Skip to main content

Signed Operations

These endpoints require the owner's Ed25519 signature. Each request includes a nonce that must be strictly greater than the previous nonce for that name.

warning

UPDATE and TRANSFER are blocked while a name is listed for sale. Call DELIST first.

Update Address​

Change the address a name resolves to.

POST /v1/names/{name}/update
{
  "new_address": "u1new...address...",
  "nonce": 1,
  "pubkey": "3b6a27bceeb6a090...",
  "signature": "d4e5f6a7b8c9..."
}

Signature signs: "UPDATE:{name}:{new_address}:{nonce}"

Transfer Ownership​

Transfer a name to a new Ed25519 public key.

POST /v1/names/{name}/transfer
{
  "new_owner_pubkey": "b4c5d6e7f8a9...",
  "nonce": 2,
  "pubkey": "3b6a27bceeb6a090...",
  "signature": "e5f6a7b8c9d0..."
}

Signature signs: "TRANSFER:{name}:{new_owner_pubkey}:{nonce}"

Nonce resets to 0 for the new owner.

List for Sale​

List a name on the marketplace.

POST /v1/names/{name}/list
{
  "price_zat": 1000000,
  "seller_address": "u1sell...addr...",
  "nonce": 3,
  "pubkey": "3b6a27bceeb6a090...",
  "signature": "f6a7b8c9d0e1..."
}

Signature signs: "LIST:{name}:{price_zat}:{seller_address}:{nonce}"

Delist​

Remove a name from the marketplace.

POST /v1/names/{name}/delist
{
  "nonce": 4,
  "pubkey": "3b6a27bceeb6a090...",
  "signature": "a7b8c9d0e1f2..."
}

Signature signs: "DELIST:{name}:{nonce}"

Confirm Sale​

Finalize an off-protocol sale (no escrow).

POST /v1/names/{name}/confirm-sale
{
  "buyer_pubkey": "c8d9e0f1a2b3...",
  "buyer_address": "u1buyer...addr...",
  "nonce": 5,
  "pubkey": "3b6a27bceeb6a090...",
  "signature": "b8c9d0e1f2a3..."
}

Signature signs: "CONFIRM_SALE:{name}:{buyer_pubkey}:{buyer_address}:{nonce}"