@metamask/multichain-network-controller/dist/types.d.mts

Multichain network controller

import type { AccountsControllerListMultichainAccountsAction } from "@metamask/accounts-controller";
import type { ControllerGetStateAction, ControllerStateChangeEvent } from "@metamask/base-controller";
import type { BtcScope, CaipAssetType, CaipChainId, SolScope, TrxScope } from "@metamask/keyring-api";
import type { InternalAccount } from "@metamask/keyring-internal-api";
import type { Messenger } from "@metamask/messenger";
import type { NetworkStatus, NetworkControllerSetActiveNetworkAction, NetworkControllerGetStateAction, NetworkControllerRemoveNetworkAction, NetworkControllerGetSelectedChainIdAction, NetworkControllerFindNetworkClientIdByChainIdAction, NetworkClientId } from "@metamask/network-controller";
import type { ActiveNetworksByAddress } from "./api/accounts-api.mjs";
import type { MultichainNetworkControllerMethodActions } from "./MultichainNetworkController/MultichainNetworkController-method-action-types.mjs";
export declare const MULTICHAIN_NETWORK_CONTROLLER_NAME = "MultichainNetworkController";
export type MultichainNetworkMetadata = {
    features: string[];
    status: NetworkStatus;
};
export type SupportedCaipChainId = BtcScope.Mainnet | BtcScope.Testnet | BtcScope.Testnet4 | BtcScope.Signet | BtcScope.Regtest | SolScope.Mainnet | SolScope.Testnet | SolScope.Devnet | TrxScope.Mainnet | TrxScope.Nile | TrxScope.Shasta;
export type CommonNetworkConfiguration = {
    /**
     * EVM network flag.
     */
    isEvm: boolean;
    /**
     * The chain ID of the network.
     */
    chainId: CaipChainId;
    /**
     * The name of the network.
     */
    name: string;
};
export type NonEvmNetworkConfiguration = CommonNetworkConfiguration & {
    /**
     * EVM network flag.
     */
    isEvm: false;
    /**
     * The native asset type of the network.
     */
    nativeCurrency: CaipAssetType;
};
export type EvmNetworkConfiguration = CommonNetworkConfiguration & {
    /**
     * EVM network flag.
     */
    isEvm: true;
    /**
     * The native asset type of the network.
     * For EVM, this is the network ticker since there is no standard between
     * tickers and Caip IDs.
     */
    nativeCurrency: string;
    /**
     * The block explorers of the network.
     */
    blockExplorerUrls: string[];
    /**
     * The index of the default block explorer URL.
     */
    defaultBlockExplorerUrlIndex: number;
};
export type MultichainNetworkConfiguration = EvmNetworkConfiguration | NonEvmNetworkConfiguration;
/**
 * State used by the {@link MultichainNetworkController} to cache network configurations.
 */
export type MultichainNetworkControllerState = {
    /**
     * The network configurations by chain ID.
     */
    multichainNetworkConfigurationsByChainId: Record<CaipChainId, MultichainNetworkConfiguration>;
    /**
     * The chain ID of the selected network.
     */
    selectedMultichainNetworkChainId: SupportedCaipChainId;
    /**
     * Whether EVM or non-EVM network is selected
     */
    isEvmSelected: boolean;
    /**
     * The active networks for the available EVM addresses (non-EVM networks will be supported in the future).
     */
    networksWithTransactionActivity: ActiveNetworksByAddress;
};
/**
 * Returns the state of the {@link MultichainNetworkController}.
 */
export type MultichainNetworkControllerGetStateAction = ControllerGetStateAction<typeof MULTICHAIN_NETWORK_CONTROLLER_NAME, MultichainNetworkControllerState>;
/**
 * Event emitted when the state of the {@link MultichainNetworkController} changes.
 */
export type MultichainNetworkControllerStateChange = ControllerStateChangeEvent<typeof MULTICHAIN_NETWORK_CONTROLLER_NAME, MultichainNetworkControllerState>;
export type MultichainNetworkControllerNetworkDidChangeEvent = {
    type: `${typeof MULTICHAIN_NETWORK_CONTROLLER_NAME}:networkDidChange`;
    payload: [NetworkClientId | SupportedCaipChainId];
};
/**
 * Actions exposed by the {@link MultichainNetworkController}.
 */
export type MultichainNetworkControllerActions = MultichainNetworkControllerGetStateAction | MultichainNetworkControllerMethodActions;
/**
 * Events emitted by {@link MultichainNetworkController}.
 */
export type MultichainNetworkControllerEvents = MultichainNetworkControllerStateChange | MultichainNetworkControllerNetworkDidChangeEvent;
/**
 * Actions that this controller is allowed to call.
 */
type AllowedActions = NetworkControllerGetStateAction | NetworkControllerSetActiveNetworkAction | AccountsControllerListMultichainAccountsAction | NetworkControllerRemoveNetworkAction | NetworkControllerGetSelectedChainIdAction | NetworkControllerFindNetworkClientIdByChainIdAction;
export type AccountsControllerSelectedAccountChangeEvent = {
    type: `AccountsController:selectedAccountChange`;
    payload: [InternalAccount];
};
/**
 * Events that this controller is allowed to subscribe.
 */
type AllowedEvents = AccountsControllerSelectedAccountChangeEvent;
/**
 * Messenger type for the MultichainNetworkController.
 */
export type MultichainNetworkControllerMessenger = Messenger<typeof MULTICHAIN_NETWORK_CONTROLLER_NAME, MultichainNetworkControllerActions | AllowedActions, MultichainNetworkControllerEvents | AllowedEvents>;
export {};
//# sourceMappingURL=types.d.mts.map