@t402/tezos 2.3.0

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

@@ -0,0 +1,198 @@
+// src/constants.ts
+var SCHEME_EXACT_DIRECT = "exact-direct";
+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/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()
+  );
+}
+function getDefaultToken(network) {
+  return DEFAULT_TOKENS[network];
+}
+
+// src/utils.ts
+function parseAmount(amount, decimals) {
+  const [whole, fractional = ""] = amount.split(".");
+  const paddedFractional = fractional.padEnd(decimals, "0").slice(0, decimals);
+  return BigInt(whole + paddedFractional);
+}
+
+// src/types.ts
+function isTezosNetwork(network) {
+  return network.startsWith("tezos:");
+}
+
+// src/exact-direct/server/scheme.ts
+var ExactDirectTezosServer = 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 Tezos-specific amount
+   */
+  async parsePrice(price, network) {
+    if (!isTezosNetwork(network)) {
+      throw new Error(`Invalid Tezos network: ${network}`);
+    }
+    if (typeof price === "object" && price !== null && "amount" in price) {
+      if (!price.asset) {
+        throw new Error(`Asset 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 Tezos-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: this.createAssetIdentifier(network, token.contractAddress, token.tokenId),
+      extra: {
+        symbol: token.symbol,
+        name: token.name,
+        decimals: token.decimals,
+        tokenId: token.tokenId
+      }
+    };
+  }
+  /**
+   * Create a CAIP-19 asset identifier for Tezos FA2
+   */
+  createAssetIdentifier(network, contractAddress, tokenId) {
+    return `${network}/fa2:${contractAddress}/${tokenId}`;
+  }
+  /**
+   * Get the default asset info for a network.
+   */
+  getDefaultAsset(network) {
+    if (this.config.preferredToken) {
+      const preferred = getTokenBySymbol(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 registerExactDirectTezosServer(server, config = {}) {
+  const scheme = new ExactDirectTezosServer(config.schemeConfig);
+  if (config.networks && config.networks.length > 0) {
+    config.networks.forEach((network) => {
+      server.register(network, scheme);
+    });
+  } else {
+    server.register("tezos:*", scheme);
+  }
+  return server;
+}
+export {
+  ExactDirectTezosServer,
+  registerExactDirectTezosServer
+};
+//# 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/types.ts","../../../src/exact-direct/server/scheme.ts","../../../src/exact-direct/server/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 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 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 Exact-Direct Server Scheme\n *\n * Handles price parsing and payment requirement enhancement for\n * Tezos FA2 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 { getTokenBySymbol, getDefaultToken, TOKEN_REGISTRY } from \"../../tokens.js\";\nimport { parseAmount } from \"../../utils.js\";\nimport { isTezosNetwork } from \"../../types.js\";\n\n/**\n * Configuration for ExactDirectTezosServer\n */\nexport interface ExactDirectTezosServerConfig {\n  /** Preferred token symbol (e.g., \"USDt\"). Defaults to network's default token. */\n  preferredToken?: string;\n}\n\n/**\n * Tezos Exact-Direct Server\n *\n * Implements the server-side price parsing and payment requirements enhancement.\n */\nexport class ExactDirectTezosServer implements SchemeNetworkServer {\n  readonly scheme = SCHEME_EXACT_DIRECT;\n  private moneyParsers: MoneyParser[] = [];\n  private config: ExactDirectTezosServerConfig;\n\n  constructor(config: ExactDirectTezosServerConfig = {}) {\n    this.config = config;\n  }\n\n  /**\n   * Register a custom money parser in the parser chain.\n   */\n  registerMoneyParser(parser: MoneyParser): ExactDirectTezosServer {\n    this.moneyParsers.push(parser);\n    return this;\n  }\n\n  /**\n   * Parse price into Tezos-specific amount\n   */\n  async parsePrice(price: Price, network: Network): Promise<AssetAmount> {\n    // Validate network\n    if (!isTezosNetwork(network)) {\n      throw new Error(`Invalid Tezos 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 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 Tezos-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: this.createAssetIdentifier(network, token.contractAddress, token.tokenId),\n      extra: {\n        symbol: token.symbol,\n        name: token.name,\n        decimals: token.decimals,\n        tokenId: token.tokenId,\n      },\n    };\n  }\n\n  /**\n   * Create a CAIP-19 asset identifier for Tezos FA2\n   */\n  private createAssetIdentifier(\n    network: Network,\n    contractAddress: string,\n    tokenId: number,\n  ): string {\n    return `${network}/fa2:${contractAddress}/${tokenId}`;\n  }\n\n  /**\n   * Get the default asset info for a network.\n   */\n  private getDefaultAsset(\n    network: Network,\n  ): { contractAddress: string; tokenId: number; 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 = getTokenBySymbol(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 ExactDirectTezosServer;\n","/**\n * Registration function for Tezos Exact-Direct server\n */\n\nimport { t402ResourceServer } from \"@t402/core/server\";\nimport type { Network } from \"@t402/core/types\";\nimport {\n  ExactDirectTezosServer,\n  type ExactDirectTezosServerConfig,\n} from \"./scheme.js\";\n\n/**\n * Configuration options for registering Tezos schemes to a t402ResourceServer\n */\nexport interface TezosServerConfig {\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?: ExactDirectTezosServerConfig;\n}\n\n/**\n * Registers Tezos exact-direct payment scheme to a t402ResourceServer instance.\n *\n * @param server - The t402ResourceServer instance to register schemes to\n * @param config - Configuration for Tezos server registration\n * @returns The server instance for chaining\n *\n * @example\n * ```typescript\n * import { registerExactDirectTezosServer } from \"@t402/tezos/exact-direct/server\";\n * import { t402ResourceServer } from \"@t402/core/server\";\n *\n * const server = new t402ResourceServer();\n * registerExactDirectTezosServer(server, {\n *   networks: [\"tezos:NetXdQprcVkpaWU\"]\n * });\n * ```\n */\nexport function registerExactDirectTezosServer(\n  server: t402ResourceServer,\n  config: TezosServerConfig = {},\n): t402ResourceServer {\n  const scheme = new ExactDirectTezosServer(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 Tezos networks\n    server.register(\"tezos:*\", scheme);\n  }\n\n  return server;\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,124 @@
+export { E as ExactDirectTezosPayload, b as FA2TransferParam, F as FacilitatorTezosSigner, a as TezosOperationResult, T as TezosSigner, d as isTezosNetwork, c as isValidOperationHash, i as isValidTezosAddress } from './types-DQMtUOa_.cjs';
+import '@t402/core/types';
+
+/**
+ * Tezos mechanism constants
+ */
+declare const SCHEME_EXACT_DIRECT = "exact-direct";
+declare const TEZOS_CAIP2_NAMESPACE = "tezos";
+declare const TEZOS_MAINNET_CAIP2 = "tezos:NetXdQprcVkpaWU";
+declare const TEZOS_GHOSTNET_CAIP2 = "tezos:NetXnHfVqm9iesp";
+declare const DEFAULT_MAINNET_RPC = "https://mainnet.api.tez.ie";
+declare const DEFAULT_GHOSTNET_RPC = "https://ghostnet.tezos.marigold.dev";
+declare const DEFAULT_MAINNET_INDEXER = "https://api.tzkt.io";
+declare const DEFAULT_GHOSTNET_INDEXER = "https://api.ghostnet.tzkt.io";
+declare const FA2_TRANSFER_ENTRYPOINT = "transfer";
+declare const FA2_BALANCE_OF_ENTRYPOINT = "balance_of";
+declare const FA2_UPDATE_OPERATORS_ENTRYPOINT = "update_operators";
+declare const SUPPORTED_NETWORKS: readonly ["tezos:NetXdQprcVkpaWU", "tezos:NetXnHfVqm9iesp"];
+declare const NETWORK_CONFIGS: Record<string, {
+    name: string;
+    rpcUrl: string;
+    indexerUrl: string;
+}>;
+
+/**
+ * Tezos token registry
+ */
+/**
+ * Token configuration for Tezos FA2 tokens
+ */
+interface TokenConfig {
+    /** FA2 contract address (KT1...) */
+    contractAddress: string;
+    /** Token ID within the FA2 contract */
+    tokenId: number;
+    /** Token symbol */
+    symbol: string;
+    /** Token name */
+    name: string;
+    /** Token decimals */
+    decimals: number;
+}
+/**
+ * USDT on Tezos Mainnet
+ */
+declare const USDT_MAINNET: TokenConfig;
+/**
+ * Token registry by network
+ */
+declare const TOKEN_REGISTRY: Record<string, TokenConfig[]>;
+/**
+ * Default token for each network
+ */
+declare const DEFAULT_TOKENS: Record<string, TokenConfig | undefined>;
+/**
+ * Get token by symbol for a network
+ */
+declare function getTokenBySymbol(network: string, symbol: string): TokenConfig | undefined;
+/**
+ * Get token by contract address and token ID
+ */
+declare function getTokenByContract(network: string, contractAddress: string, tokenId: number): TokenConfig | undefined;
+/**
+ * Get default token for a network
+ */
+declare function getDefaultToken(network: string): TokenConfig | undefined;
+
+/**
+ * Tezos utility functions
+ */
+/**
+ * Get network configuration
+ */
+declare function getNetworkConfig(network: string): {
+    name: string;
+    rpcUrl: string;
+    indexerUrl: string;
+};
+/**
+ * Check if a network is supported
+ */
+declare function isSupportedNetwork(network: string): boolean;
+/**
+ * Parse a CAIP-2 network identifier to extract the chain reference
+ */
+declare function parseNetworkId(network: string): {
+    namespace: string;
+    reference: string;
+} | null;
+/**
+ * Build a CAIP-2 network identifier
+ */
+declare function buildNetworkId(reference: string): string;
+/**
+ * Get indexer URL for a network
+ */
+declare function getIndexerUrl(network: string): string | undefined;
+/**
+ * Get RPC URL for a network
+ */
+declare function getRpcUrl(network: string): string | undefined;
+/**
+ * Compare two Tezos addresses (case-insensitive for base58)
+ */
+declare function compareAddresses(addr1: string, addr2: string): boolean;
+/**
+ * Format amount with decimals
+ */
+declare function formatAmount(amount: bigint, decimals: number): string;
+/**
+ * Parse amount string to bigint
+ */
+declare function parseAmount(amount: string, decimals: number): bigint;
+/**
+ * Extract FA2 transfer details from operation parameter
+ */
+declare function extractFA2TransferDetails(parameter: unknown): {
+    from: string;
+    to: string;
+    tokenId: number;
+    amount: string;
+} | null;
+
+export { DEFAULT_GHOSTNET_INDEXER, DEFAULT_GHOSTNET_RPC, DEFAULT_MAINNET_INDEXER, DEFAULT_MAINNET_RPC, DEFAULT_TOKENS, FA2_BALANCE_OF_ENTRYPOINT, FA2_TRANSFER_ENTRYPOINT, FA2_UPDATE_OPERATORS_ENTRYPOINT, NETWORK_CONFIGS, SCHEME_EXACT_DIRECT, SUPPORTED_NETWORKS, TEZOS_CAIP2_NAMESPACE, TEZOS_GHOSTNET_CAIP2, TEZOS_MAINNET_CAIP2, TOKEN_REGISTRY, type TokenConfig, USDT_MAINNET, buildNetworkId, compareAddresses, extractFA2TransferDetails, formatAmount, getDefaultToken, getIndexerUrl, getNetworkConfig, getRpcUrl, getTokenByContract, getTokenBySymbol, isSupportedNetwork, parseAmount, parseNetworkId };

package/dist/index.d.ts

@@ -0,0 +1,124 @@
+export { E as ExactDirectTezosPayload, b as FA2TransferParam, F as FacilitatorTezosSigner, a as TezosOperationResult, T as TezosSigner, d as isTezosNetwork, c as isValidOperationHash, i as isValidTezosAddress } from './types-DQMtUOa_.js';
+import '@t402/core/types';
+
+/**
+ * Tezos mechanism constants
+ */
+declare const SCHEME_EXACT_DIRECT = "exact-direct";
+declare const TEZOS_CAIP2_NAMESPACE = "tezos";
+declare const TEZOS_MAINNET_CAIP2 = "tezos:NetXdQprcVkpaWU";
+declare const TEZOS_GHOSTNET_CAIP2 = "tezos:NetXnHfVqm9iesp";
+declare const DEFAULT_MAINNET_RPC = "https://mainnet.api.tez.ie";
+declare const DEFAULT_GHOSTNET_RPC = "https://ghostnet.tezos.marigold.dev";
+declare const DEFAULT_MAINNET_INDEXER = "https://api.tzkt.io";
+declare const DEFAULT_GHOSTNET_INDEXER = "https://api.ghostnet.tzkt.io";
+declare const FA2_TRANSFER_ENTRYPOINT = "transfer";
+declare const FA2_BALANCE_OF_ENTRYPOINT = "balance_of";
+declare const FA2_UPDATE_OPERATORS_ENTRYPOINT = "update_operators";
+declare const SUPPORTED_NETWORKS: readonly ["tezos:NetXdQprcVkpaWU", "tezos:NetXnHfVqm9iesp"];
+declare const NETWORK_CONFIGS: Record<string, {
+    name: string;
+    rpcUrl: string;
+    indexerUrl: string;
+}>;
+
+/**
+ * Tezos token registry
+ */
+/**
+ * Token configuration for Tezos FA2 tokens
+ */
+interface TokenConfig {
+    /** FA2 contract address (KT1...) */
+    contractAddress: string;
+    /** Token ID within the FA2 contract */
+    tokenId: number;
+    /** Token symbol */
+    symbol: string;
+    /** Token name */
+    name: string;
+    /** Token decimals */
+    decimals: number;
+}
+/**
+ * USDT on Tezos Mainnet
+ */
+declare const USDT_MAINNET: TokenConfig;
+/**
+ * Token registry by network
+ */
+declare const TOKEN_REGISTRY: Record<string, TokenConfig[]>;
+/**
+ * Default token for each network
+ */
+declare const DEFAULT_TOKENS: Record<string, TokenConfig | undefined>;
+/**
+ * Get token by symbol for a network
+ */
+declare function getTokenBySymbol(network: string, symbol: string): TokenConfig | undefined;
+/**
+ * Get token by contract address and token ID
+ */
+declare function getTokenByContract(network: string, contractAddress: string, tokenId: number): TokenConfig | undefined;
+/**
+ * Get default token for a network
+ */
+declare function getDefaultToken(network: string): TokenConfig | undefined;
+
+/**
+ * Tezos utility functions
+ */
+/**
+ * Get network configuration
+ */
+declare function getNetworkConfig(network: string): {
+    name: string;
+    rpcUrl: string;
+    indexerUrl: string;
+};
+/**
+ * Check if a network is supported
+ */
+declare function isSupportedNetwork(network: string): boolean;
+/**
+ * Parse a CAIP-2 network identifier to extract the chain reference
+ */
+declare function parseNetworkId(network: string): {
+    namespace: string;
+    reference: string;
+} | null;
+/**
+ * Build a CAIP-2 network identifier
+ */
+declare function buildNetworkId(reference: string): string;
+/**
+ * Get indexer URL for a network
+ */
+declare function getIndexerUrl(network: string): string | undefined;
+/**
+ * Get RPC URL for a network
+ */
+declare function getRpcUrl(network: string): string | undefined;
+/**
+ * Compare two Tezos addresses (case-insensitive for base58)
+ */
+declare function compareAddresses(addr1: string, addr2: string): boolean;
+/**
+ * Format amount with decimals
+ */
+declare function formatAmount(amount: bigint, decimals: number): string;
+/**
+ * Parse amount string to bigint
+ */
+declare function parseAmount(amount: string, decimals: number): bigint;
+/**
+ * Extract FA2 transfer details from operation parameter
+ */
+declare function extractFA2TransferDetails(parameter: unknown): {
+    from: string;
+    to: string;
+    tokenId: number;
+    amount: string;
+} | null;
+
+export { DEFAULT_GHOSTNET_INDEXER, DEFAULT_GHOSTNET_RPC, DEFAULT_MAINNET_INDEXER, DEFAULT_MAINNET_RPC, DEFAULT_TOKENS, FA2_BALANCE_OF_ENTRYPOINT, FA2_TRANSFER_ENTRYPOINT, FA2_UPDATE_OPERATORS_ENTRYPOINT, NETWORK_CONFIGS, SCHEME_EXACT_DIRECT, SUPPORTED_NETWORKS, TEZOS_CAIP2_NAMESPACE, TEZOS_GHOSTNET_CAIP2, TEZOS_MAINNET_CAIP2, TOKEN_REGISTRY, type TokenConfig, USDT_MAINNET, buildNetworkId, compareAddresses, extractFA2TransferDetails, formatAmount, getDefaultToken, getIndexerUrl, getNetworkConfig, getRpcUrl, getTokenByContract, getTokenBySymbol, isSupportedNetwork, parseAmount, parseNetworkId };