@t402/aptos 2.3.0

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

@@ -0,0 +1,175 @@
+// 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()
+  );
+}
+
+// src/utils.ts
+function isValidAptosAddress(address) {
+  if (!address) return false;
+  if (!address.startsWith("0x")) return false;
+  const hex = address.slice(2);
+  if (hex.length === 0 || hex.length > 64) return false;
+  return /^[0-9a-fA-F]+$/.test(hex);
+}
+function normalizeAptosAddress(address) {
+  if (!address.startsWith("0x")) {
+    throw new Error("Aptos address must start with 0x");
+  }
+  const hex = address.slice(2).toLowerCase();
+  return "0x" + hex.padStart(64, "0");
+}
+function compareAddresses(addr1, addr2) {
+  try {
+    return normalizeAptosAddress(addr1) === normalizeAptosAddress(addr2);
+  } catch {
+    return false;
+  }
+}
+function isAptosNetwork(network) {
+  return network.startsWith(`${APTOS_CAIP2_NAMESPACE}:`);
+}
+function parseAssetIdentifier(asset) {
+  const parts = asset.split("/");
+  if (parts.length !== 2) return null;
+  const network = parts[0];
+  if (!isAptosNetwork(network)) return null;
+  const [assetType, address] = parts[1].split(":");
+  if (assetType !== "fa" || !address) return null;
+  if (!isValidAptosAddress(address)) return null;
+  return { network, metadataAddress: address };
+}
+
+// src/exact-direct/client/scheme.ts
+var ExactDirectAptosClient = class {
+  constructor(signer, config = {}) {
+    this.signer = signer;
+    void config;
+  }
+  scheme = SCHEME_EXACT_DIRECT;
+  /**
+   * Create a payment payload by executing the transfer
+   */
+  async createPaymentPayload(t402Version, paymentRequirements) {
+    this.validateRequirements(paymentRequirements);
+    const from = await this.signer.getAddress();
+    const assetInfo = parseAssetIdentifier(paymentRequirements.asset);
+    if (!assetInfo) {
+      throw new Error(`Invalid asset identifier: ${paymentRequirements.asset}`);
+    }
+    const amount = BigInt(paymentRequirements.amount);
+    const balance = await this.signer.getBalance(assetInfo.metadataAddress);
+    if (balance < amount) {
+      throw new Error(
+        `Insufficient balance: have ${balance}, need ${amount}`
+      );
+    }
+    const txHash = await this.signer.transfer(
+      paymentRequirements.payTo,
+      assetInfo.metadataAddress,
+      amount
+    );
+    const payload = {
+      txHash,
+      from,
+      to: paymentRequirements.payTo,
+      amount: paymentRequirements.amount,
+      metadataAddress: assetInfo.metadataAddress
+    };
+    return {
+      t402Version,
+      payload
+    };
+  }
+  /**
+   * Validate payment requirements
+   */
+  validateRequirements(requirements) {
+    if (requirements.scheme !== SCHEME_EXACT_DIRECT) {
+      throw new Error(
+        `Invalid scheme: expected ${SCHEME_EXACT_DIRECT}, got ${requirements.scheme}`
+      );
+    }
+    if (!requirements.network.startsWith(`${APTOS_CAIP2_NAMESPACE}:`)) {
+      throw new Error(`Invalid network: ${requirements.network}`);
+    }
+    if (!isValidAptosAddress(requirements.payTo)) {
+      throw new Error(`Invalid payTo address: ${requirements.payTo}`);
+    }
+    const amount = BigInt(requirements.amount);
+    if (amount <= 0n) {
+      throw new Error(`Invalid amount: ${requirements.amount}`);
+    }
+    const assetInfo = parseAssetIdentifier(requirements.asset);
+    if (!assetInfo) {
+      throw new Error(`Invalid asset: ${requirements.asset}`);
+    }
+    const tokenConfig = getTokenConfig(requirements.network, "USDT");
+    if (tokenConfig && !compareAddresses(tokenConfig.metadataAddress, assetInfo.metadataAddress)) {
+      console.warn(
+        `Using non-standard token: ${assetInfo.metadataAddress}`
+      );
+    }
+  }
+};
+
+// src/exact-direct/client/register.ts
+function registerExactDirectAptosClient(client, config) {
+  const scheme = new ExactDirectAptosClient(config.signer, config.schemeConfig);
+  if (config.networks && config.networks.length > 0) {
+    config.networks.forEach((network) => {
+      client.register(network, scheme);
+    });
+  } else {
+    client.register("aptos:*", scheme);
+  }
+  if (config.policies) {
+    config.policies.forEach((policy) => {
+      client.registerPolicy(policy);
+    });
+  }
+  return client;
+}
+export {
+  ExactDirectAptosClient,
+  registerExactDirectAptosClient
+};
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/constants.ts","../../../src/tokens.ts","../../../src/utils.ts","../../../src/exact-direct/client/scheme.ts","../../../src/exact-direct/client/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 Client Scheme\n *\n * The client executes the FA transfer directly and provides\n * the transaction hash as proof of payment.\n */\n\nimport type {\n  SchemeNetworkClient,\n  PaymentPayload,\n  PaymentRequirements,\n} from \"@t402/core/types\";\nimport { SCHEME_EXACT_DIRECT, APTOS_CAIP2_NAMESPACE } from \"../../constants.js\";\nimport type { ClientAptosSigner, ExactDirectAptosPayload } from \"../../types.js\";\nimport { getTokenConfig } from \"../../tokens.js\";\nimport {\n  isValidAptosAddress,\n  parseAssetIdentifier,\n  compareAddresses,\n} from \"../../utils.js\";\n\n/**\n * Configuration for ExactDirectAptosClient\n */\nexport interface ExactDirectAptosClientConfig {\n  /**\n   * Whether to verify the transfer was successful before returning\n   * @default true\n   */\n  verifyTransfer?: boolean;\n}\n\n/**\n * Aptos Exact-Direct Client\n *\n * Implements the client-side payment flow where the client:\n * 1. Receives payment requirements\n * 2. Executes the FA transfer transaction\n * 3. Returns transaction hash as proof\n */\nexport class ExactDirectAptosClient implements SchemeNetworkClient {\n  readonly scheme = SCHEME_EXACT_DIRECT;\n\n  constructor(\n    private readonly signer: ClientAptosSigner,\n    config: ExactDirectAptosClientConfig = {},\n  ) {\n    // Config reserved for future use (e.g., verifyTransfer option)\n    void config;\n  }\n\n  /**\n   * Create a payment payload by executing the transfer\n   */\n  async createPaymentPayload(\n    t402Version: number,\n    paymentRequirements: PaymentRequirements,\n  ): Promise<Pick<PaymentPayload, \"t402Version\" | \"payload\">> {\n    // Validate requirements\n    this.validateRequirements(paymentRequirements);\n\n    // Get sender address\n    const from = await this.signer.getAddress();\n\n    // Parse asset to get metadata address\n    const assetInfo = parseAssetIdentifier(paymentRequirements.asset);\n    if (!assetInfo) {\n      throw new Error(`Invalid asset identifier: ${paymentRequirements.asset}`);\n    }\n\n    // Get amount\n    const amount = BigInt(paymentRequirements.amount);\n\n    // Check balance\n    const balance = await this.signer.getBalance(assetInfo.metadataAddress);\n    if (balance < amount) {\n      throw new Error(\n        `Insufficient balance: have ${balance}, need ${amount}`,\n      );\n    }\n\n    // Execute transfer\n    const txHash = await this.signer.transfer(\n      paymentRequirements.payTo,\n      assetInfo.metadataAddress,\n      amount,\n    );\n\n    // Create payload\n    const payload: ExactDirectAptosPayload = {\n      txHash,\n      from,\n      to: paymentRequirements.payTo,\n      amount: paymentRequirements.amount,\n      metadataAddress: assetInfo.metadataAddress,\n    };\n\n    return {\n      t402Version,\n      payload,\n    };\n  }\n\n  /**\n   * Validate payment requirements\n   */\n  private validateRequirements(requirements: PaymentRequirements): void {\n    // Check scheme\n    if (requirements.scheme !== SCHEME_EXACT_DIRECT) {\n      throw new Error(\n        `Invalid scheme: expected ${SCHEME_EXACT_DIRECT}, got ${requirements.scheme}`,\n      );\n    }\n\n    // Check network\n    if (!requirements.network.startsWith(`${APTOS_CAIP2_NAMESPACE}:`)) {\n      throw new Error(`Invalid network: ${requirements.network}`);\n    }\n\n    // Check payTo address\n    if (!isValidAptosAddress(requirements.payTo)) {\n      throw new Error(`Invalid payTo address: ${requirements.payTo}`);\n    }\n\n    // Check amount\n    const amount = BigInt(requirements.amount);\n    if (amount <= 0n) {\n      throw new Error(`Invalid amount: ${requirements.amount}`);\n    }\n\n    // Check asset\n    const assetInfo = parseAssetIdentifier(requirements.asset);\n    if (!assetInfo) {\n      throw new Error(`Invalid asset: ${requirements.asset}`);\n    }\n\n    // Verify token is supported\n    const tokenConfig = getTokenConfig(requirements.network, \"USDT\");\n    if (tokenConfig && !compareAddresses(tokenConfig.metadataAddress, assetInfo.metadataAddress)) {\n      // Allow any valid FA, but log warning for unknown tokens\n      console.warn(\n        `Using non-standard token: ${assetInfo.metadataAddress}`,\n      );\n    }\n  }\n}\n\nexport default ExactDirectAptosClient;\n","/**\n * Registration function for Aptos Exact-Direct client\n */\n\nimport { t402Client, PaymentPolicy } from \"@t402/core/client\";\nimport type { Network } from \"@t402/core/types\";\nimport type { ClientAptosSigner } from \"../../types.js\";\nimport {\n  ExactDirectAptosClient,\n  type ExactDirectAptosClientConfig,\n} from \"./scheme.js\";\n\n/**\n * Configuration options for registering Aptos schemes to a t402Client\n */\nexport interface AptosClientConfig {\n  /**\n   * The Aptos signer for client operations\n   */\n  signer: ClientAptosSigner;\n\n  /**\n   * Optional policies to apply to the client\n   */\n  policies?: PaymentPolicy[];\n\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?: ExactDirectAptosClientConfig;\n}\n\n/**\n * Registers Aptos exact-direct payment schemes to a t402Client instance.\n *\n * @param client - The t402Client instance to register schemes to\n * @param config - Configuration for Aptos client registration\n * @returns The client instance for chaining\n *\n * @example\n * ```typescript\n * import { registerExactDirectAptosClient } from \"@t402/aptos/exact-direct/client\";\n * import { t402Client } from \"@t402/core/client\";\n *\n * const client = new t402Client();\n * registerExactDirectAptosClient(client, {\n *   signer: myAptosSigner,\n *   networks: [\"aptos:1\"]\n * });\n * ```\n */\nexport function registerExactDirectAptosClient(\n  client: t402Client,\n  config: AptosClientConfig,\n): t402Client {\n  const scheme = new ExactDirectAptosClient(config.signer, config.schemeConfig);\n\n  // Register scheme\n  if (config.networks && config.networks.length > 0) {\n    // Register specific networks\n    config.networks.forEach((network) => {\n      client.register(network, scheme);\n    });\n  } else {\n    // Register wildcard for all Aptos networks\n    client.register(\"aptos:*\", scheme);\n  }\n\n  // Apply policies if provided\n  if (config.policies) {\n    config.policies.forEach((policy) => {\n      client.registerPolicy(policy);\n    });\n  }\n\n  return client;\n}\n"],"mappings":"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","names":[]}

package/dist/exact-direct/facilitator/index.d.cts

@@ -0,0 +1,110 @@
+import { SchemeNetworkFacilitator, Network, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse } from '@t402/core/types';
+import { F as FacilitatorAptosSigner } from '../../types-kOweBf4U.cjs';
+import { t402Facilitator } from '@t402/core/facilitator';
+
+/**
+ * Aptos Exact-Direct Facilitator Scheme
+ *
+ * Verifies FA transfer transactions and manages replay protection.
+ */
+
+/**
+ * Configuration for ExactDirectAptosFacilitator
+ */
+interface ExactDirectAptosFacilitatorConfig {
+    /**
+     * Maximum age of transaction in seconds (default: 3600 = 1 hour)
+     */
+    maxTransactionAge?: number;
+    /**
+     * Duration to cache used transaction hashes (in milliseconds)
+     */
+    usedTxCacheDuration?: number;
+}
+/**
+ * Aptos Exact-Direct Facilitator
+ *
+ * Implements the facilitator-side verification and settlement.
+ * For exact-direct, settlement is a no-op since client already executed.
+ */
+declare class ExactDirectAptosFacilitator implements SchemeNetworkFacilitator {
+    private readonly signer;
+    readonly scheme = "exact-direct";
+    readonly caipFamily = "aptos:*";
+    private readonly config;
+    private usedTxs;
+    constructor(signer: FacilitatorAptosSigner, config?: ExactDirectAptosFacilitatorConfig);
+    /**
+     * Get extra data for a supported kind
+     */
+    getExtra(network: Network): Record<string, unknown> | undefined;
+    /**
+     * Get facilitator signer addresses for a network
+     */
+    getSigners(network: Network): string[];
+    /**
+     * Verify a payment payload
+     */
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    /**
+     * Settle a payment (no-op for exact-direct since client already executed)
+     */
+    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+    /**
+     * Check if a transaction has been used
+     */
+    private isTxUsed;
+    /**
+     * Mark a transaction as used
+     */
+    private markTxUsed;
+    /**
+     * Start the cleanup interval for used transactions
+     */
+    private startCleanupInterval;
+}
+
+/**
+ * Registration function for Aptos Exact-Direct facilitator
+ */
+
+/**
+ * Configuration options for registering Aptos schemes to a t402Facilitator
+ */
+interface AptosFacilitatorConfig {
+    /**
+     * The Aptos signer for facilitator operations (verify and settle)
+     */
+    signer: FacilitatorAptosSigner;
+    /**
+     * Optional specific networks to register
+     * If not provided, registers wildcard support (aptos:*)
+     */
+    networks?: Network[];
+    /**
+     * Optional scheme configuration
+     */
+    schemeConfig?: ExactDirectAptosFacilitatorConfig;
+}
+/**
+ * Registers Aptos exact-direct payment schemes to a t402Facilitator instance.
+ *
+ * @param facilitator - The t402Facilitator instance to register schemes to
+ * @param config - Configuration for Aptos facilitator registration
+ * @returns The facilitator instance for chaining
+ *
+ * @example
+ * ```typescript
+ * import { registerExactDirectAptosFacilitator } from "@t402/aptos/exact-direct/facilitator";
+ * import { t402Facilitator } from "@t402/core/facilitator";
+ *
+ * const facilitator = new t402Facilitator();
+ * registerExactDirectAptosFacilitator(facilitator, {
+ *   signer: myAptosSigner,
+ *   networks: ["aptos:1"]
+ * });
+ * ```
+ */
+declare function registerExactDirectAptosFacilitator(facilitator: t402Facilitator, config: AptosFacilitatorConfig): t402Facilitator;
+
+export { type AptosFacilitatorConfig, ExactDirectAptosFacilitator, type ExactDirectAptosFacilitatorConfig, registerExactDirectAptosFacilitator };

package/dist/exact-direct/facilitator/index.d.ts

@@ -0,0 +1,110 @@
+import { SchemeNetworkFacilitator, Network, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse } from '@t402/core/types';
+import { F as FacilitatorAptosSigner } from '../../types-kOweBf4U.js';
+import { t402Facilitator } from '@t402/core/facilitator';
+
+/**
+ * Aptos Exact-Direct Facilitator Scheme
+ *
+ * Verifies FA transfer transactions and manages replay protection.
+ */
+
+/**
+ * Configuration for ExactDirectAptosFacilitator
+ */
+interface ExactDirectAptosFacilitatorConfig {
+    /**
+     * Maximum age of transaction in seconds (default: 3600 = 1 hour)
+     */
+    maxTransactionAge?: number;
+    /**
+     * Duration to cache used transaction hashes (in milliseconds)
+     */
+    usedTxCacheDuration?: number;
+}
+/**
+ * Aptos Exact-Direct Facilitator
+ *
+ * Implements the facilitator-side verification and settlement.
+ * For exact-direct, settlement is a no-op since client already executed.
+ */
+declare class ExactDirectAptosFacilitator implements SchemeNetworkFacilitator {
+    private readonly signer;
+    readonly scheme = "exact-direct";
+    readonly caipFamily = "aptos:*";
+    private readonly config;
+    private usedTxs;
+    constructor(signer: FacilitatorAptosSigner, config?: ExactDirectAptosFacilitatorConfig);
+    /**
+     * Get extra data for a supported kind
+     */
+    getExtra(network: Network): Record<string, unknown> | undefined;
+    /**
+     * Get facilitator signer addresses for a network
+     */
+    getSigners(network: Network): string[];
+    /**
+     * Verify a payment payload
+     */
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    /**
+     * Settle a payment (no-op for exact-direct since client already executed)
+     */
+    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+    /**
+     * Check if a transaction has been used
+     */
+    private isTxUsed;
+    /**
+     * Mark a transaction as used
+     */
+    private markTxUsed;
+    /**
+     * Start the cleanup interval for used transactions
+     */
+    private startCleanupInterval;
+}
+
+/**
+ * Registration function for Aptos Exact-Direct facilitator
+ */
+
+/**
+ * Configuration options for registering Aptos schemes to a t402Facilitator
+ */
+interface AptosFacilitatorConfig {
+    /**
+     * The Aptos signer for facilitator operations (verify and settle)
+     */
+    signer: FacilitatorAptosSigner;
+    /**
+     * Optional specific networks to register
+     * If not provided, registers wildcard support (aptos:*)
+     */
+    networks?: Network[];
+    /**
+     * Optional scheme configuration
+     */
+    schemeConfig?: ExactDirectAptosFacilitatorConfig;
+}
+/**
+ * Registers Aptos exact-direct payment schemes to a t402Facilitator instance.
+ *
+ * @param facilitator - The t402Facilitator instance to register schemes to
+ * @param config - Configuration for Aptos facilitator registration
+ * @returns The facilitator instance for chaining
+ *
+ * @example
+ * ```typescript
+ * import { registerExactDirectAptosFacilitator } from "@t402/aptos/exact-direct/facilitator";
+ * import { t402Facilitator } from "@t402/core/facilitator";
+ *
+ * const facilitator = new t402Facilitator();
+ * registerExactDirectAptosFacilitator(facilitator, {
+ *   signer: myAptosSigner,
+ *   networks: ["aptos:1"]
+ * });
+ * ```
+ */
+declare function registerExactDirectAptosFacilitator(facilitator: t402Facilitator, config: AptosFacilitatorConfig): t402Facilitator;
+
+export { type AptosFacilitatorConfig, ExactDirectAptosFacilitator, type ExactDirectAptosFacilitatorConfig, registerExactDirectAptosFacilitator };