n8n-nodes-singularitynet

[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 the SingularityNET decentralized AI marketplace. Access and automate AI services, manage payment channels, stake AGIX tokens, and interact with the entire SingularityNET ecosystem directly from your n8n workflows.

Features

• 100+ Operations across 16 resource categories
• Multi-Chain Support for Ethereum and Cardano networks
• Real-Time Triggers for blockchain event monitoring
• AI Service Invocation with payment channel management
• Full Marketplace Access to browse, discover, and use AI services

Installation

Community Nodes (Recommended)

1. Open n8n
2. Go to Settings → Community Nodes
3. Click Install
4. Enter n8n-nodes-singularitynet
5. Click Install

Manual Installation

# Navigate to your n8n installation
cd ~/.n8n

# Install the package
npm install n8n-nodes-singularitynet

# Restart n8n

Development Installation

# 1. Extract the zip file
unzip n8n-nodes-singularitynet.zip
cd n8n-nodes-singularitynet

# 2. Install dependencies
npm install

# 3. Build the project
npm run build

# 4. Create symlink to n8n custom nodes directory
# For Linux/macOS:
mkdir -p ~/.n8n/custom
ln -s $(pwd) ~/.n8n/custom/n8n-nodes-singularitynet

# For Windows (run as Administrator):
# mklink /D %USERPROFILE%\.n8n\custom\n8n-nodes-singularitynet %CD%

# 5. Restart n8n
# If running n8n locally:
n8n start

# If running n8n via Docker, restart the container:
# docker restart n8n

Credentials Setup

SingularityNET Network Credentials

SingularityNET Platform Credentials

AI Service Credentials

Resources & Operations

Trigger Node

The SingularityNET Trigger node monitors blockchain events in real-time:

• Account Events: Balance changes, deposits, withdrawals
• Payment Channel Events: Open, fund, extend, claim
• Service Events: Updates, ratings, new services
• Staking Events: Stake added, rewards available
• Organization Events: Created, updated, member changes

Usage Examples

Browse Featured AI Services

{
  "resource": "marketplace",
  "operation": "getFeaturedServices"
}

Check AGIX Balance

{
  "resource": "account",
  "operation": "getAgixBalance",
  "address": "0x..."
}

Open Payment Channel

{
  "resource": "paymentChannel",
  "operation": "openChannel",
  "recipientAddress": "0x...",
  "groupId": "default_group",
  "amount": 10,
  "expiration": 11520
}

Search Services

{
  "resource": "service",
  "operation": "searchServices",
  "query": "image recognition"
}

SingularityNET Concepts

AGIX Token

The native utility token of SingularityNET. Used for paying for AI services, staking for rewards, and governance voting.

Cogs

Smallest unit of AGIX: 1 AGIX = 10^8 cogs

Multi-Party Escrow (MPE)

Smart contract system enabling trustless payments:

• Users deposit AGIX to escrow
• Open payment channels with service providers
• Pay per service call via signed messages
• Claim unused funds after channel expiration

Payment Channels

Pre-funded accounts for AI service calls:

• Open channel with initial deposit
• Make multiple calls without on-chain transactions
• Extend expiration as needed
• Claim timeout to recover unused funds

ASI Token

The merged token (AGIX + FET + OCEAN) of the Artificial Superintelligence Alliance.

Networks

Contract Addresses

Ethereum Mainnet:

• AGIX Token: 0x5B7533812759B45C2B44C19e320ba2cD2681b542
• MPE Contract: 0x5e592F9b1d303183d963635f895f0f0C48284f4e
• Registry: 0xb3180fEB962c597De6521a7D88c4d58d41E68aDf

Ethereum Sepolia:

• AGIX Token: 0xdA80c3B9A7C7E2cB42151BbFc94aa9A54F0a9bfe
• MPE Contract: 0x7E6366fBe3bDfa0a0F282Fab9cC2B1Ca7c90b55a
• Registry: 0x663422c6999ff94933dbcb388623952cf2407f6f

Error Handling

The node includes comprehensive error handling for:

• Network connectivity issues
• Insufficient balance errors
• Channel expiration errors
• Invalid address formats
• Transaction failures

Security Best Practices

1. Never share private keys - Use environment variables or n8n credentials
2. Test on Sepolia first - Verify workflows before mainnet
3. Monitor channel expiration - Reclaim funds before expiry
4. Verify service endpoints - Ensure services are authentic
5. Use appropriate gas limits - Avoid transaction failures

Development

Building

# Development build
npm run build

# Watch mode
npm run dev

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Lint code
npm run lint

# Fix linting issues
npm run lint:fix

Testing the Node

# Run unit tests
npm test

# Run tests with coverage
npm run test:coverage

# Run linting
npm run lint

# Fix linting issues
npm run lint:fix

Verify Installation in n8n

1. Open n8n in your browser (default: http://localhost:5678)
2. Create a new workflow
3. Click the "+" button to add a node
4. Search for "SingularityNET"
5. The node should appear in the list
6. Add the node and configure credentials
7. Test the node operations

Project Structure

n8n-nodes-singularitynet/
├── credentials/
│   ├── SingularitynetNetwork.credentials.ts
│   ├── SingularitynetPlatform.credentials.ts
│   └── AiService.credentials.ts
├── nodes/Singularitynet/
│   ├── Singularitynet.node.ts
│   ├── SingularitynetTrigger.node.ts
│   ├── actions/
│   │   ├── account/
│   │   ├── service/
│   │   ├── organization/
│   │   ├── invocation/
│   │   ├── paymentChannel/
│   │   ├── escrow/
│   │   ├── marketplace/
│   │   ├── staking/
│   │   ├── rfai/
│   │   ├── publisher/
│   │   ├── ipfs/
│   │   ├── bridge/
│   │   ├── governance/
│   │   ├── daemon/
│   │   ├── asi/
│   │   └── utility/
│   ├── transport/
│   │   ├── ethereumClient.ts
│   │   ├── cardanoClient.ts
│   │   ├── platformApi.ts
│   │   ├── grpcClient.ts
│   │   ├── ipfsClient.ts
│   │   └── snetSdk.ts
│   ├── constants/
│   │   ├── networks.ts
│   │   ├── contracts.ts
│   │   ├── organizations.ts
│   │   └── services.ts
│   └── utils/
│       ├── unitConverter.ts
│       ├── paymentUtils.ts
│       ├── serviceUtils.ts
│       └── protobufUtils.ts
├── test/
│   ├── unit/
│   │   ├── unitConverter.test.ts
│   │   └── ipfsClient.test.ts
│   └── integration/
│       └── platformApi.test.ts
├── scripts/
│   ├── test.sh
│   ├── build.sh
│   └── install-local.sh
├── package.json
├── tsconfig.json
├── .eslintrc.js
├── .prettierrc
├── .gitignore
├── .npmignore
├── LICENSE
├── COMMERCIAL_LICENSE.md
├── LICENSING_FAQ.md
└── README.md

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.

Change Date: January 1, 2030
Change License: Apache License, Version 2.0

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
3. Make your changes
4. Run tests and linting
5. Submit a pull request

Support

• Documentation: SingularityNET Docs
• Discord: SingularityNET Community
• GitHub Issues: Report a Bug

Acknowledgments

• SingularityNET - Decentralized AI marketplace
• n8n - Workflow automation platform
• The SingularityNET developer community