Skip to main content

EXTRA WALLET CLIs

About​

EXTRA WALLET CLIs is a monorepo containing a collection of command-line tools designed to be run in your terminal. Each CLI focuses on a specific wallet, security, or blockchain-related task, and can be used independently.

These tools are intended for:

  • developers,
  • security researchers,
  • power users,
  • and advanced wallet operators.

Each CLI has its own package, command, and documentation.

License​

Each package is licensed under the PolyForm Noncommercial License 1.0.0. Commercial use requires a separate written commercial license agreement from the licensor — contact alex@vir-tec.net.

Available Packages​

The repository currently includes the following CLI tools:

  • Address Checker CLI
    Checks whether a given address is associated with known malicious activity.

  • Railgun CLI
    A terminal wallet for interacting with the RAILGUN privacy engine, including wallet management, private transfers, POI handling, and compliance exports.

  • Restore Mnemonic CLI
    Assists in restoring a mnemonic phrase when one word is missing.

  • Transaction History CLI
    Fetches transaction history for a specified address on a selected network.

  • Transaction Simulation CLI
    Simulates a transaction to preview the most likely outcome without spending gas.

info

For detailed usage, features, and examples, refer to the README of each individual package.

Repository Structure​

This is a monorepo.
Each CLI lives in its own package directory under packages/ and can be built or executed independently.

packages/
├─ address-checker-cli/
├─ balance-recovery-cli/
├─ private-key-searcher-cli/
├─ secure-qr-cli/
├─ railgun-wallet-cli/
├─ restore-mnemonic-cli/
├─ send-transaction-cli/
├─ transaction-history-cli/
├─ transaction-simulation-cli/
├─ wallet-expander-cli/
└─ wallet-tracker-cli/

How to Run​

You can run the CLIs in two ways, depending on your use case.

This is the simplest way to run a CLI without cloning the repository or building locally.

Requirements​

  • Node.js (LTS recommended)

Example​

npx @extra-wallet/railgun-cli

This will download and execute the CLI on demand, without a global install.

Each CLI package can be run directly using npx <package-name>.

Option 2: Run locally from the repository (for development)​

Use this option if you want to develop, modify, or inspect the CLIs.

Requirements​

  • Node.js (LTS recommended)
  • pnpm package manager

1. Install dependencies​

From the repository root:

pnpm install

2. Build packages​

Build all CLIs at once:

pnpm build

Or build a single package only:

cd packages/<package-name>
pnpm build

3. Execute a CLI locally​

Each package defines its executable command via the bin field in its package.json.

To run a CLI:

  1. Navigate to the package directory.
  2. Check the bin field to find the command name.
  3. Execute it using npx.

Example:

npx railgun-cli

Usage Notes​

  • Each CLI is self-contained and does not require running others.
  • All tools are designed to run locally.
  • Some CLIs may require:
    • reliable RPC endpoints,
    • network configuration,
    • or additional setup described in their package README.

Developer Info​