EVM icon

EVM

Interact with an EVM chain

Overview

This node enables interaction with Ethereum Virtual Machine (EVM) compatible blockchains. It supports a variety of operations such as checking balances, creating wallets, transferring tokens, interacting with smart contracts, signing messages, and more. The "Donate to Author" operation specifically allows users to send a native token donation to support the development of this EVM node.

Common scenarios where this node is beneficial include:

  • Automating blockchain transactions like token transfers or contract calls.
  • Monitoring wallet balances or transaction statuses.
  • Creating new wallets programmatically.
  • Supporting open-source development by sending donations directly on-chain.

Practical example for the "Donate to Author" operation:

  • A user wants to contribute 0.5 ETH to support ongoing development. They configure the donation amount and execute the node, which sends the specified amount from their wallet to the author's address.

Properties

Name Meaning
All donations go straight back into features, testnets, CI gas fees, and docs. Every wei counts—thank you! Informational notice explaining that donations fund development costs.
Donation Amount Amount of native token to donate (e.g., ETH). Accepts decimal numbers like 0.1, 1, 2, etc.

Output

The output JSON contains the result of the donation transaction. Typically, this includes details such as the transaction hash, status, and any relevant blockchain receipt information confirming the donation was sent successfully.

If the node outputs binary data (not typical for this operation), it would represent raw transaction data or signed messages, but for the donation operation, the output is standard JSON transaction info.

Dependencies

  • Requires an API key credential for an EVM-compatible blockchain provider (e.g., Infura, Alchemy, or similar).
  • Uses the ethers.js library for blockchain interactions.
  • Needs network access to the specified RPC URL of the target EVM chain.
  • The user's wallet private key must be available either via credentials or input to sign and send the donation transaction.

Troubleshooting

  • Invalid Private Key Provided: If the private key is malformed or incorrect, the node will throw an error indicating the key is invalid. Ensure the private key is correctly formatted, optionally prefixed with "0x".
  • Insufficient Funds: Donations require enough native tokens in the wallet to cover the donation amount plus gas fees. Insufficient balance will cause transaction failure.
  • RPC Connection Issues: Network or RPC endpoint problems can prevent transaction submission. Verify the RPC URL and network connectivity.
  • Gas Estimation Failures: If manual gas settings are used incorrectly, the transaction may fail. Use automatic gas estimation unless experienced with manual gas configuration.

Links and References

Discussion