Befehlsformat
Jede PiNS-Operation ist eine abgeschirmte PIVX-Transaktion an die Protokolladresse der Registrierungsstelle, wobei der Betrag die Zahlung und das Memo der signierte Befehl ist. Beides reist in derselben Note, sodass Absicht und Zahlung untrennbar verbunden sind — es gibt keine separate Referenz oder Rechnung, die zugeordnet werden müsste.
Diese Seite beschreibt das exakte Wire-Format. Ein danach gebauter Befehl wird sowohl von der Registrierungsstelle als auch von der Zero-Knowledge-Schaltung akzeptiert.
Aufbau
Alle Befehle sind ASCII mit Doppelpunkten als Trennzeichen und beginnen mit Protokollmarker und Version:
PiNS:1:{OP}:{name}:…:{ed25519_pubkey_hex}:…:{nonce}:{signature_hex}
Die Felder dazwischen hängen von der Operation ab:
| Operation | Memo-Aufbau | Gezahlter Betrag |
|---|---|---|
REG registrieren | PiNS:1:REG:{name}:{address}:{pubkey}:{nonce}:{sig} | Registrierungsgebühr für die Namenslänge |
UPD Adresse ändern | PiNS:1:UPD:{name}:{address}:{pubkey}:{nonce}:{sig} | Änderungsgebühr |
CHG Inhaber übertragen | PiNS:1:CHG:{name}:{new_pubkey}:{nonce}:{sig} | Änderungsgebühr |
LST zum Verkauf anbieten | PiNS:1:LST:{name}:{pubkey}:{price}:{nonce}:{sig} | Änderungsgebühr |
ULT vom Markt nehmen | PiNS:1:ULT:{name}:{pubkey}:{nonce}:{sig} | Änderungsgebühr |
BUY kaufen | PiNS:1:BUY:{name}:{address}:{pubkey}:{nonce}:{sig} | exakt der Angebotspreis |
Bei CHG ist {new_pubkey} der Schlüssel des übernehmenden Inhabers, und die Signatur
stammt vom abgebenden Inhaber — die Übertragung autorisiert der aktuelle Inhaber.
Die signierte Nachricht
Die Signatur deckt den Befehl ohne das abschließende :{signature} ab — also alles vom
Marker bis einschließlich der Nonce:
PiNS:1:REG:richard.pivx:ps1f84lvgj…:0101…0101:1780000001
Die Regeln sind exakt; ein Client, der eine davon verletzt, erzeugt eine Signatur, die die Schaltung zurückweist:
pubkeyist Kleinbuchstaben-Hex, 64 Zeichen.priceerscheint nur beiLST.addresserscheint nur beiREG,UPDundBUY.priceundnoncesind dezimal, ohne führende Nullen, ohne Vorzeichen, ohne Auffüllen.- Die Signatur ist Ed25519 über genau diese Bytes, hex-kodiert, 128 Zeichen.
Die Prüfung ist streng: nicht-kanonische Signaturen und Schlüssel kleiner Ordnung werden abgelehnt.
Feldregeln
Name
| Regel | Wert |
|---|---|
| Zeichen | a-z, 0-9, Bindestrich |
| Länge | 1–64 Zeichen einschließlich der Zone |
| Schreibweise | nur Kleinbuchstaben — ein Name wird kleingeschrieben gespeichert und gehasht |
| Bindestriche | nicht am Anfang, nicht am Ende, nie doppelt |
| Zonen | .pivx, .private, .secure, .safe |
Genau ein Punkt ist erlaubt; er trennt das Label von der Zone.
Zieladresse
Die Adresse, auf die ein Name aufgelöst wird, muss eine abgeschirmte PIVX-Sapling-Zahlungs-
adresse im Mainnet sein — bech32, menschenlesbares Präfix ps, genau 78 Zeichen.
Transparente und alle sonstigen Adressen werden abgelehnt.
Die Länge ist nicht willkürlich. Eine Sapling-Zahlungsadresse ist eine 43-Byte-Nutzlast — ein
11-Byte-Diversifier plus ein 32-Byte-pk_d —, die bech32 als 69 Datenzeichen plus 6 Zeichen
Prüfsumme kodiert, also ps + Trenner + 69 + 6 = 78.
Die Regel gehört zum Protokoll selbst: Der Indexer und die Schaltung wenden sie gleich an und verlangen die Adresse zudem in Kleinbuchstaben — eine Bech32-Prüfsumme ignoriert die Groß- und Kleinschreibung, sonst ergäben zwei Schreibweisen einer Adresse zwei verschiedene Blätter im Baum. Mit der Art, wie die Registrierungsstelle zahlt, hat sie nichts zu tun: Rückerstattungen und Verkaufserlöse gehen nie an die Adresse, auf die ein Name zeigt, sondern auf das interne Guthaben eines Ed25519-Schlüssels, von dem sein Inhaber sie abhebt.
Nur die moderne bech32-Form wird akzeptiert
Die alte Testnet-Form ptestsapling… (88 Zeichen) wird auf beiden Netzen abgelehnt, und die
Schaltung erzwingt dieselbe Regel wie die Registrierungsstelle. Jede aktuelle PIVX-Wallet
erzeugt im Mainnet die ps…-Form.
Nonce
Die Nonce ist ein Unix-Zeitstempel in Sekunden zum Zeitpunkt der Signatur.
- Sie muss strikt größer sein als die aktuell für diesen Namen gespeicherte Nonce. Das verhindert das Wiedereinspielen eines alten signierten Befehls.
- Sie darf dem Block, der sie trägt, um höchstens 300 Sekunden vorauslaufen; das fängt übliche Uhrabweichungen ab, ohne dass eine Nonce weit in der Zukunft geparkt werden kann.
Für eine Erstregistrierung genügt ein beliebiger aktueller Zeitstempel.
Ein Befehl, dessen Nonce nicht größer als die gespeicherte ist, wird abgelehnt, und seine Zahlung geht auf Ihr internes Guthaben zurück, von dem jede Auszahlung eine Servicegebühr von 5 % kostet. Dazu kann eine nachgehende Uhr führen, ebenso zwei Befehle für einen Namen, die innerhalb derselben Sekunde signiert werden. Nehmen Sie daher den späteren Wert aus der aktuellen Zeit und der letzten Nonce des Namens plus eine Sekunde; die letzte Nonce ist die nonce, die die Namensauflösung liefert, oder die eines eigenen Befehls für den Namen, der noch auf seine Verarbeitung wartet, je nachdem, welche später ist.
Preis
Nur LST trägt einen Preis. Er ist eine ganze Zahl in Satoshi (1 PIVX = 100.000.000
Satoshi) und muss größer als null sein.
Einen bereits angebotenen Namen zu einem neuen Preis erneut anzubieten ist erlaubt — senden Sie
ein weiteres LST. Das jüngste gewinnt.
Größenbeschränkung
Ein PIVX-Memo umfasst genau 512 Bytes, und der ganze Befehl muss hineinpassen. Die festen Teile verbrauchen einen vorhersehbaren Anteil:
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
Eine Sapling-Adresse hat feste 78 Zeichen, daher lässt sich das Budget anders als bei einem variabel langen Adressformat leicht überschauen: Für den Namen bleiben rund 218 Byte — weit mehr als die höchstens 64 Zeichen, die ein Name belegen kann. In der Praxis passt ein Befehl immer. Clients sollten das Budget dennoch berechnen statt es anzunehmen, damit ein künftiges Feld das Memo nie unbemerkt überlaufen lässt.
Zahlung
Der Betrag entscheidet ebenso über die Gültigkeit wie das Memo:
REGmuss exakt die Registrierungsgebühr für die Namenslänge zahlen.UPD,CHG,LST,ULTmüssen exakt die Änderungsgebühr zahlen.BUYmuss exakt den Angebotspreis zahlen.
Die Länge wird am Label gemessen, ohne die Zone: ab.pivx ist ein Name mit 2 Zeichen.
Ein zu niedrig oder zu hoch bezahlter Befehl wird nicht verarbeitet, ebenso wenig ein Memo, das
die Format- oder Signaturprüfung nicht besteht. Beides wird Ihrem internen Guthaben erstattet,
wenn mindestens 0.01 PIVX gezahlt wurden und es sich noch so weit lesen lässt: der Kopf
PiNS:1:, eine bekannte Operation und ein gültiger öffentlicher Schlüssel — bei einem CHG
ein Name, der existiert. Ein CHG nennt den neuen Eigentümer statt seines Unterzeichners,
daher geht seine Erstattung an den Eigentümer des Namens, der ihn signiert hat; ein CHG, den kein
Eigentümer signiert hat, wird nicht erstattet. Erstattungen werden nach 120 Bestätigungen
gutgeschrieben und können dann ausgezahlt werden — siehe Fragen & Antworten.
Eine Zahlung, deren Memo auch nur ein Zeichen außerhalb des druckbaren ASCII enthält, wird nicht automatisch erstattet, gleich was sie zahlt, ebenso wenig eine Zahlung unter 0.01 PIVX: Solche Zahlungen werden dem PIVX Name-Team gemeldet — siehe Fragen & Antworten.
Reihenfolge
Befehle werden in der Reihenfolge verarbeitet, in der PIVX sie erzeugt hat: Blockhöhe, dann Transaktionsindex innerhalb des Blocks. Die Registrierungsstelle wählt die Reihenfolge nicht und kann sie nicht ändern, ohne dass jeder unabhängige Indexer einen anderen Root berechnet.
Eine Transaktion trägt einen Befehl: den ersten ihrer Outputs an die Adresse der Registrierungsstelle, nach Output-Index, dessen Memo ein wohlgeformter Befehl ist. Jeder weitere Output an die Registrierungsstelle in derselben Transaktion wird weder verarbeitet noch automatisch erstattet — senden Sie daher jeden Befehl in einer eigenen Transaktion.
Bei konkurrierenden Operationen — zwei REG für denselben Namen oder zwei BUY für dasselbe
Angebot — gewinnt die in dieser Reihenfolge erste, den übrigen wird der Betrag auf das interne
Guthaben erstattet.
Durchgerechnetes Beispiel
Registrierung von 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.
Sobald die Zahlung 40 Bestätigungen hat — etwa 40 Minuten —, kommt der Befehl in den nächsten
Batch, der etwa zehn Minuten später geschlossen und dann bewiesen und verankert wird. Von da an
löst sich richard.pivx über jeden Indexer auf, mit einem Merkle-Beweis, den Sie selbst prüfen
können.