diff --git a/docs/celo-codebase/protocol/bridging/optics-bridge-faq.md b/docs/celo-codebase/protocol/bridging/optics-bridge-faq.md index a3f2252c71..f21f4c69eb 100644 --- a/docs/celo-codebase/protocol/bridging/optics-bridge-faq.md +++ b/docs/celo-codebase/protocol/bridging/optics-bridge-faq.md @@ -3,6 +3,11 @@ title: Optics Bridge FAQs description: Common questions about the Optics Bridge. --- +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; +import ImageWrapper from '@components/ImageWrapper' + + # Optics Bridge FAQs @@ -26,6 +31,17 @@ For converting Optics Bridge v1 wETH, wBTC, cUSDC to v2 you should use the Mobiu Go to [optics.app/search-transaction](https://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. @@ -54,3 +70,113 @@ 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](https://discord.gg/Rp8TYetc) 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](https://wallet.polygon.technology/) 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: + + +This will display the list of tokens: + + + + +## Resources + + +### Dashboards + +[https://optics.app/](https://optics.app/) + +[https://bridge.mobius.money/#/](https://bridge.mobius.money/#/) + + + +### Token Addresses + + + + + + + + + + + + + + + + +
SUSHI:0x29dFce9c22003A4999930382Fd00f9Fd6133Acd1
WETH:0x122013fd7dF1C6F636a5bb8f03108E876548b455
WBTC:0xBAAB46E28388d2779e6E31Fd00cF0e5Ad95E327B
USDC:0xef4229c8c3250C675F21BCefa42f58EfbfF6002a
USDCPOS (Polygon):0x1bfc26cE035c368503fAE319Cc2596716428ca44
USDT:0x88eeC49252c8cbc039DCdB394c0c2BA2f1637EA0
DAI:0x90Ca507a5D4458a4C6C6249d186b6dCb02a5BCCd
CELO:0x471ece3750da237f93b8e339c536989b8978a438
CUSD:0x765DE816845861e75A25fCA122bb6898B8B1282a
CEUR:0xD8763CBa276a3738E6DE85b4b3bF5FDed6D6cA73
WMATIC:0x2E3487F967DF2Ebc2f236E16f8fCAeac7091324D
+ + + + + + + + + + + + + + +
CUSD:0xd8f3208c045dd69d27938346275165998359d8ff
CELO:0xc95dc0eceec11ab8b2bfa1aff3c223c5dc006fad
SUSHI:0x6b3595068778dd592e39a122f4f5a5cf09c90fe2
WETH:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
WBTC:0x2260fac5e5542a773aa44fbcfedf7c193bc2c599
UNI:0x1f9840a85d5af5bf1d1762f925bdaddc4201f984
LINK:0x514910771af9ca656af840dff83e8264ecf986ca
USDC:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
USDT:0xdac17f958d2ee523a2206206994597c13d831ec7
DAI:0x6b175474e89094c44da98b954eedeac495271d0f
CEUR:0x977453366b8d205f5c9266b6ba271e850a814a50
+ + + + + + + + + + + + + + +
SUSHI:0xa84b7d339570eb053939810f56ab6eef2e0b38cd
WETH:0xac24381947d4f44c2da58881547c0c38196beb07
WBTC:0x15d25a3c47037c133210ab90adae4d51365a1108
USDC:0x22d9c9fc91ebd595af762ed4c9d5cc1d92cabf59
USDCPOS (Polygon):0x2791bca1f2de4661ed88a30c99a7a9449aa84174
USDT:0x91ff78ae858498e6f6e884f78b6e5be892c706af
DAI:0x795a8ec05f0c4f0eea7388378b1b890f851c5001
CELO:0x4764ea6d06ce4e503d0bb323913c1e96dcd1a943
CUSD:0x151517af77b06d9593f3ed41abecdd349316e006
CEUR:0x2f0173dfe97a7dc670d5a10b35c4263cfecfa853
WMATIC:0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270
+ + + + +### 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/tree/main/rust/config/production-community) + + + + https://github.com/celo-org/optics-monorepo/blob/main/rust/config/production-community/celo_contracts.json + + + https://github.com/celo-org/optics-monorepo/blob/main/rust/config/production-community/avalanche_contracts.json + + + https://github.com/celo-org/optics-monorepo/blob/main/rust/config/production-community/ethereum_contracts.json + + + https://github.com/celo-org/optics-monorepo/blob/main/rust/config/production-community/polygon_verification.json + + + + diff --git a/static/img/doc-images/migrating-optics-v2/verify-token-list.png b/static/img/doc-images/migrating-optics-v2/verify-token-list.png new file mode 100644 index 0000000000..41b0ce4f27 Binary files /dev/null and b/static/img/doc-images/migrating-optics-v2/verify-token-list.png differ diff --git a/static/img/doc-images/migrating-optics-v2/verify-token-wallet.png b/static/img/doc-images/migrating-optics-v2/verify-token-wallet.png new file mode 100644 index 0000000000..922ebebe62 Binary files /dev/null and b/static/img/doc-images/migrating-optics-v2/verify-token-wallet.png differ