@ktmcp-cli/nowpayments 1.0.0

package/bin/nowpayments.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+
+/**
+ * NOWPayments CLI Entry Point
+ *
+ * A production-ready command-line interface for the NOWPayments cryptocurrency
+ * payment processing API.
+ *
+ * @see https://documenter.getpostman.com/view/7907941/S1a32n38
+ */
+
+const { Command } = require('commander');
+const chalk = require('chalk');
+const path = require('path');
+const fs = require('fs');
+
+// Load environment variables
+require('dotenv').config();
+
+const program = new Command();
+
+// Import commands
+const statusCommand = require('../src/commands/status');
+const currenciesCommand = require('../src/commands/currencies');
+const estimateCommand = require('../src/commands/estimate');
+const paymentCommand = require('../src/commands/payment');
+const invoiceCommand = require('../src/commands/invoice');
+const payoutCommand = require('../src/commands/payout');
+const authCommand = require('../src/commands/auth');
+
+// CLI metadata
+program
+  .name('nowpayments')
+  .description('NOWPayments API CLI - Cryptocurrency payment processing from the command line')
+  .version('1.0.0')
+  .option('-k, --api-key <key>', 'NOWPayments API key (or set NOWPAYMENTS_API_KEY env var)')
+  .option('--sandbox', 'Use sandbox environment (sandbox.nowpayments.io)')
+  .option('--json', 'Output raw JSON responses')
+  .option('--debug', 'Enable debug logging')
+  .hook('preAction', (thisCommand, actionCommand) => {
+    // Make global options available to all commands
+    const opts = thisCommand.opts();
+    program._apiKey = opts.apiKey || process.env.NOWPAYMENTS_API_KEY;
+    program._sandbox = opts.sandbox || false;
+    program._json = opts.json || false;
+    program._debug = opts.debug || false;
+
+    if (program._debug) {
+      console.log(chalk.gray(`[DEBUG] Command: ${actionCommand.name()}`));
+      console.log(chalk.gray(`[DEBUG] Sandbox: ${program._sandbox}`));
+    }
+  });
+
+// Register commands
+program.addCommand(authCommand);
+program.addCommand(statusCommand);
+program.addCommand(currenciesCommand);
+program.addCommand(estimateCommand);
+program.addCommand(paymentCommand);
+program.addCommand(invoiceCommand);
+program.addCommand(payoutCommand);
+
+// Display helpful message when no command is provided
+program.on('--help', () => {
+  console.log('');
+  console.log('Examples:');
+  console.log('  $ nowpayments status');
+  console.log('  $ nowpayments currencies --available');
+  console.log('  $ nowpayments estimate --from USD --to BTC --amount 100');
+  console.log('  $ nowpayments payment create --price 99.99 --currency USD --pay-currency BTC');
+  console.log('  $ nowpayments payment get <payment_id>');
+  console.log('');
+  console.log('Authentication:');
+  console.log('  Set NOWPAYMENTS_API_KEY in .env file or use --api-key flag');
+  console.log('  $ nowpayments auth set YOUR_API_KEY');
+  console.log('');
+  console.log('Documentation:');
+  console.log('  README.md - General usage and examples');
+  console.log('  AGENT.md - AI agent integration patterns');
+  console.log('  OPENCLAW.md - OpenClaw integration guide');
+});
+
+// Parse and execute
+program.parse(process.argv);
+
+// Show help if no command provided
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+}

package/examples/basic-payment.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+
+/**
+ * Basic Payment Example
+ *
+ * Demonstrates creating a simple cryptocurrency payment with NOWPayments CLI.
+ */
+
+const { exec } = require('child_process');
+const util = require('util');
+
+const execPromise = util.promisify(exec);
+
+async function createBasicPayment() {
+  console.log('Creating a basic payment...\n');
+
+  try {
+    // Step 1: Check API status
+    console.log('1. Checking API status...');
+    await execPromise('nowpayments status');
+    console.log('   ✓ API is online\n');
+
+    // Step 2: Get estimate
+    console.log('2. Getting price estimate...');
+    const estimateResult = await execPromise(
+      'nowpayments --json estimate convert --from USD --to BTC --amount 100'
+    );
+    const estimate = JSON.parse(estimateResult.stdout);
+    console.log(`   ✓ $100 USD ≈ ${estimate.estimated_amount} BTC\n`);
+
+    // Step 3: Create payment
+    console.log('3. Creating payment...');
+    const paymentResult = await execPromise(`
+      nowpayments --json payment create \
+        --price 100 \
+        --currency USD \
+        --pay-currency BTC \
+        --order-id "DEMO-${Date.now()}" \
+        --order-description "Basic payment example"
+    `);
+    const payment = JSON.parse(paymentResult.stdout);
+
+    console.log('   ✓ Payment created successfully!\n');
+    console.log('Payment Details:');
+    console.log(`  Payment ID: ${payment.payment_id}`);
+    console.log(`  Status: ${payment.payment_status}`);
+    console.log(`  Pay Amount: ${payment.pay_amount} ${payment.pay_currency}`);
+    console.log(`  Pay Address: ${payment.pay_address}`);
+    console.log(`  Created: ${new Date(payment.created_at).toLocaleString()}\n`);
+
+    // Step 4: Check payment status
+    console.log('4. Checking payment status...');
+    const statusResult = await execPromise(
+      `nowpayments --json payment get ${payment.payment_id}`
+    );
+    const status = JSON.parse(statusResult.stdout);
+    console.log(`   Status: ${status.payment_status}`);
+
+  } catch (error) {
+    console.error('Error:', error.message);
+    process.exit(1);
+  }
+}
+
+// Run the example
+createBasicPayment();

package/examples/invoice-flow.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+
+/**
+ * Invoice Flow Example
+ *
+ * Demonstrates creating and managing payment invoices.
+ */
+
+const { exec } = require('child_process');
+const util = require('util');
+
+const execPromise = util.promisify(exec);
+
+async function createInvoiceFlow() {
+  console.log('Creating payment invoice...\n');
+
+  try {
+    // Step 1: Create invoice
+    console.log('1. Creating invoice...');
+    const invoiceResult = await execPromise(`
+      nowpayments --json invoice create \
+        --price 49.99 \
+        --currency USD \
+        --order-id "INV-${Date.now()}" \
+        --order-description "Premium subscription" \
+        --success-url "https://example.com/success" \
+        --cancel-url "https://example.com/cancel"
+    `);
+    const invoice = JSON.parse(invoiceResult.stdout);
+
+    console.log('   ✓ Invoice created!\n');
+    console.log('Invoice Details:');
+    console.log(`  Invoice ID: ${invoice.id}`);
+    console.log(`  Status: ${invoice.invoice_status}`);
+    console.log(`  Amount: $${invoice.price_amount} ${invoice.price_currency}`);
+    console.log(`  Invoice URL: ${invoice.invoice_url}`);
+    console.log(`  Created: ${new Date(invoice.created_at).toLocaleString()}\n`);
+
+    console.log('Share this URL with your customer:');
+    console.log(`  ${invoice.invoice_url}\n`);
+
+    // Step 2: Check invoice status
+    console.log('2. Checking invoice status...');
+    const statusResult = await execPromise(
+      `nowpayments --json invoice get ${invoice.id}`
+    );
+    const status = JSON.parse(statusResult.stdout);
+
+    console.log(`   Status: ${status.invoice_status}`);
+
+    if (status.payment_id) {
+      console.log(`   Payment ID: ${status.payment_id}`);
+    }
+
+    // Step 3: List recent invoices
+    console.log('\n3. Listing recent invoices...');
+    const listResult = await execPromise(
+      'nowpayments --json invoice list --limit 5'
+    );
+    const list = JSON.parse(listResult.stdout);
+
+    console.log(`   Found ${list.data.length} invoices:\n`);
+    list.data.forEach((inv, i) => {
+      console.log(`   ${i + 1}. ${inv.id}`);
+      console.log(`      Status: ${inv.invoice_status}`);
+      console.log(`      Amount: $${inv.price_amount}`);
+      console.log(`      Created: ${new Date(inv.created_at).toLocaleString()}`);
+      console.log('');
+    });
+
+  } catch (error) {
+    console.error('Error:', error.message);
+    process.exit(1);
+  }
+}
+
+// Run the example
+createInvoiceFlow();

package/examples/monitor-payment.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+
+/**
+ * Payment Monitoring Example
+ *
+ * Demonstrates monitoring a payment until completion or timeout.
+ */
+
+const { exec } = require('child_process');
+const util = require('util');
+
+const execPromise = util.promisify(exec);
+
+// Configuration
+const CHECK_INTERVAL = 30000; // 30 seconds
+const MAX_DURATION = 30 * 60 * 1000; // 30 minutes
+
+async function monitorPayment(paymentId) {
+  const startTime = Date.now();
+
+  console.log(`Monitoring payment: ${paymentId}`);
+  console.log(`Check interval: ${CHECK_INTERVAL / 1000}s`);
+  console.log(`Max duration: ${MAX_DURATION / 60000} minutes\n`);
+
+  while (Date.now() - startTime < MAX_DURATION) {
+    try {
+      // Check payment status
+      const result = await execPromise(
+        `nowpayments --json payment get ${paymentId}`
+      );
+      const payment = JSON.parse(result.stdout);
+
+      const elapsed = Math.round((Date.now() - startTime) / 1000);
+      console.log(`[${elapsed}s] Status: ${payment.payment_status}`);
+
+      // Check for terminal states
+      switch (payment.payment_status) {
+        case 'finished':
+          console.log('\n✓ Payment completed successfully!');
+          console.log(`  Amount paid: ${payment.actually_paid} ${payment.pay_currency}`);
+          console.log(`  Outcome: ${payment.outcome_amount} ${payment.outcome_currency}`);
+          return { success: true, payment };
+
+        case 'failed':
+          console.log('\n✗ Payment failed');
+          return { success: false, reason: 'failed', payment };
+
+        case 'expired':
+          console.log('\n✗ Payment expired');
+          return { success: false, reason: 'expired', payment };
+
+        case 'partially_paid':
+          console.log(`\n⚠ Partially paid: ${payment.actually_paid}/${payment.pay_amount} ${payment.pay_currency}`);
+          // Continue monitoring
+          break;
+
+        case 'waiting':
+        case 'confirming':
+        case 'confirmed':
+        case 'sending':
+          // Still processing, continue monitoring
+          break;
+      }
+
+      // Wait before next check
+      await new Promise(resolve => setTimeout(resolve, CHECK_INTERVAL));
+
+    } catch (error) {
+      console.error(`Error checking payment: ${error.message}`);
+      await new Promise(resolve => setTimeout(resolve, CHECK_INTERVAL));
+    }
+  }
+
+  console.log('\n⏱ Monitoring timeout reached');
+  return { success: false, reason: 'timeout' };
+}
+
+// Get payment ID from command line
+const paymentId = process.argv[2];
+
+if (!paymentId) {
+  console.error('Usage: node monitor-payment.js <payment_id>');
+  process.exit(1);
+}
+
+// Run monitoring
+monitorPayment(paymentId)
+  .then(result => {
+    process.exit(result.success ? 0 : 1);
+  })
+  .catch(error => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+  });