د کمانډ کرښه

له cargo build --release څخه درې باینري لاسته راځي: rand-node (نوډ او د چلوونکي کمانډونه)، rand (پټ والټ) او rand-prover (سپارل شوی ثبوت جوړوونکی). هر کمانډ -h/--help مني. دا پاڼه د v0.6.8 خپرونه (c9c9bd3c) بیانوي، هغه جوړښت چې زنځیر 20 پرې چلېږي؛ چېرې چې v0.6.7 بل ډول چلند کاوه، دا پاڼه یې یادوي. له v0.6.8 څخه زوړ rand والټ په زنځیر 20 کې نشي لېږلی، ځکه د دې زنځیر پیدایښت هر ثبوت او هر لاسلیک شوی پیغام له خپل هش سره تړي. لومړۍ دوه باینري بېل ډوله کیلي ساتي: د نوډ کیلي د 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 نشته: لېږد د پټ لګښت کیلي ته اړتیا لري، چې یوازې والټ یې ساتي.

یو عمومي بیرغ، --allow-test-fri-profile (یا RAND_ALLOW_TEST_FRI_PROFILE=1)، init، run او verify ته اجازه ورکوي چې هغه پیدایښت ومني چې fri_profile یې test وي. دا پروفایل شاوخوا 17 بټه سموالی لري، او هر څوک چې د پیدایښت فایل لیکي کولی شي هغه پکې وټاکي، نو له v0.6.8 راهیسې نوډ پرته له دې بیرغ څخه داسې پیدایښت ردوي. د ازموینې سویټونه یې ټاکي؛ بل هېڅ شی باید یې ونه ټاکي.

keygen، address

keygen د 0600 حالت سره { "seed": <32-byte hex>, "address": <base58>, "public_key": <hex> } لیکي. دا فایل د تخم یوازینۍ کاپي ده. له 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 (1,312 بایټه hex) او peer_id چاپوي.

genesis

د هر --alloc لپاره یوه alloc کرښه چاپوي، بیا د پیدایښت هش، د تصدیقوونکو او نوټونو شمېر، د دورې اوږدوالی، پنځه پولې، 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 همدا د ګاز کرښه چاپوي. د پولو پنځه بیرغونه یو ډول چلند کوي: که پرېښودل شي، فایل داسې ساحه نه لري او زنځیر ډیفالټ چلوي؛ که ورکړل شي، ساحه د پیدایښت د هش برخه ده حتی په ډیفالټ ارزښت کې هم. زنځیر 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 له فلګونو څخه یې هیڅ یو نه درلود. د ثبوت سقف 4 MiB دی، چې د 13 تر 16 زنځیرونو له 8 MiB څخه راټیټ شوی: د ویشل شوې اجازې یوه معامله تر درېیو ثبوتونو پورې لېږدوي، او 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 پکې د خپلو اوو ملاتړونو سره لېست شوی. د --bridge هیڅ فلګ نشته، او د جوړولو سکرېپټ لا هم وروسته د bridge، staking او consensus_domain برخې په فایل کې ورګډوي (په 20 زنځیر کې: پل د ساتونکو په 1 ټولګه کې د اتو PQ ساتونکو کیلیو سره، د درولو کیلي، rules_v2، rotation او fees؛ د staking برخه د فاسېټ د اجازې لېست، admission_by_vote او د 2,500 bps د ننوتلو بودیجې سره؛ consensus_domain: 1؛ او د zUSD د جنیسس نوټونه، چې د alloc-note --asset 1 --envelope-bytes 1860 په واسطه جوړ شوي). هغه جنیسس هش چې اعتبار لري هغه دی چې init یې په بشپړ شوي فایل چاپوي.

هر --alloc د تعهد له تازه تصادفیت سره د زېرمې یو نوټ جوړوي، نو دوه ځله جوړول دوه بېل هشونه ورکوي. کمانډ تل د نوټ پرانیستنه د cm او amount تر څنګ لیکي، چې هغه زنځیر ورته اړتیا لري چې 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>" } }
]

له همدې امله، کله چې فایل خپور شي، د جنیسس نوټ مالک او مقدار په قصدي ډول عامه دي؛ یوازې دا چې وروسته کله او په څه کې لګول کېږي پټ پاتې کېږي. جنیسس یو ځل جوړ کړئ او فایل وساتئ.

alloc-note

--to <rand1…> (اړین)، --amount <N> (اړین)، --asset <INDEX> (ډیفالټ 0)، --envelope-bytes <N> (ډیفالټ: زوړ بڼه). د تخصیص یو نوټ د JSON په بڼه چاپوي، چې --to ته مهر شوی وي، لکه څنګه چې genesis --alloc یو نوټ مهر کوي. هغه جنیسس چې envelope_bytes ټاکي، هغه نوټ ردوي چې د اړوند --envelope-bytes پرته مهر شوی وي. --amount د شتمنۍ په بشپړو واحدونو دی: د RAND لپاره نهه اعشاریې، د پل شوي ټوکن لپاره اته (10 په 1 شتمنۍ کې 10 zUSD دی). د لېست شوي ټوکن نوټ اړتیا لري چې د هغه ټوکن ملاتړونه داسې locked مقدارونه ولري چې مجموعه یې دقیقاً د هغه له نوټونو سره برابره وي.

init

د جنیسس هش او هماغه gas: کرښه چاپوي چې genesis یې چاپوي.

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، لوړ QC، دا چې آیا تاییدوونکی له خپل سر څخه پورته قفل دی، او هر ثبت شوی د خوندیتوب درېدل چاپوي. هغه نوډ چې وویني یو تصدیق شوی درې‌ګونی زنځیر هڅه کوي داسې بلاک ژمن کړي چې د هغه له خپل ژمن شوي سر څخه نه وي راوتلی، درېږي او دا ثبتوي (audit v6, CON-5)؛ بیا run له دې ثبت سره وځي تر هغه چې clear-halt وچلول شي. د پاکولو مخکې د دې نوډ سر د دوو نورو تاییدوونکو له سر سره پرتله کړئ، او که توپیر یې درلود له یوه آرشیف څخه بیا همغږي کړئ. له v0.6.8 راهیسې (CON-4) د “نه ساتل کېږي” ځوابونو هیڅ کوروم نور قفل نه خلاصوي: هغه تاییدوونکی چې په داسې بلاک قفل وي چې ترلاسه یې نشي کولی، تر هغه چوپ پاتې کېږي چې یو وړاندیز راشي چې justify یې له قفل څخه لوړ وي، یا بلاک راوړل شي. release-lock خوندي شوی قفل د ژمن شوي سر تر تصدیق‌لیک پورې ښکته کوي؛ په یو وخت کې یې یوازې په یوه تاییدوونکي وکاروئ، او یوازې هغه وخت چې بلاک د تل لپاره ورک شوی وي. د خپل تایید فلګ پرته هر لیکونکی کمانډ چاپوي چې څه به وکړي او هیڅ شی نه بدلوي.

verify

د وتلو کوډ 0 که همغږی وي، 2 که د --repair پرته کومه ستونزه وموندل شوه.

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 زنځیر، د تاییدوونکي نوې کیلي یوازې هغه وخت ثبتېږي چې هغو تاییدوونکو یې د منلو لاسلیک کړی وي چې په ټولیز ډول د رایې له وزن څخه له دوو پر دریو څخه زیات ولري.

نوماند هغه کیلي ده چې ثبت به یې له ځانه سره لري؛ rand-node address --key یې چاپوي، او هغه hex چې register چاپ کړی هم دا کیلي لري. کله چې منل ثبت شي، ګرو لکه د پخوا په شان کېږي (rand bond … --registration) او منل لګوي. rand_getAdmitted هغه کیلي لیست کوي چې منل شوې دي او په تمه دي.

bridge-gov

د پُل د کوانټم‌ضد کیلیو بدلونونه (v0.6.8)، د ساتونکو او د درولو د کیلي د لرونکي لپاره. هر ګام د زنځیر id، د هغه د تړلو ډومېن او rand_getBridgeState.rotation_nonce له --rpc څخه لولي (اصلي ارزښت http://127.0.0.1:8545).

--new-key د Dilithium2 یوه hex عامه کیلي ده، @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 پوښتي، یو راټول ثبوت جوړوي او سپاري یې. د 20 په زنځیر کې غیر فعال دی، ځکه پیدایښت یې aggregation برخه نه لري.

rand (والټ)

عمومي اختیارونه، د فرعي فرمان مخکې یا وروسته:

مقدارونه لسیز RAND دي چې تر نهو لسیزو ځایونو پورې لري (1، 1.5، .25، 0.000000001). د نښې مقدار په send، token mint او token burn کې، او په randpay: لینک کې، د نښې د ښودلو په واحدونو دی، د هغې د راجستر د قطار د خپل decimals سره سم (10 د zUSD یعنې 10 zUSD). bridge-burn، token create --fixed-supply او --initial د نښې په تر ټولو کوچني واحد کې ساده بشپړ عددونه اخلي، او asset-balance یې چاپوي. هر چېرې چې یو فرمان نښه اخلي، د راجستر شمېره، د rpl1… id یا 64-hex id مني؛ id د نوډ له ټول راجستر لیست څخه (rand_getTokens، هره پاڼه) خپلې شمېرې ته اړول کېږي، هېڅکله د یوې نښې په جلا پلټنه نه، ځکه هغه به نوډ ته وښيي چې کومه نښه د حرکت په حال کې ده. عددي شمېره هېڅکله نوډ ته نه رسېږي.

--cuda د --features cuda سره جوړ شوي build ته اړتیا لري او هېڅ بدیل نه لري؛ تر اوسه هېڅ PTX نه دی جوړ شوی. دا د call-input envelope مهرول نه شي کولی: rand call --cuda --no-envelope ته اړتیا لري. دا یوازې د ګاز پورتنی حد اعلانوي، او --gas-limit N ردوي.

هر memo او د اړیکې نوم چې CLI یې چاپوي (د send تایید، notes، history، tx-key) لومړی د نندارې له یوه قاعدې تېرېږي: کنټرولي توري، د Unicode د بڼې توري (bidi کنټرولونه، صفر-پلن توري، soft hyphen) او U+2028/U+2029 د U+FFFD په توګه ښودل کېږي، او د فاصلې جلاکوونکو لړۍ د یوې فاصلې په توګه.

لومړۍ خوندي لېږد

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

د پتې شریکول، او 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 د نوټ سره په هماغه مهر شوي بدنه کې پروت دی، نو څوک چې یو یې پرانیستلی شي، بل یې هم پرانیستلی شي: ترلاسه کوونکی د notes له لارې، او هر هغه څوک چې د هغه output د هرې معاملې کیلي ولري د rand_checkTransaction <hash> <key> له لارې. Chain 18 لومړی chain دی چې genesis یې envelope_bytes ټاکي؛ په 14 تر 17 chainونو کې --memo مخکې له دې چې څه ثابت شي رد کېده.

محرمانه call چې وروسته یې بیا پرانیستلی شئ

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 شمېرونکی

په داسې chain کې چې program_state برخه ولري، لکه chain 20. شمېرونکی یوازې هغه لېږدونه مني چې یوه cell لولي او بېرته یې د لومړۍ کلمې جمع یو سره لیکي؛ په لېږد کې نور هر څه (څه چې bundle زېرمه کوي، څه چې vault ورکوي، څه چې پروګرام mint کوي) بې له څارنې ورسره تېرېږي، چې دا یې یوه نمایشي بېلګه ګرځوي، نه داسې پروګرام چې ارزښت پرې وتړل شي.

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 hex تورو پر ځای ولاړ دي، چې wallet یې غواړي.

deploy او call څه چاپوي

په split-authorisation chain کې هر bundle دوه ثبوتونه دي چې په همدې ماشین جوړېږي: د tier-10 د لګښت اجازه او د tier-14 bundle. د rand v0.6.7 سره په chain 18 کې یو 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 خپل ګاز او فیس د call له ثبوت مخکې چاپوي، بیا ورکوونکی bundle په همدې ډول ثابتوي:

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> دا حد د tip په بیو، پرته له اضافي حاشیې، بیه کوي.

rand-prover

ګمارل شوی ثابتوونکی د خپل جلا binary په توګه: دا د یوه wallet د tier-14 bundle ثبوت په بل ماشین جوړوي. rand-node run --prover همدا خدمت د یوه node دننه کوربه کوي. هر فرعي امر --home <DIR> اخلي (env RAND_PROVER_HOME، default ~/.rand-prover)، هغه لارښود چې prover.key.json او pairings.json ساتي.

په chain 20 کې ثابتوونکی د wallet viewing key nk او یو تازه salt ترلاسه کوي. دا لګښت نه شي کولی، او هر هغه څه لوستلی شي چې هغه wallet کله هم ترلاسه کړي یا لېږلي دي: یوازې له داسې ثابتوونکي سره جوړه شئ چې خپل تاریخچه ورته ښودلی شئ. wallet هر هغه ثبوت چې بېرته یې ترلاسه کوي تاییدوي.

د کیلي فایل بڼې

د node کیلي:

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

د wallet کیلي، نسخه 2:

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

rand keygen دا د 0600 حالت سره لیکي، او له v0.6.8 راهیسې هر rand امر هغه wallet کیلي فایل ردوي چې group یا other یې لوستلی شي: هغه کیلي چې په لاس کاپي یا بېرته راګرځول شوې وي باید بېرته 0600 ته وټاکل شي (chmod 600 <key>). د wallet کیلي له لاسه ورکول هر هغه نوټ له لاسه ورکوي چې هغې پرانیستلی شو؛ په دې خپرونه کې د بیا رغونې عبارت نشته.