How to Track Cross-Chain Transfers Reliably

If your app sends tokens across chains, treat the source transaction and destination delivery as separate events; a successful source receipt does not mean the transfer is finished. Build a status view around the route’s steps so users can see what happened, what is waiting, and whether they need to act.

  • A mined source transaction confirms only that the first on-chain action succeeded.
  • Use the route’s step statuses and next check time to drive your app’s updates.
  • Show “complete” only when every required transaction and wait step is done.

Model the transfer as a sequence of states

A cross-chain transfer can include transactions to sign, automatic relayer actions, and waits for confirmations or protocol finalization. The sequence depends on the chosen route, so don’t assume every bridge has the same steps or timing. When deciding how your interface should explain the journey, keep what Super Bridge does across chains in mind: the route determines what happens after the source action.

For example, a route from Ethereum to Base might start with a wallet transaction, then wait for source confirmation, then rely on a relayer to deliver funds. A native route can involve a much longer wait; Optimism’s native bridge, for example, has a seven-day challenge period for withdrawals. Present the route’s expected steps and timing before submission, then update them from observed status.

Use the activity record to advance the transfer

For an integration with Super Bridge, the Activity endpoint returns the transfer’s steps and a nextCheckTimestamp. Save the initiating transaction hash as soon as the wallet submits it; use that hash to find the matching activity record, or query by the user’s address. If the record has not appeared yet, treat it as “awaiting indexing,” not as a failed transfer.

  1. Wait for the source transaction receipt and store its hash with the source and destination chain identifiers.
  2. Query /v1/activity using the initiating hash or address, then match the activity’s transaction confirmation hash to your saved hash.
  3. Read every step: ready means a transaction can be submitted, auto means a relayer handles it, and done means a transaction was confirmed. Wait steps use in-progress and done.
  4. When a transaction step is ready, request its transaction data with the step action and submitter address, then ask the wallet to sign and send it.
  5. Schedule the next activity check from nextCheckTimestamp; if it is null or already passed, check now.

Keep both chain IDs alongside the hash: a hash is only meaningful on its own chain, and the same user may have several transfers in flight. Store each step’s status and transaction hash so a page refresh or backend restart can restore progress without asking the user to submit the original transaction again.

Report delays and completion accurately

Suppose a user sends 0.01 ETH from Ethereum to Base. The source receipt arrives, but the route is still in a wait step. Your app should show “source confirmed; destination pending,” not “complete,” and use the route’s expected duration to set a reasonable expectation. A delayed indexer can briefly leave the activity record missing; retry the lookup rather than encouraging the user to repeat the transfer.

Stop polling only when all transaction steps are confirmed or automatic and all wait steps are done. If a step becomes actionable, surface the required wallet action; if the route remains in a wait, show its last confirmed step and check again at the supplied time. The reliable pattern is simple: persist the source hash, follow the route’s actual steps, and reserve “complete” for confirmed destination delivery.

Comments

Post a Comment

Popular posts from this blog

How Do I Compare Cross-Chain Swap Quotes?

Compare the amount expected to arrive after route costs: in an illustrative transfer, 994 USDC net beats 1,000 USDC less a separate 8 USDC charge. A cross-chain quote can combine a swap on the source chain, a bridge transfer, and a swap on the destination chain, so compare the whole journey. Rango bridge is a way to find routes across supported chains; the Rango bridge service can help when you want to handle that journey through one service. Read Each Quote As A Full Route A route is a sequence of actions, and the order tells you where price changes and costs can enter. For example, a route might swap ETH to USDC on the source chain, bridge USDC, then swap to a different token after arrival. Check the starting asset and amount, destination chain, and exact token contract or denomination you expect to receive. A token with the same ticker can be a different asset on another chain. A route’s final output matters only if it is the asset you intended to hold. Route aggregation services, ...
Read more

How to Check a Chainflip Boost Falls Back

A Boosted Bitcoin deposit can save about 20 minutes, but only when Boost liquidity is available. If it isn’t, the deposit waits for the usual confirmations, so you can judge the speed benefit without assuming it is guaranteed. Boost liquidity decides whether the deposit gets a head start Boost is an option that lets a swap begin before the source deposit has completed its usual confirmation wait. For Bitcoin, the normal wait is about three blocks, or roughly 30 minutes; a Boosted deposit may proceed after one block. That early start depends on Boost liquidity: funds that liquidity providers set aside to cover deposits while they are still waiting for full confirmation. The protocol checks whether enough is available for the whole deposit. Boosting is all or nothing, so a shortfall means the entire deposit follows the regular confirmation path. After a Bitcoin deposit appears in a block, validators check it and the available Boost funds. If enough is available, the protocol uses those f...
Read more

How to trace a delayed crypto swap from your wallet

Image
Trace a delayed swap by checking each blockchain step in order. A confirmed send on the first chain does not prove the swap has finished on the second. Find the original transaction hash and check its status on the source chain. Compare the destination chain and wallet address with your swap details. Wait for the route’s required steps; do not send a duplicate swap. What does “pending” mean across chains? A cross-chain swap moves value from one blockchain to another, sometimes through several transactions. A route may need the source chain to confirm your deposit, then a bridge or relayer—a service that passes information between chains—to trigger the next step. That gap explains why your wallet can show a successful send while the destination asset is still missing. Rango bridge is an example of a service that finds routes across chains; the same status-checking logic applies to any route. How do you find where the swap stopped? Open the source transaction. Copy its transaction has...
Read more