You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Base.dev is the canonical registry for agents on Base. A Builder Code ties every transaction your agent sends to your identity in that registry, giving you verifiable onchain attribution and access to analytics and leaderboard features.
9
+
10
+
## What you get
11
+
12
+
-**Builder Code** — a unique identifier (e.g. `bc_a1b2c3d4`) that you append to your onchain transactions. Base uses this to measure your agent's activity on Base Chain.
13
+
14
+
## Prerequisites
15
+
16
+
- An EVM wallet address that your agent operates from
17
+
18
+
---
19
+
20
+
## Get your Builder Code
21
+
22
+
One call. No auth.
23
+
24
+
```bash Terminal
25
+
curl -X POST https://api.base.dev/v1/agents/builder-codes \
26
+
-H "Content-Type: application/json" \
27
+
-d '{
28
+
"wallet_address": "0x<your-wallet-address>"
29
+
}'
30
+
```
31
+
32
+
Response:
33
+
34
+
```json Title Response
35
+
{
36
+
"builder_code": "bc_a1b2c3d4",
37
+
"wallet_address": "0x...",
38
+
}
39
+
```
40
+
41
+
<Warning>
42
+
Already registered? Calling this endpoint again with the same wallet address returns your existing builder code.
43
+
</Warning>
44
+
---
45
+
46
+
## Get a Builder Code using the Base skill
47
+
48
+
If you're using an AI coding tool (Claude Code, Cursor, Codex), install the Base skills package and let the skill handle registration end-to-end:
49
+
50
+
```bash Terminal
51
+
npx skills add base/skills
52
+
```
53
+
54
+
Then ask your agent: **"Register my agent for a builder code on Base.dev."**
55
+
56
+
The skill runs four phases:
57
+
58
+
<Steps>
59
+
<Steptitle="Wallet">
60
+
Asks for your agent's wallet address. If you don't have one, it sends you to the [wallet setup guide](/ai-agents/guides/wallet-setup) before continuing.
61
+
</Step>
62
+
<Steptitle="Registration and attribution">
63
+
Calls `POST /v1/agents/builder-codes` with your wallet address, writes the returned code to `src/constants/builderCode.ts`, installs `ox`, and wires the ERC-8021 `dataSuffix` into your transaction client (viem, ethers.js, or managed service). It also writes an `AGENT_README.md` documenting the setup.
64
+
</Step>
65
+
<Steptitle="Permanent rule">
66
+
Confirms the setup and instructs you that every future transaction must include the ERC-8021 suffix. Missing it causes silent, permanent attribution loss — no error, no warning.
67
+
</Step>
68
+
</Steps>
69
+
70
+
---
71
+
72
+
## Get a Builder Code with a prompt
73
+
74
+
If you're using an AI agent, point it to this page:
75
+
76
+
```text Title Prompt
77
+
Get a Builder Code for my agent on Base.dev using the documentation at [URL of this page].
78
+
79
+
My agent's wallet address: [0x...]
80
+
81
+
Run this curl command, replacing the wallet address with mine:
82
+
curl -X POST https://api.base.dev/v1/agents/builder-codes \
83
+
-H "Content-Type: application/json" \
84
+
-d '{"wallet_address": "[0x...]"}'
85
+
86
+
Return the builder_code from the response, then show me how to append it to my transactions using ERC-8021.
87
+
```
88
+
---
89
+
90
+
91
+
## What happens next
92
+
93
+
Once you receive your Builder Code, it becomes active right away Base will begin tracking any transactions that include it.
- [Wallets](https://docs.base.org/ai-agents/core-concepts/wallets) — Agent wallets, signing, and funded execution
39
+
- [Payments and transactions](https://docs.base.org/ai-agents/core-concepts/payments-and-transactions) — x402 payments and onchain transaction
40
+
- [Identity and auth](https://docs.base.org/ai-agents/core-concepts/identity-verification-auth) — Verification and trust between agents and services
41
+
- [Base Account quickstart for AI tools](https://docs.base.org/base-account/quickstart/ai-tools-available-for-devs) — Agent-assisted wallet and account flows
42
+
- [Deploy on Base](https://docs.base.org/base-chain/quickstart/deploy-on-base) — Contract deployment on Base
43
+
- [Build a Base app](https://docs.base.org/get-started/build-app)
- [Wallets](https://docs.base.org/ai-agents/core-concepts/wallets) — Agent wallets, signing, and funded execution
93
-
- [Payments and transactions](https://docs.base.org/ai-agents/core-concepts/payments-and-transactions) — x402 payments and onchain transaction
94
-
- [Identity and auth](https://docs.base.org/ai-agents/core-concepts/identity-verification-auth) — Verification and trust between agents and services
95
-
- [Base Account quickstart for AI tools](https://docs.base.org/base-account/quickstart/ai-tools-available-for-devs) — Agent-assisted wallet and account flows
96
-
- [Deploy on Base](https://docs.base.org/base-chain/quickstart/deploy-on-base) — Contract deployment on Base
97
-
- [Build a Base app](https://docs.base.org/get-started/build-app)
0 commit comments