@dynamic-labs-wallet/node-evm 1.0.50 → 1.0.52

package/index.esm.js

@@ -1,8 +1,9 @@
 import { toAccount } from 'viem/accounts';
 import { MessageHash, createLogError, createDelegatedWalletClient, delegatedSignMessage as delegatedSignMessage$1, stripHexPrefix, revokeDelegation as revokeDelegation$1, DynamicWalletClient, getMPCChainConfig, WalletOperation } from '@dynamic-labs-wallet/node';
-import { getAddress, stringToHex, bytesToHex, size, concat, hashTypedData, validateTypedData, serializeSignature, parseSignature, serializeTransaction, createPublicClient, http, defineChain, createWalletClient } from 'viem';
+import { getAddress, stringToHex, bytesToHex, size, concat, hashTypedData, validateTypedData, serializeSignature, parseSignature, serializeTransaction, defineChain, createPublicClient, http, createWalletClient } from 'viem';
 import { hashAuthorization } from 'viem/utils';
 import { mainnet } from 'viem/chains';
+import { randomBytes } from 'node:crypto';
 import { initializeClient, refreshUser, getNetworksData, createDynamicClient } from '@dynamic-labs-sdk/client';
 import { assertDefined } from '@dynamic-labs-sdk/client/core';
 import { mapNetworkDataToViemChain } from '@dynamic-labs-sdk/evm/viem';
@@ -93,7 +94,7 @@ const deriveAccountAddress = ({ rawPublicKey })=>{
     };
 };
 
-const logError$1 = createLogError('node-evm');
+const logError$2 = createLogError('node-evm');
 /**
  * Creates a delegated EVM wallet client for functional operations
  */ const createDelegatedEvmWalletClient = ({ environmentId, baseApiUrl, baseMPCRelayApiUrl, apiKey, debug = false })=>{
@@ -132,7 +133,7 @@ const logError$1 = createLogError('node-evm');
         });
         return serializeECDSASignature(signatureEcdsa);
     } catch (error) {
-        logError$1({
+        logError$2({
             message: 'Error in delegatedSignMessage',
             error: error,
             context: {
@@ -178,7 +179,7 @@ const logError$1 = createLogError('node-evm');
         });
         return serializeTransaction(signedTx);
     } catch (error) {
-        logError$1({
+        logError$2({
             message: 'Error in delegatedSignTransaction',
             error: error,
             context: {
@@ -211,7 +212,7 @@ const logError$1 = createLogError('node-evm');
         });
         return serializeECDSASignature(signatureEcdsa);
     } catch (error) {
-        logError$1({
+        logError$2({
             message: 'Error in delegatedSignTypedData',
             error: error,
             context: {
@@ -246,7 +247,7 @@ const logError$1 = createLogError('node-evm');
         const serializedSignature = serializeECDSASignature(signatureEcdsa);
         return parseSignature(serializedSignature);
     } catch (error) {
-        logError$1({
+        logError$2({
             message: 'Error in delegatedSignAuthorization',
             error: error,
             context: {
@@ -279,7 +280,7 @@ const logError$1 = createLogError('node-evm');
         });
         return serializeECDSASignature(signatureEcdsa);
     } catch (error) {
-        logError$1({
+        logError$2({
             message: 'Error in delegatedSignRawMessage',
             error: error,
             context: {
@@ -395,6 +396,409 @@ const createAccountAdapter = ({ evmClient, walletMetadata, password, externalSer
     });
 };
 
+/** The Fireblocks Universal Gasless Delegate (UGD) contract address used for EIP-7702 delegation. */ const DELEGATION_CONTRACT_ADDRESS = '0x0000Fb7702036ff9f76044a501ac1aA74cbab16b';
+/** Default sponsored transaction validity duration in seconds (10 minutes). */ const DEFAULT_VALID_FOR_SECONDS = 600;
+/** EIP-7702 delegation code prefix used to identify delegated accounts. */ const DELEGATION_CODE_PREFIX = '0xef0100';
+/** ERC-7579 batch call with opData and auth mode identifier. */ const BATCH_CALL_OPDATA_AUTH_MODE = '0x0100000000007821000100000000000000000000000000000000000000000000';
+/** EIP-712 typed data types for UGD AuthorizedExecutions signing. */ const AUTHORIZED_EXECUTIONS_TYPES = {
+    AuthorizedExecutions: [
+        {
+            name: 'calls',
+            type: 'Execution[]'
+        },
+        {
+            name: 'deadline',
+            type: 'uint256'
+        },
+        {
+            name: 'mode',
+            type: 'bytes32'
+        },
+        {
+            name: 'nonce',
+            type: 'uint256'
+        },
+        {
+            name: 'relayer',
+            type: 'address'
+        }
+    ],
+    Execution: [
+        {
+            name: 'target',
+            type: 'address'
+        },
+        {
+            name: 'value',
+            type: 'uint256'
+        },
+        {
+            name: 'data',
+            type: 'bytes'
+        }
+    ]
+};
+/** Minimal ABI for the UGD contract's nonce validation function. */ const UGD_ABI = [
+    {
+        inputs: [
+            {
+                name: 'nonce',
+                type: 'uint256'
+            }
+        ],
+        name: 'isNonceUsed',
+        outputs: [
+            {
+                name: '',
+                type: 'bool'
+            }
+        ],
+        stateMutability: 'view',
+        type: 'function'
+    }
+];
+/** Default polling interval for sponsored transaction status checks (milliseconds). */ const EVM_GASLESS_DEFAULT_POLL_INTERVAL_MS = 2000;
+/** Default timeout for sponsored transaction polling (milliseconds). */ const EVM_GASLESS_DEFAULT_TIMEOUT_MS = 60000;
+// Error messages
+const ERROR_GASLESS_RPC_REQUIRED_FOR_AUTO_DELEGATE = 'rpcUrl is required when autoDelegate is true and no explicit authorization is provided. ' + 'Pass rpcUrl, pass an explicit authorization, or set autoDelegate: false.';
+const ERROR_GASLESS_RELAY_FAILED = 'EVM sponsored transaction relay failed';
+const ERROR_GASLESS_TIMEOUT = 'EVM sponsored transaction timed out waiting for terminal status';
+const ERROR_GASLESS_MISSING_REQUEST_ID = 'Relay response did not include a requestId';
+const ERROR_GASLESS_MISSING_YPARITY = 'Signed authorization is missing yParity';
+const ERROR_GASLESS_RPC_REQUIRED = 'rpcUrl is required for this operation';
+
+const logError$1 = createLogError('node-evm');
+/**
+ * Builds a stateless gasless client for EVM sponsored transactions (Fireblocks-relayer
+ * native gasless via EIP-7702 / AuthorizedExecutions). It holds no wallet state — the
+ * signing primitives and API client are injected by the owning `DynamicEvmWalletClient`.
+ */ const createEvmGaslessClient = ({ apiClient, createViemPublicClient, signAuthorization, signTypedData })=>{
+    const viemPublicClientForChain = (chainId, rpcUrl)=>{
+        if (!rpcUrl) {
+            throw new Error(ERROR_GASLESS_RPC_REQUIRED);
+        }
+        const chain = defineChain({
+            id: chainId,
+            name: `Chain ${chainId}`,
+            nativeCurrency: {
+                name: 'Ether',
+                symbol: 'ETH',
+                decimals: 18
+            },
+            rpcUrls: {
+                default: {
+                    http: [
+                        rpcUrl
+                    ]
+                }
+            }
+        });
+        return createViemPublicClient({
+            chain,
+            rpcUrl
+        });
+    };
+    const generateRandomNonce = ()=>BigInt('0x' + randomBytes(32).toString('hex'));
+    const generateIntentNonce = async ({ walletAddress, chainId, rpcUrl })=>{
+        let nonce = generateRandomNonce();
+        if (rpcUrl) {
+            try {
+                const publicClient = viemPublicClientForChain(chainId, rpcUrl);
+                // On a brand-new (undelegated) wallet the address has no UGD code yet,
+                // so isNonceUsed reverts — the random value is safe regardless.
+                const isUsed = await publicClient.readContract({
+                    address: walletAddress,
+                    abi: UGD_ABI,
+                    functionName: 'isNonceUsed',
+                    args: [
+                        nonce
+                    ]
+                });
+                if (isUsed) {
+                    nonce = generateRandomNonce();
+                }
+            } catch (e) {
+            // RPC failure is tolerable — 256-bit random collision is negligible
+            }
+        }
+        return nonce;
+    };
+    const is7702DelegationActive = async ({ walletAddress, chainId, rpcUrl })=>{
+        const publicClient = viemPublicClientForChain(chainId, rpcUrl);
+        const code = await publicClient.getCode({
+            address: walletAddress
+        });
+        if (!code) return false;
+        const expectedPrefix = DELEGATION_CODE_PREFIX + DELEGATION_CONTRACT_ADDRESS.slice(2).toLowerCase();
+        return code.toLowerCase().startsWith(expectedPrefix);
+    };
+    const sign7702Authorization = async ({ walletMetadata, chainId, rpcUrl, nonce, password, externalServerKeyShares })=>{
+        const address = walletMetadata.accountAddress;
+        try {
+            let eoaNonce;
+            if (nonce === undefined) {
+                if (!rpcUrl) {
+                    throw new Error(ERROR_GASLESS_RPC_REQUIRED);
+                }
+                const publicClient = viemPublicClientForChain(chainId, rpcUrl);
+                eoaNonce = Number(await publicClient.getTransactionCount({
+                    address
+                }));
+            } else {
+                eoaNonce = nonce;
+            }
+            const authorization = {
+                address: DELEGATION_CONTRACT_ADDRESS,
+                chainId,
+                nonce: eoaNonce
+            };
+            const sig = await signAuthorization({
+                authorization,
+                walletMetadata,
+                password,
+                externalServerKeyShares
+            });
+            if (sig.yParity === undefined) {
+                throw new Error(ERROR_GASLESS_MISSING_YPARITY);
+            }
+            return {
+                address: DELEGATION_CONTRACT_ADDRESS,
+                chainId,
+                nonce: eoaNonce,
+                r: sig.r,
+                s: sig.s,
+                yParity: sig.yParity
+            };
+        } catch (error) {
+            logError$1({
+                message: 'Error signing 7702 authorization',
+                error: error,
+                context: {
+                    accountAddress: address,
+                    chainId
+                }
+            });
+            throw error;
+        }
+    };
+    const getAvailableEvmGaslessRelayer = async ({ chainId, traceContext })=>{
+        const result = await apiClient.getAvailableEVMGaslessRelayer({
+            chainId,
+            traceContext
+        });
+        return {
+            relayerAddress: result.relayerAddress
+        };
+    };
+    const resolveSponsoredAuthorization = async ({ authorization, autoDelegate, walletMetadata, chainId, rpcUrl, password, externalServerKeyShares })=>{
+        if (authorization) {
+            return authorization;
+        }
+        if (!autoDelegate) {
+            return undefined;
+        }
+        // The EOA nonce and delegation status are only knowable on-chain; without
+        // an RPC we can't safely auto-sign a 7702 authorization, so fail loud
+        // instead of relaying an intent that would revert.
+        if (!rpcUrl) {
+            throw new Error(ERROR_GASLESS_RPC_REQUIRED_FOR_AUTO_DELEGATE);
+        }
+        const walletAddress = walletMetadata.accountAddress;
+        const isDelegated = await is7702DelegationActive({
+            walletAddress,
+            chainId,
+            rpcUrl
+        });
+        if (isDelegated) {
+            return undefined;
+        }
+        return sign7702Authorization({
+            walletMetadata,
+            chainId,
+            rpcUrl,
+            password,
+            externalServerKeyShares
+        });
+    };
+    const signSponsoredTransaction = async ({ walletMetadata, calls, chainId, rpcUrl, authorization, autoDelegate = true, nonce: providedNonce, validForSeconds = DEFAULT_VALID_FOR_SECONDS, password, externalServerKeyShares, traceContext })=>{
+        const walletAddress = walletMetadata.accountAddress;
+        try {
+            const resolvedAuth = await resolveSponsoredAuthorization({
+                authorization,
+                autoDelegate,
+                walletMetadata,
+                chainId,
+                rpcUrl,
+                password,
+                externalServerKeyShares
+            });
+            const nonce = providedNonce != null ? providedNonce : await generateIntentNonce({
+                walletAddress,
+                chainId,
+                rpcUrl
+            });
+            const deadline = BigInt(Math.floor(Date.now() / 1000) + validForSeconds);
+            const { relayerAddress } = await getAvailableEvmGaslessRelayer({
+                chainId,
+                traceContext
+            });
+            const signature = await signTypedData({
+                walletMetadata,
+                password,
+                externalServerKeyShares,
+                typedData: {
+                    domain: {
+                        chainId,
+                        verifyingContract: DELEGATION_CONTRACT_ADDRESS
+                    },
+                    message: {
+                        calls: calls.map((c)=>({
+                                data: c.data,
+                                target: c.target,
+                                value: c.value
+                            })),
+                        deadline,
+                        mode: BATCH_CALL_OPDATA_AUTH_MODE,
+                        nonce,
+                        relayer: relayerAddress
+                    },
+                    primaryType: 'AuthorizedExecutions',
+                    types: AUTHORIZED_EXECUTIONS_TYPES
+                }
+            });
+            return {
+                authorization: resolvedAuth,
+                calls,
+                chainId,
+                deadline: deadline.toString(),
+                nonce: nonce.toString(),
+                relayer: relayerAddress,
+                signature,
+                walletAddress
+            };
+        } catch (error) {
+            logError$1({
+                message: 'Error signing sponsored transaction',
+                error: error,
+                context: {
+                    accountAddress: walletAddress,
+                    chainId
+                }
+            });
+            throw error;
+        }
+    };
+    const getEVMSponsoredTransactionStatus = async ({ requestId, traceContext })=>{
+        const result = await apiClient.getEVMSponsoredTransactionStatus({
+            requestId,
+            traceContext
+        });
+        return result;
+    };
+    const isSignedTransactionParams = (params)=>'signedTransaction' in params;
+    const relaySponsoredTransaction = async (params)=>{
+        try {
+            const signed = isSignedTransactionParams(params) ? params.signedTransaction : await signSponsoredTransaction(params);
+            const { requestId } = await apiClient.sponsorEVMTransaction({
+                traceContext: params.traceContext,
+                request: _extends({
+                    authorization: signed.authorization,
+                    calls: signed.calls.map((c)=>({
+                            data: c.data,
+                            target: c.target,
+                            value: c.value.toString()
+                        })),
+                    chainId: signed.chainId,
+                    deadline: signed.deadline,
+                    nonce: signed.nonce,
+                    relayer: signed.relayer,
+                    signature: signed.signature,
+                    walletAddress: signed.walletAddress
+                }, params.userId ? {
+                    userId: params.userId
+                } : {})
+            });
+            if (!requestId) {
+                throw new Error(ERROR_GASLESS_MISSING_REQUEST_ID);
+            }
+            return {
+                requestId
+            };
+        } catch (error) {
+            const { accountAddress, chainId } = isSignedTransactionParams(params) ? {
+                accountAddress: params.signedTransaction.walletAddress,
+                chainId: params.signedTransaction.chainId
+            } : {
+                accountAddress: params.walletMetadata.accountAddress,
+                chainId: params.chainId
+            };
+            logError$1({
+                message: 'Error relaying sponsored transaction',
+                error: error,
+                context: {
+                    accountAddress,
+                    chainId,
+                    userId: params.userId
+                }
+            });
+            throw error;
+        }
+    };
+    const waitForSponsoredTransaction = async ({ requestId, pollInterval = EVM_GASLESS_DEFAULT_POLL_INTERVAL_MS, timeout = EVM_GASLESS_DEFAULT_TIMEOUT_MS, traceContext })=>{
+        try {
+            // A zero or negative pollInterval makes attempts Infinity and turns this into a
+            // tight loop hammering the status API, so clamp it to a sane minimum.
+            const effectivePoll = Math.max(1, pollInterval);
+            const attempts = Math.max(1, Math.floor(timeout / effectivePoll));
+            for(let i = 0; i < attempts; i++){
+                const r = await getEVMSponsoredTransactionStatus({
+                    requestId,
+                    traceContext
+                });
+                if (r.status === 'failure') {
+                    var _r_errorMessage;
+                    throw new Error(`${ERROR_GASLESS_RELAY_FAILED}: ${(_r_errorMessage = r.errorMessage) != null ? _r_errorMessage : 'unknown'}`);
+                }
+                if (r.transactionHash) {
+                    return {
+                        transactionHash: r.transactionHash
+                    };
+                }
+                if (i < attempts - 1) {
+                    await new Promise((resolve)=>setTimeout(resolve, effectivePoll));
+                }
+            }
+            throw new Error(`${ERROR_GASLESS_TIMEOUT}: ${requestId}`);
+        } catch (error) {
+            logError$1({
+                message: 'Error waiting for sponsored transaction',
+                error: error,
+                context: {
+                    requestId
+                }
+            });
+            throw error;
+        }
+    };
+    const sendSponsoredTransaction = async (params)=>{
+        const { requestId } = await relaySponsoredTransaction(params);
+        return waitForSponsoredTransaction({
+            requestId,
+            traceContext: params.traceContext
+        });
+    };
+    return {
+        getAvailableEvmGaslessRelayer,
+        getEVMSponsoredTransactionStatus,
+        is7702DelegationActive,
+        relaySponsoredTransaction,
+        sendSponsoredTransaction,
+        sign7702Authorization,
+        signSponsoredTransaction,
+        waitForSponsoredTransaction
+    };
+};
+
 const logError = createLogError('node-evm');
 class DynamicEvmWalletClient extends DynamicWalletClient {
     get jwtAuthToken() {
@@ -827,6 +1231,62 @@ class DynamicEvmWalletClient extends DynamicWalletClient {
         const evmWallets = wallets.filter((wallet)=>wallet.chainName === 'EVM');
         return evmWallets;
     }
+    // ---------------------------------------------------------------------------
+    // EVM gasless (Fireblocks-relayer native gasless via EIP-7702 / AuthorizedExecutions)
+    // ---------------------------------------------------------------------------
+    get evmGasless() {
+        return createEvmGaslessClient({
+            apiClient: this.apiClient,
+            createViemPublicClient: (args)=>this.createViemPublicClient(args),
+            signAuthorization: (args)=>this.signAuthorization(args),
+            signTypedData: (args)=>this.signTypedData(args)
+        });
+    }
+    /**
+   * Checks whether the given wallet address has an active EIP-7702 delegation
+   * to the Universal Gasless Delegate (UGD) contract.
+   */ async is7702DelegationActive(params) {
+        return this.evmGasless.is7702DelegationActive(params);
+    }
+    /**
+   * Signs an EIP-7702 authorization that delegates the EOA to the UGD contract.
+   * The EOA nonce is fetched from the chain unless explicitly provided.
+   */ async sign7702Authorization(params) {
+        return this.evmGasless.sign7702Authorization(params);
+    }
+    /**
+   * Fetches the available gasless relayer address for a given chain.
+   */ async getAvailableEvmGaslessRelayer(params) {
+        return this.evmGasless.getAvailableEvmGaslessRelayer(params);
+    }
+    /**
+   * Signs a sponsored transaction intent: resolves 7702 authorization, generates
+   * a bitmap nonce, fetches the relayer, and MPC-signs the EIP-712 typed data.
+   */ async signSponsoredTransaction(params) {
+        return this.evmGasless.signSponsoredTransaction(params);
+    }
+    /**
+   * Returns the current status of an EVM sponsored transaction relay request.
+   */ async getEVMSponsoredTransactionStatus(params) {
+        return this.evmGasless.getEVMSponsoredTransactionStatus(params);
+    }
+    /**
+   * Relays a sponsored transaction to the Dynamic API.
+   * Accepts either a pre-signed transaction or parameters to sign first.
+   */ async relaySponsoredTransaction(params) {
+        return this.evmGasless.relaySponsoredTransaction(params);
+    }
+    /**
+   * Relay then poll to completion. Fixed 60s/2s default (matches js-sdk).
+   * For a custom timeout, use relaySponsoredTransaction + waitForSponsoredTransaction.
+   */ async sendSponsoredTransaction(params) {
+        return this.evmGasless.sendSponsoredTransaction(params);
+    }
+    /**
+   * Polls the relay status until a terminal state (success or failure) is reached.
+   */ async waitForSponsoredTransaction(params) {
+        return this.evmGasless.waitForSponsoredTransaction(params);
+    }
     constructor({ environmentId, baseApiUrl, baseMPCRelayApiUrl, debug, enableMPCAccelerator, logger }){
         super({
             environmentId,
@@ -1022,4 +1482,4 @@ const createZerodevClient = async (evmClient)=>{
     return client;
 };
 
-export { DynamicEvmWalletClient, ERROR_ACCOUNT_ADDRESS_REQUIRED, ERROR_CREATE_WALLET_ACCOUNT, ERROR_KEYGEN_FAILED, ERROR_SIGN_MESSAGE, ERROR_SIGN_RAW_MESSAGE, ERROR_SIGN_TYPED_DATA, ERROR_VERIFY_MESSAGE_SIGNATURE, EVM_SIGN_MESSAGE_PREFIX, createAccountAdapter, createDelegatedEvmWalletClient, createZerodevClient, delegatedSignAuthorization, delegatedSignMessage, delegatedSignRawMessage, delegatedSignTransaction, delegatedSignTypedData, deriveAccountAddress, formatEVMMessage, formatTypedData, revokeDelegation, serializeECDSASignature };
+export { AUTHORIZED_EXECUTIONS_TYPES, BATCH_CALL_OPDATA_AUTH_MODE, DEFAULT_VALID_FOR_SECONDS, DELEGATION_CODE_PREFIX, DELEGATION_CONTRACT_ADDRESS, DynamicEvmWalletClient, ERROR_ACCOUNT_ADDRESS_REQUIRED, ERROR_CREATE_WALLET_ACCOUNT, ERROR_GASLESS_MISSING_REQUEST_ID, ERROR_GASLESS_MISSING_YPARITY, ERROR_GASLESS_RELAY_FAILED, ERROR_GASLESS_RPC_REQUIRED, ERROR_GASLESS_RPC_REQUIRED_FOR_AUTO_DELEGATE, ERROR_GASLESS_TIMEOUT, ERROR_KEYGEN_FAILED, ERROR_SIGN_MESSAGE, ERROR_SIGN_RAW_MESSAGE, ERROR_SIGN_TYPED_DATA, ERROR_VERIFY_MESSAGE_SIGNATURE, EVM_GASLESS_DEFAULT_POLL_INTERVAL_MS, EVM_GASLESS_DEFAULT_TIMEOUT_MS, EVM_SIGN_MESSAGE_PREFIX, UGD_ABI, createAccountAdapter, createDelegatedEvmWalletClient, createZerodevClient, delegatedSignAuthorization, delegatedSignMessage, delegatedSignRawMessage, delegatedSignTransaction, delegatedSignTypedData, deriveAccountAddress, formatEVMMessage, formatTypedData, revokeDelegation, serializeECDSASignature };

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@dynamic-labs-wallet/node-evm",
-  "version": "1.0.50",
+  "version": "1.0.52",
   "license": "MIT",
   "type": "module",
   "dependencies": {
-    "@dynamic-labs-wallet/node": "1.0.50",
+    "@dynamic-labs-wallet/node": "1.0.52",
     "@dynamic-labs/sdk-api-core": "^0.0.984",
     "@dynamic-labs-sdk/client": "0.3.0",
     "@dynamic-labs-sdk/zerodev": "0.3.0",
     "@dynamic-labs-sdk/evm": "0.3.0",
     "@zerodev/ecdsa-validator": "5.4.9",
     "@zerodev/sdk": "5.4.36",
-    "@dynamic-labs-wallet/core": "1.0.50"
+    "@dynamic-labs-wallet/core": "1.0.52"
   },
   "publishConfig": {
     "access": "public"

package/src/client/client.d.ts

@@ -1,6 +1,7 @@
 import { DynamicWalletClient, type DynamicWalletClientProps, type EcdsaKeygenResult, type EcdsaPublicKey, type Ed25519KeygenResult, type ServerKeyShare, type ThresholdSignatureScheme, type WalletMetadata } from '@dynamic-labs-wallet/node';
 import type { SignMessageContext } from '@dynamic-labs/sdk-api-core';
-import { type Account, type Chain, type PublicClient, type SignableMessage, type TransactionSerializable, type Transport, type TypedData, type WalletClient } from 'viem';
+import { type Account, type Chain, type Hex, type PublicClient, type SignableMessage, type TransactionSerializable, type Transport, type TypedData, type WalletClient } from 'viem';
+import type { GetAvailableEvmGaslessRelayerParams, GetEVMSponsoredTransactionStatusParams, Is7702DelegationActiveParams, RelaySponsoredTransactionParams, SerializedAuthorization, Sign7702AuthorizationParams, SignedSponsoredTransaction, SignSponsoredTransactionParams, SponsoredTransactionStatusResult, WaitForSponsoredTransactionParams } from './gasless.types.js';
 export declare class DynamicEvmWalletClient extends DynamicWalletClient {
     readonly chainName = "EVM";
     constructor({ environmentId, baseApiUrl, baseMPCRelayApiUrl, debug, enableMPCAccelerator, logger, }: DynamicWalletClientProps);
@@ -143,5 +144,51 @@ export declare class DynamicEvmWalletClient extends DynamicWalletClient {
         derivationPath: string | undefined;
         thresholdSignatureScheme: ThresholdSignatureScheme;
     }[]>;
+    private get evmGasless();
+    /**
+     * Checks whether the given wallet address has an active EIP-7702 delegation
+     * to the Universal Gasless Delegate (UGD) contract.
+     */
+    is7702DelegationActive(params: Is7702DelegationActiveParams): Promise<boolean>;
+    /**
+     * Signs an EIP-7702 authorization that delegates the EOA to the UGD contract.
+     * The EOA nonce is fetched from the chain unless explicitly provided.
+     */
+    sign7702Authorization(params: Sign7702AuthorizationParams): Promise<SerializedAuthorization>;
+    /**
+     * Fetches the available gasless relayer address for a given chain.
+     */
+    getAvailableEvmGaslessRelayer(params: GetAvailableEvmGaslessRelayerParams): Promise<{
+        relayerAddress: Hex;
+    }>;
+    /**
+     * Signs a sponsored transaction intent: resolves 7702 authorization, generates
+     * a bitmap nonce, fetches the relayer, and MPC-signs the EIP-712 typed data.
+     */
+    signSponsoredTransaction(params: SignSponsoredTransactionParams): Promise<SignedSponsoredTransaction>;
+    /**
+     * Returns the current status of an EVM sponsored transaction relay request.
+     */
+    getEVMSponsoredTransactionStatus(params: GetEVMSponsoredTransactionStatusParams): Promise<SponsoredTransactionStatusResult>;
+    /**
+     * Relays a sponsored transaction to the Dynamic API.
+     * Accepts either a pre-signed transaction or parameters to sign first.
+     */
+    relaySponsoredTransaction(params: RelaySponsoredTransactionParams): Promise<{
+        requestId: string;
+    }>;
+    /**
+     * Relay then poll to completion. Fixed 60s/2s default (matches js-sdk).
+     * For a custom timeout, use relaySponsoredTransaction + waitForSponsoredTransaction.
+     */
+    sendSponsoredTransaction(params: RelaySponsoredTransactionParams): Promise<{
+        transactionHash: Hex;
+    }>;
+    /**
+     * Polls the relay status until a terminal state (success or failure) is reached.
+     */
+    waitForSponsoredTransaction(params: WaitForSponsoredTransactionParams): Promise<{
+        transactionHash: Hex;
+    }>;
 }
 //# sourceMappingURL=client.d.ts.map

package/src/client/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"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"}