diff --git a/docs/agents.md b/docs/agents.md index 85dff4115..6ac371b05 100644 --- a/docs/agents.md +++ b/docs/agents.md @@ -4,7 +4,7 @@ Base is an Ethereum L2 by Coinbase. Docs for: Base Chain, Smart Wallet, OnchainK [Docs]|root:./docs |ai-agents:index |ai-agents/frameworks:eliza,langchain,vercel-ai-sdk -|ai-agents/guides:agent-app,register-and-sign-in-your-agent,trading,wallet-setup,x402-payments +|ai-agents/guides:agent-app,agent-builder-codes,register-and-sign-in-your-agent,trading,wallet-setup,x402-payments |ai-agents/introduction:choosing-a-framework |ai-agents/quickstart:agentkit,openclaw-claude |ai-agents/reference:contracts @@ -45,4 +45,4 @@ Base is an Ethereum L2 by Coinbase. Docs for: Base Chain, Smart Wallet, OnchainK |mini-apps/quickstart:build-checklist,building-for-the-base-app,create-new-miniapp,migrate-existing-apps,migrate-to-standard-web-app,template |mini-apps/technical-guides:accept-payments,building-chat-agents,neynar-notifications,sharing-and-social-graph,sign-manifest |onchainkit:migrate-from-onchainkit -|root:cookie-policy,privacy-policy,terms-of-service,tone_of_voice +|root:agents,cookie-policy,privacy-policy,terms-of-service,tone_of_voice diff --git a/docs/ai-agents/guides/agent-builder-codes.mdx b/docs/ai-agents/guides/agent-builder-codes.mdx new file mode 100644 index 000000000..0f9f1c935 --- /dev/null +++ b/docs/ai-agents/guides/agent-builder-codes.mdx @@ -0,0 +1,111 @@ +--- +title: "Get a Builder Code for Your Agent" +description: "Register your agent on Base.dev and append a Builder Code to every transaction to measure onchain activity." +keywords: ["builder code", "Base.dev", "ERC-8021", "attribution", "onchain activity", "agent attribution", "dataSuffix", "builder codes", "Base builder codes", "agent onchain"] +tag: "NEW" +--- + +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. + +## What you get + +- **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. + +## Prerequisites + +- An EVM wallet address that your agent operates from + +--- + +## Get your Builder Code + +One call. No auth. + +```bash Terminal +curl -X POST https://api.base.dev/v1/agents/builder-codes \ + -H "Content-Type: application/json" \ + -d '{ + "wallet_address": "0x" + }' +``` + +Response: + +```json Title Response +{ + "builder_code": "bc_a1b2c3d4", + "wallet_address": "0x...", +} +``` + + +Already registered? Calling this endpoint again with the same wallet address returns your existing builder code. + +--- + +## Get a Builder Code using the Base skill + +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: + +```bash Terminal +npx skills add base/skills +``` + +Then ask your agent: **"Register my agent for a builder code on Base.dev."** + +The skill runs four phases: + + + + 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. + + + 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. + + + 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. + + + +--- + +## Get a Builder Code with a prompt + +If you're using an AI agent, point it to this page: + +```text Title Prompt +Get a Builder Code for my agent on Base.dev using the documentation at [URL of this page]. + +My agent's wallet address: [0x...] + +Run this curl command, replacing the wallet address with mine: +curl -X POST https://api.base.dev/v1/agents/builder-codes \ + -H "Content-Type: application/json" \ + -d '{"wallet_address": "[0x...]"}' + +Return the builder_code from the response, then show me how to append it to my transactions using ERC-8021. +``` +--- + + +## What happens next + +Once you receive your Builder Code, it becomes active right away Base will begin tracking any transactions that include it. + +## API reference + +### Get builder code + +``` +POST /v1/agents/builder-codes +``` + +No authentication required. + +| Field | Type | Required | Description | +|---|---|---|---| +| `wallet_address` | string | Yes | Your agent's EVM wallet address (`0x...`) | + +Returns the builder code for the given wallet. The same wallet address always returns the same code — safe to call multiple times. + + diff --git a/docs/docs.json b/docs/docs.json index 73cedf9ad..5c72e77c6 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -535,6 +535,7 @@ "group": "Guides", "pages": [ "ai-agents/guides/wallet-setup", + "ai-agents/guides/agent-builder-codes", "ai-agents/guides/x402-payments", "ai-agents/guides/register-and-sign-in-your-agent", "ai-agents/guides/agent-app", diff --git a/docs/llms.txt b/docs/llms.txt index 1b3825c98..bde275320 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -14,6 +14,34 @@ These resources give AI assistants direct access to Base documentation and reusable workflows. +### Base MCP server + +`https://docs.base.org/mcp` + +### Base skills + +AI agents can use Base skills to perform onchain actions directly from their tool loop — no custom integration required. Available skills include: + +[https://github.com/base/skills](https://github.com/base/skills) + +Install Base skills for your AI assistant: + +``` +npx skills add base/base-skills +``` +## Recommended starting points + +Narrow context to a specific type of work: + +- [AI Agents overview](https://docs.base.org/ai-agents) — Overall agent building model on Base +- [Agent frameworks](https://docs.base.org/ai-agents/core-concepts/agent-frameworks) +- [Wallets](https://docs.base.org/ai-agents/core-concepts/wallets) — Agent wallets, signing, and funded execution +- [Payments and transactions](https://docs.base.org/ai-agents/core-concepts/payments-and-transactions) — x402 payments and onchain transaction +- [Identity and auth](https://docs.base.org/ai-agents/core-concepts/identity-verification-auth) — Verification and trust between agents and services +- [Base Account quickstart for AI tools](https://docs.base.org/base-account/quickstart/ai-tools-available-for-devs) — Agent-assisted wallet and account flows +- [Deploy on Base](https://docs.base.org/base-chain/quickstart/deploy-on-base) — Contract deployment on Base +- [Build a Base app](https://docs.base.org/get-started/build-app) + ### Docs index [https://docs.base.org/llms.txt](https://docs.base.org/llms.txt) @@ -25,7 +53,7 @@ Base is an Ethereum L2 by Coinbase. Docs for: Base Chain, Smart Wallet, OnchainK [Docs]|root:./docs |ai-agents:index |ai-agents/frameworks:eliza,langchain,vercel-ai-sdk -|ai-agents/guides:agent-app,register-and-sign-in-your-agent,trading,wallet-setup,x402-payments +|ai-agents/guides:agent-app,agent-builder-codes,register-and-sign-in-your-agent,trading,wallet-setup,x402-payments |ai-agents/introduction:choosing-a-framework |ai-agents/quickstart:agentkit,openclaw-claude |ai-agents/reference:contracts @@ -66,34 +94,8 @@ Base is an Ethereum L2 by Coinbase. Docs for: Base Chain, Smart Wallet, OnchainK |mini-apps/quickstart:build-checklist,building-for-the-base-app,create-new-miniapp,migrate-existing-apps,migrate-to-standard-web-app,template |mini-apps/technical-guides:accept-payments,building-chat-agents,neynar-notifications,sharing-and-social-graph,sign-manifest |onchainkit:migrate-from-onchainkit -|root:cookie-policy,privacy-policy,terms-of-service,tone_of_voice +|root:agents,cookie-policy,privacy-policy,terms-of-service,tone_of_voice ``` -### Base MCP server - -`https://docs.base.org/mcp` - -### Base skills - -[https://github.com/base/skills](https://github.com/base/skills) - -Install Base skills for your AI assistant: - -``` -npx skills add base/base-skills -``` - -## Recommended starting points - -Narrow context to a specific type of work: - -- [AI Agents overview](https://docs.base.org/ai-agents) — Overall agent building model on Base -- [Agent frameworks](https://docs.base.org/ai-agents/core-concepts/agent-frameworks) -- [Wallets](https://docs.base.org/ai-agents/core-concepts/wallets) — Agent wallets, signing, and funded execution -- [Payments and transactions](https://docs.base.org/ai-agents/core-concepts/payments-and-transactions) — x402 payments and onchain transaction -- [Identity and auth](https://docs.base.org/ai-agents/core-concepts/identity-verification-auth) — Verification and trust between agents and services -- [Base Account quickstart for AI tools](https://docs.base.org/base-account/quickstart/ai-tools-available-for-devs) — Agent-assisted wallet and account flows -- [Deploy on Base](https://docs.base.org/base-chain/quickstart/deploy-on-base) — Contract deployment on Base -- [Build a Base app](https://docs.base.org/get-started/build-app)