> For the complete documentation index, see [llms.txt](https://hub.bsvblockchain.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hub.bsvblockchain.org/demos-and-onboardings/onboardings/onboarding-catalog/legacy-bridge.md).
# Legacy Bridge
**Status:** Production **Last Updated:** September 2025 **Contact/Support:** BSV Blockchain Association Community
***
## 1. What Is Legacy Bridge?
Legacy Bridge is a BSV blockchain tool that enables seamless fund transfers between traditional cryptocurrency exchanges and modern BRC-100 wallets, specifically designed to work with BSV Desktop wallets. The system acts as a conversion layer that bridges the compatibility gap between legacy address formats used by exchanges and modern BSV wallet standards.
**Key Features:**
* Legacy address-based BSV payments to and from BRC-100 wallets
* Exchange-to-wallet fund transfers without format conversion issues
* Core functionality including receiving funds, displaying addresses, sending transactions, and viewing transaction history
* Seamless integration with BSV Desktop wallets
***
## 2. Before You Begin
### 2.1. Prerequisites
**Essential Requirements:**
* **BSV Desktop** - Your BRC-100 compatible BSV wallet
* **Web browser** - Chrome, Firefox, Safari, or Edge
* **BSV funds on an exchange** - Funds in a traditional exchange like KuCoin, Kraken, or others
* **Internet connection** - Stable connection for blockchain transactions
### 2.2. Supported Platforms
* **Web-based** - Access through any modern web browser
* **Compatible with** - All operating systems (Windows, macOS, Linux)
* **Wallet Integration** - Works with BSV Desktop and other BRC-100 wallets
### 2.3. Exchange Compatibility
Legacy Bridge works with traditional exchanges that use legacy address formats, including:
* KuCoin
* Kraken
* Digifinex
* Orange
* Htx
* Any other major BSV-supporting exchanges
***
## 3. Getting Started: Step-by-Step
### Step 1: Set Up Your BSV Desktop
If you don't have a BSV Desktop wallet yet:
1. **Download BSV Desktop** from
2. **Install and configure** your wallet following the setup wizard
3. **Secure your recovery keys** in a safe place
4. **Note your wallet's receiving address** for later use
👉 **Detailed Guide:** [BSV Desktop Setup](/demos-and-onboardings/onboardings/onboarding-catalog/metanet-desktop-mainnet.md)
### Step 2: Access Legacy Bridge
1. **Visit the Legacy Bridge platform** at
2. **Connect your BSV Desktop wallet** when prompted
3. **Grant necessary permissions** for the application to interact with your wallet
### Step 3: Prepare Your Exchange Funds
**Before using Legacy Bridge, ensure you have:**
* BSV available in your exchange account
* Withdrawal permissions enabled on your exchange
* Sufficient funds to cover both the transfer amount and network fees
### Step 4: Generate Legacy Address
1. **In Legacy Bridge**, select "Generate Address"
2. **Generate a legacy-compatible address** that your exchange can recognize
3. **Copy the generated legacy address** carefully
4. **Verify the address format** matches what your exchange expects
### Step 5: Initiate Exchange Withdrawal
1. **Log into your exchange account**
2. **Navigate to BSV withdrawal section**
3. **Paste the legacy address** generated by Legacy Bridge
4. **Enter the amount** you want to transfer
5. **Confirm the withdrawal** following your exchange's security procedures
### Step 6: Monitor the Transfer
1. **Return to Legacy Bridge** to monitor the incoming transaction
2. **Check transaction status** in the application dashboard
3. **Wait for blockchain confirmations** (typically 6 confirmations for security)
4. **Click import to send funds to you metanet wallet**
5. **Verify funds arrival** in your connected BSV Desktop wallet
### Step 7: Send funds to a recipient wallet (Optional)
1. **Enter your adress in the Legacy Bridge**
2. **Enter the ammount to send** within your funds
3. **Send the funds to the wallet**
***
## 4. Advanced Features
### 4.1. Transaction History
* **View all transfers** made through Legacy Bridge
* **Export transaction records** for accounting purposes
* **Track confirmations** and transaction status in real-time
### 4.2. Multiple Exchange Support
* **Use different legacy addresses** for different exchanges
* **Manage multiple incoming transfers** simultaneously
* **Switch between mainnet and testnet** for testing purposes
### 4.3. BRC-100 Integration
Legacy Bridge leverages the **BRC-100 standard** features:
* **Payment Internalization with BRC-29** for standardized payment handling
* **BKDS Integration** for secure key derivation
* **SPV Verification** using BRC-67 for transaction validation
***
## 5. Security & Best Practices
### 5.1. Address Verification
* **Always double-check** the legacy address before withdrawing from exchanges
* **Use small test amounts** first to verify the process works correctly
* **Never share your private keys** or Privileged Identity Key
### 5.2. Transaction Safety
* **Verify network fees** before initiating transfers
* **Wait for full confirmations** before considering transactions complete
* **Keep records** of all transaction IDs for reference
### 5.3. Wallet Security
* **Keep BSV Desktop updated** to the latest version
* **Secure your recovery keys** offline in multiple safe locations
* **Use strong authentication** methods when available
***
## 6. Troubleshooting & FAQs
### 6.1. Common Issues
| Problem | Cause | Solution |
| ------------------------ | ---------------------------- | ------------------------------------ |
| Exchange rejects address | Legacy format not recognized | Regenerate address in Legacy Bridge |
| Funds not appearing | Insufficient confirmations | Wait for 6+ blockchain confirmations |
| Wallet connection fails | Browser compatibility | Try different browser or refresh |
| High fees | Network congestion | Wait for lower network traffic |
### 6.2. Support Channels
* **BSV Blockchain Association Community**
* **Legacy Bridge Documentation**
* **BSV Desktop Support**
* **Exchange Customer Support** (for withdrawal issues)
***
## 7. Learn More / Next Steps
### 7.1. Enhanced BSV Experience
Now that you can transfer funds from exchanges to your modern BSV wallet:
* **Explore Metanet Apps** at
* **Make peer-to-peer payments** using connected applications
* **Store and manage** your BSV securely in BSV Desktop
### 7.2. Additional Resources
* **Business Guide:** Understanding BSV blockchain for business applications
* **Technical Guide:** Deep dive into BRC-100 standards and implementation
* **Community Resources:** Join BSV blockchain developer and user communities
### 7.3. Recommended Workflow
**Complete BSV Onboarding Stack:**
1. **Legacy Bridge** → Transfer funds from exchanges
2. **BSV Desktop** → Secure wallet management
3. **PeerPay** → Send and receive payments
4. **Metanet Apps** → Explore blockchain applications
***
**Quick Links:** [BSV Desktop Guide](/demos-and-onboardings/onboardings/onboarding-catalog/metanet-desktop-mainnet.md) | [Get BSV Guide](/demos-and-onboardings/onboardings/onboarding-catalog/get-bsv.md) | [Pay & Get Paid Guide](/demos-and-onboardings/onboardings/onboarding-catalog/pay-and-paid.md) | [Home](/demos-and-onboardings/onboardings/onboardings.md)
***
*Legacy Bridge makes it easy to transition from traditional cryptocurrency exchanges to modern BSV blockchain applications. Start your journey today and unlock the full potential of BSV blockchain technology.*
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://hub.bsvblockchain.org/demos-and-onboardings/onboardings/onboarding-catalog/legacy-bridge.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.