Skip to main content
Base.dev는 Base의 에이전트를 위한 공식 레지스트리입니다. 빌더 코드는 에이전트가 전송하는 모든 트랜잭션을 해당 레지스트리의 신원과 연결하여 검증 가능한 온체인 어트리뷰션과 분석 및 리더보드 기능에 대한 접근을 제공합니다.

​
제공되는 것

  • 빌더 코드 — 온체인 트랜잭션에 추가하는 고유 식별자 (예: bc_a1b2c3d4). Base는 이를 사용하여 Base Chain에서 에이전트의 활동을 측정합니다.

​
사전 요구사항

  • 에이전트가 운영하는 EVM 지갑 주소

​
빌더 코드 발급

인증이 필요 없는 단일 API 호출:
Terminal
curl -X POST https://api.base.dev/v1/agents/builder-codes \
  -H "Content-Type: application/json" \
  -d '{
    "walletAddress": "<your-wallet-address>"
  }'
응답:
Response
{
  "builderCode": "bc_a1b2c3d4",
  "walletAddress": "0x...",
}
이미 등록하셨나요? 동일한 지갑 주소로 이 엔드포인트를 다시 호출하면 기존 빌더 코드가 반환됩니다.

​
Base 스킬을 사용하여 빌더 코드 발급

AI 코딩 도구(Claude Code, Cursor, Codex)를 사용하는 경우 Base 스킬 패키지를 설치하고 스킬이 등록 전 과정을 처리하도록 합니다:
Terminal
npx skills add base/skills
그런 다음 에이전트에게 요청합니다: “Base.dev에서 에이전트의 빌더 코드를 등록해주세요.” 스킬은 세 단계로 실행됩니다:
1

지갑

에이전트의 지갑 주소를 요청합니다. 지갑이 없는 경우 계속 진행하기 전에 지갑 설정 가이드로 안내합니다.
2

등록 및 어트리뷰션

지갑 주소로 POST /v1/agents/builder-codes를 호출하고, 반환된 코드를 src/constants/builderCode.ts에 저장하고, ox를 설치하고, ERC-8021 dataSuffix를 트랜잭션 클라이언트(viem, ethers.js, 또는 관리형 서비스)에 연결합니다. 또한 설정을 문서화하는 AGENT_README.md를 작성합니다.
3

영구 규칙

설정을 확인하고 향후 모든 트랜잭션에 ERC-8021 접미사가 포함되어야 함을 안내합니다. 누락 시 조용하고 영구적인 어트리뷰션 손실이 발생합니다.

​
프롬프트로 빌더 코드 발급

AI 에이전트를 사용하는 경우 이 페이지를 가리킵니다:
Prompt
Get a Builder Code for my agent on Base.dev using the documentation at https://docs.base.org/ai-agents/setup/agent-builder-codes.

My agent's wallet address: [0x...]

Run this curl command, replacing the wallet address with my agent's:
curl -X POST https://api.base.dev/v1/agents/builder-codes \
  -H "Content-Type: application/json" \
  -d '{"walletAddress": "0x..."}'

Return the `builderCode` from the response, then show me how to append it to my transactions using ERC-8021.

​
다음 단계

빌더 코드를 받으면 즉시 활성화되고 Base는 해당 코드가 포함된 트랜잭션 추적을 시작합니다.

​
API 레퍼런스

​
빌더 코드 발급

POST /v1/agents/builder-codes
인증 불필요.
필드타입필수설명
walletAddressstring예에이전트의 EVM 지갑 주소 (0x...)
지정된 지갑에 대한 빌더 코드를 반환합니다. 동일한 지갑 주소는 항상 동일한 코드를 반환하며 여러 번 호출해도 안전합니다.

​
추가 자료