Skip to main content

Optics Bridge FAQs

What is the Optics Bridge?​

Optics is a protocol for sending messages between EVM chains. It can be used to securely send tokens cross-chain using the burn/mint token model.

How long does it take to send a transaction?​

It typically takes 1 hour for funds to arrive at the destination chain, but can take longer. Optics uses an optimistic model that includes a 30-minute period. We are working on ways to significantly reduce latency for users.

How do I convert my v1 tokens into v2?​

For converting Optics Bridge v1 wETH, wBTC, cUSDC to v2 you should use the Mobius + Celo one-for-one migration tool. This tutorial guides you through the process.

How can I check the status of my transaction?​

Go to optics.app/search-transaction and select the network you bridged FROM and enter the transaction hash.

I’m unable to check the status of the transaction?​

Make sure you are searching the transaction within the correct version of Optics. Within the Optics.app site, located on the top right & left side of the window you can choose between Optics v1 and v2.

I’m unable to obtain a transaction update with a transaction using Polygon, how do I check status?​

This often happens when the RPC server on Polygon is not responding to requests. To check status, use a block explorer to verify the transaction was sent successfully. Next, check the receiving network with block explorer to view if you received the tokens. The typical time to process is 30 minutes for Optics v2 and 4 hours for Optics v1.

I get “Error fetching transaction” when searching my transaction?​

Make sure you have the right network selected and the correct hash. If you are still seeing the error, try again in a few minutes. Your funds are safe, this does not indicate an error with your transaction.

My funds haven’t arrived after 5+ hours​

Your funds are safe. Sometimes the agent that processes messages gets stuck. Reach out to us in #bridge-support and we will get your transaction back on track. We are working to improve agent stability.

I filled out the form but haven’t gotten a response​

We will be deprecating the form and migrating to our new discord server. Please reach out to us in #bridge-support.

It shows my transaction was processed, but I haven’t received the funds​

Your transaction was a success, you are likely looking at the wrong token address. Go to optics.app and click on your address in the top right corner. It will open up a modal with a list of tokens on each chain and the ability to add them to Metamask.

The app doesn’t recognize my token balance​

Some tokens are not currently supported (Polygon WETH, Polygon SUSHI, etc)

My newly-added token has an ugly name, can it be changed?​

Yes, reach out to us on #bridge-support and we’ll request a name change.

I sent USDC to Polygon but I think I received the wrong token, how do I resolve?​

If you obtained USDC tokens which are not recognized on the Polygon network, you might have sent the wrong token. There are two core USDC token contracts, one that is native to the Ethereum network and the another that represents USDC on the Polygon network. There are multiple USDC contracts on different networks, each corresponding to the bridge that was used to send the token. For example, with Polygon, USDC sent via the Polygon Bridge will have a different address than USDC sent via the Optics Bridge (and it doesn’t matter if the USDC is comes from Celo or directly from Ethereum). On Polygon, there are greater incentives for users to bridge USDC via the polygon bridge, so that is the more popular token with greater liquidity. To transfer the popular version of Polygon USDC from Celo to Polygon via Optics, make sure that you use USDC PoS. In the event you sent the wrong token, bridge back the tokens to convert to USDC PoS and then bridge USDC PoS to Polygon.

How do I transfer value from Celo to Polygon?​

It’s recommended to use USDC PoS.

To get USDC using token with address 0x2791bca1f2de4661ed88a30c99a7a9449aa84174 on Polygon you should send USDC PoS with token address 0x1bfc26cE035c368503fAE319Cc2596716428ca44 from Celo.

How do I verify token addresses?​

Within the Optics.app dashboard, on the top right side of the page, select your wallet address to bring up the contract validation window to view token addresses.

After connecting your wallet, tap your wallet address:

Connect your wallet

This will display the list of tokens:

View token list

Resources​

Dashboards​

https://optics.app/

https://bridge.mobius.money/#/

Token Addresses​

CUSD:0xd8f3208c045dd69d27938346275165998359d8ff
CELO:0xc95dc0eceec11ab8b2bfa1aff3c223c5dc006fad
SUSHI:0x6b3595068778dd592e39a122f4f5a5cf09c90fe2
WETH:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
WBTC:0x2260fac5e5542a773aa44fbcfedf7c193bc2c599
UNI:0x1f9840a85d5af5bf1d1762f925bdaddc4201f984
LINK:0x514910771af9ca656af840dff83e8264ecf986ca
USDC:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
USDT:0xdac17f958d2ee523a2206206994597c13d831ec7
DAI:0x6b175474e89094c44da98b954eedeac495271d0f
CEUR:0x977453366b8d205f5c9266b6ba271e850a814a50

Optics Contracts​

Optics replica contracts are configured for each network within: https://github.com/celo-org/optics-monorepo/tree/main/rust/config/production-community

https://github.com/celo-org/optics-monorepo/blob/main/rust/config/production-community/celo_contracts.json