Invalidate quotes when the wallet changes chain
Reset wallet-dependent execution state on chain changes and reject late responses from the previously selected network.
Explore the reference
Integration engineering — page 2
Handle precision, validation, reliability and the operating details behind a swap interface.
69 guides · Page 2 of 4
JSON-RPC batching and Multicall solve different problems
Choose transport batching or contract Multicall according to state consistency, call context and failure isolation.
Keep a local ledger of swap attempts and outcomes
Persist stable swap attempt identities and reconcile them with receipts or order evidence after a reload.
Keep chain configuration separate from provider configuration
Separate chain identity, token configuration, RPC settings and provider capabilities so unsupported combinations fail explicitly.
Keep swap API secrets out of the browser
Design a narrow backend quote proxy that protects service credentials without taking control of users’ wallet keys.
Let confirmed swap records survive a chain reorganization
Treat recent receipts as provisional and reconcile swaps when their inclusion block is no longer canonical.
Log swap failures without storing sensitive payloads
Minimize and redact diagnostic data in quote and transaction logs while retaining identifiers needed for support.
Make approval and swap status understandable to assistive tools
Announce approval and swap status changes clearly without relying on color, focus jumps or constantly repeating quote updates.
Measure where a swap funnel actually fails
Instrument the swap funnel by stage and correlate quote, approval, wallet, broadcast and receipt events without storing secrets.
Model multi-input and multi-output swaps explicitly
Represent basket swaps with explicit asset amounts, output constraints and atomicity instead of reusing a single-pair form.
Native token sentinel addresses need provider adapters
Translate native currency through a provider-specific adapter rather than assuming one placeholder address works everywhere.
Normalize aggregator responses without losing meaning
Create a common quote model that preserves provider-specific execution types, cost units and missing values.
Normalize slippage units at each API boundary
Convert slippage fractions, percentages and basis points explicitly and test provider boundaries with equivalent values.
Permit2 integration has two authorization layers
Separate token approval to Permit2 from Permit2 permission to a downstream spender and track their different lifetimes.
Preserve transaction value when executing a native swap
Keep native transaction value intact through API normalization, simulation and wallet submission.
Rebasing tokens can invalidate cached balances
Refresh rebasing token balances from current state and avoid treating Transfer logs as a complete balance history.
Record the block context behind a route
Preserve quote and simulation block context so differences can be investigated without pretending routes are immutable.
Recover from wallet disconnection without losing swap history
Separate wallet connectivity from public transaction observation so disconnecting cannot erase or mislabel pending swaps.
Render token names and logos as untrusted content
Render token labels, logos and links as untrusted external data, even when they arrive from a legitimate quote API.
Review a swap integration before enabling transactions
Collect evidence that a swap integration preserves user intent, handles uncertain outcomes and can stop new execution safely.