@t402/cosmos 2.4.0

package/README.md

@@ -0,0 +1,175 @@
+# @t402/cosmos
+
+Cosmos (Noble) implementation of the t402 payment protocol using the **exact-direct** payment scheme with native USDC via `MsgSend`.
+
+## Installation
+
+```bash
+npm install @t402/cosmos
+# or
+pnpm add @t402/cosmos
+```
+
+## Overview
+
+This package provides support for USDC payments on Cosmos SDK chains (currently Noble) using the exact-direct scheme. The client executes a `MsgSend` transaction directly on-chain, then provides the transaction hash as proof of payment.
+
+Three main components:
+
+- **Client** - For applications that make payments (have Cosmos wallets)
+- **Facilitator** - For payment processors that verify transactions via REST API
+- **Server** - For resource servers that accept payments and build payment requirements
+
+## Supported Networks
+
+| Network        | CAIP-2 Identifier  | USDC Denomination | Bech32 Prefix | Status     |
+| -------------- | ------------------ | ----------------- | ------------- | ---------- |
+| Noble Mainnet  | `cosmos:noble-1`   | `uusdc`           | `noble`       | Production |
+| Noble Testnet  | `cosmos:grand-1`   | `uusdc`           | `noble`       | Testnet    |
+
+## Package Exports
+
+### Main Package (`@t402/cosmos`)
+
+**Constants:**
+
+- `NOBLE_MAINNET_CAIP2` - CAIP-2 identifier for Noble mainnet
+- `NOBLE_TESTNET_CAIP2` - CAIP-2 identifier for Noble testnet
+- `COSMOS_NETWORKS` - Array of supported networks
+- `NETWORK_RPC_ENDPOINTS` - RPC endpoint mapping
+- `NETWORK_REST_ENDPOINTS` - REST endpoint mapping
+- `SCHEME_EXACT_DIRECT` - Scheme identifier
+- `USDC_DENOM` - USDC denomination (`uusdc`)
+- `MSG_TYPE_SEND` - Cosmos MsgSend type URL
+
+**Tokens:**
+
+- `TOKEN_REGISTRY` - Token configurations by network
+- `getTokenConfig(network, symbol)` - Get token by symbol
+- `getTokenByDenom(network, denom)` - Get token by denomination
+- `getDefaultToken(network)` - Get default token
+- `getNetworkTokens(network)` - Get all tokens for a network
+- `isNetworkSupported(network)` - Check if network is supported
+
+**Utilities:**
+
+- `isValidAddress(address)` - Validate Noble bech32 address (`noble1...`)
+- `normalizeNetwork(network)` - Normalize to CAIP-2 format
+- `extractNetworkId(network)` - Extract network ID from CAIP-2
+- `getRpcEndpoint(network)` - Get RPC endpoint for network
+- `getRestEndpoint(network)` - Get REST endpoint for network
+- `toAtomicUnits(amount, decimals)` - Convert decimal to smallest units
+- `formatAmount(amount, decimals)` - Format for display
+
+### Client (`@t402/cosmos/exact-direct/client`)
+
+```typescript
+import { ExactDirectCosmosClient } from "@t402/cosmos/exact-direct/client";
+
+const client = new ExactDirectCosmosClient(signer);
+const payload = await client.createPaymentPayload(2, requirements);
+```
+
+### Server (`@t402/cosmos/exact-direct/server`)
+
+```typescript
+import { ExactDirectCosmosServer } from "@t402/cosmos/exact-direct/server";
+
+const server = new ExactDirectCosmosServer();
+const assetAmount = await server.parsePrice(1.5, "cosmos:noble-1");
+```
+
+### Facilitator (`@t402/cosmos/exact-direct/facilitator`)
+
+```typescript
+import { ExactDirectCosmosFacilitator } from "@t402/cosmos/exact-direct/facilitator";
+
+const facilitator = new ExactDirectCosmosFacilitator(signer);
+const result = await facilitator.verify(2, payloadBytes, requirementsBytes);
+```
+
+## Payment Flow
+
+1. **Client** requests protected resource
+2. **Server** responds with 402 + payment requirements (network, amount, payTo)
+3. **Client** broadcasts a `MsgSend` transaction on Noble chain
+4. **Client** submits transaction hash as payment proof
+5. **Facilitator** queries Noble REST API to verify the transaction
+6. **Facilitator** confirms payment matches requirements (amount, recipient, denom)
+
+## Payload Structure
+
+```typescript
+interface ExactDirectCosmosPayload {
+  txHash: string; // Transaction hash
+  from: string; // Sender bech32 address (noble1...)
+  to: string; // Recipient bech32 address (noble1...)
+  amount: string; // Amount in smallest units (uusdc)
+  denom?: string; // Token denomination (default: uusdc)
+}
+```
+
+## Address Format
+
+Noble uses bech32 addresses with the `noble` prefix:
+
+```
+noble1qg5ega6dykkxc307y25pecuufrjkxkaggkkxh7
+noble1m3h30wlvsf8llruxtpukdvsy0km2kum8g38c8q
+```
+
+## USDC on Noble
+
+Noble is an appchain purpose-built for native USDC issuance in the Cosmos ecosystem:
+
+- **Denomination**: `uusdc` (micro-USDC)
+- **Decimals**: 6 (1 USDC = 1,000,000 uusdc)
+- **Transfer**: Uses standard `cosmos.bank.v1beta1.MsgSend`
+
+```typescript
+// MsgSend structure
+{
+  "@type": "/cosmos.bank.v1beta1.MsgSend",
+  fromAddress: "noble1sender...",
+  toAddress: "noble1recipient...",
+  amount: [{ denom: "uusdc", amount: "1000000" }]
+}
+```
+
+## Gas Configuration
+
+Default gas parameters:
+
+- Gas limit: 200,000
+- Gas price: 0.025 uusdc
+- Default fee: 5,000 uusdc (0.005 USDC)
+
+## 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 implementation
+- `@t402/svm` - Solana implementation
+- `@t402/ton` - TON implementation
+- `@t402/tron` - TRON implementation
+- `@t402/near` - NEAR Protocol implementation
+- `@t402/aptos` - Aptos implementation
+- `@t402/tezos` - Tezos implementation
+- `@t402/polkadot` - Polkadot Asset Hub implementation
+- `@t402/stacks` - Stacks implementation

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

@@ -0,0 +1,50 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayload } from '@t402/core/types';
+import { d as ClientCosmosSigner } from '../../types-CgseoctH.js';
+
+/**
+ * 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/cjs/exact-direct/client/index.js

@@ -0,0 +1,122 @@
+"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, {
+  ExactDirectCosmosClient: () => ExactDirectCosmosClient
+});
+module.exports = __toCommonJS(client_exports);
+
+// src/constants.ts
+var NOBLE_MAINNET_CAIP2 = "cosmos:noble-1";
+var NOBLE_TESTNET_CAIP2 = "cosmos:grand-1";
+var NOBLE_MAINNET_RPC = "https://noble-rpc.polkachu.com";
+var NOBLE_TESTNET_RPC = "https://rpc.testnet.noble.strange.love";
+var NOBLE_MAINNET_REST = "https://noble-api.polkachu.com";
+var NOBLE_TESTNET_REST = "https://api.testnet.noble.strange.love";
+var NETWORK_RPC_ENDPOINTS = {
+  [NOBLE_MAINNET_CAIP2]: NOBLE_MAINNET_RPC,
+  [NOBLE_TESTNET_CAIP2]: NOBLE_TESTNET_RPC
+};
+var NETWORK_REST_ENDPOINTS = {
+  [NOBLE_MAINNET_CAIP2]: NOBLE_MAINNET_REST,
+  [NOBLE_TESTNET_CAIP2]: NOBLE_TESTNET_REST
+};
+var NOBLE_BECH32_PREFIX = "noble";
+var USDC_DENOM = "uusdc";
+var SCHEME_EXACT_DIRECT = "exact-direct";
+var MAX_TRANSACTION_AGE = 5 * 60 * 1e3;
+var COSMOS_CAIP2_NAMESPACE = "cosmos";
+
+// src/utils.ts
+function normalizeNetwork(network) {
+  if (network.startsWith(`${COSMOS_CAIP2_NAMESPACE}:`)) {
+    return network;
+  }
+  return `${COSMOS_CAIP2_NAMESPACE}:${network}`;
+}
+function isValidAddress(address) {
+  if (!address || address.length < 10) {
+    return false;
+  }
+  return address.startsWith(`${NOBLE_BECH32_PREFIX}1`);
+}
+
+// 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
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ExactDirectCosmosClient
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/exact-direct/client/index.ts","../../../../src/constants.ts","../../../../src/utils.ts","../../../../src/exact-direct/client/scheme.ts"],"sourcesContent":["/**\n * Cosmos Exact-Direct Client Exports\n */\n\nexport { ExactDirectCosmosClient, type ExactDirectCosmosClientConfig } from \"./scheme.js\";\n","/**\n * Cosmos Network Constants\n *\n * This module provides constants for Cosmos blockchain integration including:\n * - CAIP-2 network identifiers (Noble chain)\n * - RPC and REST endpoints\n * - Bech32 prefix configuration\n * - USDC denomination and gas parameters\n */\n\n/**\n * CAIP-2 Network Identifiers for Cosmos (Noble)\n */\nexport const NOBLE_MAINNET_CAIP2 = \"cosmos:noble-1\";\nexport const NOBLE_TESTNET_CAIP2 = \"cosmos:grand-1\";\n\n/**\n * Supported Cosmos networks\n */\nexport const COSMOS_NETWORKS = [NOBLE_MAINNET_CAIP2, NOBLE_TESTNET_CAIP2] as const;\n\nexport type CosmosNetwork = (typeof COSMOS_NETWORKS)[number];\n\n/**\n * Default RPC endpoints\n */\nexport const NOBLE_MAINNET_RPC = \"https://noble-rpc.polkachu.com\";\nexport const NOBLE_TESTNET_RPC = \"https://rpc.testnet.noble.strange.love\";\n\n/**\n * Default REST endpoints\n */\nexport const NOBLE_MAINNET_REST = \"https://noble-api.polkachu.com\";\nexport const NOBLE_TESTNET_REST = \"https://api.testnet.noble.strange.love\";\n\n/**\n * Network RPC endpoint mapping\n */\nexport const NETWORK_RPC_ENDPOINTS: Record<string, string> = {\n  [NOBLE_MAINNET_CAIP2]: NOBLE_MAINNET_RPC,\n  [NOBLE_TESTNET_CAIP2]: NOBLE_TESTNET_RPC,\n};\n\n/**\n * Network REST endpoint mapping\n */\nexport const NETWORK_REST_ENDPOINTS: Record<string, string> = {\n  [NOBLE_MAINNET_CAIP2]: NOBLE_MAINNET_REST,\n  [NOBLE_TESTNET_CAIP2]: NOBLE_TESTNET_REST,\n};\n\n/**\n * Bech32 prefix for Noble addresses\n */\nexport const NOBLE_BECH32_PREFIX = \"noble\";\n\n/**\n * USDC denomination on Noble\n * uusdc = micro-USDC (1 USDC = 1,000,000 uusdc)\n */\nexport const USDC_DENOM = \"uusdc\";\n\n/**\n * Default gas parameters\n */\nexport const DEFAULT_GAS_LIMIT = 200000;\nexport const DEFAULT_GAS_PRICE = \"0.025uusdc\";\nexport const DEFAULT_FEE_AMOUNT = \"5000\"; // 0.005 USDC\n\n/**\n * Cosmos message type for bank send\n */\nexport const MSG_TYPE_SEND = \"/cosmos.bank.v1beta1.MsgSend\";\n\n/**\n * Scheme identifier for exact-direct payments\n */\nexport const SCHEME_EXACT_DIRECT = \"exact-direct\";\n\n/**\n * Maximum transaction age to accept (in milliseconds)\n */\nexport const MAX_TRANSACTION_AGE = 5 * 60 * 1000; // 5 minutes\n\n/**\n * CAIP-2 namespace for Cosmos\n */\nexport const COSMOS_CAIP2_NAMESPACE = \"cosmos\";\n","/**\n * Cosmos Utility Functions\n *\n * Helper functions for Cosmos address validation, network normalization,\n * and amount conversion.\n */\n\nimport {\n  COSMOS_CAIP2_NAMESPACE,\n  NOBLE_BECH32_PREFIX,\n  NETWORK_RPC_ENDPOINTS,\n  NETWORK_REST_ENDPOINTS,\n  type CosmosNetwork,\n} from \"./constants.js\";\n\n/**\n * Normalize a network identifier to CAIP-2 format\n * @param network - Network identifier (e.g., \"noble-1\", \"cosmos:noble-1\")\n * @returns CAIP-2 formatted network identifier\n */\nexport function normalizeNetwork(network: string): CosmosNetwork {\n  // Already in CAIP-2 format\n  if (network.startsWith(`${COSMOS_CAIP2_NAMESPACE}:`)) {\n    return network as CosmosNetwork;\n  }\n  // Convert shorthand to CAIP-2\n  return `${COSMOS_CAIP2_NAMESPACE}:${network}` as CosmosNetwork;\n}\n\n/**\n * Extract network ID from CAIP-2 identifier\n * @param network - CAIP-2 network identifier\n * @returns Network ID (e.g., \"noble-1\")\n */\nexport function extractNetworkId(network: string): string {\n  if (network.includes(\":\")) {\n    return network.split(\":\")[1];\n  }\n  return network;\n}\n\n/**\n * Validate a Cosmos bech32 address with Noble prefix\n * Checks that the address starts with the \"noble\" prefix followed by \"1\"\n * @param address - Address to validate\n * @returns Whether the address is valid\n */\nexport function isValidAddress(address: string): boolean {\n  if (!address || address.length < 10) {\n    return false;\n  }\n  return address.startsWith(`${NOBLE_BECH32_PREFIX}1`);\n}\n\n/**\n * Get RPC endpoint for a network\n * @param network - CAIP-2 network identifier\n * @returns RPC endpoint URL\n */\nexport function getRpcEndpoint(network: string): string {\n  const normalizedNetwork = normalizeNetwork(network);\n  return NETWORK_RPC_ENDPOINTS[normalizedNetwork] || NETWORK_RPC_ENDPOINTS[\"cosmos:noble-1\"];\n}\n\n/**\n * Get REST endpoint for a network\n * @param network - CAIP-2 network identifier\n * @returns REST endpoint URL\n */\nexport function getRestEndpoint(network: string): string {\n  const normalizedNetwork = normalizeNetwork(network);\n  return NETWORK_REST_ENDPOINTS[normalizedNetwork] || NETWORK_REST_ENDPOINTS[\"cosmos:noble-1\"];\n}\n\n/**\n * Convert decimal amount to token units (atomic units)\n * @param decimalAmount - Amount with decimals (e.g., \"1.50\")\n * @param decimals - Token decimals\n * @returns Amount in smallest units\n */\nexport function toAtomicUnits(decimalAmount: string | number, decimals: number): bigint {\n  const amount = typeof decimalAmount === \"string\" ? parseFloat(decimalAmount) : decimalAmount;\n  if (isNaN(amount)) {\n    throw new Error(`Invalid amount: ${decimalAmount}`);\n  }\n  const multiplier = 10 ** decimals;\n  return BigInt(Math.floor(amount * multiplier));\n}\n\n/**\n * Format amount for display (with decimals)\n * @param amount - Amount in smallest units\n * @param decimals - Number of decimal places\n * @returns Formatted amount string\n */\nexport function formatAmount(amount: bigint, decimals: number): string {\n  const divisor = BigInt(10 ** decimals);\n  const whole = amount / divisor;\n  const remainder = amount % divisor;\n  const decimal = remainder.toString().padStart(decimals, \"0\").slice(0, 2);\n  return `${whole}.${decimal}`;\n}\n\n/**\n * Get the list of supported networks\n * @returns Array of CAIP-2 network identifiers\n */\nexport function getSupportedNetworks(): string[] {\n  return Object.keys(NETWORK_RPC_ENDPOINTS);\n}\n","/**\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":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACaO,IAAM,sBAAsB;AAC5B,IAAM,sBAAsB;AAY5B,IAAM,oBAAoB;AAC1B,IAAM,oBAAoB;AAK1B,IAAM,qBAAqB;AAC3B,IAAM,qBAAqB;AAK3B,IAAM,wBAAgD;AAAA,EAC3D,CAAC,mBAAmB,GAAG;AAAA,EACvB,CAAC,mBAAmB,GAAG;AACzB;AAKO,IAAM,yBAAiD;AAAA,EAC5D,CAAC,mBAAmB,GAAG;AAAA,EACvB,CAAC,mBAAmB,GAAG;AACzB;AAKO,IAAM,sBAAsB;AAM5B,IAAM,aAAa;AAiBnB,IAAM,sBAAsB;AAK5B,IAAM,sBAAsB,IAAI,KAAK;AAKrC,IAAM,yBAAyB;;;ACnE/B,SAAS,iBAAiB,SAAgC;AAE/D,MAAI,QAAQ,WAAW,GAAG,sBAAsB,GAAG,GAAG;AACpD,WAAO;AAAA,EACT;AAEA,SAAO,GAAG,sBAAsB,IAAI,OAAO;AAC7C;AAoBO,SAAS,eAAe,SAA0B;AACvD,MAAI,CAAC,WAAW,QAAQ,SAAS,IAAI;AACnC,WAAO;AAAA,EACT;AACA,SAAO,QAAQ,WAAW,GAAG,mBAAmB,GAAG;AACrD;;;AC1BO,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/cjs/exact-direct/facilitator/index.d.ts

@@ -0,0 +1,70 @@
+import { SchemeNetworkFacilitator, Network, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse } from '@t402/core/types';
+import { F as FacilitatorCosmosSigner } from '../../types-CgseoctH.js';
+
+/**
+ * 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 };