Testing Guide

Learn how to test your wallet operations on Spark

Testing on Regtest

Faucet

You can add test funds to your REGTEST Spark wallet using our faucet.

CLI

To quickly create a Spark wallet and start testing sending and receiving, we recommend using the Spark CLI.

# Clone the Spark SDK repo
git clone https://github.com/buildonspark/spark.git

# Navigate to the JS folder
cd spark/sdks/js

# Install dependencies and build the SDK
yarn && yarn build

# Navigate to the JS CLI folder
cd examples/spark-cli

# Start the CLi
yarn cli

You can find a CLI quickstart guide to interact with Spark here.

Sample Apps

Spark code samples can be found in the Spark Github Repo in the sdks/js/examples directory.

You’ll need to install dependencies before running any of the examples.

# Clone the Spark SDK repo
git clone https://github.com/buildonspark/spark.git

# Navigate to the JS folder
cd spark/sdks/js

# Install dependencies and build the SDK
yarn && yarn build

Faucet

You can add test funds to your REGTEST Spark wallet using our faucet.

CLI

To quickly create a Spark wallet and start testing sending and receiving, we recommend using the Spark CLI.

# Clone the Spark SDK repo
git clone https://github.com/buildonspark/spark.git

# Navigate to the JS folder
cd spark/sdks/js

# Install dependencies and build the SDK
yarn && yarn build

# Navigate to the JS CLI folder
cd examples/spark-cli

# Start the CLi
yarn cli

You can find a CLI quickstart guide to interact with Spark here.

Sample Apps

Spark code samples can be found in the Spark Github Repo in the sdks/js/examples directory.

You’ll need to install dependencies before running any of the examples.

# Clone the Spark SDK repo
git clone https://github.com/buildonspark/spark.git

# Navigate to the JS folder
cd spark/sdks/js

# Install dependencies and build the SDK
yarn && yarn build

Testing Spark <> L1 transfers

To interact with Spark on mainnet, you can use existing Bitcoin tools like the Mempool Explorer to track your transactions. As much as we’d love to hand out free BTC (maybe one day), you’ll need to fund your wallet with your own for now.

Testing Spark <> Lightning

You can test send/receive Lightning payments to/from any Lightning-compatible wallet or exchange. Here are some popular options:

• Coinbase
• Cash App
• Kraken
• Binance
• Ripio
• Strike
• Muun Wallet
• Phoenix Wallet
• Wallet of Satoshi

Works both ways — try it.

Using our demo app

We built a simple React demo app to help you explore how wallet interactions work with Spark — no backend required, and no blockchain wizardry needed to get started.

# Clone the Spark SDK repository
git clone https://github.com/buildonspark/spark.git

# Navigate to the demo app directory
cd spark/sdks/js
# Install all dependencies
yarn install && yarn build

# Start the development server with hot-reloading
cd examples/spark-demo
yarn start

# Once you're done developing and ready for production
# Build the optimized bundle (optional)
yarn build

Open http://localhost:3000 in your browser after starting the development server.

The app supports hot-reloading, shows real-time wallet interactions, and is a good starting point if you’re integrating Spark into your own product. The demo is available here