🍣 Nigiri Bitcoin
Nigiri provides a fully dockerized ready-to-use bitcoin environment thats supports different networks and chains.
Utensils
Ingredients
Directions
| Preparation Time: 5 min | Cooking Difficulty: Easy |
|---|
Clone the repo:
$ git clone https://github.com/vulpemventures/nigiri.git
Enter project directory and install dependencies:
nigiri $ bash scripts/install
Build binary (Mac version):
nigiri $ bash scripts/build darwin amd64
At the moment bitcoind, liquidd and electrs are started on regtest network.
Create nigiri environment:
nigiri/build $ nigiri-linux-amd64 create
Nigiri uses the default directory ~/.nigiri to store the configuration file and docker stuff.
To set a custom directory use the --datadir flag, but do not forget to always pass this flag to other commands, just as you do with your bitcoind.
The environment will start with 3 containers for regtest bitcoin network that run the following services respectevely:
- bitcoin daemon
- electrs REST server
- API passthrough with optional faucet and mining capabilities (nigiri-chopsticks)
Use the --liquid flag to let you do experiments with the Liquid sidechain. A liquid daemon and a block explorer
are also started when passing this flag.
Start/Stop nigiri:
nigiri/build $ nigiri-linux-amd64 start|stop
Stop and delete nigiri environment:
nigiri/build $ nigiri-linux-amd64 delete
This command stops and deletes any active contained and deletes the configuration file and all the Docker-generated files and directories.
Nutrition Facts
The list of all available endpoints can be extended with one more POST /faucet which expects a body { "address": <receiving_address> } by enabling faucet.
Footnotes
If you really do love Sathoshi's favourite dish like us at Vulpem Ventures, check the real recipe out and enjoy your own, delicious, hand made nigiri sushi.
Roadmap
- router
- electrum server
- bitcoin daemon
- liquid daemon
- faucet