Permit signature expired before the swap: what needs renewing?
Renew the correct authorization when a permit expires, while checking whether the route and token allowance are still valid.
Explore the reference
Fix a swap problem — page 2
Identify failed, pending or unexpected transactions using the evidence recorded on-chain.
50 guides · Page 2 of 3
Price impact warning: when a smaller swap is the safer diagnostic
Use a price-impact warning to inspect trade size and available execution, without confusing it with slippage tolerance.
Quote expired before signing: refresh or resubmit?
Refresh stale swap instructions and reassess the economic terms when a quote expires before execution.
Rebasing tokens and failed swaps: check router compatibility
Evaluate the exact router and token behavior when balances change through rebasing, without assuming every rebase swap must fail.
Replacement transaction underpriced: what does the wallet mean?
Why a node can reject a higher-fee replacement and what to check before changing transaction fees again.
RPC unavailable during a swap: what did the chain receive?
Separate a broken wallet connection from the state of a swap that may already have been submitted.
Speeding up a pending swap without creating a second trade
Accelerate an existing pending transaction by replacing its fee bid while preserving awareness of its quote and deadline.
Swap amount looks wrong by powers of ten
Distinguish raw token units from display decimals when a swap amount appears too large or too small.
Swap connected to the wrong wallet account
Match the application’s connected account with the actual signer and recipient before approving or swapping.
Swap out of gas: when changing the gas limit helps
Distinguish an exhausted execution gas limit from expensive gas and logical swap failures before changing wallet settings.
Swap output went to a different recipient: what can be recovered?
Establish where swap output went and what recovery depends on when the recipient differs from your intended account.
Swap stuck after returning from the mobile wallet
Check wallet activity when a mobile swap stops updating after you return from the signing app.
Swap succeeded but the output token is missing from my wallet
Check the recipient, token contract, network and hidden-token display when a confirmed swap seems to have produced no output.
Taxed token swap fails: why the route may be incompatible
Why token-level deductions can make a quote inaccurate or a router incompatible, even when you approve enough.
The aggregator connects but cannot request a valid signature
Why a wallet can connect to an aggregator yet fail when the application requests a transaction or typed-data signature.
The swap failed on slippage: what should change before retrying?
Diagnose a minimum-output failure and compare a refreshed quote before accepting a wider execution range.
The swap shows an error but has no transaction hash
Work out whether a swap stopped before signing, failed during submission or lost its confirmation display before retrying.
The wallet cannot switch to the swap network
Check supported chains and connection permissions when the wallet cannot switch to the network required by a swap.
Transaction deadline expired: can the old swap still execute?
Distinguish contract execution deadlines from pending transaction status and avoid resubmitting expired swap data.
TRANSFER_FROM_FAILED: check allowance, balance and token restrictions
Check the token pull step when a swap fails with TRANSFER_FROM_FAILED or a related transfer error.