Wallet Node icon

Wallet Node

Interact with a blockchain wallet

Overview

This node interacts 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 transactions from a wallet.

Common scenarios include:

  • Checking the current Ether balance of any Ethereum wallet address.
  • Sending Ether from a wallet controlled by the user to another address.

Practical examples:

  • Monitoring wallet balances in real-time for accounting or alerting.
  • Automating payments or transfers on the Ethereum network as part of a workflow.

Properties

Name Meaning
RPC URL The URL of the Ethereum JSON-RPC endpoint to connect to (e.g., Infura, Alchemy).
Wallet Address The Ethereum wallet address whose balance you want to retrieve (used only for Get Balance operation).

Output

The node outputs a JSON object with the following structure when performing the "Get Balance" operation:

{
  "balanceWei": "string",   // The wallet balance in Wei (smallest unit of Ether) as a string.
  "balanceEther": "string"  // The wallet balance converted to Ether as a decimal string.
}

If the node were used for sending transactions (not requested here), it would output the transaction hash.

No binary data is output by this node.

Dependencies

  • Requires access to an Ethereum JSON-RPC provider URL (such as Infura or Alchemy).
  • For sending transactions, requires a private key credential to sign transactions (not applicable for Get Balance).
  • Uses the ethers library for interacting with the Ethereum blockchain.

Troubleshooting

  • Invalid RPC URL or network issues: If the RPC URL is incorrect or unreachable, the node will fail to connect. Verify the URL and network connectivity.
  • Invalid wallet address: Providing an incorrectly formatted Ethereum address will cause errors. Ensure the address is valid and checksummed if necessary.
  • Rate limits or API restrictions: Public RPC providers may impose rate limits; consider using a dedicated API key or service.
  • Error messages: Errors typically include connection failures or invalid parameters. Review the error message for details and verify inputs.

Links and References

Discussion