Claude
Skills
Sign in
Back

bitcoin-testing-nigiri

Included with Lifetime
$97 forever

Nigiri: regtest stack with Bitcoin + Esplora + electrs + Liquid + optional LN. CLI-based, fast iteration, includes faucet. USE WHEN: regtest with explorer dependency, full-stack E2E testing, dev environment with Esplora API.

Backend & APIs

What this skill does


# Nigiri

Single-command regtest stack. Includes Bitcoin Core + electrs +
Esplora frontend + optional Liquid + optional LN.

Repo: `github.com/vulpemventures/nigiri`.

## Quickstart

```bash
nigiri start         # spin up bitcoind + electrs + esplora
nigiri faucet bcrt1q...   # send test BTC
nigiri rpc getblockchaininfo
nigiri logs
nigiri stop
```

## Features

- **All in one**: `nigiri start` runs bitcoind, electrs, Esplora
  frontend, Chopsticks (mock signatures).
- **Esplora available** at `localhost:5000` for explorer + REST API.
- **Faucet** for instant BTC.
- **Liquid support** via `nigiri start --liquid`.
- **Lightning** via `nigiri start --ln`.

## Use cases

- **Wallet integration** that needs Esplora API.
- **End-to-end testing** with realistic explorer queries.
- **Demos** with full Bitcoin + explorer view.

## Compared

| Aspect | Nigiri | Polar | Manual regtest |
|--------|--------|-------|----------------|
| GUI | no | yes | no |
| Explorer | Esplora | none | manual |
| LN support | optional | primary | manual |
| Liquid | yes | no | manual |
| Setup time | <1 min | <1 min | minutes-hours |

## Common issues

- Docker required; resource cost (~2-4 GB RAM).
- Port conflicts: bitcoind uses 18443, electrs 50001, Esplora 5000.
- Liquid stack adds significant resource use.

## See also

- [regtest/SKILL.md](../regtest/SKILL.md)
- [polar/SKILL.md](../polar/SKILL.md)
- [../infrastructure/esplora/SKILL.md](../../infrastructure/esplora/SKILL.md)
- [../l2/liquid/SKILL.md](../../l2/liquid/SKILL.md)

Related in Backend & APIs