8 releases

Uses new Rust 2024

new 0.0.14 Nov 7, 2025
0.0.13 Sep 26, 2025
0.0.12 Aug 26, 2025
0.0.9 Jul 17, 2025
0.0.7 Jun 30, 2025

#3 in #firewood

22 downloads per month

Custom license

1MB
18K SLoC

fwdctl

fwdctl is a small CLI designed to make it easy to experiment with firewood locally.

Building locally

cargo build --release --bin fwdctl

To use

./target/release/fwdctl -h

Supported commands

  • fwdctl create: Create a new firewood database.
  • fwdctl get: Get the code associated with a key in the database.
  • fwdctl insert: Insert a key/value pair into the generic key/value store.
  • fwdctl delete: Delete a key/value pair from the database.
  • fwdctl root: Get the root hash of the key/value trie.
  • fwdctl dump: Dump the contents of the key/value store.

Examples

  • fwdctl create
# Check available options when creating a database, including the defaults.
$ fwdctl create -h
# Create a new, blank instance of firewood using the default name "firewood.db".
$ fwdctl create firewood.db
  • fwdctl get KEY
# Get the value associated with a key in the database, if it exists.
fwdctl get KEY
  • fwdctl insert KEY VALUE
# Insert a key/value pair into the database.
fwdctl insert KEY VALUE
  • fwdctl delete KEY
# Delete a key from the database, along with the associated value.
fwdctl delete KEY

Dependencies

~13–18MB
~332K SLoC