@talismn/balances 1.3.7 → 1.5.0

package/dist/index.d.mts

@@ -1,13 +1,13 @@
-import { TokenId, NetworkId, NetworkList, TokenList, TokenType, TokenOfType, Token, DotNetworkId, SolNetworkId, EthNetworkId, AnyMiniMetadata, ChaindataProvider, SubDTaoToken } from '@talismn/chaindata-provider';
+import { TokenId, NetworkId, NetworkList, TokenList, TokenType, TokenOfType, DotNetworkId, SolNetworkId, Token, EthNetworkId, AnyMiniMetadata, ChaindataProvider, SubDTaoToken } from '@talismn/chaindata-provider';
 export { MINIMETADATA_VERSION } from '@talismn/chaindata-provider';
 import { Observable } from 'rxjs';
 import { IChainConnectorDot, IChainConnectorEth, IChainConnectorSol } from '@talismn/chain-connectors';
 import { TransactionInstruction } from '@solana/web3.js';
 import * as _talismn_token_rates from '@talismn/token-rates';
-import { TokenRates, TokenRateCurrency, TokenRatesList } from '@talismn/token-rates';
+import { TokenRatesList, TokenRates, TokenRateCurrency } from '@talismn/token-rates';
 import { NonFunctionProperties } from '@talismn/util';
-import z from 'zod/v4';
 import { bittensor } from '@polkadot-api/descriptors';
+import z from 'zod/v4';
 
 type Address = string;
 
@@ -320,6 +320,7 @@ declare class Balance {
         balancesConfig?: {
             "sol-native"?: Record<string, never> | undefined;
             "sol-spl"?: Record<string, never> | undefined;
+            "sol-token2022"?: Record<string, never> | undefined;
         } | undefined;
     } | null;
     get tokenId(): string;
@@ -511,6 +512,21 @@ declare class Balance {
         coingeckoId?: string | undefined;
         noDiscovery?: boolean | undefined;
         mirrorOf?: string | undefined;
+    } | {
+        id: string;
+        networkId: string;
+        decimals: number;
+        symbol: string;
+        type: "sol-token2022";
+        platform: "solana";
+        mintAddress: string;
+        isDefault?: boolean | undefined;
+        name?: string | undefined;
+        logo?: string | undefined;
+        coingeckoId?: string | undefined;
+        noDiscovery?: boolean | undefined;
+        mirrorOf?: string | undefined;
+        isTransferable?: boolean | undefined;
     } | null;
     get decimals(): number | null;
     get rates(): TokenRates | null;
@@ -1686,9 +1702,9 @@ declare const EvmErc20TokenConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 type EvmErc20TokenConfig = z.infer<typeof EvmErc20TokenConfigSchema>;
 
-declare const MODULE_TYPE$b: "evm-erc20";
+declare const MODULE_TYPE$c: "evm-erc20";
 
-declare const EvmErc20BalanceModule: IBalanceModule<typeof MODULE_TYPE$b, EvmErc20TokenConfig>;
+declare const EvmErc20BalanceModule: IBalanceModule<typeof MODULE_TYPE$c, EvmErc20TokenConfig>;
 
 declare const EvmNativeTokenConfigSchema: z.ZodObject<{
     symbol: z.ZodOptional<z.ZodString>;
@@ -1703,9 +1719,9 @@ declare const EvmNativeTokenConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 type EvmNativeTokenConfig = z.infer<typeof EvmNativeTokenConfigSchema>;
 
-declare const MODULE_TYPE$a: "evm-native";
+declare const MODULE_TYPE$b: "evm-native";
 
-declare const EvmNativeBalanceModule: IBalanceModule<typeof MODULE_TYPE$a, EvmNativeTokenConfig>;
+declare const EvmNativeBalanceModule: IBalanceModule<typeof MODULE_TYPE$b, EvmNativeTokenConfig>;
 
 declare const EvmUniswapV2TokenConfigSchema: z.ZodObject<{
     symbol: z.ZodOptional<z.ZodString>;
@@ -1721,9 +1737,9 @@ declare const EvmUniswapV2TokenConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 type EvmUniswapV2TokenConfig = z.infer<typeof EvmUniswapV2TokenConfigSchema>;
 
-declare const MODULE_TYPE$9: "evm-uniswapv2";
+declare const MODULE_TYPE$a: "evm-uniswapv2";
 
-declare const EvmUniswapV2BalanceModule: IBalanceModule<typeof MODULE_TYPE$9, EvmUniswapV2TokenConfig>;
+declare const EvmUniswapV2BalanceModule: IBalanceModule<typeof MODULE_TYPE$a, EvmUniswapV2TokenConfig>;
 
 declare const SolNativeTokenConfigSchema: z.ZodObject<{
     symbol: z.ZodOptional<z.ZodString>;
@@ -1738,9 +1754,9 @@ declare const SolNativeTokenConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 type SolNativeTokenConfig = z.infer<typeof SolNativeTokenConfigSchema>;
 
-declare const MODULE_TYPE$8: "sol-native";
+declare const MODULE_TYPE$9: "sol-native";
 
-declare const SolNativeBalanceModule: IBalanceModule<typeof MODULE_TYPE$8, SolNativeTokenConfig>;
+declare const SolNativeBalanceModule: IBalanceModule<typeof MODULE_TYPE$9, SolNativeTokenConfig>;
 
 declare const SolSplTokenConfigSchema: z.ZodObject<{
     symbol: z.ZodOptional<z.ZodString>;
@@ -1756,9 +1772,27 @@ declare const SolSplTokenConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 type SolSplTokenConfig = z.infer<typeof SolSplTokenConfigSchema>;
 
-declare const MODULE_TYPE$7: "sol-spl";
+declare const MODULE_TYPE$8: "sol-spl";
+
+declare const SolSplBalanceModule: IBalanceModule<typeof MODULE_TYPE$8, SolSplTokenConfig>;
+
+declare const SolToken2022TokenConfigSchema: 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>>;
+    mintAddress: z.ZodString;
+}, z.core.$strict>;
+type SolToken2022TokenConfig = z.infer<typeof SolToken2022TokenConfigSchema>;
 
-declare const SolSplBalanceModule: IBalanceModule<typeof MODULE_TYPE$7, SolSplTokenConfig>;
+declare const MODULE_TYPE$7: "sol-token2022";
+
+declare const SolToken2022BalanceModule: IBalanceModule<typeof MODULE_TYPE$7, SolToken2022TokenConfig>;
 
 declare const SubAssetsTokenConfigSchema: z.ZodObject<{
     symbol: z.ZodOptional<z.ZodString>;
@@ -1784,16 +1818,14 @@ declare const ALPHA_PRICE_SCALE: bigint;
 declare const getScaledAlphaPrice: (alphaIn: bigint, taoIn: bigint) => bigint;
 declare const alphaToTao: (alpha: bigint, scaledAlphaPrice: bigint) => bigint;
 declare const taoToAlpha: (tao: bigint, scaledAlphaPrice: bigint) => bigint;
-
 /**
- * To be used for tokens that don't have a coingecko id
- *
- * @param token
- * @param tokenRates
- * @param scaledAlphaPrice
- * @returns
+ * Like taoToAlpha but rounds up. Use for "must keep / must send at least this much alpha"
+ * thresholds: the chain floors the alpha→TAO conversion when checking its TAO-denominated
+ * minimums, so a floored alpha threshold can sit one planck below the real bound — an amount
+ * meeting it exactly would still fail the on-chain check (or get the position force-swept).
+ * Guarantees alphaToTao(taoToAlphaCeil(tao, price), price) >= tao.
  */
-declare const getDTaoTokenRates: (token: SubDTaoToken, tokenRates: TokenRatesList, scaledAlphaPrice: string | bigint) => _talismn_token_rates.TokenRates | null;
+declare const taoToAlphaCeil: (tao: bigint, scaledAlphaPrice: bigint) => bigint;
 
 declare const SubDTaoTokenConfigSchema: z.ZodObject<{
     symbol: z.ZodOptional<z.ZodString>;
@@ -1810,6 +1842,13 @@ declare const SubDTaoTokenConfigSchema: z.ZodObject<{
 type SubDTaoTokenConfig = z.infer<typeof SubDTaoTokenConfigSchema>;
 type SubDTaoBalanceMeta = {
     scaledAlphaPrice: string;
+    convictionLock?: SubDTaoConvictionLockMeta;
+};
+type SubDTaoConvictionLockType = "decaying" | "perpetual";
+type SubDTaoConvictionLockMeta = {
+    type: "conviction-lock";
+    hotkey: string;
+    lockType: SubDTaoConvictionLockType;
 };
 type SubDTaoBalance = {
     address: string;
@@ -1817,12 +1856,57 @@ type SubDTaoBalance = {
     baseTokenId: string;
     stake: bigint;
     pendingRootClaim?: bigint;
+    convictionLock?: SubDTaoConvictionLock;
     hotkey: string;
     netuid: number;
     scaledAlphaPrice: bigint;
 };
+type SubDTaoConvictionLock = {
+    amount: bigint;
+    hotkey: string;
+    lockType: SubDTaoConvictionLockType;
+    convictionRaw: string;
+};
 type GetDynamicInfosResult = (typeof bittensor)["descriptors"]["apis"]["SubnetInfoRuntimeApi"]["get_all_dynamic_info"][1];
 type GetStakeInfosResult = (typeof bittensor)["descriptors"]["apis"]["StakeInfoRuntimeApi"]["get_stake_info_for_coldkeys"][1];
+/**
+ * `undefined` when the coldkey has no lock on the subnet; `null` is our own fetch-failure marker.
+ * `conviction` is the raw U64F64 fixed-point value (shift right by 64 bits for the integer part),
+ * despite decoding as a plain bigint.
+ */
+type GetColdkeyLockResult = (typeof bittensor)["descriptors"]["apis"]["StakeInfoRuntimeApi"]["get_coldkey_lock"][1] | null;
+
+declare const getConvictionLockLabel: (lockType: SubDTaoConvictionLockType) => string;
+type DTaoConvictionLockInfo = {
+    amount: bigint;
+    /** the hotkey the lock is keyed on: required to top-up (the chain rejects a different hotkey) */
+    hotkey: string;
+    lockType: SubDTaoConvictionLockType;
+    label: string;
+};
+type BalanceLockLike = {
+    amount: {
+        planck: bigint;
+    };
+    meta?: unknown;
+};
+/**
+ * Extracts the dtao conviction lock from a Balance locks array (Balance#locks), if any.
+ * The locked amount cannot be unstaked until the lock decays (or ever, if perpetual);
+ * transferring it is allowed but moves the lock and its conviction to the recipient.
+ */
+declare const findDTaoConvictionLock: (locks: BalanceLockLike[] | null | undefined) => DTaoConvictionLockInfo | null;
+
+/**
+ * To be used for tokens that don't have a coingecko id
+ *
+ * @param token
+ * @param tokenRates
+ * @param scaledAlphaPrice
+ * @param alphaPriceChange24h 24h change of the pool price (alpha vs TAO) in percent, when known
+ * @returns
+ */
+declare const getDTaoTokenRates: (token: SubDTaoToken, tokenRates: TokenRatesList, scaledAlphaPrice: string | bigint, alphaPriceChange24h?: number | null) => _talismn_token_rates.TokenRates | null;
 
 declare const MODULE_TYPE$5: "substrate-dtao";
 type TokenConfig = z.infer<typeof SubDTaoTokenConfigSchema>;
@@ -2017,6 +2101,17 @@ declare const BALANCE_MODULES: (IBalanceModule<"substrate-dtao", {
     coingeckoId?: string | undefined;
     noDiscovery?: boolean | undefined;
     mirrorOf?: string | undefined;
+}, unknown, unknown> | IBalanceModule<"sol-token2022", {
+    mintAddress: 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> | IBalanceModule<"substrate-assets", {
     assetId: string;
     symbol?: string | undefined;
@@ -2097,4 +2192,4 @@ declare const BALANCE_MODULES: (IBalanceModule<"substrate-dtao", {
 }>)[];
 type AnyBalanceModule = (typeof BALANCE_MODULES)[number];
 
-export { ALPHA_PRICE_SCALE, type Address, type Amount, type AmountWithLabel, type AnyBalanceModule, BALANCE_MODULES, Balance, BalanceFormatter, type BalanceJson, type BalanceJsonList, type BalanceLockType, type BalanceSearchQuery, type BalanceSource, type BalanceStatus, type BalanceStatusTypes, type BalanceTransferType, BalanceValueGetter, Balances, BalancesProvider, type BalancesResult, type BalancesStorage, type ChainConnectors, Change24hCurrencyFormatter, EvmErc20BalanceModule, type EvmErc20TokenConfig, EvmErc20TokenConfigSchema, EvmNativeBalanceModule, type EvmNativeTokenConfig, EvmNativeTokenConfigSchema, EvmUniswapV2BalanceModule, type EvmUniswapV2TokenConfig, EvmUniswapV2TokenConfigSchema, type ExtraAmount, type FetchBalanceErrors, type FetchBalanceResults, FiatSumBalancesFormatter, type GetDynamicInfosResult, type GetStakeInfosResult, type HydrateDb, type IBalance, type IBalanceModule, type LockedAmount, type MiniMetadata, type NarrowBalanceType, PlanckSumBalancesFormatter, type PlatformConnector, SolNativeBalanceModule, type SolNativeTokenConfig, SolNativeTokenConfigSchema, SolSplBalanceModule, type SolSplTokenConfig, SolSplTokenConfigSchema, SubAssetsBalanceModule, type SubAssetsTokenConfig, SubAssetsTokenConfigSchema, type SubDTaoBalance, type SubDTaoBalanceMeta, SubDTaoBalanceModule, type SubDTaoTokenConfig, SubDTaoTokenConfigSchema, SubForeignAssetsBalanceModule, type SubForeignAssetsTokenConfig, SubForeignAssetsTokenConfigSchema, SubHydrationBalanceModule, type SubHydrationTokenConfig, SubHydrationTokenConfigSchema, SubNativeBalanceModule, type SubNativeMiniMetadataExtra, SubNativeMiniMetadataExtraSchema, type SubNativeModuleConfig, SubNativeModuleConfigSchema, type SubNativeTokenConfig, SubNativeTokenConfigSchema, SubPsp22BalanceModule, type SubPsp22TokenConfig, SubPsp22TokenConfigSchema, SubTokensBalanceModule, type SubTokensMiniMetadataExtra, SubTokensMiniMetadataExtraSchema, type SubTokensModuleConfig, SubTokensModuleConfigSchema, type SubTokensTokenConfig, SubTokensTokenConfigSchema, type SubscriptionCallback, SumBalancesFormatter, TAO_DECIMALS, type TokenPlatform, type TokensWithAddresses, type UnsubscribeFn, abiMulticall, alphaToTao, deriveMiniMetadataId, erc20BalancesAggregatorAbi, excludeFromFeePayableLocks, excludeFromTransferableAmount, filterBaseLocks, filterMirrorTokens, getBalanceId, getDTaoTokenRates, getLockTitle, getLockedType, getScaledAlphaPrice, getValueId, includeInTotalExtraAmount, taoToAlpha, uniswapV2PairAbi };
+export { ALPHA_PRICE_SCALE, type Address, type Amount, type AmountWithLabel, type AnyBalanceModule, BALANCE_MODULES, Balance, BalanceFormatter, type BalanceJson, type BalanceJsonList, type BalanceLockType, type BalanceSearchQuery, type BalanceSource, type BalanceStatus, type BalanceStatusTypes, type BalanceTransferType, BalanceValueGetter, Balances, BalancesProvider, type BalancesResult, type BalancesStorage, type ChainConnectors, Change24hCurrencyFormatter, type DTaoConvictionLockInfo, EvmErc20BalanceModule, type EvmErc20TokenConfig, EvmErc20TokenConfigSchema, EvmNativeBalanceModule, type EvmNativeTokenConfig, EvmNativeTokenConfigSchema, EvmUniswapV2BalanceModule, type EvmUniswapV2TokenConfig, EvmUniswapV2TokenConfigSchema, type ExtraAmount, type FetchBalanceErrors, type FetchBalanceResults, FiatSumBalancesFormatter, type GetColdkeyLockResult, type GetDynamicInfosResult, type GetStakeInfosResult, type HydrateDb, type IBalance, type IBalanceModule, type LockedAmount, type MiniMetadata, type NarrowBalanceType, PlanckSumBalancesFormatter, type PlatformConnector, SolNativeBalanceModule, type SolNativeTokenConfig, SolNativeTokenConfigSchema, SolSplBalanceModule, type SolSplTokenConfig, SolSplTokenConfigSchema, SolToken2022BalanceModule, type SolToken2022TokenConfig, SolToken2022TokenConfigSchema, SubAssetsBalanceModule, type SubAssetsTokenConfig, SubAssetsTokenConfigSchema, type SubDTaoBalance, type SubDTaoBalanceMeta, SubDTaoBalanceModule, type SubDTaoConvictionLock, type SubDTaoConvictionLockMeta, type SubDTaoConvictionLockType, type SubDTaoTokenConfig, SubDTaoTokenConfigSchema, SubForeignAssetsBalanceModule, type SubForeignAssetsTokenConfig, SubForeignAssetsTokenConfigSchema, SubHydrationBalanceModule, type SubHydrationTokenConfig, SubHydrationTokenConfigSchema, SubNativeBalanceModule, type SubNativeMiniMetadataExtra, SubNativeMiniMetadataExtraSchema, type SubNativeModuleConfig, SubNativeModuleConfigSchema, type SubNativeTokenConfig, SubNativeTokenConfigSchema, SubPsp22BalanceModule, type SubPsp22TokenConfig, SubPsp22TokenConfigSchema, SubTokensBalanceModule, type SubTokensMiniMetadataExtra, SubTokensMiniMetadataExtraSchema, type SubTokensModuleConfig, SubTokensModuleConfigSchema, type SubTokensTokenConfig, SubTokensTokenConfigSchema, type SubscriptionCallback, SumBalancesFormatter, TAO_DECIMALS, type TokenPlatform, type TokensWithAddresses, type UnsubscribeFn, abiMulticall, alphaToTao, deriveMiniMetadataId, erc20BalancesAggregatorAbi, excludeFromFeePayableLocks, excludeFromTransferableAmount, filterBaseLocks, filterMirrorTokens, findDTaoConvictionLock, getBalanceId, getConvictionLockLabel, getDTaoTokenRates, getLockTitle, getLockedType, getScaledAlphaPrice, getValueId, includeInTotalExtraAmount, taoToAlpha, taoToAlphaCeil, uniswapV2PairAbi };

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-import { TokenId, NetworkId, NetworkList, TokenList, TokenType, TokenOfType, Token, DotNetworkId, SolNetworkId, EthNetworkId, AnyMiniMetadata, ChaindataProvider, SubDTaoToken } from '@talismn/chaindata-provider';
+import { TokenId, NetworkId, NetworkList, TokenList, TokenType, TokenOfType, DotNetworkId, SolNetworkId, Token, EthNetworkId, AnyMiniMetadata, ChaindataProvider, SubDTaoToken } from '@talismn/chaindata-provider';
 export { MINIMETADATA_VERSION } from '@talismn/chaindata-provider';
 import { Observable } from 'rxjs';
 import { IChainConnectorDot, IChainConnectorEth, IChainConnectorSol } from '@talismn/chain-connectors';
 import { TransactionInstruction } from '@solana/web3.js';
 import * as _talismn_token_rates from '@talismn/token-rates';
-import { TokenRates, TokenRateCurrency, TokenRatesList } from '@talismn/token-rates';
+import { TokenRatesList, TokenRates, TokenRateCurrency } from '@talismn/token-rates';
 import { NonFunctionProperties } from '@talismn/util';
-import z from 'zod/v4';
 import { bittensor } from '@polkadot-api/descriptors';
+import z from 'zod/v4';
 
 type Address = string;
 
@@ -320,6 +320,7 @@ declare class Balance {
         balancesConfig?: {
             "sol-native"?: Record<string, never> | undefined;
             "sol-spl"?: Record<string, never> | undefined;
+            "sol-token2022"?: Record<string, never> | undefined;
         } | undefined;
     } | null;
     get tokenId(): string;
@@ -511,6 +512,21 @@ declare class Balance {
         coingeckoId?: string | undefined;
         noDiscovery?: boolean | undefined;
         mirrorOf?: string | undefined;
+    } | {
+        id: string;
+        networkId: string;
+        decimals: number;
+        symbol: string;
+        type: "sol-token2022";
+        platform: "solana";
+        mintAddress: string;
+        isDefault?: boolean | undefined;
+        name?: string | undefined;
+        logo?: string | undefined;
+        coingeckoId?: string | undefined;
+        noDiscovery?: boolean | undefined;
+        mirrorOf?: string | undefined;
+        isTransferable?: boolean | undefined;
     } | null;
     get decimals(): number | null;
     get rates(): TokenRates | null;
@@ -1686,9 +1702,9 @@ declare const EvmErc20TokenConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 type EvmErc20TokenConfig = z.infer<typeof EvmErc20TokenConfigSchema>;
 
-declare const MODULE_TYPE$b: "evm-erc20";
+declare const MODULE_TYPE$c: "evm-erc20";
 
-declare const EvmErc20BalanceModule: IBalanceModule<typeof MODULE_TYPE$b, EvmErc20TokenConfig>;
+declare const EvmErc20BalanceModule: IBalanceModule<typeof MODULE_TYPE$c, EvmErc20TokenConfig>;
 
 declare const EvmNativeTokenConfigSchema: z.ZodObject<{
     symbol: z.ZodOptional<z.ZodString>;
@@ -1703,9 +1719,9 @@ declare const EvmNativeTokenConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 type EvmNativeTokenConfig = z.infer<typeof EvmNativeTokenConfigSchema>;
 
-declare const MODULE_TYPE$a: "evm-native";
+declare const MODULE_TYPE$b: "evm-native";
 
-declare const EvmNativeBalanceModule: IBalanceModule<typeof MODULE_TYPE$a, EvmNativeTokenConfig>;
+declare const EvmNativeBalanceModule: IBalanceModule<typeof MODULE_TYPE$b, EvmNativeTokenConfig>;
 
 declare const EvmUniswapV2TokenConfigSchema: z.ZodObject<{
     symbol: z.ZodOptional<z.ZodString>;
@@ -1721,9 +1737,9 @@ declare const EvmUniswapV2TokenConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 type EvmUniswapV2TokenConfig = z.infer<typeof EvmUniswapV2TokenConfigSchema>;
 
-declare const MODULE_TYPE$9: "evm-uniswapv2";
+declare const MODULE_TYPE$a: "evm-uniswapv2";
 
-declare const EvmUniswapV2BalanceModule: IBalanceModule<typeof MODULE_TYPE$9, EvmUniswapV2TokenConfig>;
+declare const EvmUniswapV2BalanceModule: IBalanceModule<typeof MODULE_TYPE$a, EvmUniswapV2TokenConfig>;
 
 declare const SolNativeTokenConfigSchema: z.ZodObject<{
     symbol: z.ZodOptional<z.ZodString>;
@@ -1738,9 +1754,9 @@ declare const SolNativeTokenConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 type SolNativeTokenConfig = z.infer<typeof SolNativeTokenConfigSchema>;
 
-declare const MODULE_TYPE$8: "sol-native";
+declare const MODULE_TYPE$9: "sol-native";
 
-declare const SolNativeBalanceModule: IBalanceModule<typeof MODULE_TYPE$8, SolNativeTokenConfig>;
+declare const SolNativeBalanceModule: IBalanceModule<typeof MODULE_TYPE$9, SolNativeTokenConfig>;
 
 declare const SolSplTokenConfigSchema: z.ZodObject<{
     symbol: z.ZodOptional<z.ZodString>;
@@ -1756,9 +1772,27 @@ declare const SolSplTokenConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 type SolSplTokenConfig = z.infer<typeof SolSplTokenConfigSchema>;
 
-declare const MODULE_TYPE$7: "sol-spl";
+declare const MODULE_TYPE$8: "sol-spl";
+
+declare const SolSplBalanceModule: IBalanceModule<typeof MODULE_TYPE$8, SolSplTokenConfig>;
+
+declare const SolToken2022TokenConfigSchema: 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>>;
+    mintAddress: z.ZodString;
+}, z.core.$strict>;
+type SolToken2022TokenConfig = z.infer<typeof SolToken2022TokenConfigSchema>;
 
-declare const SolSplBalanceModule: IBalanceModule<typeof MODULE_TYPE$7, SolSplTokenConfig>;
+declare const MODULE_TYPE$7: "sol-token2022";
+
+declare const SolToken2022BalanceModule: IBalanceModule<typeof MODULE_TYPE$7, SolToken2022TokenConfig>;
 
 declare const SubAssetsTokenConfigSchema: z.ZodObject<{
     symbol: z.ZodOptional<z.ZodString>;
@@ -1784,16 +1818,14 @@ declare const ALPHA_PRICE_SCALE: bigint;
 declare const getScaledAlphaPrice: (alphaIn: bigint, taoIn: bigint) => bigint;
 declare const alphaToTao: (alpha: bigint, scaledAlphaPrice: bigint) => bigint;
 declare const taoToAlpha: (tao: bigint, scaledAlphaPrice: bigint) => bigint;
-
 /**
- * To be used for tokens that don't have a coingecko id
- *
- * @param token
- * @param tokenRates
- * @param scaledAlphaPrice
- * @returns
+ * Like taoToAlpha but rounds up. Use for "must keep / must send at least this much alpha"
+ * thresholds: the chain floors the alpha→TAO conversion when checking its TAO-denominated
+ * minimums, so a floored alpha threshold can sit one planck below the real bound — an amount
+ * meeting it exactly would still fail the on-chain check (or get the position force-swept).
+ * Guarantees alphaToTao(taoToAlphaCeil(tao, price), price) >= tao.
  */
-declare const getDTaoTokenRates: (token: SubDTaoToken, tokenRates: TokenRatesList, scaledAlphaPrice: string | bigint) => _talismn_token_rates.TokenRates | null;
+declare const taoToAlphaCeil: (tao: bigint, scaledAlphaPrice: bigint) => bigint;
 
 declare const SubDTaoTokenConfigSchema: z.ZodObject<{
     symbol: z.ZodOptional<z.ZodString>;
@@ -1810,6 +1842,13 @@ declare const SubDTaoTokenConfigSchema: z.ZodObject<{
 type SubDTaoTokenConfig = z.infer<typeof SubDTaoTokenConfigSchema>;
 type SubDTaoBalanceMeta = {
     scaledAlphaPrice: string;
+    convictionLock?: SubDTaoConvictionLockMeta;
+};
+type SubDTaoConvictionLockType = "decaying" | "perpetual";
+type SubDTaoConvictionLockMeta = {
+    type: "conviction-lock";
+    hotkey: string;
+    lockType: SubDTaoConvictionLockType;
 };
 type SubDTaoBalance = {
     address: string;
@@ -1817,12 +1856,57 @@ type SubDTaoBalance = {
     baseTokenId: string;
     stake: bigint;
     pendingRootClaim?: bigint;
+    convictionLock?: SubDTaoConvictionLock;
     hotkey: string;
     netuid: number;
     scaledAlphaPrice: bigint;
 };
+type SubDTaoConvictionLock = {
+    amount: bigint;
+    hotkey: string;
+    lockType: SubDTaoConvictionLockType;
+    convictionRaw: string;
+};
 type GetDynamicInfosResult = (typeof bittensor)["descriptors"]["apis"]["SubnetInfoRuntimeApi"]["get_all_dynamic_info"][1];
 type GetStakeInfosResult = (typeof bittensor)["descriptors"]["apis"]["StakeInfoRuntimeApi"]["get_stake_info_for_coldkeys"][1];
+/**
+ * `undefined` when the coldkey has no lock on the subnet; `null` is our own fetch-failure marker.
+ * `conviction` is the raw U64F64 fixed-point value (shift right by 64 bits for the integer part),
+ * despite decoding as a plain bigint.
+ */
+type GetColdkeyLockResult = (typeof bittensor)["descriptors"]["apis"]["StakeInfoRuntimeApi"]["get_coldkey_lock"][1] | null;
+
+declare const getConvictionLockLabel: (lockType: SubDTaoConvictionLockType) => string;
+type DTaoConvictionLockInfo = {
+    amount: bigint;
+    /** the hotkey the lock is keyed on: required to top-up (the chain rejects a different hotkey) */
+    hotkey: string;
+    lockType: SubDTaoConvictionLockType;
+    label: string;
+};
+type BalanceLockLike = {
+    amount: {
+        planck: bigint;
+    };
+    meta?: unknown;
+};
+/**
+ * Extracts the dtao conviction lock from a Balance locks array (Balance#locks), if any.
+ * The locked amount cannot be unstaked until the lock decays (or ever, if perpetual);
+ * transferring it is allowed but moves the lock and its conviction to the recipient.
+ */
+declare const findDTaoConvictionLock: (locks: BalanceLockLike[] | null | undefined) => DTaoConvictionLockInfo | null;
+
+/**
+ * To be used for tokens that don't have a coingecko id
+ *
+ * @param token
+ * @param tokenRates
+ * @param scaledAlphaPrice
+ * @param alphaPriceChange24h 24h change of the pool price (alpha vs TAO) in percent, when known
+ * @returns
+ */
+declare const getDTaoTokenRates: (token: SubDTaoToken, tokenRates: TokenRatesList, scaledAlphaPrice: string | bigint, alphaPriceChange24h?: number | null) => _talismn_token_rates.TokenRates | null;
 
 declare const MODULE_TYPE$5: "substrate-dtao";
 type TokenConfig = z.infer<typeof SubDTaoTokenConfigSchema>;
@@ -2017,6 +2101,17 @@ declare const BALANCE_MODULES: (IBalanceModule<"substrate-dtao", {
     coingeckoId?: string | undefined;
     noDiscovery?: boolean | undefined;
     mirrorOf?: string | undefined;
+}, unknown, unknown> | IBalanceModule<"sol-token2022", {
+    mintAddress: 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> | IBalanceModule<"substrate-assets", {
     assetId: string;
     symbol?: string | undefined;
@@ -2097,4 +2192,4 @@ declare const BALANCE_MODULES: (IBalanceModule<"substrate-dtao", {
 }>)[];
 type AnyBalanceModule = (typeof BALANCE_MODULES)[number];
 
-export { ALPHA_PRICE_SCALE, type Address, type Amount, type AmountWithLabel, type AnyBalanceModule, BALANCE_MODULES, Balance, BalanceFormatter, type BalanceJson, type BalanceJsonList, type BalanceLockType, type BalanceSearchQuery, type BalanceSource, type BalanceStatus, type BalanceStatusTypes, type BalanceTransferType, BalanceValueGetter, Balances, BalancesProvider, type BalancesResult, type BalancesStorage, type ChainConnectors, Change24hCurrencyFormatter, EvmErc20BalanceModule, type EvmErc20TokenConfig, EvmErc20TokenConfigSchema, EvmNativeBalanceModule, type EvmNativeTokenConfig, EvmNativeTokenConfigSchema, EvmUniswapV2BalanceModule, type EvmUniswapV2TokenConfig, EvmUniswapV2TokenConfigSchema, type ExtraAmount, type FetchBalanceErrors, type FetchBalanceResults, FiatSumBalancesFormatter, type GetDynamicInfosResult, type GetStakeInfosResult, type HydrateDb, type IBalance, type IBalanceModule, type LockedAmount, type MiniMetadata, type NarrowBalanceType, PlanckSumBalancesFormatter, type PlatformConnector, SolNativeBalanceModule, type SolNativeTokenConfig, SolNativeTokenConfigSchema, SolSplBalanceModule, type SolSplTokenConfig, SolSplTokenConfigSchema, SubAssetsBalanceModule, type SubAssetsTokenConfig, SubAssetsTokenConfigSchema, type SubDTaoBalance, type SubDTaoBalanceMeta, SubDTaoBalanceModule, type SubDTaoTokenConfig, SubDTaoTokenConfigSchema, SubForeignAssetsBalanceModule, type SubForeignAssetsTokenConfig, SubForeignAssetsTokenConfigSchema, SubHydrationBalanceModule, type SubHydrationTokenConfig, SubHydrationTokenConfigSchema, SubNativeBalanceModule, type SubNativeMiniMetadataExtra, SubNativeMiniMetadataExtraSchema, type SubNativeModuleConfig, SubNativeModuleConfigSchema, type SubNativeTokenConfig, SubNativeTokenConfigSchema, SubPsp22BalanceModule, type SubPsp22TokenConfig, SubPsp22TokenConfigSchema, SubTokensBalanceModule, type SubTokensMiniMetadataExtra, SubTokensMiniMetadataExtraSchema, type SubTokensModuleConfig, SubTokensModuleConfigSchema, type SubTokensTokenConfig, SubTokensTokenConfigSchema, type SubscriptionCallback, SumBalancesFormatter, TAO_DECIMALS, type TokenPlatform, type TokensWithAddresses, type UnsubscribeFn, abiMulticall, alphaToTao, deriveMiniMetadataId, erc20BalancesAggregatorAbi, excludeFromFeePayableLocks, excludeFromTransferableAmount, filterBaseLocks, filterMirrorTokens, getBalanceId, getDTaoTokenRates, getLockTitle, getLockedType, getScaledAlphaPrice, getValueId, includeInTotalExtraAmount, taoToAlpha, uniswapV2PairAbi };
+export { ALPHA_PRICE_SCALE, type Address, type Amount, type AmountWithLabel, type AnyBalanceModule, BALANCE_MODULES, Balance, BalanceFormatter, type BalanceJson, type BalanceJsonList, type BalanceLockType, type BalanceSearchQuery, type BalanceSource, type BalanceStatus, type BalanceStatusTypes, type BalanceTransferType, BalanceValueGetter, Balances, BalancesProvider, type BalancesResult, type BalancesStorage, type ChainConnectors, Change24hCurrencyFormatter, type DTaoConvictionLockInfo, EvmErc20BalanceModule, type EvmErc20TokenConfig, EvmErc20TokenConfigSchema, EvmNativeBalanceModule, type EvmNativeTokenConfig, EvmNativeTokenConfigSchema, EvmUniswapV2BalanceModule, type EvmUniswapV2TokenConfig, EvmUniswapV2TokenConfigSchema, type ExtraAmount, type FetchBalanceErrors, type FetchBalanceResults, FiatSumBalancesFormatter, type GetColdkeyLockResult, type GetDynamicInfosResult, type GetStakeInfosResult, type HydrateDb, type IBalance, type IBalanceModule, type LockedAmount, type MiniMetadata, type NarrowBalanceType, PlanckSumBalancesFormatter, type PlatformConnector, SolNativeBalanceModule, type SolNativeTokenConfig, SolNativeTokenConfigSchema, SolSplBalanceModule, type SolSplTokenConfig, SolSplTokenConfigSchema, SolToken2022BalanceModule, type SolToken2022TokenConfig, SolToken2022TokenConfigSchema, SubAssetsBalanceModule, type SubAssetsTokenConfig, SubAssetsTokenConfigSchema, type SubDTaoBalance, type SubDTaoBalanceMeta, SubDTaoBalanceModule, type SubDTaoConvictionLock, type SubDTaoConvictionLockMeta, type SubDTaoConvictionLockType, type SubDTaoTokenConfig, SubDTaoTokenConfigSchema, SubForeignAssetsBalanceModule, type SubForeignAssetsTokenConfig, SubForeignAssetsTokenConfigSchema, SubHydrationBalanceModule, type SubHydrationTokenConfig, SubHydrationTokenConfigSchema, SubNativeBalanceModule, type SubNativeMiniMetadataExtra, SubNativeMiniMetadataExtraSchema, type SubNativeModuleConfig, SubNativeModuleConfigSchema, type SubNativeTokenConfig, SubNativeTokenConfigSchema, SubPsp22BalanceModule, type SubPsp22TokenConfig, SubPsp22TokenConfigSchema, SubTokensBalanceModule, type SubTokensMiniMetadataExtra, SubTokensMiniMetadataExtraSchema, type SubTokensModuleConfig, SubTokensModuleConfigSchema, type SubTokensTokenConfig, SubTokensTokenConfigSchema, type SubscriptionCallback, SumBalancesFormatter, TAO_DECIMALS, type TokenPlatform, type TokensWithAddresses, type UnsubscribeFn, abiMulticall, alphaToTao, deriveMiniMetadataId, erc20BalancesAggregatorAbi, excludeFromFeePayableLocks, excludeFromTransferableAmount, filterBaseLocks, filterMirrorTokens, findDTaoConvictionLock, getBalanceId, getConvictionLockLabel, getDTaoTokenRates, getLockTitle, getLockedType, getScaledAlphaPrice, getValueId, includeInTotalExtraAmount, taoToAlpha, taoToAlphaCeil, uniswapV2PairAbi };