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 [email protected].

An n8n community node for SingularityNET integration, providing access to 5 core resources for decentralized AI service management. Access AI services, manage organizations and payment channels, track blockchain transactions, and interact with the service registry through n8n workflows.

Features

• AI Service Integration - Call and manage decentralized AI services on the SingularityNET platform
• Organization Management - Create, update, and manage AI service organizations
• Payment Channel Operations - Handle micropayments and channel management for service usage
• Transaction Tracking - Monitor blockchain transactions and payment flows
• Registry Access - Search and discover available AI services in the network
• Blockchain Integration - Native support for Ethereum-based operations
• Decentralized Architecture - Connect to the distributed AI marketplace
• Real-time Monitoring - Track service performance and usage metrics

Installation

Community Nodes (Recommended)

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

Manual Installation

cd ~/.n8n
npm install n8n-nodes-singularitynet

Development Installation

git clone https://github.com/Velocity-BPA/n8n-nodes-singularitynet.git
cd n8n-nodes-singularitynet
npm install
npm run build
mkdir -p ~/.n8n/custom
ln -s $(pwd) ~/.n8n/custom/n8n-nodes-singularitynet
n8n start

Credentials Setup

| Field | Description | Required | |-------|-------------|----------| | API Key | Your SingularityNET platform API key | Yes | | Network | Ethereum network (mainnet/testnet) | Yes | | Wallet Address | Your wallet address for transactions | Yes |

Resources & Operations

1. AIService

| Operation | Description | |-----------|-------------| | Get | Retrieve AI service details and metadata | | Call | Execute an AI service with input parameters | | List | Get available AI services from organizations | | Get Pricing | Retrieve service pricing and payment information | | Get Metadata | Fetch service metadata and configuration |

2. Organization

| Operation | Description | |-----------|-------------| | Create | Create a new AI service organization | | Get | Retrieve organization details and information | | Update | Modify organization settings and metadata | | List | Get all organizations in the network | | Delete | Remove an organization from the platform | | Get Members | Retrieve organization member list |

3. Channel

| Operation | Description | |-----------|-------------| | Open | Open a new payment channel for services | | Close | Close an existing payment channel | | Extend | Extend payment channel expiration | | Get Balance | Check current channel balance | | Fund | Add funds to an existing channel | | List | Get all channels for an organization |

4. Transaction

| Operation | Description | |-----------|-------------| | Get | Retrieve transaction details by hash | | List | Get transaction history for an account | | Create | Create a new blockchain transaction | | Get Status | Check transaction confirmation status | | Get Receipt | Retrieve transaction receipt and logs |

5. Registry

| Operation | Description | |-----------|-------------| | Search Services | Search for AI services by criteria | | Get Service | Retrieve specific service from registry | | List Organizations | Get all registered organizations | | Get Tags | Retrieve available service tags | | Filter by Category | Find services by category or type |

Usage Examples

// Call an AI service for image classification
{
  "service_id": "image-classifier-v2",
  "organization_id": "example-ai-org",
  "method": "classify",
  "input": {
    "image_url": "https://example.com/image.jpg",
    "max_results": 5
  }
}

// Open a payment channel for service usage
{
  "organization_id": "example-ai-org",
  "service_group_id": "default-group",
  "amount": "1000000000", // Amount in AGI tokens (wei)
  "expiration": "2024-12-31T23:59:59Z"
}

// Search for AI services in the registry
{
  "query": "natural language processing",
  "tags": ["nlp", "text-analysis"],
  "category": "language",
  "max_results": 10
}

// Get organization details and services
{
  "organization_id": "example-ai-org",
  "include_services": true,
  "include_members": true
}

Error Handling

| Error | Description | Solution | |-------|-------------|----------| | Invalid API Key | Authentication failed with provided credentials | Verify API key is correct and active | | Insufficient Funds | Not enough AGI tokens for service call | Add funds to wallet or payment channel | | Service Unavailable | AI service is temporarily offline | Retry later or use alternative service | | Channel Expired | Payment channel has expired | Open new channel or extend existing one | | Network Error | Blockchain network connection issues | Check network status and retry | | Invalid Parameters | Service call parameters are malformed | Review service documentation and fix parameters |

Development

npm install
npm run build
npm test
npm run lint
npm run dev

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: [email protected]

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

Contributing

Contributions are welcome! Please ensure:

1. Code follows existing style conventions
2. All tests pass (npm test)
3. Linting passes (npm run lint)
4. Documentation is updated for new features
5. Commit messages are descriptive

Support

• Issues: GitHub Issues
• SingularityNET Documentation: dev.singularitynet.io
• Platform Portal: beta.singularitynet.io