Développeurs · Bots

Faites tourner l'automatisation de dépôts sans inventer de gestionnaire de taux.

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.

Cloner les templates de botsRead Peerlytics guide
01

Séquence du bot

  1. 01Chargez un wallet client Base depuis votre propre infrastructure de signature.
  2. 02Appelez deposits(walletAddress) avant de créer un nouveau dépôt ; réutilisez l'inventaire actif quand il correspond à l'ordre.
  3. 03Appelez offramp(walletClient, params) avec integratorId et referralId pour que l'automatisation puisse être identifiée.
  4. 04Utilisez otcTaker quand l'acheteur est déjà connu ; sinon le dépôt est remplissable publiquement.
  5. 05Persistez depositId, txHash, platform, currency, amount et le contexte de l'acheteur visé.
  6. 06Poll deposits(address) or Peerlytics deposit/intent reads so fills and closes survive process restarts.
02

Discipline de retry

  • Le SDK reprend les dépôts non délégués en les déléguant au lieu de créer un doublon.
  • Le cache navigateur idempotencyKey ne protège pas les workers Node. Votre worker devrait vérifier deposits(address) avant de créer de la nouvelle liquidité.
  • Si la délégation échoue après la création, réessayez la même route de wallet ; le chemin de reprise est conçu pour cet état.
  • Ne réessayez pas USER_CANCELLED automatiquement. Cela indique qu'un signataire a rejeté une invite.
03

Patterns de bots utiles

File de paie ou de paiements

Créez un dépôt OTC privé par wallet acheteur connu, puis envoyez le lien retourné.

Bot de liquidité de trésorerie

Maintain a small delegated deposit on a preferred route and refill after reconciled fills.

Réconciliation de support

Utilisez depositId et txHash comme identifiants de support, puis réconciliez avec deposits(address).

Poursuivre l’exploration

SDK d’off-rampEspace développeurs

Questions fréquentes

Un backend peut-il créer des dépôts sans wallet utilisateur ?

Oui, s'il dispose de son propre signataire Base et d'un solde en USDC. Le SDK signe via le WalletClient viem que vous fournissez ; la custody et la gestion des clés vous appartiennent.

idempotencyKey empêche-t-il les dépôts de bot en double ?

Non. idempotencyKey est soutenu par la session du navigateur. Dans Node ou les workers, utilisez deposits(address) et votre propre base de données d'ordres pour empêcher l'inventaire en double.