@dynamic-labs/global-wallet-client 4.19.4 → 4.19.6

package/CHANGELOG.md

@@ -1,4 +1,24 @@
 
+### [4.19.6](https://github.com/dynamic-labs/dynamic-auth/compare/v4.19.5...v4.19.6) (2025-06-04)
+
+
+### Features
+
+* backup unsuccessful popup when create wallet fails ([#8872](https://github.com/dynamic-labs/dynamic-auth/issues/8872)) ([c8f88f2](https://github.com/dynamic-labs/dynamic-auth/commit/c8f88f2cafdb7856764305764a230e159f09dadf))
+* **global-wallet:** new native api method to return the eoa wallet for a connected smart wallet ([#8864](https://github.com/dynamic-labs/dynamic-auth/issues/8864)) ([5d0e200](https://github.com/dynamic-labs/dynamic-auth/commit/5d0e2002caefb658f6120b102abe145d6caafaf4))
+
+
+### Bug Fixes
+
+* dont call select endpoint when signing in with 7702 wallet ([#8854](https://github.com/dynamic-labs/dynamic-auth/issues/8854)) ([9828a8f](https://github.com/dynamic-labs/dynamic-auth/commit/9828a8fb758b07dd4dc51cb9eadee483b884defe))
+
+### [4.19.5](https://github.com/dynamic-labs/dynamic-auth/compare/v4.19.4...v4.19.5) (2025-06-02)
+
+
+### Features
+
+* add cleanup for waas connectors ([#8849](https://github.com/dynamic-labs/dynamic-auth/issues/8849)) ([5899169](https://github.com/dynamic-labs/dynamic-auth/commit/5899169abaf7ce86add2b1393cfd9b967da5e388))
+
 ### [4.19.4](https://github.com/dynamic-labs/dynamic-auth/compare/v4.19.3...v4.19.4) (2025-05-31)
 
 ### [4.19.3](https://github.com/dynamic-labs/dynamic-auth/compare/v4.19.2...v4.19.3) (2025-05-28)

package/package.cjs

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

package/package.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/global-wallet-client",
-  "version": "4.19.4",
+  "version": "4.19.6",
   "description": "Core package for building Dynamic's Global Wallet",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -55,12 +55,12 @@
   },
   "homepage": "https://www.dynamic.xyz/",
   "dependencies": {
-    "@dynamic-labs/assert-package-version": "4.19.4",
-    "@dynamic-labs/logger": "4.19.4",
-    "@dynamic-labs/message-transport": "4.19.4",
-    "@dynamic-labs/store": "4.19.4",
-    "@dynamic-labs/types": "4.19.4",
-    "@dynamic-labs/utils": "4.19.4",
+    "@dynamic-labs/assert-package-version": "4.19.6",
+    "@dynamic-labs/logger": "4.19.6",
+    "@dynamic-labs/message-transport": "4.19.6",
+    "@dynamic-labs/store": "4.19.6",
+    "@dynamic-labs/types": "4.19.6",
+    "@dynamic-labs/utils": "4.19.6",
     "eventemitter3": "5.0.1"
   },
   "peerDependencies": {

package/src/features.cjs

@@ -5,6 +5,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var connect = require('./lib/functions/connect/connect.cjs');
 var disconnect = require('./lib/functions/disconnect/disconnect.cjs');
+var getEoaWalletForSmartWallet = require('./lib/functions/getEoaWalletForSmartWallet/getEoaWalletForSmartWallet.cjs');
 var getEthereumWallets = require('./lib/functions/getEthereumWallets/getEthereumWallets.cjs');
 var getSolanaWallets = require('./lib/functions/getSolanaWallets/getSolanaWallets.cjs');
 var getSupportedEthereumNetworks = require('./lib/functions/getSupportedEthereumNetworks/getSupportedEthereumNetworks.cjs');
@@ -14,11 +15,13 @@ var isSolanaWallet = require('./lib/functions/isSolanaWallet/isSolanaWallet.cjs'
 var onEvent = require('./lib/functions/onEvent/onEvent.cjs');
 var signMessage = require('./lib/functions/signMessage/signMessage.cjs');
 var switchNetwork = require('./lib/functions/switchNetwork/switchNetwork.cjs');
+var sendTransaction = require('./lib/functions/sendTransaction/sendTransaction.cjs');
 
 
 
 exports.connect = connect.connect;
 exports.disconnect = disconnect.disconnect;
+exports.getEoaWalletForSmartWallet = getEoaWalletForSmartWallet.getEoaWalletForSmartWallet;
 exports.getEthereumWallets = getEthereumWallets.getEthereumWallets;
 exports.getSolanaWallets = getSolanaWallets.getSolanaWallets;
 exports.getSupportedEthereumNetworks = getSupportedEthereumNetworks.getSupportedEthereumNetworks;
@@ -28,3 +31,4 @@ exports.isSolanaWallet = isSolanaWallet.isSolanaWallet;
 exports.onEvent = onEvent.onEvent;
 exports.signMessage = signMessage.signMessage;
 exports.switchNetwork = switchNetwork.switchNetwork;
+exports.sendTransaction = sendTransaction.sendTransaction;

package/src/features.d.ts

@@ -1,5 +1,6 @@
 export { connect } from './lib/functions/connect';
 export { disconnect } from './lib/functions/disconnect';
+export { getEoaWalletForSmartWallet } from './lib/functions/getEoaWalletForSmartWallet';
 export { getEthereumWallets } from './lib/functions/getEthereumWallets';
 export { getSolanaWallets } from './lib/functions/getSolanaWallets';
 export { getSupportedEthereumNetworks } from './lib/functions/getSupportedEthereumNetworks';
@@ -9,3 +10,4 @@ export { isSolanaWallet } from './lib/functions/isSolanaWallet';
 export { onEvent } from './lib/functions/onEvent';
 export { signMessage } from './lib/functions/signMessage';
 export { switchNetwork } from './lib/functions/switchNetwork';
+export { sendTransaction } from './lib/functions/sendTransaction';

package/src/features.js

@@ -1,6 +1,7 @@
 'use client'
 export { connect } from './lib/functions/connect/connect.js';
 export { disconnect } from './lib/functions/disconnect/disconnect.js';
+export { getEoaWalletForSmartWallet } from './lib/functions/getEoaWalletForSmartWallet/getEoaWalletForSmartWallet.js';
 export { getEthereumWallets } from './lib/functions/getEthereumWallets/getEthereumWallets.js';
 export { getSolanaWallets } from './lib/functions/getSolanaWallets/getSolanaWallets.js';
 export { getSupportedEthereumNetworks } from './lib/functions/getSupportedEthereumNetworks/getSupportedEthereumNetworks.js';
@@ -10,3 +11,4 @@ export { isSolanaWallet } from './lib/functions/isSolanaWallet/isSolanaWallet.js
 export { onEvent } from './lib/functions/onEvent/onEvent.js';
 export { signMessage } from './lib/functions/signMessage/signMessage.js';
 export { switchNetwork } from './lib/functions/switchNetwork/switchNetwork.js';
+export { sendTransaction } from './lib/functions/sendTransaction/sendTransaction.js';

package/src/lib/client/createClientStore/createClientStore.d.ts

@@ -18,6 +18,7 @@ export type ClientStoreState = {
      * Ethereum specific state
      */
     ethereum: {
+        eoaWallets: Record<string, BaseWallet>;
         supportedNetworks: {
             chainId: number;
             rpcUrl?: string;

package/src/lib/functions/connect/connect.cjs

@@ -54,6 +54,7 @@ const connect = (client) => _tslib.__awaiter(void 0, void 0, void 0, function* (
         ethereum: ethereum
             ? {
                 currentNetworkId: ethereum.currentNetworkId,
+                eoaWallets: ethereum.eoaWallets,
                 supportedNetworks: ethereum.supportedNetworks,
             }
             : null,

package/src/lib/functions/connect/connect.js

@@ -50,6 +50,7 @@ const connect = (client) => __awaiter(void 0, void 0, void 0, function* () {
         ethereum: ethereum
             ? {
                 currentNetworkId: ethereum.currentNetworkId,
+                eoaWallets: ethereum.eoaWallets,
                 supportedNetworks: ethereum.supportedNetworks,
             }
             : null,

package/src/lib/functions/getEoaWalletForSmartWallet/getEoaWalletForSmartWallet.cjs

@@ -0,0 +1,30 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+require('eventemitter3');
+require('@dynamic-labs/logger');
+require('@dynamic-labs/store');
+require('../../errors/DisconnectError.cjs');
+require('../../../../_virtual/_tslib.cjs');
+require('@dynamic-labs/utils');
+require('../../constants/logger.cjs');
+var getCore = require('../../client/getCore/getCore.cjs');
+var getClient = require('../../client/getClient/getClient.cjs');
+
+/**
+ * Gets the EOA wallet for a smart wallet.
+ *
+ * @param smartWallet - The smart wallet.
+ *
+ * @returns The EOA wallet for the smart wallet.
+ */
+const getEoaWalletForSmartWallet = ({ smartWallet, }) => {
+    const client = getClient.getClient(smartWallet);
+    const core = getCore.getCore(client);
+    const { ethereum } = core.store.getState();
+    return ethereum === null || ethereum === void 0 ? void 0 : ethereum.eoaWallets[smartWallet.address];
+};
+
+exports.getEoaWalletForSmartWallet = getEoaWalletForSmartWallet;

package/src/lib/functions/getEoaWalletForSmartWallet/getEoaWalletForSmartWallet.d.ts

@@ -0,0 +1,11 @@
+import { BaseWallet } from '@dynamic-labs/types';
+/**
+ * Gets the EOA wallet for a smart wallet.
+ *
+ * @param smartWallet - The smart wallet.
+ *
+ * @returns The EOA wallet for the smart wallet.
+ */
+export declare const getEoaWalletForSmartWallet: ({ smartWallet, }: {
+    smartWallet: BaseWallet;
+}) => BaseWallet | undefined;

package/src/lib/functions/getEoaWalletForSmartWallet/getEoaWalletForSmartWallet.js

@@ -0,0 +1,26 @@
+'use client'
+import 'eventemitter3';
+import '@dynamic-labs/logger';
+import '@dynamic-labs/store';
+import '../../errors/DisconnectError.js';
+import '../../../../_virtual/_tslib.js';
+import '@dynamic-labs/utils';
+import '../../constants/logger.js';
+import { getCore } from '../../client/getCore/getCore.js';
+import { getClient } from '../../client/getClient/getClient.js';
+
+/**
+ * Gets the EOA wallet for a smart wallet.
+ *
+ * @param smartWallet - The smart wallet.
+ *
+ * @returns The EOA wallet for the smart wallet.
+ */
+const getEoaWalletForSmartWallet = ({ smartWallet, }) => {
+    const client = getClient(smartWallet);
+    const core = getCore(client);
+    const { ethereum } = core.store.getState();
+    return ethereum === null || ethereum === void 0 ? void 0 : ethereum.eoaWallets[smartWallet.address];
+};
+
+export { getEoaWalletForSmartWallet };

package/src/lib/functions/getEoaWalletForSmartWallet/index.d.ts

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

package/src/lib/functions/sendTransaction/index.d.ts

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

package/src/lib/functions/sendTransaction/sendTransaction.cjs

@@ -0,0 +1,48 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../../_virtual/_tslib.cjs');
+require('eventemitter3');
+require('@dynamic-labs/logger');
+require('@dynamic-labs/store');
+var getActiveConnection = require('../getActiveConnection/getActiveConnection.cjs');
+require('../../errors/DisconnectError.cjs');
+require('@dynamic-labs/utils');
+require('../../constants/logger.cjs');
+var getCore = require('../../client/getCore/getCore.cjs');
+var getClient = require('../../client/getClient/getClient.cjs');
+var isEthereumWallet = require('../isEthereumWallet/isEthereumWallet.cjs');
+var getCurrentEthereumNetworkId = require('../getCurrentEthereumNetworkId/getCurrentEthereumNetworkId.cjs');
+
+/**
+ * Sends a transaction to the Ethereum network
+ * @param {BaseWallet} wallet - The wallet to send the transaction from
+ * @param {SendTransactionParams} params - The parameters for the transaction
+ * @returns {Promise<string>} The transaction hash
+ */
+const sendTransaction = (wallet, params) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+    if (!isEthereumWallet.isEthereumWallet(wallet)) {
+        throw new Error('Wallet is not an Ethereum wallet');
+    }
+    const client = getClient.getClient(wallet);
+    const chainId = getCurrentEthereumNetworkId.getCurrentEthereumNetworkId(client);
+    if (!chainId) {
+        throw new Error('No chain id found');
+    }
+    const requestParams = Object.assign(Object.assign({}, params), { from: wallet.address });
+    const { data } = yield getCore.getCore(client).request({
+        args: {
+            chainId,
+            method: 'eth_sendTransaction',
+            params: [requestParams],
+            sessionId: params.sessionId,
+        },
+        connection: getActiveConnection.getActiveConnection(client),
+        name: 'eth-request',
+    });
+    return data;
+});
+
+exports.sendTransaction = sendTransaction;

package/src/lib/functions/sendTransaction/sendTransaction.d.ts

@@ -0,0 +1,12 @@
+import { SendTransactionParameters } from 'viem';
+import { BaseWallet, ConvertBigIntToString } from '@dynamic-labs/types';
+export type SendTransactionParams = ConvertBigIntToString<Omit<SendTransactionParameters, 'account' | 'chain'>> & {
+    sessionId?: string;
+};
+/**
+ * Sends a transaction to the Ethereum network
+ * @param {BaseWallet} wallet - The wallet to send the transaction from
+ * @param {SendTransactionParams} params - The parameters for the transaction
+ * @returns {Promise<string>} The transaction hash
+ */
+export declare const sendTransaction: (wallet: BaseWallet, params: SendTransactionParams) => Promise<string>;

package/src/lib/functions/sendTransaction/sendTransaction.js

@@ -0,0 +1,44 @@
+'use client'
+import { __awaiter } from '../../../../_virtual/_tslib.js';
+import 'eventemitter3';
+import '@dynamic-labs/logger';
+import '@dynamic-labs/store';
+import { getActiveConnection } from '../getActiveConnection/getActiveConnection.js';
+import '../../errors/DisconnectError.js';
+import '@dynamic-labs/utils';
+import '../../constants/logger.js';
+import { getCore } from '../../client/getCore/getCore.js';
+import { getClient } from '../../client/getClient/getClient.js';
+import { isEthereumWallet } from '../isEthereumWallet/isEthereumWallet.js';
+import { getCurrentEthereumNetworkId } from '../getCurrentEthereumNetworkId/getCurrentEthereumNetworkId.js';
+
+/**
+ * Sends a transaction to the Ethereum network
+ * @param {BaseWallet} wallet - The wallet to send the transaction from
+ * @param {SendTransactionParams} params - The parameters for the transaction
+ * @returns {Promise<string>} The transaction hash
+ */
+const sendTransaction = (wallet, params) => __awaiter(void 0, void 0, void 0, function* () {
+    if (!isEthereumWallet(wallet)) {
+        throw new Error('Wallet is not an Ethereum wallet');
+    }
+    const client = getClient(wallet);
+    const chainId = getCurrentEthereumNetworkId(client);
+    if (!chainId) {
+        throw new Error('No chain id found');
+    }
+    const requestParams = Object.assign(Object.assign({}, params), { from: wallet.address });
+    const { data } = yield getCore(client).request({
+        args: {
+            chainId,
+            method: 'eth_sendTransaction',
+            params: [requestParams],
+            sessionId: params.sessionId,
+        },
+        connection: getActiveConnection(client),
+        name: 'eth-request',
+    });
+    return data;
+});
+
+export { sendTransaction };

package/src/lib/protocol/functions/decodeFromBase64.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Decodes a base64-encoded string to a UTF-8 string.
+ *
+ * @param encodedPayload - The base64-encoded string to decode
+ * @returns A promise that resolves to the decoded UTF-8 string
+ */
+export declare const decodeFromBase64: (encodedPayload: string) => Promise<string>;

package/src/lib/protocol/functions/encodeToBase64.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Encodes a string to base64.
+ *
+ * @param payload - The string to encode
+ * @returns A promise that resolves to the base64-encoded string
+ */
+export declare const encodeToBase64: (payload: string) => Promise<string>;

package/src/lib/protocol/functions/generateNonce.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generates a 6-character hexadecimal nonce for encrypted communications.
+ *
+ * @returns A 6-character hexadecimal string to use as a nonce
+ */
+export declare const generateNonce: () => string;

package/src/lib/protocol/functions/generateRandomHex.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Generates a random hexadecimal string of a specified length.
+ *
+ * @param length - The length of the hexadecimal string to generate (default: 6)
+ * @returns A random hexadecimal string
+ */
+export declare const generateRandomHex: (length?: number) => string;

package/src/lib/protocol/functions/walletRequest/addActionToWalletRequest.d.ts

@@ -0,0 +1,15 @@
+import { WalletRequest, WalletRequestAction } from '../../types';
+/**
+ * Adds a new action to an existing wallet request.
+ *
+ * @param request - The wallet request to add the action to
+ * @param action - The action to add, containing name and arguments
+ * @returns The created WalletRequestAction with auto-generated ID
+ */
+export declare const addActionToWalletRequest: <T extends {
+    name: string;
+    args: Record<string, unknown>;
+} = {
+    name: never;
+    args: never;
+}>(request: WalletRequest, action: T) => WalletRequestAction;

package/src/lib/protocol/functions/walletRequest/createWalletRequest.d.ts

@@ -0,0 +1,7 @@
+import { WalletRequest } from '../../types';
+/**
+ * Creates a new wallet request with an empty body and a generated request ID.
+ *
+ * @returns A new WalletRequest object with empty body and auto-generated request ID
+ */
+export declare const createWalletRequest: () => WalletRequest;

package/src/lib/protocol/functions/walletRequest/decodeWalletRequest.d.ts

@@ -0,0 +1,8 @@
+import { EncryptedWalletRequest, WalletRequest } from '../../types';
+/**
+ * Decodes a base64-encoded wallet request string back to a request object.
+ *
+ * @param encodedRequest - The base64-encoded request string to decode
+ * @returns A promise that resolves to the decoded wallet request (encrypted or unencrypted)
+ */
+export declare const decodeWalletRequest: (encodedRequest: string) => Promise<WalletRequest | EncryptedWalletRequest>;

package/src/lib/protocol/functions/walletRequest/decryptWalletRequest.d.ts

@@ -0,0 +1,10 @@
+import { EncryptedWalletRequest, WalletRequest } from '../../types';
+/**
+ * Decrypts an encrypted wallet request using AES-GCM decryption with a shared secret and nonce.
+ *
+ * @param encryptedRequest - The encrypted wallet request to decrypt
+ * @param sharedSecret - The shared secret key for decryption
+ * @param nonce - The nonce value used during encryption
+ * @returns A promise that resolves to the decrypted wallet request
+ */
+export declare const decryptWalletRequest: (encryptedRequest: EncryptedWalletRequest, sharedSecret: string, nonce: string) => Promise<WalletRequest>;

package/src/lib/protocol/functions/walletRequest/encodeWalletRequest.d.ts

@@ -0,0 +1,8 @@
+import { EncryptedWalletRequest, WalletRequest } from '../../types';
+/**
+ * Encodes a wallet request (encrypted or unencrypted) to a base64 string for transmission.
+ *
+ * @param request - The wallet request to encode
+ * @returns A promise that resolves to the base64-encoded request string
+ */
+export declare const encodeWalletRequest: (request: WalletRequest | EncryptedWalletRequest) => Promise<string>;

package/src/lib/protocol/functions/walletRequest/encryptWalletRequest.d.ts

@@ -0,0 +1,10 @@
+import { EncryptedWalletRequest, WalletRequest } from '../../types';
+/**
+ * Encrypts a wallet request using AES-GCM encryption with a shared secret and nonce.
+ *
+ * @param request - The wallet request to encrypt
+ * @param sharedSecret - The shared secret key for encryption
+ * @param nonce - The nonce value to use for encryption
+ * @returns A promise that resolves to the encrypted wallet request
+ */
+export declare const encryptWalletRequest: (request: WalletRequest, sharedSecret: string, nonce: string) => Promise<EncryptedWalletRequest>;

package/src/lib/protocol/functions/walletRequest/getActionFromWalletRequest.d.ts

@@ -0,0 +1,9 @@
+import { WalletRequest, WalletRequestAction } from '../../types';
+/**
+ * Retrieves the first action from a wallet request.
+ *
+ * @param request - The wallet request to extract the action from
+ * @returns The first action found in the request
+ * @throws {Error} When no action is found in the request
+ */
+export declare const getActionFromWalletRequest: (request: WalletRequest) => WalletRequestAction;

package/src/lib/protocol/functions/walletRequest/isEncryptedWalletRequest.d.ts

@@ -0,0 +1,8 @@
+import { EncryptedWalletRequest, WalletRequest } from '../../types';
+/**
+ * Type guard to determine if a wallet request is encrypted.
+ *
+ * @param request - The wallet request to check
+ * @returns True if the request is encrypted, false otherwise
+ */
+export declare const isEncryptedWalletRequest: (request: WalletRequest | EncryptedWalletRequest) => request is EncryptedWalletRequest;

package/src/lib/protocol/functions/walletResponse/addActionErrorToWalletResponse.d.ts

@@ -0,0 +1,9 @@
+import { WalletResponse, WalletRequestAction } from '../../types';
+/**
+ * Adds an action-specific error to a wallet response.
+ *
+ * @param response - The wallet response to add the error to
+ * @param action - The action that failed
+ * @param error - The error that occurred during action execution
+ */
+export declare const addActionErrorToWalletResponse: (response: WalletResponse, action: WalletRequestAction, error: Error) => void;

package/src/lib/protocol/functions/walletResponse/addActionResultToWalletResponse.d.ts

@@ -0,0 +1,9 @@
+import { WalletRequestAction, WalletResponse } from '../../types';
+/**
+ * Adds a successful action result to a wallet response.
+ *
+ * @param response - The wallet response to add the result to
+ * @param requestAction - The action that was executed successfully
+ * @param result - The result data from executing the action
+ */
+export declare const addActionResultToWalletResponse: (response: WalletResponse, requestAction: WalletRequestAction, result: Record<string, unknown>) => void;

package/src/lib/protocol/functions/walletResponse/addErrorToWalletResponse.d.ts

@@ -0,0 +1,8 @@
+import { WalletResponse } from '../../types';
+/**
+ * Adds a general error to a wallet response.
+ *
+ * @param response - The wallet response to add the error to
+ * @param error - The general error that occurred
+ */
+export declare const addErrorToWalletResponse: (response: WalletResponse, error: Error) => void;

package/src/lib/protocol/functions/walletResponse/addNextNonceToWalletResponse.d.ts

@@ -0,0 +1,8 @@
+import { WalletResponse } from '../../types';
+/**
+ * Adds a next nonce to a wallet response for encrypted communication flows.
+ *
+ * @param response - The wallet response to add the next nonce to
+ * @param nonce - The nonce value to include for the next encrypted exchange
+ */
+export declare const addNextNonceToWalletResponse: (response: WalletResponse, nonce: string) => void;

package/src/lib/protocol/functions/walletResponse/createWalletResponse.d.ts

@@ -0,0 +1,8 @@
+import { WalletRequest, WalletResponse } from '../../types';
+/**
+ * Creates a new wallet response, optionally linked to a request.
+ *
+ * @param request - Optional wallet request to link this response to
+ * @returns A new WalletResponse object with empty body and optional request ID
+ */
+export declare const createWalletResponse: (request?: WalletRequest) => WalletResponse;

package/src/lib/protocol/functions/walletResponse/decodeWalletResponse.d.ts

@@ -0,0 +1,8 @@
+import { EncryptedWalletResponse, WalletResponse } from '../../types';
+/**
+ * Decodes a base64-encoded wallet response string back to a response object.
+ *
+ * @param response - The base64-encoded response string to decode
+ * @returns A promise that resolves to the decoded wallet response (encrypted or unencrypted)
+ */
+export declare const decodeWalletResponse: (response: string) => Promise<WalletResponse | EncryptedWalletResponse>;

package/src/lib/protocol/functions/walletResponse/decryptWalletResponse.d.ts

@@ -0,0 +1,10 @@
+import { EncryptedWalletResponse, WalletResponse } from '../../types';
+/**
+ * Decrypts an encrypted wallet response using AES-GCM decryption with a shared secret and nonce.
+ *
+ * @param encryptedResponse - The encrypted wallet response to decrypt
+ * @param sharedSecret - The shared secret key for decryption
+ * @param nonce - The nonce value used during encryption
+ * @returns A promise that resolves to the decrypted wallet response
+ */
+export declare const decryptWalletResponse: (encryptedResponse: EncryptedWalletResponse, sharedSecret: string, nonce: string) => Promise<WalletResponse>;

package/src/lib/protocol/functions/walletResponse/encodeWalletResponse.d.ts

@@ -0,0 +1,8 @@
+import { EncryptedWalletResponse, WalletResponse } from '../../types';
+/**
+ * Encodes a wallet response (encrypted or unencrypted) to a base64 string for transmission.
+ *
+ * @param response - The wallet response to encode
+ * @returns A promise that resolves to the base64-encoded response string
+ */
+export declare const encodeWalletResponse: (response: WalletResponse | EncryptedWalletResponse) => Promise<string>;

package/src/lib/protocol/functions/walletResponse/encryptWalletResponse.d.ts

@@ -0,0 +1,10 @@
+import { EncryptedWalletResponse, WalletResponse } from '../../types';
+/**
+ * Encrypts a wallet response using AES-GCM encryption with a shared secret and nonce.
+ *
+ * @param response - The wallet response to encrypt
+ * @param sharedSecret - The shared secret key for encryption
+ * @param nonce - The nonce value to use for encryption
+ * @returns A promise that resolves to the encrypted wallet response
+ */
+export declare const encryptWalletResponse: (response: WalletResponse, sharedSecret: string, nonce: string) => Promise<EncryptedWalletResponse>;

package/src/lib/protocol/functions/walletResponse/getActionErrorFromWalletResponse.d.ts

@@ -0,0 +1,9 @@
+import { WalletResponse, WalletRequestAction } from '../../types';
+/**
+ * Retrieves an action-specific error from a wallet response.
+ *
+ * @param response - The wallet response to search for the action error
+ * @param action - The action to find the error for
+ * @returns The action error if found, null otherwise
+ */
+export declare const getActionErrorFromWalletResponse: (response: WalletResponse, action: WalletRequestAction) => Error | null;

package/src/lib/protocol/functions/walletResponse/getActionResultFromWalletResponse.d.ts

@@ -0,0 +1,10 @@
+import { WalletRequestAction, WalletResponse } from '../../types';
+/**
+ * Retrieves the result data for a specific action from a wallet response.
+ *
+ * @param response - The wallet response to search for the action result
+ * @param action - The action to find the result for
+ * @returns The action result data
+ * @throws {Error} When no action result is found for the given action
+ */
+export declare const getActionResultFromWalletResponse: <T extends Record<string, unknown> = never>(response: WalletResponse, action: WalletRequestAction) => T;

package/src/lib/protocol/functions/walletResponse/getErrorFromWalletResponse.d.ts

@@ -0,0 +1,8 @@
+import { WalletResponse } from '../../types';
+/**
+ * Retrieves a general error from a wallet response.
+ *
+ * @param response - The wallet response to search for the general error
+ * @returns The general error if found, null otherwise
+ */
+export declare const getErrorFromWalletResponse: (response: WalletResponse) => Error | null;

package/src/lib/protocol/functions/walletResponse/getNextNonceFromWalletResponse.d.ts

@@ -0,0 +1,8 @@
+import { WalletResponse } from '../../types';
+/**
+ * Extracts the next nonce from a wallet response for encrypted communication flows.
+ *
+ * @param response - The wallet response to extract the next nonce from
+ * @returns The next nonce string if found, null otherwise
+ */
+export declare const getNextNonceFromWalletResponse: (response: WalletResponse) => string | null;

package/src/lib/protocol/functions/walletResponse/isEncryptedWalletResponse.d.ts

@@ -0,0 +1,8 @@
+import { EncryptedWalletResponse, WalletResponse } from '../../types';
+/**
+ * Type guard to determine if a wallet response is encrypted.
+ *
+ * @param response - The wallet response to check
+ * @returns True if the response is encrypted, false otherwise
+ */
+export declare const isEncryptedWalletResponse: (response: WalletResponse | EncryptedWalletResponse) => response is EncryptedWalletResponse;

package/src/lib/protocol/index.d.ts

@@ -0,0 +1,24 @@
+export type { WalletRequest, WalletResponse, EncryptedWalletRequest, EncryptedWalletResponse, } from './types';
+export { createWalletRequest } from './functions/walletRequest/createWalletRequest';
+export { getActionResultFromWalletResponse } from './functions/walletResponse/getActionResultFromWalletResponse';
+export { addActionResultToWalletResponse } from './functions/walletResponse/addActionResultToWalletResponse';
+export { addActionToWalletRequest } from './functions/walletRequest/addActionToWalletRequest';
+export { createWalletResponse } from './functions/walletResponse/createWalletResponse';
+export { encodeWalletRequest } from './functions/walletRequest/encodeWalletRequest';
+export { decodeWalletRequest } from './functions/walletRequest/decodeWalletRequest';
+export { encodeWalletResponse } from './functions/walletResponse/encodeWalletResponse';
+export { decodeWalletResponse } from './functions/walletResponse/decodeWalletResponse';
+export { decryptWalletRequest } from './functions/walletRequest/decryptWalletRequest';
+export { decryptWalletResponse } from './functions/walletResponse/decryptWalletResponse';
+export { encryptWalletRequest } from './functions/walletRequest/encryptWalletRequest';
+export { encryptWalletResponse } from './functions/walletResponse/encryptWalletResponse';
+export { isEncryptedWalletRequest } from './functions/walletRequest/isEncryptedWalletRequest';
+export { isEncryptedWalletResponse } from './functions/walletResponse/isEncryptedWalletResponse';
+export { getActionFromWalletRequest } from './functions/walletRequest/getActionFromWalletRequest';
+export { generateNonce } from './functions/generateNonce';
+export { addNextNonceToWalletResponse } from './functions/walletResponse/addNextNonceToWalletResponse';
+export { getNextNonceFromWalletResponse } from './functions/walletResponse/getNextNonceFromWalletResponse';
+export { addActionErrorToWalletResponse } from './functions/walletResponse/addActionErrorToWalletResponse';
+export { addErrorToWalletResponse } from './functions/walletResponse/addErrorToWalletResponse';
+export { getActionErrorFromWalletResponse } from './functions/walletResponse/getActionErrorFromWalletResponse';
+export { getErrorFromWalletResponse } from './functions/walletResponse/getErrorFromWalletResponse';

package/src/lib/protocol/types.d.ts

@@ -0,0 +1,48 @@
+import { SerializedError } from '@dynamic-labs/message-transport';
+export type WalletRequestAction = {
+    id: string;
+    type: 'action';
+    name: string;
+    args: Record<string, unknown>;
+};
+export type WalletRequestBody = WalletRequestAction[];
+export type WalletRequest = {
+    version: string;
+    requestId: string;
+    body: WalletRequestBody;
+};
+export type EncryptedWalletRequest = {
+    iv: string;
+    encryptedMessage: string;
+};
+export type WalletResponseBodyActionResult = {
+    type: 'action-result';
+    actionId: string;
+    data: Record<string, unknown>;
+};
+export type WalletResponseBodyNextNonce = {
+    type: 'next-nonce';
+    nonce: string;
+};
+export type WalletResponseBodyEvent = {
+    type: 'event';
+    data: Record<string, unknown>;
+};
+export type WalletResponseBodyActionError = {
+    type: 'action-error';
+    actionId: string;
+    error: SerializedError;
+};
+export type WalletResponseBodyError = {
+    type: 'error';
+    error: SerializedError;
+};
+export type WalletResponseBody = (WalletResponseBodyActionResult | WalletResponseBodyNextNonce | WalletResponseBodyEvent | WalletResponseBodyActionError | WalletResponseBodyError)[];
+export type WalletResponse = {
+    requestId?: string;
+    body: WalletResponseBody;
+};
+export type EncryptedWalletResponse = {
+    iv: string;
+    encryptedMessage: string;
+};