コマンドライン

cargo build --release で3つのバイナリが生成されます。rand-node(ノードとオペレーター向けコマンド)、rand(シールドウォレット)、rand-prover(委任プローバー)です。すべてのコマンドが -h/--help を受け付けます。このページでは、chain 20 が稼働しているビルドである v0.6.8 リリース(c9c9bd3c)を説明し、v0.6.7 で動作が異なる箇所にはその旨を記します。v0.6.8 より古い rand ウォレットは chain 20 で送金できません。chain 20 のジェネシスは、すべての証明と署名付きメッセージをそのハッシュに結び付けているためです。最初の2つは、異なる種類の鍵を扱います。ノード鍵はブロックに署名する Dilithium2 の鍵ペアであり、ウォレット鍵はオンチェーンでは何にも署名しないシールドされた支払い鍵です。

rand-node

rand-node <COMMAND>
  keygen      Generate a new Dilithium2 key file (refuses to overwrite an existing one)
  address     Print the address, public key, and libp2p peer id of a key file
  genesis     Write a genesis.json: every validator key is staked, each --alloc becomes a deposit note
  alloc-note  Print one genesis alloc note as JSON, RAND or a listed token, for splicing into a genesis
  init        Initialise a data directory from a genesis file
  run         Run the node
  verify      Verify the chain in a data directory without running the node
  db          Database maintenance on a stopped node's data directory
  safety      status | clear-halt | release-lock: a stopped validator's consensus safety state
  status      Show node status
  register    Print this node's Registration, for the wallet that bonds it in
  admit       sign | submit: the validator set's vote to admit a new key (admission by vote)
  unbond      Move bonded stake into unbonding
  withdraw    Pay released stake and rewards into a note at the payout address
  bridge-gov  rotate-pq | rotate-pause | cancel-rotation: the bridge's post-quantum rotations
  vesting     status | claim | revoke | bond | unbond: genesis vesting (chains with a vesting section)
  aggregator  register | unbond | withdraw — the aggregator role (aggregation chains only)
  aggregate   The aggregate daemon (aggregation chains only)

safety、admit、bridge-gov は v0.6.8 で新たに加わりました。balance と transfer はありません。送金にはシールドされた支払い鍵が必要で、それを持つのはウォレットだけだからです。

グローバルフラグが1つあります。--allow-test-fri-profile(または RAND_ALLOW_TEST_FRI_PROFILE=1)を指定すると、init、run、verify は fri_profile が test のジェネシスを受け付けます。このプロファイルの健全性は約17ビットにすぎず、ジェネシスファイルを書く人は誰でもこれを指定できるため、v0.6.8 以降、ノードはフラグなしではそのようなジェネシスを拒否します。テストスイートはこれを設定しますが、それ以外では設定すべきではありません。

keygen、address

keygen は { "seed": <32-byte hex>, "address": <base58>, "public_key": <hex> } をパーミッション 0600 で書き出します。このファイルがシードの唯一のコピーです。v0.6.8 以降、keygen は既に存在する --out を拒否し(… already exists or cannot be created; refusing to overwrite a key file)、そのファイルには手を付けません。--force はないため、置き換えるには古いファイルを別の場所へ移してください。v0.6.7 以前は、確認なしに上書きしていました。address は address、public_key(16進で 1,312 バイト)、peer_id を表示します。

genesis

--alloc ごとに alloc の行を1行表示し、続いてジェネシスハッシュ、バリデータ数とノート数、エポック長、5つの上限、hc_bundle と hc_auth(--auth-guest がなければ none)を表示します。その後にガスの行が続きます。gas: price P/gas, B/KiB, bundle limit N, dynamic: target … B / … gas, adjust … bps, floor …/…, ceiling …/…, byte load all|paying、または --gas-price がなければ gas: none です。--program-state-cell-fee を指定した場合は、program_state: cell fee N RAND の行も表示されます。init も同じガスの行を表示します。5つの上限フラグは同様に動作します。省略した場合、ファイルにそのフィールドはなく、チェーンはデフォルト値で動作します。指定した場合、そのフィールドはデフォルト値と同じであってもジェネシスハッシュの一部になります。chain 20 は次のフラグで作成されました(deploy/cut-chain20-genesis.sh):

--max-program-words 65535 --max-proof-bytes 4194304 --max-block-bytes 20971520 \
--max-call-envelope-bytes 65536 --max-program-public-words 32768 \
--tokens tokens.json \
--bundle-guest v3 --auth-guest --hardening-v6 \
--gas-price 100 --byte-price 800 --bundle-gas-limit 20479 --gas-dynamic 10485760,262144,1250 \
--max-gas-price 10000 --max-byte-price 80000 --gas-byte-load paying \
--envelope-bytes 1860 \
--testnet --binding-domain 1 --proof-window-blocks 1024 --program-state-cell-fee 10000000 \
--epoch-blocks 1000 --faucet --fri-profile production

チェーン18と19は、--envelope-bytes 1860 までは同じフラグで作成されており、v0.6.8 のフラグは使っていません。proof の上限は、チェーン13〜16の 8 MiB から 4 MiB に下がりました。分割承認のトランザクションは最大3つの proof を運び、3 × 4 MiB + 1 MiB は 20 MiB のブロックに収まります。tokens.json には、1 RAND の registration_fee、10000000000000 の mint_cap_per_day、max_tokens の 4096、burn_registration_fee、bound_note_value が含まれ、zUSD が7つの裏付け資産とともに掲載されています。--bridge フラグはなく、作成スクリプトは引き続き、bridge、staking、consensus_domain の各セクションを後からファイルに差し込みます。チェーン20の内容は次のとおりです。guardian set 1 のブリッジ(8つの PQ guardian 鍵、pause 鍵、rules_v2、rotation、fees)、faucet の許可リスト、admission_by_vote、2,500 bps のエントリー予算を持つ staking セクション、consensus_domain: 1、そして alloc-note --asset 1 --envelope-bytes 1860 で作成した zUSD の genesis ノートです。有効な genesis ハッシュは、完成したファイルに対して init が出力するものです。

各 --alloc は、新しいコミットメントのランダムネスで預入ノートを1つ作成するため、2回作成すると異なる2つのハッシュが得られます。このコマンドは常に、cm と amount の横にノートの opening を書き出します。tokens セクションを持つチェーンではこれが必須です。

"alloc": [
  { "cm": "<64 hex>",
    "envelope": { "kem_ct": "<hex>", "to_receiver": "<hex>", "to_sender": "<hex>", "body": "<hex>" },
    "amount": 1000000000000,
    "opening": { "pk": "<64 hex>", "time": 0, "r": "<64 hex>" } }
]

したがって、genesis ノートの所有者と金額は、ファイルが公開された時点で設計上公開されます。非公開のまま残るのは、そのノートがいつ、何に使われるかだけです。genesis は一度だけ作成し、そのファイルを保管してください。

alloc-note

--to <rand1…>(必須)、--amount <N>(必須)、--asset <INDEX>(デフォルト 0)、--envelope-bytes <N>(デフォルト: 旧形式)。genesis --alloc が封印するのと同じ方法で --to 宛てに封印した alloc ノートを、JSON で1つ出力します。envelope_bytes を設定した genesis は、対応する --envelope-bytes なしで封印されたノートを拒否します。--amount はそのアセットの整数単位で指定します。RAND は小数9桁、ブリッジされたトークンは8桁です(アセット1での 10 は 10 zUSD)。掲載されたトークンのノートには、そのトークンの裏付け資産の locked 額の合計が、そのノートの合計とちょうど一致している必要があります。

init

genesis ハッシュと、genesis と同じ gas: 行を出力します。

run

環境変数: RUST_LOG(デフォルトは info,libp2p=warn,libp2p_mdns=off)。Ctrl-C または SIGTERM で、ノードは正常にシャットダウンします。

公開エンドポイント https://rpc.randprotocol.org は、アーカイブノードの手前に置かれた許可リスト方式のプロキシです。2026-10-01 以降、その許可リストは公開リスナーのメソッドセットです。

safety

停止中のバリデータのコンセンサス安全性の状態(v0.6.8)。各コマンドはデータディレクトリを自ら開くため、稼働中のノードと並行して実行することはできません。

rand-node safety status       --datadir <dir>
rand-node safety clear-halt   --datadir <dir> --i-have-compared-this-node-with-the-fleet
rand-node safety release-lock --datadir <dir> --i-give-up-this-validators-lock

status は、コミット済みのヘッド、view と最後に投票した view、high QC、バリデータがヘッドより上でロックされているかどうか、そして記録されている safety halt があればそれを出力します。ノードが、自身のコミット済みヘッドの子孫ではないブロックを、認証済みの three-chain がコミットしようとするのを検知すると、停止してそれを記録します(audit v6、CON-5)。その後 run は、clear-halt を実行するまで、その記録を示して終了します。解除する前に、このノードのヘッドを他の2台のバリデータのヘッドと比較し、異なる場合はアーカイブから再同期してください。v0.6.8 以降(CON-4)、「保持していない」という回答が quorum に達しても、ロックが解放されることはなくなりました。入手できないブロックにロックされたバリデータは、そのロックを上回る justify を持つプロポーザルが届くか、ブロックが取得されるまで、沈黙を保ちます。release-lock は、永続化されたロックを、コミット済みヘッドの証明書まで下げます。一度に1台のバリデータにだけ使い、ブロックが完全に失われた場合に限ってください。書き込みを行う各コマンドは、確認用のフラグがなければ、実行する内容を表示するだけで、何も変更しません。

verify

整合していれば終了コード 0、--repair なしで問題が見つかった場合は 2 です。

db

db drop-receipts-index --datadir <DATADIR>(ノードを停止した状態で): receipts_by_program インデックスを削除します。これは、v0.3 より前のビルドにロールバックする前に行います。そのビルドは、このインデックスを持つデータベースを開けません。その後の起動で、インデックスはレシートから再構築されます。

status

--rpc <URL>(デフォルトは http://127.0.0.1:8545)。rand_status をそのまま出力します。

register, unbond, withdraw

admit sign|submit

投票による承認(v0.6.8)。ジェネシスで staking.admission_by_vote が設定されているチェーン(チェーン 20 など)では、新しいバリデータの鍵は、議決権の3分の2を厳密に超えるバリデータが署名して承認した場合にのみ登録できます。

候補者とは、登録に含まれる鍵のことです。rand-node address --key がそれを出力し、register が出力した16進文字列にも含まれています。承認がコミットされた後のボンディングは従来どおりで(rand bond … --registration)、承認を消費します。rand_getAdmitted は、承認済みで待機中のものを一覧表示します。

bridge-gov

ブリッジのポスト量子ローテーション(v0.6.8)で、ガーディアンと一時停止鍵の保有者のためのものです。すべてのステップで、チェーン ID、そのバインディングドメイン、rand_getBridgeState.rotation_nonce を --rpc(デフォルトは http://127.0.0.1:8545)から読み取ります。

--new-key は、16進の Dilithium2 公開鍵、それを収めた @file、または @key-file(その公開鍵)です。署名行は index:hex の形式で、空白または改行で区切り、# によるコメントを書けます。

vesting status|claim|revoke|bond|unbond

vesting セクションを持つジェネシスのチェーンにおける、タイムロックされたジェネシス割り当てについて、保有者と取り消し権者の側の操作です。チェーン 20 にはこのセクションがありません。鍵は rand-node keygen で作成したファイルです。

aggregator register|unbond|withdraw, aggregate

aggregation セクションを持つチェーンにおけるアグリゲータの役割のコマンドです。aggregator register --key --bond <RAND> --payout <rand1…> --rpc は署名済みの AggregatorRegistration を出力します。aggregator unbond と aggregator withdraw は、バリデータの同名のペアと対応します。aggregate --key <KEY> [--rpc <URL>] [--watch] [--interval-secs 15] [--no-wait] は、rand_getUnsealed をポーリングし、1つのアグリゲートを証明して送信するデーモンです。ジェネシスに aggregation セクションがないチェーン 20 では動作しません。

rand(ウォレット)

グローバルオプションで、サブコマンドの前後どちらにも置けます。

金額は小数点以下9桁までの10進の RAND です(1、1.5、.25、0.000000001)。send、token mint、token burn、および randpay: リンクにおけるトークンの金額は、そのトークンの表示単位で、レジストリの該当行の decimals に従います(zUSD の 10 は 10 zUSD です)。bridge-burn、token create --fixed-supply、--initial は、トークンの最小単位による整数のみを受け付けます。asset-balance もその形式で出力します。コマンドがトークンを受け取る箇所では、レジストリのインデックス、rpl1… の ID、または64桁の16進 ID を指定できます。ID は、ノードのレジストリ一覧全体(rand_getTokens、全ページ)からインデックスに解決され、トークン単位の照会は決して行いません。そうすると、どのトークンが動かされようとしているかがノードに知られてしまうためです。数値のインデックスは、ノードにまったく送られません。

--cuda は --features cuda を付けたビルドが必要で、フォールバックはありません。PTX はまだビルドされていません。呼び出し入力のエンベロープを封印することはできないため、rand call --cuda には --no-envelope が必要です。宣言するのはガス上限のみで、--gas-limit N は受け付けません。

CLI が表示するメモと連絡先名(send の確認表示、notes、history、tx-key)はすべて、最初に一つの表示規則を通します。制御文字、Unicode の書式文字(双方向制御文字、ゼロ幅文字、ソフトハイフン)、U+2028/U+2029 は U+FFFD として表示し、連続するスペース区切り文字は 1 つのスペースにします。

最初のシールド送金

rand keygen                                   # wallet.key.json
rand address                                  # rand1… on stdout, its fingerprint XXXX-XXXX-XXXX-XXXX on stderr
rand faucet                                   # testnet, allowlisted wallets only: 100 RAND into a note only you can open
rand balance                                  # balance: 100 RAND
rand send rand1q9f… 1.5                       # asks to confirm, then a minute and a half to two minutes of local proving, then the commit
rand notes                                    # the spent note, and the change note

アドレスの共有とメモ

rand address --uri --amount 1.5 --memo "invoice #42" --qr   # a randpay: link, as a terminal QR
rand contacts add alice rand1q9f…                           # shows the fingerprint, asks add? [y/N]
rand send alice 1.5 --memo "coffee"                         # the memo is sealed into the payment output
rand history --memo                                         # alice's row shows the whole memo
rand tx-key <hash>                                          # hand the sent row's key to alice or an auditor

メモはノートと同じ封印された本体の中にあるため、一方を開ける者は他方も開けられます。受取人は notes で、そのアウトプットのトランザクションごとの鍵を持つ者は rand_checkTransaction <hash> <key> で開けます。Chain 18 は、ジェネシスで envelope_bytes を設定した最初のチェーンです。chain 14 から 17 では、証明を行う前に --memo が拒否されていました。

後から再び開ける機密コール

rand program build --guest balance_check --arg 1000 --out bc.json
rand program deploy bc.json                   # prints the program id
rand call <id> --input 100 --input 200 --input 300 --input 400
rand open-call <txhash>                       # inputs: [100, 200, 300, 400] — verdict: faithful (exit 0)

ステートフルなプログラム:RPL-2 カウンター

program_state セクションを持つチェーン(chain 20 がそうです)での例です。カウンターが受け付けるのは、1 つのセルを読み、その先頭ワードに 1 を加えて書き戻すトランジションだけです。トランジションのそれ以外の部分(バンドルが預け入れるもの、ボールトが支払うもの、プログラムがミントするもの)は検証されないまま通過します。そのため、これはデモであり、価値を預けるプログラムではありません。

rand program build --guest rpl2_counter --out counter.json
rand program deploy counter.json                          # prints the program id
rand token create --name "Counter Share" --symbol CTR --decimals 0 --program <id>   # say index 2
rand program state <id> --cell 0100000000000000000000000000000000000000000000000000000000000000   # 64 zeros: absent
cat > step.json <<'JSON'
{ "reads":  [{ "key": "0100…00", "value": "0000…00" }],
  "writes": [{ "key": "0100…00", "value": "0100…00" }],
  "deposit": { "rand": "500000000", "kind": "none" },
  "pays":   [{ "asset": 0, "amount": "200000000", "to": "rand1…" }],
  "mints":  [{ "asset": 2, "amount": "1" }] }
JSON
rand program invoke <id> --transition step.json           # exit 3 if the cell moved since; re-read and retry
rand program vault <id>                                   # asset 0: 300000000 units (0.5 RAND in, 0.2 out)

ファイル中の … は 64 桁の 16 進文字の全体を表しており、ウォレットはこれを必須とします。

デプロイとコールの出力

分割認可のチェーンでは、すべてのバンドルは、このマシン上で作られる 2 つの証明から成ります。tier-10 のスペンド認可と、tier-14 のバンドルです。chain 18 で、rand v0.6.7 を使った program deploy の出力(2026-09-30):

proving the spend authorisation on this machine (tier 10; seconds)…
authorisation proved in 6.8s: tier 10, 1368908 bytes
proving the bundle (tier 14; about a minute and a half on a laptop)…
proved in 116.7s: tier 14, 1500710 bytes
submitted deploy <hash>
  0 RAND out, 59.8545 RAND change, fee 0.1007 RAND, anchored at height 97831, proved in 116.7s (bundle) + 6.8s (auth)

call は、コールの証明の前にガスと手数料を表示し、続いて支払いバンドルを同じ方法で証明します。

proving the call locally (90 inputs stay private, over the program's 11-word public input)…
gas: 5636 (declaring 6144, tier 12)
fee 0.006191437 RAND (incl. two price steps of headroom)
proved in 29.2s: tier 12, 3346865 bytes, outputs [...]

ここでの 6,144 は、5,636 を 2^10 の倍数に切り上げた値です。rand fee call 12 --gas 6144 --bytes <B> は、この上限を、余裕を持たせずにチップ時点の価格で見積もります。

rand-prover

独立したバイナリとしての委任プローバーです。別のマシン上でウォレットの tier-14 バンドル証明を作成します。rand-node run --prover は、同じサービスをノード内でホストします。すべてのサブコマンドは --home <DIR>(環境変数 RAND_PROVER_HOME、デフォルトは ~/.rand-prover)を取ります。これは prover.key.json と pairings.json を置くディレクトリです。

chain 20 のプローバーが受け取るのは、ウォレットのビューイングキー nk と新しいソルトです。プローバーは資金を使うことはできませんが、そのウォレットがこれまでに受け取ったもの、送ったものをすべて読むことができます。履歴を見せてもよい相手のプローバーとペアリングしてください。ウォレットは、返ってきたすべての証明を検証します。

鍵ファイルの形式

ノード鍵:

{ "seed": "hex of 32 bytes", "address": "base58 of blake3(\"rand-address\" || public key)", "public_key": "hex of 1312-byte Dilithium2 public key" }

ウォレット鍵、バージョン 2:

{ "version": 2, "spend_key": "hex of 8 little-endian u32 words (64 characters)" }

rand keygen はこれをモード 0600 で書き込みます。v0.6.8 以降、すべての rand コマンドは、グループまたはその他のユーザーが読み取れるウォレット鍵ファイルを拒否します。手作業でコピーまたは復元した鍵は、0600 に戻さなければなりません(chmod 600 <key>)。ウォレット鍵を失うと、その鍵で開けたすべてのノートを失います。このリリースにはリカバリーフレーズがありません。