n8n-nodes-cardano

[Velocity BPA Licensing Notice]

This n8n node is licensed under the Business Source License 1.1 (BSL 1.1).

Use of this node by for-profit organizations in production environments requires a commercial license from Velocity BPA.

For licensing information, visit https://velobpa.com/licensing or contact licensing@velobpa.com.

A comprehensive n8n community node for Cardano blockchain providing 13 resources and 100+ operations for accounts, transactions, native tokens, NFTs, staking, smart contracts, and governance. Includes real-time event triggers and full support for CIP standards.

Features

Credentials

• Cardano Network API: Connect to Mainnet, Preprod, Preview, or custom networks via Blockfrost, Koios, Cardano GraphQL, or Ogmios
• Cardano Wallet: Support for mnemonic phrases (15/24 words), extended signing keys, separate payment/stake keys

Cardano Node (13 Resources, 100+ Operations)

Cardano Trigger Node (11 Event Types)

Real-time blockchain event monitoring with polling:

• Block/Transaction: New Block, Address Transaction, Large Transaction
• Asset: Token Transfer, Token Minted, NFT Transfer
• Staking: Delegation Changed, Rewards Available, Pool Retirement
• Smart Contract: Script Execution
• Account: Balance Change

Installation

Community Nodes (Recommended)

1. Open n8n
2. Go to Settings → Community Nodes
3. Click Install a community node
4. Enter n8n-nodes-cardano
5. Click Install

Manual Installation

# Clone repository
git clone https://github.com/Velocity-BPA/n8n-nodes-cardano.git
cd n8n-nodes-cardano

# Install dependencies
npm install

# Build
npm run build

# Link to n8n
cd ~/.n8n/custom
ln -s /path/to/n8n-nodes-cardano .

Development Installation

# Extract the zip file
unzip n8n-nodes-cardano.zip
cd n8n-nodes-cardano

# Install dependencies
npm install

# Build the project
npm run build

# Create symlink to n8n custom nodes directory
mkdir -p ~/.n8n/custom
ln -s $(pwd) ~/.n8n/custom/n8n-nodes-cardano

# Restart n8n
n8n start

Credentials Setup

Cardano Network API

Cardano Wallet (Optional)

Usage Examples

Get Address Balance

{
  "resource": "account",
  "operation": "getBalance",
  "address": "addr1qx2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer..."
}

Monitor Large Transactions

Use the Cardano Trigger node with:

• Trigger Type: Large Transaction
• Threshold: 10000 (ADA)
• Poll Interval: 60 seconds

Get NFT Collection

{
  "resource": "nft",
  "operation": "getCollection",
  "policyId": "d5e6bf0500378d4f0da4e8dde6becec7621cd8cbf5cbb9b87013d4cc"
}

Check Staking Rewards

{
  "resource": "staking",
  "operation": "getAvailableRewards",
  "stakeAddress": "stake1uxpdrerp9wrxunfh6ukyv5267j70fzxgw0fr3z8zeac5vyqhf9jhy"
}

Cardano Concepts

Address Types

• Base Address (addr1q...): Payment + stake credentials
• Enterprise Address (addr1v...): Payment only, no staking
• Stake Address (stake1...): Rewards/delegation address

Units

• 1 ADA = 1,000,000 Lovelace
• All API amounts are in Lovelace

CIP Standards Supported

• CIP-2: Coin Selection Algorithms
• CIP-14: Asset Fingerprints
• CIP-25: NFT Metadata Standard
• CIP-68: Datum-based Token Metadata
• CIP-1694: Voltaire Governance

Networks

Error Handling

Common errors and solutions:

Security Best Practices

1. Never expose mnemonics - Use environment variables
2. Use read-only mode for monitoring-only workflows
3. Encrypt credentials - Use n8n's built-in encryption
4. Test on testnet first - Use Preprod or Preview networks

Development

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Run linting
npm run lint

# Fix linting issues
npm run lint:fix

Author

Velocity BPA

• Website: velobpa.com
• GitHub: Velocity-BPA

Licensing

This n8n community node is licensed under the Business Source License 1.1.

Free Use

Permitted for personal, educational, research, and internal business use.

Commercial Use

Use of this node within any SaaS, PaaS, hosted platform, managed service,
or paid automation offering requires a commercial license.

For licensing inquiries:
licensing@velobpa.com

See LICENSE, COMMERCIAL_LICENSE.md, and LICENSING_FAQ.md for details.

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Run linting and tests (npm run lint && npm test)
5. Commit your changes (git commit -m 'Add amazing feature')
6. Push to the branch (git push origin feature/amazing-feature)
7. Open a Pull Request

Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: licensing@velobpa.com

Acknowledgments

• Blockfrost for their excellent Cardano API
• Koios for free API access
• n8n for the workflow automation platform
• Cardano Foundation for blockchain infrastructure
• IOG for Cardano development