개발자 · Base

USDCtoFiat 예치의 Builder Code 어트리뷰션을 검증하세요.

발급된 코드는 프로덕션 앱의 트랜잭션 calldata에 연결되어 있습니다. 이 가이드에서 어느 경로가 접미사를 관리하며 트랜잭션 후 무엇을 검증해야 하는지 확인하세요.

01

어트리뷰션 순서

  1. 01Base Mini App을 안정적인 HTTPS origin에 배포합니다.
  2. 02Base.dev에서 앱을 등록하고 검증합니다.
  3. 03Base.dev 설정에서 실제 Builder Code를 복사합니다.
  4. 04ox/erc8021로 해당 코드에서 ERC-8021 dataSuffix를 생성합니다.
  5. 05직접 관리하는 트랜잭션 경로에서는 기존 접미사를 제거한 후 정규화된 dataSuffix 하나를 추가하세요.
  6. 06작은 USDCtoFiat 예치를 만들고 캠페인 시작 전에 어트리뷰션을 검증합니다.
02

적용 위치

표면어트리뷰션 경로
Base AppBase 문서에 따르면 등록된 앱은 Base App 내부 활동에 대해 자동 어트리뷰션을 받을 수 있습니다.
웹 앱USDCtoFiat 웹 어댑터는 기존 접미사를 교체하고 프로덕션 코드를 추가합니다.
USDCtoFiat SDKSDK는 자체 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을 검사할 수 있습니다.

자주 묻는 질문

USDCtoFiat은 이미 발급된 Builder Code를 사용하나요?

예. 프로덕션 어댑터는 발급된 Builder Code를 onchain 예치 calldata에 추가합니다. 실제 트랜잭션 후 Base.dev 또는 블록 탐색기에서 어트리뷰션 성공 여부를 검증하세요.

@usdctofiat/offramp에 별도의 Builder Code 옵션이 필요한가요?

아니요. SDK는 이미 galleonlabs 리퍼러를 제공하며 별도의 Builder Code를 위한 지원되는 병합 경로를 현재 노출하지 않습니다. 두 번째 클라이언트 수준 접미사를 추가하지 마세요.

ERC-8021이 ZKP2P 컨트랙트를 변경하나요?

아니요. Base 문서는 Builder Codes를 calldata suffix attribution으로 설명합니다. 컨트랙트는 정상 실행되고, 어트리뷰션은 트랜잭션 이후 오프체인 indexers가 읽습니다.