PkgFoundry
Catalog npm
Back to packageRELEASE DETAILS

0.1.1

npm

@0xlimao/n8n-nodes-ethereum

Comprehensive Ethereum blockchain integration for n8n with unified node structure using viem

blockchainethereumn8nn8n-community-node-packageviemweb3
Published24 Dec 2025
Direct dependencies14
Transitive dependenciesNot calculated

README

Current package documentation

n8n-nodes-ethereum

npm version

Comprehensive Ethereum blockchain integration for n8n with a unified node structure using viem. This community node package provides two powerful nodes: Ethereum (regular node) and Ethereum Trigger (trigger node) for interacting with Ethereum and EVM-compatible blockchains.

⚠️ Disclaimer

WARNING: This package is currently in early development and has not been thoroughly tested or audited. Please use at your own risk.

  • ❌ Not production-ready
  • ⚠️ May contain bugs or security vulnerabilities
  • 🔍 Always verify transaction details before execution
  • 💰 Test with small amounts first
  • 🛡️ Conduct your own security review

By using this package, you acknowledge these risks and agree that you are solely responsible for any losses or damages.

Features

  • ✨ Unified Node Structure: Single Ethereum node with Resource/Operation pattern for cleaner UX
  • 🔐 Secure Credentials: Separate RPC and Account credentials with optional wallet for read operations
  • 🔄 10 Resource Types: Account, Block, Transaction, Contract, ERC20, ERC721, ERC1155, ENS, Gas, Utils
  • ⚡ Trigger Support: Monitor new blocks, contract events, and transactions in real-time
  • 🌐 Multi-Chain: Supports Ethereum, Polygon, BSC, Arbitrum, Optimism, Avalanche, Fantom, Base, and custom networks
  • 🪙 Complete Token Standards: ERC20, ERC721, ERC1155 with automatic ABI handling
  • 📦 Built with viem: Modern, type-safe TypeScript library for Ethereum interactions

Installation

npm install @0xlimao/n8n-nodes-ethereum

Credentials

Ethereum RPC

Connection details for the Ethereum node.

Fields:

  • Chain: Select from supported chains (Ethereum, Polygon, BSC, etc.) or choose Custom
  • RPC URL (required): HTTP(S) or WebSocket endpoint (e.g., https://mainnet.infura.io/v3/YOUR-API-KEY)
  • Custom Headers (optional): JSON object for API authentication (e.g., {"Authorization": "Bearer token"})

Ethereum Account

Wallet credentials for signing transactions. Optional for read operations.

Fields:

  • Private Key (optional): 64-character hex private key (with or without 0x prefix)
  • Mnemonic Phrase (optional): 12 or 24-word seed phrase
  • Derivation Path: BIP-44 path for deriving account from mnemonic (default: m/44'/60'/0'/0/0)
  • Passphrase: Optional passphrase for BIP-39 mnemonic

Note: At least one of Private Key or Mnemonic is required for write operations. Read operations don't need this credential.

Triggers

Event Trigger

Activates workflow when a smart contract emits specific events.

Features:

  • Monitor all contracts (no address required)
  • Support multiple contract addresses
  • Support multiple event types

Block Trigger

Triggers when a new block is created on the blockchain.

Transaction Trigger

Triggers when transactions occur at specified addresses.

Features:

  • Monitor specific addresses
  • Filter for incoming transactions only
  • Filter for outgoing transactions only
  • Monitor both incoming and outgoing (default)

Nodes

Account Operations

  • Get Balance: Retrieve native token balance with formatting options (wei/gwei/ether)
  • Get Transaction Count: Get account nonce for transaction sequencing
  • Get Code: Check if address is a smart contract

Block Operations

  • Get Block: Retrieve detailed block information with optional full transactions
  • Get Block Number: Get current blockchain height with caching support

Transaction Operations

  • Send Transaction: Send native tokens with EIP-1559 gas support
  • Get Transaction: Retrieve transaction details by hash
  • Get Transaction Receipt: Get transaction receipt with event logs
  • Wait For Transaction: Wait for confirmations with configurable timeout
  • Estimate Gas: Estimate gas requirements with buffer

Contract Operations

  • Read Contract: Call view/pure functions with dynamic parameter inputs
  • Write Contract: Execute state-changing contract functions
  • Deploy Contract: Deploy smart contracts with constructor arguments
  • Multicall: Batch multiple read operations efficiently
  • Simulate Contract: Test contract calls without sending transactions
  • Get Logs: Query historical event logs with automatic decoding

ERC20 Token Standard (9 nodes)

  • Get Balance: Token balance with automatic decimal formatting
  • Transfer: Send tokens with decimal conversion
  • Approve: Approve spending with unlimited option
  • Transfer From: Transfer using allowance
  • Get Allowance: Check approved amounts
  • Get Total Supply: Query total token supply
  • Get Decimals: Retrieve token decimals
  • Get Name: Get token name
  • Get Symbol: Get token symbol

ERC721 NFT Standard (9 nodes)

  • Get Balance: NFT count for address
  • Owner Of: Get owner of specific token ID
  • Transfer From: Transfer NFT ownership
  • Safe Transfer From: Safe transfer with receiver validation
  • Approve: Approve NFT transfer
  • Set Approval For All: Approve operator for all NFTs
  • Get Approved: Get approved address for token
  • Is Approved For All: Check operator approval status
  • Token URI: Get token metadata URI

ERC1155 Multi-Token Standard (7 nodes)

  • Balance Of: Get balance for specific token ID
  • Balance Of Batch: Batch balance queries
  • Safe Transfer From: Safe transfer single token type
  • Safe Batch Transfer From: Batch transfer multiple token types
  • Set Approval For All: Approve operator
  • Is Approved For All: Check operator approval
  • URI: Get token metadata URI

Gas Operations

  • Get Gas Price: Retrieve current gas price (legacy)
  • Get Fee History: Analyze historical fees for EIP-1559 optimization
  • Estimate Max Priority Fee: Estimate priority fee for transactions

ENS Operations

  • Get ENS Address: Resolve ENS name to Ethereum address
  • Get ENS Name: Reverse resolve address to ENS name
  • Get ENS Avatar: Retrieve avatar URI for ENS name
  • Get ENS Text: Get text records (email, twitter, url, etc.)
  • Get ENS Resolver: Get resolver contract address

Signature Operations

  • Sign Message: Personal message signing with wallet
  • Sign Typed Data: EIP-712 structured data signing
  • Verify Message: Verify personal message signatures
  • Verify Typed Data: Verify EIP-712 signatures
  • Recover Address: Recover signer address from signature
  • Hash Message: Keccak256 hash of messages
  • Hash Typed Data: Hash typed data for signing

Utility Operations

  • Format Units: Convert wei to human-readable format
  • Parse Units: Convert human-readable to wei
  • Get Chain ID: Retrieve current chain identifier
  • Validate Address: Validate and checksum Ethereum addresses
  • Encode Function Data: Encode function call data from ABI
  • Decode Function Data: Decode function call data using ABI
  • Encode Event Topics: Encode event topics for log filtering
  • Decode Event Log: Decode event log data using ABI
  • Get Contract Address: Calculate CREATE/CREATE2 deployment addresses

Advanced Operations

  • Get Storage At: Read raw storage slots from contracts
  • Call: Make raw contract calls with custom data
  • Get Proof: Generate Merkle proofs for account state and storage

Usage Examples

Monitor Contract Events and Send Notifications

[Event Trigger] → [Process Data] → [Send Notification]

Periodically Read Contract State

[Schedule Trigger] → [Read Contract] → [Store Data]

Execute Contract Operation and Wait for Confirmation

[Trigger] → [Write Contract] → [Wait Transaction] → [Post-processing]

Supported Networks

The package includes pre-configured support for 18 major Ethereum-compatible networks:

Ethereum:

  • Mainnet
  • Sepolia (testnet)
  • Goerli (testnet)
  • Holesky (testnet)

Layer 2 & Scaling:

  • Arbitrum One
  • Arbitrum Sepolia
  • Optimism
  • Optimism Sepolia
  • Base
  • Base Sepolia

Sidechains & Alternative L1s:

  • Polygon (Matic)
  • Polygon Amoy (testnet)
  • BNB Smart Chain (BSC)
  • BSC Testnet
  • Avalanche C-Chain
  • Avalanche Fuji (testnet)

Additional Networks:

  • Gnosis Chain
  • Celo

You can also add custom networks by configuring the RPC endpoint directly.

License

MIT License

Contributing

Issues and Pull Requests are welcome!

Related Links

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 14

Native requirements
14 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
viem
Environment
{
  "local_name": "viem",
  "alias": false,
  "peer_metadata": null
}
^2.21.0runtime
abitype
Environment
{
  "local_name": "abitype",
  "alias": false,
  "peer_metadata": null
}
^1.0.0runtime
n8n-core
Environment
{
  "local_name": "n8n-core",
  "alias": false,
  "peer_metadata": null
}
^1.0.0runtime
n8n-workflow
Environment
{
  "local_name": "n8n-workflow",
  "alias": false,
  "peer_metadata": null
}
^1.0.0runtime
gulp
Environment
{
  "local_name": "gulp",
  "alias": false,
  "peer_metadata": null
}
^5.0.1development
eslint
Environment
{
  "local_name": "eslint",
  "alias": false,
  "peer_metadata": null
}
^8.0.0development
vitest
Environment
{
  "local_name": "vitest",
  "alias": false,
  "peer_metadata": null
}
^1.0.0development
hardhat
Environment
{
  "local_name": "hardhat",
  "alias": false,
  "peer_metadata": null
}
^2.19.0development
prettier
Environment
{
  "local_name": "prettier",
  "alias": false,
  "peer_metadata": null
}
^3.0.0development
typescript
Environment
{
  "local_name": "typescript",
  "alias": false,
  "peer_metadata": null
}
^5.3.0development
@types/node
Environment
{
  "local_name": "@types/node",
  "alias": false,
  "peer_metadata": null
}
^20.19.27development
@typescript-eslint/parser
Environment
{
  "local_name": "@typescript-eslint/parser",
  "alias": false,
  "peer_metadata": null
}
^6.0.0development
@nomicfoundation/hardhat-viem
Environment
{
  "local_name": "@nomicfoundation/hardhat-viem",
  "alias": false,
  "peer_metadata": null
}
^2.0.0development
@typescript-eslint/eslint-plugin
Environment
{
  "local_name": "@typescript-eslint/eslint-plugin",
  "alias": false,
  "peer_metadata": null
}
^6.0.0development

Distribution files

1 collected
Distribution 1

Source distribution

Source file
Checksums from source
{
  "shasum": "dd11000daed6eaf98769ecd7b283c3325f9166b4",
  "tarball": "https://registry.npmjs.org/@0xlimao/n8n-nodes-ethereum/-/n8n-nodes-ethereum-0.1.1.tgz",
  "fileCount": 56,
  "integrity": "sha512-r2YHbxB10b6+aJlms0IVoTf7WipS6IIyw17oxOdqjE6AY8ey+6Yjlk52Ycn5+SrvHTax+2ZuaZgSR7DUf5T9bg==",
  "signatures": [
    {
      "sig": "MEQCIBPb7IyfA4wTAqrYsWDSwkEs9IHWESW2kbk4g/OYTjlUAiAYF+v2WYnJxUsfoX2KV3iZJvT0enPSHWaoZ7ikXwUyUA==",
      "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"
    }
  ],
  "unpackedSize": 1282054
}

Repository

PENDING
flyinglimao/n8n-ethereum

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 21 Oct, 09:04 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:c77095a4d4d52d02631f5eb242ccf28ca99ca077c95c070b89d68fb82720a64b

Other collected versions

1.0.18 Jan1.0.06 JanView all collected versions →