@t402/near 2.3.0

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

@@ -0,0 +1,304 @@
+"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/facilitator/index.ts
+var facilitator_exports = {};
+__export(facilitator_exports, {
+  ExactDirectNearFacilitator: () => ExactDirectNearFacilitator,
+  registerExactDirectNearFacilitator: () => registerExactDirectNearFacilitator
+});
+module.exports = __toCommonJS(facilitator_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/utils.ts
+function normalizeNetwork(network) {
+  if (network.startsWith(`${NEAR_CAIP2_NAMESPACE}:`)) {
+    return network;
+  }
+  return `${NEAR_CAIP2_NAMESPACE}:${network}`;
+}
+function isValidAccountId(accountId) {
+  if (!accountId || accountId.length < 2 || accountId.length > 64) {
+    return false;
+  }
+  const regex = /^[a-z0-9]([a-z0-9_-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9_-]*[a-z0-9])?)*$/;
+  return regex.test(accountId);
+}
+function parseFtTransferArgs(argsBase64) {
+  try {
+    const argsJson = atob(argsBase64);
+    return JSON.parse(argsJson);
+  } catch {
+    try {
+      return JSON.parse(argsBase64);
+    } catch {
+      return null;
+    }
+  }
+}
+function isTransactionSuccessful(status) {
+  return status.SuccessValue !== void 0 && status.Failure === void 0;
+}
+
+// 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 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/exact-direct/facilitator/scheme.ts
+var ExactDirectNearFacilitator = class {
+  constructor(signer, config) {
+    this.signer = signer;
+    this.scheme = SCHEME_EXACT_DIRECT;
+    this.caipFamily = `${NEAR_CAIP2_NAMESPACE}:*`;
+    this.usedTxs = /* @__PURE__ */ new Map();
+    this.config = {
+      maxTransactionAge: config?.maxTransactionAge ?? MAX_TRANSACTION_AGE,
+      usedTxCacheDuration: config?.usedTxCacheDuration ?? 24 * 60 * 60 * 1e3
+      // 24 hours
+    };
+    this.startCleanupInterval();
+  }
+  /**
+   * Get extra data for a supported kind
+   */
+  getExtra(network) {
+    const token = getDefaultToken(network);
+    if (!token) {
+      return void 0;
+    }
+    return {
+      assetSymbol: token.symbol,
+      assetDecimals: token.decimals
+    };
+  }
+  /**
+   * Get signer addresses for a network
+   */
+  getSigners(network) {
+    return this.signer.getAddresses(network);
+  }
+  /**
+   * Verify a payment payload
+   */
+  async verify(payload, requirements) {
+    const network = normalizeNetwork(requirements.network);
+    if (payload.accepted.scheme !== SCHEME_EXACT_DIRECT) {
+      return {
+        isValid: false,
+        invalidReason: "invalid_scheme"
+      };
+    }
+    if (normalizeNetwork(payload.accepted.network) !== network) {
+      return {
+        isValid: false,
+        invalidReason: "network_mismatch"
+      };
+    }
+    const nearPayload = payload.payload;
+    if (!nearPayload.txHash) {
+      return {
+        isValid: false,
+        invalidReason: "missing_tx_hash"
+      };
+    }
+    if (!nearPayload.from || !isValidAccountId(nearPayload.from)) {
+      return {
+        isValid: false,
+        invalidReason: "invalid_from_address"
+      };
+    }
+    if (this.isTxUsed(nearPayload.txHash)) {
+      return {
+        isValid: false,
+        invalidReason: "transaction_already_used",
+        payer: nearPayload.from
+      };
+    }
+    try {
+      const tx = await this.signer.queryTransaction(nearPayload.txHash, nearPayload.from);
+      if (!isTransactionSuccessful(tx.status)) {
+        return {
+          isValid: false,
+          invalidReason: "transaction_failed",
+          payer: nearPayload.from
+        };
+      }
+      if (tx.transaction.receiver_id !== requirements.asset) {
+        return {
+          isValid: false,
+          invalidReason: "wrong_token_contract",
+          payer: nearPayload.from
+        };
+      }
+      let ftTransferArgs = null;
+      for (const action of tx.transaction.actions) {
+        if (action.FunctionCall?.method_name === "ft_transfer") {
+          ftTransferArgs = parseFtTransferArgs(action.FunctionCall.args);
+          break;
+        }
+      }
+      if (!ftTransferArgs) {
+        return {
+          isValid: false,
+          invalidReason: "no_ft_transfer_action",
+          payer: nearPayload.from
+        };
+      }
+      if (ftTransferArgs.receiver_id !== requirements.payTo) {
+        return {
+          isValid: false,
+          invalidReason: "wrong_recipient",
+          payer: nearPayload.from
+        };
+      }
+      const txAmount = BigInt(ftTransferArgs.amount);
+      const requiredAmount = BigInt(requirements.amount);
+      if (txAmount < requiredAmount) {
+        return {
+          isValid: false,
+          invalidReason: "insufficient_amount",
+          payer: nearPayload.from
+        };
+      }
+      this.markTxUsed(nearPayload.txHash);
+      return {
+        isValid: true,
+        payer: nearPayload.from
+      };
+    } catch {
+      return {
+        isValid: false,
+        invalidReason: "transaction_not_found",
+        payer: nearPayload.from
+      };
+    }
+  }
+  /**
+   * Settle a payment - for exact-direct, the transfer is already complete
+   */
+  async settle(payload, requirements) {
+    const verifyResult = await this.verify(payload, requirements);
+    if (!verifyResult.isValid) {
+      return {
+        success: false,
+        errorReason: verifyResult.invalidReason || "verification_failed",
+        payer: verifyResult.payer,
+        transaction: "",
+        network: normalizeNetwork(requirements.network)
+      };
+    }
+    const nearPayload = payload.payload;
+    return {
+      success: true,
+      transaction: nearPayload.txHash,
+      network: normalizeNetwork(requirements.network),
+      payer: nearPayload.from
+    };
+  }
+  /**
+   * Check if a transaction has been used
+   */
+  isTxUsed(txHash) {
+    return this.usedTxs.has(txHash);
+  }
+  /**
+   * Mark a transaction as used
+   */
+  markTxUsed(txHash) {
+    this.usedTxs.set(txHash, Date.now());
+  }
+  /**
+   * Start the cleanup interval for used transactions
+   */
+  startCleanupInterval() {
+    setInterval(
+      () => {
+        const cutoff = Date.now() - this.config.usedTxCacheDuration;
+        for (const [txHash, usedAt] of this.usedTxs.entries()) {
+          if (usedAt < cutoff) {
+            this.usedTxs.delete(txHash);
+          }
+        }
+      },
+      60 * 60 * 1e3
+    );
+  }
+};
+
+// src/exact-direct/facilitator/register.ts
+function registerExactDirectNearFacilitator(facilitator, config) {
+  const scheme = new ExactDirectNearFacilitator(config.signer, config.schemeConfig);
+  facilitator.register(config.networks, scheme);
+  return facilitator;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ExactDirectNearFacilitator,
+  registerExactDirectNearFacilitator
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/exact-direct/facilitator/index.ts","../../../../src/constants.ts","../../../../src/utils.ts","../../../../src/tokens.ts","../../../../src/exact-direct/facilitator/scheme.ts","../../../../src/exact-direct/facilitator/register.ts"],"sourcesContent":["/**\n * NEAR Exact-Direct Facilitator Exports\n */\n\nexport { ExactDirectNearFacilitator, type ExactDirectNearFacilitatorConfig } from \"./scheme.js\";\nexport { registerExactDirectNearFacilitator, type NearFacilitatorConfig } 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 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 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 Facilitator Scheme Implementation - Exact Direct\n *\n * Verifies and settles NEAR NEP-141 payments using the exact-direct scheme.\n * The facilitator verifies that the client's transaction was successful\n * and matches the payment requirements.\n */\n\nimport type {\n  Network,\n  PaymentPayload,\n  PaymentRequirements,\n  SchemeNetworkFacilitator,\n  SettleResponse,\n  VerifyResponse,\n} from \"@t402/core/types\";\nimport type { FacilitatorNearSigner, ExactDirectNearPayload, FtTransferArgs } from \"../../types.js\";\nimport { SCHEME_EXACT_DIRECT, NEAR_CAIP2_NAMESPACE, MAX_TRANSACTION_AGE } from \"../../constants.js\";\nimport {\n  normalizeNetwork,\n  isTransactionSuccessful,\n  parseFtTransferArgs,\n  isValidAccountId,\n} from \"../../utils.js\";\nimport { getDefaultToken } from \"../../tokens.js\";\n\n/**\n * Configuration for ExactDirectNearFacilitator\n */\nexport interface ExactDirectNearFacilitatorConfig {\n  /** Maximum age of a transaction to accept (in milliseconds) */\n  maxTransactionAge?: number;\n  /** Duration to cache used transaction hashes (in milliseconds) */\n  usedTxCacheDuration?: number;\n}\n\n/**\n * NEAR facilitator implementation for the Exact-Direct payment scheme.\n * Verifies transaction proofs and confirms payments.\n */\nexport class ExactDirectNearFacilitator implements SchemeNetworkFacilitator {\n  readonly scheme = SCHEME_EXACT_DIRECT;\n  readonly caipFamily = `${NEAR_CAIP2_NAMESPACE}:*`;\n\n  private readonly config: Required<ExactDirectNearFacilitatorConfig>;\n  private usedTxs: Map<string, number> = new Map();\n\n  constructor(\n    private readonly signer: FacilitatorNearSigner,\n    config?: ExactDirectNearFacilitatorConfig,\n  ) {\n    this.config = {\n      maxTransactionAge: config?.maxTransactionAge ?? MAX_TRANSACTION_AGE,\n      usedTxCacheDuration: config?.usedTxCacheDuration ?? 24 * 60 * 60 * 1000, // 24 hours\n    };\n\n    // Start cleanup interval\n    this.startCleanupInterval();\n  }\n\n  /**\n   * Get extra data for a supported kind\n   */\n  getExtra(network: Network): Record<string, unknown> | undefined {\n    const token = getDefaultToken(network);\n    if (!token) {\n      return undefined;\n    }\n    return {\n      assetSymbol: token.symbol,\n      assetDecimals: token.decimals,\n    };\n  }\n\n  /**\n   * Get signer addresses for a network\n   */\n  getSigners(network: Network): string[] {\n    return this.signer.getAddresses(network);\n  }\n\n  /**\n   * Verify a payment payload\n   */\n  async verify(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n  ): Promise<VerifyResponse> {\n    const network = normalizeNetwork(requirements.network);\n\n    // Validate scheme\n    if (payload.accepted.scheme !== SCHEME_EXACT_DIRECT) {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_scheme\",\n      };\n    }\n\n    // Validate network\n    if (normalizeNetwork(payload.accepted.network) !== network) {\n      return {\n        isValid: false,\n        invalidReason: \"network_mismatch\",\n      };\n    }\n\n    // Parse payload\n    const nearPayload = payload.payload as ExactDirectNearPayload;\n    if (!nearPayload.txHash) {\n      return {\n        isValid: false,\n        invalidReason: \"missing_tx_hash\",\n      };\n    }\n    if (!nearPayload.from || !isValidAccountId(nearPayload.from)) {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_from_address\",\n      };\n    }\n\n    // Check for replay attack\n    if (this.isTxUsed(nearPayload.txHash)) {\n      return {\n        isValid: false,\n        invalidReason: \"transaction_already_used\",\n        payer: nearPayload.from,\n      };\n    }\n\n    try {\n      // Query the transaction\n      const tx = await this.signer.queryTransaction(nearPayload.txHash, nearPayload.from);\n\n      // Check transaction succeeded\n      if (!isTransactionSuccessful(tx.status)) {\n        return {\n          isValid: false,\n          invalidReason: \"transaction_failed\",\n          payer: nearPayload.from,\n        };\n      }\n\n      // Verify the transaction was to the correct token contract\n      if (tx.transaction.receiver_id !== requirements.asset) {\n        return {\n          isValid: false,\n          invalidReason: \"wrong_token_contract\",\n          payer: nearPayload.from,\n        };\n      }\n\n      // Find and verify ft_transfer action\n      let ftTransferArgs: FtTransferArgs | null = null;\n      for (const action of tx.transaction.actions) {\n        if (action.FunctionCall?.method_name === \"ft_transfer\") {\n          ftTransferArgs = parseFtTransferArgs(action.FunctionCall.args);\n          break;\n        }\n      }\n\n      if (!ftTransferArgs) {\n        return {\n          isValid: false,\n          invalidReason: \"no_ft_transfer_action\",\n          payer: nearPayload.from,\n        };\n      }\n\n      // Verify recipient\n      if (ftTransferArgs.receiver_id !== requirements.payTo) {\n        return {\n          isValid: false,\n          invalidReason: \"wrong_recipient\",\n          payer: nearPayload.from,\n        };\n      }\n\n      // Verify amount\n      const txAmount = BigInt(ftTransferArgs.amount);\n      const requiredAmount = BigInt(requirements.amount);\n      if (txAmount < requiredAmount) {\n        return {\n          isValid: false,\n          invalidReason: \"insufficient_amount\",\n          payer: nearPayload.from,\n        };\n      }\n\n      // Mark transaction as used\n      this.markTxUsed(nearPayload.txHash);\n\n      return {\n        isValid: true,\n        payer: nearPayload.from,\n      };\n    } catch {\n      return {\n        isValid: false,\n        invalidReason: \"transaction_not_found\",\n        payer: nearPayload.from,\n      };\n    }\n  }\n\n  /**\n   * Settle a payment - for exact-direct, the transfer is already complete\n   */\n  async settle(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n  ): Promise<SettleResponse> {\n    // Verify first\n    const verifyResult = await this.verify(payload, requirements);\n    if (!verifyResult.isValid) {\n      return {\n        success: false,\n        errorReason: verifyResult.invalidReason || \"verification_failed\",\n        payer: verifyResult.payer,\n        transaction: \"\",\n        network: normalizeNetwork(requirements.network),\n      };\n    }\n\n    const nearPayload = payload.payload as ExactDirectNearPayload;\n\n    // For exact-direct, settlement is already complete\n    return {\n      success: true,\n      transaction: nearPayload.txHash,\n      network: normalizeNetwork(requirements.network),\n      payer: nearPayload.from,\n    };\n  }\n\n  /**\n   * Check if a transaction has been used\n   */\n  private isTxUsed(txHash: string): boolean {\n    return this.usedTxs.has(txHash);\n  }\n\n  /**\n   * Mark a transaction as used\n   */\n  private markTxUsed(txHash: string): void {\n    this.usedTxs.set(txHash, Date.now());\n  }\n\n  /**\n   * Start the cleanup interval for used transactions\n   */\n  private startCleanupInterval(): void {\n    setInterval(\n      () => {\n        const cutoff = Date.now() - this.config.usedTxCacheDuration;\n        for (const [txHash, usedAt] of this.usedTxs.entries()) {\n          if (usedAt < cutoff) {\n            this.usedTxs.delete(txHash);\n          }\n        }\n      },\n      60 * 60 * 1000,\n    ); // Cleanup every hour\n  }\n}\n","/**\n * Registration function for NEAR Exact-Direct facilitator\n */\n\nimport { t402Facilitator } from \"@t402/core/facilitator\";\nimport { Network } from \"@t402/core/types\";\nimport type { FacilitatorNearSigner } from \"../../types.js\";\nimport { ExactDirectNearFacilitator, type ExactDirectNearFacilitatorConfig } from \"./scheme.js\";\n\n/**\n * Configuration options for registering NEAR schemes to a t402Facilitator\n */\nexport interface NearFacilitatorConfig {\n  /**\n   * The NEAR signer for facilitator operations (verify and settle)\n   */\n  signer: FacilitatorNearSigner;\n\n  /**\n   * Networks to register (single network or array of networks)\n   * Examples: \"near:mainnet\", [\"near:mainnet\", \"near:testnet\"]\n   */\n  networks: Network | Network[];\n\n  /**\n   * Optional scheme configuration\n   */\n  schemeConfig?: ExactDirectNearFacilitatorConfig;\n}\n\n/**\n * Registers NEAR exact-direct payment schemes to a t402Facilitator instance.\n *\n * @param facilitator - The t402Facilitator instance to register schemes to\n * @param config - Configuration for NEAR facilitator registration\n * @returns The facilitator instance for chaining\n *\n * @example\n * ```typescript\n * import { registerExactDirectNearFacilitator } from \"@t402/near/exact-direct/facilitator\";\n * import { t402Facilitator } from \"@t402/core/facilitator\";\n *\n * const facilitator = new t402Facilitator();\n *\n * // Single network\n * registerExactDirectNearFacilitator(facilitator, {\n *   signer: myNearSigner,\n *   networks: \"near:mainnet\"\n * });\n *\n * // Multiple networks\n * registerExactDirectNearFacilitator(facilitator, {\n *   signer: myNearSigner,\n *   networks: [\"near:mainnet\", \"near:testnet\"]\n * });\n * ```\n */\nexport function registerExactDirectNearFacilitator(\n  facilitator: t402Facilitator,\n  config: NearFacilitatorConfig,\n): t402Facilitator {\n  const scheme = new ExactDirectNearFacilitator(config.signer, config.schemeConfig);\n\n  // Register scheme with specified networks\n  facilitator.register(config.networks, scheme);\n\n  return facilitator;\n}\n"],"mappings":"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","names":[]}

package/dist/cjs/exact-direct/server/index.d.ts

@@ -0,0 +1,129 @@
+import { SchemeNetworkServer, MoneyParser, Price, Network, AssetAmount, PaymentRequirements } from '@t402/core/types';
+import { t402ResourceServer } from '@t402/core/server';
+
+/**
+ * NEAR Server Scheme Implementation - Exact Direct
+ *
+ * Handles price parsing and payment requirement enhancement for
+ * NEAR NEP-141 payments using the exact-direct scheme.
+ */
+
+/**
+ * Configuration options for ExactDirectNearServer
+ */
+interface ExactDirectNearServerConfig {
+    /** Preferred token symbol (e.g., "USDC"). Defaults to network's highest priority token. */
+    preferredToken?: string;
+}
+/**
+ * NEAR server implementation for the Exact-Direct payment scheme.
+ * Handles price parsing and converts user-friendly amounts to token amounts.
+ */
+declare class ExactDirectNearServer implements SchemeNetworkServer {
+    readonly scheme = "exact-direct";
+    private moneyParsers;
+    private config;
+    constructor(config?: ExactDirectNearServerConfig);
+    /**
+     * 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: MoneyParser): ExactDirectNearServer;
+    /**
+     * 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
+     */
+    parsePrice(price: Price, network: Network): Promise<AssetAmount>;
+    /**
+     * 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
+     */
+    enhancePaymentRequirements(paymentRequirements: PaymentRequirements, supportedKind: {
+        t402Version: number;
+        scheme: string;
+        network: Network;
+        extra?: Record<string, unknown>;
+    }, extensionKeys: string[]): Promise<PaymentRequirements>;
+    /**
+     * Parse Money (string | number) to a decimal number.
+     * Handles formats like "$1.50", "1.50", 1.50, etc.
+     */
+    private parseMoneyToDecimal;
+    /**
+     * Default money conversion implementation.
+     * Converts decimal amount to the preferred token on the specified network.
+     */
+    private defaultMoneyConversion;
+    /**
+     * Get the default asset info for a network.
+     * Priority: configured preferredToken > network default
+     */
+    private getDefaultAsset;
+    /**
+     * Get all supported networks
+     */
+    static getSupportedNetworks(): string[];
+    /**
+     * Check if a network is supported
+     */
+    static isNetworkSupported(network: string): boolean;
+}
+
+/**
+ * Registration function for NEAR Exact-Direct server
+ */
+
+/**
+ * Configuration options for registering NEAR schemes to a t402ResourceServer
+ */
+interface NearResourceServerConfig {
+    /**
+     * Optional specific networks to register
+     * If not provided, registers wildcard support (near:*)
+     */
+    networks?: Network[];
+    /**
+     * Optional scheme configuration (preferred token, etc.)
+     */
+    schemeConfig?: ExactDirectNearServerConfig;
+}
+/**
+ * Registers NEAR exact-direct payment schemes to a t402ResourceServer instance.
+ *
+ * @param server - The t402ResourceServer instance to register schemes to
+ * @param config - Configuration for NEAR resource server registration
+ * @returns The server instance for chaining
+ *
+ * @example
+ * ```typescript
+ * import { registerExactDirectNearServer } from "@t402/near/exact-direct/server";
+ * import { t402ResourceServer } from "@t402/core/server";
+ *
+ * const server = new t402ResourceServer(facilitatorClient);
+ * registerExactDirectNearServer(server, {});
+ *
+ * // Or with specific token preference
+ * registerExactDirectNearServer(server, {
+ *   schemeConfig: { preferredToken: "USDT" }
+ * });
+ * ```
+ */
+declare function registerExactDirectNearServer(server: t402ResourceServer, config?: NearResourceServerConfig): t402ResourceServer;
+
+export { ExactDirectNearServer, type ExactDirectNearServerConfig, type NearResourceServerConfig, registerExactDirectNearServer };