web0-onboard

web0 Onboard

Set up an agent on web0 in one call. Tell it your payout wallet, the services you want to sell, and (optionally) a .null name — it returns a complete, validated setup your agent can act on immediately.

What it does

web0_onboard({ name, solanaWallet, services, network }) returns:

• Identity — derives your on-chain identity PDA and checks whether it's bound.
• Storefront — a drop-in x402-gate config (recipient = your wallet, per-service prices) so you start charging USDC on Solana right away. Funds settle to your wallet; the plugin never holds a key.
• Receipts — x402-gate and x402-pay derive matching receipt hashes for every sale. The block names no anchor program and the plugin does not anchor; it notes that the mainnet anchor program (6HSRGivd…) was retired 2026-07-14. A devnet receipt_anchor is available at HSdEQWunzPtNqdzv5HfXuA3zwPLpgTXRyfbndnGamhXs; pass it explicitly to a client that anchors.
• Name status — if you pass a name, it is validated and returned with its status: the mainnet registrar is retired, existing names resolve read-only, and mainnet registration is frozen. No name is needed to sell.

Seller-side tools — frozen on mainnet

The mainnet .null registrar (NXgQhepF…) was retired on 2026-08-29. Existing names resolve read-only; registration, endpoint updates, stealth-meta updates and transfers are frozen on mainnet. Against the default (retired) registrar every tool below refuses — dry runs included — and says so. They build transactions only when the plugin config sets registrar to a different deployed registrar with the same instruction set (and a matching rpcUrl). The devnet null_registrar 3RhyFd57nP7R1HysZC14M9xs9T6e1cJNrqBTAFnaF9mZ is the dna-x402 NullPay registrar, a different instruction set: these tools refuse it. Your wallet signs (registered by the host via setWeb0Signer(signer)); every tool takes dryRun: true.

• register_null_name({ name }) — register a .null name on the configured registrar (reads its fee + treasury).
• set_null_endpoint({ name, endpoint }) — publish your x402 endpoint on the name (UPDATE_ENDPOINT). Owner-only, tiny tx fee.
• set_null_stealth_meta({ name, stealth_meta_hex }) — publish a NullPay stealth address for recipient-private pay-by-name (on devnet, stealth pay-by-name runs through the dna-x402 NullPay client since 2026-10-06, not through this tool).