n8n-nodes-trezor 1.0.0

package/LICENSE

@@ -0,0 +1,46 @@
+Business Source License 1.1
+
+License text copyright (c) 2017 MariaDB Corporation Ab.
+
+Licensor:
+Velocity BPA, LLC
+https://velobpa.com
+
+Licensed Work:
+This repository and all source code, documentation, and associated artifacts
+contained herein, including all n8n community nodes published by Velocity BPA.
+
+Additional Use Grant:
+You may use, modify, and run the Licensed Work free of charge for:
+- Personal use
+- Educational use
+- Research use
+- Internal business use, provided such use does not involve resale,
+  redistribution, or offering the Licensed Work as part of a commercial
+  product or service.
+
+Commercial Use Restriction:
+Commercial Use of the Licensed Work is prohibited without a valid
+Commercial License issued by the Licensor.
+
+Commercial Use includes, but is not limited to:
+- Use of the Licensed Work within any Software-as-a-Service (SaaS),
+  Platform-as-a-Service (PaaS), or hosted application that is sold,
+  licensed, or monetized in any form
+- Offering the Licensed Work as part of a managed services engagement
+- Bundling or redistributing the Licensed Work with a paid product
+- Reselling, sublicensing, or white-labeling the Licensed Work
+- Embedding the Licensed Work into any commercial automation platform,
+  integration product, or solution offering
+
+Change Date:
+January 1, 2030
+
+Change License:
+Apache License, Version 2.0
+
+For commercial licensing inquiries:
+licensing@velobpa.com
+
+Business Source License 1.1 full text:
+https://mariadb.com/bsl11/

package/README.md

@@ -0,0 +1,267 @@
+# n8n-nodes-trezor
+
+> **[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.
+
+Comprehensive n8n community node for Trezor hardware wallets providing 26 resources and 200+ operations for Bitcoin, Ethereum, Cardano, Solana, and 15+ blockchain networks. Includes transaction signing, device management, CoinJoin privacy, and real-time event triggers.
+
+![n8n](https://img.shields.io/badge/n8n-community--node-orange)
+![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue)
+![License](https://img.shields.io/badge/license-BSL--1.1-blue)
+
+## Features
+
+- **26 Resource Categories** - Device management, multi-chain support, security features
+- **200+ Operations** - Comprehensive blockchain interactions
+- **20+ Blockchain Networks** - Bitcoin, Ethereum, Cardano, Solana, Ripple, Stellar, and more
+- **Hardware Security** - All signing operations happen on device
+- **Real-time Triggers** - Device connection and blockchain event monitoring
+- **CoinJoin Privacy** - Enhanced privacy for Bitcoin transactions
+- **Multi-signature Support** - Complex signing workflows
+- **WebAuthn/FIDO2** - Hardware-backed authentication
+
+## Installation
+
+### Community Nodes (Recommended)
+
+1. Open n8n Settings
+2. Go to "Community Nodes"
+3. Search for `n8n-nodes-trezor`
+4. Click Install
+
+### Manual Installation
+
+```bash
+# Navigate to your n8n installation
+cd ~/.n8n
+
+# Install the package
+npm install n8n-nodes-trezor
+```
+
+### Development Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/velocity-bpa/n8n-nodes-trezor.git
+cd n8n-nodes-trezor
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Link to n8n
+mkdir -p ~/.n8n/custom
+ln -s $(pwd) ~/.n8n/custom/n8n-nodes-trezor
+
+# Restart n8n
+```
+
+## Credentials Setup
+
+### Trezor Device API
+
+| Field | Description |
+|-------|-------------|
+| Connection Type | USB (direct) or Bridge (via Trezor Bridge) |
+| Device Path | Optional specific device path |
+| Passphrase | Optional BIP39 passphrase for hidden wallets |
+
+### Trezor Connect API
+
+| Field | Description |
+|-------|-------------|
+| Manifest Email | Contact email for Trezor Connect |
+| Manifest App URL | Your application URL |
+| Use Core Mode | Enable for headless operation |
+
+## Resources & Operations
+
+### Device Management
+- **Device**: Get features, ping, wipe, reset, recover, apply settings
+- **Firmware**: Check version, verify integrity
+- **Backup**: Create seed backup, verify backup
+- **Security**: Change PIN, enable/disable passphrase, lock device
+- **Label**: Set device label, get device state
+
+### Cryptocurrency Operations
+- **Bitcoin**: Get address, sign transaction, sign/verify message, get UTXO
+- **Bitcoin-like**: Litecoin, Dogecoin, Dash, Bitcoin Cash, Zcash, and more
+- **Ethereum**: Get address, sign transaction, sign message, sign typed data
+- **EVM Chains**: Polygon, BSC, Avalanche, Arbitrum, Optimism, Base, Fantom
+- **Cardano**: Get address/stake address, sign transaction
+- **Solana**: Get address, sign transaction
+- **Ripple (XRP)**: Get address, sign transaction
+- **Stellar (XLM)**: Get address, sign transaction
+- **Tezos (XTZ)**: Get address, sign transaction
+- **EOS**: Get public key, sign transaction
+- **Binance Chain**: Get address, sign transaction
+
+### Advanced Features
+- **Multi-currency**: Batch operations across multiple coins
+- **CoinJoin**: Privacy-enhanced Bitcoin transactions
+- **Signing**: Raw message signing, proof of ownership
+- **Passphrase**: Hidden wallet management
+- **WebAuthn**: FIDO2 credential management
+- **Suite**: Trezor Suite integration
+
+## Trigger Node
+
+The TrezorTrigger node monitors for real-time events:
+
+- **Device Events**: Connection, disconnection, button press, PIN entry
+- **Blockchain Events**: New transactions, confirmations, balance changes
+- **Security Events**: Failed PIN attempts, passphrase changes
+
+## Usage Examples
+
+### Get Bitcoin Address
+
+```javascript
+// In n8n workflow
+{
+  "resource": "bitcoin",
+  "operation": "getAddress",
+  "coin": "btc",
+  "path": "m/84'/0'/0'/0/0",
+  "showOnDevice": true
+}
+```
+
+### Sign Ethereum Transaction
+
+```javascript
+{
+  "resource": "ethereum",
+  "operation": "signTransaction",
+  "chainId": 1,
+  "to": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bEaC",
+  "value": "1000000000000000000",
+  "gasLimit": "21000",
+  "maxFeePerGas": "50000000000"
+}
+```
+
+### Multi-chain Address Discovery
+
+```javascript
+{
+  "resource": "multiCurrency",
+  "operation": "batchGetAddresses",
+  "coins": ["btc", "eth", "ltc", "ada"],
+  "accountIndex": 0
+}
+```
+
+## Blockchain Networks
+
+| Network | Coin Type | Address Format |
+|---------|-----------|----------------|
+| Bitcoin | BTC | P2PKH, P2SH-P2WPKH, P2WPKH |
+| Ethereum | ETH | EIP-55 checksum |
+| Litecoin | LTC | P2PKH, P2SH-P2WPKH |
+| Cardano | ADA | Bech32 |
+| Solana | SOL | Base58 |
+| Ripple | XRP | Base58check |
+| Stellar | XLM | Ed25519 public key |
+| Dogecoin | DOGE | P2PKH |
+| Bitcoin Cash | BCH | CashAddr |
+| Polygon | MATIC | EIP-55 |
+| Arbitrum | ARB | EIP-55 |
+| Optimism | OP | EIP-55 |
+
+## Error Handling
+
+The node provides detailed error information:
+
+- **DeviceNotFound**: No Trezor device detected
+- **ActionCancelled**: User cancelled operation on device
+- **PinInvalid**: Incorrect PIN entered
+- **PassphraseMismatch**: Passphrase confirmation failed
+- **FirmwareOutdated**: Device firmware needs update
+- **TransportError**: Communication failure with device
+
+## Security Best Practices
+
+1. **Always verify addresses on device** - Enable `showOnDevice` for address operations
+2. **Use passphrases for high-value accounts** - Adds an extra layer of security
+3. **Keep firmware updated** - Ensures latest security patches
+4. **Verify transaction details on device** - Never blind-sign transactions
+5. **Use dedicated workflows** - Isolate sensitive operations
+6. **Implement rate limiting** - Prevent automated attacks
+7. **Log all operations** - Maintain audit trail
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Run tests with coverage
+npm run test:coverage
+
+# Lint
+npm run lint
+
+# Format code
+npm run format
+
+# Type check
+npm run typecheck
+```
+
+## Author
+
+**Velocity BPA**
+- Website: [velobpa.com](https://velobpa.com)
+- GitHub: [Velocity-BPA](https://github.com/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](LICENSE), [COMMERCIAL_LICENSE.md](COMMERCIAL_LICENSE.md), and [LICENSING_FAQ.md](LICENSING_FAQ.md) for details.
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+Please ensure your code follows the existing style and includes appropriate tests.
+
+## Support
+
+- **Documentation**: [GitHub Wiki](https://github.com/velocity-bpa/n8n-nodes-trezor/wiki)
+- **Issues**: [GitHub Issues](https://github.com/velocity-bpa/n8n-nodes-trezor/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/velocity-bpa/n8n-nodes-trezor/discussions)
+- **Commercial Support**: [licensing@velobpa.com](mailto:licensing@velobpa.com)
+
+## Acknowledgments
+
+- [Trezor](https://trezor.io) - Hardware wallet manufacturer
+- [n8n](https://n8n.io) - Workflow automation platform
+- [SatoshiLabs](https://satoshilabs.com) - Trezor Connect SDK

package/dist/Trezor/trezor.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <defs>
+    <linearGradient id="trezorGrad" x1="0%" y1="0%" x2="0%" y2="100%">
+      <stop offset="0%" style="stop-color:#00A340;stop-opacity:1" />
+      <stop offset="100%" style="stop-color:#008732;stop-opacity:1" />
+    </linearGradient>
+  </defs>
+  <rect x="16" y="8" width="32" height="48" rx="4" ry="4" fill="url(#trezorGrad)"/>
+  <rect x="20" y="12" width="24" height="32" rx="2" ry="2" fill="#fff"/>
+  <circle cx="32" cy="50" r="3" fill="#fff"/>
+  <path d="M26 20h12v4H26z M26 28h12v4H26z" fill="#00A340"/>
+</svg>

package/dist/credentials/TrezorConnectApi.credentials.d.ts

@@ -0,0 +1,8 @@
+import { ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class TrezorConnectApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+}
+//# sourceMappingURL=TrezorConnectApi.credentials.d.ts.map

package/dist/credentials/TrezorConnectApi.credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrezorConnectApi.credentials.d.ts","sourceRoot":"","sources":["../../credentials/TrezorConnectApi.credentials.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEhE,qBAAa,gBAAiB,YAAW,eAAe;IACtD,IAAI,SAAsB;IAC1B,WAAW,SAAoB;IAC/B,gBAAgB,SAA2D;IAE3E,UAAU,EAAE,eAAe,EAAE,CA6C3B;CACH"}

package/dist/credentials/TrezorConnectApi.credentials.js

@@ -0,0 +1,64 @@
+"use strict";
+/*
+ * Copyright (c) Velocity BPA, LLC
+ * Licensed under the Business Source License 1.1
+ * Commercial use requires a separate commercial license.
+ * See LICENSE file for details.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TrezorConnectApi = void 0;
+class TrezorConnectApi {
+    constructor() {
+        this.name = 'trezorConnectApi';
+        this.displayName = 'Trezor Connect';
+        this.documentationUrl = 'https://docs.trezor.io/trezor-suite/packages/connect/';
+        this.properties = [
+            {
+                displayName: 'Manifest Email',
+                name: 'manifestEmail',
+                type: 'string',
+                default: '',
+                required: true,
+                description: 'Contact email for the application (required by Trezor Connect)',
+            },
+            {
+                displayName: 'Manifest App URL',
+                name: 'manifestAppUrl',
+                type: 'string',
+                default: '',
+                required: true,
+                description: 'URL of the application using Trezor Connect',
+            },
+            {
+                displayName: 'Bridge URL',
+                name: 'bridgeUrl',
+                type: 'string',
+                default: 'http://127.0.0.1:21325',
+                description: 'URL of the Trezor Bridge service',
+            },
+            {
+                displayName: 'Webusb',
+                name: 'webusb',
+                type: 'boolean',
+                default: false,
+                description: 'Whether to use WebUSB for device communication',
+            },
+            {
+                displayName: 'Debug Mode',
+                name: 'debug',
+                type: 'boolean',
+                default: false,
+                description: 'Whether to enable debug logging',
+            },
+            {
+                displayName: 'Lazy Load',
+                name: 'lazyLoad',
+                type: 'boolean',
+                default: true,
+                description: 'Whether to lazy load Trezor Connect',
+            },
+        ];
+    }
+}
+exports.TrezorConnectApi = TrezorConnectApi;
+//# sourceMappingURL=TrezorConnectApi.credentials.js.map

package/dist/credentials/TrezorConnectApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrezorConnectApi.credentials.js","sourceRoot":"","sources":["../../credentials/TrezorConnectApi.credentials.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAIH,MAAa,gBAAgB;IAA7B;QACE,SAAI,GAAG,kBAAkB,CAAC;QAC1B,gBAAW,GAAG,gBAAgB,CAAC;QAC/B,qBAAgB,GAAG,uDAAuD,CAAC;QAE3E,eAAU,GAAsB;YAC9B;gBACE,WAAW,EAAE,gBAAgB;gBAC7B,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,gEAAgE;aAC9E;YACD;gBACE,WAAW,EAAE,kBAAkB;gBAC/B,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,6CAA6C;aAC3D;YACD;gBACE,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,wBAAwB;gBACjC,WAAW,EAAE,kCAAkC;aAChD;YACD;gBACE,WAAW,EAAE,QAAQ;gBACrB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EAAE,gDAAgD;aAC9D;YACD;gBACE,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EAAE,iCAAiC;aAC/C;YACD;gBACE,WAAW,EAAE,WAAW;gBACxB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,qCAAqC;aACnD;SACF,CAAC;IACJ,CAAC;CAAA;AAnDD,4CAmDC"}

package/dist/credentials/TrezorDeviceApi.credentials.d.ts

@@ -0,0 +1,8 @@
+import { ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class TrezorDeviceApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+}
+//# sourceMappingURL=TrezorDeviceApi.credentials.d.ts.map

package/dist/credentials/TrezorDeviceApi.credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrezorDeviceApi.credentials.d.ts","sourceRoot":"","sources":["../../credentials/TrezorDeviceApi.credentials.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEhE,qBAAa,eAAgB,YAAW,eAAe;IACrD,IAAI,SAAqB;IACzB,WAAW,SAAmB;IAC9B,gBAAgB,SAA2D;IAE3E,UAAU,EAAE,eAAe,EAAE,CA6B3B;CACH"}

package/dist/credentials/TrezorDeviceApi.credentials.js

@@ -0,0 +1,48 @@
+"use strict";
+/*
+ * Copyright (c) Velocity BPA, LLC
+ * Licensed under the Business Source License 1.1
+ * Commercial use requires a separate commercial license.
+ * See LICENSE file for details.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TrezorDeviceApi = void 0;
+class TrezorDeviceApi {
+    constructor() {
+        this.name = 'trezorDeviceApi';
+        this.displayName = 'Trezor Device';
+        this.documentationUrl = 'https://docs.trezor.io/trezor-suite/packages/connect/';
+        this.properties = [
+            {
+                displayName: 'Device Label',
+                name: 'deviceLabel',
+                type: 'string',
+                default: '',
+                description: 'Optional label to identify the Trezor device',
+            },
+            {
+                displayName: 'Device Path',
+                name: 'devicePath',
+                type: 'string',
+                default: '',
+                description: 'USB path to the device (leave empty for auto-detection)',
+            },
+            {
+                displayName: 'Use Passphrase',
+                name: 'usePassphrase',
+                type: 'boolean',
+                default: false,
+                description: 'Whether to use passphrase protection for this device',
+            },
+            {
+                displayName: 'Default Account Index',
+                name: 'defaultAccountIndex',
+                type: 'number',
+                default: 0,
+                description: 'Default account index to use for operations',
+            },
+        ];
+    }
+}
+exports.TrezorDeviceApi = TrezorDeviceApi;
+//# sourceMappingURL=TrezorDeviceApi.credentials.js.map

package/dist/credentials/TrezorDeviceApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrezorDeviceApi.credentials.js","sourceRoot":"","sources":["../../credentials/TrezorDeviceApi.credentials.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAIH,MAAa,eAAe;IAA5B;QACE,SAAI,GAAG,iBAAiB,CAAC;QACzB,gBAAW,GAAG,eAAe,CAAC;QAC9B,qBAAgB,GAAG,uDAAuD,CAAC;QAE3E,eAAU,GAAsB;YAC9B;gBACE,WAAW,EAAE,cAAc;gBAC3B,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,8CAA8C;aAC5D;YACD;gBACE,WAAW,EAAE,aAAa;gBAC1B,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,yDAAyD;aACvE;YACD;gBACE,WAAW,EAAE,gBAAgB;gBAC7B,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EAAE,sDAAsD;aACpE;YACD;gBACE,WAAW,EAAE,uBAAuB;gBACpC,IAAI,EAAE,qBAAqB;gBAC3B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,6CAA6C;aAC3D;SACF,CAAC;IACJ,CAAC;CAAA;AAnCD,0CAmCC"}

package/dist/nodes/Trezor/Trezor.node.d.ts

@@ -0,0 +1,6 @@
+import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class Trezor implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}
+//# sourceMappingURL=Trezor.node.d.ts.map

package/dist/nodes/Trezor/Trezor.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Trezor.node.d.ts","sourceRoot":"","sources":["../../../nodes/Trezor/Trezor.node.ts"],"names":[],"mappings":"AAOA,OAAO,EACN,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,oBAAoB,EACpB,MAAM,cAAc,CAAC;AA6CtB,qBAAa,MAAO,YAAW,SAAS;IACvC,WAAW,EAAE,oBAAoB,CA8G/B;IAEI,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;CA6GvE"}