@cheqd/sdk-esm 5.3.7-develop.1 → 5.4.0-develop.1

package/build/cjs/src/modules/feemarket.d.ts

@@ -0,0 +1,244 @@
+import { GasPriceResponse, GasPricesResponse, ParamsResponse } from '@cheqd/ts-proto-cjs/feemarket/feemarket/v1/index.js';
+import { EncodeObject, GeneratedType } from '@cosmjs/proto-signing-cjs';
+import { GasPrice, QueryClient } from '@cosmjs/stargate-cjs';
+import { AbstractCheqdSDKModule, MinimalImportableCheqdSDKModule } from './_';
+import { DidStdFee, IContext, QueryExtensionSetup } from '../types';
+import { CheqdQuerier } from '../querier';
+import { CheqdSigningStargateClient } from '../signer';
+/** Default extension key for fee market-related query operations */
+export declare const defaultFeemarketExtensionKey: "feemarket";
+/**
+ * Protobuf message type literals for fee market operations.
+ * Used for consistent message type identification across the module.
+ */
+export declare const protobufLiterals: {
+    /** Gas price response message type */
+    readonly GasPriceResponse: "GasPriceResponse";
+    /** Gas prices response message type */
+    readonly GasPricesResponse: "GasPricesResponse";
+    /** Parameters response message type */
+    readonly ParamsResponse: "ParamsResponse";
+};
+/** Type URL for GasPriceResponse messages */
+export declare const typeUrlGasPriceResponse: "/feemarket.feemarket.v1.GasPriceResponse";
+/** Type URL for GasPricesResponse messages */
+export declare const typeUrlGasPricesResponse: "/feemarket.feemarket.v1.GasPricesResponse";
+/** Type URL for ParamsResponse messages */
+export declare const typeUrlParamsResponse: "/feemarket.feemarket.v1.ParamsResponse";
+/**
+ * Default gas price tier names for fee calculation.
+ * Provides predefined tiers for different transaction priority levels.
+ */
+export declare const defaultGasPriceTiers: {
+    /** Low priority tier with lowest gas prices */
+    readonly Low: "DefaultLowTier";
+    /** Average priority tier with moderate gas prices */
+    readonly Avg: "DefaultAvgTier";
+    /** High priority tier with highest gas prices */
+    readonly High: "DefaultHighTier";
+};
+/** Type representing the available default gas price tiers */
+/** Type representing the available default gas price tiers */
+export type DefaultGasPriceTiers = (typeof defaultGasPriceTiers)[keyof typeof defaultGasPriceTiers];
+/**
+ * Encode object interface for GasPriceResponse messages.
+ * Used for type-safe message encoding in gas price operations.
+ */
+export interface GasPriceEncodeObject extends EncodeObject {
+    readonly typeUrl: typeof typeUrlGasPriceResponse;
+    readonly value: Partial<GasPriceResponse>;
+}
+/**
+ * Type guard function to check if an object is a GasPriceEncodeObject.
+ *
+ * @param obj - EncodeObject to check
+ * @returns True if the object is a GasPriceEncodeObject
+ */
+export declare function isGasPriceEncodeObject(obj: EncodeObject): obj is GasPriceEncodeObject;
+/**
+ * Encode object interface for GasPricesResponse messages.
+ * Used for type-safe message encoding in gas prices query operations.
+ */
+export interface GasPricesEncodeObject extends EncodeObject {
+    readonly typeUrl: typeof typeUrlGasPricesResponse;
+    readonly value: Partial<GasPricesResponse>;
+}
+/**
+ * Type guard function to check if an object is a GasPricesEncodeObject.
+ *
+ * @param obj - EncodeObject to check
+ * @returns True if the object is a GasPricesEncodeObject
+ */
+export declare function isGasPricesEncodeObject(obj: EncodeObject): obj is GasPricesEncodeObject;
+/**
+ * Encode object interface for ParamsResponse messages.
+ * Used for type-safe message encoding in parameter query operations.
+ */
+export interface ParamsEncodeObject extends EncodeObject {
+    readonly typeUrl: typeof typeUrlParamsResponse;
+    readonly value: Partial<ParamsResponse>;
+}
+/**
+ * Type guard function to check if an object is a ParamsEncodeObject.
+ *
+ * @param obj - EncodeObject to check
+ * @returns True if the object is a ParamsEncodeObject
+ */
+export declare function isParamsEncodeObject(obj: EncodeObject): obj is ParamsEncodeObject;
+/** Minimal importable version of the fee market module for clean external interfaces */
+export type MinimalImportableFeemarketModule = MinimalImportableCheqdSDKModule<FeemarketModule>;
+/**
+ * Fee market extension interface for querier functionality.
+ * Provides methods for querying gas prices and fee market parameters.
+ */
+export type FeemarketExtension = {
+    readonly [defaultFeemarketExtensionKey]: {
+        /** Query gas price for a specific denomination */
+        readonly gasPrice: (denom: string) => Promise<GasPriceResponse>;
+        /** Query all available gas prices */
+        readonly gasPrices: () => Promise<GasPricesResponse>;
+        /** Query fee market module parameters */
+        readonly params: () => Promise<ParamsResponse>;
+    };
+};
+/**
+ * Sets up the fee market extension for the querier client.
+ * Creates and configures the fee market-specific query methods.
+ *
+ * @param base - Base QueryClient to extend
+ * @returns Configured fee market extension with query methods
+ */
+export declare const setupFeemarketExtension: (base: QueryClient) => FeemarketExtension;
+/**
+ * Fee Market Module class providing comprehensive fee market functionality.
+ * Handles gas price queries, dynamic fee calculation, and fee market parameter management.
+ */
+export declare class FeemarketModule extends AbstractCheqdSDKModule {
+    static readonly registryTypes: Iterable<[string, GeneratedType]>;
+    /**
+     * Default gas prices for different priority tiers.
+     * Used as fallback when live gas price queries are unavailable.
+     */
+    static readonly defaultGasPrices: {
+        DefaultLowTier: {
+            amount: string;
+            denom: string;
+        };
+        DefaultAvgTier: {
+            amount: string;
+            denom: string;
+        };
+        DefaultHighTier: {
+            amount: string;
+            denom: string;
+        };
+    };
+    /** Gas offset factor used for adjusting live gas prices */
+    static readonly gasOffsetFactor: number;
+    /** Address of the fee collector account that receives transaction fees */
+    static readonly feeCollectorAddress: "cheqd13pxn9n3qw79e03844rdadagmg0nshmwfszqu0g";
+    /** Address of the fee market module account */
+    static readonly moduleAccountAddress: "cheqd1el68mjnzv87uurqks8u29tec0cj3297047g2dl";
+    /** Querier extension setup function for fee market operations */
+    static readonly querierExtensionSetup: QueryExtensionSetup<FeemarketExtension>;
+    /** Querier instance with fee market extension capabilities */
+    /** Querier instance with fee market extension capabilities */
+    querier: CheqdQuerier & FeemarketExtension;
+    /**
+     * Constructs a new fee market module instance.
+     *
+     * @param signer - Signing client for blockchain transactions
+     * @param querier - Querier client with fee market extension for data retrieval
+     */
+    constructor(signer: CheqdSigningStargateClient, querier: CheqdQuerier & FeemarketExtension);
+    /**
+     * Gets the registry types for fee market message encoding/decoding.
+     *
+     * @returns Iterable of [typeUrl, GeneratedType] pairs for the registry
+     */
+    getRegistryTypes(): Iterable<[string, GeneratedType]>;
+    /**
+     * Gets the querier extension setup for fee market operations.
+     *
+     * @returns Query extension setup function for fee market functionality
+     */
+    getQuerierExtensionSetup(): QueryExtensionSetup<FeemarketExtension>;
+    /**
+     * Queries the current gas price for a specific denomination.
+     * Retrieves live gas price data from the fee market module.
+     *
+     * @param denom - Token denomination to query gas price for
+     * @param context - Optional SDK context for accessing clients
+     * @returns Promise resolving to the gas price response
+     */
+    queryGasPrice(denom: string, context?: IContext): Promise<GasPriceResponse>;
+    /**
+     * Queries all available gas prices from the fee market.
+     * Retrieves comprehensive gas pricing information for all denominations.
+     *
+     * @param context - Optional SDK context for accessing clients
+     * @returns Promise resolving to the gas prices response
+     */
+    queryGasPrices(context?: IContext): Promise<GasPricesResponse>;
+    /**
+     * Queries the fee market module parameters.
+     * Retrieves configuration settings for the fee market functionality.
+     *
+     * @param context - Optional SDK context for accessing clients
+     * @returns Promise resolving to the parameters response
+     */
+    queryParams(context?: IContext): Promise<ParamsResponse>;
+    /**
+     * Generates gas price for a denomination by live polling the fee market.
+     * Queries current gas prices and adjusts them using the gas offset factor.
+     * Throws an error if live polling fails.
+     *
+     * @param denom - Token denomination to generate gas price for
+     * @param context - Optional SDK context for accessing clients
+     * @returns Promise resolving to the calculated gas price
+     * @throws Error if live poll for gas price fails or returns invalid data
+     */
+    generateGasPrice(denom: string, context?: IContext): Promise<GasPrice>;
+    /**
+     * Generates offline gas price for a denomination using static tier pricing.
+     * Uses predefined gas prices as fallback when live polling is unavailable.
+     *
+     * @param denom - Token denomination to generate gas price for
+     * @param tier - Priority tier for gas price calculation (defaults to Low)
+     * @returns Promise resolving to the static gas price
+     * @throws Error if denomination or tier is invalid
+     */
+    generateOfflineGasPrice(denom: string, tier?: DefaultGasPriceTiers): Promise<GasPrice>;
+    /**
+     * Generates safe gas price with automatic fallback to offline pricing.
+     * Attempts live polling first, falls back to static tier pricing if it fails.
+     *
+     * @param denom - Token denomination to generate gas price for
+     * @param tier - Priority tier for fallback gas price calculation (defaults to Low)
+     * @param context - Optional SDK context for accessing clients
+     * @returns Promise resolving to the gas price (live or fallback)
+     */
+    generateSafeGasPrice(denom: string, tier?: DefaultGasPriceTiers, context?: IContext): Promise<GasPrice>;
+    /**
+     * Generates safe gas price with exponential backoff retry mechanism.
+     * Retries live polling with exponential backoff before falling back to offline pricing.
+     *
+     * @param denom - Token denomination to generate gas price for
+     * @param tier - Priority tier for fallback gas price calculation (defaults to Low)
+     * @param backoffOptions - Retry configuration options (defaults to DefaultBackoffOptions)
+     * @param context - Optional SDK context for accessing clients
+     * @returns Promise resolving to the gas price (live with retries or fallback)
+     */
+    generateSafeGasPriceWithExponentialBackoff(denom: string, tier?: DefaultGasPriceTiers, backoffOptions?: Partial<import("exponential-backoff").IBackOffOptions>, context?: IContext): Promise<GasPrice>;
+    /**
+     * Generates transaction fees from a given gas price.
+     * Calculates the total fee amount based on gas price and gas limit.
+     *
+     * @param gasPrice - Gas price to use for fee calculation
+     * @param payer - Address of the account paying the transaction fees
+     * @param gas - Gas limit for the transaction (defaults to '200000')
+     * @returns Standard fee configuration for the transaction
+     */
+    static generateFeesFromGasPrice(gasPrice: GasPrice, payer: string, gas?: string): DidStdFee;
+}
+//# sourceMappingURL=feemarket.d.ts.map

package/build/cjs/src/modules/feemarket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feemarket.d.ts","sourceRoot":"","sources":["../../../../../cjs/src/modules/feemarket.ts"],"names":[],"mappings":"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"}

package/build/cjs/src/modules/feemarket.js

@@ -0,0 +1,297 @@
+import { GasPriceResponse, GasPricesResponse, ParamsResponse, QueryClientImpl, protobufPackage, } from '@cheqd/ts-proto-cjs/feemarket/feemarket/v1/index.js';
+import { createProtobufRpcClient, GasPrice } from '@cosmjs/stargate-cjs';
+import { AbstractCheqdSDKModule } from './_';
+import { DefaultBackoffOptions, retry } from '../utils';
+import { Decimal, Uint32 } from '@cosmjs/math-cjs';
+/** Default extension key for fee market-related query operations */
+export const defaultFeemarketExtensionKey = 'feemarket';
+/**
+ * Protobuf message type literals for fee market operations.
+ * Used for consistent message type identification across the module.
+ */
+export const protobufLiterals = {
+    /** Gas price response message type */
+    GasPriceResponse: 'GasPriceResponse',
+    /** Gas prices response message type */
+    GasPricesResponse: 'GasPricesResponse',
+    /** Parameters response message type */
+    ParamsResponse: 'ParamsResponse',
+};
+/** Type URL for GasPriceResponse messages */
+export const typeUrlGasPriceResponse = `/${protobufPackage}.${protobufLiterals.GasPriceResponse}`;
+/** Type URL for GasPricesResponse messages */
+export const typeUrlGasPricesResponse = `/${protobufPackage}.${protobufLiterals.GasPricesResponse}`;
+/** Type URL for ParamsResponse messages */
+export const typeUrlParamsResponse = `/${protobufPackage}.${protobufLiterals.ParamsResponse}`;
+/**
+ * Default gas price tier names for fee calculation.
+ * Provides predefined tiers for different transaction priority levels.
+ */
+export const defaultGasPriceTiers = {
+    /** Low priority tier with lowest gas prices */
+    Low: 'DefaultLowTier',
+    /** Average priority tier with moderate gas prices */
+    Avg: 'DefaultAvgTier',
+    /** High priority tier with highest gas prices */
+    High: 'DefaultHighTier',
+};
+/**
+ * Type guard function to check if an object is a GasPriceEncodeObject.
+ *
+ * @param obj - EncodeObject to check
+ * @returns True if the object is a GasPriceEncodeObject
+ */
+export function isGasPriceEncodeObject(obj) {
+    return obj.typeUrl === typeUrlGasPriceResponse;
+}
+/**
+ * Type guard function to check if an object is a GasPricesEncodeObject.
+ *
+ * @param obj - EncodeObject to check
+ * @returns True if the object is a GasPricesEncodeObject
+ */
+export function isGasPricesEncodeObject(obj) {
+    return obj.typeUrl === typeUrlGasPricesResponse;
+}
+/**
+ * Type guard function to check if an object is a ParamsEncodeObject.
+ *
+ * @param obj - EncodeObject to check
+ * @returns True if the object is a ParamsEncodeObject
+ */
+export function isParamsEncodeObject(obj) {
+    return obj.typeUrl === typeUrlParamsResponse;
+}
+/**
+ * Sets up the fee market extension for the querier client.
+ * Creates and configures the fee market-specific query methods.
+ *
+ * @param base - Base QueryClient to extend
+ * @returns Configured fee market extension with query methods
+ */
+export const setupFeemarketExtension = (base) => {
+    const rpc = createProtobufRpcClient(base);
+    const queryService = new QueryClientImpl(rpc);
+    return {
+        [defaultFeemarketExtensionKey]: {
+            gasPrice: async (denom) => {
+                return queryService.GasPrice({ denom });
+            },
+            gasPrices: async () => {
+                return queryService.GasPrices({});
+            },
+            params: async () => {
+                return queryService.Params({});
+            },
+        },
+    };
+};
+/**
+ * Fee Market Module class providing comprehensive fee market functionality.
+ * Handles gas price queries, dynamic fee calculation, and fee market parameter management.
+ */
+export class FeemarketModule extends AbstractCheqdSDKModule {
+    //@ts-expect-error underlying type `GeneratedType` is intentionally wider
+    static registryTypes = [
+        [typeUrlGasPriceResponse, GasPriceResponse],
+        [typeUrlGasPricesResponse, GasPricesResponse],
+        [typeUrlParamsResponse, ParamsResponse],
+    ];
+    /**
+     * Default gas prices for different priority tiers.
+     * Used as fallback when live gas price queries are unavailable.
+     */
+    static defaultGasPrices = {
+        [defaultGasPriceTiers.Low]: { amount: '5000', denom: 'ncheq' },
+        [defaultGasPriceTiers.Avg]: { amount: '7500', denom: 'ncheq' },
+        [defaultGasPriceTiers.High]: { amount: '10000', denom: 'ncheq' },
+    };
+    /** Gas offset factor used for adjusting live gas prices */
+    static gasOffsetFactor = 10 ** 4;
+    /** Address of the fee collector account that receives transaction fees */
+    static feeCollectorAddress = 'cheqd13pxn9n3qw79e03844rdadagmg0nshmwfszqu0g';
+    /** Address of the fee market module account */
+    static moduleAccountAddress = 'cheqd1el68mjnzv87uurqks8u29tec0cj3297047g2dl';
+    /** Querier extension setup function for fee market operations */
+    static querierExtensionSetup = setupFeemarketExtension;
+    /** Querier instance with fee market extension capabilities */
+    /** Querier instance with fee market extension capabilities */
+    querier;
+    /**
+     * Constructs a new fee market module instance.
+     *
+     * @param signer - Signing client for blockchain transactions
+     * @param querier - Querier client with fee market extension for data retrieval
+     */
+    constructor(signer, querier) {
+        super(signer, querier);
+        this.querier = querier;
+        this.methods = {
+            queryGasPrice: this.queryGasPrice.bind(this),
+            queryGasPrices: this.queryGasPrices.bind(this),
+            queryParams: this.queryParams.bind(this),
+            generateGasPrice: this.generateGasPrice.bind(this),
+            generateOfflineGasPrice: this.generateOfflineGasPrice.bind(this),
+            generateSafeGasPrice: this.generateSafeGasPrice.bind(this),
+            generateSafeGasPriceWithExponentialBackoff: this.generateSafeGasPriceWithExponentialBackoff.bind(this),
+        };
+    }
+    /**
+     * Gets the registry types for fee market message encoding/decoding.
+     *
+     * @returns Iterable of [typeUrl, GeneratedType] pairs for the registry
+     */
+    getRegistryTypes() {
+        return FeemarketModule.registryTypes;
+    }
+    /**
+     * Gets the querier extension setup for fee market operations.
+     *
+     * @returns Query extension setup function for fee market functionality
+     */
+    getQuerierExtensionSetup() {
+        return FeemarketModule.querierExtensionSetup;
+    }
+    /**
+     * Queries the current gas price for a specific denomination.
+     * Retrieves live gas price data from the fee market module.
+     *
+     * @param denom - Token denomination to query gas price for
+     * @param context - Optional SDK context for accessing clients
+     * @returns Promise resolving to the gas price response
+     */
+    async queryGasPrice(denom, context) {
+        if (!this.querier)
+            this.querier = context.sdk.querier;
+        return this.querier[defaultFeemarketExtensionKey].gasPrice(denom);
+    }
+    /**
+     * Queries all available gas prices from the fee market.
+     * Retrieves comprehensive gas pricing information for all denominations.
+     *
+     * @param context - Optional SDK context for accessing clients
+     * @returns Promise resolving to the gas prices response
+     */
+    async queryGasPrices(context) {
+        if (!this.querier)
+            this.querier = context.sdk.querier;
+        return this.querier[defaultFeemarketExtensionKey].gasPrices();
+    }
+    /**
+     * Queries the fee market module parameters.
+     * Retrieves configuration settings for the fee market functionality.
+     *
+     * @param context - Optional SDK context for accessing clients
+     * @returns Promise resolving to the parameters response
+     */
+    async queryParams(context) {
+        if (!this.querier)
+            this.querier = context.sdk.querier;
+        return this.querier[defaultFeemarketExtensionKey].params();
+    }
+    /**
+     * Generates gas price for a denomination by live polling the fee market.
+     * Queries current gas prices and adjusts them using the gas offset factor.
+     * Throws an error if live polling fails.
+     *
+     * @param denom - Token denomination to generate gas price for
+     * @param context - Optional SDK context for accessing clients
+     * @returns Promise resolving to the calculated gas price
+     * @throws Error if live poll for gas price fails or returns invalid data
+     */
+    async generateGasPrice(denom, context) {
+        if (!this.querier)
+            this.querier = context.sdk.querier;
+        // query gas price, bubble up error, no catch
+        const gasPrice = await this.queryGasPrice(denom, context);
+        // validate gas price
+        if (!gasPrice.price)
+            throw new Error('Invalid gas price: live poll for gas price failed');
+        // convert gas price through offset factor
+        const adjustedGasPrice = Decimal.fromAtomics(gasPrice.price.amount, 18)
+            .multiply(Uint32.fromString(FeemarketModule.gasOffsetFactor.toString()))
+            .toString();
+        // safe convert gas price to string
+        return GasPrice.fromString(`${adjustedGasPrice}${gasPrice.price.denom}`);
+    }
+    /**
+     * Generates offline gas price for a denomination using static tier pricing.
+     * Uses predefined gas prices as fallback when live polling is unavailable.
+     *
+     * @param denom - Token denomination to generate gas price for
+     * @param tier - Priority tier for gas price calculation (defaults to Low)
+     * @returns Promise resolving to the static gas price
+     * @throws Error if denomination or tier is invalid
+     */
+    async generateOfflineGasPrice(denom, tier = defaultGasPriceTiers.Low) {
+        // validate denom against default
+        if (!Object.values(FeemarketModule.defaultGasPrices).some((gp) => gp.denom === denom))
+            throw new Error(`Invalid denom: ${denom}`);
+        // validate tier against default
+        if (!Object.keys(FeemarketModule.defaultGasPrices).includes(tier))
+            throw new Error(`Invalid tier: ${tier}`);
+        // generate gas price
+        const gasPrice = FeemarketModule.defaultGasPrices[tier];
+        // safe convert gas price to string
+        return GasPrice.fromString(`${gasPrice.amount}${gasPrice.denom}`);
+    }
+    /**
+     * Generates safe gas price with automatic fallback to offline pricing.
+     * Attempts live polling first, falls back to static tier pricing if it fails.
+     *
+     * @param denom - Token denomination to generate gas price for
+     * @param tier - Priority tier for fallback gas price calculation (defaults to Low)
+     * @param context - Optional SDK context for accessing clients
+     * @returns Promise resolving to the gas price (live or fallback)
+     */
+    async generateSafeGasPrice(denom, tier = defaultGasPriceTiers.Low, context) {
+        if (!this.querier)
+            this.querier = context.sdk.querier;
+        try {
+            // generate gas price
+            return await this.generateGasPrice(denom, context);
+        }
+        catch (error) {
+            // generate offline gas price
+            return await this.generateOfflineGasPrice(denom, tier);
+        }
+    }
+    /**
+     * Generates safe gas price with exponential backoff retry mechanism.
+     * Retries live polling with exponential backoff before falling back to offline pricing.
+     *
+     * @param denom - Token denomination to generate gas price for
+     * @param tier - Priority tier for fallback gas price calculation (defaults to Low)
+     * @param backoffOptions - Retry configuration options (defaults to DefaultBackoffOptions)
+     * @param context - Optional SDK context for accessing clients
+     * @returns Promise resolving to the gas price (live with retries or fallback)
+     */
+    async generateSafeGasPriceWithExponentialBackoff(denom, tier = defaultGasPriceTiers.Low, backoffOptions = DefaultBackoffOptions, context) {
+        if (!this.querier)
+            this.querier = context.sdk.querier;
+        // live poll for gas price
+        const gasPrice = await retry(() => this.generateGasPrice(denom, context), backoffOptions);
+        // return, if applicable
+        if (gasPrice)
+            return gasPrice;
+        // otherwise, generate offline gas price
+        return await this.generateOfflineGasPrice(denom, tier);
+    }
+    /**
+     * Generates transaction fees from a given gas price.
+     * Calculates the total fee amount based on gas price and gas limit.
+     *
+     * @param gasPrice - Gas price to use for fee calculation
+     * @param payer - Address of the account paying the transaction fees
+     * @param gas - Gas limit for the transaction (defaults to '200000')
+     * @returns Standard fee configuration for the transaction
+     */
+    static generateFeesFromGasPrice(gasPrice, payer, gas = '200000') {
+        return {
+            amount: [{ denom: gasPrice.denom, amount: gasPrice.amount.multiply(Uint32.fromString(gas)).toString() }],
+            gas,
+            payer,
+        };
+    }
+}
+//# sourceMappingURL=feemarket.js.map

package/build/cjs/src/modules/feemarket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feemarket.js","sourceRoot":"","sources":["../../../../../cjs/src/modules/feemarket.ts"],"names":[],"mappings":"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"}