Entwickler · Bots

Einzahlungsautomatisierung betreiben, ohne einen Rate-Manager zu erfinden.

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

Bot-Sequenz

  1. 01Laden Sie einen Base-Wallet-Client aus Ihrer eigenen Signer-Infrastruktur.
  2. 02Rufen Sie deposits(walletAddress) auf, bevor Sie eine neue Einzahlung erstellen; verwenden Sie aktives Inventar wieder, wenn es zur Order passt.
  3. 03Rufen Sie offramp(walletClient, params) mit integratorId und referralId auf, damit die Automatisierung identifiziert werden kann.
  4. 04Verwenden Sie otcTaker, wenn der Käufer bereits bekannt ist; andernfalls ist die Einzahlung öffentlich ausführbar.
  5. 05Speichern Sie depositId, txHash, Plattform, Währung, Betrag und den beabsichtigten Käuferkontext.
  6. 06Poll deposits(address) or Peerlytics deposit/intent reads so fills and closes survive process restarts.
02

Wiederholungsdisziplin

  • Das SDK setzt nicht delegierte Einzahlungen durch Delegierung fort, anstatt ein Duplikat zu erstellen.
  • Das browserbasierte idempotencyKey-Caching schützt keine Node-Worker. Ihr Worker sollte deposits(address) prüfen, bevor er neue Liquidität erstellt.
  • Wenn die Delegierung nach der Erstellung fehlschlägt, wiederholen Sie dieselbe Wallet-Route; der Resume-Pfad ist für diesen Status konzipiert.
  • Wiederholen Sie USER_CANCELLED nicht automatisch. Dies zeigt an, dass ein Signierer eine Anfrage abgelehnt hat.

Häufige Fragen

Kann ein Backend Einzahlungen ohne eine Nutzer-Wallet erstellen?

Ja, wenn es seinen eigenen Base-Signierer und USDC-Guthaben hat. Das SDK signiert über den viem WalletClient, den Sie bereitstellen; Verwahrung und Schlüsselverwaltung liegen bei Ihnen.

Verhindert idempotencyKey doppelte Bot-Einzahlungen?

Nein. idempotencyKey ist browser-session-basiert. In Node oder Workers verwenden Sie deposits(address) und Ihre eigene Auftragsdatenbank, um doppeltes Inventar zu verhindern.