Ethereum icon

Ethereum

Interact with Ethereum blockchain

Actions6

Overview

This node interacts with the Ethereum blockchain, specifically focusing on wallet-related operations. For the "Get ETH Balance" operation under the "Wallet" resource, it retrieves the Ether (ETH) balance of any specified Ethereum wallet address. This is useful for monitoring wallet balances in real-time, integrating balance checks into workflows, or validating funds before transactions.

Practical examples:

  • Automatically checking the ETH balance of a user's wallet before initiating a payment.
  • Monitoring multiple wallet addresses to trigger alerts when balances fall below a threshold.
  • Integrating balance retrieval into reporting dashboards or audit logs.

Properties

Name Meaning
RPC URL Ethereum RPC endpoint URL used to connect to the Ethereum network. Defaults to a public RPC endpoint but can be customized to any valid Ethereum node URL. Optional.
Wallet Address The Ethereum wallet address whose ETH balance you want to retrieve. If left empty, the node will use the wallet address from the connected credential (if applicable).

Output

The output JSON object contains the following fields:

  • address: The Ethereum wallet address queried.
  • balance: The ETH balance formatted as a decimal string in Ether units (e.g., "0.1234").
  • balanceWei: The raw balance value in Wei (the smallest unit of Ether), represented as a string.

Example output JSON:

{
  "address": "0xabc123...def",
  "balance": "1.2345",
  "balanceWei": "1234500000000000000"
}

No binary data is output by this operation.

Dependencies

  • Requires access to an Ethereum JSON-RPC endpoint (RPC URL) to query the blockchain state. By default, it uses a public Ethereum RPC endpoint but can be configured to any custom node.
  • No special credentials are required for this operation if a wallet address is provided explicitly.
  • Uses the ethers JavaScript library internally for blockchain interaction.

Troubleshooting

  • Empty or invalid wallet address: If the wallet address is missing or malformed, the node may fail to retrieve the balance. Ensure the address is a valid Ethereum address.
  • RPC connection issues: If the RPC URL is incorrect, unreachable, or rate-limited, balance retrieval will fail. Verify the RPC endpoint and network connectivity.
  • Credential wallet usage: If no wallet address is provided and the node attempts to use a credential wallet that is not set up or accessible, it may throw errors. Provide a wallet address explicitly or ensure credentials are properly configured.
  • Error messages: Common errors include "invalid address", "network error", or timeout errors related to the RPC provider. Check the input parameters and RPC service status.

Links and References

Discussion