n8n-nodes-privy

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

A comprehensive n8n community node for Privy, the leading wallet-as-a-service platform powering embedded wallets for 75M+ accounts. Privy provides self-custodial wallet infrastructure with MPC key management, enabling applications to create and manage wallets for their users.

Features

• User Management: Create, retrieve, update, and delete Privy users with full metadata support
• Embedded Wallets: Create and manage self-custodial wallets for both EVM chains and Solana
• Server Wallets: Backend-controlled wallets for automated operations with policy controls
• Delegated Wallets: Execute transactions on behalf of users with proper delegation
• Multi-Chain Support: Ethereum, Polygon, Arbitrum, Optimism, Base, Avalanche, BSC, and Solana
• Session Management: Create, verify, and manage user authentication sessions
• Webhook Support: Real-time event notifications with signature verification
• OAuth Integration: Support for Google, Twitter, Discord, GitHub, and Apple OAuth

Installation

Community Nodes (Recommended)

1. Open your n8n instance
2. Go to Settings > Community Nodes
3. Click Install a community node
4. Enter n8n-nodes-privy
5. Click Install

Manual Installation

# Navigate to your n8n custom extensions folder
cd ~/.n8n/custom

# Clone or download this package
npm install n8n-nodes-privy

# Restart n8n

Development Installation

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

# Install dependencies
npm install

# Build the project
npm run build

# Link to n8n
npm link
cd ~/.n8n/custom
npm link n8n-nodes-privy

# Restart n8n

Credentials Setup

Privy API Credentials

| Field | Type | Description | |-------|------|-------------| | App ID | String | Your Privy application ID from the dashboard | | App Secret | String | Your Privy application secret key | | Environment | Options | Production or Development |

To obtain your credentials:

1. Sign up at Privy Dashboard
2. Create a new application
3. Navigate to Settings > App Secrets
4. Copy your App ID and generate an App Secret

Resources & Operations

User Resource

| Operation | Description | |-----------|-------------| | List | Get a paginated list of all users | | Get | Retrieve a user by their DID | | Get by Email | Find a user by email address | | Get by Phone | Find a user by phone number | | Get by Wallet | Find a user by wallet address | | Get by Twitter | Find a user by Twitter handle | | Get by Discord | Find a user by Discord ID | | Create | Create a new user with optional wallet | | Delete | Remove a user and associated data | | Update Metadata | Update custom user metadata |

Embedded Wallet Resource

| Operation | Description | |-----------|-------------| | List | Get all wallets for a user | | Get | Get specific wallet details | | Create Ethereum | Create an EVM wallet | | Create Solana | Create a Solana wallet | | Pregenerate | Create wallet before user signup | | Get Balance | Get wallet balance | | Get Transactions | Get transaction history |

Server Wallet Resource

| Operation | Description | |-----------|-------------| | List | List all server wallets | | Create | Create a new server wallet | | Get | Get wallet details | | Delete | Delete a server wallet | | Sign Message | Sign an arbitrary message | | Sign Transaction | Sign a transaction | | Send Transaction | Sign and broadcast transaction | | Get Policy | Get wallet policy rules | | Update Policy | Update policy rules |

Delegated Wallet Resource

| Operation | Description | |-----------|-------------| | List | List delegated wallets | | Get | Get delegated wallet details | | Sign Message | Sign on behalf of user | | Sign Transaction | Sign tx on behalf of user | | Send Transaction | Execute on behalf of user | | Sign Typed Data | EIP-712 typed data signing |

Session Resource

| Operation | Description | |-----------|-------------| | Create | Generate a user session token | | Verify | Validate a session token | | Revoke | Invalidate a session | | Get Active | List active sessions | | Revoke All | Logout everywhere |

Authentication Resource

| Operation | Description | |-----------|-------------| | Verify Email OTP | Validate email verification code | | Verify SMS OTP | Validate phone verification code | | Verify Custom JWT | Validate external JWT token | | Get User by Token | Decode access token |

Linked Account Resource

| Operation | Description | |-----------|-------------| | List | Get all linked auth methods | | Link Email | Add email to user | | Link Phone | Add phone to user | | Link Wallet | Link external wallet | | Unlink | Remove auth method | | Set Primary | Set default auth |

Custom Auth Resource

| Operation | Description | |-----------|-------------| | Create Session | External provider login | | Get Config | Get provider settings | | Update Config | Modify provider config |

Webhook Resource

| Operation | Description | |-----------|-------------| | List | List registered webhooks | | Create | Register new webhook | | Get | Get webhook details | | Update | Modify webhook config | | Delete | Remove webhook | | Get Deliveries | View delivery history | | Retry Delivery | Resend failed webhook |

App Configuration Resource

| Operation | Description | |-----------|-------------| | Get Settings | Get app configuration | | Update Settings | Modify configuration | | Get Login Methods | Get enabled auth methods | | Update Login Methods | Enable/disable methods | | Get Wallet Config | Get wallet settings | | Update Wallet Config | Modify wallet settings |

Trigger Node

The Privy Trigger node allows you to receive webhook events:

| Event | Description | |-------|-------------| | user.created | New user signup | | user.updated | User profile changed | | user.deleted | User account removed | | wallet.created | New wallet created | | wallet.updated | Wallet settings changed | | linked_account.created | New auth method added | | linked_account.deleted | Auth method removed | | session.created | User logged in | | session.revoked | Session ended |

Usage Examples

User Onboarding with Wallet Creation

// Create a new user with an Ethereum wallet
{
  "resource": "user",
  "operation": "create",
  "email": "[email protected]",
  "createWallet": true,
  "walletChainType": "ethereum"
}

Server-Side Transaction for Trading Bot

// Sign and send a transaction from server wallet
{
  "resource": "serverWallet",
  "operation": "sendTransaction",
  "walletId": "wallet-id",
  "to": "0x742d35Cc6634C0532925a3b844Bc9e7595f3bD12",
  "value": "1000000000000000000",
  "data": "0x",
  "chain": "ethereum"
}

Airdrop Distribution

// Get user's wallet and send tokens
{
  "resource": "embeddedWallet",
  "operation": "list",
  "userId": "did:privy:xxxxx"
}

Gaming Reward Distribution

// Delegated transaction for in-game rewards
{
  "resource": "delegatedWallet",
  "operation": "sendTransaction",
  "walletAddress": "0x...",
  "to": "0x...",
  "value": "0",
  "data": "0xa9059cbb..." // ERC20 transfer
}

Privy Concepts

| Concept | Description | |---------|-------------| | DID | Decentralized Identifier (did:privy:xxxxx) - unique user ID | | Embedded Wallet | Self-custodial wallet managed via Privy MPC | | Server Wallet | Backend-controlled wallet for automated operations | | Delegated Wallet | User wallet with server execution rights | | MPC | Multi-Party Computation for key management | | TEE | Trusted Execution Environment for secure key operations | | Linked Account | Connected authentication method (email, OAuth, etc.) |

Supported Networks

EVM Chains

| Chain | Chain ID | Type | |-------|----------|------| | Ethereum | 1 | Mainnet | | Polygon | 137 | Mainnet | | Arbitrum | 42161 | Mainnet | | Optimism | 10 | Mainnet | | Base | 8453 | Mainnet | | Avalanche | 43114 | Mainnet | | BSC | 56 | Mainnet |

Solana

| Network | Description | |---------|-------------| | mainnet-beta | Production network | | devnet | Development network |

Error Handling

The node provides detailed error messages for common issues:

• Invalid Credentials: Check your App ID and App Secret
• User Not Found: Verify the DID or lookup identifier
• Wallet Not Found: Ensure the wallet address is correct
• Insufficient Funds: Check wallet balance before transactions
• Invalid Chain: Verify the chain is supported
• Policy Violation: Review server wallet policy rules

Security Best Practices

1. Never expose credentials in workflows or logs
2. Use webhook signatures to verify incoming events
3. Implement rate limiting for high-volume operations
4. Monitor transactions using the webhook trigger
5. Use server wallets for automated backend operations
6. Implement proper delegation for user wallet actions

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode for development
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

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 your code:

1. Follows the existing code style
2. Includes appropriate tests
3. Updates documentation as needed
4. Maintains BSL 1.1 license compliance

Support

• Documentation: Privy Docs
• Issues: GitHub Issues
• Licensing: [email protected]

Acknowledgments

• Privy for their excellent wallet-as-a-service platform
• n8n for the powerful workflow automation platform
• The n8n community for their continuous support and feedback