@ktmcp-cli/nowpayments 1.0.0

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@ktmcp-cli/nowpayments",
+  "version": "1.0.0",
+  "description": "Production-ready CLI for NOWPayments cryptocurrency payment processing API",
+  "main": "src/index.js",
+  "bin": {
+    "nowpayments": "./bin/nowpayments.js"
+  },
+  "scripts": {
+    "start": "node bin/nowpayments.js",
+    "test": "node --test",
+    "lint": "eslint ."
+  },
+  "keywords": [
+    "nowpayments",
+    "cryptocurrency",
+    "payment",
+    "cli",
+    "crypto",
+    "bitcoin",
+    "ethereum",
+    "commander"
+  ],
+  "author": "KTMCP",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "chalk": "^4.1.2",
+    "ora": "^5.4.1",
+    "dotenv": "^16.4.1",
+    "node-fetch": "^2.7.0",
+    "cli-table3": "^0.6.3"
+  },
+  "devDependencies": {
+    "eslint": "^8.56.0"
+  }
+}

package/src/commands/auth.js

@@ -0,0 +1,65 @@
+/**
+ * Authentication command
+ *
+ * Manage API keys and authentication configuration.
+ */
+
+const { Command } = require('commander');
+const chalk = require('chalk');
+const { setConfig, getConfig, CONFIG_FILE } = require('../lib/config');
+const { validateApiKeyFormat } = require('../lib/auth');
+
+const command = new Command('auth');
+
+command
+  .description('Manage API authentication')
+  .summary('Configure and manage API keys');
+
+// Set API key
+command
+  .command('set <api-key>')
+  .description('Save API key to config file')
+  .action((apiKey) => {
+    if (!validateApiKeyFormat(apiKey)) {
+      console.error(chalk.red('Error: Invalid API key format'));
+      console.error(chalk.yellow('API keys should be 20-100 alphanumeric characters'));
+      process.exit(1);
+    }
+
+    setConfig('apiKey', apiKey);
+    console.log(chalk.green('✓ API key saved successfully'));
+    console.log(chalk.gray(`Config file: ${CONFIG_FILE}`));
+  });
+
+// Show current API key (masked)
+command
+  .command('show')
+  .description('Display current API key configuration (masked)')
+  .action(() => {
+    const apiKey = getConfig('apiKey');
+
+    if (!apiKey) {
+      console.log(chalk.yellow('No API key configured'));
+      console.log(chalk.gray('\nSet an API key with: nowpayments auth set YOUR_KEY'));
+      return;
+    }
+
+    // Mask the API key (show first 4 and last 4 characters)
+    const masked = apiKey.length > 8
+      ? `${apiKey.substring(0, 4)}${'*'.repeat(apiKey.length - 8)}${apiKey.substring(apiKey.length - 4)}`
+      : '*'.repeat(apiKey.length);
+
+    console.log(chalk.cyan('API Key:'), masked);
+    console.log(chalk.gray(`Config file: ${CONFIG_FILE}`));
+  });
+
+// Clear API key
+command
+  .command('clear')
+  .description('Remove API key from config')
+  .action(() => {
+    setConfig('apiKey', null);
+    console.log(chalk.green('✓ API key cleared'));
+  });
+
+module.exports = command;

package/src/commands/currencies.js

@@ -0,0 +1,95 @@
+/**
+ * Currencies command
+ *
+ * List and query available cryptocurrencies.
+ */
+
+const { Command } = require('commander');
+const chalk = require('chalk');
+const Table = require('cli-table3');
+const { makeRequest, handleApiError, displayResponse } = require('../lib/api');
+
+const command = new Command('currencies');
+
+command
+  .description('List available currencies')
+  .summary('Query supported cryptocurrencies');
+
+// List all available currencies
+command
+  .command('list')
+  .description('List all available cryptocurrencies')
+  .option('-a, --available', 'Show only available currencies for payments')
+  .option('-s, --selected', 'Show only selected currencies')
+  .action(async (options) => {
+    try {
+      let endpoint = '/currencies';
+
+      if (options.available) {
+        endpoint = '/merchant/coins';
+      } else if (options.selected) {
+        endpoint = '/currencies?fixed_rate=true';
+      }
+
+      const data = await makeRequest(command.parent.parent, endpoint);
+
+      displayResponse(command.parent.parent, data, (response) => {
+        const currencies = response.selectedCurrencies || response.currencies || [];
+
+        if (!currencies || currencies.length === 0) {
+          console.log(chalk.yellow('No currencies found'));
+          return;
+        }
+
+        console.log(chalk.cyan(`\nAvailable Currencies: ${currencies.length}`));
+
+        // Display as formatted list
+        const columns = 4;
+        for (let i = 0; i < currencies.length; i += columns) {
+          const row = currencies.slice(i, i + columns);
+          console.log('  ' + row.map(c => chalk.bold(c.toUpperCase())).join('  '));
+        }
+      });
+    } catch (error) {
+      handleApiError(error);
+    }
+  });
+
+// Get currency details
+command
+  .command('info <currency>')
+  .description('Get information about a specific currency')
+  .action(async (currency) => {
+    try {
+      // First get all currencies
+      const data = await makeRequest(command.parent.parent, '/currencies');
+
+      const currencies = data.currencies || [];
+      const currencyUpper = currency.toUpperCase();
+
+      if (currencies.includes(currencyUpper.toLowerCase())) {
+        console.log(chalk.cyan('\nCurrency:'), chalk.bold(currencyUpper));
+        console.log(chalk.green('✓ Supported by NOWPayments'));
+
+        // Get minimum amount
+        try {
+          const minData = await makeRequest(command.parent.parent, '/min-amount', {
+            queryParams: { currency_from: 'USD', currency_to: currencyUpper }
+          });
+
+          if (minData.min_amount) {
+            console.log(chalk.cyan('Minimum amount:'), minData.min_amount, currencyUpper);
+          }
+        } catch (e) {
+          // Minimum amount not available
+        }
+      } else {
+        console.log(chalk.red(`\n✗ Currency ${currencyUpper} is not supported`));
+        process.exit(1);
+      }
+    } catch (error) {
+      handleApiError(error);
+    }
+  });
+
+module.exports = command;

package/src/commands/estimate.js

@@ -0,0 +1,85 @@
+/**
+ * Estimate command
+ *
+ * Calculate cryptocurrency price estimates and conversions.
+ */
+
+const { Command } = require('commander');
+const chalk = require('chalk');
+const { makeRequest, handleApiError, displayResponse } = require('../lib/api');
+
+const command = new Command('estimate');
+
+command
+  .description('Estimate cryptocurrency amounts')
+  .summary('Calculate price conversions and estimates');
+
+// Estimate conversion
+command
+  .command('convert')
+  .description('Estimate cryptocurrency amount for a given price')
+  .requiredOption('-f, --from <currency>', 'Currency to convert from (e.g., USD, EUR)')
+  .requiredOption('-t, --to <currency>', 'Cryptocurrency to convert to (e.g., BTC, ETH)')
+  .requiredOption('-a, --amount <amount>', 'Amount to convert')
+  .action(async (options) => {
+    try {
+      const amount = parseFloat(options.amount);
+
+      if (isNaN(amount) || amount <= 0) {
+        console.error(chalk.red('Error: Amount must be a positive number'));
+        process.exit(1);
+      }
+
+      const data = await makeRequest(command.parent.parent, '/estimate', {
+        queryParams: {
+          amount,
+          currency_from: options.from.toUpperCase(),
+          currency_to: options.to.toUpperCase()
+        }
+      });
+
+      displayResponse(command.parent.parent, data, (response) => {
+        console.log(chalk.cyan('\nEstimate:'));
+        console.log(chalk.bold(`  ${amount} ${options.from.toUpperCase()}`), '→',
+                    chalk.green(`${response.estimated_amount || response.amount_to} ${options.to.toUpperCase()}`));
+
+        if (response.fee_amount) {
+          console.log(chalk.gray(`  Network fee: ${response.fee_amount} ${options.to.toUpperCase()}`));
+        }
+      });
+    } catch (error) {
+      handleApiError(error);
+    }
+  });
+
+// Get minimum amount
+command
+  .command('min')
+  .description('Get minimum payment amount for a currency pair')
+  .requiredOption('-f, --from <currency>', 'Currency from (e.g., USD)')
+  .requiredOption('-t, --to <currency>', 'Cryptocurrency to (e.g., BTC)')
+  .option('--fiat', 'Get fiat equivalent of minimum')
+  .action(async (options) => {
+    try {
+      const data = await makeRequest(command.parent.parent, '/min-amount', {
+        queryParams: {
+          currency_from: options.from.toUpperCase(),
+          currency_to: options.to.toUpperCase(),
+          fiat_equivalent: options.fiat ? 'true' : undefined
+        }
+      });
+
+      displayResponse(command.parent.parent, data, (response) => {
+        console.log(chalk.cyan('\nMinimum Payment Amount:'));
+        console.log(chalk.bold(`  ${response.min_amount} ${options.to.toUpperCase()}`));
+
+        if (response.fiat_equivalent) {
+          console.log(chalk.gray(`  ≈ ${response.fiat_equivalent} ${options.from.toUpperCase()}`));
+        }
+      });
+    } catch (error) {
+      handleApiError(error);
+    }
+  });
+
+module.exports = command;

package/src/commands/invoice.js

@@ -0,0 +1,188 @@
+/**
+ * Invoice command
+ *
+ * Create and manage payment invoices.
+ */
+
+const { Command } = require('commander');
+const chalk = require('chalk');
+const Table = require('cli-table3');
+const { makeRequest, handleApiError, displayResponse } = require('../lib/api');
+
+const command = new Command('invoice');
+
+command
+  .description('Manage invoices')
+  .summary('Create and query payment invoices');
+
+// Create a new invoice
+command
+  .command('create')
+  .description('Create a new invoice')
+  .requiredOption('-p, --price <amount>', 'Invoice amount')
+  .requiredOption('-c, --currency <currency>', 'Price currency (e.g., USD)')
+  .option('--order-id <id>', 'Your order ID')
+  .option('--order-description <desc>', 'Order description')
+  .option('--ipn-url <url>', 'IPN callback URL')
+  .option('--success-url <url>', 'Success redirect URL')
+  .option('--cancel-url <url>', 'Cancel redirect URL')
+  .option('--partially-paid-url <url>', 'Partially paid redirect URL')
+  .option('--payout-currency <currency>', 'Payout currency')
+  .option('--payout-address <address>', 'Payout address')
+  .action(async (options) => {
+    try {
+      const price = parseFloat(options.price);
+
+      if (isNaN(price) || price <= 0) {
+        console.error(chalk.red('Error: Price must be a positive number'));
+        process.exit(1);
+      }
+
+      const invoiceData = {
+        price_amount: price,
+        price_currency: options.currency.toUpperCase(),
+        order_id: options.orderId,
+        order_description: options.orderDescription,
+        ipn_callback_url: options.ipnUrl,
+        success_url: options.successUrl,
+        cancel_url: options.cancelUrl,
+        partially_paid_url: options.partiallyPaidUrl,
+        payout_currency: options.payoutCurrency?.toUpperCase(),
+        payout_address: options.payoutAddress
+      };
+
+      // Remove undefined values
+      Object.keys(invoiceData).forEach(key => {
+        if (invoiceData[key] === undefined) {
+          delete invoiceData[key];
+        }
+      });
+
+      const data = await makeRequest(command.parent.parent, '/invoice', {
+        method: 'POST',
+        body: invoiceData
+      });
+
+      displayResponse(command.parent.parent, data, (response) => {
+        console.log(chalk.green('\n✓ Invoice created successfully'));
+        console.log(chalk.cyan('\nInvoice Details:'));
+        console.log(chalk.bold('  Invoice ID:'), response.id);
+        console.log(chalk.bold('  Status:'), response.invoice_status);
+        console.log(chalk.bold('  Price:'), `${response.price_amount} ${response.price_currency}`);
+        console.log(chalk.bold('  Invoice URL:'), chalk.yellow(response.invoice_url));
+
+        if (response.order_id) {
+          console.log(chalk.bold('  Order ID:'), response.order_id);
+        }
+
+        console.log(chalk.gray('\n  Created:'), new Date(response.created_at).toLocaleString());
+      });
+    } catch (error) {
+      handleApiError(error);
+    }
+  });
+
+// Get invoice details
+command
+  .command('get <invoice-id>')
+  .description('Get invoice details by ID')
+  .action(async (invoiceId) => {
+    try {
+      const data = await makeRequest(command.parent.parent, `/invoice/${invoiceId}`);
+
+      displayResponse(command.parent.parent, data, (response) => {
+        console.log(chalk.cyan('\nInvoice Details:'));
+
+        const table = new Table({
+          chars: { 'mid': '', 'left-mid': '', 'mid-mid': '', 'right-mid': '' }
+        });
+
+        table.push(
+          ['Invoice ID', response.id],
+          ['Status', response.invoice_status],
+          ['Price', `${response.price_amount} ${response.price_currency}`],
+          ['Invoice URL', response.invoice_url]
+        );
+
+        if (response.order_id) {
+          table.push(['Order ID', response.order_id]);
+        }
+
+        if (response.order_description) {
+          table.push(['Description', response.order_description]);
+        }
+
+        if (response.payment_id) {
+          table.push(['Payment ID', response.payment_id]);
+        }
+
+        table.push(
+          ['Created', new Date(response.created_at).toLocaleString()],
+          ['Updated', new Date(response.updated_at).toLocaleString()]
+        );
+
+        console.log(table.toString());
+      });
+    } catch (error) {
+      handleApiError(error);
+    }
+  });
+
+// List invoices
+command
+  .command('list')
+  .description('List all invoices')
+  .option('-l, --limit <number>', 'Number of invoices to return', '10')
+  .option('-p, --page <number>', 'Page number', '0')
+  .option('--sort-by <field>', 'Sort by field (created_at, updated_at)')
+  .option('--order <order>', 'Sort order (asc, desc)', 'desc')
+  .option('--date-from <date>', 'Filter by start date (YYYY-MM-DD)')
+  .option('--date-to <date>', 'Filter by end date (YYYY-MM-DD)')
+  .action(async (options) => {
+    try {
+      const queryParams = {
+        limit: parseInt(options.limit),
+        page: parseInt(options.page),
+        sortBy: options.sortBy,
+        orderBy: options.order,
+        dateFrom: options.dateFrom,
+        dateTo: options.dateTo
+      };
+
+      const data = await makeRequest(command.parent.parent, '/invoice', {
+        queryParams
+      });
+
+      displayResponse(command.parent.parent, data, (response) => {
+        const invoices = response.data || [];
+
+        if (invoices.length === 0) {
+          console.log(chalk.yellow('\nNo invoices found'));
+          return;
+        }
+
+        console.log(chalk.cyan(`\nInvoices (${invoices.length}):`));
+
+        const table = new Table({
+          head: ['ID', 'Status', 'Amount', 'Currency', 'Created'],
+          colWidths: [20, 15, 12, 10, 25]
+        });
+
+        invoices.forEach(invoice => {
+          table.push([
+            invoice.id?.toString().substring(0, 18) || 'N/A',
+            invoice.invoice_status || 'N/A',
+            invoice.price_amount || 'N/A',
+            invoice.price_currency || 'N/A',
+            new Date(invoice.created_at).toLocaleString()
+          ]);
+        });
+
+        console.log(table.toString());
+      });
+    } catch (error) {
+      handleApiError(error);
+    }
+  });
+
+module.exports = command;