@minswap/noodles-sdk 0.1.2-beta.0 → 0.2.0

package/dist/index.d.ts

@@ -5,7 +5,6 @@ import type { MemezPumpSDK } from '@interest-protocol/memez-fun-sdk';
 import { Path } from '@cetusprotocol/aggregator-sdk';
 import type { PreSwapLpChangeParams } from '@cetusprotocol/aggregator-sdk';
 import { Protocol } from '@flowx-finance/sdk';
-import { Quote } from '@naviprotocol/astros-aggregator-sdk';
 import { QuoteResponse } from '@bluefin-exchange/bluefin7k-aggregator-sdk';
 import type { Route } from '@flowx-finance/sdk/src/universal-router/entities';
 import type { RouterCompleteTradeRoute } from 'aftermath-ts-sdk';
@@ -67,30 +66,13 @@ export declare type AddTierRequest = {
     currentTx?: Transaction;
 };
 
-/** Admin capability object ID for privileged operations */
 export declare const ADMIN_CAP_ID = "0x13d101f44a0710a5475bec5f492a87b80e03d92d1cf540f26096f65850b23d26";
 
-/**
- * Aftermath DEX aggregator client for routing trades across multiple pools
- */
 export declare class AftermathAggregator {
-    /** Configuration settings for the aggregator */
     private _config;
-    /** Aftermath SDK client instance (lazy-loaded on first use) */
     private _aftermathClient;
-    /** Sui blockchain client */
     private _suiClient;
-    /**
-     * Creates a new AftermathAggregator instance
-     * @param config - Aggregator configuration including optional API settings
-     * @param suiClient - Sui client for blockchain interactions
-     */
     constructor(config: AftermathAggregatorConfig, suiClient: SuiJsonRpcClient);
-    /**
-     * Lazy-loads and returns the Aftermath client, initializing it on first use
-     * Handles authentication if API key is provided in config
-     * @returns Promise resolving to initialized Aftermath client
-     */
     private aftermathClient;
     /**
      * Finds the optimal trade route for swapping tokens
@@ -116,15 +98,10 @@ export declare namespace AftermathAggregator {
     export function toCommonTradeRoutes(tradeRoute: RouterCompleteTradeRoute): FinalTradeRoute | null;
 }
 
-/**
- * Configuration options for the Aftermath aggregator
- */
 export declare type AftermathAggregatorConfig = {
-    /** Default trade fee settings applied to each trade */
     defaultTradeFee: TradeFeeOptions;
-    /** Optional API key for authenticated Aftermath API access */
     aftermathApiKey?: string;
-    /** Optional custom Aftermath API endpoint (defaults to MAINNET if not provided) */
+    /** Defaults to the MAINNET endpoint when omitted. */
     aftermathApiEndpoint?: string;
 };
 
@@ -155,36 +132,18 @@ export declare namespace AggregatorConverter {
 }
 
 /**
- * Main aggregator module that provides unified access to multiple DEX aggregators
- * Supports routing trades through Cetus, FlowX, Astros, Aftermath, and 7K Protocol
+ * Unified access to the supported DEX aggregators (Cetus, FlowX, Aftermath, 7K).
  */
 export declare class AggregatorModule implements IModule {
-    /** Reference to the main Noodles SDK instance */
     readonly sdk: NoodlesSdk;
-    /** Astros/Navi Protocol aggregator instance */
-    private _astrosAggregator;
-    /** Aftermath Finance aggregator instance */
     private _aftermathAggregator;
-    /** 7K Protocol aggregator instance */
     private _sevenkAggregator;
-    /** Cetus Protocol aggregator instance */
     private _cetusAggregator;
-    /** FlowX Finance aggregator instance */
     private _flowXAggregator;
-    /**
-     * Creates a new AggregatorModule instance with all supported aggregators
-     * @param sdk - The main Noodles SDK instance containing configuration
-     */
     constructor(sdk: NoodlesSdk);
-    /** Gets the Astros/Navi Protocol aggregator instance */
-    get astrosAggregator(): AstrosAggregator;
-    /** Gets the Aftermath Finance aggregator instance */
     get aftermathAggregator(): AftermathAggregator;
-    /** Gets the 7K Protocol aggregator instance */
     get sevenkAggregator(): SevenKAggregator;
-    /** Gets the Cetus Protocol aggregator instance */
     get cetusAggregator(): CetusAggregator;
-    /** Gets the FlowX Finance aggregator instance */
     get flowXAggregator(): FlowXAggregator;
     /**
      * Finds the optimal trade route using the specified aggregator
@@ -290,111 +249,10 @@ export declare type AggregatorTradeRoute<T extends SupportedAggregator> = AllAgg
 export declare type AllAggregatorTradeRoute = {
     [SupportedAggregator.FLOWX]: GetRoutesResult<Coin, Coin>;
     [SupportedAggregator.CETUS]: RouterDataV3;
-    [SupportedAggregator.ASTROS]: Quote;
     [SupportedAggregator.AFTERMATH]: RouterCompleteTradeRoute;
     [SupportedAggregator.SEVENK]: QuoteResponse;
 };
 
-/**
- * Astros DEX aggregator client for routing trades across multiple pools
- * Provides access to liquidity aggregation from various DEX protocols
- */
-export declare class AstrosAggregator {
-    /** Configuration settings for the aggregator */
-    private _config;
-    /** Sui blockchain client */
-    private _suiClient;
-    /**
-     * Creates a new AstrosAggregator instance
-     * @param config - Aggregator configuration including optional fee settings
-     * @param suiClient - Sui client for blockchain interactions
-     */
-    constructor(config: AstrosAggregatorConfig, suiClient: SuiJsonRpcClient);
-    /**
-     * Finds the optimal trade route for swapping tokens using Astros aggregator
-     * @param params - Trade route parameters
-     * @param params.coinInAmount - Amount of input token to swap
-     * @param params.coinInType - Type/address of input token
-     * @param params.coinOutType - Type/address of output token
-     * @returns Promise resolving to quote with pricing and route information, or null if no route found
-     */
-    getTradeRoute({ coinInAmount, coinInType, coinOutType, tradeFee, }: GetTradeRouteRequest_4): Promise<Quote | null>;
-    /**
-     * Merges multiple coin objects into a single coin for trading
-     * Optimizes coin usage by merging smaller coins into larger ones
-     * @param txb - Transaction builder instance
-     * @param coins - Array of coin objects to merge
-     * @param amount - Required amount for the trade
-     * @returns Transaction object reference for the merged coin
-     */
-    private returnMergedCoins;
-    /**
-     * Builds a transaction for executing a trade route from Astros aggregator
-     * @param params - Transaction parameters
-     * @param params.completeRoute - Complete quote from getTradeRoute() (aliased as quote)
-     * @param params.walletAddress - Address of the wallet executing the trade
-     * @param params.slippage - Maximum acceptable slippage (e.g., 0.01 for 1%)
-     * @returns Promise resolving to built transaction bytes ready for signing and execution
-     */
-    getTransaction({ completeRoute: quote, walletAddress, slippage, tradeFee, }: GetTransactionRequest_3): Promise<Uint8Array>;
-}
-
-export declare namespace AstrosAggregator {
-    export function toCommonTradeRoutes(tradeRoute: Quote, coinInType: string, coinOutType: string): FinalTradeRoute | null;
-}
-
-/**
- * Configuration options for the Astros aggregator
- */
-export declare type AstrosAggregatorConfig = {
-    /** Default trade fee settings applied to each trade */
-    defaultTradeFee: TradeFeeOptions;
-    /** Optional API key for Astros aggregator access */
-    astrosApiKey?: string;
-};
-
-/**
- * Individual trade path within a route
- */
-export declare type AstrosTradePath = {
-    /** Unique identifier for the path */
-    id: string;
-    /** Type of the trade path */
-    type: string;
-    /** Liquidity provider name */
-    provider: string;
-    /** Source token type */
-    from: string;
-    /** Target token type */
-    target: string;
-    /** Direction flag for A to B trade */
-    a2b: boolean;
-    /** Trade direction */
-    direction: boolean;
-    /** Fee rate for this path */
-    fee_rate: number;
-    /** Lot size for the trade */
-    lot_size: number;
-    /** Input amount for this path */
-    amount_in: number;
-    /** Output amount for this path */
-    amount_out: number;
-};
-
-/**
- * Trade route information from Astros aggregator
- */
-export declare type AstrosTradeRoute = {
-    /** Array of trade paths in the route */
-    path: AstrosTradePath[];
-    /** Total input amount */
-    amount_in: number;
-    /** Total output amount */
-    amount_out: number;
-    /** Initial price for the trade */
-    initial_price: number;
-};
-
 export declare type BalanceContent = {
     balance: string;
     id: {
@@ -544,7 +402,6 @@ export declare namespace Bolt {
     const ORACLE_OBJ_ID = "0xfa3975b98f3d0e3df18ed88ae6e69db31836b3f4212df02fae144b1e5a89ca8e";
 }
 
-/** Sui package ID for the boosting protocol */
 export declare const BOOSTING_PACKAGE_ID = "0x25fa0eb553dd69fa6a8028f73a38f1df7f289fa88a58ed3d7dc5a5360155bb19";
 
 /**
@@ -569,13 +426,7 @@ export declare type BoostingConfig = {
  * - Updating fee receiver settings
  */
 export declare class BoostingModule implements IPayModule {
-    /** Reference to the main SDK instance */
     sdk: NoodlesPaySdk;
-    /**
-     * Creates a new BoostingModule instance.
-     *
-     * @param sdk - The main Noodles Pay SDK instance
-     */
     constructor(sdk: NoodlesPaySdk);
     /**
      * Retrieves the current boosting configuration from the blockchain.
@@ -705,31 +556,12 @@ export declare type BuyMoreCUPlanRequest = {
     currentTx?: Transaction;
 };
 
-/**
- * Cetus DEX aggregator client for routing trades across multiple pools
- * Cetus is a concentrated liquidity protocol that provides efficient trading
- */
 export declare class CetusAggregator {
-    /** Configuration settings for the aggregator */
     private _config;
-    /** Sui blockchain client */
     private _suiClient;
-    /** Cetus aggregator client instance (lazy-loaded) */
     private _cetusClient;
     private getCetusClientConfig;
-    /**
-     * Creates a new CetusAggregator instance
-     * @param config - Aggregator configuration including fee settings and optional API credentials
-     * @param suiClient - Sui client for blockchain interactions
-     */
     constructor(config: CetusAggregatorConfig, suiClient: SuiGrpcClient);
-    /**
-     * Lazy-loads and returns the Cetus aggregator client, initializing it on first use
-     * Configures the client with overlay fees, API credentials, and partner information
-     * @param walletAddress - Optional wallet address for signing transactions
-     * @param tradeFee - Optional custom trade fee settings for this client instance
-     * @returns Initialized Cetus AggregatorClient instance
-     */
     private cetusClient;
     /**
      * Finds the optimal trade route for swapping tokens using Cetus aggregator
@@ -740,7 +572,7 @@ export declare class CetusAggregator {
      * @param params.metaAggregator - If true, only meta-supported protocols are used and no extra overlay fee is applied
      * @returns Promise resolving to router data with pricing and route information, or null if no route found
      */
-    getTradeRoute({ coinInAmount, coinInType, coinOutType, tradeFee, metaAggregator, supportedProtocols, }: GetTradeRouteRequest_5 & {
+    getTradeRoute({ coinInAmount, coinInType, coinOutType, tradeFee, metaAggregator, supportedProtocols, }: GetTradeRouteRequest_4 & {
         supportedProtocols?: string[];
     }): Promise<RouterDataV3 | null>;
     /**
@@ -751,24 +583,17 @@ export declare class CetusAggregator {
      * @param params.slippage - Maximum acceptable slippage (e.g., 0.01 for 1%)
      * @returns Promise resolving to built transaction bytes ready for signing and execution
      */
-    getTransaction({ completeRoute: routers, walletAddress, slippage, tradeFee, metaAggregator, }: GetTransactionRequest_4): Promise<Uint8Array>;
+    getTransaction({ completeRoute: routers, walletAddress, slippage, tradeFee, metaAggregator, }: GetTransactionRequest_3): Promise<Uint8Array>;
 }
 
 export declare namespace CetusAggregator {
     export function toCommonTradeRoutes(tradeRoute: RouterDataV3, coinInType: string, coinOutType: string): FinalTradeRoute | null;
 }
 
-/**
- * Configuration options for the Cetus aggregator
- */
 export declare type CetusAggregatorConfig = {
-    /** Default trade fee settings applied to each trade */
     defaultTradeFee: TradeFeeOptions;
-    /** Optional API key for Cetus aggregator access */
     cetusApiKey?: string;
-    /** Optional custom Cetus API endpoint */
     cetusApiEndpoint?: string;
-    /** Optional partner ID for Cetus integration */
     cetusPartnerId?: string;
 };
 
@@ -862,7 +687,6 @@ export declare interface CommonTxParams {
     isSponsored?: boolean;
 }
 
-/** Configuration object ID for boosting settings */
 export declare const CONFIG_ID = "0x8b1a8ac6e34688cd8f8f8e5fefa9d5fb9e1ff74d2f132f8e208ae5ac9cc530bb";
 
 export declare class CurveModule implements IModule {
@@ -896,30 +720,9 @@ export declare type DraftTransaction = {
 export declare class DraftTransferTx {
     private readonly suiClient;
     constructor(suiClient: SuiGrpcClient);
-    /**
-     * Validates private key against expected sender address
-     * @private
-     */
     private validatePrivateKey;
-    /**
-     * Creates a draft transaction for SUI transfer
-     * @param params - Transfer parameters
-     * @returns Draft transaction object with encoded transaction data
-     * @throws {Error} If validation fails or transaction building fails
-     */
     createDraft(sender: string, recipient: string, amountMIST: bigint): Promise<DraftTransaction>;
-    /**
-     * Executes a draft transaction on the Sui network
-     * @param draftTx - Draft transaction to execute
-     * @param privateKey - Sender's private key
-     * @returns Execution result with success status and transaction details
-     */
     execute(draftTx: DraftTransaction, privateKey: string): Promise<ExecutionResult>;
-    /**
-     * Verifies the status of a transaction on the Sui network
-     * @param txDigest - Transaction digest to check
-     * @returns Transaction status: 'success', 'failure', or 'pending'
-     */
     getTransactionStatus(txDigest: string): Promise<TransactionStatus>;
 }
 
@@ -1053,27 +856,10 @@ export declare type FinalTradeRoute = {
     routes: TradeRoute[];
 };
 
-/**
- * FlowX DEX aggregator client for routing trades across multiple pools
- * FlowX provides liquidity aggregation and optimized routing for Sui ecosystem
- */
 export declare class FlowXAggregator {
-    /** Configuration settings for the aggregator */
     private _config;
-    /** Sui blockchain client */
     private _suiClient;
-    /**
-     * Creates a new FlowXAggregator instance
-     * @param config - Aggregator configuration including fee settings and optional API key
-     * @param suiClient - Sui client for blockchain interactions
-     */
     constructor(config: FlowXAggregatorConfig, suiClient: SuiGrpcClient);
-    /**
-     * Creates a commission configuration for FlowX trades
-     * @param coinInType - Type/address of the input coin for commission calculation
-     * @param tradeFee - Optional custom trade fee settings for this commission
-     * @returns Commission instance configured with fee recipient, percentage, and coin type
-     */
     private getCommission;
     /**
      * Finds the optimal trade route for swapping tokens using FlowX aggregator
@@ -1084,7 +870,7 @@ export declare class FlowXAggregator {
      * @param params.metaAggregator - If true, only meta-supported DEXs are used and no extra commission is applied
      * @returns Promise resolving to routes result with pricing and path information, or null if no route found
      */
-    getTradeRoute({ coinInAmount, coinInType, coinOutType, tradeFee, metaAggregator, supportedProtocols, }: GetTradeRouteRequest_6 & {
+    getTradeRoute({ coinInAmount, coinInType, coinOutType, tradeFee, metaAggregator, supportedProtocols, }: GetTradeRouteRequest_5 & {
         supportedProtocols?: Protocol[];
     }): Promise<GetRoutesResult<Coin, Coin> | null>;
     /**
@@ -1095,20 +881,15 @@ export declare class FlowXAggregator {
      * @param params.slippage - Maximum acceptable slippage (e.g., 0.01 for 1%)
      * @returns Promise resolving to built transaction bytes ready for signing and execution
      */
-    getTransaction({ walletAddress, completeRoute, slippage, tradeFee, metaAggregator, }: GetTransactionRequest_5): Promise<Uint8Array>;
+    getTransaction({ walletAddress, completeRoute, slippage, tradeFee, metaAggregator, }: GetTransactionRequest_4): Promise<Uint8Array>;
 }
 
 export declare namespace FlowXAggregator {
     export function toCommonTradeRoutes(tradeRoute: GetRoutesResult<Coin, Coin>): FinalTradeRoute | null;
 }
 
-/**
- * Configuration options for the FlowX aggregator
- */
 export declare type FlowXAggregatorConfig = {
-    /** Default trade fee settings applied to each trade */
     defaultTradeFee: TradeFeeOptions;
-    /** Optional API key for FlowX aggregator access */
     flowxApiKey?: string;
 };
 
@@ -1314,226 +1095,133 @@ export declare type GetSuiAmountAfterSellParams = {
     frontendFee?: number | string;
 };
 
-/**
- * Request parameters for getting a trade route from an aggregator
- */
 export declare type GetTradeRouteRequest = {
-    /** Amount of input coin to trade (in smallest unit) */
+    /** Input amount in the coin's smallest unit (base-units, not decimals) */
     coinInAmount: bigint;
-    /** Type/address of the input coin */
     coinInType: string;
-    /** Type/address of the output coin */
     coinOutType: string;
-    /** Custom trade fee for this request, if not provided, the default trade fee will be applied */
+    /** Overrides the SDK's default trade fee for this request */
     tradeFee?: TradeFeeOptions;
-    /** If true, only meta-supported aggregators/protocols will be used without extra aggregator fees */
+    /** Restrict to meta-supported aggregators, charging no extra aggregator fee */
     metaAggregator?: boolean;
 };
 
-/**
- * Request parameters for getting a trade route
- */
 declare type GetTradeRouteRequest_2 = {
-    /** Amount of input coin to trade (in smallest unit) */
+    /** coinInAmount is in the input coin's smallest unit (base units, not decimals). */
     coinInAmount: bigint;
-    /** Type/address of the input coin */
     coinInType: string;
-    /** Type/address of the output coin */
     coinOutType: string;
-    /** Custom trade fee for this request, if not provided, the default trade fee will be applied */
+    /** Overrides defaultTradeFee for this request only. */
     tradeFee?: TradeFeeOptions;
-    /** If true, only meta-supported DEXs will be used and no extra commission should be applied */
+    /** When true, restrict to meta-supported DEXs and charge no commission (the meta-aggregator adds its own overlay fee). */
     metaAggregator?: boolean;
 };
 
-/**
- * Request parameters for getting a trade route
- */
 declare type GetTradeRouteRequest_3 = {
-    /** Amount of input coin to trade (in smallest unit) */
+    /** coinInAmount is in the input coin's smallest unit (base units, not decimals). */
     coinInAmount: bigint;
-    /** Type/address of the input coin */
     coinInType: string;
-    /** Type/address of the output coin */
     coinOutType: string;
-    /** Custom trade fee for this request, if not provided, the default trade fee will be applied */
+    /** Overrides defaultTradeFee for this request only. */
     tradeFee?: TradeFeeOptions;
 };
 
-/**
- * Request parameters for getting a trade route
- */
 declare type GetTradeRouteRequest_4 = {
-    /** Amount of input coin to trade (in smallest unit) */
-    coinInAmount: bigint;
-    /** Type/address of the input coin */
-    coinInType: string;
-    /** Type/address of the output coin */
-    coinOutType: string;
-    /** Custom trade fee for this request, if not provided, the default trade fee will be applied */
-    tradeFee?: TradeFeeOptions;
-};
-
-/**
- * Request parameters for getting a trade route
- */
-declare type GetTradeRouteRequest_5 = {
-    /** Amount of input coin to trade (in smallest unit) */
+    /** coinInAmount is in the input coin's smallest unit (base units, not decimals). */
     coinInAmount: bigint;
-    /** Type/address of the input coin */
     coinInType: string;
-    /** Type/address of the output coin */
     coinOutType: string;
-    /** Custom trade fee for this request, if not provided, the default trade fee will be applied */
+    /** Overrides defaultTradeFee for this request only. */
     tradeFee?: TradeFeeOptions;
-    /** If true, only some supported protocols will be used */
+    /** When true, restrict to meta-supported protocols and add no overlay fee (the meta-aggregator owns the fee). */
     metaAggregator?: boolean;
 };
 
-/**
- * Request parameters for getting a trade route
- */
-declare type GetTradeRouteRequest_6 = {
-    /** Amount of input coin to trade (in smallest unit) */
+declare type GetTradeRouteRequest_5 = {
+    /** coinInAmount is in the input coin's smallest unit (base units, not decimals). */
     coinInAmount: bigint;
-    /** Type/address of the input coin */
     coinInType: string;
-    /** Type/address of the output coin */
     coinOutType: string;
-    /** Custom trade fee for this request, if not provided, the default trade fee will be applied */
+    /** Overrides defaultTradeFee for this request only. */
     tradeFee?: TradeFeeOptions;
-    /** If true, only some supported DEXs will be used */
+    /** When true, restrict to meta-supported DEXs and charge no commission (the meta-aggregator owns the fee). */
     metaAggregator?: boolean;
 };
 
-/**
- * Response from getting a trade route, containing both standardized and raw route data
- */
 export declare type GetTradeRouteResponse = {
-    /** The standardized trade route information across all aggregators */
     route: FinalTradeRoute;
-    /** The raw route response from the specific aggregator (format varies by aggregator) */
+    /** Raw aggregator response; shape varies per aggregator, passed back to build the tx */
     aggregatorRoute: any;
 };
 
 export declare type GetTradeTransactionRequest = {
-    /** Amount of input coin to trade (in smallest unit) */
+    /** Input amount in the coin's smallest unit (base-units, not decimals) */
     coinInAmount: bigint;
-    /** Type/address of the input coin */
     coinInType: string;
-    /** Type/address of the output coin */
     coinOutType: string;
-    /** Wallet address that will execute the transaction */
     walletAddress: string;
-    /** Slippage tolerance as decimal (e.g., 0.01 for 1%) */
+    /** Slippage tolerance as decimal (e.g. 0.01 for 1%) */
     slippage: number;
-    /** Custom trade fee for this request, if not provided, the default trade fee will be applied */
+    /** Overrides the SDK's default trade fee for this request */
     tradeFee?: TradeFeeOptions;
-    /** If true, only meta-supported aggregators/protocols will be used without extra aggregator fees */
+    /** Restrict to meta-supported aggregators, charging no extra aggregator fee */
     metaAggregator?: boolean;
-    /** The bonding curve Pool ID */
     poolId: string;
 };
 
-/**
- * Response from getting both route and transaction, containing route info and built transaction
- */
 export declare type GetTradeTransactionResponse = {
-    /** The standardized trade route information */
     route: FinalTradeRoute;
-    /** The raw route response from the aggregator */
     aggregatorRoute: any;
-    /** The built transaction bytes ready for signing and execution */
+    /** Built transaction bytes ready for signing and execution */
     transaction: Uint8Array;
 };
 
-/**
- * Request parameters for building a transaction from an existing route
- */
 export declare type GetTransactionByRouteRequest = {
-    /** Wallet address that will execute the transaction */
     walletAddress: string;
-    /** Complete trade route from aggregator router (raw aggregator response) */
+    /** Raw aggregator response from a prior getTradeRoute call */
     completeRoute: any;
-    /** Slippage tolerance as decimal (e.g., 0.01 for 1%) */
+    /** Slippage tolerance as decimal (e.g. 0.01 for 1%) */
     slippage: number;
-    /** Custom trade fee for this request, if not provided, the default trade fee will be applied */
+    /** Overrides the SDK's default trade fee for this request */
     tradeFee?: TradeFeeOptions;
-    /** If true, no extra aggregator fee will be applied for Cetus, FlowX, and 7K routes */
+    /** Skip the extra aggregator fee on Cetus, FlowX, and 7K routes */
     metaAggregator?: boolean;
 };
 
-/**
- * Request parameters for getting a transaction
- */
 declare type GetTransactionRequest = {
-    /** Wallet address that will execute the transaction */
     walletAddress: string;
-    /** Complete quote response from 7K Protocol */
     completeRoute: QuoteResponse;
-    /** Slippage tolerance (e.g., 0.01 for 1%) */
+    /** Slippage tolerance as a fraction, e.g. 0.01 for 1%. */
     slippage: number;
-    /** Custom trade fee for this request, if not provided, the default trade fee will be applied */
     tradeFee?: TradeFeeOptions;
-    /** If true, no extra commission should be applied */
+    /** When true, charge no commission (the meta-aggregator owns the fee). */
     metaAggregator?: boolean;
 };
 
-/**
- * Request parameters for getting a transaction
- */
 declare type GetTransactionRequest_2 = {
-    /** Wallet address that will execute the transaction */
     walletAddress: string;
-    /** Complete trade route from Aftermath router */
     completeRoute: RouterCompleteTradeRoute;
-    /** Slippage tolerance (e.g., 0.01 for 1%) */
+    /** Slippage tolerance as a fraction, e.g. 0.01 for 1%. */
     slippage: number;
 };
 
-/**
- * Request parameters for getting a transaction
- */
 declare type GetTransactionRequest_3 = {
-    /** Wallet address that will execute the transaction */
-    walletAddress: string;
-    /** Complete quote from Astros aggregator */
-    completeRoute: Quote;
-    /** Slippage tolerance (e.g., 0.01 for 1%) */
-    slippage: number;
-    /** Custom trade fee for this request, if not provided, the default trade fee will be applied */
-    tradeFee?: TradeFeeOptions;
-};
-
-/**
- * Request parameters for getting a transaction
- */
-declare type GetTransactionRequest_4 = {
-    /** Wallet address that will execute the transaction */
     walletAddress: string;
-    /** Complete router data from Cetus aggregator */
     completeRoute: RouterDataV3;
-    /** Slippage tolerance (e.g., 0.01 for 1%) */
+    /** Slippage tolerance as a fraction, e.g. 0.01 for 1%. */
     slippage: number;
-    /** Custom trade fee for this request, if not provided, the default trade fee will be applied */
     tradeFee?: TradeFeeOptions;
-    /** If true, no extra overlay fee should be applied */
+    /** When true, add no overlay fee (the meta-aggregator owns the fee). */
     metaAggregator?: boolean;
 };
 
-/**
- * Request parameters for getting a transaction
- */
-declare type GetTransactionRequest_5 = {
-    /** Wallet address that will execute the transaction */
+declare type GetTransactionRequest_4 = {
     walletAddress: string;
-    /** Complete routes result from FlowX aggregator */
     completeRoute: GetRoutesResult<Coin, Coin>;
-    /** Slippage tolerance (e.g., 0.01 for 1%) */
+    /** Slippage tolerance as a fraction, e.g. 0.01 for 1%. */
     slippage: number;
-    /** Custom trade fee for this request, if not provided, the default trade fee will be applied */
     tradeFee?: TradeFeeOptions;
-    /** If true, no extra commission should be applied */
+    /** When true, charge no commission (the meta-aggregator owns the fee). */
     metaAggregator?: boolean;
 };
 
@@ -2018,8 +1706,20 @@ export declare namespace Scallop {
     const MARKET_OBJ_ID = "0xa757975255146dc9686aa823b7838b507f315d704f428cbadad2f4ea061939d9";
 }
 
+/**
+ * Sui clients used by the SDK.
+ *
+ * `grpc` is required. `jsonRpc` is optional — when omitted, the SDK creates a
+ * default JSON-RPC client against the public Sui fullnode for the SDK network.
+ * (JSON-RPC is still required by third-party SDKs such as Aftermath and Pyth.)
+ */
+export declare type SdkClients = {
+    grpc: SuiGrpcClient;
+    jsonRpc?: SuiJsonRpcClient;
+};
+
 export declare type SdkOptions = {
-    clients: SuiClients;
+    clients: SdkClients;
     tradeFee: TradeFeeOptions;
     /** Optional API key for Astros aggregator access */
     astrosApiKey?: string;
@@ -2064,20 +1764,9 @@ export declare type SetPausedRequest = {
     currentTx?: Transaction;
 };
 
-/**
- * 7K Protocol DEX aggregator client for routing trades across multiple pools
- * 7K Protocol aggregates liquidity from various DEXs to find optimal trade routes
- */
 export declare class SevenKAggregator {
-    /** Configuration settings for the aggregator */
     private _config;
-    /** Sui blockchain client */
     private _suiClient;
-    /**
-     * Creates a new SevenKAggregator instance
-     * @param config - Aggregator configuration including fee settings and optional API key
-     * @param suiClient - Sui client for blockchain interactions
-     */
     constructor(config: SevenKAggregatorConfig, suiClient: SuiGrpcClient);
     /**
      * Finds the optimal trade route for swapping tokens using 7K Protocol
@@ -2106,13 +1795,8 @@ export declare namespace SevenKAggregator {
     export function toCommonTradeRoutes(tradeRouteResponse: QuoteResponse): FinalTradeRoute | null;
 }
 
-/**
- * Configuration options for the 7K Protocol aggregator
- */
 export declare type SevenKAggregatorConfig = {
-    /** Default trade fee settings applied to each trade */
     defaultTradeFee: TradeFeeOptions;
-    /** Optional API key for 7K Protocol access */
     sevenKApiKey?: string;
 };
 
@@ -2230,13 +1914,7 @@ export declare type SubscriptionConfig = {
  * - Updating fee receiver wallet and pause settings
  */
 export declare class SubscriptionModule implements IPayModule {
-    /** Reference to the main SDK instance */
     sdk: NoodlesPaySdk;
-    /**
-     * Creates a new SubscriptionModule instance.
-     *
-     * @param sdk - The main Noodles Pay SDK instance
-     */
     constructor(sdk: NoodlesPaySdk);
     /**
      * Retrieves the current subscription configuration from the blockchain.
@@ -2247,7 +1925,8 @@ export declare class SubscriptionModule implements IPayModule {
     getConfig(): Promise<SubscriptionConfig>;
     /**
      * Builds a transaction for subscribing to a plan.
-     * The payment amount is determined by the plan configuration.
+     * The payment amount is determined by the plan configuration (plan.price charged for
+     * every month in the plan's interval).
      *
      * @param request - Subscription request parameters
      * @reference order_id generated from your backend to identify the purchase
@@ -2257,6 +1936,7 @@ export declare class SubscriptionModule implements IPayModule {
     buildSubscribeCyclePlanTx({ walletAddress, planId, reference, paymentCoinType, currentTx, }: SubscribePlanRequest): Promise<Transaction>;
     /**
      * Builds a transaction for buying additional compute units (CU) for CUAddOn plans.
+     * Tops up compute units for an arbitrary paidAmount.
      *
      * @param request - Buy more CU request parameters
      * @reference order_id generated from your backend to identify the purchase
@@ -2358,8 +2038,12 @@ export declare const SUI_ADDRESS_ZERO = "0x0000000000000000000000000000000000000
 
 export declare const SUI_FULL_TYPE = "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI";
 
+export declare const SUI_GRAPHQL_URL = "https://graphql.mainnet.sui.io/graphql";
+
 export declare const SUI_METADATA_OBJECT_ID = "0x9258181f5ceac8dbffb7030890243caed69a9599d2886d957a9cb7656af3bdb3";
 
+export declare const SUI_RPC_URL = "https://fullnode.mainnet.sui.io:443";
+
 export declare const SUI_TYPE = "0x2::sui::SUI";
 
 export declare type SuiClient = SuiGrpcClient;
@@ -2378,7 +2062,6 @@ export { SuiJsonRpcClient }
 export declare type SuiNetwork = SuiClientTypes.Network;
 
 export declare enum SupportedAggregator {
-    ASTROS = "ASTROS",
     AFTERMATH = "AFTERMATH",
     SEVENK = "7K",
     CETUS = "CETUS",
@@ -2406,13 +2089,9 @@ export declare type TierInfo = {
 
 export declare const timeout: <T = any>(fn: () => Promise<T>, timeout: number, msg?: string) => Promise<T>;
 
-/**
- * Configuration options for trade fees applied to aggregator transactions
- */
 export declare type TradeFeeOptions = {
-    /** Trade fee percentage as a decimal (e.g., 0.01 for 1%, 0.003 for 0.3%) */
+    /** Decimal fraction, not bps: 0.01 = 1%, 0.003 = 0.3% */
     tradeFeePercent: number;
-    /** Address that will receive the trade fees */
     tradeFeeRecipientAddress: string;
 };