> For the complete documentation index, see [llms.txt](https://zentrafinance.gitbook.io/zentra/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zentrafinance.gitbook.io/zentra/getting-started/wallet.md).

# Wallet

## Wallet Setup

To use Zentra Finance, you'll need a Web3 wallet configured for Citrea Mainnet and some cBTC for gas fees.

### Supported Wallets

| Wallet              | Type              | Recommended |
| ------------------- | ----------------- | ----------- |
| **MetaMask**        | Browser Extension | ✅ Yes       |
| **Rabby**           | Browser Extension | ✅ Yes       |
| **Trust Wallet**    | Mobile            | ✅ Yes       |
| **Coinbase Wallet** | Browser / Mobile  | ✅ Yes       |
| **WalletConnect**   | Multi-platform    | ✅ Yes       |

Any EVM-compatible wallet will work with Zentra.

### Quick Start

#### Step 1: Connect Your Wallet

1. Go to [zentra.finance](https://zentra.finance)
2. Click **Connect Wallet**
3. Select your wallet from the list
4. Approve the connection request

> 💡 When you connect, Zentra will automatically prompt you to add and switch to Citrea Mainnet.

#### Step 2: Add Citrea Network (Automatic)

When connecting for the first time, you'll see a prompt to add Citrea Mainnet. Simply click **Approve** to add the network automatically.

#### Step 3: Get Gas (cBTC)

All transactions on Citrea require cBTC for gas fees. You'll need to bridge BTC to Citrea.

### Citrea Network Details

If you prefer to add the network manually, use these settings:

#### Mainnet

| Parameter           | Value                                                              |
| ------------------- | ------------------------------------------------------------------ |
| **Network Name**    | Citrea Mainnet                                                     |
| **Chain ID**        | 4114                                                               |
| **RPC URL**         | [`https://rpc.mainnet.citrea.xyz`](https://rpc.mainnet.citrea.xyz) |
| **Currency Symbol** | cBTC                                                               |
| **Block Explorer**  | `https://explorer.citrea.xyz`                                      |

#### Adding Manually to MetaMask

1. Open MetaMask
2. Click the network dropdown (top left)
3. Click **Add Network**
4. Click **Add a network manually**
5. Enter the network details above
6. Click **Save**

### Getting cBTC for Gas

You need cBTC to pay for transaction fees on Citrea. Here's how to get it:

#### Option 1: Bridge from Bitcoin

1. Go to the official [Citrea Bridge](https://bridge.citrea.xyz)
2. Connect your Bitcoin wallet
3. Enter the amount of BTC to bridge
4. Complete the transaction
5. Wait for confirmation (\~10-30 minutes)

#### Option 2: Bridge from Other Chains

1. Use supported bridges like:
   * Citrea Official Bridge
   * Third-party bridges (check Citrea docs)
2. Bridge assets from Ethereum or other chains
3. Swap to cBTC if needed

#### Option 3: CEX Withdrawal (If Supported)

Some exchanges may support direct withdrawal to Citrea. Check your exchange for Citrea network support.

### Getting Assets to Supply

#### USDC

To get USDC on Citrea:

1. Bridge USDC from Ethereum via official bridge
2. Or swap other assets to USDC on [Satsuma DEX](https://satsuma.xyz)

#### wcBTC

wcBTC is wrapped cBTC. To get wcBTC:

1. Bridge BTC to Citrea (you receive cBTC)
2. Wrap cBTC to wcBTC through the Zentra interface or directly

### Wallet Security Tips

#### Do's ✅

| Practice                  | Why                             |
| ------------------------- | ------------------------------- |
| Use a hardware wallet     | Best security for large amounts |
| Verify URLs carefully     | Avoid phishing sites            |
| Bookmark official sites   | zentra.finance                  |
| Check transaction details | Before signing                  |
| Keep seed phrase offline  | Never store digitally           |

#### Don'ts ❌

| Practice                 | Risk                      |
| ------------------------ | ------------------------- |
| Share your seed phrase   | Total loss of funds       |
| Click unknown links      | Phishing attacks          |
| Approve unlimited tokens | Unnecessary exposure      |
| Use public WiFi          | Man-in-the-middle attacks |
| Ignore wallet warnings   | Missing security alerts   |

### Adding Zentra Tokens to Wallet

After interacting with Zentra, you may want to see your tokens in your wallet.

#### zUSDC (Interest-bearing USDC)

| Parameter    | Value                                        |
| ------------ | -------------------------------------------- |
| **Contract** | `0x01465912C8cEc266237050f429fE1b88dAa56C0A` |
| **Symbol**   | zUSDC                                        |
| **Decimals** | 6                                            |

#### zWcBTC (Interest-bearing wcBTC)

| Parameter    | Value                                        |
| ------------ | -------------------------------------------- |
| **Contract** | `0x21EdC56532b6E92E676aA260B2a1f968B20EB1F5` |
| **Symbol**   | zWcBTC                                       |
| **Decimals** | 18                                           |

#### How to Add Custom Token

1. Open your wallet
2. Click **Import Tokens** or **Add Token**
3. Enter the contract address
4. Symbol and decimals should auto-fill
5. Click **Add**

### Troubleshooting

#### "Wrong Network" Error

**Solution:** Switch to Citrea Mainnet

1. Click the network dropdown in your wallet
2. Select "Citrea Mainnet"
3. If not listed, add it manually (see above)

#### Transaction Stuck/Pending

**Solutions:**

1. Check if you have enough cBTC for gas
2. Try increasing gas price
3. Wait for network congestion to clear
4. Cancel and retry with higher gas

#### Wallet Won't Connect

**Solutions:**

1. Refresh the page
2. Clear browser cache
3. Disable conflicting browser extensions
4. Try a different browser
5. Update your wallet to latest version

#### "Insufficient Funds for Gas"

**Solution:** You need cBTC for gas fees

1. Bridge BTC to Citrea
2. Ensure you have at least 0.0001 cBTC for transactions

#### Token Not Showing in Wallet

**Solution:** Import the token manually

1. Copy the token contract address from Contract Addresses
2. Import as custom token in your wallet

### Mobile Wallet Setup

#### Using Trust Wallet

1. Download Trust Wallet from App Store / Play Store
2. Create or import wallet
3. Tap **Settings** → **Networks**
4. Add Citrea Mainnet with details above
5. Visit zentra.finance in the built-in browser

#### Using MetaMask Mobile

1. Download MetaMask from App Store / Play Store
2. Create or import wallet
3. Tap hamburger menu → **Settings** → **Networks** → **Add Network**
4. Enter Citrea Mainnet details
5. Use the built-in browser to access zentra.finance

### Hardware Wallet Support

Zentra supports hardware wallets through MetaMask and other compatible interfaces:

| Hardware Wallet | Connection Method |
| --------------- | ----------------- |
| **Ledger**      | MetaMask, Rabby   |
| **Trezor**      | MetaMask          |
| **GridPlus**    | MetaMask          |

#### Connecting Ledger

1. Connect Ledger to computer
2. Open Ethereum app on Ledger
3. In MetaMask, click account icon → **Connect Hardware Wallet**
4. Select Ledger and follow prompts
5. Proceed to use Zentra normally

### Need Help?

| Resource        | Link                     |
| --------------- | ------------------------ |
| **Discord**     | discord.gg/zentrafinance |
| **Citrea Docs** | docs.citrea.xyz          |
| **FAQ**         | FAQ & Troubleshoot       |