​
Receiving Spark Payments

Spark ↔ Spark transfers, use Spark Addresses to identify the receiving wallet. To receive a payment, you’ll need to get your Spark wallet address and share it with the sender. The Spark Address format is similar to the usual Bitcoin address format:

Address Example: sp1pgssyuuuhnrrdjswal5c3s3rafw9w3y5dd4cjy3duxlf7hjzkp0rqx6dj6mrhu

Checkout Spark Addresses for more details.

Code Sample:

const sparkAddress = await wallet.getSparkAddress();
console.log("Spark Address:", sparkAddress);

​
Sending Spark Payments

Send Bitcoin payments to other Spark wallets:

const transfer = await wallet.transfer({
  receiverSparkAddress:
    "sp1pgssyuuuhnrrdjswal5c3s3rafw9w3y5dd4cjy3duxlf7hjzkp0rqx6dj6mrhu",
  amountSats: 100,
});

console.log("Transfer:", transfer);

Using a Spark Wallet you can also send and receive Tokens to other Spark users:

 const transfer = await wallet.transferTokens({
        tokenPublicKey: "0226ec76414bcf3f87e37882912a595f1d6701b609b97d0ed464284b418a395dba",
        tokenAmount: 100n,
        receiverSparkAddress: "sp1pgssyuuuhnrrdjswal5c3s3rafw9w3y5dd4cjy3duxlf7hjzkp0rqx6dj6mrhu"
  });

console.log("Transfer:", transfer);

​
Receiving Spark Payments

To check balance after a transfer, use the getBalance() method.

// Check updated balance
const balance = await wallet.getBalance();
console.log("New balance:", balance);

The getBalance() method returns a Promise resolving to an object containing:

  • balance: A bigint representing the total amount in satoshis
  • tokenBalances: A Map of token balances, where each entry contains:
    • The public key of the token
    • An object with bigint representing the token amount

Additionally, you can listen for balance update events.

wallet.on("transfer:claimed", (transferId: string, balance: number) => {
  console.log(
    `Transfer ${transferId} claimed. New balance: ${balance}`,
  );

​
Features and Benefits

  • Instant settlements
  • Lower fees compared to on-chain transactions
  • Standard pubkey addressing system

​
Next Steps

After mastering Spark payments, you can:

​
Need Help?