Xverse Transaction Confirmation Breakdown
| ❌ |
-| Bitget | ❌ | ✅ | ❌ | | ✅ |
-| BTC Connect | ❌ | ❌ | ✅ | ¹ | ✅¹ |
-| Leather | ✅ | ✅ | ❌ | 
| ❌ |
-| MetaMask | ❌ | ❌ | ✅ | 
| ✅ |
-| OKX | ✅ | ✅ | ❌ | | ✅ |
-| Phantom | ❌ | ❌ | ✅ | | ✅ |
-| UniSat | ❌ | ✅ | ❌ | | ✅ |
-| Xverse | ✅ | ✅ | ❌ | | ✅ |
-
-¹ BTC Connect enables connection through Bitget, OKX, UniSat, and Xverse wallets.
-
-## Wallet Setup
-
-For more information on how to set up each wallet, refer to each wallet's documentation and download links below.
-
-{% tabs %}
-{% tab title="Asigna" %}
-
-
-Asigna is a multisig wallet designed for Bitcoin and Stacks, supporting Ordinals, BRC-20 tokens, and batch transactions.
-
-**Supported Browser Extensions:** Chrome
-**Supported Mobile Apps:** None
-**Supported Blockchains on XLink:** Stacks
-
-[**Visit Site**](https://www.asigna.io)
-[**Download Asigna**](https://asigna.gitbook.io/asigna/stacks-multisig/quickstart/connecting-to-asigna)
-{% endtab %}
-
-{% tab title="Bitget" %}
-
-
-Bitget Wallet offers a multi-chain experience with support for Bitcoin and other blockchains, accessible through both browser extensions and mobile apps.
-
-**Supported Browser Extensions:** Chrome
-**Supported Mobile Apps:** Android and iOS
-**Supported Blockchains on XLink:** Bitcoin
-
-[**Visit Site**](https://web3.bitget.com)
-[**Download Bitget**](https://web3.bitget.com/en/wallet-download)
-{% endtab %}
-
-{% tab title="BTC Connect" %}
-
-
-BTC Connect is a wallet that integrates Bitcoin with Ethereum ecosystems, enabling secure multisig transactions and interaction with decentralized applications.
-
-**Supported Browser Extensions:** Chrome¹
-**Supported Mobile Apps:** Android and iOS¹
-**Supported Blockchains on XLink:** EVM
-
-[**Visit Site**](https://particle.network/btc-connect.html)
-[**Download BTC Connect**](https://particle.network/btc-connect.html)
-
-¹ BTC Connect enables connection through Bitget, OKX, UniSat, and Xverse wallets.
-{% endtab %}
-
-{% tab title="Leather" %}
-
-
-Leather is a non-custodial wallet for managing Bitcoin-backed assets on Stacks and other Bitcoin layers, supporting tokens and collectibles.
-
-**Supported Browser Extensions:** Chrome, Brave, Edge, and Opera
-**Supported Mobile Apps:** None
-**Supported Blockchains on XLink:** Stacks and Bitcoin
-
-[**Visit Site**](https://leather.io)
-[**Download Leather**](https://leather.io/install-extension)
-{% endtab %}
-
-{% tab title="MetaMask" %}
-
-
-MetaMask is one of the most popular Ethereum-based wallets, offering support for Ethereum and other EVM-compatible blockchains.
-
-**Supported Browser Extensions:** Chrome, Firefox, Brave, Edge, and Opera
-**Supported Mobile Apps:** Android and iOS
-**Supported Blockchains on XLink:** EVM
-
-[**Visit Site**](https://metamask.io)
-[**Download MetaMask**](https://metamask.io/download)
-{% endtab %}
-
-{% tab title="OKX" %}
-
-
-OKX Wallet offers multi-chain support across over 100 blockchains. It provides easy access to NFTs, DeFi, and trading tools.
-
-**Supported Browser Extensions:** Chrome
-**Supported Mobile Apps:** Android and iOS
-**Supported Blockchains on XLink:** Stacks and Bitcoin
-
-[**Visit Site**](https://www.okx.com/web3)
-[**Download OKX**](https://www.okx.com/web3)
-{% endtab %}
-
-{% tab title="Phantom" %}
-
-
-Phantom is a wallet that supports Solana and Ethereum-based blockchains, offering easy-to-use browser extensions and mobile apps.
-
-**Supported Browser Extensions:** Chrome, Firefox, Brave, and Edge
-**Supported Mobile Apps:** Android and iOS
-**Supported Blockchains on XLink:** EVM
-
-[**Visit Site**](https://phantom.app)
-[**Download Phantom**](https://phantom.app/download)
-{% endtab %}
-
-{% tab title="UniSat" %}
-
-
-UniSat is a wallet designed to manage Bitcoin Ordinals and interact with decentralized applications on the Bitcoin blockchain.
-
-**Supported Browser Extensions:** Chrome
-**Supported Mobile Apps:** Android and iOS
-**Supported Blockchains on XLink:** Bitcoin
-
-[**Visit Site**](https://unisat.io)
-[**Download UniSat**](https://unisat.io/download)
-{% endtab %}
-
-{% tab title="Xverse" %}
-
-
-Xverse is a multi-chain wallet designed for Bitcoin and Stacks, supporting Bitcoin Ordinals and BRC-20 tokens.
-
-**Supported Browser Extensions:** Chrome
-**Supported Mobile Apps:** Android and iOS
-**Supported Blockchains on XLink:** Stacks and Bitcoin
-
-[**Visit Site**](https://www.xverse.app)
-[**Download Xverse**](https://www.xverse.app/download)
-{% endtab %}
-{% endtabs %}
diff --git a/getting-started/the-bridge.md b/getting-started/the-bridge.md
deleted file mode 100644
index 39c30ad..0000000
--- a/getting-started/the-bridge.md
+++ /dev/null
@@ -1,92 +0,0 @@
-# Quickstart: Using the Bridge
-
-Follow these steps to bridge your assets between chains using XLink!
-
-{% hint style="info" %}
-**Important:** Users can only bridge tokens that represent the **same asset** across different blockchains. For example, BTC can be transferred to its equivalent, WBTC, when moving from Bitcoin to an EVM network, as both represent the same asset on different chains.
-{% endhint %}
-
-### Step 0: Connecting your Wallet
-
-Before using the bridge, you need to connect a wallet for the blockchain you are bridging from, as well as one for the blockchain you are bridging to (e.g., **Stacks Chain**, **Bitcoin Chain**, or **EVM Chain**).
-
-{% hint style="info" %}
-See the [Prerequisites](prerequisites.md) section for the list of **Supported Wallets** and their installation guides.
-{% endhint %}
-
-You can connect your wallet by clicking the **Wallet Manager** located in the top right corner of the XLink app. This is where you’ll manage all your wallet connections.
-
-
-
-In some cases, you can use the same wallet for both blockchains, but you still need to connect it separately for each blockchain in order to specify the source and destination accounts.
-
-{% hint style="info" %}
-For a detailed explanation on how to connect your wallet, check our guide: [**How to Connect your Wallet**](./guides/how-to-connect-your-wallet.md).
-{% endhint %}
-
-Once you have connected both wallets, you will see them active in the **Wallet Manager**.
-
-
-
-### Step 1: Select the Source Blockchain and Token
-
-To start, click on the << From Token Selector >>.
-
-
-
-Next, choose the **source blockchain** from which you want to bridge your assets (e.g., **Stacks Chain**). Then, select the **source token** you would like to bridge (e.g., **sUSDT**).
-
-
-
-{% hint style="info" %} Bridgable tokens for a specific blockchain are identified by the double arrow icon ⮂. You will only be able to select these tokens for bridging with the selected blockchain. {% endhint %}
-
-### Step 2: Select the Destination Blockchain and Token
-
-First, click on the << To Token Selector >>.
-
-
-
-Next, select the **destination blockchain** where you wish to send the assets (e.g., **BNB Chain**). Then, choose the corresponding **destination token** on this chain (e.g., **sUSDT ERC-20**).
-
-
-
-
-### Step 3: Input the Amount to Bridge
-
-Enter the amount of tokens you would like to bridge. You can also use the **Max** button to select your full balance.
-
-
-
-### Step 4: Initiate the Bridge
-
-After confirming the selected blockchains and token amounts, click the **Bridge** button to begin the process.
-
-
-
-### Step 5: Confirm the Transaction
-
-You will now be prompted to confirm the bridging transaction. Review the details and ensure everything is correct, then click **Confirm** to proceed.
-
-
-
-### Step 6: Complete Transfer (Unwrap)
-
-Once the bridge process begins, scroll down in the **Transfer-to-Unwrap** pop-up and confirm the additional unwrap transaction. This step is required for your tokens to be fully processed on the destination chain.
-
-
-
-
-
-### Step 7: Wait for Confirmation
-
-Finally, wait for the transaction to be confirmed on the blockchain. The confirmation time can take anywhere from 10 to 30 minutes, depending on network conditions. Once the transaction is broadcasted, you should see the bridged tokens deposited in your destination wallet.
-
-
-
-{% hint style="info" %}
-You can monitor your transaction in real-time by clicking the **View in explorer** link or turning on **Telegram notifications**.
-{% endhint %}
-
-## Support
-
-For assistance, please reach out to our Community Managers on [Discord](https://discord.com/invite/xlink).
\ No newline at end of file
diff --git a/integrations/non-bitcoin-chains.md b/integrations/non-bitcoin-chains.md
deleted file mode 100644
index 134fd02..0000000
--- a/integrations/non-bitcoin-chains.md
+++ /dev/null
@@ -1,9 +0,0 @@
-# Non-Bitcoin chains
-
-On L2s or non-Bitcoin chains, users interact with "Endpoints" on the source blockchain to lock assets to be bridged ("source asset"), and on the destination blockchain to receive the bridged asset ("destination asset").
-
-Endpoints are the smart contracts that handle the asset transfers. They are owned by multisig contracts (for example, [Gnosis Safe](https://safe.global/) on Ethereum and [Executor DAO](https://explorer.stacks.co/txid/0xf4bd95ea0486e6a50ae632c613f1d72b2a5bbbc4211b494cd0f1d3443658544d?chain=mainnet) on Stacks) operated by a decentralised network of validators and verifiers.
-
-Users use Endpoints to trigger transfer of source assets. The destination assets are then sent by a relayer by producing cryptographic proofs.
-
-That the assets are held by contracts owned by multisig contracts is important because this minimises the risk of a malicious actor stealing the private key and assets sent by users.
diff --git a/introduction/getting-started/README.md b/introduction/getting-started/README.md
new file mode 100644
index 0000000..e968805
--- /dev/null
+++ b/introduction/getting-started/README.md
@@ -0,0 +1,65 @@
+---
+description: Get started with asset transfers using the Brotocol cross-chain bridge!
+layout:
+ title:
+ visible: true
+ description:
+ visible: true
+ tableOfContents:
+ visible: true
+ outline:
+ visible: true
+ pagination:
+ visible: false
+---
+
+# Getting Started
+
+Brotocol enables seamless asset transfers across blockchains, keeping you in control of your tokens.
+
+Start using Brotocol by setting up your wallet and bridging assets across chains.
+
+[**🌁 Connect to Brotocol and Start Bridging Now!**](https://brotocol.xyz/bridge/cross-bridge)
+
+{% hint style="info" %}
+If you have not used the Bitcoin ecosystem before, we highly recommend starting your journey with the [Xverse](https://www.xverse.app/) Wallet due to its compatibility with our protocol.
+{% endhint %}
+
+## Explore the Brotocol Documentation
+
+Brotocol's functionality is detailed across various sections in our documentation. Here's an overview of the key files and structure:
+
+* **Introduction**
+ * [What is Brotocol](../../): Discover what Brotocol is and the type of bridge we use
+ * [Brotocol 101:](../readme/brotocol-101.md) A one-pager that covers Brotocol entirely including it's unique selling points.
+ * [**Getting Started**](./)**:** You are at this page currently!
+ * [Supported Wallets](prerequisites/): See which wallets are compatible with Brotocol across Bitcoin, Stacks, and EVM chains.
+ * [How to Connect your Wallet](prerequisites/how-to-connect-your-wallet.md): Step-by-step guide to securely connect your wallet and start using Brotocol.
+ * [**What is Bonbori**](../what-is-bonbori/)**:** Learn what Bonbori is and how it powers Brotocol’s cross-chain messaging and consensus.
+ * [Why Bonbori](../what-is-bonbori/why-bonbori.md): Understand why Bonbori is crucial for enabling secure and Bitcoin-aligned interoperability.
+ * [Bonbori Consensus Model](../what-is-bonbori/bonbori-consensus-model.md): Dive into Bonbori’s customizable m-of-n consensus and validator-verifier framework.
+* **Features**
+ * [BroSwap](../../features/broswap/): Swap assets across chains directly from your Bitcoin wallet using a unified interface.
+ * [DEX Aggregation](../../features/broswap/dex-aggregation.md): BroSwap sources the best rates by aggregating liquidity from top DEXs like Kyber, ALEX and more.
+ * [How to Swap Non-Bridgeable Tokens](../../features/broswap/how-to-swap-non-bridgeable-tokens.md): Use BroSwap’s routing to swap tokens that aren’t directly bridgeable via BroBridge.
+ * [BroBridge](../../developers/contracts/BridgeEndpoint.md): Brotocol’s core infrastructure for secure asset movement across Bitcoin, Stacks, and EVM chains.
+ * [How Brotocol Bridge Works](../../features/brobridge/how-xlink-works.md): Overview of how assets are locked, validated, and transferred using BroBridge endpoints.
+ * [Explorer](../../features/explorer/): Search all or your own transactions and statuses using Brotocol’s on-chain explorer.
+ * [Active Notification](../../features/explorer/active-notifications.md): On-page real-time alerts for transaction updates, confirmations, and status changes.
+ * [Reserves](../../reserves/): View Brotocol’s live proof-of-reserves across all bridged assets.
+ * [What is aBTC?](../../reserves/what-is-abtc.md): Read more about aBTC; 1:1 tokenized BTC on Stacks.
+ * [What is aUSD?](../../reserves/what-is-ausd.md): Read more about the wrapped version of USDT.
+* **Developers**
+ * [Smart Contracts](../../developers/contracts/): Explore Brotocol’s contracts for bridging, swaps, and how it works.
+ * [Add a New Chains](../../developers/add-a-new-chain.md): Learn how to propose and configure new chain integrations with Brotocol.
+ * [Supported Blockchains and Tokens](../../developers/supported-blockchains-and-tokens.md): A list of all currently supported L1s, L2s, and token types.
+ * [Security Audits](../../developers/security-audits.md): Browse detailed audit reports from across contracts and backend.
+ * [Integrations](../../developers/integrations/): Technical guide to integrating Brotocol endpoints and validators into new chains.
+ * [Bitcoin](../../developers/integrations/understanding-the-bitcoin-bridge.md): Read more on how Brotocol uses Bitcoin multisigs and OP\_RETURN to trigger secure cross-chain operations.
+ * [Bitcoin L2s or EVMs](../../developers/integrations/bitcoin-l2s.md): How users interact with smart contract endpoints for bridging and asset transfers.
+* **Media Kits**
+ * [Official Links](../../media-kits/official-links.md): To prevent going to the fake Brotocol page, you can double check the URLs here.
+
+## Support
+
+For help, join us on [Discord](https://discord.com/invite/xlink).
diff --git a/introduction/getting-started/prerequisites/README.md b/introduction/getting-started/prerequisites/README.md
new file mode 100644
index 0000000..447f8bd
--- /dev/null
+++ b/introduction/getting-started/prerequisites/README.md
@@ -0,0 +1,14 @@
+# Supported Wallets
+
+Before using Brotocol to bridge your assets across blockchains, you need to ensure that you have a compatible wallet set up and the necessary funds for transaction fees.
+
+## Supported Wallets
+
+Brotocol supports various wallets depending on the blockchain, browser, or device you are using.
+
+Below is a list of the available wallets for each supported chain, along with information on compatible browsers and mobile devices.
+
+| Wallet (Download URL) | Stacks | Bitcoin | EVM | Browser | Mobile |
|---|---|---|---|---|---|
| Asigna | ✅ | ❌ | ❌ |  | ❌ |
| Bitget Wallet | ❌ | ✅ | ❌ | | ✅ |
| BTC Connect | ❌ | ❌ | ✅ | ¹ | ✅¹ |
| Leather | ✅ | ✅ | ❌ |    | ❌ |
| MetaMask | ❌ | ❌ | ✅ |  | ✅ |
| OKX | ✅ | ✅ | ❌ | | ✅ |
| Phantom | ❌ | ❌ | ✅ | | ✅ |
| UniSat | ❌ | ✅ | ❌ | | ✅ |
| Xverse | ✅ | ✅ | ❌ | | ✅ |
| Orange | ✅ | ❌ | ❌ | | ✅ |
| Magic Eden | ❌ | ✅ | ✅ | | ✅ |
| Keplr | ❌ | ❌ | ✅ | | ✅ |
| Cosmostation | ❌ | ❌ | ✅ | | ✅ |
| SubWallet | ❌ | ❌ | ✅ | | ✅ |
| Rabby Wallet | ❌ | ❌ | ✅ | | ✅ |
| Brave Wallet | ❌ | ❌ | ✅ | | ✅ |
| Wallet Connect | ❌ | ❌ | ✅ | | ✅ |
- 
-
