@profullstack/coinpay 0.16.0 → 0.17.0

package/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to `@profullstack/coinpay` will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.17.0] - 2026-10-17
+
+### Added
+- Itemised invoices: `createInvoice` / `updateInvoice` take `lineItems`
+  (description, quantity, unit price, optional tax rate) and a `discount`
+  (`percent` or `fixed`, applied before tax). The server computes the total;
+  `amount` is only for single-amount invoices.
+- `coinpay invoice create --item "Desc|qty|price[|tax %[|tax name]]"`
+  (repeatable) and `--discount 10%` / `--discount 25`.
+- Saved products/services and tax rates: `coinpay item list|create|delete`,
+  `coinpay tax-rate list|create|delete`; SDK `listInvoiceItems`,
+  `createInvoiceItem`, `deleteInvoiceItem`, `listTaxRates`, `createTaxRate`,
+  `deleteTaxRate`.
+
 ## [0.16.0] - 2026-10-12
 
 ### Added

package/bin/coinpay.js

@@ -24,6 +24,12 @@ import {
   sendInvoice,
   updateInvoice,
   InvoiceStatus,
+  listTaxRates,
+  createTaxRate,
+  deleteTaxRate,
+  listInvoiceItems,
+  createInvoiceItem,
+  deleteInvoiceItem,
 } from '../src/invoices.js';
 import { readFileSync, writeFileSync, existsSync, unlinkSync, chmodSync } from 'fs';
 import { execSync, spawn } from 'child_process';
@@ -206,8 +212,18 @@ const BOOLEAN_FLAGS = new Set([
 /**
  * Parse command line arguments
  */
+// Flags that may be given more than once collect into an array.
+const REPEATABLE_FLAGS = new Set(['item']);
+
 function parseArgs(args) {
   const result = { command: null, subcommand: null, args: [], flags: {} };
+  const setFlag = (name, value) => {
+    if (REPEATABLE_FLAGS.has(name) && value !== true) {
+      result.flags[name] = [...(Array.isArray(result.flags[name]) ? result.flags[name] : []), value];
+    } else {
+      result.flags[name] = value;
+    }
+  };
   
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
@@ -215,14 +231,14 @@ function parseArgs(args) {
     if (arg.startsWith('--')) {
       const eqIdx = arg.indexOf('=');
       if (eqIdx !== -1) {
-        result.flags[arg.slice(2, eqIdx)] = arg.slice(eqIdx + 1);
+        setFlag(arg.slice(2, eqIdx), arg.slice(eqIdx + 1));
       } else {
         const name = arg.slice(2);
         const next = args[i + 1];
         if (BOOLEAN_FLAGS.has(name)) {
           result.flags[name] = true;
         } else if (next && !next.startsWith('-')) {
-          result.flags[name] = next;
+          setFlag(name, next);
           i++;
         } else {
           result.flags[name] = true;
@@ -289,6 +305,40 @@ function isValidDate(value) {
   );
 }
 
+function parseItemFlags(values) {
+  return values.map((value) => {
+    const [description, qty, price, tax, taxName] = String(value).split('|').map((p) => p.trim());
+    const quantity = Number(qty);
+    const unitPrice = parseNonNegativeAmount(price);
+    const taxRate = tax ? Number(tax) : null;
+    if (!description || !(quantity > 0) || unitPrice === null || (tax && !(taxRate >= 0 && taxRate <= 100))) {
+      print.error('--item must look like "Description|qty|unit price[|tax %[|tax name]]", got: ' + value);
+      process.exit(1);
+    }
+    return {
+      description,
+      quantity,
+      unit_price: unitPrice,
+      ...(taxRate ? { tax_rate: taxRate, tax_name: taxName || null } : {}),
+    };
+  });
+}
+
+function parseNonNegativeAmount(value) {
+  if (typeof value !== 'string' || !/^\d+(\.\d{1,2})?$/.test(value)) return null;
+  return Number(value);
+}
+
+/** "10%" is a percent discount, "25" a fixed one in the invoice currency. */
+function parseDiscountFlag(value) {
+  const match = /^(\d+(?:\.\d+)?)(%?)$/.exec(String(value).trim());
+  if (!match || !(Number(match[1]) > 0)) {
+    print.error('--discount must be a percent like 10% or a fixed amount like 25');
+    process.exit(1);
+  }
+  return { type: match[2] ? 'percent' : 'fixed', value: Number(match[1]) };
+}
+
 function requireFlagValues(flags, names) {
   for (const name of names) {
     if (flags[name] === true) {
@@ -325,6 +375,10 @@ function invoiceForOutput(data, fallbackId) {
     clientId: invoice.clientId ?? invoice.client_id,
     currency: invoice.currency,
     amount: invoice.amount,
+    lineItems: invoice.lineItems ?? invoice.line_items ?? null,
+    subtotal: invoice.subtotal ?? null,
+    discountTotal: invoice.discountTotal ?? invoice.discount_total ?? null,
+    taxTotal: invoice.taxTotal ?? invoice.tax_total ?? null,
     cryptoCurrency: invoice.cryptoCurrency ?? invoice.crypto_currency,
     cryptoAmount: invoice.cryptoAmount ?? invoice.crypto_amount,
     status: invoice.status,
@@ -403,7 +457,9 @@ ${colors.cyan}Commands:${colors.reset}
     qr <id>               Get payment QR code
 
   ${colors.bright}invoice${colors.reset}
-    create                Create a draft invoice (--amount required)
+    create                Create a draft invoice (--amount, or one or more
+                          --item "Desc|qty|price[|tax %[|tax name]]" and
+                          an optional --discount 10% / --discount 25)
       --wallet-id <id>    Route settlement through a saved wallet
       --merchant-wallet-address <address>
                             Route settlement to a direct address
@@ -415,6 +471,17 @@ ${colors.cyan}Commands:${colors.reset}
     delete <id>           Permanently delete a draft invoice
       --yes               Skip confirmation for publish/send/delete
 
+  ${colors.bright}item${colors.reset}
+    list                  Saved products/services (--business-id)
+    create                Save one: --name, --price [--unit hour] [--description]
+                          [--tax-rate-id <id>]
+    delete <id>           Delete a saved item (issued invoices keep their copy)
+
+  ${colors.bright}tax-rate${colors.reset}
+    list                  Saved tax rates (--business-id)
+    create                Save one: --name "CA Sales Tax" --rate 8.25 [--default]
+    delete <id>           Delete a saved tax rate
+
   ${colors.bright}tokens${colors.reset}
     list                  List checkout tokens (--business-id, --active-only)
 
@@ -1068,6 +1135,15 @@ function printInvoiceDetails(invoice, { shareUrl } = {}) {
   console.log('\n' + colors.bright + label + colors.reset);
   print.info('ID: ' + invoice.id);
   print.info('Status: ' + (invoice.status || 'unknown'));
+  if (Array.isArray(invoice.lineItems) && invoice.lineItems.length > 0) {
+    for (const line of invoice.lineItems) {
+      const tax = line.tax_rate ? ' +' + line.tax_rate + '% ' + (line.tax_name || 'tax') : '';
+      print.info('  ' + line.description.split('\n')[0] + ': ' + line.quantity + ' x ' + line.unit_price + ' = ' + line.amount + tax);
+    }
+    print.info('Subtotal: ' + invoice.subtotal);
+    if (Number(invoice.discountTotal) > 0) print.info('Discount: -' + invoice.discountTotal);
+    if (Number(invoice.taxTotal) > 0) print.info('Tax: ' + invoice.taxTotal);
+  }
   print.info('Amount: ' + invoice.amount + ' ' + (invoice.currency || ''));
   if (invoice.businessId) print.info('Business: ' + invoice.businessId);
   if (invoice.clientId) print.info('Client: ' + invoice.clientId);
@@ -1088,6 +1164,92 @@ function printInvoiceDetails(invoice, { shareUrl } = {}) {
 /**
  * Invoice commands
  */
+async function handleCatalog(kind, subcommand, args, flags) {
+  const client = createClient();
+  const isItem = kind === 'item';
+  requireFlagValues(flags, ['business-id', 'name', 'price', 'unit', 'description', 'tax-rate-id', 'rate']);
+
+  switch (subcommand) {
+    case 'list': {
+      const rows = isItem
+        ? await listInvoiceItems(client, { businessId: flags['business-id'] })
+        : await listTaxRates(client, { businessId: flags['business-id'] });
+      if (flags.json) {
+        print.json(rows);
+        break;
+      }
+      if (rows.length === 0) {
+        print.info(isItem ? 'No saved items' : 'No saved tax rates');
+        break;
+      }
+      for (const row of rows) {
+        print.info(
+          isItem
+            ? row.id + '  ' + row.name + '  ' + row.unit_price + (row.unit ? ' / ' + row.unit : '')
+            : row.id + '  ' + row.name + '  ' + row.rate + '%' + (row.is_default ? '  (default)' : '')
+        );
+      }
+      break;
+    }
+
+    case 'create': {
+      if (!flags.name) {
+        print.error('--name is required');
+        process.exit(1);
+      }
+      let row;
+      if (isItem) {
+        const unitPrice = parseNonNegativeAmount(flags.price);
+        if (unitPrice === null) {
+          print.error('--price must be a decimal with at most two decimal places');
+          process.exit(1);
+        }
+        row = await createInvoiceItem(client, {
+          businessId: flags['business-id'],
+          name: flags.name,
+          unitPrice,
+          description: flags.description,
+          unit: flags.unit,
+          taxRateId: flags['tax-rate-id'],
+        });
+      } else {
+        const rate = Number(flags.rate);
+        if (flags.rate === undefined || !(rate >= 0 && rate <= 100)) {
+          print.error('--rate must be a percent between 0 and 100');
+          process.exit(1);
+        }
+        row = await createTaxRate(client, {
+          businessId: flags['business-id'],
+          name: flags.name,
+          rate,
+          isDefault: flags.default === true || flags.default === 'true',
+        });
+      }
+      if (flags.json) {
+        print.json(row);
+        break;
+      }
+      print.success((isItem ? 'Item' : 'Tax rate') + ' saved: ' + row.id);
+      break;
+    }
+
+    case 'delete': {
+      if (args.length !== 1) {
+        print.error('Usage: coinpay ' + kind + ' delete <id>');
+        process.exit(1);
+      }
+      if (isItem) await deleteInvoiceItem(client, args[0]);
+      else await deleteTaxRate(client, args[0]);
+      print.success('Deleted ' + args[0]);
+      break;
+    }
+
+    default:
+      print.error('Usage: coinpay ' + kind + ' <list|create|delete>');
+      process.exit(1);
+  }
+}
+
 async function handleInvoice(subcommand, args, flags) {
   const client = createClient();
 
@@ -1103,12 +1265,23 @@ async function handleInvoice(subcommand, args, flags) {
         'notes',
         'wallet-id',
         'merchant-wallet-address',
+        'item',
+        'discount',
       ]);
 
-      const amount = parsePositiveAmount(flags.amount);
-      if (amount === null) {
+      // --item "Description|qty|unit price[|tax %[|tax name]]", repeatable.
+      const lineItems = flags.item === undefined ? undefined : parseItemFlags(flags.item);
+      const discount = flags.discount === undefined ? undefined : parseDiscountFlag(flags.discount);
+      if (discount && !lineItems) {
+        print.error('--discount applies to itemised invoices; add one or more --item');
+        process.exit(1);
+      }
+
+      const amount = lineItems ? undefined : parsePositiveAmount(flags.amount);
+      if (!lineItems && amount === null) {
         print.error('--amount must be a positive decimal with at most two decimal places');
         print.info('Example: coinpay invoice create --amount 125 --currency USD --notes "Consulting"');
+        print.info('Or itemise: coinpay invoice create --item "Design|3|100" --item "Hosting|1|19.99|8.25|CA tax"');
         process.exit(1);
       }
 
@@ -1130,6 +1303,8 @@ async function handleInvoice(subcommand, args, flags) {
         clientId: flags['client-id'],
         currency: currency.toUpperCase(),
         amount,
+        lineItems,
+        discount,
         cryptoCurrency: cryptoCurrency?.toUpperCase(),
         dueDate,
         notes: flags.notes,
@@ -4589,6 +4764,11 @@ async function handleLightning(subcommand, args, flags) {
         await handleInvoice(subcommand, args, flags);
         break;
 
+      case 'item':
+      case 'tax-rate':
+        await handleCatalog(command, subcommand, args, flags);
+        break;
+
       case 'tokens':
         await handleTokens(subcommand, args, flags);
         break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@profullstack/coinpay",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "CoinPay SDK & CLI \u2014 Accept cryptocurrency and card payments (BTC, ETH, SOL, POL, BCH, USDC) with wallet, swap and a live finances dashboard",
   "type": "module",
   "main": "./src/index.js",

package/src/index.d.ts

@@ -55,9 +55,20 @@ export {
   sendInvoice,
   getInvoicePaymentData,
   InvoiceStatus,
+  listTaxRates,
+  createTaxRate,
+  deleteTaxRate,
+  listInvoiceItems,
+  createInvoiceItem,
+  deleteInvoiceItem,
 } from './invoices.js';
 export type {
   Invoice,
+  InvoiceLine,
+  InvoiceLineInput,
+  InvoiceDiscount,
+  TaxRate,
+  InvoiceItem,
   InvoiceStatusType,
   CreateInvoiceParams,
   ListInvoicesParams,

package/src/index.js

@@ -82,6 +82,12 @@ import {
   sendInvoice,
   getInvoicePaymentData,
   InvoiceStatus,
+  listTaxRates,
+  createTaxRate,
+  deleteTaxRate,
+  listInvoiceItems,
+  createInvoiceItem,
+  deleteInvoiceItem,
 } from './invoices.js';
 
 // Wallet exports
@@ -231,6 +237,12 @@ export {
   sendInvoice,
   getInvoicePaymentData,
   InvoiceStatus,
+  listTaxRates,
+  createTaxRate,
+  deleteTaxRate,
+  listInvoiceItems,
+  createInvoiceItem,
+  deleteInvoiceItem,
   
   // Wallet
   WalletClient,

package/src/invoices.d.ts

@@ -10,6 +10,27 @@ export const InvoiceStatus: {
 
 export type InvoiceStatusType = (typeof InvoiceStatus)[keyof typeof InvoiceStatus];
 
+export interface InvoiceLineInput {
+  description: string;
+  quantity: number;
+  unit_price: number;
+  tax_rate?: number | null;
+  tax_name?: string | null;
+  item_id?: string | null;
+}
+
+export interface InvoiceLine extends Required<InvoiceLineInput> {
+  /** quantity x unit_price, before discount and tax */
+  amount: number;
+  discount: number;
+  tax: number;
+}
+
+export interface InvoiceDiscount {
+  type: 'percent' | 'fixed';
+  value: number;
+}
+
 export interface Invoice {
   id: string;
   invoiceNumber?: string;
@@ -17,6 +38,11 @@ export interface Invoice {
   clientId?: string;
   currency?: string;
   amount?: number;
+  lineItems?: InvoiceLine[] | null;
+  subtotal?: number | null;
+  discount?: InvoiceDiscount | null;
+  discountTotal?: number | null;
+  taxTotal?: number | null;
   cryptoCurrency?: string;
   cryptoAmount?: string | number;
   status?: InvoiceStatusType;
@@ -36,7 +62,10 @@ export interface CreateInvoiceParams {
   businessId?: string;
   clientId?: string;
   currency: string;
-  amount: number;
+  /** Required unless lineItems is given; the server computes itemised totals. */
+  amount?: number;
+  lineItems?: InvoiceLineInput[];
+  discount?: InvoiceDiscount;
   cryptoCurrency?: string;
   dueDate?: string;
   notes?: string;
@@ -54,6 +83,9 @@ export interface ListInvoicesParams {
 
 export interface UpdateInvoiceParams {
   amount?: number;
+  /** Replace the lines; null turns itemising off. */
+  lineItems?: InvoiceLineInput[] | null;
+  discount?: InvoiceDiscount | null;
   currency?: string;
   cryptoCurrency?: string;
   dueDate?: string;
@@ -76,3 +108,42 @@ export function deleteInvoice(client: CoinPayClient, id: string): Promise<Record
 export function publishInvoice(client: CoinPayClient, id: string): Promise<Record<string, unknown>>;
 export function sendInvoice(client: CoinPayClient, id: string): Promise<Record<string, unknown>>;
 export function getInvoicePaymentData(client: CoinPayClient, id: string): Promise<Record<string, unknown>>;
+
+export interface TaxRate {
+  id: string;
+  business_id: string;
+  name: string;
+  rate: number;
+  is_default: boolean;
+}
+
+export interface InvoiceItem {
+  id: string;
+  business_id: string;
+  name: string;
+  description: string | null;
+  unit_price: number;
+  unit: string | null;
+  tax_rate_id: string | null;
+  archived: boolean;
+}
+
+export function listTaxRates(client: CoinPayClient, options?: { businessId?: string }): Promise<TaxRate[]>;
+export function createTaxRate(
+  client: CoinPayClient,
+  options: { businessId?: string; name: string; rate: number; isDefault?: boolean }
+): Promise<TaxRate>;
+export function deleteTaxRate(client: CoinPayClient, id: string): Promise<Record<string, unknown>>;
+export function listInvoiceItems(client: CoinPayClient, options?: { businessId?: string }): Promise<InvoiceItem[]>;
+export function createInvoiceItem(
+  client: CoinPayClient,
+  options: {
+    businessId?: string;
+    name: string;
+    unitPrice: number;
+    description?: string;
+    unit?: string;
+    taxRateId?: string;
+  }
+): Promise<InvoiceItem>;
+export function deleteInvoiceItem(client: CoinPayClient, id: string): Promise<Record<string, unknown>>;

package/src/invoices.js

@@ -35,7 +35,10 @@
  * @param {string} [options.businessId] - Business ID (optional for business-scoped API keys)
  * @param {string} [options.clientId] - Client ID (optional)
  * @param {string} options.currency - Fiat currency code (USD, EUR, etc.)
- * @param {number} options.amount - Invoice amount
+ * @param {number} [options.amount] - Invoice amount (omit when lineItems is given)
+ * @param {Array<{description: string, quantity: number, unit_price: number, tax_rate?: number, tax_name?: string, item_id?: string}>} [options.lineItems]
+ *   Itemised lines; the server computes the total from them
+ * @param {{type: 'percent'|'fixed', value: number}} [options.discount] - Invoice-level discount, applied before tax
  * @param {string} [options.cryptoCurrency] - Preferred crypto for payment
  * @param {string} [options.dueDate] - Due date (ISO string or YYYY-MM-DD)
  * @param {string} [options.notes] - Notes / description
@@ -48,6 +51,8 @@ export async function createInvoice(client, {
   clientId,
   currency,
   amount,
+  lineItems,
+  discount,
   cryptoCurrency,
   dueDate,
   notes,
@@ -57,8 +62,13 @@ export async function createInvoice(client, {
   const body = {
     business_id: businessId,
     currency,
-    amount,
   };
+  if (lineItems) {
+    body.line_items = lineItems;
+    if (discount) body.discount = discount;
+  } else {
+    body.amount = amount;
+  }
   if (clientId) body.client_id = clientId;
   if (cryptoCurrency) body.crypto_currency = cryptoCurrency;
   if (dueDate) body.due_date = dueDate;
@@ -124,7 +134,9 @@ export async function getInvoice(client, id) {
  * @param {CoinPayClient} client
  * @param {string} id - Invoice ID
  * @param {Object} updates - Partial invoice fields to update
- * @param {number} [updates.amount] - Updated amount
+ * @param {number} [updates.amount] - Updated amount (single-amount invoices only)
+ * @param {Array|null} [updates.lineItems] - Replace the lines (null turns itemising off)
+ * @param {Object|null} [updates.discount] - Replace the discount
  * @param {string} [updates.currency] - Updated currency
  * @param {string} [updates.cryptoCurrency] - Updated crypto currency
  * @param {string} [updates.dueDate] - Updated due date
@@ -137,6 +149,8 @@ export async function getInvoice(client, id) {
 export async function updateInvoice(client, id, updates) {
   const body = {};
   if (updates.amount !== undefined) body.amount = updates.amount;
+  if (updates.lineItems !== undefined) body.line_items = updates.lineItems;
+  if (updates.discount !== undefined) body.discount = updates.discount;
   if (updates.currency !== undefined) body.currency = updates.currency;
   if (updates.cryptoCurrency !== undefined) body.crypto_currency = updates.cryptoCurrency;
   if (updates.dueDate !== undefined) body.due_date = updates.dueDate;
@@ -233,6 +247,11 @@ function normalizeInvoice(data) {
     clientId: invoice.client_id,
     currency: invoice.currency,
     amount: invoice.amount,
+    lineItems: invoice.line_items,
+    subtotal: invoice.subtotal,
+    discount: invoice.discount,
+    discountTotal: invoice.discount_total,
+    taxTotal: invoice.tax_total,
     cryptoCurrency: invoice.crypto_currency,
     cryptoAmount: invoice.crypto_amount,
     status: invoice.status,
@@ -248,3 +267,52 @@ function normalizeInvoice(data) {
     updatedAt: invoice.updated_at,
   };
 }
+
+// ---------------------------------------------------------------------------
+// Catalog: saved tax rates and products/services for itemised invoices.
+// An API key is locked to its own business, so businessId is optional there.
+// ---------------------------------------------------------------------------
+
+function businessQuery(businessId) {
+  return businessId ? '?business_id=' + encodeURIComponent(businessId) : '';
+}
+
+/** List a business's saved tax rates. */
+export async function listTaxRates(client, { businessId } = {}) {
+  const data = await client.request('/tax-rates' + businessQuery(businessId));
+  return data.tax_rates ?? [];
+}
+
+/** Save a tax rate (percent, up to three decimals). */
+export async function createTaxRate(client, { businessId, name, rate, isDefault }) {
+  const body = { name, rate };
+  if (businessId) body.business_id = businessId;
+  if (isDefault !== undefined) body.is_default = isDefault;
+  const data = await client.request('/tax-rates', { method: 'POST', body: JSON.stringify(body) });
+  return data.tax_rate;
+}
+
+export async function deleteTaxRate(client, id) {
+  return client.request('/tax-rates/' + encodeURIComponent(id), { method: 'DELETE' });
+}
+
+/** List a business's saved products and services. */
+export async function listInvoiceItems(client, { businessId } = {}) {
+  const data = await client.request('/invoice-items' + businessQuery(businessId));
+  return data.invoice_items ?? [];
+}
+
+/** Save a product or service to bill again later. */
+export async function createInvoiceItem(client, { businessId, name, unitPrice, description, unit, taxRateId }) {
+  const body = { name, unit_price: unitPrice };
+  if (businessId) body.business_id = businessId;
+  if (description) body.description = description;
+  if (unit) body.unit = unit;
+  if (taxRateId) body.tax_rate_id = taxRateId;
+  const data = await client.request('/invoice-items', { method: 'POST', body: JSON.stringify(body) });
+  return data.invoice_item;
+}
+
+export async function deleteInvoiceItem(client, id) {
+  return client.request('/invoice-items/' + encodeURIComponent(id), { method: 'DELETE' });
+}

package/src/x402.js

@@ -2,7 +2,7 @@
  * x402 Payment Protocol Support
  * 
  * CoinPayPortal as the first multi-chain, multi-asset x402 facilitator.
- * Supports native crypto (BTC, ETH, SOL, POL), USDC stablecoins,
+ * Supports native crypto (BTC, ETH, SOL, POL, XNO), USDC stablecoins,
  * Lightning (BOLT12), and Stripe fiat — all via HTTP 402.
  *
  * Note: Bitcoin Cash is intentionally not listed. The x402 settle path has no
@@ -92,6 +92,18 @@ export const PAYMENT_METHODS = {
     label: 'USDC on Base',
   },
 
+  // ── Nano ───────────────────────────────────────────────────────
+  // Opt-in: only advertised when `payTo` names a Nano address (`payTo.nano`
+  // or a `nano_` string) and an XNO amount can be quoted (`rates.XNO`, or a
+  // raw `amount`). The payer sends a block; the proof carries its `blockHash`.
+  xno: {
+    network: 'nano',
+    asset: 'XNO',
+    scheme: 'exact',
+    decimals: 30,
+    label: 'Nano (XNO)',
+  },
+
   // ── Lightning ──────────────────────────────────────────────────
   lightning: {
     network: 'lightning',
@@ -175,6 +187,14 @@ export function convertUsdToAssetAmount(amountUsd, methodKey, rates = {}) {
   if (!rate) throw new Error(`No exchange rate for ${method.asset}`);
 
   const assetAmount = amountUsd / rate;
+
+  if (method.network === 'nano') {
+    // 30 decimals is past float64's exact range, and String() of a number that
+    // large is exponent notation ("1e+27"), which no verifier parses. Quote to
+    // the nearest 10^-9 XNO and scale the rest in BigInt.
+    return (BigInt(Math.round(assetAmount * 1e9)) * 10n ** 21n).toString();
+  }
+
   const smallest = Math.round(assetAmount * Math.pow(10, method.decimals));
   return String(smallest);
 }
@@ -288,6 +308,8 @@ export function buildPaymentRequired(options) {
       addr = payTo;
     }
     if (!addr) continue; // skip methods where merchant has no address
+    // A single non-Nano address must not be advertised as a Nano payee.
+    if (method.network === 'nano' && !/^(nano|xrb)_/.test(addr)) continue;
 
     // Convert USD to asset amount
     let assetAmount;
@@ -329,6 +351,7 @@ function _networkToMethodKey(network) {
     polygon: 'pol',
     solana: 'sol',
     bitcoin: 'btc',
+    nano: 'xno',
     lightning: 'lightning',
     stripe: 'stripe',
   };