n8n-nodes-nano-rpc
v0.1.0
Published
n8n community node package to execute Nano node RPC commands
Downloads
33
Maintainers
Readme
n8n-nodes-nano-rpc
n8n-nodes-nano-rpc is an n8n community node package for interacting with a Nano node over RPC.
It includes:
- Nano RPC node for on-demand actions (send, receive, account queries, wallet operations, work generation, admin/debug actions)
- Nano Trigger node for event-driven workflows via webhook
Installation
Install this package as an n8n community node. See the official n8n guide:
Then add the following nodes in your workflow editor:
Nano RPCNano Trigger
Credentials
Credential type: Nano API
Required
- RPC URL: URL of your Nano node RPC endpoint (for example
http://localhost:7076)
Optional authentication
- None
- Basic Auth (
username,password) - API Key Header (
headerName,apiKey)
Optional defaults
- Wallet ID: default wallet for wallet-dependent operations
- Default Source Account: default source account for transfer operations
Supported operations
Operations are grouped by resource.
Account
- Get balance
- Get account info
- Get account history
- Get account block count
- Get account key / representative / weight
- Validate address
- Multi-account balance/frontier/receivable/representative queries
Transaction
- Send payment
- Receive pending transaction
- Process block
- Check receivable existence
- Epoch upgrade
Block
- Confirm block
- Get block info / account / count
- Get blocks / blocks info
- Create block
- Calculate block hash
Wallet
- Create/destroy wallet
- Create/list/remove/move accounts
- Change/enter/validate wallet password
- Wallet balances/history/info/ledger/frontiers/receivable/work
- Set wallet/account representative
- Set/get account work
- Wallet add/watch/export/lock
- Search receivable (single/all wallets)
Network
- Node version/id/uptime/telemetry
- Peers and online representatives
- Keepalive, republish, populate backlog
- Available supply
Ledger
- Get chain/successors/frontiers/frontier count
- Get ledger
- Get unopened
Confirmation
- Confirmation active/history/info/quorum
- Election statistics
Work
- Generate/validate work
- Add/list/clear work peers
- Cancel work
Keys
- Create key pair
- Expand key
- Deterministic key derivation
- Sign
Administration
- Bootstrap/bootstrapAny/bootstrapLazy
- Get/reset bootstrap state
- Node stats (get/clear)
- Unchecked blocks (get/clear)
- Stop node
Conversion
- Nano → raw (RPC)
- raw → Nano (RPC)
Usage notes
- Prefer a trusted/private Nano RPC endpoint for production usage.
- Operations that mutate wallet or node state should only be enabled for trusted workflows/users.
- Wallet IDs, block hashes, work values, and account addresses are validated before sensitive operations.
- RPC calls include timeout and retry handling for transient network failures.
Runtime options
Under Options, the node supports:
- Timeout (Ms): request timeout per RPC call
- Max Retries: number of retries for transient failures (timeouts, rate limits, network/server errors)
Compatibility
- Package is built with the n8n community node tooling (
@n8n/node-cli). - Peer dependency:
n8n-workflow@^2.13.1. - Use a Nano node version that supports the RPC actions you invoke.
Development
Available scripts:
builddevlintlint:fixrelease
Resources
Version history
See CHANGELOG.md.
