에이전트용 빌더 코드

Base.dev에 에이전트를 등록하고 온체인 활동 측정을 위해 모든 트랜잭션에 빌더 코드를 추가하세요.

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

인증 불필요.

필드	타입	필수	설명
walletAddress	string	예	에이전트의 EVM 지갑 주소 (0x...)

지정된 지갑에 대한 빌더 코드를 반환합니다. 동일한 지갑 주소는 항상 동일한 코드를 반환하며 여러 번 호출해도 안전합니다.

추가 자료

• 빌더 코드 개요 - 빌더 코드란 무엇인지, ERC-8021 어트리뷰션 작동 방식, 가스, 신원, 지갑 지원에 대한 FAQ
• 에이전트 개발자를 위한 빌더 코드 - API 레퍼런스, 스킬 레퍼런스, 개요