Get started
Quickstart
Your first agent payment in 5 steps, about 10 minutes.
- Time
- About 10 minutes
- You need
- MetaMask (or another browser wallet) and Node 18+
- Network
- Arc TestnetArc mainnet
Step 1: Get USDC
- Install a browser wallet such as MetaMask if you don't have one.
- Get free test USDC from faucet.circle.com. Choose Arc Testnet and paste your wallet address.
- Install a browser wallet such as MetaMask if you don't have one.
- Put some USDC on Arc mainnet in that wallet. This is real money, so start small: a few dollars is plenty.
On Arc, fees are also paid in USDC, so this one balance covers everything.
Step 2: Create your Aider wallet
- Open the app and click Connect wallet. If asked, switch your wallet to Arc Testnet.
- Click Create wallet and confirm.
- Click Deposit, enter
5and confirm the two prompts (Approve, then Deposit).
- Open the app and click Connect wallet. If asked, switch your wallet to Arc mainnet.
- Click Create wallet and confirm.
- Click Deposit, enter
5and confirm the two prompts (Approve, then Deposit).
Step 3: Install aidr on the agent's computer
The agent's computer is wherever the agent runs, for example your laptop if you use Claude Code. Open a terminal and run:
npm install -g aidr-cli
aidr --versionaidr --version should print a version number. If it says command not found, close the terminal, open a new one and try again.
Step 4: Connect the agent
In the same terminal:
aidr setup --name "Claude Code"aidr setup --name "Claude Code" --network mainnetIt prints a link like this:
Open this link where your Aider wallet is, set the limits and click Add agent:
https://aider-smoky.vercel.app/connect?agent=0x7D47…bebf&name=Claude+Code&chain=5042002&…Open this link where your Aider wallet is, set the limits and click Add agent:
https://aider-smoky.vercel.app/connect?agent=0x7D47…bebf&name=Claude+Code&chain=5042&…Open the link in the browser where your wallet is connected. The Add agent form is already filled in:
- Choose the limits, for example $0.10 per payment and $0.50 per day.
- Leave Send 0.05 USDC for gas on. The agent needs a little USDC to send payments.
- Click Add agent and confirm the two prompts.
Check it worked:
aidr balanceLook for "status": "active".
Step 5: Make a payment
aidr pay 0x90F79bf6EB2c4f870365E785982E1f101E93b906 0.05 "My first agent payment"You get "status": "paid" and an explorer link. The payment also appears in the app under Activity.
Try one over the limit:
aidr pay 0x90F79bf6EB2c4f870365E785982E1f101E93b906 1 "Bigger purchase"You get "status": "pending_approval". Open Approvals in the app and click Approve.
Tip
You don't have to type these yourself. Start Claude Code and ask it to pay; see use it with Claude.
Next
- Use it with Claude: what to say, and what agents can pay for.
- Owner guide: approvals, revoking, pausing and withdrawing.
- Agent guide: every
aidrcommand in plain steps.