n8n-nodes-quicknode

This is an n8n community node that provides comprehensive access to blockchain data through QuickNode's infrastructure. It allows you to interact with various blockchain networks using RPC calls, retrieve NFT metadata, and access token information.

🚀 Features

• Blockchain Operations: Get block numbers, balances, and gas prices
• NFT Support: Retrieve NFT metadata and token information
• Token Operations: Access ERC-20 token balances and data
• AI Agent Optimized: Perfect for AI automation workflows
• Error Handling: Robust error management with detailed responses
• Multiple Networks: Support for Ethereum and other EVM-compatible chains

📦 Installation

Follow the installation guide in the n8n community nodes documentation.

npm install @cryptodevops/n8n-nodes-quicknode

🔧 Configuration

QuickNode Credentials

1. Sign up at QuickNode
2. Create an endpoint for your desired blockchain network
3. Copy your endpoint URL
4. (Optional) Generate an API key for enhanced features

n8n Setup

1. Go to Settings > Community Nodes
2. Install @cryptodevops/n8n-nodes-quicknode
3. Add QuickNode credentials with your endpoint URL

🎯 Operations

Blockchain Operations

• Get Block Number: Retrieve the latest block number
• Get Balance: Get ETH balance of any address
• Get Gas Price: Get current network gas price

NFT Operations

• Get NFT Metadata: Retrieve NFT metadata using contract address and token ID

Token Operations

• Get Token Balance: Get ERC-20 token balance for any address

💡 Usage Examples

Basic Blockchain Query

{
  "resource": "blockchain",
  "operation": "getBlockNumber"
}

Check ETH Balance

{
  "resource": "blockchain",
  "operation": "getBalance",
  "address": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4Db45"
}

Get Token Balance

{
  "resource": "token",
  "operation": "getTokenBalance",
  "address": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4Db45",
  "contractAddress": "0xA0b86a33E6441E6C6C7C0b4B1c0b4B1c0b4B1c0b"
}

📊 Response Format

All responses include structured data:

{
  "resource": "blockchain",
  "operation": "getBalance",
  "timestamp": "2024-01-15T10:30:00.000Z",
  "data": {
    "jsonrpc": "2.0",
    "result": "0x1bc16d674ec80000",
    "id": 1
  },
  "summary": {
    "balanceWei": "2000000000000000000",
    "balanceEth": "2.0",
    "balanceHex": "0x1bc16d674ec80000"
  },
  "aiDescription": "Retrieved ETH balance for the specified address"
}

🤖 AI Agent Support

This node is specifically designed for AI agents with:

• Clear Descriptions: Every operation has detailed descriptions
• Formatted Summaries: Automatic conversion of hex values to readable formats
• AI Descriptions: Human-readable explanations for each operation
• Error Context: Detailed error messages for troubleshooting

🧪 Testing

Test your QuickNode connection:

node test-quicknode.js

🔗 Supported Networks

• Ethereum Mainnet
• Ethereum Testnets (Goerli, Sepolia)
• Polygon
• BSC (Binance Smart Chain)
• Arbitrum
• Optimism
• And many more EVM-compatible networks

📚 Documentation

• QuickNode API Documentation
• n8n Community Nodes
• Ethereum JSON-RPC

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

MIT

🆘 Support

• GitHub Issues
• n8n Community
• QuickNode Support

Made with ❤️ by CryptoDevOps