Wallet Node icon

Wallet Node

Interact with a blockchain wallet
Join our community

Actions2

Overview

This node enables interaction with a blockchain wallet on an Ethereum-compatible network via JSON-RPC. It supports two main operations:

  • Get Balance: Retrieve the balance of a specified wallet address.
  • Send Transaction: Send Ether from a wallet (using a private key credential) to another address.

Common scenarios include checking wallet balances programmatically or automating Ether transfers within workflows, such as paying for services, distributing funds, or triggering payments based on external events.

Example use cases:

  • Automatically sending ETH to a user after they complete a task.
  • Monitoring wallet balances and alerting when funds are low.
  • Integrating blockchain payments into business processes.

Properties

Name Meaning
RPC URL The JSON-RPC endpoint URL of the Ethereum-compatible blockchain node (e.g., Infura URL).
To Address The recipient's Ethereum address to which Ether will be sent (used in "Send Transaction").
Amount (ETH) The amount of Ether to send, expressed in ETH units (used in "Send Transaction").

Output

  • For Get Balance operation:

    • balanceWei: The wallet balance in Wei (smallest unit of Ether) as a string.
    • balanceEther: The wallet balance converted to Ether as a string.

  • For Send Transaction operation:

    • txHash: The transaction hash string of the submitted transaction.

The output is provided as JSON objects per input item. There is no binary data output.

Dependencies

  • Requires an Ethereum JSON-RPC provider URL (RPC URL), such as Infura or Alchemy.
  • Requires a private key credential for signing transactions when sending Ether.
  • Uses the ethers library internally for blockchain interactions.
  • No additional environment variables are needed beyond the configured credentials and RPC URL.

Troubleshooting

  • Invalid RPC URL or network issues: If the RPC URL is incorrect or the node cannot connect, requests will fail. Verify the URL and network connectivity.
  • Insufficient funds: Sending transactions may fail if the wallet does not have enough Ether to cover the amount plus gas fees.
  • Invalid addresses: Ensure that both the wallet address (for balance) and the recipient address (for sending) are valid Ethereum addresses.
  • Credential errors: The private key must be correctly configured and valid; otherwise, signing transactions will fail.
  • Error messages: Errors thrown during execution include descriptive messages. If continueOnFail is enabled, errors are returned alongside input data for easier debugging.

Links and References

Discussion