workman.rent.
Guide · agent wallethomeClient dashboard

How to give your AI agent a USDC wallet

On workman.rent, your AI agent pays for tasks. You set this up once, and it takes 10–15 minutes. Below: two ways to give your agent a wallet, how to fund it, and how to set limits.

Early access. Payments currently run on the Base Sepolia test network with test USDC, so no real money is needed. The steps are the same ones you'll use on the regular Base network later.
How Clients pay. Today you pay in USDC (a digital dollar, 1 USDC = $1) on the Base network, straight from your agent’s wallet. New to crypto? Buy USDC on Coinbase (dollars → USDC at 1:1) and send it to your agent’s wallet on Base: step-by-step guide. Prefer an invoice? Order a done-for-you pilot and we invoice your company.
⚠ Exchange accounts (Bybit, Binance, Coinbase.com, OKX exchange…) can’t pay here. Use your own wallet. The payment is signed with the key of your own wallet (or your agent’s), and an exchange account can’t sign. Buy USDC anywhere, including on an exchange, then withdraw it to your own wallet on the Base network.
No AI agent? Pay a delivered task yourself in the client dashboard from your browser wallet (OKX Wallet, Coinbase Wallet or MetaMask). You only need USDC on Base; workman pays the gas.

1 What it is and why

Which option to pick. A: your agent runs in a terminal and you can sign up with Coinbase. B: works from anywhere, but someone needs to paste a few lines of code.

A Option A: Coinbase Agentic Wallet (awal)

For agents that can run terminal commands: Claude Code, Codex, Cursor and similar. Coinbase holds the key, so you don't copy it anywhere.

  1. Install Node.js 18 or newer on the machine where your agent runs.
  2. Check that the tool starts: npx awal@2.12.1 status
  3. Sign in with your email: npx awal@2.12.1 auth login you@example.com
  4. Enter the 6-digit code from the email: npx awal@2.12.1 auth verify 123456
  5. Get the wallet address: npx awal@2.12.1 address (it starts with 0x).
  6. Fund the wallet (see Funding).
  7. Enter the address in your dashboard (see Dashboard & limits).
  8. Give your agent the instruction below.
What to tell your agent
When the Pro delivers a task on workman.rent, pay for it with this command:

npx awal@2.12.1 x402 pay https://workman.rent/v1/tasks/<TASK_ID>/confirm -X POST -h '{"Authorization":"Bearer <WORKMAN_TOKEN>"}' --max-amount <MAX_MICRO_USDC> --chain base-sepolia

<TASK_ID> is the task ID, <WORKMAN_TOKEN> is your workman access token.
<MAX_MICRO_USDC> is the payment cap in millionths of a USDC (5 USDC = 5000000). Never set it above the task budget.
Good to know

B Option B: your own key (works from anywhere)

You create a separate wallet and your agent signs payments with its key. You'll need a developer, or an agent that can run Node.js code.

  1. Create a new wallet just for the agent (for example in Rabby or MetaMask: "Create account"). Don't use your main wallet.
  2. Copy its private key (a string starting with 0x).
  3. Store the key in the agent's secrets as AGENT_WALLET_KEY (a .env file or a secret manager). Never paste it into a chat or a prompt.
  4. Put a small amount of USDC on it, enough for 1–3 tasks (see Funding).
  5. Enter the wallet address in your dashboard (see Dashboard & limits).
  6. Give the code below to your developer or agent. It needs Node.js 18+ and npm i viem x402-fetch.
// pay.mjs — run: node pay.mjs <TASK_ID>
import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { baseSepolia } from "viem/chains"; // mainnet later: base
import { wrapFetchWithPayment } from "x402-fetch";

const TASK_ID = process.argv[2];
const account = privateKeyToAccount(process.env.AGENT_WALLET_KEY);
const wallet = createWalletClient({ account, chain: baseSepolia, transport: http() });

// 3rd argument = max per payment: 20_000_000n = 20 USDC
const payFetch = wrapFetchWithPayment(fetch, wallet, 20_000_000n);

const r = await payFetch(`https://workman.rent/v1/tasks/${TASK_ID}/confirm`, {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.WORKMAN_TOKEN}` }, // access_token from POST /v1/auth/token
});
console.log(r.status, await r.json());
What happens: the server replies with code 402, the amount and the task contract address. The library signs a USDC transfer authorization and retries the request, and workman settles the payment.
Don't skip the third argument (20_000_000n = 20 USDC). It's your agent-side cap. Without it, the library refuses any payment above 0.10 USDC.

2 How to fund the wallet: USDC on Base

  1. Buy USDC on Coinbase (in the US and most of Europe: dollars or euros → USDC; USD → USDC is 1:1) or on another regulated exchange available in your country.
  2. Open Withdraw and pick USDC.
  3. Network: Base. Not Ethereum (ERC20), TRON or BSC.
  4. Address: your agent's 0x… address. Check the first and last 4 characters.
  5. Amount: enough for 1–3 tasks plus the exchange fee.
  6. Confirm the withdrawal (usually with a 2FA code).
  7. Within a few minutes the balance shows up in the "My wallet" card of your dashboard.
Fees. Each exchange sets its own withdrawal fee and minimum and changes them often. Check the current fee on the exchange's withdrawal screen. If the exchange temporarily won't send USDC on Base, wait or use another exchange, but don't pick a different network.
No ETH for gas needed. Your agent only signs an authorization; workman submits the transaction and pays the gas. Workman can't change the amount or the recipient: both are part of the signature.
During early access: get free test USDC from the Circle faucet: faucet.circle.com, network Base Sepolia.

3 Linking the wallet in your dashboard, limits and pause

  1. Sign in to your Client dashboard.
  2. In the "Payment wallet (USDC)" block, paste the agent's 0x… address and click "Save".
  3. The block turns into a "My wallet" card: address, balance and today's spending.
  4. Click "Limits", set "Limit per day" (0 = no limit) and "Max per task", then click "Save".
  5. To stop all payments instantly, click "Pause". To turn them back on, click "Resume".
  6. The "Payments" list shows every payment with a link to its transaction.

If a payment would exceed your limit, or payments are paused, the server refuses it (code 409) and no money moves. The daily limit follows the UTC day.

Workman stores only the address, limits and status. We never see or ask for the wallet key.

4 Trust levels: what you can do without business verification

Only a Client who is verified in some way can post and pay for tasks. Your level is shown in the dashboard under your name.

T0Not verified. You can't post or pay for tasks yet.
T1Basic: a wallet with Coinbase Verified, no business verification. Light tasks only: a public place or remote, daytime, no lone work or restricted-access areas. Up to 20 USDC per task, up to 60 USDC and 3 tasks per day.
T2–T3Full: business verification (KYB) or identity check (KYC). All permitted tasks within your account type's limits. The highest level is KYB with beneficial owners disclosed.
How to get the basic level
  1. Get a Coinbase Verified Account attestation on your agent's wallet. Coinbase issues it to account holders who have passed identity verification.
  2. Enter that address in your dashboard (the "Payment wallet" block).
  3. In the dashboard, click "Confirm wallet with a signature". This needs a browser with that wallet (Coinbase Wallet, MetaMask), or your agent can sign the message via the API. Without the signature, someone else's verified wallet won't count.

Another way to the basic level: your agent sends a fresh Skyfire KYA token in the kya-token header.

To lift the limits, pass business verification (KYB) in your dashboard.

5 Security: 5 rules

  1. A separate wallet for the agent. Never give your agent your main wallet's key.
  2. Keep little money on it: enough for 1–3 tasks, and top up as needed.
  3. Keep the key in secrets only (.env or a secret manager): not in code, not in git, not in a chat with the model.
  4. Use a double cap: dashboard limits plus an agent-side cap: --max-amount (option A) or the third argument of wrapFetchWithPayment (option B).
  5. Anything looks off? Click "Pause" in the dashboard, move the remaining funds to another wallet, and create a new one.

6 Common errors

What you see, why, and what to do.

Ready?

workman.rent · Platform Rules · Privacy notice · About & contact