에이전트 개발자를 위한 빌더 코드

AI 에이전트의 온체인 트랜잭션을 Base의 신원에 귀속시키고 분석 및 리더보드 기능을 활용하세요.

AI 에이전트는 자율적으로 동작하며 사용자가 각 트랜잭션을 수동으로 트리거하지 않고도 트랜잭션을 전송합니다. 빌더 코드를 사용하면 모든 활동을 Base의 에이전트 신원으로 귀속시킬 수 있습니다.

에이전트에 빌더 코드가 필요한 이유

• 귀속 — 에이전트가 전송하는 모든 트랜잭션이 Base 레지스트리의 신원과 연결됩니다. 빌더 코드 없이는 에이전트의 온체인 활동이 익명으로 처리됩니다.
• 분석 — base.dev에서 에이전트의 트랜잭션 볼륨, 사용자 도달, 온체인 전환을 추적합니다.
• 가시성 — 빌더 코드가 있는 에이전트는 Base의 앱 리더보드 및 에코시스템 스포트라이트와 같은 발견 서비스에 노출될 수 있습니다.

작동 방식

빌더 코드는 고유 식별자(예: bc_a1b2c3d4)로, 에이전트의 트랜잭션 calldata에 ERC-8021 서픽스로 추가됩니다. 스마트 컨트랙트는 서픽스를 무시하며, 오프체인 인덱서에 의해 사후에 추출됩니다. 가스 오버헤드는 최소화되어 있습니다 (비영 바이트당 16 가스).

API 레퍼런스

에이전트 등록

POST /v1/agents/builder-codes

인증이 필요하지 않습니다.

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

주어진 지갑에 대한 빌더 코드를 반환합니다. 동일한 지갑 주소는 항상 동일한 코드를 반환합니다.

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에서 에이전트를 빌더 코드에 등록해줘.”

이 스킬은 지갑 유효성 검사, 등록 API 호출, 반환된 코드를 src/constants/builderCode.ts에 저장, ox 설치, 트랜잭션 클라이언트(viem, ethers.js 또는 관리 서비스)에 ERC-8021 dataSuffix 연결을 모두 처리합니다.

자세한 내용은 에이전트 빌더 코드 가이드를 참고하세요.

귀속 확인

빌더 코드가 올바르게 추가되고 있는지 확인하려면:

1. base.dev 확인

• base.dev 방문
• 트랜잭션 유형 드롭다운에서 Onchain 선택
• 총 트랜잭션 섹션에서 코드가 포함된 트랜잭션이 처리되면 귀속 카운트가 증가합니다

2. 블록 탐색기 사용 (Basescan, Etherscan 등)

• 트랜잭션 해시 찾기
• 입력 데이터 필드 확인
• 마지막 16바이트가 8021 반복인지 확인
• 서픽스를 디코딩하여 빌더 코드가 있는지 확인

3. 오픈 소스 도구

• 빌더 코드 검증 도구 사용
• 트랜잭션 유형 선택
• 트랜잭션 또는 UserOperation 해시 입력
• Check Attribution 버튼 클릭

다음 단계

전체 등록 가이드

수동 등록, 프롬프트 기반 설정, ERC-8021을 트랜잭션 클라이언트에 연결하는 단계별 안내