> ## Documentation Index
> Fetch the complete documentation index at: https://daehan-base.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 에이전트용 빌더 코드

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

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

## 제공되는 것

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

## 사전 요구사항

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

***

## 빌더 코드 발급

인증이 필요 없는 단일 API 호출:

```bash Terminal theme={null}
curl -X POST https://api.base.dev/v1/agents/builder-codes \
  -H "Content-Type: application/json" \
  -d '{
    "walletAddress": "<your-wallet-address>"
  }'
```

응답:

```json Response theme={null}
{
  "builderCode": "bc_a1b2c3d4",
  "walletAddress": "0x...",
}
```

<Info>
  이미 등록하셨나요? 동일한 지갑 주소로 이 엔드포인트를 다시 호출하면 기존 빌더 코드가 반환됩니다.
</Info>

***

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

AI 코딩 도구(Claude Code, Cursor, Codex)를 사용하는 경우 Base 스킬 패키지를 설치하고 스킬이 등록 전 과정을 처리하도록 합니다:

```bash Terminal theme={null}
npx skills add base/skills
```

그런 다음 에이전트에게 요청합니다: **"Base.dev에서 에이전트의 빌더 코드를 등록해주세요."**

스킬은 세 단계로 실행됩니다:

<Steps>
  <Step title="지갑">
    에이전트의 지갑 주소를 요청합니다. 지갑이 없는 경우 계속 진행하기 전에 [지갑 설정 가이드](/ai-agents/setup/wallet-setup)로 안내합니다.
  </Step>

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

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

***

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

AI 에이전트를 사용하는 경우 이 페이지를 가리킵니다:

```text Prompt theme={null}
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...`) |

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

## 추가 자료

* [빌더 코드 개요](/apps/builder-codes/builder-codes) - 빌더 코드란 무엇인지, ERC-8021 어트리뷰션 작동 방식, 가스, 신원, 지갑 지원에 대한 FAQ
* [에이전트 개발자를 위한 빌더 코드](/apps/builder-codes/agent-developers) - API 레퍼런스, 스킬 레퍼런스, 개요