Baris arahan

Tiga binari terhasil daripada cargo build --release: rand-node (nod dan perintah operator), rand (dompet terlindung) dan rand-prover (pembukti yang diwakilkan). Setiap perintah menerima -h/--help. Halaman ini menerangkan keluaran v0.6.8 (c9c9bd3c), iaitu binaan yang dijalankan oleh chain 20; jika v0.6.7 berfungsi secara berbeza, halaman ini menyatakannya. Dompet rand yang lebih lama daripada v0.6.8 tidak dapat menghantar pada chain 20, yang genesisnya mengikat setiap bukti dan mesej bertandatangan kepada hashnya. Dua yang pertama memegang jenis kunci yang berbeza: kunci nod ialah pasangan kunci Dilithium2 yang menandatangani blok; kunci dompet ialah kunci belanja terlindung yang tidak menandatangani apa-apa pada chain.

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 dan bridge-gov ialah ciri baharu dalam v0.6.8. Tiada balance dan tiada transfer: pemindahan memerlukan kunci belanja terlindung, yang hanya dipegang oleh dompet.

Satu bendera global, --allow-test-fri-profile (atau RAND_ALLOW_TEST_FRI_PROFILE=1), membolehkan init, run dan verify menerima genesis yang fri_profilenya ialah test. Profil itu memberikan kira-kira 17 bit kesahihan (soundness), dan sesiapa yang menulis fail genesis boleh menamakannya, maka sejak v0.6.8 nod menolak genesis sedemikian tanpa bendera tersebut. Suite ujian menetapkannya; tiada yang lain patut berbuat demikian.

keygen, address

keygen menulis { "seed": <32-byte hex>, "address": <base58>, "public_key": <hex> } dengan mod 0600. Fail itu ialah satu-satunya salinan seed. Sejak v0.6.8 keygen menolak --out yang sudah wujud (… already exists or cannot be created; refusing to overwrite a key file) dan membiarkannya tidak disentuh; tiada --force, jadi alihkan fail lama ke tempat lain untuk menggantikannya. v0.6.7 dan yang terdahulu menimpanya tanpa bertanya. address mencetak address, public_key (1,312 bait hex) dan peer_id.

genesis

Mencetak satu baris alloc bagi setiap --alloc, kemudian hash genesis, bilangan validator dan nota, panjang epoch, lima had, hc_bundle dan hc_auth (none tanpa --auth-guest), kemudian baris gas: gas: price P/gas, B/KiB, bundle limit N, dynamic: target … B / … gas, adjust … bps, floor …/…, ceiling …/…, byte load all|paying, atau gas: none tanpa --gas-price, dan dengan --program-state-cell-fee satu baris program_state: cell fee N RAND. init mencetak baris gas yang sama. Kelima-lima bendera had berfungsi dengan cara yang sama: jika ditinggalkan, fail tidak mempunyai medan sedemikian dan chain menjalankan nilai lalai; jika diberikan, medan itu menjadi sebahagian daripada hash genesis walaupun pada nilai lalainya. Chain 20 dipotong dengan bendera ini (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

Rantaian 18 dan 19 dipotong dengan bendera yang sama sehingga --envelope-bytes 1860, dan tanpa mana-mana bendera v0.6.8. Had bukti ialah 4 MiB, turun daripada 8 MiB bagi rantaian 13 hingga 16: satu transaksi kebenaran terpisah membawa sehingga tiga bukti, dan 3 × 4 MiB + 1 MiB muat dalam blok 20 MiB. tokens.json mengandungi registration_fee sebanyak 1 RAND, mint_cap_per_day sebanyak 10000000000000, max_tokens 4096, burn_registration_fee dan bound_note_value, serta zUSD disenaraikan bersama tujuh sandarannya. Tiada bendera --bridge, dan skrip pemotongan masih menyambung bahagian bridge, staking dan consensus_domain ke dalam fail selepas itu (pada rantaian 20: jambatan pada set penjaga 1 dengan lapan kunci penjaga PQ, kunci jeda, rules_v2, rotation dan fees; bahagian staking dengan senarai kebenaran faucet, admission_by_vote dan bajet kemasukan 2,500 bps; consensus_domain: 1; dan nota genesis zUSD, yang dibuat dengan alloc-note --asset 1 --envelope-bytes 1860). Cincangan genesis yang diambil kira ialah yang dicetak oleh init pada fail yang telah siap.

Setiap --alloc membina satu nota deposit dengan keacakan komitmen yang baharu, maka memotong dua kali menghasilkan dua cincangan yang berbeza. Perintah ini sentiasa menulis bukaan nota di sebelah cm dan amount, yang diperlukan oleh rantaian yang mempunyai bahagian 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>" } }
]

Pemilik dan jumlah nota genesis oleh itu awam secara reka bentuk setelah fail diterbitkan; hanya bila dan ke dalam apa ia dibelanjakan kemudian kekal persendirian. Potong genesis sekali sahaja dan simpan failnya.

alloc-note

--to <rand1…> (diperlukan), --amount <N> (diperlukan), --asset <INDEX> (lalai 0), --envelope-bytes <N> (lalai: format warisan). Mencetak satu nota alloc sebagai JSON, yang dimeterai kepada --to seperti yang dilakukan oleh genesis --alloc. Genesis yang menetapkan envelope_bytes menolak nota yang dimeterai tanpa --envelope-bytes yang sepadan. --amount adalah dalam unit penuh aset: sembilan perpuluhan untuk RAND, lapan untuk token yang dijambatankan (10 pada aset 1 ialah 10 zUSD). Nota bagi token yang disenaraikan memerlukan sandaran token itu membawa jumlah locked yang berjumlah tepat sama dengan nota-notanya.

init

Mencetak cincangan genesis dan baris gas: yang sama seperti genesis.

run

Persekitaran: RUST_LOG (lalai info,libp2p=warn,libp2p_mdns=off). Ctrl-C atau SIGTERM menutup nod dengan bersih.

Titik akhir awam https://rpc.randprotocol.org ialah proksi senarai kebenaran di hadapan nod arkib; sejak 2026-10-01 senarai kebenarannya ialah set kaedah pendengar awam.

safety

Keadaan keselamatan konsensus bagi pengesah yang dihentikan (v0.6.8). Setiap perintah membuka direktori data sendiri, maka tiada yang berjalan bersama nod yang aktif.

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 mencetak kepala yang telah dikomit, pandangan dan pandangan yang terakhir diundi, QC tinggi, sama ada pengesah dikunci di atas kepalanya, dan sebarang penghentian keselamatan yang direkodkan. Nod yang melihat tiga-rantai yang diperakui cuba mengomit blok yang tidak diturunkan daripada kepala terkomitnya sendiri berhenti dan merekodkannya (audit v6, CON-5); run kemudian keluar bersama rekod itu sehingga clear-halt. Bandingkan kepala nod ini dengan kepala dua pengesah lain dan segerakkan semula daripada arkib jika ia berbeza sebelum membersihkan. Sejak v0.6.8 (CON-4) tiada kuorum jawapan “tidak dipegang” yang melepaskan kunci lagi: pengesah yang dikunci pada blok yang tidak dapat diperolehnya kekal senyap sehingga cadangan yang justify-nya mengatasi kunci itu tiba atau blok itu diambil. release-lock menurunkan kunci yang dikekalkan kepada perakuan kepala terkomit; gunakannya pada satu pengesah pada satu masa, dan hanya apabila blok itu hilang selama-lamanya. Tanpa bendera pengakuannya, setiap perintah penulisan mencetak apa yang akan dilakukannya dan tidak mengubah apa-apa.

verify

Kod keluar 0 jika konsisten, 2 jika masalah ditemui tanpa --repair.

db

db drop-receipts-index --datadir <DATADIR>, dengan nod dihentikan: gugurkan indeks receipts_by_program sebelum melancarkan balik ke binaan pra-v0.3, yang tidak dapat membuka pangkalan data yang memilikinya. Permulaan kemudian membina semula indeks daripada resit.

status

--rpc <URL> (lalai http://127.0.0.1:8545). Mencetak rand_status secara verbatim.

register, unbond, withdraw

admit sign|submit

Kemasukan melalui undian (v0.6.8). Pada rantaian yang genesisnya menetapkan staking.admission_by_vote, seperti rantaian 20, kunci pengesah baharu hanya didaftarkan setelah pengesah yang memegang lebih daripada dua pertiga berat undian menandatangani kemasukannya.

Calon ialah kunci yang akan dibawa oleh pendaftaran; rand-node address --key mencetaknya, dan heks yang dicetak oleh register memuatkannya. Selepas kemasukan itu disahkan, ikatan berjalan seperti biasa (rand bond … --registration) dan menggunakan kemasukan tersebut. rand_getAdmitted menyenaraikan pengesah yang telah diterima masuk dan sedang menunggu.

bridge-gov

Putaran pasca-kuantum jambatan (v0.6.8), untuk penjaga dan pemegang kunci jeda. Setiap langkah membaca id rantaian, domain pengikatnya dan rand_getBridgeState.rotation_nonce daripada --rpc (lalai http://127.0.0.1:8545).

--new-key ialah kunci awam Dilithium2 heks, @file yang memuatkannya, atau @key-file (kunci awamnya). Baris tandatangan berbentuk index:hex, dipisahkan dengan ruang kosong atau baris baharu, dan komen # dibenarkan.

vesting status|claim|revoke|bond|unbond

Bahagian pemegang dan pembatal bagi peruntukan genesis berkunci masa, pada rantaian yang genesisnya mempunyai bahagian vesting. Genesis rantaian 20 tidak mempunyainya. Kunci ialah fail rand-node keygen.

aggregator register|unbond|withdraw, aggregate

Arahan bagi peranan pengagregat untuk rantaian yang mempunyai bahagian aggregation: aggregator register --key --bond <RAND> --payout <rand1…> --rpc mencetak AggregatorRegistration yang ditandatangani; aggregator unbond dan aggregator withdraw mencerminkan pasangan arahan pengesah. aggregate --key <KEY> [--rpc <URL>] [--watch] [--interval-secs 15] [--no-wait] ialah daemon yang meninjau rand_getUnsealed, membuktikan satu agregat dan menyerahkannya. Tidak aktif pada rantaian 20, yang genesisnya tidak mempunyai bahagian aggregation.

rand (dompet)

Pilihan global, sebelum atau selepas subarahan:

Jumlah ialah RAND perpuluhan dengan sehingga sembilan tempat perpuluhan (1, 1.5, .25, 0.000000001). Jumlah token pada send, token mint dan token burn, dan dalam pautan randpay:, adalah dalam unit paparan token itu, pada decimals baris daftarnya sendiri (10 zUSD ialah 10 zUSD). bridge-burn, token create --fixed-supply dan --initial menerima integer biasa dalam unit terkecil token, dan asset-balance mencetaknya. Di mana-mana arahan menerima token, ia menerima indeks daftar, id rpl1… atau id 64-heks; id diselesaikan kepada indeksnya daripada senarai daftar keseluruhan nod (rand_getTokens, setiap halaman), tidak sekali-kali melalui carian bagi setiap token, yang akan memberitahu nod token mana yang bakal dipindahkan. Indeks berangka tidak sampai kepada nod langsung.

--cuda memerlukan binaan dengan --features cuda dan tiada pilihan sandaran; belum ada PTX yang dibina. Ia tidak dapat menyegel sampul input panggilan: rand call --cuda memerlukan --no-envelope. Ia hanya mengisytiharkan siling gas, dan menolak --gas-limit N.

Setiap memo dan nama kenalan yang dipaparkan oleh CLI (pengesahan send, notes, history, tx-key) melalui satu peraturan paparan terlebih dahulu: aksara kawalan, aksara format Unicode (kawalan dwiarah, aksara lebar sifar, tanda sempang lembut) dan U+2028/U+2029 dipaparkan sebagai U+FFFD, dan satu rentetan aksara pemisah ruang dipaparkan sebagai satu ruang.

Pemindahan terlindung pertama

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

Berkongsi alamat, dan memo

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

Memo berada di dalam badan tersegel yang sama dengan nota, jadi sesiapa yang dapat membuka salah satunya dapat membuka yang lain: penerima bayaran melalui notes, dan sesiapa yang memegang kunci per-transaksi bagi output tersebut melalui rand_checkTransaction <hash> <key>. Chain 18 ialah chain pertama yang genesisnya menetapkan envelope_bytes; pada chain 14 hingga 17, --memo ditolak sebelum sebarang pembuktian dibuat.

Panggilan sulit yang boleh anda buka semula kemudian

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)

Atur cara berkeadaan: pembilang RPL-2

Pada chain yang mempunyai bahagian program_state, seperti chain 20. Pembilang ini menerima tepat transisi yang membaca satu sel dan menulisnya semula dengan perkataan pertamanya ditambah satu; segala yang lain dalam transisi itu (apa yang didepositkan oleh bundle, apa yang dibayar oleh vault, apa yang dicetak oleh atur cara) turut dibawa tanpa disemak, menjadikannya demonstrasi dan bukan atur cara untuk meletakkan nilai di belakangnya.

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)

Tanda … dalam fail itu mewakili 64 aksara heks penuh, yang diperlukan oleh dompet.

Apa yang dicetak oleh deploy dan call

Pada chain dengan pengesahan terpisah, setiap bundle ialah dua bukti yang dibuat pada mesin ini: pengesahan perbelanjaan tier-10 dan bundle tier-14. Satu program deploy dengan rand v0.6.7 pada chain 18, 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)

Satu call mencetak gas dan failnya sebelum bukti panggilan, kemudian membuktikan bundle pembayar dengan cara yang sama:

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 [...]

Di sini 6,144 ialah 5,636 yang dibundarkan ke atas kepada gandaan 2^10, dan rand fee call 12 --gas 6144 --bytes <B> meletakkan harga had itu pada harga di hujung rantaian tanpa ruang lebihan.

rand-prover

Prover yang diwakilkan sebagai binari tersendiri: ia membuat bukti bundle tier-14 sesebuah dompet pada mesin lain. rand-node run --prover menjalankan perkhidmatan yang sama di dalam nod. Setiap subperintah menerima --home <DIR> (env RAND_PROVER_HOME, lalai ~/.rand-prover), iaitu direktori yang menyimpan prover.key.json dan pairings.json.

Prover pada chain 20 menerima kunci pemerhatian nk dompet dan satu salt baharu. Ia tidak dapat membelanjakan, tetapi ia dapat membaca segala yang pernah diterima atau dihantar oleh dompet itu: pasangkan dengan prover yang sejarah anda boleh anda tunjukkan kepadanya. Dompet menyemak setiap bukti yang diterimanya semula.

Format fail kunci

Kunci nod:

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

Kunci dompet, versi 2:

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

rand keygen menulisnya dengan mod 0600, dan sejak v0.6.8 setiap perintah rand enggan menerima fail kunci dompet yang boleh dibaca oleh kumpulan atau pihak lain: kunci yang disalin atau dipulihkan secara manual mesti dikembalikan kepada 0600 (chmod 600 <key>). Kehilangan kunci dompet bermakna kehilangan setiap nota yang dapat dibukanya; tiada frasa pemulihan dalam keluaran ini.