@paraspell/sdk-core 13.5.0 → 13.7.0

package/dist/index.d.ts

@@ -2,9 +2,9 @@ import * as _paraspell_sdk_common from '@paraspell/sdk-common';
 import { TSubstrateChain, TChain, Version, TRelaychain, TParachain, TLocation, TExternalChain, TJunction, Parents, TJunctions } from '@paraspell/sdk-common';
 export * from '@paraspell/sdk-common';
 import * as _paraspell_assets from '@paraspell/assets';
-import { TAssetInfo, WithAmount, TAsset, TCurrencyInputWithAmount, TCurrencyInput, TCurrencyCore, TAmount, TAssetWithFee, WithComplexAmount, TAssetInfoWithId } from '@paraspell/assets';
+import { TChainAssetsInfo, TAssetInfo, TCurrencyInput, WithAmount, TAsset, TCurrencyInputWithAmount, TCustomAssetInfo, TCustomCtx, TCustomAssetsMap, TCurrencyCore, TAmount, TAssetWithFee, WithComplexAmount, TAssetInfoWithId } from '@paraspell/assets';
 export * from '@paraspell/assets';
-import { TPallet, TAssetsPallet } from '@paraspell/pallets';
+import { TPallet, TPalletEntry, TAssetsPallet, TCustomChainPallets, TCrosschainPallet } from '@paraspell/pallets';
 export * from '@paraspell/pallets';
 import { WalletClient, TransactionSerializableEIP1559, Address, formatUnits as formatUnits$1, parseUnits as parseUnits$1 } from 'viem';
 
@@ -37,11 +37,18 @@ type ClientCache<T> = {
 };
 declare const API_TYPES: readonly ["PAPI", "PJS", "DEDOT"];
 type TApiType = (typeof API_TYPES)[number];
+type TRuntimeApi = 'DryRunApi' | 'XcmPaymentApi';
+type TSystemProperties = {
+    ss58Format?: number;
+    tokenSymbol?: string;
+    tokenDecimals?: number;
+};
 
-declare abstract class PolkadotApi<TApi, TRes, TSigner> {
+declare abstract class PolkadotApi<TApi, TRes, TSigner, TCustomChain extends string = never> {
     _api?: TApi;
-    _chain?: TSubstrateChain;
+    _chain?: TSubstrateChain | TCustomChain;
     readonly _config?: TBuilderOptions<TApiOrUrl<TApi>>;
+    _customCtx: TFullCustomCtx;
     _ttlMs: number;
     _disconnectAllowed: boolean;
     abstract readonly type: TApiType;
@@ -50,7 +57,24 @@ declare abstract class PolkadotApi<TApi, TRes, TSigner> {
     set disconnectAllowed(allowed: boolean);
     get disconnectAllowed(): boolean;
     get config(): TBuilderOptions<TApiOrUrl<TApi>> | undefined;
-    init(chain: TChain, clientTtlMs?: number): Promise<void>;
+    getAssetsObject(chain: TChain): TChainAssetsInfo;
+    getAssets(chain: TChain): TAssetInfo[];
+    getNativeAssets(chain: TChain): TAssetInfo[];
+    getOtherAssets(chain: TChain): TAssetInfo[];
+    findAssetInfo(chain: TChain, currency: TCurrencyInput, destination?: TChain | null): TAssetInfo | null;
+    findAssetInfoOrThrow(chain: TChain, currency: TCurrencyInput, destination?: TChain | null): TAssetInfo;
+    findAssetInfoOnDest(origin: TChain, destination: TChain, currency: TCurrencyInput, originAsset?: TAssetInfo | null): TAssetInfo | null;
+    findAssetOnDestOrThrow(origin: TChain, destination: TChain, currency: TCurrencyInput): TAssetInfo;
+    findNativeAssetInfo(chain: TChain): TAssetInfo | null;
+    findNativeAssetInfoOrThrow(chain: TChain): TAssetInfo;
+    isChainEvm(chain: TChain): boolean;
+    getNativeAssetSymbol(chain: TChain): string;
+    getRelayChainSymbol(chain: TChain): string;
+    hasDryRunSupport(chain: TChain): boolean;
+    hasXcmPaymentApiSupport(chain: TChain): boolean;
+    init(chain: TChain | TCustomChain, clientTtlMs?: number, destination?: TDestination): Promise<void>;
+    setCustomCtx(ctx: TFullCustomCtx): void;
+    private hydrateCustomChain;
     abstract leaseClient(wsUrl: TUrl, ttlMs: number): Promise<TApi>;
     abstract accountToHex(address: string, isPrefixed?: boolean): string;
     abstract accountToUint8a(address: string): Uint8Array;
@@ -68,6 +92,9 @@ declare abstract class PolkadotApi<TApi, TRes, TSigner> {
     abstract getMethod(tx: TRes): string;
     abstract getTypeThenAssetCount(tx: TRes): number | undefined;
     abstract hasMethod(pallet: TPallet, method: string): Promise<boolean>;
+    abstract hasRuntimeApi(runtimeApi: TRuntimeApi): Promise<boolean>;
+    abstract fetchPalletList(): Promise<TPalletEntry[]>;
+    abstract isEvmChain(): Promise<boolean>;
     abstract getPaymentInfo(tx: TRes, address: string): Promise<{
         partialFee: bigint;
         weight: TWeight;
@@ -77,8 +104,8 @@ declare abstract class PolkadotApi<TApi, TRes, TSigner> {
     abstract getEvmStorage(contract: string, slot: string): Promise<string>;
     abstract getFromRpc(module: string, method: string, key: string): Promise<string>;
     abstract blake2AsHex(data: Uint8Array): string;
-    abstract clone(): PolkadotApi<TApi, TRes, TSigner>;
-    abstract createApiForChain(chain: TSubstrateChain): Promise<PolkadotApi<TApi, TRes, TSigner>>;
+    abstract clone(): PolkadotApi<TApi, TRes, TSigner, TCustomChain>;
+    abstract createApiForChain(chain: TSubstrateChain): Promise<PolkadotApi<TApi, TRes, TSigner, TCustomChain>>;
     abstract getDryRunCall(options: TDryRunCallBaseOptions<TRes>): Promise<TDryRunChainResult>;
     abstract getDryRunXcm(options: TDryRunXcmBaseOptions<TRes>): Promise<TDryRunChainResult>;
     abstract getBridgeStatus(): Promise<TBridgeStatus>;
@@ -88,14 +115,18 @@ declare abstract class PolkadotApi<TApi, TRes, TSigner> {
     abstract deriveAddress(sender: TSender<TSigner>): string;
     abstract signAndSubmit(tx: TRes, sender: TSender<TSigner>): Promise<string>;
     abstract signAndSubmitFinalized(tx: TRes, sender: TSender<TSigner>): Promise<string>;
+    abstract getSystemProperties(): Promise<TSystemProperties>;
+    abstract getConstant<T = unknown>(pallet: string, name: string): Promise<T | undefined>;
+    private getNativeExistentialDeposit;
+    private maybeHydrateCustomChain;
 }
 
-declare abstract class Chain<TApi, TRes, TSigner> {
+declare abstract class Chain<TApi, TRes, TSigner, TCustomChain extends string = never> {
     private readonly _chain;
     private readonly _info;
     private readonly _ecosystem;
     private readonly _version;
-    constructor(chain: TSubstrateChain, info: string, ecosystem: TRelaychain, version: Version);
+    constructor(chain: TSubstrateChain | TCustomChain, info: string, ecosystem: TRelaychain, version: Version);
     get info(): string;
     get ecosystem(): TRelaychain;
     get chain(): TSubstrateChain;
@@ -106,16 +137,16 @@ declare abstract class Chain<TApi, TRes, TSigner> {
     throwIfTempDisabled(options: TTransferInternalOptions<TApi, TRes, TSigner>, destChain?: TChain): void;
     isSendingTempDisabled(_options: TTransferInternalOptions<TApi, TRes, TSigner>): boolean;
     isReceivingTempDisabled(_scenario: TScenario): boolean;
-    canReceiveFrom(_origin: TChain): boolean;
-    shouldUseNativeAssetTeleport({ assetInfo: asset, to }: TTransferInternalOptions<TApi, TRes, TSigner>): boolean;
-    createAsset(asset: WithAmount<TAssetInfo>, version: Version): TAsset;
-    getNativeAssetSymbol(): string;
+    canReceiveFrom(_origin: TChain | TCustomChain): boolean;
+    shouldUseNativeAssetTeleport({ api, assetInfo: asset, to }: TTransferInternalOptions<TApi, TRes, TSigner>): boolean;
+    createAsset(api: PolkadotApi<TApi, TRes, TSigner>, asset: WithAmount<TAssetInfo>, version: Version): TAsset;
+    getNativeAssetSymbol(api: PolkadotApi<TApi, TRes, TSigner>): string;
     transferLocal(options: TTransferInternalOptions<TApi, TRes, TSigner>): Promise<TRes>;
     transferLocalNativeAsset(options: TTransferLocalOptions<TApi, TRes, TSigner>): Promise<TRes>;
     transferLocalNonNativeAsset(options: TTransferLocalOptions<TApi, TRes, TSigner>): TRes;
     getBalanceNative(api: PolkadotApi<TApi, TRes, TSigner>, address: string, asset: TAssetInfo): Promise<bigint>;
-    getCustomCurrencyId(_asset: TAssetInfo): unknown;
-    getBalanceForeign<TApi, TRes, TSigner>(api: PolkadotApi<TApi, TRes, TSigner>, address: string, asset: TAssetInfo): Promise<bigint>;
+    getCustomCurrencyId(_api: PolkadotApi<TApi, TRes, TSigner>, _asset: TAssetInfo): unknown;
+    getBalanceForeign(api: PolkadotApi<TApi, TRes, TSigner>, address: string, asset: TAssetInfo): Promise<bigint>;
     getBalance(api: PolkadotApi<TApi, TRes, TSigner>, address: string, asset: TAssetInfo): Promise<bigint>;
 }
 
@@ -125,7 +156,7 @@ declare class Acala<TApi, TRes, TSigner> extends Chain<TApi, TRes, TSigner> impl
     isRelayToParaEnabled(): boolean;
     transferLocalNativeAsset(options: TTransferLocalOptions<TApi, TRes, TSigner>): Promise<TRes>;
     transferLocalNonNativeAsset(options: TTransferLocalOptions<TApi, TRes, TSigner>): TRes;
-    getCustomCurrencyId(asset: TAssetInfo): TForeignOrTokenAsset;
+    getCustomCurrencyId(_api: PolkadotApi<TApi, TRes, TSigner>, asset: TAssetInfo): TForeignOrTokenAsset;
     getBalance(api: PolkadotApi<TApi, TRes, TSigner>, address: string, asset: TAssetInfo): Promise<bigint>;
 }
 
@@ -184,7 +215,7 @@ declare class Basilisk<TApi, TRes, TSigner> extends Hydration<TApi, TRes, TSigne
 
 declare class BifrostPolkadot<TApi, TRes, TSigner> extends Chain<TApi, TRes, TSigner> implements IPolkadotXCMTransfer<TApi, TRes, TSigner> {
     constructor(chain?: TParachain, info?: string, ecosystem?: TRelaychain, version?: Version);
-    getCustomCurrencyId(asset: TAssetInfo): {
+    getCustomCurrencyId(api: PolkadotApi<TApi, TRes, TSigner>, asset: TAssetInfo): {
         Native: string;
         VToken?: undefined;
         Token?: undefined;
@@ -259,7 +290,7 @@ declare class BridgeHubWestend<TApi, TRes, TSigner> extends BridgeHubPolkadot<TA
 
 declare class Centrifuge<TApi, TRes, TSigner> extends Chain<TApi, TRes, TSigner> implements IXTokensTransfer<TApi, TRes, TSigner> {
     constructor();
-    getCustomCurrencyId(asset: TAssetInfo): "Native" | {
+    getCustomCurrencyId(api: PolkadotApi<TApi, TRes, TSigner>, asset: TAssetInfo): "Native" | {
         ForeignAsset: number;
     };
     transferXTokens(input: TXTokensTransferOptions<TApi, TRes, TSigner>): TRes;
@@ -352,7 +383,7 @@ declare class HydrationPaseo<TApi, TRes, TSigner> extends Hydration<TApi, TRes,
 
 declare class Interlay<TApi, TRes, TSigner> extends Chain<TApi, TRes, TSigner> implements IXTokensTransfer<TApi, TRes, TSigner> {
     constructor();
-    getCustomCurrencyId(asset: TAssetInfo): TForeignOrTokenAsset;
+    getCustomCurrencyId(_api: PolkadotApi<TApi, TRes, TSigner>, asset: TAssetInfo): TForeignOrTokenAsset;
     transferXTokens(input: TXTokensTransferOptions<TApi, TRes, TSigner>): TRes;
     transferLocalNativeAsset(options: TTransferLocalOptions<TApi, TRes, TSigner>): Promise<TRes>;
     transferLocalNonNativeAsset(options: TTransferLocalOptions<TApi, TRes, TSigner>): TRes;
@@ -361,7 +392,7 @@ declare class Interlay<TApi, TRes, TSigner> extends Chain<TApi, TRes, TSigner> i
 
 declare class Jamton<TApi, TRes, TSigner> extends Chain<TApi, TRes, TSigner> implements IPolkadotXCMTransfer<TApi, TRes, TSigner> {
     constructor();
-    getCustomCurrencyId(asset: TAssetInfo): {
+    getCustomCurrencyId(_api: PolkadotApi<TApi, TRes, TSigner>, asset: TAssetInfo): {
         Native: number;
         ForeignAsset?: undefined;
     } | {
@@ -377,7 +408,7 @@ declare class Karura<TApi, TRes, TSigner> extends Acala<TApi, TRes, TSigner> {
 
 declare class Kintsugi<TApi, TRes, TSigner> extends Chain<TApi, TRes, TSigner> implements IXTokensTransfer<TApi, TRes, TSigner> {
     constructor();
-    getCustomCurrencyId(asset: TAssetInfo): TForeignOrTokenAsset;
+    getCustomCurrencyId(_api: PolkadotApi<TApi, TRes, TSigner>, asset: TAssetInfo): TForeignOrTokenAsset;
     transferXTokens(input: TXTokensTransferOptions<TApi, TRes, TSigner>): TRes;
     transferLocalNativeAsset(options: TTransferLocalOptions<TApi, TRes, TSigner>): Promise<TRes>;
     transferLocalNonNativeAsset(options: TTransferLocalOptions<TApi, TRes, TSigner>): TRes;
@@ -393,16 +424,6 @@ declare class Kusama<TApi, TRes, TSigner> extends Polkadot<TApi, TRes, TSigner>
     constructor();
 }
 
-declare class Laos<TApi, TRes, TSigner> extends Chain<TApi, TRes, TSigner> implements IPolkadotXCMTransfer<TApi, TRes, TSigner> {
-    constructor(chain?: TParachain, info?: string, ecosystem?: TRelaychain, version?: Version);
-    transferPolkadotXCM(input: TPolkadotXCMTransferOptions<TApi, TRes, TSigner>): Promise<TRes>;
-    isRelayToParaEnabled(): boolean;
-}
-
-declare class LaosPaseo<TApi, TRes, TSigner> extends Laos<TApi, TRes, TSigner> {
-    constructor();
-}
-
 declare class Moonbeam<TApi, TRes, TSigner> extends Chain<TApi, TRes, TSigner> implements IPolkadotXCMTransfer<TApi, TRes, TSigner> {
     constructor(chain?: TParachain, info?: string, ecosystem?: TRelaychain, version?: Version);
     transferPolkadotXCM(options: TPolkadotXCMTransferOptions<TApi, TRes, TSigner>): Promise<TRes>;
@@ -446,7 +467,7 @@ declare class Peaq<TApi, TRes, TSigner> extends Chain<TApi, TRes, TSigner> imple
 
 declare class Pendulum<TApi, TRes, TSigner> extends Chain<TApi, TRes, TSigner> implements IXTokensTransfer<TApi, TRes, TSigner> {
     constructor();
-    getCustomCurrencyId(asset: TAssetInfo): TXcmAsset;
+    getCustomCurrencyId(api: PolkadotApi<TApi, TRes, TSigner>, asset: TAssetInfo): TXcmAsset;
     transferXTokens(input: TXTokensTransferOptions<TApi, TRes, TSigner>): TRes;
     transferLocalNonNativeAsset(options: TTransferLocalOptions<TApi, TRes, TSigner>): TRes;
 }
@@ -509,7 +530,7 @@ declare class Xode<TApi, TRes, TSigner> extends Chain<TApi, TRes, TSigner> imple
 
 declare class Zeitgeist<TApi, TRes, TSigner> extends Chain<TApi, TRes, TSigner> implements IPolkadotXCMTransfer<TApi, TRes, TSigner> {
     constructor(chain?: TParachain, info?: string, ecosystem?: TRelaychain, version?: Version);
-    getCustomCurrencyId(asset: TAssetInfo): TZeitgeistAsset | TXcmForeignAsset;
+    getCustomCurrencyId(_api: PolkadotApi<TApi, TRes, TSigner>, asset: TAssetInfo): TZeitgeistAsset | TXcmForeignAsset;
     transferPolkadotXCM(input: TPolkadotXCMTransferOptions<TApi, TRes, TSigner>): Promise<TRes>;
     canReceiveFrom(origin: TChain): boolean;
     transferLocalNonNativeAsset(options: TTransferLocalOptions<TApi, TRes, TSigner>): TRes;
@@ -558,7 +579,6 @@ declare const chains: <TApi, TRes, TSigner>() => {
     Karura: Karura<TApi, TRes, TSigner>;
     Kintsugi: Kintsugi<TApi, TRes, TSigner>;
     Moonriver: Moonriver<TApi, TRes, TSigner>;
-    Laos: Laos<TApi, TRes, TSigner>;
     Quartz: Quartz<TApi, TRes, TSigner>;
     PeopleKusama: PeopleKusama<TApi, TRes, TSigner>;
     Shiden: Shiden<TApi, TRes, TSigner>;
@@ -580,7 +600,6 @@ declare const chains: <TApi, TRes, TSigner>() => {
     BifrostPaseo: BifrostPaseo<TApi, TRes, TSigner>;
     HeimaPaseo: HeimaPaseo<TApi, TRes, TSigner>;
     HydrationPaseo: HydrationPaseo<TApi, TRes, TSigner>;
-    LaosPaseo: LaosPaseo<TApi, TRes, TSigner>;
     NeuroWebPaseo: NeuroWebPaseo<TApi, TRes, TSigner>;
     ZeitgeistPaseo: ZeitgeistPaseo<TApi, TRes, TSigner>;
 };
@@ -675,7 +694,7 @@ declare class BatchTransactionManager<TApi, TRes, TSigner> {
 /**
  * A builder class for constructing Para-to-Para, Para-to-Relay, Relay-to-Para transactions and asset claims.
  */
-declare class GeneralBuilder<TApi, TRes, TSigner, T extends Partial<TTransferBaseOptions<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>> = object> {
+declare class GeneralBuilder<TApi, TRes, TSigner, T extends Partial<TTransferBaseOptions<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>> = object, TCustomChain extends string = never> {
     readonly batchManager: BatchTransactionManager<TApi, TRes, TSigner>;
     readonly api: PolkadotApi<TApi, TRes, TSigner>;
     readonly _options: T;
@@ -686,9 +705,9 @@ declare class GeneralBuilder<TApi, TRes, TSigner, T extends Partial<TTransferBas
      * @param chain - The chain from which the transaction originates.
      * @returns An instance of Builder
      */
-    from(chain: TChain): GeneralBuilder<TApi, TRes, TSigner, T & {
+    from(chain: TChain | TCustomChain): GeneralBuilder<TApi, TRes, TSigner, T & {
         from: TChain;
-    }>;
+    }, TCustomChain>;
     /**
      * Specifies the destination chain for the transaction.
      *
@@ -696,9 +715,9 @@ declare class GeneralBuilder<TApi, TRes, TSigner, T extends Partial<TTransferBas
      * @param paraIdTo - (Optional) The parachain ID of the destination chain.
      * @returns An instance of Builder
      */
-    to(chain: TDestination, paraIdTo?: number): GeneralBuilder<TApi, TRes, TSigner, T & {
+    to(chain: TDestination | TCustomChain, paraIdTo?: number): GeneralBuilder<TApi, TRes, TSigner, T & {
         to: TDestination;
-    }>;
+    }, TCustomChain>;
     /**
      * Initiates the process to claim assets from a specified chain.
      *
@@ -717,7 +736,7 @@ declare class GeneralBuilder<TApi, TRes, TSigner, T extends Partial<TTransferBas
      */
     currency(currency: TCurrencyInputWithAmount): GeneralBuilder<TApi, TRes, TSigner, T & {
         currency: TCurrencyInputWithAmount;
-    }>;
+    }, TCustomChain>;
     /**
      * Sets the recipient address.
      *
@@ -726,7 +745,7 @@ declare class GeneralBuilder<TApi, TRes, TSigner, T extends Partial<TTransferBas
      */
     recipient(address: TAddress): GeneralBuilder<TApi, TRes, TSigner, T & {
         recipient: TAddress;
-    }>;
+    }, TCustomChain>;
     /**
      * Sets the sender address or signer.
      *
@@ -735,7 +754,7 @@ declare class GeneralBuilder<TApi, TRes, TSigner, T extends Partial<TTransferBas
      */
     sender(sender: TSender<TSigner> | WalletClient): GeneralBuilder<TApi, TRes, TSigner, T & {
         sender: string;
-    }>;
+    }, TCustomChain>;
     /**
      * Sets the asset hub address. This is used for transfers that go through the Asset Hub and originate from an EVM chain.
      *
@@ -744,7 +763,7 @@ declare class GeneralBuilder<TApi, TRes, TSigner, T extends Partial<TTransferBas
      */
     ahAddress(address: string | undefined): GeneralBuilder<TApi, TRes, TSigner, T & {
         ahAddress: string | undefined;
-    }>;
+    }, never>;
     /**
      * Sets the XCM version to be used for the transfer.
      *
@@ -753,7 +772,7 @@ declare class GeneralBuilder<TApi, TRes, TSigner, T extends Partial<TTransferBas
      */
     xcmVersion(version: Version): GeneralBuilder<TApi, TRes, TSigner, T & {
         version: Version;
-    }>;
+    }, never>;
     /**
      * Whether to keep the account alive after the transfer.
      *
@@ -762,7 +781,7 @@ declare class GeneralBuilder<TApi, TRes, TSigner, T extends Partial<TTransferBas
      */
     keepAlive(keepAlive: boolean): GeneralBuilder<TApi, TRes, TSigner, T & {
         keepAlive: boolean;
-    }>;
+    }, never>;
     /**
      * Sets a custom pallet for the transaction.
      *
@@ -773,7 +792,7 @@ declare class GeneralBuilder<TApi, TRes, TSigner, T extends Partial<TTransferBas
     customPallet(pallet: string | undefined, method: string | undefined): GeneralBuilder<TApi, TRes, TSigner, T & {
         pallet: string | undefined;
         method: string | undefined;
-    }>;
+    }, never>;
     /**
      * Optional fee asset for the transaction.
      *
@@ -782,7 +801,7 @@ declare class GeneralBuilder<TApi, TRes, TSigner, T extends Partial<TTransferBas
      */
     feeAsset(currency: TCurrencyInput | undefined): GeneralBuilder<TApi, TRes, TSigner, T & {
         feeAsset: TCurrencyInput | undefined;
-    }>;
+    }, never>;
     /**
      * Sets the hex of the encoded transaction call to apply on the destination chain
      *
@@ -797,7 +816,7 @@ declare class GeneralBuilder<TApi, TRes, TSigner, T extends Partial<TTransferBas
             originKind: "Native" | "SovereignAccount" | "Superuser" | "Xcm" | undefined;
             maxWeight: TWeight | undefined;
         };
-    }>;
+    }, never>;
     /**
      * Performs a token swap as part of the transfer, using the specified exchange and destination currency.
      *
@@ -806,54 +825,54 @@ declare class GeneralBuilder<TApi, TRes, TSigner, T extends Partial<TTransferBas
      */
     swap(options: TSwapOptions<TApi, TRes, TSigner>): GeneralBuilder<TApi, TRes, TSigner, T & {
         swapOptions: TSwapOptions<TApi, TRes, TSigner>;
-    }>;
+    }, TCustomChain>;
     /**
      * Adds the transfer transaction to the batch.
      *
      * @returns An instance of Builder
      */
-    addToBatch(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptions<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>>): GeneralBuilder<TApi, TRes, TSigner, T & {
+    addToBatch(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptions<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>, TCustomChain>): GeneralBuilder<TApi, TRes, TSigner, T & {
         from: TSubstrateChain;
-    }>;
+    }, TCustomChain>;
     /**
      * Builds and returns the batched transaction based on the configured parameters.
      *
      * @param options - (Optional) Options to customize the batch transaction.
      * @returns A Extrinsic representing the batched transactions.
      */
-    buildBatch(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptions<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>>, options?: TBatchOptions): Promise<TRes>;
-    protected buildInternal<TOptions extends TTransferBaseOptions<TApi, TRes, TSigner>>(this: GeneralBuilder<TApi, TRes, TSigner, TOptions>): Promise<TBuildInternalRes<TApi, TRes, TSigner, TOptions>>;
+    buildBatch(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptions<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>, TCustomChain>, options?: TBatchOptions): Promise<TRes>;
+    protected buildInternal<TOptions extends TTransferBaseOptions<TApi, TRes, TSigner>>(this: GeneralBuilder<TApi, TRes, TSigner, TOptions, TCustomChain>): Promise<TBuildInternalRes<TApi, TRes, TSigner, TOptions>>;
     private prepareNormalizedOptions;
     /**
      * Builds and returns the transfer extrinsic.
      *
      * @returns A Promise that resolves to the transfer extrinsic.
      */
-    build(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptions<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>>): Promise<TRes>;
+    build(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptions<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>, TCustomChain>): Promise<TRes>;
     /**
      * Builds an unsigned EIP-1559 transaction (viem `TransactionSerializableEIP1559`) for an
      * EVM-compatible origin. `nonce`, `gas`, and fees are populated from the origin chain's RPC.
      */
-    buildEvm(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>>): Promise<TransactionSerializableEIP1559>;
+    buildEvm(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>, TCustomChain>): Promise<TransactionSerializableEIP1559>;
     /**
      * Builds and returns multiple transfer or swap extrinsics
      *
      * @returns A Promise that resolves to the transfer extrinsic contexts
      */
-    buildAll(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptions<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>>): Promise<TTransactionContext<TApi, TRes>[]>;
+    buildAll(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptions<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>, TCustomChain>): Promise<TTransactionContext<TApi, TRes>[]>;
     private validateBatchState;
     private buildCommon;
     private buildCommonAll;
     private maybePerformXcmFormatCheck;
-    dryRun(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>>): Promise<TDryRunResult>;
-    dryRunPreview(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>>, dryRunOptions?: TDryRunPreviewOptions): Promise<TDryRunResult>;
-    protected createTxFactory<TOptions extends TTransferBaseOptions<TApi, TRes, TSigner>>(this: GeneralBuilder<TApi, TRes, TSigner, TOptions>): TTxFactory<TRes>;
+    dryRun(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>, TCustomChain>): Promise<TDryRunResult>;
+    dryRunPreview(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>, TCustomChain>, dryRunOptions?: TDryRunPreviewOptions): Promise<TDryRunResult>;
+    protected createTxFactory<TOptions extends TTransferBaseOptions<TApi, TRes, TSigner>>(this: GeneralBuilder<TApi, TRes, TSigner, TOptions, TCustomChain>): TTxFactory<TRes>;
     /**
      * Returns the XCM fee for the transfer using dryRun or paymentInfo function.
      *
      * @returns An origin and destination fee.
      */
-    getXcmFee<TDisableFallback extends boolean = false>(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>>, options?: TGetXcmFeeBuilderOptions & {
+    getXcmFee<TDisableFallback extends boolean = false>(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>, TCustomChain>, options?: TGetXcmFeeBuilderOptions & {
         disableFallback: TDisableFallback;
     }): Promise<TGetXcmFeeResult<TDisableFallback>>;
     /**
@@ -861,7 +880,7 @@ declare class GeneralBuilder<TApi, TRes, TSigner, T extends Partial<TTransferBas
      *
      * @returns An origin fee.
      */
-    getOriginXcmFee<TDisableFallback extends boolean = false>(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>>, options?: TGetXcmFeeBuilderOptions & {
+    getOriginXcmFee<TDisableFallback extends boolean = false>(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>, TCustomChain>, options?: TGetXcmFeeBuilderOptions & {
         disableFallback: TDisableFallback;
     }): Promise<TXcmFeeDetailWithForwardedXcm<TDisableFallback>>;
     /**
@@ -869,38 +888,38 @@ declare class GeneralBuilder<TApi, TRes, TSigner, T extends Partial<TTransferBas
      *
      * @returns The max transferable amount.
      */
-    getTransferableAmount(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>>): Promise<bigint>;
+    getTransferableAmount(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>, TCustomChain>): Promise<bigint>;
     /**
      * Returns the min transferable amount for the transfer
      *
      * @returns The min transferable amount.
      */
-    getMinTransferableAmount(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>>): Promise<bigint>;
+    getMinTransferableAmount(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>, TCustomChain>): Promise<bigint>;
     /**
      * Returns the max transferable amount for the transfer
      *
      * @returns The max transferable amount.
      */
-    verifyEdOnDestination(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>>): Promise<boolean>;
+    verifyEdOnDestination(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>, TCustomChain>): Promise<boolean>;
     /**
      * Returns the transfer info for the transfer
      *
      * @returns The transfer info.
      */
-    getTransferInfo(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>>): Promise<TTransferInfo>;
+    getTransferInfo(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>, TCustomChain>): Promise<TTransferInfo>;
     /**
      * Returns the receivable amount on the destination after the transfer
      *
      * @returns The computed receivable amount.
      * @throws \{UnableToComputeError\} Thrown when the receivable amount cannot be determined.
      */
-    getReceivableAmount(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>>): Promise<bigint>;
-    getBestAmountOut(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSwap<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>>): Promise<{
+    getReceivableAmount(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>, TCustomChain>): Promise<bigint>;
+    getBestAmountOut(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSwap<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>, TCustomChain>): Promise<{
         exchange: TExchangeChain;
         amountOut: bigint;
     }>;
-    signAndSubmit(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>>): Promise<string>;
-    signAndSubmitAll(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>>): Promise<string[]>;
+    signAndSubmit(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>, TCustomChain>): Promise<string>;
+    signAndSubmitAll(this: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptionsWithSender<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>, TCustomChain>): Promise<string[]>;
     private executeWithEvmSigner;
     private prepareEvmDispatch;
     /**
@@ -922,7 +941,61 @@ declare class GeneralBuilder<TApi, TRes, TSigner, T extends Partial<TTransferBas
  * @param api - The API instance to use for building transactions. If not provided, a new instance will be created.
  * @returns A new Builder instance.
  */
-declare const Builder: <TApi, TRes, TSigner>(api: PolkadotApi<TApi, TRes, TSigner>) => GeneralBuilder<TApi, TRes, TSigner, object>;
+declare const Builder: <TApi, TRes, TSigner, TCustomChain extends string = never>(api: PolkadotApi<TApi, TRes, TSigner>) => GeneralBuilder<TApi, TRes, TSigner, object, TCustomChain>;
+
+type TProviderEntry = {
+    name: string;
+    endpoint: string;
+};
+type TChainConfig = {
+    name: string;
+    info: string;
+    paraId: number;
+    providers: TProviderEntry[];
+};
+type TChainConfigMap = Record<TSubstrateChain, TChainConfig>;
+
+type TCustomChainPalletsInput = {
+    nativeAssets?: TAssetsPallet;
+    otherAssets?: TAssetsPallet[];
+};
+type TCustomChainInput = {
+    paraId: number;
+    ecosystem: TRelaychain;
+    providers: TProviderEntry[];
+    xcmVersion: Version;
+    ss58Prefix?: number;
+    nativeAssetSymbol?: string;
+    nativeAssetDecimals?: number;
+    assets?: TCustomAssetInfo[];
+    pallets?: TCustomChainPalletsInput;
+};
+type TCustomChainsMap = Record<string, TCustomChainInput>;
+type TCustomChainEntry = {
+    name: string;
+    paraId: number;
+    ecosystem: TRelaychain;
+    providers: TProviderEntry[];
+    xcmVersion: Version;
+    ss58Prefix?: number;
+    nativeAssetSymbol?: string;
+    nativeAssetDecimals?: number;
+    assets: TAssetInfo[];
+    pallets?: TCustomChainPallets;
+};
+type TCustomChainEntryHydrated = TCustomChainEntry & {
+    xcmPallet: TCrosschainPallet;
+    isEVM: boolean;
+    supportsDryRunApi: boolean;
+    supportsXcmPaymentApi: boolean;
+    nativeExistentialDeposit?: string;
+    pallets: TCustomChainPallets;
+};
+type TCustomChainsCtx = Record<string, TCustomChainEntry>;
+type TFullCustomCtx = TCustomCtx & {
+    customChains?: TCustomChainsCtx;
+    customChainPallets?: Record<string, TCustomChainPallets>;
+};
 
 type TEvmTransferOptionsBase = {
     from: TChain;
@@ -967,10 +1040,15 @@ type TDryRunPreviewOptions = {
 type TBuilderOptions<TApi> = TApi | TBuilderConfig<TApi>;
 type TBuilderConfig<TApi> = Partial<{
     apiOverrides: Partial<Record<TChain, TApi>>;
+    customAssets: TCustomAssetsMap;
+    customChains: TCustomChainsMap;
     development: boolean;
     abstractDecimals: boolean;
     xcmFormatCheck: boolean;
 }>;
+type TCustomChainFrom<TOpts> = TOpts extends {
+    customChains: infer C;
+} ? Extract<keyof C, string> : never;
 type TCreateTxsOptions<TApi, TRes, TSigner> = Pick<TTransferOptions<TApi, TRes, TSigner>, 'api' | 'from' | 'to' | 'currency'>;
 type TBatchedTransferOptions<TApi, TRes, TSigner> = Omit<TSubstrateTransferOptions<TApi, TRes, TSigner>, 'isAmountAll'> & {
     builder: GeneralBuilder<TApi, TRes, TSigner, TTransferBaseOptions<TApi, TRes, TSigner> & TBuilderInternalOptions<TSigner>>;
@@ -1272,6 +1350,21 @@ declare class BridgeHaltedError extends Error {
     constructor();
 }
 
+/**
+ * Error thrown when a custom chain name collides with a built-in chain.
+ */
+declare class CustomChainConflictError extends Error {
+    constructor(msg: string);
+}
+
+/**
+ * Error thrown when a custom chain definition is missing required fields or
+ * carries invalid values.
+ */
+declare class CustomChainInvalidError extends Error {
+    constructor(msg: string);
+}
+
 /**
  * Error thrown when the Dry Run fails.
  */
@@ -1322,13 +1415,13 @@ declare class InvalidAddressError extends Error {
 /**
  * Error development mode is on and no API override is provided for a specific chain.
  */
-declare class MissingChainApiError extends Error {
+declare class MissingChainApiError<TCustomChain extends string = never> extends Error {
     /**
      * Constructs a new MissingChainApiError.
      *
      * @param chain - The chain for which the API is missing.
      */
-    constructor(chain: TChain);
+    constructor(chain: TChain | TCustomChain);
 }
 
 /**
@@ -1341,13 +1434,13 @@ declare class MissingParameterError extends Error {
 /**
  * Used to inform user, that Parachain they wish to use has not yet implemented full XCM Support
  */
-declare class NoXCMSupportImplementedError extends Error {
+declare class NoXCMSupportImplementedError<TCustomChain extends string = never> extends Error {
     /**
      * Constructs a new NoXCMSupportImplementedError.
      *
      * @param chain - The chain for which XCM support is not implemented.
      */
-    constructor(chain: TChain);
+    constructor(chain: TChain | TCustomChain);
 }
 
 /**
@@ -2016,7 +2109,7 @@ type TSetBalanceRes = {
 declare abstract class BaseAssetsPallet {
     protected palletName: TAssetsPallet;
     constructor(palletName: TAssetsPallet);
-    abstract mint<TApi, TRes, TSigner>(address: string, assetInfo: WithAmount<TAssetInfo>, balance: bigint, chain: TSubstrateChain, api: PolkadotApi<TApi, TRes, TSigner>): Promise<TSetBalanceRes>;
+    abstract mint<TApi, TRes, TSigner>(api: PolkadotApi<TApi, TRes, TSigner>, address: string, assetInfo: WithAmount<TAssetInfo>, balance: bigint, chain: TSubstrateChain): Promise<TSetBalanceRes>;
     abstract getBalance<TApi, TRes, TSigner>(api: PolkadotApi<TApi, TRes, TSigner>, address: string, asset: TAssetInfo, customCurrencyId?: unknown): Promise<bigint>;
 }
 
@@ -2103,18 +2196,6 @@ type TVerifyEdOnDestinationOptionsBase<TRes> = {
 };
 type TVerifyEdOnDestinationOptions<TApi, TRes, TSigner> = WithApi<TVerifyEdOnDestinationOptionsBase<TRes>, TApi, TRes, TSigner>;
 
-type TProviderEntry = {
-    name: string;
-    endpoint: string;
-};
-type TChainConfig = {
-    name: string;
-    info: string;
-    paraId: number;
-    providers: TProviderEntry[];
-};
-type TChainConfigMap = Record<TSubstrateChain, TChainConfig>;
-
 type OneKey<K extends string, V = unknown> = {
     [P in K]: Record<P, V> & Partial<Record<Exclude<K, P>, never>> extends infer O ? {
         [Q in keyof O]: O[Q];
@@ -2205,17 +2286,24 @@ declare const getEthErc20Balance: (chain: TExternalChain, asset: TAssetInfo, add
 
 declare const getMoonbeamErc20Balance: (chain: TSubstrateChain, assetId: string, address: string) => Promise<bigint>;
 
+declare const getChainConfigImpl: <TCustomChain extends string = never>(chain: TSubstrateChain | TCustomChain, ctx?: TFullCustomCtx) => TChainConfig;
 declare const getChainConfig: (chain: TSubstrateChain) => TChainConfig;
 
+declare const getChainProvidersImpl: <TCustomChain extends string = never>(chain: TSubstrateChain | TCustomChain, ctx?: TFullCustomCtx) => string[];
 declare const getChainProviders: (chain: TSubstrateChain) => string[];
 
+declare const getParaIdImpl: <TCustomChain extends string = never>(chain: TChain | TCustomChain, ctx?: TFullCustomCtx) => number;
 /**
  * Retrieves the parachain ID for a specified chain.
  *
  * @param chain - The chain for which to get the paraId.
  * @returns The parachain ID of the chain.
  */
-declare const getParaId: (chain: TChain) => number;
+declare const getParaId: <TCustomChain extends string = never>(chain: TChain | TCustomChain) => number;
+
+declare const normalizeCustomChains: (map: TCustomChainsMap | undefined) => TCustomChainsCtx;
+declare const buildCustomChainConfig: (entry: TCustomChainEntry) => TChainConfig;
+declare const buildCustomChainAssetsInfo: (entry: TCustomChainEntryHydrated) => TChainAssetsInfo;
 
 /**
  * Retrieves the chain name corresponding to a specified parachain ID.
@@ -2358,7 +2446,7 @@ declare const createTypeAndThenCall: <TApi, TRes, TSigner>(options: TPolkadotXCM
 declare const createTypeThenAutoReserve: <TApi, TRes, TSigner>(chain: TSubstrateChain, options: TPolkadotXCMTransferOptions<TApi, TRes, TSigner>) => Promise<TSerializedExtrinsics>;
 
 declare const validateCurrency: (currency: TCurrencyInput, feeAsset?: TCurrencyInput) => void;
-declare const validateDestination: (origin: TSubstrateChain, destination: TDestination) => void;
+declare const validateDestination: <TApi, TRes, TSigner>(origin: TSubstrateChain, destination: TDestination, api: PolkadotApi<TApi, TRes, TSigner>) => void;
 declare const validateAssetSpecifiers: (assetCheckEnabled: boolean, currency: TCurrencyInput) => void;
 declare const validateTransact: <TApi, TRes, TSigner>({ api, from, to, sender, recipient: address, transactOptions }: TSubstrateTransferOptions<TApi, TRes, TSigner>) => ValidationError | undefined;
 
@@ -2403,8 +2491,9 @@ declare const createTransferOrSwapAll: <TApi, TRes, TSigner>(options: TSubstrate
 declare const createTransferOrSwap: <TApi, TRes, TSigner>(options: TSubstrateTransferOptions<TApi, TRes, TSigner>) => Promise<TRes>;
 
 declare const getAssetReserveChain: (chain: TSubstrateChain, assetLocation: TLocation, resolveExternalReserve?: boolean) => TChain;
+declare const getAssetReserveChainImpl: <TApi, TRes, TSigner, TCustomChain extends string = never>(api: PolkadotApi<TApi, TRes, TSigner>, chain: TSubstrateChain | TCustomChain, assetLocation: TLocation, resolveExternalReserve?: boolean) => TChain | TCustomChain;
 
-declare const getChainVersion: <TApi, TRes, TSigner>(chain: TChain) => Version;
+declare const getChainVersion: <TApi, TRes, TSigner>(api: PolkadotApi<TApi, TRes, TSigner>, chain: TChain) => Version;
 
 /**
  * Gets the relay chain (Polkadot, Kusama, Westend, or Paseo) of a given chain.
@@ -2413,6 +2502,15 @@ declare const getChainVersion: <TApi, TRes, TSigner>(chain: TChain) => Version;
  * @returns The corresponding relay chain.
  */
 declare const getRelayChainOf: (chain: TSubstrateChain) => TRelaychain;
+declare const getRelayChainOfImpl: <TApi, TRes, TSigner, TCustomChain extends string = never>(api: PolkadotApi<TApi, TRes, TSigner>, chain: TSubstrateChain | TCustomChain) => TRelaychain;
+
+/**
+ * Gets the native asset symbol of the relay chain that the given chain belongs to.
+ *
+ * @param chain - The chain to evaluate.
+ * @returns The native asset symbol of the corresponding relay chain.
+ */
+declare const getRelayChainSymbolOf: (chain: TSubstrateChain) => string;
 
 declare const createChainClient: <TApi, TRes, TSigner>(api: PolkadotApi<TApi, TRes, TSigner>, chain: TSubstrateChain) => Promise<TApi>;
 
@@ -2445,31 +2543,23 @@ declare const isViemSigner: (value: unknown) => value is WalletClient;
 declare const createBeneficiaryLocXTokens: <TApi, TRes, TSigner>({ api, recipient, origin, destination, version, paraId }: TCreateBeneficiaryXTokensOptions<TApi, TRes, TSigner>) => TLocation;
 declare const createBeneficiaryLocation: <TApi, TRes, TSigner>({ api, address, version }: TCreateBeneficiaryOptions<TApi, TRes, TSigner>) => TLocation;
 
-declare const createDestination: (version: Version, origin: TChain, destination: TDestination, chainId?: number, junction?: TJunction, parents?: Parents) => TLocation;
-declare const createVersionedDestination: (version: Version, origin: TSubstrateChain, destination: TDestination, chainId?: number, junction?: TJunction, parents?: Parents) => TXcmVersioned<TLocation>;
+declare const createDestination: <TApi, TRes, TSigner, TCustomChain extends string = never>(api: PolkadotApi<TApi, TRes, TSigner>, version: Version, origin: TChain | TCustomChain, destination: TDestination, chainId?: number, junction?: TJunction, parents?: Parents) => TLocation;
+declare const createVersionedDestination: <TApi, TRes, TSigner>(api: PolkadotApi<TApi, TRes, TSigner>, version: Version, origin: TSubstrateChain, destination: TDestination, chainId?: number, junction?: TJunction, parents?: Parents) => TXcmVersioned<TLocation>;
 
 declare const createX1Payload: (version: Version, junction: TJunction) => TJunctions;
 
 declare const getChainLocation: (chain: TChain, destChain: TChain) => TLocation;
 
-/**
- * This function localizes a location by removing the `Parachain` junction
- * if it exists. The `parents` field is set to `0` either if a `Parachain` was removed
- * or if the resulting interior is `'Here'` and the chain is a relay chain.
- *
- * @param chain - The current chain
- * @param location - The location to localize
- * @returns The localized location
- */
 declare const localizeLocation: (chain: TChain, location: TLocation, origin?: TChain) => TLocation;
+declare const localizeLocationImpl: <TApi, TRes, TSigner, TCustomChain extends string = never>(api: PolkadotApi<TApi, TRes, TSigner>, chain: TChain | TCustomChain, location: TLocation, origin?: TChain | TCustomChain) => TLocation;
 
 declare const reverseTransformLocation: (location: TLocation) => TLocation;
 
 declare const normalizeAmount: (amount: bigint) => bigint;
 
-declare const resolveDestChain: (originChain: TSubstrateChain, paraId: number | undefined) => "AssetHubPolkadot" | "Acala" | "Ajuna" | "Astar" | "BifrostPolkadot" | "BridgeHubPolkadot" | "Centrifuge" | "Darwinia" | "EnergyWebX" | "Hydration" | "Interlay" | "Heima" | "Jamton" | "Moonbeam" | "CoretimePolkadot" | "Collectives" | "Crust" | "NeuroWeb" | "Pendulum" | "Mythos" | "Peaq" | "PeoplePolkadot" | "Unique" | "Xode" | "AssetHubKusama" | "BridgeHubKusama" | "Karura" | "Kintsugi" | "Moonriver" | "CoretimeKusama" | "Encointer" | "Basilisk" | "BifrostKusama" | "CrustShadow" | "Crab" | "Laos" | "Quartz" | "RobonomicsPolkadot" | "PeopleKusama" | "Shiden" | "Zeitgeist" | "AssetHubWestend" | "BridgeHubWestend" | "CollectivesWestend" | "CoretimeWestend" | "Penpal" | "PeopleWestend" | "AjunaPaseo" | "AssetHubPaseo" | "BifrostPaseo" | "BridgeHubPaseo" | "CoretimePaseo" | "EnergyWebXPaseo" | "HeimaPaseo" | "HydrationPaseo" | "LaosPaseo" | "NeuroWebPaseo" | "PeoplePaseo" | "ZeitgeistPaseo" | undefined;
+declare const resolveDestChain: <TApi, TRes, TSigner, TCustomChain extends string = never>(api: PolkadotApi<TApi, TRes, TSigner>, originChain: TSubstrateChain | TCustomChain, paraId: number | undefined) => "AssetHubPolkadot" | "Acala" | "Ajuna" | "Astar" | "BifrostPolkadot" | "BridgeHubPolkadot" | "Centrifuge" | "Darwinia" | "EnergyWebX" | "Hydration" | "Interlay" | "Heima" | "Jamton" | "Moonbeam" | "CoretimePolkadot" | "Collectives" | "Crust" | "NeuroWeb" | "Pendulum" | "Mythos" | "Peaq" | "PeoplePolkadot" | "Unique" | "Xode" | "AssetHubKusama" | "BridgeHubKusama" | "Karura" | "Kintsugi" | "Moonriver" | "CoretimeKusama" | "Encointer" | "Basilisk" | "BifrostKusama" | "CrustShadow" | "Crab" | "Quartz" | "RobonomicsPolkadot" | "PeopleKusama" | "Shiden" | "Zeitgeist" | "AssetHubWestend" | "BridgeHubWestend" | "CollectivesWestend" | "CoretimeWestend" | "Penpal" | "PeopleWestend" | "AjunaPaseo" | "AssetHubPaseo" | "BifrostPaseo" | "BridgeHubPaseo" | "CoretimePaseo" | "EnergyWebXPaseo" | "HeimaPaseo" | "HydrationPaseo" | "NeuroWebPaseo" | "PeoplePaseo" | "ZeitgeistPaseo" | undefined;
 
-declare const resolveParaId: (paraId: number | undefined, destination: TDestination) => number | undefined;
+declare const resolveParaId: <TApi, TRes, TSigner>(paraId: number | undefined, destination: TDestination, api: PolkadotApi<TApi, TRes, TSigner>) => number | undefined;
 
 declare const convertBuilderConfig: <TApi>(config: TBuilderOptions<TApiOrUrl<TApi>> | undefined) => TBuilderConfig<TUrl> | undefined;
 declare const createSwapBuilder: <TApi, TRes, TSigner>(options: TTransferOptionsWithSwap<TApi, TRes, TSigner>) => TSwapBuilder<TApi, TRes, TSigner>;
@@ -2490,7 +2580,7 @@ declare const createAssetsFilter: (asset: TAsset, version: Version) => {
     };
 };
 
-declare const createBaseExecuteXcm: <TRes>(options: TCreateBaseTransferXcmOptions<TRes> & {
+declare const createBaseExecuteXcm: <TApi, TRes, TSigner>(options: TCreateTransferXcmOptions<TApi, TRes, TSigner> & {
     suffixXcm?: unknown[];
 }) => unknown[];
 
@@ -2517,8 +2607,8 @@ declare const formatUnits: typeof formatUnits$1;
 
 declare const addXcmVersionHeader: <T, V extends Version>(obj: T, version: V) => OneKey<V, T>;
 declare const selectXcmVersion: (forcedVersion: Version | undefined, originVersion: Version, destMaxVersion?: Version) => Version;
-declare const pickCompatibleXcmVersion: (origin: TSubstrateChain, destination: TDestination, override?: Version) => Version;
-declare const pickRouterCompatibleXcmVersion: (origin: TSubstrateChain | undefined, exchangeChain: TSubstrateChain, destination: TChain | undefined) => Version;
+declare const pickCompatibleXcmVersion: <TApi, TRes, TSigner>(api: PolkadotApi<TApi, TRes, TSigner>, origin: TSubstrateChain, destination: TDestination, override?: Version) => Version;
+declare const pickRouterCompatibleXcmVersion: <TApi, TRes, TSigner>(api: PolkadotApi<TApi, TRes, TSigner>, origin: TSubstrateChain | undefined, exchangeChain: TSubstrateChain, destination: TChain | undefined) => Version;
 
-export { API_TYPES, AmountTooLowError, ApiNotInitializedError, AssetClaimBuilder, BaseAssetsPallet, BatchMode, BatchValidationError, BridgeHaltedError, Builder, DEFAULT_TTL_MS, DRY_RUN_CLIENT_TIMEOUT_MS, DryRunFailedError, ETH_MAINNET_CHAIN_ID, ETH_TESTNET_CHAIN_ID, EXCHANGE_CHAINS, EXTENSION_MS, ExtensionNotInstalledError, FeatureTemporarilyDisabledError, GeneralBuilder, InvalidAddressError, MAX_CLIENTS, MissingChainApiError, MissingParameterError, NoXCMSupportImplementedError, NumberFormatError, OverrideConflictError, PolkadotApi, PolkadotXcmError, PolkadotXcmExecutionError, ProviderUnavailableError, RELAY_LOCATION, RoutingResolutionError, RuntimeApiError, RuntimeApiUnavailableError, ScenarioNotSupportedError, SubmitTransactionError, TRANSACT_ORIGINS, TX_CLIENT_TIMEOUT_MS, TransferToAhNotSupported, TypeAndThenUnavailableError, UnableToComputeError, UnsupportedOperationError, ValidationError, XTokensError, abstractDecimals, addEthereumBridgeFees, addXcmVersionHeader, aggregateHopFees, applyDecimalAbstraction, assertAddressIsString, assertCurrencyCore, assertEvmAddress, assertExtensionInstalled, assertHasId, assertNotEvmTransfer, assertSender, assertSenderSource, assertSubstrateOrigin, assertSwapSupport, assertToIsString, blake2b256, blake2b512, buildDestInfo, buildHopInfo, buildOriginInfo, calcPreviewMintAmount, claimAssets, compareAddresses, computeOverridenAmount, constructTypeAndThenCall, convertBuilderConfig, convertSs58, createAsset, createAssetId, createAssetsFilter, createBaseExecuteXcm, createBeneficiaryLocXTokens, createBeneficiaryLocation, createChainClient, createClientCache, createClientPoolHelpers, createCustomXcmOnDest, createDestination, createDirectExecuteXcm, createEthereumBridgeInstructions, createExecuteCall, createExecuteExchangeXcm, createSwapBuilder, createTransfer, createTransferOrSwap, createTransferOrSwapAll, createTxOverrideAmount, createTypeAndThenCall, createTypeThenAutoReserve, createVersionedAssets, createVersionedDestination, createX1Payload, deriveAccountId, dryRun, dryRunInternal, dryRunOrigin, encodeSs58, executeWithSwap, formatAssetIdToERC20, formatUnits, generateMessageId, getAssetBalanceInternal, getAssetReserveChain, getBalance, getBalanceInternal, getBridgeStatus, getChain, getChainConfig, getChainLocation, getChainProviders, getChainVersion, getEthErc20Balance, getEvmExtensionOrThrow, getEvmPrivateKeyHex, getEvmSnowbridgeExtensionOrThrow, getFailureInfo, getLocalTransferAmount, getMinTransferableAmount, getMinTransferableAmountInternal, getMoonbeamErc20Balance, getOriginXcmFee, getOriginXcmFeeInternal, getParaEthTransferFees, getParaId, getRelayChainOf, getSwapExtensionOrThrow, getTChain, getTransferInfo, getTransferableAmount, getTransferableAmountInternal, getXcmFee, getXcmFeeInternal, getXcmFeeOnce, handleExecuteTransfer, handleSwapExecuteTransfer, handleToAhTeleport, isConfig, isSenderSigner, isViemSigner, keyFromWs, localizeLocation, maybeOverrideAsset, maybeOverrideAssets, normalizeAmount, normalizeExchange, overrideTxAmount, padFee, padValueBy, parseUnits, pickCompatibleXcmVersion, pickRouterCompatibleXcmVersion, registerEvmExtension, registerEvmSnowbridgeExtension, registerSwapExtension, resolveAssetCount, resolveDestChain, resolveModuleError, resolveParaId, resolveTransferParams, reverseTransformLocation, selectXcmVersion, sortAssets, throwUnsupportedCurrency, transferMoonbeamEvm, transferMoonbeamToEth, traverseXcmHops, validateAddress, validateAssetSpecifiers, validateCurrency, validateDestination, validateDestinationAddress, validateTransact, verifyEdOnDestination, wrapTxBypass };
-export type { BuildHopInfoOptions, ClientCache, HopProcessParams, HopTraversalConfig, HopTraversalResult, IPolkadotXCMTransfer, IXTokensTransfer, OneKey, TAddress, TApiOrUrl, TApiType, TAssetClaimInternalOptions, TAssetClaimOptions, TAssetClaimOptionsBase, TBatchOptions, TBatchedTransferOptions, TBifrostToken, TBridgeStatus, TBuildAllInternalRes, TBuildDestInfoOptions, TBuildEvmTransferOptions, TBuildInternalRes, TBuildInternalResBase, TBuildOriginInfoOptions, TBuilderConfig, TBuilderInternalOptions, TBuilderOptions, TBypassOptions, TCacheItem, TChainConfig, TChainConfigMap, TChainEndpoint, TChainWithApi, TClientEntry, TClientKey, TConditionalXcmFeeDetail, TConditionalXcmFeeHopInfo, TCreateBaseSwapXcmOptions, TCreateBaseTransferXcmOptions, TCreateBeneficiaryOptions, TCreateBeneficiaryXTokensOptions, TCreateEthBridgeInstructionsOptions, TCreateSwapXcmInternalOptions, TCreateSwapXcmOptions, TCreateTransferXcmOptions, TCreateTxsOptions, TDestWeight, TDestination, TDryRunBaseOptions, TDryRunBypassOptions, TDryRunCallBaseOptions, TDryRunCallOptions, TDryRunChainFailure, TDryRunChainResult, TDryRunChainSuccess, TDryRunError, TDryRunOptions, TDryRunPreviewOptions, TDryRunResBase, TDryRunResult, TDryRunXcmBaseOptions, TDryRunXcmOptions, TEvmExtension, TEvmSnowbridgeExtension, TEvmTransferOptions, TEvmTransferOptionsBase, TExchangeChain, TExchangeInput, TFeeType, TForeignAssetId, TForeignOrNativeAsset, TForeignOrTokenAsset, TGetAssetBalanceOptions, TGetAssetBalanceOptionsBase, TGetBalanceCommonOptions, TGetBalanceOptions, TGetBalanceOptionsBase, TGetFeeForDestChainBaseOptions, TGetFeeForDestChainOptions, TGetMinTransferableAmountOptions, TGetOriginXcmFeeBaseOptions, TGetOriginXcmFeeInternalOptions, TGetOriginXcmFeeOptions, TGetReverseTxFeeOptions, TGetTransferInfoOptions, TGetTransferInfoOptionsBase, TGetTransferableAmountOptions, TGetTransferableAmountOptionsBase, TGetXcmFeeBaseOptions, TGetXcmFeeBuilderOptions, TGetXcmFeeInternalOptions, TGetXcmFeeOptions, TGetXcmFeeResult, THopInfo, THopTransferInfo, TModuleError, TNativeTokenAsset, TOriginFeeDetails, TOtherReserveAsset, TPaymentInfo, TPolkadotXCMTransferOptions, TPolkadotXcmMethod, TProviderEntry, TReserveAsset, TResolveHopParams, TScenario, TSelfReserveAsset, TSender, TSerializedExtrinsics, TSerializedRuntimeApiQuery, TSerializedStateQuery, TSetBalanceRes, TStatusChangeCallback, TSubstrateTransferBaseOptions, TSubstrateTransferBaseOptionsWithSender, TSubstrateTransferOptions, TSwapBuilder, TSwapBuilderFactory, TSwapConfig, TSwapEvent, TSwapEventType, TSwapExtension, TSwapFeeEstimates, TSwapOptions, TTransactOptions, TTransactOrigin, TTransactionContext, TTransactionType, TTransferBaseOptions, TTransferBaseOptionsWithSender, TTransferBaseOptionsWithSwap, TTransferFeeEstimates, TTransferInfo, TTransferInternalOptions, TTransferLocalOptions, TTransferOptions, TTransferOptionsWithSwap, TTxFactory, TTypeAndThenCallContext, TTypeAndThenFees, TTypeAndThenOverrides, TUrl, TVerifyEdOnDestinationOptions, TVerifyEdOnDestinationOptionsBase, TWeight, TXTokensCurrencySelection, TXTokensMethod, TXTokensTransferOptions, TXcmAsset, TXcmFeeBase, TXcmFeeDetail, TXcmFeeDetailError, TXcmFeeDetailSuccess, TXcmFeeDetailWithFallback, TXcmFeeDetailWithForwardedXcm, TXcmFeeHopInfo, TXcmFeeHopResult, TXcmFeeSwapConfig, TXcmForeignAsset, TXcmPalletMethod, TXcmVersioned, TZeitgeistAsset, WithApi, WithRequiredSender, WithRequiredSwapOptions };
+export { API_TYPES, AmountTooLowError, ApiNotInitializedError, AssetClaimBuilder, BaseAssetsPallet, BatchMode, BatchValidationError, BridgeHaltedError, Builder, CustomChainConflictError, CustomChainInvalidError, DEFAULT_TTL_MS, DRY_RUN_CLIENT_TIMEOUT_MS, DryRunFailedError, ETH_MAINNET_CHAIN_ID, ETH_TESTNET_CHAIN_ID, EXCHANGE_CHAINS, EXTENSION_MS, ExtensionNotInstalledError, FeatureTemporarilyDisabledError, GeneralBuilder, InvalidAddressError, MAX_CLIENTS, MissingChainApiError, MissingParameterError, NoXCMSupportImplementedError, NumberFormatError, OverrideConflictError, PolkadotApi, PolkadotXcmError, PolkadotXcmExecutionError, ProviderUnavailableError, RELAY_LOCATION, RoutingResolutionError, RuntimeApiError, RuntimeApiUnavailableError, ScenarioNotSupportedError, SubmitTransactionError, TRANSACT_ORIGINS, TX_CLIENT_TIMEOUT_MS, TransferToAhNotSupported, TypeAndThenUnavailableError, UnableToComputeError, UnsupportedOperationError, ValidationError, XTokensError, abstractDecimals, addEthereumBridgeFees, addXcmVersionHeader, aggregateHopFees, applyDecimalAbstraction, assertAddressIsString, assertCurrencyCore, assertEvmAddress, assertExtensionInstalled, assertHasId, assertNotEvmTransfer, assertSender, assertSenderSource, assertSubstrateOrigin, assertSwapSupport, assertToIsString, blake2b256, blake2b512, buildCustomChainAssetsInfo, buildCustomChainConfig, buildDestInfo, buildHopInfo, buildOriginInfo, calcPreviewMintAmount, claimAssets, compareAddresses, computeOverridenAmount, constructTypeAndThenCall, convertBuilderConfig, convertSs58, createAsset, createAssetId, createAssetsFilter, createBaseExecuteXcm, createBeneficiaryLocXTokens, createBeneficiaryLocation, createChainClient, createClientCache, createClientPoolHelpers, createCustomXcmOnDest, createDestination, createDirectExecuteXcm, createEthereumBridgeInstructions, createExecuteCall, createExecuteExchangeXcm, createSwapBuilder, createTransfer, createTransferOrSwap, createTransferOrSwapAll, createTxOverrideAmount, createTypeAndThenCall, createTypeThenAutoReserve, createVersionedAssets, createVersionedDestination, createX1Payload, deriveAccountId, dryRun, dryRunInternal, dryRunOrigin, encodeSs58, executeWithSwap, formatAssetIdToERC20, formatUnits, generateMessageId, getAssetBalanceInternal, getAssetReserveChain, getAssetReserveChainImpl, getBalance, getBalanceInternal, getBridgeStatus, getChain, getChainConfig, getChainConfigImpl, getChainLocation, getChainProviders, getChainProvidersImpl, getChainVersion, getEthErc20Balance, getEvmExtensionOrThrow, getEvmPrivateKeyHex, getEvmSnowbridgeExtensionOrThrow, getFailureInfo, getLocalTransferAmount, getMinTransferableAmount, getMinTransferableAmountInternal, getMoonbeamErc20Balance, getOriginXcmFee, getOriginXcmFeeInternal, getParaEthTransferFees, getParaId, getParaIdImpl, getRelayChainOf, getRelayChainOfImpl, getRelayChainSymbolOf, getSwapExtensionOrThrow, getTChain, getTransferInfo, getTransferableAmount, getTransferableAmountInternal, getXcmFee, getXcmFeeInternal, getXcmFeeOnce, handleExecuteTransfer, handleSwapExecuteTransfer, handleToAhTeleport, isConfig, isSenderSigner, isViemSigner, keyFromWs, localizeLocation, localizeLocationImpl, maybeOverrideAsset, maybeOverrideAssets, normalizeAmount, normalizeCustomChains, normalizeExchange, overrideTxAmount, padFee, padValueBy, parseUnits, pickCompatibleXcmVersion, pickRouterCompatibleXcmVersion, registerEvmExtension, registerEvmSnowbridgeExtension, registerSwapExtension, resolveAssetCount, resolveDestChain, resolveModuleError, resolveParaId, resolveTransferParams, reverseTransformLocation, selectXcmVersion, sortAssets, throwUnsupportedCurrency, transferMoonbeamEvm, transferMoonbeamToEth, traverseXcmHops, validateAddress, validateAssetSpecifiers, validateCurrency, validateDestination, validateDestinationAddress, validateTransact, verifyEdOnDestination, wrapTxBypass };
+export type { BuildHopInfoOptions, ClientCache, HopProcessParams, HopTraversalConfig, HopTraversalResult, IPolkadotXCMTransfer, IXTokensTransfer, OneKey, TAddress, TApiOrUrl, TApiType, TAssetClaimInternalOptions, TAssetClaimOptions, TAssetClaimOptionsBase, TBatchOptions, TBatchedTransferOptions, TBifrostToken, TBridgeStatus, TBuildAllInternalRes, TBuildDestInfoOptions, TBuildEvmTransferOptions, TBuildInternalRes, TBuildInternalResBase, TBuildOriginInfoOptions, TBuilderConfig, TBuilderInternalOptions, TBuilderOptions, TBypassOptions, TCacheItem, TChainConfig, TChainConfigMap, TChainEndpoint, TChainWithApi, TClientEntry, TClientKey, TConditionalXcmFeeDetail, TConditionalXcmFeeHopInfo, TCreateBaseSwapXcmOptions, TCreateBaseTransferXcmOptions, TCreateBeneficiaryOptions, TCreateBeneficiaryXTokensOptions, TCreateEthBridgeInstructionsOptions, TCreateSwapXcmInternalOptions, TCreateSwapXcmOptions, TCreateTransferXcmOptions, TCreateTxsOptions, TCustomChainEntry, TCustomChainEntryHydrated, TCustomChainFrom, TCustomChainInput, TCustomChainPalletsInput, TCustomChainsCtx, TCustomChainsMap, TDestWeight, TDestination, TDryRunBaseOptions, TDryRunBypassOptions, TDryRunCallBaseOptions, TDryRunCallOptions, TDryRunChainFailure, TDryRunChainResult, TDryRunChainSuccess, TDryRunError, TDryRunOptions, TDryRunPreviewOptions, TDryRunResBase, TDryRunResult, TDryRunXcmBaseOptions, TDryRunXcmOptions, TEvmExtension, TEvmSnowbridgeExtension, TEvmTransferOptions, TEvmTransferOptionsBase, TExchangeChain, TExchangeInput, TFeeType, TForeignAssetId, TForeignOrNativeAsset, TForeignOrTokenAsset, TFullCustomCtx, TGetAssetBalanceOptions, TGetAssetBalanceOptionsBase, TGetBalanceCommonOptions, TGetBalanceOptions, TGetBalanceOptionsBase, TGetFeeForDestChainBaseOptions, TGetFeeForDestChainOptions, TGetMinTransferableAmountOptions, TGetOriginXcmFeeBaseOptions, TGetOriginXcmFeeInternalOptions, TGetOriginXcmFeeOptions, TGetReverseTxFeeOptions, TGetTransferInfoOptions, TGetTransferInfoOptionsBase, TGetTransferableAmountOptions, TGetTransferableAmountOptionsBase, TGetXcmFeeBaseOptions, TGetXcmFeeBuilderOptions, TGetXcmFeeInternalOptions, TGetXcmFeeOptions, TGetXcmFeeResult, THopInfo, THopTransferInfo, TModuleError, TNativeTokenAsset, TOriginFeeDetails, TOtherReserveAsset, TPaymentInfo, TPolkadotXCMTransferOptions, TPolkadotXcmMethod, TProviderEntry, TReserveAsset, TResolveHopParams, TRuntimeApi, TScenario, TSelfReserveAsset, TSender, TSerializedExtrinsics, TSerializedRuntimeApiQuery, TSerializedStateQuery, TSetBalanceRes, TStatusChangeCallback, TSubstrateTransferBaseOptions, TSubstrateTransferBaseOptionsWithSender, TSubstrateTransferOptions, TSwapBuilder, TSwapBuilderFactory, TSwapConfig, TSwapEvent, TSwapEventType, TSwapExtension, TSwapFeeEstimates, TSwapOptions, TSystemProperties, TTransactOptions, TTransactOrigin, TTransactionContext, TTransactionType, TTransferBaseOptions, TTransferBaseOptionsWithSender, TTransferBaseOptionsWithSwap, TTransferFeeEstimates, TTransferInfo, TTransferInternalOptions, TTransferLocalOptions, TTransferOptions, TTransferOptionsWithSwap, TTxFactory, TTypeAndThenCallContext, TTypeAndThenFees, TTypeAndThenOverrides, TUrl, TVerifyEdOnDestinationOptions, TVerifyEdOnDestinationOptionsBase, TWeight, TXTokensCurrencySelection, TXTokensMethod, TXTokensTransferOptions, TXcmAsset, TXcmFeeBase, TXcmFeeDetail, TXcmFeeDetailError, TXcmFeeDetailSuccess, TXcmFeeDetailWithFallback, TXcmFeeDetailWithForwardedXcm, TXcmFeeHopInfo, TXcmFeeHopResult, TXcmFeeSwapConfig, TXcmForeignAsset, TXcmPalletMethod, TXcmVersioned, TZeitgeistAsset, WithApi, WithRequiredSender, WithRequiredSwapOptions };