@metamask-previews/multichain-transactions-controller 0.1.0-preview-2a6578b3 → 0.1.0-preview-99939da3

package/dist/MultichainTransactionsController.mjs

@@ -3,13 +3,19 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     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 _MultichainTransactionsController_instances, _MultichainTransactionsController_listMultichainAccounts, _MultichainTransactionsController_listAccounts, _MultichainTransactionsController_getTransactions, _MultichainTransactionsController_isNonEvmAccount, _MultichainTransactionsController_handleOnAccountAdded, _MultichainTransactionsController_handleOnAccountRemoved, _MultichainTransactionsController_handleOnAccountTransactionsUpdated, _MultichainTransactionsController_getClient;
+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 _MultichainTransactionsController_instances, _MultichainTransactionsController_tracker, _MultichainTransactionsController_listMultichainAccounts, _MultichainTransactionsController_listAccounts, _MultichainTransactionsController_updateTransactions, _MultichainTransactionsController_getTransactions, _MultichainTransactionsController_getBlockTimeFor, _MultichainTransactionsController_isNonEvmAccount, _MultichainTransactionsController_handleOnAccountAdded, _MultichainTransactionsController_handleOnAccountRemoved, _MultichainTransactionsController_getClient;
 import { BaseController } from "@metamask/base-controller";
 import { isEvmAccountType } from "@metamask/keyring-api";
 import { KeyringClient } from "@metamask/keyring-snap-client";
 import { HandlerType } from "@metamask/snaps-utils";
-import { KnownCaipNamespace, parseCaipChainId } from "@metamask/utils";
-import { MultichainNetwork } from "./constants.mjs";
+import { MultichainNetwork, TRANSACTIONS_CHECK_INTERVALS } from "./constants.mjs";
+import { MultichainTransactionsTracker } from "./MultichainTransactionsTracker.mjs";
 const controllerName = 'MultichainTransactionsController';
 /**
  * Constructs the default {@link MultichainTransactionsController} state.
@@ -50,61 +56,81 @@ export class MultichainTransactionsController extends BaseController {
             },
         });
         _MultichainTransactionsController_instances.add(this);
-        // Fetch initial transactions for all non-EVM accounts
+        _MultichainTransactionsController_tracker.set(this, void 0);
+        __classPrivateFieldSet(this, _MultichainTransactionsController_tracker, new MultichainTransactionsTracker(async (accountId, pagination) => await __classPrivateFieldGet(this, _MultichainTransactionsController_instances, "m", _MultichainTransactionsController_updateTransactions).call(this, accountId, pagination)), "f");
+        // Register all non-EVM accounts into the tracker
         for (const account of __classPrivateFieldGet(this, _MultichainTransactionsController_instances, "m", _MultichainTransactionsController_listAccounts).call(this)) {
-            this.updateTransactionsForAccount(account.id).catch((error) => {
-                console.error(`Failed to fetch initial transactions for account ${account.id}:`, error);
-            });
+            if (__classPrivateFieldGet(this, _MultichainTransactionsController_instances, "m", _MultichainTransactionsController_isNonEvmAccount).call(this, account)) {
+                __classPrivateFieldGet(this, _MultichainTransactionsController_tracker, "f").track(account.id, __classPrivateFieldGet(this, _MultichainTransactionsController_instances, "m", _MultichainTransactionsController_getBlockTimeFor).call(this, account));
+            }
         }
         this.messagingSystem.subscribe('AccountsController:accountAdded', (account) => __classPrivateFieldGet(this, _MultichainTransactionsController_instances, "m", _MultichainTransactionsController_handleOnAccountAdded).call(this, account));
         this.messagingSystem.subscribe('AccountsController:accountRemoved', (accountId) => __classPrivateFieldGet(this, _MultichainTransactionsController_instances, "m", _MultichainTransactionsController_handleOnAccountRemoved).call(this, accountId));
-        this.messagingSystem.subscribe('AccountsController:accountTransactionsUpdated', (transactionsUpdate) => __classPrivateFieldGet(this, _MultichainTransactionsController_instances, "m", _MultichainTransactionsController_handleOnAccountTransactionsUpdated).call(this, transactionsUpdate));
     }
     /**
-     * Updates transactions for a specific account. This is used for the initial fetch
-     * when an account is first added.
+     * Updates transactions for a specific account
      *
      * @param accountId - The ID of the account to get transactions for.
      */
     async updateTransactionsForAccount(accountId) {
-        try {
-            const account = __classPrivateFieldGet(this, _MultichainTransactionsController_instances, "m", _MultichainTransactionsController_listAccounts).call(this).find((accountItem) => accountItem.id === accountId);
-            if (account?.metadata.snap) {
-                const response = await __classPrivateFieldGet(this, _MultichainTransactionsController_instances, "m", _MultichainTransactionsController_getTransactions).call(this, account.id, account.metadata.snap.id, { limit: 10 });
-                // Filter only Solana transactions to ensure they're on mainnet.
-                // All other chain transactions are included as-is.
-                // TODO: Maybe we should not do any filtering here? Or maybe have it
-                // being configurable somehow?
-                const transactions = response.data.filter((tx) => {
-                    const chain = tx.chain;
-                    const { namespace } = parseCaipChainId(chain);
-                    // Enum comparison is safe here as we control both enum values
-                    // eslint-disable-next-line @typescript-eslint/no-unsafe-enum-comparison
-                    if (namespace === KnownCaipNamespace.Solana) {
-                        return chain === MultichainNetwork.Solana;
-                    }
-                    return true;
-                });
-                this.update((state) => {
-                    const entry = {
-                        transactions,
-                        next: response.next,
-                        lastUpdated: Date.now(),
-                    };
-                    Object.assign(state.nonEvmTransactions, { [account.id]: entry });
-                });
-            }
-        }
-        catch (error) {
-            console.error(`Failed to fetch transactions for account ${accountId}:`, error);
-        }
+        await __classPrivateFieldGet(this, _MultichainTransactionsController_tracker, "f").updateTransactionsForAccount(accountId);
+    }
+    /**
+     * Updates the transactions of all supported accounts. This method doesn't return
+     * anything, but it updates the state of the controller.
+     */
+    async updateTransactions() {
+        await __classPrivateFieldGet(this, _MultichainTransactionsController_tracker, "f").updateTransactions();
+    }
+    /**
+     * Starts the polling process.
+     */
+    start() {
+        __classPrivateFieldGet(this, _MultichainTransactionsController_tracker, "f").start();
+    }
+    /**
+     * Stops the polling process.
+     */
+    stop() {
+        __classPrivateFieldGet(this, _MultichainTransactionsController_tracker, "f").stop();
     }
 }
-_MultichainTransactionsController_instances = new WeakSet(), _MultichainTransactionsController_listMultichainAccounts = function _MultichainTransactionsController_listMultichainAccounts() {
+_MultichainTransactionsController_tracker = new WeakMap(), _MultichainTransactionsController_instances = new WeakSet(), _MultichainTransactionsController_listMultichainAccounts = function _MultichainTransactionsController_listMultichainAccounts() {
     return this.messagingSystem.call('AccountsController:listMultichainAccounts');
 }, _MultichainTransactionsController_listAccounts = function _MultichainTransactionsController_listAccounts() {
     const accounts = __classPrivateFieldGet(this, _MultichainTransactionsController_instances, "m", _MultichainTransactionsController_listMultichainAccounts).call(this);
     return accounts.filter((account) => __classPrivateFieldGet(this, _MultichainTransactionsController_instances, "m", _MultichainTransactionsController_isNonEvmAccount).call(this, account));
+}, _MultichainTransactionsController_updateTransactions = 
+/**
+ * Updates the transactions for one account.
+ *
+ * @param accountId - The ID of the account to update transactions for.
+ * @param pagination - Options for paginating transaction results.
+ */
+async function _MultichainTransactionsController_updateTransactions(accountId, pagination) {
+    const account = __classPrivateFieldGet(this, _MultichainTransactionsController_instances, "m", _MultichainTransactionsController_listAccounts).call(this).find((accountItem) => accountItem.id === accountId);
+    if (account?.metadata.snap) {
+        const response = await __classPrivateFieldGet(this, _MultichainTransactionsController_instances, "m", _MultichainTransactionsController_getTransactions).call(this, account.id, account.metadata.snap.id, pagination);
+        /**
+         * Filter only Solana transactions to ensure they're mainnet
+         * All other chain transactions are included as-is
+         */
+        const transactions = response.data.filter((tx) => {
+            const chain = tx.chain;
+            if (chain.startsWith(MultichainNetwork.Solana)) {
+                return chain === MultichainNetwork.Solana;
+            }
+            return true;
+        });
+        this.update((state) => {
+            const entry = {
+                transactions,
+                next: response.next,
+                lastUpdated: Date.now(),
+            };
+            Object.assign(state.nonEvmTransactions, { [account.id]: entry });
+        });
+    }
 }, _MultichainTransactionsController_getTransactions = 
 /**
  * Gets transactions for an account.
@@ -116,6 +142,11 @@ _MultichainTransactionsController_instances = new WeakSet(), _MultichainTransact
  */
 async function _MultichainTransactionsController_getTransactions(accountId, snapId, pagination) {
     return await __classPrivateFieldGet(this, _MultichainTransactionsController_instances, "m", _MultichainTransactionsController_getClient).call(this, snapId).listAccountTransactions(accountId, pagination);
+}, _MultichainTransactionsController_getBlockTimeFor = function _MultichainTransactionsController_getBlockTimeFor(account) {
+    if (account.type in TRANSACTIONS_CHECK_INTERVALS) {
+        return TRANSACTIONS_CHECK_INTERVALS[account.type];
+    }
+    throw new Error(`Unsupported account type for transactions tracking: ${account.type}`);
 }, _MultichainTransactionsController_isNonEvmAccount = function _MultichainTransactionsController_isNonEvmAccount(account) {
     return (!isEvmAccountType(account.type) &&
         // Non-EVM accounts are backed by a Snap for now
@@ -130,7 +161,7 @@ async function _MultichainTransactionsController_handleOnAccountAdded(account) {
     if (!__classPrivateFieldGet(this, _MultichainTransactionsController_instances, "m", _MultichainTransactionsController_isNonEvmAccount).call(this, account)) {
         return;
     }
-    await this.updateTransactionsForAccount(account.id);
+    __classPrivateFieldGet(this, _MultichainTransactionsController_tracker, "f").track(account.id, __classPrivateFieldGet(this, _MultichainTransactionsController_instances, "m", _MultichainTransactionsController_getBlockTimeFor).call(this, account));
 }, _MultichainTransactionsController_handleOnAccountRemoved = 
 /**
  * Handles changes when a new account has been removed.
@@ -138,20 +169,14 @@ async function _MultichainTransactionsController_handleOnAccountAdded(account) {
  * @param accountId - The account ID being removed.
  */
 async function _MultichainTransactionsController_handleOnAccountRemoved(accountId) {
+    if (__classPrivateFieldGet(this, _MultichainTransactionsController_tracker, "f").isTracked(accountId)) {
+        __classPrivateFieldGet(this, _MultichainTransactionsController_tracker, "f").untrack(accountId);
+    }
     if (accountId in this.state.nonEvmTransactions) {
         this.update((state) => {
             delete state.nonEvmTransactions[accountId];
         });
     }
-}, _MultichainTransactionsController_handleOnAccountTransactionsUpdated = function _MultichainTransactionsController_handleOnAccountTransactionsUpdated(transactionsUpdate) {
-    this.update((state) => {
-        Object.entries(transactionsUpdate.transactions).forEach(([accountId, transactions]) => {
-            if (accountId in state.nonEvmTransactions) {
-                state.nonEvmTransactions[accountId].transactions = transactions;
-                state.nonEvmTransactions[accountId].lastUpdated = Date.now();
-            }
-        });
-    });
 }, _MultichainTransactionsController_getClient = function _MultichainTransactionsController_getClient(snapId) {
     return new KeyringClient({
         send: async (request) => (await this.messagingSystem.call('SnapController:handleRequest', {

package/dist/MultichainTransactionsController.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"MultichainTransactionsController.mjs","sourceRoot":"","sources":["../src/MultichainTransactionsController.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  AccountsControllerAccountAddedEvent,\n  AccountsControllerAccountRemovedEvent,\n  AccountsControllerListMultichainAccountsAction,\n  AccountsControllerAccountTransactionsUpdatedEvent,\n} from '@metamask/accounts-controller';\nimport {\n  BaseController,\n  type ControllerGetStateAction,\n  type ControllerStateChangeEvent,\n  type RestrictedMessenger,\n} from '@metamask/base-controller';\nimport {\n  isEvmAccountType,\n  type Transaction,\n  type AccountTransactionsUpdatedEventPayload,\n} from '@metamask/keyring-api';\nimport type { InternalAccount } from '@metamask/keyring-internal-api';\nimport { KeyringClient } from '@metamask/keyring-snap-client';\nimport type { HandleSnapRequest } from '@metamask/snaps-controllers';\nimport type { SnapId } from '@metamask/snaps-sdk';\nimport { HandlerType } from '@metamask/snaps-utils';\nimport {\n  KnownCaipNamespace,\n  parseCaipChainId,\n  type Json,\n  type JsonRpcRequest,\n} from '@metamask/utils';\nimport type { Draft } from 'immer';\n\nimport { MultichainNetwork } from './constants';\n\nconst controllerName = 'MultichainTransactionsController';\n\n/**\n * PaginationOptions\n *\n * Represents options for paginating transaction results\n * limit - The maximum number of transactions to return\n * next - The cursor for the next page of transactions, or null if there is no next page\n */\nexport type PaginationOptions = {\n  limit: number;\n  next?: string | null;\n};\n\n/**\n * State used by the {@link MultichainTransactionsController} to cache account transactions.\n */\nexport type MultichainTransactionsControllerState = {\n  nonEvmTransactions: {\n    [accountId: string]: TransactionStateEntry;\n  };\n};\n\n/**\n * Constructs the default {@link MultichainTransactionsController} state.\n *\n * @returns The default {@link MultichainTransactionsController} state.\n */\nexport function getDefaultMultichainTransactionsControllerState(): MultichainTransactionsControllerState {\n  return {\n    nonEvmTransactions: {},\n  };\n}\n\n/**\n * Returns the state of the {@link MultichainTransactionsController}.\n */\nexport type MultichainTransactionsControllerGetStateAction =\n  ControllerGetStateAction<\n    typeof controllerName,\n    MultichainTransactionsControllerState\n  >;\n\n/**\n * Event emitted when the state of the {@link MultichainTransactionsController} changes.\n */\nexport type MultichainTransactionsControllerStateChange =\n  ControllerStateChangeEvent<\n    typeof controllerName,\n    MultichainTransactionsControllerState\n  >;\n\n/**\n * Actions exposed by the {@link MultichainTransactionsController}.\n */\nexport type MultichainTransactionsControllerActions =\n  MultichainTransactionsControllerGetStateAction;\n\n/**\n * Events emitted by {@link MultichainTransactionsController}.\n */\nexport type MultichainTransactionsControllerEvents =\n  MultichainTransactionsControllerStateChange;\n\n/**\n * Messenger type for the MultichainTransactionsController.\n */\nexport type MultichainTransactionsControllerMessenger = RestrictedMessenger<\n  typeof controllerName,\n  MultichainTransactionsControllerActions | AllowedActions,\n  MultichainTransactionsControllerEvents | AllowedEvents,\n  AllowedActions['type'],\n  AllowedEvents['type']\n>;\n\n/**\n * Actions that this controller is allowed to call.\n */\nexport type AllowedActions =\n  | HandleSnapRequest\n  | AccountsControllerListMultichainAccountsAction;\n\n/**\n * Events that this controller is allowed to subscribe.\n */\nexport type AllowedEvents =\n  | AccountsControllerAccountAddedEvent\n  | AccountsControllerAccountRemovedEvent\n  | AccountsControllerAccountTransactionsUpdatedEvent;\n\n/**\n * {@link MultichainTransactionsController}'s metadata.\n *\n * This allows us to choose if fields of the state should be persisted or not\n * using the `persist` flag; and if they can be sent to Sentry or not, using\n * the `anonymous` flag.\n */\nconst multichainTransactionsControllerMetadata = {\n  nonEvmTransactions: {\n    persist: true,\n    anonymous: false,\n  },\n};\n\n/**\n * The state of transactions for a specific account.\n */\nexport type TransactionStateEntry = {\n  transactions: Transaction[];\n  next: string | null;\n  lastUpdated: number;\n};\n\n/**\n * The MultichainTransactionsController is responsible for fetching and caching account\n * transactions for non-EVM accounts.\n */\nexport class MultichainTransactionsController extends BaseController<\n  typeof controllerName,\n  MultichainTransactionsControllerState,\n  MultichainTransactionsControllerMessenger\n> {\n  constructor({\n    messenger,\n    state,\n  }: {\n    messenger: MultichainTransactionsControllerMessenger;\n    state?: Partial<MultichainTransactionsControllerState>;\n  }) {\n    super({\n      messenger,\n      name: controllerName,\n      metadata: multichainTransactionsControllerMetadata,\n      state: {\n        ...getDefaultMultichainTransactionsControllerState(),\n        ...state,\n      },\n    });\n\n    // Fetch initial transactions for all non-EVM accounts\n    for (const account of this.#listAccounts()) {\n      this.updateTransactionsForAccount(account.id).catch((error) => {\n        console.error(\n          `Failed to fetch initial transactions for account ${account.id}:`,\n          error,\n        );\n      });\n    }\n\n    this.messagingSystem.subscribe(\n      'AccountsController:accountAdded',\n      (account: InternalAccount) => this.#handleOnAccountAdded(account),\n    );\n    this.messagingSystem.subscribe(\n      'AccountsController:accountRemoved',\n      (accountId: string) => this.#handleOnAccountRemoved(accountId),\n    );\n    this.messagingSystem.subscribe(\n      'AccountsController:accountTransactionsUpdated',\n      (transactionsUpdate: AccountTransactionsUpdatedEventPayload) =>\n        this.#handleOnAccountTransactionsUpdated(transactionsUpdate),\n    );\n  }\n\n  /**\n   * Lists the multichain accounts coming from the `AccountsController`.\n   *\n   * @returns A list of multichain accounts.\n   */\n  #listMultichainAccounts(): InternalAccount[] {\n    return this.messagingSystem.call(\n      'AccountsController:listMultichainAccounts',\n    );\n  }\n\n  /**\n   * Lists the accounts that we should get transactions for.\n   *\n   * @returns A list of accounts that we should get transactions for.\n   */\n  #listAccounts(): InternalAccount[] {\n    const accounts = this.#listMultichainAccounts();\n    return accounts.filter((account) => this.#isNonEvmAccount(account));\n  }\n\n  /**\n   * Gets transactions for an account.\n   *\n   * @param accountId - The ID of the account to get transactions for.\n   * @param snapId - The ID of the snap that manages the account.\n   * @param pagination - Options for paginating transaction results.\n   * @returns A promise that resolves to the transaction data and pagination info.\n   */\n  async #getTransactions(\n    accountId: string,\n    snapId: string,\n    pagination: PaginationOptions,\n  ): Promise<{\n    data: Transaction[];\n    next: string | null;\n  }> {\n    return await this.#getClient(snapId).listAccountTransactions(\n      accountId,\n      pagination,\n    );\n  }\n\n  /**\n   * Updates transactions for a specific account. This is used for the initial fetch\n   * when an account is first added.\n   *\n   * @param accountId - The ID of the account to get transactions for.\n   */\n  async updateTransactionsForAccount(accountId: string) {\n    try {\n      const account = this.#listAccounts().find(\n        (accountItem) => accountItem.id === accountId,\n      );\n\n      if (account?.metadata.snap) {\n        const response = await this.#getTransactions(\n          account.id,\n          account.metadata.snap.id,\n          { limit: 10 },\n        );\n\n        // Filter only Solana transactions to ensure they're on mainnet.\n        // All other chain transactions are included as-is.\n        // TODO: Maybe we should not do any filtering here? Or maybe have it\n        // being configurable somehow?\n        const transactions = response.data.filter((tx) => {\n          const chain = tx.chain as MultichainNetwork;\n          const { namespace } = parseCaipChainId(chain);\n          // Enum comparison is safe here as we control both enum values\n          // eslint-disable-next-line @typescript-eslint/no-unsafe-enum-comparison\n          if (namespace === KnownCaipNamespace.Solana) {\n            return chain === MultichainNetwork.Solana;\n          }\n          return true;\n        });\n\n        this.update((state: Draft<MultichainTransactionsControllerState>) => {\n          const entry: TransactionStateEntry = {\n            transactions,\n            next: response.next,\n            lastUpdated: Date.now(),\n          };\n\n          Object.assign(state.nonEvmTransactions, { [account.id]: entry });\n        });\n      }\n    } catch (error) {\n      console.error(\n        `Failed to fetch transactions for account ${accountId}:`,\n        error,\n      );\n    }\n  }\n\n  /**\n   * Checks for non-EVM accounts.\n   *\n   * @param account - The new account to be checked.\n   * @returns True if the account is a non-EVM account, false otherwise.\n   */\n  #isNonEvmAccount(account: InternalAccount): boolean {\n    return (\n      !isEvmAccountType(account.type) &&\n      // Non-EVM accounts are backed by a Snap for now\n      account.metadata.snap !== undefined\n    );\n  }\n\n  /**\n   * Handles changes when a new account has been added.\n   *\n   * @param account - The new account being added.\n   */\n  async #handleOnAccountAdded(account: InternalAccount) {\n    if (!this.#isNonEvmAccount(account)) {\n      return;\n    }\n\n    await this.updateTransactionsForAccount(account.id);\n  }\n\n  /**\n   * Handles changes when a new account has been removed.\n   *\n   * @param accountId - The account ID being removed.\n   */\n  async #handleOnAccountRemoved(accountId: string) {\n    if (accountId in this.state.nonEvmTransactions) {\n      this.update((state: Draft<MultichainTransactionsControllerState>) => {\n        delete state.nonEvmTransactions[accountId];\n      });\n    }\n  }\n\n  /**\n   * Handles transaction updates received from the AccountsController.\n   *\n   * @param transactionsUpdate - The transaction update event containing new transactions.\n   */\n  #handleOnAccountTransactionsUpdated(\n    transactionsUpdate: AccountTransactionsUpdatedEventPayload,\n  ): void {\n    this.update((state: Draft<MultichainTransactionsControllerState>) => {\n      Object.entries(transactionsUpdate.transactions).forEach(\n        ([accountId, transactions]) => {\n          if (accountId in state.nonEvmTransactions) {\n            state.nonEvmTransactions[accountId].transactions = transactions;\n            state.nonEvmTransactions[accountId].lastUpdated = Date.now();\n          }\n        },\n      );\n    });\n  }\n\n  /**\n   * Gets a `KeyringClient` for a Snap.\n   *\n   * @param snapId - ID of the Snap to get the client for.\n   * @returns A `KeyringClient` for the Snap.\n   */\n  #getClient(snapId: string): KeyringClient {\n    return new KeyringClient({\n      send: async (request: JsonRpcRequest) =>\n        (await this.messagingSystem.call('SnapController:handleRequest', {\n          snapId: snapId as SnapId,\n          origin: 'metamask',\n          handler: HandlerType.OnKeyringRequest,\n          request,\n        })) as Promise<Json>,\n    });\n  }\n}\n"]}
+{"version":3,"file":"MultichainTransactionsController.mjs","sourceRoot":"","sources":["../src/MultichainTransactionsController.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  AccountsControllerAccountAddedEvent,\n  AccountsControllerAccountRemovedEvent,\n  AccountsControllerListMultichainAccountsAction,\n} from '@metamask/accounts-controller';\nimport {\n  BaseController,\n  type ControllerGetStateAction,\n  type ControllerStateChangeEvent,\n  type RestrictedMessenger,\n} from '@metamask/base-controller';\nimport { isEvmAccountType, type Transaction } from '@metamask/keyring-api';\nimport type { InternalAccount } from '@metamask/keyring-internal-api';\nimport { KeyringClient } from '@metamask/keyring-snap-client';\nimport type { HandleSnapRequest } from '@metamask/snaps-controllers';\nimport type { SnapId } from '@metamask/snaps-sdk';\nimport { HandlerType } from '@metamask/snaps-utils';\nimport type { Json, JsonRpcRequest } from '@metamask/utils';\nimport type { Draft } from 'immer';\n\nimport { MultichainNetwork, TRANSACTIONS_CHECK_INTERVALS } from './constants';\nimport { MultichainTransactionsTracker } from './MultichainTransactionsTracker';\n\nconst controllerName = 'MultichainTransactionsController';\n\n/**\n * PaginationOptions\n *\n * Represents options for paginating transaction results\n * limit - The maximum number of transactions to return\n * next - The cursor for the next page of transactions, or null if there is no next page\n */\nexport type PaginationOptions = {\n  limit: number;\n  next?: string | null;\n};\n\n/**\n * State used by the {@link MultichainTransactionsController} to cache account transactions.\n */\nexport type MultichainTransactionsControllerState = {\n  nonEvmTransactions: {\n    [accountId: string]: TransactionStateEntry;\n  };\n};\n\n/**\n * Constructs the default {@link MultichainTransactionsController} state.\n *\n * @returns The default {@link MultichainTransactionsController} state.\n */\nexport function getDefaultMultichainTransactionsControllerState(): MultichainTransactionsControllerState {\n  return {\n    nonEvmTransactions: {},\n  };\n}\n\n/**\n * Returns the state of the {@link MultichainTransactionsController}.\n */\nexport type MultichainTransactionsControllerGetStateAction =\n  ControllerGetStateAction<\n    typeof controllerName,\n    MultichainTransactionsControllerState\n  >;\n\n/**\n * Updates the transactions of all supported accounts.\n */\nexport type MultichainTransactionsControllerListTransactionsAction = {\n  type: `${typeof controllerName}:updateTransactions`;\n  handler: MultichainTransactionsController['updateTransactions'];\n};\n\n/**\n * Event emitted when the state of the {@link MultichainTransactionsController} changes.\n */\nexport type MultichainTransactionsControllerStateChange =\n  ControllerStateChangeEvent<\n    typeof controllerName,\n    MultichainTransactionsControllerState\n  >;\n\n/**\n * Actions exposed by the {@link MultichainTransactionsController}.\n */\nexport type MultichainTransactionsControllerActions =\n  | MultichainTransactionsControllerGetStateAction\n  | MultichainTransactionsControllerListTransactionsAction;\n\n/**\n * Events emitted by {@link MultichainTransactionsController}.\n */\nexport type MultichainTransactionsControllerEvents =\n  MultichainTransactionsControllerStateChange;\n\n/**\n * Messenger type for the MultichainTransactionsController.\n */\nexport type MultichainTransactionsControllerMessenger = RestrictedMessenger<\n  typeof controllerName,\n  MultichainTransactionsControllerActions | AllowedActions,\n  MultichainTransactionsControllerEvents | AllowedEvents,\n  AllowedActions['type'],\n  AllowedEvents['type']\n>;\n\n/**\n * Actions that this controller is allowed to call.\n */\nexport type AllowedActions =\n  | HandleSnapRequest\n  | AccountsControllerListMultichainAccountsAction;\n\n/**\n * Events that this controller is allowed to subscribe.\n */\nexport type AllowedEvents =\n  | AccountsControllerAccountAddedEvent\n  | AccountsControllerAccountRemovedEvent;\n\n/**\n * {@link MultichainTransactionsController}'s metadata.\n *\n * This allows us to choose if fields of the state should be persisted or not\n * using the `persist` flag; and if they can be sent to Sentry or not, using\n * the `anonymous` flag.\n */\nconst multichainTransactionsControllerMetadata = {\n  nonEvmTransactions: {\n    persist: true,\n    anonymous: false,\n  },\n};\n\n/**\n * The state of transactions for a specific account.\n */\nexport type TransactionStateEntry = {\n  transactions: Transaction[];\n  next: string | null;\n  lastUpdated: number;\n};\n\n/**\n * The MultichainTransactionsController is responsible for fetching and caching account\n * transactions for non-EVM accounts.\n */\nexport class MultichainTransactionsController extends BaseController<\n  typeof controllerName,\n  MultichainTransactionsControllerState,\n  MultichainTransactionsControllerMessenger\n> {\n  readonly #tracker: MultichainTransactionsTracker;\n\n  constructor({\n    messenger,\n    state,\n  }: {\n    messenger: MultichainTransactionsControllerMessenger;\n    state?: Partial<MultichainTransactionsControllerState>;\n  }) {\n    super({\n      messenger,\n      name: controllerName,\n      metadata: multichainTransactionsControllerMetadata,\n      state: {\n        ...getDefaultMultichainTransactionsControllerState(),\n        ...state,\n      },\n    });\n\n    this.#tracker = new MultichainTransactionsTracker(\n      async (accountId: string, pagination: PaginationOptions) =>\n        await this.#updateTransactions(accountId, pagination),\n    );\n\n    // Register all non-EVM accounts into the tracker\n    for (const account of this.#listAccounts()) {\n      if (this.#isNonEvmAccount(account)) {\n        this.#tracker.track(account.id, this.#getBlockTimeFor(account));\n      }\n    }\n\n    this.messagingSystem.subscribe(\n      'AccountsController:accountAdded',\n      (account) => this.#handleOnAccountAdded(account),\n    );\n    this.messagingSystem.subscribe(\n      'AccountsController:accountRemoved',\n      (accountId: string) => this.#handleOnAccountRemoved(accountId),\n    );\n  }\n\n  /**\n   * Lists the multichain accounts coming from the `AccountsController`.\n   *\n   * @returns A list of multichain accounts.\n   */\n  #listMultichainAccounts(): InternalAccount[] {\n    return this.messagingSystem.call(\n      'AccountsController:listMultichainAccounts',\n    );\n  }\n\n  /**\n   * Lists the accounts that we should get transactions for.\n   *\n   * @returns A list of accounts that we should get transactions for.\n   */\n  #listAccounts(): InternalAccount[] {\n    const accounts = this.#listMultichainAccounts();\n    return accounts.filter((account) => this.#isNonEvmAccount(account));\n  }\n\n  /**\n   * Updates the transactions for one account.\n   *\n   * @param accountId - The ID of the account to update transactions for.\n   * @param pagination - Options for paginating transaction results.\n   */\n  async #updateTransactions(accountId: string, pagination: PaginationOptions) {\n    const account = this.#listAccounts().find(\n      (accountItem) => accountItem.id === accountId,\n    );\n\n    if (account?.metadata.snap) {\n      const response = await this.#getTransactions(\n        account.id,\n        account.metadata.snap.id,\n        pagination,\n      );\n\n      /**\n       * Filter only Solana transactions to ensure they're mainnet\n       * All other chain transactions are included as-is\n       */\n      const transactions = response.data.filter((tx) => {\n        const chain = tx.chain as MultichainNetwork;\n        if (chain.startsWith(MultichainNetwork.Solana)) {\n          return chain === MultichainNetwork.Solana;\n        }\n        return true;\n      });\n\n      this.update((state: Draft<MultichainTransactionsControllerState>) => {\n        const entry: TransactionStateEntry = {\n          transactions,\n          next: response.next,\n          lastUpdated: Date.now(),\n        };\n\n        Object.assign(state.nonEvmTransactions, { [account.id]: entry });\n      });\n    }\n  }\n\n  /**\n   * Gets transactions for an account.\n   *\n   * @param accountId - The ID of the account to get transactions for.\n   * @param snapId - The ID of the snap that manages the account.\n   * @param pagination - Options for paginating transaction results.\n   * @returns A promise that resolves to the transaction data and pagination info.\n   */\n  async #getTransactions(\n    accountId: string,\n    snapId: string,\n    pagination: PaginationOptions,\n  ): Promise<{\n    data: Transaction[];\n    next: string | null;\n  }> {\n    return await this.#getClient(snapId).listAccountTransactions(\n      accountId,\n      pagination,\n    );\n  }\n\n  /**\n   * Updates transactions for a specific account\n   *\n   * @param accountId - The ID of the account to get transactions for.\n   */\n  async updateTransactionsForAccount(accountId: string) {\n    await this.#tracker.updateTransactionsForAccount(accountId);\n  }\n\n  /**\n   * Updates the transactions of all supported accounts. This method doesn't return\n   * anything, but it updates the state of the controller.\n   */\n  async updateTransactions() {\n    await this.#tracker.updateTransactions();\n  }\n\n  /**\n   * Starts the polling process.\n   */\n  start(): void {\n    this.#tracker.start();\n  }\n\n  /**\n   * Stops the polling process.\n   */\n  stop(): void {\n    this.#tracker.stop();\n  }\n\n  /**\n   * Gets the block time for a given account.\n   *\n   * @param account - The account to get the block time for.\n   * @returns The block time for the account.\n   */\n  #getBlockTimeFor(account: InternalAccount): number {\n    if (account.type in TRANSACTIONS_CHECK_INTERVALS) {\n      return TRANSACTIONS_CHECK_INTERVALS[\n        account.type as keyof typeof TRANSACTIONS_CHECK_INTERVALS\n      ];\n    }\n    throw new Error(\n      `Unsupported account type for transactions tracking: ${account.type}`,\n    );\n  }\n\n  /**\n   * Checks for non-EVM accounts.\n   *\n   * @param account - The new account to be checked.\n   * @returns True if the account is a non-EVM account, false otherwise.\n   */\n  #isNonEvmAccount(account: InternalAccount): boolean {\n    return (\n      !isEvmAccountType(account.type) &&\n      // Non-EVM accounts are backed by a Snap for now\n      account.metadata.snap !== undefined\n    );\n  }\n\n  /**\n   * Handles changes when a new account has been added.\n   *\n   * @param account - The new account being added.\n   */\n  async #handleOnAccountAdded(account: InternalAccount) {\n    if (!this.#isNonEvmAccount(account)) {\n      return;\n    }\n\n    this.#tracker.track(account.id, this.#getBlockTimeFor(account));\n  }\n\n  /**\n   * Handles changes when a new account has been removed.\n   *\n   * @param accountId - The account ID being removed.\n   */\n  async #handleOnAccountRemoved(accountId: string) {\n    if (this.#tracker.isTracked(accountId)) {\n      this.#tracker.untrack(accountId);\n    }\n\n    if (accountId in this.state.nonEvmTransactions) {\n      this.update((state: Draft<MultichainTransactionsControllerState>) => {\n        delete state.nonEvmTransactions[accountId];\n      });\n    }\n  }\n\n  /**\n   * Gets a `KeyringClient` for a Snap.\n   *\n   * @param snapId - ID of the Snap to get the client for.\n   * @returns A `KeyringClient` for the Snap.\n   */\n  #getClient(snapId: string): KeyringClient {\n    return new KeyringClient({\n      send: async (request: JsonRpcRequest) =>\n        (await this.messagingSystem.call('SnapController:handleRequest', {\n          snapId: snapId as SnapId,\n          origin: 'metamask',\n          handler: HandlerType.OnKeyringRequest,\n          request,\n        })) as Promise<Json>,\n    });\n  }\n}\n"]}

package/dist/MultichainTransactionsTracker.cjs

@@ -0,0 +1,124 @@
+"use strict";
+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 _MultichainTransactionsTracker_poller, _MultichainTransactionsTracker_updateTransactions, _MultichainTransactionsTracker_transactions;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultichainTransactionsTracker = void 0;
+const Poller_1 = require("./Poller.cjs");
+// Every 5s in milliseconds.
+const TRANSACTIONS_TRACKING_INTERVAL = 5 * 1000;
+/**
+ * This class manages the tracking and periodic updating of transactions for multiple blockchain accounts.
+ *
+ * The tracker uses a polling mechanism to periodically check and update transactions
+ * for all tracked accounts, respecting each account's specific block time to determine
+ * when updates are needed.
+ */
+class MultichainTransactionsTracker {
+    constructor(updateTransactionsCallback) {
+        _MultichainTransactionsTracker_poller.set(this, void 0);
+        _MultichainTransactionsTracker_updateTransactions.set(this, void 0);
+        _MultichainTransactionsTracker_transactions.set(this, {});
+        __classPrivateFieldSet(this, _MultichainTransactionsTracker_updateTransactions, updateTransactionsCallback, "f");
+        __classPrivateFieldSet(this, _MultichainTransactionsTracker_poller, new Poller_1.Poller(() => {
+            this.updateTransactions().catch((error) => {
+                console.error('Failed to update transactions:', error);
+            });
+        }, TRANSACTIONS_TRACKING_INTERVAL), "f");
+    }
+    /**
+     * Starts the tracking process.
+     */
+    start() {
+        __classPrivateFieldGet(this, _MultichainTransactionsTracker_poller, "f").start();
+    }
+    /**
+     * Stops the tracking process.
+     */
+    stop() {
+        __classPrivateFieldGet(this, _MultichainTransactionsTracker_poller, "f").stop();
+    }
+    /**
+     * Checks if an account ID is being tracked.
+     *
+     * @param accountId - The account ID.
+     * @returns True if the account is being tracked, false otherwise.
+     */
+    isTracked(accountId) {
+        return accountId in __classPrivateFieldGet(this, _MultichainTransactionsTracker_transactions, "f");
+    }
+    /**
+     * Asserts that an account ID is being tracked.
+     *
+     * @param accountId - The account ID.
+     * @throws If the account ID is not being tracked.
+     */
+    assertBeingTracked(accountId) {
+        if (!this.isTracked(accountId)) {
+            throw new Error(`Account is not being tracked: ${accountId}`);
+        }
+    }
+    /**
+     * Starts tracking a new account ID. This method has no effect on already tracked
+     * accounts.
+     *
+     * @param accountId - The account ID.
+     * @param blockTime - The block time (used when refreshing the account transactions).
+     * @param pagination - Options for paginating transaction results. Defaults to { limit: 10 }.
+     */
+    track(accountId, blockTime, pagination = { limit: 10 }) {
+        if (!this.isTracked(accountId)) {
+            __classPrivateFieldGet(this, _MultichainTransactionsTracker_transactions, "f")[accountId] = {
+                lastUpdated: 0,
+                blockTime,
+                pagination,
+            };
+        }
+    }
+    /**
+     * Stops tracking a tracked account ID.
+     *
+     * @param accountId - The account ID.
+     * @throws If the account ID is not being tracked.
+     */
+    untrack(accountId) {
+        this.assertBeingTracked(accountId);
+        delete __classPrivateFieldGet(this, _MultichainTransactionsTracker_transactions, "f")[accountId];
+    }
+    /**
+     * Update the transactions for a tracked account ID.
+     *
+     * @param accountId - The account ID.
+     * @throws If the account ID is not being tracked.
+     */
+    async updateTransactionsForAccount(accountId) {
+        this.assertBeingTracked(accountId);
+        const info = __classPrivateFieldGet(this, _MultichainTransactionsTracker_transactions, "f")[accountId];
+        const isOutdated = Date.now() - info.lastUpdated >= info.blockTime;
+        const hasNoTransactionsYet = info.lastUpdated === 0;
+        if (hasNoTransactionsYet || isOutdated) {
+            await __classPrivateFieldGet(this, _MultichainTransactionsTracker_updateTransactions, "f").call(this, accountId, info.pagination);
+            __classPrivateFieldGet(this, _MultichainTransactionsTracker_transactions, "f")[accountId].lastUpdated = Date.now();
+        }
+    }
+    /**
+     * Update the transactions of all tracked accounts
+     */
+    async updateTransactions() {
+        await Promise.allSettled(Object.keys(__classPrivateFieldGet(this, _MultichainTransactionsTracker_transactions, "f")).map(async (accountId) => {
+            await this.updateTransactionsForAccount(accountId);
+        }));
+    }
+}
+exports.MultichainTransactionsTracker = MultichainTransactionsTracker;
+_MultichainTransactionsTracker_poller = new WeakMap(), _MultichainTransactionsTracker_updateTransactions = new WeakMap(), _MultichainTransactionsTracker_transactions = new WeakMap();
+//# sourceMappingURL=MultichainTransactionsTracker.cjs.map

package/dist/MultichainTransactionsTracker.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultichainTransactionsTracker.cjs","sourceRoot":"","sources":["../src/MultichainTransactionsTracker.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AACA,yCAAkC;AAQlC,4BAA4B;AAC5B,MAAM,8BAA8B,GAAG,CAAC,GAAG,IAAI,CAAC;AAEhD;;;;;;GAMG;AACH,MAAa,6BAA6B;IAUxC,YACE,0BAGkB;QAbX,wDAAgB;QAEhB,oEAGU;QAEnB,sDAAiD,EAAE,EAAC;QAQlD,uBAAA,IAAI,qDAAuB,0BAA0B,MAAA,CAAC;QAEtD,uBAAA,IAAI,yCAAW,IAAI,eAAM,CAAC,GAAG,EAAE;YAC7B,IAAI,CAAC,kBAAkB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACxC,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;YACzD,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,8BAA8B,CAAC,MAAA,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,uBAAA,IAAI,6CAAQ,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,IAAI;QACF,uBAAA,IAAI,6CAAQ,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,SAAiB;QACzB,OAAO,SAAS,IAAI,uBAAA,IAAI,mDAAc,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,SAAiB;QAClC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE;YAC9B,MAAM,IAAI,KAAK,CAAC,iCAAiC,SAAS,EAAE,CAAC,CAAC;SAC/D;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CACH,SAAiB,EACjB,SAAiB,EACjB,aAAgC,EAAE,KAAK,EAAE,EAAE,EAAE;QAE7C,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE;YAC9B,uBAAA,IAAI,mDAAc,CAAC,SAAS,CAAC,GAAG;gBAC9B,WAAW,EAAE,CAAC;gBACd,SAAS;gBACT,UAAU;aACX,CAAC;SACH;IACH,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,SAAiB;QACvB,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;QACnC,OAAO,uBAAA,IAAI,mDAAc,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,4BAA4B,CAAC,SAAiB;QAClD,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAEnC,MAAM,IAAI,GAAG,uBAAA,IAAI,mDAAc,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,SAAS,CAAC;QACnE,MAAM,oBAAoB,GAAG,IAAI,CAAC,WAAW,KAAK,CAAC,CAAC;QAEpD,IAAI,oBAAoB,IAAI,UAAU,EAAE;YACtC,MAAM,uBAAA,IAAI,yDAAoB,MAAxB,IAAI,EAAqB,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YAC3D,uBAAA,IAAI,mDAAc,CAAC,SAAS,CAAC,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;SACxD;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB;QACtB,MAAM,OAAO,CAAC,UAAU,CACtB,MAAM,CAAC,IAAI,CAAC,uBAAA,IAAI,mDAAc,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE;YACtD,MAAM,IAAI,CAAC,4BAA4B,CAAC,SAAS,CAAC,CAAC;QACrD,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;CACF;AA3HD,sEA2HC","sourcesContent":["import type { PaginationOptions } from './MultichainTransactionsController';\nimport { Poller } from './Poller';\n\ntype TransactionInfo = {\n  lastUpdated: number;\n  blockTime: number;\n  pagination: PaginationOptions;\n};\n\n// Every 5s in milliseconds.\nconst TRANSACTIONS_TRACKING_INTERVAL = 5 * 1000;\n\n/**\n * This class manages the tracking and periodic updating of transactions for multiple blockchain accounts.\n *\n * The tracker uses a polling mechanism to periodically check and update transactions\n * for all tracked accounts, respecting each account's specific block time to determine\n * when updates are needed.\n */\nexport class MultichainTransactionsTracker {\n  readonly #poller: Poller;\n\n  readonly #updateTransactions: (\n    accountId: string,\n    pagination: PaginationOptions,\n  ) => Promise<void>;\n\n  #transactions: Record<string, TransactionInfo> = {};\n\n  constructor(\n    updateTransactionsCallback: (\n      accountId: string,\n      pagination: PaginationOptions,\n    ) => Promise<void>,\n  ) {\n    this.#updateTransactions = updateTransactionsCallback;\n\n    this.#poller = new Poller(() => {\n      this.updateTransactions().catch((error) => {\n        console.error('Failed to update transactions:', error);\n      });\n    }, TRANSACTIONS_TRACKING_INTERVAL);\n  }\n\n  /**\n   * Starts the tracking process.\n   */\n  start(): void {\n    this.#poller.start();\n  }\n\n  /**\n   * Stops the tracking process.\n   */\n  stop(): void {\n    this.#poller.stop();\n  }\n\n  /**\n   * Checks if an account ID is being tracked.\n   *\n   * @param accountId - The account ID.\n   * @returns True if the account is being tracked, false otherwise.\n   */\n  isTracked(accountId: string) {\n    return accountId in this.#transactions;\n  }\n\n  /**\n   * Asserts that an account ID is being tracked.\n   *\n   * @param accountId - The account ID.\n   * @throws If the account ID is not being tracked.\n   */\n  assertBeingTracked(accountId: string) {\n    if (!this.isTracked(accountId)) {\n      throw new Error(`Account is not being tracked: ${accountId}`);\n    }\n  }\n\n  /**\n   * Starts tracking a new account ID. This method has no effect on already tracked\n   * accounts.\n   *\n   * @param accountId - The account ID.\n   * @param blockTime - The block time (used when refreshing the account transactions).\n   * @param pagination - Options for paginating transaction results. Defaults to { limit: 10 }.\n   */\n  track(\n    accountId: string,\n    blockTime: number,\n    pagination: PaginationOptions = { limit: 10 },\n  ) {\n    if (!this.isTracked(accountId)) {\n      this.#transactions[accountId] = {\n        lastUpdated: 0,\n        blockTime,\n        pagination,\n      };\n    }\n  }\n\n  /**\n   * Stops tracking a tracked account ID.\n   *\n   * @param accountId - The account ID.\n   * @throws If the account ID is not being tracked.\n   */\n  untrack(accountId: string) {\n    this.assertBeingTracked(accountId);\n    delete this.#transactions[accountId];\n  }\n\n  /**\n   * Update the transactions for a tracked account ID.\n   *\n   * @param accountId - The account ID.\n   * @throws If the account ID is not being tracked.\n   */\n  async updateTransactionsForAccount(accountId: string) {\n    this.assertBeingTracked(accountId);\n\n    const info = this.#transactions[accountId];\n    const isOutdated = Date.now() - info.lastUpdated >= info.blockTime;\n    const hasNoTransactionsYet = info.lastUpdated === 0;\n\n    if (hasNoTransactionsYet || isOutdated) {\n      await this.#updateTransactions(accountId, info.pagination);\n      this.#transactions[accountId].lastUpdated = Date.now();\n    }\n  }\n\n  /**\n   * Update the transactions of all tracked accounts\n   */\n  async updateTransactions() {\n    await Promise.allSettled(\n      Object.keys(this.#transactions).map(async (accountId) => {\n        await this.updateTransactionsForAccount(accountId);\n      }),\n    );\n  }\n}\n"]}

package/dist/MultichainTransactionsTracker.d.cts

@@ -0,0 +1,62 @@
+import type { PaginationOptions } from "./MultichainTransactionsController.cjs";
+/**
+ * This class manages the tracking and periodic updating of transactions for multiple blockchain accounts.
+ *
+ * The tracker uses a polling mechanism to periodically check and update transactions
+ * for all tracked accounts, respecting each account's specific block time to determine
+ * when updates are needed.
+ */
+export declare class MultichainTransactionsTracker {
+    #private;
+    constructor(updateTransactionsCallback: (accountId: string, pagination: PaginationOptions) => Promise<void>);
+    /**
+     * Starts the tracking process.
+     */
+    start(): void;
+    /**
+     * Stops the tracking process.
+     */
+    stop(): void;
+    /**
+     * Checks if an account ID is being tracked.
+     *
+     * @param accountId - The account ID.
+     * @returns True if the account is being tracked, false otherwise.
+     */
+    isTracked(accountId: string): boolean;
+    /**
+     * Asserts that an account ID is being tracked.
+     *
+     * @param accountId - The account ID.
+     * @throws If the account ID is not being tracked.
+     */
+    assertBeingTracked(accountId: string): void;
+    /**
+     * Starts tracking a new account ID. This method has no effect on already tracked
+     * accounts.
+     *
+     * @param accountId - The account ID.
+     * @param blockTime - The block time (used when refreshing the account transactions).
+     * @param pagination - Options for paginating transaction results. Defaults to { limit: 10 }.
+     */
+    track(accountId: string, blockTime: number, pagination?: PaginationOptions): void;
+    /**
+     * Stops tracking a tracked account ID.
+     *
+     * @param accountId - The account ID.
+     * @throws If the account ID is not being tracked.
+     */
+    untrack(accountId: string): void;
+    /**
+     * Update the transactions for a tracked account ID.
+     *
+     * @param accountId - The account ID.
+     * @throws If the account ID is not being tracked.
+     */
+    updateTransactionsForAccount(accountId: string): Promise<void>;
+    /**
+     * Update the transactions of all tracked accounts
+     */
+    updateTransactions(): Promise<void>;
+}
+//# sourceMappingURL=MultichainTransactionsTracker.d.cts.map

package/dist/MultichainTransactionsTracker.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultichainTransactionsTracker.d.cts","sourceRoot":"","sources":["../src/MultichainTransactionsTracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,+CAA2C;AAY5E;;;;;;GAMG;AACH,qBAAa,6BAA6B;;gBAWtC,0BAA0B,EAAE,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,iBAAiB,KAC1B,OAAO,CAAC,IAAI,CAAC;IAWpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;;;;OAKG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM;IAI3B;;;;;OAKG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM;IAMpC;;;;;;;OAOG;IACH,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,iBAAiC;IAW/C;;;;;OAKG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM;IAKzB;;;;;OAKG;IACG,4BAA4B,CAAC,SAAS,EAAE,MAAM;IAapD;;OAEG;IACG,kBAAkB;CAOzB"}

package/dist/MultichainTransactionsTracker.d.mts

@@ -0,0 +1,62 @@
+import type { PaginationOptions } from "./MultichainTransactionsController.mjs";
+/**
+ * This class manages the tracking and periodic updating of transactions for multiple blockchain accounts.
+ *
+ * The tracker uses a polling mechanism to periodically check and update transactions
+ * for all tracked accounts, respecting each account's specific block time to determine
+ * when updates are needed.
+ */
+export declare class MultichainTransactionsTracker {
+    #private;
+    constructor(updateTransactionsCallback: (accountId: string, pagination: PaginationOptions) => Promise<void>);
+    /**
+     * Starts the tracking process.
+     */
+    start(): void;
+    /**
+     * Stops the tracking process.
+     */
+    stop(): void;
+    /**
+     * Checks if an account ID is being tracked.
+     *
+     * @param accountId - The account ID.
+     * @returns True if the account is being tracked, false otherwise.
+     */
+    isTracked(accountId: string): boolean;
+    /**
+     * Asserts that an account ID is being tracked.
+     *
+     * @param accountId - The account ID.
+     * @throws If the account ID is not being tracked.
+     */
+    assertBeingTracked(accountId: string): void;
+    /**
+     * Starts tracking a new account ID. This method has no effect on already tracked
+     * accounts.
+     *
+     * @param accountId - The account ID.
+     * @param blockTime - The block time (used when refreshing the account transactions).
+     * @param pagination - Options for paginating transaction results. Defaults to { limit: 10 }.
+     */
+    track(accountId: string, blockTime: number, pagination?: PaginationOptions): void;
+    /**
+     * Stops tracking a tracked account ID.
+     *
+     * @param accountId - The account ID.
+     * @throws If the account ID is not being tracked.
+     */
+    untrack(accountId: string): void;
+    /**
+     * Update the transactions for a tracked account ID.
+     *
+     * @param accountId - The account ID.
+     * @throws If the account ID is not being tracked.
+     */
+    updateTransactionsForAccount(accountId: string): Promise<void>;
+    /**
+     * Update the transactions of all tracked accounts
+     */
+    updateTransactions(): Promise<void>;
+}
+//# sourceMappingURL=MultichainTransactionsTracker.d.mts.map

package/dist/MultichainTransactionsTracker.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultichainTransactionsTracker.d.mts","sourceRoot":"","sources":["../src/MultichainTransactionsTracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,+CAA2C;AAY5E;;;;;;GAMG;AACH,qBAAa,6BAA6B;;gBAWtC,0BAA0B,EAAE,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,iBAAiB,KAC1B,OAAO,CAAC,IAAI,CAAC;IAWpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;;;;OAKG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM;IAI3B;;;;;OAKG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM;IAMpC;;;;;;;OAOG;IACH,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,iBAAiC;IAW/C;;;;;OAKG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM;IAKzB;;;;;OAKG;IACG,4BAA4B,CAAC,SAAS,EAAE,MAAM;IAapD;;OAEG;IACG,kBAAkB;CAOzB"}