Troubleshooting

Common issues you may encounter when integrating with the Superbridge API

Delayed OP Stack Dispute Games

When bridging via the OP Stack native bridge, withdrawals require a valid dispute game to be posted on-chain before the withdrawal can be proven. Superbridge analyses historical dispute game posting and resolution times to estimate when this step will be ready.

In practice, delays in dispute game resolution are common and can vary significantly. The estimated time provided by the API reflects historical patterns but actual resolution may take longer.

If you observe extended delays beyond the estimated time, please get in touch.

Delayed CCTP Minting

When bridging via CCTP (Circle's Cross-Chain Transfer Protocol), the mint step requires an attestation from Circle before it can be executed. Bridge durations often exceed the advertised time because pulling the attestation from Circle can be delayed.

If you observe extended delays in CCTP attestations, please get in touch.

Invalidation Events

Rollups can invalidate pending withdrawals, typically during system upgrades or as a security fix. An invalidation event resets the wait duration required for a withdrawal, meaning users will need to wait the full proving/challenge period again from the point of invalidation.

Invalidation events will almost always be accompanied by an Info Step in the transaction's steps array, providing context on what happened.

Where possible, when the date for an invalidation event is known ahead of time, the Superbridge API will restrict certain routes to prevent withdrawals being initiated that would be immediately affected.