@dynamic-labs/waas-evm 5.4.0 → 5.5.0

package/CHANGELOG.md

@@ -1,4 +1,31 @@
 
+## [5.5.0](https://github.com/dynamic-labs/dynamic-auth/compare/v5.4.1...v5.5.0) (2026-08-31)
+
+
+### Features
+
+* **waas-evm:** route embedded EVM sends through gas sponsorship when enabled ([#12306](https://github.com/dynamic-labs/dynamic-auth/issues/12306)) ([6046ff3](https://github.com/dynamic-labs/dynamic-auth/commit/6046ff362d8de9402793bdaa7319fda645ff4c04))
+
+
+### Bug Fixes
+
+* **bitcoin:** resolve the active BTC wallet and network correctly across the widget ([#12308](https://github.com/dynamic-labs/dynamic-auth/issues/12308)) ([13e9eae](https://github.com/dynamic-labs/dynamic-auth/commit/13e9eaec19b3925db507c878988cfd82da5a6de6))
+* **btc:** unbreak BTC transaction confirmation, testnet balances and taproot testnet switching ([#12305](https://github.com/dynamic-labs/dynamic-auth/issues/12305)) ([5fd999c](https://github.com/dynamic-labs/dynamic-auth/commit/5fd999c4c819d3a74e967c0cfa77c5877a74906b))
+* **react-native-extension:** stop leaking expo-secure-store into consumer autolinking ([#12296](https://github.com/dynamic-labs/dynamic-auth/issues/12296)) ([1e0396a](https://github.com/dynamic-labs/dynamic-auth/commit/1e0396ab00c79aa0b2f45b6d7b1d339c1dac1203)), closes [#12254](https://github.com/dynamic-labs/dynamic-auth/issues/12254)
+* **screening:** wire connected-wallet screening into the Send Balance UI (DYNT-1663) ([#12303](https://github.com/dynamic-labs/dynamic-auth/issues/12303)) ([5d26ff3](https://github.com/dynamic-labs/dynamic-auth/commit/5d26ff375118302522c39bd2f1fa9e04f7378eaf))
+
+### [5.4.1](https://github.com/dynamic-labs/dynamic-auth/compare/v5.4.0...v5.4.1) (2026-08-26)
+
+
+### Bug Fixes
+
+* **webview-controller:** resolve which keychain key a session belongs to ([#12246](https://github.com/dynamic-labs/dynamic-auth/issues/12246)) ([3d110db](https://github.com/dynamic-labs/dynamic-auth/commit/3d110db831c6e9d82d07d86841f5c7733924b17e))
+* **bitcoin:** forward the password through the BTC importPrivateKey override ([#12278](https://github.com/dynamic-labs/dynamic-auth/issues/12278)) ([21e1df3](https://github.com/dynamic-labs/dynamic-auth/commit/21e1df3e33e96e2efdb15ffa0fd29a441056202e))
+* **react-native-extension:** recover 4.x expo-secure-store sessions on keychain miss ([#12254](https://github.com/dynamic-labs/dynamic-auth/issues/12254)) ([217e991](https://github.com/dynamic-labs/dynamic-auth/commit/217e991838f3073c12e2d2fab7a2e12830faad9e)), closes [#12092](https://github.com/dynamic-labs/dynamic-auth/issues/12092) [#12092](https://github.com/dynamic-labs/dynamic-auth/issues/12092) [#12092](https://github.com/dynamic-labs/dynamic-auth/issues/12092) [#12092](https://github.com/dynamic-labs/dynamic-auth/issues/12092) [#12242](https://github.com/dynamic-labs/dynamic-auth/issues/12242) [#12242](https://github.com/dynamic-labs/dynamic-auth/issues/12242)
+* **transaction-card:** use walletConnector prop for network/fee instead of primaryWallet ([#12063](https://github.com/dynamic-labs/dynamic-auth/issues/12063)) ([81314d2](https://github.com/dynamic-labs/dynamic-auth/commit/81314d25fba4b20ab89631bc2d9ceeb9e2b6b2ac))
+* **waas-svm:** instrument sponsorship retry attempts ([#12281](https://github.com/dynamic-labs/dynamic-auth/issues/12281)) ([7273a4b](https://github.com/dynamic-labs/dynamic-auth/commit/7273a4bc456cad512c0e9fbcd2abd66532a2f7df))
+* **webview-controller:** recover 4.x secure-storage sessions and surface init failures ([#12242](https://github.com/dynamic-labs/dynamic-auth/issues/12242)) ([b51605c](https://github.com/dynamic-labs/dynamic-auth/commit/b51605cc9bdbb5d695173192c502a58d899bbbdd)), closes [#12094](https://github.com/dynamic-labs/dynamic-auth/issues/12094) [#12095](https://github.com/dynamic-labs/dynamic-auth/issues/12095) [#12098](https://github.com/dynamic-labs/dynamic-auth/issues/12098) [dynamic-labs/flutter-sdk#256](https://github.com/dynamic-labs/flutter-sdk/issues/256)
+
 ## [5.4.0](https://github.com/dynamic-labs/dynamic-auth/compare/v5.3.2...v5.4.0) (2026-08-25)
 
 

package/package.cjs

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

package/package.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/waas-evm",
-  "version": "5.4.0",
+  "version": "5.5.0",
   "description": "A React SDK for implementing wallet web3 authentication and authorization to your website.",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -18,15 +18,16 @@
   },
   "homepage": "https://www.dynamic.xyz/",
   "dependencies": {
+    "@dynamic-labs/ethereum-gasless-core": "5.5.0",
     "@dynamic-labs/sdk-api-core": "0.12.0",
     "viem": "^2.45.3",
-    "@dynamic-labs/assert-package-version": "5.4.0",
-    "@dynamic-labs/ethereum-core": "5.4.0",
-    "@dynamic-labs/logger": "5.4.0",
-    "@dynamic-labs/types": "5.4.0",
-    "@dynamic-labs/utils": "5.4.0",
-    "@dynamic-labs/waas": "5.4.0",
-    "@dynamic-labs/wallet-connector-core": "5.4.0"
+    "@dynamic-labs/assert-package-version": "5.5.0",
+    "@dynamic-labs/ethereum-core": "5.5.0",
+    "@dynamic-labs/logger": "5.5.0",
+    "@dynamic-labs/types": "5.5.0",
+    "@dynamic-labs/utils": "5.5.0",
+    "@dynamic-labs/waas": "5.5.0",
+    "@dynamic-labs/wallet-connector-core": "5.5.0"
   },
   "peerDependencies": {}
 }

package/src/DynamicWaasEVMConnector.cjs

@@ -8,11 +8,14 @@ var viem = require('viem');
 var accounts = require('viem/accounts');
 var utils$1 = require('viem/utils');
 var ethereumCore = require('@dynamic-labs/ethereum-core');
+var ethereumGaslessCore = require('@dynamic-labs/ethereum-gasless-core');
 var logger$1 = require('@dynamic-labs/logger');
 var sdkApiCore = require('@dynamic-labs/sdk-api-core');
 var utils = require('@dynamic-labs/utils');
 var waas = require('@dynamic-labs/waas');
 var walletConnectorCore = require('@dynamic-labs/wallet-connector-core');
+var toSponsoredTransactionCalls = require('./gasless/toSponsoredTransactionCalls/toSponsoredTransactionCalls.cjs');
+var withBigintSafeSignTypedData = require('./gasless/withBigintSafeSignTypedData/withBigintSafeSignTypedData.cjs');
 
 const logger = new logger$1.Logger('DynamicWaasConnector');
 class DynamicWaasEVMConnector extends waas.withDynamicWaas(ethereumCore.EthereumWalletConnector) {
@@ -43,6 +46,9 @@ class DynamicWaasEVMConnector extends waas.withDynamicWaas(ethereumCore.Ethereum
         this.logger = logger;
         this.overrideKey = 'dynamicwaas';
         this.isEmbeddedWallet = true;
+        this.getEvmGasSponsorshipEnabled = () => false;
+        this.getSponsorshipSdkApi = undefined;
+        this.delegation7702Registry = ethereumGaslessCore.create7702DelegationRegistry();
         /**
          * Chain IDs that have dedicated connectors and should not be handled by this connector.
          * Networks with these chain IDs are filtered from network lists and rejected during switching.
@@ -475,88 +481,162 @@ class DynamicWaasEVMConnector extends waas.withDynamicWaas(ethereumCore.Ethereum
         return this.getWalletClient();
     }
     // Chain-specific override for exportClientKeyshares - EVM needs to set active account first
-    exportClientKeyshares(_a) {
+    exportClientKeyshares(params) {
         const _super = Object.create(null, {
             exportClientKeyshares: { get: () => super.exportClientKeyshares }
         });
-        return _tslib.__awaiter(this, arguments, void 0, function* ({ accountAddress, password, }) {
-            if (!accountAddress) {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            if (!params.accountAddress) {
                 throw new Error('Account address is required');
             }
             // EVM-specific: set active account before exporting
-            this.setActiveAccount(accountAddress);
-            return _super.exportClientKeyshares.call(this, { accountAddress, password });
+            this.setActiveAccount(params.accountAddress);
+            return _super.exportClientKeyshares.call(this, params);
         });
     }
     // Chain-specific override for backupKeySharesToGoogleDrive - EVM needs to set active account first
-    backupKeySharesToGoogleDrive(_a) {
+    backupKeySharesToGoogleDrive(params) {
         const _super = Object.create(null, {
             backupKeySharesToGoogleDrive: { get: () => super.backupKeySharesToGoogleDrive }
         });
-        return _tslib.__awaiter(this, arguments, void 0, function* ({ accountAddress, password, googleDriveAccessToken, }) {
-            if (!accountAddress) {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            if (!params.accountAddress) {
                 throw new Error('Account address is required');
             }
             // EVM-specific: set active account before backing up
-            this.setActiveAccount(accountAddress);
-            return _super.backupKeySharesToGoogleDrive.call(this, {
-                accountAddress,
-                googleDriveAccessToken,
-                password,
-            });
+            this.setActiveAccount(params.accountAddress);
+            return _super.backupKeySharesToGoogleDrive.call(this, params);
         });
     }
     // Chain-specific override for refreshWalletAccountShares - EVM needs to set active account first
-    refreshWalletAccountShares(_a) {
+    refreshWalletAccountShares(params) {
         const _super = Object.create(null, {
             refreshWalletAccountShares: { get: () => super.refreshWalletAccountShares }
         });
-        return _tslib.__awaiter(this, arguments, void 0, function* ({ accountAddress, password, }) {
-            if (!accountAddress) {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            if (!params.accountAddress) {
                 throw new Error('Account address is required');
             }
             // EVM-specific: set active account before refreshing
-            this.setActiveAccount(accountAddress);
-            return _super.refreshWalletAccountShares.call(this, { accountAddress, password });
+            this.setActiveAccount(params.accountAddress);
+            return _super.refreshWalletAccountShares.call(this, params);
         });
     }
     // Chain-specific override for reshareWalletAccountShares - EVM needs to set active account first
-    reshareWalletAccountShares(_a) {
+    reshareWalletAccountShares(params) {
         const _super = Object.create(null, {
             reshareWalletAccountShares: { get: () => super.reshareWalletAccountShares }
         });
-        return _tslib.__awaiter(this, arguments, void 0, function* ({ accountAddress, password, thresholdSignatureScheme, }) {
-            if (!accountAddress) {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            if (!params.accountAddress) {
                 throw new Error('Account address is required');
             }
-            this.setActiveAccount(accountAddress);
-            return _super.reshareWalletAccountShares.call(this, {
-                accountAddress,
-                password,
-                thresholdSignatureScheme,
-            });
+            this.setActiveAccount(params.accountAddress);
+            return _super.reshareWalletAccountShares.call(this, params);
         });
     }
     // Chain-specific override for updatePassword - EVM needs to set active account first
-    updatePassword(_a) {
+    updatePassword(params) {
         const _super = Object.create(null, {
             updatePassword: { get: () => super.updatePassword }
         });
-        return _tslib.__awaiter(this, arguments, void 0, function* ({ accountAddress, existingPassword, newPassword, }) {
-            if (!accountAddress) {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            if (!params.accountAddress) {
                 throw new Error('Account address is required');
             }
             // EVM-specific: set active account before updating password
-            this.setActiveAccount(accountAddress);
-            return _super.updatePassword.call(this, {
+            this.setActiveAccount(params.accountAddress);
+            return _super.updatePassword.call(this, params);
+        });
+    }
+    /**
+     * Registers the project's EVM gas sponsorship configuration so the send flow
+     * can route transactions through the sponsored relay instead of paying fees
+     * from the wallet's native balance.
+     */
+    setEvmGasSponsorshipConfig({ getEnabled, getSdkApi, }) {
+        this.getEvmGasSponsorshipEnabled = getEnabled;
+        this.getSponsorshipSdkApi = getSdkApi;
+    }
+    /**
+     * Sponsorship requires the project setting, an SDK API client and a relayer
+     * funded for the wallet's current chain. Anything missing means the send flow
+     * pays fees from the wallet's native balance.
+     */
+    isGasSponsorshipAvailable() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const { environmentId } = this;
+            if (!this.getEvmGasSponsorshipEnabled() || !environmentId) {
+                return false;
+            }
+            const sdkApi = (_a = this.getSponsorshipSdkApi) === null || _a === void 0 ? void 0 : _a.call(this);
+            if (!sdkApi) {
+                return false;
+            }
+            const evmNetwork = this.currentEvmNetwork();
+            if (!evmNetwork) {
+                return false;
+            }
+            try {
+                yield ethereumGaslessCore.getAvailableEvmGaslessRelayer({ chainId: Number(evmNetwork.chainId) }, { environmentId, sdkApi });
+                return true;
+            }
+            catch (_b) {
+                logger.debug('No EVM gasless relayer available for chain');
+                return false;
+            }
+        });
+    }
+    sendSponsoredUiTransaction(_a) {
+        return _tslib.__awaiter(this, arguments, void 0, function* ({ accountAddress, sponsoredChainId, transaction, }) {
+            var _b, _c;
+            const sdkApi = (_b = this.getSponsorshipSdkApi) === null || _b === void 0 ? void 0 : _b.call(this);
+            if (!sdkApi || !this.environmentId) {
+                throw new utils.DynamicError('Gas sponsorship is not configured', 'gas_sponsorship_not_configured');
+            }
+            const evmNetwork = this.currentEvmNetwork();
+            if (!evmNetwork) {
+                throw new utils.DynamicError('EVM network not found', 'evm_network_not_found');
+            }
+            if (Number(evmNetwork.chainId) !== sponsoredChainId) {
+                throw new utils.DynamicError('Gas sponsorship was not verified for the active chain', 'gas_sponsorship_chain_mismatch');
+            }
+            const publicClient = yield this.getPublicClient();
+            if (!publicClient) {
+                throw new utils.DynamicError('No public client available', 'no_public_client_available');
+            }
+            const accountSource = yield this.getViemAccountCustomSource({
                 accountAddress,
-                existingPassword,
-                newPassword,
             });
+            const sponsorshipWalletClient = viem.createWalletClient({
+                account: accounts.toAccount(withBigintSafeSignTypedData.withBigintSafeSignTypedData(accountSource)),
+                chain: ethereumCore.getOrMapViemChain(evmNetwork),
+                transport: viem.http(this.getRpcUrl(evmNetwork), this.providersConfig.httpTransportConfig),
+            });
+            const calls = toSponsoredTransactionCalls.toSponsoredTransactionCalls({
+                nonNativeAddress: transaction.nonNativeAddress,
+                nonNativeValue: transaction.nonNativeValue,
+                to: (_c = transaction.to) !== null && _c !== void 0 ? _c : undefined,
+                value: transaction.value,
+            });
+            const { transactionHash } = yield ethereumGaslessCore.sendSponsoredTransaction({
+                autoDelegate: true,
+                calls,
+            }, {
+                chainId: Number(evmNetwork.chainId),
+                delegationRegistry: this.delegation7702Registry,
+                environmentId: this.environmentId,
+                publicClient: publicClient,
+                sdkApi,
+                walletClient: sponsorshipWalletClient,
+            });
+            return transactionHash;
         });
     }
     createUiTransaction(from) {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
+            var _a;
             yield this.validateActiveWallet(from);
             const walletClient = this.getWalletClient();
             const publicClient = yield this.getPublicClient();
@@ -566,9 +646,19 @@ class DynamicWaasEVMConnector extends waas.withDynamicWaas(ethereumCore.Ethereum
             if (!publicClient || !walletClient) {
                 throw new utils.DynamicError('No public client available', 'no_public_client_available');
             }
+            const isGasSponsored = yield this.isGasSponsorshipAvailable();
+            const sponsoredChainId = Number((_a = this.currentEvmNetwork()) === null || _a === void 0 ? void 0 : _a.chainId);
             return new ethereumCore.ViemUiTransaction({
                 account: from,
+                isGasSponsored,
                 onSubmit: (transaction) => _tslib.__awaiter(this, void 0, void 0, function* () {
+                    if (isGasSponsored) {
+                        return this.sendSponsoredUiTransaction({
+                            accountAddress: from,
+                            sponsoredChainId,
+                            transaction,
+                        });
+                    }
                     // Non native token
                     if (transaction.nonNativeAddress) {
                         return walletClient.writeContract({

package/src/DynamicWaasEVMConnector.d.ts

@@ -2,10 +2,10 @@ import { Account, CustomSource, Hex, Transport, Chain as ViemChain, WalletClient
 import { LocalAccount, SignAuthorizationParameters, SignAuthorizationReturnType } from 'viem/accounts';
 import { EthereumWalletConnector, EthereumWalletConnectorOpts, SwitchNetworkOps } from '@dynamic-labs/ethereum-core';
 import { Logger } from '@dynamic-labs/logger';
-import { JwtVerifiedCredential, MFAAction, SignMessageContext, TokenScope } from '@dynamic-labs/sdk-api-core';
+import { JwtVerifiedCredential, MFAAction, SDKApi, SignMessageContext, TokenScope } from '@dynamic-labs/sdk-api-core';
 import { IUITransaction } from '@dynamic-labs/types';
 import { WaasExportHandler } from '@dynamic-labs/waas';
-import { IDynamicWaasConnector } from '@dynamic-labs/wallet-connector-core';
+import { BackupKeySharesToGoogleDriveParams, ExportClientKeysharesParams, IDynamicWaasConnector, RefreshWalletAccountSharesParams, ReshareWalletAccountSharesParams, UpdatePasswordParams } from '@dynamic-labs/wallet-connector-core';
 type EvmNetwork = EthereumWalletConnector['evmNetworks'][number];
 interface JwtVerifiedCredentialWithSmartWalletRef extends JwtVerifiedCredential {
     smartWalletRefId?: string;
@@ -60,6 +60,14 @@ declare const DynamicWaasEVMConnector_base: (abstract new (...args: any[]) => {
     }): Promise<string | undefined>;
     setEnvironmentId(environmentId: string): void;
     setBaseApiUrl(baseApiUrl: string): void;
+    /**
+     * Override getEnabledNetworks to filter out unsupported networks.
+     * This is the UI-facing method used by network pickers.
+     *
+     * Note: We override getEnabledNetworks() instead of the evmNetworks getter because
+     * evmNetworks is a class field in EthereumWalletConnector, and class fields create
+     * own properties that shadow prototype-based getters/setters.
+     */
     setBaseClientKeysharesRelayApiUrl(baseClientKeysharesRelayApiUrl?: string | undefined): void;
     setRelayUrl(relayUrl: string): void;
     setGetSignedSessionIdFunction(getSignedSessionId: () => Promise<string>): void;
@@ -76,12 +84,7 @@ declare const DynamicWaasEVMConnector_base: (abstract new (...args: any[]) => {
     getWaasWalletClient(traceContext?: import("dist/packages/waas/utils/instrumentation").TraceContext | undefined, { forceRebuild }?: {
         forceRebuild?: boolean | undefined;
     } | undefined): Promise<import("@dynamic-labs-wallet/browser-wallet-client").DynamicWalletClient>;
-    createWalletAccount({ thresholdSignatureScheme, password, bitcoinConfig, businessAccountId, }?: {
-        thresholdSignatureScheme?: string | undefined;
-        password?: string | undefined;
-        bitcoinConfig?: import("@dynamic-labs-wallet/browser-wallet-client").BitcoinConfig | undefined;
-        businessAccountId?: string | undefined;
-    } | undefined): Promise<{
+    createWalletAccount({ thresholdSignatureScheme, password, bitcoinConfig, businessAccountId, }?: import("@dynamic-labs/wallet-connector-core").CreateWalletAccountParams | undefined): Promise<{
         chainName: string;
         accountAddress: string;
         publicKeyHex: string;
@@ -101,15 +104,7 @@ declare const DynamicWaasEVMConnector_base: (abstract new (...args: any[]) => {
     }): Promise<{
         shareSetId: string;
     }>;
-    importPrivateKey({ privateKey, thresholdSignatureScheme, publicAddressCheck, addressType, legacyWalletId, password, isRawScalarImport, }: {
-        privateKey: string;
-        thresholdSignatureScheme?: string | undefined;
-        publicAddressCheck?: string | undefined;
-        addressType?: string | undefined;
-        legacyWalletId?: string | undefined;
-        password?: string | undefined;
-        isRawScalarImport?: boolean | undefined;
-    }): Promise<void>;
+    importPrivateKey({ privateKey, thresholdSignatureScheme, publicAddressCheck, addressType, legacyWalletId, password, isRawScalarImport, }: import("@dynamic-labs/wallet-connector-core").ImportPrivateKeyParams): Promise<void>;
     migrateFromFireblocks({ deviceId, jwt, walletPassword, ncwStorage, expectedAddresses, coinTypes, password, }: {
         deviceId: string;
         jwt: string;
@@ -127,10 +122,7 @@ declare const DynamicWaasEVMConnector_base: (abstract new (...args: any[]) => {
     getExportHandler(): {
         clear: () => void;
     };
-    exportClientKeyshares({ accountAddress, password, }: {
-        accountAddress: string;
-        password?: string | undefined;
-    }): Promise<void>;
+    exportClientKeyshares({ accountAddress, password, }: ExportClientKeysharesParams): Promise<void>;
     runBackupLifecycle({ provider, accountAddress, password, performBackup, }: {
         provider: string;
         accountAddress: string;
@@ -146,11 +138,7 @@ declare const DynamicWaasEVMConnector_base: (abstract new (...args: any[]) => {
             };
         }) => Promise<void>;
     }): Promise<void>;
-    backupKeySharesToGoogleDrive({ accountAddress, password, googleDriveAccessToken, }: {
-        accountAddress: string;
-        password?: string | undefined;
-        googleDriveAccessToken?: string | undefined;
-    }): Promise<void>;
+    backupKeySharesToGoogleDrive({ accountAddress, password, googleDriveAccessToken, }: BackupKeySharesToGoogleDriveParams): Promise<void>;
     exportClientKeysharesFromGoogleDrive({ accountAddress, password, }: {
         accountAddress: string;
         password?: string | undefined;
@@ -164,24 +152,13 @@ declare const DynamicWaasEVMConnector_base: (abstract new (...args: any[]) => {
     }): Promise<void>;
     hideICloudSignIn(): Promise<void>;
     isICloudAuthenticated(): Promise<boolean>;
-    refreshWalletAccountShares({ accountAddress, password, }: {
-        accountAddress: string;
-        password?: string | undefined;
-    }): Promise<void>;
-    reshareWalletAccountShares({ accountAddress, thresholdSignatureScheme, password, }: {
-        accountAddress: string;
-        thresholdSignatureScheme: string;
-        password?: string | undefined;
-    }): Promise<void>;
+    refreshWalletAccountShares({ accountAddress, password, }: RefreshWalletAccountSharesParams): Promise<void>;
+    reshareWalletAccountShares({ accountAddress, thresholdSignatureScheme, password, }: ReshareWalletAccountSharesParams): Promise<void>;
     revokeDelegation({ accountAddress, password, }: {
         accountAddress: string;
         password?: string | undefined;
     }): Promise<void>;
-    updatePassword({ accountAddress, existingPassword, newPassword, }: {
-        accountAddress: string;
-        existingPassword?: string | undefined;
-        newPassword: string;
-    }): Promise<void>;
+    updatePassword({ accountAddress, existingPassword, newPassword, }: UpdatePasswordParams): Promise<void>;
     setPassword({ accountAddress, newPassword, }: {
         accountAddress: string;
         newPassword: string;
@@ -241,6 +218,9 @@ export declare class DynamicWaasEVMConnector extends DynamicWaasEVMConnector_bas
     logger: Logger;
     overrideKey: string;
     isEmbeddedWallet: boolean;
+    private getEvmGasSponsorshipEnabled;
+    private getSponsorshipSdkApi;
+    private delegation7702Registry;
     /**
      * Chain IDs that have dedicated connectors and should not be handled by this connector.
      * Networks with these chain IDs are filtered from network lists and rejected during switching.
@@ -305,29 +285,27 @@ export declare class DynamicWaasEVMConnector extends DynamicWaasEVMConnector_bas
     getWalletClientByAddress({ accountAddress, }: {
         accountAddress: string;
     }): WalletClient<Transport, ViemChain, Account> | undefined;
-    exportClientKeyshares({ accountAddress, password, }: {
-        accountAddress: string;
-        password?: string;
-    }): Promise<void>;
-    backupKeySharesToGoogleDrive({ accountAddress, password, googleDriveAccessToken, }: {
-        accountAddress: string;
-        password?: string;
-        googleDriveAccessToken?: string;
-    }): Promise<void>;
-    refreshWalletAccountShares({ accountAddress, password, }: {
-        accountAddress: string;
-        password?: string;
-    }): Promise<void>;
-    reshareWalletAccountShares({ accountAddress, password, thresholdSignatureScheme, }: {
-        accountAddress: string;
-        password?: string;
-        thresholdSignatureScheme: string;
-    }): Promise<void>;
-    updatePassword({ accountAddress, existingPassword, newPassword, }: {
-        accountAddress: string;
-        existingPassword: string;
-        newPassword: string;
-    }): Promise<void>;
+    exportClientKeyshares(params: ExportClientKeysharesParams): Promise<void>;
+    backupKeySharesToGoogleDrive(params: BackupKeySharesToGoogleDriveParams): Promise<void>;
+    refreshWalletAccountShares(params: RefreshWalletAccountSharesParams): Promise<void>;
+    reshareWalletAccountShares(params: ReshareWalletAccountSharesParams): Promise<void>;
+    updatePassword(params: UpdatePasswordParams): Promise<void>;
+    /**
+     * Registers the project's EVM gas sponsorship configuration so the send flow
+     * can route transactions through the sponsored relay instead of paying fees
+     * from the wallet's native balance.
+     */
+    setEvmGasSponsorshipConfig({ getEnabled, getSdkApi, }: {
+        getEnabled: () => boolean;
+        getSdkApi: () => SDKApi;
+    }): void;
+    /**
+     * Sponsorship requires the project setting, an SDK API client and a relayer
+     * funded for the wallet's current chain. Anything missing means the send flow
+     * pays fees from the wallet's native balance.
+     */
+    private isGasSponsorshipAvailable;
+    private sendSponsoredUiTransaction;
     createUiTransaction(from: string): Promise<IUITransaction>;
     getConnectedAccounts(): Promise<string[]>;
     getAddress(): Promise<string>;

package/src/DynamicWaasEVMConnector.js

@@ -1,14 +1,17 @@
 'use client'
 import { __awaiter } from '../_virtual/_tslib.js';
-import { http, serializeTransaction, erc20Abi, parseSignature } from 'viem';
+import { http, serializeTransaction, createWalletClient, erc20Abi, parseSignature } from 'viem';
 import { toAccount } from 'viem/accounts';
 import { hashAuthorization } from 'viem/utils';
 import { EthereumWalletConnector, createWalletClientWithUiConfirmation, getOrMapViemChain, ViemUiTransaction } from '@dynamic-labs/ethereum-core';
+import { create7702DelegationRegistry, getAvailableEvmGaslessRelayer, sendSponsoredTransaction } from '@dynamic-labs/ethereum-gasless-core';
 import { Logger } from '@dynamic-labs/logger';
 import { MFAAction, TokenScope } from '@dynamic-labs/sdk-api-core';
 import { DynamicError } from '@dynamic-labs/utils';
 import { withDynamicWaas, WaasExportHandler } from '@dynamic-labs/waas';
 import { isSameAddress } from '@dynamic-labs/wallet-connector-core';
+import { toSponsoredTransactionCalls } from './gasless/toSponsoredTransactionCalls/toSponsoredTransactionCalls.js';
+import { withBigintSafeSignTypedData } from './gasless/withBigintSafeSignTypedData/withBigintSafeSignTypedData.js';
 
 const logger = new Logger('DynamicWaasConnector');
 class DynamicWaasEVMConnector extends withDynamicWaas(EthereumWalletConnector) {
@@ -39,6 +42,9 @@ class DynamicWaasEVMConnector extends withDynamicWaas(EthereumWalletConnector) {
         this.logger = logger;
         this.overrideKey = 'dynamicwaas';
         this.isEmbeddedWallet = true;
+        this.getEvmGasSponsorshipEnabled = () => false;
+        this.getSponsorshipSdkApi = undefined;
+        this.delegation7702Registry = create7702DelegationRegistry();
         /**
          * Chain IDs that have dedicated connectors and should not be handled by this connector.
          * Networks with these chain IDs are filtered from network lists and rejected during switching.
@@ -471,88 +477,162 @@ class DynamicWaasEVMConnector extends withDynamicWaas(EthereumWalletConnector) {
         return this.getWalletClient();
     }
     // Chain-specific override for exportClientKeyshares - EVM needs to set active account first
-    exportClientKeyshares(_a) {
+    exportClientKeyshares(params) {
         const _super = Object.create(null, {
             exportClientKeyshares: { get: () => super.exportClientKeyshares }
         });
-        return __awaiter(this, arguments, void 0, function* ({ accountAddress, password, }) {
-            if (!accountAddress) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!params.accountAddress) {
                 throw new Error('Account address is required');
             }
             // EVM-specific: set active account before exporting
-            this.setActiveAccount(accountAddress);
-            return _super.exportClientKeyshares.call(this, { accountAddress, password });
+            this.setActiveAccount(params.accountAddress);
+            return _super.exportClientKeyshares.call(this, params);
         });
     }
     // Chain-specific override for backupKeySharesToGoogleDrive - EVM needs to set active account first
-    backupKeySharesToGoogleDrive(_a) {
+    backupKeySharesToGoogleDrive(params) {
         const _super = Object.create(null, {
             backupKeySharesToGoogleDrive: { get: () => super.backupKeySharesToGoogleDrive }
         });
-        return __awaiter(this, arguments, void 0, function* ({ accountAddress, password, googleDriveAccessToken, }) {
-            if (!accountAddress) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!params.accountAddress) {
                 throw new Error('Account address is required');
             }
             // EVM-specific: set active account before backing up
-            this.setActiveAccount(accountAddress);
-            return _super.backupKeySharesToGoogleDrive.call(this, {
-                accountAddress,
-                googleDriveAccessToken,
-                password,
-            });
+            this.setActiveAccount(params.accountAddress);
+            return _super.backupKeySharesToGoogleDrive.call(this, params);
         });
     }
     // Chain-specific override for refreshWalletAccountShares - EVM needs to set active account first
-    refreshWalletAccountShares(_a) {
+    refreshWalletAccountShares(params) {
         const _super = Object.create(null, {
             refreshWalletAccountShares: { get: () => super.refreshWalletAccountShares }
         });
-        return __awaiter(this, arguments, void 0, function* ({ accountAddress, password, }) {
-            if (!accountAddress) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!params.accountAddress) {
                 throw new Error('Account address is required');
             }
             // EVM-specific: set active account before refreshing
-            this.setActiveAccount(accountAddress);
-            return _super.refreshWalletAccountShares.call(this, { accountAddress, password });
+            this.setActiveAccount(params.accountAddress);
+            return _super.refreshWalletAccountShares.call(this, params);
         });
     }
     // Chain-specific override for reshareWalletAccountShares - EVM needs to set active account first
-    reshareWalletAccountShares(_a) {
+    reshareWalletAccountShares(params) {
         const _super = Object.create(null, {
             reshareWalletAccountShares: { get: () => super.reshareWalletAccountShares }
         });
-        return __awaiter(this, arguments, void 0, function* ({ accountAddress, password, thresholdSignatureScheme, }) {
-            if (!accountAddress) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!params.accountAddress) {
                 throw new Error('Account address is required');
             }
-            this.setActiveAccount(accountAddress);
-            return _super.reshareWalletAccountShares.call(this, {
-                accountAddress,
-                password,
-                thresholdSignatureScheme,
-            });
+            this.setActiveAccount(params.accountAddress);
+            return _super.reshareWalletAccountShares.call(this, params);
         });
     }
     // Chain-specific override for updatePassword - EVM needs to set active account first
-    updatePassword(_a) {
+    updatePassword(params) {
         const _super = Object.create(null, {
             updatePassword: { get: () => super.updatePassword }
         });
-        return __awaiter(this, arguments, void 0, function* ({ accountAddress, existingPassword, newPassword, }) {
-            if (!accountAddress) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!params.accountAddress) {
                 throw new Error('Account address is required');
             }
             // EVM-specific: set active account before updating password
-            this.setActiveAccount(accountAddress);
-            return _super.updatePassword.call(this, {
+            this.setActiveAccount(params.accountAddress);
+            return _super.updatePassword.call(this, params);
+        });
+    }
+    /**
+     * Registers the project's EVM gas sponsorship configuration so the send flow
+     * can route transactions through the sponsored relay instead of paying fees
+     * from the wallet's native balance.
+     */
+    setEvmGasSponsorshipConfig({ getEnabled, getSdkApi, }) {
+        this.getEvmGasSponsorshipEnabled = getEnabled;
+        this.getSponsorshipSdkApi = getSdkApi;
+    }
+    /**
+     * Sponsorship requires the project setting, an SDK API client and a relayer
+     * funded for the wallet's current chain. Anything missing means the send flow
+     * pays fees from the wallet's native balance.
+     */
+    isGasSponsorshipAvailable() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const { environmentId } = this;
+            if (!this.getEvmGasSponsorshipEnabled() || !environmentId) {
+                return false;
+            }
+            const sdkApi = (_a = this.getSponsorshipSdkApi) === null || _a === void 0 ? void 0 : _a.call(this);
+            if (!sdkApi) {
+                return false;
+            }
+            const evmNetwork = this.currentEvmNetwork();
+            if (!evmNetwork) {
+                return false;
+            }
+            try {
+                yield getAvailableEvmGaslessRelayer({ chainId: Number(evmNetwork.chainId) }, { environmentId, sdkApi });
+                return true;
+            }
+            catch (_b) {
+                logger.debug('No EVM gasless relayer available for chain');
+                return false;
+            }
+        });
+    }
+    sendSponsoredUiTransaction(_a) {
+        return __awaiter(this, arguments, void 0, function* ({ accountAddress, sponsoredChainId, transaction, }) {
+            var _b, _c;
+            const sdkApi = (_b = this.getSponsorshipSdkApi) === null || _b === void 0 ? void 0 : _b.call(this);
+            if (!sdkApi || !this.environmentId) {
+                throw new DynamicError('Gas sponsorship is not configured', 'gas_sponsorship_not_configured');
+            }
+            const evmNetwork = this.currentEvmNetwork();
+            if (!evmNetwork) {
+                throw new DynamicError('EVM network not found', 'evm_network_not_found');
+            }
+            if (Number(evmNetwork.chainId) !== sponsoredChainId) {
+                throw new DynamicError('Gas sponsorship was not verified for the active chain', 'gas_sponsorship_chain_mismatch');
+            }
+            const publicClient = yield this.getPublicClient();
+            if (!publicClient) {
+                throw new DynamicError('No public client available', 'no_public_client_available');
+            }
+            const accountSource = yield this.getViemAccountCustomSource({
                 accountAddress,
-                existingPassword,
-                newPassword,
             });
+            const sponsorshipWalletClient = createWalletClient({
+                account: toAccount(withBigintSafeSignTypedData(accountSource)),
+                chain: getOrMapViemChain(evmNetwork),
+                transport: http(this.getRpcUrl(evmNetwork), this.providersConfig.httpTransportConfig),
+            });
+            const calls = toSponsoredTransactionCalls({
+                nonNativeAddress: transaction.nonNativeAddress,
+                nonNativeValue: transaction.nonNativeValue,
+                to: (_c = transaction.to) !== null && _c !== void 0 ? _c : undefined,
+                value: transaction.value,
+            });
+            const { transactionHash } = yield sendSponsoredTransaction({
+                autoDelegate: true,
+                calls,
+            }, {
+                chainId: Number(evmNetwork.chainId),
+                delegationRegistry: this.delegation7702Registry,
+                environmentId: this.environmentId,
+                publicClient: publicClient,
+                sdkApi,
+                walletClient: sponsorshipWalletClient,
+            });
+            return transactionHash;
         });
     }
     createUiTransaction(from) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a;
             yield this.validateActiveWallet(from);
             const walletClient = this.getWalletClient();
             const publicClient = yield this.getPublicClient();
@@ -562,9 +642,19 @@ class DynamicWaasEVMConnector extends withDynamicWaas(EthereumWalletConnector) {
             if (!publicClient || !walletClient) {
                 throw new DynamicError('No public client available', 'no_public_client_available');
             }
+            const isGasSponsored = yield this.isGasSponsorshipAvailable();
+            const sponsoredChainId = Number((_a = this.currentEvmNetwork()) === null || _a === void 0 ? void 0 : _a.chainId);
             return new ViemUiTransaction({
                 account: from,
+                isGasSponsored,
                 onSubmit: (transaction) => __awaiter(this, void 0, void 0, function* () {
+                    if (isGasSponsored) {
+                        return this.sendSponsoredUiTransaction({
+                            accountAddress: from,
+                            sponsoredChainId,
+                            transaction,
+                        });
+                    }
                     // Non native token
                     if (transaction.nonNativeAddress) {
                         return walletClient.writeContract({

package/src/gasless/toSponsoredTransactionCalls/toSponsoredTransactionCalls.cjs

@@ -0,0 +1,39 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var viem = require('viem');
+var utils = require('@dynamic-labs/utils');
+
+/**
+ * Maps a UI transaction to the batch of calls the sponsored-transaction
+ * delegate executes on behalf of the wallet.
+ */
+const toSponsoredTransactionCalls = ({ to, value, nonNativeAddress, nonNativeValue, }) => {
+    if (!to) {
+        throw new utils.DynamicError('Missing recipient, cannot sponsor transaction', 'sponsorship_missing_recipient');
+    }
+    if (nonNativeAddress) {
+        return [
+            {
+                data: viem.encodeFunctionData({
+                    abi: viem.erc20Abi,
+                    args: [to, nonNativeValue !== null && nonNativeValue !== void 0 ? nonNativeValue : BigInt(0)],
+                    functionName: 'transfer',
+                }),
+                target: nonNativeAddress,
+                value: BigInt(0),
+            },
+        ];
+    }
+    return [
+        {
+            data: '0x',
+            target: to,
+            value: value !== null && value !== void 0 ? value : BigInt(0),
+        },
+    ];
+};
+
+exports.toSponsoredTransactionCalls = toSponsoredTransactionCalls;

package/src/gasless/toSponsoredTransactionCalls/toSponsoredTransactionCalls.d.ts

@@ -0,0 +1,13 @@
+import type { SponsoredTransactionCall } from '@dynamic-labs/ethereum-gasless-core';
+type ToSponsoredTransactionCallsParams = {
+    to: string | undefined;
+    value: bigint | undefined;
+    nonNativeAddress?: string;
+    nonNativeValue?: bigint;
+};
+/**
+ * Maps a UI transaction to the batch of calls the sponsored-transaction
+ * delegate executes on behalf of the wallet.
+ */
+export declare const toSponsoredTransactionCalls: ({ to, value, nonNativeAddress, nonNativeValue, }: ToSponsoredTransactionCallsParams) => SponsoredTransactionCall[];
+export {};

package/src/gasless/toSponsoredTransactionCalls/toSponsoredTransactionCalls.js

@@ -0,0 +1,35 @@
+'use client'
+import { encodeFunctionData, erc20Abi } from 'viem';
+import { DynamicError } from '@dynamic-labs/utils';
+
+/**
+ * Maps a UI transaction to the batch of calls the sponsored-transaction
+ * delegate executes on behalf of the wallet.
+ */
+const toSponsoredTransactionCalls = ({ to, value, nonNativeAddress, nonNativeValue, }) => {
+    if (!to) {
+        throw new DynamicError('Missing recipient, cannot sponsor transaction', 'sponsorship_missing_recipient');
+    }
+    if (nonNativeAddress) {
+        return [
+            {
+                data: encodeFunctionData({
+                    abi: erc20Abi,
+                    args: [to, nonNativeValue !== null && nonNativeValue !== void 0 ? nonNativeValue : BigInt(0)],
+                    functionName: 'transfer',
+                }),
+                target: nonNativeAddress,
+                value: BigInt(0),
+            },
+        ];
+    }
+    return [
+        {
+            data: '0x',
+            target: to,
+            value: value !== null && value !== void 0 ? value : BigInt(0),
+        },
+    ];
+};
+
+export { toSponsoredTransactionCalls };

package/src/gasless/withBigintSafeSignTypedData/withBigintSafeSignTypedData.cjs

@@ -0,0 +1,37 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var utils = require('@dynamic-labs/utils');
+
+const toJsonSafeValue = (value) => {
+    if (typeof value === 'bigint') {
+        return value.toString();
+    }
+    if (Array.isArray(value)) {
+        return value.map(toJsonSafeValue);
+    }
+    if (value !== null && typeof value === 'object') {
+        const entries = Object.entries(value).map(([key, nestedValue]) => [
+            key,
+            toJsonSafeValue(nestedValue),
+        ]);
+        return Object.fromEntries(entries);
+    }
+    return value;
+};
+/**
+ * Wraps a viem custom source so typed-data payloads are stripped of bigints
+ * before signing. The WaaS signing transport serializes messages as JSON and
+ * rejects bigint values, which EIP-712 sponsored-transaction intents contain.
+ */
+const withBigintSafeSignTypedData = (source) => {
+    const { signTypedData } = source;
+    if (!signTypedData) {
+        throw new utils.DynamicError('Custom source does not support signTypedData', 'sign_typed_data_not_supported');
+    }
+    return Object.assign(Object.assign({}, source), { signTypedData: (typedData) => signTypedData(toJsonSafeValue(typedData)) });
+};
+
+exports.withBigintSafeSignTypedData = withBigintSafeSignTypedData;

package/src/gasless/withBigintSafeSignTypedData/withBigintSafeSignTypedData.d.ts

@@ -0,0 +1,7 @@
+import { CustomSource } from 'viem';
+/**
+ * Wraps a viem custom source so typed-data payloads are stripped of bigints
+ * before signing. The WaaS signing transport serializes messages as JSON and
+ * rejects bigint values, which EIP-712 sponsored-transaction intents contain.
+ */
+export declare const withBigintSafeSignTypedData: (source: CustomSource) => CustomSource;

package/src/gasless/withBigintSafeSignTypedData/withBigintSafeSignTypedData.js

@@ -0,0 +1,33 @@
+'use client'
+import { DynamicError } from '@dynamic-labs/utils';
+
+const toJsonSafeValue = (value) => {
+    if (typeof value === 'bigint') {
+        return value.toString();
+    }
+    if (Array.isArray(value)) {
+        return value.map(toJsonSafeValue);
+    }
+    if (value !== null && typeof value === 'object') {
+        const entries = Object.entries(value).map(([key, nestedValue]) => [
+            key,
+            toJsonSafeValue(nestedValue),
+        ]);
+        return Object.fromEntries(entries);
+    }
+    return value;
+};
+/**
+ * Wraps a viem custom source so typed-data payloads are stripped of bigints
+ * before signing. The WaaS signing transport serializes messages as JSON and
+ * rejects bigint values, which EIP-712 sponsored-transaction intents contain.
+ */
+const withBigintSafeSignTypedData = (source) => {
+    const { signTypedData } = source;
+    if (!signTypedData) {
+        throw new DynamicError('Custom source does not support signTypedData', 'sign_typed_data_not_supported');
+    }
+    return Object.assign(Object.assign({}, source), { signTypedData: (typedData) => signTypedData(toJsonSafeValue(typedData)) });
+};
+
+export { withBigintSafeSignTypedData };