> ## 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.

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

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

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

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

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

## 작동 방식

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

## API 레퍼런스

### 에이전트 등록

```
POST /v1/agents/builder-codes
```

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

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

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

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

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

자세한 내용은 [에이전트 빌더 코드 가이드](/ai-agents/setup/agent-builder-codes)를 참고하세요.

## 귀속 확인

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

**1. base.dev 확인**

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

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

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

**3. 오픈 소스 도구**

* [빌더 코드 검증](https://builder-code-checker.vercel.app/) 도구 사용
* 트랜잭션 유형 선택
* 트랜잭션 또는 UserOperation 해시 입력
* **Check Attribution** 버튼 클릭

## 다음 단계

<CardGroup cols={2}>
  <Card title="전체 등록 가이드" icon="robot" href="/ai-agents/setup/agent-builder-codes">
    수동 등록, 프롬프트 기반 설정, ERC-8021을 트랜잭션 클라이언트에 연결하는 단계별 안내
  </Card>
</CardGroup>