@t402/tezos 2.3.0

package/dist/index.js

@@ -0,0 +1,228 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  DEFAULT_GHOSTNET_INDEXER: () => DEFAULT_GHOSTNET_INDEXER,
+  DEFAULT_GHOSTNET_RPC: () => DEFAULT_GHOSTNET_RPC,
+  DEFAULT_MAINNET_INDEXER: () => DEFAULT_MAINNET_INDEXER,
+  DEFAULT_MAINNET_RPC: () => DEFAULT_MAINNET_RPC,
+  DEFAULT_TOKENS: () => DEFAULT_TOKENS,
+  FA2_BALANCE_OF_ENTRYPOINT: () => FA2_BALANCE_OF_ENTRYPOINT,
+  FA2_TRANSFER_ENTRYPOINT: () => FA2_TRANSFER_ENTRYPOINT,
+  FA2_UPDATE_OPERATORS_ENTRYPOINT: () => FA2_UPDATE_OPERATORS_ENTRYPOINT,
+  NETWORK_CONFIGS: () => NETWORK_CONFIGS,
+  SCHEME_EXACT_DIRECT: () => SCHEME_EXACT_DIRECT,
+  SUPPORTED_NETWORKS: () => SUPPORTED_NETWORKS,
+  TEZOS_CAIP2_NAMESPACE: () => TEZOS_CAIP2_NAMESPACE,
+  TEZOS_GHOSTNET_CAIP2: () => TEZOS_GHOSTNET_CAIP2,
+  TEZOS_MAINNET_CAIP2: () => TEZOS_MAINNET_CAIP2,
+  TOKEN_REGISTRY: () => TOKEN_REGISTRY,
+  USDT_MAINNET: () => USDT_MAINNET,
+  buildNetworkId: () => buildNetworkId,
+  compareAddresses: () => compareAddresses,
+  extractFA2TransferDetails: () => extractFA2TransferDetails,
+  formatAmount: () => formatAmount,
+  getDefaultToken: () => getDefaultToken,
+  getIndexerUrl: () => getIndexerUrl,
+  getNetworkConfig: () => getNetworkConfig,
+  getRpcUrl: () => getRpcUrl,
+  getTokenByContract: () => getTokenByContract,
+  getTokenBySymbol: () => getTokenBySymbol,
+  isSupportedNetwork: () => isSupportedNetwork,
+  isTezosNetwork: () => isTezosNetwork,
+  isValidOperationHash: () => isValidOperationHash,
+  isValidTezosAddress: () => isValidTezosAddress,
+  parseAmount: () => parseAmount,
+  parseNetworkId: () => parseNetworkId
+});
+module.exports = __toCommonJS(src_exports);
+
+// 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 FA2_TRANSFER_ENTRYPOINT = "transfer";
+var FA2_BALANCE_OF_ENTRYPOINT = "balance_of";
+var FA2_UPDATE_OPERATORS_ENTRYPOINT = "update_operators";
+var SUPPORTED_NETWORKS = [
+  TEZOS_MAINNET_CAIP2,
+  TEZOS_GHOSTNET_CAIP2
+];
+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;
+}
+function isValidOperationHash(opHash) {
+  if (!opHash) return false;
+  return opHash.startsWith("o") && opHash.length === 51;
+}
+function isTezosNetwork(network) {
+  return network.startsWith("tezos:");
+}
+
+// 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 getTokenByContract(network, contractAddress, tokenId) {
+  const tokens = TOKEN_REGISTRY[network];
+  if (!tokens) return void 0;
+  return tokens.find(
+    (t) => t.contractAddress.toLowerCase() === contractAddress.toLowerCase() && t.tokenId === tokenId
+  );
+}
+function getDefaultToken(network) {
+  return DEFAULT_TOKENS[network];
+}
+
+// src/utils.ts
+function getNetworkConfig(network) {
+  return NETWORK_CONFIGS[network];
+}
+function isSupportedNetwork(network) {
+  return SUPPORTED_NETWORKS.includes(network);
+}
+function parseNetworkId(network) {
+  const parts = network.split(":");
+  if (parts.length !== 2) return null;
+  return {
+    namespace: parts[0],
+    reference: parts[1]
+  };
+}
+function buildNetworkId(reference) {
+  return `${TEZOS_CAIP2_NAMESPACE}:${reference}`;
+}
+function getIndexerUrl(network) {
+  return NETWORK_CONFIGS[network]?.indexerUrl;
+}
+function getRpcUrl(network) {
+  return NETWORK_CONFIGS[network]?.rpcUrl;
+}
+function compareAddresses(addr1, addr2) {
+  if (!addr1 || !addr2) return false;
+  return addr1 === addr2;
+}
+function formatAmount(amount, decimals) {
+  const divisor = BigInt(10 ** decimals);
+  const wholePart = amount / divisor;
+  const fractionalPart = amount % divisor;
+  const fractionalStr = fractionalPart.toString().padStart(decimals, "0");
+  return `${wholePart}.${fractionalStr}`;
+}
+function parseAmount(amount, decimals) {
+  const [whole, fractional = ""] = amount.split(".");
+  const paddedFractional = fractional.padEnd(decimals, "0").slice(0, decimals);
+  return BigInt(whole + paddedFractional);
+}
+function extractFA2TransferDetails(parameter) {
+  if (!parameter || !Array.isArray(parameter)) return null;
+  const firstTransfer = parameter[0];
+  if (!firstTransfer || typeof firstTransfer !== "object") return null;
+  const transfer = firstTransfer;
+  const from = transfer.from_;
+  const txs = transfer.txs;
+  if (!from || !Array.isArray(txs) || txs.length === 0) return null;
+  const firstTx = txs[0];
+  if (!firstTx) return null;
+  return {
+    from,
+    to: firstTx.to_,
+    tokenId: typeof firstTx.token_id === "string" ? parseInt(firstTx.token_id, 10) : firstTx.token_id,
+    amount: String(firstTx.amount)
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  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,
+  USDT_MAINNET,
+  buildNetworkId,
+  compareAddresses,
+  extractFA2TransferDetails,
+  formatAmount,
+  getDefaultToken,
+  getIndexerUrl,
+  getNetworkConfig,
+  getRpcUrl,
+  getTokenByContract,
+  getTokenBySymbol,
+  isSupportedNetwork,
+  isTezosNetwork,
+  isValidOperationHash,
+  isValidTezosAddress,
+  parseAmount,
+  parseNetworkId
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/constants.ts","../src/types.ts","../src/tokens.ts","../src/utils.ts"],"sourcesContent":["/**\n * @t402/tezos - Tezos (FA2) mechanism for T402 payment protocol\n *\n * This package provides client, server, and facilitator implementations\n * for processing USDT payments on Tezos using the FA2 token standard (TZIP-12).\n *\n * @example\n * ```typescript\n * // Client usage\n * import { registerExactDirectTezosClient } from \"@t402/tezos/exact-direct/client\";\n *\n * // Server usage\n * import { registerExactDirectTezosServer } from \"@t402/tezos/exact-direct/server\";\n *\n * // Facilitator usage\n * import { registerExactDirectTezosFacilitator } from \"@t402/tezos/exact-direct/facilitator\";\n * ```\n *\n * @packageDocumentation\n */\n\n// Constants\nexport * from \"./constants.js\";\n\n// Types\nexport * from \"./types.js\";\n\n// Tokens\nexport * from \"./tokens.js\";\n\n// Utilities\nexport * from \"./utils.js\";\n","/**\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"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,170 @@
+// 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 FA2_TRANSFER_ENTRYPOINT = "transfer";
+var FA2_BALANCE_OF_ENTRYPOINT = "balance_of";
+var FA2_UPDATE_OPERATORS_ENTRYPOINT = "update_operators";
+var SUPPORTED_NETWORKS = [
+  TEZOS_MAINNET_CAIP2,
+  TEZOS_GHOSTNET_CAIP2
+];
+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;
+}
+function isValidOperationHash(opHash) {
+  if (!opHash) return false;
+  return opHash.startsWith("o") && opHash.length === 51;
+}
+function isTezosNetwork(network) {
+  return network.startsWith("tezos:");
+}
+
+// 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 getTokenByContract(network, contractAddress, tokenId) {
+  const tokens = TOKEN_REGISTRY[network];
+  if (!tokens) return void 0;
+  return tokens.find(
+    (t) => t.contractAddress.toLowerCase() === contractAddress.toLowerCase() && t.tokenId === tokenId
+  );
+}
+function getDefaultToken(network) {
+  return DEFAULT_TOKENS[network];
+}
+
+// src/utils.ts
+function getNetworkConfig(network) {
+  return NETWORK_CONFIGS[network];
+}
+function isSupportedNetwork(network) {
+  return SUPPORTED_NETWORKS.includes(network);
+}
+function parseNetworkId(network) {
+  const parts = network.split(":");
+  if (parts.length !== 2) return null;
+  return {
+    namespace: parts[0],
+    reference: parts[1]
+  };
+}
+function buildNetworkId(reference) {
+  return `${TEZOS_CAIP2_NAMESPACE}:${reference}`;
+}
+function getIndexerUrl(network) {
+  return NETWORK_CONFIGS[network]?.indexerUrl;
+}
+function getRpcUrl(network) {
+  return NETWORK_CONFIGS[network]?.rpcUrl;
+}
+function compareAddresses(addr1, addr2) {
+  if (!addr1 || !addr2) return false;
+  return addr1 === addr2;
+}
+function formatAmount(amount, decimals) {
+  const divisor = BigInt(10 ** decimals);
+  const wholePart = amount / divisor;
+  const fractionalPart = amount % divisor;
+  const fractionalStr = fractionalPart.toString().padStart(decimals, "0");
+  return `${wholePart}.${fractionalStr}`;
+}
+function parseAmount(amount, decimals) {
+  const [whole, fractional = ""] = amount.split(".");
+  const paddedFractional = fractional.padEnd(decimals, "0").slice(0, decimals);
+  return BigInt(whole + paddedFractional);
+}
+function extractFA2TransferDetails(parameter) {
+  if (!parameter || !Array.isArray(parameter)) return null;
+  const firstTransfer = parameter[0];
+  if (!firstTransfer || typeof firstTransfer !== "object") return null;
+  const transfer = firstTransfer;
+  const from = transfer.from_;
+  const txs = transfer.txs;
+  if (!from || !Array.isArray(txs) || txs.length === 0) return null;
+  const firstTx = txs[0];
+  if (!firstTx) return null;
+  return {
+    from,
+    to: firstTx.to_,
+    tokenId: typeof firstTx.token_id === "string" ? parseInt(firstTx.token_id, 10) : firstTx.token_id,
+    amount: String(firstTx.amount)
+  };
+}
+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,
+  USDT_MAINNET,
+  buildNetworkId,
+  compareAddresses,
+  extractFA2TransferDetails,
+  formatAmount,
+  getDefaultToken,
+  getIndexerUrl,
+  getNetworkConfig,
+  getRpcUrl,
+  getTokenByContract,
+  getTokenBySymbol,
+  isSupportedNetwork,
+  isTezosNetwork,
+  isValidOperationHash,
+  isValidTezosAddress,
+  parseAmount,
+  parseNetworkId
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts","../src/types.ts","../src/tokens.ts","../src/utils.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"],"mappings":"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","names":[]}

package/dist/types-DQMtUOa_.d.cts

@@ -0,0 +1,125 @@
+import { Network } from '@t402/core/types';
+
+/**
+ * Tezos mechanism types
+ */
+
+/**
+ * Exact-direct payment payload for Tezos
+ */
+type ExactDirectTezosPayload = {
+    /** Operation hash (o...) */
+    opHash: string;
+    /** Sender address (tz1/tz2/tz3...) */
+    from: string;
+    /** Recipient address */
+    to: string;
+    /** Amount in smallest units */
+    amount: string;
+    /** FA2 contract address (KT1...) */
+    contractAddress: string;
+    /** Token ID within the FA2 contract */
+    tokenId: number;
+};
+/**
+ * Tezos signer interface for client-side operations
+ */
+interface TezosSigner {
+    /** Get the signer's address */
+    getAddress(): Promise<string>;
+    /**
+     * Execute an FA2 transfer
+     * @param contractAddress FA2 contract address
+     * @param tokenId Token ID
+     * @param to Recipient address
+     * @param amount Amount to transfer
+     * @returns Operation hash
+     */
+    transfer(contractAddress: string, tokenId: number, to: string, amount: bigint): Promise<string>;
+    /**
+     * Get token balance
+     * @param contractAddress FA2 contract address
+     * @param tokenId Token ID
+     * @param address Address to check (optional, defaults to signer address)
+     * @returns Balance in smallest units
+     */
+    getBalance(contractAddress: string, tokenId: number, address?: string): Promise<bigint>;
+}
+/**
+ * Tezos signer interface for facilitator operations
+ */
+interface FacilitatorTezosSigner {
+    /** Get facilitator addresses for a network */
+    getAddresses(network: Network): string[];
+    /**
+     * Query an operation by hash
+     * @param opHash Operation hash
+     * @returns Operation result or null if not found
+     */
+    queryOperation(opHash: string): Promise<TezosOperationResult | null>;
+    /**
+     * Get token balance for an address
+     * @param contractAddress FA2 contract address
+     * @param tokenId Token ID
+     * @param address Address to check
+     * @returns Balance as string
+     */
+    getBalance(contractAddress: string, tokenId: number, address: string): Promise<string>;
+}
+/**
+ * Tezos operation result from indexer
+ */
+interface TezosOperationResult {
+    /** Operation hash */
+    hash: string;
+    /** Block level */
+    level: number;
+    /** Timestamp */
+    timestamp: string;
+    /** Status: applied, failed, backtracked, skipped */
+    status: "applied" | "failed" | "backtracked" | "skipped";
+    /** Sender address */
+    sender: {
+        address: string;
+    };
+    /** Target contract (for contract calls) */
+    target?: {
+        address: string;
+    };
+    /** Entrypoint called */
+    entrypoint?: string;
+    /** Parameter value */
+    parameter?: unknown;
+    /** Amount transferred (in mutez for XTZ) */
+    amount?: number;
+    /** Errors if failed */
+    errors?: Array<{
+        type: string;
+        message?: string;
+    }>;
+}
+/**
+ * FA2 transfer parameter structure
+ */
+interface FA2TransferParam {
+    from_: string;
+    txs: Array<{
+        to_: string;
+        token_id: number;
+        amount: string;
+    }>;
+}
+/**
+ * Check if a string is a valid Tezos address
+ */
+declare function isValidTezosAddress(address: string): boolean;
+/**
+ * Check if a string is a valid Tezos operation hash
+ */
+declare function isValidOperationHash(opHash: string): boolean;
+/**
+ * Check if a network is a Tezos network
+ */
+declare function isTezosNetwork(network: string): boolean;
+
+export { type ExactDirectTezosPayload as E, type FacilitatorTezosSigner as F, type TezosSigner as T, type TezosOperationResult as a, type FA2TransferParam as b, isValidOperationHash as c, isTezosNetwork as d, isValidTezosAddress as i };