GITBOOK-25: updating Bridging section

Author: eric-stacks

docs/learn/.gitbook/assets/bridging-cover.jpg

@@ -1,5 +1,4 @@
 ---
-description: 'Stacks: The leading Bitcoin L2.'
 layout:
   width: default
   title:

docs/learn/.gitbook/assets/usdcx-bridge-app.png

@@ -69,7 +69,6 @@
     * [Contracts](bridging/usdcx/contracts/README.md)
       * [usdcx-v1](bridging/usdcx/contracts/usdcx-v1.md)
       * [usdcx-token](bridging/usdcx/contracts/usdcx-token.md)
-    * [Bridge App](bridging/usdcx/bridge-app/README.md)
+    * [USDCx Bridge App](bridging/usdcx/bridge-app/README.md)
       * [Migrating aeUSDC](bridging/usdcx/bridge-app/migrating-aeusdc.md)
-    * [Security](bridging/usdcx/security.md)
     * [FAQ](bridging/usdcx/faq.md)

docs/learn/README.md

@@ -1,7 +1,13 @@
 ---
 description: Exploring the plethora of ways to bridge assets to and from Stacks
-hidden: true
 ---
 
 # Bridging
 
+<div data-with-frame="true"><figure><img src="../.gitbook/assets/bridging-cover.jpg" alt=""><figcaption><p>source: <a href="https://www.hiro.so/blog/understanding-blockchain-bridges-a-key-to-interoperability-in-web3">Hiro Blog</a></p></figcaption></figure></div>
+
+A blockchain bridge is a protocol or mechanism that serves as a connection between different blockchains, allowing for the transfer of tokens and data between them. Bridges enable the seamless transfer of data and assets between disparate blockchain networks. They break down the silos of individual blockchains and unlock the full potential of a permissionless, borderless Web3.
+
+#### Explore the different bridges available with Stacks
+
+<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4>USDCx</h4></td><td>Learn how USDC can flow to and from the bitcoin layer 2.</td><td><a href="usdcx/">usdcx</a></td></tr></tbody></table>

docs/learn/SUMMARY.md

@@ -1,20 +1,32 @@
+---
+description: >-
+  USDCx is a 1:1 USDC-backed stablecoin issued through Circle xReserve and
+  native to Stacks.
+---
+
 # USDCx
 
-<figure><img src="../../.gitbook/assets/stacks-circle.png" alt=""><figcaption></figcaption></figure>
+<div data-with-frame="true"><figure><img src="../../.gitbook/assets/stacks-circle.png" alt=""><figcaption></figcaption></figure></div>
+
+{% hint style="info" %}
+Developer support for integrating USDCx bridging into applications will be available via Circle’s Bridge Kit SDK in Q1 2026.
+{% endhint %}
 
 Stacks now has a fully USDC-backed stablecoin that plugs directly into Circle’s multichain ecosystem and brings stable, interoperable dollar liquidity to Bitcoin’s leading Layer 2.
 
 ### What is USDCx?
 
-USDCx is a 1:1 USDC-backed stablecoin issued through Circle xReserve and native to Stacks. xReserve provides cryptographic attestations for deposits and minting, while Circle Gateway and CCTP handle cross-chain movement. The result is USDC on Stacks without third-party bridges, wrapped assets, or fragmented liquidity.
+USDCx is a 1:1 USDC-backed stablecoin issued through Circle xReserve and native to Stacks. It will exist as a SIP-010 token on Stacks.&#x20;
+
+Circle's xReserve provides cryptographic attestations for deposits and minting, while Circle Gateway and CCTP handle cross-chain movement. The result is USDC on Stacks without third-party bridges, wrapped assets, or fragmented liquidity.
 
 {% hint style="info" %}
 For more info on xReserve, check out the dedicated Circle docs [here](https://developers.circle.com/xreserve).
 {% endhint %}
 
 ### Discover more of USDCx
 
-<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Operations</td><td><a href="operations.md">operations.md</a></td></tr><tr><td>Contracts</td><td><a href="contracts/">contracts</a></td></tr><tr><td>Bridge App</td><td><a href="bridge-app/">bridge-app</a></td></tr><tr><td>Security</td><td><a href="security.md">security.md</a></td></tr><tr><td>FAQ</td><td><a href="faq.md">faq.md</a></td></tr></tbody></table>
+<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4>Operations</h4></td><td><a href="operations.md">operations.md</a></td></tr><tr><td><h4>Contracts</h4></td><td><a href="contracts/">contracts</a></td></tr><tr><td><h4>Bridge App</h4></td><td><a href="bridge-app/">bridge-app</a></td></tr><tr><td><h4>Security</h4></td><td><a href="/broken/pages/lpi1fDfEzVNhJIl6VUWP">Broken link</a></td></tr><tr><td><h4>FAQ</h4></td><td><a href="faq.md">faq.md</a></td></tr></tbody></table>
 
 ***
 

docs/learn/bridging/README.md

@@ -1,4 +1,11 @@
-# Bridge App
+# USDCx Bridge App
 
-<div data-with-frame="true"><figure><img src="../../../.gitbook/assets/usdcx-bridge.png" alt=""><figcaption></figcaption></figure></div>
+<div data-with-frame="true"><figure><img src="../../../.gitbook/assets/usdcx-bridge-app.png" alt=""><figcaption><p><a href="http://bridge.stacks.com">http://bridge.stacks.com</a></p></figcaption></figure></div>
 
+The USDCx Bridge app is maintained by Stacks Labs and is powered by Circle xReserve.
+
+Acquire USDCx through the [official bridge app](http://bridge.stacks.com) or migrate your aeUSDC into USDCx to take advantage of better liquidity and improved trust assumptions.&#x20;
+
+At launch, the USDCx bridge on Stacks supports transfers between Ethereum and Stacks. The first aeUSDC–USDCx liquidity pool will be available on Bitflow in early January.
+
+Support for additional Circle / CCTP-compatible networks is on the roadmap and will roll out in Q1 2026, enabling broader interoperability across Circle’s multichain USDC ecosystem.

docs/learn/bridging/usdcx/README.md

@@ -6,12 +6,59 @@ description: Migrate your aeUSDC tokens to USDCx.
 
 ### What is aeUSDC?
 
-aeUSDC on Stacks is a bridged form of USDC managed by Allbridge. Allbridge is a platform dedicated to building bridges between different blockchain networks, fostering seamless communication and interoperability. Their expertise lies in connecting various ecosystems, with a particular emphasis on non-EVM chains like Stacks. 
+aeUSDC on Stacks is a bridged form of USDC managed by Allbridge. Now that USDCx is live on Stacks, aeUSDC holders should upgrade to USDCx for better liquidity, better UX and improved trust assumptions.
 
-Over the years, the UX for aeUSDC has not been as seamless as expected for Stacks users. Complex swap movements and higher requirements for trust has been a challenge.
+aeUSDC was first released in 2023. It will be gradually depreciated in favor of USDCx.
 
-### Why should you migrate your aeUSDC tokens to USDCx?
+{% hint style="warning" %}
+Minting aeUSDC is disabled. Users will not be able to mint new aeUSDC. Only transfers from Stacks to Ethereum enabled.
+{% endhint %}
+
+### Why should you migrate your aeUSDC to USDCx?
 
 * **Better liquidity** → USDCx gives you deeper liquidity and smoother swaps, powered by a more connected market.
 * **Better UX** → Enjoy a cleaner, faster experience with tools and apps built for real usability, not workarounds.
 * **Trust & reputation via attestations** → Onchain attestations backed by trusted issuers, Circle, strengthen transparency, credibility, and confidence.
+
+***
+
+### How to migrate aeUSDC to USDCx
+
+There are two primary ways to migrate aeUSDC tokens to USDCx. We’ll explain both of them here. 
+
+<details>
+
+<summary>Swap via Bitflow's Conversion Pool</summary>
+
+{% hint style="warning" %}
+Please note, the first aeUSDC:USDCx pool will be available in early January via Bitflow. This pool is not yet live.
+{% endhint %}
+
+aeUSDC holders can use the aeUSDC/USDC pool on Bitflow. This is the fastest and cheapest way to migrate to USDCx.
+
+* Navigate to Swaps in the [Bitflow app](https://app.bitflow.finance/trade).&#x20;
+* Connect your wallet.
+* Select aeUSDC as the “From” token.
+* Set the amount you want to migrate. You may decide to migrate your full aeUSDC balance at once, or test a small amount first before migrating the full balance.&#x20;
+* Select USDCx as the “To” token.
+* Click “Swap” button to initiate the swap. You’ll need to sign the transaction requests from your wallet in order to complete the transaction.
+
+</details>
+
+<details>
+
+<summary><strong>Bridge via Allbridge Classic</strong></summary>
+
+Users can bridge aeUSDC back to Ethereum and then bridge back to mint USDCx on Stacks.
+
+* Navigate to the [Allbridge](https://app.allbridge.io/bridge?from=STX\&to=ETH\&asset=aeUSDC) app.
+* Choose “Stacks” in the dropdown menu in the “From” field
+* Choose “Ethereum” in the dropdown menu in the “To” field
+* Choose “aeUSDC” as the asset.
+* Connect your wallet.
+* Set the amount you want to migrate. You may decide to migrate your full aeUSDC balance at once, or test a small amount first before migrating the full balance.&#x20;
+* Note that it may take 60 minutes (six confirmation blocks) to complete the transaction.
+* Once you have migrated aeUSDC back to USDC on Ethereum, you can use the USDCx Stacks bridge to deposit USDC on Stacks. http://bridge.stacks.co/
+
+</details>
+

docs/learn/bridging/usdcx/bridge-app/README.md

@@ -4,10 +4,10 @@ The USDCx smart contract is deployed on Stacks. It's role mirrors native USDC be
 
 Below are the integral contracts that make up the USDCx architecture.
 
-### Ethereum
+### Stacks
 
-<table><thead><tr><th width="103.1875">Network</th><th>USDC token contract</th><th>xReserve contract</th></tr></thead><tbody><tr><td>Mainnet</td><td><a href="https://etherscan.io/token/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48">0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48</a></td><td><a href="https://etherscan.io/address/0x8888888199b2Df864bf678259607d6D5EBb4e3Ce">0x8888888199b2Df864bf678259607d6D5EBb4e3Ce</a></td></tr><tr><td>Testnet</td><td><a href="https://sepolia.etherscan.io/token/0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238">0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238</a></td><td><a href="https://sepolia.etherscan.io/address/0x008888878f94C0d87defdf0B07f46B93C1934442">0x008888878f94C0d87defdf0B07f46B93C1934442</a></td></tr></tbody></table>
+<table><thead><tr><th width="125.3046875">Network</th><th>USDCx token contract</th><th>USDC xReserve protocol (entrypoint)</th></tr></thead><tbody><tr><td>Mainnet</td><td><a href="https://explorer.hiro.so/txid/0x07ea0a8d7262acd0cb094006969527351883281e08ebb6535843c5dbbde31ce9?chain=mainnet">SP120SBRBQJ00MCWS7TM5R8WJNTTKD5K0HFRC2CNE.usdcx</a></td><td><a href="https://explorer.hiro.so/txid/0xb5f29114ecdbaf199887433cdd4ca46d177d60875141e1dfb67304b53bf2df11?chain=mainnet">SP120SBRBQJ00MCWS7TM5R8WJNTTKD5K0HFRC2CNE.usdcx-v1</a></td></tr><tr><td>Testnet</td><td><a href="https://explorer.hiro.so/txid/ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM.usdcx?chain=testnet">ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM.usdcx</a></td><td><a href="https://explorer.hiro.so/txid/ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM.usdcx-v1?chain=testnet">ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM.usdcx-v1</a></td></tr></tbody></table>
 
-### Stacks
+### Ethereum
 
-<table><thead><tr><th width="125.3046875">Network</th><th>USDCx token contract</th><th>USDC xReserve protocol</th></tr></thead><tbody><tr><td>Mainnet</td><td></td><td></td></tr><tr><td>Testnet</td><td><a href="https://explorer.hiro.so/txid/ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM.usdcx?chain=testnet">ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM.usdcx</a></td><td><a href="https://explorer.hiro.so/txid/ST3FBR2AGK5H9QBDH3EEN6DF8EK8JY7RX8NQXMNRQ.usdcx-test-v3?chain=testnet&#x26;tab=overview">ST3FBR2AGK5H9QBDH3EEN6DF8EK8JY7RX8NQXMNRQ.usdcx-test-v3</a></td></tr><tr><td></td><td></td><td></td></tr></tbody></table>
+<table><thead><tr><th width="103.1875">Network</th><th>USDC token contract</th><th>xReserve contract</th></tr></thead><tbody><tr><td>Mainnet</td><td><a href="https://etherscan.io/token/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48">0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48</a></td><td><a href="https://etherscan.io/address/0x8888888199b2Df864bf678259607d6D5EBb4e3Ce">0x8888888199b2Df864bf678259607d6D5EBb4e3Ce</a></td></tr><tr><td>Testnet</td><td><a href="https://sepolia.etherscan.io/token/0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238">0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238</a></td><td><a href="https://sepolia.etherscan.io/address/0x008888878f94C0d87defdf0B07f46B93C1934442">0x008888878f94C0d87defdf0B07f46B93C1934442</a></td></tr></tbody></table>

docs/learn/bridging/usdcx/bridge-app/migrating-aeusdc.md

@@ -1,6 +1,6 @@
 # usdcx-token
 
-{% code title="usdcx-token.clar" lineNumbers="true" expandable="true" %}
+{% code title=".usdcx" lineNumbers="true" expandable="true" %}
 ```clarity
 ;; USDCx token
 ;;
@@ -14,7 +14,7 @@
 ;; - `pause`: Allowed to pause and unpause the protocol
 ;;
 
-(impl-trait 'ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM.sip-010-trait-ft-standard.sip-010-trait)
+(impl-trait 'SP3FBR2AGK5H9QBDH3EEN6DF8EK8JY7RX8QJ5SVTE.sip-010-trait-ft-standard.sip-010-trait)
 
 ;; `tx-sender` or `contract-caller` tried to move a token it does not own.
 (define-constant ERR_NOT_OWNER (err u4))
@@ -313,7 +313,7 @@
 ```
 {% endcode %}
 
-## **USDCx Contract Summary**
+## **USDCx-Token Contract Summary**
 
 This contract implements **USDCx**, a SIP-010 fungible token on Stacks with a **role-based access control system** and **pause functionality** for protocol safety. It exposes the standard SIP-010 interface for transfers, supply queries, and metadata, while providing protocol-only functions for minting, burning, governance updates, and pausing.