Skip to main content

Transfer

Creates a transfer transaction to send native cryptocurrency (ETH, MATIC, BNB, etc.) to another address.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • Wallet Address - The source wallet address sending the cryptocurrency.
  • To Address - The destination wallet address receiving the cryptocurrency.
  • Amount (GWEI) - The amount to transfer in hexadecimal format (e.g., "0x..." representing the value in WEI).

Output​

  • Transaction ID - A unique identifier for the transfer transaction. Use this with the Send Transaction node to execute the transfer.

How It Works​

The Transfer node prepares a cryptocurrency transfer transaction. When executed, the node:

  1. Validates the amount is in proper hex format
  2. Converts the hex amount to a big integer value
  3. Creates a transaction data structure with the amount
  4. Generates a unique Transaction ID
  5. Returns the Transaction ID for execution with Send Transaction

Requirements​

  • Valid wallet addresses for both source and destination
  • Amount in hexadecimal format starting with "0x"
  • Sufficient balance in the source wallet (checked when sending)

Error Handling​

The node will return errors for:

  • Amount not in hex format
  • Amount not starting with "0x"
  • Invalid amount value

Amount Formatting​

The amount must be provided in hexadecimal format representing WEI:

Examples:

  • 1 ETH = 0x0de0b6b3a7640000 (1000000000000000000 WEI)
  • 0.1 ETH = 0x016345785d8a0000 (100000000000000000 WEI)
  • 0.01 ETH = 0x002386f26fc10000 (10000000000000000 WEI)

Use the To WEI node to convert decimal amounts to hex format.

Usage Notes​

  • This node only prepares the transaction; use Send Transaction to execute it
  • The Transfer node is for native currency only (ETH, MATIC, BNB)
  • For ERC20 token transfers, use ABI Method with the token's transfer function
  • The Transaction ID is temporary and only valid during flow execution
  • Gas fees will be added automatically by Send Transaction
  • Always verify addresses before sending transactions

Example​

Transferring 0.1 ETH:

First, convert the amount with To WEI node:

  • Amount: 0.1
  • Unit: wei
  • Output: 0x016345785d8a0000

Then create the transfer:

Inputs:

  • Wallet Address: 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb
  • To Address: 0x1234567890123456789012345678901234567890
  • Amount (GWEI): 0x016345785d8a0000

Output:

  • Transaction ID: tx-a1b2c3d4-e5f6-7g8h-9i0j-k1l2m3n4o5p6

Next step - execute with Send Transaction:

  • Client ID: (from Create Client)
  • Transaction ID: tx-a1b2c3d4-e5f6-7g8h-9i0j-k1l2m3n4o5p6
  • Contract/To Address: 0x1234567890123456789012345678901234567890
  • Gas Price: (from Estimate Gas Price)
  • Gas Limit: 21000 (standard for ETH transfer)

Common Use Cases​

Automated Payments: Send payments to suppliers, employees, or customers automatically.

Wallet Funding: Distribute funds to multiple wallets for operations.

Profit Distribution: Transfer earnings from trading or yield farming to stakeholders.

Treasury Management: Move funds between organizational wallets based on rules.

Refunds: Automatically process refunds to customers.

Balance Rebalancing: Maintain target balances across multiple wallets.

tip

Always use Estimate Gas before sending transfers to ensure the transaction will succeed and to get the current gas price.

warning

Verify the destination address carefully. Cryptocurrency transfers are irreversible. Sending to the wrong address will result in permanent loss of funds.

Complete Transfer Flow​

  1. To WEI - Convert decimal amount to hex WEI format
  2. Transfer - Create transfer transaction
  3. Estimate Gas Price - Get current gas price
  4. Send Transaction - Execute the transfer
  5. Transaction Receipt - Verify completion

Gas Costs​

Standard ETH transfers use 21,000 gas:

  • At 20 GWEI: ~$0.05-0.10 (varies with ETH price)
  • At 50 GWEI: ~$0.15-0.25
  • At 100 GWEI: ~$0.30-0.50
info

The actual amount sent is the "Amount" you specify. Gas fees are additional and paid from the sender's wallet balance.

ERC20 Token Transfers​

For transferring ERC20 tokens (USDC, DAI, etc.), don't use the Transfer node. Instead:

  1. Use Parse ABI with the token's ABI
  2. Use ABI Method with the "transfer" function
  3. Pass recipient address and amount as arguments
  4. Use Send Transaction to execute