Wallet Node icon

Wallet Node

Interact with a blockchain wallet

Actions2

Overview

This node enables interaction with a blockchain wallet via an Ethereum-compatible JSON RPC endpoint. It supports two main operations: retrieving the balance of a specified wallet address and sending Ether from a wallet to another address. This node is useful for automating blockchain wallet management tasks such as monitoring balances or programmatically transferring funds.

Practical examples include:

  • Checking the Ether balance of a wallet address on the Ethereum mainnet or testnets.
  • Sending Ether payments automatically as part of a workflow, e.g., paying out rewards or invoices.

Properties

Name Meaning
RPC URL The URL of the Ethereum JSON RPC endpoint to connect to (e.g., Infura or Alchemy URL).

Output

The node outputs JSON data with the following structure depending on the operation:

  • Get Balance:

    {
  "balanceWei": "string",     // Wallet balance in Wei (smallest unit)
  "balanceEther": "string"    // Wallet balance converted to Ether (human-readable)
}

  • Send Transaction:

    {
  "txHash": "string"          // The transaction hash of the sent Ether transfer
}

No binary data output is produced by this node.

Dependencies

  • Requires access to an Ethereum-compatible JSON RPC provider URL (e.g., Infura, Alchemy).
  • Requires a private key credential for signing transactions when sending Ether.
  • Uses the ethers library for blockchain interactions.
  • The node expects the private key to be securely provided via credentials configured in n8n.

Troubleshooting

  • Common issues:

    • Invalid or unreachable RPC URL will cause connection failures.
    • Incorrect wallet address format may result in errors fetching balance.
    • Insufficient funds or incorrect private key will cause transaction failures.
    • Network congestion or gas price issues can delay or fail transactions.

  • Error messages:

    • Errors related to RPC connectivity usually indicate misconfigured or invalid RPC URLs.
    • Errors about invalid addresses suggest checking the wallet or recipient address format.
    • Transaction errors often relate to insufficient balance or invalid private key; verify credentials and wallet funds.

  • To resolve errors, ensure all input parameters are correct, the RPC URL is valid and accessible, and the private key credential is properly set up.

Links and References

Discussion