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. Click Connect Wallet

  2. Select your wallet from the list

  3. 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

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 Bridgearrow-up-right

  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 DEXarrow-up-right

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 SettingsNetworks

  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 → SettingsNetworksAdd 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

Last updated