The Nano.Community CLI is available as a global npm package. You'll need to have Node.js installed to use it.
npm install -g nano-community-cli
It is also available as a yarn global package.
yarn global add nano-community-cli
Version 0.1.0 or later is required. Earlier versions sign in a format the API no longer accepts.
The CLI signs with the 32-byte private key of a nano account, as 64 hex characters. Wallets usually show a seed or a mnemonic rather than an account private key. A seed and an account index derive the private key, as described in the nano documentation's key management guide. Back up the seed before you export any key from it.
Use the account private key once, to link a signing key, and use the signing key for everything after that.
The CLI will prompt you for the private key if it is not already set as an environment variable. Using the CLI in this way is simple and secure, as the private key will neither be stored in command history nor saved to a file.
If you prefer setting the environment variable, you have three options:
Choose the method that best suits your security and convenience needs.
You can set the environment variable for a single command by passing it as an argument.
NC_CLI_NANO_PRIVATE_KEY='<private_key>' nano-community update-rep-meta
export NC_CLI_NANO_PRIVATE_KEY='<private_key>'
set NC_CLI_NANO_PRIVATE_KEY=<private_key>
This will persist for the duration of the current session in the terminal. You can now run commands without having to set the environment variable for each command.
You can persist the environment variable for all sessions by adding it to your .bashrc, .zshrc, or .bash_profile file in your home directory.
The purpose of a signing key is to sign messages to manage metadata related to a nano account/representative or block while minimizing the exposure of the account private key. This is optional but recommended.
nano-community add-signing-key
Run it with the account private key. The CLI generates a new signing key and links it to the account. Linking takes both keys' consent: the account signs a message naming the new key, and the new key signs a message naming the account. The CLI prints the new key's public and private keys. Store the private key securely.
This new signing key can now be used in place of your account key. Replace the NC_CLI_NANO_PRIVATE_KEY environment variable with the signing key's private key. Messages it signs apply to the linked account.
A key can be linked only once. A key that was ever linked, to any account and whether or not it was later revoked, is refused with "key previously linked; generate a new key". Run add-signing-key again to get a new one.
Signing keys linked before the CLI 0.1.0 release were revoked when the update was deployed, because the old link signature did not bind the key it linked. If you had a signing key, run add-signing-key again with the account private key to link a new one. The old key cannot be linked again.
To revoke a signing key, use the revoke-signing-key command with the public key of the signing key. Either the signing key itself or the account key can sign the revocation.
nano-community revoke-signing-key <linked_public_key>
The CLI asks you to confirm and shows the key that will be revoked.
Every command signs a canonical Nano signed message for the domain nano.community. The signature binds the action, every field you entered, the signing account, the time and a one-time nonce. The API accepts a message only within ten minutes of its signing time, so the clock on your computer needs to be roughly right.
To update the metadata for a Nano representative use the update-rep-meta command.
nano-community update-rep-meta
Supported metadata fields:
You can set a public alias for a nano account using the update-account-meta command.
nano-community update-account-meta
Supported metadata fields:
You can set a public note for a nano block using the update-block-meta command. The note shows on the block's page on nano.community.
nano-community update-block-meta <block_hash>
Supported metadata fields:
The block must be confirmed and published by your account, or by the account your signing key is linked to. Otherwise the message is rejected and nothing is stored. When several notes are signed for one block, the one with the latest signing time is shown.
A representative operator can sign a measured power reading with the update-representative-power-reading command. It needs CLI 0.5.0 or later. The reading feeds the energy figure on the homepage, as described in Network Energy Usage.
nano-community update-representative-power-reading
Sign with a signing key linked to the representative account, not the account private key. The account must be a representative known to nano.community, or the reading is rejected and nothing is stored.
Supported fields:
wall_meter for a meter between the wall and the host's power supply, or baseboard_management_controller for the host's own power sensor through IPMI or Redfish.2026-11-13T00:00:00Z. The window must be at least 24 hours and must end before you sign. The CLI sends both as epoch seconds.The reading whose window ends latest is your current one, and every reading you sign is kept. To correct a reading, sign one over a later window.
A representative operator can sign the details of the host the node runs on with the report-representative-hardware command. It needs CLI 0.6.0 or later and a Linux host. The site estimates the representative's power from the report, as described in Network Energy Usage.
nano-community report-representative-hardware
Run it on the host that runs the node, signed with a key linked to the representative account. It reads the following, shows them, and sends nothing until you confirm:
/proc/cpuinfossd or hdd with its size, from lsblksystemd-detect-virt reports, or none/proc/stat, in hundredths of a percent, and the uptime it covers. The host must have been up at least 24 hours.nano_node process's average share of the host's CPU since it started, or null if no node process is foundThe latest report is current. Run it again after any hardware change or move to another host. A measured reading from update-representative-power-reading takes precedence over the estimate.