n8n-nodes-sky

[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 Sky Protocol (formerly MakerDAO) providing 21 resources and 100+ operations for DeFi automation including USDS/sUSDS/SKY tokens, CDP vaults, PSM swaps, governance, liquidations, and protocol analytics.

Features

• USDS Operations: Balance, transfer, approve, and manage Sky Dollar stablecoin
• sUSDS Savings: Deposit, withdraw, and earn yield with Savings USDS (ERC-4626)
• SKY Token: Governance token operations and MKR migration
• Vault Management: Open, manage, and monitor CDP vaults
• Collateral Types: Query and analyze 15+ collateral types (ETH, WBTC, wstETH, etc.)
• Liquidations: Monitor at-risk vaults and auction activity
• PSM: Peg Stability Module for stablecoin swaps
• Governance: Vote tracking, spell monitoring, and delegation
• Oracles: Real-time price feeds with OSM and Median oracles
• Migration: Seamless DAI→USDS and MKR→SKY migration
• Flash Mints: Uncollateralized USDS loans
• Analytics: Protocol TVL, stats, and historical data via subgraph
• Multi-Network: Ethereum Mainnet, Base, and Sepolia testnet support
• Trigger Node: Real-time event monitoring for transfers, deposits, liquidations

Installation

Community Nodes (Recommended)

1. Open n8n Settings → Community Nodes
2. Click "Install a community node"
3. Enter: n8n-nodes-sky
4. Click Install

Manual Installation

# Navigate to your n8n installation
cd ~/.n8n

# Install the package
npm install n8n-nodes-sky

# Restart n8n

Development Installation

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

# Install dependencies
npm install

# Build the project
npm run build

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

# Restart n8n
n8n start

Credentials Setup

Sky Network Credentials

Sky API Credentials (Optional)

Resources & Operations

USDS (Sky Dollar)

sUSDS (Savings USDS)

SKY Token

Vault

Collateral

Oracle

PSM (Peg Stability Module)

Governance

Migration

System

Subgraph

Utility

Trigger Node

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

Usage Examples

Check USDS Balance

{
  "nodes": [
    {
      "name": "Sky",
      "type": "n8n-nodes-sky.sky",
      "parameters": {
        "resource": "usds",
        "operation": "getBalance",
        "address": "0x..."
      }
    }
  ]
}

Deposit to sUSDS

{
  "nodes": [
    {
      "name": "Sky",
      "type": "n8n-nodes-sky.sky",
      "parameters": {
        "resource": "susds",
        "operation": "deposit",
        "amount": "1000"
      }
    }
  ]
}

Monitor Vault Health

{
  "nodes": [
    {
      "name": "Sky",
      "type": "n8n-nodes-sky.sky",
      "parameters": {
        "resource": "vault",
        "operation": "getHealth",
        "vaultId": 12345
      }
    }
  ]
}

Migrate DAI to USDS

{
  "nodes": [
    {
      "name": "Sky",
      "type": "n8n-nodes-sky.sky",
      "parameters": {
        "resource": "migration",
        "operation": "daiToUsds",
        "amount": "1000"
      }
    }
  ]
}

Sky Protocol Concepts

Networks

Error Handling

The node includes comprehensive error handling:

• Network Errors: Automatic retry with exponential backoff
• Invalid Addresses: Validation before transactions
• Insufficient Balance: Pre-flight checks
• Vault Not Found: Graceful error messages
• Oracle Errors: Fallback price sources
• Gas Estimation: Automatic gas limit calculation

Use "Continue on Fail" to process errors gracefully in workflows.

Security Best Practices

1. Private Keys: Store in n8n credentials, never in workflows
2. RPC Endpoints: Use authenticated endpoints for production
3. Vault Operations: Always check health before modifying
4. Large Transactions: Test on Sepolia first
5. Approvals: Use exact amounts, not unlimited
6. Monitoring: Set up alerts for liquidation risk

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Lint
npm run lint

# Fix lint 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

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Ensure all tests pass
6. Submit a pull request

Please read our contributing guidelines before submitting PRs.

Support

• 📖 Documentation
• 🐛 Issue Tracker
• 💬 Discord Community
• 📧 Email Support

Acknowledgments

• Sky Ecosystem - Protocol documentation and support
• MakerDAO - Original protocol creators
• n8n - Workflow automation platform
• The Graph - Subgraph indexing