SSolon 中EN繁
Solon Docs

在 Solon 上構建

EVM 完全兼容：你熟悉的一切以太坊工具（MetaMask / ethers.js / web3.py / Remix / Hardhat）開箱即用。只需把 RPC 指向 Solon。

快速開始JSON-RPC方法全表錯誤碼水龍頭 API 合約地址冊SDK 示例發行合規章通證節點信息 合規説明

Quickstart快速開始

參數值
網絡名稱Solon Chain Testnet
RPC 地址…
Chain ID51051（十六進制 0xC76B）
代幣符號SLN · 18 位小數 · 測試幣無價值
出塊 / 共識1 秒 · Clique PoA · EVM London
區塊瀏覽器Solon Explorer

15 分鐘全鏈路驗收（從 0 到第一筆鏈上交互）
  1. 連接網絡（1 分鐘） — 點上方「一鍵添加到 MetaMask」，或在任意 EVM 工具把 RPC 指到本站 /solonrpc/，eth_chainId 應返回 0xC76B。
  2. 領測試幣（1 分鐘） — 水龍頭領取 10 SLN，或直接用下方 Faucet API 程序化領取。
  3. 發第一筆轉賬（2 分鐘） — 用 網頁錢包或 MetaMask 轉 0.1 SLN 給任意地址，1 秒出塊即確認。
  4. 在瀏覽器核對（1 分鐘） — 打開 Solon Explorer 查交易哈希，確認狀態成功、Gas 消耗符合預期。
  5. 部署一個合約（10 分鐘） — Remix / Hardhat 直接部署（編譯器 EVM 版本務必選 london），或按發行指南部署自己的合規章通證。

JSON-RPC直接調用節點

標準以太坊 JSON-RPC 接口，支持 eth_* / net_* / web3_* / txpool_* 命名空間。

cURL · 查詢最新區塊高度
# 查詢最新區塊高度
curl -X POST … \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

# 返回: {"jsonrpc":"2.0","id":1,"result":"0x7a13"}
cURL · 查詢地址餘額
curl -X POST … \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_getBalance",
       "params":["0x你的地址","latest"],"id":1}'

Method ReferenceJSON-RPC 方法全表

與以太坊主網 RPC 語義完全一致——凡是能連以太坊公共 RPC 的代碼，改一個 URL 即可跑在 Solon 上。

方法類型説明
eth_* · 鏈數據與交易
eth_chainId / eth_blockNumber讀鏈 ID（0xC76B）/ 最新區塊高度
eth_getBalance / eth_getTransactionCount / eth_getCode / eth_getStorageAt讀餘額 / nonce / 合約字節碼 / 存儲槽
eth_getBlockByNumber / eth_getBlockByHash讀區塊詳情（含交易列表）
eth_getTransactionByHash / eth_getTransactionReceipt讀交易詳情 / 回執（狀態、Gas、日誌）
eth_call / eth_estimateGas讀本地模擬調用（不發交易）/ Gas 估算
eth_sendRawTransaction寫廣播已簽名交易（唯一寫接口，私鑰永不觸網）
eth_getLogs / eth_getFilterChanges 等 filter 族讀事件日誌查詢（按地址 / topic 過濾）
eth_gasPrice / eth_feeHistory / eth_syncing讀Gas 價格 / 費率歷史 / 同步狀態
net_* / web3_* / txpool_* · 節點與工具
net_version / net_peerCount / net_listening讀網絡 ID（51051）/ 對等節點數 / 監聽狀態
web3_clientVersion / web3_sha3讀節點版本 / Keccak-256 哈希工具
txpool_content / txpool_status讀交易池內容 / 排隊與待打包計數

⚠️ 管理類命名空間（admin_* / personal_* / miner_*）不對公網開放；主網上線前將進一步收窄。

Error Codes錯誤碼速查

三類錯誤：JSON-RPC 協議層（標準以太坊）、合約 revert（Solon 合規邏輯）、儲備證明門控原因碼（SolonProof，9 類）。

碼含義與排查
JSON-RPC 標準錯誤
-32700Parse error — 請求體不是合法 JSON
-32600Invalid Request — 缺 jsonrpc:"2.0" 或字段結構錯誤
-32601Method not found — 方法名拼寫錯誤，或該命名空間未開放（如 admin_*）
-32602Invalid params — 參數數量 / 類型 / 區塊標籤錯誤
-32000Server error — 含 gas required exceeds allowance（Gas 上限）、nonce too low（重發舊 nonce）、insufficient funds（餘額不足）等子類，讀 message 定位
合規章合約 revert（交易被合規規則攔截）
not verified接收方（或發起方）未通過 IdentityRegistry 白名單 → 先完成 KYC 登記
frozen地址被合規凍結，任何轉入轉出均被攔截
paused合約處於緊急暫停狀態，等待官方恢復（狀態見狀態頁）
PUSH0 相關部署報未知操作碼 → 編譯器 EVM 版本改為 london 重新編譯（本鏈暫不支持 cancun）
SolonProof 門控原因碼（gate(asset) 返回 reason，認購 / 贖回被攔截時查閲）
0 / 1手動暫停 — 合規方主動暫停，附鏈上備註
2未登記證明 — 資產從未提交儲備證明
3證明不在有效期 — 超出 validFrom ~ validUntil 窗口，需更新證明
4證明被撤銷 — 發行人或合規方已 revoke，資產頁同步披露
5無喂價結論 — 多籤喂價尚未達成（2-of-3 未齊）
6審計不合格 — 喂價結論為不通過
7儲備率低於閾值 — 實測儲備率 < 資產規則設定的 minRatioBp
8風險告警 — 喂價方上報 riskFlag，預防性攔截

Faucet API水龍頭（程序化領幣）

除網頁版外，水龍頭提供 HTTP API：每地址每 24 小時可領 10 SLN。

cURL · 領取測試幣
curl -X POST … \
  -H "Content-Type: application/json" \
  -d '{"address":"0x你的地址"}'

# 成功: {"ok":true,"tx":"0x…"}　失敗: {"ok":false,"error":"…"}

Official Contracts官方合規合約

由 Solon 官方部署並做鏈上驗證的合規章基礎設施（ERC-3643 簡化實現）。官方 IdentityRegistry 為白名單制，僅官方可登記地址；如需自由管理白名單，請使用自部署模式。

合約地址
IdentityRegistry
鏈上 KYC 白名單登記處		 0xd81991206354E7b954C286a264eB1f2D940fa736
STT（合規章通證樣例）
Solon Treasury Token · RWA 債券類		 0x9182B8445614D76f8E30118c73256829a68e3516
SolonProof
儲備證明登記 + 多籤喂價 + ReserveGuard 門控		 0x1B6aa6198DaFe8b6a373FC91026b4D80b0409b68
DividendPool
股息池 · 公司行動引擎		 0x8aC596e41db553BAE8B82d151A80dc10d9C98351
LimitBook
限價訂單簿 · 託管 + 原子交收		 0x86a60247Bdad0fE1b4fdFdeA231af996C8d5189c
SolonBridge
跨鏈橋 Solon 端 · 限額 / 快速通道 / 緊急暫停		 0x36507aB96929181867CE406B7DcAE0114467474f
SolonOffering
一級認購引擎 · 固定價格 + 原子 DvP		 0xf61Ed0E0964Ac3B2f7d872B03315972BfE97e816
GLD（黃金份額樣例）
商品類合規章通證 · 多資產演示		 0x0Fe35F9621969B4bBEed7C153660B91d00cC4094
ABI 下載（JSON，直接配合 ethers / web3.py 使用）
合約ABI 文件
IdentityRegistryir.json
合規章通證（STT / GLD 同款）ct.json
SolonProof（儲備證明）proof.json
DividendPooldividend.json
LimitBookorderbook.json
SolonBridgebridge.json
SolonOfferingoffering.json
預言機 PriceFeedfeed.json

即插即用示例腳本見 assets/examples/（01 價格查詢 → 06 限價單，共 6 個，Node 直接運行）；合約源碼級 ABI 與字節碼打包於 assets/solon-contracts.js。

方法權限説明
IdentityRegistry（白名單）
isVerified(address)view查詢地址是否已通過 KYC 白名單登記
register(address) / registerBatch(address[])owner登記單個 / 批量地址入白名單
remove(address)owner移出白名單
合規章通證（STT 同款邏輯）
transfer(to, amount)白名單雙方接收方未登記或任一被凍結 → 直接 revert
mint(to, amount) / burn(amount)owner增發 / 銷燬
freeze(addr) / unfreeze(addr) / frozen(addr)owner合規凍結 / 解凍 / 查詢凍結狀態
forcedTransfer(from, to, amount)owner強制轉賬（法院令等司法場景）
pause() / unpause()owner緊急暫停 / 恢復全合約轉賬
鏈上驗證結果（部署當日實測，全通過）

SDK ExamplesSDK 示例

JavaScript · ethers v6
// npm i ethers　（或直接使用本站 assets/ethers.umd.min.js）
import { ethers } from "ethers";

const provider = new ethers.JsonRpcProvider("…");
console.log("block:", await provider.getBlockNumber());

// 發送 SLN（MetaMask）
const signer = await new ethers.BrowserProvider(window.ethereum).getSigner();
const tx = await signer.sendTransaction({
  to: "0x接收地址",
  value: ethers.parseEther("1.0")
});
console.log("tx:", tx.hash);

// 查詢 STT 餘額
const stt = new ethers.Contract(
  "0x9182B8445614D76f8E30118c73256829a68e3516",
  ["function balanceOf(address) view returns (uint256)"],
  provider
);
console.log("STT:", ethers.formatUnits(await stt.balanceOf(signer.address), 18));
Python · web3.py
# pip install web3
from web3 import Web3

w3 = Web3(Web3.HTTPProvider("…"))
assert w3.is_connected()
print("block:", w3.eth.block_number)
print("balance:", w3.from_wei(w3.eth.get_balance("0x你的地址"), "ether"), "SLN")

Issue Your Token發行合規章通證

官方 IdentityRegistry 為白名單制（僅官方可登記）。要在測試網上自由發行，推薦「自部署模式」：每個發行方部署自己專屬的 IR + 通證組合，發行方即 owner，全權管理白名單、增發與凍結。

兩種發行方式
  1. 網頁嚮導（零代碼） — 打開 發行平台，連接錢包後一鍵完成：部署專屬 IdentityRegistry → 部署通證合約 → 白名單登記發行方與接收方 → 鑄造初始供應量，共 4 筆鏈上交易。
  2. 程序化部署 — 合約 ABI 與字節碼託管於 assets/solon-contracts.js（solc 0.8.26，evmVersion=london），直接用 ethers ContractFactory 部署即可。⚠️ 部署合約請務必指定 EVM 版本為 london（cancun 的 PUSH0 指令本鏈暫不支持）。

Infrastructure節點信息

Solon 測試網採用雙驗證人架構，新加坡 + 首爾兩個出塊節點交替封塊，任一節點宕機鏈不停。

節點角色
新加坡出塊驗證人 · 水龍頭服務
首爾出塊驗證人 · 門户 / RPC 入口

測試網階段 RPC 開放寫交易；主網上線前將收窄管理類命名空間並開放節點接入申請。

Emergency Playbook應急預案手冊

按運維監控體系（P1/P2/P3 分級告警）配套的處置流程——每級告警都有對應的操作手冊，狀態頁實時評估當前級別。

P1 · 致命（立即響應，15 分鐘內）
場景處置步驟
單驗證人離線① 狀態頁確認另一節點仍在出塊（Clique 容錯生效，鏈不停）→ ② 檢查離線節點容器與磁盤 → ③ 重啓節點容器，觀察重新同步 → ④ 高度追平後解除告警
出塊停滯 > 30s① 雙節點互查 peer 連接 → ② 檢查驗證人 unlock 狀態與系統時間（NTP 偏移是 Clique 停塊首因）→ ③ 必要時重啓落後節點 → ④ 公告用户
橋異常資金流① 多籤委員會立即執行 setPaused(true) 暫停橋（2-of-3 門限，提案+確認全程鏈上留痕）→ ② 凍結異常地址（合規中台操作枱）→ ③ 出具事件報告
P2 · 嚴重（1 小時內響應）
場景處置步驟
雙節點高度差 > 10 塊檢查落後節點網絡與磁盤 IO；持續擴大則按 P1 單驗證人離線流程處理
出塊間隔 P95 > 5s檢查驗證人負載；如為交易洪峯屬預期，持續 1 小時不降則排查 peer 質量
橋池流動性不足快速橋池低於單日限額 20% 時，從金庫經多籤提案補充注資
P3 · 提示（當日處理）與日常演練
事項説明
RPC 延遲 > 1500ms檢查首爾入口負載；機構用户可切換直連節點 RPC
季度災備演練每季度模擬單區域失聯：關停一個驗證人，驗證鏈不停 + 狀態頁降級橫幅 + 告警分級正確觸發
密鑰輪換多籤委員私鑰半年輪換一次：新委員加入提案 → 舊委員移除提案 → 金庫小額試付驗證

Compliance & Dual Proof合規説明：雙層證明與造假處置

Solon 的合規分兩層：鏈下——監管審批備案、審計託管、法律意見（信任根）；鏈上——文件哈希存證、多籤喂價、自動風控（可驗證證明）。鏈上做規則執行、不做事實發現：不自動審計鏈下資產真偽；造假的證偽與處罰由政府監管（SFC / AFRC / HKMA / CCB / ICAC）與司法機關負責，鏈上負責秒級止損與證據固定。

合規全景圖 →造假處置鏈路 →PoR 操作枱 →雙層證明視圖 →資產披露示例（GLD）→