Skip to main content
Abstract Interface Class Interface for apps to provide crypto wallet signing capabilities.
When crypto payments are enabled in the checkout, the hosted page will request transaction signing via postMessage. The app implements this interface to bridge to its wallet. Prefer attaching the payer under payment.crypto.payer in CrossmintCheckoutConfig. The widget-level CrossmintEmbeddedCheckout.payer override is retained for compatibility.

​
Properties

​
address

Current wallet address.

​
initialChain

Chain the wallet is initially connected on.

​
supportedChains

Chains the wallet can sign transactions on. The hosted checkout only offers chains that appear here.

​
walletProviderKey

Optional wallet provider identifier (e.g. “metamask”, “coinbase”). Returns null if not applicable.

​
Methods

​
signAndSendTransaction

Signs and broadcasts a serialized transaction. Return CrossmintCheckoutTransactionSuccess with the transaction id on success, or CrossmintCheckoutTransactionFailure with a user-facing message on failure.

​
switchChain

Switches the wallet to chain. Called by the hosted page when the user changes chain in the UI.

​
signMessage

Optional — return null if message signing is not supported.