Run locally

Step-by-step for getting the full stack running on a single Windows + WSL2 + Docker host, in the order the components depend on each other. By the end of this you should be able to: hit eth_chainId on the gateway, see a balance in the read API, create a merchant on Pay, create an invoice, and watch settlement detect a payment.

Prerequisites

A reasonable check:

wsl -l -v
docker --version

The 5-step quickstart

1. Build and start the chain

cd ~/babychain
docker build -f chain\Dockerfile.babychain -t babychain:local chain

Start the node. The script is mounted read-only so editing chain\babychain_local.sh does not require a rebuild; just restart the container.

2. Start the gateway

cd ~/babychain
docker compose -f gateway\docker-compose.yml up -d

Three containers come up: openresty (:8080), indexer, api (:3000), and postgres (:5432).

3. Start Pay

cd ~/babychain
docker compose -f pay\docker-compose.yml up -d

Three containers: pay-api (:4000), pay-settlement, pay-webhooks, pay-sweep.

4. (Optional) start the explorer and monitoring

docker compose -f explorer\docker-compose.yml up -d
docker compose -f monitoring\docker-compose.yml up -d

5. Verify

curl http://localhost:8080 -X POST -H "Content-Type: application/json" `
  --data ''{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}''

You should see {"jsonrpc":"2.0","id":1,"result":"0x07eb"} (2027 in hex).

What runs where

Troubleshooting