# Command line options

*Last updated: January 2026*

This document provides a **complete reference** for all command-line options supported by the **Abey (`gabey`)** client. Options are grouped by functionality for easier navigation and operational clarity.

***

### Usage

```bash
gabey [options] command [command options] [arguments...]
```

**Version:** `1.1.2-stable`\
**Copyright:** © 2018–2026 Abey Foundation

***

### Commands

| Command      | Description                                            |
| ------------ | ------------------------------------------------------ |
| `account`    | Manage accounts                                        |
| `attach`     | Attach to a running node with a JavaScript console     |
| `console`    | Start an interactive JavaScript console                |
| `bug`        | Open a bug report window                               |
| `copydb`     | Create a local chain from an existing chaindata folder |
| `dump`       | Dump a specific block from storage                     |
| `dumpconfig` | Show resolved configuration values                     |
| `export`     | Export blockchain data                                 |
| `import`     | Import blockchain data                                 |
| `init`       | Initialize a new genesis block                         |
| `js`         | Execute JavaScript files                               |
| `license`    | Display license information                            |
| `monitor`    | Monitor and visualize node metrics                     |
| `removedb`   | Remove blockchain and state databases                  |
| `version`    | Print version information                              |
| `wallet`     | Manage presale wallets                                 |
| `help`       | Show help information                                  |

***

### Core Options

#### Configuration and Storage

| Option       | Description                                  |
| ------------ | -------------------------------------------- |
| `--config`   | Path to TOML configuration file              |
| `--datadir`  | Data directory for blockchain and keystore   |
| `--keystore` | Keystore directory (default: inside datadir) |
| `--nousb`    | Disable USB hardware wallet support          |
| `--identity` | Custom node name                             |

***

#### Network Selection

| Option        | Description                |
| ------------- | -------------------------- |
| `--networkid` | Network identifier         |
| `--testnet`   | Enable test network        |
| `--devnet`    | Enable development network |

***

#### Synchronization

| Option       | Description                                     |
| ------------ | ----------------------------------------------- |
| `--syncmode` | Sync mode (`fast`, `full`, `light`, `snapshot`) |
| `--gcmode`   | Garbage collection mode (`full`, `archive`)     |
| `--stategc`  | Delete block bodies and receipts                |

***

### Consensus and Committee Options

#### Election

| Option       | Description               |
| ------------ | ------------------------- |
| `--election` | Enable validator election |

***

#### BFT (Committee)

| Option        | Description                                  |
| ------------- | -------------------------------------------- |
| `--bftip`     | Committee node public IP                     |
| `--bftport`   | Committee port (default: 30310)              |
| `--bftport2`  | Committee standby port (default: 30311)      |
| `--bftkey`    | Generate BFT private key                     |
| `--bftkeyhex` | Generate BFT private key (hex, testing only) |
| `--oldbft`    | Run BFT over HTTP                            |

***

### Transaction Pool Options

Controls how pending transactions are queued and prioritized.

| Option                  | Description                          |
| ----------------------- | ------------------------------------ |
| `--txpool.nolocals`     | Disable local transaction exemptions |
| `--txpool.journal`      | Transaction journal file             |
| `--txpool.rejournal`    | Journal regeneration interval        |
| `--txpool.pricelimit`   | Minimum accepted gas price           |
| `--txpool.pricebump`    | Price bump percentage                |
| `--txpool.accountslots` | Executable slots per account         |
| `--txpool.globalslots`  | Global executable slots              |
| `--txpool.accountqueue` | Non-executable slots per account     |
| `--txpool.globalqueue`  | Global non-executable slots          |
| `--txpool.lifetime`     | Transaction lifetime                 |

***

### Fruit Pool Options

| Option                  | Description                         |
| ----------------------- | ----------------------------------- |
| `--fruitpool.journal`   | Fruit journal file                  |
| `--fruitpool.rejournal` | Fruit journal regeneration interval |
| `--fruitpool.count`     | Maximum pending fruits              |

***

### Performance Tuning

| Option              | Description                       |
| ------------------- | --------------------------------- |
| `--cache`           | Cache size in MB                  |
| `--cache.database`  | Cache percentage for database I/O |
| `--cache.gc`        | Cache percentage for trie pruning |
| `--trie-cache-gens` | Trie generations kept in memory   |

***

### Account Options

| Option       | Description        |
| ------------ | ------------------ |
| `--unlock`   | Accounts to unlock |
| `--password` | Password file      |

***

### RPC, IPC, and Console

| Option            | Description              |
| ----------------- | ------------------------ |
| `--rpc`           | Enable HTTP-RPC          |
| `--rpcaddr`       | RPC bind address         |
| `--rpcport`       | RPC port                 |
| `--rpcapi`        | APIs exposed over RPC    |
| `--ws`            | Enable WebSocket RPC     |
| `--wsaddr`        | WS bind address          |
| `--wsport`        | WS port                  |
| `--wsapi`         | APIs exposed over WS     |
| `--ipcdisable`    | Disable IPC              |
| `--ipcpath`       | IPC socket path          |
| `--rpccorsdomain` | CORS domains             |
| `--rpcvhosts`     | Allowed virtual hosts    |
| `--jspath`        | JavaScript root path     |
| `--exec`          | Execute JavaScript       |
| `--preload`       | Preload JavaScript files |

***

### Networking

| Option         | Description            |
| -------------- | ---------------------- |
| `--bootnodes`  | Bootstrap nodes        |
| `--port`       | P2P port               |
| `--maxpeers`   | Maximum peers          |
| `--nodiscover` | Disable peer discovery |
| `--nat`        | NAT configuration      |
| `--nodekey`    | P2P node key file      |

***

### Mining

| Option           | Description          |
| ---------------- | -------------------- |
| `--mine`         | Enable mining        |
| `--minefruit`    | Mine fruits only     |
| `--minerthreads` | Mining threads       |
| `--coinbase`     | Reward address       |
| `--gastarget`    | Target gas floor     |
| `--gaslimit`     | Target gas ceiling   |
| `--gasprice`     | Minimum gas price    |
| `--extradata`    | Extra block data     |
| `--remote`       | Enable remote mining |

***

### Logging and Debugging

| Option        | Description                   |
| ------------- | ----------------------------- |
| `--verbosity` | Log verbosity                 |
| `--vmodule`   | Per-module verbosity          |
| `--debug`     | Include file and line numbers |
| `--metrics`   | Enable metrics                |
| `--pprof`     | Enable pprof server           |
| `--trace`     | Write execution trace         |

***

### Miscellaneous

| Option         | Description |
| -------------- | ----------- |
| `--help`, `-h` | Show help   |

***

### Notes

* Not all options are safe for production use
* Avoid exposing RPC interfaces publicly
* Prefer IPC for administrative operations
* Always test configuration changes on non-production nodes first


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.abey.com/usage/command_line_options.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.