Testing Guide

​

1. Getting faucet and testing Spark <> L1 transfers

We’ve deployed our own internal Regtest environment to simplify local development and testing. To interact with Spark on Regtest, you can use the Spark Regtest Faucet to request funds.

• Username: hackathon

• Password: MakeBitcoinMoneyAgain

​

2. Paying an invoice directly from regtest

You can pay invoices using the Lightning Command Line tool in the spark repo. Below are the set up instructions:

Git clone the repo:

git clone https://github.com/buildonspark/spark-sdk.git

Go to the tools folder:

cd spark-sdk/tools/paylightning

Install dependencies:

brew install rust

Verify rust is installed:

rustc --version
cargo --version

Run the Tool:

cargo run -- "your-lightning-invoice"

On first run, the tool will download a few dependencies before processing the Lightning invoice. Subsequent runs will be faster, as dependencies are already in place

​

1. 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.

​

2. 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.

​

3. Using our Spark CLI tool

We’ve built a CLI tool that lets you test wallet operations on Spark — no coding needed. To install the CLI tool, you can run:

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

# Navigate to the JS SDK example folder
cd sdks/js/packages/spark-sdk/src/examples

# Install deps and build the SDK
yarn install && yarn build

# Start the CLI (use 'mainnet' or 'regtest' as <network>)
yarn tsx ./example.ts <network>

Once it’s running, type help to explore commands.

​

Command Reference

​

4. 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-sdk.git

# Navigate to the demo app directory
cd spark-sdk/sdks/js/examples/spark-demo

# Install all dependencies
yarn install

# Start the development server with hot-reloading
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