@t402/cosmos 2.4.0

package/dist/esm/index.d.mts

@@ -0,0 +1,178 @@
+import { T as TokenConfig } from './types-CgseoctH.mjs';
+export { d as ClientCosmosSigner, C as Coin, E as ExactDirectCosmosPayload, F as FacilitatorCosmosSigner, M as MsgSend, N as NetworkConfig, a as TransactionResult, c as TxBody, b as TxWrapper } from './types-CgseoctH.mjs';
+export { ExactDirectCosmosClient, ExactDirectCosmosClientConfig } from './exact-direct/client/index.mjs';
+export { ExactDirectCosmosServer, ExactDirectCosmosServerConfig } from './exact-direct/server/index.mjs';
+export { ExactDirectCosmosFacilitator, ExactDirectCosmosFacilitatorConfig } from './exact-direct/facilitator/index.mjs';
+import '@t402/core/types';
+
+/**
+ * Cosmos Network Constants
+ *
+ * This module provides constants for Cosmos blockchain integration including:
+ * - CAIP-2 network identifiers (Noble chain)
+ * - RPC and REST endpoints
+ * - Bech32 prefix configuration
+ * - USDC denomination and gas parameters
+ */
+/**
+ * CAIP-2 Network Identifiers for Cosmos (Noble)
+ */
+declare const NOBLE_MAINNET_CAIP2 = "cosmos:noble-1";
+declare const NOBLE_TESTNET_CAIP2 = "cosmos:grand-1";
+/**
+ * Supported Cosmos networks
+ */
+declare const COSMOS_NETWORKS: readonly ["cosmos:noble-1", "cosmos:grand-1"];
+type CosmosNetwork = (typeof COSMOS_NETWORKS)[number];
+/**
+ * Default RPC endpoints
+ */
+declare const NOBLE_MAINNET_RPC = "https://noble-rpc.polkachu.com";
+declare const NOBLE_TESTNET_RPC = "https://rpc.testnet.noble.strange.love";
+/**
+ * Default REST endpoints
+ */
+declare const NOBLE_MAINNET_REST = "https://noble-api.polkachu.com";
+declare const NOBLE_TESTNET_REST = "https://api.testnet.noble.strange.love";
+/**
+ * Network RPC endpoint mapping
+ */
+declare const NETWORK_RPC_ENDPOINTS: Record<string, string>;
+/**
+ * Network REST endpoint mapping
+ */
+declare const NETWORK_REST_ENDPOINTS: Record<string, string>;
+/**
+ * Bech32 prefix for Noble addresses
+ */
+declare const NOBLE_BECH32_PREFIX = "noble";
+/**
+ * USDC denomination on Noble
+ * uusdc = micro-USDC (1 USDC = 1,000,000 uusdc)
+ */
+declare const USDC_DENOM = "uusdc";
+/**
+ * Default gas parameters
+ */
+declare const DEFAULT_GAS_LIMIT = 200000;
+declare const DEFAULT_GAS_PRICE = "0.025uusdc";
+declare const DEFAULT_FEE_AMOUNT = "5000";
+/**
+ * Cosmos message type for bank send
+ */
+declare const MSG_TYPE_SEND = "/cosmos.bank.v1beta1.MsgSend";
+/**
+ * Scheme identifier for exact-direct payments
+ */
+declare const SCHEME_EXACT_DIRECT = "exact-direct";
+/**
+ * Maximum transaction age to accept (in milliseconds)
+ */
+declare const MAX_TRANSACTION_AGE: number;
+/**
+ * CAIP-2 namespace for Cosmos
+ */
+declare const COSMOS_CAIP2_NAMESPACE = "cosmos";
+
+/**
+ * Cosmos Token Registry
+ *
+ * Defines supported tokens for each Cosmos network (currently Noble USDC).
+ */
+
+/**
+ * Token registry by network
+ */
+declare const TOKEN_REGISTRY: Record<string, TokenConfig[]>;
+/**
+ * Get token configuration by symbol
+ * @param network - CAIP-2 network identifier
+ * @param symbol - Token symbol (e.g., "USDC")
+ * @returns Token configuration or undefined
+ */
+declare function getTokenConfig(network: string, symbol: string): TokenConfig | undefined;
+/**
+ * Get token configuration by denomination
+ * @param network - CAIP-2 network identifier
+ * @param denom - Token denomination (e.g., "uusdc")
+ * @returns Token configuration or undefined
+ */
+declare function getTokenByDenom(network: string, denom: string): TokenConfig | undefined;
+/**
+ * Get the default token for a network
+ * Returns the token with highest priority (lowest priority number)
+ * @param network - CAIP-2 network identifier
+ * @returns Default token configuration or undefined
+ */
+declare function getDefaultToken(network: string): TokenConfig | undefined;
+/**
+ * Get all tokens for a network
+ * @param network - CAIP-2 network identifier
+ * @returns Array of token configurations
+ */
+declare function getNetworkTokens(network: string): TokenConfig[];
+/**
+ * Check if a network is supported
+ * @param network - CAIP-2 network identifier
+ */
+declare function isNetworkSupported(network: string): boolean;
+
+/**
+ * Cosmos Utility Functions
+ *
+ * Helper functions for Cosmos address validation, network normalization,
+ * and amount conversion.
+ */
+
+/**
+ * Normalize a network identifier to CAIP-2 format
+ * @param network - Network identifier (e.g., "noble-1", "cosmos:noble-1")
+ * @returns CAIP-2 formatted network identifier
+ */
+declare function normalizeNetwork(network: string): CosmosNetwork;
+/**
+ * Extract network ID from CAIP-2 identifier
+ * @param network - CAIP-2 network identifier
+ * @returns Network ID (e.g., "noble-1")
+ */
+declare function extractNetworkId(network: string): string;
+/**
+ * Validate a Cosmos bech32 address with Noble prefix
+ * Checks that the address starts with the "noble" prefix followed by "1"
+ * @param address - Address to validate
+ * @returns Whether the address is valid
+ */
+declare function isValidAddress(address: string): boolean;
+/**
+ * Get RPC endpoint for a network
+ * @param network - CAIP-2 network identifier
+ * @returns RPC endpoint URL
+ */
+declare function getRpcEndpoint(network: string): string;
+/**
+ * Get REST endpoint for a network
+ * @param network - CAIP-2 network identifier
+ * @returns REST endpoint URL
+ */
+declare function getRestEndpoint(network: string): string;
+/**
+ * Convert decimal amount to token units (atomic units)
+ * @param decimalAmount - Amount with decimals (e.g., "1.50")
+ * @param decimals - Token decimals
+ * @returns Amount in smallest units
+ */
+declare function toAtomicUnits(decimalAmount: string | number, decimals: number): bigint;
+/**
+ * Format amount for display (with decimals)
+ * @param amount - Amount in smallest units
+ * @param decimals - Number of decimal places
+ * @returns Formatted amount string
+ */
+declare function formatAmount(amount: bigint, decimals: number): string;
+/**
+ * Get the list of supported networks
+ * @returns Array of CAIP-2 network identifiers
+ */
+declare function getSupportedNetworks(): string[];
+
+export { COSMOS_CAIP2_NAMESPACE, COSMOS_NETWORKS, type CosmosNetwork, DEFAULT_FEE_AMOUNT, DEFAULT_GAS_LIMIT, DEFAULT_GAS_PRICE, MAX_TRANSACTION_AGE, MSG_TYPE_SEND, NETWORK_REST_ENDPOINTS, NETWORK_RPC_ENDPOINTS, NOBLE_BECH32_PREFIX, NOBLE_MAINNET_CAIP2, NOBLE_MAINNET_REST, NOBLE_MAINNET_RPC, NOBLE_TESTNET_CAIP2, NOBLE_TESTNET_REST, NOBLE_TESTNET_RPC, SCHEME_EXACT_DIRECT, TOKEN_REGISTRY, TokenConfig, USDC_DENOM, extractNetworkId, formatAmount, getDefaultToken, getNetworkTokens, getRestEndpoint, getRpcEndpoint, getSupportedNetworks, getTokenByDenom, getTokenConfig, isNetworkSupported, isValidAddress, normalizeNetwork, toAtomicUnits };

package/dist/esm/index.mjs

@@ -0,0 +1,83 @@
+import {
+  ExactDirectCosmosClient
+} from "./chunk-QP5VO3IO.mjs";
+import {
+  ExactDirectCosmosServer
+} from "./chunk-JV6LXL2U.mjs";
+import {
+  ExactDirectCosmosFacilitator
+} from "./chunk-XUMAS5DJ.mjs";
+import {
+  TOKEN_REGISTRY,
+  getDefaultToken,
+  getNetworkTokens,
+  getTokenByDenom,
+  getTokenConfig,
+  isNetworkSupported
+} from "./chunk-57DBLYIR.mjs";
+import {
+  COSMOS_CAIP2_NAMESPACE,
+  COSMOS_NETWORKS,
+  DEFAULT_FEE_AMOUNT,
+  DEFAULT_GAS_LIMIT,
+  DEFAULT_GAS_PRICE,
+  MAX_TRANSACTION_AGE,
+  MSG_TYPE_SEND,
+  NETWORK_REST_ENDPOINTS,
+  NETWORK_RPC_ENDPOINTS,
+  NOBLE_BECH32_PREFIX,
+  NOBLE_MAINNET_CAIP2,
+  NOBLE_MAINNET_REST,
+  NOBLE_MAINNET_RPC,
+  NOBLE_TESTNET_CAIP2,
+  NOBLE_TESTNET_REST,
+  NOBLE_TESTNET_RPC,
+  SCHEME_EXACT_DIRECT,
+  USDC_DENOM,
+  extractNetworkId,
+  formatAmount,
+  getRestEndpoint,
+  getRpcEndpoint,
+  getSupportedNetworks,
+  isValidAddress,
+  normalizeNetwork,
+  toAtomicUnits
+} from "./chunk-2UTEGIZ2.mjs";
+export {
+  COSMOS_CAIP2_NAMESPACE,
+  COSMOS_NETWORKS,
+  DEFAULT_FEE_AMOUNT,
+  DEFAULT_GAS_LIMIT,
+  DEFAULT_GAS_PRICE,
+  ExactDirectCosmosClient,
+  ExactDirectCosmosFacilitator,
+  ExactDirectCosmosServer,
+  MAX_TRANSACTION_AGE,
+  MSG_TYPE_SEND,
+  NETWORK_REST_ENDPOINTS,
+  NETWORK_RPC_ENDPOINTS,
+  NOBLE_BECH32_PREFIX,
+  NOBLE_MAINNET_CAIP2,
+  NOBLE_MAINNET_REST,
+  NOBLE_MAINNET_RPC,
+  NOBLE_TESTNET_CAIP2,
+  NOBLE_TESTNET_REST,
+  NOBLE_TESTNET_RPC,
+  SCHEME_EXACT_DIRECT,
+  TOKEN_REGISTRY,
+  USDC_DENOM,
+  extractNetworkId,
+  formatAmount,
+  getDefaultToken,
+  getNetworkTokens,
+  getRestEndpoint,
+  getRpcEndpoint,
+  getSupportedNetworks,
+  getTokenByDenom,
+  getTokenConfig,
+  isNetworkSupported,
+  isValidAddress,
+  normalizeNetwork,
+  toAtomicUnits
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

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

package/dist/esm/types-CgseoctH.d.mts

@@ -0,0 +1,155 @@
+/**
+ * Cosmos Payment Types
+ *
+ * Defines the payload structure for Cosmos (Noble USDC) payments using the exact-direct scheme.
+ * The exact-direct scheme has the client execute the transfer directly, then provide
+ * the transaction hash as proof of payment.
+ */
+/**
+ * Cosmos payment payload for the exact-direct scheme
+ * Contains transaction hash and metadata for verification
+ */
+type ExactDirectCosmosPayload = {
+    /**
+     * Transaction hash of the completed MsgSend
+     */
+    txHash: string;
+    /**
+     * Sender bech32 address (e.g., "noble1...")
+     */
+    from: string;
+    /**
+     * Recipient bech32 address (e.g., "noble1...")
+     */
+    to: string;
+    /**
+     * Transfer amount in smallest units (e.g., "1000000" for 1 USDC)
+     */
+    amount: string;
+    /**
+     * Token denomination (e.g., "uusdc")
+     */
+    denom?: string;
+};
+/**
+ * Token configuration
+ */
+interface TokenConfig {
+    /** Token denomination */
+    denom: string;
+    /** Token symbol */
+    symbol: string;
+    /** Token name */
+    name: string;
+    /** Decimal places */
+    decimals: number;
+    /** Priority for selection (lower = higher priority) */
+    priority: number;
+}
+/**
+ * Network configuration
+ */
+interface NetworkConfig {
+    /** CAIP-2 network identifier */
+    network: string;
+    /** Bech32 address prefix */
+    bech32Prefix: string;
+    /** RPC endpoint */
+    rpcEndpoint: string;
+    /** REST endpoint */
+    restEndpoint: string;
+}
+/**
+ * Cosmos transaction result
+ */
+interface TransactionResult {
+    /** Transaction hash */
+    txHash: string;
+    /** Block height */
+    height: string;
+    /** Result code (0 = success) */
+    code: number;
+    /** Raw log */
+    rawLog: string;
+    /** Gas wanted */
+    gasWanted: string;
+    /** Gas used */
+    gasUsed: string;
+    /** Transaction timestamp */
+    timestamp: string;
+    /** Transaction body */
+    tx: TxWrapper;
+}
+/**
+ * Transaction wrapper
+ */
+interface TxWrapper {
+    body: TxBody;
+}
+/**
+ * Transaction body
+ */
+interface TxBody {
+    messages: MsgSend[];
+    memo: string;
+}
+/**
+ * Cosmos MsgSend
+ */
+interface MsgSend {
+    "@type"?: string;
+    fromAddress: string;
+    toAddress: string;
+    amount: Coin[];
+}
+/**
+ * Cosmos Coin
+ */
+interface Coin {
+    denom: string;
+    amount: string;
+}
+/**
+ * Cosmos signer interface for client operations
+ */
+interface ClientCosmosSigner {
+    /**
+     * Get the bech32 address
+     */
+    readonly address: string;
+    /**
+     * Send tokens to a recipient
+     * @param network - CAIP-2 network identifier
+     * @param to - Recipient bech32 address
+     * @param amount - Amount in smallest units
+     * @param denom - Token denomination
+     * @returns Transaction hash
+     */
+    sendTokens(network: string, to: string, amount: string, denom: string): Promise<string>;
+}
+/**
+ * Cosmos signer interface for facilitator operations
+ */
+interface FacilitatorCosmosSigner {
+    /**
+     * Get the facilitator's addresses for a network
+     * @param network - CAIP-2 network identifier
+     */
+    getAddresses(network: string): string[];
+    /**
+     * Query a transaction by hash
+     * @param network - CAIP-2 network identifier
+     * @param txHash - Transaction hash
+     * @returns Transaction result
+     */
+    queryTransaction(network: string, txHash: string): Promise<TransactionResult>;
+    /**
+     * Get token balance for an address
+     * @param network - CAIP-2 network identifier
+     * @param address - Bech32 address
+     * @param denom - Token denomination
+     */
+    getBalance(network: string, address: string, denom: string): Promise<bigint>;
+}
+
+export type { Coin as C, ExactDirectCosmosPayload as E, FacilitatorCosmosSigner as F, MsgSend as M, NetworkConfig as N, TokenConfig as T, TransactionResult as a, TxWrapper as b, TxBody as c, ClientCosmosSigner as d };

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "@t402/cosmos",
+  "version": "2.4.0",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/cjs/index.d.ts",
+  "keywords": [
+    "t402",
+    "payment",
+    "protocol",
+    "cosmos",
+    "noble",
+    "usdc"
+  ],
+  "license": "Apache-2.0",
+  "author": "T402 Team",
+  "repository": "https://github.com/t402-io/t402",
+  "description": "t402 Payment Protocol Cosmos (Noble USDC) Implementation",
+  "devDependencies": {
+    "@eslint/js": "^9.24.0",
+    "@types/node": "^25.2.0",
+    "@typescript-eslint/eslint-plugin": "^8.29.1",
+    "@typescript-eslint/parser": "^8.29.1",
+    "eslint": "^9.24.0",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-jsdoc": "^62.5.0",
+    "eslint-plugin-prettier": "^5.2.6",
+    "glob": "^13.0.0",
+    "prettier": "3.5.2",
+    "tsup": "^8.4.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.3",
+    "vite": "^7.3.1",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "@t402/core": "2.4.0"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.mts",
+        "default": "./dist/esm/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./exact-direct/client": {
+      "import": {
+        "types": "./dist/esm/exact-direct/client/index.d.mts",
+        "default": "./dist/esm/exact-direct/client/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/exact-direct/client/index.d.ts",
+        "default": "./dist/cjs/exact-direct/client/index.js"
+      }
+    },
+    "./exact-direct/server": {
+      "import": {
+        "types": "./dist/esm/exact-direct/server/index.d.mts",
+        "default": "./dist/esm/exact-direct/server/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/exact-direct/server/index.d.ts",
+        "default": "./dist/cjs/exact-direct/server/index.js"
+      }
+    },
+    "./exact-direct/facilitator": {
+      "import": {
+        "types": "./dist/esm/exact-direct/facilitator/index.d.mts",
+        "default": "./dist/esm/exact-direct/facilitator/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/exact-direct/facilitator/index.d.ts",
+        "default": "./dist/cjs/exact-direct/facilitator/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "start": "tsx --env-file=.env index.ts",
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "watch": "tsc --watch",
+    "format": "prettier -c .prettierrc --write \"**/*.{ts,js,cjs,json,md}\"",
+    "format:check": "prettier -c .prettierrc --check \"**/*.{ts,js,cjs,json,md}\"",
+    "lint": "eslint . --ext .ts --fix",
+    "lint:check": "eslint . --ext .ts"
+  }
+}