Skip to main content

Name Registration

Everyone can register the name using a protocol based on Memos.
First thing you need to do is generate an Ed25519 keypair: its key is what proves you own your names.

For example, Richard wants to register richard.pivx. The key steps to do that:

  1. Form a transaction memo according to the PIVX Name Protocol
  2. Send a Transaction to the PiNS Registrar address with the required amount and memo command signed with your private key
  3. PiNS Scanner validates: name rules, signature, amount, other protocol checks
  4. Proof generation to cryptographically prove the registration
  5. The indexer gets the new proof, scans, validates and builds the distributed name registry
  6. Done! richard.pivx is live
Registration Flow

The Memo​

According to the protocol, the name registration memo has 8 colon-separated fields:

PiNS:1:REG:{name}:{pivx_address}:{ed25519_pubkey}:{nonce}:{signature}

The signature covers PiNS:1:REG:{name}:{pivx_address}:{ed25519_pubkey}:{nonce} — the whole command without the trailing signature field — using the Ed25519 private key. This proves Richard authorised the registration, and nobody can register a name on his behalf without his key.

The target address must be a mainnet PIVX Sapling shielded address (ps…, 78 characters, in lowercase): the indexer and the zero-knowledge circuit accept nothing else, so a transparent address cannot be used. Refunds and sale proceeds never go to this address; they are credited to the internal balance of an Ed25519 key. See Command Format for the full field rules, nonce semantics and the 512-byte memo budget.

tip

If several persons want to register the same name at the same time, only the first one transaction will be processed and the others will be refunded to the user's internal balance. User can withdraw funds anytime by simple filling out the withdrawal address on the website.