@metamask-previews/assets-controller 1.0.0-preview-ee8f1b28b → 2.0.0-preview-33dbba4f3

package/dist/data-sources/evm-rpc-services/services/StakedBalanceFetcher.d.cts

@@ -0,0 +1,78 @@
+import { Web3Provider } from "@ethersproject/providers";
+import type { Address, AccountId, ChainId } from "../types/index.cjs";
+import { getStakingContractAddress, getSupportedStakingChainIds, isStakingContractAssetId } from "../utils/index.cjs";
+export { getStakingContractAddress, getSupportedStakingChainIds, isStakingContractAssetId, };
+export type StakedBalancePollingInput = {
+    /** Chain ID (hex format, e.g. 0x1) */
+    chainId: ChainId;
+    /** Account ID */
+    accountId: AccountId;
+    /** Account address */
+    accountAddress: Address;
+};
+/** Human-readable staked balance (e.g. "1.5" for 1.5 ETH). */
+export type StakedBalance = {
+    amount: string;
+};
+/** Result reported via the update callback. */
+export type StakedBalanceFetchResult = {
+    /** Account ID (UUID). */
+    accountId: AccountId;
+    /** Hex chain ID. */
+    chainId: ChainId;
+    /** Human-readable staked balance. */
+    balance: StakedBalance;
+};
+/**
+ * Callback type for staked balance updates.
+ */
+export type OnStakedBalanceUpdateCallback = (result: StakedBalanceFetchResult) => void;
+export type StakedBalanceFetcherConfig = {
+    /** Polling interval in ms (default: 180s) */
+    pollingInterval?: number;
+    /** Returns the network provider for the given chain. Required for fetchStakedBalance. */
+    getNetworkProvider?: (chainId: ChainId) => Web3Provider | undefined;
+};
+declare const StakedBalanceFetcher_base: (abstract new (...args: any[]) => {
+    readonly "__#15@#intervalIds": Record<string, NodeJS.Timeout>;
+    "__#15@#intervalLength": number | undefined;
+    setIntervalLength(intervalLength: number): void;
+    getIntervalLength(): number | undefined; /** Chain ID (hex format, e.g. 0x1) */
+    _startPolling(input: StakedBalancePollingInput): void;
+    _stopPollingByPollingTokenSetId(key: string): void;
+    readonly "__#3@#pollingTokenSets": Map<string, Set<string>>;
+    readonly "__#3@#callbacks": Map<string, Set<(input: StakedBalancePollingInput) => void>>;
+    _executePoll(input: StakedBalancePollingInput): Promise<void>;
+    startPolling(input: StakedBalancePollingInput): string;
+    stopAllPolling(): void;
+    stopPollingByPollingToken(pollingToken: string): void;
+    onPollingComplete(input: StakedBalancePollingInput, callback: (input: StakedBalancePollingInput) => void): void;
+}) & {
+    new (): {};
+};
+export declare class StakedBalanceFetcher extends StakedBalanceFetcher_base {
+    #private;
+    constructor(config?: StakedBalanceFetcherConfig);
+    /**
+     * Register a callback that is invoked after every successful poll with
+     * the staked balance (including zero). Zero is reported so that merged
+     * updates can clear prior non-zero state.
+     *
+     * @param callback - The callback to invoke.
+     */
+    setOnStakedBalanceUpdate(callback: OnStakedBalanceUpdateCallback): void;
+    _executePoll(input: StakedBalancePollingInput): Promise<void>;
+    /**
+     * Fetches the staked balance for an account on a chain using the same
+     * staking contract as AccountTrackerController (getShares then convertToAssets).
+     * Returns a human-readable amount string (e.g. "1.5" for 1.5 ETH).
+     * Throws when no provider is available or when the RPC/contract call fails, so
+     * callers do not persist a false zero and overwrite existing balances.
+     *
+     * @param input - Chain, account ID, and address to query.
+     * @returns Human-readable staked balance (amount string).
+     * @throws When provider is missing or when getShares/convertToAssets fails.
+     */
+    fetchStakedBalance(input: StakedBalancePollingInput): Promise<StakedBalance>;
+}
+//# sourceMappingURL=StakedBalanceFetcher.d.cts.map

package/dist/data-sources/evm-rpc-services/services/StakedBalanceFetcher.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StakedBalanceFetcher.d.cts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/services/StakedBalanceFetcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,iCAAiC;AAGxD,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,2BAAiB;AAC5D,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,EAEzB,2BAAiB;AAElB,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,GACzB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,sBAAsB;IACtB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,8DAA8D;AAC9D,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,+CAA+C;AAC/C,MAAM,MAAM,wBAAwB,GAAG;IACrC,yBAAyB;IACzB,SAAS,EAAE,SAAS,CAAC;IACrB,oBAAoB;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,OAAO,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,CAC1C,MAAM,EAAE,wBAAwB,KAC7B,IAAI,CAAC;AAwBV,MAAM,MAAM,0BAA0B,GAAG;IACvC,6CAA6C;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yFAAyF;IACzF,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,YAAY,GAAG,SAAS,CAAC;CACrE,CAAC;;;;;6CAzDA,sCAAsC;;;;;;;;;;;;;AA6DxC,qBAAa,oBAAqB,SAAQ,yBAAgE;;gBAK5F,MAAM,CAAC,EAAE,0BAA0B;IAS/C;;;;;;OAMG;IACH,wBAAwB,CAAC,QAAQ,EAAE,6BAA6B,GAAG,IAAI;IAIjE,YAAY,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBnE;;;;;;;;;;OAUG;IACG,kBAAkB,CACtB,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,aAAa,CAAC;CAoD1B"}

package/dist/data-sources/evm-rpc-services/services/StakedBalanceFetcher.d.mts

@@ -0,0 +1,78 @@
+import { Web3Provider } from "@ethersproject/providers";
+import type { Address, AccountId, ChainId } from "../types/index.mjs";
+import { getStakingContractAddress, getSupportedStakingChainIds, isStakingContractAssetId } from "../utils/index.mjs";
+export { getStakingContractAddress, getSupportedStakingChainIds, isStakingContractAssetId, };
+export type StakedBalancePollingInput = {
+    /** Chain ID (hex format, e.g. 0x1) */
+    chainId: ChainId;
+    /** Account ID */
+    accountId: AccountId;
+    /** Account address */
+    accountAddress: Address;
+};
+/** Human-readable staked balance (e.g. "1.5" for 1.5 ETH). */
+export type StakedBalance = {
+    amount: string;
+};
+/** Result reported via the update callback. */
+export type StakedBalanceFetchResult = {
+    /** Account ID (UUID). */
+    accountId: AccountId;
+    /** Hex chain ID. */
+    chainId: ChainId;
+    /** Human-readable staked balance. */
+    balance: StakedBalance;
+};
+/**
+ * Callback type for staked balance updates.
+ */
+export type OnStakedBalanceUpdateCallback = (result: StakedBalanceFetchResult) => void;
+export type StakedBalanceFetcherConfig = {
+    /** Polling interval in ms (default: 180s) */
+    pollingInterval?: number;
+    /** Returns the network provider for the given chain. Required for fetchStakedBalance. */
+    getNetworkProvider?: (chainId: ChainId) => Web3Provider | undefined;
+};
+declare const StakedBalanceFetcher_base: (abstract new (...args: any[]) => {
+    readonly "__#15@#intervalIds": Record<string, NodeJS.Timeout>;
+    "__#15@#intervalLength": number | undefined;
+    setIntervalLength(intervalLength: number): void;
+    getIntervalLength(): number | undefined; /** Chain ID (hex format, e.g. 0x1) */
+    _startPolling(input: StakedBalancePollingInput): void;
+    _stopPollingByPollingTokenSetId(key: string): void;
+    readonly "__#3@#pollingTokenSets": Map<string, Set<string>>;
+    readonly "__#3@#callbacks": Map<string, Set<(input: StakedBalancePollingInput) => void>>;
+    _executePoll(input: StakedBalancePollingInput): Promise<void>;
+    startPolling(input: StakedBalancePollingInput): string;
+    stopAllPolling(): void;
+    stopPollingByPollingToken(pollingToken: string): void;
+    onPollingComplete(input: StakedBalancePollingInput, callback: (input: StakedBalancePollingInput) => void): void;
+}) & {
+    new (): {};
+};
+export declare class StakedBalanceFetcher extends StakedBalanceFetcher_base {
+    #private;
+    constructor(config?: StakedBalanceFetcherConfig);
+    /**
+     * Register a callback that is invoked after every successful poll with
+     * the staked balance (including zero). Zero is reported so that merged
+     * updates can clear prior non-zero state.
+     *
+     * @param callback - The callback to invoke.
+     */
+    setOnStakedBalanceUpdate(callback: OnStakedBalanceUpdateCallback): void;
+    _executePoll(input: StakedBalancePollingInput): Promise<void>;
+    /**
+     * Fetches the staked balance for an account on a chain using the same
+     * staking contract as AccountTrackerController (getShares then convertToAssets).
+     * Returns a human-readable amount string (e.g. "1.5" for 1.5 ETH).
+     * Throws when no provider is available or when the RPC/contract call fails, so
+     * callers do not persist a false zero and overwrite existing balances.
+     *
+     * @param input - Chain, account ID, and address to query.
+     * @returns Human-readable staked balance (amount string).
+     * @throws When provider is missing or when getShares/convertToAssets fails.
+     */
+    fetchStakedBalance(input: StakedBalancePollingInput): Promise<StakedBalance>;
+}
+//# sourceMappingURL=StakedBalanceFetcher.d.mts.map

package/dist/data-sources/evm-rpc-services/services/StakedBalanceFetcher.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StakedBalanceFetcher.d.mts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/services/StakedBalanceFetcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,iCAAiC;AAGxD,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,2BAAiB;AAC5D,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,EAEzB,2BAAiB;AAElB,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,GACzB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,sBAAsB;IACtB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,8DAA8D;AAC9D,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,+CAA+C;AAC/C,MAAM,MAAM,wBAAwB,GAAG;IACrC,yBAAyB;IACzB,SAAS,EAAE,SAAS,CAAC;IACrB,oBAAoB;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,OAAO,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,CAC1C,MAAM,EAAE,wBAAwB,KAC7B,IAAI,CAAC;AAwBV,MAAM,MAAM,0BAA0B,GAAG;IACvC,6CAA6C;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yFAAyF;IACzF,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,YAAY,GAAG,SAAS,CAAC;CACrE,CAAC;;;;;6CAzDA,sCAAsC;;;;;;;;;;;;;AA6DxC,qBAAa,oBAAqB,SAAQ,yBAAgE;;gBAK5F,MAAM,CAAC,EAAE,0BAA0B;IAS/C;;;;;;OAMG;IACH,wBAAwB,CAAC,QAAQ,EAAE,6BAA6B,GAAG,IAAI;IAIjE,YAAY,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBnE;;;;;;;;;;OAUG;IACG,kBAAkB,CACtB,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,aAAa,CAAC;CAoD1B"}

package/dist/data-sources/evm-rpc-services/services/StakedBalanceFetcher.mjs

@@ -0,0 +1,126 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _StakedBalanceFetcher_providerGetter, _StakedBalanceFetcher_onStakedBalanceUpdate;
+import { Interface } from "@ethersproject/abi";
+import { Web3Provider } from "@ethersproject/providers";
+import { StaticIntervalPollingControllerOnly } from "@metamask/polling-controller";
+import { getStakingContractAddress, getSupportedStakingChainIds, isStakingContractAssetId, weiToHumanReadable } from "../utils/index.mjs";
+export { getStakingContractAddress, getSupportedStakingChainIds, isStakingContractAssetId };
+/** Staking contract ABI: getShares(account) and convertToAssets(shares). */
+const STAKING_CONTRACT_ABI = [
+    {
+        inputs: [{ internalType: 'address', name: 'account', type: 'address' }],
+        name: 'getShares',
+        outputs: [{ internalType: 'uint256', name: '', type: 'uint256' }],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [{ internalType: 'uint256', name: 'shares', type: 'uint256' }],
+        name: 'convertToAssets',
+        outputs: [{ internalType: 'uint256', name: 'assets', type: 'uint256' }],
+        stateMutability: 'view',
+        type: 'function',
+    },
+];
+const STAKING_INTERFACE = new Interface(STAKING_CONTRACT_ABI);
+const STAKING_DECIMALS = 18;
+const DEFAULT_STAKED_BALANCE_INTERVAL = 180000; // 3 minutes
+export class StakedBalanceFetcher extends StaticIntervalPollingControllerOnly() {
+    constructor(config) {
+        super();
+        _StakedBalanceFetcher_providerGetter.set(this, void 0);
+        _StakedBalanceFetcher_onStakedBalanceUpdate.set(this, void 0);
+        __classPrivateFieldSet(this, _StakedBalanceFetcher_providerGetter, config?.getNetworkProvider, "f");
+        this.setIntervalLength(config?.pollingInterval ?? DEFAULT_STAKED_BALANCE_INTERVAL);
+    }
+    /**
+     * Register a callback that is invoked after every successful poll with
+     * the staked balance (including zero). Zero is reported so that merged
+     * updates can clear prior non-zero state.
+     *
+     * @param callback - The callback to invoke.
+     */
+    setOnStakedBalanceUpdate(callback) {
+        __classPrivateFieldSet(this, _StakedBalanceFetcher_onStakedBalanceUpdate, callback, "f");
+    }
+    async _executePoll(input) {
+        let result;
+        try {
+            result = await this.fetchStakedBalance(input);
+        }
+        catch {
+            // Do not push an update on provider/RPC failure; otherwise we would
+            // overwrite existing non-zero staked balances with zero in state.
+            return;
+        }
+        if (__classPrivateFieldGet(this, _StakedBalanceFetcher_onStakedBalanceUpdate, "f")) {
+            __classPrivateFieldGet(this, _StakedBalanceFetcher_onStakedBalanceUpdate, "f").call(this, {
+                accountId: input.accountId,
+                chainId: input.chainId,
+                balance: result,
+            });
+        }
+    }
+    /**
+     * Fetches the staked balance for an account on a chain using the same
+     * staking contract as AccountTrackerController (getShares then convertToAssets).
+     * Returns a human-readable amount string (e.g. "1.5" for 1.5 ETH).
+     * Throws when no provider is available or when the RPC/contract call fails, so
+     * callers do not persist a false zero and overwrite existing balances.
+     *
+     * @param input - Chain, account ID, and address to query.
+     * @returns Human-readable staked balance (amount string).
+     * @throws When provider is missing or when getShares/convertToAssets fails.
+     */
+    async fetchStakedBalance(input) {
+        const { chainId, accountAddress } = input;
+        const provider = __classPrivateFieldGet(this, _StakedBalanceFetcher_providerGetter, "f")?.call(this, chainId);
+        if (!provider) {
+            throw new Error('StakedBalanceFetcher: no provider available for chain');
+        }
+        const contractAddress = getStakingContractAddress(chainId);
+        if (!contractAddress) {
+            return { amount: '0' };
+        }
+        try {
+            const sharesCalldata = STAKING_INTERFACE.encodeFunctionData('getShares', [
+                accountAddress,
+            ]);
+            const sharesResult = await provider.call({
+                to: contractAddress,
+                data: sharesCalldata,
+            });
+            const sharesRaw = STAKING_INTERFACE.decodeFunctionResult('getShares', sharesResult)[0];
+            const sharesBigNum = BigInt(sharesRaw.toString());
+            if (sharesBigNum === 0n) {
+                return { amount: '0' };
+            }
+            const assetsCalldata = STAKING_INTERFACE.encodeFunctionData('convertToAssets', [sharesBigNum]);
+            const assetsResult = await provider.call({
+                to: contractAddress,
+                data: assetsCalldata,
+            });
+            const assetsRaw = STAKING_INTERFACE.decodeFunctionResult('convertToAssets', assetsResult)[0];
+            const assetsWei = BigInt(assetsRaw.toString());
+            const amount = weiToHumanReadable(assetsWei, STAKING_DECIMALS);
+            return { amount };
+        }
+        catch (error) {
+            throw error instanceof Error
+                ? error
+                : new Error('StakedBalanceFetcher: failed to fetch staked balance');
+        }
+    }
+}
+_StakedBalanceFetcher_providerGetter = new WeakMap(), _StakedBalanceFetcher_onStakedBalanceUpdate = new WeakMap();
+//# sourceMappingURL=StakedBalanceFetcher.mjs.map

package/dist/data-sources/evm-rpc-services/services/StakedBalanceFetcher.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"StakedBalanceFetcher.mjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/services/StakedBalanceFetcher.ts"],"names":[],"mappings":"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","sourcesContent":["import { Interface } from '@ethersproject/abi';\nimport { Web3Provider } from '@ethersproject/providers';\nimport { StaticIntervalPollingControllerOnly } from '@metamask/polling-controller';\n\nimport type { Address, AccountId, ChainId } from '../types';\nimport {\n  getStakingContractAddress,\n  getSupportedStakingChainIds,\n  isStakingContractAssetId,\n  weiToHumanReadable,\n} from '../utils';\n\nexport {\n  getStakingContractAddress,\n  getSupportedStakingChainIds,\n  isStakingContractAssetId,\n};\n\nexport type StakedBalancePollingInput = {\n  /** Chain ID (hex format, e.g. 0x1) */\n  chainId: ChainId;\n  /** Account ID */\n  accountId: AccountId;\n  /** Account address */\n  accountAddress: Address;\n};\n\n/** Human-readable staked balance (e.g. \"1.5\" for 1.5 ETH). */\nexport type StakedBalance = {\n  amount: string;\n};\n\n/** Result reported via the update callback. */\nexport type StakedBalanceFetchResult = {\n  /** Account ID (UUID). */\n  accountId: AccountId;\n  /** Hex chain ID. */\n  chainId: ChainId;\n  /** Human-readable staked balance. */\n  balance: StakedBalance;\n};\n\n/**\n * Callback type for staked balance updates.\n */\nexport type OnStakedBalanceUpdateCallback = (\n  result: StakedBalanceFetchResult,\n) => void;\n\n/** Staking contract ABI: getShares(account) and convertToAssets(shares). */\nconst STAKING_CONTRACT_ABI = [\n  {\n    inputs: [{ internalType: 'address', name: 'account', type: 'address' }],\n    name: 'getShares',\n    outputs: [{ internalType: 'uint256', name: '', type: 'uint256' }],\n    stateMutability: 'view',\n    type: 'function',\n  },\n  {\n    inputs: [{ internalType: 'uint256', name: 'shares', type: 'uint256' }],\n    name: 'convertToAssets',\n    outputs: [{ internalType: 'uint256', name: 'assets', type: 'uint256' }],\n    stateMutability: 'view',\n    type: 'function',\n  },\n];\n\nconst STAKING_INTERFACE = new Interface(STAKING_CONTRACT_ABI);\n\nconst STAKING_DECIMALS = 18;\n\nexport type StakedBalanceFetcherConfig = {\n  /** Polling interval in ms (default: 180s) */\n  pollingInterval?: number;\n  /** Returns the network provider for the given chain. Required for fetchStakedBalance. */\n  getNetworkProvider?: (chainId: ChainId) => Web3Provider | undefined;\n};\n\nconst DEFAULT_STAKED_BALANCE_INTERVAL = 180_000; // 3 minutes\n\nexport class StakedBalanceFetcher extends StaticIntervalPollingControllerOnly<StakedBalancePollingInput>() {\n  readonly #providerGetter?: (chainId: ChainId) => Web3Provider | undefined;\n\n  #onStakedBalanceUpdate: OnStakedBalanceUpdateCallback | undefined;\n\n  constructor(config?: StakedBalanceFetcherConfig) {\n    super();\n    this.#providerGetter = config?.getNetworkProvider;\n\n    this.setIntervalLength(\n      config?.pollingInterval ?? DEFAULT_STAKED_BALANCE_INTERVAL,\n    );\n  }\n\n  /**\n   * Register a callback that is invoked after every successful poll with\n   * the staked balance (including zero). Zero is reported so that merged\n   * updates can clear prior non-zero state.\n   *\n   * @param callback - The callback to invoke.\n   */\n  setOnStakedBalanceUpdate(callback: OnStakedBalanceUpdateCallback): void {\n    this.#onStakedBalanceUpdate = callback;\n  }\n\n  async _executePoll(input: StakedBalancePollingInput): Promise<void> {\n    let result: StakedBalance;\n    try {\n      result = await this.fetchStakedBalance(input);\n    } catch {\n      // Do not push an update on provider/RPC failure; otherwise we would\n      // overwrite existing non-zero staked balances with zero in state.\n      return;\n    }\n\n    if (this.#onStakedBalanceUpdate) {\n      this.#onStakedBalanceUpdate({\n        accountId: input.accountId,\n        chainId: input.chainId,\n        balance: result,\n      });\n    }\n  }\n\n  /**\n   * Fetches the staked balance for an account on a chain using the same\n   * staking contract as AccountTrackerController (getShares then convertToAssets).\n   * Returns a human-readable amount string (e.g. \"1.5\" for 1.5 ETH).\n   * Throws when no provider is available or when the RPC/contract call fails, so\n   * callers do not persist a false zero and overwrite existing balances.\n   *\n   * @param input - Chain, account ID, and address to query.\n   * @returns Human-readable staked balance (amount string).\n   * @throws When provider is missing or when getShares/convertToAssets fails.\n   */\n  async fetchStakedBalance(\n    input: StakedBalancePollingInput,\n  ): Promise<StakedBalance> {\n    const { chainId, accountAddress } = input;\n    const provider = this.#providerGetter?.(chainId);\n    if (!provider) {\n      throw new Error('StakedBalanceFetcher: no provider available for chain');\n    }\n    const contractAddress = getStakingContractAddress(chainId);\n\n    if (!contractAddress) {\n      return { amount: '0' };\n    }\n\n    try {\n      const sharesCalldata = STAKING_INTERFACE.encodeFunctionData('getShares', [\n        accountAddress,\n      ]);\n      const sharesResult = await provider.call({\n        to: contractAddress,\n        data: sharesCalldata,\n      });\n      const sharesRaw = STAKING_INTERFACE.decodeFunctionResult(\n        'getShares',\n        sharesResult,\n      )[0];\n      const sharesBigNum = BigInt(sharesRaw.toString());\n\n      if (sharesBigNum === 0n) {\n        return { amount: '0' };\n      }\n\n      const assetsCalldata = STAKING_INTERFACE.encodeFunctionData(\n        'convertToAssets',\n        [sharesBigNum],\n      );\n      const assetsResult = await provider.call({\n        to: contractAddress,\n        data: assetsCalldata,\n      });\n      const assetsRaw = STAKING_INTERFACE.decodeFunctionResult(\n        'convertToAssets',\n        assetsResult,\n      )[0];\n      const assetsWei = BigInt(assetsRaw.toString());\n\n      const amount = weiToHumanReadable(assetsWei, STAKING_DECIMALS);\n      return { amount };\n    } catch (error) {\n      throw error instanceof Error\n        ? error\n        : new Error('StakedBalanceFetcher: failed to fetch staked balance');\n    }\n  }\n}\n"]}

package/dist/data-sources/evm-rpc-services/services/index.cjs

@@ -1,8 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BalanceFetcher = exports.TokenDetector = void 0;
+exports.isStakingContractAssetId = exports.getStakingContractAddress = exports.getSupportedStakingChainIds = exports.StakedBalanceFetcher = exports.BalanceFetcher = exports.TokenDetector = void 0;
 var TokenDetector_1 = require("./TokenDetector.cjs");
 Object.defineProperty(exports, "TokenDetector", { enumerable: true, get: function () { return TokenDetector_1.TokenDetector; } });
 var BalanceFetcher_1 = require("./BalanceFetcher.cjs");
 Object.defineProperty(exports, "BalanceFetcher", { enumerable: true, get: function () { return BalanceFetcher_1.BalanceFetcher; } });
+var StakedBalanceFetcher_1 = require("./StakedBalanceFetcher.cjs");
+Object.defineProperty(exports, "StakedBalanceFetcher", { enumerable: true, get: function () { return StakedBalanceFetcher_1.StakedBalanceFetcher; } });
+Object.defineProperty(exports, "getSupportedStakingChainIds", { enumerable: true, get: function () { return StakedBalanceFetcher_1.getSupportedStakingChainIds; } });
+Object.defineProperty(exports, "getStakingContractAddress", { enumerable: true, get: function () { return StakedBalanceFetcher_1.getStakingContractAddress; } });
+Object.defineProperty(exports, "isStakingContractAssetId", { enumerable: true, get: function () { return StakedBalanceFetcher_1.isStakingContractAssetId; } });
 //# sourceMappingURL=index.cjs.map

package/dist/data-sources/evm-rpc-services/services/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/services/index.ts"],"names":[],"mappings":";;;AAAA,qDAMyB;AALvB,8GAAA,aAAa,OAAA;AAMf,uDAM0B;AALxB,gHAAA,cAAc,OAAA","sourcesContent":["export {\n  TokenDetector,\n  type TokenDetectorConfig,\n  type TokenDetectorMessenger,\n  type DetectionPollingInput,\n  type OnDetectionUpdateCallback,\n} from './TokenDetector';\nexport {\n  BalanceFetcher,\n  type BalanceFetcherConfig,\n  type BalanceFetcherMessenger,\n  type BalancePollingInput,\n  type OnBalanceUpdateCallback,\n} from './BalanceFetcher';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/services/index.ts"],"names":[],"mappings":";;;AAAA,qDAMyB;AALvB,8GAAA,aAAa,OAAA;AAMf,uDAM0B;AALxB,gHAAA,cAAc,OAAA;AAMhB,mEASgC;AAR9B,4HAAA,oBAAoB,OAAA;AACpB,mIAAA,2BAA2B,OAAA;AAC3B,iIAAA,yBAAyB,OAAA;AACzB,gIAAA,wBAAwB,OAAA","sourcesContent":["export {\n  TokenDetector,\n  type TokenDetectorConfig,\n  type TokenDetectorMessenger,\n  type DetectionPollingInput,\n  type OnDetectionUpdateCallback,\n} from './TokenDetector';\nexport {\n  BalanceFetcher,\n  type BalanceFetcherConfig,\n  type BalanceFetcherMessenger,\n  type BalancePollingInput,\n  type OnBalanceUpdateCallback,\n} from './BalanceFetcher';\nexport {\n  StakedBalanceFetcher,\n  getSupportedStakingChainIds,\n  getStakingContractAddress,\n  isStakingContractAssetId,\n  type StakedBalanceFetcherConfig,\n  type StakedBalancePollingInput,\n  type StakedBalanceFetchResult,\n  type OnStakedBalanceUpdateCallback,\n} from './StakedBalanceFetcher';\n"]}

package/dist/data-sources/evm-rpc-services/services/index.d.cts

@@ -1,3 +1,4 @@
 export { TokenDetector, type TokenDetectorConfig, type TokenDetectorMessenger, type DetectionPollingInput, type OnDetectionUpdateCallback, } from "./TokenDetector.cjs";
 export { BalanceFetcher, type BalanceFetcherConfig, type BalanceFetcherMessenger, type BalancePollingInput, type OnBalanceUpdateCallback, } from "./BalanceFetcher.cjs";
+export { StakedBalanceFetcher, getSupportedStakingChainIds, getStakingContractAddress, isStakingContractAssetId, type StakedBalanceFetcherConfig, type StakedBalancePollingInput, type StakedBalanceFetchResult, type OnStakedBalanceUpdateCallback, } from "./StakedBalanceFetcher.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/data-sources/evm-rpc-services/services/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,GAC/B,4BAAwB;AACzB,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,GAC7B,6BAAyB"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,GAC/B,4BAAwB;AACzB,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,GAC7B,6BAAyB;AAC1B,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,GACnC,mCAA+B"}

package/dist/data-sources/evm-rpc-services/services/index.d.mts

@@ -1,3 +1,4 @@
 export { TokenDetector, type TokenDetectorConfig, type TokenDetectorMessenger, type DetectionPollingInput, type OnDetectionUpdateCallback, } from "./TokenDetector.mjs";
 export { BalanceFetcher, type BalanceFetcherConfig, type BalanceFetcherMessenger, type BalancePollingInput, type OnBalanceUpdateCallback, } from "./BalanceFetcher.mjs";
+export { StakedBalanceFetcher, getSupportedStakingChainIds, getStakingContractAddress, isStakingContractAssetId, type StakedBalanceFetcherConfig, type StakedBalancePollingInput, type StakedBalanceFetchResult, type OnStakedBalanceUpdateCallback, } from "./StakedBalanceFetcher.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/data-sources/evm-rpc-services/services/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,GAC/B,4BAAwB;AACzB,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,GAC7B,6BAAyB"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,GAC/B,4BAAwB;AACzB,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,GAC7B,6BAAyB;AAC1B,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,GACnC,mCAA+B"}

package/dist/data-sources/evm-rpc-services/services/index.mjs

@@ -1,3 +1,4 @@
 export { TokenDetector } from "./TokenDetector.mjs";
 export { BalanceFetcher } from "./BalanceFetcher.mjs";
+export { StakedBalanceFetcher, getSupportedStakingChainIds, getStakingContractAddress, isStakingContractAssetId } from "./StakedBalanceFetcher.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/data-sources/evm-rpc-services/services/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAKd,4BAAwB;AACzB,OAAO,EACL,cAAc,EAKf,6BAAyB","sourcesContent":["export {\n  TokenDetector,\n  type TokenDetectorConfig,\n  type TokenDetectorMessenger,\n  type DetectionPollingInput,\n  type OnDetectionUpdateCallback,\n} from './TokenDetector';\nexport {\n  BalanceFetcher,\n  type BalanceFetcherConfig,\n  type BalanceFetcherMessenger,\n  type BalancePollingInput,\n  type OnBalanceUpdateCallback,\n} from './BalanceFetcher';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAKd,4BAAwB;AACzB,OAAO,EACL,cAAc,EAKf,6BAAyB;AAC1B,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EAKzB,mCAA+B","sourcesContent":["export {\n  TokenDetector,\n  type TokenDetectorConfig,\n  type TokenDetectorMessenger,\n  type DetectionPollingInput,\n  type OnDetectionUpdateCallback,\n} from './TokenDetector';\nexport {\n  BalanceFetcher,\n  type BalanceFetcherConfig,\n  type BalanceFetcherMessenger,\n  type BalancePollingInput,\n  type OnBalanceUpdateCallback,\n} from './BalanceFetcher';\nexport {\n  StakedBalanceFetcher,\n  getSupportedStakingChainIds,\n  getStakingContractAddress,\n  isStakingContractAssetId,\n  type StakedBalanceFetcherConfig,\n  type StakedBalancePollingInput,\n  type StakedBalanceFetchResult,\n  type OnStakedBalanceUpdateCallback,\n} from './StakedBalanceFetcher';\n"]}

package/dist/data-sources/evm-rpc-services/types/state.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"state.cjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/types/state.ts"],"names":[],"mappings":"","sourcesContent":["import type { Address, ChainId } from './core';\n\n/**\n * Single token entry from token list.\n */\nexport type TokenListEntry = {\n  /** Contract address */\n  address: Address;\n  /** Token symbol */\n  symbol: string;\n  /** Token name */\n  name: string;\n  /** Token decimals */\n  decimals: number;\n  /** Logo URL */\n  iconUrl?: string;\n  /** Aggregator sources */\n  aggregators?: string[];\n  /** Occurrence count in lists */\n  occurrences?: number;\n};\n\n/**\n * Cache entry for a chain's token list.\n */\nexport type TokenChainsCacheEntry = {\n  /** Timestamp when the cache was last updated */\n  timestamp: number;\n  /** Token list data: address -> TokenListEntry */\n  data: Record<Address, TokenListEntry>;\n};\n\n/**\n * Token list state shape (from TokenListController).\n */\nexport type TokenListState = {\n  /** Map of chain ID to token list cache entry */\n  tokensChainsCache: Record<ChainId, TokenChainsCacheEntry>;\n};\n\n/**\n * Single asset balance entry.\n */\nexport type AssetBalanceEntry = {\n  /** Human-readable balance amount */\n  amount: string;\n};\n\n/**\n * Assets balance state shape (from AssetsController).\n * Maps accountId -> assetId (CAIP-19) -> balance entry.\n */\nexport type AssetsBalanceState = {\n  /** Balance data per account: accountId -> assetId -> balance */\n  assetsBalance: Record<string, Record<string, AssetBalanceEntry>>;\n};\n"]}
+{"version":3,"file":"state.cjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/types/state.ts"],"names":[],"mappings":"","sourcesContent":["import type { ChainId } from './core';\n\n/**\n * Single token entry from token list.\n */\nexport type TokenListEntry = {\n  /** Contract address */\n  address: string;\n  /** Token symbol */\n  symbol: string;\n  /** Token name */\n  name: string;\n  /** Token decimals */\n  decimals: number;\n  /** Logo URL */\n  iconUrl?: string;\n  /** Aggregator sources */\n  aggregators?: string[];\n  /** Occurrence count in lists */\n  occurrences?: number;\n};\n\n/**\n * Cache entry for a chain's token list.\n */\nexport type TokenChainsCacheEntry = {\n  /** Timestamp when the cache was last updated */\n  timestamp: number;\n  /** Token list data: address -> TokenListEntry */\n  data: Record<string, TokenListEntry>;\n};\n\n/**\n * Token list state shape (from TokenListController).\n */\nexport type TokenListState = {\n  /** Map of chain ID to token list cache entry */\n  tokensChainsCache: Record<ChainId, TokenChainsCacheEntry>;\n};\n\n/**\n * Single asset balance entry.\n */\nexport type AssetBalanceEntry = {\n  /** Human-readable balance amount */\n  amount: string;\n};\n\n/**\n * Assets balance state shape (from AssetsController).\n * Maps accountId -> assetId (CAIP-19) -> balance entry.\n */\nexport type AssetsBalanceState = {\n  /** Balance data per account: accountId -> assetId -> balance */\n  assetsBalance: Record<string, Record<string, AssetBalanceEntry>>;\n};\n"]}

package/dist/data-sources/evm-rpc-services/types/state.d.cts

@@ -1,10 +1,10 @@
-import type { Address, ChainId } from "./core.cjs";
+import type { ChainId } from "./core.cjs";
 /**
  * Single token entry from token list.
  */
 export type TokenListEntry = {
     /** Contract address */
-    address: Address;
+    address: string;
     /** Token symbol */
     symbol: string;
     /** Token name */
@@ -25,7 +25,7 @@ export type TokenChainsCacheEntry = {
     /** Timestamp when the cache was last updated */
     timestamp: number;
     /** Token list data: address -> TokenListEntry */
-    data: Record<Address, TokenListEntry>;
+    data: Record<string, TokenListEntry>;
 };
 /**
  * Token list state shape (from TokenListController).

package/dist/data-sources/evm-rpc-services/types/state.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.cts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/types/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAe;AAE/C;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,uBAAuB;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,gDAAgD;IAChD,iBAAiB,EAAE,MAAM,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;CAC3D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;CAClE,CAAC"}
+{"version":3,"file":"state.d.cts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/types/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAe;AAEtC;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,gDAAgD;IAChD,iBAAiB,EAAE,MAAM,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;CAC3D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;CAClE,CAAC"}

package/dist/data-sources/evm-rpc-services/types/state.d.mts

@@ -1,10 +1,10 @@
-import type { Address, ChainId } from "./core.mjs";
+import type { ChainId } from "./core.mjs";
 /**
  * Single token entry from token list.
  */
 export type TokenListEntry = {
     /** Contract address */
-    address: Address;
+    address: string;
     /** Token symbol */
     symbol: string;
     /** Token name */
@@ -25,7 +25,7 @@ export type TokenChainsCacheEntry = {
     /** Timestamp when the cache was last updated */
     timestamp: number;
     /** Token list data: address -> TokenListEntry */
-    data: Record<Address, TokenListEntry>;
+    data: Record<string, TokenListEntry>;
 };
 /**
  * Token list state shape (from TokenListController).

package/dist/data-sources/evm-rpc-services/types/state.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.mts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/types/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAe;AAE/C;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,uBAAuB;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,gDAAgD;IAChD,iBAAiB,EAAE,MAAM,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;CAC3D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;CAClE,CAAC"}
+{"version":3,"file":"state.d.mts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/types/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAe;AAEtC;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,gDAAgD;IAChD,iBAAiB,EAAE,MAAM,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;CAC3D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;CAClE,CAAC"}

package/dist/data-sources/evm-rpc-services/types/state.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"state.mjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/types/state.ts"],"names":[],"mappings":"","sourcesContent":["import type { Address, ChainId } from './core';\n\n/**\n * Single token entry from token list.\n */\nexport type TokenListEntry = {\n  /** Contract address */\n  address: Address;\n  /** Token symbol */\n  symbol: string;\n  /** Token name */\n  name: string;\n  /** Token decimals */\n  decimals: number;\n  /** Logo URL */\n  iconUrl?: string;\n  /** Aggregator sources */\n  aggregators?: string[];\n  /** Occurrence count in lists */\n  occurrences?: number;\n};\n\n/**\n * Cache entry for a chain's token list.\n */\nexport type TokenChainsCacheEntry = {\n  /** Timestamp when the cache was last updated */\n  timestamp: number;\n  /** Token list data: address -> TokenListEntry */\n  data: Record<Address, TokenListEntry>;\n};\n\n/**\n * Token list state shape (from TokenListController).\n */\nexport type TokenListState = {\n  /** Map of chain ID to token list cache entry */\n  tokensChainsCache: Record<ChainId, TokenChainsCacheEntry>;\n};\n\n/**\n * Single asset balance entry.\n */\nexport type AssetBalanceEntry = {\n  /** Human-readable balance amount */\n  amount: string;\n};\n\n/**\n * Assets balance state shape (from AssetsController).\n * Maps accountId -> assetId (CAIP-19) -> balance entry.\n */\nexport type AssetsBalanceState = {\n  /** Balance data per account: accountId -> assetId -> balance */\n  assetsBalance: Record<string, Record<string, AssetBalanceEntry>>;\n};\n"]}
+{"version":3,"file":"state.mjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/types/state.ts"],"names":[],"mappings":"","sourcesContent":["import type { ChainId } from './core';\n\n/**\n * Single token entry from token list.\n */\nexport type TokenListEntry = {\n  /** Contract address */\n  address: string;\n  /** Token symbol */\n  symbol: string;\n  /** Token name */\n  name: string;\n  /** Token decimals */\n  decimals: number;\n  /** Logo URL */\n  iconUrl?: string;\n  /** Aggregator sources */\n  aggregators?: string[];\n  /** Occurrence count in lists */\n  occurrences?: number;\n};\n\n/**\n * Cache entry for a chain's token list.\n */\nexport type TokenChainsCacheEntry = {\n  /** Timestamp when the cache was last updated */\n  timestamp: number;\n  /** Token list data: address -> TokenListEntry */\n  data: Record<string, TokenListEntry>;\n};\n\n/**\n * Token list state shape (from TokenListController).\n */\nexport type TokenListState = {\n  /** Map of chain ID to token list cache entry */\n  tokensChainsCache: Record<ChainId, TokenChainsCacheEntry>;\n};\n\n/**\n * Single asset balance entry.\n */\nexport type AssetBalanceEntry = {\n  /** Human-readable balance amount */\n  amount: string;\n};\n\n/**\n * Assets balance state shape (from AssetsController).\n * Maps accountId -> assetId (CAIP-19) -> balance entry.\n */\nexport type AssetsBalanceState = {\n  /** Balance data per account: accountId -> assetId -> balance */\n  assetsBalance: Record<string, Record<string, AssetBalanceEntry>>;\n};\n"]}

package/dist/data-sources/evm-rpc-services/utils/index.cjs

@@ -1,7 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.reduceInBatchesSerially = exports.divideIntoBatches = void 0;
+exports.STAKING_CONTRACT_ADDRESS_BY_CHAINID = exports.isStakingContractAssetId = exports.getSupportedStakingChainIds = exports.getStakingContractAddress = exports.weiToHumanReadable = exports.chainIdToHex = exports.reduceInBatchesSerially = exports.divideIntoBatches = void 0;
 var batch_1 = require("./batch.cjs");
 Object.defineProperty(exports, "divideIntoBatches", { enumerable: true, get: function () { return batch_1.divideIntoBatches; } });
 Object.defineProperty(exports, "reduceInBatchesSerially", { enumerable: true, get: function () { return batch_1.reduceInBatchesSerially; } });
+var parsing_1 = require("./parsing.cjs");
+Object.defineProperty(exports, "chainIdToHex", { enumerable: true, get: function () { return parsing_1.chainIdToHex; } });
+Object.defineProperty(exports, "weiToHumanReadable", { enumerable: true, get: function () { return parsing_1.weiToHumanReadable; } });
+var staking_contracts_1 = require("./staking-contracts.cjs");
+Object.defineProperty(exports, "getStakingContractAddress", { enumerable: true, get: function () { return staking_contracts_1.getStakingContractAddress; } });
+Object.defineProperty(exports, "getSupportedStakingChainIds", { enumerable: true, get: function () { return staking_contracts_1.getSupportedStakingChainIds; } });
+Object.defineProperty(exports, "isStakingContractAssetId", { enumerable: true, get: function () { return staking_contracts_1.isStakingContractAssetId; } });
+Object.defineProperty(exports, "STAKING_CONTRACT_ADDRESS_BY_CHAINID", { enumerable: true, get: function () { return staking_contracts_1.STAKING_CONTRACT_ADDRESS_BY_CHAINID; } });
 //# sourceMappingURL=index.cjs.map

package/dist/data-sources/evm-rpc-services/utils/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/utils/index.ts"],"names":[],"mappings":";;;AAAA,qCAAqE;AAA5D,0GAAA,iBAAiB,OAAA;AAAE,gHAAA,uBAAuB,OAAA","sourcesContent":["export { divideIntoBatches, reduceInBatchesSerially } from './batch';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/utils/index.ts"],"names":[],"mappings":";;;AAAA,qCAAqE;AAA5D,0GAAA,iBAAiB,OAAA;AAAE,gHAAA,uBAAuB,OAAA;AACnD,yCAA6D;AAApD,uGAAA,YAAY,OAAA;AAAE,6GAAA,kBAAkB,OAAA;AACzC,6DAK6B;AAJ3B,8HAAA,yBAAyB,OAAA;AACzB,gIAAA,2BAA2B,OAAA;AAC3B,6HAAA,wBAAwB,OAAA;AACxB,wIAAA,mCAAmC,OAAA","sourcesContent":["export { divideIntoBatches, reduceInBatchesSerially } from './batch';\nexport { chainIdToHex, weiToHumanReadable } from './parsing';\nexport {\n  getStakingContractAddress,\n  getSupportedStakingChainIds,\n  isStakingContractAssetId,\n  STAKING_CONTRACT_ADDRESS_BY_CHAINID,\n} from './staking-contracts';\n"]}

package/dist/data-sources/evm-rpc-services/utils/index.d.cts

@@ -1,2 +1,4 @@
 export { divideIntoBatches, reduceInBatchesSerially } from "./batch.cjs";
+export { chainIdToHex, weiToHumanReadable } from "./parsing.cjs";
+export { getStakingContractAddress, getSupportedStakingChainIds, isStakingContractAssetId, STAKING_CONTRACT_ADDRESS_BY_CHAINID, } from "./staking-contracts.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/data-sources/evm-rpc-services/utils/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,oBAAgB"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,oBAAgB;AACrE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,sBAAkB;AAC7D,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,EACxB,mCAAmC,GACpC,gCAA4B"}

package/dist/data-sources/evm-rpc-services/utils/index.d.mts

@@ -1,2 +1,4 @@
 export { divideIntoBatches, reduceInBatchesSerially } from "./batch.mjs";
+export { chainIdToHex, weiToHumanReadable } from "./parsing.mjs";
+export { getStakingContractAddress, getSupportedStakingChainIds, isStakingContractAssetId, STAKING_CONTRACT_ADDRESS_BY_CHAINID, } from "./staking-contracts.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/data-sources/evm-rpc-services/utils/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,oBAAgB"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,oBAAgB;AACrE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,sBAAkB;AAC7D,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,EACxB,mCAAmC,GACpC,gCAA4B"}

package/dist/data-sources/evm-rpc-services/utils/index.mjs

@@ -1,2 +1,4 @@
 export { divideIntoBatches, reduceInBatchesSerially } from "./batch.mjs";
+export { chainIdToHex, weiToHumanReadable } from "./parsing.mjs";
+export { getStakingContractAddress, getSupportedStakingChainIds, isStakingContractAssetId, STAKING_CONTRACT_ADDRESS_BY_CHAINID } from "./staking-contracts.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/data-sources/evm-rpc-services/utils/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,oBAAgB","sourcesContent":["export { divideIntoBatches, reduceInBatchesSerially } from './batch';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,oBAAgB;AACrE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,sBAAkB;AAC7D,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,EACxB,mCAAmC,EACpC,gCAA4B","sourcesContent":["export { divideIntoBatches, reduceInBatchesSerially } from './batch';\nexport { chainIdToHex, weiToHumanReadable } from './parsing';\nexport {\n  getStakingContractAddress,\n  getSupportedStakingChainIds,\n  isStakingContractAssetId,\n  STAKING_CONTRACT_ADDRESS_BY_CHAINID,\n} from './staking-contracts';\n"]}

package/dist/data-sources/evm-rpc-services/utils/parsing.cjs

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chainIdToHex = exports.weiToHumanReadable = void 0;
+const utils_1 = require("@metamask/utils");
+const bignumber_js_1 = __importDefault(require("bignumber.js"));
+/**
+ * Convert wei to human-readable amount with decimals, trim trailing zeros.
+ * Uses BigNumber for precision.
+ *
+ * Note: `.shiftedBy(-decimals).toFixed()` (no args) rounds to DECIMAL_PLACES (0
+ * by default in bignumber.js), producing integers (e.g. 1.5 ETH → "2").
+ * We use `.toFixed(decimals)` to preserve fractional precision, then trim
+ * trailing zeros so the result is e.g. "1.5" instead of "1.500000000000000000".
+ *
+ * @param wei - Balance in wei as bigint or decimal string.
+ * @param decimals - Token decimals (e.g. 18).
+ * @returns Human-readable amount string (e.g. "1.5").
+ */
+function weiToHumanReadable(wei, decimals) {
+    const weiStr = typeof wei === 'bigint' ? wei.toString() : wei;
+    const fixed = new bignumber_js_1.default(weiStr).shiftedBy(-decimals).toFixed(decimals);
+    const trimmed = fixed.replace(/\.?0+$/u, '');
+    return trimmed === '' ? '0' : trimmed;
+}
+exports.weiToHumanReadable = weiToHumanReadable;
+/**
+ * Normalize chain ID to hex for contract lookup (e.g. eip155:1 -> 0x1).
+ * Uses @metamask/utils for CAIP parsing.
+ *
+ * @param chainId - CAIP-2 or hex chain ID.
+ * @returns Hex chain ID for contract map lookup.
+ */
+function chainIdToHex(chainId) {
+    if ((0, utils_1.isStrictHexString)(chainId)) {
+        return chainId;
+    }
+    if ((0, utils_1.isCaipChainId)(chainId)) {
+        const { reference } = (0, utils_1.parseCaipChainId)(chainId);
+        return (0, utils_1.numberToHex)(parseInt(reference, 10));
+    }
+    return chainId;
+}
+exports.chainIdToHex = chainIdToHex;
+//# sourceMappingURL=parsing.cjs.map

package/dist/data-sources/evm-rpc-services/utils/parsing.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.cjs","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/utils/parsing.ts"],"names":[],"mappings":";;;;;;AAAA,2CAKyB;AAEzB,gEAAuC;AAIvC;;;;;;;;;;;;GAYG;AACH,SAAgB,kBAAkB,CAChC,GAAoB,EACpB,QAAgB;IAEhB,MAAM,MAAM,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAC9D,MAAM,KAAK,GAAG,IAAI,sBAAW,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC7C,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;AACxC,CAAC;AARD,gDAQC;AAED;;;;;;GAMG;AACH,SAAgB,YAAY,CAAC,OAA8B;IACzD,IAAI,IAAA,yBAAiB,EAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,IAAA,qBAAa,EAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,EAAE,SAAS,EAAE,GAAG,IAAA,wBAAgB,EAAC,OAAO,CAAC,CAAC;QAChD,OAAO,IAAA,mBAAW,EAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AATD,oCASC","sourcesContent":["import {\n  isCaipChainId,\n  isStrictHexString,\n  numberToHex,\n  parseCaipChainId,\n} from '@metamask/utils';\nimport type { CaipChainId, Hex } from '@metamask/utils';\nimport BigNumberJS from 'bignumber.js';\n\nimport type { ChainId } from '../types';\n\n/**\n * Convert wei to human-readable amount with decimals, trim trailing zeros.\n * Uses BigNumber for precision.\n *\n * Note: `.shiftedBy(-decimals).toFixed()` (no args) rounds to DECIMAL_PLACES (0\n * by default in bignumber.js), producing integers (e.g. 1.5 ETH → \"2\").\n * We use `.toFixed(decimals)` to preserve fractional precision, then trim\n * trailing zeros so the result is e.g. \"1.5\" instead of \"1.500000000000000000\".\n *\n * @param wei - Balance in wei as bigint or decimal string.\n * @param decimals - Token decimals (e.g. 18).\n * @returns Human-readable amount string (e.g. \"1.5\").\n */\nexport function weiToHumanReadable(\n  wei: string | bigint,\n  decimals: number,\n): string {\n  const weiStr = typeof wei === 'bigint' ? wei.toString() : wei;\n  const fixed = new BigNumberJS(weiStr).shiftedBy(-decimals).toFixed(decimals);\n  const trimmed = fixed.replace(/\\.?0+$/u, '');\n  return trimmed === '' ? '0' : trimmed;\n}\n\n/**\n * Normalize chain ID to hex for contract lookup (e.g. eip155:1 -> 0x1).\n * Uses @metamask/utils for CAIP parsing.\n *\n * @param chainId - CAIP-2 or hex chain ID.\n * @returns Hex chain ID for contract map lookup.\n */\nexport function chainIdToHex(chainId: ChainId | CaipChainId): Hex {\n  if (isStrictHexString(chainId)) {\n    return chainId;\n  }\n  if (isCaipChainId(chainId)) {\n    const { reference } = parseCaipChainId(chainId);\n    return numberToHex(parseInt(reference, 10));\n  }\n  return chainId;\n}\n"]}

package/dist/data-sources/evm-rpc-services/utils/parsing.d.cts

@@ -0,0 +1,25 @@
+import type { CaipChainId, Hex } from "@metamask/utils";
+import type { ChainId } from "../types/index.cjs";
+/**
+ * Convert wei to human-readable amount with decimals, trim trailing zeros.
+ * Uses BigNumber for precision.
+ *
+ * Note: `.shiftedBy(-decimals).toFixed()` (no args) rounds to DECIMAL_PLACES (0
+ * by default in bignumber.js), producing integers (e.g. 1.5 ETH → "2").
+ * We use `.toFixed(decimals)` to preserve fractional precision, then trim
+ * trailing zeros so the result is e.g. "1.5" instead of "1.500000000000000000".
+ *
+ * @param wei - Balance in wei as bigint or decimal string.
+ * @param decimals - Token decimals (e.g. 18).
+ * @returns Human-readable amount string (e.g. "1.5").
+ */
+export declare function weiToHumanReadable(wei: string | bigint, decimals: number): string;
+/**
+ * Normalize chain ID to hex for contract lookup (e.g. eip155:1 -> 0x1).
+ * Uses @metamask/utils for CAIP parsing.
+ *
+ * @param chainId - CAIP-2 or hex chain ID.
+ * @returns Hex chain ID for contract map lookup.
+ */
+export declare function chainIdToHex(chainId: ChainId | CaipChainId): Hex;
+//# sourceMappingURL=parsing.d.cts.map

package/dist/data-sources/evm-rpc-services/utils/parsing.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.d.cts","sourceRoot":"","sources":["../../../../src/data-sources/evm-rpc-services/utils/parsing.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,wBAAwB;AAGxD,OAAO,KAAK,EAAE,OAAO,EAAE,2BAAiB;AAExC;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,GAAG,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,MAAM,CAKR;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,GAAG,GAAG,CAShE"}