🚀 CrossChain Connect

Universal Multi-Blockchain Connection Protocol & Web3 Wallet Support

📚 Documentation

Complete documentation is available in the docs/ folder:

Core Guides

📊 Blockchains Supported

🔗 7 Blockchains, 23 Networks

Supported Networks:

• 🌐 Ethereum - Ethereum, BSC, Polygon, Arbitrum, Optimism, Ducros (6 chains)
• ₿ Bitcoin - Mainnet, Testnet, Signet, Regtest (4 networks)
• 🔐 Monero - Mainnet, Stagenet, Testnet (3 networks)
• ⚡ Solana - Mainnet, Devnet (2 networks)
• 💎 Cardano - Mainnet, Testnet (2 networks)
• ⓞ Polkadot - Mainnet, Westend (2 networks)
• ⚛️ Cosmos - Hub, Testnet (2 networks)

🏆 Features at a Glance

🏗️ Architecture

src/
├── chains/
│   ├── evm/              (Ethereum, BSC, Polygon, Arbitrum, Optimism, Ducros)
│   ├── btc/              (Bitcoin Mainnet, Testnet, Signet, Regtest)
│   ├── xmr/              (Monero Mainnet, Stagenet, Testnet)
│   ├── solana/           (Solana Mainnet, Devnet)
│   ├── cardano/          (Cardano Mainnet, Testnet)
│   ├── polkadot/         (Polkadot Mainnet, Westend)
│   └── cosmos/           (Cosmos Hub, Testnet)
├── evm_advanced/         (Transactions, Gas, Batch, Tokens, Contracts)
├── security/
│   ├── crypto/           (SHA256, HMAC, Keccak256)
│   ├── qrcode/           (QR code generation)
│   ├── session/          (Session management)
│   └── message/          (Message signing)
├── protocol/             (Connection & transaction protocols)
├── error.rs              (Error types)
└── lib.rs                (Main library)

tests/
├── bitcoin_tests.rs      (7 tests)
├── evm_tests.rs          (8 tests)
├── monero_tests.rs       (8 tests)
├── solana_tests.rs       (tests)
├── cardano_tests.rs      (tests)
├── crypto_tests.rs       (tests)
├── qrcode_tests.rs       (tests)
└── session_tests.rs      (tests)

docs/
├── GETTING_STARTED.md
├── EVM_ADVANCED.md
├── BLOCKCHAIN_SUPPORT.md
├── API_REFERENCE.md
└── EXAMPLES.md

🚀 Quick Start

1️⃣ Installation

Add to your Cargo.toml:

[dependencies]
crosschain-connect = "0.1.0"

2️⃣ Basic Usage

use crosschain_connect::chains::*;

#[tokio::main]
async fn main() -> Result {
    // Ethereum
    let ethereum = Ethereum::new()?;
    let balance = ethereum.get_balance("0x...").await?;
    println!("Balance: {}", balance);
    
    // Bitcoin
    assert!(BitcoinMainnet::validate_address("bc1..."));
    
    // Monero
    assert!(MoneroMainnet::validate_address("4..."));
    
    Ok(())
}

3️⃣ Run Tests

cargo test
# ✅ 100+ tests pass
# ✅ 0 errors
# ✅ 0 warnings

💡 Examples

Validate Addresses

use crosschain_connect::chains::*;

fn validate_addresses() -> Result {
    // Ethereum
    assert!(Ethereum::new()?.validate_address("0x742d35Cc6634C0532925a3b844Bc9e7595f42553"));
    
    // Bitcoin
    assert!(BitcoinMainnet::validate_address("bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4"));
    
    // Monero
    assert!(MoneroMainnet::validate_address(
        "4AbEH7bHZ9gFP53aMHbkHucJpV5c5cNyQXye47stDs6GozTvHaGaLTCjwjqzx19HiqaSvmc5S1KfqCfP7jqvNQ85Gk7QG4bEh"
    ));
    
    Ok(())
}

Get EVM Balance

use crosschain_connect::chains::evm::*;

#[tokio::main]
async fn get_balances() -> Result {
    let address = "0x742d35Cc6634C0532925a3b844Bc9e7595f42553";
    
    let eth = Ethereum::new()?;
    let bsc = BSC::new()?;
    let polygon = Polygon::new()?;
    
    println!("ETH: {}", eth.get_balance(address).await?);
    println!("BSC: {}", bsc.get_balance(address).await?);
    println!("Polygon: {}", polygon.get_balance(address).await?);
    
    Ok(())
}

Estimate Gas & Transfer Token

use crosschain_connect::evm_advanced::*;

#[tokio::main]
async fn transfer() -> Result {
    let rpc = "https://rpc.aquioi.com";
    
    // Estimate gas
    let gas = GasEstimator::estimate_gas(rpc, "0xfrom", "0xto", None).await?;
    println!("Estimated gas: {}", gas);
    
    // Transfer token
    let tx = TokenTransfer::transfer_token(
        rpc,
        "0xtoken",
        "0xto",
        "1000000000000000000"  // 1 token (18 decimals)
    ).await?;
    println!("TX: {}", tx);
    
    Ok(())
}

🤝 Contributing

Contributions are welcome!

📄 License

MIT License - See LICENSE for details.

⭐ If You Find This Useful

Please consider giving this project a star! It helps others discover the library.