@dynamic-labs-sdk/solana 0.0.1-alpha.8 → 0.1.0-alpha.0

package/CHANGELOG.md

@@ -1,3 +1,160 @@
+## 0.1.0-alpha.0 (2025-09-02)
+
+### 🚀 Features
+
+- add connectAndVerifyWithWalletProvider function ([#385](https://github.com/dynamic-labs/dynamic-sdk/pull/385))
+- add event listening for wallet providers ([#389](https://github.com/dynamic-labs/dynamic-sdk/pull/389))
+
+### 🩹 Fixes
+
+- sending transaction with solana ([#381](https://github.com/dynamic-labs/dynamic-sdk/pull/381))
+
+### 🔧 Refactors
+
+- waas sign message defined in waas provider ([#377](https://github.com/dynamic-labs/dynamic-sdk/pull/377))
+- ban chain enum ([#386](https://github.com/dynamic-labs/dynamic-sdk/pull/386))
+- ban misplaced waas exports ([#387](https://github.com/dynamic-labs/dynamic-sdk/pull/387))
+
+## 0.0.1-alpha.27 (2025-08-29)
+
+### 🚀 Features
+
+- allow switching network ([#323](https://github.com/dynamic-labs/dynamic-sdk/pull/323))
+- introduce getBalance and getBalanceForAddress ([#335](https://github.com/dynamic-labs/dynamic-sdk/pull/335))
+- add delegateWaasKeyShares function ([#353](https://github.com/dynamic-labs/dynamic-sdk/pull/353))
+- add updateWaasPassword function ([#354](https://github.com/dynamic-labs/dynamic-sdk/pull/354))
+- add exportWaasClientKeyshares function ([#355](https://github.com/dynamic-labs/dynamic-sdk/pull/355))
+- add importWaasPrivateKey function ([#356](https://github.com/dynamic-labs/dynamic-sdk/pull/356))
+- add refreshWaasWalletAccountShares function ([#357](https://github.com/dynamic-labs/dynamic-sdk/pull/357))
+- add backupWaasKeySharesToGoogleDrive function ([#358](https://github.com/dynamic-labs/dynamic-sdk/pull/358))
+- add exportWaasPrivateKey function ([#359](https://github.com/dynamic-labs/dynamic-sdk/pull/359))
+- add isWaasWalletAccount function ([#365](https://github.com/dynamic-labs/dynamic-sdk/pull/365))
+- add createWalletClientForWalletAccount function ([#367](https://github.com/dynamic-labs/dynamic-sdk/pull/367))
+
+### 🔧 Refactors
+
+- assert signed session id in getSignedSessionId ([#361](https://github.com/dynamic-labs/dynamic-sdk/pull/361))
+- add consumeMfaTokenIfRequiredForAction function ([#363](https://github.com/dynamic-labs/dynamic-sdk/pull/363))
+
+## 0.0.1-alpha.26 (2025-08-27)
+
+### 🩹 Fixes
+
+- remove version pin on sdk-api-core ([#351](https://github.com/dynamic-labs/dynamic-sdk/pull/351))
+
+## 0.0.1-alpha.25 (2025-08-27)
+
+### 🚀 Features
+
+- add ethereum netowrk providers ([#267](https://github.com/dynamic-labs/dynamic-sdk/pull/267))
+- add solana network provider ([#268](https://github.com/dynamic-labs/dynamic-sdk/pull/268))
+- add proveWalletAccountOwnership function ([#295](https://github.com/dynamic-labs/dynamic-sdk/pull/295))
+- format evm wallet addresses to conform to eip55 ([#300](https://github.com/dynamic-labs/dynamic-sdk/pull/300))
+- add viem public client ([#272](https://github.com/dynamic-labs/dynamic-sdk/pull/272))
+- add getSolanaConnection ([#275](https://github.com/dynamic-labs/dynamic-sdk/pull/275))
+- add dynamic waas evm extension ([#299](https://github.com/dynamic-labs/dynamic-sdk/pull/299))
+- add refreshUser function ([#332](https://github.com/dynamic-labs/dynamic-sdk/pull/332))
+- add get network method ([#321](https://github.com/dynamic-labs/dynamic-sdk/pull/321))
+
+### 🩹 Fixes
+
+- update default API base URL ([#296](https://github.com/dynamic-labs/dynamic-sdk/pull/296))
+
+### 🔧 Refactors
+
+- reorganize exports index file ([#303](https://github.com/dynamic-labs/dynamic-sdk/pull/303))
+- rename events folder to clientEvents ([#305](https://github.com/dynamic-labs/dynamic-sdk/pull/305))
+- dry network provider type ([#308](https://github.com/dynamic-labs/dynamic-sdk/pull/308))
+- rename types files to include the features name ([#319](https://github.com/dynamic-labs/dynamic-sdk/pull/319))
+- use evm instead of other terms ([#306](https://github.com/dynamic-labs/dynamic-sdk/pull/306))
+- rename net configuration to net data ([#322](https://github.com/dynamic-labs/dynamic-sdk/pull/322))
+- move waas-utils to client package ([#342](https://github.com/dynamic-labs/dynamic-sdk/pull/342))
+
+## 0.0.1-alpha.24 (2025-08-14)
+
+This was a version bump only, there were no code changes.
+
+## 0.0.1-alpha.23 (2025-08-14)
+
+This was a version bump only, there were no code changes.
+
+## 0.0.1-alpha.22 (2025-08-13)
+
+This was a version bump only, there were no code changes.
+
+## 0.0.1-alpha.21 (2025-08-12)
+
+### 🚀 Features
+
+- add signInWithExternalJwt function ([#263](https://github.com/dynamic-labs/dynamic-sdk/pull/263))
+
+### 🩹 Fixes
+
+- bind fetch to window ([#265](https://github.com/dynamic-labs/dynamic-sdk/pull/265))
+
+## 0.0.1-alpha.20 (2025-08-06)
+
+### 🚀 Features
+
+- raise an error if different dynamic packages are on different versions ([#253](https://github.com/dynamic-labs/dynamic-sdk/pull/253))
+
+## 0.0.1-alpha.19 (2025-07-23)
+
+This was a version bump only, there were no code changes.
+
+## 0.0.1-alpha.18 (2025-07-22)
+
+This was a version bump only, there were no code changes.
+
+## 0.0.1-alpha.17 (2025-07-22)
+
+This was a version bump only, there were no code changes.
+
+## 0.0.1-alpha.16 (2025-07-14)
+
+### 🚀 Features
+
+- add new getMultichainBalances api method ([#219](https://github.com/dynamic-labs/dynamic-sdk/pull/219))
+- adds authenticated event ([#222](https://github.com/dynamic-labs/dynamic-sdk/pull/222))
+
+## 0.0.1-alpha.15 (2025-07-14)
+
+### 🚀 Features
+
+- **SIN-7:** Add Signin with Passkey ([#201](https://github.com/dynamic-labs/dynamic-sdk/pull/201))
+
+## 0.0.1-alpha.14 (2025-07-11)
+
+### 🩹 Fixes
+
+- import zod mini using namespace ([#214](https://github.com/dynamic-labs/dynamic-sdk/pull/214))
+
+## 0.0.1-alpha.13 (2025-07-09)
+
+### 🩹 Fixes
+
+- convert api headers to get api headers ([#211](https://github.com/dynamic-labs/dynamic-sdk/pull/211))
+
+## 0.0.1-alpha.12 (2025-07-09)
+
+### 🩹 Fixes
+
+- allow the api call to include cookie credentials ([#209](https://github.com/dynamic-labs/dynamic-sdk/pull/209))
+
+## 0.0.1-alpha.11 (2025-07-08)
+
+This was a version bump only, there were no code changes.
+
+## 0.0.1-alpha.10 (2025-07-08)
+
+This was a version bump only, there were no code changes.
+
+## 0.0.1-alpha.9 (2025-07-08)
+
+### 🩹 Fixes
+
+- throw when attempting to set undefined prop in storage ([#200](https://github.com/dynamic-labs/dynamic-sdk/pull/200))
+
 ## 0.0.1-alpha.8 (2025-07-03)
 
 This was a version bump only, there were no code changes.

package/addSolanaWalletStandardExtension.cjs.js

@@ -2,49 +2,82 @@
 
 var core = require('@dynamic-labs-sdk/client/core');
 var app = require('@wallet-standard/app');
+var isVersionedTransaction = require('./isVersionedTransaction.cjs.js');
+var web3_js = require('@solana/web3.js');
 var client = require('@dynamic-labs-sdk/client');
 var sdkApiCore = require('@dynamic-labs/sdk-api-core');
-var web3_js = require('@solana/web3.js');
+var bs58 = require('bs58');
 
-const isVersionedTransaction = (transaction)=>!('instructions' in transaction);
+const fetchSolBalance = async ({ address, rpcUrl })=>{
+    // Establish a connection to the Solana network using the provided RPC URL.
+    const connection = new web3_js.Connection(rpcUrl);
+    // Convert the string address into a PublicKey object.
+    const publicKey = new web3_js.PublicKey(address);
+    // Fetch the balance of the public key. The balance is in lamports.
+    const balanceInLamports = await connection.getBalance(publicKey);
+    // The getBalance method returns the balance in lamports.
+    // 1 SOL = 1,000,000,000 lamports.
+    const balanceInSol = balanceInLamports / 1000000000;
+    // Return the balance in SOL as a string
+    return balanceInSol.toString();
+};
+
+const createSolanaNetworkProvider = (networkData)=>isVersionedTransaction._extends({}, core.createBaseNetworkProvider('SOL', networkData), {
+        cluster: networkData.cluster,
+        getBalance: async ({ address })=>({
+                balance: await fetchSolBalance({
+                    address,
+                    rpcUrl: networkData.rpcUrls.http[0]
+                })
+            })
+    });
+
+const registerSolanaNetworkProviderBuilder = (client)=>{
+    const networkProviderBuilderRegistry = core.getNetworkProviderBuilderRegistry(client);
+    /**
+   * If the Solana network provider builder is already registered, return.
+   */ if (networkProviderBuilderRegistry.get().get('SOL')) {
+        return;
+    }
+    networkProviderBuilderRegistry.register({
+        builder: createSolanaNetworkProvider,
+        chain: 'SOL'
+    });
+};
 
 const getFeaturesForSolanaStandardWallet = (wallet)=>{
     return wallet.features;
 };
 
-const createSolanaSignerFromSolanaStandardWallet = (wallet)=>{
-    const features = getFeaturesForSolanaStandardWallet(wallet);
+const createSolanaSignerFromSolanaStandardWallet = ({ networkProvider, walletStandardWallet })=>{
+    const features = getFeaturesForSolanaStandardWallet(walletStandardWallet);
     const getPublicKey = ()=>{
-        var _wallet_accounts_, _wallet_accounts;
-        if (!((_wallet_accounts = wallet.accounts) == null ? void 0 : (_wallet_accounts_ = _wallet_accounts[0]) == null ? void 0 : _wallet_accounts_.publicKey)) {
+        var _walletStandardWallet_accounts_, _walletStandardWallet_accounts;
+        if (!((_walletStandardWallet_accounts = walletStandardWallet.accounts) == null ? void 0 : (_walletStandardWallet_accounts_ = _walletStandardWallet_accounts[0]) == null ? void 0 : _walletStandardWallet_accounts_.publicKey)) {
             return undefined;
         }
-        return new web3_js.PublicKey(wallet.accounts[0].publicKey);
+        return new web3_js.PublicKey(walletStandardWallet.accounts[0].publicKey);
     };
     const getChain = ()=>{
-        // TODO: add support for getting the chain from the provider
-        // const currentNetwork = provider.getSelectedNetwork();
-        // assertDefined(currentNetwork, 'Network not found');
-        // const cluster = currentNetwork.cluster ?? 'mainnet';
-        const cluster = 'mainnet';
-        return `solana:${cluster}`;
+        core.assertDefined(networkProvider.cluster, `Cluster was not defined for network provider ${networkProvider.displayName} (networkId: ${networkProvider.networkId})`);
+        return `solana:${networkProvider.cluster}`;
     };
     const isConnected = ()=>{
-        var _wallet_accounts;
-        return ((_wallet_accounts = wallet.accounts) == null ? void 0 : _wallet_accounts.length) > 0;
+        var _walletStandardWallet_accounts;
+        return ((_walletStandardWallet_accounts = walletStandardWallet.accounts) == null ? void 0 : _walletStandardWallet_accounts.length) > 0;
     };
     const getCurrentAccount = async ()=>{
-        var _wallet_accounts;
+        var _walletStandardWallet_accounts;
         if (!isConnected()) {
             await connect();
         }
-        const account = (_wallet_accounts = wallet.accounts) == null ? void 0 : _wallet_accounts[0];
+        const account = (_walletStandardWallet_accounts = walletStandardWallet.accounts) == null ? void 0 : _walletStandardWallet_accounts[0];
         core.assertDefined(account, 'No connected accounts found');
         return account;
     };
     const connect = async ()=>{
         var _features_standardconnect, _result_accounts;
-        const autoConnectedAccounts = wallet.accounts;
+        const autoConnectedAccounts = walletStandardWallet.accounts;
         // some wallets like Farcaster will auto inject the account into the wallet object
         // instead of returning it from the connect method
         // so we need to check for that first
@@ -105,7 +138,7 @@ const createSolanaSignerFromSolanaStandardWallet = (wallet)=>{
             })
         });
         const signedTransaction = signTransactionResult[0].signedTransaction;
-        if (isVersionedTransaction(transaction)) {
+        if (isVersionedTransaction.isVersionedTransaction(transaction)) {
             return web3_js.VersionedTransaction.deserialize(signedTransaction);
         }
         return web3_js.Transaction.from(signedTransaction);
@@ -125,7 +158,7 @@ const createSolanaSignerFromSolanaStandardWallet = (wallet)=>{
         });
         const [{ signature }] = signedTransactions;
         return {
-            signature: new TextDecoder().decode(signature)
+            signature: bs58.encode(signature)
         };
     };
     const signMessage = async (message)=>{
@@ -141,52 +174,35 @@ const createSolanaSignerFromSolanaStandardWallet = (wallet)=>{
             signature: messages[0].signature
         };
     };
-    return {
-        addListener: ()=>{
-            throw new core.MethodNotImplementedError('addListener');
-        },
+    return isVersionedTransaction._extends({}, isVersionedTransaction.createEmptyEventEmitter(), {
         connect,
         disconnect,
-        emit: ()=>{
-            throw new core.MethodNotImplementedError('emit');
-        },
-        eventNames: ()=>{
-            return [];
-        },
         get isConnected () {
             return isConnected();
         },
-        listenerCount: ()=>{
-            return 0;
-        },
-        listeners: ()=>{
-            return [];
-        },
-        off: ()=>{
-            throw new core.MethodNotImplementedError('off');
-        },
         on,
-        once: ()=>{
-            throw new core.MethodNotImplementedError('once');
-        },
         providers: [],
         get publicKey () {
             return getPublicKey();
         },
-        removeAllListeners: ()=>{
-            throw new core.MethodNotImplementedError('removeAllListeners');
-        },
-        removeListener: ()=>{
-            throw new core.MethodNotImplementedError('removeListener');
-        },
         signAllTransactions,
         signAndSendTransaction,
         signMessage,
         signTransaction
-    };
+    });
 };
 
-const createWalletProviderFromSolanaStandardWallet = ({ wallet })=>{
+const createWalletProviderFromSolanaStandardWallet = ({ dynamicClient, walletStandardWallet })=>{
+    const key = core.formatWalletProviderKey(walletStandardWallet.name, 'SOL');
+    const getActiveNetworkId = async ()=>core.getActiveNetworkIdFromLastKnownRegistry({
+            client: dynamicClient,
+            walletProviderKey: key
+        });
+    const switchActiveNetwork = async ({ networkId })=>core.switchActiveNetworkInLastKnownRegistry({
+            client: dynamicClient,
+            networkId,
+            walletProviderKey: key
+        });
     const connect = async ()=>{
         const signer = await getSigner();
         const result = await signer.connect();
@@ -206,45 +222,24 @@ const createWalletProviderFromSolanaStandardWallet = ({ wallet })=>{
             await signer.connect();
         }
         return {
-            addresses: wallet.accounts.map((account)=>account.address)
+            addresses: walletStandardWallet.accounts.map((account)=>account.address)
         };
     };
     const getSigner = async (walletAccount)=>{
         if (walletAccount) {
-            await client.assertWalletAccountSigningAvailability(walletAccount);
+            await client.assertWalletAccountSigningAvailability({
+                walletAccount
+            }, dynamicClient);
         }
-        return createSolanaSignerFromSolanaStandardWallet(wallet);
-    };
-    const proveOwnership = async (walletAccount)=>{
-        var _core_metadata;
-        const client = core.getClient(walletAccount);
-        const core$1 = core.getCore(client);
-        const apiClient = core.createApiClient(client);
-        const appUrl = (_core_metadata = core$1.metadata) == null ? void 0 : _core_metadata.url;
-        core.assertDefined(appUrl, 'App URL is not set');
-        const url = new URL(appUrl);
-        const { nonce } = await apiClient.getNonce({
-            environmentId: core$1.environmentId
-        });
-        core.assertDefined(nonce, 'Failed to get nonce');
-        const messageToSign = await core.formatSignInMessage({
-            address: walletAccount.address,
-            blockchainName: 'Solana',
-            domain: url.host,
-            issuedAt: new Date().toISOString(),
-            nonce,
-            requestId: core$1.environmentId,
-            uri: url.toString()
-        });
-        const signedMessage = await signMessage({
-            message: messageToSign,
-            walletAccount
+        const { networkId } = await getActiveNetworkId();
+        const networkProvider = core.getNetworkProviderFromNetworkId({
+            chain: 'SOL',
+            networkId
+        }, dynamicClient);
+        return createSolanaSignerFromSolanaStandardWallet({
+            networkProvider,
+            walletStandardWallet
         });
-        return {
-            chain: sdkApiCore.ChainEnum.Sol,
-            messageToSign,
-            signedMessage: signedMessage.signature
-        };
     };
     const signMessage = async ({ message, walletAccount })=>{
         const signer = await getSigner(walletAccount);
@@ -255,22 +250,57 @@ const createWalletProviderFromSolanaStandardWallet = ({ wallet })=>{
             signature: core.bufferToBase64(signedMessage.signature)
         };
     };
-    return {
+    const getEventsFeature = ()=>{
+        const features = getFeaturesForSolanaStandardWallet(walletStandardWallet);
+        const eventsFeature = features['standard:events'];
+        return eventsFeature;
+    };
+    const { getEventEmitter, cleanupEventEmitter } = core.createWalletProviderEventEmitter({
+        removeEventListeners: ({ setupReturnValue })=>{
+            core.assertDefined(setupReturnValue, 'Setup return value not defined');
+            setupReturnValue();
+        },
+        setupEventListeners: ({ handleAccountsChanged })=>{
+            return getEventsFeature().on('change', ({ accounts })=>{
+                var _accounts_map;
+                handleAccountsChanged({
+                    addresses: (_accounts_map = accounts == null ? void 0 : accounts.map((account)=>account.address)) != null ? _accounts_map : []
+                });
+            });
+        },
+        supportedEvents: [
+            'accountsChanged'
+        ]
+    });
+    const terminate = async ()=>{
+        cleanupEventEmitter();
+    };
+    const walletProvider = {
         chain: 'SOL',
         connect,
         disconnect,
+        getActiveNetworkId,
         getConnectedAddresses,
         getSigner,
         getWalletProviderType: ()=>sdkApiCore.WalletProviderEnum.BrowserExtension,
-        groupKey: core.formatWalletProviderGroupKey(wallet.name),
-        key: core.formatWalletProviderKey(wallet.name, sdkApiCore.ChainEnum.Sol),
+        groupKey: core.formatWalletProviderGroupKey(walletStandardWallet.name),
+        key,
         metadata: {
-            displayName: wallet.name,
-            icon: wallet.icon
+            displayName: walletStandardWallet.name,
+            icon: walletStandardWallet.icon
         },
-        proveOwnership,
-        signMessage
+        signMessage,
+        switchActiveNetwork,
+        terminate
     };
+    // The provider will only implement events if this external wallet provider
+    // implements the standard:events feature
+    if (getEventsFeature()) {
+        Object.defineProperty(walletProvider, 'events', {
+            get: ()=>getEventEmitter()
+        });
+    }
+    return walletProvider;
 };
 
 const hasAllRequiredFeatures = (wallet)=>{
@@ -279,16 +309,30 @@ const hasAllRequiredFeatures = (wallet)=>{
 };
 
 const SOLANA_WALLET_STANDARD_EXTENSION_KEY = 'solanaWalletStandard';
-const addSolanaWalletStandardExtension = (client)=>{
-    if (core.hasExtension(client, SOLANA_WALLET_STANDARD_EXTENSION_KEY)) {
+/**
+ * Adds the Solana Wallet Standard extension to the Dynamic client.
+ *
+ * This extension enables integration with wallets that implement the Solana Wallet Standard,
+ * automatically detecting and registering compatible wallets for use with the Dynamic SDK.
+ *
+ * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+ */ const addSolanaWalletStandardExtension = (client = core.getDefaultClient())=>{
+    if (core.hasExtension({
+        extensionKey: SOLANA_WALLET_STANDARD_EXTENSION_KEY
+    }, client)) {
         return;
     }
+    core.registerExtension({
+        extensionKey: SOLANA_WALLET_STANDARD_EXTENSION_KEY
+    }, client);
+    registerSolanaNetworkProviderBuilder(client);
     const walletProviderRegistry = core.getWalletProviderRegistry(client);
-    const walletStandardWallet = app.getWallets().get().filter(hasAllRequiredFeatures);
-    walletStandardWallet.forEach((wallet)=>{
-        const walletProvider = core.assignClient(createWalletProviderFromSolanaStandardWallet({
-            wallet
-        }), client);
+    const walletStandardWallets = app.getWallets().get().filter(hasAllRequiredFeatures);
+    walletStandardWallets.forEach((walletStandardWallet)=>{
+        const walletProvider = createWalletProviderFromSolanaStandardWallet({
+            dynamicClient: client,
+            walletStandardWallet
+        });
         walletProviderRegistry.register({
             priority: core.WalletProviderPriority.WALLET_SELF_ANNOUNCEMENT_STANDARD,
             walletProvider