Actions11
Overview
This node enables interaction with Ethereum Virtual Machine (EVM) compatible blockchains to transfer tokens. It supports transferring native blockchain tokens (like ETH, BNB, MATIC), ERC20 tokens, and ERC721 NFTs. The node is useful for automating token transfers in workflows such as payments, asset management, NFT trading, or batch transfers.
Practical examples:
- Sending ETH or other native tokens from one wallet to another.
- Transferring ERC20 tokens like USDT or DAI between addresses.
- Transferring ownership of an ERC721 NFT by specifying its token ID.
The node also supports advanced transaction options like manual gas settings, nonce management, and private key input flexibility.
Properties
| Name | Meaning |
|---|---|
| Token Type | The type of token to transfer. Options: Native Token, ERC20 Token, ERC721 NFT. |
| Token Contract Address | The contract address of the ERC20 token to transfer. Required if Token Type is ERC20. |
| NFT Contract Address | The contract address of the ERC721 NFT to transfer. Required if Token Type is ERC721. |
| Token ID | The ID of the NFT to transfer. Required if Token Type is ERC721. |
| Wallet Source | Choose which wallet to use for this transaction. Options: Credential Wallet (wallet from credential settings), Input Private Key (provide a private key directly). |
| Private Key | The private key to use for this specific transaction when Wallet Source is "Input Private Key". Can be with or without 0x prefix. |
| To Address | The recipient's blockchain address. |
| Value (Native Token) | Amount of native token to transfer (e.g., ETH). Accepts decimal numbers like 0.1, 1, 2, etc. Required for all token types but primarily used for native token transfers. |
| Gas Settings | How gas settings should be determined. Options: Auto (Estimated) - network estimates gas; Manual - user sets gas parameters manually. |
| Gas Limit | Gas limit for the transaction. Required if Gas Settings is Manual. |
| Max Fee Per Gas (Gwei) | Maximum fee per gas in Gwei. Required if Gas Settings is Manual. |
| Max Priority Fee Per Gas (Gwei) | Maximum priority fee per gas in Gwei. Required if Gas Settings is Manual. |
| No Execution, Estimate Gas Only | If enabled, only estimates the gas required for the transaction without executing it. Useful for cost estimation before sending. |
| Transaction Management | Collection of advanced transaction options: • Manual Nonce: Specify a nonce manually (-1 to auto-manage). • Max Attempts: Number of retries if transaction fails. • Replacement Fee Boost (%): Increase gas fee % for replacement transactions. |
Output
The node outputs JSON data representing the result of the token transfer operation. This typically includes:
- Transaction hash and details confirming the transfer.
- Status of the transaction (success/failure).
- Gas used and fees paid.
- For gas estimation mode, estimated gas values without actual execution.
If binary data were involved (not applicable here), it would represent raw transaction data or signatures, but this node focuses on JSON output describing transaction results.
Dependencies
- Requires connection to an EVM-compatible blockchain via an RPC URL provided in credentials.
- Needs an API key credential that includes the RPC URL and optionally a default private key wallet.
- Uses the ethers.js library for blockchain interactions.
- Supports direct private key input for signing transactions if not using the credential wallet.
Troubleshooting
- Invalid Private Key Provided: Error thrown if the private key format is incorrect or invalid. Ensure the private key is correct and optionally prefixed with "0x".
- Insufficient Funds: Transactions will fail if the sending wallet lacks enough native tokens to cover value plus gas fees.
- Gas Estimation Failures: If manual gas settings are incorrect or too low, transactions may fail or revert. Use auto gas estimation or adjust gas parameters carefully.
- Nonce Conflicts: When managing nonces manually, ensure the nonce is correct to avoid transaction replacement or rejection.
- Incorrect Contract Addresses or Token IDs: For ERC20/ERC721 transfers, verify the contract address and token ID are valid and correspond to the intended assets.
- Network Connectivity Issues: Ensure the RPC URL is reachable and correct for the target blockchain network.