​
Generate a Deposit Address

To deposit Bitcoin into your Spark wallet from L1, you’ll first need to generate a deposit address. Once you have a deposit address, you can send Bitcoin to it. As deposited funds are mapped to the Spark statechain, Spark deposit address can only be used a single time.

Once the transaction is confirmed, you can claim the deposit by calling claimDeposit(txId). Once claimed you can call getBalance() to view the updated balance. For Layer 1 Bitcoin deposits, Spark generates Pay to Taproot (P2TR) addresses. These addresses start with “bc1p” for mainnet and can be used to receive Bitcoin from any wallet.

Mainnet Address Example: bc1p5d7rjq7g6rdk2yhzks9smtbqtedr4dekq08ge8ztwac72sfr9rusxg3297

Code Sample:

const depositAddress = await wallet.getSingleUseDepositAddress();
console.log("Deposit Address:", depositAddress);

​
Deposit Bitcoin

​
Mainnet

On mainnet, you’ll create a transaction sending funds to the deposit address.

​
Regtest

On REGTEST, you can use our faucet to fund your Spark wallet.

​
Watch for the deposit transaction

After sending Bitcoin to the deposit address, you can watch the mempool for the transaction to be confirmed.

Use below utility function to poll the mempool for the transaction to be confirmed.

import { getLatestDepositTxId } from "@buildonspark/spark-sdk/utils";
const result = await getLatestDepositTxId(depositAddress);

Once confirmed, run claimDeposit(txId) to claim the deposit.

if (result) {
  console.log("Transaction ID: ", result);
  const tx = await wallet.claimDeposit(result);
}

​
Confirmation Requirements

  • Deposits require 3 confirmations on L1
  • Once you’re deposit is final you’ll receive BTC on Spark
  • Funds will be available in your Spark wallet after confirmation

​
Best Practices

  • Start with a small test amount for your first deposit
  • Keep track of your deposit transaction IDs
  • Wait for the required confirmations before considering the deposit complete

​
Next Steps

Once your deposit is confirmed, you can:

​
Need Help?