@t402/aptos 2.3.0

package/dist/index.d.ts

@@ -0,0 +1,145 @@
+import { A as AptosTransactionEvent, P as ParsedFATransfer, a as AptosTransactionResult } from './types-kOweBf4U.js';
+export { c as AptosStateChange, b as AptosTransactionPayload, C as ClientAptosSigner, E as ExactDirectAptosPayload, F as FacilitatorAptosSigner, e as extractChainId } from './types-kOweBf4U.js';
+import { Network } from '@t402/core/types';
+export { AptosClientConfig, ExactDirectAptosClient, ExactDirectAptosClientConfig, registerExactDirectAptosClient } from './exact-direct/client/index.js';
+export { AptosServerConfig, ExactDirectAptosServer, ExactDirectAptosServerConfig, registerExactDirectAptosServer } from './exact-direct/server/index.js';
+export { AptosFacilitatorConfig, ExactDirectAptosFacilitator, ExactDirectAptosFacilitatorConfig, registerExactDirectAptosFacilitator } from './exact-direct/facilitator/index.js';
+import '@t402/core/client';
+import '@t402/core/server';
+import '@t402/core/facilitator';
+
+/**
+ * Aptos Network Constants
+ */
+declare const APTOS_CAIP2_NAMESPACE = "aptos";
+declare const APTOS_MAINNET_CAIP2 = "aptos:1";
+declare const APTOS_TESTNET_CAIP2 = "aptos:2";
+declare const APTOS_DEVNET_CAIP2 = "aptos:149";
+declare const APTOS_NETWORKS: readonly ["aptos:1", "aptos:2", "aptos:149"];
+type AptosNetwork = (typeof APTOS_NETWORKS)[number];
+declare const APTOS_MAINNET_CHAIN_ID = 1;
+declare const APTOS_TESTNET_CHAIN_ID = 2;
+declare const APTOS_DEVNET_CHAIN_ID = 149;
+declare const DEFAULT_MAINNET_RPC = "https://fullnode.mainnet.aptoslabs.com/v1";
+declare const DEFAULT_TESTNET_RPC = "https://fullnode.testnet.aptoslabs.com/v1";
+declare const DEFAULT_DEVNET_RPC = "https://fullnode.devnet.aptoslabs.com/v1";
+declare const SCHEME_EXACT_DIRECT = "exact-direct";
+declare const PRIMARY_FUNGIBLE_STORE_MODULE = "0x1::primary_fungible_store";
+declare const FUNGIBLE_ASSET_MODULE = "0x1::fungible_asset";
+declare const APTOS_ACCOUNT_MODULE = "0x1::aptos_account";
+declare const FA_TRANSFER_FUNCTION = "0x1::primary_fungible_store::transfer";
+declare const DEFAULT_MAX_GAS_AMOUNT = 100000n;
+declare const DEFAULT_GAS_UNIT_PRICE = 100n;
+declare const DEFAULT_TX_EXPIRATION_SECONDS = 600;
+
+/**
+ * Aptos Token Registry
+ *
+ * Token addresses for supported stablecoins on Aptos networks.
+ * All tokens use the Fungible Asset (FA) standard.
+ */
+/**
+ * Token configuration for Aptos fungible assets
+ */
+interface TokenConfig {
+    /** Fungible Asset metadata address */
+    metadataAddress: string;
+    /** Token symbol (e.g., "USDT", "USDC") */
+    symbol: string;
+    /** Token name */
+    name: string;
+    /** Decimal places */
+    decimals: number;
+}
+/**
+ * Token registry mapping network -> tokens
+ */
+declare const TOKEN_REGISTRY: Record<string, TokenConfig[]>;
+/**
+ * Get token configuration for a specific network and symbol
+ */
+declare function getTokenConfig(network: string, symbol: string): TokenConfig | undefined;
+/**
+ * Get all supported tokens for a network
+ */
+declare function getSupportedTokens(network: string): TokenConfig[];
+/**
+ * Check if a token is supported on a network
+ */
+declare function isTokenSupported(network: string, symbol: string): boolean;
+/**
+ * Get token by metadata address
+ */
+declare function getTokenByAddress(network: string, metadataAddress: string): TokenConfig | undefined;
+/**
+ * Default token symbol for payments (USDT)
+ */
+declare const DEFAULT_TOKEN_SYMBOL = "USDT";
+/**
+ * Get the default token for a network
+ */
+declare function getDefaultToken(network: string): TokenConfig | undefined;
+
+/**
+ * Aptos Utility Functions
+ */
+
+/**
+ * Validate Aptos address format
+ * Aptos addresses are 64 hex characters (32 bytes) with 0x prefix
+ */
+declare function isValidAptosAddress(address: string): boolean;
+/**
+ * Normalize Aptos address to full 64-character format
+ */
+declare function normalizeAptosAddress(address: string): string;
+/**
+ * Compare two Aptos addresses (case-insensitive, handles short addresses)
+ */
+declare function compareAddresses(addr1: string, addr2: string): boolean;
+/**
+ * Validate transaction hash format
+ */
+declare function isValidTxHash(txHash: string): boolean;
+/**
+ * Get default RPC URL for a network
+ */
+declare function getDefaultRpcUrl(network: Network): string;
+/**
+ * Check if a network identifier is for Aptos
+ */
+declare function isAptosNetwork(network: Network): boolean;
+/**
+ * Parse CAIP-19 asset identifier for Aptos
+ * Format: aptos:1/fa:0x...
+ */
+declare function parseAssetIdentifier(asset: string): {
+    network: Network;
+    metadataAddress: string;
+} | null;
+/**
+ * Create CAIP-19 asset identifier for Aptos FA
+ */
+declare function createAssetIdentifier(network: Network, metadataAddress: string): string;
+/**
+ * Parse fungible asset transfer from transaction events
+ */
+declare function parseFATransferFromEvents(events: AptosTransactionEvent[]): ParsedFATransfer | null;
+/**
+ * Check if transaction is a FA transfer
+ */
+declare function isFATransferTransaction(tx: AptosTransactionResult): boolean;
+/**
+ * Extract transfer details from transaction
+ */
+declare function extractTransferDetails(tx: AptosTransactionResult): ParsedFATransfer | null;
+/**
+ * Format amount with decimals for display
+ */
+declare function formatAmount(amount: bigint, decimals: number): string;
+/**
+ * Parse amount string to bigint
+ */
+declare function parseAmount(amount: string, decimals: number): bigint;
+
+export { APTOS_ACCOUNT_MODULE, APTOS_CAIP2_NAMESPACE, APTOS_DEVNET_CAIP2, APTOS_DEVNET_CHAIN_ID, APTOS_MAINNET_CAIP2, APTOS_MAINNET_CHAIN_ID, APTOS_NETWORKS, APTOS_TESTNET_CAIP2, APTOS_TESTNET_CHAIN_ID, type AptosNetwork, AptosTransactionEvent, AptosTransactionResult, DEFAULT_DEVNET_RPC, DEFAULT_GAS_UNIT_PRICE, DEFAULT_MAINNET_RPC, DEFAULT_MAX_GAS_AMOUNT, DEFAULT_TESTNET_RPC, DEFAULT_TOKEN_SYMBOL, DEFAULT_TX_EXPIRATION_SECONDS, FA_TRANSFER_FUNCTION, FUNGIBLE_ASSET_MODULE, PRIMARY_FUNGIBLE_STORE_MODULE, ParsedFATransfer, SCHEME_EXACT_DIRECT, TOKEN_REGISTRY, type TokenConfig, compareAddresses, createAssetIdentifier, extractTransferDetails, formatAmount, getDefaultRpcUrl, getDefaultToken, getSupportedTokens, getTokenByAddress, getTokenConfig, isAptosNetwork, isFATransferTransaction, isTokenSupported, isValidAptosAddress, isValidTxHash, normalizeAptosAddress, parseAmount, parseAssetIdentifier, parseFATransferFromEvents };