01
어트리뷰션 순서
- 01Base Mini App을 안정적인 HTTPS origin에 배포합니다.
- 02Base.dev에서 앱을 등록하고 검증합니다.
- 03Base.dev 설정에서 실제 Builder Code를 복사합니다.
- 04ox/erc8021로 해당 코드에서 ERC-8021 dataSuffix를 생성합니다.
- 05직접 관리하는 트랜잭션 경로에서는 기존 접미사를 제거한 후 정규화된 dataSuffix 하나를 추가하세요.
- 06작은 USDCtoFiat 예치를 만들고 캠페인 시작 전에 어트리뷰션을 검증합니다.
02
적용 위치
| 표면 | 어트리뷰션 경로 |
|---|---|
| Base App | Base 문서에 따르면 등록된 앱은 Base App 내부 활동에 대해 자동 어트리뷰션을 받을 수 있습니다. |
| 웹 앱 | USDCtoFiat 웹 어댑터는 기존 접미사를 교체하고 프로덕션 코드를 추가합니다. |
| USDCtoFiat SDK | SDK는 자체 galleonlabs 리퍼러를 제공합니다. 두 번째 클라이언트 수준 접미사를 중첩하지 마세요. 현재 SDK API는 별도의 통합자 코드를 지원하지 않습니다. |
| 컨트랙트 | 컨트랙트 변경은 필요 없습니다. ERC-8021 suffix 데이터는 calldata에 추가되고 오프체인에서 인덱싱됩니다. |
03
구현 메모
- Base 문서 경로에는 viem 2.45.0 이상을 사용하세요. 이 앱은 이미 더 새로운 viem 버전을 사용합니다.
- USDCtoFiat의 프로덕션 어댑터에는 발급된 Builder Code가 연결되어 있습니다. 어트리뷰션 성공 여부는 여전히 트랜잭션 단위로 검증해야 합니다.
- 직접 관리하는 Viem 또는 Wagmi 트랜잭션에서는 사용할 모든 코드로 dataSuffix 하나를 생성하세요.
- 서로 다른 ERC-8021 접미사를 이어 붙이지 마세요. 서명하기 전에 코드를 파싱해 교체하거나 하나의 접미사로 병합하세요.
- @usdctofiat/offramp SDK는 이미 Galleon Labs 어트리뷰션을 제공합니다. 별도의 Builder Code 병합 옵션은 노출하지 않습니다.
04
검증
| 확인 | 통과 조건 |
|---|---|
| Base.dev | 앱의 Builder Code에 대한 온체인 트랜잭션 수가 증가합니다. |
| 블록 탐색기 | 트랜잭션 input이 ERC-8021 suffix marker로 끝나고 예상 코드로 decode됩니다. |
| USDCtoFiat 결과 | 생성된 예치는 depositId와 txHash를 반환한 뒤 deposits(address)에 나타납니다. |
| Peerlytics | 인덱싱이 따라잡으면 예치와 intent lifecycle을 검사할 수 있습니다. |