firewood-fwdctl

Crates.iofirewood-fwdctl
lib.rsfirewood-fwdctl
version0.0.12
created_at2025-06-21 01:16:36.110022+00
updated_at2025-08-26 18:01:47.891789+00
descriptionCommand-line tool for Firewood, an embedded key-value store optimized for blockchain state.
homepagehttps://avalabs.org
repositoryhttps://github.com/ava-labs/firewood
max_upload_size
id1720429
size95,300
Joachim Brandon LeBlanc (demosdemon)

documentation

README

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
Commit count: 931

cargo fmt