@t402/near 2.3.0

package/dist/cjs/exact-direct/server/index.js

@@ -0,0 +1,253 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/exact-direct/server/index.ts
+var server_exports = {};
+__export(server_exports, {
+  ExactDirectNearServer: () => ExactDirectNearServer,
+  registerExactDirectNearServer: () => registerExactDirectNearServer
+});
+module.exports = __toCommonJS(server_exports);
+
+// src/constants.ts
+var NEAR_MAINNET_CAIP2 = "near:mainnet";
+var NEAR_TESTNET_CAIP2 = "near:testnet";
+var NEAR_NETWORK_IDS = {
+  [NEAR_MAINNET_CAIP2]: "mainnet",
+  [NEAR_TESTNET_CAIP2]: "testnet"
+};
+var NEAR_MAINNET_RPC = "https://rpc.mainnet.near.org";
+var NEAR_TESTNET_RPC = "https://rpc.testnet.near.org";
+var NETWORK_RPC_ENDPOINTS = {
+  [NEAR_MAINNET_CAIP2]: NEAR_MAINNET_RPC,
+  [NEAR_TESTNET_CAIP2]: NEAR_TESTNET_RPC
+};
+var SCHEME_EXACT_DIRECT = "exact-direct";
+var MAX_TRANSACTION_AGE = 5 * 60 * 1e3;
+var NEAR_CAIP2_NAMESPACE = "near";
+
+// src/tokens.ts
+var TOKEN_REGISTRY = {
+  [NEAR_MAINNET_CAIP2]: [
+    {
+      // USDC on NEAR (Rainbow Bridge)
+      contractId: "17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1",
+      symbol: "USDC",
+      name: "USD Coin",
+      decimals: 6,
+      priority: 1
+    },
+    {
+      // USDT on NEAR
+      contractId: "usdt.tether-token.near",
+      symbol: "USDT",
+      name: "Tether USD",
+      decimals: 6,
+      priority: 2
+    }
+  ],
+  [NEAR_TESTNET_CAIP2]: [
+    {
+      // Fake USDC on testnet
+      contractId: "usdc.fakes.testnet",
+      symbol: "USDC",
+      name: "USD Coin (Testnet)",
+      decimals: 6,
+      priority: 1
+    }
+  ]
+};
+function getTokenConfig(network, symbol) {
+  const tokens = TOKEN_REGISTRY[network];
+  if (!tokens) return void 0;
+  return tokens.find((t) => t.symbol.toUpperCase() === symbol.toUpperCase());
+}
+function getDefaultToken(network) {
+  const tokens = TOKEN_REGISTRY[network];
+  if (!tokens || tokens.length === 0) return void 0;
+  return [...tokens].sort((a, b) => a.priority - b.priority)[0];
+}
+
+// src/utils.ts
+function normalizeNetwork(network) {
+  if (network.startsWith(`${NEAR_CAIP2_NAMESPACE}:`)) {
+    return network;
+  }
+  return `${NEAR_CAIP2_NAMESPACE}:${network}`;
+}
+function toTokenUnits(decimalAmount, decimals) {
+  const amount = typeof decimalAmount === "string" ? parseFloat(decimalAmount) : decimalAmount;
+  if (isNaN(amount)) {
+    throw new Error(`Invalid amount: ${decimalAmount}`);
+  }
+  const multiplier = 10 ** decimals;
+  return BigInt(Math.floor(amount * multiplier));
+}
+
+// src/exact-direct/server/scheme.ts
+var ExactDirectNearServer = class {
+  constructor(config = {}) {
+    this.scheme = SCHEME_EXACT_DIRECT;
+    this.moneyParsers = [];
+    this.config = config;
+  }
+  /**
+   * Register a custom money parser in the parser chain.
+   * Multiple parsers can be registered - they will be tried in registration order.
+   * Each parser receives a decimal amount (e.g., 1.50 for $1.50).
+   * If a parser returns null, the next parser in the chain will be tried.
+   * The default parser is always the final fallback.
+   *
+   * @param parser - Custom function to convert amount to AssetAmount (or null to skip)
+   * @returns The server instance for chaining
+   */
+  registerMoneyParser(parser) {
+    this.moneyParsers.push(parser);
+    return this;
+  }
+  /**
+   * Parses a price into an asset amount.
+   * If price is already an AssetAmount, returns it directly.
+   * If price is Money (string | number), parses to decimal and tries custom parsers.
+   * Falls back to default conversion if all custom parsers return null.
+   *
+   * @param price - The price to parse
+   * @param network - The network to use
+   * @returns Promise that resolves to the parsed asset amount
+   */
+  async parsePrice(price, network) {
+    const normalizedNetwork = normalizeNetwork(network);
+    if (typeof price === "object" && price !== null && "amount" in price) {
+      if (!price.asset) {
+        throw new Error(`Asset address must be specified for AssetAmount on network ${network}`);
+      }
+      return {
+        amount: price.amount,
+        asset: price.asset,
+        extra: price.extra || {}
+      };
+    }
+    const amount = this.parseMoneyToDecimal(price);
+    for (const parser of this.moneyParsers) {
+      const result = await parser(amount, normalizedNetwork);
+      if (result !== null) {
+        return result;
+      }
+    }
+    return this.defaultMoneyConversion(amount, normalizedNetwork);
+  }
+  /**
+   * Build payment requirements for this scheme/network combination.
+   *
+   * @param paymentRequirements - Base payment requirements with amount/asset already set
+   * @param supportedKind - The supported kind from facilitator's /supported endpoint
+   * @param extensionKeys - Extensions supported by the facilitator
+   * @returns Enhanced payment requirements ready to be sent to clients
+   */
+  async enhancePaymentRequirements(paymentRequirements, supportedKind, extensionKeys) {
+    void extensionKeys;
+    const extra = { ...paymentRequirements.extra };
+    if (supportedKind.extra?.assetSymbol) {
+      extra.assetSymbol = supportedKind.extra.assetSymbol;
+    }
+    if (supportedKind.extra?.assetDecimals) {
+      extra.assetDecimals = supportedKind.extra.assetDecimals;
+    }
+    return {
+      ...paymentRequirements,
+      extra
+    };
+  }
+  /**
+   * Parse Money (string | number) to a decimal number.
+   * Handles formats like "$1.50", "1.50", 1.50, etc.
+   */
+  parseMoneyToDecimal(money) {
+    if (typeof money === "number") {
+      return money;
+    }
+    const cleanMoney = money.replace(/^\$/, "").trim();
+    const amount = parseFloat(cleanMoney);
+    if (isNaN(amount)) {
+      throw new Error(`Invalid money format: ${money}`);
+    }
+    return amount;
+  }
+  /**
+   * Default money conversion implementation.
+   * Converts decimal amount to the preferred token on the specified network.
+   */
+  defaultMoneyConversion(amount, network) {
+    const token = this.getDefaultAsset(network);
+    const tokenAmount = toTokenUnits(amount, token.decimals);
+    return {
+      amount: tokenAmount.toString(),
+      asset: token.contractId,
+      extra: {
+        symbol: token.symbol,
+        name: token.name,
+        decimals: token.decimals
+      }
+    };
+  }
+  /**
+   * Get the default asset info for a network.
+   * Priority: configured preferredToken > network default
+   */
+  getDefaultAsset(network) {
+    if (this.config.preferredToken) {
+      const preferred = getTokenConfig(network, this.config.preferredToken);
+      if (preferred) return preferred;
+    }
+    const defaultToken = getDefaultToken(network);
+    if (defaultToken) return defaultToken;
+    throw new Error(`No tokens configured for network ${network}`);
+  }
+  /**
+   * Get all supported networks
+   */
+  static getSupportedNetworks() {
+    return Object.keys(TOKEN_REGISTRY);
+  }
+  /**
+   * Check if a network is supported
+   */
+  static isNetworkSupported(network) {
+    return network in TOKEN_REGISTRY;
+  }
+};
+
+// src/exact-direct/server/register.ts
+function registerExactDirectNearServer(server, config = {}) {
+  const scheme = new ExactDirectNearServer(config.schemeConfig);
+  if (config.networks && config.networks.length > 0) {
+    config.networks.forEach((network) => {
+      server.register(network, scheme);
+    });
+  } else {
+    server.register("near:*", scheme);
+  }
+  return server;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ExactDirectNearServer,
+  registerExactDirectNearServer
+});
+//# sourceMappingURL=index.js.map

package/dist/cjs/exact-direct/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/exact-direct/server/index.ts","../../../../src/constants.ts","../../../../src/tokens.ts","../../../../src/utils.ts","../../../../src/exact-direct/server/scheme.ts","../../../../src/exact-direct/server/register.ts"],"sourcesContent":["/**\n * NEAR Exact-Direct Server Exports\n */\n\nexport { ExactDirectNearServer, type ExactDirectNearServerConfig } from \"./scheme.js\";\nexport { registerExactDirectNearServer, type NearResourceServerConfig } from \"./register.js\";\n","/**\n * NEAR Network Constants\n *\n * This module provides constants for NEAR blockchain integration including:\n * - CAIP-2 network identifiers\n * - RPC endpoints\n * - NEP-141 function names\n * - Default gas amounts\n */\n\n/**\n * CAIP-2 Network Identifiers for NEAR\n */\nexport const NEAR_MAINNET_CAIP2 = \"near:mainnet\";\nexport const NEAR_TESTNET_CAIP2 = \"near:testnet\";\n\n/**\n * Supported NEAR networks\n */\nexport const NEAR_NETWORKS = [NEAR_MAINNET_CAIP2, NEAR_TESTNET_CAIP2] as const;\n\nexport type NearNetwork = (typeof NEAR_NETWORKS)[number];\n\n/**\n * NEAR network IDs (for wallet connection)\n */\nexport const NEAR_NETWORK_IDS: Record<string, string> = {\n  [NEAR_MAINNET_CAIP2]: \"mainnet\",\n  [NEAR_TESTNET_CAIP2]: \"testnet\",\n};\n\n/**\n * Default RPC endpoints\n */\nexport const NEAR_MAINNET_RPC = \"https://rpc.mainnet.near.org\";\nexport const NEAR_TESTNET_RPC = \"https://rpc.testnet.near.org\";\n\n/**\n * Network RPC endpoint mapping\n */\nexport const NETWORK_RPC_ENDPOINTS: Record<string, string> = {\n  [NEAR_MAINNET_CAIP2]: NEAR_MAINNET_RPC,\n  [NEAR_TESTNET_CAIP2]: NEAR_TESTNET_RPC,\n};\n\n/**\n * NEP-141 Fungible Token Standard function names\n * @see https://nomicon.io/Standards/Tokens/FungibleToken/Core\n */\nexport const NEP141_FT_TRANSFER = \"ft_transfer\";\nexport const NEP141_FT_BALANCE_OF = \"ft_balance_of\";\nexport const NEP141_STORAGE_DEPOSIT = \"storage_deposit\";\nexport const NEP141_STORAGE_BALANCE_OF = \"storage_balance_of\";\n\n/**\n * Default gas amounts for NEP-141 transfers\n * NEAR gas is measured in TGas (1 TGas = 10^12 gas)\n */\nexport const DEFAULT_FT_TRANSFER_GAS = \"30000000000000\"; // 30 TGas\nexport const DEFAULT_STORAGE_DEPOSIT_GAS = \"10000000000000\"; // 10 TGas\n\n/**\n * Required deposits for NEP-141 operations\n * ft_transfer requires 1 yoctoNEAR attached deposit\n */\nexport const FT_TRANSFER_DEPOSIT = \"1\"; // 1 yoctoNEAR\nexport const DEFAULT_STORAGE_DEPOSIT = \"1250000000000000000000\"; // 0.00125 NEAR\n\n/**\n * Scheme identifier for exact-direct payments\n */\nexport const SCHEME_EXACT_DIRECT = \"exact-direct\";\n\n/**\n * Default timeout for payment validity (in seconds)\n */\nexport const DEFAULT_VALIDITY_DURATION = 3600; // 1 hour\n\n/**\n * Maximum transaction age to accept (in milliseconds)\n */\nexport const MAX_TRANSACTION_AGE = 5 * 60 * 1000; // 5 minutes\n\n/**\n * CAIP-2 namespace for NEAR\n */\nexport const NEAR_CAIP2_NAMESPACE = \"near\";\n","/**\n * NEAR Token Registry\n *\n * Defines supported tokens (NEP-141 fungible tokens) for each NEAR network.\n */\n\nimport { NEAR_MAINNET_CAIP2, NEAR_TESTNET_CAIP2 } from \"./constants.js\";\n\n/**\n * Token configuration\n */\nexport interface TokenConfig {\n  /** Contract address/account ID */\n  contractId: string;\n  /** Token symbol */\n  symbol: string;\n  /** Token name */\n  name: string;\n  /** Decimal places */\n  decimals: number;\n  /** Priority for selection (lower = higher priority) */\n  priority: number;\n}\n\n/**\n * Token registry by network\n */\nexport const TOKEN_REGISTRY: Record<string, TokenConfig[]> = {\n  [NEAR_MAINNET_CAIP2]: [\n    {\n      // USDC on NEAR (Rainbow Bridge)\n      contractId: \"17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1\",\n      symbol: \"USDC\",\n      name: \"USD Coin\",\n      decimals: 6,\n      priority: 1,\n    },\n    {\n      // USDT on NEAR\n      contractId: \"usdt.tether-token.near\",\n      symbol: \"USDT\",\n      name: \"Tether USD\",\n      decimals: 6,\n      priority: 2,\n    },\n  ],\n  [NEAR_TESTNET_CAIP2]: [\n    {\n      // Fake USDC on testnet\n      contractId: \"usdc.fakes.testnet\",\n      symbol: \"USDC\",\n      name: \"USD Coin (Testnet)\",\n      decimals: 6,\n      priority: 1,\n    },\n  ],\n};\n\n/**\n * Get token configuration by symbol\n * @param network - CAIP-2 network identifier\n * @param symbol - Token symbol (e.g., \"USDC\")\n * @returns Token configuration or undefined\n */\nexport function getTokenConfig(network: string, symbol: string): TokenConfig | undefined {\n  const tokens = TOKEN_REGISTRY[network];\n  if (!tokens) return undefined;\n  return tokens.find((t) => t.symbol.toUpperCase() === symbol.toUpperCase());\n}\n\n/**\n * Get token configuration by contract ID\n * @param network - CAIP-2 network identifier\n * @param contractId - Token contract account ID\n * @returns Token configuration or undefined\n */\nexport function getTokenByContract(network: string, contractId: string): TokenConfig | undefined {\n  const tokens = TOKEN_REGISTRY[network];\n  if (!tokens) return undefined;\n  return tokens.find((t) => t.contractId === contractId);\n}\n\n/**\n * Get the default token for a network\n * Returns the token with highest priority (lowest priority number)\n * @param network - CAIP-2 network identifier\n * @returns Default token configuration or undefined\n */\nexport function getDefaultToken(network: string): TokenConfig | undefined {\n  const tokens = TOKEN_REGISTRY[network];\n  if (!tokens || tokens.length === 0) return undefined;\n  return [...tokens].sort((a, b) => a.priority - b.priority)[0];\n}\n\n/**\n * Get all tokens for a network\n * @param network - CAIP-2 network identifier\n * @returns Array of token configurations\n */\nexport function getNetworkTokens(network: string): TokenConfig[] {\n  return TOKEN_REGISTRY[network] || [];\n}\n\n/**\n * Check if a network is supported\n * @param network - CAIP-2 network identifier\n */\nexport function isNetworkSupported(network: string): boolean {\n  return network in TOKEN_REGISTRY;\n}\n","/**\n * NEAR Utility Functions\n *\n * Helper functions for NEAR address validation, network normalization,\n * and RPC interactions.\n */\n\nimport { NEAR_CAIP2_NAMESPACE, NETWORK_RPC_ENDPOINTS, type NearNetwork } from \"./constants.js\";\nimport type {\n  NearRpcRequest,\n  NearRpcResponse,\n  TransactionResult,\n  FtTransferArgs,\n} from \"./types.js\";\n\n/**\n * Normalize a network identifier to CAIP-2 format\n * @param network - Network identifier (e.g., \"mainnet\", \"near:mainnet\")\n * @returns CAIP-2 formatted network identifier\n */\nexport function normalizeNetwork(network: string): NearNetwork {\n  // Already in CAIP-2 format\n  if (network.startsWith(`${NEAR_CAIP2_NAMESPACE}:`)) {\n    return network as NearNetwork;\n  }\n  // Convert shorthand to CAIP-2\n  return `${NEAR_CAIP2_NAMESPACE}:${network}` as NearNetwork;\n}\n\n/**\n * Extract network ID from CAIP-2 identifier\n * @param network - CAIP-2 network identifier\n * @returns Network ID (e.g., \"mainnet\")\n */\nexport function extractNetworkId(network: string): string {\n  if (network.includes(\":\")) {\n    return network.split(\":\")[1];\n  }\n  return network;\n}\n\n/**\n * Validate a NEAR account ID\n * NEAR account IDs must:\n * - Be 2-64 characters\n * - Contain only lowercase alphanumeric, underscores, hyphens\n * - Not start with a hyphen or underscore\n * @param accountId - Account ID to validate\n * @returns Whether the account ID is valid\n */\nexport function isValidAccountId(accountId: string): boolean {\n  if (!accountId || accountId.length < 2 || accountId.length > 64) {\n    return false;\n  }\n  // NEAR account ID regex\n  const regex = /^[a-z0-9]([a-z0-9_-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9_-]*[a-z0-9])?)*$/;\n  return regex.test(accountId);\n}\n\n/**\n * Get RPC endpoint for a network\n * @param network - CAIP-2 network identifier\n * @returns RPC endpoint URL\n */\nexport function getRpcEndpoint(network: string): string {\n  const normalizedNetwork = normalizeNetwork(network);\n  return NETWORK_RPC_ENDPOINTS[normalizedNetwork] || NETWORK_RPC_ENDPOINTS[\"near:mainnet\"];\n}\n\n/**\n * Make a JSON-RPC call to NEAR\n * @param network - CAIP-2 network identifier\n * @param method - RPC method name\n * @param params - Method parameters\n * @returns RPC response result\n */\nexport async function rpcCall<T>(\n  network: string,\n  method: string,\n  params: NearRpcRequest[\"params\"],\n): Promise<T> {\n  const endpoint = getRpcEndpoint(network);\n\n  const request: NearRpcRequest = {\n    jsonrpc: \"2.0\",\n    id: `t402-${Date.now()}`,\n    method,\n    params,\n  };\n\n  const response = await fetch(endpoint, {\n    method: \"POST\",\n    headers: { \"Content-Type\": \"application/json\" },\n    body: JSON.stringify(request),\n  });\n\n  const data = (await response.json()) as NearRpcResponse<T>;\n\n  if (data.error) {\n    throw new Error(`NEAR RPC error: ${data.error.message}`);\n  }\n\n  return data.result as T;\n}\n\n/**\n * Query a transaction by hash\n * @param network - CAIP-2 network identifier\n * @param txHash - Transaction hash\n * @param senderAccountId - Sender account ID\n * @returns Transaction result\n */\nexport async function queryTransaction(\n  network: string,\n  txHash: string,\n  senderAccountId: string,\n): Promise<TransactionResult> {\n  return rpcCall<TransactionResult>(network, \"tx\", [txHash, senderAccountId]);\n}\n\n/**\n * Query token balance\n * @param network - CAIP-2 network identifier\n * @param accountId - Account to query\n * @param tokenContract - Token contract address\n * @returns Balance as bigint\n */\nexport async function queryTokenBalance(\n  network: string,\n  accountId: string,\n  tokenContract: string,\n): Promise<bigint> {\n  try {\n    const result = await rpcCall<{ result: number[] }>(network, \"query\", {\n      request_type: \"call_function\",\n      finality: \"final\",\n      account_id: tokenContract,\n      method_name: \"ft_balance_of\",\n      args_base64: btoa(JSON.stringify({ account_id: accountId })),\n    });\n\n    // Result is a byte array representing the JSON response\n    const bytes = new Uint8Array(result.result);\n    const text = new TextDecoder().decode(bytes);\n    // Remove quotes from JSON string response\n    const balance = text.replace(/\"/g, \"\");\n    return BigInt(balance);\n  } catch (error) {\n    console.error(\"Error fetching token balance:\", error);\n    return 0n;\n  }\n}\n\n/**\n * Parse ft_transfer args from base64 encoded string\n * @param argsBase64 - Base64 encoded JSON arguments\n * @returns Parsed ft_transfer arguments\n */\nexport function parseFtTransferArgs(argsBase64: string): FtTransferArgs | null {\n  try {\n    const argsJson = atob(argsBase64);\n    return JSON.parse(argsJson) as FtTransferArgs;\n  } catch {\n    // Try parsing as raw JSON (some nodes return it differently)\n    try {\n      return JSON.parse(argsBase64) as FtTransferArgs;\n    } catch {\n      return null;\n    }\n  }\n}\n\n/**\n * Check if a transaction succeeded\n * @param status - Transaction status\n * @returns Whether the transaction succeeded\n */\nexport function isTransactionSuccessful(status: {\n  SuccessValue?: string;\n  Failure?: unknown;\n}): boolean {\n  return status.SuccessValue !== undefined && status.Failure === undefined;\n}\n\n/**\n * Format amount for display (with decimals)\n * @param amount - Amount in smallest units\n * @param decimals - Number of decimal places\n * @returns Formatted amount string\n */\nexport function formatAmount(amount: bigint, decimals: number): string {\n  const divisor = BigInt(10 ** decimals);\n  const whole = amount / divisor;\n  const remainder = amount % divisor;\n  const decimal = remainder.toString().padStart(decimals, \"0\").slice(0, 2);\n  return `${whole}.${decimal}`;\n}\n\n/**\n * Convert decimal amount to token units\n * @param decimalAmount - Amount with decimals (e.g., \"1.50\")\n * @param decimals - Token decimals\n * @returns Amount in smallest units\n */\nexport function toTokenUnits(decimalAmount: string | number, decimals: number): bigint {\n  const amount = typeof decimalAmount === \"string\" ? parseFloat(decimalAmount) : decimalAmount;\n  if (isNaN(amount)) {\n    throw new Error(`Invalid amount: ${decimalAmount}`);\n  }\n  const multiplier = 10 ** decimals;\n  return BigInt(Math.floor(amount * multiplier));\n}\n","/**\n * NEAR Server Scheme Implementation - Exact Direct\n *\n * Handles price parsing and payment requirement enhancement for\n * NEAR NEP-141 payments using the exact-direct scheme.\n */\n\nimport type {\n  AssetAmount,\n  Network,\n  PaymentRequirements,\n  Price,\n  SchemeNetworkServer,\n  MoneyParser,\n} from \"@t402/core/types\";\nimport { SCHEME_EXACT_DIRECT } from \"../../constants.js\";\nimport { getDefaultToken, getTokenConfig, TOKEN_REGISTRY } from \"../../tokens.js\";\nimport { normalizeNetwork, toTokenUnits } from \"../../utils.js\";\n\n/**\n * Configuration options for ExactDirectNearServer\n */\nexport interface ExactDirectNearServerConfig {\n  /** Preferred token symbol (e.g., \"USDC\"). Defaults to network's highest priority token. */\n  preferredToken?: string;\n}\n\n/**\n * NEAR server implementation for the Exact-Direct payment scheme.\n * Handles price parsing and converts user-friendly amounts to token amounts.\n */\nexport class ExactDirectNearServer implements SchemeNetworkServer {\n  readonly scheme = SCHEME_EXACT_DIRECT;\n  private moneyParsers: MoneyParser[] = [];\n  private config: ExactDirectNearServerConfig;\n\n  constructor(config: ExactDirectNearServerConfig = {}) {\n    this.config = config;\n  }\n\n  /**\n   * Register a custom money parser in the parser chain.\n   * Multiple parsers can be registered - they will be tried in registration order.\n   * Each parser receives a decimal amount (e.g., 1.50 for $1.50).\n   * If a parser returns null, the next parser in the chain will be tried.\n   * The default parser is always the final fallback.\n   *\n   * @param parser - Custom function to convert amount to AssetAmount (or null to skip)\n   * @returns The server instance for chaining\n   */\n  registerMoneyParser(parser: MoneyParser): ExactDirectNearServer {\n    this.moneyParsers.push(parser);\n    return this;\n  }\n\n  /**\n   * Parses a price into an asset amount.\n   * If price is already an AssetAmount, returns it directly.\n   * If price is Money (string | number), parses to decimal and tries custom parsers.\n   * Falls back to default conversion if all custom parsers return null.\n   *\n   * @param price - The price to parse\n   * @param network - The network to use\n   * @returns Promise that resolves to the parsed asset amount\n   */\n  async parsePrice(price: Price, network: Network): Promise<AssetAmount> {\n    // Normalize network to CAIP-2 format\n    const normalizedNetwork = normalizeNetwork(network);\n\n    // If already an AssetAmount, return it directly\n    if (typeof price === \"object\" && price !== null && \"amount\" in price) {\n      if (!price.asset) {\n        throw new Error(`Asset address must be specified for AssetAmount on network ${network}`);\n      }\n      return {\n        amount: price.amount,\n        asset: price.asset,\n        extra: price.extra || {},\n      };\n    }\n\n    // Parse Money to decimal number\n    const amount = this.parseMoneyToDecimal(price);\n\n    // Try each custom money parser in order\n    for (const parser of this.moneyParsers) {\n      const result = await parser(amount, normalizedNetwork);\n      if (result !== null) {\n        return result;\n      }\n    }\n\n    // All custom parsers returned null, use default conversion\n    return this.defaultMoneyConversion(amount, normalizedNetwork);\n  }\n\n  /**\n   * Build payment requirements for this scheme/network combination.\n   *\n   * @param paymentRequirements - Base payment requirements with amount/asset already set\n   * @param supportedKind - The supported kind from facilitator's /supported endpoint\n   * @param extensionKeys - Extensions supported by the facilitator\n   * @returns Enhanced payment requirements ready to be sent to clients\n   */\n  async enhancePaymentRequirements(\n    paymentRequirements: PaymentRequirements,\n    supportedKind: {\n      t402Version: number;\n      scheme: string;\n      network: Network;\n      extra?: Record<string, unknown>;\n    },\n    extensionKeys: string[],\n  ): Promise<PaymentRequirements> {\n    // Mark unused parameters to satisfy linter\n    void extensionKeys;\n\n    // Start with existing extra fields\n    const extra = { ...paymentRequirements.extra };\n\n    // Add any facilitator-provided extra fields\n    if (supportedKind.extra?.assetSymbol) {\n      extra.assetSymbol = supportedKind.extra.assetSymbol;\n    }\n    if (supportedKind.extra?.assetDecimals) {\n      extra.assetDecimals = supportedKind.extra.assetDecimals;\n    }\n\n    return {\n      ...paymentRequirements,\n      extra,\n    };\n  }\n\n  /**\n   * Parse Money (string | number) to a decimal number.\n   * Handles formats like \"$1.50\", \"1.50\", 1.50, etc.\n   */\n  private parseMoneyToDecimal(money: string | number): number {\n    if (typeof money === \"number\") {\n      return money;\n    }\n\n    // Remove $ sign and whitespace, then parse\n    const cleanMoney = money.replace(/^\\$/, \"\").trim();\n    const amount = parseFloat(cleanMoney);\n\n    if (isNaN(amount)) {\n      throw new Error(`Invalid money format: ${money}`);\n    }\n\n    return amount;\n  }\n\n  /**\n   * Default money conversion implementation.\n   * Converts decimal amount to the preferred token on the specified network.\n   */\n  private defaultMoneyConversion(amount: number, network: Network): AssetAmount {\n    const token = this.getDefaultAsset(network);\n\n    // Convert decimal amount to token amount\n    const tokenAmount = toTokenUnits(amount, token.decimals);\n\n    return {\n      amount: tokenAmount.toString(),\n      asset: token.contractId,\n      extra: {\n        symbol: token.symbol,\n        name: token.name,\n        decimals: token.decimals,\n      },\n    };\n  }\n\n  /**\n   * Get the default asset info for a network.\n   * Priority: configured preferredToken > network default\n   */\n  private getDefaultAsset(network: Network): {\n    contractId: string;\n    symbol: string;\n    name: string;\n    decimals: number;\n  } {\n    // If a preferred token is configured, try to use it\n    if (this.config.preferredToken) {\n      const preferred = getTokenConfig(network, this.config.preferredToken);\n      if (preferred) return preferred;\n    }\n\n    // Use the network's default token (sorted by priority)\n    const defaultToken = getDefaultToken(network);\n    if (defaultToken) return defaultToken;\n\n    throw new Error(`No tokens configured for network ${network}`);\n  }\n\n  /**\n   * Get all supported networks\n   */\n  static getSupportedNetworks(): string[] {\n    return Object.keys(TOKEN_REGISTRY);\n  }\n\n  /**\n   * Check if a network is supported\n   */\n  static isNetworkSupported(network: string): boolean {\n    return network in TOKEN_REGISTRY;\n  }\n}\n","/**\n * Registration function for NEAR Exact-Direct server\n */\n\nimport { t402ResourceServer } from \"@t402/core/server\";\nimport { Network } from \"@t402/core/types\";\nimport { ExactDirectNearServer, type ExactDirectNearServerConfig } from \"./scheme.js\";\n\n/**\n * Configuration options for registering NEAR schemes to a t402ResourceServer\n */\nexport interface NearResourceServerConfig {\n  /**\n   * Optional specific networks to register\n   * If not provided, registers wildcard support (near:*)\n   */\n  networks?: Network[];\n\n  /**\n   * Optional scheme configuration (preferred token, etc.)\n   */\n  schemeConfig?: ExactDirectNearServerConfig;\n}\n\n/**\n * Registers NEAR exact-direct payment schemes to a t402ResourceServer instance.\n *\n * @param server - The t402ResourceServer instance to register schemes to\n * @param config - Configuration for NEAR resource server registration\n * @returns The server instance for chaining\n *\n * @example\n * ```typescript\n * import { registerExactDirectNearServer } from \"@t402/near/exact-direct/server\";\n * import { t402ResourceServer } from \"@t402/core/server\";\n *\n * const server = new t402ResourceServer(facilitatorClient);\n * registerExactDirectNearServer(server, {});\n *\n * // Or with specific token preference\n * registerExactDirectNearServer(server, {\n *   schemeConfig: { preferredToken: \"USDT\" }\n * });\n * ```\n */\nexport function registerExactDirectNearServer(\n  server: t402ResourceServer,\n  config: NearResourceServerConfig = {},\n): t402ResourceServer {\n  const scheme = new ExactDirectNearServer(config.schemeConfig);\n\n  // Register scheme\n  if (config.networks && config.networks.length > 0) {\n    // Register specific networks\n    config.networks.forEach((network) => {\n      server.register(network, scheme);\n    });\n  } else {\n    // Register wildcard for all NEAR networks\n    server.register(\"near:*\", scheme);\n  }\n\n  return server;\n}\n"],"mappings":"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","names":[]}

package/dist/cjs/index.d.ts

@@ -0,0 +1,226 @@
+import { N as NearRpcRequest, T as TransactionResult, F as FtTransferArgs } from './types-Ca7ztL_f.js';
+export { C as ClientNearSigner, E as ExactDirectNearPayload, f as FacilitatorNearSigner, c as FunctionCallAction, e as NearRpcResponse, d as NearTransaction, b as TransactionOutcome, a as TransactionStatus, V as VerifyTransactionResult } from './types-Ca7ztL_f.js';
+export { ExactDirectNearClient, ExactDirectNearClientConfig, NearClientConfig, registerExactDirectNearClient } from './exact-direct/client/index.js';
+export { ExactDirectNearServer, ExactDirectNearServerConfig, NearResourceServerConfig, registerExactDirectNearServer } from './exact-direct/server/index.js';
+export { ExactDirectNearFacilitator, ExactDirectNearFacilitatorConfig, NearFacilitatorConfig, registerExactDirectNearFacilitator } from './exact-direct/facilitator/index.js';
+import '@t402/core/types';
+import '@t402/core/client';
+import '@t402/core/server';
+import '@t402/core/facilitator';
+
+/**
+ * NEAR Network Constants
+ *
+ * This module provides constants for NEAR blockchain integration including:
+ * - CAIP-2 network identifiers
+ * - RPC endpoints
+ * - NEP-141 function names
+ * - Default gas amounts
+ */
+/**
+ * CAIP-2 Network Identifiers for NEAR
+ */
+declare const NEAR_MAINNET_CAIP2 = "near:mainnet";
+declare const NEAR_TESTNET_CAIP2 = "near:testnet";
+/**
+ * Supported NEAR networks
+ */
+declare const NEAR_NETWORKS: readonly ["near:mainnet", "near:testnet"];
+type NearNetwork = (typeof NEAR_NETWORKS)[number];
+/**
+ * NEAR network IDs (for wallet connection)
+ */
+declare const NEAR_NETWORK_IDS: Record<string, string>;
+/**
+ * Default RPC endpoints
+ */
+declare const NEAR_MAINNET_RPC = "https://rpc.mainnet.near.org";
+declare const NEAR_TESTNET_RPC = "https://rpc.testnet.near.org";
+/**
+ * Network RPC endpoint mapping
+ */
+declare const NETWORK_RPC_ENDPOINTS: Record<string, string>;
+/**
+ * NEP-141 Fungible Token Standard function names
+ * @see https://nomicon.io/Standards/Tokens/FungibleToken/Core
+ */
+declare const NEP141_FT_TRANSFER = "ft_transfer";
+declare const NEP141_FT_BALANCE_OF = "ft_balance_of";
+declare const NEP141_STORAGE_DEPOSIT = "storage_deposit";
+declare const NEP141_STORAGE_BALANCE_OF = "storage_balance_of";
+/**
+ * Default gas amounts for NEP-141 transfers
+ * NEAR gas is measured in TGas (1 TGas = 10^12 gas)
+ */
+declare const DEFAULT_FT_TRANSFER_GAS = "30000000000000";
+declare const DEFAULT_STORAGE_DEPOSIT_GAS = "10000000000000";
+/**
+ * Required deposits for NEP-141 operations
+ * ft_transfer requires 1 yoctoNEAR attached deposit
+ */
+declare const FT_TRANSFER_DEPOSIT = "1";
+declare const DEFAULT_STORAGE_DEPOSIT = "1250000000000000000000";
+/**
+ * Scheme identifier for exact-direct payments
+ */
+declare const SCHEME_EXACT_DIRECT = "exact-direct";
+/**
+ * Default timeout for payment validity (in seconds)
+ */
+declare const DEFAULT_VALIDITY_DURATION = 3600;
+/**
+ * Maximum transaction age to accept (in milliseconds)
+ */
+declare const MAX_TRANSACTION_AGE: number;
+/**
+ * CAIP-2 namespace for NEAR
+ */
+declare const NEAR_CAIP2_NAMESPACE = "near";
+
+/**
+ * NEAR Token Registry
+ *
+ * Defines supported tokens (NEP-141 fungible tokens) for each NEAR network.
+ */
+/**
+ * Token configuration
+ */
+interface TokenConfig {
+    /** Contract address/account ID */
+    contractId: string;
+    /** Token symbol */
+    symbol: string;
+    /** Token name */
+    name: string;
+    /** Decimal places */
+    decimals: number;
+    /** Priority for selection (lower = higher priority) */
+    priority: number;
+}
+/**
+ * Token registry by network
+ */
+declare const TOKEN_REGISTRY: Record<string, TokenConfig[]>;
+/**
+ * Get token configuration by symbol
+ * @param network - CAIP-2 network identifier
+ * @param symbol - Token symbol (e.g., "USDC")
+ * @returns Token configuration or undefined
+ */
+declare function getTokenConfig(network: string, symbol: string): TokenConfig | undefined;
+/**
+ * Get token configuration by contract ID
+ * @param network - CAIP-2 network identifier
+ * @param contractId - Token contract account ID
+ * @returns Token configuration or undefined
+ */
+declare function getTokenByContract(network: string, contractId: string): TokenConfig | undefined;
+/**
+ * Get the default token for a network
+ * Returns the token with highest priority (lowest priority number)
+ * @param network - CAIP-2 network identifier
+ * @returns Default token configuration or undefined
+ */
+declare function getDefaultToken(network: string): TokenConfig | undefined;
+/**
+ * Get all tokens for a network
+ * @param network - CAIP-2 network identifier
+ * @returns Array of token configurations
+ */
+declare function getNetworkTokens(network: string): TokenConfig[];
+/**
+ * Check if a network is supported
+ * @param network - CAIP-2 network identifier
+ */
+declare function isNetworkSupported(network: string): boolean;
+
+/**
+ * NEAR Utility Functions
+ *
+ * Helper functions for NEAR address validation, network normalization,
+ * and RPC interactions.
+ */
+
+/**
+ * Normalize a network identifier to CAIP-2 format
+ * @param network - Network identifier (e.g., "mainnet", "near:mainnet")
+ * @returns CAIP-2 formatted network identifier
+ */
+declare function normalizeNetwork(network: string): NearNetwork;
+/**
+ * Extract network ID from CAIP-2 identifier
+ * @param network - CAIP-2 network identifier
+ * @returns Network ID (e.g., "mainnet")
+ */
+declare function extractNetworkId(network: string): string;
+/**
+ * Validate a NEAR account ID
+ * NEAR account IDs must:
+ * - Be 2-64 characters
+ * - Contain only lowercase alphanumeric, underscores, hyphens
+ * - Not start with a hyphen or underscore
+ * @param accountId - Account ID to validate
+ * @returns Whether the account ID is valid
+ */
+declare function isValidAccountId(accountId: string): boolean;
+/**
+ * Get RPC endpoint for a network
+ * @param network - CAIP-2 network identifier
+ * @returns RPC endpoint URL
+ */
+declare function getRpcEndpoint(network: string): string;
+/**
+ * Make a JSON-RPC call to NEAR
+ * @param network - CAIP-2 network identifier
+ * @param method - RPC method name
+ * @param params - Method parameters
+ * @returns RPC response result
+ */
+declare function rpcCall<T>(network: string, method: string, params: NearRpcRequest["params"]): Promise<T>;
+/**
+ * Query a transaction by hash
+ * @param network - CAIP-2 network identifier
+ * @param txHash - Transaction hash
+ * @param senderAccountId - Sender account ID
+ * @returns Transaction result
+ */
+declare function queryTransaction(network: string, txHash: string, senderAccountId: string): Promise<TransactionResult>;
+/**
+ * Query token balance
+ * @param network - CAIP-2 network identifier
+ * @param accountId - Account to query
+ * @param tokenContract - Token contract address
+ * @returns Balance as bigint
+ */
+declare function queryTokenBalance(network: string, accountId: string, tokenContract: string): Promise<bigint>;
+/**
+ * Parse ft_transfer args from base64 encoded string
+ * @param argsBase64 - Base64 encoded JSON arguments
+ * @returns Parsed ft_transfer arguments
+ */
+declare function parseFtTransferArgs(argsBase64: string): FtTransferArgs | null;
+/**
+ * Check if a transaction succeeded
+ * @param status - Transaction status
+ * @returns Whether the transaction succeeded
+ */
+declare function isTransactionSuccessful(status: {
+    SuccessValue?: string;
+    Failure?: unknown;
+}): boolean;
+/**
+ * Format amount for display (with decimals)
+ * @param amount - Amount in smallest units
+ * @param decimals - Number of decimal places
+ * @returns Formatted amount string
+ */
+declare function formatAmount(amount: bigint, decimals: number): string;
+/**
+ * Convert decimal amount to token units
+ * @param decimalAmount - Amount with decimals (e.g., "1.50")
+ * @param decimals - Token decimals
+ * @returns Amount in smallest units
+ */
+declare function toTokenUnits(decimalAmount: string | number, decimals: number): bigint;
+
+export { DEFAULT_FT_TRANSFER_GAS, DEFAULT_STORAGE_DEPOSIT, DEFAULT_STORAGE_DEPOSIT_GAS, DEFAULT_VALIDITY_DURATION, FT_TRANSFER_DEPOSIT, FtTransferArgs, MAX_TRANSACTION_AGE, NEAR_CAIP2_NAMESPACE, NEAR_MAINNET_CAIP2, NEAR_MAINNET_RPC, NEAR_NETWORKS, NEAR_NETWORK_IDS, NEAR_TESTNET_CAIP2, NEAR_TESTNET_RPC, NEP141_FT_BALANCE_OF, NEP141_FT_TRANSFER, NEP141_STORAGE_BALANCE_OF, NEP141_STORAGE_DEPOSIT, NETWORK_RPC_ENDPOINTS, type NearNetwork, NearRpcRequest, SCHEME_EXACT_DIRECT, TOKEN_REGISTRY, type TokenConfig, TransactionResult, extractNetworkId, formatAmount, getDefaultToken, getNetworkTokens, getRpcEndpoint, getTokenByContract, getTokenConfig, isNetworkSupported, isTransactionSuccessful, isValidAccountId, normalizeNetwork, parseFtTransferArgs, queryTokenBalance, queryTransaction, rpcCall, toTokenUnits };