n8n-nodes-eigenlayer

[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 EigenLayer's restaking protocol, offering 6 core resources for managing decentralized validation infrastructure. Access restaking operations, delegation management, EigenPod controls, operator registration, AVS registration, and rewards tracking through automated workflows.

Features

• Complete Restaking Management - Stake, unstake, and manage ETH restaking positions across multiple strategies
• Delegation Operations - Automate delegation to operators and manage delegation relationships
• EigenPod Controls - Monitor and manage EigenPod lifecycle, validator proofs, and withdrawals
• Operator Registration - Register and update operator metadata, manage operator stakes and commissions
• AVS Integration - Register with Actively Validated Services and manage service-specific configurations
• Rewards Tracking - Monitor and claim rewards from restaking activities across all supported strategies
• Real-time Monitoring - Track staking positions, delegation status, and reward accumulation
• Multi-Strategy Support - Work with liquid staking tokens and native ETH restaking strategies

Installation

Community Nodes (Recommended)

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

Manual Installation

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

Development Installation

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

Credentials Setup

| Field | Description | Required | |-------|-------------|----------| | API Key | EigenLayer API key for authentication | Yes | | Environment | Target environment (mainnet/testnet) | Yes | | Wallet Address | Ethereum wallet address for operations | Yes |

Resources & Operations

1. Restaking

| Operation | Description | |-----------|-------------| | Stake | Deposit ETH or LSTs into EigenLayer restaking strategies | | Unstake | Initiate unstaking process from restaking positions | | Get Position | Retrieve current restaking position details and balances | | List Strategies | Get available restaking strategies and their parameters | | Queue Withdrawal | Queue assets for withdrawal with delay period | | Complete Withdrawal | Complete queued withdrawals after delay period |

2. Delegation

| Operation | Description | |-----------|-------------| | Delegate | Delegate restaked assets to a specific operator | | Undelegate | Remove delegation from an operator | | Get Delegation | Retrieve current delegation status and operator details | | List Operators | Get available operators with their metadata and performance | | Update Delegation | Modify existing delegation parameters | | Get Delegation History | Retrieve historical delegation changes |

3. EigenPods

| Operation | Description | |-----------|-------------| | Create Pod | Deploy a new EigenPod for native ETH restaking | | Verify Credentials | Submit validator credentials for EigenPod verification | | Prove Withdrawal | Submit withdrawal proofs for validator exits | | Get Pod Status | Retrieve EigenPod status and associated validators | | Update Pod | Update EigenPod configuration and settings | | Withdraw from Pod | Process withdrawals from EigenPod balance |

4. OperatorRegistration

| Operation | Description | |-----------|-------------| | Register Operator | Register as an operator on EigenLayer | | Update Metadata | Update operator metadata and configuration | | Set Commission | Configure operator commission rates | | Get Operator Info | Retrieve operator details and statistics | | Deregister | Remove operator registration | | Update Socket | Update operator communication endpoints |

5. AVSRegistration

| Operation | Description | |-----------|-------------| | Register with AVS | Register operator with Actively Validated Services | | Deregister from AVS | Remove registration from specific AVS | | Get AVS List | Retrieve available AVS and their requirements | | Update AVS Config | Modify AVS-specific configuration | | Get Registration Status | Check current AVS registration status | | Submit AVS Proof | Submit required proofs for AVS participation |

6. Rewards

| Operation | Description | |-----------|-------------| | Get Rewards | Retrieve current reward balances across strategies | | Claim Rewards | Claim accumulated rewards from restaking activities | | Get Reward History | Retrieve historical reward distribution data | | Calculate Projected | Estimate future rewards based on current positions | | Get APY Data | Retrieve current and historical APY for strategies | | Track Performance | Monitor reward performance across time periods |

Usage Examples

// Stake ETH in a restaking strategy
{
  "operation": "stake",
  "strategy": "stETH",
  "amount": "32",
  "recipient": "0x742d35Cc6634C0532925a3b8D62115CdEFE13891"
}

// Delegate restaked assets to an operator
{
  "operation": "delegate",
  "operator": "0x1234567890abcdef1234567890abcdef12345678",
  "amount": "100",
  "strategy": "cbETH"
}

// Create and configure an EigenPod
{
  "operation": "createPod",
  "withdrawalCredentials": "0x010000000000000000000000742d35Cc6634C0532925a3b8D62115CdEFE13891",
  "podOwner": "0x742d35Cc6634C0532925a3b8D62115CdEFE13891"
}

// Claim accumulated rewards
{
  "operation": "claimRewards",
  "strategies": ["stETH", "rETH", "cbETH"],
  "recipient": "0x742d35Cc6634C0532925a3b8D62115CdEFE13891"
}

Error Handling

| Error | Description | Solution | |-------|-------------|----------| | Invalid API Key | Authentication failed with provided credentials | Verify API key and environment settings | | Insufficient Balance | Not enough tokens for requested operation | Check wallet balance and allowances | | Invalid Strategy | Specified restaking strategy not found | Use List Strategies operation to get valid options | | Delegation Not Found | No active delegation found for operator | Verify operator address and delegation status | | Pod Not Deployed | EigenPod not found for specified address | Create EigenPod before performing pod operations | | Withdrawal Delay | Withdrawal still in queue period | Wait for delay period completion before claiming |

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
• EigenLayer Documentation: docs.eigenlayer.xyz
• EigenLayer Community: Discord