Skip to main content
This guide walks you through setting up a local FlowGuard development environment on chipnet — BCH’s public testing network.

​
Prerequisites

  • Node.js 18+
  • pnpm 8+
  • A BCH wallet that supports chipnet (Paytaca or Electron Cash chipnet build)

​
Clone and Install

git clone https://github.com/winsznx/flow-guard
cd flowguard
pnpm install

​
Environment Variables

Copy the example env files: 
cp .env.example .env
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env
Required variables in backend/.env: 
BCH_NETWORK=chipnet
DATABASE_PATH=./flowguard-chipnet.db
Required variables in frontend/.env: 
VITE_API_URL=http://localhost:3001/api
VITE_BCH_NETWORK=chipnet

​
Get Chipnet BCH

Visit the chipnet faucet to fund your wallet:
Chipnet BCH has no real value. Use it freely for testing all FlowGuard products before going to mainnet.

​
Start the Development Stack

1

Start the backend API and indexer

cd backend
pnpm dev
The API starts on http://localhost:3001. The indexer begins scanning chipnet blocks.
2

Start the frontend

cd frontend
pnpm dev
The app starts on http://localhost:5173.
3

Connect your wallet

Open the app, click Connect Wallet, and select Paytaca or your chipnet wallet.
4

Create your first vault

Navigate to Vaults → Create Vault. Use your wallet address as all three signers for a simple 1-of-1 test setup.

​
Verify Setup

Check that the indexer is running correctly: 
curl http://localhost:3001/api/admin/indexer/status
Expected response includes indexer status and block progress metrics.