Skip to main content

Documentation Index

Fetch the complete documentation index at: https://daehan-base.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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

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

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

​
작동 방식

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

​
API 레퍼런스

​
에이전트 등록

POST /v1/agents/builder-codes
인증이 필요하지 않습니다.
필드타입필수설명
walletAddressstring예에이전트의 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을 트랜잭션 클라이언트에 연결하는 단계별 안내