[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 SecuX hardware wallet integration providing 26 resources and 150+ operations for multi-chain cryptocurrency management, transaction signing, NFT handling, and device management.

• Multi-Chain Support: Bitcoin, Ethereum, Solana, XRP, Cardano, Cosmos, Stellar, Tron, Terra, and EVM-compatible chains
• Transaction Signing: Secure transaction signing with on-device verification
• NFT Management: ERC-721 and ERC-1155 token operations
• Token Operations: ERC-20, BEP-20, and SPL token transfers and approvals
• Device Management: Connection, PIN, security, backup, and firmware operations
• SecuXess Integration: Portfolio tracking and market data integration
• Multiple Connection Types: USB HID, WebUSB, and Bluetooth support
• Trigger Node: Event-based automation for device and transaction events

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

# Navigate to your n8n installation
cd ~/.n8n

# Install the node
npm install n8n-nodes-secux

# Restart n8n

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

# Install dependencies
npm install

# Build the project
npm run build

# Link for local development
mkdir -p ~/.n8n/custom
ln -s $(pwd) ~/.n8n/custom/n8n-nodes-secux

# Restart n8n

• Device: Get info, get version, check status, list connected, disconnect
• PIN: Get status, verify, change, lock, unlock, get attempts
• Security: Verify device, get SE info, factory reset, wipe device, get tamper status, get security log
• Backup: Get status, verify recovery words, check integrity, get seed length
• Firmware: Get version, check updates, get update history, get changelog

• Get address, sign transaction, get balance, sign PSBT, get UTXO, verify address

• Get address, sign transaction, sign message, get balance, sign typed data, get nonce

• Get address, sign transaction, get balance, sign message

• Get address, sign transaction, get balance, get account info

• Get address, sign transaction, get balance

• Get address, sign transaction, get balance

• Get address, sign transaction, get balance

• Get address, sign transaction, get balance

• Get address, sign transaction, get balance

• Multi-Chain: Get all addresses, get portfolio balance, get transaction history
• EVM Chains: BSC, Polygon, Avalanche, Arbitrum, Optimism operations
• Bitcoin-Like: Litecoin, Dogecoin, Bitcoin Cash operations

• Token: Get balance, sign transfer, sign approval, get allowance, get token info
• NFT: Get NFTs, sign transfer, display on device, get collections, get metadata

• Transaction: Create, sign, broadcast, get status, estimate fee, decode
• Signing: Sign transaction, sign message, sign typed data, sign PSBT, batch sign, verify signature

• Get address, display on device, verify, get multiple, get public key

• SecuXess: Connect, get portfolio, get transactions, sync, get market data, get accounts

• Get supported coins, validate address, test connection, get SDK version, convert units, generate QR code
• Bluetooth: Scan devices, connect, disconnect, get paired devices

The SecuX Trigger node enables event-based automation with the following events:

• Chain Filter: Filter events by specific blockchain
• Battery Threshold: Set minimum battery level for alerts
• Minimum Amount: Set minimum amount for transaction events
• Address Filter: Filter by specific wallet address
• Poll Interval: Set polling frequency (default: 60 seconds)

{
  "nodes": [
    {
      "name": "SecuX",
      "type": "n8n-nodes-secux.secuX",
      "parameters": {
        "resource": "bitcoin",
        "operation": "getAddress",
        "addressType": "nativeSegwit",
        "accountIndex": 0,
        "displayOnDevice": true
      }
    }
  ]
}

{
  "nodes": [
    {
      "name": "SecuX",
      "type": "n8n-nodes-secux.secuX",
      "parameters": {
        "resource": "ethereum",
        "operation": "signTransaction",
        "to": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE2",
        "value": "0.1",
        "chainId": 1
      }
    }
  ]
}

{
  "nodes": [
    {
      "name": "SecuX Trigger",
      "type": "n8n-nodes-secux.secuXTrigger",
      "parameters": {
        "eventType": "balanceChanged",
        "chainFilter": "ethereum",
        "minimumAmount": "0.01"
      }
    }
  ]
}

The node supports standard BIP-44 derivation paths:

• Secure Element: All private keys stored in certified secure element
• On-Device Verification: Transaction details displayed on device screen
• PIN Protection: Customizable PIN with attempt limits
• Tamper Detection: Hardware tamper detection and response

The node implements comprehensive error handling:

{
  "success": false,
  "error": {
    "code": "DEVICE_NOT_CONNECTED",
    "message": "No SecuX device connected",
    "details": {}
  }
}

1. Always verify transactions on device screen before approving
2. Use strong PIN with maximum allowed length
3. Keep firmware updated for latest security patches
4. Secure your recovery phrase offline and never share it
5. Enable auto-lock to protect unattended devices
6. Use testnet for development and testing
7. Implement proper error handling in workflows

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Run linting
npm run lint

# Fix linting issues
npm run lint:fix

# Watch mode for development
npm run dev

n8n-nodes-secux/
├── credentials/
│   ├── SecuXDevice.credentials.ts
│   ├── SecuXess.credentials.ts
│   └── SecuXNetwork.credentials.ts
├── nodes/
│   └── SecuX/
│       ├── SecuX.node.ts
│       ├── SecuXTrigger.node.ts
│       ├── actions/
│       ├── constants/
│       ├── transport/
│       └── utils/
├── test/
│   ├── unit/
│   └── integration/
└── scripts/

Velocity BPA

• Website: velobpa.com
• GitHub: Velocity-BPA

This n8n community node is licensed under the Business Source License 1.1.

Permitted for personal, educational, research, and internal business 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.

1. Fork the repository
2. Create a feature branch: git checkout -b feature/my-feature
3. Commit changes: git commit -am 'Add my feature'
4. Push to branch: git push origin feature/my-feature
5. Submit a pull request

Please ensure your code:

• Passes all tests (npm test)
• Follows the linting rules (npm run lint)
• Includes appropriate documentation
• Respects the BSL 1.1 license terms

• Documentation: GitHub Wiki
• Issues: GitHub Issues
• SecuX Documentation: SecuX Official
• n8n Documentation: n8n Docs

• SecuX for their hardware wallet technology
• n8n for the workflow automation platform
• The open-source cryptocurrency development community