search
WebsiteBlogJoin The Community

Deposit Guide

This guide covers the complete process for depositing 10 BTC to Citrea using Clementine CLI. The deposit process involves creating a wallet, generating a deposit address, sending 10 BTC, and monitoring the bridging process.

View all deposit commands:

clementine-cli deposit --help
triangle-exclamation

Don't forget to specify the --network flag if you plan to use a different Bitcoin network other than mainnet. Mainnet is selected implicitly for every command. Network aliases are used interchangeably throughout the docs: bitcoin/mainnet, testnet4/testnet, signet/devnet, and regtest.

hashtag
Prerequisites

Before starting a deposit, ensure you have:

  • A Citrea address

  • A Clementine CLI wallet with deposit purpose ("dep" prefix address) which will be used as the recovery taproot address

  • Access to a Bitcoin wallet for sending 10 BTC to the deposit address

hashtag
Deposit Process Overview

The deposit process consists of several stages:

  1. Create a Wallet for Deposits - Create a recovery taproot address

  2. Start Deposit - Create a unique deposit address using your Citrea (EVM) address and recovery taproot address

  3. Send 10 BTC to the Deposit Address - Transfer 10 BTC to the deposit address and rest will be automatically handled by the Clementine, and you will receive your 10 cBTC on your Citrea address.

  4. Monitor Deposit Status - Track the bridging process

  5. Fund Recovery (If Needed) - Recover funds if bridging fails

circle-exclamation

The RECOVERY_TAPROOT_ADDRESS and the DEPOSIT_ADDRESS are different. The RECOVERY_TAPROOT_ADDRESS will belong to your Clementine CLI wallet to be able to sign the recovery transaction in case the deposit fails, whereas the DEPOSIT_ADDRESS is the address you send Bitcoin to in order to perform the deposit operation. Your RECOVERY_TAPROOT_ADDRESS is used alongside the N_of_N_ADDRESS when creating the DEPOSIT_ADDRESS to make sure if the deposit fails, you can recover your funds back to your DESTINATION_ADDRESS.

hashtag
Step 1: Create a Wallet for Deposits

Create a deposit-purpose wallet to get your recovery taproot address:

The dep-prefixed address output is your RECOVERY_TAPROOT_ADDRESS. See Wallet Operations for details.

hashtag
Step 2: Start Deposit (Generate Deposit Address)

hashtag
Start Deposit

Create a deposit address using your Citrea (EVM) address and recovery taproot address:

Example:

circle-exclamation

About the "dep" prefix: The recovery taproot address should belong to Clementine wallet with deposit purpose and should be prefixed with "dep" to indicate it's being used for deposit operations. This prefix helps distinguish deposit-specific addresses from regular wallet addresses and ensures proper address derivation in the Clementine bridge system.

hashtag
Step 3: Send 10 BTC to the Deposit Address

Send your Bitcoin to the generated deposit address. You can use any Bitcoin wallet or client. The deposit amount is fixed to 10 BTC. After sending the funds, rest will be automatically handled by the Clementine, and you will receive your 10 cBTC on your Citrea address.

triangle-exclamation

Save your deposit transaction ID immediately. This is required for recovery if the Move to Vault transaction fails after 200 blocks.

hashtag
Step 4: Monitor Deposit Status

Track the progress of your deposit throughout the bridging process:

Example:

hashtag
Step 5: Fund Recovery (If Needed)

If 200 blocks have passed and the deposit status shows the Move to Vault transaction has not been broadcasted, you can recover your funds using the recovery mechanism. Recovery is done by signing a recovery transaction with your Clementine CLI wallet and broadcasting it to the Bitcoin network.

hashtag
Prepare Recovery Data

Gather all necessary information:

  • RECOVERY_TAPROOT_ADDRESS: Your wallet's recovery address (depbc1p...)

  • CITREA_ADDRESS: Your Citrea address used for the deposit (0x...)

  • DEPOSIT_UTXO_OUTPOINT: Your deposit Outpoint (txid:vout)

  • DESTINATION_ADDRESS: Bitcoin address where recovered funds will be sent

  • CLEMENTINE_AGGREGATED_KEY: MuSig2 aggregated x-only public key for the bridge signers

You can check CLEMENTINE_AGGREGATED_KEY with: clementine-cli show-config --network <BITCOIN_NETWORK> or clementine-cli deposit get-deposit-address-details <DEPOSIT_ADDRESS>.

Use MuSig2 key aggregation if you need to compute CLEMENTINE_AGGREGATED_KEY from signer pubkeys. Signer pubkeys are listed in Clementine signers. Check the aggregated key with the command below:

PUBKEYS is a comma-separated list of hex-encoded public keys.

Example:

hashtag
Create Recovery Transaction

Generate signed recovery transaction:

Example:

circle-exclamation

Please make sure that AMOUNT you enter is the exact amount of BTC you sent to the deposit address. This is necessary to recover your funds if you accidentally send any amount other than 10 BTC.

hashtag
Verify Recovery Transaction (Optional)

Verify the recovery transaction details before broadcasting:

hashtag
Broadcast Recovery Transaction

Send the recovery transaction to the Bitcoin network:

hashtag
Troubleshooting

hashtag
Common Issues

Deposit address generation fails:

  • Verify Citrea (EVM) address format (0x...)

  • Check recovery taproot address format (depbc1p...)

  • Ensure network parameter matches your Bitcoin network

Status check returns no results:

  • Confirm deposit address is correct

  • Wait for Bitcoin network confirmation (usually 1-6 blocks)

  • Check if deposit transaction was actually broadcasted

Recovery transaction creation fails:

  • Verify all parameters match original deposit exactly

  • Check that 200 blocks have actually passed

  • Ensure recovery taproot address is from the correct wallet

PreviousWallet OperationsNextWithdrawal Guide

Last updated

Was this helpful?