> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usexfg.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage XFG from the Command Line with fire_wallet

> Use fire_wallet to create wallets, check balances, send XFG, view your full transaction history, and manage keys from your terminal.

`fire_wallet` is the official command-line wallet for Fuego (XFG). It connects to a running `fuegod` daemon, lets you create and open wallet files, send and receive XFG, and access your keys — all from a terminal without a graphical interface.

## Create a new wallet

Run the following command to generate a new wallet and save it to a file called `wallet.keys`:

```bash theme={null}
./fire_wallet --generate-new-wallet wallet.keys
```

You will be prompted to set a password. Store this password securely — you cannot recover it if lost.

## Open an existing wallet

To open a wallet file you have already created:

```bash theme={null}
./fire_wallet --wallet-file wallet.keys
```

## Connect to a daemon

By default, `simplewallet` connects to a local daemon on port `18180`. To specify a different host or port explicitly:

```bash theme={null}
./simplewallet --wallet-file wallet.keys --daemon-host localhost --daemon-port 18180
```

Replace `localhost` with a remote host address if you are connecting to a remote node.

## Available commands

Once the wallet is open, you interact with it through an interactive prompt. The table below lists all available commands.

| Command                                       | Description                                                                                                   |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| `balance` / `show_balance`                    | Display your current wallet balance, including any locked (pending) funds.                                    |
| `transfer <address> <amount> [-p payment_id]` | Send XFG to an address. Mixin is set automatically to the network minimum (2). Minimum fee is 0.008 XFG.      |
| `list_transfers`                              | Show all incoming and outgoing transactions for this wallet.                                                  |
| `show_payments <payment_id>`                  | List all transactions that include the specified payment ID.                                                  |
| `show_incoming_transfers`                     | List only incoming transfers to this wallet.                                                                  |
| `export_keys`                                 | Display your spend secret key and view secret key.                                                            |
| `payment_id`                                  | Generate a random payment ID for use in transactions.                                                         |
| `create_integrated <payment_id>`              | Create an integrated address by combining your wallet address with the given payment ID into a single string. |
| `sign_message`                                | Sign a message with your wallet's spend key to prove ownership.                                               |
| `verify_signature`                            | Verify a signature produced by `sign_message`.                                                                |
| `get_reserve_proof`                           | Generate a cryptographic proof that your wallet holds a certain balance.                                      |
| `get_tx_proof`                                | Generate a proof that a specific transaction was sent to a given address.                                     |
| `show_blockchain_height`                      | Display the current block height as seen by the connected daemon.                                             |
| `optimize_outputs`                            | Merge small outputs into fewer, larger outputs to reduce future transaction sizes.                            |
| `optimize_all_outputs`                        | Run output optimization across all available outputs in the wallet.                                           |
| `show_dust`                                   | List outputs below the dust threshold (below 0.002 XFG).                                                      |
| `show_num_unlocked_outputs`                   | Display how many outputs are currently available to spend.                                                    |
| `start_mining`                                | Begin solo mining using this wallet address through the connected daemon.                                     |
| `stop_mining`                                 | Stop solo mining.                                                                                             |
| `save`                                        | Save the current wallet state to disk immediately.                                                            |
| `reset`                                       | Rescan the blockchain from the beginning to rebuild wallet history.                                           |
| `set_log <level>`                             | Change the logging verbosity level (0–4).                                                                     |
| `help`                                        | List all commands and their usage.                                                                            |
| `exit`                                        | Close the wallet and exit.                                                                                    |

## Transfer parameters

* **Privacy-by-default**: Transaction mixin is automatically set to maximum achievable privacy (based on output availability for your amount & median block size) up to 18- but no lower than network minimum of 8. This cannot be manually overridden in `fire_wallet`.
* **Fee**: The network minimum transaction fee  is =`0.0008 XFG`and is enforced automatically. This fee is deducted from your available balance in addition to the send amount.
* **Payment ID**: An optional 64-character hex string used to identify payments, commonly used by merchants and exchanges. Attach one with the `-p <payment_id>` flag. Generate a random one with the `payment_id` command.

<Warning>
  Keep your wallet file (`wallet.keys`) and its password private. Anyone with access to both can spend your funds. Back up the file to a secure location and never share the password.
</Warning>