dunes-cli

The dunes-cli is an interactive command‑line tool for managing a bitcoin dunes wallet and interacting with Dune assets. It supports wallet generation, recovery, switching addresses, querying balances, transferring funds, minting and etching Dune tokens, configuration management, and more.

🚀 Installation

1. Install Node.js (v18 or higher).

2. On your command line terminal, run:

   npm install -g dunes-cli

3. Youre all set! You can now use the dunes command in your terminal. To view the commands you can call, run

   dunes --help

📚 Command Reference

The CLI command is invoked as dunes. Below are the available commands along with usage examples:

Wallet Commands

• Generate a New Address

  • Generates a new wallet address (or switches to the next index if a wallet already exists).
  • Usage:

    dunes wallet generate

  • Example output shows the new wallet index and address.

• Recover a Wallet

  • Recovers a wallet from a 12‑word mnemonic phrase.
  • Usage:

    dunes wallet recover

  • Follow the prompts to enter your mnemonic phrase and set a password.

• Reveal Mnemonic

  • Displays the mnemonic phrase for your active wallet.
  • Usage:

    dunes wallet reveal

• Show Wallet Info

  • Displays the current wallet address.
  • Usage:

    dunes wallet info

• Switch Wallet

  • Switches to another HD wallet index.
  • Usage:

    dunes wallet switch <index>

  • Example:

    dunes wallet switch 2

• List Wallets

  • Lists all generated wallet addresses and their balances.
  • Usage:

    dunes wallets

Balance & Transfer Commands

• Balance

  • Display confirmed BTC and Dune balances for your wallet address.
  • Usage:

    dunes balance

• Transfer

  • Interactively build and broadcast BTC and/or Dune transfers.
  • Usage:

    dunes transfer

  • Follow the interactive prompts to enter transfer details.

Dune Asset Commands

• Dune Info

  • Shows metadata and the top holders for a Dune asset.
  • Usage:

    dunes info <block:tx | duneName>

  • Example:

    dunes info 859:1

= Discover dunes =

• Dune List

  • Lists all Dunes on the network.
  • Usage:

    dunes all <protocol>

• Holders

  • Lists holders for a specific Dune asset.
  • Usage:

    dunes holders <block:tx | duneName> [page]

  • Example:

    dunes holders 859:1 3

• Mint

  • Mint a Dune token that you have already etched (if mintable).
  • Usage:

    dunes mint <block:tx | duneName>

  • Follows prompts for mint cost and confirmation.

• Etch

  • Create a Dunestone etching and build a transaction.
  • Usage:

    dunes etch

  • A guided wizard walks you through setting etching properties.

Configuration Commands

• Set Configuration

  • Set Electrum API URL, Dunes RPC URL, or Network (bitcoin | testnet | regtest).
  • Usage:

    dunes config set --electrum <url> --dunes <url> --network <env>

  • Example:

    dunes config set --electrum https://regtest.anoa.io/api --network regtest

• Show Configuration

  • Display the current Dunes CLI configuration.
  • Usage:

    dunes config show

  • You may also run:

    dunes config

For more details or to report issues, please visit the GitHub Issue Tracker.