開発者向け · ボット

レートマネージャーを自前で発明せずにデポジット自動化を実行。

ボット統合は、ボタンを取り除いたブラウザフローではありません。重複防止、再起動に強い状態、明示的なウォレットカストディ、Webhook検証、そして流動性をいつプライベートにすべきかという明確なルールが必要です。

ボットテンプレートをクローンWebhookガイドを読む
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 Webhookを登録します。
02

リトライの規律

  • SDKは未委任のデポジットを、重複作成ではなく委任することで再開します。
  • ブラウザのidempotencyKeyキャッシュはNodeワーカーを保護しません。ワーカーは新しい流動性を作成する前にdeposits(address)を確認すべきです。
  • 作成後に委任が失敗した場合は、同じウォレットルートで再試行してください。再開パスはその状態のために設計されています。
  • USER_CANCELLEDを自動で再試行しないでください。これは署名者がプロンプトを拒否したことを示します。
03

便利なボットパターン

給与または支払いキュー

既知の買い手ウォレットごとにプライベートOTCデポジットを1つ作成し、返されたリンクを送ります。

トレジャリー流動性ボット

優先ルートで小さな委任デポジットを維持し、Webhookで確認されたフィルの後に補充します。

サポート照合

depositIdとtxHashをサポートのハンドルとして使い、deposits(address)で照合します。

Keep exploring

Offramp SDKDeveloper hub

Common questions

バックエンドはユーザーウォレットなしでデポジットを作成できますか？

はい。自前のBase署名者とUSDC残高があれば可能です。SDKは渡されたviem WalletClientを通じて署名します。カストディと鍵管理はあなたの責任です。

idempotencyKeyは重複したボットデポジットを防ぎますか？

いいえ。idempotencyKeyはブラウザセッションに依存します。Nodeやワーカーでは、deposits(address)と自前の注文データベースを使って重複した在庫を防いでください。