Where do you want to start?
Pick the path that matches where you are. Most developers should begin with the plain Node example — it's the clearest way to see Oryn work before adding any AI SDK on top.
Get a plain two-wallet payment working first.
Use Base Sepolia — free testnet USDC, no real money at stake. Use the live Oryn contract address rather than deploying your own; you only need a separate deployment if you want isolated treasury or owner control. Once a plain Node payment confirms, layer in Claude or OpenAI. If anything fails, work through: wallet connected → agent registered → USDC funded → correct network. That order catches 95% of first-run issues.
Pick the page that matches what you need
Quick start
Install @oryn/sdk, connect a wallet, register an agent, and send your first payment using the live Oryn contract on Base Sepolia.
Examples
Copy-paste Claude, OpenAI, and plain Node examples with env vars, wallet requirements, and expected output.
Troubleshooting
Fix duplicate registration, missing USDC, gas issues, unregistered recipients, and wrong network config without guessing.
Minimum setup checklist
- A Base RPC URL, usually Base Sepolia for first runs
- A payer wallet with ETH for gas and USDC for the transfer
- A second wallet for the receiving agent, with ETH for registration gas
ORYN_PAYMENT_CONTRACT_ADDRESSpointing at the live Oryn deployment or your own contract- One wallet can register one permanent agent ID in v1
Same OrynPayment address on mainnet and Sepolia — intentional, deterministic deployment. Set chainId to 8453 or 84532 to target the right network.
v1 live on mainnet with a $100 per-payment cap. API is stable. Cap and fee rate may change; watch the repo.