Skip to content
docs

EvmConfig

Defined in: wallet-evm/src/types.ts:10

Options for an EVM wallet manager or account: endpoints, chain id, fee caps and the pre-sign safety checks.

optional allowBurn?: boolean

Defined in: wallet-evm/src/types.ts:41

Allow value transfers to the zero address (refused by default — UnsafeTransactionError).


optional allowCrossChainTypedData?: boolean

Defined in: wallet-evm/src/types.ts:43

Allow signing typed data whose domain names another chain (refused by default — ChainMismatchError).


optional autoResetAllowance?: boolean

Defined in: wallet-evm/src/types.ts:29

Ethereum-mainnet USDT reverts a non-zero → non-zero approve. By default the account throws and asks the caller to approve(0) first; with this flag the account sends the reset itself and waits for it before the real approval.


optional chainId?: number

Defined in: wallet-evm/src/types.ts:16

Skip chain-id detection. Required for offline signing when the tx omits chainId.


optional gasHeadroom?: number

Defined in: wallet-evm/src/types.ts:39

Multiplier applied to an ESTIMATED gas limit (simulation / estimateGas) when the caller passes none. Default 1.2; 1 = no headroom.


optional provider?: EvmProvider | EvmProvider[]

Defined in: wallet-evm/src/types.ts:12

RPC url(s) or EIP-1193 provider(s). A list fails over in order. Omit for an offline (sign-only) wallet.


optional retries?: number

Defined in: wallet-evm/src/types.ts:14

Extra attempts after the first failure across the provider list (default 3).


optional simulate?: boolean

Defined in: wallet-evm/src/types.ts:34

eth_call every transaction before signing it and refuse on revert (SimulationError). Default true whenever a provider is configured.


optional transactionMaxFee?: number | bigint

Defined in: wallet-evm/src/types.ts:23

Max fee (wei) for sendTransaction / signTransaction, checked the same way on the caller’s own fee fields too.


optional transferMaxFee?: number | bigint

Defined in: wallet-evm/src/types.ts:21

Max fee (wei) for transfer: the signed transaction’s gas limit × fee cap (gasPrice or maxFeePerGas) above it throws before anything is signed.