monero-wallet-rpc - Reference¶

RPC Command library¶

Wallet RPC commands

Overview¶

Provides wallet API over HTTP¶

Programmers can build thin user interfaces (UIs) on top of monero-wallet-rpc.

Programmers can also use monero-wallet-rpc to build arbitrary wallet automation driven by HTTP calls.

Think of monero-wallet-rpc as complete wallet logic exposed via JSON-RPC over HTTP.

Wallet uses your private keys to understand your total balance, transactions history, and to facilitate creating transactions.

However, wallet does not store the blockchain and does not directly participate in the p2p network.

Depends on the full node¶

Wallet connects to a full node to scan the blockchain for your transaction outputs and to send your transactions out to the network.

The full node can be either local (same computer) or remote.

You can play with CLI wallet and GUI wallet first to understand the relationship between the full node, the wallet and the user.

Syntax¶

./monero-wallet-rpc --rpc-bind-port <port> (--wallet-file <file>|--generate-from-json <file>|--wallet-dir <directory>) [options]

Or with a config file:

./monero-wallet-rpc --config-file <arg>

Running¶

Make sure you are running a locally synced monerod or point to a remote daemon with --daemon-address option.

Linux (Production Example)¶

./monero-wallet-rpc --rpc-bind-port 28088 --wallet-file wallets/main/main --password walletPassword --rpc-login monero:rpcPassword --log-file logs/monero-wallet-rpc.log --max-log-files 2 --trusted-daemon --non-interactive

• If the RPC is used to retrieve information not dependent on any spending, consider using a view-only to prevent abuse.
• --rpc-login should be used in production to protect against any network attacks. An uncommon password protects against the case where the RPC port is open to the public

Windows (Development Example)¶

monero-wallet-rpc --rpc-bind-port 28088 --wallet-file wallets\main\main --password walletPassword --daemon-address http://node.supportxmr.com:18081 --untrusted-daemon --disable-rpc-login

• Specifying --untrusted-daemon is not necessary but tells yourself that the daemon is untrusted and that commands requiring a trusted daemon will be disabled
• Default installation on Windows is "C:\Program Files\Monero GUI Wallet"

Trouble Shooting¶

If the expected RPC URL, say http://127.0.0.1:28088/json_rpc, is unavailabe, or there is no terminal output saying that the server has been started, monero-wallet-rpc might be trying to synchronize the wallet. In that case, you should use the GUI or CLI to sync that wallet file because using the GUI/CLI results in faster and measurable syncing.

The suggested way is to have two wallet files for the same keys. One that is used manually (synced often), and one that is used by monero-wallet-rpc. Whenever you decide to use monero-wallet-rpc and encounter the unresponsive issue, simply copy the files of the GUI/CLI wallet and replace the ones that were being used by monero-wallet-rpc. This problem should only occur on the development system where monerod or monero-wallet-rpc might not have been running for weeks. In production, monerod and monero-wallet-rpc should have minimal downtimes, ensuring that the wallet is always synchronized.

API conventions¶

The API is based on JSON-RPC standard version 2.0.

All monero-wallet-rpc method calls use the same JSON-RPC interface.

Assuming your monero-wallet-rpc is running on 127.0.0.1:18088, you would call it like this:

IP=127.0.0.1
PORT=18088
METHOD="make_integrated_address"
PARAMS="{\"payment_id\":\"1234567890123456789012345678900012345678901234567890123456789000\"}"
curl \
    -u username:password --digest \
    -X POST http://$IP:$PORT/json_rpc \
    -d '{"jsonrpc":"2.0","id":"0","method":"'$METHOD'","params":'"$PARAMS"'}' \
    -H 'Content-Type: application/json'

The atomic unit used by the API is the smallest fraction of 1 XMR according to the monerod implementation. 1 XMR = 1e12 atomic units.

Options¶

Help and Version¶

Pick Network¶

Logging¶

Daemon (Node)¶

Other Useful¶

RPC¶

Open Existing Wallet¶

Create new Wallet¶

Windows Service¶

Legacy and Rare Uses¶