Skip to main content

Overview

This guide shows you how to sign messages with your EVM wallet. Message signing is commonly used for authentication, nonce verification, and data integrity checks.

Prerequisites

Basic Message Signing

The Node SDK is stateless — every sign call requires walletMetadata (and externalServerKeyShares if you store them in your own vault). Load both from where you persisted them at wallet creation time.

Simple Message Signing

Whether you need to provide externalServerKeyShares depends on how you created your wallet: If you created your wallet with backUpToDynamic: true, the SDK can recover the shares from backup using password — you can omit externalServerKeyShares:

With Manual Backup

If you created your wallet with backUpToDynamic: false, you must provide the cached externalServerKeyShares:
Password handling notes:
  • If your wallet was created without a password (backUpToDynamic: false, no password), omit the password parameter.
  • If your wallet was created with a password (backUpToDynamic: true), pass it.
  • See signMessage reference for full details.
Password Handling Notes:
  • If your wallet was created without a password, omit the password parameter
  • If your wallet was created with a password, you must provide it for all operations
  • The password parameter is always optional in the API, but required if the wallet is password-protected

Common Use Cases

Authentication

Data Integrity

Next Steps

Last modified on May 21, 2026