Skip to Content
SupraNova (Bridge)Troubleshooting

Troubleshooting

Messages in the SupraNova application

MessageMeaningWhat to do
Insufficient balanceThe source wallet does not hold enough of the asset, or of the native token for gas.Top up the source wallet. On SupraMVM Devnet, get PEPE and DOGE from the application’s Faucet page.
Exceeds max transfer.The amount is above the per-request limit for the asset.Send a smaller amount. See Transfer Limits.
Switch To Mainnet / TestnetThe wallet is connected to a different network from the one the application expects.Switch the wallet to the network shown.

A transfer stays at “Transfer Initiated”

A transfer is complete only after a relayer delivers it and the destination chain verifies it. If a transfer stays at Transfer Initiated:

  1. Check finality. A relayer cannot deliver a transfer from Ethereum until its block is deep enough in Ethereum’s consensus for the Token Bridge’s verification strategy. See Finality.
  2. Check delivery. Follow the transfer in Transaction Details or Explorer > My Transactions, or check it on-chain. See Track a Transfer.
  3. Wait for a relayer or a committee update. If no relayer has delivered the transfer yet, or the destination verifier’s committee keys are out of date, the transfer waits. Both cases delay the transfer but put no funds at risk. The transfer completes after a relayer delivers it or a Committee Updater submits the new keys. You can also deliver it yourself. See Recover a Transfer.

A contract call reverts

If you call the contracts directly and a transaction reverts or aborts, the error names the check that failed. The tables below list the most common errors, first for senders and then for relayers and applications that receive messages.

The EVM contracts revert with custom errors. Below each error are its 4-byte selector and the contract that reverts with it. An explorer that does not have the contract’s ABI shows only the selector.

When sending

ErrorCauseWhat to do
LockLimitBreached()
0xe062d1dc · TokenVault
The amount to lock is outside the token’s per-request limits.Read lockLimits(token) and change the amount. See Transfer Limits.
GlobalLockLimitBreached()
0x69e5adae · TokenVault
The vault would hold more of the token than its global cap.Send less, or try again later. Compare lockedTokenBalance(token) with the cap.
WrappedTokenLimitBreached(uint256,uint256,uint256)
0x639b0be6 · TokenBridge
On SupraEVM Devnet, the amount to burn, after fees, is outside the wrapped token’s limit, or the limit is not configured yet.Read the limit from the last field of inboundTokenInfo and change the amount. A limit of 0 to 0 means the token cannot be sent yet. See Quote Fees and Limits.
InsufficientAmount(uint256,uint256,uint256)
0xa3a05223 · FeeOperator
The fee is not below the amount.Quote the fee with inboundTokenFee and send a larger amount.
InboundTokenNotEnabled()
0x940d5fd7 · TokenBridge
The token is not enabled for this destination chain. inboundTokenFee reverts with TokenNotRegistered() (0x259ba1ad) for the same reason.Check the token in Supported Tokens. For native currency, the token is the address returned by nativeToken().
ChainNotEnabled()
0xd53a2e13 · TokenBridge
The destination chain is not enabled on the TokenBridge.Check the chain ID in Supported Networks.
ChainNotEnabled(uint64)
0x1c33fbee · Hypernova
The destination chain is not enabled on Hypernova.Check the chain ID in Supported Networks.
ERC20InsufficientAllowance(address,uint256,uint256)
0xfb8f41b2 · the token
The TokenBridge is not approved to spend the amount. Tokens not built on OpenZeppelin v5 revert with their own error.Approve the TokenBridge proxy, not the TokenVault, for the full amount.
InvalidAmount()
0x2c5211c6 · TokenBridge
The amount, or the transaction value for sendNative, is zero.Send a non-zero amount.
InvalidReceiver()
0x1e4ec46b · TokenBridge
The receiver is zero.Pass the recipient’s address as a bytes32.
BridgePaused()
0xa792dfa3 · TokenBridge
The TokenBridge is paused. VaultPaused() (0xda9f8b34), FeeOperatorPaused() (0x710665fd) and HypernovaPaused() (0x3822c4b7) mean the same for the other contracts.Wait until the admin resumes the contract. Each contract reports its state with isPaused().
StaleOraclePrice()
0xa887f2d8 · FeeOperator
The price used for a dynamic fee is out of date.Try again later.

When delivering or verifying a message

ErrorCauseWhat to do
InvalidVerificationFeeReceived(uint256,uint256)
0xbe01d68c · Hypernova
The transaction value is not exactly the verification fee times the number of messages. Paying more also reverts.Read sourceEnabledChainVerificationFee(chainId) with the SupraMVM chain ID, and send exactly that amount per message.
MessageAlreadyProcessed()
0x7b042609 · Hypernova
The consumer has already processed this message.The message is already delivered. Check with isMessageProcessed(chainId, consumer, messageId).
UnauthorizedCaller(bytes32)
0x49056a96 · Hypernova
The expectedCaller did not post the message. For the TokenBridge, only the SupraMVM Token Bridge can post transfers.Submit only messages posted by the expected SupraMVM account. See Receive a Message.
InclusionCertificateNotVerified(uint64)
0x85a94c54 · Hypernova
A function without a certificate was called before any certificate for that block was verified.Call the variant that takes the certificate.
UnverifiedCertifyingCommittee()
0xe66caa47 · Hypernova
The committee that signed the certificate is not registered yet.Wait for a committee update, or submit one. See Committee Updaters.
CertifyingCommitteeTooOld(uint64,uint64)
0x8808370b · Hypernova
The committee that signed the certificate is older than the epoch tolerance allows.Use a certificate signed by a more recent committee.
ReleaseLimitBreached()
0x13bcdb6f · TokenVault
The amount to release, or the relayer reward, is outside the token’s release limits.Contact Supra. The transfer can be delivered once the limits allow it.

Still stuck?

Contact Supra through the Support Portal or Discord .

Last updated on