Skip to main content

Marketplace

Names can be bought and sold through a built-in escrow marketplace. All payments are fully shielded.

Selling​

The seller signs a LIST request via an on-chain TX and formed shielded memo with the command LIST:

PiNS:1:LST:{name}:{ed25519_pubkey}:{price}:{nonce}:{signature}

This lists a name on the Marketplace.

tip
  • price can be only an integer number in PIVX coins (ex. 1, 100, 123)
  • LIST command can be used to change the sell price of previously listed names on the Marketplace

If you change your mind​

The seller can always delist the domain from the Marketplace by sending an on-chain TX and formed shielded memo with the command UNLIST:

PiNS:1:ULT:{name}:{ed25519_pubkey}:{nonce}:{signature}

This removes the name from the Marketplace.

tip

The commands are processed one by one in the queue sorted by PIVX blockchain. This means that your UNLIST command should be received before someone's BUY command.
PIVX.NAME do not control the order of the transactions, it fully depends on PIVX blockchain block producing and transactions index order in each block.

Buying​

The buyer sends a shielded transaction to the registrar shielded address with a BUY command in memo:

PiNS:1:BUY:{name}:{shielded_address}:{ed25519_pubkey}:{nonce}:{signature}

The scanner validates:

  • Name must be listed for sale
  • Payment must match the listing price exactly
  • If valid: name transfers to buyer, payout performed to seller's internal balance
  • If invalid: will be refunded on buyer's internal balance
tip

If several persons want to buy the same name at the same time, only 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.