@t402/cosmos 2.4.0

package/dist/esm/chunk-QP5VO3IO.mjs

@@ -0,0 +1,68 @@
+import {
+  SCHEME_EXACT_DIRECT,
+  USDC_DENOM,
+  isValidAddress,
+  normalizeNetwork
+} from "./chunk-2UTEGIZ2.mjs";
+
+// src/exact-direct/client/scheme.ts
+var ExactDirectCosmosClient = class {
+  /**
+   * Creates a new ExactDirectCosmosClient instance.
+   *
+   * @param signer - The Cosmos signer for client operations
+   * @param config - Optional configuration overrides
+   */
+  constructor(signer, config = {}) {
+    this.signer = signer;
+    this.config = config;
+    this.scheme = SCHEME_EXACT_DIRECT;
+  }
+  /**
+   * Creates a payment payload by executing the transfer.
+   *
+   * Unlike other schemes where the client creates a signed message for
+   * the facilitator to execute, the exact-direct scheme has the client
+   * execute the transfer directly. The transaction hash is then used
+   * as proof of payment.
+   *
+   * @param t402Version - The t402 protocol version
+   * @param paymentRequirements - The payment requirements
+   * @returns Promise resolving to a payment payload with transaction hash
+   */
+  async createPaymentPayload(t402Version, paymentRequirements) {
+    const network = normalizeNetwork(paymentRequirements.network);
+    if (!paymentRequirements.payTo) {
+      throw new Error("PayTo address is required");
+    }
+    if (!paymentRequirements.amount) {
+      throw new Error("Amount is required");
+    }
+    if (!isValidAddress(paymentRequirements.payTo)) {
+      throw new Error(`Invalid recipient address: ${paymentRequirements.payTo}`);
+    }
+    if (!isValidAddress(this.signer.address)) {
+      throw new Error(`Invalid sender address: ${this.signer.address}`);
+    }
+    const recipient = paymentRequirements.payTo;
+    const amount = paymentRequirements.amount;
+    const denom = paymentRequirements.extra?.denom || this.config.denom || USDC_DENOM;
+    const txHash = await this.signer.sendTokens(network, recipient, amount, denom);
+    const payload = {
+      txHash,
+      from: this.signer.address,
+      to: recipient,
+      amount,
+      denom
+    };
+    return {
+      t402Version,
+      payload
+    };
+  }
+};
+
+export {
+  ExactDirectCosmosClient
+};
+//# sourceMappingURL=chunk-QP5VO3IO.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/exact-direct/client/scheme.ts"],"sourcesContent":["/**\n * Cosmos Client Scheme Implementation - Exact Direct\n *\n * Creates payment payloads for Cosmos MsgSend transfers using the exact-direct scheme.\n * In this scheme, the client executes the bank send directly and provides\n * the transaction hash as proof of payment.\n */\n\nimport type { PaymentPayload, PaymentRequirements, SchemeNetworkClient } from \"@t402/core/types\";\nimport type { ClientCosmosSigner, ExactDirectCosmosPayload } from \"../../types.js\";\nimport { SCHEME_EXACT_DIRECT, USDC_DENOM } from \"../../constants.js\";\nimport { normalizeNetwork, isValidAddress } from \"../../utils.js\";\n\n/**\n * Configuration for ExactDirectCosmosClient\n */\nexport interface ExactDirectCosmosClientConfig {\n  /** Override the default denomination */\n  denom?: string;\n}\n\n/**\n * Cosmos client implementation for the Exact-Direct payment scheme.\n *\n * Executes a Cosmos MsgSend and returns the transaction hash as proof.\n */\nexport class ExactDirectCosmosClient implements SchemeNetworkClient {\n  readonly scheme = SCHEME_EXACT_DIRECT;\n\n  /**\n   * Creates a new ExactDirectCosmosClient instance.\n   *\n   * @param signer - The Cosmos signer for client operations\n   * @param config - Optional configuration overrides\n   */\n  constructor(\n    private readonly signer: ClientCosmosSigner,\n    private readonly config: ExactDirectCosmosClientConfig = {},\n  ) {}\n\n  /**\n   * Creates a payment payload by executing the transfer.\n   *\n   * Unlike other schemes where the client creates a signed message for\n   * the facilitator to execute, the exact-direct scheme has the client\n   * execute the transfer directly. The transaction hash is then used\n   * as proof of payment.\n   *\n   * @param t402Version - The t402 protocol version\n   * @param paymentRequirements - The payment requirements\n   * @returns Promise resolving to a payment payload with transaction hash\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.payTo) {\n      throw new Error(\"PayTo address is required\");\n    }\n    if (!paymentRequirements.amount) {\n      throw new Error(\"Amount is required\");\n    }\n\n    // Validate addresses\n    if (!isValidAddress(paymentRequirements.payTo)) {\n      throw new Error(`Invalid recipient address: ${paymentRequirements.payTo}`);\n    }\n    if (!isValidAddress(this.signer.address)) {\n      throw new Error(`Invalid sender address: ${this.signer.address}`);\n    }\n\n    const recipient = paymentRequirements.payTo;\n    const amount = paymentRequirements.amount;\n\n    // Determine denomination from extra field, config, or default\n    const denom =\n      (paymentRequirements.extra?.denom as string) || this.config.denom || USDC_DENOM;\n\n    // Execute the transfer\n    const txHash = await this.signer.sendTokens(network, recipient, amount, denom);\n\n    // Build the payload\n    const payload: ExactDirectCosmosPayload = {\n      txHash,\n      from: this.signer.address,\n      to: recipient,\n      amount: amount,\n      denom,\n    };\n\n    return {\n      t402Version,\n      payload,\n    };\n  }\n}\n"],"mappings":";;;;;;;;AA0BO,IAAM,0BAAN,MAA6D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASlE,YACmB,QACA,SAAwC,CAAC,GAC1D;AAFiB;AACA;AAVnB,SAAS,SAAS;AAAA,EAWf;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcH,MAAM,qBACJ,aACA,qBAC0D;AAE1D,UAAM,UAAU,iBAAiB,oBAAoB,OAAO;AAG5D,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,QAAI,CAAC,eAAe,oBAAoB,KAAK,GAAG;AAC9C,YAAM,IAAI,MAAM,8BAA8B,oBAAoB,KAAK,EAAE;AAAA,IAC3E;AACA,QAAI,CAAC,eAAe,KAAK,OAAO,OAAO,GAAG;AACxC,YAAM,IAAI,MAAM,2BAA2B,KAAK,OAAO,OAAO,EAAE;AAAA,IAClE;AAEA,UAAM,YAAY,oBAAoB;AACtC,UAAM,SAAS,oBAAoB;AAGnC,UAAM,QACH,oBAAoB,OAAO,SAAoB,KAAK,OAAO,SAAS;AAGvE,UAAM,SAAS,MAAM,KAAK,OAAO,WAAW,SAAS,WAAW,QAAQ,KAAK;AAG7E,UAAM,UAAoC;AAAA,MACxC;AAAA,MACA,MAAM,KAAK,OAAO;AAAA,MAClB,IAAI;AAAA,MACJ;AAAA,MACA;AAAA,IACF;AAEA,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/esm/chunk-XUMAS5DJ.mjs

@@ -0,0 +1,223 @@
+import {
+  getDefaultToken
+} from "./chunk-57DBLYIR.mjs";
+import {
+  COSMOS_CAIP2_NAMESPACE,
+  MAX_TRANSACTION_AGE,
+  MSG_TYPE_SEND,
+  SCHEME_EXACT_DIRECT,
+  isValidAddress,
+  normalizeNetwork
+} from "./chunk-2UTEGIZ2.mjs";
+
+// src/exact-direct/facilitator/scheme.ts
+var ExactDirectCosmosFacilitator = class {
+  constructor(signer, config) {
+    this.signer = signer;
+    this.scheme = SCHEME_EXACT_DIRECT;
+    this.caipFamily = `${COSMOS_CAIP2_NAMESPACE}:*`;
+    this.usedTxs = /* @__PURE__ */ new Map();
+    this.config = {
+      maxTransactionAge: config?.maxTransactionAge ?? MAX_TRANSACTION_AGE,
+      usedTxCacheDuration: config?.usedTxCacheDuration ?? 24 * 60 * 60 * 1e3
+      // 24 hours
+    };
+    this.startCleanupInterval();
+  }
+  /**
+   * Get extra data for a supported kind
+   */
+  getExtra(network) {
+    const token = getDefaultToken(network);
+    if (!token) {
+      return void 0;
+    }
+    return {
+      assetSymbol: token.symbol,
+      assetDecimals: token.decimals,
+      assetDenom: token.denom
+    };
+  }
+  /**
+   * Get signer addresses for a network
+   */
+  getSigners(network) {
+    return this.signer.getAddresses(network);
+  }
+  /**
+   * Verify a payment payload
+   */
+  async verify(payload, requirements) {
+    const network = normalizeNetwork(requirements.network);
+    if (payload.accepted.scheme !== SCHEME_EXACT_DIRECT) {
+      return {
+        isValid: false,
+        invalidReason: "invalid_scheme"
+      };
+    }
+    if (normalizeNetwork(payload.accepted.network) !== network) {
+      return {
+        isValid: false,
+        invalidReason: "network_mismatch"
+      };
+    }
+    const cosmosPayload = payload.payload;
+    if (!cosmosPayload.txHash) {
+      return {
+        isValid: false,
+        invalidReason: "missing_tx_hash"
+      };
+    }
+    if (!cosmosPayload.from || !isValidAddress(cosmosPayload.from)) {
+      return {
+        isValid: false,
+        invalidReason: "invalid_from_address"
+      };
+    }
+    if (this.isTxUsed(cosmosPayload.txHash)) {
+      return {
+        isValid: false,
+        invalidReason: "transaction_already_used",
+        payer: cosmosPayload.from
+      };
+    }
+    try {
+      const tx = await this.signer.queryTransaction(network, cosmosPayload.txHash);
+      if (tx.code !== 0) {
+        return {
+          isValid: false,
+          invalidReason: "transaction_failed",
+          payer: cosmosPayload.from
+        };
+      }
+      const msgSend = this.findMsgSend(tx.tx.body.messages);
+      if (!msgSend) {
+        return {
+          isValid: false,
+          invalidReason: "no_msg_send_found",
+          payer: cosmosPayload.from
+        };
+      }
+      if (msgSend.toAddress !== requirements.payTo) {
+        return {
+          isValid: false,
+          invalidReason: "wrong_recipient",
+          payer: cosmosPayload.from
+        };
+      }
+      if (msgSend.fromAddress !== cosmosPayload.from) {
+        return {
+          isValid: false,
+          invalidReason: "sender_mismatch",
+          payer: cosmosPayload.from
+        };
+      }
+      const expectedDenom = requirements.extra?.denom || requirements.asset;
+      const coin = this.getAmountByDenom(msgSend, expectedDenom);
+      if (!coin) {
+        return {
+          isValid: false,
+          invalidReason: "wrong_denomination",
+          payer: cosmosPayload.from
+        };
+      }
+      const txAmount = BigInt(coin.amount);
+      const requiredAmount = BigInt(requirements.amount);
+      if (txAmount < requiredAmount) {
+        return {
+          isValid: false,
+          invalidReason: "insufficient_amount",
+          payer: cosmosPayload.from
+        };
+      }
+      this.markTxUsed(cosmosPayload.txHash);
+      return {
+        isValid: true,
+        payer: cosmosPayload.from
+      };
+    } catch {
+      return {
+        isValid: false,
+        invalidReason: "transaction_not_found",
+        payer: cosmosPayload.from
+      };
+    }
+  }
+  /**
+   * Settle a payment - for exact-direct, the transfer is already complete
+   */
+  async settle(payload, requirements) {
+    const verifyResult = await this.verify(payload, requirements);
+    if (!verifyResult.isValid) {
+      return {
+        success: false,
+        errorReason: verifyResult.invalidReason || "verification_failed",
+        payer: verifyResult.payer,
+        transaction: "",
+        network: normalizeNetwork(requirements.network)
+      };
+    }
+    const cosmosPayload = payload.payload;
+    return {
+      success: true,
+      transaction: cosmosPayload.txHash,
+      network: normalizeNetwork(requirements.network),
+      payer: cosmosPayload.from
+    };
+  }
+  /**
+   * Find a MsgSend in transaction messages
+   */
+  findMsgSend(messages) {
+    for (const msg of messages) {
+      if (msg["@type"] === MSG_TYPE_SEND || !msg["@type"] && msg.fromAddress && msg.toAddress) {
+        return msg;
+      }
+    }
+    return null;
+  }
+  /**
+   * Get a specific coin amount from a MsgSend by denomination
+   */
+  getAmountByDenom(msg, denom) {
+    for (const coin of msg.amount) {
+      if (coin.denom === denom) {
+        return coin;
+      }
+    }
+    return null;
+  }
+  /**
+   * Check if a transaction has been used
+   */
+  isTxUsed(txHash) {
+    return this.usedTxs.has(txHash);
+  }
+  /**
+   * Mark a transaction as used
+   */
+  markTxUsed(txHash) {
+    this.usedTxs.set(txHash, Date.now());
+  }
+  /**
+   * Start the cleanup interval for used transactions
+   */
+  startCleanupInterval() {
+    setInterval(
+      () => {
+        const cutoff = Date.now() - this.config.usedTxCacheDuration;
+        for (const [txHash, usedAt] of this.usedTxs.entries()) {
+          if (usedAt < cutoff) {
+            this.usedTxs.delete(txHash);
+          }
+        }
+      },
+      60 * 60 * 1e3
+    );
+  }
+};
+
+export {
+  ExactDirectCosmosFacilitator
+};
+//# sourceMappingURL=chunk-XUMAS5DJ.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/exact-direct/facilitator/scheme.ts"],"sourcesContent":["/**\n * Cosmos Facilitator Scheme Implementation - Exact Direct\n *\n * Verifies and settles Cosmos (Noble USDC) payments using the exact-direct scheme.\n * The facilitator verifies that the client's transaction was successful\n * and matches the payment requirements.\n */\n\nimport type {\n  Network,\n  PaymentPayload,\n  PaymentRequirements,\n  SchemeNetworkFacilitator,\n  SettleResponse,\n  VerifyResponse,\n} from \"@t402/core/types\";\nimport type { FacilitatorCosmosSigner, ExactDirectCosmosPayload, MsgSend } from \"../../types.js\";\nimport { SCHEME_EXACT_DIRECT, COSMOS_CAIP2_NAMESPACE, MAX_TRANSACTION_AGE, MSG_TYPE_SEND } from \"../../constants.js\";\nimport { normalizeNetwork, isValidAddress } from \"../../utils.js\";\nimport { getDefaultToken } from \"../../tokens.js\";\n\n/**\n * Configuration for ExactDirectCosmosFacilitator\n */\nexport interface ExactDirectCosmosFacilitatorConfig {\n  /** Maximum age of a transaction to accept (in milliseconds) */\n  maxTransactionAge?: number;\n  /** Duration to cache used transaction hashes (in milliseconds) */\n  usedTxCacheDuration?: number;\n}\n\n/**\n * Cosmos facilitator implementation for the Exact-Direct payment scheme.\n * Verifies transaction proofs and confirms payments.\n */\nexport class ExactDirectCosmosFacilitator implements SchemeNetworkFacilitator {\n  readonly scheme = SCHEME_EXACT_DIRECT;\n  readonly caipFamily = `${COSMOS_CAIP2_NAMESPACE}:*`;\n\n  private readonly config: Required<ExactDirectCosmosFacilitatorConfig>;\n  private usedTxs: Map<string, number> = new Map();\n\n  constructor(\n    private readonly signer: FacilitatorCosmosSigner,\n    config?: ExactDirectCosmosFacilitatorConfig,\n  ) {\n    this.config = {\n      maxTransactionAge: config?.maxTransactionAge ?? MAX_TRANSACTION_AGE,\n      usedTxCacheDuration: config?.usedTxCacheDuration ?? 24 * 60 * 60 * 1000, // 24 hours\n    };\n\n    // Start cleanup interval\n    this.startCleanupInterval();\n  }\n\n  /**\n   * Get extra data for a supported kind\n   */\n  getExtra(network: Network): Record<string, unknown> | undefined {\n    const token = getDefaultToken(network);\n    if (!token) {\n      return undefined;\n    }\n    return {\n      assetSymbol: token.symbol,\n      assetDecimals: token.decimals,\n      assetDenom: token.denom,\n    };\n  }\n\n  /**\n   * Get signer addresses for a network\n   */\n  getSigners(network: Network): string[] {\n    return this.signer.getAddresses(network);\n  }\n\n  /**\n   * Verify a payment payload\n   */\n  async verify(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n  ): Promise<VerifyResponse> {\n    const network = normalizeNetwork(requirements.network);\n\n    // Validate scheme\n    if (payload.accepted.scheme !== SCHEME_EXACT_DIRECT) {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_scheme\",\n      };\n    }\n\n    // Validate network\n    if (normalizeNetwork(payload.accepted.network) !== network) {\n      return {\n        isValid: false,\n        invalidReason: \"network_mismatch\",\n      };\n    }\n\n    // Parse payload\n    const cosmosPayload = payload.payload as ExactDirectCosmosPayload;\n    if (!cosmosPayload.txHash) {\n      return {\n        isValid: false,\n        invalidReason: \"missing_tx_hash\",\n      };\n    }\n    if (!cosmosPayload.from || !isValidAddress(cosmosPayload.from)) {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_from_address\",\n      };\n    }\n\n    // Check for replay attack\n    if (this.isTxUsed(cosmosPayload.txHash)) {\n      return {\n        isValid: false,\n        invalidReason: \"transaction_already_used\",\n        payer: cosmosPayload.from,\n      };\n    }\n\n    try {\n      // Query the transaction\n      const tx = await this.signer.queryTransaction(network, cosmosPayload.txHash);\n\n      // Check transaction succeeded (code 0 = success)\n      if (tx.code !== 0) {\n        return {\n          isValid: false,\n          invalidReason: \"transaction_failed\",\n          payer: cosmosPayload.from,\n        };\n      }\n\n      // Find the MsgSend in the transaction messages\n      const msgSend = this.findMsgSend(tx.tx.body.messages);\n      if (!msgSend) {\n        return {\n          isValid: false,\n          invalidReason: \"no_msg_send_found\",\n          payer: cosmosPayload.from,\n        };\n      }\n\n      // Verify recipient\n      if (msgSend.toAddress !== requirements.payTo) {\n        return {\n          isValid: false,\n          invalidReason: \"wrong_recipient\",\n          payer: cosmosPayload.from,\n        };\n      }\n\n      // Verify sender matches payload\n      if (msgSend.fromAddress !== cosmosPayload.from) {\n        return {\n          isValid: false,\n          invalidReason: \"sender_mismatch\",\n          payer: cosmosPayload.from,\n        };\n      }\n\n      // Determine expected denom\n      const expectedDenom = (requirements.extra?.denom as string) || requirements.asset;\n\n      // Verify amount and denomination\n      const coin = this.getAmountByDenom(msgSend, expectedDenom);\n      if (!coin) {\n        return {\n          isValid: false,\n          invalidReason: \"wrong_denomination\",\n          payer: cosmosPayload.from,\n        };\n      }\n\n      const txAmount = BigInt(coin.amount);\n      const requiredAmount = BigInt(requirements.amount);\n      if (txAmount < requiredAmount) {\n        return {\n          isValid: false,\n          invalidReason: \"insufficient_amount\",\n          payer: cosmosPayload.from,\n        };\n      }\n\n      // Mark transaction as used\n      this.markTxUsed(cosmosPayload.txHash);\n\n      return {\n        isValid: true,\n        payer: cosmosPayload.from,\n      };\n    } catch {\n      return {\n        isValid: false,\n        invalidReason: \"transaction_not_found\",\n        payer: cosmosPayload.from,\n      };\n    }\n  }\n\n  /**\n   * Settle a payment - for exact-direct, the transfer is already complete\n   */\n  async settle(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n  ): Promise<SettleResponse> {\n    // Verify first\n    const verifyResult = await this.verify(payload, requirements);\n    if (!verifyResult.isValid) {\n      return {\n        success: false,\n        errorReason: verifyResult.invalidReason || \"verification_failed\",\n        payer: verifyResult.payer,\n        transaction: \"\",\n        network: normalizeNetwork(requirements.network),\n      };\n    }\n\n    const cosmosPayload = payload.payload as ExactDirectCosmosPayload;\n\n    // For exact-direct, settlement is already complete\n    return {\n      success: true,\n      transaction: cosmosPayload.txHash,\n      network: normalizeNetwork(requirements.network),\n      payer: cosmosPayload.from,\n    };\n  }\n\n  /**\n   * Find a MsgSend in transaction messages\n   */\n  private findMsgSend(messages: MsgSend[]): MsgSend | null {\n    for (const msg of messages) {\n      if (msg[\"@type\"] === MSG_TYPE_SEND || (!msg[\"@type\"] && msg.fromAddress && msg.toAddress)) {\n        return msg;\n      }\n    }\n    return null;\n  }\n\n  /**\n   * Get a specific coin amount from a MsgSend by denomination\n   */\n  private getAmountByDenom(msg: MsgSend, denom: string): { denom: string; amount: string } | null {\n    for (const coin of msg.amount) {\n      if (coin.denom === denom) {\n        return coin;\n      }\n    }\n    return null;\n  }\n\n  /**\n   * Check if a transaction has been used\n   */\n  private isTxUsed(txHash: string): boolean {\n    return this.usedTxs.has(txHash);\n  }\n\n  /**\n   * Mark a transaction as used\n   */\n  private markTxUsed(txHash: string): void {\n    this.usedTxs.set(txHash, Date.now());\n  }\n\n  /**\n   * Start the cleanup interval for used transactions\n   */\n  private startCleanupInterval(): void {\n    setInterval(\n      () => {\n        const cutoff = Date.now() - this.config.usedTxCacheDuration;\n        for (const [txHash, usedAt] of this.usedTxs.entries()) {\n          if (usedAt < cutoff) {\n            this.usedTxs.delete(txHash);\n          }\n        }\n      },\n      60 * 60 * 1000,\n    ); // Cleanup every hour\n  }\n}\n"],"mappings":"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","names":[]}

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

@@ -0,0 +1,50 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayload } from '@t402/core/types';
+import { d as ClientCosmosSigner } from '../../types-CgseoctH.mjs';
+
+/**
+ * Cosmos Client Scheme Implementation - Exact Direct
+ *
+ * Creates payment payloads for Cosmos MsgSend transfers using the exact-direct scheme.
+ * In this scheme, the client executes the bank send directly and provides
+ * the transaction hash as proof of payment.
+ */
+
+/**
+ * Configuration for ExactDirectCosmosClient
+ */
+interface ExactDirectCosmosClientConfig {
+    /** Override the default denomination */
+    denom?: string;
+}
+/**
+ * Cosmos client implementation for the Exact-Direct payment scheme.
+ *
+ * Executes a Cosmos MsgSend and returns the transaction hash as proof.
+ */
+declare class ExactDirectCosmosClient implements SchemeNetworkClient {
+    private readonly signer;
+    private readonly config;
+    readonly scheme = "exact-direct";
+    /**
+     * Creates a new ExactDirectCosmosClient instance.
+     *
+     * @param signer - The Cosmos signer for client operations
+     * @param config - Optional configuration overrides
+     */
+    constructor(signer: ClientCosmosSigner, config?: ExactDirectCosmosClientConfig);
+    /**
+     * Creates a payment payload by executing the transfer.
+     *
+     * Unlike other schemes where the client creates a signed message for
+     * the facilitator to execute, the exact-direct scheme has the client
+     * execute the transfer directly. The transaction hash is then used
+     * as proof of payment.
+     *
+     * @param t402Version - The t402 protocol version
+     * @param paymentRequirements - The payment requirements
+     * @returns Promise resolving to a payment payload with transaction hash
+     */
+    createPaymentPayload(t402Version: number, paymentRequirements: PaymentRequirements): Promise<Pick<PaymentPayload, "t402Version" | "payload">>;
+}
+
+export { ExactDirectCosmosClient, type ExactDirectCosmosClientConfig };

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

@@ -0,0 +1,8 @@
+import {
+  ExactDirectCosmosClient
+} from "../../chunk-QP5VO3IO.mjs";
+import "../../chunk-2UTEGIZ2.mjs";
+export {
+  ExactDirectCosmosClient
+};
+//# sourceMappingURL=index.mjs.map

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

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

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

@@ -0,0 +1,70 @@
+import { SchemeNetworkFacilitator, Network, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse } from '@t402/core/types';
+import { F as FacilitatorCosmosSigner } from '../../types-CgseoctH.mjs';
+
+/**
+ * Cosmos Facilitator Scheme Implementation - Exact Direct
+ *
+ * Verifies and settles Cosmos (Noble USDC) payments using the exact-direct scheme.
+ * The facilitator verifies that the client's transaction was successful
+ * and matches the payment requirements.
+ */
+
+/**
+ * Configuration for ExactDirectCosmosFacilitator
+ */
+interface ExactDirectCosmosFacilitatorConfig {
+    /** Maximum age of a transaction to accept (in milliseconds) */
+    maxTransactionAge?: number;
+    /** Duration to cache used transaction hashes (in milliseconds) */
+    usedTxCacheDuration?: number;
+}
+/**
+ * Cosmos facilitator implementation for the Exact-Direct payment scheme.
+ * Verifies transaction proofs and confirms payments.
+ */
+declare class ExactDirectCosmosFacilitator implements SchemeNetworkFacilitator {
+    private readonly signer;
+    readonly scheme = "exact-direct";
+    readonly caipFamily = "cosmos:*";
+    private readonly config;
+    private usedTxs;
+    constructor(signer: FacilitatorCosmosSigner, config?: ExactDirectCosmosFacilitatorConfig);
+    /**
+     * Get extra data for a supported kind
+     */
+    getExtra(network: Network): Record<string, unknown> | undefined;
+    /**
+     * Get signer addresses for a network
+     */
+    getSigners(network: Network): string[];
+    /**
+     * Verify a payment payload
+     */
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    /**
+     * Settle a payment - for exact-direct, the transfer is already complete
+     */
+    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+    /**
+     * Find a MsgSend in transaction messages
+     */
+    private findMsgSend;
+    /**
+     * Get a specific coin amount from a MsgSend by denomination
+     */
+    private getAmountByDenom;
+    /**
+     * Check if a transaction has been used
+     */
+    private isTxUsed;
+    /**
+     * Mark a transaction as used
+     */
+    private markTxUsed;
+    /**
+     * Start the cleanup interval for used transactions
+     */
+    private startCleanupInterval;
+}
+
+export { ExactDirectCosmosFacilitator, type ExactDirectCosmosFacilitatorConfig };

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

@@ -0,0 +1,9 @@
+import {
+  ExactDirectCosmosFacilitator
+} from "../../chunk-XUMAS5DJ.mjs";
+import "../../chunk-57DBLYIR.mjs";
+import "../../chunk-2UTEGIZ2.mjs";
+export {
+  ExactDirectCosmosFacilitator
+};
+//# sourceMappingURL=index.mjs.map

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

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

package/dist/esm/exact-direct/server/index.d.mts

@@ -0,0 +1,87 @@
+import { SchemeNetworkServer, MoneyParser, Price, Network, AssetAmount, PaymentRequirements } from '@t402/core/types';
+
+/**
+ * Cosmos Server Scheme Implementation - Exact Direct
+ *
+ * Handles price parsing and payment requirement enhancement for
+ * Cosmos (Noble USDC) payments using the exact-direct scheme.
+ */
+
+/**
+ * Configuration options for ExactDirectCosmosServer
+ */
+interface ExactDirectCosmosServerConfig {
+    /** Preferred token symbol (e.g., "USDC"). Defaults to network's highest priority token. */
+    preferredToken?: string;
+}
+/**
+ * Cosmos server implementation for the Exact-Direct payment scheme.
+ * Handles price parsing and converts user-friendly amounts to token amounts.
+ */
+declare class ExactDirectCosmosServer implements SchemeNetworkServer {
+    readonly scheme = "exact-direct";
+    private moneyParsers;
+    private config;
+    constructor(config?: ExactDirectCosmosServerConfig);
+    /**
+     * Register a custom money parser in the parser chain.
+     * Multiple parsers can be registered - they will be tried in registration order.
+     * Each parser receives a decimal amount (e.g., 1.50 for $1.50).
+     * If a parser returns null, the next parser in the chain will be tried.
+     * The default parser is always the final fallback.
+     *
+     * @param parser - Custom function to convert amount to AssetAmount (or null to skip)
+     * @returns The server instance for chaining
+     */
+    registerMoneyParser(parser: MoneyParser): ExactDirectCosmosServer;
+    /**
+     * Parses a price into an asset amount.
+     * If price is already an AssetAmount, returns it directly.
+     * If price is Money (string | number), parses to decimal and tries custom parsers.
+     * Falls back to default conversion if all custom parsers return null.
+     *
+     * @param price - The price to parse
+     * @param network - The network to use
+     * @returns Promise that resolves to the parsed asset amount
+     */
+    parsePrice(price: Price, network: Network): Promise<AssetAmount>;
+    /**
+     * Build payment requirements for this scheme/network combination.
+     *
+     * @param paymentRequirements - Base payment requirements with amount/asset already set
+     * @param supportedKind - The supported kind from facilitator's /supported endpoint
+     * @param extensionKeys - Extensions supported by the facilitator
+     * @returns Enhanced payment requirements ready to be sent to clients
+     */
+    enhancePaymentRequirements(paymentRequirements: PaymentRequirements, supportedKind: {
+        t402Version: number;
+        scheme: string;
+        network: Network;
+        extra?: Record<string, unknown>;
+    }, extensionKeys: string[]): Promise<PaymentRequirements>;
+    /**
+     * Parse Money (string | number) to a decimal number.
+     * Handles formats like "$1.50", "1.50", 1.50, etc.
+     */
+    private parseMoneyToDecimal;
+    /**
+     * Default money conversion implementation.
+     * Converts decimal amount to the preferred token on the specified network.
+     */
+    private defaultMoneyConversion;
+    /**
+     * Get the default asset info for a network.
+     * Priority: configured preferredToken > network default
+     */
+    private getDefaultAsset;
+    /**
+     * Get all supported networks
+     */
+    static getSupportedNetworks(): string[];
+    /**
+     * Check if a network is supported
+     */
+    static isNetworkSupported(network: string): boolean;
+}
+
+export { ExactDirectCosmosServer, type ExactDirectCosmosServerConfig };

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

@@ -0,0 +1,9 @@
+import {
+  ExactDirectCosmosServer
+} from "../../chunk-JV6LXL2U.mjs";
+import "../../chunk-57DBLYIR.mjs";
+import "../../chunk-2UTEGIZ2.mjs";
+export {
+  ExactDirectCosmosServer
+};
+//# sourceMappingURL=index.mjs.map

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

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