F1r3fly Node CLI

Rust crate for interacting with F1r3fly blockchain nodes. Usable as a library or CLI tool.

Quick Start

# Build
cargo build --release

# Check node status and native token info
cargo run --release -- status -H localhost -p 40413

# Deploy and wait for result
cargo run --release -- deploy-and-wait -f contract.rho

# Read-only query
cargo run --release -- exploratory-deploy -f query.rho -H localhost -p 40452

# Query native token metadata from on-chain contract
cargo run --release -- exploratory-deploy -f rho_examples/query_token_metadata.rho -H localhost -p 40452

Documentation

Commands

• deploy -- submit Rholang code to the blockchain
• deploy-and-wait -- deploy, wait for finalization, read result
• exploratory-deploy -- read-only Rholang execution
• estimate-cost -- estimate phlogiston cost before deploying
• get-deploy -- get deploy execution details
• get-data -- read deploy result data
• propose -- manually propose a block
• is-finalized -- check block finalization
• transfer -- transfer native tokens
• Node inspection -- status, blocks, bonds, balance, etc.
• Key management -- generate keys, addresses
• Advanced -- load-test, watch-events, dag, bond-validator

Library

• Getting started -- ConnectionManager API, config, examples
• Events -- WebSocket deploy finalization
• Architecture -- module structure, deploy flow, node endpoints

Testing

• Testing guide -- integration tests (cargo test --test smoke) and CLI smoke test

Environment Variables

Variable	Required	Default	Description
FIREFLY_PRIVATE_KEY	Yes	--	Signing key (64 hex chars)
FIREFLY_HOST	No	localhost	Node hostname
FIREFLY_GRPC_PORT	No	40401	gRPC port
FIREFLY_HTTP_PORT	No	40403	HTTP port
FIREFLY_OBSERVER_HOST	No	same as host	Observer for finalization
FIREFLY_OBSERVER_GRPC_PORT	No	40452	Observer gRPC port
FIREFLY_DEPLOY_TIMEOUT	No	60	Max seconds for block inclusion
FIREFLY_FINALIZATION_TIMEOUT	No	30	Max seconds for finalization

Dependencies

Crate	Version	Purpose
f1r3fly-models	git (rust/dev)	Protobuf types
f1r3fly-shared	git (rust/dev)	Event types
secp256k1	0.31	ECDSA signing
reqwest	0.12	HTTP client
tonic	0.14	gRPC client
tokio-tungstenite	0.26	WebSocket
tracing	0.1	Structured logging
thiserror	2.0	Error derives