@dynamic-labs-sdk/solana 1.3.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (81) hide show
  1. package/dist/addSolanaWalletStandardExtension-BA3gsfap.esm.js +43 -0
  2. package/dist/addSolanaWalletStandardExtension-BA3gsfap.esm.js.map +1 -0
  3. package/dist/addSolanaWalletStandardExtension-B_xgItlS.cjs +49 -0
  4. package/dist/addSolanaWalletStandardExtension-B_xgItlS.cjs.map +1 -0
  5. package/dist/{addWaasSolanaExtension-Cg3NSUhc.cjs → addWaasSolanaExtension-BFUZxm1W.cjs} +2 -2
  6. package/dist/{addWaasSolanaExtension-Cg3NSUhc.cjs.map → addWaasSolanaExtension-BFUZxm1W.cjs.map} +1 -1
  7. package/dist/{addWaasSolanaExtension-BkfWvyyw.esm.js → addWaasSolanaExtension-DqoYZS9E.esm.js} +2 -2
  8. package/dist/{addWaasSolanaExtension-BkfWvyyw.esm.js.map → addWaasSolanaExtension-DqoYZS9E.esm.js.map} +1 -1
  9. package/dist/{addSolanaWalletStandardExtension-Be-6Ygxh.cjs → createWalletProviderFromSolanaStandardWallet-BxD2GtlU.cjs} +11 -43
  10. package/dist/createWalletProviderFromSolanaStandardWallet-BxD2GtlU.cjs.map +1 -0
  11. package/dist/{addSolanaWalletStandardExtension-sDd9PeWK.esm.js → createWalletProviderFromSolanaStandardWallet-p0Vh1zZ_.esm.js} +5 -43
  12. package/dist/createWalletProviderFromSolanaStandardWallet-p0Vh1zZ_.esm.js.map +1 -0
  13. package/dist/exports/metamask.d.ts +6 -0
  14. package/dist/exports/metamask.d.ts.map +1 -0
  15. package/dist/index.cjs +5 -24
  16. package/dist/index.cjs.map +1 -1
  17. package/dist/index.esm.js +4 -23
  18. package/dist/index.esm.js.map +1 -1
  19. package/dist/metamask/connectAndVerifyWithMetaMaskUriSolana/connectAndVerifyWithMetaMaskUriSolana.d.ts +20 -0
  20. package/dist/metamask/connectAndVerifyWithMetaMaskUriSolana/connectAndVerifyWithMetaMaskUriSolana.d.ts.map +1 -0
  21. package/dist/metamask/connectAndVerifyWithMetaMaskUriSolana/index.d.ts +2 -0
  22. package/dist/metamask/connectAndVerifyWithMetaMaskUriSolana/index.d.ts.map +1 -0
  23. package/dist/metamask/connectWithMetaMaskUriSolana/connectWithMetaMaskUriSolana.d.ts +16 -0
  24. package/dist/metamask/connectWithMetaMaskUriSolana/connectWithMetaMaskUriSolana.d.ts.map +1 -0
  25. package/dist/metamask/connectWithMetaMaskUriSolana/index.d.ts +3 -0
  26. package/dist/metamask/connectWithMetaMaskUriSolana/index.d.ts.map +1 -0
  27. package/dist/metamask/createMetaMaskSolanaWalletProvider/createMetaMaskSolanaWalletProvider.d.ts +16 -0
  28. package/dist/metamask/createMetaMaskSolanaWalletProvider/createMetaMaskSolanaWalletProvider.d.ts.map +1 -0
  29. package/dist/metamask/createMetaMaskSolanaWalletProvider/index.d.ts +2 -0
  30. package/dist/metamask/createMetaMaskSolanaWalletProvider/index.d.ts.map +1 -0
  31. package/dist/metamask/getMetaMaskSolanaExtensionWalletProviderKey/getMetaMaskSolanaExtensionWalletProviderKey.d.ts +11 -0
  32. package/dist/metamask/getMetaMaskSolanaExtensionWalletProviderKey/getMetaMaskSolanaExtensionWalletProviderKey.d.ts.map +1 -0
  33. package/dist/metamask/getMetaMaskSolanaExtensionWalletProviderKey/index.d.ts +2 -0
  34. package/dist/metamask/getMetaMaskSolanaExtensionWalletProviderKey/index.d.ts.map +1 -0
  35. package/dist/metamask/metamask.types.d.ts +14 -0
  36. package/dist/metamask/metamask.types.d.ts.map +1 -0
  37. package/dist/metamask/utils/createMetaMaskSolanaController/createMetaMaskSolanaController.d.ts +17 -0
  38. package/dist/metamask/utils/createMetaMaskSolanaController/createMetaMaskSolanaController.d.ts.map +1 -0
  39. package/dist/metamask/utils/createMetaMaskSolanaController/index.d.ts +2 -0
  40. package/dist/metamask/utils/createMetaMaskSolanaController/index.d.ts.map +1 -0
  41. package/dist/metamask/utils/getOrCreateMetaMaskSolanaController/getOrCreateMetaMaskSolanaController.d.ts +20 -0
  42. package/dist/metamask/utils/getOrCreateMetaMaskSolanaController/getOrCreateMetaMaskSolanaController.d.ts.map +1 -0
  43. package/dist/metamask/utils/getOrCreateMetaMaskSolanaController/index.d.ts +2 -0
  44. package/dist/metamask/utils/getOrCreateMetaMaskSolanaController/index.d.ts.map +1 -0
  45. package/dist/metamask/utils/getSolanaNetworkFromCluster/getSolanaNetworkFromCluster.d.ts +18 -0
  46. package/dist/metamask/utils/getSolanaNetworkFromCluster/getSolanaNetworkFromCluster.d.ts.map +1 -0
  47. package/dist/metamask/utils/getSolanaNetworkFromCluster/index.d.ts +3 -0
  48. package/dist/metamask/utils/getSolanaNetworkFromCluster/index.d.ts.map +1 -0
  49. package/dist/metamask/utils/getSupportedNetworks/getSupportedNetworks.d.ts +16 -0
  50. package/dist/metamask/utils/getSupportedNetworks/getSupportedNetworks.d.ts.map +1 -0
  51. package/dist/metamask/utils/getSupportedNetworks/index.d.ts +2 -0
  52. package/dist/metamask/utils/getSupportedNetworks/index.d.ts.map +1 -0
  53. package/dist/metamask.cjs +258 -0
  54. package/dist/metamask.cjs.map +1 -0
  55. package/dist/metamask.esm.js +249 -0
  56. package/dist/metamask.esm.js.map +1 -0
  57. package/dist/signAndSendTransaction/signAndSendTransaction.d.ts +26 -3
  58. package/dist/signAndSendTransaction/signAndSendTransaction.d.ts.map +1 -1
  59. package/dist/{solanaTransferAmount-BnXvC3Mo.cjs → solanaTransferAmount-CoNaVFtC.cjs} +85 -52
  60. package/dist/solanaTransferAmount-CoNaVFtC.cjs.map +1 -0
  61. package/dist/{solanaTransferAmount-DLyhEiFq.esm.js → solanaTransferAmount-DzMtPDJf.esm.js} +80 -53
  62. package/dist/solanaTransferAmount-DzMtPDJf.esm.js.map +1 -0
  63. package/dist/tsconfig.lib.tsbuildinfo +1 -1
  64. package/dist/utils/solanaExecuteSwapTransaction/solanaExecuteSwapTransaction.d.ts +5 -3
  65. package/dist/utils/solanaExecuteSwapTransaction/solanaExecuteSwapTransaction.d.ts.map +1 -1
  66. package/dist/utils/solanaTransferAmount/solanaTransferAmount.d.ts.map +1 -1
  67. package/dist/waas.cjs +2 -2
  68. package/dist/waas.esm.js +2 -2
  69. package/dist/walletConnect.cjs +1 -1
  70. package/dist/walletConnect.esm.js +1 -1
  71. package/dist/walletStandard/utils/createWalletProviderFromSolanaStandardWallet/createWalletProviderFromSolanaStandardWallet.d.ts +10 -1
  72. package/dist/walletStandard/utils/createWalletProviderFromSolanaStandardWallet/createWalletProviderFromSolanaStandardWallet.d.ts.map +1 -1
  73. package/dist/walletStandard.cjs +3 -2
  74. package/dist/walletStandard.cjs.map +1 -1
  75. package/dist/walletStandard.esm.js +3 -2
  76. package/dist/walletStandard.esm.js.map +1 -1
  77. package/package.json +14 -7
  78. package/dist/addSolanaWalletStandardExtension-Be-6Ygxh.cjs.map +0 -1
  79. package/dist/addSolanaWalletStandardExtension-sDd9PeWK.esm.js.map +0 -1
  80. package/dist/solanaTransferAmount-BnXvC3Mo.cjs.map +0 -1
  81. package/dist/solanaTransferAmount-DLyhEiFq.esm.js.map +0 -1
@@ -5,7 +5,7 @@ import { TOKEN_2022_PROGRAM_ID, TOKEN_PROGRAM_ID, createAssociatedTokenAccountIn
5
5
 
6
6
  //#region package.json
7
7
  var name = "@dynamic-labs-sdk/solana";
8
- var version = "1.3.0";
8
+ var version = "1.5.0";
9
9
 
10
10
  //#endregion
11
11
  //#region src/utils/fetchSolBalance/fetchSolBalance.ts
@@ -116,25 +116,89 @@ const isSolanaWalletProvider = (provider) => {
116
116
  return provider.chain === "SOL";
117
117
  };
118
118
 
119
+ //#endregion
120
+ //#region src/errors/NotSolanaProviderError/NotSolanaProviderError.ts
121
+ var NotSolanaProviderError = class extends BaseError {
122
+ providerKey;
123
+ constructor(params) {
124
+ super({
125
+ cause: null,
126
+ code: "not_solana_provider_error",
127
+ docsUrl: null,
128
+ name: "NotSolanaProviderError",
129
+ shortMessage: "Provider is not a Solana wallet provider"
130
+ });
131
+ this.providerKey = params.providerKey;
132
+ }
133
+ };
134
+
135
+ //#endregion
136
+ //#region src/isSolanaGasSponsorshipEnabled/isSolanaGasSponsorshipEnabled.ts
137
+ /**
138
+ * Checks if Solana gas sponsorship is enabled for the current project.
139
+ *
140
+ * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
141
+ * @returns True if Solana gas sponsorship is enabled, false otherwise.
142
+ * @not-instrumented
143
+ */
144
+ const isSolanaGasSponsorshipEnabled = (client = getDefaultClient$1()) => {
145
+ assertDefined(client.projectSettings, "Project settings are not defined");
146
+ return client.projectSettings.sdk.embeddedWallets?.svmGasSponsorshipEnabled ?? false;
147
+ };
148
+
149
+ //#endregion
150
+ //#region src/signAndSendTransaction/signAndSendTransaction.ts
151
+ /**
152
+ * Signs and sends a Solana transaction, honoring the project's Solana gas
153
+ * sponsorship setting.
154
+ *
155
+ * When solana gas sponsorship is enabled in project settings and sponsorship
156
+ * is supported by the wallet provider, the transaction is routed through
157
+ * Dynamic's gas sponsorship API.
158
+ * Otherwise it falls back to the provider's standard `signAndSendTransaction`.
159
+ *
160
+ * @param params.transaction - The transaction to sign and send
161
+ * @param params.walletAccount - The wallet account to sign and send the transaction with
162
+ * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
163
+ * @returns An object containing the signature
164
+ * @not-instrumented
165
+ */
166
+ const signAndSendTransaction = async ({ walletAccount, transaction, sponsorshipMode = "auto", options }, client = getDefaultClient$1()) => {
167
+ const provider = getWalletProviderFromWalletAccount({ walletAccount }, client);
168
+ if (!isSolanaWalletProvider(provider)) throw new NotSolanaProviderError({ providerKey: provider.key });
169
+ if (sponsorshipMode === "auto" && isSolanaGasSponsorshipEnabled(client) && provider.signAndSendSponsoredTransaction) return provider.signAndSendSponsoredTransaction({
170
+ options,
171
+ transaction,
172
+ walletAccount
173
+ });
174
+ return provider.signAndSendTransaction({
175
+ options,
176
+ transaction,
177
+ walletAccount
178
+ });
179
+ };
180
+
119
181
  //#endregion
120
182
  //#region src/utils/solanaExecuteSwapTransaction/solanaExecuteSwapTransaction.ts
121
183
  /**
122
184
  * Executes a Solana checkout transaction by deserializing the base64-encoded
123
- * transaction and sending it via the wallet provider's signAndSendTransaction.
185
+ * transaction and routing it through `signAndSendTransaction`, which applies
186
+ * the project's gas sponsorship setting when enabled.
124
187
  *
125
188
  * 1. Validates that the wallet account is a Solana wallet account
126
189
  * 2. Extracts and validates the serialized transaction from the signing payload
127
190
  * 3. Deserializes the transaction (tries VersionedTransaction first, falls back to Transaction)
128
- * 4. Signs and sends via the Solana wallet provider
191
+ * 4. Signs and sends via `signAndSendTransaction` (sponsored when project settings opt in)
129
192
  *
130
193
  * @param params.signingPayload - The signing payload containing `serializedTransaction`.
131
194
  * @param params.walletAccount - The wallet account used to sign and send the transaction.
132
195
  * @param params.onStepChange - Optional callback invoked with `'transaction'` when the send step begins.
196
+ * @param params.sponsorshipMode - `'auto'` (default) sponsors when eligible; `'off'` never sponsors.
133
197
  * @param client - The Dynamic client instance.
134
198
  * @returns The transaction hash (signature).
135
199
  * @not-instrumented
136
200
  */
137
- const solanaExecuteSwapTransaction = async ({ onStepChange, signingPayload, walletAccount }, client) => {
201
+ const solanaExecuteSwapTransaction = async ({ onStepChange, signingPayload, sponsorshipMode = "auto", walletAccount }, client) => {
138
202
  const walletProvider = getWalletProviderFromWalletAccount({ walletAccount }, client);
139
203
  if (!isSolanaWalletAccount(walletAccount) || !isSolanaWalletProvider(walletProvider)) throw new InvalidParamError("Wallet account is not a Solana wallet account");
140
204
  const serializedTransactionData = signingPayload.serializedTransaction;
@@ -147,43 +211,14 @@ const solanaExecuteSwapTransaction = async ({ onStepChange, signingPayload, wall
147
211
  transaction = Transaction.from(bytes);
148
212
  }
149
213
  onStepChange?.("transaction");
150
- const { signature } = await walletProvider.signAndSendTransaction({
214
+ const { signature } = await signAndSendTransaction({
215
+ sponsorshipMode,
151
216
  transaction,
152
217
  walletAccount
153
- });
218
+ }, client);
154
219
  return { transactionHash: signature };
155
220
  };
156
221
 
157
- //#endregion
158
- //#region src/errors/NotSolanaProviderError/NotSolanaProviderError.ts
159
- var NotSolanaProviderError = class extends BaseError {
160
- providerKey;
161
- constructor(params) {
162
- super({
163
- cause: null,
164
- code: "not_solana_provider_error",
165
- docsUrl: null,
166
- name: "NotSolanaProviderError",
167
- shortMessage: "Provider is not a Solana wallet provider"
168
- });
169
- this.providerKey = params.providerKey;
170
- }
171
- };
172
-
173
- //#endregion
174
- //#region src/isSolanaGasSponsorshipEnabled/isSolanaGasSponsorshipEnabled.ts
175
- /**
176
- * Checks if Solana gas sponsorship is enabled for the current project.
177
- *
178
- * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
179
- * @returns True if Solana gas sponsorship is enabled, false otherwise.
180
- * @not-instrumented
181
- */
182
- const isSolanaGasSponsorshipEnabled = (client = getDefaultClient$1()) => {
183
- assertDefined(client.projectSettings, "Project settings are not defined");
184
- return client.projectSettings.sdk.embeddedWallets?.svmGasSponsorshipEnabled ?? false;
185
- };
186
-
187
222
  //#endregion
188
223
  //#region src/utils/solanaTransferAmount/solanaTransferAmount.ts
189
224
  const DEFAULT_DECIMALS = 9;
@@ -229,25 +264,17 @@ const solanaTransferAmount = async ({ amount, recipient, token, walletAccount },
229
264
  toPubkey
230
265
  })];
231
266
  const { blockhash } = await connection.getLatestBlockhash("finalized");
232
- const transaction = new VersionedTransaction(new TransactionMessage({
233
- instructions,
234
- payerKey: fromPubkey,
235
- recentBlockhash: blockhash
236
- }).compileToV0Message());
237
- if (isSolanaGasSponsorshipEnabled(client) && provider.signAndSendSponsoredTransaction) {
238
- const { signature: signature$1 } = await provider.signAndSendSponsoredTransaction({
239
- transaction,
240
- walletAccount
241
- });
242
- return { transactionHash: signature$1 };
243
- }
244
- const { signature } = await provider.signAndSendTransaction({
245
- transaction,
267
+ const { signature } = await signAndSendTransaction({
268
+ transaction: new VersionedTransaction(new TransactionMessage({
269
+ instructions,
270
+ payerKey: fromPubkey,
271
+ recentBlockhash: blockhash
272
+ }).compileToV0Message()),
246
273
  walletAccount
247
- });
274
+ }, client);
248
275
  return { transactionHash: signature };
249
276
  };
250
277
 
251
278
  //#endregion
252
- export { isSolanaWalletProvider as a, isVersionedTransaction as c, name as d, version as f, solanaExecuteSwapTransaction as i, getSolanaConnection as l, isSolanaGasSponsorshipEnabled as n, solanaConfirmTransaction as o, NotSolanaProviderError as r, isSolanaWalletAccount as s, solanaTransferAmount as t, registerSolanaNetworkProviderBuilder as u };
253
- //# sourceMappingURL=solanaTransferAmount-DLyhEiFq.esm.js.map
279
+ export { NotSolanaProviderError as a, isSolanaWalletAccount as c, registerSolanaNetworkProviderBuilder as d, name as f, isSolanaGasSponsorshipEnabled as i, isVersionedTransaction as l, solanaExecuteSwapTransaction as n, isSolanaWalletProvider as o, version as p, signAndSendTransaction as r, solanaConfirmTransaction as s, solanaTransferAmount as t, getSolanaConnection as u };
280
+ //# sourceMappingURL=solanaTransferAmount-DzMtPDJf.esm.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"solanaTransferAmount-DzMtPDJf.esm.js","names":["getDefaultClient","getDefaultClient","transaction: Transaction | VersionedTransaction","instructions: TransactionInstruction[]"],"sources":["../package.json","../src/utils/fetchSolBalance/fetchSolBalance.ts","../src/utils/createSolanaNetworkProvider/createSolanaNetworkProvider.ts","../src/registerSolanaNetworkProviderBuilder/registerSolanaNetworkProviderBuilder.ts","../src/getSolanaConnection/getSolanaConnection.ts","../src/utils/isVersionedTransaction/isVersionedTransaction.ts","../src/isSolanaWalletAccount/isSolanaWalletAccount.ts","../src/utils/solanaConfirmTransaction/solanaConfirmTransaction.ts","../src/isSolanaWalletProvider/isSolanaWalletProvider.ts","../src/errors/NotSolanaProviderError/NotSolanaProviderError.ts","../src/isSolanaGasSponsorshipEnabled/isSolanaGasSponsorshipEnabled.ts","../src/signAndSendTransaction/signAndSendTransaction.ts","../src/utils/solanaExecuteSwapTransaction/solanaExecuteSwapTransaction.ts","../src/utils/solanaTransferAmount/solanaTransferAmount.ts"],"sourcesContent":["","import type { NetworkData } from '@dynamic-labs-sdk/client';\nimport { Connection, PublicKey } from '@solana/web3.js';\n\n/** @not-instrumented */\nexport const fetchSolBalance = async ({\n address,\n networkData,\n}: {\n address: string;\n networkData: NetworkData;\n}): Promise<string | null> => {\n // Establish a connection to the Solana network using the provided RPC URL.\n const connection = new Connection(networkData.rpcUrls.http[0]);\n\n // Convert the string address into a PublicKey object.\n const publicKey = new PublicKey(address);\n\n // Fetch the balance of the public key. The balance is in lamports.\n const balanceInLamports = await connection.getBalance(publicKey);\n\n // The getBalance method returns the balance in lamports.\n // 1 SOL = 1,000,000,000 lamports.\n const balanceInSol = balanceInLamports / 1_000_000_000;\n\n // Return the balance in SOL as a string\n return balanceInSol.toString();\n};\n","import type { NetworkData } from '@dynamic-labs-sdk/client';\nimport { createBaseNetworkProvider } from '@dynamic-labs-sdk/client/core';\n\nimport type { SolanaNetworkProvider } from '../../SolanaNetworkProvider.types';\nimport { fetchSolBalance } from '../fetchSolBalance';\n\n/** @not-instrumented */\nexport const createSolanaNetworkProvider = (\n networkData: NetworkData\n): SolanaNetworkProvider => ({\n ...createBaseNetworkProvider('SOL', networkData),\n cluster: networkData.cluster,\n genesisHash: networkData.genesisHash,\n getBalance: async ({ address }) => ({\n balance: await fetchSolBalance({\n address,\n networkData,\n }),\n }),\n});\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { getNetworkProviderBuilderRegistry } from '@dynamic-labs-sdk/client/core';\n\nimport { createSolanaNetworkProvider } from '../utils/createSolanaNetworkProvider';\n\n/** @not-instrumented */\nexport const registerSolanaNetworkProviderBuilder = (\n client: DynamicClient\n): void => {\n const networkProviderBuilderRegistry =\n getNetworkProviderBuilderRegistry(client);\n\n /**\n * If the Solana network provider builder is already registered, return.\n */\n if (networkProviderBuilderRegistry.get().get('SOL')) {\n return;\n }\n\n networkProviderBuilderRegistry.register({\n builder: createSolanaNetworkProvider,\n chain: 'SOL',\n });\n};\n","import type { NetworkData } from '@dynamic-labs-sdk/client';\nimport type { Commitment, ConnectionConfig } from '@solana/web3.js';\nimport { Connection } from '@solana/web3.js';\n\ntype GetSolanaConnectionOptions = {\n commitmentOrConfig?: Commitment | ConnectionConfig;\n networkData: NetworkData;\n};\n\n/**\n * Returns a new Solana connection for the given network provider.\n *\n * @example\n * ```ts\n * import { getActiveNetworkData } from '@dynamic-labs-sdk/client';\n * import { isSolanaNetworkProvider, getSolanaConnection } from '@dynamic-labs-sdk/solana';\n *\n * const { networkData } = getActiveNetworkData({ walletAccount });\n *\n * if(!networkData) {\n * throw new Error('No network data found');\n * }\n *\n * const connection = getSolanaConnection({\n * networkData,\n * });\n * ```\n * @not-instrumented\n */\nexport const getSolanaConnection = ({\n networkData,\n commitmentOrConfig,\n}: GetSolanaConnectionOptions) => {\n return new Connection(networkData.rpcUrls.http[0], commitmentOrConfig);\n};\n","import type { Transaction, VersionedTransaction } from '@solana/web3.js';\n\n/** @not-instrumented */\nexport const isVersionedTransaction = (\n transaction: VersionedTransaction | Transaction\n): transaction is VersionedTransaction => !('instructions' in transaction);\n","import type { WalletAccount } from '@dynamic-labs-sdk/client';\n\nimport type { SolanaWalletAccount } from '../SolanaWalletAccount.types';\n\n/**\n * Type guard function to check if a wallet account is a Solana wallet account.\n *\n * @param walletAccount - The wallet account to check.\n * @returns True if the wallet account is a Solana wallet account, false otherwise.\n * @not-instrumented\n */\nexport const isSolanaWalletAccount = (\n walletAccount: WalletAccount\n): walletAccount is SolanaWalletAccount => walletAccount.chain === 'SOL';\n","import {\n type DynamicClient,\n InvalidParamError,\n getActiveNetworkData,\n} from '@dynamic-labs-sdk/client';\nimport type { ConfirmTransactionParams } from '@dynamic-labs-sdk/client/core';\nimport { assertDefined } from '@dynamic-labs-sdk/client/core';\n\nimport { getSolanaConnection } from '../../getSolanaConnection';\nimport { isSolanaWalletAccount } from '../../isSolanaWalletAccount';\n\n/**\n * Waits for a Solana transaction to be confirmed on-chain.\n *\n * @param params.transactionHash - The transaction signature to wait for.\n * @param params.walletAccount - The Solana wallet account used to resolve the active network.\n * @param client - The Dynamic client instance.\n * @not-instrumented\n */\nexport const solanaConfirmTransaction = async (\n { transactionHash, walletAccount }: ConfirmTransactionParams,\n client: DynamicClient\n): Promise<void> => {\n if (!isSolanaWalletAccount(walletAccount)) {\n throw new InvalidParamError(\n 'Wallet account is not a Solana wallet account'\n );\n }\n\n const { networkData } = await getActiveNetworkData({ walletAccount }, client);\n\n assertDefined(\n networkData,\n `No network data found for wallet account ${walletAccount.address}`\n );\n\n const connection = getSolanaConnection({ networkData });\n\n const { blockhash, lastValidBlockHeight } =\n await connection.getLatestBlockhash();\n\n await connection.confirmTransaction({\n blockhash,\n lastValidBlockHeight,\n signature: transactionHash,\n });\n};\n","import type { WalletProvider } from '@dynamic-labs-sdk/client/core';\n\nimport type { SolanaWalletProvider } from '../SolanaWalletProvider.types';\n\n/** @not-instrumented */\nexport const isSolanaWalletProvider = (\n provider: WalletProvider\n): provider is SolanaWalletProvider => {\n return provider.chain === 'SOL';\n};\n","import { BaseError } from '@dynamic-labs-sdk/client';\n\nexport class NotSolanaProviderError extends BaseError {\n public readonly providerKey: string;\n\n constructor(params: { providerKey: string }) {\n super({\n cause: null,\n code: 'not_solana_provider_error',\n docsUrl: null,\n name: 'NotSolanaProviderError',\n shortMessage: 'Provider is not a Solana wallet provider',\n });\n\n this.providerKey = params.providerKey;\n }\n}\n","import { getDefaultClient } from '@dynamic-labs-sdk/client';\nimport { assertDefined } from '@dynamic-labs-sdk/client/core';\n\n/**\n * Checks if Solana gas sponsorship is enabled for the current project.\n *\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns True if Solana gas sponsorship is enabled, false otherwise.\n * @not-instrumented\n */\nexport const isSolanaGasSponsorshipEnabled = (\n client = getDefaultClient()\n): boolean => {\n assertDefined(client.projectSettings, 'Project settings are not defined');\n\n return (\n client.projectSettings.sdk.embeddedWallets?.svmGasSponsorshipEnabled ??\n false\n );\n};\n","import { getDefaultClient } from '@dynamic-labs-sdk/client';\nimport { getWalletProviderFromWalletAccount } from '@dynamic-labs-sdk/client/core';\nimport type {\n SendOptions,\n Transaction,\n VersionedTransaction,\n} from '@solana/web3.js';\n\nimport type { SolanaWalletAccount } from '../SolanaWalletAccount.types';\nimport { NotSolanaProviderError } from '../errors/NotSolanaProviderError';\nimport { isSolanaGasSponsorshipEnabled } from '../isSolanaGasSponsorshipEnabled';\nimport { isSolanaWalletProvider } from '../isSolanaWalletProvider';\n\ntype SignAndSendTransactionParams = {\n options?: SendOptions;\n /**\n * Controls whether Dynamic's gas sponsorship API is used to pay for this\n * transaction.\n *\n * - `'auto'` (default): the transaction is sponsored when Solana gas\n * sponsorship is enabled in project settings AND the walletAccount is a\n * Dynamic embedded wallet. Otherwise the user pays gas.\n * - `'off'`: the transaction is never sponsored, regardless of project\n * settings or provider capabilities. The user pays gas.\n *\n * To require sponsorship (and throw if unsupported), use\n * `signAndSendSponsoredTransaction` instead.\n *\n * @default 'auto'\n */\n sponsorshipMode?: 'auto' | 'off';\n transaction: Transaction | VersionedTransaction;\n walletAccount: SolanaWalletAccount;\n};\n\n/**\n * Signs and sends a Solana transaction, honoring the project's Solana gas\n * sponsorship setting.\n *\n * When solana gas sponsorship is enabled in project settings and sponsorship\n * is supported by the wallet provider, the transaction is routed through\n * Dynamic's gas sponsorship API.\n * Otherwise it falls back to the provider's standard `signAndSendTransaction`.\n *\n * @param params.transaction - The transaction to sign and send\n * @param params.walletAccount - The wallet account to sign and send the transaction with\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns An object containing the signature\n * @not-instrumented\n */\nexport const signAndSendTransaction = async (\n {\n walletAccount,\n transaction,\n sponsorshipMode = 'auto',\n options,\n }: SignAndSendTransactionParams,\n client = getDefaultClient()\n): Promise<{ signature: string }> => {\n const provider = getWalletProviderFromWalletAccount(\n {\n walletAccount,\n },\n client\n );\n\n if (!isSolanaWalletProvider(provider)) {\n throw new NotSolanaProviderError({ providerKey: provider.key });\n }\n\n if (\n sponsorshipMode === 'auto' &&\n isSolanaGasSponsorshipEnabled(client) &&\n provider.signAndSendSponsoredTransaction\n ) {\n return provider.signAndSendSponsoredTransaction({\n options,\n transaction,\n walletAccount,\n });\n }\n\n return provider.signAndSendTransaction({\n options,\n transaction,\n walletAccount,\n });\n};\n","import {\n type DynamicClient,\n InvalidParamError,\n} from '@dynamic-labs-sdk/client';\nimport type {\n ExecuteSwapTransactionParams,\n ExecuteSwapTransactionResult,\n} from '@dynamic-labs-sdk/client/core';\nimport {\n getBuffer,\n getWalletProviderFromWalletAccount,\n} from '@dynamic-labs-sdk/client/core';\nimport { Transaction, VersionedTransaction } from '@solana/web3.js';\n\nimport { isSolanaWalletAccount } from '../../isSolanaWalletAccount';\nimport { isSolanaWalletProvider } from '../../isSolanaWalletProvider';\nimport { signAndSendTransaction } from '../../signAndSendTransaction';\n\n/**\n * Executes a Solana checkout transaction by deserializing the base64-encoded\n * transaction and routing it through `signAndSendTransaction`, which applies\n * the project's gas sponsorship setting when enabled.\n *\n * 1. Validates that the wallet account is a Solana wallet account\n * 2. Extracts and validates the serialized transaction from the signing payload\n * 3. Deserializes the transaction (tries VersionedTransaction first, falls back to Transaction)\n * 4. Signs and sends via `signAndSendTransaction` (sponsored when project settings opt in)\n *\n * @param params.signingPayload - The signing payload containing `serializedTransaction`.\n * @param params.walletAccount - The wallet account used to sign and send the transaction.\n * @param params.onStepChange - Optional callback invoked with `'transaction'` when the send step begins.\n * @param params.sponsorshipMode - `'auto'` (default) sponsors when eligible; `'off'` never sponsors.\n * @param client - The Dynamic client instance.\n * @returns The transaction hash (signature).\n * @not-instrumented\n */\nexport const solanaExecuteSwapTransaction = async (\n {\n onStepChange,\n signingPayload,\n sponsorshipMode = 'auto',\n walletAccount,\n }: ExecuteSwapTransactionParams,\n client: DynamicClient\n): Promise<ExecuteSwapTransactionResult> => {\n const walletProvider = getWalletProviderFromWalletAccount(\n { walletAccount },\n client\n );\n\n if (\n !isSolanaWalletAccount(walletAccount) ||\n !isSolanaWalletProvider(walletProvider)\n ) {\n throw new InvalidParamError(\n 'Wallet account is not a Solana wallet account'\n );\n }\n\n const serializedTransactionData = signingPayload.serializedTransaction;\n\n if (!serializedTransactionData) {\n throw new InvalidParamError(\n 'Signing payload is missing serialized transaction data'\n );\n }\n\n const bytes = new Uint8Array(\n getBuffer().from(serializedTransactionData, 'base64')\n );\n\n let transaction: Transaction | VersionedTransaction;\n\n // Try VersionedTransaction first, fall back to legacy Transaction\n try {\n transaction = VersionedTransaction.deserialize(bytes);\n } catch {\n transaction = Transaction.from(bytes);\n }\n\n onStepChange?.('transaction');\n\n const { signature } = await signAndSendTransaction(\n {\n sponsorshipMode,\n transaction,\n walletAccount,\n },\n client\n );\n\n return { transactionHash: signature };\n};\n","import {\n type DynamicClient,\n InvalidParamError,\n getActiveNetworkData,\n} from '@dynamic-labs-sdk/client';\nimport type { TransferAmountParams } from '@dynamic-labs-sdk/client/core';\nimport {\n assertDefined,\n getWalletProviderFromWalletAccount,\n parseAmountToSmallestUnit,\n} from '@dynamic-labs-sdk/client/core';\nimport {\n TOKEN_2022_PROGRAM_ID,\n TOKEN_PROGRAM_ID,\n createAssociatedTokenAccountInstruction,\n createTransferCheckedInstruction,\n getAssociatedTokenAddress,\n} from '@solana/spl-token';\nimport type { TransactionInstruction } from '@solana/web3.js';\nimport {\n PublicKey,\n SystemProgram,\n TransactionMessage,\n VersionedTransaction,\n} from '@solana/web3.js';\n\nimport { NotSolanaProviderError } from '../../errors/NotSolanaProviderError';\nimport { getSolanaConnection } from '../../getSolanaConnection';\nimport { isSolanaWalletAccount } from '../../isSolanaWalletAccount';\nimport { isSolanaWalletProvider } from '../../isSolanaWalletProvider';\nimport { signAndSendTransaction } from '../../signAndSendTransaction';\nconst DEFAULT_DECIMALS = 9;\n\n/**\n * Transfers native SOL or SPL tokens from one wallet to another.\n *\n * For native SOL, builds a `SystemProgram.transfer` instruction.\n * For SPL tokens, derives associated token accounts, creates the recipient\n * ATA if needed, and builds a `transferChecked` instruction. Supports both\n * standard SPL tokens and Token-2022 tokens by detecting the mint's program.\n * @not-instrumented\n */\nexport const solanaTransferAmount = async (\n { amount, recipient, token, walletAccount }: TransferAmountParams,\n client: DynamicClient\n): Promise<{ transactionHash: string }> => {\n if (!isSolanaWalletAccount(walletAccount)) {\n throw new InvalidParamError(\n 'Wallet account is not a Solana wallet account'\n );\n }\n\n const provider = getWalletProviderFromWalletAccount(\n { walletAccount },\n client\n );\n\n if (!isSolanaWalletProvider(provider)) {\n throw new NotSolanaProviderError({ providerKey: provider.key });\n }\n\n const { networkData } = await getActiveNetworkData({ walletAccount }, client);\n assertDefined(networkData, 'Network data is required');\n\n const connection = getSolanaConnection({ networkData });\n\n const fromPubkey = new PublicKey(walletAccount.address);\n const toPubkey = new PublicKey(recipient);\n\n let instructions: TransactionInstruction[];\n\n if (token) {\n const decimals = token.decimals ?? DEFAULT_DECIMALS;\n const mintPubkey = new PublicKey(token.address);\n\n // Detect Token-2022 vs standard SPL by checking mint account owner\n const mintAccountInfo = await connection.getAccountInfo(mintPubkey);\n const tokenProgramId = mintAccountInfo?.owner.equals(TOKEN_2022_PROGRAM_ID)\n ? TOKEN_2022_PROGRAM_ID\n : TOKEN_PROGRAM_ID;\n\n const senderAta = await getAssociatedTokenAddress(\n mintPubkey,\n fromPubkey,\n false,\n tokenProgramId\n );\n\n const recipientAta = await getAssociatedTokenAddress(\n mintPubkey,\n toPubkey,\n false,\n tokenProgramId\n );\n\n const recipientAccountInfo = await connection.getAccountInfo(recipientAta);\n\n const rawAmount = parseAmountToSmallestUnit({ amount, decimals });\n\n instructions = [];\n\n if (!recipientAccountInfo) {\n instructions.push(\n createAssociatedTokenAccountInstruction(\n fromPubkey,\n recipientAta,\n toPubkey,\n mintPubkey,\n tokenProgramId\n )\n );\n }\n\n instructions.push(\n createTransferCheckedInstruction(\n senderAta,\n mintPubkey,\n recipientAta,\n fromPubkey,\n rawAmount,\n decimals,\n [],\n tokenProgramId\n )\n );\n } else {\n instructions = [\n SystemProgram.transfer({\n fromPubkey,\n lamports: parseAmountToSmallestUnit({ amount, decimals: DEFAULT_DECIMALS }),\n toPubkey,\n }),\n ];\n }\n\n const { blockhash } = await connection.getLatestBlockhash('finalized');\n\n const message = new TransactionMessage({\n instructions,\n payerKey: fromPubkey,\n recentBlockhash: blockhash,\n }).compileToV0Message();\n\n const transaction = new VersionedTransaction(message);\n\n const { signature } = await signAndSendTransaction(\n { transaction, walletAccount },\n client\n );\n\n return { transactionHash: signature };\n};\n"],"mappings":"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"}