@dynamic-labs/solana-core 5.9.4 → 5.9.6

package/CHANGELOG.md

@@ -1,4 +1,15 @@
 
+### [5.9.6](https://github.com/dynamic-labs/dynamic-auth/compare/v5.9.5...v5.9.6) (2026-10-06)
+
+### [5.9.5](https://github.com/dynamic-labs/dynamic-auth/compare/v5.9.4...v5.9.5) (2026-10-06)
+
+
+### Bug Fixes
+
+* **ton:** move encodeComment to base TonWalletConnector ([#12459](https://github.com/dynamic-labs/dynamic-auth/issues/12459)) ([647df5b](https://github.com/dynamic-labs/dynamic-auth/commit/647df5bc3986d59d89dbe31bbd3ebe1c4605ec40))
+* **waas-svm:** apply overrideBlockhash before sponsorship ([#12319](https://github.com/dynamic-labs/dynamic-auth/issues/12319)) ([074ce3c](https://github.com/dynamic-labs/dynamic-auth/commit/074ce3c4ecfa080b683c84120fa7643e8fe064d4)), closes [#10599](https://github.com/dynamic-labs/dynamic-auth/issues/10599) [#10599](https://github.com/dynamic-labs/dynamic-auth/issues/10599) [#10599](https://github.com/dynamic-labs/dynamic-auth/issues/10599) [#10599](https://github.com/dynamic-labs/dynamic-auth/issues/10599)
+* **wallet-book:** use phantom.com for Phantom in-app-browser links ([#12456](https://github.com/dynamic-labs/dynamic-auth/issues/12456)) ([e762553](https://github.com/dynamic-labs/dynamic-auth/commit/e7625534f8beda3e649f121e637451e2188faef6))
+
 ### [5.9.4](https://github.com/dynamic-labs/dynamic-auth/compare/v5.9.3...v5.9.4) (2026-10-02)
 
 ### [5.9.3](https://github.com/dynamic-labs/dynamic-auth/compare/v5.9.2...v5.9.3) (2026-10-02)

package/package.cjs

@@ -3,6 +3,6 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = "5.9.4";
+var version = "5.9.6";
 
 exports.version = version;

package/package.js

@@ -1,4 +1,4 @@
 'use client'
-var version = "5.9.4";
+var version = "5.9.6";
 
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/solana-core",
-  "version": "5.9.4",
+  "version": "5.9.6",
   "description": "Core package for utilities and types for solana",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -19,14 +19,14 @@
   "homepage": "https://www.dynamic.xyz/",
   "dependencies": {
     "@dynamic-labs/sdk-api-core": "0.70.0",
-    "@dynamic-labs/utils": "5.9.4",
+    "@dynamic-labs/utils": "5.9.6",
     "@solana/web3.js": "1.98.1",
     "@solana/spl-token": "0.4.14",
-    "@dynamic-labs/assert-package-version": "5.9.4",
-    "@dynamic-labs/rpc-providers": "5.9.4",
-    "@dynamic-labs/types": "5.9.4",
-    "@dynamic-labs/wallet-book": "5.9.4",
-    "@dynamic-labs/wallet-connector-core": "5.9.4",
+    "@dynamic-labs/assert-package-version": "5.9.6",
+    "@dynamic-labs/rpc-providers": "5.9.6",
+    "@dynamic-labs/types": "5.9.6",
+    "@dynamic-labs/wallet-book": "5.9.6",
+    "@dynamic-labs/wallet-connector-core": "5.9.6",
     "eventemitter3": "5.0.1"
   },
   "peerDependencies": {}

package/src/connector/SolanaWalletConnector.cjs

@@ -25,6 +25,9 @@ class SolanaWalletConnector extends walletConnectorCore.WalletConnectorBase {
         this.ChainWallet = SolanaWallet.SolanaWallet;
         this.supportedChains = ['SOL'];
         this.connectedChain = 'SOL';
+        // Whether the connector can sponsor Solana transactions (overridden by
+        // connectors with a sponsorship implementation, e.g. WaaS SVM)
+        this.supportsSvmGasSponsorship = false;
         this.solNetworks = getBackwardsCompatibleSolNetworks.getBackwardsCompatibleSolNetworks(opts.solNetworks, opts.connectionConfig);
         this.chainRpcProviders = opts.chainRpcProviders;
         this.connectionConfig = opts.connectionConfig;

package/src/connector/SolanaWalletConnector.d.ts

@@ -23,6 +23,7 @@ export declare abstract class SolanaWalletConnector extends WalletConnectorBase<
     ChainWallet: typeof SolanaWallet;
     supportedChains: Chain[];
     connectedChain: Chain;
+    readonly supportsSvmGasSponsorship: boolean;
     protected connectionConfig: SolanaConnectionConfig | undefined;
     constructor(opts: SolanaWalletConnectorOpts);
     getNetworkId(): string;

package/src/connector/SolanaWalletConnector.js

@@ -21,6 +21,9 @@ class SolanaWalletConnector extends WalletConnectorBase {
         this.ChainWallet = SolanaWallet;
         this.supportedChains = ['SOL'];
         this.connectedChain = 'SOL';
+        // Whether the connector can sponsor Solana transactions (overridden by
+        // connectors with a sponsorship implementation, e.g. WaaS SVM)
+        this.supportsSvmGasSponsorship = false;
         this.solNetworks = getBackwardsCompatibleSolNetworks(opts.solNetworks, opts.connectionConfig);
         this.chainRpcProviders = opts.chainRpcProviders;
         this.connectionConfig = opts.connectionConfig;

package/src/index.d.ts

@@ -3,4 +3,4 @@ export * from './rpc';
 export * from './utils';
 export * from './wallet';
 export { SOLANA_GENESIS_HASH, DYNAMIC_SVM_NETWORK_ID_LS_KEY, } from './constants';
-export type { ConnectionResult, ExtensionLocator, ISolana, IBackpackSolanaSigner, SignedMessage, ISolanaSigner, SolanaConnectionConfig, ISolanaEvents, } from './types';
+export type { ConnectionResult, ExtensionLocator, ISolana, IBackpackSolanaSigner, SignedMessage, ISolanaSigner, GasSponsorshipMode, SolanaSendOptions, SolanaTransactionOptions, SolanaConnectionConfig, ISolanaEvents, } from './types';

package/src/types.d.ts

@@ -32,6 +32,11 @@ export interface ISolanaEvents {
 export type SignedMessage = {
     signature: Uint8Array;
 };
+export type GasSponsorshipMode = 'auto' | 'off' | 'required';
+export type SolanaTransactionOptions = {
+    sponsorshipMode?: GasSponsorshipMode;
+};
+export type SolanaSendOptions = SendOptions & SolanaTransactionOptions;
 type ExtensionLocators = {
     [key in ExtensionLocator]: boolean;
 };
@@ -41,9 +46,9 @@ export type ISolanaSigner = ExtensionLocators & EventEmitter<ISolanaEvents> & {
     };
     isConnected: boolean;
     providers: ISolanaSigner[];
-    signTransaction<T extends Transaction | VersionedTransaction>(transaction: T): Promise<T>;
-    signAllTransactions<T extends Transaction | VersionedTransaction>(transactions: T[]): Promise<T[]>;
-    signAndSendTransaction<T extends Transaction | VersionedTransaction>(transaction: T, options?: SendOptions): Promise<{
+    signTransaction<T extends Transaction | VersionedTransaction>(transaction: T, options?: SolanaTransactionOptions): Promise<T>;
+    signAllTransactions<T extends Transaction | VersionedTransaction>(transactions: T[], options?: SolanaTransactionOptions): Promise<T[]>;
+    signAndSendTransaction<T extends Transaction | VersionedTransaction>(transaction: T, options?: SolanaSendOptions): Promise<{
         signature: TransactionSignature;
     }>;
     signMessage(message: Uint8Array, encoding?: string): Promise<SignedMessage>;

package/src/utils/SolanaUiTransaction/SolanaUiTransaction.cjs

@@ -10,7 +10,7 @@ var utils = require('@dynamic-labs/utils');
 
 const LAMPORTS_PER_SOL = 1000000000;
 class SolanaUiTransaction {
-    constructor({ onSubmit, from, connection, multipleTransactions, }) {
+    constructor({ onSubmit, from, connection, multipleTransactions, sponsorshipMode, }) {
         this.chain = 'SOL';
         this.data = undefined;
         this.fee = { gas: undefined };
@@ -19,6 +19,7 @@ class SolanaUiTransaction {
         this.onSubmit = onSubmit;
         this.connection = connection;
         this.multipleTransactions = multipleTransactions;
+        this.sponsorshipMode = sponsorshipMode;
     }
     fetchFee() {
         return _tslib.__awaiter(this, void 0, void 0, function* () {

package/src/utils/SolanaUiTransaction/SolanaUiTransaction.d.ts

@@ -1,11 +1,13 @@
 import { Connection, Transaction, VersionedTransaction } from '@solana/web3.js';
 import { IUITransaction, IUITransactionFormatOptions } from '@dynamic-labs/types';
+import { GasSponsorshipMode } from '../../types';
 export declare const LAMPORTS_PER_SOL = 1000000000;
 type SolanaUiTransactionProps = {
     from: string;
     connection: Connection;
     onSubmit: (transaction?: Transaction | VersionedTransaction) => Promise<any>;
     multipleTransactions?: (Transaction | VersionedTransaction)[];
+    sponsorshipMode?: GasSponsorshipMode;
 };
 export declare class SolanaUiTransaction implements IUITransaction {
     to: string | undefined;
@@ -21,9 +23,10 @@ export declare class SolanaUiTransaction implements IUITransaction {
     nonNativeAddress?: string;
     nonNativeDecimal?: number;
     nonNativeValue?: bigint;
+    sponsorshipMode?: GasSponsorshipMode;
     private onSubmit;
     private connection;
-    constructor({ onSubmit, from, connection, multipleTransactions, }: SolanaUiTransactionProps);
+    constructor({ onSubmit, from, connection, multipleTransactions, sponsorshipMode, }: SolanaUiTransactionProps);
     nativePrice?: number | undefined;
     fetchFee(): Promise<void>;
     isGasSponsored(): boolean;

package/src/utils/SolanaUiTransaction/SolanaUiTransaction.js

@@ -6,7 +6,7 @@ import { formatNumberText } from '@dynamic-labs/utils';
 
 const LAMPORTS_PER_SOL = 1000000000;
 class SolanaUiTransaction {
-    constructor({ onSubmit, from, connection, multipleTransactions, }) {
+    constructor({ onSubmit, from, connection, multipleTransactions, sponsorshipMode, }) {
         this.chain = 'SOL';
         this.data = undefined;
         this.fee = { gas: undefined };
@@ -15,6 +15,7 @@ class SolanaUiTransaction {
         this.onSubmit = onSubmit;
         this.connection = connection;
         this.multipleTransactions = multipleTransactions;
+        this.sponsorshipMode = sponsorshipMode;
     }
     fetchFee() {
         return __awaiter(this, void 0, void 0, function* () {

package/src/wallet/SolanaWallet.cjs

@@ -78,6 +78,12 @@ class SolanaWallet extends walletConnectorCore.Wallet {
             return signature;
         });
     }
+    assertSponsorshipSupported(options) {
+        if ((options === null || options === void 0 ? void 0 : options.sponsorshipMode) === 'required' &&
+            !this._connector.supportsSvmGasSponsorship) {
+            throw new utils.DynamicError('This wallet does not support gas sponsorship', 'sponsorship_not_supported');
+        }
+    }
     /**
      * Retrieves the RPC connection
      * @returns A promise that resolves to the RPC connection
@@ -100,35 +106,50 @@ class SolanaWallet extends walletConnectorCore.Wallet {
             }
             try {
                 return utils.cloneObjectWithOverrides(signer, {
-                    signAllTransactions: (transactions) => _tslib.__awaiter(this, void 0, void 0, function* () {
+                    signAllTransactions: (transactions, options) => _tslib.__awaiter(this, void 0, void 0, function* () {
+                        this.assertSponsorshipSupported(options);
                         yield this.sync();
                         yield screenSolanaTransactions.screenSolanaTransactions({
                             senderAddress: this.address,
                             transactionScreening: this._connector.transactionScreening,
                             transactions,
                         });
+                        if (options) {
+                            return signer.signAllTransactions(transactions, options);
+                        }
                         return signer.signAllTransactions(transactions);
                     }),
-                    signAndSendTransaction: (transaction, ...args) => _tslib.__awaiter(this, void 0, void 0, function* () {
+                    signAndSendTransaction: (transaction, options) => _tslib.__awaiter(this, void 0, void 0, function* () {
+                        this.assertSponsorshipSupported(options);
                         yield this.sync();
                         yield screenSolanaTransactions.screenSolanaTransactions({
                             senderAddress: this.address,
                             transactionScreening: this._connector.transactionScreening,
                             transactions: [transaction],
                         });
-                        return signer.signAndSendTransaction(transaction, ...args);
+                        if (options) {
+                            return signer.signAndSendTransaction(transaction, options);
+                        }
+                        return signer.signAndSendTransaction(transaction);
                     }),
-                    signMessage: (message, ...args) => _tslib.__awaiter(this, void 0, void 0, function* () {
+                    signMessage: (message, encoding) => _tslib.__awaiter(this, void 0, void 0, function* () {
                         yield this.sync();
-                        return signer.signMessage(message, ...args);
+                        if (encoding) {
+                            return signer.signMessage(message, encoding);
+                        }
+                        return signer.signMessage(message);
                     }),
-                    signTransaction: (transaction) => _tslib.__awaiter(this, void 0, void 0, function* () {
+                    signTransaction: (transaction, options) => _tslib.__awaiter(this, void 0, void 0, function* () {
+                        this.assertSponsorshipSupported(options);
                         yield this.sync();
                         yield screenSolanaTransactions.screenSolanaTransactions({
                             senderAddress: this.address,
                             transactionScreening: this._connector.transactionScreening,
                             transactions: [transaction],
                         });
+                        if (options) {
+                            return signer.signTransaction(transaction, options);
+                        }
                         return signer.signTransaction(transaction);
                     }),
                 });

package/src/wallet/SolanaWallet.d.ts

@@ -29,6 +29,7 @@ export declare class SolanaWallet extends Wallet<SolanaWalletConnector> {
     createAssociatedTokenAccount({ tokenAddress, }: {
         tokenAddress: string;
     }): Promise<string | undefined>;
+    private assertSponsorshipSupported;
     /**
      * Retrieves the RPC connection
      * @returns A promise that resolves to the RPC connection

package/src/wallet/SolanaWallet.js

@@ -1,7 +1,7 @@
 'use client'
 import { __awaiter } from '../../_virtual/_tslib.js';
 import { Wallet, logger } from '@dynamic-labs/wallet-connector-core';
-import { cloneObjectWithOverrides } from '@dynamic-labs/utils';
+import { DynamicError, cloneObjectWithOverrides } from '@dynamic-labs/utils';
 import '@solana/web3.js';
 import '@solana/spl-token';
 import { createNonNativeTokenTransfer } from '../utils/createNonNativeTokenTransfer/createNonNativeTokenTransfer.js';
@@ -74,6 +74,12 @@ class SolanaWallet extends Wallet {
             return signature;
         });
     }
+    assertSponsorshipSupported(options) {
+        if ((options === null || options === void 0 ? void 0 : options.sponsorshipMode) === 'required' &&
+            !this._connector.supportsSvmGasSponsorship) {
+            throw new DynamicError('This wallet does not support gas sponsorship', 'sponsorship_not_supported');
+        }
+    }
     /**
      * Retrieves the RPC connection
      * @returns A promise that resolves to the RPC connection
@@ -96,35 +102,50 @@ class SolanaWallet extends Wallet {
             }
             try {
                 return cloneObjectWithOverrides(signer, {
-                    signAllTransactions: (transactions) => __awaiter(this, void 0, void 0, function* () {
+                    signAllTransactions: (transactions, options) => __awaiter(this, void 0, void 0, function* () {
+                        this.assertSponsorshipSupported(options);
                         yield this.sync();
                         yield screenSolanaTransactions({
                             senderAddress: this.address,
                             transactionScreening: this._connector.transactionScreening,
                             transactions,
                         });
+                        if (options) {
+                            return signer.signAllTransactions(transactions, options);
+                        }
                         return signer.signAllTransactions(transactions);
                     }),
-                    signAndSendTransaction: (transaction, ...args) => __awaiter(this, void 0, void 0, function* () {
+                    signAndSendTransaction: (transaction, options) => __awaiter(this, void 0, void 0, function* () {
+                        this.assertSponsorshipSupported(options);
                         yield this.sync();
                         yield screenSolanaTransactions({
                             senderAddress: this.address,
                             transactionScreening: this._connector.transactionScreening,
                             transactions: [transaction],
                         });
-                        return signer.signAndSendTransaction(transaction, ...args);
+                        if (options) {
+                            return signer.signAndSendTransaction(transaction, options);
+                        }
+                        return signer.signAndSendTransaction(transaction);
                     }),
-                    signMessage: (message, ...args) => __awaiter(this, void 0, void 0, function* () {
+                    signMessage: (message, encoding) => __awaiter(this, void 0, void 0, function* () {
                         yield this.sync();
-                        return signer.signMessage(message, ...args);
+                        if (encoding) {
+                            return signer.signMessage(message, encoding);
+                        }
+                        return signer.signMessage(message);
                     }),
-                    signTransaction: (transaction) => __awaiter(this, void 0, void 0, function* () {
+                    signTransaction: (transaction, options) => __awaiter(this, void 0, void 0, function* () {
+                        this.assertSponsorshipSupported(options);
                         yield this.sync();
                         yield screenSolanaTransactions({
                             senderAddress: this.address,
                             transactionScreening: this._connector.transactionScreening,
                             transactions: [transaction],
                         });
+                        if (options) {
+                            return signer.signTransaction(transaction, options);
+                        }
                         return signer.signTransaction(transaction);
                     }),
                 });