@t402/aptos 2.3.0

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

@@ -0,0 +1,220 @@
+"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, {
+  ExactDirectAptosServer: () => ExactDirectAptosServer,
+  registerExactDirectAptosServer: () => registerExactDirectAptosServer
+});
+module.exports = __toCommonJS(server_exports);
+
+// src/constants.ts
+var APTOS_CAIP2_NAMESPACE = "aptos";
+var APTOS_MAINNET_CAIP2 = "aptos:1";
+var APTOS_TESTNET_CAIP2 = "aptos:2";
+var APTOS_DEVNET_CAIP2 = "aptos:149";
+var SCHEME_EXACT_DIRECT = "exact-direct";
+var PRIMARY_FUNGIBLE_STORE_MODULE = "0x1::primary_fungible_store";
+var FA_TRANSFER_FUNCTION = `${PRIMARY_FUNGIBLE_STORE_MODULE}::transfer`;
+
+// src/tokens.ts
+var TOKEN_REGISTRY = {
+  [APTOS_MAINNET_CAIP2]: [
+    {
+      metadataAddress: "0xf73e887a8754f540ee6e1a93bdc6dde2af69fc7ca5de32013e89dd44244473cb",
+      symbol: "USDT",
+      name: "Tether USD",
+      decimals: 6
+    },
+    {
+      metadataAddress: "0xbae207659db88bea0cbead6da0ed00aac12edcdda169e591cd41c94180b46f3b",
+      symbol: "USDC",
+      name: "USD Coin",
+      decimals: 6
+    }
+  ],
+  [APTOS_TESTNET_CAIP2]: [
+    {
+      // Testnet USDT (may differ from mainnet)
+      metadataAddress: "0xf73e887a8754f540ee6e1a93bdc6dde2af69fc7ca5de32013e89dd44244473cb",
+      symbol: "USDT",
+      name: "Tether USD",
+      decimals: 6
+    }
+  ],
+  [APTOS_DEVNET_CAIP2]: []
+};
+function getTokenConfig(network, symbol) {
+  const tokens = TOKEN_REGISTRY[network];
+  if (!tokens) return void 0;
+  return tokens.find(
+    (t) => t.symbol.toUpperCase() === symbol.toUpperCase()
+  );
+}
+var DEFAULT_TOKEN_SYMBOL = "USDT";
+function getDefaultToken(network) {
+  return getTokenConfig(network, DEFAULT_TOKEN_SYMBOL);
+}
+
+// src/utils.ts
+function isAptosNetwork(network) {
+  return network.startsWith(`${APTOS_CAIP2_NAMESPACE}:`);
+}
+function createAssetIdentifier(network, metadataAddress) {
+  return `${network}/fa:${metadataAddress}`;
+}
+function parseAmount(amount, decimals) {
+  const [whole, fractional = ""] = amount.split(".");
+  const paddedFractional = fractional.padEnd(decimals, "0").slice(0, decimals);
+  return BigInt(whole + paddedFractional);
+}
+
+// src/exact-direct/server/scheme.ts
+var ExactDirectAptosServer = class {
+  scheme = SCHEME_EXACT_DIRECT;
+  moneyParsers = [];
+  config;
+  constructor(config = {}) {
+    this.config = config;
+  }
+  /**
+   * Register a custom money parser in the parser chain.
+   */
+  registerMoneyParser(parser) {
+    this.moneyParsers.push(parser);
+    return this;
+  }
+  /**
+   * Parse price into Aptos-specific amount
+   */
+  async parsePrice(price, network) {
+    if (!isAptosNetwork(network)) {
+      throw new Error(`Invalid Aptos network: ${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, network);
+      if (result !== null) {
+        return result;
+      }
+    }
+    return this.defaultMoneyConversion(amount, network);
+  }
+  /**
+   * Enhance payment requirements with Aptos-specific details
+   */
+  async enhancePaymentRequirements(paymentRequirements, supportedKind, facilitatorExtensions) {
+    void facilitatorExtensions;
+    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.
+   */
+  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.
+   */
+  defaultMoneyConversion(amount, network) {
+    const token = this.getDefaultAsset(network);
+    const tokenAmount = parseAmount(amount.toString(), token.decimals);
+    return {
+      amount: tokenAmount.toString(),
+      asset: createAssetIdentifier(network, token.metadataAddress),
+      extra: {
+        symbol: token.symbol,
+        name: token.name,
+        decimals: token.decimals
+      }
+    };
+  }
+  /**
+   * Get the default asset info for a network.
+   */
+  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 registerExactDirectAptosServer(server, config = {}) {
+  const scheme = new ExactDirectAptosServer(config.schemeConfig);
+  if (config.networks && config.networks.length > 0) {
+    config.networks.forEach((network) => {
+      server.register(network, scheme);
+    });
+  } else {
+    server.register("aptos:*", scheme);
+  }
+  return server;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ExactDirectAptosServer,
+  registerExactDirectAptosServer
+});
+//# sourceMappingURL=index.js.map

package/dist/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 * Aptos Exact-Direct Server Exports\n */\n\nexport {\n  ExactDirectAptosServer,\n  type ExactDirectAptosServerConfig,\n} from \"./scheme.js\";\nexport {\n  registerExactDirectAptosServer,\n  type AptosServerConfig,\n} from \"./register.js\";\n","/**\n * Aptos Network Constants\n */\n\n// CAIP-2 namespace for Aptos\nexport const APTOS_CAIP2_NAMESPACE = \"aptos\";\n\n// Standard Aptos network identifiers (CAIP-2 format)\nexport const APTOS_MAINNET_CAIP2 = \"aptos:1\";\nexport const APTOS_TESTNET_CAIP2 = \"aptos:2\";\nexport const APTOS_DEVNET_CAIP2 = \"aptos:149\";\n\n// All supported Aptos networks\nexport const APTOS_NETWORKS = [\n  APTOS_MAINNET_CAIP2,\n  APTOS_TESTNET_CAIP2,\n  APTOS_DEVNET_CAIP2,\n] as const;\n\nexport type AptosNetwork = (typeof APTOS_NETWORKS)[number];\n\n// Chain IDs\nexport const APTOS_MAINNET_CHAIN_ID = 1;\nexport const APTOS_TESTNET_CHAIN_ID = 2;\nexport const APTOS_DEVNET_CHAIN_ID = 149;\n\n// RPC endpoints\nexport const DEFAULT_MAINNET_RPC = \"https://fullnode.mainnet.aptoslabs.com/v1\";\nexport const DEFAULT_TESTNET_RPC = \"https://fullnode.testnet.aptoslabs.com/v1\";\nexport const DEFAULT_DEVNET_RPC = \"https://fullnode.devnet.aptoslabs.com/v1\";\n\n// Scheme identifier\nexport const SCHEME_EXACT_DIRECT = \"exact-direct\";\n\n// Fungible Asset module addresses\nexport const PRIMARY_FUNGIBLE_STORE_MODULE = \"0x1::primary_fungible_store\";\nexport const FUNGIBLE_ASSET_MODULE = \"0x1::fungible_asset\";\nexport const APTOS_ACCOUNT_MODULE = \"0x1::aptos_account\";\n\n// Transfer function\nexport const FA_TRANSFER_FUNCTION = `${PRIMARY_FUNGIBLE_STORE_MODULE}::transfer`;\n\n// Default gas configuration\nexport const DEFAULT_MAX_GAS_AMOUNT = 100000n;\nexport const DEFAULT_GAS_UNIT_PRICE = 100n;\n\n// Transaction expiration (in seconds)\nexport const DEFAULT_TX_EXPIRATION_SECONDS = 600; // 10 minutes\n","/**\n * Aptos Token Registry\n *\n * Token addresses for supported stablecoins on Aptos networks.\n * All tokens use the Fungible Asset (FA) standard.\n */\n\nimport {\n  APTOS_MAINNET_CAIP2,\n  APTOS_TESTNET_CAIP2,\n  APTOS_DEVNET_CAIP2,\n} from \"./constants.js\";\n\n/**\n * Token configuration for Aptos fungible assets\n */\nexport interface TokenConfig {\n  /** Fungible Asset metadata address */\n  metadataAddress: string;\n  /** Token symbol (e.g., \"USDT\", \"USDC\") */\n  symbol: string;\n  /** Token name */\n  name: string;\n  /** Decimal places */\n  decimals: number;\n}\n\n/**\n * Token registry mapping network -> tokens\n */\nexport const TOKEN_REGISTRY: Record<string, TokenConfig[]> = {\n  [APTOS_MAINNET_CAIP2]: [\n    {\n      metadataAddress:\n        \"0xf73e887a8754f540ee6e1a93bdc6dde2af69fc7ca5de32013e89dd44244473cb\",\n      symbol: \"USDT\",\n      name: \"Tether USD\",\n      decimals: 6,\n    },\n    {\n      metadataAddress:\n        \"0xbae207659db88bea0cbead6da0ed00aac12edcdda169e591cd41c94180b46f3b\",\n      symbol: \"USDC\",\n      name: \"USD Coin\",\n      decimals: 6,\n    },\n  ],\n  [APTOS_TESTNET_CAIP2]: [\n    {\n      // Testnet USDT (may differ from mainnet)\n      metadataAddress:\n        \"0xf73e887a8754f540ee6e1a93bdc6dde2af69fc7ca5de32013e89dd44244473cb\",\n      symbol: \"USDT\",\n      name: \"Tether USD\",\n      decimals: 6,\n    },\n  ],\n  [APTOS_DEVNET_CAIP2]: [],\n};\n\n/**\n * Get token configuration for a specific network and symbol\n */\nexport function getTokenConfig(\n  network: string,\n  symbol: string,\n): TokenConfig | undefined {\n  const tokens = TOKEN_REGISTRY[network];\n  if (!tokens) return undefined;\n  return tokens.find(\n    (t) => t.symbol.toUpperCase() === symbol.toUpperCase(),\n  );\n}\n\n/**\n * Get all supported tokens for a network\n */\nexport function getSupportedTokens(network: string): TokenConfig[] {\n  return TOKEN_REGISTRY[network] || [];\n}\n\n/**\n * Check if a token is supported on a network\n */\nexport function isTokenSupported(network: string, symbol: string): boolean {\n  return getTokenConfig(network, symbol) !== undefined;\n}\n\n/**\n * Get token by metadata address\n */\nexport function getTokenByAddress(\n  network: string,\n  metadataAddress: string,\n): TokenConfig | undefined {\n  const tokens = TOKEN_REGISTRY[network];\n  if (!tokens) return undefined;\n  const normalizedAddress = metadataAddress.toLowerCase();\n  return tokens.find(\n    (t) => t.metadataAddress.toLowerCase() === normalizedAddress,\n  );\n}\n\n/**\n * Default token symbol for payments (USDT)\n */\nexport const DEFAULT_TOKEN_SYMBOL = \"USDT\";\n\n/**\n * Get the default token for a network\n */\nexport function getDefaultToken(network: string): TokenConfig | undefined {\n  return getTokenConfig(network, DEFAULT_TOKEN_SYMBOL);\n}\n","/**\n * Aptos Utility Functions\n */\n\nimport type { Network } from \"@t402/core/types\";\nimport {\n  APTOS_CAIP2_NAMESPACE,\n  APTOS_MAINNET_CAIP2,\n  APTOS_TESTNET_CAIP2,\n  APTOS_DEVNET_CAIP2,\n  DEFAULT_MAINNET_RPC,\n  DEFAULT_TESTNET_RPC,\n  DEFAULT_DEVNET_RPC,\n  FA_TRANSFER_FUNCTION,\n} from \"./constants.js\";\nimport type {\n  AptosTransactionResult,\n  AptosTransactionEvent,\n  ParsedFATransfer,\n} from \"./types.js\";\n\n/**\n * Validate Aptos address format\n * Aptos addresses are 64 hex characters (32 bytes) with 0x prefix\n */\nexport function isValidAptosAddress(address: string): boolean {\n  if (!address) return false;\n  // Must start with 0x\n  if (!address.startsWith(\"0x\")) return false;\n  // Remove 0x prefix and check hex\n  const hex = address.slice(2);\n  // Aptos addresses can be 1-64 hex chars (leading zeros may be omitted)\n  if (hex.length === 0 || hex.length > 64) return false;\n  return /^[0-9a-fA-F]+$/.test(hex);\n}\n\n/**\n * Normalize Aptos address to full 64-character format\n */\nexport function normalizeAptosAddress(address: string): string {\n  if (!address.startsWith(\"0x\")) {\n    throw new Error(\"Aptos address must start with 0x\");\n  }\n  const hex = address.slice(2).toLowerCase();\n  // Pad to 64 characters\n  return \"0x\" + hex.padStart(64, \"0\");\n}\n\n/**\n * Compare two Aptos addresses (case-insensitive, handles short addresses)\n */\nexport function compareAddresses(addr1: string, addr2: string): boolean {\n  try {\n    return normalizeAptosAddress(addr1) === normalizeAptosAddress(addr2);\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Validate transaction hash format\n */\nexport function isValidTxHash(txHash: string): boolean {\n  if (!txHash) return false;\n  if (!txHash.startsWith(\"0x\")) return false;\n  const hex = txHash.slice(2);\n  // Transaction hash is 64 hex characters (32 bytes)\n  if (hex.length !== 64) return false;\n  return /^[0-9a-fA-F]+$/.test(hex);\n}\n\n/**\n * Get default RPC URL for a network\n */\nexport function getDefaultRpcUrl(network: Network): string {\n  switch (network) {\n    case APTOS_MAINNET_CAIP2:\n      return DEFAULT_MAINNET_RPC;\n    case APTOS_TESTNET_CAIP2:\n      return DEFAULT_TESTNET_RPC;\n    case APTOS_DEVNET_CAIP2:\n      return DEFAULT_DEVNET_RPC;\n    default:\n      throw new Error(`Unknown Aptos network: ${network}`);\n  }\n}\n\n/**\n * Check if a network identifier is for Aptos\n */\nexport function isAptosNetwork(network: Network): boolean {\n  return network.startsWith(`${APTOS_CAIP2_NAMESPACE}:`);\n}\n\n/**\n * Parse CAIP-19 asset identifier for Aptos\n * Format: aptos:1/fa:0x...\n */\nexport function parseAssetIdentifier(asset: string): {\n  network: Network;\n  metadataAddress: string;\n} | null {\n  const parts = asset.split(\"/\");\n  if (parts.length !== 2) return null;\n\n  const network = parts[0] as Network;\n  if (!isAptosNetwork(network)) return null;\n\n  const [assetType, address] = parts[1].split(\":\");\n  if (assetType !== \"fa\" || !address) return null;\n\n  if (!isValidAptosAddress(address)) return null;\n\n  return { network, metadataAddress: address };\n}\n\n/**\n * Create CAIP-19 asset identifier for Aptos FA\n */\nexport function createAssetIdentifier(\n  network: Network,\n  metadataAddress: string,\n): string {\n  return `${network}/fa:${metadataAddress}`;\n}\n\n/**\n * Parse fungible asset transfer from transaction events\n */\nexport function parseFATransferFromEvents(\n  events: AptosTransactionEvent[],\n): ParsedFATransfer | null {\n  // Look for Withdraw and Deposit events\n  const withdrawEvent = events.find(\n    (e) =>\n      e.type === \"0x1::fungible_asset::Withdraw\" ||\n      e.type.includes(\"::fungible_asset::Withdraw\"),\n  );\n  const depositEvent = events.find(\n    (e) =>\n      e.type === \"0x1::fungible_asset::Deposit\" ||\n      e.type.includes(\"::fungible_asset::Deposit\"),\n  );\n\n  if (!withdrawEvent || !depositEvent) {\n    return null;\n  }\n\n  // Extract data from events\n  const withdrawData = withdrawEvent.data as {\n    store?: string;\n    amount?: string;\n  };\n  const depositData = depositEvent.data as {\n    store?: string;\n    amount?: string;\n  };\n\n  if (!withdrawData.amount || !depositData.store) {\n    return null;\n  }\n\n  // The from address is the account that owns the withdraw store\n  // The to address is the account that owns the deposit store\n  // For simplicity, we'll extract from the event guid\n  const from = withdrawEvent.guid.accountAddress;\n  const to = depositEvent.guid.accountAddress;\n  const amount = BigInt(withdrawData.amount);\n\n  // Metadata address would need to be extracted from state changes\n  // For now, return with empty metadata (to be filled by caller)\n  return {\n    from,\n    to,\n    amount,\n    metadataAddress: \"\", // Will be filled from transaction details\n  };\n}\n\n/**\n * Check if transaction is a FA transfer\n */\nexport function isFATransferTransaction(tx: AptosTransactionResult): boolean {\n  if (!tx.payload) return false;\n  if (tx.payload.type !== \"entry_function_payload\") return false;\n  return (\n    tx.payload.function === FA_TRANSFER_FUNCTION ||\n    tx.payload.function?.includes(\"primary_fungible_store::transfer\") ||\n    false\n  );\n}\n\n/**\n * Extract transfer details from transaction\n */\nexport function extractTransferDetails(\n  tx: AptosTransactionResult,\n): ParsedFATransfer | null {\n  if (!tx.success) return null;\n  if (!tx.payload || tx.payload.type !== \"entry_function_payload\") return null;\n\n  const args = tx.payload.arguments;\n  if (!args || args.length < 3) return null;\n\n  // Arguments for primary_fungible_store::transfer:\n  // [0] - metadata object address\n  // [1] - recipient address\n  // [2] - amount\n\n  const metadataAddress = args[0] as string;\n  const to = args[1] as string;\n  const amount = BigInt(args[2] as string);\n\n  return {\n    from: tx.sender,\n    to,\n    amount,\n    metadataAddress,\n  };\n}\n\n/**\n * Format amount with decimals for display\n */\nexport function formatAmount(amount: bigint, decimals: number): string {\n  const divisor = BigInt(10 ** decimals);\n  const wholePart = amount / divisor;\n  const fractionalPart = amount % divisor;\n  const paddedFractional = fractionalPart.toString().padStart(decimals, \"0\");\n  return `${wholePart}.${paddedFractional}`;\n}\n\n/**\n * Parse amount string to bigint\n */\nexport function parseAmount(amount: string, decimals: number): bigint {\n  const [whole, fractional = \"\"] = amount.split(\".\");\n  const paddedFractional = fractional.padEnd(decimals, \"0\").slice(0, decimals);\n  return BigInt(whole + paddedFractional);\n}\n","/**\n * Aptos Exact-Direct Server Scheme\n *\n * Handles price parsing and payment requirement enhancement for\n * Aptos FA payments using the exact-direct scheme.\n */\n\nimport type {\n  SchemeNetworkServer,\n  PaymentRequirements,\n  Price,\n  AssetAmount,\n  Network,\n  MoneyParser,\n} from \"@t402/core/types\";\nimport { SCHEME_EXACT_DIRECT } from \"../../constants.js\";\nimport { getTokenConfig, getDefaultToken, TOKEN_REGISTRY } from \"../../tokens.js\";\nimport {\n  isAptosNetwork,\n  createAssetIdentifier,\n  parseAmount,\n} from \"../../utils.js\";\n\n/**\n * Configuration for ExactDirectAptosServer\n */\nexport interface ExactDirectAptosServerConfig {\n  /** Preferred token symbol (e.g., \"USDT\"). Defaults to network's default token. */\n  preferredToken?: string;\n}\n\n/**\n * Aptos Exact-Direct Server\n *\n * Implements the server-side price parsing and payment requirements enhancement.\n */\nexport class ExactDirectAptosServer implements SchemeNetworkServer {\n  readonly scheme = SCHEME_EXACT_DIRECT;\n  private moneyParsers: MoneyParser[] = [];\n  private config: ExactDirectAptosServerConfig;\n\n  constructor(config: ExactDirectAptosServerConfig = {}) {\n    this.config = config;\n  }\n\n  /**\n   * Register a custom money parser in the parser chain.\n   */\n  registerMoneyParser(parser: MoneyParser): ExactDirectAptosServer {\n    this.moneyParsers.push(parser);\n    return this;\n  }\n\n  /**\n   * Parse price into Aptos-specific amount\n   */\n  async parsePrice(price: Price, network: Network): Promise<AssetAmount> {\n    // Validate network\n    if (!isAptosNetwork(network)) {\n      throw new Error(`Invalid Aptos network: ${network}`);\n    }\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, network);\n      if (result !== null) {\n        return result;\n      }\n    }\n\n    // All custom parsers returned null, use default conversion\n    return this.defaultMoneyConversion(amount, network);\n  }\n\n  /**\n   * Enhance payment requirements with Aptos-specific details\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    facilitatorExtensions: string[],\n  ): Promise<PaymentRequirements> {\n    // Mark unused parameters\n    void facilitatorExtensions;\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   */\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   */\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 = parseAmount(amount.toString(), token.decimals);\n\n    return {\n      amount: tokenAmount.toString(),\n      asset: createAssetIdentifier(network, token.metadataAddress),\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   */\n  private getDefaultAsset(\n    network: Network,\n  ): { metadataAddress: string; symbol: string; name: string; decimals: number } {\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\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\nexport default ExactDirectAptosServer;\n","/**\n * Registration function for Aptos Exact-Direct server\n */\n\nimport { t402ResourceServer } from \"@t402/core/server\";\nimport type { Network } from \"@t402/core/types\";\nimport {\n  ExactDirectAptosServer,\n  type ExactDirectAptosServerConfig,\n} from \"./scheme.js\";\n\n/**\n * Configuration options for registering Aptos schemes to a t402ResourceServer\n */\nexport interface AptosServerConfig {\n  /**\n   * Optional specific networks to register\n   * If not provided, registers wildcard support (aptos:*)\n   */\n  networks?: Network[];\n\n  /**\n   * Optional scheme configuration\n   */\n  schemeConfig?: ExactDirectAptosServerConfig;\n}\n\n/**\n * Registers Aptos exact-direct payment schemes to a t402ResourceServer instance.\n *\n * @param server - The t402ResourceServer instance to register schemes to\n * @param config - Configuration for Aptos server registration\n * @returns The server instance for chaining\n *\n * @example\n * ```typescript\n * import { registerExactDirectAptosServer } from \"@t402/aptos/exact-direct/server\";\n * import { t402ResourceServer } from \"@t402/core/server\";\n *\n * const server = new t402ResourceServer();\n * registerExactDirectAptosServer(server, {\n *   networks: [\"aptos:1\"],\n *   schemeConfig: { preferredToken: \"USDT\" }\n * });\n * ```\n */\nexport function registerExactDirectAptosServer(\n  server: t402ResourceServer,\n  config: AptosServerConfig = {},\n): t402ResourceServer {\n  const scheme = new ExactDirectAptosServer(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 Aptos networks\n    server.register(\"aptos:*\", scheme);\n  }\n\n  return server;\n}\n"],"mappings":"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","names":[]}

package/dist/exact-direct/server/index.mjs

@@ -0,0 +1,192 @@
+// src/constants.ts
+var APTOS_CAIP2_NAMESPACE = "aptos";
+var APTOS_MAINNET_CAIP2 = "aptos:1";
+var APTOS_TESTNET_CAIP2 = "aptos:2";
+var APTOS_DEVNET_CAIP2 = "aptos:149";
+var SCHEME_EXACT_DIRECT = "exact-direct";
+var PRIMARY_FUNGIBLE_STORE_MODULE = "0x1::primary_fungible_store";
+var FA_TRANSFER_FUNCTION = `${PRIMARY_FUNGIBLE_STORE_MODULE}::transfer`;
+
+// src/tokens.ts
+var TOKEN_REGISTRY = {
+  [APTOS_MAINNET_CAIP2]: [
+    {
+      metadataAddress: "0xf73e887a8754f540ee6e1a93bdc6dde2af69fc7ca5de32013e89dd44244473cb",
+      symbol: "USDT",
+      name: "Tether USD",
+      decimals: 6
+    },
+    {
+      metadataAddress: "0xbae207659db88bea0cbead6da0ed00aac12edcdda169e591cd41c94180b46f3b",
+      symbol: "USDC",
+      name: "USD Coin",
+      decimals: 6
+    }
+  ],
+  [APTOS_TESTNET_CAIP2]: [
+    {
+      // Testnet USDT (may differ from mainnet)
+      metadataAddress: "0xf73e887a8754f540ee6e1a93bdc6dde2af69fc7ca5de32013e89dd44244473cb",
+      symbol: "USDT",
+      name: "Tether USD",
+      decimals: 6
+    }
+  ],
+  [APTOS_DEVNET_CAIP2]: []
+};
+function getTokenConfig(network, symbol) {
+  const tokens = TOKEN_REGISTRY[network];
+  if (!tokens) return void 0;
+  return tokens.find(
+    (t) => t.symbol.toUpperCase() === symbol.toUpperCase()
+  );
+}
+var DEFAULT_TOKEN_SYMBOL = "USDT";
+function getDefaultToken(network) {
+  return getTokenConfig(network, DEFAULT_TOKEN_SYMBOL);
+}
+
+// src/utils.ts
+function isAptosNetwork(network) {
+  return network.startsWith(`${APTOS_CAIP2_NAMESPACE}:`);
+}
+function createAssetIdentifier(network, metadataAddress) {
+  return `${network}/fa:${metadataAddress}`;
+}
+function parseAmount(amount, decimals) {
+  const [whole, fractional = ""] = amount.split(".");
+  const paddedFractional = fractional.padEnd(decimals, "0").slice(0, decimals);
+  return BigInt(whole + paddedFractional);
+}
+
+// src/exact-direct/server/scheme.ts
+var ExactDirectAptosServer = class {
+  scheme = SCHEME_EXACT_DIRECT;
+  moneyParsers = [];
+  config;
+  constructor(config = {}) {
+    this.config = config;
+  }
+  /**
+   * Register a custom money parser in the parser chain.
+   */
+  registerMoneyParser(parser) {
+    this.moneyParsers.push(parser);
+    return this;
+  }
+  /**
+   * Parse price into Aptos-specific amount
+   */
+  async parsePrice(price, network) {
+    if (!isAptosNetwork(network)) {
+      throw new Error(`Invalid Aptos network: ${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, network);
+      if (result !== null) {
+        return result;
+      }
+    }
+    return this.defaultMoneyConversion(amount, network);
+  }
+  /**
+   * Enhance payment requirements with Aptos-specific details
+   */
+  async enhancePaymentRequirements(paymentRequirements, supportedKind, facilitatorExtensions) {
+    void facilitatorExtensions;
+    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.
+   */
+  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.
+   */
+  defaultMoneyConversion(amount, network) {
+    const token = this.getDefaultAsset(network);
+    const tokenAmount = parseAmount(amount.toString(), token.decimals);
+    return {
+      amount: tokenAmount.toString(),
+      asset: createAssetIdentifier(network, token.metadataAddress),
+      extra: {
+        symbol: token.symbol,
+        name: token.name,
+        decimals: token.decimals
+      }
+    };
+  }
+  /**
+   * Get the default asset info for a network.
+   */
+  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 registerExactDirectAptosServer(server, config = {}) {
+  const scheme = new ExactDirectAptosServer(config.schemeConfig);
+  if (config.networks && config.networks.length > 0) {
+    config.networks.forEach((network) => {
+      server.register(network, scheme);
+    });
+  } else {
+    server.register("aptos:*", scheme);
+  }
+  return server;
+}
+export {
+  ExactDirectAptosServer,
+  registerExactDirectAptosServer
+};
+//# sourceMappingURL=index.mjs.map

package/dist/exact-direct/server/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/constants.ts","../../../src/tokens.ts","../../../src/utils.ts","../../../src/exact-direct/server/scheme.ts","../../../src/exact-direct/server/register.ts"],"sourcesContent":["/**\n * Aptos Network Constants\n */\n\n// CAIP-2 namespace for Aptos\nexport const APTOS_CAIP2_NAMESPACE = \"aptos\";\n\n// Standard Aptos network identifiers (CAIP-2 format)\nexport const APTOS_MAINNET_CAIP2 = \"aptos:1\";\nexport const APTOS_TESTNET_CAIP2 = \"aptos:2\";\nexport const APTOS_DEVNET_CAIP2 = \"aptos:149\";\n\n// All supported Aptos networks\nexport const APTOS_NETWORKS = [\n  APTOS_MAINNET_CAIP2,\n  APTOS_TESTNET_CAIP2,\n  APTOS_DEVNET_CAIP2,\n] as const;\n\nexport type AptosNetwork = (typeof APTOS_NETWORKS)[number];\n\n// Chain IDs\nexport const APTOS_MAINNET_CHAIN_ID = 1;\nexport const APTOS_TESTNET_CHAIN_ID = 2;\nexport const APTOS_DEVNET_CHAIN_ID = 149;\n\n// RPC endpoints\nexport const DEFAULT_MAINNET_RPC = \"https://fullnode.mainnet.aptoslabs.com/v1\";\nexport const DEFAULT_TESTNET_RPC = \"https://fullnode.testnet.aptoslabs.com/v1\";\nexport const DEFAULT_DEVNET_RPC = \"https://fullnode.devnet.aptoslabs.com/v1\";\n\n// Scheme identifier\nexport const SCHEME_EXACT_DIRECT = \"exact-direct\";\n\n// Fungible Asset module addresses\nexport const PRIMARY_FUNGIBLE_STORE_MODULE = \"0x1::primary_fungible_store\";\nexport const FUNGIBLE_ASSET_MODULE = \"0x1::fungible_asset\";\nexport const APTOS_ACCOUNT_MODULE = \"0x1::aptos_account\";\n\n// Transfer function\nexport const FA_TRANSFER_FUNCTION = `${PRIMARY_FUNGIBLE_STORE_MODULE}::transfer`;\n\n// Default gas configuration\nexport const DEFAULT_MAX_GAS_AMOUNT = 100000n;\nexport const DEFAULT_GAS_UNIT_PRICE = 100n;\n\n// Transaction expiration (in seconds)\nexport const DEFAULT_TX_EXPIRATION_SECONDS = 600; // 10 minutes\n","/**\n * Aptos Token Registry\n *\n * Token addresses for supported stablecoins on Aptos networks.\n * All tokens use the Fungible Asset (FA) standard.\n */\n\nimport {\n  APTOS_MAINNET_CAIP2,\n  APTOS_TESTNET_CAIP2,\n  APTOS_DEVNET_CAIP2,\n} from \"./constants.js\";\n\n/**\n * Token configuration for Aptos fungible assets\n */\nexport interface TokenConfig {\n  /** Fungible Asset metadata address */\n  metadataAddress: string;\n  /** Token symbol (e.g., \"USDT\", \"USDC\") */\n  symbol: string;\n  /** Token name */\n  name: string;\n  /** Decimal places */\n  decimals: number;\n}\n\n/**\n * Token registry mapping network -> tokens\n */\nexport const TOKEN_REGISTRY: Record<string, TokenConfig[]> = {\n  [APTOS_MAINNET_CAIP2]: [\n    {\n      metadataAddress:\n        \"0xf73e887a8754f540ee6e1a93bdc6dde2af69fc7ca5de32013e89dd44244473cb\",\n      symbol: \"USDT\",\n      name: \"Tether USD\",\n      decimals: 6,\n    },\n    {\n      metadataAddress:\n        \"0xbae207659db88bea0cbead6da0ed00aac12edcdda169e591cd41c94180b46f3b\",\n      symbol: \"USDC\",\n      name: \"USD Coin\",\n      decimals: 6,\n    },\n  ],\n  [APTOS_TESTNET_CAIP2]: [\n    {\n      // Testnet USDT (may differ from mainnet)\n      metadataAddress:\n        \"0xf73e887a8754f540ee6e1a93bdc6dde2af69fc7ca5de32013e89dd44244473cb\",\n      symbol: \"USDT\",\n      name: \"Tether USD\",\n      decimals: 6,\n    },\n  ],\n  [APTOS_DEVNET_CAIP2]: [],\n};\n\n/**\n * Get token configuration for a specific network and symbol\n */\nexport function getTokenConfig(\n  network: string,\n  symbol: string,\n): TokenConfig | undefined {\n  const tokens = TOKEN_REGISTRY[network];\n  if (!tokens) return undefined;\n  return tokens.find(\n    (t) => t.symbol.toUpperCase() === symbol.toUpperCase(),\n  );\n}\n\n/**\n * Get all supported tokens for a network\n */\nexport function getSupportedTokens(network: string): TokenConfig[] {\n  return TOKEN_REGISTRY[network] || [];\n}\n\n/**\n * Check if a token is supported on a network\n */\nexport function isTokenSupported(network: string, symbol: string): boolean {\n  return getTokenConfig(network, symbol) !== undefined;\n}\n\n/**\n * Get token by metadata address\n */\nexport function getTokenByAddress(\n  network: string,\n  metadataAddress: string,\n): TokenConfig | undefined {\n  const tokens = TOKEN_REGISTRY[network];\n  if (!tokens) return undefined;\n  const normalizedAddress = metadataAddress.toLowerCase();\n  return tokens.find(\n    (t) => t.metadataAddress.toLowerCase() === normalizedAddress,\n  );\n}\n\n/**\n * Default token symbol for payments (USDT)\n */\nexport const DEFAULT_TOKEN_SYMBOL = \"USDT\";\n\n/**\n * Get the default token for a network\n */\nexport function getDefaultToken(network: string): TokenConfig | undefined {\n  return getTokenConfig(network, DEFAULT_TOKEN_SYMBOL);\n}\n","/**\n * Aptos Utility Functions\n */\n\nimport type { Network } from \"@t402/core/types\";\nimport {\n  APTOS_CAIP2_NAMESPACE,\n  APTOS_MAINNET_CAIP2,\n  APTOS_TESTNET_CAIP2,\n  APTOS_DEVNET_CAIP2,\n  DEFAULT_MAINNET_RPC,\n  DEFAULT_TESTNET_RPC,\n  DEFAULT_DEVNET_RPC,\n  FA_TRANSFER_FUNCTION,\n} from \"./constants.js\";\nimport type {\n  AptosTransactionResult,\n  AptosTransactionEvent,\n  ParsedFATransfer,\n} from \"./types.js\";\n\n/**\n * Validate Aptos address format\n * Aptos addresses are 64 hex characters (32 bytes) with 0x prefix\n */\nexport function isValidAptosAddress(address: string): boolean {\n  if (!address) return false;\n  // Must start with 0x\n  if (!address.startsWith(\"0x\")) return false;\n  // Remove 0x prefix and check hex\n  const hex = address.slice(2);\n  // Aptos addresses can be 1-64 hex chars (leading zeros may be omitted)\n  if (hex.length === 0 || hex.length > 64) return false;\n  return /^[0-9a-fA-F]+$/.test(hex);\n}\n\n/**\n * Normalize Aptos address to full 64-character format\n */\nexport function normalizeAptosAddress(address: string): string {\n  if (!address.startsWith(\"0x\")) {\n    throw new Error(\"Aptos address must start with 0x\");\n  }\n  const hex = address.slice(2).toLowerCase();\n  // Pad to 64 characters\n  return \"0x\" + hex.padStart(64, \"0\");\n}\n\n/**\n * Compare two Aptos addresses (case-insensitive, handles short addresses)\n */\nexport function compareAddresses(addr1: string, addr2: string): boolean {\n  try {\n    return normalizeAptosAddress(addr1) === normalizeAptosAddress(addr2);\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Validate transaction hash format\n */\nexport function isValidTxHash(txHash: string): boolean {\n  if (!txHash) return false;\n  if (!txHash.startsWith(\"0x\")) return false;\n  const hex = txHash.slice(2);\n  // Transaction hash is 64 hex characters (32 bytes)\n  if (hex.length !== 64) return false;\n  return /^[0-9a-fA-F]+$/.test(hex);\n}\n\n/**\n * Get default RPC URL for a network\n */\nexport function getDefaultRpcUrl(network: Network): string {\n  switch (network) {\n    case APTOS_MAINNET_CAIP2:\n      return DEFAULT_MAINNET_RPC;\n    case APTOS_TESTNET_CAIP2:\n      return DEFAULT_TESTNET_RPC;\n    case APTOS_DEVNET_CAIP2:\n      return DEFAULT_DEVNET_RPC;\n    default:\n      throw new Error(`Unknown Aptos network: ${network}`);\n  }\n}\n\n/**\n * Check if a network identifier is for Aptos\n */\nexport function isAptosNetwork(network: Network): boolean {\n  return network.startsWith(`${APTOS_CAIP2_NAMESPACE}:`);\n}\n\n/**\n * Parse CAIP-19 asset identifier for Aptos\n * Format: aptos:1/fa:0x...\n */\nexport function parseAssetIdentifier(asset: string): {\n  network: Network;\n  metadataAddress: string;\n} | null {\n  const parts = asset.split(\"/\");\n  if (parts.length !== 2) return null;\n\n  const network = parts[0] as Network;\n  if (!isAptosNetwork(network)) return null;\n\n  const [assetType, address] = parts[1].split(\":\");\n  if (assetType !== \"fa\" || !address) return null;\n\n  if (!isValidAptosAddress(address)) return null;\n\n  return { network, metadataAddress: address };\n}\n\n/**\n * Create CAIP-19 asset identifier for Aptos FA\n */\nexport function createAssetIdentifier(\n  network: Network,\n  metadataAddress: string,\n): string {\n  return `${network}/fa:${metadataAddress}`;\n}\n\n/**\n * Parse fungible asset transfer from transaction events\n */\nexport function parseFATransferFromEvents(\n  events: AptosTransactionEvent[],\n): ParsedFATransfer | null {\n  // Look for Withdraw and Deposit events\n  const withdrawEvent = events.find(\n    (e) =>\n      e.type === \"0x1::fungible_asset::Withdraw\" ||\n      e.type.includes(\"::fungible_asset::Withdraw\"),\n  );\n  const depositEvent = events.find(\n    (e) =>\n      e.type === \"0x1::fungible_asset::Deposit\" ||\n      e.type.includes(\"::fungible_asset::Deposit\"),\n  );\n\n  if (!withdrawEvent || !depositEvent) {\n    return null;\n  }\n\n  // Extract data from events\n  const withdrawData = withdrawEvent.data as {\n    store?: string;\n    amount?: string;\n  };\n  const depositData = depositEvent.data as {\n    store?: string;\n    amount?: string;\n  };\n\n  if (!withdrawData.amount || !depositData.store) {\n    return null;\n  }\n\n  // The from address is the account that owns the withdraw store\n  // The to address is the account that owns the deposit store\n  // For simplicity, we'll extract from the event guid\n  const from = withdrawEvent.guid.accountAddress;\n  const to = depositEvent.guid.accountAddress;\n  const amount = BigInt(withdrawData.amount);\n\n  // Metadata address would need to be extracted from state changes\n  // For now, return with empty metadata (to be filled by caller)\n  return {\n    from,\n    to,\n    amount,\n    metadataAddress: \"\", // Will be filled from transaction details\n  };\n}\n\n/**\n * Check if transaction is a FA transfer\n */\nexport function isFATransferTransaction(tx: AptosTransactionResult): boolean {\n  if (!tx.payload) return false;\n  if (tx.payload.type !== \"entry_function_payload\") return false;\n  return (\n    tx.payload.function === FA_TRANSFER_FUNCTION ||\n    tx.payload.function?.includes(\"primary_fungible_store::transfer\") ||\n    false\n  );\n}\n\n/**\n * Extract transfer details from transaction\n */\nexport function extractTransferDetails(\n  tx: AptosTransactionResult,\n): ParsedFATransfer | null {\n  if (!tx.success) return null;\n  if (!tx.payload || tx.payload.type !== \"entry_function_payload\") return null;\n\n  const args = tx.payload.arguments;\n  if (!args || args.length < 3) return null;\n\n  // Arguments for primary_fungible_store::transfer:\n  // [0] - metadata object address\n  // [1] - recipient address\n  // [2] - amount\n\n  const metadataAddress = args[0] as string;\n  const to = args[1] as string;\n  const amount = BigInt(args[2] as string);\n\n  return {\n    from: tx.sender,\n    to,\n    amount,\n    metadataAddress,\n  };\n}\n\n/**\n * Format amount with decimals for display\n */\nexport function formatAmount(amount: bigint, decimals: number): string {\n  const divisor = BigInt(10 ** decimals);\n  const wholePart = amount / divisor;\n  const fractionalPart = amount % divisor;\n  const paddedFractional = fractionalPart.toString().padStart(decimals, \"0\");\n  return `${wholePart}.${paddedFractional}`;\n}\n\n/**\n * Parse amount string to bigint\n */\nexport function parseAmount(amount: string, decimals: number): bigint {\n  const [whole, fractional = \"\"] = amount.split(\".\");\n  const paddedFractional = fractional.padEnd(decimals, \"0\").slice(0, decimals);\n  return BigInt(whole + paddedFractional);\n}\n","/**\n * Aptos Exact-Direct Server Scheme\n *\n * Handles price parsing and payment requirement enhancement for\n * Aptos FA payments using the exact-direct scheme.\n */\n\nimport type {\n  SchemeNetworkServer,\n  PaymentRequirements,\n  Price,\n  AssetAmount,\n  Network,\n  MoneyParser,\n} from \"@t402/core/types\";\nimport { SCHEME_EXACT_DIRECT } from \"../../constants.js\";\nimport { getTokenConfig, getDefaultToken, TOKEN_REGISTRY } from \"../../tokens.js\";\nimport {\n  isAptosNetwork,\n  createAssetIdentifier,\n  parseAmount,\n} from \"../../utils.js\";\n\n/**\n * Configuration for ExactDirectAptosServer\n */\nexport interface ExactDirectAptosServerConfig {\n  /** Preferred token symbol (e.g., \"USDT\"). Defaults to network's default token. */\n  preferredToken?: string;\n}\n\n/**\n * Aptos Exact-Direct Server\n *\n * Implements the server-side price parsing and payment requirements enhancement.\n */\nexport class ExactDirectAptosServer implements SchemeNetworkServer {\n  readonly scheme = SCHEME_EXACT_DIRECT;\n  private moneyParsers: MoneyParser[] = [];\n  private config: ExactDirectAptosServerConfig;\n\n  constructor(config: ExactDirectAptosServerConfig = {}) {\n    this.config = config;\n  }\n\n  /**\n   * Register a custom money parser in the parser chain.\n   */\n  registerMoneyParser(parser: MoneyParser): ExactDirectAptosServer {\n    this.moneyParsers.push(parser);\n    return this;\n  }\n\n  /**\n   * Parse price into Aptos-specific amount\n   */\n  async parsePrice(price: Price, network: Network): Promise<AssetAmount> {\n    // Validate network\n    if (!isAptosNetwork(network)) {\n      throw new Error(`Invalid Aptos network: ${network}`);\n    }\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, network);\n      if (result !== null) {\n        return result;\n      }\n    }\n\n    // All custom parsers returned null, use default conversion\n    return this.defaultMoneyConversion(amount, network);\n  }\n\n  /**\n   * Enhance payment requirements with Aptos-specific details\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    facilitatorExtensions: string[],\n  ): Promise<PaymentRequirements> {\n    // Mark unused parameters\n    void facilitatorExtensions;\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   */\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   */\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 = parseAmount(amount.toString(), token.decimals);\n\n    return {\n      amount: tokenAmount.toString(),\n      asset: createAssetIdentifier(network, token.metadataAddress),\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   */\n  private getDefaultAsset(\n    network: Network,\n  ): { metadataAddress: string; symbol: string; name: string; decimals: number } {\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\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\nexport default ExactDirectAptosServer;\n","/**\n * Registration function for Aptos Exact-Direct server\n */\n\nimport { t402ResourceServer } from \"@t402/core/server\";\nimport type { Network } from \"@t402/core/types\";\nimport {\n  ExactDirectAptosServer,\n  type ExactDirectAptosServerConfig,\n} from \"./scheme.js\";\n\n/**\n * Configuration options for registering Aptos schemes to a t402ResourceServer\n */\nexport interface AptosServerConfig {\n  /**\n   * Optional specific networks to register\n   * If not provided, registers wildcard support (aptos:*)\n   */\n  networks?: Network[];\n\n  /**\n   * Optional scheme configuration\n   */\n  schemeConfig?: ExactDirectAptosServerConfig;\n}\n\n/**\n * Registers Aptos exact-direct payment schemes to a t402ResourceServer instance.\n *\n * @param server - The t402ResourceServer instance to register schemes to\n * @param config - Configuration for Aptos server registration\n * @returns The server instance for chaining\n *\n * @example\n * ```typescript\n * import { registerExactDirectAptosServer } from \"@t402/aptos/exact-direct/server\";\n * import { t402ResourceServer } from \"@t402/core/server\";\n *\n * const server = new t402ResourceServer();\n * registerExactDirectAptosServer(server, {\n *   networks: [\"aptos:1\"],\n *   schemeConfig: { preferredToken: \"USDT\" }\n * });\n * ```\n */\nexport function registerExactDirectAptosServer(\n  server: t402ResourceServer,\n  config: AptosServerConfig = {},\n): t402ResourceServer {\n  const scheme = new ExactDirectAptosServer(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 Aptos networks\n    server.register(\"aptos:*\", scheme);\n  }\n\n  return server;\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,145 @@
+import { A as AptosTransactionEvent, P as ParsedFATransfer, a as AptosTransactionResult } from './types-kOweBf4U.cjs';
+export { c as AptosStateChange, b as AptosTransactionPayload, C as ClientAptosSigner, E as ExactDirectAptosPayload, F as FacilitatorAptosSigner, e as extractChainId } from './types-kOweBf4U.cjs';
+import { Network } from '@t402/core/types';
+export { AptosClientConfig, ExactDirectAptosClient, ExactDirectAptosClientConfig, registerExactDirectAptosClient } from './exact-direct/client/index.cjs';
+export { AptosServerConfig, ExactDirectAptosServer, ExactDirectAptosServerConfig, registerExactDirectAptosServer } from './exact-direct/server/index.cjs';
+export { AptosFacilitatorConfig, ExactDirectAptosFacilitator, ExactDirectAptosFacilitatorConfig, registerExactDirectAptosFacilitator } from './exact-direct/facilitator/index.cjs';
+import '@t402/core/client';
+import '@t402/core/server';
+import '@t402/core/facilitator';
+
+/**
+ * Aptos Network Constants
+ */
+declare const APTOS_CAIP2_NAMESPACE = "aptos";
+declare const APTOS_MAINNET_CAIP2 = "aptos:1";
+declare const APTOS_TESTNET_CAIP2 = "aptos:2";
+declare const APTOS_DEVNET_CAIP2 = "aptos:149";
+declare const APTOS_NETWORKS: readonly ["aptos:1", "aptos:2", "aptos:149"];
+type AptosNetwork = (typeof APTOS_NETWORKS)[number];
+declare const APTOS_MAINNET_CHAIN_ID = 1;
+declare const APTOS_TESTNET_CHAIN_ID = 2;
+declare const APTOS_DEVNET_CHAIN_ID = 149;
+declare const DEFAULT_MAINNET_RPC = "https://fullnode.mainnet.aptoslabs.com/v1";
+declare const DEFAULT_TESTNET_RPC = "https://fullnode.testnet.aptoslabs.com/v1";
+declare const DEFAULT_DEVNET_RPC = "https://fullnode.devnet.aptoslabs.com/v1";
+declare const SCHEME_EXACT_DIRECT = "exact-direct";
+declare const PRIMARY_FUNGIBLE_STORE_MODULE = "0x1::primary_fungible_store";
+declare const FUNGIBLE_ASSET_MODULE = "0x1::fungible_asset";
+declare const APTOS_ACCOUNT_MODULE = "0x1::aptos_account";
+declare const FA_TRANSFER_FUNCTION = "0x1::primary_fungible_store::transfer";
+declare const DEFAULT_MAX_GAS_AMOUNT = 100000n;
+declare const DEFAULT_GAS_UNIT_PRICE = 100n;
+declare const DEFAULT_TX_EXPIRATION_SECONDS = 600;
+
+/**
+ * Aptos Token Registry
+ *
+ * Token addresses for supported stablecoins on Aptos networks.
+ * All tokens use the Fungible Asset (FA) standard.
+ */
+/**
+ * Token configuration for Aptos fungible assets
+ */
+interface TokenConfig {
+    /** Fungible Asset metadata address */
+    metadataAddress: string;
+    /** Token symbol (e.g., "USDT", "USDC") */
+    symbol: string;
+    /** Token name */
+    name: string;
+    /** Decimal places */
+    decimals: number;
+}
+/**
+ * Token registry mapping network -> tokens
+ */
+declare const TOKEN_REGISTRY: Record<string, TokenConfig[]>;
+/**
+ * Get token configuration for a specific network and symbol
+ */
+declare function getTokenConfig(network: string, symbol: string): TokenConfig | undefined;
+/**
+ * Get all supported tokens for a network
+ */
+declare function getSupportedTokens(network: string): TokenConfig[];
+/**
+ * Check if a token is supported on a network
+ */
+declare function isTokenSupported(network: string, symbol: string): boolean;
+/**
+ * Get token by metadata address
+ */
+declare function getTokenByAddress(network: string, metadataAddress: string): TokenConfig | undefined;
+/**
+ * Default token symbol for payments (USDT)
+ */
+declare const DEFAULT_TOKEN_SYMBOL = "USDT";
+/**
+ * Get the default token for a network
+ */
+declare function getDefaultToken(network: string): TokenConfig | undefined;
+
+/**
+ * Aptos Utility Functions
+ */
+
+/**
+ * Validate Aptos address format
+ * Aptos addresses are 64 hex characters (32 bytes) with 0x prefix
+ */
+declare function isValidAptosAddress(address: string): boolean;
+/**
+ * Normalize Aptos address to full 64-character format
+ */
+declare function normalizeAptosAddress(address: string): string;
+/**
+ * Compare two Aptos addresses (case-insensitive, handles short addresses)
+ */
+declare function compareAddresses(addr1: string, addr2: string): boolean;
+/**
+ * Validate transaction hash format
+ */
+declare function isValidTxHash(txHash: string): boolean;
+/**
+ * Get default RPC URL for a network
+ */
+declare function getDefaultRpcUrl(network: Network): string;
+/**
+ * Check if a network identifier is for Aptos
+ */
+declare function isAptosNetwork(network: Network): boolean;
+/**
+ * Parse CAIP-19 asset identifier for Aptos
+ * Format: aptos:1/fa:0x...
+ */
+declare function parseAssetIdentifier(asset: string): {
+    network: Network;
+    metadataAddress: string;
+} | null;
+/**
+ * Create CAIP-19 asset identifier for Aptos FA
+ */
+declare function createAssetIdentifier(network: Network, metadataAddress: string): string;
+/**
+ * Parse fungible asset transfer from transaction events
+ */
+declare function parseFATransferFromEvents(events: AptosTransactionEvent[]): ParsedFATransfer | null;
+/**
+ * Check if transaction is a FA transfer
+ */
+declare function isFATransferTransaction(tx: AptosTransactionResult): boolean;
+/**
+ * Extract transfer details from transaction
+ */
+declare function extractTransferDetails(tx: AptosTransactionResult): ParsedFATransfer | null;
+/**
+ * Format amount with decimals for display
+ */
+declare function formatAmount(amount: bigint, decimals: number): string;
+/**
+ * Parse amount string to bigint
+ */
+declare function parseAmount(amount: string, decimals: number): bigint;
+
+export { APTOS_ACCOUNT_MODULE, APTOS_CAIP2_NAMESPACE, APTOS_DEVNET_CAIP2, APTOS_DEVNET_CHAIN_ID, APTOS_MAINNET_CAIP2, APTOS_MAINNET_CHAIN_ID, APTOS_NETWORKS, APTOS_TESTNET_CAIP2, APTOS_TESTNET_CHAIN_ID, type AptosNetwork, AptosTransactionEvent, AptosTransactionResult, DEFAULT_DEVNET_RPC, DEFAULT_GAS_UNIT_PRICE, DEFAULT_MAINNET_RPC, DEFAULT_MAX_GAS_AMOUNT, DEFAULT_TESTNET_RPC, DEFAULT_TOKEN_SYMBOL, DEFAULT_TX_EXPIRATION_SECONDS, FA_TRANSFER_FUNCTION, FUNGIBLE_ASSET_MODULE, PRIMARY_FUNGIBLE_STORE_MODULE, ParsedFATransfer, SCHEME_EXACT_DIRECT, TOKEN_REGISTRY, type TokenConfig, compareAddresses, createAssetIdentifier, extractTransferDetails, formatAmount, getDefaultRpcUrl, getDefaultToken, getSupportedTokens, getTokenByAddress, getTokenConfig, isAptosNetwork, isFATransferTransaction, isTokenSupported, isValidAptosAddress, isValidTxHash, normalizeAptosAddress, parseAmount, parseAssetIdentifier, parseFATransferFromEvents };