Turbo SDKArNS Names (paid with Turbo Credits)
Purchase lifecycle
Every purchase is identified by a client-minted UUID nonce. The nonce is:
- Signed by your wallet and sent to the bundler (proving intent).
- The idempotency key for the purchase.
- The status-lookup key — poll
getArNSPurchaseStatus({ nonce })until the purchase reaches a terminal state.
purchaseArNSName returns the nonce on both response.nonce and response.purchaseReceipt.nonce. A purchase is terminal-success once its status carries a messageId (the Solana transaction id of the on-chain ArNS write) and terminal-failure once it carries a failedDate.
buyArNSName() ──▶ POST /arns/purchase ──▶ { nonce, purchaseReceipt, arioWriteResult }
│
poll getArNSPurchaseStatus({ nonce })
│
┌──────────────────────────────────────┴───────────────────────┐
messageId present (success) failedDate present (failure)How is this guide?