@elsoul/erpc-sdk 0.5.0 → 0.7.0

package/dist/index.d.ts

@@ -79,6 +79,206 @@ declare class AccountClient {
     getTokenBalance(options?: RpcSendOptions): Promise<TokenBalance>;
 }
 
+type TokenRepresentationKind = "native" | "issued" | "wrapped" | "bridged" | "unclassified";
+type TokenStandard = "native" | "erc20" | "spl-token" | "spl-token-2022";
+type TokenStatus = "active" | "legacy" | "winding-down" | "retired";
+type TokenStableCurrency = "USD" | "EUR" | "JPY" | null;
+interface TokenAsset {
+    readonly assetId: string;
+    readonly name: string;
+    readonly representationKind: TokenRepresentationKind;
+    readonly stableCurrency: TokenStableCurrency;
+    readonly underlyingAssetId: string | null;
+    readonly economicReferenceAssetId: string | null;
+}
+interface TokenDeployment {
+    readonly deploymentId: string;
+    readonly assetId: string;
+    readonly name: string;
+    readonly representationKind: TokenRepresentationKind;
+    readonly stableCurrency: TokenStableCurrency;
+    readonly underlyingAssetId: string | null;
+    readonly economicReferenceAssetId: string | null;
+    readonly chainId: TokenChainId;
+    readonly symbol: string;
+    readonly decimals: number;
+    readonly standard: TokenStandard;
+    readonly address: string | null;
+    readonly status: TokenStatus;
+    readonly replacedByDeploymentId: string | null;
+}
+interface TokenAlias {
+    readonly namespace: string;
+    readonly name: string;
+    readonly deploymentId: string;
+}
+declare const TOKEN_CATALOG_VERSION: "1.0.0";
+declare const TOKEN_CATALOG_AS_OF_DATE: "2026-09-15";
+declare const TOKEN_CATALOG_CONTENT_DIGEST: "28318f4f6a6bc2cdeef51368eeb17c86685c6f12d1723b0b4dd27f7e54d7235d";
+declare const TOKEN_CHAIN_IDS: {
+    readonly ethereumMainnet: "eip155:1";
+    readonly solanaMainnet: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+    readonly avalancheCMainnet: "eip155:43114";
+};
+type TokenChainId = (typeof TOKEN_CHAIN_IDS)[keyof typeof TOKEN_CHAIN_IDS];
+declare const tokens: Readonly<{
+    readonly avalancheC: {
+        readonly AUSD: "deployment-0035";
+        readonly AVAX: "deployment-0003";
+        readonly DISCOVERED_0A7F98C8752F15EE: "discovered-token-0a7f98c8752f15ee02ce0d801f25df8ff78864a1d70aff7e204f7bdb3f8a0692";
+        readonly DISCOVERED_1847342426B765AD: "discovered-token-1847342426b765add3c8b4feb724c6b15121f25097cb7917c967c285ca77e804";
+        readonly DISCOVERED_288036A90EE0FA72: "discovered-token-288036a90ee0fa72a2751a78a6934cc6ced9e16de91c97ae8e109e2ee6189bc5";
+        readonly DISCOVERED_323D07C442F0D089: "discovered-token-323d07c442f0d089197ae7eea9b3ebb829910177c5b780161a7623aaed5e4371";
+        readonly DISCOVERED_9F9965CC065C9BEC: "discovered-token-9f9965cc065c9becf8d2cb58071524baafea37d27fda9bf683a93ea85f2e653d";
+        readonly EURC: "deployment-0012";
+        readonly EUROP: "deployment-0045";
+        readonly GHO: "deployment-0030";
+        readonly JOE: "deployment-0059";
+        readonly JPYC: "deployment-0039";
+        readonly LINK: "deployment-0058";
+        readonly USDC: "deployment-0009";
+        readonly USDC_E: "deployment-0018";
+        readonly USDT: "deployment-0015";
+        readonly WAVAX: "deployment-0004";
+    };
+    readonly ethereum: {
+        readonly AAVE: "deployment-0056";
+        readonly AUSD: "deployment-0034";
+        readonly DAI: "deployment-0019";
+        readonly DISCOVERED_054D80A64E1F36A7: "discovered-token-054d80a64e1f36a756129763ca2f1e7a140b50b04c83876ff01dd5fd497a74c5";
+        readonly DISCOVERED_611597BD13DAA43D: "discovered-token-611597bd13daa43d01a23caa9cca6a98797c64be7fb5b2677370ddbcdeaf01ec";
+        readonly DISCOVERED_69519FD08E31445C: "discovered-token-69519fd08e31445cad84b0c17a5346b7ee9c5692e270602af9308ca6d8943bb6";
+        readonly DISCOVERED_B475569F6A15E97A: "discovered-token-b475569f6a15e97ac04e531dd813e9dcc902521c098d60d6ae4d21d53baf1395";
+        readonly DISCOVERED_E375086901067FE3: "discovered-token-e375086901067fe3de023bcdc70f1bafca798e1719ed7e676a98f57de3350a07";
+        readonly ETH: "deployment-0001";
+        readonly EURA: "deployment-0051";
+        readonly EURAU: "deployment-0042";
+        readonly EURC: "deployment-0011";
+        readonly EURCV: "deployment-0040";
+        readonly EURE: "deployment-0054";
+        readonly EURE_V1: "deployment-0053";
+        readonly EUROP: "deployment-0044";
+        readonly EURS: "deployment-0052";
+        readonly EURT: "deployment-0017";
+        readonly FDUSD: "deployment-0031";
+        readonly GHO: "deployment-0029";
+        readonly GYEN: "deployment-0047";
+        readonly JPYC: "deployment-0038";
+        readonly LINK: "deployment-0057";
+        readonly PYUSD: "deployment-0022";
+        readonly RLUSD: "deployment-0033";
+        readonly UNI: "deployment-0055";
+        readonly USDC: "deployment-0008";
+        readonly USDE: "deployment-0028";
+        readonly USDG: "deployment-0024";
+        readonly USDP: "deployment-0026";
+        readonly USDS: "deployment-0020";
+        readonly USDT: "deployment-0014";
+        readonly WETH: "deployment-0002";
+        readonly ZUSD: "deployment-0049";
+    };
+    readonly solana: {
+        readonly AUSD: "deployment-0036";
+        readonly EURAU: "deployment-0043";
+        readonly EURC: "deployment-0013";
+        readonly EURCV: "deployment-0041";
+        readonly EUROP: "deployment-0046";
+        readonly FDUSD: "deployment-0032";
+        readonly GYEN: "deployment-0048";
+        readonly JUP: "deployment-0060";
+        readonly JUPUSD: "deployment-0037";
+        readonly PYUSD: "deployment-0023";
+        readonly SOL: "deployment-0005";
+        readonly USDC: "deployment-0010";
+        readonly USDG: "deployment-0025";
+        readonly USDP: "deployment-0027";
+        readonly USDS: "deployment-0021";
+        readonly USDT: "deployment-0016";
+        readonly WSOL: "deployment-0006";
+        readonly WSOL_TOKEN_2022: "deployment-0007";
+        readonly ZUSD: "deployment-0050";
+    };
+}>;
+declare const TOKEN_ASSETS: readonly TokenAsset[];
+declare const TOKEN_DEPLOYMENTS: readonly TokenDeployment[];
+declare const TOKEN_ALIASES: readonly TokenAlias[];
+
+/** Stable currencies represented by the catalog's stablecoin metadata. */
+type StableCurrency = 'USD' | 'EUR' | 'JPY';
+interface ListTokenDeploymentsOptions {
+    readonly chainId?: TokenChainId;
+    readonly stableCurrency?: StableCurrency;
+}
+/**
+ * Return an asset by its opaque, exact asset ID.
+ *
+ * IDs are intentionally treated as opaque strings. No chain or symbol is
+ * inferred from the value.
+ */
+declare function getTokenAsset(assetId: string): TokenAsset | undefined;
+/** Return a deployment by its opaque, exact deployment ID. */
+declare function getTokenDeployment(deploymentId: string): TokenDeployment | undefined;
+/**
+ * List all catalog deployments, optionally restricted by chain and stable
+ * currency. Every status remains visible in the result.
+ */
+declare function listTokenDeployments(options?: ListTokenDeploymentsOptions): readonly TokenDeployment[];
+/**
+ * Find every exact-case symbol match on a chain, ordered by deployment ID.
+ */
+declare function findTokenDeploymentsBySymbol(chainId: TokenChainId, symbol: string): readonly TokenDeployment[];
+/**
+ * Find a deployment by address. EVM addresses are ASCII hex and are matched
+ * case-insensitively; Solana addresses are matched byte-for-byte as strings.
+ */
+declare function findTokenDeploymentByAddress(chainId: TokenChainId, address: string): TokenDeployment | undefined;
+/** Find the chain's native deployment. Native deployments use address null. */
+declare function getNativeTokenDeployment(chainId: TokenChainId): TokenDeployment | undefined;
+
+type TokenRankingMetric = 'onchain-total-supply-value-native' | 'global-circulating-market-cap-usd';
+type TokenRankingStatus = 'unconfigured' | 'complete' | 'partial';
+interface TokenRankingCoverage {
+    readonly chainId: string;
+    readonly totalDeployments: number;
+    readonly rankedDeployments: number;
+    readonly unrankedDeployments: number;
+    readonly observedAt: string | null;
+}
+interface TokenRankingMetadata {
+    readonly schemaVersion: 1;
+    readonly metric: TokenRankingMetric | null;
+    readonly asOf: string | null;
+    readonly contentDigest: string;
+    readonly status: TokenRankingStatus;
+    readonly coverage: readonly TokenRankingCoverage[];
+    readonly sourceIds: readonly string[];
+}
+interface TokenRanking {
+    readonly rank: number;
+    readonly chainId: string;
+    readonly deploymentIds: readonly string[];
+    readonly metric: TokenRankingMetric;
+    readonly valueNumerator: string;
+    readonly valueDenominator: string;
+    readonly quoteCurrency: 'native' | 'USD';
+    readonly quoteDeploymentId: string | null;
+    readonly observedAt: string;
+    readonly sourceId: string;
+    readonly sourceAssetId: string | null;
+}
+declare const TOKEN_RANKINGS_METADATA: TokenRankingMetadata;
+declare const TOKEN_RANKINGS: readonly TokenRanking[];
+declare const TOKEN_RANKINGS_CONTENT_DIGEST: string;
+declare const TOKEN_RANKINGS_BY_CHAIN: Readonly<Record<string, readonly TokenRanking[]>>;
+
+/**
+ * Return the bundled token rankings for an exact chain ID.
+ *
+ * Rankings are an offline snapshot. An unknown or empty chain ID is a safe,
+ * immutable empty result; no chain aliases or network lookups are inferred.
+ */
+declare function listTokenRankings(chainId: string): readonly TokenRanking[];
+
 type CloudResourceKind = 'bare-metal' | 'solana-grpc' | 'solana-shredstream' | 'vps';
 type CloudResourceMode = 'dedicated' | 'direct' | 'shared';
 /** A credential-free projection of an ERPC Cloud resource. */
@@ -226,6 +426,23 @@ declare class PriceClient {
     streamPriceUpdates(options: PriceStreamOptions, sendOptions?: RpcSendOptions): AsyncGenerator<PriceStreamEvent, void, undefined>;
 }
 
+interface HttpTransportConfig {
+    readonly apiKey: string;
+    readonly endpoint: URL;
+    readonly fetch: typeof globalThis.fetch;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly maxBatchSize?: number;
+    readonly timeoutMs: number;
+}
+declare class HttpJsonRpcTransport {
+    #private;
+    readonly endpoint: string;
+    readonly maxBatchSize: number;
+    constructor(config: HttpTransportConfig);
+    request<TResult>(method: string, params?: JsonRpcParams, options?: RpcSendOptions): Promise<TResult>;
+    batch<TResult extends readonly unknown[]>(calls: readonly RpcBatchCall[], options?: RpcSendOptions): Promise<TResult>;
+}
+
 interface JsonRpcTransport {
     readonly endpoint: string;
     readonly maxBatchSize: number;
@@ -370,6 +587,177 @@ interface EthereumClient {
     readonly rpc: RpcNamespace<EthereumRpcSchema>;
 }
 
+interface AvalancheEncodingParams {
+    readonly encoding?: string;
+}
+interface AvalancheUtxoParams extends AvalancheEncodingParams {
+    readonly addresses: readonly string[];
+    readonly limit?: number | string;
+    readonly sourceChain?: string;
+    readonly startIndex?: Readonly<Record<string, JsonValue>>;
+}
+interface AvalancheAvaxSchema {
+    readonly getAtomicTx: RpcMethodSpec<AvalancheEncodingParams & {
+        readonly txID: string;
+    }, JsonValue>;
+    readonly getAtomicTxStatus: RpcMethodSpec<{
+        readonly txID: string;
+    }, JsonValue>;
+    readonly getUTXOs: RpcMethodSpec<AvalancheUtxoParams & {
+        readonly sourceChain: string;
+    }, JsonValue>;
+    readonly issueTx: RpcMethodSpec<AvalancheEncodingParams & {
+        readonly tx: string;
+    }, JsonValue>;
+}
+interface AvalancheXChainSchema {
+    readonly buildGenesis: RpcMethodSpec<AvalancheEncodingParams & {
+        readonly genesisData: Readonly<Record<string, JsonValue>>;
+        readonly networkId: number | string;
+    }, JsonValue>;
+    readonly getAllBalances: RpcMethodSpec<{
+        readonly address: string;
+    }, JsonValue>;
+    readonly getAssetDescription: RpcMethodSpec<{
+        readonly assetID: string;
+    }, JsonValue>;
+    readonly getBalance: RpcMethodSpec<{
+        readonly address: string;
+        readonly assetID: string;
+    }, JsonValue>;
+    readonly getBlockByHeight: RpcMethodSpec<AvalancheEncodingParams & {
+        readonly height: number | string;
+    }, JsonValue>;
+    readonly getHeight: RpcMethodSpec<undefined, JsonValue>;
+    readonly getTx: RpcMethodSpec<AvalancheEncodingParams & {
+        readonly txID: string;
+    }, JsonValue>;
+    readonly getTxFee: RpcMethodSpec<undefined, JsonValue>;
+    readonly getTxStatus: RpcMethodSpec<{
+        readonly txID: string;
+    }, JsonValue>;
+    readonly getUTXOs: RpcMethodSpec<AvalancheUtxoParams, JsonValue>;
+    readonly issueTx: RpcMethodSpec<AvalancheEncodingParams & {
+        readonly tx: string;
+    }, JsonValue>;
+}
+interface AvalanchePChainSchema {
+    readonly getAllValidatorsAt: RpcMethodSpec<{
+        readonly height: number | string;
+    }, JsonValue>;
+    readonly getBalance: RpcMethodSpec<{
+        readonly addresses?: readonly string[];
+    }, JsonValue>;
+    readonly getBlockchainStatus: RpcMethodSpec<{
+        readonly blockchainID?: string;
+    }, JsonValue>;
+    readonly getBlockchains: RpcMethodSpec<undefined, JsonValue>;
+    readonly getCurrentSupply: RpcMethodSpec<undefined, JsonValue>;
+    readonly getCurrentValidators: RpcMethodSpec<{
+        readonly nodeIDs?: readonly string[];
+        readonly subnetID?: string;
+    }, JsonValue>;
+    readonly getFeeConfig: RpcMethodSpec<undefined, JsonValue>;
+    readonly getFeeState: RpcMethodSpec<undefined, JsonValue>;
+    readonly getHeight: RpcMethodSpec<undefined, JsonValue>;
+    readonly getMinStake: RpcMethodSpec<undefined, JsonValue>;
+    readonly getRewardUTXOs: RpcMethodSpec<AvalancheEncodingParams & {
+        readonly txID?: string;
+    }, JsonValue>;
+    readonly getStake: RpcMethodSpec<AvalancheEncodingParams & {
+        readonly addresses?: readonly string[];
+        readonly validatorsOnly?: boolean;
+    }, JsonValue>;
+    readonly getStakingAssetID: RpcMethodSpec<{
+        readonly subnetID?: string;
+    }, JsonValue>;
+    readonly getSubnets: RpcMethodSpec<{
+        readonly ids?: readonly string[];
+    }, JsonValue>;
+    readonly getTimestamp: RpcMethodSpec<undefined, JsonValue>;
+    readonly getTotalStake: RpcMethodSpec<{
+        readonly subnetID?: string;
+    }, JsonValue>;
+    readonly getTx: RpcMethodSpec<AvalancheEncodingParams & {
+        readonly txID: string;
+    }, JsonValue>;
+    readonly getTxStatus: RpcMethodSpec<{
+        readonly txID: string;
+    }, JsonValue>;
+    readonly getUTXOs: RpcMethodSpec<AvalancheUtxoParams, JsonValue>;
+    readonly getValidatorFeeConfig: RpcMethodSpec<undefined, JsonValue>;
+    readonly getValidatorFeeState: RpcMethodSpec<undefined, JsonValue>;
+    readonly getValidatorsAt: RpcMethodSpec<{
+        readonly height: number | string;
+        readonly subnetID?: string;
+    }, JsonValue>;
+    readonly issueTx: RpcMethodSpec<AvalancheEncodingParams & {
+        readonly tx: string;
+    }, JsonValue>;
+    readonly sampleValidators: RpcMethodSpec<{
+        readonly size: number | string;
+        readonly subnetID?: string;
+    }, JsonValue>;
+    readonly validatedBy: RpcMethodSpec<{
+        readonly blockchainID: string;
+    }, JsonValue>;
+    readonly validates: RpcMethodSpec<{
+        readonly subnetID: string;
+    }, JsonValue>;
+}
+interface AvalancheProposerVmSchema {
+    readonly getCurrentEpoch: RpcMethodSpec<undefined, JsonValue>;
+    readonly getProposedHeight: RpcMethodSpec<undefined, JsonValue>;
+}
+interface AvalancheInfoSchema {
+    readonly upgrades: RpcMethodSpec<undefined, JsonValue>;
+}
+interface AvalancheIndexSchema {
+    readonly getContainerByID: RpcMethodSpec<AvalancheEncodingParams & {
+        readonly id: string;
+    }, JsonValue>;
+    readonly getContainerByIndex: RpcMethodSpec<AvalancheEncodingParams & {
+        readonly index: number | string;
+    }, JsonValue>;
+    readonly getContainerRange: RpcMethodSpec<AvalancheEncodingParams & {
+        readonly numToFetch: number | string;
+        readonly startIndex: number | string;
+    }, JsonValue>;
+    readonly getIndex: RpcMethodSpec<AvalancheEncodingParams & {
+        readonly containerID: string;
+    }, JsonValue>;
+    readonly getLastAccepted: RpcMethodSpec<AvalancheEncodingParams, JsonValue>;
+    readonly isAccepted: RpcMethodSpec<AvalancheEncodingParams & {
+        readonly containerID: string;
+    }, JsonValue>;
+}
+declare const AVALANCHE_AVAX_METHODS: readonly ["avax.getAtomicTx", "avax.getAtomicTxStatus", "avax.getUTXOs", "avax.issueTx"];
+declare const AVALANCHE_X_CHAIN_METHODS: readonly ["avm.buildGenesis", "avm.getAllBalances", "avm.getAssetDescription", "avm.getBalance", "avm.getBlockByHeight", "avm.getHeight", "avm.getTx", "avm.getTxFee", "avm.getTxStatus", "avm.getUTXOs", "avm.issueTx"];
+declare const AVALANCHE_P_CHAIN_METHODS: readonly ["platform.getAllValidatorsAt", "platform.getBalance", "platform.getBlockchainStatus", "platform.getBlockchains", "platform.getCurrentSupply", "platform.getCurrentValidators", "platform.getFeeConfig", "platform.getFeeState", "platform.getHeight", "platform.getMinStake", "platform.getRewardUTXOs", "platform.getStake", "platform.getStakingAssetID", "platform.getSubnets", "platform.getTimestamp", "platform.getTotalStake", "platform.getTx", "platform.getTxStatus", "platform.getUTXOs", "platform.getValidatorFeeConfig", "platform.getValidatorFeeState", "platform.getValidatorsAt", "platform.issueTx", "platform.sampleValidators", "platform.validatedBy", "platform.validates"];
+declare const AVALANCHE_PROPOSER_VM_METHODS: readonly ["proposervm.getCurrentEpoch", "proposervm.getProposedHeight"];
+declare const AVALANCHE_INFO_METHODS: readonly ["info.upgrades"];
+declare const AVALANCHE_INDEX_METHODS: readonly ["index.getContainerByID", "index.getContainerByIndex", "index.getContainerRange", "index.getIndex", "index.getLastAccepted", "index.isAccepted"];
+interface AvalancheIndexClient {
+    readonly cChainBlocks: RpcNamespace<AvalancheIndexSchema>;
+    readonly pChainBlocks: RpcNamespace<AvalancheIndexSchema>;
+    readonly xChainBlocks: RpcNamespace<AvalancheIndexSchema>;
+    readonly xChainTransactions: RpcNamespace<AvalancheIndexSchema>;
+}
+interface AvalancheClient extends EthereumClient {
+    readonly avax: RpcNamespace<AvalancheAvaxSchema>;
+    readonly index: AvalancheIndexClient;
+    readonly info: RpcNamespace<AvalancheInfoSchema>;
+    readonly pChain: RpcNamespace<AvalanchePChainSchema>;
+    readonly proposerVm: RpcNamespace<AvalancheProposerVmSchema>;
+    readonly xChain: RpcNamespace<AvalancheXChainSchema>;
+}
+interface AvalancheIndexTransports {
+    readonly cChainBlocks: HttpJsonRpcTransport;
+    readonly pChainBlocks: HttpJsonRpcTransport;
+    readonly xChainBlocks: HttpJsonRpcTransport;
+    readonly xChainTransactions: HttpJsonRpcTransport;
+}
+
 type SolanaCommitment = 'confirmed' | 'finalized' | 'processed';
 type SolanaEncoding = 'base58' | 'base64' | 'base64+zstd' | 'jsonParsed';
 type SolanaConfig = Readonly<Record<string, unknown>>;
@@ -796,6 +1184,52 @@ declare class SolanaSubscriptions {
     rawSubscribe<TResult = unknown>(subscribeMethod: string, params: readonly unknown[], unsubscribeMethod: string, listener: SubscriptionListener<TResult>): Promise<RpcSubscription>;
 }
 
+type SwapQuoteErrorCode = 'SWAP_INVALID_ARGUMENT' | 'SWAP_UNSUPPORTED_CHAIN' | 'SWAP_UNKNOWN_POOL' | 'SWAP_UNKNOWN_TOKEN' | 'SWAP_TOKEN_NOT_ACTIVE' | 'SWAP_UNSUPPORTED_TOKEN_STANDARD' | 'SWAP_UNSUPPORTED_ADAPTER' | 'SWAP_UNSUPPORTED_TOKEN' | 'SWAP_CHAIN_MISMATCH' | 'SWAP_POOL_TOKEN_MISMATCH' | 'SWAP_PROGRAM_MISMATCH' | 'SWAP_INVALID_POOL_STATE' | 'SWAP_STATE_STALE' | 'SWAP_INSUFFICIENT_LIQUIDITY' | 'SWAP_ARITHMETIC';
+declare const SWAP_QUOTE_ERROR_MESSAGES: Readonly<Record<SwapQuoteErrorCode, string>>;
+declare class SwapQuoteError extends Error {
+    readonly code: SwapQuoteErrorCode;
+    constructor(code: SwapQuoteErrorCode);
+}
+interface SwapFreshness {
+    readonly maxBlockAgeSeconds?: number;
+    readonly maxBlockLag?: number;
+    readonly maxClockSkewSeconds?: number;
+}
+interface ExactInputQuoteRequest {
+    readonly chainId: string;
+    readonly poolDefinitionId: string;
+    readonly inputTokenDeploymentId: string;
+    readonly outputTokenDeploymentId: string;
+    readonly amountIn: string;
+    readonly freshness?: SwapFreshness;
+}
+interface ExactInputQuoteResult {
+    readonly quoteKind: 'exact-input';
+    readonly chainId: string;
+    readonly poolDefinitionId: string;
+    readonly dexDeploymentId: string;
+    readonly adapterKind: string;
+    readonly inputTokenDeploymentId: string;
+    readonly outputTokenDeploymentId: string;
+    readonly amountIn: string;
+    readonly amountOut: string;
+    readonly fee: {
+        readonly numerator: string;
+        readonly denominator: string;
+    };
+    readonly snapshot: {
+        readonly kind: 'evm-block';
+        readonly blockNumber: string;
+        readonly blockHash: string;
+        readonly blockTimestamp: string;
+    };
+    readonly tokenCatalogDigest: string;
+    readonly dexCatalogDigest: string;
+}
+interface SwapClient {
+    readonly quoteExactInput: (request: ExactInputQuoteRequest, options?: RpcSendOptions) => Promise<ExactInputQuoteResult>;
+}
+
 interface MonthlyApiKeyMethodUsage {
     readonly count: number;
     readonly creditCost: number;
@@ -845,18 +1279,134 @@ interface ErpcSolanaClient extends SolanaClient {
 interface ErpcEthereumClient extends EthereumClient {
     readonly subscriptions: EthereumSubscriptions;
 }
-type ErpcAvalancheClient = ErpcEthereumClient;
+interface ErpcAvalancheClient extends AvalancheClient {
+    readonly subscriptions: EthereumSubscriptions;
+}
 interface ErpcClient {
     readonly account: AccountClient;
     readonly avalanche: ErpcAvalancheClient;
     readonly ethereum: ErpcEthereumClient;
     readonly price: PriceClient;
     readonly solana: ErpcSolanaClient;
+    readonly swap: SwapClient;
     readonly usage: UsageClient;
     close(): void;
 }
 declare const createErpcClient: (config: ErpcClientConfig) => ErpcClient;
 
+type DexStatus = 'active' | 'legacy' | 'winding-down' | 'retired';
+type DexChainId = string;
+interface DexDeployment {
+    readonly dexDeploymentId: string;
+    readonly protocolId: string;
+    readonly name: string;
+    readonly chainId: DexChainId;
+    readonly programAddress: string;
+    readonly adapterKind: string;
+    readonly status: DexStatus;
+    readonly replacedByDexDeploymentId: string | null;
+}
+interface PoolAdapter {
+    readonly kind: string;
+    readonly feeNumerator: string | null;
+    readonly feeDenominator: string | null;
+}
+interface PoolDefinition {
+    readonly poolDefinitionId: string;
+    readonly dexDeploymentId: string;
+    readonly chainId: DexChainId;
+    readonly address: string;
+    readonly token0DeploymentId: string;
+    readonly token1DeploymentId: string;
+    readonly adapter: Readonly<PoolAdapter>;
+    readonly status: DexStatus;
+    readonly replacedByPoolDefinitionId: string | null;
+}
+interface NativeWrapDefinition {
+    readonly nativeWrapDefinitionId: string;
+    readonly chainId: DexChainId;
+    readonly nativeTokenDeploymentId: string;
+    readonly wrappedTokenDeploymentId: string;
+    readonly status: DexStatus;
+}
+interface DexAlias {
+    readonly namespace: string;
+    readonly name: string;
+    readonly dexDeploymentId: string | null;
+    readonly poolDefinitionId: string | null;
+}
+declare const DEX_CATALOG_VERSION: "1.0.0";
+declare const DEX_CATALOG_AS_OF_DATE: "2026-09-15";
+declare const DEX_CATALOG_CONTENT_DIGEST: "caccde1f997648dfa045af41d4f8b7f93a051c59d098cc770bd3a2757185aac1";
+declare const DEX_CHAIN_IDS: {
+    readonly ethereum: "eip155:1";
+    readonly solana: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+    readonly avalancheC: "eip155:43114";
+};
+declare const dexes: {
+    readonly ethereum: {
+        readonly UNISWAP_V2: "dex-deployment-0001";
+    };
+    readonly solana: {
+        readonly ORCA_WHIRLPOOLS: "dex-deployment-0003";
+        readonly RAYDIUM_CLMM: "dex-deployment-0004";
+    };
+    readonly avalancheC: {
+        readonly LFJ_LEGACY: "dex-deployment-0002";
+    };
+};
+declare const pools: {
+    readonly ethereum: {
+        readonly DISCOVERED_POOL_1B98A5F24A364E05: "discovered-pool-1b98a5f24a364e05b3d56a9702c3560fc3a71f84b2195c486cfc5f8a956cc0b7";
+        readonly DISCOVERED_POOL_6428A1E5DA293B2E: "discovered-pool-6428a1e5da293b2ef62027ec823ba27532219a40784def3930feee56a623b809";
+        readonly DISCOVERED_POOL_866F890448D13C07: "discovered-pool-866f890448d13c078e217a894ebd47430da5941fe5bff7e382fc095916b4614d";
+        readonly DISCOVERED_POOL_90805F8995C1D0B8: "discovered-pool-90805f8995c1d0b85a45fcd4587928a00066b1f14407baee4e8ed1b634c07804";
+        readonly DISCOVERED_POOL_A7F9E600A86951F4: "discovered-pool-a7f9e600a86951f40472ff779fae467db8a6bbbc6076356058f427e97d4ae429";
+        readonly DISCOVERED_POOL_B8F972F8BAE36C82: "discovered-pool-b8f972f8bae36c82b51ed2aeed070d3ef3e7642e2a708c7d3c0c134e6e1946ed";
+        readonly DISCOVERED_POOL_E702B0CB56528418: "discovered-pool-e702b0cb56528418b4ce089dfc001c6241c94e92aabde72f1a340c4601541780";
+        readonly UNISWAP_V2_USDC_WETH: "pool-0001";
+    };
+    readonly solana: {
+        readonly ORCA_WHIRLPOOLS_WSOL_EURC: "pool-0003";
+        readonly RAYDIUM_CLMM_WSOL_EURC: "pool-0004";
+    };
+    readonly avalancheC: {
+        readonly DISCOVERED_POOL_1568E761C62F7DC5: "discovered-pool-1568e761c62f7dc58207a77f2dc32153805efe03a8d9cce9366ce68efdf276c4";
+        readonly DISCOVERED_POOL_3C1E38D02092D16E: "discovered-pool-3c1e38d02092d16e396d2f3a22b2bfae55246a1c566831d31f211670e45bd562";
+        readonly DISCOVERED_POOL_3F840A40991E755E: "discovered-pool-3f840a40991e755e42d242188bd8deb85cd5b9655308269b00c220f5237710cf";
+        readonly DISCOVERED_POOL_5D7AA6A767A0C6EA: "discovered-pool-5d7aa6a767a0c6ea9ddeb06d1289bd12d85018935d5b25724b165dc8b9832252";
+        readonly DISCOVERED_POOL_9E4ED76F76904A4A: "discovered-pool-9e4ed76f76904a4ae271946bb1a4b2dc7428e343040b05a42707071bbfac9462";
+        readonly DISCOVERED_POOL_A2480F3D4EA5CE12: "discovered-pool-a2480f3d4ea5ce12252126acf64b174b9fe678b0f0fda8936a12fef180ae08cd";
+        readonly DISCOVERED_POOL_ECE9088CF3894443: "discovered-pool-ece9088cf38944438897ff9fb2a1abc6855a687b5a3f0d6ab98dfe06c1a6dfef";
+        readonly DISCOVERED_POOL_FB02E85806CD9079: "discovered-pool-fb02e85806cd907920126af935137b0775a858ddf04a28d7ca144f761fd7579e";
+        readonly LFJ_LEGACY_WAVAX_USDC: "pool-0002";
+    };
+};
+declare const DEX_DEPLOYMENTS: ReadonlyArray<Readonly<DexDeployment>>;
+declare const POOL_DEFINITIONS: ReadonlyArray<Readonly<PoolDefinition>>;
+declare const NATIVE_WRAP_DEFINITIONS: ReadonlyArray<Readonly<NativeWrapDefinition>>;
+declare const DEX_ALIASES: ReadonlyArray<Readonly<DexAlias>>;
+
+type DexNamespace = 'ethereum' | 'solana' | 'avalancheC';
+interface ListPoolDefinitionsOptions {
+    readonly chainId?: DexChainId;
+    readonly tokenDeploymentId?: string;
+    readonly adapterKind?: string;
+}
+
+/** Return a DEX deployment by its exact opaque ID. */
+declare function getDexDeployment(dexDeploymentId: string): DexDeployment | undefined;
+/** Return a pool definition by its exact opaque ID. */
+declare function getPoolDefinition(poolDefinitionId: string): PoolDefinition | undefined;
+/** Find a pool by its chain-qualified address. */
+declare function findPoolDefinitionByAddress(chainId: DexChainId, address: string): PoolDefinition | undefined;
+/** Find all pools for an unordered token pair in stable pool-ID order. */
+declare function findPoolDefinitionsByPair(chainId: DexChainId, tokenADeploymentId: string, tokenBDeploymentId: string): readonly PoolDefinition[];
+/** List pool definitions using the optional exact filters. */
+declare function listPoolDefinitions(options?: ListPoolDefinitionsOptions): readonly PoolDefinition[];
+/** Return the active or historical native-to-wrapped relationship for a token. */
+declare function getNativeWrapDefinition(nativeTokenDeploymentId: string): NativeWrapDefinition | undefined;
+
 type CloudCreditAlertLevel = 'critical' | 'normal' | 'suspended' | 'warning';
 interface CloudCredit {
     readonly alertLevel: CloudCreditAlertLevel;
@@ -922,4 +1472,4 @@ declare class ErpcBatchPolicyError extends ErpcError {
     constructor(message: string);
 }
 
-export { AccountClient, type AddressTransaction, type AddressTransactionPage, type AddressTransactionsOptions, type AddressTransfer, type AddressTransferPage, type AddressTransfersOptions, type AnalyticsTimeBound, type AssetBatchRequest, type AssetListRequest, type AssetRequest, type BinaryUpdate, CloudCatalogClient, type CloudCredit, type CloudCreditAlertLevel, CloudCreditClient, type CloudOffering, type CloudOfferingBilling, type CloudOfferingCompute, type CloudOfferingSolana, type CloudResource, type CloudResourceKind, type CloudResourceMode, type CloudResourceStatus, type CloudResourceStatusBilling, CloudResourcesClient, DEFAULT_ACCOUNT_ENDPOINT, DEFAULT_AVALANCHE_ENDPOINT, DEFAULT_ENDPOINT, DEFAULT_TIMEOUT_MS, DEFAULT_USER_ENDPOINT, ETHEREUM_RPC_METHODS, ETHEREUM_SUBSCRIPTION_METHODS, type EpochSummary, ErpcAbortedError, type ErpcAvalancheClient, ErpcBatchPolicyError, type ErpcClient, type ErpcClientConfig, type ErpcCloudClient, type ErpcCloudClientConfig, type ErpcCloudRequestOptions, ErpcConfigError, ErpcError, type ErpcErrorCode, type ErpcEthereumClient, ErpcHttpError, ErpcInvalidResponseError, ErpcJsonRpcError, type ErpcPlan, type ErpcSolanaClient, ErpcTimeoutError, ErpcTransportError, type EthereumAddress, type EthereumBlockTag, type EthereumClient, type EthereumFilter, type EthereumObject, type EthereumRpcSchema, type EthereumSubscriptionSchema, EthereumSubscriptions, type EthereumTransactionRequest, type Hex, type IndexedAsset, type IndexedAssetList, type IndexedAssetProof, type JsonObject, type JsonPrimitive, type JsonRpcErrorObject, type JsonRpcFailure, type JsonRpcId, type JsonRpcParams, type JsonRpcRequest, type JsonRpcResponse, type JsonRpcSuccess, type JsonRpcTransport, type JsonValue, type LeaderSlot, type LeaderSlotsResult, type MonthlyApiKeyChainUsage, type MonthlyApiKeyMethodUsage, type MonthlyApiKeyUsage, type MonthlyApiKeyUsageEntry, type MonthlyApiKeyUsageParams, type NumericFilter, type ParsedPriceUpdate, PendingRpcBatchRequest, PendingRpcRequest, type PingMeasurement, type PriceAssetType, PriceClient, type PriceEncoding, type PriceFeedMetadata, type PricePoint, type PriceStreamEvent, type PriceStreamOptions, type PriceUpdateOptions, type PriceUpdateResponse, type PriorityFeeEstimate, type ProgramStatsBucket, type ProgramStatsOptions, type PublisherStakeCap, type PublisherStakeCapsResponse, type RpcBatchCall, type RpcMethodSpec, type RpcNamespace, type RpcNamespaceBase, type RpcNotification, type RpcNotificationListener, type RpcParams, type RpcResult, type RpcSendOptions, RpcSubscription, SOLANA_ANALYTICS_METHODS, SOLANA_DAS_METHODS, SOLANA_ENHANCED_SUBSCRIPTION_METHODS, SOLANA_HISTORY_METHODS, SOLANA_LEADER_METHODS, SOLANA_RPC_METHODS, type SlotStatsOptions, type SlotStatsRow, type SolanaAnalyticsSchema, type SolanaClient, type SolanaCommitment, type SolanaConfig, type SolanaContext, type SolanaContextResult, type SolanaDasSchema, type SolanaEncoding, type SolanaEnhancedSubscriptionSchema, type SolanaHistorySchema, type SolanaLeaderSchema, type SolanaRpcSchema, SolanaSubscriptions, type SubscriptionId, type SubscriptionListener, type TokenBalance, type TopProgramRow, type TopProgramsOptions, type TpsBucket, type TpsTimeseriesOptions, UsageClient, type ValidatorInformation, type ValidatorsInformationOptions, type ValidatorsInformationResult, createErpcClient, createErpcCloudClient };
+export { AVALANCHE_AVAX_METHODS, AVALANCHE_INDEX_METHODS, AVALANCHE_INFO_METHODS, AVALANCHE_PROPOSER_VM_METHODS, AVALANCHE_P_CHAIN_METHODS, AVALANCHE_X_CHAIN_METHODS, AccountClient, type AddressTransaction, type AddressTransactionPage, type AddressTransactionsOptions, type AddressTransfer, type AddressTransferPage, type AddressTransfersOptions, type AnalyticsTimeBound, type AssetBatchRequest, type AssetListRequest, type AssetRequest, type AvalancheAvaxSchema, type AvalancheClient, type AvalancheEncodingParams, type AvalancheIndexClient, type AvalancheIndexSchema, type AvalancheIndexTransports, type AvalancheInfoSchema, type AvalanchePChainSchema, type AvalancheProposerVmSchema, type AvalancheUtxoParams, type AvalancheXChainSchema, type BinaryUpdate, CloudCatalogClient, type CloudCredit, type CloudCreditAlertLevel, CloudCreditClient, type CloudOffering, type CloudOfferingBilling, type CloudOfferingCompute, type CloudOfferingSolana, type CloudResource, type CloudResourceKind, type CloudResourceMode, type CloudResourceStatus, type CloudResourceStatusBilling, CloudResourcesClient, DEFAULT_ACCOUNT_ENDPOINT, DEFAULT_AVALANCHE_ENDPOINT, DEFAULT_ENDPOINT, DEFAULT_TIMEOUT_MS, DEFAULT_USER_ENDPOINT, DEX_ALIASES, DEX_CATALOG_AS_OF_DATE, DEX_CATALOG_CONTENT_DIGEST, DEX_CATALOG_VERSION, DEX_CHAIN_IDS, DEX_DEPLOYMENTS, type DexAlias, type DexChainId, type DexDeployment, type DexNamespace, type DexStatus, ETHEREUM_RPC_METHODS, ETHEREUM_SUBSCRIPTION_METHODS, type EpochSummary, ErpcAbortedError, type ErpcAvalancheClient, ErpcBatchPolicyError, type ErpcClient, type ErpcClientConfig, type ErpcCloudClient, type ErpcCloudClientConfig, type ErpcCloudRequestOptions, ErpcConfigError, ErpcError, type ErpcErrorCode, type ErpcEthereumClient, ErpcHttpError, ErpcInvalidResponseError, ErpcJsonRpcError, type ErpcPlan, type ErpcSolanaClient, ErpcTimeoutError, ErpcTransportError, type EthereumAddress, type EthereumBlockTag, type EthereumClient, type EthereumFilter, type EthereumObject, type EthereumRpcSchema, type EthereumSubscriptionSchema, EthereumSubscriptions, type EthereumTransactionRequest, type ExactInputQuoteRequest, type ExactInputQuoteResult, type Hex, type IndexedAsset, type IndexedAssetList, type IndexedAssetProof, type JsonObject, type JsonPrimitive, type JsonRpcErrorObject, type JsonRpcFailure, type JsonRpcId, type JsonRpcParams, type JsonRpcRequest, type JsonRpcResponse, type JsonRpcSuccess, type JsonRpcTransport, type JsonValue, type LeaderSlot, type LeaderSlotsResult, type ListPoolDefinitionsOptions, type ListTokenDeploymentsOptions, type MonthlyApiKeyChainUsage, type MonthlyApiKeyMethodUsage, type MonthlyApiKeyUsage, type MonthlyApiKeyUsageEntry, type MonthlyApiKeyUsageParams, NATIVE_WRAP_DEFINITIONS, type NativeWrapDefinition, type NumericFilter, POOL_DEFINITIONS, type ParsedPriceUpdate, PendingRpcBatchRequest, PendingRpcRequest, type PingMeasurement, type PoolDefinition, type PriceAssetType, PriceClient, type PriceEncoding, type PriceFeedMetadata, type PricePoint, type PriceStreamEvent, type PriceStreamOptions, type PriceUpdateOptions, type PriceUpdateResponse, type PriorityFeeEstimate, type ProgramStatsBucket, type ProgramStatsOptions, type PublisherStakeCap, type PublisherStakeCapsResponse, type RpcBatchCall, type RpcMethodSpec, type RpcNamespace, type RpcNamespaceBase, type RpcNotification, type RpcNotificationListener, type RpcParams, type RpcResult, type RpcSendOptions, RpcSubscription, SOLANA_ANALYTICS_METHODS, SOLANA_DAS_METHODS, SOLANA_ENHANCED_SUBSCRIPTION_METHODS, SOLANA_HISTORY_METHODS, SOLANA_LEADER_METHODS, SOLANA_RPC_METHODS, SWAP_QUOTE_ERROR_MESSAGES, type SlotStatsOptions, type SlotStatsRow, type SolanaAnalyticsSchema, type SolanaClient, type SolanaCommitment, type SolanaConfig, type SolanaContext, type SolanaContextResult, type SolanaDasSchema, type SolanaEncoding, type SolanaEnhancedSubscriptionSchema, type SolanaHistorySchema, type SolanaLeaderSchema, type SolanaRpcSchema, SolanaSubscriptions, type StableCurrency, type SubscriptionId, type SubscriptionListener, type SwapClient, type SwapFreshness, SwapQuoteError, type SwapQuoteErrorCode, TOKEN_ALIASES, TOKEN_ASSETS, TOKEN_CATALOG_AS_OF_DATE, TOKEN_CATALOG_CONTENT_DIGEST, TOKEN_CATALOG_VERSION, TOKEN_CHAIN_IDS, TOKEN_DEPLOYMENTS, TOKEN_RANKINGS, TOKEN_RANKINGS_BY_CHAIN, TOKEN_RANKINGS_CONTENT_DIGEST, TOKEN_RANKINGS_METADATA, type TokenAlias, type TokenAsset, type TokenBalance, type TokenChainId, type TokenDeployment, type TokenRanking, type TokenRankingCoverage, type TokenRankingMetadata, type TokenRankingMetric, type TokenRankingStatus, type TokenRepresentationKind, type TokenStandard, type TokenStatus, type TopProgramRow, type TopProgramsOptions, type TpsBucket, type TpsTimeseriesOptions, UsageClient, type ValidatorInformation, type ValidatorsInformationOptions, type ValidatorsInformationResult, createErpcClient, createErpcCloudClient, dexes, findPoolDefinitionByAddress, findPoolDefinitionsByPair, findTokenDeploymentByAddress, findTokenDeploymentsBySymbol, getDexDeployment, getNativeTokenDeployment, getNativeWrapDefinition, getPoolDefinition, getTokenAsset, getTokenDeployment, listPoolDefinitions, listTokenDeployments, listTokenRankings, pools, tokens };