> For the complete documentation index, see [llms.txt](https://docs.aftermath.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aftermath.finance/ko/perpetuals/architecture/builder-codes-front-end-fee.md).

# 빌더 코드 (프런트엔드 수수료)

자체 커스텀 프런트엔드를 구축하고 수수료를 얻을 수 있습니다

빌더 코드 (Builder Codes)를 사용하면 모든 서드파티 통합 파트너(인테그레이터)가 별도의 허가 없이, 사용자를 위해 제출하는 주문에서 수수료를 얻을 수 있습니다. 트레이딩 플랫폼, 추천인 프로그램, 화이트 라벨 솔루션은 Aftermath로 보내는 주문 흐름에서 수익을 얻을 수 있습니다.

### 개요

**빌더 코드**는 Aftermath Perpetuals 위에 서비스를 구축하는 인테그레이터를 위한 수수료 공유 메커니즘입니다.

1. **인테그레이터 등록**: 인테그레이터는 전역으로 한 번 등록하고 숫자형 `integratorId`를 부여받습니다
2. **사용자 승인**: 사용자는 특정 인테그레이터를 승인하고 지불할 의사가 있는 최대 수수료를 설정합니다
3. **주문 제출**: 인테그레이터는 사용자를 대신해 주문을 제출하면서 (승인된 최대치 이하의) 수수료를 지정합니다

추천인 코드와 달리 빌더 코드는 온체인 수수료 로직의 일부로 실시간 적용됩니다.

{% hint style="info" %}
**변경 사항:** 이제 인테그레이터는 주소가 아닌 숫자형 `integratorId`로 식별되며, 등록은 단일 전역 단계입니다. 시장마다 볼트를 만들고 누적 수수료를 수령하던 기존의 시장별 수수료 볼트 모델은 제거되었습니다.
{% endhint %}

### 작동 원리

#### 사용자

사용자는 어떤 인테그레이터가 자신의 주문에서 수수료를 얻을 수 있는지 통제합니다.

* 인테그레이터별 최대 수수료 한도를 정해 승인
* 언제든지 권한 철회
* 인테그레이터마다 다른 수수료 한도 설정

#### 인테그레이터

인테그레이터는 수수료를 얻기 전에 일회성 전역 설정을 완료합니다.

1. 인테그레이터로 한 번 등록합니다(시장별이 아닌 전역 등록)
2. 사용자의 승인을 받습니다. 각 사용자는 최대 수수료를 설정합니다
3. `integratorId`와 부과할 수수료를 담아 주문을 제출합니다

생성할 볼트도, 수령 단계도 없습니다. 등록이란 무기한 선물 레지스트리에 기록되는 인테그레이터의 전역 주소이며, 이 주소는 `integratorId`를 잃지 않고 언제든지 변경할 수 있습니다.

#### 수수료 구조

* 인테그레이터 수수료는 일반 거래 수수료에 **추가로** 부과됩니다. 사용자의 승인은 이 추가 수수료만 제한합니다
* 수수료는 체결된 명목 거래량에 부과되며, 주문을 따라갑니다. 주문이 테이커로 즉시 체결될 때**와** 오더북에 대기했다가 나중에 메이커로 체결될 때 모두 적용됩니다
* 수수료는 소수 형태로 표기합니다: `0.0005`는 0.05% 수수료입니다
* 주문별 수수료는 사용자가 해당 인테그레이터에 승인한 `maxIntegratorFee`를 초과할 수 없습니다. 더 높은 수수료를 담은 주문이나 사용자가 승인하지 않은 인테그레이터의 수수료가 담긴 주문은 온체인에서 거부됩니다
* 프로토콜은 모든 인테그레이터 수수료에 \*\*1.00%\*\*의 절대 상한을 적용합니다

{% hint style="warning" %}
**메이커 체결도 빌더 수수료를 얻습니다.** [aftermath.finance/docs](https://aftermath.finance/docs)의 API 레퍼런스는 아직 `integratorFee`가 "테이커 거래량에만" 적용된다고 설명하며, 인테그레이터에게 시장별 볼트가 필요하다고도 적고 있습니다. 두 설명 모두 오래된 내용이며, 이 페이지가 최신입니다. 배포된 Move ABI가 이를 확인해 줍니다. [move-interfaces](https://github.com/AftermathFinance/move-interfaces)의 `perpetuals::events::FilledMakerOrder`는 `FilledTakerOrder`와 똑같이 `integrator_id`와 `integrator_fee_paid_usd`를 담고 있습니다.
{% endhint %}

### 개발자용

**TypeScript.** TypeScript SDK에는 빌더 코드 승인 함수가 포함되어 있으며, 아래 문서에 정리되어 있습니다. 일회성 인테그레이터 등록은 네이티브 API를 사용합니다.

{% embed url="<https://docs.aftermath.finance/for-developers/typescript-sdk/products/perpetuals/perpetuals#builder-code-integration-methods>" %}

**API.** 빌더 코드 엔드포인트는 API 레퍼런스를 참고하십시오.

{% embed url="<https://aftermath.finance/docs>" %}

#### API 엔드포인트

모든 빌더 코드 엔드포인트는 JSON 본문을 담은 POST 요청을 받습니다. 기본 URL: `https://aftermath.finance`

등록 정보와 계정별 승인 조회:

* `/api/perpetuals/builder-codes/integrator-registration`: `integratorId`를 등록된 `integratorAddress`로 변환합니다
* `/api/perpetuals/builder-codes/integrator-config`: `accountId`와 `integratorId`를 받아 `{ exists, maxIntegratorFee }`를 반환합니다

설정 및 승인을 위한 트랜잭션 빌드:

* `/api/perpetuals/builder-codes/transactions/create-integrator-registration`: 일회성 전역 등록, 인테그레이터가 서명합니다
* `/api/perpetuals/builder-codes/transactions/create-integrator-config`: 사용자가 인테그레이터를 승인하고 수수료 한도를 설정합니다
* `/api/perpetuals/builder-codes/transactions/remove-integrator-config`: 사용자가 인테그레이터 승인을 철회합니다

예시: 인테그레이터 등록

```
## Request
POST https://aftermath.finance/api/perpetuals/builder-codes/transactions/create-integrator-registration
Content-Type: application/json

{}

## Response
{
  "txKind": "<base64-encoded TransactionKind>",
  "sponsorSignature": null
}
```

인테그레이터의 신원은 온체인 트랜잭션 발신자에서 가져오므로 요청 본문에 주소를 넣지 않습니다. 모든 빌더 코드 트랜잭션 라우트에서 `txKind`(기존 트랜잭션 확장용)와 `sponsor`(GasPool 스폰서십용)는 선택 사항입니다. sponsor에는 `walletAddress`, `bytes`, `signature`와 선택적 MIST 단위 `gasBudget`이 들어갑니다. `bytes`는 재사용 가능한 `Aftermath Terms and Conditions` 메시지의 base64입니다.

예시: 사용자가 0.05% 한도로 인테그레이터를 승인

```
## Request
POST https://aftermath.finance/api/perpetuals/builder-codes/transactions/create-integrator-config
Content-Type: application/json

{
  "accountId": "123n",
  "integratorId": 1,
  "maxIntegratorFee": 0.0005
}
```

승인이 완료되면 해당 사용자를 위해 제출하는 각 주문에 빌더 코드를 첨부합니다:

```json
{
  "builderCode": { "integratorId": 1, "integratorFee": 0.0005 }
}
```

SL/TP와 스탑 주문은 상위 주문과 별개로 자체 `builderCode`를 받을 수 있습니다.

#### 트랜잭션 흐름

모든 트랜잭션 엔드포인트는 직렬화된 트랜잭션 종류(kind)를 반환합니다. 온체인에서 실행하려면:

1. 파라미터와 함께 트랜잭션 엔드포인트를 호출합니다
2. JSON 응답에서 `txKind`를 읽습니다
3. Sui SDK로 `txKind`에서 `Transaction`을 빌드합니다
4. 지갑으로 트랜잭션에 서명합니다
5. Sui 네트워크에 제출합니다

`sponsor`를 전달했다면 응답에 `sponsorSignature`도 포함됩니다. 이 경우 `txKind`에는 가스 지불이 이미 첨부된 base64 BCS 인코딩 `Transaction` 바이트가 담겨 있습니다. 이 바이트에 서명한 뒤 스폰서 서명과 함께 제출하십시오.

#### 통합 방식

빌더 코드를 통합하는 방법은 세 가지입니다.

* 네이티브 API(`/api/perpetuals/*`): 권장. 등록, 승인, 트랜잭션 빌더를 포함한 전체 기능을 제공합니다.
* TypeScript SDK(`aftermath-ts-sdk`): 빌더 코드 승인을 위한 타입 지원 헬퍼 메서드. 일회성 등록은 네이티브 API를 사용합니다.
* CCXT 호환 API(`/api/ccxt/*`): CCXT 표준을 따르는 봇 통합을 위한 거래소 스타일 엔드포인트.
