# 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: ```sh clementine-cli deposit --help ``` {% hint style="danger" %} 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`. {% endhint %} ## 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 ## Deposit Process Overview The deposit process consists of several stages: 1. [**Create a Wallet for Deposits**](#step-1-create-a-wallet-for-deposits) - Create a recovery taproot address 2. [**Start Deposit**](#step-2-start-deposit-generate-deposit-address) - Create a unique deposit address using your Citrea (EVM) address and recovery taproot address 3. [**Send 10 BTC to the Deposit Address**](#step-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**](#step-4-monitor-deposit-status) - Track the bridging process 5. [**Fund Recovery (If Needed)**](#step-5-fund-recovery-if-needed) - Recover funds if bridging fails {% hint style="warning" %} 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`. {% endhint %} ## Step 1: Create a Wallet for Deposits Create a deposit-purpose wallet to get your recovery taproot address: ```sh clementine-cli wallet create deposit ``` The `dep`-prefixed address output is your `RECOVERY_TAPROOT_ADDRESS`. See [Wallet Operations](/essentials/using-clementine/clementine-cli/wallet.md#create-wallet-for-deposits) for details. ## Step 2: Start Deposit (Generate Deposit Address) ### Start Deposit Create a deposit address using your Citrea (EVM) address and recovery taproot address: ```sh clementine-cli deposit start [--network ] ``` **Example:** ```sh clementine-cli deposit start depbc1p... 0x742d35...e4C837Be # For testnet4 clementine-cli deposit start --network testnet depbc1p... 0x742d35...e4C837Be ``` {% hint style="warning" %} **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. {% endhint %} ## 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. {% hint style="danger" %} Save your deposit transaction ID immediately. This is required for recovery if the Move to Vault transaction fails after 200 blocks. {% endhint %} ## Step 4: Monitor Deposit Status Track the progress of your deposit throughout the bridging process: ```sh clementine-cli deposit status [--network ] ``` **Example:** ```sh clementine-cli deposit status tb1pd... # For testnet4 clementine-cli deposit status --network testnet tb1pd... ``` ## 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. ### 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 ` or `clementine-cli deposit get-deposit-address-details `. Use MuSig2 key aggregation if you need to compute `CLEMENTINE_AGGREGATED_KEY` from signer pubkeys. Signer pubkeys are listed in [Clementine signers](/advanced/clementine-signers.md). Check the aggregated key with the command below: ```sh clementine-cli musig2-key-aggregation ``` `PUBKEYS` is a comma-separated list of hex-encoded public keys. Example: ```sh clementine-cli musig2-key-aggregation 02abc...123,03def...456 ``` ### Create Recovery Transaction Generate signed recovery transaction: ```sh clementine-cli deposit create-signed-recovery-tx [--network ] ``` **Example:** ```sh clementine-cli deposit create-signed-recovery-tx deptb1pd... 0x742d35... abc123def456...:0 tb1qe... 1 10 1e0f48f81dfa14...6bf7 # For testnet4 clementine-cli deposit create-signed-recovery-tx --network testnet deptb1pd... 0x742d35... abc123def456...:0 tb1qe... 1 10 1e0f48f81dfa14...6bf7 ``` {% hint style="warning" %} 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`. {% endhint %} ### Verify Recovery Transaction (Optional) Verify the recovery transaction details before broadcasting: ```sh clementine-cli deposit verify-recovery-tx [--network ] [AMOUNT] ``` ### Broadcast Recovery Transaction Send the recovery transaction to the Bitcoin network: ```sh clementine-cli deposit broadcast-recovery-tx ``` ## Troubleshooting ### 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 --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.citrea.xyz/essentials/using-clementine/clementine-cli/deposit.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.