개발자 · 봇

환율 관리자를 따로 만들지 않고 예치금 자동화를 실행하세요.

봇 통합은 버튼이 제거된 브라우저 흐름이 아닙니다. 중복 방지, 재시작 안전 상태, 명시적인 지갑 보관, 웹훅 검증, 유동성이 비공개여야 할 때의 명확한 규칙이 필요합니다.

01

봇 시퀀스

  1. 1본인의 서명자 인프라에서 Base 지갑 클라이언트를 로드합니다.
  2. 2새 예치금을 생성하기 전에 deposits(walletAddress)를 호출합니다. 주문에 맞는 경우 활성 인벤토리를 재사용합니다.
  3. 3자동화를 식별할 수 있도록 integratorId 및 referralId와 함께 offramp(walletClient, params)를 호출합니다.
  4. 4구매자가 이미 알려진 경우 otcTaker를 사용합니다. 그렇지 않으면 예치금은 공개적으로 체결 가능합니다.
  5. 5depositId, txHash, platform, currency, amount 및 의도된 구매자 컨텍스트를 영속합니다.
  6. 6체결 및 종료가 프로세스 재시작 후에도 유지되도록 HMAC 웹훅을 등록합니다.
02

재시도 규율

  • SDK는 중복을 생성하는 대신 위임하여 미위임 예치금을 재개합니다.
  • 브라우저 idempotencyKey 캐싱은 Node 워커를 보호하지 않습니다. 워커는 새 유동성을 생성하기 전에 deposits(address)를 확인해야 합니다.
  • 생성 후 위임이 실패하면 동일한 지갑 경로를 재시도하세요. 재개 경로는 해당 상태를 위해 설계되었습니다.
  • USER_CANCELLED를 자동으로 재시도하지 마세요. 이는 서명자가 프롬프트를 거부했음을 나타냅니다.

Common questions

백엔드가 사용자 지갑 없이 예치금을 생성할 수 있나요?

예, 자체 Base 서명자와 USDC 잔액이 있는 경우 가능합니다. SDK는 제공하는 viem WalletClient를 통해 서명합니다. 보관 및 키 관리는 본인 책임입니다.

idempotencyKey가 봇 중복 예치금을 방지하나요?

아닙니다. idempotencyKey는 브라우저 세션 기반입니다. Node 또는 워커에서는 deposits(address)와 자체 주문 데이터베이스를 사용하여 중복 인벤토리를 방지하세요.