Nhà phát triển · Bot

Vận hành tự động hóa ký gửi mà không phải tự phát minh một bộ quản lý tỷ giá.

A bot integration is not a browser flow with the buttons removed. It needs duplicate prevention, restart-safe state, explicit wallet custody, and a clear rule for when liquidity should be private.

01

Trình tự bot

  1. 01Tải một wallet client Base từ hạ tầng ký của riêng bạn.
  2. 02Gọi deposits(walletAddress) trước khi tạo một khoản ký gửi mới; tái sử dụng kho đang hoạt động khi nó phù hợp với lệnh.
  3. 03Gọi offramp(walletClient, params) với integratorId và referralId để có thể nhận diện tự động hóa.
  4. 04Dùng otcTaker khi đã biết người mua; nếu không, khoản ký gửi có thể được lấp công khai.
  5. 05Lưu lại depositId, txHash, platform, currency, amount, và ngữ cảnh người mua dự kiến.
  6. 06Poll deposits(address) or Peerlytics deposit/intent reads so fills and closes survive process restarts.
02

Kỷ luật thử lại

  • SDK tiếp tục các khoản ký gửi chưa ủy thác bằng cách ủy thác thay vì tạo một bản trùng lặp.
  • Bộ nhớ đệm idempotencyKey của trình duyệt không bảo vệ các worker Node. Worker của bạn nên kiểm tra deposits(address) trước khi tạo thanh khoản mới.
  • Nếu việc ủy thác thất bại sau khi tạo, hãy thử lại cùng một tuyến ví; con đường tiếp tục được thiết kế cho trạng thái đó.
  • Đừng tự động thử lại USER_CANCELLED. Điều đó cho thấy một bên ký đã từ chối một lời nhắc.

Câu hỏi thường gặp

Một backend có thể tạo các khoản ký gửi mà không cần ví người dùng không?

Có, nếu nó có một bên ký Base riêng và số dư USDC. SDK ký thông qua viem WalletClient bạn cung cấp; việc giám hộ và quản lý khóa thuộc về bạn.

idempotencyKey có ngăn các khoản ký gửi bot trùng lặp không?

Không. idempotencyKey được hỗ trợ bởi phiên trình duyệt. Trong Node hoặc worker, hãy dùng deposits(address) và cơ sở dữ liệu lệnh của riêng bạn để ngăn kho trùng lặp.