n8n-nodes-bitgo

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

This n8n community node provides comprehensive integration with BitGo's enterprise cryptocurrency platform, featuring 6 core resources for digital asset management. It enables secure wallet operations, address management, transaction monitoring, fund transfers, key management, and webhook configuration for institutional-grade cryptocurrency workflows.

Features

• Multi-Signature Wallet Management - Create, configure, and manage enterprise-grade multi-signature wallets across multiple cryptocurrencies
• Secure Address Generation - Generate and validate cryptocurrency addresses with comprehensive metadata and balance tracking
• Transaction Monitoring - Real-time transaction tracking, verification, and detailed transaction history analysis
• Automated Fund Transfers - Execute secure transfers with multi-signature approval workflows and compliance controls
• Advanced Key Management - Enterprise key generation, rotation, and secure storage with hierarchical deterministic support
• Real-Time Webhook Integration - Configure and manage webhooks for transaction notifications, wallet events, and security alerts
• Multi-Currency Support - Native support for Bitcoin, Ethereum, and 100+ other cryptocurrencies and tokens
• Compliance & Auditing - Built-in compliance features with detailed audit trails and regulatory reporting capabilities

Installation

Community Nodes (Recommended)

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

Manual Installation

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

Development Installation

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

Credentials Setup

| Field | Description | Required | |-------|-------------|----------| | API Key | Your BitGo API access key from the developer console | ✓ | | Environment | Choose between 'test' (testnet) or 'prod' (mainnet) | ✓ | | Base URL | BitGo API endpoint (auto-configured based on environment) | ✓ | | Passphrase | Wallet passphrase for transaction signing operations | ✗ |

Resources & Operations

1. Wallet

| Operation | Description | |-----------|-------------| | Create | Generate new multi-signature wallets with customizable security parameters | | Get | Retrieve detailed wallet information including balances and configuration | | List | Fetch all wallets associated with your account with filtering options | | Update | Modify wallet settings, labels, and security configurations | | Get Balance | Check current balance and pending transactions for specific wallets | | Get Transactions | Retrieve transaction history with advanced filtering and pagination |

2. Address

| Operation | Description | |-----------|-------------| | Create | Generate new receiving addresses for wallets with optional labels | | Get | Retrieve address details including balance and transaction history | | List | Fetch all addresses for a wallet with filtering and search capabilities | | Validate | Verify address format and network compatibility | | Get Balance | Check balance for specific addresses across multiple confirmations | | Get Transactions | View all transactions associated with specific addresses |

3. Transaction

| Operation | Description | |-----------|-------------| | Get | Retrieve detailed transaction information including confirmations and fees | | List | Query transactions with advanced filtering by date, amount, and status | | Get by Hash | Fetch transaction details using blockchain transaction hash | | Verify | Validate transaction signatures and confirm blockchain inclusion | | Get Confirmations | Check current confirmation count and estimated completion time | | Get Fee Estimate | Calculate optimal transaction fees for different priority levels |

4. Transfer

| Operation | Description | |-----------|-------------| | Create | Initiate new cryptocurrency transfers with multi-signature requirements | | Send | Execute pre-approved transfers with final signature authorization | | Get | Retrieve transfer status and detailed execution information | | List | View transfer history with comprehensive filtering and status tracking | | Cancel | Cancel pending transfers before final signature completion | | Approve | Provide additional signatures for multi-signature transfer approval |

5. Key

| Operation | Description | |-----------|-------------| | Create | Generate new cryptographic keys with secure entropy sources | | Get | Retrieve public key information and associated metadata | | List | View all keys associated with your account and their usage status | | Backup | Export key backup information for disaster recovery purposes | | Derive | Generate child keys using hierarchical deterministic derivation | | Verify | Validate key integrity and cryptographic properties |

6. Webhook

| Operation | Description | |-----------|-------------| | Create | Set up new webhook endpoints for real-time event notifications | | Get | Retrieve webhook configuration and delivery status information | | List | View all configured webhooks with filtering and status monitoring | | Update | Modify webhook URLs, events, and configuration parameters | | Delete | Remove webhook subscriptions and clean up endpoint configurations | | Test | Send test notifications to verify webhook endpoint functionality |

Usage Examples

// Create a new Bitcoin wallet
{
  "coin": "btc",
  "label": "Corporate Treasury Wallet",
  "passphrase": "secure-passphrase-123",
  "userKey": "xpub6C...",
  "backupKey": "xpub6D...",
  "enterprise": "enterprise-id-123"
}

// Execute a Bitcoin transfer
{
  "walletId": "wallet-abc123",
  "amount": 50000000,
  "address": "3P14159f73E4gFr7JterCCQh9QjiTjiZrG",
  "walletPassphrase": "secure-passphrase-123",
  "comment": "Payment to supplier XYZ"
}

// Set up transaction webhook
{
  "type": "transfer",
  "url": "https://your-app.com/webhooks/bitgo",
  "coin": "btc",
  "walletId": "wallet-abc123",
  "numConfirmations": 3,
  "label": "Transaction Notifications"
}

// Get wallet transaction history
{
  "walletId": "wallet-abc123",
  "limit": 50,
  "skip": 0,
  "minValue": 1000000,
  "dateGte": "2024-01-01T00:00:00Z"
}

Error Handling

| Error | Description | Solution | |-------|-------------|----------| | Invalid API Key | Authentication failed with provided credentials | Verify API key is correct and has proper permissions | | Insufficient Balance | Wallet balance too low for requested transfer amount | Check wallet balance and reduce transfer amount or add funds | | Invalid Address | Cryptocurrency address format is incorrect or unsupported | Validate address format matches the target cryptocurrency network | | Signature Required | Multi-signature transaction requires additional approvals | Obtain required signatures from authorized wallet participants | | Rate Limited | API request frequency exceeds allowed limits | Implement request throttling and retry with exponential backoff | | Webhook Timeout | Webhook endpoint failed to respond within timeout period | Verify webhook URL accessibility and implement proper response handling |

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
• BitGo API Documentation: BitGo Developer Portal
• BitGo Support: BitGo Help Center