Фармат каманд
Кожная аперацыя PiNS — гэта экранаваная транзакцыя PIVX на пратакольны адрас рэгістратара, дзе сума з'яўляецца плацяжом, а memo — падпісанай камандай. І тое і другое едзе ў адной ноце, таму намер і аплата звязаныя непарыўна: супастаўляць асобныя спасылкі ці рахункі не трэба.
Гэтая старонка апісвае дакладны фармат перадачы. Каманда, пабудаваная па ім, будзе прынятая і рэгістратарам, і схемай з нулявым разгалошваннем.
Будова
Усе каманды — гэта ASCII з падзельнікамі-двукроп'ямі, якія пачынаюцца з маркера пратакола і версіі:
PiNS:1:{OP}:{name}:…:{ed25519_pubkey_hex}:…:{nonce}:{signature_hex}
Палі паміж імі залежаць ад аперацыі:
| Аперацыя | Структура memo | Аплачваемая сума |
|---|---|---|
REG рэгістрацыя | PiNS:1:REG:{name}:{address}:{pubkey}:{nonce}:{sig} | плата за рэгістрацыю па даўжыні імя |
UPD змена адраса | PiNS:1:UPD:{name}:{address}:{pubkey}:{nonce}:{sig} | плата за змяненне |
CHG перадача правоў | PiNS:1:CHG:{name}:{new_pubkey}:{nonce}:{sig} | плата за змяненне |
LST выставіць на продаж | PiNS:1:LST:{name}:{pubkey}:{price}:{nonce}:{sig} | плата за змяненне |
ULT зняць з продажу | PiNS:1:ULT:{name}:{pubkey}:{nonce}:{sig} | плата за змяненне |
BUY пакупка | PiNS:1:BUY:{name}:{address}:{pubkey}:{nonce}:{sig} | роўна выстаўленая цана |
Для CHG поле {new_pubkey} — гэта ключ прымальнага ўладальніка, а подпіс робіць
перадаючы ўладальнік: перадачу санкцыянуе менавіта цяперашні ўладальнік.
Падпісваемае паведамленне
Подпіс пакрывае каманду без завяршальнага :{signature} — гэта значыць усё ад маркера да
nonce уключна:
PiNS:1:REG:richard.pivx:ps1f84lvgj…:0101…0101:1780000001
Правілы тут дакладныя, і кліент, які парушыў любое з іх, атрымае подпіс, які схема адхіліць:
pubkey— малы hex, 64 сімвалы.priceпрысутнічае толькі ўLST.addressпрысутнічае толькі ўREG,UPDіBUY.priceіnonce— дзесятковыя, без вядучых нулёў, без знака і без дапаўнення.- Подпіс — Ed25519 па роўна гэтых байтах, у hex-кадаванні, 128 сімвалаў.
Праверка строгая: неканічныя подпісы і ключы малога парадку адхіляюцца.
Правілы палёў
Імя
| Правіла | Значэнне |
|---|---|
| Сімвалы | a-z, 0-9, дэфіс |
| Даўжыня | 1–64 сімвалы разам з зонай |
| Рэгістр | толькі ніжні — імя захоўваецца і хэшуецца ў ніжнім рэгістры |
| Дэфісы | не ў пачатку, не ў канцы, ніколі запар |
| Зоны | .pivx, .private, .secure, .safe |
Дапускаецца роўна адна кропка, якая аддзяляе метку ад зоны.
Мэтавы адрас
Адрас, у які вырашаецца імя, мусіць быць экранаваным плацёжным адрасам PIVX Sapling
асноўнай сеткі — bech32, чытэльны прэфікс ps, роўна 78 сімвалаў. Празрыстыя і любыя
іншыя адрасы не прымаюцца.
Даўжыня не адвольная. Плацёжны адрас Sapling — гэта 43 байты карыснай нагрузкі: 11-байтавы
дыверсіфікатар плюс 32-байтавы pk_d, што ў bech32 кадуецца 69 сімваламі даных плюс
6-сімвальная кантрольная сума, гэта значыць ps + падзельнік + 69 + 6 = 78.
Гэта правіла самога пратакола: індэксатар і схема ўжываюць яго аднолькава і яшчэ патрабуюць адрас у ніжнім рэгістры — кантрольная сума Bech32 не ўлічвае рэгістр, таму інакш два напісанні аднаго адраса далі б два розныя лісты дрэва. Яно не звязана з тым, як плаціць рэгістратар: вяртанні і выручка ад продажаў ніколі не ідуць на адрас, на які паказвае імя, а залічваюцца на ўнутраны баланс ключа Ed25519, адкуль іх выводзіць уладальнік ключа.
Прымаецца толькі сучасная форма bech32
Старая тэставая форма ptestsapling… (88 сімвалаў) адхіляецца ў абедзвюх сетках, і схема
патрабуе таго ж, што і рэгістратар. Любы сучасны гаманец PIVX выдае ў асноўнай сетцы форму
ps….
Nonce
Nonce — гэта часавая пазнака Unix у секундах на момант падпісання.
- Ён мусіць быць строга большым за nonce, запісаны для гэтага імя зараз. Менавіта гэта прадухіляе паўторнае выкарыстанне старой падпісанай каманды.
- Ён не можа апярэджваць блок, які яго нясе, больш чым на 300 секунд — гэтага хапае, каб паглынуць звычайнае разыходжанне гадзіннікаў, але не дазваляе задаць nonce далёка ў будучыні.
Для першай рэгістрацыі падыдзе любая бягучая часавая пазнака.
Каманда, nonce якой не большы за запісаны, адхіляецца, а яе плацёж вяртаецца на ваш унутраны баланс, вывад з якога каштуе 5% сэрвіснай камісіі. Так бывае, калі гадзіннік адстае, або калі дзве каманды для аднаго імя падпісаны ў межах адной секунды. Таму бярыце большае з бягучага часу і апошняга nonce імя плюс адна секунда, дзе апошні nonce — гэта nonce, які вяртае вырашэнне імя, або nonce вашай каманды для гэтага імя, што яшчэ чакае апрацоўкі, у залежнасці ад таго, што пазней.
Цана
Цану нясе толькі LST. Гэта цэлы лік сатошы (1 PIVX = 100 000 000 сатошы), і ён мусіць быць
большым за нуль.
Паўторна выставіць ужо выстаўленае імя па новай цане можна — адпраўце яшчэ адну каманду LST.
Перамагае апошняя.
Абмежаванне памеру
Memo ў PIVX займае роўна 512 байт, і ўся каманда мусіць у іх змясціцца. Фіксаваныя часткі расходуюць прадказальны аб'ём:
PiNS:1:{OP}: … marker, version, operation 11 bytes
{pubkey} 64 hex characters 65 bytes with separator
{nonce} 10 digits today 11 bytes with separator
{signature} 128 hex characters 128 bytes
{address} 78 characters 79 bytes with separator
Адрас Sapling заўсёды займае роўна 78 сімвалаў, таму, у адрозненне ад фармату са зменнай даўжынёй, бюджэт лёгка прасачыць: на імя застаецца каля 218 байт — нашмат больш за максімум у 64 сімвалы, які імя наогул можа заняць. На практыцы каманда заўсёды змяшчаецца. Кліентам усё ж варта вылічваць бюджэт, а не спадзявацца на яго ўсляпую, каб будучае поле ніколі не перапоўніла memo незаўважна.
Аплата
Сума вызначае карэктнасць не менш, чым memo:
REGмусіць аплаціць роўна плату за рэгістрацыю для дадзенай даўжыні імя.UPD,CHG,LST,ULTмусяць аплаціць роўна плату за змяненне.BUYмусіць аплаціць роўна выстаўленую цану.
Даўжыня лічыцца па метцы, без уліку зоны: ab.pivx — гэта імя з 2 сімвалаў.
Каманда з недаплатай ці пераплатай не апрацоўваецца, як і memo, што не праходзіць праверку
фармату ці подпісу. Абодва вяртаюцца на ваш унутраны баланс, калі плацеж складае не менш за
0.01 PIVX і memo яшчэ чытаецца настолькі: загаловак PiNS:1:, вядомая аперацыя і сапраўдны
публічны ключ — для CHG імя, якое існуе. CHG называе новага ўладальніка, а не таго, хто
падпісаў, таму вяртанне па ім ідзе таму ўладальніку імя, які яго падпісаў, а CHG, які не
падпісаў ніводзін уладальнік, не вяртаецца. Вяртанні залічваюцца пасля 120 пацверджанняў, і
потым іх можна вывесці — гл. Пытанні і адказы.
Плацеж з memo, у якім ёсць хоць адзін сімвал па-за друкаваным ASCII, аўтаматычна не вяртаецца, колькі б ён ні плаціў, як і плацеж меншы за 0.01 PIVX: пра такія плацяжы паведамляецца камандзе PIVX Name — гл. Пытанні і адказы.
Парадак апрацоўкі
Каманды апрацоўваюцца ў тым парадку, у якім іх стварыў PIVX: па вышыні блока, затым па індэксе транзакцыі ўнутры блока. Рэгістратар не выбірае парадак і не можа яго пераставіць так, каб кожны незалежны індэксатар не вылічыў пры гэтым іншы корань.
Транзакцыя нясе адну каманду: першы з яе выхадаў на адрас рэгістратара, па індэксе выхаду, memo якога — правільна складзеная каманда. Іншыя выхады на адрас рэгістратара ў той жа транзакцыі не апрацоўваюцца і аўтаматычна не вяртаюцца, таму адпраўляйце кожную каманду асобнай транзакцыяй.
Для канкуруючых аперацый — двух REG на адно імя ці двух BUY па адным аб'яўленні — перамагае
першая ў гэтым парадку, а астатнім сродкі вяртаюцца на ўнутраны баланс.
Разабраны прыклад
Рэгістрацыя richard.pivx:
1. Generate an Ed25519 keypair. The public key is your identity across all your names.
2. Build the message to sign (note: no trailing signature field):
PiNS:1:REG:richard.pivx:ps1f84lvgj0awz…:3757ee1a…a53:1780000001
3. Sign it with the private key; hex-encode the 64-byte signature.
4. Append it to form the memo:
PiNS:1:REG:richard.pivx:ps1f84lvgj0awz…:3757ee1a…a53:1780000001:cfec7a58…04
5. Send a shielded transaction to the registrar address, with that memo, paying the
registration fee for a 7-character name.
Калі плацеж набярэ 40 пацверджанняў — гэта каля 40 хвілін, — каманда трапляе ў наступны пакет,
які закрываецца прыкладна праз дзесяць хвілін, а потым даказваецца і замацоўваецца ў блокчэйне.
З гэтага моманту richard.pivx вырашаецца праз любы індэксатар, прычым з доказам Меркла, які
вы можаце праверыць самі.