@t402/tezos 2.3.0

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

@@ -0,0 +1,176 @@
+// src/constants.ts
+var SCHEME_EXACT_DIRECT = "exact-direct";
+var TEZOS_CAIP2_NAMESPACE = "tezos";
+var TEZOS_MAINNET_CAIP2 = "tezos:NetXdQprcVkpaWU";
+var TEZOS_GHOSTNET_CAIP2 = "tezos:NetXnHfVqm9iesp";
+var DEFAULT_MAINNET_RPC = "https://mainnet.api.tez.ie";
+var DEFAULT_GHOSTNET_RPC = "https://ghostnet.tezos.marigold.dev";
+var DEFAULT_MAINNET_INDEXER = "https://api.tzkt.io";
+var DEFAULT_GHOSTNET_INDEXER = "https://api.ghostnet.tzkt.io";
+var NETWORK_CONFIGS = {
+  [TEZOS_MAINNET_CAIP2]: {
+    name: "Tezos Mainnet",
+    rpcUrl: DEFAULT_MAINNET_RPC,
+    indexerUrl: DEFAULT_MAINNET_INDEXER
+  },
+  [TEZOS_GHOSTNET_CAIP2]: {
+    name: "Tezos Ghostnet",
+    rpcUrl: DEFAULT_GHOSTNET_RPC,
+    indexerUrl: DEFAULT_GHOSTNET_INDEXER
+  }
+};
+
+// src/types.ts
+function isValidTezosAddress(address) {
+  if (!address) return false;
+  const prefixPattern = /^(tz1|tz2|tz3|KT1)/;
+  if (!prefixPattern.test(address)) return false;
+  return address.length === 36;
+}
+
+// src/tokens.ts
+var USDT_MAINNET = {
+  contractAddress: "KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o",
+  tokenId: 0,
+  symbol: "USDt",
+  name: "Tether USD",
+  decimals: 6
+};
+var TOKEN_REGISTRY = {
+  [TEZOS_MAINNET_CAIP2]: [USDT_MAINNET],
+  [TEZOS_GHOSTNET_CAIP2]: []
+};
+var DEFAULT_TOKENS = {
+  [TEZOS_MAINNET_CAIP2]: USDT_MAINNET,
+  [TEZOS_GHOSTNET_CAIP2]: void 0
+};
+function getTokenBySymbol(network, symbol) {
+  const tokens = TOKEN_REGISTRY[network];
+  if (!tokens) return void 0;
+  return tokens.find(
+    (t) => t.symbol.toLowerCase() === symbol.toLowerCase()
+  );
+}
+
+// src/utils.ts
+function compareAddresses(addr1, addr2) {
+  if (!addr1 || !addr2) return false;
+  return addr1 === addr2;
+}
+
+// src/exact-direct/client/scheme.ts
+var ExactDirectTezosClient = 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 = this.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.contractAddress,
+      assetInfo.tokenId
+    );
+    if (balance < amount) {
+      throw new Error(
+        `Insufficient balance: have ${balance}, need ${amount}`
+      );
+    }
+    const opHash = await this.signer.transfer(
+      assetInfo.contractAddress,
+      assetInfo.tokenId,
+      paymentRequirements.payTo,
+      amount
+    );
+    const payload = {
+      opHash,
+      from,
+      to: paymentRequirements.payTo,
+      amount: paymentRequirements.amount,
+      contractAddress: assetInfo.contractAddress,
+      tokenId: assetInfo.tokenId
+    };
+    return {
+      t402Version,
+      payload
+    };
+  }
+  /**
+   * Parse CAIP-19 asset identifier for Tezos FA2
+   * Format: tezos:{chainRef}/fa2:{contractAddress}/{tokenId}
+   */
+  parseAssetIdentifier(asset) {
+    const caipMatch = asset.match(/^tezos:[^/]+\/fa2:([^/]+)\/(\d+)$/);
+    if (caipMatch) {
+      return {
+        contractAddress: caipMatch[1],
+        tokenId: parseInt(caipMatch[2], 10)
+      };
+    }
+    const simpleMatch = asset.match(/^(KT1[a-zA-Z0-9]+)(?:\/(\d+))?$/);
+    if (simpleMatch) {
+      return {
+        contractAddress: simpleMatch[1],
+        tokenId: simpleMatch[2] ? parseInt(simpleMatch[2], 10) : 0
+      };
+    }
+    return null;
+  }
+  /**
+   * 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(`${TEZOS_CAIP2_NAMESPACE}:`)) {
+      throw new Error(`Invalid network: ${requirements.network}`);
+    }
+    if (!isValidTezosAddress(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 = this.parseAssetIdentifier(requirements.asset);
+    if (!assetInfo) {
+      throw new Error(`Invalid asset: ${requirements.asset}`);
+    }
+    const tokenConfig = getTokenBySymbol(requirements.network, "USDt");
+    if (tokenConfig && !compareAddresses(tokenConfig.contractAddress, assetInfo.contractAddress)) {
+      console.warn(
+        `Using non-standard token: ${assetInfo.contractAddress}`
+      );
+    }
+  }
+};
+
+// src/exact-direct/client/register.ts
+function registerExactDirectTezosClient(client, config) {
+  const scheme = new ExactDirectTezosClient(config.signer, config.schemeConfig);
+  if (config.networks && config.networks.length > 0) {
+    config.networks.forEach((network) => {
+      client.register(network, scheme);
+    });
+  } else {
+    client.register("tezos:*", scheme);
+  }
+  return client;
+}
+export {
+  ExactDirectTezosClient,
+  registerExactDirectTezosClient
+};
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/constants.ts","../../../src/types.ts","../../../src/tokens.ts","../../../src/utils.ts","../../../src/exact-direct/client/scheme.ts","../../../src/exact-direct/client/register.ts"],"sourcesContent":["/**\n * Tezos mechanism constants\n */\n\n// Scheme identifiers\nexport const SCHEME_EXACT_DIRECT = \"exact-direct\";\n\n// CAIP-2 namespace\nexport const TEZOS_CAIP2_NAMESPACE = \"tezos\";\n\n// CAIP-2 network identifiers (derived from genesis block hash)\nexport const TEZOS_MAINNET_CAIP2 = \"tezos:NetXdQprcVkpaWU\";\nexport const TEZOS_GHOSTNET_CAIP2 = \"tezos:NetXnHfVqm9iesp\";\n\n// Default RPC endpoints\nexport const DEFAULT_MAINNET_RPC = \"https://mainnet.api.tez.ie\";\nexport const DEFAULT_GHOSTNET_RPC = \"https://ghostnet.tezos.marigold.dev\";\n\n// Default indexer API endpoints (TzKT)\nexport const DEFAULT_MAINNET_INDEXER = \"https://api.tzkt.io\";\nexport const DEFAULT_GHOSTNET_INDEXER = \"https://api.ghostnet.tzkt.io\";\n\n// FA2 token standard (TZIP-12)\nexport const FA2_TRANSFER_ENTRYPOINT = \"transfer\";\nexport const FA2_BALANCE_OF_ENTRYPOINT = \"balance_of\";\nexport const FA2_UPDATE_OPERATORS_ENTRYPOINT = \"update_operators\";\n\n// Supported networks\nexport const SUPPORTED_NETWORKS = [\n  TEZOS_MAINNET_CAIP2,\n  TEZOS_GHOSTNET_CAIP2,\n] as const;\n\n// Network configurations\nexport const NETWORK_CONFIGS: Record<\n  string,\n  {\n    name: string;\n    rpcUrl: string;\n    indexerUrl: string;\n  }\n> = {\n  [TEZOS_MAINNET_CAIP2]: {\n    name: \"Tezos Mainnet\",\n    rpcUrl: DEFAULT_MAINNET_RPC,\n    indexerUrl: DEFAULT_MAINNET_INDEXER,\n  },\n  [TEZOS_GHOSTNET_CAIP2]: {\n    name: \"Tezos Ghostnet\",\n    rpcUrl: DEFAULT_GHOSTNET_RPC,\n    indexerUrl: DEFAULT_GHOSTNET_INDEXER,\n  },\n};\n","/**\n * Tezos mechanism types\n */\n\nimport type { Network } from \"@t402/core/types\";\n\n/**\n * Exact-direct payment payload for Tezos\n */\nexport type ExactDirectTezosPayload = {\n  /** Operation hash (o...) */\n  opHash: string;\n  /** Sender address (tz1/tz2/tz3...) */\n  from: string;\n  /** Recipient address */\n  to: string;\n  /** Amount in smallest units */\n  amount: string;\n  /** FA2 contract address (KT1...) */\n  contractAddress: string;\n  /** Token ID within the FA2 contract */\n  tokenId: number;\n};\n\n/**\n * Tezos signer interface for client-side operations\n */\nexport interface TezosSigner {\n  /** Get the signer's address */\n  getAddress(): Promise<string>;\n\n  /**\n   * Execute an FA2 transfer\n   * @param contractAddress FA2 contract address\n   * @param tokenId Token ID\n   * @param to Recipient address\n   * @param amount Amount to transfer\n   * @returns Operation hash\n   */\n  transfer(\n    contractAddress: string,\n    tokenId: number,\n    to: string,\n    amount: bigint,\n  ): Promise<string>;\n\n  /**\n   * Get token balance\n   * @param contractAddress FA2 contract address\n   * @param tokenId Token ID\n   * @param address Address to check (optional, defaults to signer address)\n   * @returns Balance in smallest units\n   */\n  getBalance(\n    contractAddress: string,\n    tokenId: number,\n    address?: string,\n  ): Promise<bigint>;\n}\n\n/**\n * Tezos signer interface for facilitator operations\n */\nexport interface FacilitatorTezosSigner {\n  /** Get facilitator addresses for a network */\n  getAddresses(network: Network): string[];\n\n  /**\n   * Query an operation by hash\n   * @param opHash Operation hash\n   * @returns Operation result or null if not found\n   */\n  queryOperation(opHash: string): Promise<TezosOperationResult | null>;\n\n  /**\n   * Get token balance for an address\n   * @param contractAddress FA2 contract address\n   * @param tokenId Token ID\n   * @param address Address to check\n   * @returns Balance as string\n   */\n  getBalance(\n    contractAddress: string,\n    tokenId: number,\n    address: string,\n  ): Promise<string>;\n}\n\n/**\n * Tezos operation result from indexer\n */\nexport interface TezosOperationResult {\n  /** Operation hash */\n  hash: string;\n  /** Block level */\n  level: number;\n  /** Timestamp */\n  timestamp: string;\n  /** Status: applied, failed, backtracked, skipped */\n  status: \"applied\" | \"failed\" | \"backtracked\" | \"skipped\";\n  /** Sender address */\n  sender: {\n    address: string;\n  };\n  /** Target contract (for contract calls) */\n  target?: {\n    address: string;\n  };\n  /** Entrypoint called */\n  entrypoint?: string;\n  /** Parameter value */\n  parameter?: unknown;\n  /** Amount transferred (in mutez for XTZ) */\n  amount?: number;\n  /** Errors if failed */\n  errors?: Array<{\n    type: string;\n    message?: string;\n  }>;\n}\n\n/**\n * FA2 transfer parameter structure\n */\nexport interface FA2TransferParam {\n  from_: string;\n  txs: Array<{\n    to_: string;\n    token_id: number;\n    amount: string;\n  }>;\n}\n\n/**\n * Check if a string is a valid Tezos address\n */\nexport function isValidTezosAddress(address: string): boolean {\n  if (!address) return false;\n  // tz1, tz2, tz3 for implicit accounts, KT1 for contracts\n  const prefixPattern = /^(tz1|tz2|tz3|KT1)/;\n  if (!prefixPattern.test(address)) return false;\n  // Base58 check - length should be 36 characters\n  return address.length === 36;\n}\n\n/**\n * Check if a string is a valid Tezos operation hash\n */\nexport function isValidOperationHash(opHash: string): boolean {\n  if (!opHash) return false;\n  // Operation hashes start with 'o' and are 51 characters\n  return opHash.startsWith(\"o\") && opHash.length === 51;\n}\n\n/**\n * Check if a network is a Tezos network\n */\nexport function isTezosNetwork(network: string): boolean {\n  return network.startsWith(\"tezos:\");\n}\n","/**\n * Tezos token registry\n */\n\nimport { TEZOS_MAINNET_CAIP2, TEZOS_GHOSTNET_CAIP2 } from \"./constants.js\";\n\n/**\n * Token configuration for Tezos FA2 tokens\n */\nexport interface TokenConfig {\n  /** FA2 contract address (KT1...) */\n  contractAddress: string;\n  /** Token ID within the FA2 contract */\n  tokenId: number;\n  /** Token symbol */\n  symbol: string;\n  /** Token name */\n  name: string;\n  /** Token decimals */\n  decimals: number;\n}\n\n/**\n * USDT on Tezos Mainnet\n */\nexport const USDT_MAINNET: TokenConfig = {\n  contractAddress: \"KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o\",\n  tokenId: 0,\n  symbol: \"USDt\",\n  name: \"Tether USD\",\n  decimals: 6,\n};\n\n/**\n * Token registry by network\n */\nexport const TOKEN_REGISTRY: Record<string, TokenConfig[]> = {\n  [TEZOS_MAINNET_CAIP2]: [USDT_MAINNET],\n  [TEZOS_GHOSTNET_CAIP2]: [],\n};\n\n/**\n * Default token for each network\n */\nexport const DEFAULT_TOKENS: Record<string, TokenConfig | undefined> = {\n  [TEZOS_MAINNET_CAIP2]: USDT_MAINNET,\n  [TEZOS_GHOSTNET_CAIP2]: undefined,\n};\n\n/**\n * Get token by symbol for a network\n */\nexport function getTokenBySymbol(\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.toLowerCase() === symbol.toLowerCase(),\n  );\n}\n\n/**\n * Get token by contract address and token ID\n */\nexport function getTokenByContract(\n  network: string,\n  contractAddress: string,\n  tokenId: number,\n): TokenConfig | undefined {\n  const tokens = TOKEN_REGISTRY[network];\n  if (!tokens) return undefined;\n  return tokens.find(\n    (t) =>\n      t.contractAddress.toLowerCase() === contractAddress.toLowerCase() &&\n      t.tokenId === tokenId,\n  );\n}\n\n/**\n * Get default token for a network\n */\nexport function getDefaultToken(network: string): TokenConfig | undefined {\n  return DEFAULT_TOKENS[network];\n}\n","/**\n * Tezos utility functions\n */\n\nimport {\n  NETWORK_CONFIGS,\n  TEZOS_CAIP2_NAMESPACE,\n  SUPPORTED_NETWORKS,\n} from \"./constants.js\";\n\n/**\n * Get network configuration\n */\nexport function getNetworkConfig(network: string) {\n  return NETWORK_CONFIGS[network];\n}\n\n/**\n * Check if a network is supported\n */\nexport function isSupportedNetwork(network: string): boolean {\n  return (SUPPORTED_NETWORKS as readonly string[]).includes(network);\n}\n\n/**\n * Parse a CAIP-2 network identifier to extract the chain reference\n */\nexport function parseNetworkId(network: string): {\n  namespace: string;\n  reference: string;\n} | null {\n  const parts = network.split(\":\");\n  if (parts.length !== 2) return null;\n  return {\n    namespace: parts[0],\n    reference: parts[1],\n  };\n}\n\n/**\n * Build a CAIP-2 network identifier\n */\nexport function buildNetworkId(reference: string): string {\n  return `${TEZOS_CAIP2_NAMESPACE}:${reference}`;\n}\n\n/**\n * Get indexer URL for a network\n */\nexport function getIndexerUrl(network: string): string | undefined {\n  return NETWORK_CONFIGS[network]?.indexerUrl;\n}\n\n/**\n * Get RPC URL for a network\n */\nexport function getRpcUrl(network: string): string | undefined {\n  return NETWORK_CONFIGS[network]?.rpcUrl;\n}\n\n/**\n * Compare two Tezos addresses (case-insensitive for base58)\n */\nexport function compareAddresses(addr1: string, addr2: string): boolean {\n  if (!addr1 || !addr2) return false;\n  return addr1 === addr2;\n}\n\n/**\n * Format amount with decimals\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 fractionalStr = fractionalPart.toString().padStart(decimals, \"0\");\n  return `${wholePart}.${fractionalStr}`;\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/**\n * Extract FA2 transfer details from operation parameter\n */\nexport function extractFA2TransferDetails(\n  parameter: unknown,\n): {\n  from: string;\n  to: string;\n  tokenId: number;\n  amount: string;\n} | null {\n  if (!parameter || !Array.isArray(parameter)) return null;\n\n  // FA2 transfer parameter is an array of { from_: string, txs: [...] }\n  const firstTransfer = parameter[0];\n  if (!firstTransfer || typeof firstTransfer !== \"object\") return null;\n\n  const transfer = firstTransfer as Record<string, unknown>;\n  const from = transfer.from_ as string;\n  const txs = transfer.txs as Array<{\n    to_: string;\n    token_id: number | string;\n    amount: number | string;\n  }>;\n\n  if (!from || !Array.isArray(txs) || txs.length === 0) return null;\n\n  const firstTx = txs[0];\n  if (!firstTx) return null;\n\n  return {\n    from,\n    to: firstTx.to_,\n    tokenId:\n      typeof firstTx.token_id === \"string\"\n        ? parseInt(firstTx.token_id, 10)\n        : firstTx.token_id,\n    amount: String(firstTx.amount),\n  };\n}\n","/**\n * Tezos Exact-Direct Client Scheme\n *\n * The client executes the FA2 transfer directly and provides\n * the operation hash as proof of payment.\n */\n\nimport type {\n  SchemeNetworkClient,\n  PaymentPayload,\n  PaymentRequirements,\n} from \"@t402/core/types\";\nimport { SCHEME_EXACT_DIRECT, TEZOS_CAIP2_NAMESPACE } from \"../../constants.js\";\nimport type { TezosSigner, ExactDirectTezosPayload } from \"../../types.js\";\nimport { isValidTezosAddress } from \"../../types.js\";\nimport { getTokenBySymbol } from \"../../tokens.js\";\nimport { compareAddresses } from \"../../utils.js\";\n\n/**\n * Configuration for ExactDirectTezosClient\n */\nexport interface ExactDirectTezosClientConfig {\n  /**\n   * Whether to verify the operation was successful before returning\n   * @default true\n   */\n  verifyOperation?: boolean;\n}\n\n/**\n * Tezos Exact-Direct Client\n *\n * Implements the client-side payment flow where the client:\n * 1. Receives payment requirements\n * 2. Executes the FA2 transfer operation\n * 3. Returns operation hash as proof\n */\nexport class ExactDirectTezosClient implements SchemeNetworkClient {\n  readonly scheme = SCHEME_EXACT_DIRECT;\n\n  constructor(\n    private readonly signer: TezosSigner,\n    config: ExactDirectTezosClientConfig = {},\n  ) {\n    // Config reserved for future use\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 contract address and token ID\n    const assetInfo = this.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(\n      assetInfo.contractAddress,\n      assetInfo.tokenId,\n    );\n    if (balance < amount) {\n      throw new Error(\n        `Insufficient balance: have ${balance}, need ${amount}`,\n      );\n    }\n\n    // Execute transfer\n    const opHash = await this.signer.transfer(\n      assetInfo.contractAddress,\n      assetInfo.tokenId,\n      paymentRequirements.payTo,\n      amount,\n    );\n\n    // Create payload\n    const payload: ExactDirectTezosPayload = {\n      opHash,\n      from,\n      to: paymentRequirements.payTo,\n      amount: paymentRequirements.amount,\n      contractAddress: assetInfo.contractAddress,\n      tokenId: assetInfo.tokenId,\n    };\n\n    return {\n      t402Version,\n      payload,\n    };\n  }\n\n  /**\n   * Parse CAIP-19 asset identifier for Tezos FA2\n   * Format: tezos:{chainRef}/fa2:{contractAddress}/{tokenId}\n   */\n  private parseAssetIdentifier(\n    asset: string,\n  ): { contractAddress: string; tokenId: number } | null {\n    // Try parsing CAIP-19 format\n    const caipMatch = asset.match(/^tezos:[^/]+\\/fa2:([^/]+)\\/(\\d+)$/);\n    if (caipMatch) {\n      return {\n        contractAddress: caipMatch[1],\n        tokenId: parseInt(caipMatch[2], 10),\n      };\n    }\n\n    // Try simple format: contractAddress/tokenId or just contractAddress (default tokenId 0)\n    const simpleMatch = asset.match(/^(KT1[a-zA-Z0-9]+)(?:\\/(\\d+))?$/);\n    if (simpleMatch) {\n      return {\n        contractAddress: simpleMatch[1],\n        tokenId: simpleMatch[2] ? parseInt(simpleMatch[2], 10) : 0,\n      };\n    }\n\n    return null;\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(`${TEZOS_CAIP2_NAMESPACE}:`)) {\n      throw new Error(`Invalid network: ${requirements.network}`);\n    }\n\n    // Check payTo address\n    if (!isValidTezosAddress(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 = this.parseAssetIdentifier(requirements.asset);\n    if (!assetInfo) {\n      throw new Error(`Invalid asset: ${requirements.asset}`);\n    }\n\n    // Verify token is supported (warn for unknown tokens)\n    const tokenConfig = getTokenBySymbol(requirements.network, \"USDt\");\n    if (tokenConfig && !compareAddresses(tokenConfig.contractAddress, assetInfo.contractAddress)) {\n      console.warn(\n        `Using non-standard token: ${assetInfo.contractAddress}`,\n      );\n    }\n  }\n}\n\nexport default ExactDirectTezosClient;\n","/**\n * Registration function for Tezos Exact-Direct client\n */\n\nimport { t402Client } from \"@t402/core/client\";\nimport type { Network } from \"@t402/core/types\";\nimport type { TezosSigner } from \"../../types.js\";\nimport {\n  ExactDirectTezosClient,\n  type ExactDirectTezosClientConfig,\n} from \"./scheme.js\";\n\n/**\n * Configuration options for registering Tezos schemes to a t402Client\n */\nexport interface TezosClientConfig {\n  /**\n   * The Tezos signer for payment operations\n   */\n  signer: TezosSigner;\n\n  /**\n   * Optional specific networks to register\n   * If not provided, registers wildcard support (tezos:*)\n   */\n  networks?: Network[];\n\n  /**\n   * Optional scheme configuration\n   */\n  schemeConfig?: ExactDirectTezosClientConfig;\n}\n\n/**\n * Registers Tezos exact-direct payment scheme to a t402Client instance.\n *\n * @param client - The t402Client instance to register schemes to\n * @param config - Configuration for Tezos client registration\n * @returns The client instance for chaining\n *\n * @example\n * ```typescript\n * import { registerExactDirectTezosClient } from \"@t402/tezos/exact-direct/client\";\n * import { t402Client } from \"@t402/core/client\";\n *\n * const client = new t402Client();\n * registerExactDirectTezosClient(client, {\n *   signer: myTezosSigner,\n *   networks: [\"tezos:NetXdQprcVkpaWU\"]\n * });\n * ```\n */\nexport function registerExactDirectTezosClient(\n  client: t402Client,\n  config: TezosClientConfig,\n): t402Client {\n  const scheme = new ExactDirectTezosClient(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 Tezos networks\n    client.register(\"tezos:*\", scheme);\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 FacilitatorTezosSigner } from '../../types-DQMtUOa_.cjs';
+import { t402Facilitator } from '@t402/core/facilitator';
+
+/**
+ * Tezos Exact-Direct Facilitator Scheme
+ *
+ * Verifies FA2 transfer operations and manages replay protection.
+ */
+
+/**
+ * Configuration for ExactDirectTezosFacilitator
+ */
+interface ExactDirectTezosFacilitatorConfig {
+    /**
+     * Maximum age of operation in seconds (default: 3600 = 1 hour)
+     */
+    maxOperationAge?: number;
+    /**
+     * Duration to cache used operation hashes (in milliseconds)
+     */
+    usedOpCacheDuration?: number;
+}
+/**
+ * Tezos Exact-Direct Facilitator
+ *
+ * Implements the facilitator-side verification and settlement.
+ * For exact-direct, settlement is a no-op since client already executed.
+ */
+declare class ExactDirectTezosFacilitator implements SchemeNetworkFacilitator {
+    private readonly signer;
+    readonly scheme = "exact-direct";
+    readonly caipFamily = "tezos:*";
+    private readonly config;
+    private usedOps;
+    constructor(signer: FacilitatorTezosSigner, config?: ExactDirectTezosFacilitatorConfig);
+    /**
+     * 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 an operation has been used
+     */
+    private isOpUsed;
+    /**
+     * Mark an operation as used
+     */
+    private markOpUsed;
+    /**
+     * Start the cleanup interval for used operations
+     */
+    private startCleanupInterval;
+}
+
+/**
+ * Registration function for Tezos Exact-Direct facilitator
+ */
+
+/**
+ * Configuration options for registering Tezos schemes to a t402Facilitator
+ */
+interface TezosFacilitatorConfig {
+    /**
+     * The Tezos signer for facilitator operations (verify and settle)
+     */
+    signer: FacilitatorTezosSigner;
+    /**
+     * Optional specific networks to register
+     * If not provided, registers wildcard support (tezos:*)
+     */
+    networks?: Network[];
+    /**
+     * Optional scheme configuration
+     */
+    schemeConfig?: ExactDirectTezosFacilitatorConfig;
+}
+/**
+ * Registers Tezos exact-direct payment schemes to a t402Facilitator instance.
+ *
+ * @param facilitator - The t402Facilitator instance to register schemes to
+ * @param config - Configuration for Tezos facilitator registration
+ * @returns The facilitator instance for chaining
+ *
+ * @example
+ * ```typescript
+ * import { registerExactDirectTezosFacilitator } from "@t402/tezos/exact-direct/facilitator";
+ * import { t402Facilitator } from "@t402/core/facilitator";
+ *
+ * const facilitator = new t402Facilitator();
+ * registerExactDirectTezosFacilitator(facilitator, {
+ *   signer: myTezosSigner,
+ *   networks: ["tezos:NetXdQprcVkpaWU"]
+ * });
+ * ```
+ */
+declare function registerExactDirectTezosFacilitator(facilitator: t402Facilitator, config: TezosFacilitatorConfig): t402Facilitator;
+
+export { ExactDirectTezosFacilitator, type ExactDirectTezosFacilitatorConfig, type TezosFacilitatorConfig, registerExactDirectTezosFacilitator };

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 FacilitatorTezosSigner } from '../../types-DQMtUOa_.js';
+import { t402Facilitator } from '@t402/core/facilitator';
+
+/**
+ * Tezos Exact-Direct Facilitator Scheme
+ *
+ * Verifies FA2 transfer operations and manages replay protection.
+ */
+
+/**
+ * Configuration for ExactDirectTezosFacilitator
+ */
+interface ExactDirectTezosFacilitatorConfig {
+    /**
+     * Maximum age of operation in seconds (default: 3600 = 1 hour)
+     */
+    maxOperationAge?: number;
+    /**
+     * Duration to cache used operation hashes (in milliseconds)
+     */
+    usedOpCacheDuration?: number;
+}
+/**
+ * Tezos Exact-Direct Facilitator
+ *
+ * Implements the facilitator-side verification and settlement.
+ * For exact-direct, settlement is a no-op since client already executed.
+ */
+declare class ExactDirectTezosFacilitator implements SchemeNetworkFacilitator {
+    private readonly signer;
+    readonly scheme = "exact-direct";
+    readonly caipFamily = "tezos:*";
+    private readonly config;
+    private usedOps;
+    constructor(signer: FacilitatorTezosSigner, config?: ExactDirectTezosFacilitatorConfig);
+    /**
+     * 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 an operation has been used
+     */
+    private isOpUsed;
+    /**
+     * Mark an operation as used
+     */
+    private markOpUsed;
+    /**
+     * Start the cleanup interval for used operations
+     */
+    private startCleanupInterval;
+}
+
+/**
+ * Registration function for Tezos Exact-Direct facilitator
+ */
+
+/**
+ * Configuration options for registering Tezos schemes to a t402Facilitator
+ */
+interface TezosFacilitatorConfig {
+    /**
+     * The Tezos signer for facilitator operations (verify and settle)
+     */
+    signer: FacilitatorTezosSigner;
+    /**
+     * Optional specific networks to register
+     * If not provided, registers wildcard support (tezos:*)
+     */
+    networks?: Network[];
+    /**
+     * Optional scheme configuration
+     */
+    schemeConfig?: ExactDirectTezosFacilitatorConfig;
+}
+/**
+ * Registers Tezos exact-direct payment schemes to a t402Facilitator instance.
+ *
+ * @param facilitator - The t402Facilitator instance to register schemes to
+ * @param config - Configuration for Tezos facilitator registration
+ * @returns The facilitator instance for chaining
+ *
+ * @example
+ * ```typescript
+ * import { registerExactDirectTezosFacilitator } from "@t402/tezos/exact-direct/facilitator";
+ * import { t402Facilitator } from "@t402/core/facilitator";
+ *
+ * const facilitator = new t402Facilitator();
+ * registerExactDirectTezosFacilitator(facilitator, {
+ *   signer: myTezosSigner,
+ *   networks: ["tezos:NetXdQprcVkpaWU"]
+ * });
+ * ```
+ */
+declare function registerExactDirectTezosFacilitator(facilitator: t402Facilitator, config: TezosFacilitatorConfig): t402Facilitator;
+
+export { ExactDirectTezosFacilitator, type ExactDirectTezosFacilitatorConfig, type TezosFacilitatorConfig, registerExactDirectTezosFacilitator };