@t402/ton 2.0.0

package/dist/esm/chunk-ZCMWKFVA.mjs

@@ -0,0 +1,101 @@
+import {
+  DEFAULT_FORWARD_TON,
+  DEFAULT_JETTON_TRANSFER_TON,
+  SCHEME_EXACT,
+  buildJettonTransferBody,
+  generateQueryId,
+  normalizeNetwork,
+  parseTonAddress
+} from "./chunk-6LOUEHJT.mjs";
+
+// src/exact/client/scheme.ts
+import { Address, SendMode } from "@ton/core";
+var ExactTonScheme = class {
+  /**
+   * Creates a new ExactTonScheme instance.
+   *
+   * @param signer - The TON signer for client operations
+   * @param getJettonWalletAddress - Function to derive Jetton wallet address
+   * @param config - Optional configuration overrides
+   */
+  constructor(signer, getJettonWalletAddress, config = {}) {
+    this.signer = signer;
+    this.getJettonWalletAddress = getJettonWalletAddress;
+    this.config = config;
+    this.scheme = SCHEME_EXACT;
+  }
+  /**
+   * Creates a payment payload for the Exact scheme.
+   *
+   * The payload contains a pre-signed external message that performs
+   * a Jetton transfer from the client to the recipient.
+   *
+   * @param t402Version - The t402 protocol version
+   * @param paymentRequirements - The payment requirements
+   * @returns Promise resolving to a payment payload
+   */
+  async createPaymentPayload(t402Version, paymentRequirements) {
+    const network = normalizeNetwork(paymentRequirements.network);
+    if (!paymentRequirements.asset) {
+      throw new Error("Asset (Jetton master address) is required");
+    }
+    if (!paymentRequirements.payTo) {
+      throw new Error("PayTo address is required");
+    }
+    if (!paymentRequirements.amount) {
+      throw new Error("Amount is required");
+    }
+    const jettonMasterAddress = paymentRequirements.asset;
+    const destinationAddress = parseTonAddress(paymentRequirements.payTo);
+    const senderJettonWalletAddress = await this.getJettonWalletAddress(
+      this.signer.address.toString(),
+      jettonMasterAddress
+    );
+    const senderJettonWallet = Address.parse(senderJettonWalletAddress);
+    const seqno = await this.signer.getSeqno();
+    const now = Math.floor(Date.now() / 1e3);
+    const validUntil = now + paymentRequirements.maxTimeoutSeconds;
+    const queryId = generateQueryId();
+    const jettonAmount = BigInt(paymentRequirements.amount);
+    const jettonTransferBody = buildJettonTransferBody({
+      queryId,
+      amount: jettonAmount,
+      destination: destinationAddress,
+      responseDestination: this.signer.address,
+      forwardAmount: this.config.forwardAmount ?? DEFAULT_FORWARD_TON
+    });
+    const tonAmount = this.config.gasAmount ?? DEFAULT_JETTON_TRANSFER_TON;
+    const signedMessage = await this.signer.signMessage({
+      to: senderJettonWallet,
+      value: tonAmount,
+      body: jettonTransferBody,
+      sendMode: SendMode.PAY_GAS_SEPARATELY,
+      timeout: paymentRequirements.maxTimeoutSeconds
+    });
+    const signedBoc = signedMessage.toBoc().toString("base64");
+    const authorization = {
+      from: this.signer.address.toString({ bounceable: true }),
+      to: paymentRequirements.payTo,
+      jettonMaster: jettonMasterAddress,
+      jettonAmount: jettonAmount.toString(),
+      tonAmount: tonAmount.toString(),
+      validUntil,
+      seqno,
+      queryId: queryId.toString()
+    };
+    const payload = {
+      signedBoc,
+      authorization
+    };
+    void network;
+    return {
+      t402Version,
+      payload
+    };
+  }
+};
+
+export {
+  ExactTonScheme
+};
+//# sourceMappingURL=chunk-ZCMWKFVA.mjs.map

package/dist/esm/chunk-ZCMWKFVA.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/exact/client/scheme.ts"],"sourcesContent":["/**\n * TON Client Scheme Implementation\n *\n * Creates payment payloads for TON Jetton transfers using the exact scheme.\n * Builds and signs external messages for Jetton wallet interactions.\n */\n\nimport { Address, SendMode } from \"@ton/core\";\nimport type { PaymentPayload, PaymentRequirements, SchemeNetworkClient } from \"@t402/core/types\";\nimport type { ClientTonSigner } from \"../../signer.js\";\nimport type { ExactTonPayloadV2 } from \"../../types.js\";\nimport { SCHEME_EXACT, DEFAULT_JETTON_TRANSFER_TON, DEFAULT_FORWARD_TON } from \"../../constants.js\";\nimport {\n  generateQueryId,\n  buildJettonTransferBody,\n  normalizeNetwork,\n  parseTonAddress,\n} from \"../../utils.js\";\n\n/**\n * Configuration for ExactTonScheme client\n */\nexport interface ExactTonSchemeConfig {\n  /** Override the TON amount attached for gas (in nanoTON) */\n  gasAmount?: bigint;\n  /** Override the forward TON amount (in nanoTON) */\n  forwardAmount?: bigint;\n}\n\n/**\n * TON client implementation for the Exact payment scheme.\n *\n * Creates signed Jetton transfer messages that can be broadcast\n * by a facilitator to complete the payment.\n */\nexport class ExactTonScheme implements SchemeNetworkClient {\n  readonly scheme = SCHEME_EXACT;\n\n  /**\n   * Creates a new ExactTonScheme instance.\n   *\n   * @param signer - The TON signer for client operations\n   * @param getJettonWalletAddress - Function to derive Jetton wallet address\n   * @param config - Optional configuration overrides\n   */\n  constructor(\n    private readonly signer: ClientTonSigner,\n    private readonly getJettonWalletAddress: (\n      ownerAddress: string,\n      jettonMasterAddress: string,\n    ) => Promise<string>,\n    private readonly config: ExactTonSchemeConfig = {},\n  ) {}\n\n  /**\n   * Creates a payment payload for the Exact scheme.\n   *\n   * The payload contains a pre-signed external message that performs\n   * a Jetton transfer from the client to the recipient.\n   *\n   * @param t402Version - The t402 protocol version\n   * @param paymentRequirements - The payment requirements\n   * @returns Promise resolving to a payment payload\n   */\n  async createPaymentPayload(\n    t402Version: number,\n    paymentRequirements: PaymentRequirements,\n  ): Promise<Pick<PaymentPayload, \"t402Version\" | \"payload\">> {\n    // Normalize and validate network\n    const network = normalizeNetwork(paymentRequirements.network);\n\n    // Validate required fields\n    if (!paymentRequirements.asset) {\n      throw new Error(\"Asset (Jetton master address) is required\");\n    }\n    if (!paymentRequirements.payTo) {\n      throw new Error(\"PayTo address is required\");\n    }\n    if (!paymentRequirements.amount) {\n      throw new Error(\"Amount is required\");\n    }\n\n    // Parse addresses\n    const jettonMasterAddress = paymentRequirements.asset;\n    const destinationAddress = parseTonAddress(paymentRequirements.payTo);\n\n    // Get client's Jetton wallet address\n    const senderJettonWalletAddress = await this.getJettonWalletAddress(\n      this.signer.address.toString(),\n      jettonMasterAddress,\n    );\n    const senderJettonWallet = Address.parse(senderJettonWalletAddress);\n\n    // Get current seqno for replay protection\n    const seqno = await this.signer.getSeqno();\n\n    // Calculate validity period\n    const now = Math.floor(Date.now() / 1000);\n    const validUntil = now + paymentRequirements.maxTimeoutSeconds;\n\n    // Generate unique query ID\n    const queryId = generateQueryId();\n\n    // Parse amount\n    const jettonAmount = BigInt(paymentRequirements.amount);\n\n    // Build Jetton transfer body\n    const jettonTransferBody = buildJettonTransferBody({\n      queryId,\n      amount: jettonAmount,\n      destination: destinationAddress,\n      responseDestination: this.signer.address,\n      forwardAmount: this.config.forwardAmount ?? DEFAULT_FORWARD_TON,\n    });\n\n    // Gas amount for the transfer\n    const tonAmount = this.config.gasAmount ?? DEFAULT_JETTON_TRANSFER_TON;\n\n    // Sign the message\n    const signedMessage = await this.signer.signMessage({\n      to: senderJettonWallet,\n      value: tonAmount,\n      body: jettonTransferBody,\n      sendMode: SendMode.PAY_GAS_SEPARATELY,\n      timeout: paymentRequirements.maxTimeoutSeconds,\n    });\n\n    // Encode to base64\n    const signedBoc = signedMessage.toBoc().toString(\"base64\");\n\n    // Build authorization metadata\n    const authorization: ExactTonPayloadV2[\"authorization\"] = {\n      from: this.signer.address.toString({ bounceable: true }),\n      to: paymentRequirements.payTo,\n      jettonMaster: jettonMasterAddress,\n      jettonAmount: jettonAmount.toString(),\n      tonAmount: tonAmount.toString(),\n      validUntil,\n      seqno,\n      queryId: queryId.toString(),\n    };\n\n    // Create payload\n    const payload: ExactTonPayloadV2 = {\n      signedBoc,\n      authorization,\n    };\n\n    // Mark network as used\n    void network;\n\n    return {\n      t402Version,\n      payload,\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;AAOA,SAAS,SAAS,gBAAgB;AA4B3B,IAAM,iBAAN,MAAoD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUzD,YACmB,QACA,wBAIA,SAA+B,CAAC,GACjD;AANiB;AACA;AAIA;AAfnB,SAAS,SAAS;AAAA,EAgBf;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYH,MAAM,qBACJ,aACA,qBAC0D;AAE1D,UAAM,UAAU,iBAAiB,oBAAoB,OAAO;AAG5D,QAAI,CAAC,oBAAoB,OAAO;AAC9B,YAAM,IAAI,MAAM,2CAA2C;AAAA,IAC7D;AACA,QAAI,CAAC,oBAAoB,OAAO;AAC9B,YAAM,IAAI,MAAM,2BAA2B;AAAA,IAC7C;AACA,QAAI,CAAC,oBAAoB,QAAQ;AAC/B,YAAM,IAAI,MAAM,oBAAoB;AAAA,IACtC;AAGA,UAAM,sBAAsB,oBAAoB;AAChD,UAAM,qBAAqB,gBAAgB,oBAAoB,KAAK;AAGpE,UAAM,4BAA4B,MAAM,KAAK;AAAA,MAC3C,KAAK,OAAO,QAAQ,SAAS;AAAA,MAC7B;AAAA,IACF;AACA,UAAM,qBAAqB,QAAQ,MAAM,yBAAyB;AAGlE,UAAM,QAAQ,MAAM,KAAK,OAAO,SAAS;AAGzC,UAAM,MAAM,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI;AACxC,UAAM,aAAa,MAAM,oBAAoB;AAG7C,UAAM,UAAU,gBAAgB;AAGhC,UAAM,eAAe,OAAO,oBAAoB,MAAM;AAGtD,UAAM,qBAAqB,wBAAwB;AAAA,MACjD;AAAA,MACA,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,qBAAqB,KAAK,OAAO;AAAA,MACjC,eAAe,KAAK,OAAO,iBAAiB;AAAA,IAC9C,CAAC;AAGD,UAAM,YAAY,KAAK,OAAO,aAAa;AAG3C,UAAM,gBAAgB,MAAM,KAAK,OAAO,YAAY;AAAA,MAClD,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,MAAM;AAAA,MACN,UAAU,SAAS;AAAA,MACnB,SAAS,oBAAoB;AAAA,IAC/B,CAAC;AAGD,UAAM,YAAY,cAAc,MAAM,EAAE,SAAS,QAAQ;AAGzD,UAAM,gBAAoD;AAAA,MACxD,MAAM,KAAK,OAAO,QAAQ,SAAS,EAAE,YAAY,KAAK,CAAC;AAAA,MACvD,IAAI,oBAAoB;AAAA,MACxB,cAAc;AAAA,MACd,cAAc,aAAa,SAAS;AAAA,MACpC,WAAW,UAAU,SAAS;AAAA,MAC9B;AAAA,MACA;AAAA,MACA,SAAS,QAAQ,SAAS;AAAA,IAC5B;AAGA,UAAM,UAA6B;AAAA,MACjC;AAAA,MACA;AAAA,IACF;AAGA,SAAK;AAEL,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/esm/exact/client/index.d.mts

@@ -0,0 +1,53 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayload } from '@t402/core/types';
+import { C as ClientTonSigner } from '../../signer-CFiw2DST.mjs';
+import '@ton/core';
+
+/**
+ * TON Client Scheme Implementation
+ *
+ * Creates payment payloads for TON Jetton transfers using the exact scheme.
+ * Builds and signs external messages for Jetton wallet interactions.
+ */
+
+/**
+ * Configuration for ExactTonScheme client
+ */
+interface ExactTonSchemeConfig {
+    /** Override the TON amount attached for gas (in nanoTON) */
+    gasAmount?: bigint;
+    /** Override the forward TON amount (in nanoTON) */
+    forwardAmount?: bigint;
+}
+/**
+ * TON client implementation for the Exact payment scheme.
+ *
+ * Creates signed Jetton transfer messages that can be broadcast
+ * by a facilitator to complete the payment.
+ */
+declare class ExactTonScheme implements SchemeNetworkClient {
+    private readonly signer;
+    private readonly getJettonWalletAddress;
+    private readonly config;
+    readonly scheme = "exact";
+    /**
+     * Creates a new ExactTonScheme instance.
+     *
+     * @param signer - The TON signer for client operations
+     * @param getJettonWalletAddress - Function to derive Jetton wallet address
+     * @param config - Optional configuration overrides
+     */
+    constructor(signer: ClientTonSigner, getJettonWalletAddress: (ownerAddress: string, jettonMasterAddress: string) => Promise<string>, config?: ExactTonSchemeConfig);
+    /**
+     * Creates a payment payload for the Exact scheme.
+     *
+     * The payload contains a pre-signed external message that performs
+     * a Jetton transfer from the client to the recipient.
+     *
+     * @param t402Version - The t402 protocol version
+     * @param paymentRequirements - The payment requirements
+     * @returns Promise resolving to a payment payload
+     */
+    createPaymentPayload(t402Version: number, paymentRequirements: PaymentRequirements): Promise<Pick<PaymentPayload, "t402Version" | "payload">>;
+}
+
+export { ExactTonScheme, type ExactTonSchemeConfig };

package/dist/esm/exact/client/index.mjs

@@ -0,0 +1,8 @@
+import {
+  ExactTonScheme
+} from "../../chunk-ZCMWKFVA.mjs";
+import "../../chunk-6LOUEHJT.mjs";
+export {
+  ExactTonScheme
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/exact/client/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/exact/facilitator/index.d.mts

@@ -0,0 +1,79 @@
+import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse } from '@t402/core/types';
+import { F as FacilitatorTonSigner } from '../../signer-CFiw2DST.mjs';
+import '@ton/core';
+
+/**
+ * TON Facilitator Scheme Implementation
+ *
+ * Verifies and settles TON Jetton payments using the exact scheme.
+ * Validates signed messages and broadcasts transactions to the network.
+ */
+
+/**
+ * Configuration options for ExactTonScheme facilitator
+ */
+interface ExactTonSchemeConfig {
+    /** Whether this facilitator can sponsor gas for transactions */
+    canSponsorGas?: boolean;
+}
+/**
+ * TON facilitator implementation for the Exact payment scheme.
+ *
+ * Verifies signed Jetton transfer messages and broadcasts them
+ * to the TON network to complete payments.
+ */
+declare class ExactTonScheme implements SchemeNetworkFacilitator {
+    private readonly signer;
+    readonly scheme = "exact";
+    readonly caipFamily = "ton:*";
+    private config;
+    /**
+     * Creates a new ExactTonScheme facilitator instance.
+     *
+     * @param signer - The TON signer for facilitator operations
+     * @param config - Optional configuration
+     */
+    constructor(signer: FacilitatorTonSigner, config?: ExactTonSchemeConfig);
+    /**
+     * Get mechanism-specific extra data for the supported kinds endpoint.
+     * For TON, optionally returns gas sponsor address if configured.
+     *
+     * @param network - The network identifier
+     * @returns Extra data object or undefined
+     */
+    getExtra(network: string): Record<string, unknown> | undefined;
+    /**
+     * Get signer addresses used by this facilitator.
+     * Returns all addresses this facilitator can use for operations.
+     *
+     * @param network - The network identifier
+     * @returns Array of facilitator addresses
+     */
+    getSigners(network: string): string[];
+    /**
+     * Verifies a payment payload.
+     *
+     * Performs comprehensive validation:
+     * 1. Scheme and network matching
+     * 2. BOC format validation
+     * 3. Message structure verification
+     * 4. Authorization expiry check
+     * 5. Balance verification
+     * 6. Amount and recipient validation
+     *
+     * @param payload - The payment payload to verify
+     * @param requirements - The payment requirements
+     * @returns Promise resolving to verification response
+     */
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    /**
+     * Settles a payment by broadcasting the signed message.
+     *
+     * @param payload - The payment payload to settle
+     * @param requirements - The payment requirements
+     * @returns Promise resolving to settlement response
+     */
+    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+}
+
+export { ExactTonScheme, type ExactTonSchemeConfig };

package/dist/esm/exact/facilitator/index.mjs

@@ -0,0 +1,258 @@
+import {
+  SCHEME_EXACT,
+  addressesEqual,
+  normalizeNetwork
+} from "../../chunk-6LOUEHJT.mjs";
+
+// src/exact/facilitator/scheme.ts
+import { Cell } from "@ton/core";
+var ExactTonScheme = class {
+  /**
+   * Creates a new ExactTonScheme facilitator instance.
+   *
+   * @param signer - The TON signer for facilitator operations
+   * @param config - Optional configuration
+   */
+  constructor(signer, config = {}) {
+    this.signer = signer;
+    this.scheme = SCHEME_EXACT;
+    this.caipFamily = "ton:*";
+    this.config = config;
+  }
+  /**
+   * Get mechanism-specific extra data for the supported kinds endpoint.
+   * For TON, optionally returns gas sponsor address if configured.
+   *
+   * @param network - The network identifier
+   * @returns Extra data object or undefined
+   */
+  getExtra(network) {
+    void network;
+    if (this.config.canSponsorGas) {
+      const addresses = this.signer.getAddresses();
+      if (addresses.length > 0) {
+        return {
+          gasSponsor: addresses[0]
+        };
+      }
+    }
+    return void 0;
+  }
+  /**
+   * Get signer addresses used by this facilitator.
+   * Returns all addresses this facilitator can use for operations.
+   *
+   * @param network - The network identifier
+   * @returns Array of facilitator addresses
+   */
+  getSigners(network) {
+    void network;
+    return [...this.signer.getAddresses()];
+  }
+  /**
+   * Verifies a payment payload.
+   *
+   * Performs comprehensive validation:
+   * 1. Scheme and network matching
+   * 2. BOC format validation
+   * 3. Message structure verification
+   * 4. Authorization expiry check
+   * 5. Balance verification
+   * 6. Amount and recipient validation
+   *
+   * @param payload - The payment payload to verify
+   * @param requirements - The payment requirements
+   * @returns Promise resolving to verification response
+   */
+  async verify(payload, requirements) {
+    const tonPayload = payload.payload;
+    const authorization = tonPayload.authorization;
+    if (payload.accepted.scheme !== SCHEME_EXACT || requirements.scheme !== SCHEME_EXACT) {
+      return {
+        isValid: false,
+        invalidReason: "unsupported_scheme",
+        payer: authorization.from
+      };
+    }
+    try {
+      const payloadNetwork = normalizeNetwork(payload.accepted.network);
+      const requirementsNetwork = normalizeNetwork(requirements.network);
+      if (payloadNetwork !== requirementsNetwork) {
+        return {
+          isValid: false,
+          invalidReason: "network_mismatch",
+          payer: authorization.from
+        };
+      }
+    } catch {
+      return {
+        isValid: false,
+        invalidReason: "invalid_network",
+        payer: authorization.from
+      };
+    }
+    try {
+      Cell.fromBase64(tonPayload.signedBoc);
+    } catch {
+      return {
+        isValid: false,
+        invalidReason: "invalid_boc_format",
+        payer: authorization.from
+      };
+    }
+    const verifyResult = await this.signer.verifyMessage({
+      signedBoc: tonPayload.signedBoc,
+      expectedFrom: authorization.from,
+      expectedTransfer: {
+        jettonAmount: BigInt(authorization.jettonAmount),
+        destination: requirements.payTo,
+        jettonMaster: requirements.asset
+      }
+    });
+    if (!verifyResult.valid) {
+      return {
+        isValid: false,
+        invalidReason: verifyResult.reason || "message_verification_failed",
+        payer: authorization.from
+      };
+    }
+    const now = Math.floor(Date.now() / 1e3);
+    if (authorization.validUntil < now + 30) {
+      return {
+        isValid: false,
+        invalidReason: "authorization_expired",
+        payer: authorization.from
+      };
+    }
+    try {
+      const balance = await this.signer.getJettonBalance({
+        ownerAddress: authorization.from,
+        jettonMasterAddress: requirements.asset
+      });
+      if (balance < BigInt(requirements.amount)) {
+        return {
+          isValid: false,
+          invalidReason: "insufficient_jetton_balance",
+          payer: authorization.from
+        };
+      }
+    } catch (error) {
+      console.warn("Could not verify Jetton balance:", error);
+    }
+    if (BigInt(authorization.jettonAmount) < BigInt(requirements.amount)) {
+      return {
+        isValid: false,
+        invalidReason: "insufficient_amount",
+        payer: authorization.from
+      };
+    }
+    if (!addressesEqual(authorization.to, requirements.payTo)) {
+      return {
+        isValid: false,
+        invalidReason: "recipient_mismatch",
+        payer: authorization.from
+      };
+    }
+    if (!addressesEqual(authorization.jettonMaster, requirements.asset)) {
+      return {
+        isValid: false,
+        invalidReason: "asset_mismatch",
+        payer: authorization.from
+      };
+    }
+    try {
+      const currentSeqno = await this.signer.getSeqno(authorization.from);
+      if (authorization.seqno < currentSeqno) {
+        return {
+          isValid: false,
+          invalidReason: "seqno_already_used",
+          payer: authorization.from
+        };
+      }
+      if (authorization.seqno > currentSeqno) {
+        return {
+          isValid: false,
+          invalidReason: "seqno_too_high",
+          payer: authorization.from
+        };
+      }
+    } catch (error) {
+      console.warn("Could not verify seqno:", error);
+    }
+    try {
+      const isDeployed = await this.signer.isDeployed(authorization.from);
+      if (!isDeployed) {
+        return {
+          isValid: false,
+          invalidReason: "wallet_not_deployed",
+          payer: authorization.from
+        };
+      }
+    } catch (error) {
+      console.warn("Could not verify wallet deployment:", error);
+    }
+    return {
+      isValid: true,
+      invalidReason: void 0,
+      payer: authorization.from
+    };
+  }
+  /**
+   * Settles a payment by broadcasting the signed message.
+   *
+   * @param payload - The payment payload to settle
+   * @param requirements - The payment requirements
+   * @returns Promise resolving to settlement response
+   */
+  async settle(payload, requirements) {
+    const tonPayload = payload.payload;
+    const verifyResult = await this.verify(payload, requirements);
+    if (!verifyResult.isValid) {
+      return {
+        success: false,
+        network: payload.accepted.network,
+        transaction: "",
+        errorReason: verifyResult.invalidReason ?? "verification_failed",
+        payer: tonPayload.authorization.from
+      };
+    }
+    try {
+      const txHash = await this.signer.sendExternalMessage(tonPayload.signedBoc);
+      const confirmation = await this.signer.waitForTransaction({
+        address: tonPayload.authorization.from,
+        seqno: tonPayload.authorization.seqno + 1,
+        // Wait for next seqno
+        timeout: 6e4
+        // 60 second timeout
+      });
+      if (!confirmation.success) {
+        return {
+          success: false,
+          errorReason: confirmation.error || "transaction_not_confirmed",
+          transaction: txHash,
+          network: payload.accepted.network,
+          payer: tonPayload.authorization.from
+        };
+      }
+      return {
+        success: true,
+        transaction: confirmation.hash || txHash,
+        network: payload.accepted.network,
+        payer: tonPayload.authorization.from
+      };
+    } catch (error) {
+      console.error("Failed to settle TON transaction:", error);
+      return {
+        success: false,
+        errorReason: "transaction_failed",
+        transaction: "",
+        network: payload.accepted.network,
+        payer: tonPayload.authorization.from
+      };
+    }
+  }
+};
+export {
+  ExactTonScheme
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/exact/facilitator/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/exact/facilitator/scheme.ts"],"sourcesContent":["/**\n * TON Facilitator Scheme Implementation\n *\n * Verifies and settles TON Jetton payments using the exact scheme.\n * Validates signed messages and broadcasts transactions to the network.\n */\n\nimport { Cell } from \"@ton/core\";\nimport type {\n  PaymentPayload,\n  PaymentRequirements,\n  SchemeNetworkFacilitator,\n  SettleResponse,\n  VerifyResponse,\n} from \"@t402/core/types\";\nimport type { FacilitatorTonSigner } from \"../../signer.js\";\nimport type { ExactTonPayloadV2 } from \"../../types.js\";\nimport { SCHEME_EXACT } from \"../../constants.js\";\nimport { addressesEqual, normalizeNetwork } from \"../../utils.js\";\n\n/**\n * Configuration options for ExactTonScheme facilitator\n */\nexport interface ExactTonSchemeConfig {\n  /** Whether this facilitator can sponsor gas for transactions */\n  canSponsorGas?: boolean;\n}\n\n/**\n * TON facilitator implementation for the Exact payment scheme.\n *\n * Verifies signed Jetton transfer messages and broadcasts them\n * to the TON network to complete payments.\n */\nexport class ExactTonScheme implements SchemeNetworkFacilitator {\n  readonly scheme = SCHEME_EXACT;\n  readonly caipFamily = \"ton:*\";\n  private config: ExactTonSchemeConfig;\n\n  /**\n   * Creates a new ExactTonScheme facilitator instance.\n   *\n   * @param signer - The TON signer for facilitator operations\n   * @param config - Optional configuration\n   */\n  constructor(\n    private readonly signer: FacilitatorTonSigner,\n    config: ExactTonSchemeConfig = {},\n  ) {\n    this.config = config;\n  }\n\n  /**\n   * Get mechanism-specific extra data for the supported kinds endpoint.\n   * For TON, optionally returns gas sponsor address if configured.\n   *\n   * @param network - The network identifier\n   * @returns Extra data object or undefined\n   */\n  getExtra(network: string): Record<string, unknown> | undefined {\n    void network;\n\n    if (this.config.canSponsorGas) {\n      const addresses = this.signer.getAddresses();\n      if (addresses.length > 0) {\n        return {\n          gasSponsor: addresses[0],\n        };\n      }\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Get signer addresses used by this facilitator.\n   * Returns all addresses this facilitator can use for operations.\n   *\n   * @param network - The network identifier\n   * @returns Array of facilitator addresses\n   */\n  getSigners(network: string): string[] {\n    void network;\n    return [...this.signer.getAddresses()];\n  }\n\n  /**\n   * Verifies a payment payload.\n   *\n   * Performs comprehensive validation:\n   * 1. Scheme and network matching\n   * 2. BOC format validation\n   * 3. Message structure verification\n   * 4. Authorization expiry check\n   * 5. Balance verification\n   * 6. Amount and recipient validation\n   *\n   * @param payload - The payment payload to verify\n   * @param requirements - The payment requirements\n   * @returns Promise resolving to verification response\n   */\n  async verify(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n  ): Promise<VerifyResponse> {\n    const tonPayload = payload.payload as ExactTonPayloadV2;\n    const authorization = tonPayload.authorization;\n\n    // Step 1: Verify scheme matches\n    if (payload.accepted.scheme !== SCHEME_EXACT || requirements.scheme !== SCHEME_EXACT) {\n      return {\n        isValid: false,\n        invalidReason: \"unsupported_scheme\",\n        payer: authorization.from,\n      };\n    }\n\n    // Step 2: Verify network matches\n    try {\n      const payloadNetwork = normalizeNetwork(payload.accepted.network);\n      const requirementsNetwork = normalizeNetwork(requirements.network);\n\n      if (payloadNetwork !== requirementsNetwork) {\n        return {\n          isValid: false,\n          invalidReason: \"network_mismatch\",\n          payer: authorization.from,\n        };\n      }\n    } catch {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_network\",\n        payer: authorization.from,\n      };\n    }\n\n    // Step 3: Parse and validate the signed BOC\n    try {\n      Cell.fromBase64(tonPayload.signedBoc);\n    } catch {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_boc_format\",\n        payer: authorization.from,\n      };\n    }\n\n    // Step 4: Verify the message structure and parameters\n    const verifyResult = await this.signer.verifyMessage({\n      signedBoc: tonPayload.signedBoc,\n      expectedFrom: authorization.from,\n      expectedTransfer: {\n        jettonAmount: BigInt(authorization.jettonAmount),\n        destination: requirements.payTo,\n        jettonMaster: requirements.asset,\n      },\n    });\n\n    if (!verifyResult.valid) {\n      return {\n        isValid: false,\n        invalidReason: verifyResult.reason || \"message_verification_failed\",\n        payer: authorization.from,\n      };\n    }\n\n    // Step 5: Check validUntil is in the future (with 30 second buffer)\n    const now = Math.floor(Date.now() / 1000);\n    if (authorization.validUntil < now + 30) {\n      return {\n        isValid: false,\n        invalidReason: \"authorization_expired\",\n        payer: authorization.from,\n      };\n    }\n\n    // Step 6: Verify Jetton balance\n    try {\n      const balance = await this.signer.getJettonBalance({\n        ownerAddress: authorization.from,\n        jettonMasterAddress: requirements.asset,\n      });\n\n      if (balance < BigInt(requirements.amount)) {\n        return {\n          isValid: false,\n          invalidReason: \"insufficient_jetton_balance\",\n          payer: authorization.from,\n        };\n      }\n    } catch (error) {\n      // If we can't check balance, log warning but continue\n      console.warn(\"Could not verify Jetton balance:\", error);\n    }\n\n    // Step 7: Verify amount is sufficient\n    if (BigInt(authorization.jettonAmount) < BigInt(requirements.amount)) {\n      return {\n        isValid: false,\n        invalidReason: \"insufficient_amount\",\n        payer: authorization.from,\n      };\n    }\n\n    // Step 8: Verify recipient matches\n    if (!addressesEqual(authorization.to, requirements.payTo)) {\n      return {\n        isValid: false,\n        invalidReason: \"recipient_mismatch\",\n        payer: authorization.from,\n      };\n    }\n\n    // Step 9: Verify Jetton master matches\n    if (!addressesEqual(authorization.jettonMaster, requirements.asset)) {\n      return {\n        isValid: false,\n        invalidReason: \"asset_mismatch\",\n        payer: authorization.from,\n      };\n    }\n\n    // Step 10: Check seqno hasn't been used (replay protection)\n    try {\n      const currentSeqno = await this.signer.getSeqno(authorization.from);\n      if (authorization.seqno < currentSeqno) {\n        return {\n          isValid: false,\n          invalidReason: \"seqno_already_used\",\n          payer: authorization.from,\n        };\n      }\n      if (authorization.seqno > currentSeqno) {\n        return {\n          isValid: false,\n          invalidReason: \"seqno_too_high\",\n          payer: authorization.from,\n        };\n      }\n    } catch (error) {\n      console.warn(\"Could not verify seqno:\", error);\n    }\n\n    // Step 11: Verify wallet is deployed\n    try {\n      const isDeployed = await this.signer.isDeployed(authorization.from);\n      if (!isDeployed) {\n        return {\n          isValid: false,\n          invalidReason: \"wallet_not_deployed\",\n          payer: authorization.from,\n        };\n      }\n    } catch (error) {\n      console.warn(\"Could not verify wallet deployment:\", error);\n    }\n\n    return {\n      isValid: true,\n      invalidReason: undefined,\n      payer: authorization.from,\n    };\n  }\n\n  /**\n   * Settles a payment by broadcasting the signed message.\n   *\n   * @param payload - The payment payload to settle\n   * @param requirements - The payment requirements\n   * @returns Promise resolving to settlement response\n   */\n  async settle(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n  ): Promise<SettleResponse> {\n    const tonPayload = payload.payload as ExactTonPayloadV2;\n\n    // Re-verify before settling\n    const verifyResult = await this.verify(payload, requirements);\n    if (!verifyResult.isValid) {\n      return {\n        success: false,\n        network: payload.accepted.network,\n        transaction: \"\",\n        errorReason: verifyResult.invalidReason ?? \"verification_failed\",\n        payer: tonPayload.authorization.from,\n      };\n    }\n\n    try {\n      // Send the pre-signed external message\n      const txHash = await this.signer.sendExternalMessage(tonPayload.signedBoc);\n\n      // Wait for confirmation\n      const confirmation = await this.signer.waitForTransaction({\n        address: tonPayload.authorization.from,\n        seqno: tonPayload.authorization.seqno + 1, // Wait for next seqno\n        timeout: 60000, // 60 second timeout\n      });\n\n      if (!confirmation.success) {\n        return {\n          success: false,\n          errorReason: confirmation.error || \"transaction_not_confirmed\",\n          transaction: txHash,\n          network: payload.accepted.network,\n          payer: tonPayload.authorization.from,\n        };\n      }\n\n      return {\n        success: true,\n        transaction: confirmation.hash || txHash,\n        network: payload.accepted.network,\n        payer: tonPayload.authorization.from,\n      };\n    } catch (error) {\n      console.error(\"Failed to settle TON transaction:\", error);\n      return {\n        success: false,\n        errorReason: \"transaction_failed\",\n        transaction: \"\",\n        network: payload.accepted.network,\n        payer: tonPayload.authorization.from,\n      };\n    }\n  }\n}\n"],"mappings":"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","names":[]}