@dynamic-labs/solana-core 4.98.0 → 4.99.0

package/CHANGELOG.md

@@ -1,4 +1,18 @@
 
+## [4.99.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.98.0...v4.99.0) (2026-09-10)
+
+
+### Features
+
+* **solana-core:** standalone sponsored ATA creation [v4 backport] ([#12366](https://github.com/dynamic-labs/dynamic-auth/issues/12366)) ([46d86c9](https://github.com/dynamic-labs/dynamic-auth/commit/46d86c9a1a04c45bf045acc5c6df792dcd4b3590))
+
+
+### Bug Fixes
+
+* do not report wallets installed from a provider selection router (v4) ([#12341](https://github.com/dynamic-labs/dynamic-auth/issues/12341)) ([6b02087](https://github.com/dynamic-labs/dynamic-auth/commit/6b02087685545bb6f672eb9040316d01489c82f4))
+* **screening:** soften the blocked-wallet copy to be provider-neutral (v4) ([#12359](https://github.com/dynamic-labs/dynamic-auth/issues/12359)) ([d6772df](https://github.com/dynamic-labs/dynamic-auth/commit/d6772dfc1419811bfbc1d9cb1db58fe12274d397))
+* **waas:** detach the superseded WaaS client from the iframe reverse channel (v4) ([#12349](https://github.com/dynamic-labs/dynamic-auth/issues/12349)) ([393253d](https://github.com/dynamic-labs/dynamic-auth/commit/393253d9e5934e039e21b85ed6ceded760e0f225)), closes [#11766](https://github.com/dynamic-labs/dynamic-auth/issues/11766) [#12348](https://github.com/dynamic-labs/dynamic-auth/issues/12348)
+
 ## [4.98.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.97.0...v4.98.0) (2026-09-02)
 
 

package/package.cjs

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

package/package.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/solana-core",
-  "version": "4.98.0",
+  "version": "4.99.0",
   "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.12.0",
-    "@dynamic-labs/utils": "4.98.0",
+    "@dynamic-labs/utils": "4.99.0",
     "@solana/web3.js": "1.98.1",
     "@solana/spl-token": "0.4.14",
-    "@dynamic-labs/assert-package-version": "4.98.0",
-    "@dynamic-labs/rpc-providers": "4.98.0",
-    "@dynamic-labs/types": "4.98.0",
-    "@dynamic-labs/wallet-book": "4.98.0",
-    "@dynamic-labs/wallet-connector-core": "4.98.0",
+    "@dynamic-labs/assert-package-version": "4.99.0",
+    "@dynamic-labs/rpc-providers": "4.99.0",
+    "@dynamic-labs/types": "4.99.0",
+    "@dynamic-labs/wallet-book": "4.99.0",
+    "@dynamic-labs/wallet-connector-core": "4.99.0",
     "eventemitter3": "5.0.1"
   },
   "peerDependencies": {}

package/src/index.cjs

@@ -17,6 +17,7 @@ var getGenesisHashLSKey = require('./utils/getGenesisHashLSKey/getGenesisHashLSK
 var isTransactionSigned = require('./utils/isTransactionSigned/isTransactionSigned.cjs');
 var getOverrideRpcUrlForNetwork = require('./utils/getOverrideRpcUrlForNetwork/getOverrideRpcUrlForNetwork.cjs');
 var createNonNativeTokenTransfer = require('./utils/createNonNativeTokenTransfer/createNonNativeTokenTransfer.cjs');
+var createAssociatedTokenAccountTransaction = require('./utils/createAssociatedTokenAccountTransaction/createAssociatedTokenAccountTransaction.cjs');
 var createSolTransfer = require('./utils/createSolTransfer/createSolTransfer.cjs');
 var getBackwardsCompatibleSolNetworks = require('./utils/getBackwardsCompatibleSolNetworks/getBackwardsCompatibleSolNetworks.cjs');
 var serializeTransactionForScreening = require('./utils/serializeTransactionForScreening/serializeTransactionForScreening.cjs');
@@ -38,6 +39,7 @@ exports.getGenesisHashLSKey = getGenesisHashLSKey.getGenesisHashLSKey;
 exports.isTxAlreadySigned = isTransactionSigned.isTxAlreadySigned;
 exports.getOverrideRpcUrlForNetwork = getOverrideRpcUrlForNetwork.getOverrideRpcUrlForNetwork;
 exports.createNonNativeTokenTransfer = createNonNativeTokenTransfer.createNonNativeTokenTransfer;
+exports.createAssociatedTokenAccountTransaction = createAssociatedTokenAccountTransaction.createAssociatedTokenAccountTransaction;
 exports.createSolTransfer = createSolTransfer.createSolTransfer;
 exports.getBackwardsCompatibleSolNetworks = getBackwardsCompatibleSolNetworks.getBackwardsCompatibleSolNetworks;
 exports.serializeTransactionForScreening = serializeTransactionForScreening.serializeTransactionForScreening;

package/src/index.js

@@ -13,6 +13,7 @@ export { getGenesisHashLSKey } from './utils/getGenesisHashLSKey/getGenesisHashL
 export { isTxAlreadySigned } from './utils/isTransactionSigned/isTransactionSigned.js';
 export { getOverrideRpcUrlForNetwork } from './utils/getOverrideRpcUrlForNetwork/getOverrideRpcUrlForNetwork.js';
 export { createNonNativeTokenTransfer } from './utils/createNonNativeTokenTransfer/createNonNativeTokenTransfer.js';
+export { createAssociatedTokenAccountTransaction } from './utils/createAssociatedTokenAccountTransaction/createAssociatedTokenAccountTransaction.js';
 export { createSolTransfer } from './utils/createSolTransfer/createSolTransfer.js';
 export { getBackwardsCompatibleSolNetworks } from './utils/getBackwardsCompatibleSolNetworks/getBackwardsCompatibleSolNetworks.js';
 export { serializeTransactionForScreening } from './utils/serializeTransactionForScreening/serializeTransactionForScreening.js';

package/src/utils/createAssociatedTokenAccountTransaction/createAssociatedTokenAccountTransaction.cjs

@@ -0,0 +1,40 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../_virtual/_tslib.cjs');
+var splToken = require('@solana/spl-token');
+var web3_js = require('@solana/web3.js');
+
+/**
+ * Builds a standalone transaction that creates the owner's associated token
+ * account for the given mint, if it doesn't already exist — returns
+ * undefined (no transaction to send) when it's already there. Kept separate
+ * from any transfer/swap instructions so it can be sponsored and sent on its
+ * own, without competing for space in an already-large transaction.
+ */
+const createAssociatedTokenAccountTransaction = (_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ connection, ownerAddress, tokenAddress, blockhash, lastValidBlockHeight, }) {
+    const ownerPublicKey = new web3_js.PublicKey(ownerAddress);
+    const tokenPublicKey = new web3_js.PublicKey(tokenAddress);
+    const mintAccountInfo = yield connection.getAccountInfo(tokenPublicKey);
+    const tokenProgramId = mintAccountInfo && mintAccountInfo.owner.equals(splToken.TOKEN_2022_PROGRAM_ID)
+        ? splToken.TOKEN_2022_PROGRAM_ID
+        : splToken.TOKEN_PROGRAM_ID;
+    const associatedTokenAddress = yield splToken.getAssociatedTokenAddress(tokenPublicKey, ownerPublicKey, false, tokenProgramId);
+    try {
+        yield connection.getTokenAccountBalance(associatedTokenAddress);
+        // Already exists — nothing to do.
+        return undefined;
+    }
+    catch (_b) {
+        // Doesn't exist yet — build the create instruction below.
+    }
+    const transaction = new web3_js.Transaction().add(splToken.createAssociatedTokenAccountIdempotentInstruction(ownerPublicKey, associatedTokenAddress, ownerPublicKey, tokenPublicKey, tokenProgramId));
+    transaction.recentBlockhash = blockhash;
+    transaction.lastValidBlockHeight = lastValidBlockHeight;
+    transaction.feePayer = ownerPublicKey;
+    return transaction;
+});
+
+exports.createAssociatedTokenAccountTransaction = createAssociatedTokenAccountTransaction;

package/src/utils/createAssociatedTokenAccountTransaction/createAssociatedTokenAccountTransaction.d.ts

@@ -0,0 +1,15 @@
+import { Connection, Transaction } from '@solana/web3.js';
+/**
+ * Builds a standalone transaction that creates the owner's associated token
+ * account for the given mint, if it doesn't already exist — returns
+ * undefined (no transaction to send) when it's already there. Kept separate
+ * from any transfer/swap instructions so it can be sponsored and sent on its
+ * own, without competing for space in an already-large transaction.
+ */
+export declare const createAssociatedTokenAccountTransaction: ({ connection, ownerAddress, tokenAddress, blockhash, lastValidBlockHeight, }: {
+    connection: Connection;
+    ownerAddress: string;
+    tokenAddress: string;
+    blockhash: string;
+    lastValidBlockHeight: number;
+}) => Promise<Transaction | undefined>;

package/src/utils/createAssociatedTokenAccountTransaction/createAssociatedTokenAccountTransaction.js

@@ -0,0 +1,36 @@
+'use client'
+import { __awaiter } from '../../../_virtual/_tslib.js';
+import { TOKEN_2022_PROGRAM_ID, TOKEN_PROGRAM_ID, getAssociatedTokenAddress, createAssociatedTokenAccountIdempotentInstruction } from '@solana/spl-token';
+import { PublicKey, Transaction } from '@solana/web3.js';
+
+/**
+ * Builds a standalone transaction that creates the owner's associated token
+ * account for the given mint, if it doesn't already exist — returns
+ * undefined (no transaction to send) when it's already there. Kept separate
+ * from any transfer/swap instructions so it can be sponsored and sent on its
+ * own, without competing for space in an already-large transaction.
+ */
+const createAssociatedTokenAccountTransaction = (_a) => __awaiter(void 0, [_a], void 0, function* ({ connection, ownerAddress, tokenAddress, blockhash, lastValidBlockHeight, }) {
+    const ownerPublicKey = new PublicKey(ownerAddress);
+    const tokenPublicKey = new PublicKey(tokenAddress);
+    const mintAccountInfo = yield connection.getAccountInfo(tokenPublicKey);
+    const tokenProgramId = mintAccountInfo && mintAccountInfo.owner.equals(TOKEN_2022_PROGRAM_ID)
+        ? TOKEN_2022_PROGRAM_ID
+        : TOKEN_PROGRAM_ID;
+    const associatedTokenAddress = yield getAssociatedTokenAddress(tokenPublicKey, ownerPublicKey, false, tokenProgramId);
+    try {
+        yield connection.getTokenAccountBalance(associatedTokenAddress);
+        // Already exists — nothing to do.
+        return undefined;
+    }
+    catch (_b) {
+        // Doesn't exist yet — build the create instruction below.
+    }
+    const transaction = new Transaction().add(createAssociatedTokenAccountIdempotentInstruction(ownerPublicKey, associatedTokenAddress, ownerPublicKey, tokenPublicKey, tokenProgramId));
+    transaction.recentBlockhash = blockhash;
+    transaction.lastValidBlockHeight = lastValidBlockHeight;
+    transaction.feePayer = ownerPublicKey;
+    return transaction;
+});
+
+export { createAssociatedTokenAccountTransaction };

package/src/utils/createAssociatedTokenAccountTransaction/index.d.ts

@@ -0,0 +1 @@
+export { createAssociatedTokenAccountTransaction } from './createAssociatedTokenAccountTransaction';

package/src/utils/index.d.ts

@@ -6,6 +6,7 @@ export { getGenesisHashLSKey } from './getGenesisHashLSKey';
 export { isTxAlreadySigned } from './isTransactionSigned';
 export { getOverrideRpcUrlForNetwork } from './getOverrideRpcUrlForNetwork';
 export { createNonNativeTokenTransfer } from './createNonNativeTokenTransfer';
+export { createAssociatedTokenAccountTransaction } from './createAssociatedTokenAccountTransaction';
 export { createSolTransfer } from './createSolTransfer';
 export { getBackwardsCompatibleSolNetworks } from './getBackwardsCompatibleSolNetworks';
 export { serializeTransactionForScreening } from './serializeTransactionForScreening';

package/src/wallet/SolanaWallet.cjs

@@ -9,6 +9,7 @@ var utils = require('@dynamic-labs/utils');
 require('@solana/web3.js');
 require('@solana/spl-token');
 var createNonNativeTokenTransfer = require('../utils/createNonNativeTokenTransfer/createNonNativeTokenTransfer.cjs');
+var createAssociatedTokenAccountTransaction = require('../utils/createAssociatedTokenAccountTransaction/createAssociatedTokenAccountTransaction.cjs');
 var createSolTransfer = require('../utils/createSolTransfer/createSolTransfer.cjs');
 var screenSolanaTransactions = require('../utils/screenSolanaTransactions/screenSolanaTransactions.cjs');
 
@@ -49,6 +50,34 @@ class SolanaWallet extends walletConnectorCore.Wallet {
             return signature;
         });
     }
+    /**
+     * Creates the wallet's associated token account for the given mint, as its
+     * own standalone (sponsorable) transaction, if it doesn't already exist —
+     * returns undefined without signing or sending anything when it's already
+     * there. Kept separate from sendBalance/swap flows so it doesn't compete
+     * for space with other instructions in an already-large transaction.
+     * @param tokenAddress - The mint address to create the associated token account for.
+     * @returns The signature of the sent transaction, or undefined if the account already existed.
+     */
+    createAssociatedTokenAccount(_a) {
+        return _tslib.__awaiter(this, arguments, void 0, function* ({ tokenAddress, }) {
+            const connection = yield this.getConnection();
+            const { blockhash, lastValidBlockHeight } = yield connection.getLatestBlockhash('confirmed');
+            const transaction = yield createAssociatedTokenAccountTransaction.createAssociatedTokenAccountTransaction({
+                blockhash,
+                connection,
+                lastValidBlockHeight,
+                ownerAddress: this.address,
+                tokenAddress,
+            });
+            if (!transaction) {
+                return undefined;
+            }
+            const signer = yield this.getSigner();
+            const { signature } = yield signer.signAndSendTransaction(transaction);
+            return signature;
+        });
+    }
     /**
      * Retrieves the RPC connection
      * @returns A promise that resolves to the RPC connection

package/src/wallet/SolanaWallet.d.ts

@@ -17,6 +17,18 @@ export declare class SolanaWallet extends Wallet<SolanaWalletConnector> {
             decimals?: number;
         };
     }): Promise<string | undefined>;
+    /**
+     * Creates the wallet's associated token account for the given mint, as its
+     * own standalone (sponsorable) transaction, if it doesn't already exist —
+     * returns undefined without signing or sending anything when it's already
+     * there. Kept separate from sendBalance/swap flows so it doesn't compete
+     * for space with other instructions in an already-large transaction.
+     * @param tokenAddress - The mint address to create the associated token account for.
+     * @returns The signature of the sent transaction, or undefined if the account already existed.
+     */
+    createAssociatedTokenAccount({ tokenAddress, }: {
+        tokenAddress: string;
+    }): Promise<string | undefined>;
     /**
      * Retrieves the RPC connection
      * @returns A promise that resolves to the RPC connection

package/src/wallet/SolanaWallet.js

@@ -5,6 +5,7 @@ import { cloneObjectWithOverrides } from '@dynamic-labs/utils';
 import '@solana/web3.js';
 import '@solana/spl-token';
 import { createNonNativeTokenTransfer } from '../utils/createNonNativeTokenTransfer/createNonNativeTokenTransfer.js';
+import { createAssociatedTokenAccountTransaction } from '../utils/createAssociatedTokenAccountTransaction/createAssociatedTokenAccountTransaction.js';
 import { createSolTransfer } from '../utils/createSolTransfer/createSolTransfer.js';
 import { screenSolanaTransactions } from '../utils/screenSolanaTransactions/screenSolanaTransactions.js';
 
@@ -45,6 +46,34 @@ class SolanaWallet extends Wallet {
             return signature;
         });
     }
+    /**
+     * Creates the wallet's associated token account for the given mint, as its
+     * own standalone (sponsorable) transaction, if it doesn't already exist —
+     * returns undefined without signing or sending anything when it's already
+     * there. Kept separate from sendBalance/swap flows so it doesn't compete
+     * for space with other instructions in an already-large transaction.
+     * @param tokenAddress - The mint address to create the associated token account for.
+     * @returns The signature of the sent transaction, or undefined if the account already existed.
+     */
+    createAssociatedTokenAccount(_a) {
+        return __awaiter(this, arguments, void 0, function* ({ tokenAddress, }) {
+            const connection = yield this.getConnection();
+            const { blockhash, lastValidBlockHeight } = yield connection.getLatestBlockhash('confirmed');
+            const transaction = yield createAssociatedTokenAccountTransaction({
+                blockhash,
+                connection,
+                lastValidBlockHeight,
+                ownerAddress: this.address,
+                tokenAddress,
+            });
+            if (!transaction) {
+                return undefined;
+            }
+            const signer = yield this.getSigner();
+            const { signature } = yield signer.signAndSendTransaction(transaction);
+            return signature;
+        });
+    }
     /**
      * Retrieves the RPC connection
      * @returns A promise that resolves to the RPC connection