@dynamic-labs/ethereum-gasless-core 4.100.0 → 4.100.2

package/CHANGELOG.md

@@ -1,4 +1,19 @@
 
+### [4.100.2](https://github.com/dynamic-labs/dynamic-auth/compare/v4.100.1...v4.100.2) (2026-09-17)
+
+
+### Bug Fixes
+
+* **webview-controller:** route MetaMask connector storage through native secure storage [V4 backport] ([#12418](https://github.com/dynamic-labs/dynamic-auth/issues/12418)) ([0a9047c](https://github.com/dynamic-labs/dynamic-auth/commit/0a9047c72f184fca3fd27116d0a9eaa0a5bc69e6)), closes [#12304](https://github.com/dynamic-labs/dynamic-auth/issues/12304)
+
+### [4.100.1](https://github.com/dynamic-labs/dynamic-auth/compare/v4.100.0...v4.100.1) (2026-09-16)
+
+
+### Bug Fixes
+
+* **ethereum-core:** prefer dashboard-saved RPC urls when mapping viem chains ([#12407](https://github.com/dynamic-labs/dynamic-auth/issues/12407)) ([e794605](https://github.com/dynamic-labs/dynamic-auth/commit/e79460541f5d99caee64e9f4699baa1bf1b36544))
+* **wallet-connect:** fix Rabby WalletConnect connection on Mobile [V4 backport] ([#12387](https://github.com/dynamic-labs/dynamic-auth/issues/12387)) ([a2f137f](https://github.com/dynamic-labs/dynamic-auth/commit/a2f137f5dc203f7fbfc4399b9999751c22851654))
+
 ## [4.100.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.99.0...v4.100.0) (2026-09-10)
 
 

package/package.cjs

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

package/package.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/ethereum-gasless-core",
-  "version": "4.100.0",
+  "version": "4.100.2",
   "main": "./src/index.cjs",
   "module": "./src/index.js",
   "types": "./src/index.d.ts",
@@ -14,8 +14,9 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@dynamic-labs/sdk-api-core": "0.12.0",
-    "@dynamic-labs/assert-package-version": "4.100.0"
+    "@dynamic-labs/sdk-api-core": "0.40.0",
+    "@dynamic-labs/assert-package-version": "4.100.2",
+    "@dynamic-labs/logger": "4.100.2"
   },
   "peerDependencies": {
     "viem": "^2.45.3"

package/src/lib/generateIntentNonce/generateIntentNonce.cjs

@@ -5,6 +5,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var constants = require('../constants.cjs');
 var generateRandomNonce = require('../generateRandomNonce/generateRandomNonce.cjs');
+var logger = require('../logger/logger.cjs');
 
 /**
  * Generates a random 256-bit bitmap nonce for UGD `AuthorizedExecutions`
@@ -16,7 +17,8 @@ var generateRandomNonce = require('../generateRandomNonce/generateRandomNonce.cj
  * fails (e.g. delegation not yet active), the random nonce is still safe to
  * use because it was generated locally with 256 bits of entropy.
  */
-const generateIntentNonce = async ({ walletAddress }, { publicClient }) => {
+const generateIntentNonce = async ({ walletAddress }, { chainId, publicClient }) => {
+    const startedAt = Date.now();
     const nonce = generateRandomNonce.generateRandomNonce();
     try {
         const isUsed = await publicClient.readContract({
@@ -26,13 +28,32 @@ const generateIntentNonce = async ({ walletAddress }, { publicClient }) => {
             functionName: 'isNonceUsed',
         });
         if (isUsed) {
+            logger.logger.instrument('[evm-gasless] generateIntentNonce - completed', {
+                chainId,
+                key: 'generateIntentNonce-completed',
+                nonceCheck: 'used',
+                time: Date.now() - startedAt,
+            });
             return generateRandomNonce.generateRandomNonce();
         }
     }
     catch {
         // Contract call may fail if delegation is not yet active — the nonce is
         // still safe to use since it was randomly generated.
+        logger.logger.instrument('[evm-gasless] generateIntentNonce - completed', {
+            chainId,
+            key: 'generateIntentNonce-completed',
+            nonceCheck: 'failed',
+            time: Date.now() - startedAt,
+        });
+        return nonce;
     }
+    logger.logger.instrument('[evm-gasless] generateIntentNonce - completed', {
+        chainId,
+        key: 'generateIntentNonce-completed',
+        nonceCheck: 'unused',
+        time: Date.now() - startedAt,
+    });
     return nonce;
 };
 

package/src/lib/generateIntentNonce/generateIntentNonce.d.ts

@@ -4,6 +4,8 @@ type GenerateIntentNonceParams = {
     walletAddress: Hex;
 };
 type GenerateIntentNonceDeps = {
+    /** Optional chain ID, included in instrumentation logs when provided. */
+    chainId?: number;
     publicClient: PublicClient<Transport, Chain>;
 };
 /**
@@ -16,5 +18,5 @@ type GenerateIntentNonceDeps = {
  * fails (e.g. delegation not yet active), the random nonce is still safe to
  * use because it was generated locally with 256 bits of entropy.
  */
-export declare const generateIntentNonce: ({ walletAddress }: GenerateIntentNonceParams, { publicClient }: GenerateIntentNonceDeps) => Promise<bigint>;
+export declare const generateIntentNonce: ({ walletAddress }: GenerateIntentNonceParams, { chainId, publicClient }: GenerateIntentNonceDeps) => Promise<bigint>;
 export {};

package/src/lib/generateIntentNonce/generateIntentNonce.js

@@ -1,6 +1,7 @@
 'use client'
 import { UGD_ABI } from '../constants.js';
 import { generateRandomNonce } from '../generateRandomNonce/generateRandomNonce.js';
+import { logger } from '../logger/logger.js';
 
 /**
  * Generates a random 256-bit bitmap nonce for UGD `AuthorizedExecutions`
@@ -12,7 +13,8 @@ import { generateRandomNonce } from '../generateRandomNonce/generateRandomNonce.
  * fails (e.g. delegation not yet active), the random nonce is still safe to
  * use because it was generated locally with 256 bits of entropy.
  */
-const generateIntentNonce = async ({ walletAddress }, { publicClient }) => {
+const generateIntentNonce = async ({ walletAddress }, { chainId, publicClient }) => {
+    const startedAt = Date.now();
     const nonce = generateRandomNonce();
     try {
         const isUsed = await publicClient.readContract({
@@ -22,13 +24,32 @@ const generateIntentNonce = async ({ walletAddress }, { publicClient }) => {
             functionName: 'isNonceUsed',
         });
         if (isUsed) {
+            logger.instrument('[evm-gasless] generateIntentNonce - completed', {
+                chainId,
+                key: 'generateIntentNonce-completed',
+                nonceCheck: 'used',
+                time: Date.now() - startedAt,
+            });
             return generateRandomNonce();
         }
     }
     catch {
         // Contract call may fail if delegation is not yet active — the nonce is
         // still safe to use since it was randomly generated.
+        logger.instrument('[evm-gasless] generateIntentNonce - completed', {
+            chainId,
+            key: 'generateIntentNonce-completed',
+            nonceCheck: 'failed',
+            time: Date.now() - startedAt,
+        });
+        return nonce;
     }
+    logger.instrument('[evm-gasless] generateIntentNonce - completed', {
+        chainId,
+        key: 'generateIntentNonce-completed',
+        nonceCheck: 'unused',
+        time: Date.now() - startedAt,
+    });
     return nonce;
 };
 

package/src/lib/getAvailableEvmGaslessRelayer/getAvailableEvmGaslessRelayer.cjs

@@ -4,6 +4,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var SponsorTransactionError = require('../errors/SponsorTransactionError/SponsorTransactionError.cjs');
+var logger = require('../logger/logger.cjs');
 
 /**
  * Fetches the relayer address to embed in the EIP-712 sponsored-transaction
@@ -15,6 +16,7 @@ var SponsorTransactionError = require('../errors/SponsorTransactionError/Sponsor
  * validates the signature against this address.
  */
 const getAvailableEvmGaslessRelayer = async ({ chainId }, { sdkApi, environmentId }) => {
+    const startedAt = Date.now();
     let data;
     try {
         data = await sdkApi.getAvailableEVMGaslessRelayer({
@@ -29,6 +31,13 @@ const getAvailableEvmGaslessRelayer = async ({ chainId }, { sdkApi, environmentI
     if (!data.relayerAddress) {
         throw new SponsorTransactionError.SponsorTransactionError();
     }
+    logger.logger.instrument('[evm-gasless] getAvailableEvmGaslessRelayer - completed', {
+        chainId,
+        environmentId,
+        key: 'getAvailableEvmGaslessRelayer-completed',
+        relayerAddress: data.relayerAddress,
+        time: Date.now() - startedAt,
+    });
     return { relayerAddress: data.relayerAddress };
 };
 

package/src/lib/getAvailableEvmGaslessRelayer/getAvailableEvmGaslessRelayer.js

@@ -1,5 +1,6 @@
 'use client'
 import { SponsorTransactionError } from '../errors/SponsorTransactionError/SponsorTransactionError.js';
+import { logger } from '../logger/logger.js';
 
 /**
  * Fetches the relayer address to embed in the EIP-712 sponsored-transaction
@@ -11,6 +12,7 @@ import { SponsorTransactionError } from '../errors/SponsorTransactionError/Spons
  * validates the signature against this address.
  */
 const getAvailableEvmGaslessRelayer = async ({ chainId }, { sdkApi, environmentId }) => {
+    const startedAt = Date.now();
     let data;
     try {
         data = await sdkApi.getAvailableEVMGaslessRelayer({
@@ -25,6 +27,13 @@ const getAvailableEvmGaslessRelayer = async ({ chainId }, { sdkApi, environmentI
     if (!data.relayerAddress) {
         throw new SponsorTransactionError();
     }
+    logger.instrument('[evm-gasless] getAvailableEvmGaslessRelayer - completed', {
+        chainId,
+        environmentId,
+        key: 'getAvailableEvmGaslessRelayer-completed',
+        relayerAddress: data.relayerAddress,
+        time: Date.now() - startedAt,
+    });
     return { relayerAddress: data.relayerAddress };
 };
 

package/src/lib/is7702DelegationActive/is7702DelegationActive.cjs

@@ -4,6 +4,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var constants = require('../constants.cjs');
+var logger = require('../logger/logger.cjs');
 
 /**
  * Checks whether EIP-7702 delegation to the Dynamic gasless contract is
@@ -14,18 +15,45 @@ var constants = require('../constants.cjs');
  * delegation marker is `DELEGATION_CODE_PREFIX + DELEGATION_CONTRACT_ADDRESS`.
  */
 const is7702DelegationActive = async ({ walletAddress }, { chainId, delegationRegistry, publicClient }) => {
+    const startedAt = Date.now();
     if (delegationRegistry.isDelegated({ chainId, walletAddress })) {
+        logger.logger.instrument('[evm-gasless] is7702DelegationActive - completed', {
+            chainId,
+            delegateAddress: constants.DELEGATION_CONTRACT_ADDRESS,
+            isActive: true,
+            key: 'is7702DelegationActive-completed',
+            time: Date.now() - startedAt,
+        });
         return true;
     }
     const bytecode = await publicClient.getCode({ address: walletAddress });
     if (!bytecode) {
+        logger.logger.instrument('[evm-gasless] is7702DelegationActive - completed', {
+            chainId,
+            isActive: false,
+            key: 'is7702DelegationActive-completed',
+            time: Date.now() - startedAt,
+        });
         return false;
     }
     const expectedPrefix = constants.DELEGATION_CODE_PREFIX + constants.DELEGATION_CONTRACT_ADDRESS.slice(2).toLowerCase();
     const isActive = bytecode.toLowerCase().startsWith(expectedPrefix);
+    const isDelegationBytecode = bytecode
+        .toLowerCase()
+        .startsWith(constants.DELEGATION_CODE_PREFIX);
+    const delegateAddress = isDelegationBytecode
+        ? `0x${bytecode.slice(constants.DELEGATION_CODE_PREFIX.length, constants.DELEGATION_CODE_PREFIX.length + 40)}`
+        : undefined;
     if (isActive) {
         delegationRegistry.markDelegated({ chainId, walletAddress });
     }
+    logger.logger.instrument('[evm-gasless] is7702DelegationActive - completed', {
+        chainId,
+        delegateAddress,
+        isActive,
+        key: 'is7702DelegationActive-completed',
+        time: Date.now() - startedAt,
+    });
     return isActive;
 };
 

package/src/lib/is7702DelegationActive/is7702DelegationActive.js

@@ -1,5 +1,6 @@
 'use client'
-import { DELEGATION_CODE_PREFIX, DELEGATION_CONTRACT_ADDRESS } from '../constants.js';
+import { DELEGATION_CONTRACT_ADDRESS, DELEGATION_CODE_PREFIX } from '../constants.js';
+import { logger } from '../logger/logger.js';
 
 /**
  * Checks whether EIP-7702 delegation to the Dynamic gasless contract is
@@ -10,18 +11,45 @@ import { DELEGATION_CODE_PREFIX, DELEGATION_CONTRACT_ADDRESS } from '../constant
  * delegation marker is `DELEGATION_CODE_PREFIX + DELEGATION_CONTRACT_ADDRESS`.
  */
 const is7702DelegationActive = async ({ walletAddress }, { chainId, delegationRegistry, publicClient }) => {
+    const startedAt = Date.now();
     if (delegationRegistry.isDelegated({ chainId, walletAddress })) {
+        logger.instrument('[evm-gasless] is7702DelegationActive - completed', {
+            chainId,
+            delegateAddress: DELEGATION_CONTRACT_ADDRESS,
+            isActive: true,
+            key: 'is7702DelegationActive-completed',
+            time: Date.now() - startedAt,
+        });
         return true;
     }
     const bytecode = await publicClient.getCode({ address: walletAddress });
     if (!bytecode) {
+        logger.instrument('[evm-gasless] is7702DelegationActive - completed', {
+            chainId,
+            isActive: false,
+            key: 'is7702DelegationActive-completed',
+            time: Date.now() - startedAt,
+        });
         return false;
     }
     const expectedPrefix = DELEGATION_CODE_PREFIX + DELEGATION_CONTRACT_ADDRESS.slice(2).toLowerCase();
     const isActive = bytecode.toLowerCase().startsWith(expectedPrefix);
+    const isDelegationBytecode = bytecode
+        .toLowerCase()
+        .startsWith(DELEGATION_CODE_PREFIX);
+    const delegateAddress = isDelegationBytecode
+        ? `0x${bytecode.slice(DELEGATION_CODE_PREFIX.length, DELEGATION_CODE_PREFIX.length + 40)}`
+        : undefined;
     if (isActive) {
         delegationRegistry.markDelegated({ chainId, walletAddress });
     }
+    logger.instrument('[evm-gasless] is7702DelegationActive - completed', {
+        chainId,
+        delegateAddress,
+        isActive,
+        key: 'is7702DelegationActive-completed',
+        time: Date.now() - startedAt,
+    });
     return isActive;
 };
 

package/src/lib/logger/logger.cjs

@@ -0,0 +1,15 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var logger$1 = require('@dynamic-labs/logger');
+
+const logger = new logger$1.Logger('@dynamic-labs/ethereum-gasless-core');
+const errorLogContext = (error) => ({
+    errorCode: error?.code,
+    errorType: error?.constructor?.name,
+});
+
+exports.errorLogContext = errorLogContext;
+exports.logger = logger;

package/src/lib/logger/logger.d.ts

@@ -0,0 +1,6 @@
+import { Logger } from '@dynamic-labs/logger';
+export declare const logger: Logger;
+export declare const errorLogContext: (error: unknown) => {
+    errorCode: string | undefined;
+    errorType: string | undefined;
+};

package/src/lib/logger/logger.js

@@ -0,0 +1,10 @@
+'use client'
+import { Logger } from '@dynamic-labs/logger';
+
+const logger = new Logger('@dynamic-labs/ethereum-gasless-core');
+const errorLogContext = (error) => ({
+    errorCode: error?.code,
+    errorType: error?.constructor?.name,
+});
+
+export { errorLogContext, logger };

package/src/lib/relaySponsoredTransaction/relaySponsoredTransaction.cjs

@@ -5,6 +5,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var constants = require('../constants.cjs');
 var SponsorTransactionError = require('../errors/SponsorTransactionError/SponsorTransactionError.cjs');
+var logger = require('../logger/logger.cjs');
 var signSponsoredTransaction = require('../signSponsoredTransaction/signSponsoredTransaction.cjs');
 
 const isSignedTransactionParams = (params) => 'signedTransaction' in params;
@@ -17,6 +18,8 @@ const isSignedTransactionParams = (params) => 'signedTransaction' in params;
  * this with `waitForSponsoredTransaction` to await on-chain inclusion.
  */
 const relaySponsoredTransaction = async (params, deps) => {
+    const { chainId, environmentId } = deps;
+    const startedAt = Date.now();
     const signedTransaction = isSignedTransactionParams(params)
         ? params.signedTransaction
         : await signSponsoredTransaction.signSponsoredTransaction({
@@ -53,6 +56,13 @@ const relaySponsoredTransaction = async (params, deps) => {
     if (!data.requestId) {
         throw new SponsorTransactionError.SponsorTransactionError();
     }
+    logger.logger.instrument('[evm-gasless] relaySponsoredTransaction - completed', {
+        chainId,
+        environmentId,
+        key: 'relaySponsoredTransaction-completed',
+        requestId: data.requestId,
+        time: Date.now() - startedAt,
+    });
     return { requestId: data.requestId };
 };
 

package/src/lib/relaySponsoredTransaction/relaySponsoredTransaction.js

@@ -1,6 +1,7 @@
 'use client'
 import { DEFAULT_VALID_FOR_SECONDS } from '../constants.js';
 import { SponsorTransactionError } from '../errors/SponsorTransactionError/SponsorTransactionError.js';
+import { logger } from '../logger/logger.js';
 import { signSponsoredTransaction } from '../signSponsoredTransaction/signSponsoredTransaction.js';
 
 const isSignedTransactionParams = (params) => 'signedTransaction' in params;
@@ -13,6 +14,8 @@ const isSignedTransactionParams = (params) => 'signedTransaction' in params;
  * this with `waitForSponsoredTransaction` to await on-chain inclusion.
  */
 const relaySponsoredTransaction = async (params, deps) => {
+    const { chainId, environmentId } = deps;
+    const startedAt = Date.now();
     const signedTransaction = isSignedTransactionParams(params)
         ? params.signedTransaction
         : await signSponsoredTransaction({
@@ -49,6 +52,13 @@ const relaySponsoredTransaction = async (params, deps) => {
     if (!data.requestId) {
         throw new SponsorTransactionError();
     }
+    logger.instrument('[evm-gasless] relaySponsoredTransaction - completed', {
+        chainId,
+        environmentId,
+        key: 'relaySponsoredTransaction-completed',
+        requestId: data.requestId,
+        time: Date.now() - startedAt,
+    });
     return { requestId: data.requestId };
 };
 

package/src/lib/resolveAuthorization/resolveAuthorization.cjs

@@ -4,6 +4,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var is7702DelegationActive = require('../is7702DelegationActive/is7702DelegationActive.cjs');
+var logger = require('../logger/logger.cjs');
 var sign7702Authorization = require('../sign7702Authorization/sign7702Authorization.cjs');
 
 /**
@@ -16,17 +17,49 @@ var sign7702Authorization = require('../sign7702Authorization/sign7702Authorizat
  *   already active, no authorization is needed; if not, signs one.
  */
 const resolveAuthorization = async ({ authorization, autoDelegate, walletAddress }, deps) => {
+    const { chainId } = deps;
+    const startedAt = Date.now();
+    logger.logger.instrument('[evm-gasless] resolveAuthorization - start', {
+        chainId,
+        key: 'resolveAuthorization-start',
+        time: 0,
+    });
     if (authorization) {
+        logger.logger.instrument('[evm-gasless] resolveAuthorization - completed', {
+            chainId,
+            hasAuthorization: true,
+            key: 'resolveAuthorization-completed',
+            time: Date.now() - startedAt,
+        });
         return authorization;
     }
     if (!autoDelegate) {
+        logger.logger.instrument('[evm-gasless] resolveAuthorization - completed', {
+            chainId,
+            hasAuthorization: false,
+            key: 'resolveAuthorization-completed',
+            time: Date.now() - startedAt,
+        });
         return undefined;
     }
     const isDelegated = await is7702DelegationActive.is7702DelegationActive({ walletAddress }, deps);
     if (isDelegated) {
+        logger.logger.instrument('[evm-gasless] resolveAuthorization - completed', {
+            chainId,
+            hasAuthorization: false,
+            key: 'resolveAuthorization-completed',
+            time: Date.now() - startedAt,
+        });
         return undefined;
     }
-    return sign7702Authorization.sign7702Authorization({}, deps);
+    const signedAuthorization = await sign7702Authorization.sign7702Authorization({}, deps);
+    logger.logger.instrument('[evm-gasless] resolveAuthorization - completed', {
+        chainId,
+        hasAuthorization: true,
+        key: 'resolveAuthorization-completed',
+        time: Date.now() - startedAt,
+    });
+    return signedAuthorization;
 };
 
 exports.resolveAuthorization = resolveAuthorization;

package/src/lib/resolveAuthorization/resolveAuthorization.js

@@ -1,5 +1,6 @@
 'use client'
 import { is7702DelegationActive } from '../is7702DelegationActive/is7702DelegationActive.js';
+import { logger } from '../logger/logger.js';
 import { sign7702Authorization } from '../sign7702Authorization/sign7702Authorization.js';
 
 /**
@@ -12,17 +13,49 @@ import { sign7702Authorization } from '../sign7702Authorization/sign7702Authoriz
  *   already active, no authorization is needed; if not, signs one.
  */
 const resolveAuthorization = async ({ authorization, autoDelegate, walletAddress }, deps) => {
+    const { chainId } = deps;
+    const startedAt = Date.now();
+    logger.instrument('[evm-gasless] resolveAuthorization - start', {
+        chainId,
+        key: 'resolveAuthorization-start',
+        time: 0,
+    });
     if (authorization) {
+        logger.instrument('[evm-gasless] resolveAuthorization - completed', {
+            chainId,
+            hasAuthorization: true,
+            key: 'resolveAuthorization-completed',
+            time: Date.now() - startedAt,
+        });
         return authorization;
     }
     if (!autoDelegate) {
+        logger.instrument('[evm-gasless] resolveAuthorization - completed', {
+            chainId,
+            hasAuthorization: false,
+            key: 'resolveAuthorization-completed',
+            time: Date.now() - startedAt,
+        });
         return undefined;
     }
     const isDelegated = await is7702DelegationActive({ walletAddress }, deps);
     if (isDelegated) {
+        logger.instrument('[evm-gasless] resolveAuthorization - completed', {
+            chainId,
+            hasAuthorization: false,
+            key: 'resolveAuthorization-completed',
+            time: Date.now() - startedAt,
+        });
         return undefined;
     }
-    return sign7702Authorization({}, deps);
+    const signedAuthorization = await sign7702Authorization({}, deps);
+    logger.instrument('[evm-gasless] resolveAuthorization - completed', {
+        chainId,
+        hasAuthorization: true,
+        key: 'resolveAuthorization-completed',
+        time: Date.now() - startedAt,
+    });
+    return signedAuthorization;
 };
 
 export { resolveAuthorization };

package/src/lib/sendSponsoredTransaction/sendSponsoredTransaction.cjs

@@ -3,6 +3,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+var logger = require('../logger/logger.cjs');
 var relaySponsoredTransaction = require('../relaySponsoredTransaction/relaySponsoredTransaction.cjs');
 var waitForSponsoredTransaction = require('../waitForSponsoredTransaction/waitForSponsoredTransaction.cjs');
 
@@ -14,8 +15,30 @@ var waitForSponsoredTransaction = require('../waitForSponsoredTransaction/waitFo
  * transaction hash once the relay reports inclusion.
  */
 const sendSponsoredTransaction = async (params, deps) => {
-    const { requestId } = await relaySponsoredTransaction.relaySponsoredTransaction(params, deps);
-    return waitForSponsoredTransaction.waitForSponsoredTransaction({ requestId }, deps);
+    const { chainId, environmentId } = deps;
+    const startedAt = Date.now();
+    try {
+        const { requestId } = await relaySponsoredTransaction.relaySponsoredTransaction(params, deps);
+        const { transactionHash } = await waitForSponsoredTransaction.waitForSponsoredTransaction({ requestId }, deps);
+        logger.logger.instrument('[evm-gasless] sendSponsoredTransaction - completed', {
+            chainId,
+            environmentId,
+            key: 'sendSponsoredTransaction-completed',
+            time: Date.now() - startedAt,
+            transactionHash,
+        });
+        return { transactionHash };
+    }
+    catch (error) {
+        logger.logger.instrument('[evm-gasless] sendSponsoredTransaction - failed', {
+            chainId,
+            environmentId,
+            key: 'sendSponsoredTransaction-failed',
+            time: Date.now() - startedAt,
+            ...logger.errorLogContext(error),
+        });
+        throw error;
+    }
 };
 
 exports.sendSponsoredTransaction = sendSponsoredTransaction;

package/src/lib/sendSponsoredTransaction/sendSponsoredTransaction.js

@@ -1,4 +1,5 @@
 'use client'
+import { logger, errorLogContext } from '../logger/logger.js';
 import { relaySponsoredTransaction } from '../relaySponsoredTransaction/relaySponsoredTransaction.js';
 import { waitForSponsoredTransaction } from '../waitForSponsoredTransaction/waitForSponsoredTransaction.js';
 
@@ -10,8 +11,30 @@ import { waitForSponsoredTransaction } from '../waitForSponsoredTransaction/wait
  * transaction hash once the relay reports inclusion.
  */
 const sendSponsoredTransaction = async (params, deps) => {
-    const { requestId } = await relaySponsoredTransaction(params, deps);
-    return waitForSponsoredTransaction({ requestId }, deps);
+    const { chainId, environmentId } = deps;
+    const startedAt = Date.now();
+    try {
+        const { requestId } = await relaySponsoredTransaction(params, deps);
+        const { transactionHash } = await waitForSponsoredTransaction({ requestId }, deps);
+        logger.instrument('[evm-gasless] sendSponsoredTransaction - completed', {
+            chainId,
+            environmentId,
+            key: 'sendSponsoredTransaction-completed',
+            time: Date.now() - startedAt,
+            transactionHash,
+        });
+        return { transactionHash };
+    }
+    catch (error) {
+        logger.instrument('[evm-gasless] sendSponsoredTransaction - failed', {
+            chainId,
+            environmentId,
+            key: 'sendSponsoredTransaction-failed',
+            time: Date.now() - startedAt,
+            ...errorLogContext(error),
+        });
+        throw error;
+    }
 };
 
 export { sendSponsoredTransaction };

package/src/lib/sign7702Authorization/sign7702Authorization.cjs

@@ -4,6 +4,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var constants = require('../constants.cjs');
+var logger = require('../logger/logger.cjs');
 
 /**
  * Signs an EIP-7702 authorization to delegate the user's wallet to the
@@ -13,10 +14,19 @@ var constants = require('../constants.cjs');
  * (or any first-time sponsored call) to activate delegation as part of the
  * sponsored intent.
  */
-const sign7702Authorization = async ({ chainId }, { chainId: depsChainId, walletClient }) => walletClient.signAuthorization({
-    account: walletClient.account,
-    chainId: chainId ?? depsChainId,
-    contractAddress: constants.DELEGATION_CONTRACT_ADDRESS,
-});
+const sign7702Authorization = async ({ chainId }, { chainId: depsChainId, walletClient }) => {
+    const startedAt = Date.now();
+    const authorization = await walletClient.signAuthorization({
+        account: walletClient.account,
+        chainId: chainId ?? depsChainId,
+        contractAddress: constants.DELEGATION_CONTRACT_ADDRESS,
+    });
+    logger.logger.instrument('[evm-gasless] sign7702Authorization - completed', {
+        chainId: chainId ?? depsChainId,
+        key: 'sign7702Authorization-completed',
+        time: Date.now() - startedAt,
+    });
+    return authorization;
+};
 
 exports.sign7702Authorization = sign7702Authorization;

package/src/lib/sign7702Authorization/sign7702Authorization.js

@@ -1,5 +1,6 @@
 'use client'
 import { DELEGATION_CONTRACT_ADDRESS } from '../constants.js';
+import { logger } from '../logger/logger.js';
 
 /**
  * Signs an EIP-7702 authorization to delegate the user's wallet to the
@@ -9,10 +10,19 @@ import { DELEGATION_CONTRACT_ADDRESS } from '../constants.js';
  * (or any first-time sponsored call) to activate delegation as part of the
  * sponsored intent.
  */
-const sign7702Authorization = async ({ chainId }, { chainId: depsChainId, walletClient }) => walletClient.signAuthorization({
-    account: walletClient.account,
-    chainId: chainId ?? depsChainId,
-    contractAddress: DELEGATION_CONTRACT_ADDRESS,
-});
+const sign7702Authorization = async ({ chainId }, { chainId: depsChainId, walletClient }) => {
+    const startedAt = Date.now();
+    const authorization = await walletClient.signAuthorization({
+        account: walletClient.account,
+        chainId: chainId ?? depsChainId,
+        contractAddress: DELEGATION_CONTRACT_ADDRESS,
+    });
+    logger.instrument('[evm-gasless] sign7702Authorization - completed', {
+        chainId: chainId ?? depsChainId,
+        key: 'sign7702Authorization-completed',
+        time: Date.now() - startedAt,
+    });
+    return authorization;
+};
 
 export { sign7702Authorization };

package/src/lib/signSponsoredTransaction/signSponsoredTransaction.cjs

@@ -5,6 +5,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var constants = require('../constants.cjs');
 var generateIntentNonce = require('../generateIntentNonce/generateIntentNonce.cjs');
+var logger = require('../logger/logger.cjs');
 var getAvailableEvmGaslessRelayer = require('../getAvailableEvmGaslessRelayer/getAvailableEvmGaslessRelayer.cjs');
 var resolveAuthorization = require('../resolveAuthorization/resolveAuthorization.cjs');
 var toSerializedAuthorization = require('../toSerializedAuthorization/toSerializedAuthorization.cjs');
@@ -18,8 +19,9 @@ var toSerializedAuthorization = require('../toSerializedAuthorization/toSerializ
  * provided in `deps`.
  */
 const signSponsoredTransaction = async ({ authorization, autoDelegate = true, calls, nonce: providedNonce, validForSeconds = constants.DEFAULT_VALID_FOR_SECONDS, }, deps) => {
-    const { chainId, walletClient } = deps;
+    const { chainId, environmentId, walletClient } = deps;
     const walletAddress = walletClient.account.address;
+    const startedAt = Date.now();
     const authPromise = resolveAuthorization.resolveAuthorization({ authorization, autoDelegate, walletAddress }, deps);
     const signPromise = (async () => {
         const [nonce, { relayerAddress }] = await Promise.all([
@@ -27,6 +29,13 @@ const signSponsoredTransaction = async ({ authorization, autoDelegate = true, ca
             getAvailableEvmGaslessRelayer.getAvailableEvmGaslessRelayer({ chainId }, deps),
         ]);
         const deadline = BigInt(Math.floor(Date.now() / 1000) + validForSeconds);
+        const signTypedDataStartedAt = Date.now();
+        logger.logger.instrument('[evm-gasless] signTypedData - start', {
+            chainId,
+            environmentId,
+            key: 'signTypedData-start',
+            time: 0,
+        });
         const signature = await walletClient.signTypedData({
             account: walletClient.account,
             domain: {
@@ -47,9 +56,21 @@ const signSponsoredTransaction = async ({ authorization, autoDelegate = true, ca
             primaryType: 'AuthorizedExecutions',
             types: constants.AUTHORIZED_EXECUTIONS_TYPES,
         });
+        logger.logger.instrument('[evm-gasless] signTypedData - completed', {
+            chainId,
+            environmentId,
+            key: 'signTypedData-completed',
+            time: Date.now() - signTypedDataStartedAt,
+        });
         return { deadline, nonce, relayerAddress, signature };
     })();
     const [resolvedAuthorization, { deadline, nonce, relayerAddress, signature },] = await Promise.all([authPromise, signPromise]);
+    logger.logger.instrument('[evm-gasless] signSponsoredTransaction - completed', {
+        chainId,
+        environmentId,
+        key: 'signSponsoredTransaction-completed',
+        time: Date.now() - startedAt,
+    });
     return {
         authorization: resolvedAuthorization
             ? toSerializedAuthorization.toSerializedAuthorization(resolvedAuthorization)

package/src/lib/signSponsoredTransaction/signSponsoredTransaction.js

@@ -1,6 +1,7 @@
 'use client'
 import { DELEGATION_CONTRACT_ADDRESS, BATCH_CALL_OPDATA_AUTH_MODE, AUTHORIZED_EXECUTIONS_TYPES, DEFAULT_VALID_FOR_SECONDS } from '../constants.js';
 import { generateIntentNonce } from '../generateIntentNonce/generateIntentNonce.js';
+import { logger } from '../logger/logger.js';
 import { getAvailableEvmGaslessRelayer } from '../getAvailableEvmGaslessRelayer/getAvailableEvmGaslessRelayer.js';
 import { resolveAuthorization } from '../resolveAuthorization/resolveAuthorization.js';
 import { toSerializedAuthorization } from '../toSerializedAuthorization/toSerializedAuthorization.js';
@@ -14,8 +15,9 @@ import { toSerializedAuthorization } from '../toSerializedAuthorization/toSerial
  * provided in `deps`.
  */
 const signSponsoredTransaction = async ({ authorization, autoDelegate = true, calls, nonce: providedNonce, validForSeconds = DEFAULT_VALID_FOR_SECONDS, }, deps) => {
-    const { chainId, walletClient } = deps;
+    const { chainId, environmentId, walletClient } = deps;
     const walletAddress = walletClient.account.address;
+    const startedAt = Date.now();
     const authPromise = resolveAuthorization({ authorization, autoDelegate, walletAddress }, deps);
     const signPromise = (async () => {
         const [nonce, { relayerAddress }] = await Promise.all([
@@ -23,6 +25,13 @@ const signSponsoredTransaction = async ({ authorization, autoDelegate = true, ca
             getAvailableEvmGaslessRelayer({ chainId }, deps),
         ]);
         const deadline = BigInt(Math.floor(Date.now() / 1000) + validForSeconds);
+        const signTypedDataStartedAt = Date.now();
+        logger.instrument('[evm-gasless] signTypedData - start', {
+            chainId,
+            environmentId,
+            key: 'signTypedData-start',
+            time: 0,
+        });
         const signature = await walletClient.signTypedData({
             account: walletClient.account,
             domain: {
@@ -43,9 +52,21 @@ const signSponsoredTransaction = async ({ authorization, autoDelegate = true, ca
             primaryType: 'AuthorizedExecutions',
             types: AUTHORIZED_EXECUTIONS_TYPES,
         });
+        logger.instrument('[evm-gasless] signTypedData - completed', {
+            chainId,
+            environmentId,
+            key: 'signTypedData-completed',
+            time: Date.now() - signTypedDataStartedAt,
+        });
         return { deadline, nonce, relayerAddress, signature };
     })();
     const [resolvedAuthorization, { deadline, nonce, relayerAddress, signature },] = await Promise.all([authPromise, signPromise]);
+    logger.instrument('[evm-gasless] signSponsoredTransaction - completed', {
+        chainId,
+        environmentId,
+        key: 'signSponsoredTransaction-completed',
+        time: Date.now() - startedAt,
+    });
     return {
         authorization: resolvedAuthorization
             ? toSerializedAuthorization(resolvedAuthorization)

package/src/lib/waitForSponsoredTransaction/waitForSponsoredTransaction.cjs

@@ -5,6 +5,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var SponsorTransactionError = require('../errors/SponsorTransactionError/SponsorTransactionError.cjs');
 var getEVMSponsoredTransactionStatus = require('../getEVMSponsoredTransactionStatus/getEVMSponsoredTransactionStatus.cjs');
+var logger = require('../logger/logger.cjs');
 
 const TIMEOUT_MS = 60000;
 const MAX_WAIT_SECONDS = 10;
@@ -24,18 +25,47 @@ const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
  * resolves, so the hash comes back as soon as it exists.
  */
 const waitForSponsoredTransaction = async ({ requestId }, deps) => {
-    const deadline = Date.now() + TIMEOUT_MS;
+    const { chainId, environmentId } = deps;
+    const waitStartedAt = Date.now();
+    const deadline = waitStartedAt + TIMEOUT_MS;
+    logger.logger.instrument('[evm-gasless] waitForSponsoredTransaction - start', {
+        chainId,
+        environmentId,
+        key: 'waitForSponsoredTransaction-start',
+        requestId,
+        time: 0,
+    });
+    let attempt = 0;
     while (Date.now() < deadline) {
+        attempt += 1;
         const startedAt = Date.now();
         // Never ask for a hold that would outlive the deadline; under a second
         // left means asking for none at all. The clamp matters because the
         // deadline can pass between the loop check and here.
         const waitSeconds = Math.max(0, Math.min(MAX_WAIT_SECONDS, Math.floor((deadline - startedAt) / 1000)));
         const result = await getEVMSponsoredTransactionStatus.getEVMSponsoredTransactionStatus({ requestId, waitSeconds }, deps);
+        logger.logger.instrument('[evm-gasless] waitForSponsoredTransaction - poll', {
+            attempt,
+            chainId,
+            environmentId,
+            key: 'waitForSponsoredTransaction-poll',
+            requestId,
+            status: result.status,
+            time: Date.now() - startedAt,
+        });
         if (TERMINAL_FAILURE_STATUSES.has(result.status)) {
             throw new SponsorTransactionError.SponsorTransactionError(null, result.errorMessage);
         }
         if (result.transactionHash) {
+            logger.logger.instrument('[evm-gasless] waitForSponsoredTransaction - completed', {
+                attempt,
+                chainId,
+                environmentId,
+                key: 'waitForSponsoredTransaction-completed',
+                requestId,
+                time: Date.now() - waitStartedAt,
+                transactionHash: result.transactionHash,
+            });
             return { transactionHash: result.transactionHash };
         }
         const elapsed = Date.now() - startedAt;

package/src/lib/waitForSponsoredTransaction/waitForSponsoredTransaction.d.ts

@@ -4,6 +4,10 @@ type WaitForSponsoredTransactionParams = {
     /** The request ID returned by `relaySponsoredTransaction` / `sendSponsoredTransaction`. */
     requestId: string;
 };
+type WaitForSponsoredTransactionDeps = EvmGaslessApiDeps & {
+    /** Optional chain ID, included in instrumentation logs when provided. */
+    chainId?: number;
+};
 /**
  * Waits until the relay reports the transaction has been included on-chain,
  * then returns the transaction hash.
@@ -11,7 +15,7 @@ type WaitForSponsoredTransactionParams = {
  * Each request asks the API to hold the response open until the transaction
  * resolves, so the hash comes back as soon as it exists.
  */
-export declare const waitForSponsoredTransaction: ({ requestId }: WaitForSponsoredTransactionParams, deps: EvmGaslessApiDeps) => Promise<{
+export declare const waitForSponsoredTransaction: ({ requestId }: WaitForSponsoredTransactionParams, deps: WaitForSponsoredTransactionDeps) => Promise<{
     transactionHash: Hex;
 }>;
 export {};

package/src/lib/waitForSponsoredTransaction/waitForSponsoredTransaction.js

@@ -1,6 +1,7 @@
 'use client'
 import { SponsorTransactionError } from '../errors/SponsorTransactionError/SponsorTransactionError.js';
 import { getEVMSponsoredTransactionStatus } from '../getEVMSponsoredTransactionStatus/getEVMSponsoredTransactionStatus.js';
+import { logger } from '../logger/logger.js';
 
 const TIMEOUT_MS = 60000;
 const MAX_WAIT_SECONDS = 10;
@@ -20,18 +21,47 @@ const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
  * resolves, so the hash comes back as soon as it exists.
  */
 const waitForSponsoredTransaction = async ({ requestId }, deps) => {
-    const deadline = Date.now() + TIMEOUT_MS;
+    const { chainId, environmentId } = deps;
+    const waitStartedAt = Date.now();
+    const deadline = waitStartedAt + TIMEOUT_MS;
+    logger.instrument('[evm-gasless] waitForSponsoredTransaction - start', {
+        chainId,
+        environmentId,
+        key: 'waitForSponsoredTransaction-start',
+        requestId,
+        time: 0,
+    });
+    let attempt = 0;
     while (Date.now() < deadline) {
+        attempt += 1;
         const startedAt = Date.now();
         // Never ask for a hold that would outlive the deadline; under a second
         // left means asking for none at all. The clamp matters because the
         // deadline can pass between the loop check and here.
         const waitSeconds = Math.max(0, Math.min(MAX_WAIT_SECONDS, Math.floor((deadline - startedAt) / 1000)));
         const result = await getEVMSponsoredTransactionStatus({ requestId, waitSeconds }, deps);
+        logger.instrument('[evm-gasless] waitForSponsoredTransaction - poll', {
+            attempt,
+            chainId,
+            environmentId,
+            key: 'waitForSponsoredTransaction-poll',
+            requestId,
+            status: result.status,
+            time: Date.now() - startedAt,
+        });
         if (TERMINAL_FAILURE_STATUSES.has(result.status)) {
             throw new SponsorTransactionError(null, result.errorMessage);
         }
         if (result.transactionHash) {
+            logger.instrument('[evm-gasless] waitForSponsoredTransaction - completed', {
+                attempt,
+                chainId,
+                environmentId,
+                key: 'waitForSponsoredTransaction-completed',
+                requestId,
+                time: Date.now() - waitStartedAt,
+                transactionHash: result.transactionHash,
+            });
             return { transactionHash: result.transactionHash };
         }
         const elapsed = Date.now() - startedAt;