@dynamic-labs-sdk/solana 1.31.0 → 1.31.2

package/dist/metamask.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"metamask.cjs","names":["supportedNetworks: MetaMaskSupportedNetworks","latestDisplayUri: string | undefined","inFlightConnect: Promise<void> | null","getFeaturesForSolanaStandardWallet","MetaMaskWalletNotConnectedError","createWalletProviderFromSolanaStandardWallet","WalletProviderEnum","packageName","packageVersion"],"sources":["../src/metamask/utils/getSolanaNetworkFromCluster/getSolanaNetworkFromCluster.ts","../src/metamask/utils/getSupportedNetworks/getSupportedNetworks.ts","../src/metamask/utils/createMetaMaskSolanaController/createMetaMaskSolanaController.ts","../src/metamask/utils/getOrCreateMetaMaskSolanaController/getOrCreateMetaMaskSolanaController.ts","../src/metamask/createMetaMaskSolanaWalletProvider/createMetaMaskSolanaWalletProvider.ts","../src/metamask/connectWithMetaMaskUriSolana/connectWithMetaMaskUriSolana.ts","../src/metamask/connectAndVerifyWithMetaMaskUriSolana/connectAndVerifyWithMetaMaskUriSolana.ts","../src/metamask/getMetaMaskSolanaExtensionWalletProviderKey/getMetaMaskSolanaExtensionWalletProviderKey.ts","../src/exports/metamask.ts"],"sourcesContent":["import type { SolanaNetwork } from '@metamask/connect-solana';\n\n/** Parameters for {@link getSolanaNetworkFromCluster}. */\nexport type GetSolanaNetworkFromClusterParams = {\n  /** The Dynamic network `cluster` (e.g. `mainnet-beta`, `devnet`, `testnet`). */\n  cluster: string | undefined;\n};\n\n/**\n * Maps a Dynamic network `cluster` (e.g. `mainnet-beta`, `devnet`,\n * `testnet`) to the `mainnet | devnet | testnet` key shape expected by\n * `@metamask/connect-solana`'s `createSolanaClient`. Returns `undefined` for\n * clusters that do not correspond to one of MetaMask's supported Solana\n * networks so callers can skip them. Used by `getSupportedNetworks` to build\n * the SDK's `supportedNetworks` map.\n *\n * @notInstrumented\n */\nexport const getSolanaNetworkFromCluster = ({\n  cluster,\n}: GetSolanaNetworkFromClusterParams): SolanaNetwork | undefined => {\n  if (cluster === undefined) {\n    return undefined;\n  }\n\n  if (cluster.includes('mainnet')) {\n    return 'mainnet';\n  }\n\n  if (cluster.includes('devnet')) {\n    return 'devnet';\n  }\n\n  if (cluster.includes('testnet')) {\n    return 'testnet';\n  }\n\n  return undefined;\n};\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { getNetworksData } from '@dynamic-labs-sdk/client';\nimport { assertNonEmptyArray } from '@dynamic-labs-sdk/client/core';\nimport type { SolanaNetwork } from '@metamask/connect-solana';\n\nimport { getSolanaNetworkFromCluster } from '../getSolanaNetworkFromCluster';\n\ntype MetaMaskSupportedNetworks = Partial<Record<SolanaNetwork, string>>;\n\n/**\n * Builds the `supportedNetworks` map required by\n * `@metamask/connect-solana`'s `createSolanaClient`, keyed by the SDK's\n * `mainnet | devnet | testnet` network names and valued with the first\n * configured RPC URL for each. Sources the configured SOL networks from the\n * Dynamic client's project settings. Throws when no SOL network is\n * configured, mirroring the EVM `getSupportedNetworks` contract.\n *\n * @notInstrumented\n */\nexport const getSupportedNetworks = (\n  client: DynamicClient\n): MetaMaskSupportedNetworks => {\n  const solanaNetworks = getNetworksData(client).filter(\n    (network) => network.chain === 'SOL'\n  );\n\n  assertNonEmptyArray(\n    solanaNetworks,\n    'No SOL networks have been configured. Make sure to add at least one Solana network to your project settings in the Dynamic Dashboard.'\n  );\n\n  const supportedNetworks: MetaMaskSupportedNetworks = {};\n\n  for (const network of solanaNetworks) {\n    const solanaNetwork = getSolanaNetworkFromCluster({\n      cluster: network.cluster,\n    });\n\n    // Skip clusters MetaMask does not recognise, and keep the first RPC URL\n    // seen for a given network so earlier-configured networks take priority.\n    if (\n      solanaNetwork !== undefined &&\n      supportedNetworks[solanaNetwork] === undefined\n    ) {\n      supportedNetworks[solanaNetwork] = network.rpcUrls.http[0];\n    }\n  }\n\n  return supportedNetworks;\n};\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport {\n  getAppMetadata,\n  getCore,\n  getNativeLinkScheme,\n} from '@dynamic-labs-sdk/client/core';\nimport { clearMetaMaskSessionStorage } from '@dynamic-labs-sdk/metamask';\nimport type { DisplayUriListener } from '@dynamic-labs-sdk/metamask';\nimport { createSolanaClient } from '@metamask/connect-solana';\n\nimport { getFeaturesForSolanaStandardWallet } from '../../../walletStandard/utils/getFeaturesForSolanaStandardWallet';\nimport type { MetaMaskSolanaController } from '../../metamask.types';\nimport { getSupportedNetworks } from '../getSupportedNetworks';\n\n/**\n * Builds a fully-initialised `MetaMaskSolanaController` for the given Dynamic\n * client. Drives the `@metamask/connect-solana` SDK through its Wallet\n * Standard surface so consumers render their own QR / deep-link UI, and\n * subscribes to the SDK core's `display_uri` event at construction time so\n * the first URI emission cannot be lost to a subscription race. The wallet\n * is created with `skipAutoRegister` so this URI-pairing client does not\n * register itself into the global Wallet Standard registry — an announced\n * MetaMask extension is discovered independently. Dapp metadata is sourced\n * from the client's `getAppMetadata`. Browser-only.\n * The MetaMask SDK's own verbose logging is tied to the Dynamic client's log\n * level, so turning on `debug` logging for the Dynamic SDK also surfaces\n * MetaMask's internal SDK trace output.\n *\n * @notInstrumented\n */\nexport const createMetaMaskSolanaController = async (\n  client: DynamicClient\n): Promise<MetaMaskSolanaController> => {\n  const supportedNetworks = getSupportedNetworks(client);\n  const { appName, appLogoUrl, appUniversalLink, appNativeLink } =\n    getAppMetadata(client);\n  const { logger } = getCore(client);\n\n  // Drop any IndexedDB session state left behind by a previous tab, page\n  // reload, or abandoned pairing before the SDK initialises. The SDK's\n  // auto-recovery path otherwise picks up a stale transport descriptor and\n  // spends its (non-configurable) 10-second resume timeout on every\n  // controller construction trying to revive a relay session that no longer\n  // exists, surfacing as a long QR skeleton delay on every page reload that\n  // follows an abandoned pairing.\n  await clearMetaMaskSessionStorage(client);\n\n  const listeners = new Set<DisplayUriListener>();\n  let latestDisplayUri: string | undefined;\n\n  const sdk = await createSolanaClient({\n    api: { supportedNetworks },\n    dapp: {\n      iconUrl: appLogoUrl,\n      name: appName,\n      nativeScheme: getNativeLinkScheme({ nativeLink: appNativeLink }),\n      url: appUniversalLink ?? '',\n    },\n    // Mirror the Dynamic client's own debug level, so a consumer who turns on\n    // Dynamic SDK debug logging also gets MetaMask's internal SDK trace\n    // output without a second, MetaMask-specific toggle to remember.\n    debug: logger.isEnabled('debug'),\n    skipAutoRegister: true,\n  });\n\n  sdk.core.on('display_uri', (uri) => {\n    latestDisplayUri = uri;\n    for (const listener of listeners) {\n      listener(uri);\n    }\n  });\n\n  // A terminal connection state means any cached URI is for a pairing that is\n  // either complete or torn down, so it must not be replayed to late\n  // subscribers.\n  sdk.core.on('stateChanged', (status) => {\n    if (status === 'connected' || status === 'disconnected') {\n      latestDisplayUri = undefined;\n    }\n  });\n\n  // Defensive cleanup: even though we cleared IndexedDB before constructing\n  // the SDK, an in-flight `display_uri` emission could theoretically race the\n  // storage delete on slow devices. Clearing the cache here guarantees late\n  // subscribers cannot replay an URI that originated from any pairing attempt\n  // prior to this construction.\n  latestDisplayUri = undefined;\n\n  const onDisplayUri = (listener: DisplayUriListener): (() => void) => {\n    listeners.add(listener);\n    if (latestDisplayUri !== undefined) {\n      listener(latestDisplayUri);\n    }\n    return () => {\n      listeners.delete(listener);\n    };\n  };\n\n  // Tracks an in-flight `connect` call so that overlapping invocations (most\n  // commonly React's StrictMode double-invocation of effects, or a hook that\n  // re-runs while the user is still scanning) await the same underlying\n  // pairing instead of racing two connect calls against each other.\n  let inFlightConnect: Promise<void> | null = null;\n\n  const connect = (): Promise<void> => {\n    if (inFlightConnect) {\n      return inFlightConnect;\n    }\n\n    inFlightConnect = (async () => {\n      try {\n        // If a previous pairing was cancelled mid-flight the SDK can be left\n        // in `connecting` state with a dead transport descriptor; tear it\n        // down so the next connect issues a fresh URI synchronously instead\n        // of waiting for the SDK's (non-configurable) 10-second resume\n        // timeout.\n        if (sdk.core.status === 'connecting') {\n          try {\n            await sdk.disconnect();\n          } catch (error) {\n            getCore(client).logger.debug(\n              '[metamask] pre-connect disconnect rejected (expected when aborting a pairing the wallet never accepted)',\n              error\n            );\n          }\n        }\n\n        const features = getFeaturesForSolanaStandardWallet(sdk.getWallet());\n\n        await features['standard:connect'].connect();\n      } finally {\n        inFlightConnect = null;\n      }\n    })();\n\n    return inFlightConnect;\n  };\n\n  return {\n    clearCachedDisplayUri: () => {\n      latestDisplayUri = undefined;\n    },\n    connect,\n    getLatestDisplayUri: () => latestDisplayUri,\n    onDisplayUri,\n    sdk,\n  };\n};\n","import { createRuntimeServiceAccessKey } from '@dynamic-labs-sdk/client/core';\n\nimport { createMetaMaskSolanaController } from '../createMetaMaskSolanaController';\n\nconst RUNTIME_SERVICE_KEY = 'metaMaskSolanaController';\n\n/**\n * Per-`DynamicClient` accessor for the lazily-constructed MetaMask Solana\n * controller. Wraps `createMetaMaskSolanaController` with the standard\n * `runtimeServices` cache so every caller — the Wallet Standard\n * wallet-provider builder, the `display_uri` subscription helper, and the\n * `connectWithMetaMaskUriSolana` URI-returning helper — shares the same\n * controller (and therefore the same SDK instance, display-URI cache, and\n * listener registry) per Dynamic client.\n *\n * The cache is **per-Dynamic-client, not per-SDK-instance**:\n * `@metamask/connect-solana`'s `createSolanaClient` builds on the shared\n * MultichainCore singleton, so when multiple Dynamic clients coexist they\n * end up sharing the same MetaMask session regardless of this cache. The\n * wrapper exists to own the controller's `display_uri` cache and listener\n * registry per Dynamic client, which the SDK itself does not expose.\n *\n * @notInstrumented\n */\nexport const getOrCreateMetaMaskSolanaController = createRuntimeServiceAccessKey(\n  RUNTIME_SERVICE_KEY,\n  (client) => createMetaMaskSolanaController(client)\n);\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { MetaMaskWalletNotConnectedError } from '@dynamic-labs-sdk/metamask';\nimport { WalletProviderEnum } from '@dynamic-labs/sdk-api-core';\n\nimport type { SolanaWalletProvider } from '../../SolanaWalletProvider.types';\nimport { createWalletProviderFromSolanaStandardWallet } from '../../walletStandard/utils/createWalletProviderFromSolanaStandardWallet';\nimport { getOrCreateMetaMaskSolanaController } from '../utils/getOrCreateMetaMaskSolanaController';\n\n/**\n * Builds the `SolanaWalletProvider` registered AFTER a successful MetaMask\n * SDK URI pairing. Wraps the paired Wallet Standard wallet exposed by\n * `@metamask/connect-solana` behind the Dynamic Solana provider facade and\n * classifies it as `QrCode` so its key does not collide with an announced\n * MetaMask browser-extension provider for the same wallet name. Drops\n * `connect` so the provider is filtered out of the wallet picker by\n * `getAvailableWalletProvidersData` — mirroring how WalletConnect URI\n * sessions register a signing-only provider.\n *\n * @notInstrumented\n */\nexport const createMetaMaskSolanaWalletProvider = async (\n  client: DynamicClient\n): Promise<SolanaWalletProvider> => {\n  const controller = await getOrCreateMetaMaskSolanaController(client);\n\n  const walletStandardWallet = controller.sdk.getWallet();\n\n  // The provider is only meaningful once the URI pairing has produced a\n  // connected account; guard so a premature or out-of-order call raises a\n  // readable error instead of building a provider around an empty wallet.\n  if (walletStandardWallet.accounts.length === 0) {\n    throw new MetaMaskWalletNotConnectedError();\n  }\n\n  const walletProvider = createWalletProviderFromSolanaStandardWallet({\n    dynamicClient: client,\n    walletProviderType: WalletProviderEnum.QrCode,\n    walletStandardWallet,\n  });\n\n  return {\n    ...walletProvider,\n    connect: undefined,\n  };\n};\n","import { getDefaultClient } from '@dynamic-labs-sdk/client';\nimport type { WalletProviderUriConnectionResult } from '@dynamic-labs-sdk/client';\nimport { connectWithMetaMaskUri } from '@dynamic-labs-sdk/metamask';\n\nimport { registerSolanaNetworkProviderBuilder } from '../../registerSolanaNetworkProviderBuilder';\nimport { createMetaMaskSolanaWalletProvider } from '../createMetaMaskSolanaWalletProvider';\nimport { getOrCreateMetaMaskSolanaController } from '../utils/getOrCreateMetaMaskSolanaController';\n\nexport type ConnectWithMetaMaskUriSolanaParams = {\n  /** Whether to add the connected wallet account to the Dynamic client. Defaults to `true`. */\n  addToDynamicWalletAccounts?: boolean;\n};\n\n/**\n * Drives a MetaMask SDK URI pairing for Solana and returns `{ approval, uri }`\n * so consumers can render the QR / hand the URI to a deeplink. The resulting\n * wallet provider registers for signing only and is never surfaced in the\n * wallet picker. When the MetaMask extension is announced via Wallet Standard,\n * prefer routing through `getMetaMaskSolanaExtensionWalletProviderKey` instead.\n *\n * @notInstrumented\n */\nexport const connectWithMetaMaskUriSolana = (\n  { addToDynamicWalletAccounts = true }: ConnectWithMetaMaskUriSolanaParams = {},\n  client = getDefaultClient()\n): Promise<WalletProviderUriConnectionResult> => {\n  registerSolanaNetworkProviderBuilder(client);\n\n  return connectWithMetaMaskUri(\n    {\n      addToDynamicWalletAccounts,\n      chain: 'SOL',\n      getController: getOrCreateMetaMaskSolanaController,\n      walletProviderBuilder: createMetaMaskSolanaWalletProvider,\n    },\n    client\n  );\n};\n","import {\n  type WalletAccount,\n  type WalletProviderUriConnectionResult,\n  getDefaultClient,\n  verifyWalletAccount,\n} from '@dynamic-labs-sdk/client';\n\nimport { connectWithMetaMaskUriSolana } from '../connectWithMetaMaskUriSolana';\n\n/**\n * Drives a MetaMask SDK URI pairing for Solana and verifies ownership of the\n * paired wallet account through message signing, returning `{ approval, uri }`\n * so consumers can render the QR / hand the URI to a deeplink.\n *\n * Builds on `connectWithMetaMaskUriSolana` (rather than the chain-agnostic\n * connector directly) so the Solana-specific wiring stays defined in one\n * place, then wraps its `approval` to add the verification round-trip. The\n * pairing is driven with `addToDynamicWalletAccounts: false` so the account\n * lands as a verified credential instead of an unverified entry.\n *\n * The MetaMask SDK does not expose a single-round-trip authenticate\n * primitive, so this drives two sequential interactions on the wallet side:\n * the user first approves the pairing, then approves a sign-in message.\n *\n * @notInstrumented\n */\nexport const connectAndVerifyWithMetaMaskUriSolana = async (\n  client = getDefaultClient()\n): Promise<WalletProviderUriConnectionResult> => {\n  const { approval, uri } = await connectWithMetaMaskUriSolana(\n    { addToDynamicWalletAccounts: false },\n    client\n  );\n\n  const verifiedApproval = async (): Promise<{\n    walletAccounts: WalletAccount[];\n  }> => {\n    const { walletAccounts } = await approval();\n\n    // MetaMask SDK exposes a single active address per pairing, mirroring how\n    // the underlying connect helper materializes a single account from\n    // `addresses[0]`. Verify it directly.\n    const [walletAccount] = walletAccounts;\n\n    if (walletAccount) {\n      await verifyWalletAccount({ walletAccount }, client);\n    }\n\n    return { walletAccounts };\n  };\n\n  return { approval: verifiedApproval, uri };\n};\n","import { getDefaultClient } from '@dynamic-labs-sdk/client';\nimport { getMetaMaskExtensionWalletProviderKey } from '@dynamic-labs-sdk/metamask';\n\n/**\n * Returns the wallet provider key of the MetaMask browser extension announced\n * for Solana via Wallet Standard, or `undefined` when none is announced. Pass\n * the returned key to `connectWithWalletProvider` to route through the\n * announced provider; fall back to `connectWithMetaMaskUriSolana` when\n * `undefined`.\n *\n * @notInstrumented\n */\nexport const getMetaMaskSolanaExtensionWalletProviderKey = (\n  client = getDefaultClient()\n): string | undefined =>\n  getMetaMaskExtensionWalletProviderKey({ chain: 'SOL' }, client);\n","import { assertPackageVersion } from '@dynamic-labs-sdk/assert-package-version';\n\nimport {\n  name as packageName,\n  version as packageVersion,\n} from '../../package.json';\nassertPackageVersion(packageName, packageVersion);\n\nexport { connectAndVerifyWithMetaMaskUriSolana } from '../metamask/connectAndVerifyWithMetaMaskUriSolana';\nexport { connectWithMetaMaskUriSolana } from '../metamask/connectWithMetaMaskUriSolana';\nexport type { ConnectWithMetaMaskUriSolanaParams } from '../metamask/connectWithMetaMaskUriSolana/connectWithMetaMaskUriSolana';\nexport { getMetaMaskSolanaExtensionWalletProviderKey } from '../metamask/getMetaMaskSolanaExtensionWalletProviderKey';\nexport { MetaMaskDisplayUriMissingError } from '@dynamic-labs-sdk/metamask';\n"],"mappings":"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"}
+{"version":3,"file":"metamask.cjs","names":["BaseError","WalletProviderEnum","DYNAMIC_ICONIC_SPRITE_URL","isVersionedTransaction","VersionedTransaction","Transaction","getConnectedAddresses: SolanaWalletProvider['getConnectedAddresses']","getActiveNetworkId: SolanaWalletProvider['getActiveNetworkId']","switchActiveNetwork: SolanaWalletProvider['switchActiveNetwork']","signMessage: NonNullable<SolanaWalletProvider['signMessage']>","signTransaction: SolanaWalletProvider['signTransaction']","signAllTransactions: SolanaWalletProvider['signAllTransactions']","signedTransactions: T[]","signAndSendTransaction: SolanaWalletProvider['signAndSendTransaction']","disconnectWalletAccount: SolanaWalletProvider['disconnectWalletAccount']","destroy: SolanaWalletProvider['destroy']","solanaConfirmTransaction","solanaExecuteSwapTransaction","solanaTransferAmount","WalletProviderEnum","packageName","packageVersion"],"sources":["../src/errors/MetaMaskDirectConnectNotSupportedError/MetaMaskDirectConnectNotSupportedError.ts","../src/metamask/getMetaMaskSolanaSdkWalletProviderKey/getMetaMaskSolanaSdkWalletProviderKey.ts","../src/metamask/createMetaMaskSolanaWalletProvider/createMetaMaskSolanaWalletProvider.ts","../src/metamask/addMetaMaskSolanaExtension/addMetaMaskSolanaExtension.ts","../src/metamask/warnMetaMaskSolanaIntegrationIncomplete/warnMetaMaskSolanaIntegrationIncomplete.ts","../src/metamask/connectWithMetaMaskUriSolana/connectWithMetaMaskUriSolana.ts","../src/metamask/connectAndVerifyWithMetaMaskUriSolana/connectAndVerifyWithMetaMaskUriSolana.ts","../src/metamask/getMetaMaskSolanaExtensionWalletProviderKey/getMetaMaskSolanaExtensionWalletProviderKey.ts","../src/metamask/registerMetaMaskSolanaUriConnectionStarter/registerMetaMaskSolanaUriConnectionStarter.ts","../src/exports/metamask.ts"],"sourcesContent":["import { BaseError } from '@dynamic-labs-sdk/client';\n\n/**\n * Thrown when `connect()` is called directly on the MetaMask SDK placeholder\n * wallet provider (the entry `addMetaMaskSolanaExtension` registers so\n * MetaMask still shows up in the wallet picker when no browser extension is\n * installed). That placeholder has no generic connect flow of its own --\n * connecting requires the QR / deeplink pairing flow, so callers must drive\n * `connectWithMetaMaskUriSolana` (or `connectAndVerifyWithMetaMaskUriSolana`)\n * instead of the picker's default connect.\n */\nexport class MetaMaskDirectConnectNotSupportedError extends BaseError {\n  constructor() {\n    super({\n      cause: null,\n      code: 'metamask_direct_connect_not_supported',\n      docsUrl: null,\n      name: 'MetaMaskDirectConnectNotSupportedError',\n      shortMessage:\n        'MetaMask cannot be connected directly; call connectWithMetaMaskUriSolana (or connectAndVerifyWithMetaMaskUriSolana) to get a QR/URI pairing flow instead',\n    });\n  }\n}\n","import { formatWalletProviderKey } from '@dynamic-labs-sdk/client/core';\nimport { WalletProviderEnum } from '@dynamic-labs/sdk-api-core';\n\n// Kept in sync with `createMetaMaskSolanaWalletProvider`'s own copy of this\n// display name -- both derive the same deterministic key, and duplicating\n// the string here is simpler than threading a shared constant through an\n// aggregating export.\nconst METAMASK_SOLANA_SDK_DISPLAY_NAME = 'MetaMask';\n\n/**\n * Deterministic wallet provider key for the MetaMask SDK's connect-less\n * Solana placeholder. Computed without building the wallet provider itself,\n * so `addMetaMaskSolanaExtension` can check for a matching wallet account\n * before paying the cost of `createMetaMaskSolanaWalletProvider`.\n *\n * @example\n * ```ts\n * const key = getMetaMaskSolanaSdkWalletProviderKey();\n * ```\n * @returns The deterministic wallet provider key.\n * @see createMetaMaskSolanaWalletProvider\n * @see reconcileMetaMaskWalletProvider\n * @notInstrumented\n */\nexport const getMetaMaskSolanaSdkWalletProviderKey = (): string =>\n  formatWalletProviderKey({\n    chain: 'SOL',\n    displayName: METAMASK_SOLANA_SDK_DISPLAY_NAME,\n    walletProviderType: WalletProviderEnum.QrCode,\n  });\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { getNetworksData } from '@dynamic-labs-sdk/client';\nimport {\n  DYNAMIC_ICONIC_SPRITE_URL,\n  assertDefined,\n  formatWalletProviderGroupKey,\n  getActiveNetworkIdFromLastKnownRegistry,\n  getBuffer,\n  switchActiveNetworkInLastKnownRegistry,\n} from '@dynamic-labs-sdk/client/core';\nimport {\n  assertMetaMaskNetworkIsGranted,\n  createMetaMaskWalletProviderEventEmitter,\n  disconnectMetaMaskWalletProvider,\n  getOrCreateMetaMaskClientInstanceManager,\n  resolveActiveMetaMaskScope,\n} from '@dynamic-labs-sdk/metamask/core';\nimport { splitCaip10Token } from '@dynamic-labs-sdk/wallet-connect/core';\nimport { WalletProviderEnum } from '@dynamic-labs/sdk-api-core';\nimport { Transaction, VersionedTransaction } from '@solana/web3.js';\n\nimport { MetaMaskDirectConnectNotSupportedError } from '../../errors/MetaMaskDirectConnectNotSupportedError';\nimport type { SolanaWalletAccount } from '../../SolanaWalletAccount.types';\nimport type { SolanaWalletProvider } from '../../SolanaWalletProvider.types';\nimport { isVersionedTransaction } from '../../utils/isVersionedTransaction';\nimport { solanaConfirmTransaction } from '../../utils/solanaConfirmTransaction';\nimport { solanaExecuteSwapTransaction } from '../../utils/solanaExecuteSwapTransaction';\nimport { solanaTransferAmount } from '../../utils/solanaTransferAmount';\nimport { getMetaMaskSolanaSdkWalletProviderKey } from '../getMetaMaskSolanaSdkWalletProviderKey';\n\nconst METAMASK_DISPLAY_NAME = 'MetaMask';\nconst METAMASK_ICON = `${DYNAMIC_ICONIC_SPRITE_URL}#metamask`;\n\n/**\n * Builds the `SolanaWalletProvider` registered AFTER a successful MetaMask\n * SDK URI pairing. Unlike the EVM facade, MetaMask does not expose a typed\n * RPC surface for Solana, so this drives `invokeMethod` directly against the\n * documented `signMessage` / `signTransaction` / `signAndSendTransaction`\n * methods (see https://docs.metamask.io/metamask-connect/multichain/guides/sign-transactions/\n * and .../send-transactions/), scoped to `solana:<genesisHash>` per CAIP-2 —\n * MetaMask's multichain session grants every configured network as its own\n * scope up front, so \"the active network\" is tracked in Dynamic's own\n * last-known-network registry rather than asked of the SDK. Drops `connect`\n * so the provider is filtered out of the wallet picker by\n * `getAvailableWalletProvidersData` — mirroring how WalletConnect URI\n * sessions register a signing-only provider.\n *\n * MetaMask's multichain API does not document a batch-signing method for\n * Solana, so `signAllTransactions` signs each transaction with its own\n * `signTransaction` call (sequential wallet prompts) rather than one batch\n * approval.\n *\n * `getConnectedAddresses` and `switchActiveNetwork` route through\n * `resolveActiveMetaMaskScope`/`assertMetaMaskNetworkIsGranted` rather than\n * the registry directly, since every configured network is requested as an\n * *optional* scope -- MetaMask may grant an account for only a subset (see\n * their JSDoc).\n *\n * `switchActiveNetwork`/`disconnectWalletAccount` are local, Dynamic-side\n * actions with no live wallet event to bridge, so they emit `networkChanged`/\n * `disconnected` themselves via `metaMaskEvents` -- otherwise `events` would\n * never fire for MetaMask at all.\n *\n * @notInstrumented\n */\nexport const createMetaMaskSolanaWalletProvider = (\n  client: DynamicClient\n): SolanaWalletProvider => {\n  const metaMaskClientInstanceManager =\n    getOrCreateMetaMaskClientInstanceManager(client);\n\n  // Serializes a transaction the way MetaMask's multichain `signTransaction` /\n  // `signAndSendTransaction` methods expect: base64, unsigned.\n  const serializeTransaction = (\n    transaction: Transaction | VersionedTransaction\n  ): string =>\n    getBuffer()\n      .from(\n        transaction.serialize({\n          requireAllSignatures: false,\n          verifySignatures: false,\n        })\n      )\n      .toString('base64');\n\n  // Reconstructs a signed transaction from MetaMask's base64 response.\n  const deserializeTransaction = <\n    T extends Transaction | VersionedTransaction\n  >({\n    base64Transaction,\n    original,\n  }: {\n    base64Transaction: string;\n    original: T;\n  }): T => {\n    const bytes = getBuffer().from(base64Transaction, 'base64');\n\n    return (\n      isVersionedTransaction(original)\n        ? VersionedTransaction.deserialize(bytes)\n        : Transaction.from(bytes)\n    ) as T;\n  };\n\n  const walletProviderKey = getMetaMaskSolanaSdkWalletProviderKey();\n\n  // MetaMask's multichain session never fires a live wallet event we could\n  // bridge for `switchActiveNetwork`/`disconnectWalletAccount` below (both are\n  // local, Dynamic-side actions -- see their own comments), so this emitter is\n  // the only way `onWalletProviderEvent` consumers ever hear about them.\n  const metaMaskEvents = createMetaMaskWalletProviderEventEmitter();\n\n  const getActiveScope = async (): Promise<`solana:${string}`> => {\n    const { networkId } = await getActiveNetworkIdFromLastKnownRegistry({\n      client,\n      walletProviderKey,\n    });\n\n    const network = getNetworksData(client).find(\n      (candidate) =>\n        candidate.chain === 'SOL' && candidate.networkId === networkId\n    );\n\n    assertDefined(\n      network?.genesisHash,\n      `No configured SOL network with a genesis hash matches active network id \"${networkId}\"`\n    );\n\n    return `solana:${network.genesisHash}`;\n  };\n\n  const getConnectedAddresses: SolanaWalletProvider['getConnectedAddresses'] =\n    async () => {\n      const metaMaskClient =\n        await metaMaskClientInstanceManager.getMetaMaskClient();\n\n      // Every configured SOL network is requested as an *optional* MetaMask\n      // scope, so MetaMask may grant an account for only a subset (e.g. only\n      // mainnet, not a preconfigured devnet) -- resolveActiveMetaMaskScope\n      // falls back to whichever configured network DOES have a granted\n      // account, self-healing the registry's default rather than surfacing\n      // a false \"no address connected\".\n      const { accounts } = await resolveActiveMetaMaskScope(\n        { chain: 'SOL', metaMaskClient, walletProviderKey },\n        client\n      );\n\n      return {\n        addresses: accounts.map((account) => splitCaip10Token(account).address),\n      };\n    };\n\n  const getActiveNetworkId: SolanaWalletProvider['getActiveNetworkId'] =\n    async () =>\n      getActiveNetworkIdFromLastKnownRegistry({ client, walletProviderKey });\n\n  // The generic switchActiveNetwork asks the wallet live, which doesn't apply\n  // here: MetaMask's multichain session already grants every configured\n  // chain as its own scope up front, so \"switching\" is just updating which\n  // scope future requests target, tracked in Dynamic's own registry. Guarded\n  // against ever pointing that registry at a network MetaMask didn't\n  // actually grant -- see `assertMetaMaskNetworkIsGranted`.\n  const switchActiveNetwork: SolanaWalletProvider['switchActiveNetwork'] =\n    async ({ networkId }) => {\n      const metaMaskClient =\n        await metaMaskClientInstanceManager.getMetaMaskClient();\n\n      await assertMetaMaskNetworkIsGranted(\n        { chain: 'SOL', metaMaskClient, networkId },\n        client\n      );\n\n      // Read the previous value before writing, so networkChanged only fires\n      // on an actual change -- switching to the network that's already active\n      // is a no-op as far as any `onWalletProviderEvent` subscriber is concerned.\n      const { networkId: previousNetworkId } =\n        await getActiveNetworkIdFromLastKnownRegistry({\n          client,\n          walletProviderKey,\n        });\n\n      await switchActiveNetworkInLastKnownRegistry({\n        client,\n        networkId,\n        walletProviderKey,\n      });\n\n      if (networkId !== previousNetworkId) {\n        metaMaskEvents.emitNetworkChanged({ networkId });\n      }\n    };\n\n  const signMessage: NonNullable<SolanaWalletProvider['signMessage']> = async ({\n    message,\n    walletAccount,\n  }) => {\n    assertDefined(walletAccount, 'Wallet account is required');\n\n    const scope = await getActiveScope();\n    const metaMaskClient = await metaMaskClientInstanceManager.getMetaMaskClient();\n\n    const result = (await metaMaskClient.invokeMethod({\n      request: {\n        method: 'signMessage',\n        params: {\n          account: { address: walletAccount.address },\n          message: getBuffer().from(message, 'utf-8').toString('base64'),\n        },\n      },\n      scope,\n    })) as { signature: string };\n\n    return { signature: result.signature };\n  };\n\n  const signTransaction: SolanaWalletProvider['signTransaction'] = async ({\n    transaction,\n    walletAccount,\n  }) => {\n    const scope = await getActiveScope();\n    const metaMaskClient = await metaMaskClientInstanceManager.getMetaMaskClient();\n\n    const result = (await metaMaskClient.invokeMethod({\n      request: {\n        method: 'signTransaction',\n        params: {\n          account: { address: walletAccount.address },\n          scope,\n          transaction: serializeTransaction(transaction),\n        },\n      },\n      scope,\n    })) as { signedTransaction: string };\n\n    return {\n      signedTransaction: deserializeTransaction({\n        base64Transaction: result.signedTransaction,\n        original: transaction,\n      }),\n    };\n  };\n\n  const signAllTransactions: SolanaWalletProvider['signAllTransactions'] =\n    async <T extends Transaction | VersionedTransaction>({\n      transactions,\n      walletAccount,\n    }: {\n      transactions: T[];\n      walletAccount: SolanaWalletAccount;\n    }) => {\n      const signedTransactions: T[] = [];\n\n      // Sequential: MetaMask's multichain API has no documented batch-sign\n      // method for Solana, unlike the Wallet Standard surface this replaces.\n      for (const transaction of transactions) {\n        const { signedTransaction } = await signTransaction({\n          transaction,\n          walletAccount,\n        });\n        signedTransactions.push(signedTransaction as T);\n      }\n\n      return { signedTransactions };\n    };\n\n  const signAndSendTransaction: SolanaWalletProvider['signAndSendTransaction'] =\n    async ({ transaction, walletAccount }) => {\n      const scope = await getActiveScope();\n      const metaMaskClient =\n        await metaMaskClientInstanceManager.getMetaMaskClient();\n\n      const result = (await metaMaskClient.invokeMethod({\n        request: {\n          method: 'signAndSendTransaction',\n          params: {\n            account: { address: walletAccount.address },\n            scope,\n            transaction: serializeTransaction(transaction),\n          },\n        },\n        scope,\n      })) as { signature: string };\n\n      return { signature: result.signature };\n    };\n\n  // A MetaMask multichain session is scope-based rather than per-provider,\n  // so ending it properly means dropping this chain's scopes and cleaning\n  // up the persisted session -- see `disconnectMetaMaskWalletProvider`.\n  const disconnectWalletAccount: SolanaWalletProvider['disconnectWalletAccount'] =\n    async () => {\n      await disconnectMetaMaskWalletProvider(\n        { chain: 'SOL', walletProviderKey },\n        client\n      );\n      metaMaskEvents.emitDisconnected();\n    };\n\n  // Cleans up `metaMaskEvents` (the emitter behind `events` below) -- nothing\n  // else in this provider owns it or ever tears it down otherwise.\n  const destroy: SolanaWalletProvider['destroy'] = async () => {\n    metaMaskEvents.cleanupEventEmitter();\n  };\n\n  return {\n    chain: 'SOL',\n    confirmTransaction: (args) => solanaConfirmTransaction(args, client),\n    connect: async () => {\n      throw new MetaMaskDirectConnectNotSupportedError();\n    },\n    destroy,\n    disconnectWalletAccount,\n    get events() {\n      return metaMaskEvents.getEventEmitter();\n    },\n    executeSwapTransaction: (args) =>\n      solanaExecuteSwapTransaction(args, client),\n    getActiveNetworkId,\n    getConnectedAddresses,\n    groupKey: formatWalletProviderGroupKey(METAMASK_DISPLAY_NAME),\n    key: walletProviderKey,\n    metadata: {\n      displayName: METAMASK_DISPLAY_NAME,\n      icon: METAMASK_ICON,\n    },\n    signAllTransactions,\n    signAndSendTransaction,\n    signMessage,\n    signTransaction,\n    switchActiveNetwork,\n    transferAmount: (args) => solanaTransferAmount(args, client),\n    walletProviderType: WalletProviderEnum.QrCode,\n  };\n};\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport {\n  getDefaultClient,\n  hasExtension,\n  registerExtension,\n} from '@dynamic-labs-sdk/client/core';\nimport { reconcileMetaMaskWalletProvider } from '@dynamic-labs-sdk/metamask/core';\n\nimport { registerSolanaNetworkProviderBuilder } from '../../registerSolanaNetworkProviderBuilder';\nimport { createMetaMaskSolanaWalletProvider } from '../createMetaMaskSolanaWalletProvider';\nimport { getMetaMaskSolanaSdkWalletProviderKey } from '../getMetaMaskSolanaSdkWalletProviderKey';\n\nexport const METAMASK_SOLANA_EXTENSION_KEY = 'metaMaskSolana';\n\n/**\n * Integrates MetaMask Connect (MetaMask's multichain SDK) with the Dynamic\n * client for Solana, letting users connect MetaMask on platforms where the\n * browser extension isn't available — e.g. scanning a QR code, or opening\n * the MetaMask mobile app from a website or React Native app. Call this\n * once during setup.\n *\n * @example\n * ```ts\n * const client = createDynamicClient({ environmentId: '...' });\n *\n * addMetaMaskSolanaExtension(client);\n * ```\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns void\n * @see connectWithMetaMaskUriSolana\n * @see addSolanaWalletStandardExtension\n * @notInstrumented\n */\nexport const addMetaMaskSolanaExtension = (\n  client: DynamicClient = getDefaultClient()\n): void => {\n  if (hasExtension({ extensionKey: METAMASK_SOLANA_EXTENSION_KEY }, client)) {\n    return;\n  }\n\n  registerSolanaNetworkProviderBuilder(client);\n  registerExtension({ extensionKey: METAMASK_SOLANA_EXTENSION_KEY }, client);\n\n  reconcileMetaMaskWalletProvider(\n    {\n      walletProviderBuilder: createMetaMaskSolanaWalletProvider,\n      walletProviderKey: getMetaMaskSolanaSdkWalletProviderKey(),\n    },\n    client\n  );\n};\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { getCore, hasExtension } from '@dynamic-labs-sdk/client/core';\n\nimport { METAMASK_SOLANA_EXTENSION_KEY } from '../addMetaMaskSolanaExtension/addMetaMaskSolanaExtension';\n\n/**\n * Warns when `addMetaMaskSolanaExtension()` hasn't been added, since a\n * wallet connected via `connectWithMetaMaskUriSolana` without it won't be\n * restored after a page reload.\n *\n * @example\n * ```ts\n * warnMetaMaskSolanaIntegrationIncomplete(client);\n * ```\n * @param client - The Dynamic client instance.\n * @returns void\n * @see connectWithMetaMaskUriSolana\n * @see addMetaMaskSolanaExtension\n * @notInstrumented\n */\nexport const warnMetaMaskSolanaIntegrationIncomplete = (\n  client: DynamicClient\n): void => {\n  if (hasExtension({ extensionKey: METAMASK_SOLANA_EXTENSION_KEY }, client)) {\n    return;\n  }\n\n  getCore(client).logger.warn(\n    `MetaMask integration is incomplete: addMetaMaskSolanaExtension() is missing. Add it during setup:\n\nimport { addMetaMaskSolanaExtension } from '@dynamic-labs-sdk/solana/metamask';\nimport { createDynamicClient } from '@dynamic-labs-sdk/client';\n\nconst client = createDynamicClient({ environmentId: '...' });\n\naddMetaMaskSolanaExtension(client);`\n  );\n};\n","import { getDefaultClient } from '@dynamic-labs-sdk/client';\nimport type { WalletProviderUriConnectionResult } from '@dynamic-labs-sdk/client';\nimport { connectWithMetaMaskUri } from '@dynamic-labs-sdk/metamask';\n\nimport { registerSolanaNetworkProviderBuilder } from '../../registerSolanaNetworkProviderBuilder';\nimport { createMetaMaskSolanaWalletProvider } from '../createMetaMaskSolanaWalletProvider';\nimport { warnMetaMaskSolanaIntegrationIncomplete } from '../warnMetaMaskSolanaIntegrationIncomplete';\n\nexport type ConnectWithMetaMaskUriSolanaParams = {\n  /** Whether to add the connected wallet account to the Dynamic client. Defaults to `true`. */\n  addToDynamicWalletAccounts?: boolean;\n};\n\n/**\n * Drives a MetaMask SDK URI pairing for Solana and returns `{ approval, uri }`\n * so consumers can render the QR / hand the URI to a deeplink. The resulting\n * wallet provider registers for signing only and is never surfaced in the\n * wallet picker. When the MetaMask extension is announced via Wallet Standard,\n * prefer routing through `getMetaMaskSolanaExtensionWalletProviderKey` instead.\n *\n * @notInstrumented\n */\nexport const connectWithMetaMaskUriSolana = (\n  { addToDynamicWalletAccounts = true }: ConnectWithMetaMaskUriSolanaParams = {},\n  client = getDefaultClient()\n): Promise<WalletProviderUriConnectionResult> => {\n  warnMetaMaskSolanaIntegrationIncomplete(client);\n\n  registerSolanaNetworkProviderBuilder(client);\n\n  return connectWithMetaMaskUri(\n    {\n      addToDynamicWalletAccounts,\n      chain: 'SOL',\n      walletProviderBuilder: createMetaMaskSolanaWalletProvider,\n    },\n    client\n  );\n};\n","import {\n  type WalletAccount,\n  type WalletProviderUriConnectionResult,\n  getDefaultClient,\n  verifyWalletAccount,\n} from '@dynamic-labs-sdk/client';\n\nimport { connectWithMetaMaskUriSolana } from '../connectWithMetaMaskUriSolana';\n\n/**\n * Drives a MetaMask SDK URI pairing for Solana and verifies ownership of the\n * paired wallet account through message signing, returning `{ approval, uri }`\n * so consumers can render the QR / hand the URI to a deeplink.\n *\n * Builds on `connectWithMetaMaskUriSolana` (rather than the chain-agnostic\n * connector directly) so the Solana-specific wiring stays defined in one\n * place, then wraps its `approval` to add the verification round-trip. The\n * pairing is driven with `addToDynamicWalletAccounts: false` so the account\n * lands as a verified credential instead of an unverified entry.\n *\n * The MetaMask SDK does not expose a single-round-trip authenticate\n * primitive, so this drives two sequential interactions on the wallet side:\n * the user first approves the pairing, then approves a sign-in message.\n *\n * @notInstrumented\n */\nexport const connectAndVerifyWithMetaMaskUriSolana = async (\n  client = getDefaultClient()\n): Promise<WalletProviderUriConnectionResult> => {\n  const { approval, uri } = await connectWithMetaMaskUriSolana(\n    { addToDynamicWalletAccounts: false },\n    client\n  );\n\n  const verifiedApproval = async (): Promise<{\n    walletAccounts: WalletAccount[];\n  }> => {\n    const { walletAccounts } = await approval();\n\n    // MetaMask SDK exposes a single active address per pairing, mirroring how\n    // the underlying connect helper materializes a single account from\n    // `addresses[0]`. Verify it directly.\n    const [walletAccount] = walletAccounts;\n\n    if (walletAccount) {\n      await verifyWalletAccount({ walletAccount }, client);\n    }\n\n    return { walletAccounts };\n  };\n\n  return { approval: verifiedApproval, uri };\n};\n","import { getDefaultClient } from '@dynamic-labs-sdk/client';\nimport { getMetaMaskExtensionWalletProviderKey } from '@dynamic-labs-sdk/metamask';\n\n/**\n * Returns the wallet provider key of the MetaMask browser extension announced\n * for Solana via Wallet Standard, or `undefined` when none is announced. Pass\n * the returned key to `connectWithWalletProvider` to route through the\n * announced provider; fall back to `connectWithMetaMaskUriSolana` when\n * `undefined`.\n *\n * @notInstrumented\n */\nexport const getMetaMaskSolanaExtensionWalletProviderKey = (\n  client = getDefaultClient()\n): string | undefined =>\n  getMetaMaskExtensionWalletProviderKey({ chain: 'SOL' }, client);\n","import { getDefaultClient } from '@dynamic-labs-sdk/client';\nimport { getUriConnectionStarterRegistry } from '@dynamic-labs-sdk/client/core';\n\nimport { connectWithMetaMaskUriSolana } from '../connectWithMetaMaskUriSolana';\n\n/**\n * Registers the MetaMask SDK URI pairing for Solana with the client, so higher\n * level connection APIs can mint a MetaMask URI for Solana without depending on\n * this package.\n *\n * Call it during app setup to opt into the MetaMask URI path — it is kept out\n * of the Solana extension so apps that never pair with MetaMask over a URI\n * don't bundle the MetaMask SDK.\n *\n * @example\n * ```ts\n * registerMetaMaskSolanaUriConnectionStarter();\n * ```\n *\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns Nothing.\n * @see connectWithMetaMaskUriSolana\n * @see getUriConnectionStarterRegistry\n * @notInstrumented\n */\nexport const registerMetaMaskSolanaUriConnectionStarter = (\n  client = getDefaultClient()\n): void => {\n  getUriConnectionStarterRegistry(client).register({\n    chain: 'SOL',\n    start: ({ addToDynamicWalletAccounts }) =>\n      connectWithMetaMaskUriSolana({ addToDynamicWalletAccounts }, client),\n    type: 'metamaskSdkUri',\n  });\n};\n","import { assertPackageVersion } from '@dynamic-labs-sdk/assert-package-version';\n\nimport {\n  name as packageName,\n  version as packageVersion,\n} from '../../package.json';\nassertPackageVersion(packageName, packageVersion);\n\nexport { addMetaMaskSolanaExtension } from '../metamask/addMetaMaskSolanaExtension';\nexport { connectAndVerifyWithMetaMaskUriSolana } from '../metamask/connectAndVerifyWithMetaMaskUriSolana';\nexport { connectWithMetaMaskUriSolana } from '../metamask/connectWithMetaMaskUriSolana';\nexport type { ConnectWithMetaMaskUriSolanaParams } from '../metamask/connectWithMetaMaskUriSolana/connectWithMetaMaskUriSolana';\nexport { MetaMaskDirectConnectNotSupportedError } from '../errors/MetaMaskDirectConnectNotSupportedError';\nexport { getMetaMaskSolanaExtensionWalletProviderKey } from '../metamask/getMetaMaskSolanaExtensionWalletProviderKey';\nexport { registerMetaMaskSolanaUriConnectionStarter } from '../metamask/registerMetaMaskSolanaUriConnectionStarter';\nexport { MetaMaskDisplayUriMissingError } from '@dynamic-labs-sdk/metamask';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAWA,IAAa,yCAAb,cAA4DA,mCAAU;CACpE,cAAc;AACZ,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cACE;GACH,CAAC;;;;;;ACbN,MAAM,mCAAmC;;;;;;;;;;;;;;;;AAiBzC,MAAa,yGACa;CACtB,OAAO;CACP,aAAa;CACb,oBAAoBC,8CAAmB;CACxC,CAAC;;;;ACCJ,MAAM,wBAAwB;AAC9B,MAAM,gBAAgB,GAAGC,wDAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCnD,MAAa,sCACX,WACyB;CACzB,MAAM,8GACqC,OAAO;CAIlD,MAAM,wBACJ,8DAEW,CACR,KACC,YAAY,UAAU;EACpB,sBAAsB;EACtB,kBAAkB;EACnB,CAAC,CACH,CACA,SAAS,SAAS;CAGvB,MAAM,0BAEJ,EACA,mBACA,eAIO;EACP,MAAM,sDAAmB,CAAC,KAAK,mBAAmB,SAAS;AAE3D,SACEC,oDAAuB,SAAS,GAC5BC,qCAAqB,YAAY,MAAM,GACvCC,4BAAY,KAAK,MAAM;;CAI/B,MAAM,oBAAoB,uCAAuC;CAMjE,MAAM,gGAA2D;CAEjE,MAAM,iBAAiB,YAAyC;EAC9D,MAAM,EAAE,cAAc,iFAA8C;GAClE;GACA;GACD,CAAC;EAEF,MAAM,wDAA0B,OAAO,CAAC,MACrC,cACC,UAAU,UAAU,SAAS,UAAU,cAAc,UACxD;AAED,mDACE,SAAS,aACT,4EAA4E,UAAU,GACvF;AAED,SAAO,UAAU,QAAQ;;CAG3B,MAAMC,wBACJ,YAAY;EAUV,MAAM,EAAE,aAAa,sEACnB;GAAE,OAAO;GAAO,gBAThB,MAAM,8BAA8B,mBAAmB;GASvB;GAAmB,EACnD,OACD;AAED,SAAO,EACL,WAAW,SAAS,KAAK,wEAA6B,QAAQ,CAAC,QAAQ,EACxE;;CAGL,MAAMC,qBACJ,uFAC0C;EAAE;EAAQ;EAAmB,CAAC;CAQ1E,MAAMC,sBACJ,OAAO,EAAE,gBAAgB;AAIvB,4EACE;GAAE,OAAO;GAAO,gBAHhB,MAAM,8BAA8B,mBAAmB;GAGvB;GAAW,EAC3C,OACD;EAKD,MAAM,EAAE,WAAW,sBACjB,iFAA8C;GAC5C;GACA;GACD,CAAC;AAEJ,kFAA6C;GAC3C;GACA;GACA;GACD,CAAC;AAEF,MAAI,cAAc,kBAChB,gBAAe,mBAAmB,EAAE,WAAW,CAAC;;CAItD,MAAMC,cAAgE,OAAO,EAC3E,SACA,oBACI;AACJ,mDAAc,eAAe,6BAA6B;EAE1D,MAAM,QAAQ,MAAM,gBAAgB;AAcpC,SAAO,EAAE,YAXO,OAFO,MAAM,8BAA8B,mBAAmB,EAEzC,aAAa;GAChD,SAAS;IACP,QAAQ;IACR,QAAQ;KACN,SAAS,EAAE,SAAS,cAAc,SAAS;KAC3C,uDAAoB,CAAC,KAAK,SAAS,QAAQ,CAAC,SAAS,SAAS;KAC/D;IACF;GACD;GACD,CAAC,EAEyB,WAAW;;CAGxC,MAAMC,kBAA2D,OAAO,EACtE,aACA,oBACI;EACJ,MAAM,QAAQ,MAAM,gBAAgB;AAepC,SAAO,EACL,mBAAmB,uBAAuB;GACxC,oBAdY,OAFO,MAAM,8BAA8B,mBAAmB,EAEzC,aAAa;IAChD,SAAS;KACP,QAAQ;KACR,QAAQ;MACN,SAAS,EAAE,SAAS,cAAc,SAAS;MAC3C;MACA,aAAa,qBAAqB,YAAY;MAC/C;KACF;IACD;IACD,CAAC,EAI4B;GAC1B,UAAU;GACX,CAAC,EACH;;CAGH,MAAMC,sBACJ,OAAqD,EACnD,cACA,oBAII;EACJ,MAAMC,qBAA0B,EAAE;AAIlC,OAAK,MAAM,eAAe,cAAc;GACtC,MAAM,EAAE,sBAAsB,MAAM,gBAAgB;IAClD;IACA;IACD,CAAC;AACF,sBAAmB,KAAK,kBAAuB;;AAGjD,SAAO,EAAE,oBAAoB;;CAGjC,MAAMC,yBACJ,OAAO,EAAE,aAAa,oBAAoB;EACxC,MAAM,QAAQ,MAAM,gBAAgB;AAgBpC,SAAO,EAAE,YAZO,OAFd,MAAM,8BAA8B,mBAAmB,EAEpB,aAAa;GAChD,SAAS;IACP,QAAQ;IACR,QAAQ;KACN,SAAS,EAAE,SAAS,cAAc,SAAS;KAC3C;KACA,aAAa,qBAAqB,YAAY;KAC/C;IACF;GACD;GACD,CAAC,EAEyB,WAAW;;CAM1C,MAAMC,0BACJ,YAAY;AACV,8EACE;GAAE,OAAO;GAAO;GAAmB,EACnC,OACD;AACD,iBAAe,kBAAkB;;CAKrC,MAAMC,UAA2C,YAAY;AAC3D,iBAAe,qBAAqB;;AAGtC,QAAO;EACL,OAAO;EACP,qBAAqB,SAASC,sDAAyB,MAAM,OAAO;EACpE,SAAS,YAAY;AACnB,SAAM,IAAI,wCAAwC;;EAEpD;EACA;EACA,IAAI,SAAS;AACX,UAAO,eAAe,iBAAiB;;EAEzC,yBAAyB,SACvBC,0DAA6B,MAAM,OAAO;EAC5C;EACA;EACA,0EAAuC,sBAAsB;EAC7D,KAAK;EACL,UAAU;GACR,aAAa;GACb,MAAM;GACP;EACD;EACA;EACA;EACA;EACA;EACA,iBAAiB,SAASC,kDAAqB,MAAM,OAAO;EAC5D,oBAAoBC,8CAAmB;EACxC;;;;;AChUH,MAAa,gCAAgC;;;;;;;;;;;;;;;;;;;;AAqB7C,MAAa,8BACX,8DAA0C,KACjC;AACT,qDAAiB,EAAE,cAAc,+BAA+B,EAAE,OAAO,CACvE;AAGF,mEAAqC,OAAO;AAC5C,sDAAkB,EAAE,cAAc,+BAA+B,EAAE,OAAO;AAE1E,sEACE;EACE,uBAAuB;EACvB,mBAAmB,uCAAuC;EAC3D,EACD,OACD;;;;;;;;;;;;;;;;;;;;AC7BH,MAAa,2CACX,WACS;AACT,qDAAiB,EAAE,cAAc,+BAA+B,EAAE,OAAO,CACvE;AAGF,4CAAQ,OAAO,CAAC,OAAO,KACrB;;;;;;;qCAQD;;;;;;;;;;;;;;ACdH,MAAa,gCACX,EAAE,6BAA6B,SAA6C,EAAE,EAC9E,yDAA2B,KACoB;AAC/C,yCAAwC,OAAO;AAE/C,mEAAqC,OAAO;AAE5C,+DACE;EACE;EACA,OAAO;EACP,uBAAuB;EACxB,EACD,OACD;;;;;;;;;;;;;;;;;;;;;;ACXH,MAAa,wCAAwC,OACnD,yDAA2B,KACoB;CAC/C,MAAM,EAAE,UAAU,QAAQ,MAAM,6BAC9B,EAAE,4BAA4B,OAAO,EACrC,OACD;CAED,MAAM,mBAAmB,YAEnB;EACJ,MAAM,EAAE,mBAAmB,MAAM,UAAU;EAK3C,MAAM,CAAC,iBAAiB;AAExB,MAAI,cACF,yDAA0B,EAAE,eAAe,EAAE,OAAO;AAGtD,SAAO,EAAE,gBAAgB;;AAG3B,QAAO;EAAE,UAAU;EAAkB;EAAK;;;;;;;;;;;;;;ACvC5C,MAAa,+CACX,yDAA2B,2EAEW,EAAE,OAAO,OAAO,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;ACUjE,MAAa,8CACX,yDAA2B,KAClB;AACT,oEAAgC,OAAO,CAAC,SAAS;EAC/C,OAAO;EACP,QAAQ,EAAE,iCACR,6BAA6B,EAAE,4BAA4B,EAAE,OAAO;EACtE,MAAM;EACP,CAAC;;;;;mEC3BiBC,mCAAaC,qCAAe"}

package/dist/metamask.esm.js

@@ -1,180 +1,300 @@
-import { d as registerSolanaNetworkProviderBuilder, f as name, p as version } from "./solanaTransferAmount-BmcJvD2x.esm.js";
-import { n as getFeaturesForSolanaStandardWallet, t as createWalletProviderFromSolanaStandardWallet } from "./createWalletProviderFromSolanaStandardWallet-CpSgF7IN.esm.js";
+import { d as registerSolanaNetworkProviderBuilder, f as name, l as isVersionedTransaction, n as solanaExecuteSwapTransaction, p as version, s as solanaConfirmTransaction, t as solanaTransferAmount } from "./solanaTransferAmount-C-2Ct-ry.esm.js";
 import { assertPackageVersion } from "@dynamic-labs-sdk/assert-package-version";
-import { assertNonEmptyArray, createRuntimeServiceAccessKey, getAppMetadata, getCore, getNativeLinkScheme } from "@dynamic-labs-sdk/client/core";
-import { getDefaultClient as getDefaultClient$1, getNetworksData, verifyWalletAccount } from "@dynamic-labs-sdk/client";
+import { DYNAMIC_ICONIC_SPRITE_URL, assertDefined, formatWalletProviderGroupKey, formatWalletProviderKey, getActiveNetworkIdFromLastKnownRegistry, getBuffer, getCore, getDefaultClient, getUriConnectionStarterRegistry, hasExtension, registerExtension, switchActiveNetworkInLastKnownRegistry } from "@dynamic-labs-sdk/client/core";
+import { BaseError, getDefaultClient as getDefaultClient$1, getNetworksData, verifyWalletAccount } from "@dynamic-labs-sdk/client";
+import { Transaction, VersionedTransaction } from "@solana/web3.js";
 import { WalletProviderEnum } from "@dynamic-labs/sdk-api-core";
-import { MetaMaskDisplayUriMissingError, MetaMaskWalletNotConnectedError, clearMetaMaskSessionStorage, connectWithMetaMaskUri, getMetaMaskExtensionWalletProviderKey } from "@dynamic-labs-sdk/metamask";
-import { createSolanaClient } from "@metamask/connect-solana";
+import { assertMetaMaskNetworkIsGranted, createMetaMaskWalletProviderEventEmitter, disconnectMetaMaskWalletProvider, getOrCreateMetaMaskClientInstanceManager, reconcileMetaMaskWalletProvider, resolveActiveMetaMaskScope } from "@dynamic-labs-sdk/metamask/core";
+import { splitCaip10Token } from "@dynamic-labs-sdk/wallet-connect/core";
+import { MetaMaskDisplayUriMissingError, connectWithMetaMaskUri, getMetaMaskExtensionWalletProviderKey } from "@dynamic-labs-sdk/metamask";
 
-//#region src/metamask/utils/getSolanaNetworkFromCluster/getSolanaNetworkFromCluster.ts
+//#region src/errors/MetaMaskDirectConnectNotSupportedError/MetaMaskDirectConnectNotSupportedError.ts
 /**
-* Maps a Dynamic network `cluster` (e.g. `mainnet-beta`, `devnet`,
-* `testnet`) to the `mainnet | devnet | testnet` key shape expected by
-* `@metamask/connect-solana`'s `createSolanaClient`. Returns `undefined` for
-* clusters that do not correspond to one of MetaMask's supported Solana
-* networks so callers can skip them. Used by `getSupportedNetworks` to build
-* the SDK's `supportedNetworks` map.
-*
-* @notInstrumented
+* Thrown when `connect()` is called directly on the MetaMask SDK placeholder
+* wallet provider (the entry `addMetaMaskSolanaExtension` registers so
+* MetaMask still shows up in the wallet picker when no browser extension is
+* installed). That placeholder has no generic connect flow of its own --
+* connecting requires the QR / deeplink pairing flow, so callers must drive
+* `connectWithMetaMaskUriSolana` (or `connectAndVerifyWithMetaMaskUriSolana`)
+* instead of the picker's default connect.
 */
-const getSolanaNetworkFromCluster = ({ cluster }) => {
-	if (cluster === void 0) return;
-	if (cluster.includes("mainnet")) return "mainnet";
-	if (cluster.includes("devnet")) return "devnet";
-	if (cluster.includes("testnet")) return "testnet";
+var MetaMaskDirectConnectNotSupportedError = class extends BaseError {
+	constructor() {
+		super({
+			cause: null,
+			code: "metamask_direct_connect_not_supported",
+			docsUrl: null,
+			name: "MetaMaskDirectConnectNotSupportedError",
+			shortMessage: "MetaMask cannot be connected directly; call connectWithMetaMaskUriSolana (or connectAndVerifyWithMetaMaskUriSolana) to get a QR/URI pairing flow instead"
+		});
+	}
 };
 
 //#endregion
-//#region src/metamask/utils/getSupportedNetworks/getSupportedNetworks.ts
+//#region src/metamask/getMetaMaskSolanaSdkWalletProviderKey/getMetaMaskSolanaSdkWalletProviderKey.ts
+const METAMASK_SOLANA_SDK_DISPLAY_NAME = "MetaMask";
 /**
-* Builds the `supportedNetworks` map required by
-* `@metamask/connect-solana`'s `createSolanaClient`, keyed by the SDK's
-* `mainnet | devnet | testnet` network names and valued with the first
-* configured RPC URL for each. Sources the configured SOL networks from the
-* Dynamic client's project settings. Throws when no SOL network is
-* configured, mirroring the EVM `getSupportedNetworks` contract.
+* Deterministic wallet provider key for the MetaMask SDK's connect-less
+* Solana placeholder. Computed without building the wallet provider itself,
+* so `addMetaMaskSolanaExtension` can check for a matching wallet account
+* before paying the cost of `createMetaMaskSolanaWalletProvider`.
 *
+* @example
+* ```ts
+* const key = getMetaMaskSolanaSdkWalletProviderKey();
+* ```
+* @returns The deterministic wallet provider key.
+* @see createMetaMaskSolanaWalletProvider
+* @see reconcileMetaMaskWalletProvider
 * @notInstrumented
 */
-const getSupportedNetworks = (client) => {
-	const solanaNetworks = getNetworksData(client).filter((network) => network.chain === "SOL");
-	assertNonEmptyArray(solanaNetworks, "No SOL networks have been configured. Make sure to add at least one Solana network to your project settings in the Dynamic Dashboard.");
-	const supportedNetworks = {};
-	for (const network of solanaNetworks) {
-		const solanaNetwork = getSolanaNetworkFromCluster({ cluster: network.cluster });
-		if (solanaNetwork !== void 0 && supportedNetworks[solanaNetwork] === void 0) supportedNetworks[solanaNetwork] = network.rpcUrls.http[0];
-	}
-	return supportedNetworks;
-};
+const getMetaMaskSolanaSdkWalletProviderKey = () => formatWalletProviderKey({
+	chain: "SOL",
+	displayName: METAMASK_SOLANA_SDK_DISPLAY_NAME,
+	walletProviderType: WalletProviderEnum.QrCode
+});
 
 //#endregion
-//#region src/metamask/utils/createMetaMaskSolanaController/createMetaMaskSolanaController.ts
+//#region src/metamask/createMetaMaskSolanaWalletProvider/createMetaMaskSolanaWalletProvider.ts
+const METAMASK_DISPLAY_NAME = "MetaMask";
+const METAMASK_ICON = `${DYNAMIC_ICONIC_SPRITE_URL}#metamask`;
 /**
-* Builds a fully-initialised `MetaMaskSolanaController` for the given Dynamic
-* client. Drives the `@metamask/connect-solana` SDK through its Wallet
-* Standard surface so consumers render their own QR / deep-link UI, and
-* subscribes to the SDK core's `display_uri` event at construction time so
-* the first URI emission cannot be lost to a subscription race. The wallet
-* is created with `skipAutoRegister` so this URI-pairing client does not
-* register itself into the global Wallet Standard registry — an announced
-* MetaMask extension is discovered independently. Dapp metadata is sourced
-* from the client's `getAppMetadata`. Browser-only.
-* The MetaMask SDK's own verbose logging is tied to the Dynamic client's log
-* level, so turning on `debug` logging for the Dynamic SDK also surfaces
-* MetaMask's internal SDK trace output.
+* Builds the `SolanaWalletProvider` registered AFTER a successful MetaMask
+* SDK URI pairing. Unlike the EVM facade, MetaMask does not expose a typed
+* RPC surface for Solana, so this drives `invokeMethod` directly against the
+* documented `signMessage` / `signTransaction` / `signAndSendTransaction`
+* methods (see https://docs.metamask.io/metamask-connect/multichain/guides/sign-transactions/
+* and .../send-transactions/), scoped to `solana:<genesisHash>` per CAIP-2 —
+* MetaMask's multichain session grants every configured network as its own
+* scope up front, so "the active network" is tracked in Dynamic's own
+* last-known-network registry rather than asked of the SDK. Drops `connect`
+* so the provider is filtered out of the wallet picker by
+* `getAvailableWalletProvidersData` — mirroring how WalletConnect URI
+* sessions register a signing-only provider.
+*
+* MetaMask's multichain API does not document a batch-signing method for
+* Solana, so `signAllTransactions` signs each transaction with its own
+* `signTransaction` call (sequential wallet prompts) rather than one batch
+* approval.
+*
+* `getConnectedAddresses` and `switchActiveNetwork` route through
+* `resolveActiveMetaMaskScope`/`assertMetaMaskNetworkIsGranted` rather than
+* the registry directly, since every configured network is requested as an
+* *optional* scope -- MetaMask may grant an account for only a subset (see
+* their JSDoc).
+*
+* `switchActiveNetwork`/`disconnectWalletAccount` are local, Dynamic-side
+* actions with no live wallet event to bridge, so they emit `networkChanged`/
+* `disconnected` themselves via `metaMaskEvents` -- otherwise `events` would
+* never fire for MetaMask at all.
 *
 * @notInstrumented
 */
-const createMetaMaskSolanaController = async (client) => {
-	const supportedNetworks = getSupportedNetworks(client);
-	const { appName, appLogoUrl, appUniversalLink, appNativeLink } = getAppMetadata(client);
-	const { logger } = getCore(client);
-	await clearMetaMaskSessionStorage(client);
-	const listeners = /* @__PURE__ */ new Set();
-	let latestDisplayUri;
-	const sdk = await createSolanaClient({
-		api: { supportedNetworks },
-		dapp: {
-			iconUrl: appLogoUrl,
-			name: appName,
-			nativeScheme: getNativeLinkScheme({ nativeLink: appNativeLink }),
-			url: appUniversalLink ?? ""
-		},
-		debug: logger.isEnabled("debug"),
-		skipAutoRegister: true
-	});
-	sdk.core.on("display_uri", (uri) => {
-		latestDisplayUri = uri;
-		for (const listener of listeners) listener(uri);
-	});
-	sdk.core.on("stateChanged", (status) => {
-		if (status === "connected" || status === "disconnected") latestDisplayUri = void 0;
+const createMetaMaskSolanaWalletProvider = (client) => {
+	const metaMaskClientInstanceManager = getOrCreateMetaMaskClientInstanceManager(client);
+	const serializeTransaction = (transaction) => getBuffer().from(transaction.serialize({
+		requireAllSignatures: false,
+		verifySignatures: false
+	})).toString("base64");
+	const deserializeTransaction = ({ base64Transaction, original }) => {
+		const bytes = getBuffer().from(base64Transaction, "base64");
+		return isVersionedTransaction(original) ? VersionedTransaction.deserialize(bytes) : Transaction.from(bytes);
+	};
+	const walletProviderKey = getMetaMaskSolanaSdkWalletProviderKey();
+	const metaMaskEvents = createMetaMaskWalletProviderEventEmitter();
+	const getActiveScope = async () => {
+		const { networkId } = await getActiveNetworkIdFromLastKnownRegistry({
+			client,
+			walletProviderKey
+		});
+		const network = getNetworksData(client).find((candidate) => candidate.chain === "SOL" && candidate.networkId === networkId);
+		assertDefined(network?.genesisHash, `No configured SOL network with a genesis hash matches active network id "${networkId}"`);
+		return `solana:${network.genesisHash}`;
+	};
+	const getConnectedAddresses = async () => {
+		const { accounts } = await resolveActiveMetaMaskScope({
+			chain: "SOL",
+			metaMaskClient: await metaMaskClientInstanceManager.getMetaMaskClient(),
+			walletProviderKey
+		}, client);
+		return { addresses: accounts.map((account) => splitCaip10Token(account).address) };
+	};
+	const getActiveNetworkId = async () => getActiveNetworkIdFromLastKnownRegistry({
+		client,
+		walletProviderKey
 	});
-	latestDisplayUri = void 0;
-	const onDisplayUri = (listener) => {
-		listeners.add(listener);
-		if (latestDisplayUri !== void 0) listener(latestDisplayUri);
-		return () => {
-			listeners.delete(listener);
-		};
+	const switchActiveNetwork = async ({ networkId }) => {
+		await assertMetaMaskNetworkIsGranted({
+			chain: "SOL",
+			metaMaskClient: await metaMaskClientInstanceManager.getMetaMaskClient(),
+			networkId
+		}, client);
+		const { networkId: previousNetworkId } = await getActiveNetworkIdFromLastKnownRegistry({
+			client,
+			walletProviderKey
+		});
+		await switchActiveNetworkInLastKnownRegistry({
+			client,
+			networkId,
+			walletProviderKey
+		});
+		if (networkId !== previousNetworkId) metaMaskEvents.emitNetworkChanged({ networkId });
 	};
-	let inFlightConnect = null;
-	const connect = () => {
-		if (inFlightConnect) return inFlightConnect;
-		inFlightConnect = (async () => {
-			try {
-				if (sdk.core.status === "connecting") try {
-					await sdk.disconnect();
-				} catch (error) {
-					getCore(client).logger.debug("[metamask] pre-connect disconnect rejected (expected when aborting a pairing the wallet never accepted)", error);
+	const signMessage = async ({ message, walletAccount }) => {
+		assertDefined(walletAccount, "Wallet account is required");
+		const scope = await getActiveScope();
+		return { signature: (await (await metaMaskClientInstanceManager.getMetaMaskClient()).invokeMethod({
+			request: {
+				method: "signMessage",
+				params: {
+					account: { address: walletAccount.address },
+					message: getBuffer().from(message, "utf-8").toString("base64")
 				}
-				await getFeaturesForSolanaStandardWallet(sdk.getWallet())["standard:connect"].connect();
-			} finally {
-				inFlightConnect = null;
-			}
-		})();
-		return inFlightConnect;
+			},
+			scope
+		})).signature };
+	};
+	const signTransaction = async ({ transaction, walletAccount }) => {
+		const scope = await getActiveScope();
+		return { signedTransaction: deserializeTransaction({
+			base64Transaction: (await (await metaMaskClientInstanceManager.getMetaMaskClient()).invokeMethod({
+				request: {
+					method: "signTransaction",
+					params: {
+						account: { address: walletAccount.address },
+						scope,
+						transaction: serializeTransaction(transaction)
+					}
+				},
+				scope
+			})).signedTransaction,
+			original: transaction
+		}) };
+	};
+	const signAllTransactions = async ({ transactions, walletAccount }) => {
+		const signedTransactions = [];
+		for (const transaction of transactions) {
+			const { signedTransaction } = await signTransaction({
+				transaction,
+				walletAccount
+			});
+			signedTransactions.push(signedTransaction);
+		}
+		return { signedTransactions };
+	};
+	const signAndSendTransaction = async ({ transaction, walletAccount }) => {
+		const scope = await getActiveScope();
+		return { signature: (await (await metaMaskClientInstanceManager.getMetaMaskClient()).invokeMethod({
+			request: {
+				method: "signAndSendTransaction",
+				params: {
+					account: { address: walletAccount.address },
+					scope,
+					transaction: serializeTransaction(transaction)
+				}
+			},
+			scope
+		})).signature };
+	};
+	const disconnectWalletAccount = async () => {
+		await disconnectMetaMaskWalletProvider({
+			chain: "SOL",
+			walletProviderKey
+		}, client);
+		metaMaskEvents.emitDisconnected();
+	};
+	const destroy = async () => {
+		metaMaskEvents.cleanupEventEmitter();
 	};
 	return {
-		clearCachedDisplayUri: () => {
-			latestDisplayUri = void 0;
+		chain: "SOL",
+		confirmTransaction: (args) => solanaConfirmTransaction(args, client),
+		connect: async () => {
+			throw new MetaMaskDirectConnectNotSupportedError();
+		},
+		destroy,
+		disconnectWalletAccount,
+		get events() {
+			return metaMaskEvents.getEventEmitter();
 		},
-		connect,
-		getLatestDisplayUri: () => latestDisplayUri,
-		onDisplayUri,
-		sdk
+		executeSwapTransaction: (args) => solanaExecuteSwapTransaction(args, client),
+		getActiveNetworkId,
+		getConnectedAddresses,
+		groupKey: formatWalletProviderGroupKey(METAMASK_DISPLAY_NAME),
+		key: walletProviderKey,
+		metadata: {
+			displayName: METAMASK_DISPLAY_NAME,
+			icon: METAMASK_ICON
+		},
+		signAllTransactions,
+		signAndSendTransaction,
+		signMessage,
+		signTransaction,
+		switchActiveNetwork,
+		transferAmount: (args) => solanaTransferAmount(args, client),
+		walletProviderType: WalletProviderEnum.QrCode
 	};
 };
 
 //#endregion
-//#region src/metamask/utils/getOrCreateMetaMaskSolanaController/getOrCreateMetaMaskSolanaController.ts
-const RUNTIME_SERVICE_KEY = "metaMaskSolanaController";
+//#region src/metamask/addMetaMaskSolanaExtension/addMetaMaskSolanaExtension.ts
+const METAMASK_SOLANA_EXTENSION_KEY = "metaMaskSolana";
 /**
-* Per-`DynamicClient` accessor for the lazily-constructed MetaMask Solana
-* controller. Wraps `createMetaMaskSolanaController` with the standard
-* `runtimeServices` cache so every caller — the Wallet Standard
-* wallet-provider builder, the `display_uri` subscription helper, and the
-* `connectWithMetaMaskUriSolana` URI-returning helper — shares the same
-* controller (and therefore the same SDK instance, display-URI cache, and
-* listener registry) per Dynamic client.
-*
-* The cache is **per-Dynamic-client, not per-SDK-instance**:
-* `@metamask/connect-solana`'s `createSolanaClient` builds on the shared
-* MultichainCore singleton, so when multiple Dynamic clients coexist they
-* end up sharing the same MetaMask session regardless of this cache. The
-* wrapper exists to own the controller's `display_uri` cache and listener
-* registry per Dynamic client, which the SDK itself does not expose.
+* Integrates MetaMask Connect (MetaMask's multichain SDK) with the Dynamic
+* client for Solana, letting users connect MetaMask on platforms where the
+* browser extension isn't available — e.g. scanning a QR code, or opening
+* the MetaMask mobile app from a website or React Native app. Call this
+* once during setup.
+*
+* @example
+* ```ts
+* const client = createDynamicClient({ environmentId: '...' });
 *
+* addMetaMaskSolanaExtension(client);
+* ```
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns void
+* @see connectWithMetaMaskUriSolana
+* @see addSolanaWalletStandardExtension
 * @notInstrumented
 */
-const getOrCreateMetaMaskSolanaController = createRuntimeServiceAccessKey(RUNTIME_SERVICE_KEY, (client) => createMetaMaskSolanaController(client));
+const addMetaMaskSolanaExtension = (client = getDefaultClient()) => {
+	if (hasExtension({ extensionKey: METAMASK_SOLANA_EXTENSION_KEY }, client)) return;
+	registerSolanaNetworkProviderBuilder(client);
+	registerExtension({ extensionKey: METAMASK_SOLANA_EXTENSION_KEY }, client);
+	reconcileMetaMaskWalletProvider({
+		walletProviderBuilder: createMetaMaskSolanaWalletProvider,
+		walletProviderKey: getMetaMaskSolanaSdkWalletProviderKey()
+	}, client);
+};
 
 //#endregion
-//#region src/metamask/createMetaMaskSolanaWalletProvider/createMetaMaskSolanaWalletProvider.ts
+//#region src/metamask/warnMetaMaskSolanaIntegrationIncomplete/warnMetaMaskSolanaIntegrationIncomplete.ts
 /**
-* Builds the `SolanaWalletProvider` registered AFTER a successful MetaMask
-* SDK URI pairing. Wraps the paired Wallet Standard wallet exposed by
-* `@metamask/connect-solana` behind the Dynamic Solana provider facade and
-* classifies it as `QrCode` so its key does not collide with an announced
-* MetaMask browser-extension provider for the same wallet name. Drops
-* `connect` so the provider is filtered out of the wallet picker by
-* `getAvailableWalletProvidersData` — mirroring how WalletConnect URI
-* sessions register a signing-only provider.
+* Warns when `addMetaMaskSolanaExtension()` hasn't been added, since a
+* wallet connected via `connectWithMetaMaskUriSolana` without it won't be
+* restored after a page reload.
 *
+* @example
+* ```ts
+* warnMetaMaskSolanaIntegrationIncomplete(client);
+* ```
+* @param client - The Dynamic client instance.
+* @returns void
+* @see connectWithMetaMaskUriSolana
+* @see addMetaMaskSolanaExtension
 * @notInstrumented
 */
-const createMetaMaskSolanaWalletProvider = async (client) => {
-	const walletStandardWallet = (await getOrCreateMetaMaskSolanaController(client)).sdk.getWallet();
-	if (walletStandardWallet.accounts.length === 0) throw new MetaMaskWalletNotConnectedError();
-	return {
-		...createWalletProviderFromSolanaStandardWallet({
-			dynamicClient: client,
-			walletProviderType: WalletProviderEnum.QrCode,
-			walletStandardWallet
-		}),
-		connect: void 0
-	};
+const warnMetaMaskSolanaIntegrationIncomplete = (client) => {
+	if (hasExtension({ extensionKey: METAMASK_SOLANA_EXTENSION_KEY }, client)) return;
+	getCore(client).logger.warn(`MetaMask integration is incomplete: addMetaMaskSolanaExtension() is missing. Add it during setup:
+
+import { addMetaMaskSolanaExtension } from '@dynamic-labs-sdk/solana/metamask';
+import { createDynamicClient } from '@dynamic-labs-sdk/client';
+
+const client = createDynamicClient({ environmentId: '...' });
+
+addMetaMaskSolanaExtension(client);`);
 };
 
 //#endregion
@@ -189,11 +309,11 @@ const createMetaMaskSolanaWalletProvider = async (client) => {
 * @notInstrumented
 */
 const connectWithMetaMaskUriSolana = ({ addToDynamicWalletAccounts = true } = {}, client = getDefaultClient$1()) => {
+	warnMetaMaskSolanaIntegrationIncomplete(client);
 	registerSolanaNetworkProviderBuilder(client);
 	return connectWithMetaMaskUri({
 		addToDynamicWalletAccounts,
 		chain: "SOL",
-		getController: getOrCreateMetaMaskSolanaController,
 		walletProviderBuilder: createMetaMaskSolanaWalletProvider
 	}, client);
 };
@@ -244,10 +364,40 @@ const connectAndVerifyWithMetaMaskUriSolana = async (client = getDefaultClient$1
 */
 const getMetaMaskSolanaExtensionWalletProviderKey = (client = getDefaultClient$1()) => getMetaMaskExtensionWalletProviderKey({ chain: "SOL" }, client);
 
+//#endregion
+//#region src/metamask/registerMetaMaskSolanaUriConnectionStarter/registerMetaMaskSolanaUriConnectionStarter.ts
+/**
+* Registers the MetaMask SDK URI pairing for Solana with the client, so higher
+* level connection APIs can mint a MetaMask URI for Solana without depending on
+* this package.
+*
+* Call it during app setup to opt into the MetaMask URI path — it is kept out
+* of the Solana extension so apps that never pair with MetaMask over a URI
+* don't bundle the MetaMask SDK.
+*
+* @example
+* ```ts
+* registerMetaMaskSolanaUriConnectionStarter();
+* ```
+*
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns Nothing.
+* @see connectWithMetaMaskUriSolana
+* @see getUriConnectionStarterRegistry
+* @notInstrumented
+*/
+const registerMetaMaskSolanaUriConnectionStarter = (client = getDefaultClient$1()) => {
+	getUriConnectionStarterRegistry(client).register({
+		chain: "SOL",
+		start: ({ addToDynamicWalletAccounts }) => connectWithMetaMaskUriSolana({ addToDynamicWalletAccounts }, client),
+		type: "metamaskSdkUri"
+	});
+};
+
 //#endregion
 //#region src/exports/metamask.ts
 assertPackageVersion(name, version);
 
 //#endregion
-export { MetaMaskDisplayUriMissingError, connectAndVerifyWithMetaMaskUriSolana, connectWithMetaMaskUriSolana, getMetaMaskSolanaExtensionWalletProviderKey };
+export { MetaMaskDirectConnectNotSupportedError, MetaMaskDisplayUriMissingError, addMetaMaskSolanaExtension, connectAndVerifyWithMetaMaskUriSolana, connectWithMetaMaskUriSolana, getMetaMaskSolanaExtensionWalletProviderKey, registerMetaMaskSolanaUriConnectionStarter };
 //# sourceMappingURL=metamask.esm.js.map