@dynamic-labs-sdk/solana 0.12.1 → 0.14.0

package/dist/phantomRedirect/completePhantomRedirect/completePhantomRedirect.d.ts

@@ -0,0 +1,32 @@
+import type { DynamicClient } from '@dynamic-labs-sdk/client';
+export type CompletePhantomRedirectParams = {
+    url: URL;
+};
+/**
+ * Completes the Phantom wallet redirect flow after the deep link callback.
+ *
+ * This function is called on the page that Phantom redirects back to after the
+ * user approves or rejects a wallet operation. It processes the redirect URL,
+ * decrypts the response, updates session storage, and emits the appropriate
+ * events so that waiting callers (in this tab or the originating tab) can
+ * resolve or reject their pending promises.
+ *
+ * ## Cross-tab delivery
+ *
+ * On mobile browsers, Phantom opens the redirect URL in a **new tab** (the
+ * clone tab). Events are delivered to the originating tab via the
+ * `BroadcastChannel` API. Once delivery is complete this function emits
+ * `phantomRedirectCloseTab` so that the clone tab can be closed and the user
+ * is returned to the originating tab. See the `phantomRedirectCloseTab` event
+ * JSDoc for details on how to handle tab closing.
+ *
+ * @param params.url - The callback URL received from Phantom
+ * @param client - The Dynamic client instance
+ * @throws {NoPendingPhantomRequestError} If no pending request is found in storage
+ * @throws {PhantomMissingEncryptionParamsError} If the URL is missing the
+ *   required encryption parameters (`phantom_encryption_public_key`, `data`,
+ *   `nonce`) and does not carry an error code either
+ * @throws {PhantomRedirectRejectedError} If the user rejected the request in Phantom
+ */
+export declare const completePhantomRedirect: ({ url }: CompletePhantomRedirectParams, client?: DynamicClient) => Promise<void>;
+//# sourceMappingURL=completePhantomRedirect.d.ts.map

package/dist/phantomRedirect/completePhantomRedirect/completePhantomRedirect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completePhantomRedirect.d.ts","sourceRoot":"","sources":["../../../src/phantomRedirect/completePhantomRedirect/completePhantomRedirect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAmC9D,MAAM,MAAM,6BAA6B,GAAG;IAC1C,GAAG,EAAE,GAAG,CAAC;CACV,CAAC;AAqEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,uBAAuB,YACzB,6BAA6B,WAC9B,aAAa,KACpB,OAAO,CAAC,IAAI,CAqJd,CAAC"}

package/dist/phantomRedirect/completePhantomRedirect/index.d.ts

@@ -0,0 +1,3 @@
+export { completePhantomRedirect } from './completePhantomRedirect';
+export type { CompletePhantomRedirectParams } from './completePhantomRedirect';
+//# sourceMappingURL=index.d.ts.map

package/dist/phantomRedirect/completePhantomRedirect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/phantomRedirect/completePhantomRedirect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/phantomRedirect/createPhantomRedirectWalletProvider/createPhantomRedirectWalletProvider.d.ts

@@ -0,0 +1,17 @@
+import type { DynamicClient } from '@dynamic-labs-sdk/client';
+import type { SolanaWalletProvider } from '../../SolanaWalletProvider.types';
+export type CreatePhantomRedirectWalletProviderParams = {
+    baseRedirectUrl: string;
+    dynamicClient: DynamicClient;
+};
+/**
+ * Creates a Phantom redirect-based Solana wallet provider.
+ *
+ * This wallet provider uses Phantom's deep link protocol for mobile wallet
+ * interactions with end-to-end encryption using NaCl.
+ *
+ * @param params.dynamicClient - The Dynamic client instance
+ * @returns A Phantom redirect wallet provider
+ */
+export declare const createPhantomRedirectWalletProvider: ({ baseRedirectUrl, dynamicClient, }: CreatePhantomRedirectWalletProviderParams) => SolanaWalletProvider;
+//# sourceMappingURL=createPhantomRedirectWalletProvider.d.ts.map

package/dist/phantomRedirect/createPhantomRedirectWalletProvider/createPhantomRedirectWalletProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPhantomRedirectWalletProvider.d.ts","sourceRoot":"","sources":["../../../src/phantomRedirect/createPhantomRedirectWalletProvider/createPhantomRedirectWalletProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAe9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAiB7E,MAAM,MAAM,yCAAyC,GAAG;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAsBF;;;;;;;;GAQG;AACH,eAAO,MAAM,mCAAmC,wCAG7C,yCAAyC,KAAG,oBA8e9C,CAAC"}

package/dist/phantomRedirect/createPhantomRedirectWalletProvider/index.d.ts

@@ -0,0 +1,3 @@
+export { createPhantomRedirectWalletProvider } from './createPhantomRedirectWalletProvider';
+export type { CreatePhantomRedirectWalletProviderParams } from './createPhantomRedirectWalletProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/phantomRedirect/createPhantomRedirectWalletProvider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/phantomRedirect/createPhantomRedirectWalletProvider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mCAAmC,EAAE,MAAM,uCAAuC,CAAC;AAC5F,YAAY,EAAE,yCAAyC,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/phantomRedirect/detectPhantomRedirect/detectPhantomRedirect.d.ts

@@ -0,0 +1,17 @@
+import type { DynamicClient } from '@dynamic-labs-sdk/client';
+export type DetectPhantomRedirectParams = {
+    url: URL;
+};
+/**
+ * Detects if the current URL is a Phantom wallet redirect.
+ *
+ * This function examines the URL parameters to determine if it contains
+ * redirect data from a Phantom wallet deep link operation, and validates
+ * that there is a corresponding pending request in storage.
+ *
+ * @param params.url - The URL to check for Phantom redirect parameters
+ * @param client - The Dynamic client instance
+ * @returns A promise that resolves to true if the URL is a valid Phantom redirect, false otherwise
+ */
+export declare const detectPhantomRedirect: ({ url }: DetectPhantomRedirectParams, client?: DynamicClient) => Promise<boolean>;
+//# sourceMappingURL=detectPhantomRedirect.d.ts.map

package/dist/phantomRedirect/detectPhantomRedirect/detectPhantomRedirect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectPhantomRedirect.d.ts","sourceRoot":"","sources":["../../../src/phantomRedirect/detectPhantomRedirect/detectPhantomRedirect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAK9D,MAAM,MAAM,2BAA2B,GAAG;IACxC,GAAG,EAAE,GAAG,CAAC;CACV,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,YACvB,2BAA2B,WAC5B,aAAa,KACpB,OAAO,CAAC,OAAO,CAmBjB,CAAC"}

package/dist/phantomRedirect/detectPhantomRedirect/index.d.ts

@@ -0,0 +1,3 @@
+export { detectPhantomRedirect } from './detectPhantomRedirect';
+export type { DetectPhantomRedirectParams } from './detectPhantomRedirect';
+//# sourceMappingURL=index.d.ts.map

package/dist/phantomRedirect/detectPhantomRedirect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/phantomRedirect/detectPhantomRedirect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/phantomRedirect/errors/NoPendingPhantomRequestError.d.ts

@@ -0,0 +1,5 @@
+import { BaseError } from '@dynamic-labs-sdk/client';
+export declare class NoPendingPhantomRequestError extends BaseError {
+    constructor();
+}
+//# sourceMappingURL=NoPendingPhantomRequestError.d.ts.map

package/dist/phantomRedirect/errors/NoPendingPhantomRequestError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoPendingPhantomRequestError.d.ts","sourceRoot":"","sources":["../../../src/phantomRedirect/errors/NoPendingPhantomRequestError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,qBAAa,4BAA6B,SAAQ,SAAS;;CAW1D"}

package/dist/phantomRedirect/errors/NoPhantomSessionError.d.ts

@@ -0,0 +1,5 @@
+import { BaseError } from '@dynamic-labs-sdk/client';
+export declare class NoPhantomSessionError extends BaseError {
+    constructor();
+}
+//# sourceMappingURL=NoPhantomSessionError.d.ts.map

package/dist/phantomRedirect/errors/NoPhantomSessionError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoPhantomSessionError.d.ts","sourceRoot":"","sources":["../../../src/phantomRedirect/errors/NoPhantomSessionError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,qBAAa,qBAAsB,SAAQ,SAAS;;CAUnD"}

package/dist/phantomRedirect/errors/PhantomMissingEncryptionParamsError.d.ts

@@ -0,0 +1,5 @@
+import { BaseError } from '@dynamic-labs-sdk/client';
+export declare class PhantomMissingEncryptionParamsError extends BaseError {
+    constructor();
+}
+//# sourceMappingURL=PhantomMissingEncryptionParamsError.d.ts.map

package/dist/phantomRedirect/errors/PhantomMissingEncryptionParamsError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhantomMissingEncryptionParamsError.d.ts","sourceRoot":"","sources":["../../../src/phantomRedirect/errors/PhantomMissingEncryptionParamsError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,qBAAa,mCAAoC,SAAQ,SAAS;;CAWjE"}

package/dist/phantomRedirect/errors/PhantomRedirectDecryptionError.d.ts

@@ -0,0 +1,5 @@
+import { BaseError } from '@dynamic-labs-sdk/client';
+export declare class PhantomRedirectDecryptionError extends BaseError {
+    constructor();
+}
+//# sourceMappingURL=PhantomRedirectDecryptionError.d.ts.map

package/dist/phantomRedirect/errors/PhantomRedirectDecryptionError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhantomRedirectDecryptionError.d.ts","sourceRoot":"","sources":["../../../src/phantomRedirect/errors/PhantomRedirectDecryptionError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,qBAAa,8BAA+B,SAAQ,SAAS;;CAW5D"}

package/dist/phantomRedirect/errors/PhantomRedirectRejectedError.d.ts

@@ -0,0 +1,9 @@
+import { BaseError } from '@dynamic-labs-sdk/client';
+export type PhantomRedirectRejectedErrorParams = {
+    errorCode: string;
+    errorMessage?: string;
+};
+export declare class PhantomRedirectRejectedError extends BaseError {
+    constructor({ errorCode, errorMessage }: PhantomRedirectRejectedErrorParams);
+}
+//# sourceMappingURL=PhantomRedirectRejectedError.d.ts.map

package/dist/phantomRedirect/errors/PhantomRedirectRejectedError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhantomRedirectRejectedError.d.ts","sourceRoot":"","sources":["../../../src/phantomRedirect/errors/PhantomRedirectRejectedError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,MAAM,MAAM,kCAAkC,GAAG;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,qBAAa,4BAA6B,SAAQ,SAAS;gBAC7C,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,kCAAkC;CAW5E"}

package/dist/phantomRedirect/errors/PhantomRedirectTimeoutError.d.ts

@@ -0,0 +1,5 @@
+import { BaseError } from '@dynamic-labs-sdk/client';
+export declare class PhantomRedirectTimeoutError extends BaseError {
+    constructor();
+}
+//# sourceMappingURL=PhantomRedirectTimeoutError.d.ts.map

package/dist/phantomRedirect/errors/PhantomRedirectTimeoutError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhantomRedirectTimeoutError.d.ts","sourceRoot":"","sources":["../../../src/phantomRedirect/errors/PhantomRedirectTimeoutError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,qBAAa,2BAA4B,SAAQ,SAAS;;CAWzD"}

package/dist/phantomRedirect/phantomRedirect.broadcast.types.d.ts

@@ -0,0 +1,6 @@
+export type PhantomEvents = Pick<DynamicEvents, 'phantomRedirectConnectionComplete' | 'phantomRedirectConnectionError' | 'phantomRedirectDisconnectComplete' | 'phantomRedirectDisconnectError' | 'phantomRedirectSignAllTransactionsComplete' | 'phantomRedirectSignAllTransactionsError' | 'phantomRedirectSignAndSendTransactionComplete' | 'phantomRedirectSignAndSendTransactionError' | 'phantomRedirectSignMessageComplete' | 'phantomRedirectSignMessageError' | 'phantomRedirectSignTransactionComplete' | 'phantomRedirectSignTransactionError'>;
+export type PhantomBroadcastMessage<K extends keyof PhantomEvents> = {
+    args: Parameters<PhantomEvents[K]>[0];
+    event: K;
+};
+//# sourceMappingURL=phantomRedirect.broadcast.types.d.ts.map

package/dist/phantomRedirect/phantomRedirect.broadcast.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phantomRedirect.broadcast.types.d.ts","sourceRoot":"","sources":["../../src/phantomRedirect/phantomRedirect.broadcast.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,IAAI,CAC9B,aAAa,EACX,mCAAmC,GACnC,gCAAgC,GAChC,mCAAmC,GACnC,gCAAgC,GAChC,4CAA4C,GAC5C,yCAAyC,GACzC,+CAA+C,GAC/C,4CAA4C,GAC5C,oCAAoC,GACpC,iCAAiC,GACjC,wCAAwC,GACxC,qCAAqC,CACxC,CAAC;AAEF,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,MAAM,aAAa,IAAI;IACnE,IAAI,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC;CACV,CAAC"}

package/dist/phantomRedirect/phantomRedirect.constants.d.ts

@@ -0,0 +1,5 @@
+export declare const PHANTOM_DEEPLINK_BASE_URL = "https://phantom.app/ul/v1";
+export declare const PHANTOM_SESSION_STORAGE_KEY = "phantom_session";
+export declare const PHANTOM_PENDING_REQUEST_STORAGE_KEY = "phantom_pending_request";
+export declare const PHANTOM_REDIRECT_TIMEOUT_MS = 300000;
+//# sourceMappingURL=phantomRedirect.constants.d.ts.map

package/dist/phantomRedirect/phantomRedirect.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phantomRedirect.constants.d.ts","sourceRoot":"","sources":["../../src/phantomRedirect/phantomRedirect.constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AAErE,eAAO,MAAM,2BAA2B,oBAAoB,CAAC;AAE7D,eAAO,MAAM,mCAAmC,4BAA4B,CAAC;AAE7E,eAAO,MAAM,2BAA2B,SAAS,CAAC"}

package/dist/phantomRedirect/phantomRedirect.events.d.ts

@@ -0,0 +1,152 @@
+declare global {
+    interface DynamicEvents {
+        /**
+         * Emitted by `completePhantomRedirect` when it determines the current tab
+         * is a **clone tab** — a new browser tab that Phantom opened to deliver the
+         * redirect callback on mobile browsers.
+         *
+         * ## Why this event exists
+         *
+         * On mobile browsers, after deeplinking to Phantom and the user approves or rejects the request, Phantom
+         * navigates back to your app *in a new tab*. This means the
+         * completion logic (`completePhantomRedirect`) runs in a **different tab**
+         * than the one that initiated the request.  Once the events have been
+         * broadcast back to the originating tab via `BroadcastChannel`, the clone
+         * tab has served its purpose and should be closed to return the user to
+         * the originating tab.
+         *
+         * In **mobile native** environments (e.g. React Native / Capacitor), the
+         * deep link is handled in the **same JavaScript context** — no new tab is
+         * created.  The SDK detects this via a per-client `isOriginTab` flag stored
+         * in `runtimeServices` and set by `setupPhantomListeners` when the request
+         * is initiated.  Because each JavaScript context has its own client
+         * instance, the clone tab's client starts with the flag unset and this
+         * event is correctly emitted only there.
+         *
+         * ## How to handle it
+         *
+         * Pass an `onCloseTab` callback to `addPhantomRedirectSolanaExtension`.
+         * The SDK registers it as a one-time listener for this event automatically:
+         *
+         * ```ts
+         * addPhantomRedirectSolanaExtension({
+         *   url: new URL(window.location.href),
+         *   onCloseTab: () => window.close(),
+         * });
+         * ```
+         *
+         * To explicitly opt out of automatic tab closing, pass an empty function:
+         *
+         * ```ts
+         * onCloseTab: () => {}
+         * ```
+         *
+         * You can also subscribe to this event directly if you need more control:
+         *
+         * ```ts
+         * onEvent({ event: 'phantomRedirectCloseTab', listener: () => window.close() }, client);
+         * ```
+         */
+        phantomRedirectCloseTab: (args: Record<string, never>) => void;
+        /**
+         * Emitted when the Phantom redirect connection flow completes successfully.
+         * The wallet address and public key of the connected account are included.
+         */
+        phantomRedirectConnectionComplete: (args: {
+            address: string;
+            publicKey: string;
+        }) => void;
+        /**
+         * Emitted when the Phantom redirect connection flow fails (e.g. the user
+         * rejected the request in Phantom).
+         */
+        phantomRedirectConnectionError: (args: {
+            error: Error;
+        }) => void;
+        /**
+         * Emitted when the Phantom redirect disconnect flow completes successfully.
+         *
+         * ## Why a dedicated event is needed for disconnect
+         *
+         * Unlike every other Phantom deeplink method, the `disconnect` callback URL
+         * carries **no query parameters at all** on success — Phantom simply
+         * redirects to `redirect_link` with nothing appended. There is no `data`
+         * or `nonce` to decrypt, and no `phantom_encryption_public_key`. This
+         * makes disconnect structurally different from all sign/connect callbacks,
+         * which always carry at least `nonce` + `data`.
+         *
+         * `completePhantomRedirect` handles this by checking for
+         * `pendingRequest.method === 'disconnect'` **before** the
+         * `!params.data || !params.nonce` guard, so an empty callback URL is
+         * treated as a successful disconnect rather than as a
+         * `PhantomMissingEncryptionParamsError`.
+         *
+         * After this event fires the session storage is cleared by the
+         * `createPhantomRedirectWalletProvider` disconnect handler.
+         */
+        phantomRedirectDisconnectComplete: (args: Record<string, never>) => void;
+        /**
+         * Emitted when the Phantom redirect disconnect flow fails (e.g. the user
+         * rejected the request in Phantom).
+         */
+        phantomRedirectDisconnectError: (args: {
+            error: Error;
+        }) => void;
+        /**
+         * Emitted when the Phantom redirect signAllTransactions flow completes
+         * successfully. The signed transactions are returned as base-58 strings.
+         */
+        phantomRedirectSignAllTransactionsComplete: (args: {
+            transactions: string[];
+        }) => void;
+        /**
+         * Emitted when the Phantom redirect signAllTransactions flow fails.
+         */
+        phantomRedirectSignAllTransactionsError: (args: {
+            error: Error;
+        }) => void;
+        /**
+         * Emitted when the Phantom redirect signAndSendTransaction flow completes
+         * successfully. The transaction signature is included.
+         */
+        phantomRedirectSignAndSendTransactionComplete: (args: {
+            signature: string;
+        }) => void;
+        /**
+         * Emitted when the Phantom redirect signAndSendTransaction flow fails.
+         */
+        phantomRedirectSignAndSendTransactionError: (args: {
+            error: Error;
+        }) => void;
+        /**
+         * Emitted when the Phantom redirect signMessage flow completes
+         * successfully. The original message and its base-58 signature are
+         * included.
+         */
+        phantomRedirectSignMessageComplete: (args: {
+            message?: string;
+            signature: string;
+        }) => void;
+        /**
+         * Emitted when the Phantom redirect signMessage flow fails.
+         */
+        phantomRedirectSignMessageError: (args: {
+            error: Error;
+        }) => void;
+        /**
+         * Emitted when the Phantom redirect signTransaction flow completes
+         * successfully. The signed transaction is returned as a base-58 string.
+         */
+        phantomRedirectSignTransactionComplete: (args: {
+            transaction: string;
+        }) => void;
+        /**
+         * Emitted when the Phantom redirect signTransaction flow fails.
+         */
+        phantomRedirectSignTransactionError: (args: {
+            error: Error;
+        }) => void;
+    }
+}
+export {};
+//# sourceMappingURL=phantomRedirect.events.d.ts.map

package/dist/phantomRedirect/phantomRedirect.events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phantomRedirect.events.d.ts","sourceRoot":"","sources":["../../src/phantomRedirect/phantomRedirect.events.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,aAAa;QACrB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA8CG;QACH,uBAAuB,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;QAE/D;;;WAGG;QACH,iCAAiC,EAAE,CAAC,IAAI,EAAE;YACxC,OAAO,EAAE,MAAM,CAAC;YAChB,SAAS,EAAE,MAAM,CAAC;SACnB,KAAK,IAAI,CAAC;QAEX;;;WAGG;QACH,8BAA8B,EAAE,CAAC,IAAI,EAAE;YAAE,KAAK,EAAE,KAAK,CAAA;SAAE,KAAK,IAAI,CAAC;QAEjE;;;;;;;;;;;;;;;;;;;;WAoBG;QACH,iCAAiC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;QAEzE;;;WAGG;QACH,8BAA8B,EAAE,CAAC,IAAI,EAAE;YAAE,KAAK,EAAE,KAAK,CAAA;SAAE,KAAK,IAAI,CAAC;QAEjE;;;WAGG;QACH,0CAA0C,EAAE,CAAC,IAAI,EAAE;YACjD,YAAY,EAAE,MAAM,EAAE,CAAC;SACxB,KAAK,IAAI,CAAC;QAEX;;WAEG;QACH,uCAAuC,EAAE,CAAC,IAAI,EAAE;YAAE,KAAK,EAAE,KAAK,CAAA;SAAE,KAAK,IAAI,CAAC;QAE1E;;;WAGG;QACH,6CAA6C,EAAE,CAAC,IAAI,EAAE;YACpD,SAAS,EAAE,MAAM,CAAC;SACnB,KAAK,IAAI,CAAC;QAEX;;WAEG;QACH,0CAA0C,EAAE,CAAC,IAAI,EAAE;YACjD,KAAK,EAAE,KAAK,CAAC;SACd,KAAK,IAAI,CAAC;QAEX;;;;WAIG;QACH,kCAAkC,EAAE,CAAC,IAAI,EAAE;YACzC,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,SAAS,EAAE,MAAM,CAAC;SACnB,KAAK,IAAI,CAAC;QAEX;;WAEG;QACH,+BAA+B,EAAE,CAAC,IAAI,EAAE;YAAE,KAAK,EAAE,KAAK,CAAA;SAAE,KAAK,IAAI,CAAC;QAElE;;;WAGG;QACH,sCAAsC,EAAE,CAAC,IAAI,EAAE;YAC7C,WAAW,EAAE,MAAM,CAAC;SACrB,KAAK,IAAI,CAAC;QAEX;;WAEG;QACH,mCAAmC,EAAE,CAAC,IAAI,EAAE;YAAE,KAAK,EAAE,KAAK,CAAA;SAAE,KAAK,IAAI,CAAC;KACvE;CACF;AAED,OAAO,EAAE,CAAC"}

package/dist/phantomRedirect/storage/pendingRequestStorageSchema/index.d.ts

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

package/dist/phantomRedirect/storage/pendingRequestStorageSchema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/phantomRedirect/storage/pendingRequestStorageSchema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/phantomRedirect/storage/pendingRequestStorageSchema/pendingRequestStorageSchema.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Storage schema for tracking pending Phantom wallet requests.
+ * This temporary data is used to match redirect responses with their
+ * originating requests and includes the encryption keys needed for decryption.
+ */
+export declare const pendingRequestStorageKeySchema: import("@dynamic-labs-sdk/client/core").StorageKeySchema<{
+    dappPublicKey: string;
+    dappSecretKey: string;
+    method: string;
+    requestId: string;
+    timestamp: number;
+    message?: string | undefined;
+    walletAddress?: string | undefined;
+}>;
+//# sourceMappingURL=pendingRequestStorageSchema.d.ts.map

package/dist/phantomRedirect/storage/pendingRequestStorageSchema/pendingRequestStorageSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pendingRequestStorageSchema.d.ts","sourceRoot":"","sources":["../../../../src/phantomRedirect/storage/pendingRequestStorageSchema/pendingRequestStorageSchema.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;EAWzC,CAAC"}

package/dist/phantomRedirect/storage/phantomSessionStorageSchema/index.d.ts

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

package/dist/phantomRedirect/storage/phantomSessionStorageSchema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/phantomRedirect/storage/phantomSessionStorageSchema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/phantomRedirect/storage/phantomSessionStorageSchema/phantomSessionStorageSchema.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Storage schema for persisting Phantom wallet session data.
+ * This includes the encryption keys and session information needed
+ * for subsequent operations after the initial connection.
+ */
+export declare const phantomSessionStorageKeySchema: import("@dynamic-labs-sdk/client/core").StorageKeySchema<{
+    dappPublicKey: string;
+    dappSecretKey: string;
+    phantomPublicKey: string;
+    sessionToken: string;
+    sharedSecret: string;
+    walletAddress: string;
+}>;
+//# sourceMappingURL=phantomSessionStorageSchema.d.ts.map

package/dist/phantomRedirect/storage/phantomSessionStorageSchema/phantomSessionStorageSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phantomSessionStorageSchema.d.ts","sourceRoot":"","sources":["../../../../src/phantomRedirect/storage/phantomSessionStorageSchema/phantomSessionStorageSchema.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;;;;;EAUzC,CAAC"}

package/dist/phantomRedirect/utils/broadcastPhantomEvent/broadcastPhantomEvent.d.ts

@@ -0,0 +1,16 @@
+import type { DynamicClient } from '@dynamic-labs-sdk/client';
+import type { PhantomBroadcastMessage, PhantomEvents } from '../../phantomRedirect.broadcast.types';
+/**
+ * Broadcasts a Phantom redirect event to other tabs via the crossTabBroadcast
+ * service.
+ *
+ * Used by the redirect-completion tab to notify the originating tab that
+ * an operation has finished, since onceEvent listeners are in-memory and
+ * do not cross tab boundaries.
+ *
+ * @param params.event - The DynamicEvents event name to broadcast
+ * @param params.args - The event arguments to include in the message
+ * @param client - The Dynamic client instance
+ */
+export declare const broadcastPhantomEvent: <K extends keyof PhantomEvents>({ args, event }: PhantomBroadcastMessage<K>, client: DynamicClient) => void;
+//# sourceMappingURL=broadcastPhantomEvent.d.ts.map

package/dist/phantomRedirect/utils/broadcastPhantomEvent/broadcastPhantomEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcastPhantomEvent.d.ts","sourceRoot":"","sources":["../../../../src/phantomRedirect/utils/broadcastPhantomEvent/broadcastPhantomEvent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,KAAK,EACV,uBAAuB,EACvB,aAAa,EACd,MAAM,uCAAuC,CAAC;AAE/C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,MAAM,aAAa,mBAChD,uBAAuB,CAAC,CAAC,CAAC,UACnC,aAAa,KACpB,IAEF,CAAC"}

package/dist/phantomRedirect/utils/broadcastPhantomEvent/index.d.ts

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

package/dist/phantomRedirect/utils/broadcastPhantomEvent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/phantomRedirect/utils/broadcastPhantomEvent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/phantomRedirect/utils/buildPhantomDeepLink/buildPhantomDeepLink.d.ts

@@ -0,0 +1,23 @@
+export type BuildPhantomDeepLinkParams = {
+    appUrl?: string;
+    cluster?: string;
+    dappPublicKey: string;
+    method: string;
+    nonce?: string;
+    payload?: string;
+    redirectUrl: string;
+};
+/**
+ * Builds a Phantom wallet deep link URL for wallet operations.
+ *
+ * @param params.method - The operation method (connect, signMessage, signTransaction, etc.)
+ * @param params.appUrl - Optional dApp URL shown in Phantom's UI
+ * @param params.dappPublicKey - The dApp's base58-encoded public encryption key
+ * @param params.redirectUrl - The URL to redirect back to after the operation
+ * @param params.cluster - Optional Solana cluster (mainnet-beta, devnet, testnet)
+ * @param params.payload - Optional encrypted payload for signing operations
+ * @param params.nonce - Optional nonce for encrypted payload
+ * @returns The complete Phantom deep link URL
+ */
+export declare const buildPhantomDeepLink: ({ appUrl, cluster, dappPublicKey, method, nonce, payload, redirectUrl, }: BuildPhantomDeepLinkParams) => URL;
+//# sourceMappingURL=buildPhantomDeepLink.d.ts.map

package/dist/phantomRedirect/utils/buildPhantomDeepLink/buildPhantomDeepLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildPhantomDeepLink.d.ts","sourceRoot":"","sources":["../../../../src/phantomRedirect/utils/buildPhantomDeepLink/buildPhantomDeepLink.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,6EAQ9B,0BAA0B,KAAG,GAuB/B,CAAC"}

package/dist/phantomRedirect/utils/buildPhantomDeepLink/index.d.ts

@@ -0,0 +1,3 @@
+export { buildPhantomDeepLink } from './buildPhantomDeepLink';
+export type { BuildPhantomDeepLinkParams } from './buildPhantomDeepLink';
+//# sourceMappingURL=index.d.ts.map

package/dist/phantomRedirect/utils/buildPhantomDeepLink/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/phantomRedirect/utils/buildPhantomDeepLink/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/phantomRedirect/utils/cleanPhantomParamsFromUrl/cleanPhantomParamsFromUrl.d.ts

@@ -0,0 +1,15 @@
+export type CleanPhantomParamsFromUrlParams = {
+    url: URL;
+};
+/**
+ * Removes Phantom wallet redirect parameters from a URL.
+ *
+ * This is useful for cleaning up the browser address bar after
+ * handling a Phantom redirect, removing the Phantom-specific
+ * query parameters while preserving other parameters.
+ *
+ * @param params.url - The URL to clean
+ * @returns A new URL with Phantom parameters removed
+ */
+export declare const cleanPhantomParamsFromUrl: ({ url, }: CleanPhantomParamsFromUrlParams) => URL;
+//# sourceMappingURL=cleanPhantomParamsFromUrl.d.ts.map

package/dist/phantomRedirect/utils/cleanPhantomParamsFromUrl/cleanPhantomParamsFromUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanPhantomParamsFromUrl.d.ts","sourceRoot":"","sources":["../../../../src/phantomRedirect/utils/cleanPhantomParamsFromUrl/cleanPhantomParamsFromUrl.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,+BAA+B,GAAG;IAC5C,GAAG,EAAE,GAAG,CAAC;CACV,CAAC;AAWF;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,aAEnC,+BAA+B,KAAG,GAQpC,CAAC"}

package/dist/phantomRedirect/utils/cleanPhantomParamsFromUrl/index.d.ts

@@ -0,0 +1,3 @@
+export { cleanPhantomParamsFromUrl } from './cleanPhantomParamsFromUrl';
+export type { CleanPhantomParamsFromUrlParams } from './cleanPhantomParamsFromUrl';
+//# sourceMappingURL=index.d.ts.map

package/dist/phantomRedirect/utils/cleanPhantomParamsFromUrl/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/phantomRedirect/utils/cleanPhantomParamsFromUrl/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,YAAY,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/phantomRedirect/utils/crypto/createNaClSharedSecret/createNaClSharedSecret.d.ts

@@ -0,0 +1,13 @@
+export type CreateNaClSharedSecretParams = {
+    ourSecretKey: string;
+    theirPublicKey: string;
+};
+/**
+ * Creates a shared secret for NaCl box encryption using our secret key and their public key.
+ *
+ * @param params.ourSecretKey - Our base58-encoded secret key
+ * @param params.theirPublicKey - Their base58-encoded public key
+ * @returns The base58-encoded shared secret
+ */
+export declare const createNaClSharedSecret: ({ ourSecretKey, theirPublicKey, }: CreateNaClSharedSecretParams) => string;
+//# sourceMappingURL=createNaClSharedSecret.d.ts.map

package/dist/phantomRedirect/utils/crypto/createNaClSharedSecret/createNaClSharedSecret.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createNaClSharedSecret.d.ts","sourceRoot":"","sources":["../../../../../src/phantomRedirect/utils/crypto/createNaClSharedSecret/createNaClSharedSecret.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,4BAA4B,GAAG;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,sCAGhC,4BAA4B,KAAG,MAOjC,CAAC"}

package/dist/phantomRedirect/utils/crypto/createNaClSharedSecret/index.d.ts

@@ -0,0 +1,3 @@
+export { createNaClSharedSecret } from './createNaClSharedSecret';
+export type { CreateNaClSharedSecretParams } from './createNaClSharedSecret';
+//# sourceMappingURL=index.d.ts.map

package/dist/phantomRedirect/utils/crypto/createNaClSharedSecret/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/phantomRedirect/utils/crypto/createNaClSharedSecret/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/phantomRedirect/utils/crypto/decryptPayload/decryptPayload.d.ts

@@ -0,0 +1,16 @@
+export type DecryptPayloadParams = {
+    data: string;
+    nonce: string;
+    sharedSecret: string;
+};
+/**
+ * Decrypts a payload using NaCl box encryption with a shared secret.
+ *
+ * @param params.data - The base58-encoded encrypted data
+ * @param params.nonce - The base58-encoded nonce
+ * @param params.sharedSecret - The base58-encoded shared secret
+ * @returns The decrypted payload object
+ * @throws {PhantomRedirectDecryptionError} If decryption fails
+ */
+export declare const decryptPayload: ({ data, nonce, sharedSecret, }: DecryptPayloadParams) => Record<string, unknown>;
+//# sourceMappingURL=decryptPayload.d.ts.map

package/dist/phantomRedirect/utils/crypto/decryptPayload/decryptPayload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decryptPayload.d.ts","sourceRoot":"","sources":["../../../../../src/phantomRedirect/utils/crypto/decryptPayload/decryptPayload.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,mCAIxB,oBAAoB,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAwB/C,CAAC"}

package/dist/phantomRedirect/utils/crypto/decryptPayload/index.d.ts

@@ -0,0 +1,3 @@
+export { decryptPayload } from './decryptPayload';
+export type { DecryptPayloadParams } from './decryptPayload';
+//# sourceMappingURL=index.d.ts.map

package/dist/phantomRedirect/utils/crypto/decryptPayload/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/phantomRedirect/utils/crypto/decryptPayload/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/phantomRedirect/utils/crypto/encryptPayload/encryptPayload.d.ts

@@ -0,0 +1,17 @@
+export type EncryptPayloadParams = {
+    payload: Record<string, unknown>;
+    sharedSecret: string;
+};
+export type EncryptedPayload = {
+    data: string;
+    nonce: string;
+};
+/**
+ * Encrypts a payload using NaCl box encryption with a shared secret.
+ *
+ * @param params.payload - The payload object to encrypt
+ * @param params.sharedSecret - The base58-encoded shared secret
+ * @returns The encrypted data and nonce, both base58-encoded
+ */
+export declare const encryptPayload: ({ payload, sharedSecret, }: EncryptPayloadParams) => EncryptedPayload;
+//# sourceMappingURL=encryptPayload.d.ts.map

package/dist/phantomRedirect/utils/crypto/encryptPayload/encryptPayload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryptPayload.d.ts","sourceRoot":"","sources":["../../../../../src/phantomRedirect/utils/crypto/encryptPayload/encryptPayload.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,+BAGxB,oBAAoB,KAAG,gBAezB,CAAC"}

package/dist/phantomRedirect/utils/crypto/encryptPayload/index.d.ts

@@ -0,0 +1,3 @@
+export { encryptPayload } from './encryptPayload';
+export type { EncryptPayloadParams, EncryptedPayload } from './encryptPayload';
+//# sourceMappingURL=index.d.ts.map

package/dist/phantomRedirect/utils/crypto/encryptPayload/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/phantomRedirect/utils/crypto/encryptPayload/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}