BeaconKit CLI

Berachain Node (beacond) Reference

beacond, is an EVM consensus client implementation used as a basic beacon node for Berachain. See BeaconKit Consensus Layer for more details.

Global Flags

These flags apply to all commands:

Flag	Description
--home string	Directory for config and data (default: ~/.beacond)

Basic Commands

init

Initialize validator and node configuration files.

beacond init <moniker> [flags]

Flags

Flag	Description
--chain-id string	Genesis file chain-id (randomly created if blank)
--beacon-kit.chain-spec	Which chain to generate configurations for. This value is also placed in the generated app.toml. mainnet or testnet or file
--beacon-kit.chain-spec-file	If chain-spec=file, which file to use. Should be toml format. This value is also placed in the generated app.toml.
--default-denom string	Genesis file default denomination (default: “stake”)
--initial-height int	Initial block height at genesis (default: 1)
-o, --overwrite	Overwrite the genesis.json file
--recover	Recover existing key using seed phrase instead of creating new one

start

Run the node application with CometBFT in process.

beacond start [flags]

Flags

The start command has numerous configuration flags for networking, consensus, pruning, and more. Key flags include:

Flag	Description
--abci string	ABCI transport (socket or grpc) (default: “socket”)
--address string	Listen address (default: “tcp://127.0.0.1:26658”)
--db_backend string	Database backend (default: “pebbledb”)
--moniker string	Node name
--p2p.laddr string	Node listen address (default: “tcp://0.0.0.0:26656”)
--p2p.persistent_peers string	Comma-delimited ID@host:port persistent peers
--p2p.seeds string	Comma-delimited ID@host:port seed nodes
--pruning string	Pruning strategy (default|nothing|everything|custom)
--rpc.laddr string	RPC listen address (default: “tcp://127.0.0.1:26657”)

Additional flags are available for detailed engine configuration, beacon-kit settings, and consensus parameters.

status

Query remote node for status information.

beacond status [flags]

Flags

Flag	Description
-n, --node string	Node to connect to (default: “tcp://localhost:26657”)
-o, --output string	Output format (text|json) (default: “json”)

version

Print the application binary version information.

beacond version [flags]

Flags

Flag	Description
--long	Print long version information
-o, --output string	Output format (text|json) (default: “text”)

rollback

Recover from an incorrect application state transition by rolling back one height.

beacond rollback [flags]

Flags

Flag	Description
--hard	Remove last block as well as state

CometBFT Commands (comet)

Commands for managing the CometBFT consensus engine.

comet bootstrap-state

Bootstrap CometBFT state at an arbitrary block height using a light client.

beacond comet bootstrap-state [flags]

Flags

Flag	Description
--height int	Block height to bootstrap state at (uses latest block height in app state if not provided)

comet reset-state

Remove all data and WAL (Write-Ahead Log).

beacond comet reset-state [flags]

comet show-address

Show this node’s CometBFT validator consensus address.

beacond comet show-address [flags]

comet show-node-id

Show this node’s ID.

beacond comet show-node-id [flags]

comet show-validator

Show this node’s CometBFT validator info.

beacond comet show-validator [flags]

comet unsafe-reset-all

Remove all data and WAL, reset this node’s validator to genesis state (unsafe).

beacond comet unsafe-reset-all [flags]

Flags

Flag	Description
--keep-addr-book	Keep the address book intact
-k, --key-type string	Private key type (ed25519|secp256k1|bls12_381) (default: “ed25519”)

comet version

Print protocols’ and libraries’ version numbers this app was compiled against.

beacond comet version [flags]

Deposit Commands (deposit)

Commands for managing validator deposits.

deposit create-validator

Create a validator deposit with necessary credentials.

beacond deposit create-validator [withdrawal-address] [amount] ?[beacond/genesis.json] [flags]

Flags

Flag	Description
-g, --genesis-validator-root string	Use provided genesis validator root (if not set, beacond genesis file must be provided)
-o, --override-node-key	Override the node private key

deposit validate

Validate a deposit message for creating a new validator.

beacond deposit validate [pubkey] [withdrawal-credentials] [amount] [signature] ?[beacond/genesis.json] [flags]

Flags

Flag	Description
-g, --genesis-validator-root string	Use provided genesis validator root (if not set, beacond genesis file must be provided)

deposit validator-keys

Output validator public key in various formats.

beacond deposit validator-keys [flags]

Displays the validator key as Comet address, Comet pubkey, and Eth/Beacon pubkey formats.

Genesis Commands (genesis)

Commands for genesis file management. These are largely only of interest to those of us maintaining Berachain, so we have stuck to the generally useful ones.

genesis validator-root

Get and return the genesis validator root hash.

beacond genesis validator-root [beacond/genesis.json] [flags]

JWT Commands (jwt)

Commands for managing JWT authentication.

jwt generate

Generate a new JWT authentication secret.

beacond jwt generate [flags]

Flags

Flag	Description
-o, --output-path string	Optional output file path for the JWT secret (default: ”./jwt.hex”)

jwt validate

Validate a JWT secret by checking if it’s formatted properly.

beacond jwt validate [flags]

Flags

Flag	Description
-i, --input-path string	Optional input file path for the JWT secret (default: ”./jwt.hex”)