@t402/tezos 2.3.0

package/README.md

@@ -0,0 +1,161 @@
+# @t402/tezos
+
+Tezos implementation of the t402 payment protocol using the **exact-direct** payment scheme with FA2 token transfers (TZIP-12).
+
+## Installation
+
+```bash
+npm install @t402/tezos
+# or
+pnpm add @t402/tezos
+```
+
+## Overview
+
+This package provides support for USDT payments on Tezos using the exact-direct scheme. The client executes an FA2 `transfer` operation directly on-chain, then provides the operation hash as proof of payment.
+
+Three main components:
+
+- **Client** - For applications that make payments (have Tezos wallets)
+- **Facilitator** - For payment processors that verify operations via TzKT
+- **Server** - For resource servers that accept payments and build payment requirements
+
+## Supported Networks
+
+| Network | CAIP-2 Identifier | USDT Contract | Status |
+|---------|-------------------|---------------|--------|
+| Tezos Mainnet | `tezos:NetXdQprcVkpaWU` | `KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o` | Production |
+| Tezos Ghostnet | `tezos:NetXnHfVqm9iesp` | - | Testnet |
+
+## Package Exports
+
+### Main Package (`@t402/tezos`)
+
+**Constants:**
+- `TEZOS_MAINNET_CAIP2` - CAIP-2 identifier for mainnet
+- `TEZOS_GHOSTNET_CAIP2` - CAIP-2 identifier for ghostnet
+- `DEFAULT_MAINNET_RPC` - Default RPC endpoint
+- `DEFAULT_MAINNET_INDEXER` - TzKT API endpoint
+- `getNetworkConfig(network)` - Get network configuration
+
+**Tokens:**
+- `USDT_MAINNET` - USDT token config on mainnet
+- `TOKEN_REGISTRY` - Token configurations by network
+- `getTokenBySymbol(network, symbol)` - Get token by symbol
+- `getTokenByContract(network, address, tokenId)` - Get token by contract
+- `getDefaultToken(network)` - Get default token
+
+**Utilities:**
+- `isValidTezosAddress(address)` - Validate tz1/tz2/tz3/KT1 address
+- `isValidOperationHash(hash)` - Validate operation hash
+- `isTezosNetwork(network)` - Check if network is Tezos
+- `compareAddresses(addr1, addr2)` - Compare addresses
+- `formatAmount(amount, decimals)` - Format for display
+- `parseAmount(amount, decimals)` - Parse to smallest units
+- `extractFA2TransferDetails(operation)` - Extract transfer from operation
+
+### Client (`@t402/tezos/exact-direct/client`)
+
+```typescript
+import { createExactDirectTezosClient } from '@t402/tezos/exact-direct/client';
+
+const client = createExactDirectTezosClient({
+  signer: myTezosSigner,
+});
+```
+
+### Server (`@t402/tezos/exact-direct/server`)
+
+```typescript
+import { registerExactDirectTezosServer } from '@t402/tezos/exact-direct/server';
+
+registerExactDirectTezosServer(server);
+```
+
+### Facilitator (`@t402/tezos/exact-direct/facilitator`)
+
+```typescript
+import { createExactDirectTezosFacilitator } from '@t402/tezos/exact-direct/facilitator';
+
+const facilitator = createExactDirectTezosFacilitator(signer);
+```
+
+## Payment Flow
+
+1. **Client** requests protected resource
+2. **Server** responds with 402 + payment requirements (network, amount, payTo)
+3. **Client** calls FA2 `transfer` entrypoint on USDT contract
+4. **Client** submits operation hash as payment proof
+5. **Facilitator** queries TzKT API to verify the operation
+6. **Facilitator** confirms payment matches requirements
+
+## Payload Structure
+
+```typescript
+interface ExactDirectTezosPayload {
+  opHash: string;           // Operation hash (starts with 'o')
+  from: string;             // Sender address (tz1/tz2/tz3)
+  to: string;               // Recipient address
+  amount: string;           // Amount in smallest units
+  contractAddress: string;  // FA2 contract (KT1...)
+  tokenId: number;          // Token ID (0 for USDT)
+}
+```
+
+## Address Formats
+
+Tezos uses different address prefixes:
+- `tz1` - Ed25519 public key hash
+- `tz2` - Secp256k1 public key hash
+- `tz3` - P256 public key hash
+- `KT1` - Smart contract address
+
+All addresses are 36 characters, Base58Check encoded.
+
+Examples:
+```
+tz1VSUr8wwNhLAzempoch5d6hLRiTh8Cjcjb  (implicit account)
+KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o  (USDT contract)
+```
+
+## FA2 Token Standard
+
+This package uses the FA2 (TZIP-12) token standard:
+- Multi-asset contract support
+- Token ID identifies specific token within contract
+- Standard `transfer` entrypoint
+
+```typescript
+// FA2 transfer parameter structure
+[{
+  from_: "tz1...",
+  txs: [{
+    to_: "tz2...",
+    token_id: 0,
+    amount: "1000000"
+  }]
+}]
+```
+
+## Development
+
+```bash
+# Build
+pnpm build
+
+# Test
+pnpm test
+
+# Test with coverage
+pnpm test:coverage
+
+# Lint
+pnpm lint
+```
+
+## Related Packages
+
+- `@t402/core` - Core protocol types and client
+- `@t402/fetch` - HTTP wrapper with automatic payment handling
+- `@t402/evm` - EVM chains implementation
+- `@t402/polkadot` - Polkadot Asset Hub implementation

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

@@ -0,0 +1,92 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayload, Network } from '@t402/core/types';
+import { T as TezosSigner } from '../../types-DQMtUOa_.cjs';
+import { t402Client } from '@t402/core/client';
+
+/**
+ * Tezos Exact-Direct Client Scheme
+ *
+ * The client executes the FA2 transfer directly and provides
+ * the operation hash as proof of payment.
+ */
+
+/**
+ * Configuration for ExactDirectTezosClient
+ */
+interface ExactDirectTezosClientConfig {
+    /**
+     * Whether to verify the operation was successful before returning
+     * @default true
+     */
+    verifyOperation?: boolean;
+}
+/**
+ * Tezos Exact-Direct Client
+ *
+ * Implements the client-side payment flow where the client:
+ * 1. Receives payment requirements
+ * 2. Executes the FA2 transfer operation
+ * 3. Returns operation hash as proof
+ */
+declare class ExactDirectTezosClient implements SchemeNetworkClient {
+    private readonly signer;
+    readonly scheme = "exact-direct";
+    constructor(signer: TezosSigner, config?: ExactDirectTezosClientConfig);
+    /**
+     * Create a payment payload by executing the transfer
+     */
+    createPaymentPayload(t402Version: number, paymentRequirements: PaymentRequirements): Promise<Pick<PaymentPayload, "t402Version" | "payload">>;
+    /**
+     * Parse CAIP-19 asset identifier for Tezos FA2
+     * Format: tezos:{chainRef}/fa2:{contractAddress}/{tokenId}
+     */
+    private parseAssetIdentifier;
+    /**
+     * Validate payment requirements
+     */
+    private validateRequirements;
+}
+
+/**
+ * Registration function for Tezos Exact-Direct client
+ */
+
+/**
+ * Configuration options for registering Tezos schemes to a t402Client
+ */
+interface TezosClientConfig {
+    /**
+     * The Tezos signer for payment operations
+     */
+    signer: TezosSigner;
+    /**
+     * Optional specific networks to register
+     * If not provided, registers wildcard support (tezos:*)
+     */
+    networks?: Network[];
+    /**
+     * Optional scheme configuration
+     */
+    schemeConfig?: ExactDirectTezosClientConfig;
+}
+/**
+ * Registers Tezos exact-direct payment scheme to a t402Client instance.
+ *
+ * @param client - The t402Client instance to register schemes to
+ * @param config - Configuration for Tezos client registration
+ * @returns The client instance for chaining
+ *
+ * @example
+ * ```typescript
+ * import { registerExactDirectTezosClient } from "@t402/tezos/exact-direct/client";
+ * import { t402Client } from "@t402/core/client";
+ *
+ * const client = new t402Client();
+ * registerExactDirectTezosClient(client, {
+ *   signer: myTezosSigner,
+ *   networks: ["tezos:NetXdQprcVkpaWU"]
+ * });
+ * ```
+ */
+declare function registerExactDirectTezosClient(client: t402Client, config: TezosClientConfig): t402Client;
+
+export { ExactDirectTezosClient, type ExactDirectTezosClientConfig, type TezosClientConfig, registerExactDirectTezosClient };

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

@@ -0,0 +1,92 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayload, Network } from '@t402/core/types';
+import { T as TezosSigner } from '../../types-DQMtUOa_.js';
+import { t402Client } from '@t402/core/client';
+
+/**
+ * Tezos Exact-Direct Client Scheme
+ *
+ * The client executes the FA2 transfer directly and provides
+ * the operation hash as proof of payment.
+ */
+
+/**
+ * Configuration for ExactDirectTezosClient
+ */
+interface ExactDirectTezosClientConfig {
+    /**
+     * Whether to verify the operation was successful before returning
+     * @default true
+     */
+    verifyOperation?: boolean;
+}
+/**
+ * Tezos Exact-Direct Client
+ *
+ * Implements the client-side payment flow where the client:
+ * 1. Receives payment requirements
+ * 2. Executes the FA2 transfer operation
+ * 3. Returns operation hash as proof
+ */
+declare class ExactDirectTezosClient implements SchemeNetworkClient {
+    private readonly signer;
+    readonly scheme = "exact-direct";
+    constructor(signer: TezosSigner, config?: ExactDirectTezosClientConfig);
+    /**
+     * Create a payment payload by executing the transfer
+     */
+    createPaymentPayload(t402Version: number, paymentRequirements: PaymentRequirements): Promise<Pick<PaymentPayload, "t402Version" | "payload">>;
+    /**
+     * Parse CAIP-19 asset identifier for Tezos FA2
+     * Format: tezos:{chainRef}/fa2:{contractAddress}/{tokenId}
+     */
+    private parseAssetIdentifier;
+    /**
+     * Validate payment requirements
+     */
+    private validateRequirements;
+}
+
+/**
+ * Registration function for Tezos Exact-Direct client
+ */
+
+/**
+ * Configuration options for registering Tezos schemes to a t402Client
+ */
+interface TezosClientConfig {
+    /**
+     * The Tezos signer for payment operations
+     */
+    signer: TezosSigner;
+    /**
+     * Optional specific networks to register
+     * If not provided, registers wildcard support (tezos:*)
+     */
+    networks?: Network[];
+    /**
+     * Optional scheme configuration
+     */
+    schemeConfig?: ExactDirectTezosClientConfig;
+}
+/**
+ * Registers Tezos exact-direct payment scheme to a t402Client instance.
+ *
+ * @param client - The t402Client instance to register schemes to
+ * @param config - Configuration for Tezos client registration
+ * @returns The client instance for chaining
+ *
+ * @example
+ * ```typescript
+ * import { registerExactDirectTezosClient } from "@t402/tezos/exact-direct/client";
+ * import { t402Client } from "@t402/core/client";
+ *
+ * const client = new t402Client();
+ * registerExactDirectTezosClient(client, {
+ *   signer: myTezosSigner,
+ *   networks: ["tezos:NetXdQprcVkpaWU"]
+ * });
+ * ```
+ */
+declare function registerExactDirectTezosClient(client: t402Client, config: TezosClientConfig): t402Client;
+
+export { ExactDirectTezosClient, type ExactDirectTezosClientConfig, type TezosClientConfig, registerExactDirectTezosClient };

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

@@ -0,0 +1,204 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/exact-direct/client/index.ts
+var client_exports = {};
+__export(client_exports, {
+  ExactDirectTezosClient: () => ExactDirectTezosClient,
+  registerExactDirectTezosClient: () => registerExactDirectTezosClient
+});
+module.exports = __toCommonJS(client_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 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;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ExactDirectTezosClient,
+  registerExactDirectTezosClient
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/exact-direct/client/index.ts","../../../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 Exact-Direct Client\n */\n\nexport {\n  ExactDirectTezosClient,\n  type ExactDirectTezosClientConfig,\n} from \"./scheme.js\";\n\nexport {\n  registerExactDirectTezosClient,\n  type TezosClientConfig,\n} from \"./register.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","/**\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":[]}