monero-docs/docs/en/interacting/overview.md

title
Interacting with Monero

Interacting with Monero

You can interact with Monero via desktop GUI, commandline interface, and programming API.

On top of that, Monero nodes interact with each other in a peer-to-peer network.

Installation directory overview

Once unpacked you will see several executable files. You will also find a nice PDF guide for the GUI wallet.

Monero project nicely decouples network node logic from wallet logic. Wallet logic is offered through three independent user interfaces - the GUI, the CLI, and the HTTP API.

# cd monero-gui-v0.17.1.9

# ---- guide to Monero GUI ----

monero-gui-wallet-guide.pdf

# ---- main executable files -----------

monerod
monero-wallet-gui

# ---- extra executable files -----------

extras/monero-wallet-cli
extras/monero-wallet-rpc

extras/monero-blockchain-prune
extras/monero-gen-trusted-multisig
extras/monero-gen-ssl-cert

extras/monero-blockchain-export
extras/monero-blockchain-import

# ---- don't bother with these ----------

extras/monero-blockchain-stats
extras/monero-blockchain-mark-spent-outputs
extras/monero-blockchain-prune-known-spent-data
extras/monero-blockchain-usage
extras/monero-blockchain-ancestry
extras/monero-blockchain-depth

Executables

Executable	Description
monerod	The full node daemon. Does not require a wallet. Documentation.
monero-wallet-gui	Wallet logic and graphical user interface. Requires monerod running.
monero-wallet-cli	Wallet logic and commandline user interface. Requires monerod running.
monero-wallet-rpc	Wallet logic and HTTP API (JSON-RPC protocol). Requires monerod running.
monero-blockchain-prune	Prune existing local blockchain. This saves 2/3 of disk space (down to 31GB as of Jan 2021). This is preferable over monerod --prune-blockchain which only logically releases space inside the file while the file remains large. The monero-blockchain-prune creates a shrinked copy of the blockchain file. See tutorial1, tutorial2.
monero-gen-ssl-cert	Generate 4096 bit RSA private key and self signed TLS certificate for use with monerod RPC interface. Note, Monero daemon automatically generates TLS certificate on each restart. Manual generation with this tool is only useful if you want to pin TLS certificate fingerprint in your monero wallet. See the pull request.
monero-gen-trusted-multisig	Tool to generate a set of multisig wallets. See chapter on multisignatures.
monero-blockchain-export	Tool to export blockchain to blockchain.raw file.
monero-blockchain-import	Tool to import blockchain.raw - ideally your own trusted copy.

Executables - legacy

You most likely should not bother with these legacy or very specialized tools.

Executable	Description
monero-blockchain-stats	Generate stats like tx/day, blocks/day, bytes/day based on your local blockchain.
monero-blockchain-mark-spent-outputs	Advanced tool to mitigate potential privacy issues related to Monero forks. You normally shouldn't be concerned with that. See the commit and pull request.
monero-blockchain-prune-known-spent-data	Previous limited pruning tool to prune select "known spent" transaction outputs (from the before RCT era). Nowadays prefer monero-blockchain-prune. This only saves ~200 MB. See the commit.
monero-blockchain-usage	Advanced tool to mitigate potential privacy issues related to Monero forks. You normally shouldn't be concerned with that. See the commit and the pull request.
monero-blockchain-ancestry	Advanced research tool to learn ancestors of a transaction, block or chain. Irrelevant for normal users. See this pull request.
monero-blockchain-depth	Advanced research tool to learn depth of a transaction, block or chain. Irrelevant for normal users. See this commit.

Interacting

There are quite a few ways you can interact with Monero software. Perhaps the most surprising for newcomers is that monerod daemon accepts interactive keyboard commands while it is running.

Also, please note that HTTP API is split across monerod and monero-wallet-rpc. You need to run and call both daemons to explore the full API. This follows the node-logic vs wallet-logic split mentioned earlier.

All wallet implementations depend on the monerod running.

Executable	p2p network	node commands via keyboard	node HTTP API	wallet commands via keyboard	wallet HTTP API	wallet via GUI
monerod	✔	✔	✔
monero-wallet-cli				✔
monero-wallet-rpc					✔
monero-wallet-gui						✔

Data directory

This is where the blockchain, log files, and p2p network memory are stored.

By default data directory is at:

• $HOME/.bitmonero/ on Linux and macOS
• C:\ProgramData\bitmonero\ on Windows

Please mind:

• data directory is hidden as per OS convention
• the bitmonero directory name is historical artefact from before Monero forked away from Bitmonero, about 2000 years Before Christ

Data directory contains:

• lmdb/ - the blockchain database directory
• p2pstate.bin - saved memory of discovered and rated peers
• bitmonero.log - log file

It can also contain subdirectories for stagenet and testnet, mirroring the same structure:

• stagenet/ - data directory for Stagenet
• testnet/ - data directory for Testnet