@dynamic-labs-sdk/solana 1.18.0 → 1.19.0

package/dist/index.esm.js

@@ -1,8 +1,8 @@
-import { a as NotSolanaProviderError, c as isSolanaWalletAccount, d as registerSolanaNetworkProviderBuilder, f as name, i as isSolanaGasSponsorshipEnabled, l as isVersionedTransaction, n as solanaExecuteSwapTransaction, o as isSolanaWalletProvider, p as version, r as signAndSendTransaction, s as solanaConfirmTransaction, t as solanaTransferAmount, u as getSolanaConnection } from "./solanaTransferAmount-DX35Wg5S.esm.js";
+import { a as NotSolanaProviderError, c as isSolanaWalletAccount, d as registerSolanaNetworkProviderBuilder, f as name, i as isSolanaGasSponsorshipEnabled, l as isVersionedTransaction, n as solanaExecuteSwapTransaction, o as isSolanaWalletProvider, p as version, r as signAndSendTransaction, s as solanaConfirmTransaction, t as solanaTransferAmount, u as getSolanaConnection } from "./solanaTransferAmount-CdkPbAES.esm.js";
 import { t as assertBufferAvailable } from "./assertBufferAvailable-b4xOlERy.esm.js";
-import { n as SponsorTransactionError, t as addWaasSolanaExtension } from "./addWaasSolanaExtension-CzXKrlYb.esm.js";
-import "./createWalletProviderFromSolanaStandardWallet-CKgaSEl8.esm.js";
-import { t as addSolanaWalletStandardExtension } from "./addSolanaWalletStandardExtension-BGeu9CyF.esm.js";
+import { n as SponsorTransactionError, t as addWaasSolanaExtension } from "./addWaasSolanaExtension-DVuz2ISz.esm.js";
+import "./createWalletProviderFromSolanaStandardWallet-B7jh3I6k.esm.js";
+import { t as addSolanaWalletStandardExtension } from "./addSolanaWalletStandardExtension-CbR1BbPB.esm.js";
 import { assertPackageVersion } from "@dynamic-labs-sdk/assert-package-version";
 import { MethodNotImplementedError, WalletProviderPriority, assertDefined, createApiClient, createDeferredPromise, createRuntimeServiceAccessKey, createStorageKeySchema, emitEvent, formatWalletProviderGroupKey, formatWalletProviderKey, getActiveNetworkIdFromLastKnownRegistry, getBuffer, getCore, getDefaultClient, getNetworkProviders, getWalletProviderFromWalletAccount, getWalletProviderRegistry, hasExtension, randomString, registerExtension } from "@dynamic-labs-sdk/client/core";
 import { BaseError, FeeEstimationFailedError, InvalidParamError, SimulationFailedError, getActiveNetworkData, getDefaultClient as getDefaultClient$1, onEvent, onceEvent } from "@dynamic-labs-sdk/client";
@@ -20,7 +20,16 @@ import nacl from "tweetnacl";
 * and the Dynamic WaaS Solana extension, enabling support for all Solana wallet types
 * including standard wallets and embedded wallets managed by Dynamic's infrastructure.
 *
+* @example
+* ```ts
+* const client = createDynamicClient({ environmentId: 'env-123' });
+* addSolanaExtension(client);
+* ```
+*
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns void
+* @see isSolanaWalletAccount
+* @see isSolanaNetworkProvider
 * @notInstrumented
 */
 const addSolanaExtension = (client = getDefaultClient()) => {
@@ -34,8 +43,17 @@ const addSolanaExtension = (client = getDefaultClient()) => {
 /**
 * Type guard function to check if a network provider is a Solana network provider.
 *
+* @example
+* ```ts
+* if (isSolanaNetworkProvider(networkProvider)) {
+*   const connection = getSolanaConnection({ networkData });
+* }
+* ```
+*
 * @param networkProvider - The network provider to check.
 * @returns True if the network provider is a Solana network provider, false otherwise.
+* @see isSolanaWalletAccount
+* @see addSolanaExtension
 * @notInstrumented
 */
 const isSolanaNetworkProvider = (networkProvider) => networkProvider.chain === "SOL";
@@ -54,11 +72,22 @@ const sleep = (ms) => new Promise((resolve) => {
 * and querying the network. It handles both legacy Transaction and VersionedTransaction
 * formats and includes retry logic for network requests.
 *
+* @example
+* ```ts
+* const feeData = await calculateSolanaTransactionFee({
+*   transaction,
+*   networkData,
+*   nativeTokenPriceUsd: 150,
+* });
+* ```
+*
 * @param params.transaction - The Solana transaction to estimate fees for.
 * @param params.networkData - Network configuration for RPC connection.
 * @param params.nativeTokenPriceUsd - Optional USD price of SOL for fee conversion.
 * @returns Fee data in lamports and human-readable SOL format.
 * @throws {FeeEstimationFailedError} If fee retrieval fails after retries.
+* @see simulateSolanaTransaction
+* @see getSolanaConnection
 * @notInstrumented
 */
 const calculateSolanaTransactionFee = async ({ transaction, networkData, nativeTokenPriceUsd }) => {
@@ -137,6 +166,8 @@ const calculateSolanaTransactionFee = async ({ transaction, networkData, nativeT
 * @throws {InvalidParamError} If wallet account is not a Solana account.
 * @throws {SimulationFailedError} If the simulation API call fails.
 * @throws {FeeEstimationFailedError} If includeFees is true and fee calculation fails.
+* @see calculateSolanaTransactionFee
+* @see isSolanaWalletAccount
 * @notInstrumented
 */
 const simulateSolanaTransaction = async ({ walletAccount, transaction, includeFees = false }, client = getDefaultClient$1()) => {
@@ -856,6 +887,17 @@ const completeAndEmitPhantomRedirectEvent = async ({ args, event }, client) => {
 * is returned to the originating tab. See the `phantomRedirectCloseTab` event
 * JSDoc for details on how to handle tab closing.
 *
+* @example
+* ```ts
+* const url = new URL(window.location.href);
+* if (await detectPhantomRedirect({ url })) {
+*   await completePhantomRedirect({ url });
+*   // Close this clone tab; the originating tab already received the result
+*   // via BroadcastChannel and will resolve its pending promise.
+*   window.close();
+* }
+* ```
+*
 * @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
@@ -863,6 +905,9 @@ const completeAndEmitPhantomRedirectEvent = async ({ args, event }, client) => {
 *   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
+* @returns void
+* @see detectPhantomRedirect
+* @see addPhantomRedirectSolanaExtension
 * @notInstrumented
 */
 const completePhantomRedirect = async ({ url }, client = getDefaultClient()) => {
@@ -1445,9 +1490,17 @@ const createPhantomRedirectWalletProvider = ({ baseRedirectUrl, dynamicClient })
 * we fall back to checking whether a pending disconnect request exists in
 * storage.
 *
+* @example
+* ```ts
+* const url = new URL(window.location.href);
+* const isPhantomRedirect = await detectPhantomRedirect({ url });
+* ```
+*
 * @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
+* @see completePhantomRedirect
+* @see addPhantomRedirectSolanaExtension
 * @notInstrumented
 */
 const detectPhantomRedirect = async ({ url }, client = getDefaultClient()) => {
@@ -1501,10 +1554,21 @@ const PHANTOM_REDIRECT_SOLANA_EXTENSION_KEY = "phantomRedirectSolana";
 * marker written during request initiation and does **not** emit
 * `phantomRedirectCloseTab`.
 *
+* @example
+* ```ts
+* addPhantomRedirectSolanaExtension({
+*   url: new URL(window.location.href),
+*   onCloseTab: () => window.close(),
+* });
+* ```
+*
 * @param params.url - The current page URL
 * @param params.onCloseTab - Callback invoked when the clone tab should close
 * @param params.disableAutoRedirectCompletion - Skip auto detection/completion
 * @param [client] - The Dynamic client. Only required for multiple clients.
+* @returns void
+* @see completePhantomRedirect
+* @see detectPhantomRedirect
 * @notInstrumented
 */
 const addPhantomRedirectSolanaExtension = async ({ disableAutoRedirectCompletion, onCloseTab, url }, client = getDefaultClient()) => {
@@ -1560,11 +1624,23 @@ const addPhantomRedirectSolanaExtension = async ({ disableAutoRedirectCompletion
 //#endregion
 //#region src/signAllTransactions/signAllTransactions.ts
 /**
-* Signs multiple Solana transactions
-* @param params.transactions - The transactions to sign
-* @param params.walletAccount - The wallet account to sign the transactions with
+* Signs multiple Solana transactions in a single call.
+*
+* @example
+* ```ts
+* const { signedTransactions } = await signAllTransactions({
+*   walletAccount: solAccount,
+*   transactions: [tx1, tx2, tx3],
+* });
+* ```
+*
+* @param params.transactions - The transactions to sign.
+* @param params.walletAccount - The wallet account to sign the transactions with.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
-* @returns An object containing the signed transactions
+* @returns An object containing the signed transactions.
+* @throws {NotSolanaProviderError} If the wallet provider is not a Solana provider.
+* @see signTransaction
+* @see signAndSendTransaction
 * @notInstrumented
 */
 const signAllTransactions = async ({ walletAccount, transactions }, client = getDefaultClient$1()) => {
@@ -1582,12 +1658,22 @@ const signAllTransactions = async ({ walletAccount, transactions }, client = get
 * Signs and sends a sponsored Solana transaction.
 * The transaction will be sponsored via Dynamic's gas sponsorship API.
 *
-* @param params.transaction - The transaction to sponsor, sign, and send
-* @param params.walletAccount - The wallet account to sign and send the transaction with
+* @example
+* ```ts
+* const { signature } = await signAndSendSponsoredTransaction({
+*   walletAccount: solAccount,
+*   transaction,
+* });
+* ```
+*
+* @param params.transaction - The transaction to sponsor, sign, and send.
+* @param params.walletAccount - The wallet account to sign and send the transaction with.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
-* @returns An object containing the signature
-* @throws {NotSolanaProviderError} If the wallet provider is not a Solana provider
-* @throws {MethodNotImplementedError} If the wallet provider does not implement signAndSendSponsoredTransaction
+* @returns An object containing the signature.
+* @throws {NotSolanaProviderError} If the wallet provider is not a Solana provider.
+* @throws {MethodNotImplementedError} If the wallet provider does not implement signAndSendSponsoredTransaction.
+* @see signAndSendTransaction
+* @see isSolanaGasSponsorshipEnabled
 * @notInstrumented
 */
 const signAndSendSponsoredTransaction = async ({ walletAccount, transaction, options }, client = getDefaultClient$1()) => {
@@ -1604,11 +1690,23 @@ const signAndSendSponsoredTransaction = async ({ walletAccount, transaction, opt
 //#endregion
 //#region src/signTransaction/signTransaction.ts
 /**
-* Signs a Solana transaction
-* @param params.transaction - The transaction to sign
-* @param params.walletAccount - The wallet account to sign the transaction with
+* Signs a Solana transaction without sending it.
+*
+* @example
+* ```ts
+* const { signedTransaction } = await signTransaction({
+*   walletAccount: solAccount,
+*   transaction,
+* });
+* ```
+*
+* @param params.transaction - The transaction to sign.
+* @param params.walletAccount - The wallet account to sign the transaction with.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
-* @returns An object containing the signed transaction
+* @returns An object containing the signed transaction.
+* @throws {NotSolanaProviderError} If the wallet provider is not a Solana provider.
+* @see signAndSendTransaction
+* @see signAllTransactions
 * @notInstrumented
 */
 const signTransaction = async ({ walletAccount, transaction }, client = getDefaultClient$1()) => {