EVMWallet

Swift Class

Class

A Crossmint smart wallet on an EVM-compatible chain.

class EVMWallet

Overview

Obtain an instance via getWallet(chain:options:) or createWallet(chain:recoveryMethods:options:).

Instance Methods

addSigner(_:deployImmediately:)

Registers a new signer on this wallet, choosing how the registration gets approved.

func addSigner(_ config: SignerConfig, deployImmediately: Bool) async throws(WalletError)

Discussion

Throws: WalletError if registration fails.

Parameters

Parameter	Description
config	The signer configuration to register.
deployImmediately	Whether the registration is approved through an on-chain transaction rather than the lazy signature-request flow.

sendTransaction(to:data:value:chain:)

func sendTransaction(to address: EVMAddress, data: String?, value: BigInt?, chain: EVMChain) async throws(TransactionError) -> Transaction

sendTransaction(to:value:data:chain:)

Sends a raw EVM transaction and polls until it is confirmed on-chain.

func sendTransaction(to address: String, value: String?, data: String?, chain: EVMChain? = nil) async throws(TransactionError) -> TransactionSummary

Example

// Transfer 0.001 ETH
let summary = try await evmWallet.sendTransaction(
    to: "0xRecipient...",
    value: "1000000000000000",
    data: nil
)
print("Confirmed:", summary.explorerLink)

Parameters

Parameter	Description
address	Recipient contract or EOA address (checksummed or lowercase hex).
value	Native token value in wei as a decimal string, e.g. "1000000000000000". Pass nil or "0" for contract calls that transfer no ETH.
data	ABI-encoded call data as a 0x-prefixed hex string. Pass nil or "0x" for plain ETH transfers.
chain	Target chain. Defaults to the chain the wallet was opened on.

signMessage(_:signer:isSmartWalletSignature:)

Signs an arbitrary message with this wallet.

func signMessage(_ message: String, signer: (any AdminSignerData)? = nil, isSmartWalletSignature: Bool = true) async throws(SignatureError) -> String

Example

let signature = try await evmWallet.signMessage("Hello, Crossmint!")

Parameters

Parameter	Description
message	The plain-text message to sign.
signer	Override which signer produces the signature. Defaults to the wallet’s recovery signer.
isSmartWalletSignature	When true (default), produces an EIP-6492 smart-wallet-compatible signature. Set to false to produce a standard EOA signature instead.

signTypedData(_:signer:isSmartWalletSignature:)

Signs EIP-712 typed structured data with this wallet.

func signTypedData(_ typedData: EIP712.TypedData, signer: (any AdminSignerData)? = nil, isSmartWalletSignature: Bool = true) async throws(SignatureError) -> String

Parameters

Parameter	Description
typedData	The structured data to sign, conforming to EIP-712.
signer	Override which signer produces the signature. Defaults to the wallet’s recovery signer.
isSmartWalletSignature	See signMessage(_:signer:isSmartWalletSignature:) for semantics.

Type Aliases

EVMWallet.SpecificChain

Inherited from WalletOnChain.SpecificChain.

typealias SpecificChain = EVMChain

Type Methods

from(wallet:)

Casts a generic Wallet to EVMWallet.

static func from(wallet: Wallet) throws(WalletError) -> EVMWallet

Discussion

Useful when you have a Wallet reference and need EVM-specific methods. Throws WalletError if the wallet is not an EVM wallet.