@talismn/balances 0.0.0-pr2075-20250703111149 → 0.0.0-pr2075-20250707031602

package/dist/declarations/src/NewBalanceModules.d.ts

@@ -0,0 +1,99 @@
+export declare const NEW_BALANCE_MODULES: (import("./modules/IBalanceModule").IBalanceModule<"substrate-native", {
+    symbol?: string | undefined;
+    networkId?: string | undefined;
+    isDefault?: boolean | undefined;
+    decimals?: number | undefined;
+    name?: string | undefined;
+    logo?: string | undefined;
+    coingeckoId?: string | undefined;
+    noDiscovery?: boolean | undefined;
+    mirrorOf?: string | undefined;
+}, import("./modules/substrate-native/config").ModuleConfig, import("./modules/substrate-native/config").MiniMetadataExtra> | import("./modules/IBalanceModule").IBalanceModule<"substrate-assets", {
+    assetId: string;
+    symbol?: string | undefined;
+    networkId?: string | undefined;
+    isDefault?: boolean | undefined;
+    decimals?: number | undefined;
+    name?: string | undefined;
+    logo?: string | undefined;
+    coingeckoId?: string | undefined;
+    noDiscovery?: boolean | undefined;
+    mirrorOf?: string | undefined;
+}, unknown, unknown> | import("./modules/IBalanceModule").IBalanceModule<"substrate-hydration", {
+    onChainId: number;
+    symbol?: string | undefined;
+    networkId?: string | undefined;
+    isDefault?: boolean | undefined;
+    decimals?: number | undefined;
+    name?: string | undefined;
+    logo?: string | undefined;
+    coingeckoId?: string | undefined;
+    noDiscovery?: boolean | undefined;
+    mirrorOf?: string | undefined;
+}, unknown, unknown> | import("./modules/IBalanceModule").IBalanceModule<"substrate-foreignassets", {
+    onChainId: string;
+    symbol?: string | undefined;
+    networkId?: string | undefined;
+    isDefault?: boolean | undefined;
+    decimals?: number | undefined;
+    name?: string | undefined;
+    logo?: string | undefined;
+    coingeckoId?: string | undefined;
+    noDiscovery?: boolean | undefined;
+    mirrorOf?: string | undefined;
+}, unknown, unknown> | import("./modules/IBalanceModule").IBalanceModule<"substrate-psp22", {
+    contractAddress: string;
+    symbol?: string | undefined;
+    networkId?: string | undefined;
+    isDefault?: boolean | undefined;
+    decimals?: number | undefined;
+    name?: string | undefined;
+    logo?: string | undefined;
+    coingeckoId?: string | undefined;
+    noDiscovery?: boolean | undefined;
+    mirrorOf?: string | undefined;
+}, unknown, unknown> | import("./modules/IBalanceModule").IBalanceModule<"substrate-tokens", {
+    symbol: string;
+    decimals: number;
+    existentialDeposit: string;
+    onChainId: string | number;
+    networkId?: string | undefined;
+    isDefault?: boolean | undefined;
+    name?: string | undefined;
+    logo?: string | undefined;
+    coingeckoId?: string | undefined;
+    noDiscovery?: boolean | undefined;
+    mirrorOf?: string | undefined;
+}, import("./modules/substrate-tokens/config").ModuleConfig, import("./modules/substrate-tokens/config").MiniMetadataExtra> | import("./modules/IBalanceModule").IBalanceModule<"evm-erc20", {
+    contractAddress: `0x${string}`;
+    symbol?: string | undefined;
+    networkId?: string | undefined;
+    isDefault?: boolean | undefined;
+    decimals?: number | undefined;
+    name?: string | undefined;
+    logo?: string | undefined;
+    coingeckoId?: string | undefined;
+    noDiscovery?: boolean | undefined;
+    mirrorOf?: string | undefined;
+}, unknown, unknown> | import("./modules/IBalanceModule").IBalanceModule<"evm-uniswapv2", {
+    contractAddress: `0x${string}`;
+    symbol?: string | undefined;
+    networkId?: string | undefined;
+    isDefault?: boolean | undefined;
+    decimals?: number | undefined;
+    name?: string | undefined;
+    logo?: string | undefined;
+    coingeckoId?: string | undefined;
+    noDiscovery?: boolean | undefined;
+    mirrorOf?: string | undefined;
+}, unknown, unknown> | import("./modules/IBalanceModule").IBalanceModule<"evm-native", {
+    symbol?: string | undefined;
+    networkId?: string | undefined;
+    isDefault?: boolean | undefined;
+    decimals?: number | undefined;
+    name?: string | undefined;
+    logo?: string | undefined;
+    coingeckoId?: string | undefined;
+    noDiscovery?: boolean | undefined;
+    mirrorOf?: string | undefined;
+}, unknown, unknown>)[];

package/dist/declarations/src/index.d.ts

@@ -2,3 +2,5 @@ export * from "./BalanceModule";
 export * from "./TalismanBalancesDatabase";
 export * from "./modules";
 export * from "./types";
+export * from "./NewBalanceModules";
+export * from "./version";

package/dist/declarations/src/modules/EvmErc20Module.d.ts

@@ -1,8 +1,8 @@
 import { EvmErc20Token } from "@talismn/chaindata-provider";
+import { erc20Abi } from "viem";
 import z from "zod/v4";
 import { DefaultChainMeta, DefaultModuleConfig, NewBalanceModule } from "../BalanceModule";
 import { NewBalanceType } from "../types";
-import { erc20Abi } from "./abis/erc20";
 import { erc20BalancesAggregatorAbi } from "./abis/erc20BalancesAggregator";
 export { erc20Abi, erc20BalancesAggregatorAbi };
 type ModuleType = "evm-erc20";

package/dist/declarations/src/modules/IBalanceModule.d.ts

@@ -0,0 +1,100 @@
+import type { Address, IBalance } from "@talismn/balances";
+import type { ChainConnector } from "@talismn/chain-connector";
+import type { ChainConnectorEvm } from "@talismn/chain-connector-evm";
+import { AnyMiniMetadata, DotNetworkId, EthNetworkId, Token, TokenId, TokenOfType, TokenType } from "@talismn/chaindata-provider";
+import { Observable } from "rxjs";
+/**
+ * Changes:
+ * - each method is standalone
+ * - decoupled from chaindataProvider (which uses indexedDB so cant be used in node)
+ * - all methods are network specific: this way they can return without waiting on other networks, while still being able to group multiple fetchs in one query
+ * - connector is passed as a parameter on every method that needs one, so that an evm module doesnt need a substrate connector, and also to allow using a module without connector
+ * - miniMetadatas are be fully typed
+ * - TokenConfig would be made much simpler
+ * - the logic about what data to fetch and cache (ex: erc20 symbols/decimals) would be here, where it belongs
+ */
+export type PlatformOf<T extends TokenType> = TokenOfType<T>["platform"];
+export type ConnectorOf<P extends PlatformOf<TokenType>> = P extends "ethereum" ? ChainConnectorEvm : P extends "polkadot" ? ChainConnector : never;
+type DotTransferCallData = {
+    address: string;
+    method: `0x${string}`;
+};
+type EthTransferCallData = {
+    from: string;
+    to: string;
+    data: `0x${string}`;
+    value?: string;
+};
+export type BalanceTransferType = "keep-alive" | "all" | "allow-death";
+type CallDataOf<P extends PlatformOf<TokenType>> = P extends "ethereum" ? EthTransferCallData : P extends "polkadot" ? DotTransferCallData : never;
+export type TokensWithAddresses = Array<[Token, Address[]]>;
+export type FetchBalanceErrors = Array<{
+    tokenId: TokenId;
+    address: Address;
+    error: Error;
+}>;
+export type FetchBalanceResults = {
+    success: IBalance[];
+    errors: FetchBalanceErrors;
+};
+type MiniMetadata<Extra = null> = Omit<AnyMiniMetadata, "extra"> & {
+    extra: Extra;
+};
+export interface IBalanceModule<Type extends TokenType, TokenConfig = unknown, ModuleConfig = unknown, MiniMetadataExtra = unknown> {
+    type: Type;
+    platform: PlatformOf<Type>;
+    getMiniMetadata: (arg: PlatformOf<Type> extends "polkadot" ? {
+        networkId: string;
+        specVersion: number;
+        metadataRpc: `0x${string}`;
+        config?: ModuleConfig;
+    } : never) => PlatformOf<Type> extends "polkadot" ? MiniMetadata<MiniMetadataExtra> : never;
+    fetchTokens: (arg: PlatformOf<Type> extends "polkadot" ? {
+        networkId: DotNetworkId;
+        tokens: TokenConfig[];
+        connector: ChainConnector;
+        miniMetadata: MiniMetadata<MiniMetadataExtra>;
+        cache: Record<TokenId, unknown>;
+    } : PlatformOf<Type> extends "ethereum" ? {
+        networkId: EthNetworkId;
+        tokens: TokenConfig[];
+        connector: ChainConnectorEvm;
+        cache: Record<TokenId, unknown>;
+    } : never) => Promise<TokenOfType<Type>[]>;
+    fetchBalances: (arg: PlatformOf<Type> extends "polkadot" ? {
+        networkId: DotNetworkId;
+        addressesByToken: TokensWithAddresses;
+        connector: ChainConnector;
+        miniMetadata: MiniMetadata<MiniMetadataExtra>;
+    } : PlatformOf<Type> extends "ethereum" ? {
+        networkId: EthNetworkId;
+        addressesByToken: TokensWithAddresses;
+        connector: ChainConnectorEvm;
+    } : never) => Promise<FetchBalanceResults>;
+    subscribeBalances: (arg: PlatformOf<Type> extends "polkadot" ? {
+        networkId: DotNetworkId;
+        addressesByToken: TokensWithAddresses;
+        connector: ChainConnector;
+        miniMetadata: MiniMetadata<MiniMetadataExtra>;
+    } : PlatformOf<Type> extends "ethereum" ? {
+        networkId: EthNetworkId;
+        addressesByToken: TokensWithAddresses;
+        connector: ChainConnectorEvm;
+    } : never) => Observable<FetchBalanceResults>;
+    getTransferCallData: (arg: PlatformOf<Type> extends "polkadot" ? {
+        from: string;
+        to: string;
+        value: string;
+        token: Token;
+        metadataRpc: `0x${string}`;
+        type: BalanceTransferType;
+        connector: ChainConnector;
+        config?: ModuleConfig;
+    } : PlatformOf<Type> extends "ethereum" ? {
+        from: string;
+        to: string;
+        value: string;
+        token: Token;
+    } : never) => CallDataOf<PlatformOf<Type>> | Promise<CallDataOf<PlatformOf<Type>>>;
+}
+export {};

package/dist/declarations/src/modules/abis/index.d.ts

@@ -1 +1,3 @@
 export * from "./multicall";
+export * from "./erc20BalancesAggregator";
+export * from "./uniswapV2Pair";

package/dist/declarations/src/modules/evm-erc20/config.d.ts

@@ -0,0 +1,16 @@
+import z from "zod/v4";
+export declare const MODULE_TYPE: "evm-erc20";
+export declare const PLATFORM: "ethereum";
+export declare const EvmErc20TokenConfigSchema: z.ZodObject<{
+    symbol: z.ZodOptional<z.ZodString>;
+    networkId: z.ZodOptional<z.ZodString>;
+    isDefault: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+    decimals: z.ZodOptional<z.ZodInt>;
+    name: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    logo: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    coingeckoId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    noDiscovery: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+    mirrorOf: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    contractAddress: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+}, z.core.$strict>;
+export type EvmErc20TokenConfig = z.infer<typeof EvmErc20TokenConfigSchema>;

package/dist/declarations/src/modules/evm-erc20/fetchBalances.d.ts

@@ -0,0 +1,3 @@
+import { IBalanceModule } from "../IBalanceModule";
+import { MODULE_TYPE } from "./config";
+export declare const fetchBalances: IBalanceModule<typeof MODULE_TYPE>["fetchBalances"];

package/dist/declarations/src/modules/evm-erc20/fetchTokens.d.ts

@@ -0,0 +1,3 @@
+import { IBalanceModule } from "../IBalanceModule";
+import { EvmErc20TokenConfig, MODULE_TYPE } from "./config";
+export declare const fetchTokens: IBalanceModule<typeof MODULE_TYPE, EvmErc20TokenConfig>["fetchTokens"];

package/dist/declarations/src/modules/evm-erc20/getMiniMetadata.d.ts

@@ -0,0 +1,3 @@
+import { IBalanceModule } from "../IBalanceModule";
+import { MODULE_TYPE } from "./config";
+export declare const getMiniMetadata: IBalanceModule<typeof MODULE_TYPE>["getMiniMetadata"];

package/dist/declarations/src/modules/evm-erc20/getTransferCallData.d.ts

@@ -0,0 +1,3 @@
+import { IBalanceModule } from "../IBalanceModule";
+import { MODULE_TYPE } from "./config";
+export declare const getTransferCallData: IBalanceModule<typeof MODULE_TYPE>["getTransferCallData"];

package/dist/declarations/src/modules/evm-erc20/index.d.ts

@@ -0,0 +1 @@
+export * from "./module";

package/dist/declarations/src/modules/evm-erc20/module.d.ts

@@ -0,0 +1,3 @@
+import { IBalanceModule } from "../IBalanceModule";
+import { EvmErc20TokenConfig, MODULE_TYPE } from "./config";
+export declare const EvmErc20BalanceModule: IBalanceModule<typeof MODULE_TYPE, EvmErc20TokenConfig>;

package/dist/declarations/src/modules/evm-erc20/subscribeBalances.d.ts

@@ -0,0 +1,3 @@
+import { IBalanceModule } from "../IBalanceModule";
+import { MODULE_TYPE } from "./config";
+export declare const subscribeBalances: IBalanceModule<typeof MODULE_TYPE>["subscribeBalances"];

package/dist/declarations/src/modules/evm-erc20/utils.d.ts

@@ -0,0 +1,6 @@
+import { Client } from "viem";
+export declare const getErc20ContractData: (client: Client, contractAddress: `0x${string}`) => Promise<{
+    symbol: string;
+    decimals: number;
+    name: string;
+}>;

package/dist/declarations/src/modules/evm-native/config.d.ts

@@ -0,0 +1,15 @@
+import z from "zod/v4";
+export declare const MODULE_TYPE: "evm-native";
+export declare const PLATFORM: "ethereum";
+export declare const EvmNativeTokenConfigSchema: z.ZodObject<{
+    symbol: z.ZodOptional<z.ZodString>;
+    networkId: z.ZodOptional<z.ZodString>;
+    isDefault: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+    decimals: z.ZodOptional<z.ZodInt>;
+    name: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    logo: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    coingeckoId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    noDiscovery: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+    mirrorOf: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+}, z.core.$strict>;
+export type EvmNativeTokenConfig = z.infer<typeof EvmNativeTokenConfigSchema>;

package/dist/declarations/src/modules/evm-native/fetchBalances.d.ts

@@ -0,0 +1,3 @@
+import { IBalanceModule } from "../IBalanceModule";
+import { MODULE_TYPE } from "./config";
+export declare const fetchBalances: IBalanceModule<typeof MODULE_TYPE>["fetchBalances"];

package/dist/declarations/src/modules/evm-native/fetchTokens.d.ts

@@ -0,0 +1,3 @@
+import { IBalanceModule } from "../IBalanceModule";
+import { EvmNativeTokenConfig, MODULE_TYPE } from "./config";
+export declare const fetchTokens: IBalanceModule<typeof MODULE_TYPE, EvmNativeTokenConfig>["fetchTokens"];

package/dist/declarations/src/modules/evm-native/getMiniMetadata.d.ts

@@ -0,0 +1,3 @@
+import { IBalanceModule } from "../IBalanceModule";
+import { MODULE_TYPE } from "./config";
+export declare const getMiniMetadata: IBalanceModule<typeof MODULE_TYPE>["getMiniMetadata"];

package/dist/declarations/src/modules/evm-native/getTransferCallData.d.ts

@@ -0,0 +1,3 @@
+import { IBalanceModule } from "../IBalanceModule";
+import { MODULE_TYPE } from "./config";
+export declare const getTransferCallData: IBalanceModule<typeof MODULE_TYPE>["getTransferCallData"];

package/dist/declarations/src/modules/evm-native/index.d.ts

@@ -0,0 +1 @@
+export * from "./module";

package/dist/declarations/src/modules/evm-native/module.d.ts

@@ -0,0 +1,3 @@
+import { IBalanceModule } from "../IBalanceModule";
+import { EvmNativeTokenConfig, MODULE_TYPE } from "./config";
+export declare const EvmNativeBalanceModule: IBalanceModule<typeof MODULE_TYPE, EvmNativeTokenConfig>;

package/dist/declarations/src/modules/evm-native/subscribeBalances.d.ts

@@ -0,0 +1,3 @@
+import { IBalanceModule } from "../IBalanceModule";
+import { MODULE_TYPE } from "./config";
+export declare const subscribeBalances: IBalanceModule<typeof MODULE_TYPE>["subscribeBalances"];

package/dist/declarations/src/modules/evm-uniswapv2/config.d.ts

@@ -0,0 +1,16 @@
+import z from "zod/v4";
+export declare const MODULE_TYPE: "evm-uniswapv2";
+export declare const PLATFORM: "ethereum";
+export declare const EvmUniswapV2TokenConfigSchema: z.ZodObject<{
+    symbol: z.ZodOptional<z.ZodString>;
+    networkId: z.ZodOptional<z.ZodString>;
+    isDefault: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+    decimals: z.ZodOptional<z.ZodInt>;
+    name: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    logo: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    coingeckoId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    noDiscovery: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+    mirrorOf: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    contractAddress: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+}, z.core.$strict>;
+export type EvmUniswapV2TokenConfig = z.infer<typeof EvmUniswapV2TokenConfigSchema>;

package/dist/declarations/src/modules/evm-uniswapv2/fetchBalances.d.ts

@@ -0,0 +1,3 @@
+import { IBalanceModule } from "../IBalanceModule";
+import { MODULE_TYPE } from "./config";
+export declare const fetchBalances: IBalanceModule<typeof MODULE_TYPE>["fetchBalances"];

package/dist/declarations/src/modules/evm-uniswapv2/fetchTokens.d.ts

@@ -0,0 +1,3 @@
+import { IBalanceModule } from "../IBalanceModule";
+import { EvmUniswapV2TokenConfig, MODULE_TYPE } from "./config";
+export declare const fetchTokens: IBalanceModule<typeof MODULE_TYPE, EvmUniswapV2TokenConfig>["fetchTokens"];

package/dist/declarations/src/modules/evm-uniswapv2/getMiniMetadata.d.ts

@@ -0,0 +1,3 @@
+import { IBalanceModule } from "../IBalanceModule";
+import { MODULE_TYPE } from "./config";
+export declare const getMiniMetadata: IBalanceModule<typeof MODULE_TYPE>["getMiniMetadata"];

package/dist/declarations/src/modules/evm-uniswapv2/getTransferCallData.d.ts

@@ -0,0 +1,3 @@
+import { IBalanceModule } from "../IBalanceModule";
+import { MODULE_TYPE } from "./config";
+export declare const getTransferCallData: IBalanceModule<typeof MODULE_TYPE>["getTransferCallData"];

package/dist/declarations/src/modules/evm-uniswapv2/index.d.ts

@@ -0,0 +1 @@
+export * from "./module";

package/dist/declarations/src/modules/evm-uniswapv2/module.d.ts

@@ -0,0 +1,3 @@
+import { IBalanceModule } from "../IBalanceModule";
+import { EvmUniswapV2TokenConfig, MODULE_TYPE } from "./config";
+export declare const EvmUniswapV2BalanceModule: IBalanceModule<typeof MODULE_TYPE, EvmUniswapV2TokenConfig>;

package/dist/declarations/src/modules/evm-uniswapv2/subscribeBalances.d.ts

@@ -0,0 +1,3 @@
+import { IBalanceModule } from "../IBalanceModule";
+import { MODULE_TYPE } from "./config";
+export declare const subscribeBalances: IBalanceModule<typeof MODULE_TYPE>["subscribeBalances"];

package/dist/declarations/src/modules/evm-uniswapv2/utils.d.ts

@@ -0,0 +1,12 @@
+import { Client } from "viem";
+export declare const getErc20ContractData: (client: Client, contractAddress: `0x${string}`) => Promise<{
+    symbol: string;
+    decimals: number;
+    name: string;
+}>;
+export declare const getUniswapV2PairContractData: (client: Client, contractAddress: `0x${string}`) => Promise<{
+    token0: `0x${string}`;
+    token1: `0x${string}`;
+    decimals: number;
+    name: string;
+}>;

package/dist/declarations/src/modules/index.d.ts

@@ -12,7 +12,6 @@ export declare const defaultBalanceModules: (import("..").NewBalanceModule<"evm-
     coingeckoId?: string | undefined;
     noDiscovery?: boolean | undefined;
     mirrorOf?: string | undefined;
-    isCustom?: boolean | undefined;
 }, import("..").DefaultChainMeta, undefined, {
     contractAddress: `0x${string}`;
     symbol?: string | undefined;
@@ -97,6 +96,7 @@ export declare const defaultBalanceModules: (import("..").NewBalanceModule<"evm-
     type: "substrate-assets";
     platform: "polkadot";
     assetId: string;
+    isSufficient: boolean;
     existentialDeposit: string;
     isDefault?: boolean | undefined;
     name?: string | undefined;
@@ -124,6 +124,7 @@ export declare const defaultBalanceModules: (import("..").NewBalanceModule<"evm-
     type: "substrate-foreignassets";
     platform: "polkadot";
     onChainId: string;
+    isSufficient: boolean;
     existentialDeposit: string;
     isDefault?: boolean | undefined;
     name?: string | undefined;

package/dist/declarations/src/modules/shared/errors.d.ts

@@ -0,0 +1,11 @@
+import { TokenId } from "@talismn/chaindata-provider";
+import { Address } from "viem";
+export declare class BalanceFetchError extends Error {
+    tokenId: TokenId;
+    address: Address;
+    constructor(message: string, tokenId: TokenId, address: Address, cause?: Error);
+}
+export declare class BalanceFetchNetworkError extends Error {
+    evmNetworkId: string | undefined;
+    constructor(message: string, evmNetworkId?: string, cause?: Error);
+}

package/dist/declarations/src/modules/shared/fetchRuntimeCallResult.d.ts

@@ -0,0 +1,2 @@
+import { ChainConnector } from "@talismn/chain-connector";
+export declare const fetchRuntimeCallResult: <T>(connector: ChainConnector, networkId: string, metadataRpc: `0x${string}`, apiName: string, method: string, args: unknown[]) => Promise<T>;

package/dist/declarations/src/modules/shared/getContantValue.d.ts

@@ -0,0 +1 @@
+export declare const getConstantValue: <T>(metadataRpc: `0x${string}`, pallet: string, constant: string) => T;