n8n-nodes-xdc 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,421 @@
+# n8n-nodes-xdc
+
+> **[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 **XDC Network** - an enterprise-grade hybrid blockchain optimized for trade finance, international payments, and tokenized assets. Provides 10 resource categories and 50+ operations for complete blockchain integration.
+
+![n8n](https://img.shields.io/badge/n8n-community--node-blue)
+![XDC Network](https://img.shields.io/badge/XDC-Network-blue)
+![License](https://img.shields.io/badge/license-BSL--1.1-blue)
+![TypeScript](https://img.shields.io/badge/TypeScript-5.4-blue)
+
+---
+
+## Features
+
+### Resources
+- **Account** - Balance queries, transaction history, token holdings, address validation
+- **Transaction** - Send XDC, monitor transactions, estimate gas, get receipts
+- **XRC-20 Token** - Token transfers, approvals, balances, allowances
+- **XRC-721 NFT** - NFT metadata, transfers, collections, ownership
+- **Smart Contract** - Read/write contract calls, ABI encoding, event logs
+- **Trade Finance** - Document hashing, LC references, ISO 20022 validation
+- **Masternode** - XDPoS staking, voting, rewards, epoch info
+- **DeFi** - DEX swaps, liquidity pools, token prices
+- **Block** - Block data, rewards, timestamps, epoch calculation
+- **Utility** - Address conversion, unit conversion, hashing, signing
+
+### Trigger Events
+- New blocks
+- New epochs (every 900 blocks)
+- Address transactions
+- Token transfers
+
+---
+
+## Installation
+
+### Community Nodes (Recommended)
+
+1. Go to **Settings** → **Community Nodes**
+2. Select **Install**
+3. Enter `n8n-nodes-xdc`
+4. Accept the risks and install
+
+### Manual Installation
+
+```bash
+cd ~/.n8n/nodes
+npm install n8n-nodes-xdc
+```
+
+### Development Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/Velocity-BPA/n8n-nodes-xdc.git
+cd n8n-nodes-xdc
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Link to n8n custom directory
+mkdir -p ~/.n8n/custom
+ln -s $(pwd) ~/.n8n/custom/n8n-nodes-xdc
+
+# Restart n8n
+n8n start
+```
+
+---
+
+## Credentials Setup
+
+### XDC Network Credentials
+
+| Field | Description | Required |
+|-------|-------------|----------|
+| Network | Mainnet (Chain 50) or Apothem Testnet (Chain 51) | Yes |
+| RPC URL | Custom RPC endpoint (auto-filled based on network) | No |
+| Private Key | Required for write operations (sending transactions) | No |
+
+### XdcScan Credentials (Optional)
+
+| Field | Description | Required |
+|-------|-------------|----------|
+| Network | Mainnet or Apothem | Yes |
+| API Key | BlocksScan API key for explorer data | Yes |
+
+---
+
+## Resources & Operations
+
+### Account
+| Operation | Description |
+|-----------|-------------|
+| Get Balance | Get XDC balance for an address |
+| Get Token Balances | Get all token balances for an address |
+| Get Transactions | Get transaction history for an address |
+| Validate Address | Check if an address is valid |
+
+### Transaction
+| Operation | Description |
+|-----------|-------------|
+| Send XDC | Send XDC to another address |
+| Get History | Get transaction history |
+| Get Receipt | Get transaction receipt by hash |
+| Estimate Gas | Estimate gas for a transaction |
+| Get Status | Check transaction status |
+
+### Token (XRC-20)
+| Operation | Description |
+|-----------|-------------|
+| Get Balance | Get token balance for an address |
+| Transfer | Transfer tokens to another address |
+| Get Info | Get token metadata (name, symbol, decimals) |
+| Approve | Approve spending allowance |
+| Get Allowance | Check spending allowance |
+
+### NFT (XRC-721)
+| Operation | Description |
+|-----------|-------------|
+| Get Metadata | Get NFT metadata and attributes |
+| Get Owner | Get current owner of an NFT |
+| Transfer | Transfer NFT to another address |
+| Get Balance | Get NFT balance for an address |
+| Get Tokens Owned | List all NFTs owned by an address |
+
+### Smart Contract
+| Operation | Description |
+|-----------|-------------|
+| Call | Read data from a contract (no gas) |
+| Execute | Write data to a contract (requires gas) |
+| Get Events | Get contract event logs |
+| Get ABI | Fetch contract ABI from explorer |
+| Deploy | Deploy a new contract |
+
+### Trade Finance
+| Operation | Description |
+|-----------|-------------|
+| Generate Hash | Create SHA256/Keccak256 hash of documents |
+| Verify Hash | Verify document hash matches |
+| Generate LC Reference | Generate Letter of Credit reference |
+| Validate ISO 20022 | Validate ISO 20022 message format |
+
+### Masternode
+| Operation | Description |
+|-----------|-------------|
+| Get Candidates | List all masternode candidates |
+| Get Masternode Info | Get details about a specific masternode |
+| Get Epoch Info | Get current epoch information |
+| Get Voter Info | Get voting information for an address |
+| Calculate Rewards | Estimate staking rewards |
+| Vote | Stake XDC with a masternode |
+| Unvote | Withdraw stake from a masternode |
+| Withdraw | Withdraw available rewards |
+
+### DeFi
+| Operation | Description |
+|-----------|-------------|
+| Get XDC Price | Get current XDC/USD price |
+| Get Token Price | Get token price in XDC or USD |
+| Get Swap Quote | Get quote for token swap |
+| Execute Swap | Execute token swap on DEX |
+| Get Liquidity Pool | Get liquidity pool information |
+
+### Block
+| Operation | Description |
+|-----------|-------------|
+| Get Block | Get block by number or hash |
+| Get Latest Block | Get the most recent block |
+| Get Block Transactions | Get all transactions in a block |
+| Get Block Reward | Get mining reward for a block |
+| Get Block By Timestamp | Find block closest to a timestamp |
+
+### Utility
+| Operation | Description |
+|-----------|-------------|
+| Convert Units | Convert between wei, gwei, and XDC |
+| Convert Address | Convert between xdc and 0x formats |
+| Validate Address | Check if address is valid |
+| Keccak256 | Compute Keccak256 hash |
+| Encode ABI | ABI encode function call |
+| Decode ABI | ABI decode return data |
+| Sign Message | Sign a message with private key |
+| Verify Signature | Verify message signature |
+| Get Network Status | Get network status and gas prices |
+| Generate Wallet | Generate new wallet address |
+
+---
+
+## Trigger Node
+
+The XDC Trigger node monitors blockchain events and triggers workflows.
+
+### Events
+
+| Event | Description |
+|-------|-------------|
+| New Block | Triggers when a new block is mined |
+| New Epoch | Triggers when a new epoch starts (every 900 blocks) |
+| New Transaction | Triggers when a watched address receives a transaction |
+| Token Transfer | Triggers when a token transfer occurs |
+
+### Configuration
+
+| Parameter | Description |
+|-----------|-------------|
+| Event | The event type to monitor |
+| Address | (Optional) Address to watch for transactions |
+| Token Contract | (Optional) Token contract to monitor for transfers |
+| Polling Interval | How often to check for new events (default: 30s) |
+
+---
+
+## Usage Examples
+
+### Get Account Balance
+
+```json
+{
+  "resource": "account",
+  "operation": "getBalance",
+  "address": "xdc1234567890abcdef1234567890abcdef12345678"
+}
+```
+
+### Send XDC
+
+```json
+{
+  "resource": "transaction",
+  "operation": "sendXdc",
+  "toAddress": "xdc1234567890abcdef1234567890abcdef12345678",
+  "amount": "100"
+}
+```
+
+### Check Token Balance
+
+```json
+{
+  "resource": "token",
+  "operation": "getBalance",
+  "tokenAddress": "xdcTokenContractAddress...",
+  "walletAddress": "xdcWalletAddress..."
+}
+```
+
+### Generate Trade Document Hash
+
+```json
+{
+  "resource": "tradeFinance",
+  "operation": "generateHash",
+  "documentContent": "Bill of Lading content...",
+  "hashAlgorithm": "SHA256"
+}
+```
+
+### Vote for Masternode
+
+```json
+{
+  "resource": "masternode",
+  "operation": "vote",
+  "masternodeAddress": "xdcMasternodeAddress...",
+  "stakeAmount": "10000"
+}
+```
+
+---
+
+## XDC Network Concepts
+
+### Network Overview
+- **Consensus**: XDPoS (Delegated Proof of Stake)
+- **Block Time**: ~2 seconds
+- **Epoch Length**: 900 blocks (~30 minutes)
+- **Masternodes**: 108 validators
+- **Native Token**: XDC
+- **Token Standards**: XRC-20, XRC-721
+
+### Key Ecosystem Protocols
+- **Fathom Protocol** - CDP/stablecoin (FXD)
+- **Plugin Oracle** - Decentralized data feeds (PLI)
+- **XSwap/Globiance** - DEX platforms
+- **XDC Subnet** - Layer 2 scaling
+
+### Address Formats
+XDC Network uses two address formats:
+- **xdc format**: `xdc1234567890abcdef1234567890abcdef12345678`
+- **0x format**: `0x1234567890abcdef1234567890abcdef12345678`
+
+Both formats are interchangeable and represent the same address.
+
+---
+
+## Networks
+
+| Network | Chain ID | RPC Endpoint | Explorer |
+|---------|----------|--------------|----------|
+| Mainnet | 50 | https://rpc.xinfin.network | https://xdc.blocksscan.io |
+| Apothem | 51 | https://rpc.apothem.network | https://apothem.blocksscan.io |
+
+---
+
+## Error Handling
+
+The node includes comprehensive error handling:
+
+- **Network Errors**: Automatic retry with exponential backoff
+- **Invalid Address**: Clear error message with address format guidance
+- **Insufficient Funds**: Detailed balance information
+- **Gas Estimation Failed**: Suggested gas limit values
+- **Contract Errors**: Decoded revert reasons when available
+
+---
+
+## Security Best Practices
+
+1. **Private Key Storage**: Never hardcode private keys. Use n8n credentials.
+2. **Testnet First**: Always test workflows on Apothem testnet before mainnet.
+3. **Gas Limits**: Set appropriate gas limits to prevent unexpected costs.
+4. **Address Validation**: Always validate addresses before transactions.
+5. **Amount Verification**: Double-check amounts before sending transactions.
+
+---
+
+## Development
+
+```bash
+# 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 code
+npm run lint
+
+# Fix linting issues
+npm run lint:fix
+
+# Format code
+npm run format
+```
+
+---
+
+## 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
+
+Contributions are welcome! Please ensure:
+
+1. All code follows the existing style
+2. Tests are added for new features
+3. Documentation is updated
+4. Licensing headers are included in new files
+
+---
+
+## Support
+
+- [XDC Network](https://xinfin.org)
+- [XDC Documentation](https://docs.xdc.org)
+- [BlocksScan Explorer](https://xdc.blocksscan.io)
+- [XDC Faucet (Testnet)](https://faucet.apothem.network)
+
+---
+
+## Acknowledgments
+
+- [XDC Network](https://xinfin.org) for the enterprise blockchain platform
+- [n8n](https://n8n.io) for the workflow automation platform
+- [ethers.js](https://ethers.org) for Ethereum/XDC library
+
+---
+
+Built with ❤️ for the XDC Network community

package/dist/credentials/XdcNetwork.credentials.d.ts

@@ -0,0 +1,15 @@
+import type { ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+/**
+ * XDC Network Credentials
+ *
+ * Provides connection parameters for XDC Network blockchain.
+ * Supports Mainnet, Apothem Testnet, and custom RPC endpoints.
+ */
+export declare class XdcNetwork implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    test: ICredentialTestRequest;
+}
+//# sourceMappingURL=XdcNetwork.credentials.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"XdcNetwork.credentials.d.ts","sourceRoot":"","sources":["../../credentials/XdcNetwork.credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,MAAM,cAAc,CAAC;AAEtB;;;;;GAKG;AACH,qBAAa,UAAW,YAAW,eAAe;IACjD,IAAI,SAAgB;IACpB,WAAW,SAAiB;IAC5B,gBAAgB,SAA2B;IAE3C,UAAU,EAAE,eAAe,EAAE,CAyE3B;IAGF,IAAI,EAAE,sBAAsB,CAc1B;CACF"}

package/dist/credentials/XdcNetwork.credentials.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XdcNetwork = void 0;
+/**
+ * XDC Network Credentials
+ *
+ * Provides connection parameters for XDC Network blockchain.
+ * Supports Mainnet, Apothem Testnet, and custom RPC endpoints.
+ */
+class XdcNetwork {
+    name = 'xdcNetwork';
+    displayName = 'XDC Network';
+    documentationUrl = 'https://docs.xdc.org/';
+    properties = [
+        {
+            displayName: 'Network',
+            name: 'network',
+            type: 'options',
+            default: 'mainnet',
+            options: [
+                {
+                    name: 'XDC Mainnet',
+                    value: 'mainnet',
+                    description: 'XDC Network main blockchain (Chain ID: 50)',
+                },
+                {
+                    name: 'XDC Apothem Testnet',
+                    value: 'apothem',
+                    description: 'XDC Network test blockchain (Chain ID: 51)',
+                },
+                {
+                    name: 'Custom RPC',
+                    value: 'custom',
+                    description: 'Connect to a custom XDC RPC endpoint',
+                },
+            ],
+            description: 'Select the XDC network to connect to',
+        },
+        {
+            displayName: 'RPC URL',
+            name: 'rpcUrl',
+            type: 'string',
+            default: '',
+            placeholder: 'https://erpc.xinfin.network',
+            description: 'Custom RPC endpoint URL. Leave empty to use default for selected network.',
+            displayOptions: {
+                show: {
+                    network: ['custom'],
+                },
+            },
+        },
+        {
+            displayName: 'Chain ID',
+            name: 'chainId',
+            type: 'number',
+            default: 50,
+            description: 'Chain ID for custom network (50 for Mainnet, 51 for Apothem)',
+            displayOptions: {
+                show: {
+                    network: ['custom'],
+                },
+            },
+        },
+        {
+            displayName: 'Private Key',
+            name: 'privateKey',
+            type: 'string',
+            typeOptions: {
+                password: true,
+            },
+            default: '',
+            placeholder: 'Enter your wallet private key',
+            description: 'Private key for signing transactions. Required for write operations (transfers, contract calls). Never share your private key.',
+            hint: 'Leave empty for read-only operations',
+        },
+        {
+            displayName: 'API Key (Optional)',
+            name: 'providerApiKey',
+            type: 'string',
+            typeOptions: {
+                password: true,
+            },
+            default: '',
+            placeholder: 'Enter API key for enhanced RPC provider',
+            description: 'Optional API key for enhanced RPC providers with higher rate limits',
+        },
+    ];
+    // Test the credential
+    test = {
+        request: {
+            baseURL: '={{$credentials.network === "apothem" ? "https://erpc.apothem.network" : ($credentials.network === "custom" && $credentials.rpcUrl ? $credentials.rpcUrl : "https://erpc.xinfin.network")}}',
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                jsonrpc: '2.0',
+                method: 'eth_chainId',
+                params: [],
+                id: 1,
+            }),
+        },
+    };
+}
+exports.XdcNetwork = XdcNetwork;
+//# sourceMappingURL=XdcNetwork.credentials.js.map

package/dist/credentials/XdcNetwork.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"XdcNetwork.credentials.js","sourceRoot":"","sources":["../../credentials/XdcNetwork.credentials.ts"],"names":[],"mappings":";;;AAMA;;;;;GAKG;AACH,MAAa,UAAU;IACtB,IAAI,GAAG,YAAY,CAAC;IACpB,WAAW,GAAG,aAAa,CAAC;IAC5B,gBAAgB,GAAG,uBAAuB,CAAC;IAE3C,UAAU,GAAsB;QAC/B;YACC,WAAW,EAAE,SAAS;YACtB,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE;gBACR;oBACC,IAAI,EAAE,aAAa;oBACnB,KAAK,EAAE,SAAS;oBAChB,WAAW,EAAE,4CAA4C;iBACzD;gBACD;oBACC,IAAI,EAAE,qBAAqB;oBAC3B,KAAK,EAAE,SAAS;oBAChB,WAAW,EAAE,4CAA4C;iBACzD;gBACD;oBACC,IAAI,EAAE,YAAY;oBAClB,KAAK,EAAE,QAAQ;oBACf,WAAW,EAAE,sCAAsC;iBACnD;aACD;YACD,WAAW,EAAE,sCAAsC;SACnD;QACD;YACC,WAAW,EAAE,SAAS;YACtB,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,6BAA6B;YAC1C,WAAW,EAAE,2EAA2E;YACxF,cAAc,EAAE;gBACf,IAAI,EAAE;oBACL,OAAO,EAAE,CAAC,QAAQ,CAAC;iBACnB;aACD;SACD;QACD;YACC,WAAW,EAAE,UAAU;YACvB,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,8DAA8D;YAC3E,cAAc,EAAE;gBACf,IAAI,EAAE;oBACL,OAAO,EAAE,CAAC,QAAQ,CAAC;iBACnB;aACD;SACD;QACD;YACC,WAAW,EAAE,aAAa;YAC1B,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE;gBACZ,QAAQ,EAAE,IAAI;aACd;YACD,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,+BAA+B;YAC5C,WAAW,EAAE,gIAAgI;YAC7I,IAAI,EAAE,sCAAsC;SAC5C;QACD;YACC,WAAW,EAAE,oBAAoB;YACjC,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE;gBACZ,QAAQ,EAAE,IAAI;aACd;YACD,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,yCAAyC;YACtD,WAAW,EAAE,qEAAqE;SAClF;KACD,CAAC;IAEF,sBAAsB;IACtB,IAAI,GAA2B;QAC9B,OAAO,EAAE;YACR,OAAO,EAAE,6LAA6L;YACtM,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACR,cAAc,EAAE,kBAAkB;aAClC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACpB,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,aAAa;gBACrB,MAAM,EAAE,EAAE;gBACV,EAAE,EAAE,CAAC;aACL,CAAC;SACF;KACD,CAAC;CACF;AAhGD,gCAgGC"}

package/dist/credentials/XdcScan.credentials.d.ts

@@ -0,0 +1,15 @@
+import type { ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+/**
+ * XDCScan API Credentials
+ *
+ * Provides authentication for XDCScan/BlocksScan explorer APIs.
+ * Used for transaction history, token transfers, and contract verification.
+ */
+export declare class XdcScan implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    test: ICredentialTestRequest;
+}
+//# sourceMappingURL=XdcScan.credentials.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"XdcScan.credentials.d.ts","sourceRoot":"","sources":["../../credentials/XdcScan.credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,MAAM,cAAc,CAAC;AAEtB;;;;;GAKG;AACH,qBAAa,OAAQ,YAAW,eAAe;IAC9C,IAAI,SAAa;IACjB,WAAW,SAAiB;IAC5B,gBAAgB,SAAoC;IAEpD,UAAU,EAAE,eAAe,EAAE,CAwC3B;IAGF,IAAI,EAAE,sBAAsB,CAU1B;CACF"}

package/dist/credentials/XdcScan.credentials.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XdcScan = void 0;
+/**
+ * XDCScan API Credentials
+ *
+ * Provides authentication for XDCScan/BlocksScan explorer APIs.
+ * Used for transaction history, token transfers, and contract verification.
+ */
+class XdcScan {
+    name = 'xdcScan';
+    displayName = 'XDCScan API';
+    documentationUrl = 'https://xdc.blocksscan.io/docs';
+    properties = [
+        {
+            displayName: 'Network',
+            name: 'network',
+            type: 'options',
+            default: 'mainnet',
+            options: [
+                {
+                    name: 'XDC Mainnet',
+                    value: 'mainnet',
+                    description: 'XDCScan for Mainnet (xdc.blocksscan.io)',
+                },
+                {
+                    name: 'XDC Apothem Testnet',
+                    value: 'apothem',
+                    description: 'XDCScan for Apothem (apothem.blocksscan.io)',
+                },
+            ],
+            description: 'Select the network for explorer API',
+        },
+        {
+            displayName: 'API Key',
+            name: 'apiKey',
+            type: 'string',
+            typeOptions: {
+                password: true,
+            },
+            default: '',
+            placeholder: 'Enter your XDCScan API key',
+            description: 'API key for XDCScan/BlocksScan explorer. Get one at xdc.blocksscan.io',
+            required: true,
+        },
+        {
+            displayName: 'Custom API URL',
+            name: 'customApiUrl',
+            type: 'string',
+            default: '',
+            placeholder: 'https://xdc.blocksscan.io/api',
+            description: 'Optional custom API endpoint URL',
+        },
+    ];
+    // Test the credential
+    test = {
+        request: {
+            baseURL: '={{$credentials.customApiUrl || ($credentials.network === "apothem" ? "https://apothem.blocksscan.io/api" : "https://xdc.blocksscan.io/api")}}',
+            method: 'GET',
+            qs: {
+                module: 'stats',
+                action: 'xdcprice',
+                apikey: '={{$credentials.apiKey}}',
+            },
+        },
+    };
+}
+exports.XdcScan = XdcScan;
+//# sourceMappingURL=XdcScan.credentials.js.map

package/dist/credentials/XdcScan.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"XdcScan.credentials.js","sourceRoot":"","sources":["../../credentials/XdcScan.credentials.ts"],"names":[],"mappings":";;;AAMA;;;;;GAKG;AACH,MAAa,OAAO;IACnB,IAAI,GAAG,SAAS,CAAC;IACjB,WAAW,GAAG,aAAa,CAAC;IAC5B,gBAAgB,GAAG,gCAAgC,CAAC;IAEpD,UAAU,GAAsB;QAC/B;YACC,WAAW,EAAE,SAAS;YACtB,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE;gBACR;oBACC,IAAI,EAAE,aAAa;oBACnB,KAAK,EAAE,SAAS;oBAChB,WAAW,EAAE,yCAAyC;iBACtD;gBACD;oBACC,IAAI,EAAE,qBAAqB;oBAC3B,KAAK,EAAE,SAAS;oBAChB,WAAW,EAAE,6CAA6C;iBAC1D;aACD;YACD,WAAW,EAAE,qCAAqC;SAClD;QACD;YACC,WAAW,EAAE,SAAS;YACtB,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE;gBACZ,QAAQ,EAAE,IAAI;aACd;YACD,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,4BAA4B;YACzC,WAAW,EAAE,uEAAuE;YACpF,QAAQ,EAAE,IAAI;SACd;QACD;YACC,WAAW,EAAE,gBAAgB;YAC7B,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,+BAA+B;YAC5C,WAAW,EAAE,kCAAkC;SAC/C;KACD,CAAC;IAEF,sBAAsB;IACtB,IAAI,GAA2B;QAC9B,OAAO,EAAE;YACR,OAAO,EAAE,gJAAgJ;YACzJ,MAAM,EAAE,KAAK;YACb,EAAE,EAAE;gBACH,MAAM,EAAE,OAAO;gBACf,MAAM,EAAE,UAAU;gBAClB,MAAM,EAAE,0BAA0B;aAClC;SACD;KACD,CAAC;CACF;AA3DD,0BA2DC"}

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

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