@bolt-liquidity-hq/cosmwasm-client 0.1.0-beta.7 → 0.1.0-beta.9

package/dist/index.d.cts

@@ -1,730 +1,8 @@
 import { ArchwayClient, SigningArchwayClient } from '@archwayhq/arch3.js';
+import { ChainConfig, ClientConfig, Address, Duration, AssetPairString, Timestamp, OracleAssetPair, Coin, AllowanceMode, BaseClient, OracleConfig, InvertiblePrice, Price, RouterConfig, BaseLiquidityDetails, Pool, PoolConfig, Asset, SwapParams, SwapResult } from '@bolt-liquidity-hq/core';
 import { CosmWasmClient, SigningCosmWasmClient, ExecuteResult } from '@cosmjs/cosmwasm-stargate';
 import { OfflineSigner } from '@cosmjs/proto-signing';
 
-/**
- * Error codes used throughout the Bolt SDK to categorize different types of errors.
- *
- * These codes help in programmatic error handling and provide a consistent way
- * to identify error types across the SDK. Error codes are organized into ranges
- * by category for easier identification and handling.
- *
- * Error Code Ranges:
- * - 1000-1999: Resource & Data Errors
- * - 2000-2999: Blockchain Transaction Errors
- * - 3000-3999: Infrastructure & Network Errors
- * - 4000-4999: Validation & Input Errors
- *
- * @enum {number}
- * @group Errors
- * @category Error Types
- *
- * @example
- * ```typescript
- * import { BoltSdkErrorCode, BoltSdkError } from '@bolt-liquidity-hq/cosmwasm-client';
- *
- * try {
- *   await client.swap(signer, params);
- * } catch (error) {
- *   if (error instanceof BoltSdkError) {
- *     switch (error.code) {
- *       case BoltSdkErrorCode.INVALID_ADDRESS:
- *         console.error("Invalid address format");
- *         break;
- *       case BoltSdkErrorCode.TRANSACTION_EVENT_NOT_FOUND:
- *         console.error("Transaction event not found");
- *         break;
- *       default:
- *         console.error("Operation failed:", error.message);
- *     }
- *   }
- * }
- * ```
- */
-declare enum BoltSdkErrorCode {
-    /** Resource not found (pools, assets, configurations) */
-    NOT_FOUND = 1000,
-    /** Invalid object structure or missing required fields */
-    INVALID_OBJECT = 1001,
-    /** Type mismatch or invalid type provided */
-    INVALID_TYPE = 1002,
-    /** Insufficient balance to perform the operation */
-    INSUFFICIENT_FUNDS = 2000,
-    /** Invalid blockchain address format */
-    INVALID_ADDRESS = 2001,
-    /** Transaction reverted or failed on-chain */
-    TRANSACTION_FAILED = 2002,
-    /** Expected transaction event not found in logs */
-    TRANSACTION_EVENT_NOT_FOUND = 2003,
-    /** Network connectivity or RPC communication failure */
-    NETWORK_ERROR = 3000,
-    /** Invalid parameter provided to a method */
-    INVALID_PARAMETER = 4000,
-    /** Required parameter is missing */
-    MISSING_PARAMETER = 4001,
-    /** Numeric value outside acceptable range */
-    PARAMETER_OUT_OF_RANGE = 4002
-}
-/**
- * Base interface for all Bolt SDK errors.
- *
- * All custom errors in the SDK implement this interface, providing
- * a consistent error structure with error codes for easy handling.
- *
- * @interface
- * @group Errors
- * @category Error Types
- */
-interface BoltSdkError extends Error {
-    /** The error code categorizing this error */
-    code: BoltSdkErrorCode;
-}
-/**
- * Base class for all custom errors in the Bolt SDK.
- *
- * This abstract base class provides common functionality for all SDK errors,
- * including error code assignment and proper error name setting.
- *
- * @abstract
- * @group Errors
- * @category Error Classes
- */
-declare class BoltSdkErrorBase extends Error implements BoltSdkError {
-    code: BoltSdkErrorCode;
-    /**
-     * Creates a new BoltSdkErrorBase instance.
-     *
-     * @param code - The error code categorizing this error
-     * @param message - Human-readable error message
-     */
-    constructor(code: BoltSdkErrorCode, message: string);
-}
-/**
- * Error thrown when a requested resource cannot be found.
- *
- * @group Errors
- * @category Error Classes
- */
-declare class NotFoundError extends BoltSdkErrorBase {
-    /**
-     * Creates a new NotFoundError instance.
-     *
-     * @param resource - The type of resource that was not found
-     * @param details - Optional additional details about what was searched for
-     */
-    constructor(resource: string, details?: string);
-}
-/**
- * Error thrown when an object doesn't have the expected structure.
- *
- * @group Errors
- * @category Error Classes
- */
-declare class InvalidObjectError extends BoltSdkErrorBase {
-    /**
-     * Creates a new InvalidObjectError instance.
-     *
-     * @param details - Optional description of what is invalid about the object
-     */
-    constructor(details?: string);
-}
-/**
- * Error thrown when an unexpected type is encountered.
- *
- * @group Errors
- * @category Error Classes
- */
-declare class InvalidTypeError extends BoltSdkErrorBase {
-    /**
-     * Creates a new InvalidTypeError instance.
-     *
-     * @param expectedType - The type that was expected
-     * @param receivedType - The actual type that was received
-     */
-    constructor(expectedType: string, receivedType: string);
-}
-/**
- * Error thrown when an account has insufficient funds for an operation.
- *
- * @group Errors
- * @category Error Classes
- */
-declare class InsufficientFundsError extends BoltSdkErrorBase {
-    /**
-     * Creates a new InsufficientFundsError instance.
-     *
-     * @param required - The amount required for the operation
-     * @param available - The amount available in the account
-     */
-    constructor(required: number, available: number);
-}
-/**
- * Error thrown when an invalid blockchain address is provided.
- *
- * @group Errors
- * @category Error Classes
- */
-declare class InvalidAddressError extends BoltSdkErrorBase {
-    /**
-     * Creates a new InvalidAddressError instance.
-     *
-     * @param address - The invalid address that was provided
-     */
-    constructor(address: string);
-}
-/**
- * Error thrown when a blockchain transaction fails or is reverted.
- *
- * @group Errors
- * @category Error Classes
- */
-declare class TransactionFailedError extends BoltSdkErrorBase {
-    /**
-     * Creates a new TransactionFailedError instance.
-     *
-     * @param transactionId - The transaction hash or identifier
-     * @param details - Optional details about why the transaction failed
-     */
-    constructor(transactionId: string, details?: string);
-}
-/**
- * Error thrown when an expected transaction event is not found in the logs.
- *
- * @group Errors
- * @category Error Classes
- */
-declare class TransactionEventNotFoundError extends BoltSdkErrorBase {
-    /**
-     * Creates a new TransactionEventNotFoundError instance.
-     *
-     * @param eventName - The name of the event that was expected
-     * @param details - Optional details about the context
-     */
-    constructor(eventName: string, details?: string);
-}
-/**
- * Error thrown when network communication fails.
- *
- * @group Errors
- * @category Error Classes
- */
-declare class NetworkError extends BoltSdkErrorBase {
-    /**
-     * Creates a new NetworkError instance.
-     *
-     * @param details - Optional details about the network failure
-     */
-    constructor(details?: string);
-}
-/**
- * Error thrown when an invalid parameter is provided to a method.
- *
- * @group Errors
- * @category Error Classes
- */
-declare class InvalidParameterError<T = unknown> extends BoltSdkErrorBase {
-    /**
-     * Creates a new InvalidParameterError instance.
-     *
-     * @param parameterName - The name of the invalid parameter
-     * @param expected - Description of what was expected
-     * @param receivedValue - The actual value that was provided
-     * @param details - Optional additional details or constraints
-     *
-     * @template T - The type of the received value
-     */
-    constructor(parameterName: string, expected: string, receivedValue: T, details?: string);
-}
-/**
- * Error thrown when a required parameter is missing.
- *
- * @group Errors
- * @category Error Classes
- */
-declare class MissingParameterError extends BoltSdkErrorBase {
-    /**
-     * Creates a new MissingParameterError instance.
-     *
-     * @param parameterName - The name of the missing parameter
-     * @param context - Optional context about where the parameter was expected
-     */
-    constructor(parameterName: string, context?: string);
-}
-/**
- * Error thrown when a numeric parameter is outside the acceptable range.
- *
- * @group Errors
- * @category Error Classes
- */
-declare class ParameterOutOfRangeError extends BoltSdkErrorBase {
-    /**
-     * Creates a new ParameterOutOfRangeError instance.
-     *
-     * @param parameterName - The name of the parameter that's out of range
-     * @param value - The actual value that was provided
-     * @param min - Optional minimum acceptable value (inclusive)
-     * @param max - Optional maximum acceptable value (inclusive)
-     * @param details - Optional additional details about the constraint
-     */
-    constructor(parameterName: string, value: number | bigint, min?: number | bigint, max?: number | bigint, details?: string);
-}
-
-type Address = string;
-type AssetPairString = string;
-type Timestamp = string;
-type Duration = {
-    secs: number;
-    nanos: number;
-};
-type Coin = {
-    denom: string;
-    amount: string;
-};
-
-type Environment = 'mainnet' | 'testnet';
-type Asset = {
-    symbol: string;
-    name: string;
-    chainId: string;
-    denom: string;
-    decimals: number;
-    logo?: string;
-    coingeckoId?: string;
-};
-type ChainConfig = {
-    name: string;
-    id: string;
-    rpcEndpoint: string;
-};
-type Contracts = {
-    oracle: Address;
-    router: Address;
-};
-type AssetsConfig = Record<string, Asset>;
-
-type ClientConfig<TChainConfig = ChainConfig> = {
-    environment?: Environment;
-    customOverride?: {
-        chainConfig?: Partial<TChainConfig>;
-        contracts?: Partial<Contracts>;
-        assetsConfig?: AssetsConfig;
-    };
-};
-
-type OracleConfig = {
-    admin: Address;
-    priceThresholdRatio: string;
-    priceExpireTime: Duration | null;
-};
-type Price = {
-    assetPair: AssetPairString;
-    price: string;
-    expiryTime: Timestamp;
-};
-type InvertiblePrice = Price & {
-    isInverse: boolean;
-};
-type OracleAsset = {
-    name: string;
-    symbol: string;
-    precision: number;
-};
-type OracleAssetPair = {
-    base: OracleAsset;
-    quote: OracleAsset;
-};
-
-type AllowanceMode = 'allow' | 'disallow';
-type PoolConfig = {
-    priceOracleContract: Address;
-    protocolFeeRecipient: Address;
-    protocolFee: string;
-    lpFee: string;
-    allowanceMode: AllowanceMode;
-    lps: Address[];
-    minBaseOut: string;
-};
-type BaseLiquidityDetails = {
-    baseLiquidity: Coin;
-    totalShares: string;
-};
-
-type RouterConfig = {
-    admin: Address;
-    defaultPriceOracleContract: Address;
-    defaultProtocolFeeRecipient: Address;
-    defaultProtocolFee: string;
-    defaultLpFee: string;
-    settlementCodeId: number;
-};
-type Pool = {
-    poolAddress: Address;
-    baseAssetSymbol: string;
-    quoteAssetsSymbols: string[];
-};
-type SwapParams = {
-    assetIn: string;
-    amountIn: string;
-    assetOut: string;
-    minimumAmountOut?: string;
-    receiver?: Address;
-};
-type SwapResult<TTxOutput = unknown> = {
-    txOutput: TTxOutput;
-    amountOut: string;
-    assetOut: string;
-    txHash: string;
-};
-
-/**
- * Abstract base client for all implementations of the Bolt SDK for different chains/networks.
- *
- * This class provides the foundation for blockchain-specific implementations,
- * defining the core interface for interacting with oracle and router contracts.
- *
- * @template TSigner - The type of the transaction signer specific to the blockchain implementation
- * @template TTxOutput - The type of the transaction output specific to the blockchain implementation
- *
- * @example
- * ```typescript
- * class BoltCosmWasmClient extends BaseClient<OfflineSigner, ExecuteResult> {
- *   // Implementation specific to CosmWasm
- * }
- * ```
- */
-declare abstract class BaseClient<TSigner = unknown, TTxOutput = unknown> {
-    /**
-     * The blockchain network configuration containing chain ID, name, and RPC endpoint
-     */
-    chainConfig: ChainConfig;
-    /**
-     * Smart contract addresses for making Bolt queries and transactions in the blockchain
-     */
-    contracts: Contracts;
-    /**
-     * Configuration mapping of supported assets indexed by their symbol
-     */
-    assetsConfig: AssetsConfig;
-    /**
-     * Creates a new instance of the BaseClient.
-     *
-     * @param config - (Optional) Configuration object for the client
-     * @param config.customOverride - (Optional) Override configuration containing chain settings, contracts, and assets
-     * @param config.customOverride.chainConfig - (Optional) Chain configuration object
-     * @param config.customOverride.chainConfig.id - (Optional) The chain ID of the blockchain network (e.g., "archway-1")
-     * @param config.customOverride.chainConfig.name - (Optional) The human-readable name of the chain (e.g., "Archway")
-     * @param config.customOverride.chainConfig.rpcEndpoint - (Optional) RPC endpoint URL for the blockchain network
-     * @param config.customOverride.contracts - (Optional) Contract addresses for oracle and router
-     * @param config.customOverride.contracts.oracle - (Optional) Oracle contract address
-     * @param config.customOverride.contracts.router - (Optional) Router contract address
-     * @param config.customOverride.assetsConfig - (Optional) Configuration for supported assets indexed by symbol
-     *
-     * @throws {InvalidObjectError} Thrown when required configuration fields are missing
-     *
-     * @example
-     * ```typescript
-     * const client = new ConcreteClient({
-     *   customOverride: {
-     *     chainConfig: {
-     *       id: 'archway-1',
-     *       name: 'Archway',
-     *       rpcEndpoint: 'https://rpc.example.com'
-     *     },
-     *     contracts: {
-     *       oracle: 'archway1oracle...',
-     *       router: 'archway1router...'
-     *     },
-     *     assetsConfig: {
-     *       'ARCH': {
-     *         symbol: 'ARCH',
-     *         name: 'Archway',
-     *         chainId: 'archway-1',
-     *         denom: 'aarch',
-     *         decimals: 18,
-     *         logo: 'https://...',
-     *         coingeckoId: 'archway'
-     *       }
-     *     }
-     *   }
-     * });
-     * ```
-     */
-    constructor(config?: ClientConfig);
-    /**
-     * Fetches the oracle configuration from the blockchain.
-     *
-     * @returns A promise that resolves to the oracle configuration containing
-     *          settings such as price expiration time and threshold ratio
-     *
-     * @example
-     * ```typescript
-     * const oracleConfig = await client.getOracleConfig();
-     * console.log(`Price expiration: ${oracleConfig.priceExpireTime} seconds`);
-     * console.log(`Admin: ${oracleConfig.admin}`);
-     * console.log(`Price threshold ratio: ${oracleConfig.priceThresholdRatio}`);
-     * ```
-     */
-    abstract getOracleConfig(): Promise<OracleConfig>;
-    /**
-     * Fetches all asset pairs supported by the oracle.
-     *
-     * @returns A promise that resolves to an array of oracle asset pairs,
-     *          each containing base and quote asset information with name, symbol and precision
-     *
-     * @example
-     * ```typescript
-     * const pairs = await client.getAllOracleAssetPairs();
-     * pairs.forEach(pair => {
-     *   console.log(`${pair.base.symbol}/${pair.quote.symbol}`);
-     *   console.log(`  Base: ${pair.base.name} (${pair.base.precision} decimals)`);
-     *   console.log(`  Quote: ${pair.quote.name} (${pair.quote.precision} decimals)`);
-     * });
-     * ```
-     */
-    abstract getAllOracleAssetPairs(): Promise<OracleAssetPair[]>;
-    /**
-     * Fetches the current price for a specific base/quote asset pair from the oracle.
-     *
-     * @param baseAssetSymbol - The symbol of the base asset (e.g., "ARCH", "USDC")
-     * @param quoteAssetSymbol - The symbol of the quote asset (e.g., "ARCH", "USDC")
-     *
-     * @returns A promise that resolves to an invertible price object containing
-     *          the current price from the oracle and whether it's inverted
-     *
-     * @example
-     * ```typescript
-     * // Get price of ARCH in terms of USDC
-     * const priceResult = await client.getPrice("ARCH", "USDC");
-     * console.log(`1 ARCH = ${priceResult.price} USDC`);
-     * console.log(`Is inverted: ${priceResult.isInverse}`);
-     * ```
-     */
-    abstract getPrice(baseAssetSymbol: string, quoteAssetSymbol: string): Promise<InvertiblePrice>;
-    /**
-     * Fetches all available prices from the oracle.
-     *
-     * @returns A promise that resolves to an array of all current prices
-     *          available in the oracle with their respective asset pairs and expiry times
-     *
-     * @example
-     * ```typescript
-     * const prices = await client.getAllPrices();
-     * prices.forEach(priceData => {
-     *   console.log(`${priceData.assetPair}: ${priceData.price}`);
-     *   console.log(`  Expires at: ${new Date(priceData.expiryTime * 1000).toISOString()}`);
-     * });
-     * ```
-     */
-    abstract getAllPrices(): Promise<Price[]>;
-    /**
-     * Fetches the router configuration from the blockchain.
-     *
-     * @returns A promise that resolves to the router configuration containing
-     *          settings such as default protocol fees, LP fees, and oracle configuration
-     *
-     * @example
-     * ```typescript
-     * const routerConfig = await client.getRouterConfig();
-     * console.log(`Default protocol fee: ${routerConfig.defaultProtocolFee * 100}%`);
-     * console.log(`Default LP fee: ${routerConfig.defaultLpFee * 100}%`);
-     * console.log(`Oracle address: ${routerConfig.priceOracleContract}`);
-     * ```
-     */
-    abstract getRouterConfig(): Promise<RouterConfig>;
-    /**
-     * Fetches the total liquidity for all base assets across all pools.
-     *
-     * @returns A promise that resolves to a record mapping pool addresses
-     *          to their respective base asset liquidity details, including
-     *          the base liquidity amount and total shares
-     *
-     * @example
-     * ```typescript
-     * const liquidity = await client.getAllBaseAssetsLiquidity();
-     * Object.entries(liquidity).forEach(([poolAddress, details]) => {
-     *   console.log(`Pool ${poolAddress}:`);
-     *   console.log(`  Base: ${details.baseLiquidity.amount} ${details.baseLiquidity.denom}`);
-     *   console.log(`  Total Shares: ${details.totalShares}`);
-     * });
-     * ```
-     */
-    abstract getAllBaseAssetsLiquidity(): Promise<Record<Address, BaseLiquidityDetails>>;
-    /**
-     * Fetches all withdrawable quote assets for a specific user or liquidity provider.
-     *
-     * @param address - The blockchain address of the user or liquidity provider
-     *
-     * @returns A promise that resolves to a record mapping pool addresses
-     *          to arrays of withdrawable quote asset coins
-     *
-     * @example
-     * ```typescript
-     * const quotes = await client.getAllQuotesByUser("archway1...");
-     * Object.entries(quotes).forEach(([poolAddress, coins]) => {
-     *   console.log(`Pool ${poolAddress}:`);
-     *   coins.forEach(coin => {
-     *     console.log(`  ${coin.amount} ${coin.denom}`);
-     *   });
-     * });
-     * ```
-     */
-    abstract getAllQuotesByUser(address: Address): Promise<Record<Address, Coin[]>>;
-    /**
-     * Fetches pool information for a specific base asset.
-     *
-     * @param baseAssetSymbol - The symbol of the base asset (e.g., "ARCH", "ATOM")
-     *
-     * @returns A promise that resolves to the pool information for the specified asset
-     *
-     * @throws Will throw an error if no pool exists for the specified base asset
-     *
-     * @example
-     * ```typescript
-     * const pool = await client.getPoolByBaseAsset("ARCH");
-     * console.log(`Pool address: ${pool.poolAddress}`);
-     * console.log(`Base asset: ${pool.baseAssetSymbol}`);
-     * console.log('Available quote assets:');
-     * pool.quoteAssetsSymbols.forEach(symbol => {
-     *   console.log(`  - ${symbol}`);
-     * });
-     * ```
-     */
-    abstract getPoolByBaseAsset(baseAssetSymbol: string): Promise<Pool>;
-    /**
-     * Fetches information for all available pools.
-     *
-     * @returns A promise that resolves to an array containing all pool information
-     *
-     * @example
-     * ```typescript
-     * const pools = await client.getAllPools();
-     * pools.forEach(pool => {
-     *   console.log(`Pool ${pool.poolAddress}:`);
-     *   console.log(`  Base: ${pool.baseAssetSymbol}`);
-     *   console.log(`  Quotes: ${pool.quoteAssetsSymbols.join(', ')}`);
-     * });
-     * ```
-     */
-    abstract getAllPools(): Promise<Pool[]>;
-    /**
-     * Fetches the configuration settings for a specific liquidity pool.
-     *
-     * This method retrieves detailed configuration parameters for a pool, including
-     * fee structures, oracle settings, liquidity provider information, and trading limits.
-     *
-     * @param poolContractAddress - The blockchain address of the pool contract
-     *
-     * @returns A promise that resolves to a pool configuration object
-     *          containing settings such as fees, oracle address, LP addresses, and minimum trade amounts
-     *
-     * @example
-     * ```typescript
-     * const poolConfig = await client.getPoolConfig("archway1pool...");
-     * console.log(`Oracle: ${poolConfig.priceOracleContract}`);
-     * console.log(`Protocol fee: ${poolConfig.protocolFee * 100}%`);
-     * console.log(`LP fee: ${poolConfig.lpFee * 100}%`);
-     * console.log(`Allowance mode: ${poolConfig.allowanceMode}`);
-     * console.log(`LPs: ${poolConfig.lps.join(', ')}`);
-     * console.log(`Min base output: ${poolConfig.minBaseOut}`);
-     * ```
-     */
-    abstract getPoolConfig(poolContractAddress: string): Promise<PoolConfig>;
-    /**
-     * Fetches all supported assets across all pools in the Bolt protocol.
-     *
-     * This method retrieves comprehensive information about all assets that can be traded,
-     * including their metadata, chain-specific details, and external identifiers.
-     *
-     * @returns A promise that resolves to an array of Asset objects, each containing:
-     *          - symbol: The asset's trading symbol (e.g., "ARCH", "USDC")
-     *          - name: The full name of the asset (e.g., "Archway", "USD Coin")
-     *          - chainId: The blockchain network identifier where this asset exists
-     *          - denom: The chain-specific denomination (e.g., "aarch", "ibc/...")
-     *          - decimals: The number of decimal places for the asset
-     *          - logo: Optional URL to the asset's logo image
-     *          - coingeckoId: Optional CoinGecko identifier for price data
-     *
-     * @example
-     * ```typescript
-     * const assets = await client.getAllAssets();
-     *
-     * // Display all available assets
-     * assets.forEach(asset => {
-     *   console.log(`${asset.symbol} (${asset.name})`);
-     *   console.log(`  Chain: ${asset.chainId}`);
-     *   console.log(`  Denom: ${asset.denom}`);
-     *   console.log(`  Decimals: ${asset.decimals}`);
-     *   if (asset.coingeckoId) {
-     *     console.log(`  CoinGecko: ${asset.coingeckoId}`);
-     *   }
-     * });
-     *
-     * // Find a specific asset
-     * const archAsset = assets.find(a => a.symbol === 'ARCH');
-     * console.log(`ARCH denom: ${archAsset?.denom}`);
-     * ```
-     *
-     * @remarks
-     * Assets returned by this method represent all tokens available for trading
-     * in the Bolt protocol. The list may vary between mainnet and testnet environments.
-     */
-    abstract getAllAssets(): Promise<Asset[]>;
-    /**
-     * Executes a swap operation on the blockchain from one asset to another.
-     *
-     * This method performs a "swap exact in" where the exact input amount is specified, and the output
-     * amount varies based on current pool conditions and fees. The transaction includes
-     * slippage protection through the optional minimumAmountOut parameter.
-     *
-     * @param signer - The transaction signer that will authorize the swap operation.
-     *                 Must have sufficient balance of the input asset.
-     * @param params - The swap configuration parameters
-     * @param params.assetIn - The denom of the asset being sold (e.g., "aarch", "ibc/...")
-     * @param params.amountIn - The exact amount of input asset to swap (in minimal denomination)
-     * @param params.assetOut - The denom of the asset being bought (e.g., "aarch", "ibc/...")
-     * @param params.minimumAmountOut - Optional minimum acceptable amount of output asset.
-     *                                  Transaction will fail if actual output would be less.
-     * @param params.receiver - Optional recipient address for the swapped assets.
-     *                         If not provided, defaults to the signer's address.
-     *
-     * @returns A promise that resolves to a SwapResult containing:
-     *          - txOutput: Transaction execution details (type varies by implementation)
-     *          - amountOut: The actual amount of output asset received (as a string)
-     *          - assetOut: The denom of the asset received
-     *          - txHash: The transaction hash
-     *
-     * @throws Will throw an error if the swap fails due to insufficient balance,
-     *         slippage exceeding tolerance, or other transaction errors
-     *
-     * @example
-     * ```typescript
-     * // Swap exactly 1 ARCH for USDC (output amount varies)
-     * const result = await client.swap(signer, {
-     *   assetIn: "aarch",
-     *   amountIn: "1000000000000000000", // Exactly 1 ARCH (18 decimals)
-     *   assetOut: "ibc/43897B9739BD63E3A08A88191999C632E052724AB96BD4C74AE31375C991F48D", // USDC IBC denom
-     *   minimumAmountOut: "1950000000", // Accept no less than 1950 USDC
-     *   receiver: "archway1..." // Optional custom receiver
-     * });
-     *
-     * console.log(`Swapped exactly 1 ARCH`);
-     * console.log(`Received: ${result.amountOut} ${result.assetOut}`);
-     * console.log(`Transaction: ${result.txHash}`);
-     * ```
-     *
-     * @remarks
-     * This is a "swap exact in" operation where:
-     * - The input amount is exactly what you specify
-     * - The output amount depends on pool conditions
-     * - Fees are deducted from the output
-     * - Use minimumAmountOut to protect against excessive slippage
-     *
-     * The TTxOutput type parameter represents the transaction execution result type,
-     * which varies by blockchain implementation (e.g., ExecuteResult for CosmWasm).
-     */
-    abstract swap(signer: TSigner, params: SwapParams): Promise<SwapResult<TTxOutput>>;
-}
-
 type CosmWasmChainConfig = ChainConfig & {
     restEndpoint: string;
 };
@@ -980,32 +258,7 @@ declare class BoltCosmWasmClient extends BaseClient<OfflineSigner, ExecuteResult
     getPoolConfig(poolContractAddress: Address): Promise<PoolConfig>;
     /** @inheritdoc */
     getAllAssets(): Promise<Asset[]>;
-    /**
-     * Fetches the configuration settings for a pool identified by its base asset symbol.
-     *
-     * This is a convenience method that combines pool lookup and configuration retrieval.
-     * It first finds the pool associated with the given base asset, then fetches that
-     * pool's configuration parameters from its settlement contract.
-     *
-     * @param baseAssetSymbol - The symbol of the base asset (e.g., "ARCH", "ATOM")
-     *
-     * @returns A promise that resolves to a pool configuration object containing
-     *          settings such as fees, oracle address, LP addresses, and minimum trade amounts
-     *
-     * @throws Will throw an error if no pool exists for the specified base asset
-     *
-     * @example
-     * ```typescript
-     * // Get pool configuration for ARCH base asset
-     * const poolConfig = await client.getPoolConfigByBaseAsset("ARCH");
-     * console.log(`Oracle: ${poolConfig.priceOracleContract}`);
-     * console.log(`Protocol fee: ${parseFloat(poolConfig.protocolFee) * 100}%`);
-     * console.log(`LP fee: ${parseFloat(poolConfig.lpFee) * 100}%`);
-     * console.log(`Allowance mode: ${poolConfig.allowanceMode}`);
-     * console.log(`Number of LPs: ${poolConfig.lps.length}`);
-     * console.log(`Min base output: ${poolConfig.minBaseOut}`);
-     * ```
-     */
+    /** @inheritdoc */
     getPoolConfigByBaseAsset(baseAssetSymbol: string): Promise<PoolConfig>;
     /**
      * @inheritdoc
@@ -1038,4 +291,4 @@ declare class BoltCosmWasmClient extends BaseClient<OfflineSigner, ExecuteResult
     swap(signer: OfflineSigner, params: SwapParams): Promise<SwapResult<ExecuteResult>>;
 }
 
-export { type Address, type AllowanceMode, type Asset, type AssetPairString, type AssetsConfig, BaseClient, type BaseLiquidityDetails, BoltCosmWasmClient, type BoltSdkError, BoltSdkErrorBase, BoltSdkErrorCode, type ChainConfig, type ClientConfig, type Coin, type Contracts, type CosmWasmChain, type CosmWasmChainConfig, type CosmWasmClientConfig, type Duration, type Environment, InsufficientFundsError, InvalidAddressError, InvalidObjectError, InvalidParameterError, InvalidTypeError, type InvertiblePrice, type InvertiblePriceRepresentation, type MarketRepresentation, MissingParameterError, NetworkError, NotFoundError, type OracleAsset, type OracleAssetPair, type OracleConfig, ParameterOutOfRangeError, type Pool, type PoolConfig, type Price, type PriceRepresentation, type QueryAssetPairsResponse, type QueryBaseLiquidityAllResponse, type QueryBaseLiquidityResponse, type QueryMarketsResponse, type QueryOracleConfigResponse, type QueryPriceResponse, type QueryPricesResponse, type QueryQuotesForUserAllResponse, type QueryRouterConfigResponse, type QuerySettlementConfigResponse, type RouterConfig, type SwapParams, type SwapResult, type Timestamp, TransactionEventNotFoundError, TransactionFailedError };
+export { BoltCosmWasmClient, type CosmWasmChain, type CosmWasmChainConfig, type CosmWasmClientConfig, type InvertiblePriceRepresentation, type MarketRepresentation, type PriceRepresentation, type QueryAssetPairsResponse, type QueryBaseLiquidityAllResponse, type QueryBaseLiquidityResponse, type QueryMarketsResponse, type QueryOracleConfigResponse, type QueryPriceResponse, type QueryPricesResponse, type QueryQuotesForUserAllResponse, type QueryRouterConfigResponse, type QuerySettlementConfigResponse };