# Bitcoin Testing Nigiri

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

- Skill: `claude-dev-suite/bitcoin-testing-nigiri` (Agent Skill)
- Install (CLI): `npx skillmds@latest add claude-dev-suite/bitcoin-testing-nigiri`
- Raw SKILL.md: https://api.skillmd.com/api/skills/claude-dev-suite/bitcoin-testing-nigiri/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: claude-dev-suite (https://skillmd.com/u/claude-dev-suite)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/claude-dev-suite/bitcoin-testing-nigiri

---


# 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)