> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oumla.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Supported Networks

> Explore the blockchain networks supported by Oumla

export const supportEmail = 'support@oumla.com';

At Oumla, we work with various blockchains and we're continuously adding support for more. Our platform is designed to provide seamless integration with multiple blockchain networks.

## Currently Supported Networks

<CardGroup cols={2}>
  <Card title="Bitcoin" icon="bitcoin">
    **tBTC** (testnet) - Available now\
    **BTC** (mainnet) - Requires activation
  </Card>

  <Card title="Ethereum" icon="ethereum">
    **tETH** (testnet - Sepolia) - Available now
    **ETH** (mainnet) - Requires activation
  </Card>
</CardGroup>

## Network Comparison

Understanding the differences between networks helps you choose the right one for your use case:

| Feature                      | Bitcoin (BTC/tBTC)                | Ethereum (ETH/tETH)         |
| ---------------------------- | --------------------------------- | --------------------------- |
| **Network Type**             | UTXO-based                        | Account-based               |
| **Address Format**           | Bech32 (bc1...)                   | Hex (0x...)                 |
| **Transaction Model**        | UTXO (Unspent Transaction Output) | Account balance             |
| **Multi-address Withdrawal** | ✅ Supported                       | ❌ Single address only       |
| **Gas/Fees**                 | Transaction-based fees            | Gas price × gas limit       |
| **Smart Contracts**          | ❌ Limited (Bitcoin Script)        | ✅ Full EVM support          |
| **Token Standards**          | ❌ Not supported                   | ✅ ERC-20, ERC-721, ERC-1155 |
| **Confirmation Time**        | \~10 minutes                      | \~15 seconds (varies)       |

## Bitcoin vs Ethereum: Key Differences

### Transaction Formats

**Bitcoin:**

* Uses UTXO model - transactions consume and create outputs
* Multiple inputs can be combined in one transaction
* Addresses are derived from public keys
* Supports multi-signature transactions natively

**Ethereum:**

* Uses account-based model - transactions modify account balances
* Each transaction has one sender account
* Addresses are derived from private keys
* Supports smart contracts and complex logic

### Address Generation

**Bitcoin Addresses:**

* Bech32 format: `bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh`
* Testnet format: `tb1q...`
* Generated from public key hash

**Ethereum Addresses:**

* Hex format: `0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb`
* 20-byte addresses (40 hex characters + 0x prefix)
* Generated from private key

### Withdrawal Differences

**Bitcoin Withdrawals:**

* Can withdraw from multiple addresses in one transaction
* More efficient for consolidating funds
* Returns withdrawal ID for tracking

**Ethereum Withdrawals:**

* Single address per withdrawal
* Returns transaction hash immediately
* Can check status via transaction receipt

<Info>
  See the [Withdrawal Workflow](/guides/workflows/withdrawal) guide for detailed examples of network-specific withdrawal behavior.
</Info>

## Network Selection Guidance

### Choose Bitcoin (BTC/tBTC) When:

* You need simple value transfers
* You want multi-address withdrawal support
* You're building payment applications
* You need maximum security and decentralization
* You're working with Bitcoin-native applications

### Choose Ethereum (ETH/tETH) When:

* You need smart contract functionality
* You're building DeFi applications
* You need tokenization (ERC-20, ERC-721, ERC-1155)
* You want faster transaction confirmations
* You're building dApps or complex blockchain logic

## Testnet vs Mainnet

### Testnets

**Purpose:**

* Development and testing
* No real value at risk
* Faster iteration and experimentation

**Available Testnets:**

* **tBTC**: Bitcoin testnet
* **tETH**: Ethereum Sepolia testnet

**When to Use:**

* During development
* Testing integrations
* Learning and experimentation
* Prototyping new features

### Mainnets

**Purpose:**

* Production applications
* Real value transactions
* Live user interactions

**Available Mainnets:**

* **BTC**: Bitcoin mainnet
* **ETH**: Ethereum mainnet

**When to Use:**

* Production deployments
* Real user transactions
* After thorough testing

<Warning>
  **Always test on testnet first!** Mainnet transactions involve real value and cannot be reversed. Test thoroughly on testnet before deploying to mainnet.
</Warning>

## Gas and Fee Handling

### Bitcoin Fees

* Fees are calculated based on transaction size
* Paid in BTC
* Deducted from transaction amount
* Can be estimated before sending

**Example:**

```javascript theme={null}
// Bitcoin withdrawal - fees deducted automatically
const withdrawal = await client.withdraw.createWithdraw({
  networkId: 'your-btc-network-id',
  from: ['address1', 'address2'],
  to: 'recipient',
  amount: '0.001', // Amount after fees
  clientShare: 'your-share'
});
```

### Ethereum Gas

* Gas price × gas limit = total fee
* Paid in ETH (or network native token)
* Gas prices fluctuate with network congestion
* Can be estimated before sending

**Example:**

```javascript theme={null}
// Ethereum withdrawal - gas deducted from balance
const withdrawal = await client.withdraw.createWithdraw({
  networkId: 'your-eth-network-id',
  from: ['0x...'],
  to: '0x...',
  amount: '0.1', // Amount before gas
  clientShare: 'your-share'
});
```

<Tip>
  Gas prices vary significantly. During high network congestion, consider waiting or using gas price estimation tools to optimize costs.
</Tip>

## Network-Specific Examples

### Bitcoin Address Generation

```javascript theme={null}
// Generate Bitcoin address
const address = await client.addresses.createAddressV2({
  reference: 'user-123',
  networkId: 'your-btc-network-id', // Get from getNetworks()
  clientShare: 'your-client-share'
});

console.log('Bitcoin Address:', address.data.data?.address);
// Output: bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
```

### Ethereum Address Generation

```javascript theme={null}
// Generate Ethereum address
const address = await client.addresses.createAddressV2({
  reference: 'user-123',
  networkId: 'your-eth-network-id', // Get from getNetworks()
  clientShare: 'your-client-share'
});

console.log('Ethereum Address:', address.data.data?.address);
// Output: 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb
```

## Mainnet Activation

<Warning>
  **Mainnet Activation Required**

  To activate mainnet access for Bitcoin (BTC) and Ethereum (ETH), you need to contact our support team and await approval. We will whitelist your account and require more information about your business.
</Warning>

<Card title="Request Mainnet Activation" href={`mailto:${supportEmail}?subject=Mainnet%20Activation%20Request&body=Hello%20Oumla%20Team,%0A%0AI%20would%20like%20to%20request%20mainnet%20activation%20for%20my%20account.%0A%0ACompany%20Details:%0A-%20Company%20Name:%20%0A-%20Website:%20%0A%0AMainnet%20Requirements:%0A-%20Networks%20Needed:%20(BTC%20/%20ETH%20/%20Both)%0A-%20Use%20Case:%20%0A-%20Expected%20Volume:%20%0A-%20Timeline:%20%0A%0APlease%20let%20me%20know%20what%20additional%20information%20you%20need.%0A%0AThank%20you!`}>
  Click to send a pre-filled email to our support team
</Card>

## Planned Networks

In the coming months, we plan to include support for:

<CardGroup cols={2}>
  <Card icon="link" horizontal>
    **Polygon** MATIC
  </Card>

  <Card icon="mountain" horizontal>
    **Avalanche** AVAX
  </Card>

  <Card icon="coins" horizontal>
    **Binance Chain** BNB
  </Card>

  <Card icon="cube" horizontal>
    **Cardano** ADA
  </Card>

  <Card icon="cloud" horizontal>
    **Internet Computer Protocol** ICP
  </Card>

  <Card icon="bolt" horizontal>
    **Solana** SOL
  </Card>

  <Card icon="plus" horizontal>
    Additional blockchains coming soon
  </Card>
</CardGroup>

## Request a Network

<Card title="Need a Specific Blockchain?" icon="envelope" href={`mailto:${supportEmail}?subject=Network%20Support%20Request&body=Hello%20Oumla%20Team,%0A%0AI%20would%20like%20to%20request%20support%20for%20a%20specific%20blockchain%20network.%0A%0ACompany%20Details:%0A-%20Company%20Name:%20%0A-%20Website:%20%0A%0ANetwork%20Details:%0A-%20Blockchain%20Name:%20%0A-%20Network%20Type:%20(Public%20/%20Private)%0A-%20Use%20Case:%20%0A-%20Expected%20Volume:%20%0A-%20Timeline:%20%0A%0APlease%20let%20me%20know%20if%20you%20need%20any%20additional%20information.%0A%0AThank%20you!`}>
  If you want us to support a specific blockchain, whether it's public or private, click to send a pre-filled email. We're here to assist you!
</Card>