Screenshots

Blockfrost Credential Selection

Blockfrost Credential Configuration

Blockfrost Node Selection in Workflow

Blockfrost Node Configuration Details

Demo Video

n8n-nodes-blockfrost

This is a custom n8n node for interacting with the Cardano blockchain via the Blockfrost API.

Features

🎯 Comprehensive Cardano Blockchain Integration

• 75+ endpoints covering all major Cardano operations
• Complete API coverage following Blockfrost OpenAPI v0.1.78

📊 Available Categories:

• Health & Metrics - API status and usage monitoring
• Accounts - Stake account information, rewards, history, delegations
• Addresses - Address details, UTXOs, transactions
• Assets - Native tokens, NFTs, asset history and transactions
• Blocks - Block information, transactions, addresses affected
• Epochs - Epoch details, stake distribution, protocol parameters
• Governance - DReps, proposals, votes, governance metadata
• Ledger - Blockchain genesis information
• Mempool - Current pending transactions
• Metadata - Transaction metadata in JSON and CBOR formats
• Network - Network statistics and era information
• Pools - Stake pool data, delegators, performance, votes
• Scripts - Smart contracts, Plutus scripts, redeemers, datums
• Transactions - Full transaction details, UTXOs, certificates, submission
• Utilities - Address derivation, transaction evaluation

🔧 Advanced Features:

• Work with NFTs and native tokens
• Submit transactions to the blockchain
• Query smart contract data and redeemers
• Access governance information (DReps, proposals)
• Monitor stake pool performance and delegations
• Evaluate transaction execution costs
• Support for all Cardano networks (mainnet, preprod, preview)

Installation

Option 1: Community Node (via npm)

1. Open your n8n instance
2. Go to Settings > Community Nodes
3. Click Install
4. Enter n8n-nodes-blockfrost and click Install

Option 2: Manual Installation

1. Navigate to your n8n custom directory: ~/.n8n/custom/
2. Clone this repository: git clone https://github.com/bevanamit/n8n-nodes-blockfrost.git
3. Install dependencies: cd n8n-nodes-blockfrost && npm install
4. Build the project: npm run build
5. Restart n8n

Option 3: Fail-Safe Installation (if npm install does not work as expected)

If running npm install n8n-nodes-blockfrost in your ~/.n8n/custom/ directory does not install the package correctly, try the following steps:

1. Open a terminal and navigate to your n8n custom directory:

   cd ~/.n8n/custom

2. Initialize a package.json if it does not exist:

   npm init -y

3. Install the package:

   npm install n8n-nodes-blockfrost

4. Restart n8n completely (stop and start the process).

This ensures the package and its dependencies are installed correctly and n8n can load the custom node.

Prerequisites

• n8n (version 0.209.0 or newer)
• A Blockfrost account and project API key

Credentials

To use this node, you need to set up Blockfrost API credentials:

1. Sign up for a free account on Blockfrost.io
2. Create a project and get your API key
3. In n8n, create a new credential of type Blockfrost API
4. Enter your Project ID (API key)
5. Select the appropriate Network (mainnet, preprod, preview)

Usage

1. Add the Blockfrost node to your workflow
2. Select a Category (e.g., Accounts, Addresses, Assets, etc.)
3. Choose an Operation specific to that category
4. Fill in the required parameters
5. Connect the node to other nodes in your workflow

Example Workflows

1. Monitor Cardano Address Balance

Create a workflow that periodically checks a Cardano address balance and sends notifications when changes occur.

2. Track NFT Ownership

Monitor ownership changes of specific NFTs on the Cardano blockchain.

3. Analyze Transaction History

Pull transaction data for analysis or reporting purposes.

Development

If you want to contribute to this node:

1. Clone the repository
2. Install dependencies: npm install
3. Build the code: npm run build
4. Link to your local n8n: npm link
5. In your n8n installation directory: npm link n8n-nodes-blockfrost

Blockfrost Account Setup

To use this node, you'll need a Blockfrost account and Project ID. Follow these steps to set one up:

1. Create an Account:

   • Visit blockfrost.io
   • Click the "Sign Up" button
   • Complete the registration form

2. Create a Project:

   • After signing in, navigate to the Dashboard
   • Click "Create Project"
   • Enter a project name (e.g., "n8n Integration")
   • Select the network:
     • Cardano Mainnet: For production use
     • Cardano Preprod: For testing on the preprod testnet
     • Cardano Preview: For testing on the preview testnet

3. Get Your Project ID:

   • After creating your project, you'll be shown your Project ID
   • This ID will look something like mainnet1a2b3c4d5e6f7g8h9i0j
   • Copy this ID to use in your n8n Blockfrost node credentials

4. Free Tier Information:

   • Blockfrost offers a free tier with 50,000 requests per day
   • This is sufficient for many use cases and development
   • Paid plans are available if you need higher limits

5. Security Note:

   • Treat your Project ID as a secret key
   • Don't commit it to public repositories
   • Consider using n8n's credential encryption feature

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

This is free software, and you are welcome to redistribute it under certain conditions.

Support & Donations

I am not Catalyst funded. Any support you provide is greatly appreciated!

Cardano (ADA) donation address:

addr1qyxypmc96e3pska6ch2ucq4uv5d7uz6nhpgcne4ea4hgmemv40lpm3wmc3wqk5arjpgzrccm0m9k72puaqzwsgrj47asch66sp