@dynamic-labs-sdk/solana 1.31.0 → 1.31.2

package/dist/metamask/createMetaMaskSolanaWalletProvider/createMetaMaskSolanaWalletProvider.d.ts

@@ -2,15 +2,35 @@ import type { DynamicClient } from '@dynamic-labs-sdk/client';
 import type { SolanaWalletProvider } from '../../SolanaWalletProvider.types';
 /**
  * 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
+ * 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
  */
-export declare const createMetaMaskSolanaWalletProvider: (client: DynamicClient) => Promise<SolanaWalletProvider>;
+export declare const createMetaMaskSolanaWalletProvider: (client: DynamicClient) => SolanaWalletProvider;
 //# sourceMappingURL=createMetaMaskSolanaWalletProvider.d.ts.map

package/dist/metamask/createMetaMaskSolanaWalletProvider/createMetaMaskSolanaWalletProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createMetaMaskSolanaWalletProvider.d.ts","sourceRoot":"","sources":["../../../src/metamask/createMetaMaskSolanaWalletProvider/createMetaMaskSolanaWalletProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAI9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAI7E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kCAAkC,WACrC,aAAa,KACpB,OAAO,CAAC,oBAAoB,CAsB9B,CAAC"}
+{"version":3,"file":"createMetaMaskSolanaWalletProvider.d.ts","sourceRoot":"","sources":["../../../src/metamask/createMetaMaskSolanaWalletProvider/createMetaMaskSolanaWalletProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAuB9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAU7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,kCAAkC,WACrC,aAAa,KACpB,oBA0QF,CAAC"}

package/dist/metamask/getMetaMaskSolanaSdkWalletProviderKey/getMetaMaskSolanaSdkWalletProviderKey.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 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
+ */
+export declare const getMetaMaskSolanaSdkWalletProviderKey: () => string;
+//# sourceMappingURL=getMetaMaskSolanaSdkWalletProviderKey.d.ts.map

package/dist/metamask/getMetaMaskSolanaSdkWalletProviderKey/getMetaMaskSolanaSdkWalletProviderKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMetaMaskSolanaSdkWalletProviderKey.d.ts","sourceRoot":"","sources":["../../../src/metamask/getMetaMaskSolanaSdkWalletProviderKey/getMetaMaskSolanaSdkWalletProviderKey.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qCAAqC,QAAO,MAKrD,CAAC"}

package/dist/metamask/getMetaMaskSolanaSdkWalletProviderKey/index.d.ts

@@ -0,0 +1,2 @@
+export { getMetaMaskSolanaSdkWalletProviderKey } from './getMetaMaskSolanaSdkWalletProviderKey';
+//# sourceMappingURL=index.d.ts.map

package/dist/metamask/getMetaMaskSolanaSdkWalletProviderKey/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/metamask/getMetaMaskSolanaSdkWalletProviderKey/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAC"}

package/dist/metamask/registerMetaMaskSolanaUriConnectionStarter/index.d.ts

@@ -0,0 +1,2 @@
+export { registerMetaMaskSolanaUriConnectionStarter } from './registerMetaMaskSolanaUriConnectionStarter';
+//# sourceMappingURL=index.d.ts.map

package/dist/metamask/registerMetaMaskSolanaUriConnectionStarter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/metamask/registerMetaMaskSolanaUriConnectionStarter/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0CAA0C,EAAE,MAAM,8CAA8C,CAAC"}

package/dist/metamask/registerMetaMaskSolanaUriConnectionStarter/registerMetaMaskSolanaUriConnectionStarter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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
+ */
+export declare const registerMetaMaskSolanaUriConnectionStarter: (client?: import("@dynamic-labs-sdk/client").DynamicClient) => void;
+//# sourceMappingURL=registerMetaMaskSolanaUriConnectionStarter.d.ts.map

package/dist/metamask/registerMetaMaskSolanaUriConnectionStarter/registerMetaMaskSolanaUriConnectionStarter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerMetaMaskSolanaUriConnectionStarter.d.ts","sourceRoot":"","sources":["../../../src/metamask/registerMetaMaskSolanaUriConnectionStarter/registerMetaMaskSolanaUriConnectionStarter.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,0CAA0C,iEAEpD,IAOF,CAAC"}

package/dist/metamask/warnMetaMaskSolanaIntegrationIncomplete/index.d.ts

@@ -0,0 +1,2 @@
+export { warnMetaMaskSolanaIntegrationIncomplete } from './warnMetaMaskSolanaIntegrationIncomplete';
+//# sourceMappingURL=index.d.ts.map

package/dist/metamask/warnMetaMaskSolanaIntegrationIncomplete/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/metamask/warnMetaMaskSolanaIntegrationIncomplete/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uCAAuC,EAAE,MAAM,2CAA2C,CAAC"}

package/dist/metamask/warnMetaMaskSolanaIntegrationIncomplete/warnMetaMaskSolanaIntegrationIncomplete.d.ts

@@ -0,0 +1,18 @@
+import type { DynamicClient } from '@dynamic-labs-sdk/client';
+/**
+ * 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
+ */
+export declare const warnMetaMaskSolanaIntegrationIncomplete: (client: DynamicClient) => void;
+//# sourceMappingURL=warnMetaMaskSolanaIntegrationIncomplete.d.ts.map

package/dist/metamask/warnMetaMaskSolanaIntegrationIncomplete/warnMetaMaskSolanaIntegrationIncomplete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warnMetaMaskSolanaIntegrationIncomplete.d.ts","sourceRoot":"","sources":["../../../src/metamask/warnMetaMaskSolanaIntegrationIncomplete/warnMetaMaskSolanaIntegrationIncomplete.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAK9D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,uCAAuC,WAC1C,aAAa,KACpB,IAeF,CAAC"}