部署 RPL 代幣

本頁帶領讀者將一個代幣從無到有，變成 Rand 上一項已上線、可轉讓的資產。RPL 是 Rand 的代幣標準，自 chain 14 起推出。如果你部署過 ERC-20，或建立過 SPL mint，第一節值得細讀，因為 RPL 代幣兩者皆不是。RPL 代幣是本頁背後的概念頁面。

1. RPL 代幣是甚麼

RPL 代幣是賬本代幣登記冊中的一個條目，而不是智能合約。無須撰寫、編譯或審計任何程式碼。創建代幣只是一項交易，在登記冊中加入一行；此後，該代幣的單位就是普通的屏蔽 note，與 RAND 存放於同一個池中，花費方式亦相同。

符號並不唯一。 任何人都可以創建名為 USDC 的代幣，與 Ethereum 和 Solana 上一樣。代幣的身份是其資產 id，因此接受或列出代幣之前，應核對 rpl1… id，而不是符號。文字形式帶有校驗碼：輸入錯誤的 id 會被拒絕，而不會被發送到別處。

與 ERC-20 和 SPL 有何不同

保持公開的是邊界：代幣的登記、每一次鑄造和每一次銷毀，均連同金額公開。這使任何人都可以審計總供應量。持有人之間的轉賬不會透露任何資料，包括哪一種代幣被轉移。

2. 開始之前

rand --key wallet.key.json keygen     # writes the spend key; refuses to overwrite
rand --key wallet.key.json address    # your rand1… address
rand --key wallet.key.json faucet     # testnet only, allowlisted wallets only: asks a validator node to mint 100 RAND to this wallet
rand --key wallet.key.json balance    # scans the tree, prints the spendable value and the unspent note count

--key 預設為 wallet.key.json，亦可一次設定為 RAND_KEY；--rpc（或 RAND_RPC）指明要連接的節點，預設為 http://127.0.0.1:8545。以下命令均明確寫出 --key。花費證明之前，先確認節點位於 chain 21：JSON-RPC 方法 rand_chainId 在該鏈上返回 21。錢包必須是 chain 21 的構建版本 v0.8.0：chain 21 運行約束集 9，因此較舊錢包的證明在該鏈上無法解碼；並且與 chain 20 一樣，它將每個證明和每條簽名訊息（包括代幣鑄造）綁定到其創世哈希，因此 v0.6.7 的 rand 所生成的證明和簽名會被 chain 20 和 chain 21 拒絕。

3. 創建代幣

token create 的金額以代幣的最小單位計。 --fixed-supply 和 --initial 是基本單位的整數：在 --decimals 2 下，金額 1000000 即 10,000.00 個代幣。自 v0.5.10 起，之後的每條命令（rand send --asset、rand token mint、rand token burn）均採用代幣的顯示單位，與 RAND 金額以 RAND 計（1.5）相同：錢包從代幣的登記冊記錄中讀取 decimals，小數位數多於代幣所定者會被拒絕。在鏈上，金額始終是基本單位的整數。

先決定一件事：日後是否可能發行更多單位？ 答案在創建時固定於代幣之中，之後不能放寬。

固定供應量代幣

rand --key wallet.key.json token create \
  --name "Example Credits" \
  --symbol EXC \
  --decimals 2 \
  --fixed-supply 1000000 \
  --to rand1…

--to 是接收供應量的完整 rand1… 地址，例如 rand address 的輸出。--fixed-supply 以基本單位計：在 2 位小數下，1000000 即 10,000.00 EXC。

該命令從節點讀取登記冊的下一個索引和登記費用，構建初始鑄造的 note，為一個費用捆綁生成證明，提交登記並等待區塊。成功時，它會報告提交結果，然後打印形如 index <N>, id <64 hex> (<rpl1…>) 的一行，再打印 committed at height <H>。請記下 rpl1… id：它是代幣的身份，之後每條命令都需要它。

預設費用是基本費用加上鏈的登記費用，在 chain 21 上與 chain 20 一樣為 1.001 RAND，因此無須自行計算；--fee（以 RAND 計）可調高費用。--no-wait 在交易提交後立即返回，並略去 committed 一行。--cuda 在已連接的 NVIDIA GPU 上生成證明，需要以 --features cuda 構建，並且不會退回使用 CPU。

如果在你的交易生成證明期間，另一個代幣完成了登記，它會佔用你的交易所封存的索引。 節點會拒絕該登記，命令會打印 another token took index N first — re-run to register at N+1，並附上實際數字。被拒絕的登記不會進入區塊；損失的是生成證明所花的約 100 秒工作。再次運行命令，它會針對下一個索引重新生成證明。

全部供應量現在存放於一個由 --to 地址擁有的屏蔽 note 中。登記及其金額是公開的；接收者其後如何處理該 note，則不公開。

可鑄造代幣

rand --key wallet.key.json token create \
  --name "Example Points" \
  --symbol EXP \
  --decimals 0 \
  --authority-key-out exp-authority.key.json

這會將一把新的 Dilithium2 金鑰寫入 exp-authority.key.json(權限為 0600,若檔案已存在則拒絕覆寫),並以該金鑰作為鑄造授權者、初始供應量為零註冊代幣。輸出與固定供應量代幣相同,同為兩行。--fixed-supply 與 --authority-key-out 必須且只能指定其中一項。

若要在同一筆交易中鑄造首筆數量,請加上 --initial 與 --to,兩者必須一併提供:

rand --key wallet.key.json token create \
  --name "Example Points" \
  --symbol EXP \
  --decimals 0 \
  --authority-key-out exp-authority.key.json \
  --initial 5000 \
  --to rand1…

註冊進行期間,金鑰會暫存於 exp-authority.key.json.pending。一旦鏈接受該註冊,便會升格為 exp-authority.key.json;若鏈拒絕該註冊,則會被捨棄。如果連線失敗而結果未明,檔案會保留在 .pending:刪除之前,請先查看 rand token list。

金鑰檔案就是印發該代幣的權力。 請離線保存並妥善備份;它與錢包的花費金鑰(spend key)互相獨立,收發款項時完全用不到。

為何首次鑄造的接收方屬於 id 的一部分

註冊並非由其創建者簽署。任何人只要在 mempool 中看到你正在等候的註冊,都可以提交一份副本,並以自己的費用組合(fee bundle)支付費用。若資產 id 只涵蓋名稱、符號與數量,該副本便可填上抄襲者自己的地址作為接收方,並搶先進入區塊:他們將擁有該 id,而對於固定供應量代幣,更會永久擁有全部供應量。

因此,id 是對註冊中所有內容計算的雜湊,初始鑄造亦包括在內:其數量、接收方、隨機數、時間及加密信封。接收方不同的副本,雜湊出的是不同的資產 id。那是另一種碰巧與你的符號相同的代幣,而這正是非唯一符號一直以來唯一的承諾。你的 id 只可能以你的接收方註冊。

--salt <hex32> 設定同樣參與計算 id 的 32 字節 salt。若省略,錢包會隨機選取一個。當你需要 id 可重現時,例如在代幣存在之前就公布 id,便可自行設定。

確認結果

rand token info rpl1…          # by id: rpl1… or 64 hex characters
rand token info 2              # or by the index `token create` printed
rand token list --limit 20     # one page of the registry; --from <index> pages on

token info 會以 JSON 輸出該代幣的資料行:index、id、id_text(rpl1… 形式)、name、symbol、decimals、authority、mint_nonce、total_supply 及 registered_at。固定供應量代幣的 authority 為 {"kind":"none"},可鑄造代幣則為 {"kind":"key","key":…,"address":…}。total_supply 是以基本單位表示的十進制字串。token list 輸出 enabled、registration_fee、next_index 及 tokens 各行。兩者都會讀取節點的完整列表,因此節點不會得知你關注的是哪一種代幣。

亦可透過 JSON-RPC,參數可以是索引、64 個字元的十六進制 id,或 rpl1… 形式:

curl -s http://127.0.0.1:8545 -H 'content-type: application/json' -d '{
  "jsonrpc": "2.0", "id": 1,
  "method": "rand_getToken",
  "params": ["rpl1…"]
}'

結果與 token info 輸出的資料行相同;若該代幣不存在,則為 null;格式錯誤的 id(校驗和不符、大小寫混用、長度不對)會回傳錯誤 -32602。rand_getTokens 接受 [from_index, limit],可分頁瀏覽所有已註冊的代幣;rand_getTokenSupply 只回傳 { total_supply, backings }。以上皆無需金鑰。參見 JSON-RPC。

目前在 chain 21 上存在的一行是 zUSD,即索引 1 的橋接代幣,亦是 chain 21 創世區塊中唯一的代幣;在 chain 20 上註冊的十一種代幣(durian.market 的 DUR 及其資金池份額、示範代幣)並未帶過這次切換,因為任何已註冊的代幣從來都不會被帶過。瀏覽器提供節點的註冊表,毋須自行運行節點:

curl -s https://randscan.org/api/v1/tokens

在 chain 14 上,於 2026-09-20,該請求回傳 "registration_fee": 1000000000、"next_index": 2 及一種代幣,此處只保留其第一項抵押支持:

{
  "index": 1,
  "id": "32e5ab28c782c663e14da2650a3feb12f16a12db85599f4f62dc169d26f37b1f",
  "id_text": "rpl1xtj6k2x8strx8c2d5fjs50ltztck5ykms4ve7nmzmstf6fhn0v0spelqtx",
  "name": "Shielded USD",
  "symbol": "zUSD",
  "decimals": 8,
  "authority": {
    "kind": "bridge",
    "backings": [
      { "chain": 2, "token": "000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec7",
        "decimals": 6, "locked": "0", "minted_today": "0", "mint_day": 20716,
        "mint_cap_per_day": "10000000000000" }
    ]
  },
  "mint_nonce": 0,
  "total_supply": "0",
  "registered_at": 256
}

在 chain 21 上,該行的 id、id_text、名稱、符號與抵押支持均相同,但 zUSD 是列在創世區塊中,而非在區塊高度 256 註冊(registered_at 為 0),其供應量由 100.001999 zUSD 開始:Ethereum USDT 上鎖定 22,BSC USDT 上 23.001999,Tron USDT 上 30,Solana USDT 上 25,均承接自 chain 20。(chain 20 由 99 zUSD 開始,承接自 chain 19;chain 19 由 10 zUSD 開始,全部在 Solana 上;chain 18 則為 Tron 上 9 及 Solana 上 1。)每一行抵押支持亦帶有滾動窗口欄位 minted_in_window、mint_window_secs 及 mint_headroom。

瀏覽器所載的 registration_fee 是 JSON 數字;節點本身的 RPC 則與所有金額一樣,以十進制字串回傳。在 chain 21 上,一如自 chain 15 起的每條鏈,節點的 rand_getTokens 亦帶有 max_tokens(4096)、burn_registration_fee 及 bound_note_value(兩者均為 true)(RPL tokens)。

4. 鑄造,並移交授權

只有具備 Key 授權者的代幣才能鑄造,而且只能由該金鑰鑄造。

rand --key wallet.key.json token mint \
  --asset rpl1… \
  --to rand1… \
  --amount 5000 \
  --authority-key exp-authority.key.json

--amount 以代幣的顯示單位計:這個 0 位小數的代幣的 5000 即 5,000 個基本單位,而 6 位小數代幣的 1.5 即 1,500,000。在建立 note 或證明之前,錢包會讀取代幣的資料行,若代幣並非由 Key 授權,或 --authority-key 並非註冊表所指定的金鑰,便會拒絕。成功後,錢包會回報提交結果,並輸出 minted <amount> (<base units> units) of asset <index> to <address>。--fee(預設 0.001 RAND)、--no-wait 及 --cuda 的作用與 token create 相同。

一次鑄造會為接收方新增一個 note,並增加總供應量。數量與接收方的公開金鑰會出現在鏈上傳輸的數據中:鑄造按設計是公開事件,與經橋接存入無異。接收方一旦移動該 note,它便與其他一切一樣受到屏蔽(shielded)。支付費用的錢包(--key)與授權鑄造的金鑰(--authority-key)是不同的金鑰,可由不同的人持有。

每次鑄造都對鏈 id、資產 id 及註冊表維護的計數器簽署,自 chain 20 起更涵蓋創世區塊雜湊(rand-rpl-mint-2),因此鑄造無法在本鏈上重放,亦無法複製到另一條鏈,即使該鏈與本鏈共用同一個鏈 id。set-authority 的綁定方式相同。

若要將授權轉移至新金鑰,或永久放棄:

rand --key wallet.key.json token set-authority \
  --asset rpl1… \
  --authority-key exp-authority.key.json \
  --new-key next-authority.key.json

rand --key wallet.key.json token set-authority \
  --asset rpl1… \
  --authority-key exp-authority.key.json \
  --renounce

--new-key 接受一個金鑰檔案,並將代幣移交給該檔案的公開金鑰;--new-key 與 --renounce 必須且只能指定其中一項。該指令輸出 asset <index>'s mint authority is now <public key hex>,或 asset <index>'s mint authority is renounced for good。每次均需 0.001 RAND 的基本費用及一輪證明。--renounce 會令代幣在其現時供應量下成為固定供應量代幣。此舉不可逆轉:授權只能由一把金鑰轉移至另一把金鑰,或由一把金鑰轉為無人持有,別無其他途徑。以固定供應量創建的代幣永不可能變為可鑄造。

5. 使用代幣

發送

rand --key wallet.key.json send rand1… 250 --asset rpl1…

這會發送 250 個該代幣(以顯示單位計):0 位小數的是 250 EXP,2 位小數的是 250.00 EXC(25,000 個基本單位)。接收方與數量是位置參數,與 RAND 相同。在進行任何證明之前,錢包會輸出一行 to fingerprint XXXX-XXXX-XXXX-XXXX · <amount> <symbol> (<base units> units),並詢問 send? [y/N]。請將指紋與接收方的核對,並將基本單位與你的原意核對。--yes 會略過該提問,而腳本必須傳入此旗標:若不傳入,非終端機的 stdin 會被拒絕。--asset 接受索引、rpl1… id 或 64 個字元的十六進制 id;省略時發送的是 RAND。--memo <text> 會將最多 510 字節的文字密封給接收方,置於該付款的信封內,chain 18 是首條容許此功能的鏈;鏈上沒有任何跡象顯示備註存在。--fee 一律以 RAND 計,預設為 0.001;--no-wait 與 --cuda 適用。id 是根據節點的完整註冊表列表解析為索引,而數字索引根本不會到達節點,因此節點不會得知哪一種代幣即將被移動。這與移動 RAND 的 rand send 是同一個指令,證明過程也相同。交易公布四個 nullifier、四個承諾、一筆 RAND 費用、一個時間、四個加密信封、捆綁證明,以及自 chain 17 起的一個授權承諾及其證明,不論移動的是哪一種資產。觀察者無法分辨代幣轉帳與 RAND 付款,無法分辨是哪一種代幣,亦看不到發送方、接收方或數量。

費用從同一捆綁中以 RAND 支付,因此發送方錢包必須持有一些 RAND。錢包會在開始證明之前檢查這一點。

查詢餘額

rand --key wallet.key.json asset-balance 2     # one token, by index
rand --key wallet.key.json asset-balance       # a row for every token this wallet holds

參數是註冊表索引。對於單一代幣,錢包會輸出 asset <index> balance: <N> units,以基本單位計。rand notes 會列出錢包已開啟的每個 note 及其 asset 索引。錢包以其檢視金鑰(viewing key)掃描鏈來找出屬於它的 note。鏈上沒有任何地方存放可供查詢的餘額。

銷毀

rand --key wallet.key.json token burn rpl1… 100

資產與數量是位置參數:資產以索引、rpl1… 或十六進制表示,數量以代幣的顯示單位計,與 send --asset 的讀取方式相同。--fee 預設為 0.001 RAND;--no-wait 與 --cuda 適用。

銷毀會令單位消失,並降低總供應量。與鑄造一樣,銷毀屬公開邊界:數額與代幣可見,持有人不可見。像 zUSD 這類橋接代幣不能以此方式銷毀:token burn 會在生成證明前拒絕,它須經 rand bridge-burn 離開,並釋放其背後的幣。

6. 在瀏覽器上驗證

randscan.org 向所有人展示代幣的公開一面:它的登記、鑄造與銷毀,以及總供應量。所有代幣均列於 randscan.org/tokens,單一代幣的頁面為 /tokens/<rpl1…>、/tokens/<64 hex> 或 /tokens/<index>;randscan.org/tokens/1 即 zUSD。相同數據見於 GET /api/v1/tokens 與 GET /api/v1/tokens/:id,後者附有該代幣的部署交易,以及由登記、鑄造與銷毀組成的供應量歷史(Explorer API)。

一筆轉賬的公開頁面不顯示資產、數額與各方,因為鏈上並無這些資料。若要向他人(例如核數師、交易對手或交易所)證明一筆付款,須給對方一把密鑰:

rand --key wallet.key.json tx-key <TX_HASH>    # the keys for one transaction
rand --key wallet.key.json viewing-key         # the wallet's viewing key, 64 hex characters

tx-key 為該交易中本錢包發出、收到或作為找零保留的每個輸出各印一行:輸出(bundle:0 至 bundle:3,即該 bundle 的四個槽位)、角色、數額(以 RAND 計,代幣則為 N (asset I)),以及該輸出所封存於的每筆交易密鑰。請交出 sent 一行的密鑰。它適用於任何過往交易,因為錢包會從鏈上恢復該密鑰。

把交易密鑰貼到 randscan 上該交易的頁面即可打開該輸出;瀏覽器會依登記冊解析資產索引,以名稱顯示代幣,並套用其小數位數。查看密鑰則輸入 randscan.org/viewing。瀏覽器不持有任何密鑰,也不在其伺服器上解密任何內容。經 JSON-RPC,同樣的披露為 rand_checkTransaction(hash, key)。兩種密鑰均不能花費任何資產。查看密鑰一經分享便無法收回,因此若只需證明一筆付款,宜選用交易密鑰。

7. 橋接代幣

zUSD(「屏蔽美元」)同樣是 RPL 代幣,其授權為 Bridge:只有當守護者就 Ethereum、Binance Smart Chain、Tron 或 Solana 上的 USDT 或 USDC 存款作出證明時,才會鑄造其單位,而其供應量始終等於鎖定於該處的數額。它由鏈 14 以高度 256 的交易登記,索引為 1,共有七個支持幣種;其後每條鏈(包括鏈 21)的創世區塊均以同一 id 再次列出它,即 rpl1xtj6k2x8strx8c2d5fjs50ltztck5ykms4ve7nmzmstf6fhn0v0spelqtx。鏈 15 承接了鏈 14 停止時仍未償付的 10 zUSD,鏈 16 至 19 以同樣的 10 zUSD 起步,鏈 20 以鏈 19 上未償付的 99 zUSD 起步,鏈 21 則以鏈 20 上未償付的 100.001999 zUSD 起步。自鏈 20 起,橋對每筆存款與每筆贖回收取 10 bps,以 zUSD 計,歸入國庫票據(Bridge)。zUSD 是一籃子資產:其支持幣種按面值匯集,因此持有人承擔所有已列幣種的風險,而非僅限其存入的那一種(RPL tokens)。其供應量隨每筆存款與贖回而變動;rand token info 1 或瀏覽器的 /tokens/1 可查得當前數字。

它在鏈 14(一個早期 testnet)上的歷程(已於 2026-09-20 在瀏覽器核對)。此表為鏈 14 的歷史:鏈 14 已退役,因此這些交易不在鏈 20 的瀏覽器上:

該轉賬的頁面顯示的,與任何代幣轉賬所顯示的一樣:四個作廢符、四個承諾與一筆費用,而沒有任何內容表明 zUSD 曾經移動。

為說明密鑰會披露什麼,fullnode 的 v0.5 發行說明為那筆鏈 14 轉賬公佈了兩把密鑰,來自一個專為此目的而建、別無他物的示範錢包:

在鏈 14 上,該交易密鑰可在該轉賬的頁面打開該輸出,經 JSON-RPC 則只需一次調用(已於 2026-09-20 核對)。對於你自己的交易,該調用在鏈 21 上形式相同;以這些鏈 14 的值,鏈 20 的節點回應 null(已於 2026-10-01 核對),鏈 21 的節點亦然,因為兩者都從未持有該筆交易:

curl -s https://rpc.randprotocol.org -H 'content-type: application/json' -d '{
  "jsonrpc": "2.0", "id": 1, "method": "rand_checkTransaction",
  "params": ["e6ddaca3c852e6c861524a55d00a0fbdcaff6867544b9f19b9bf60ce263c32ed",
             "7f68f57c4f33a3f0fe419f4d1a5df2875461339dbc454af8ced50cbd7f40e4ef"] }'

切勿公開你正在使用的錢包的查看密鑰:它會永久展示該錢包的全部歷史。

普通地址不能建立橋接代幣。rand token create 會拒絕 Bridge 授權,而登記橋接代幣,或為既有代幣加入支持幣種,均須橋的後量子守護者集合提供已簽署的法定人數。未經此程序而自稱 zUSD 的代幣,只是借用了符號的另一種代幣,這也是核對 rpl1… id 的另一個理由。橋接代幣在 Rand 上一律為 8 位小數。

Bridge 涵蓋存款、贖回與守護者集合。