Flutter: signInWithWeb3

Signs in a user by verifying a message signed with their Web3 wallet.

• Supports Ethereum (Sign-In with Ethereum) and Solana (Sign-In with Solana), both of which derive from the EIP-4361 standard.
• Handle the wallet interaction and message signing yourself with the wallet library of your choice, then provide the signed message together with its signature.
• For Web3Chain.ethereum the signature is a hex encoded string. For Web3Chain.solana it is a base64url encoded string.
• On success, it signs the user in and returns a session. On failure, it throws an AuthException.

Parameters

• chain

  (Required)

  The blockchain used to sign in. One of `Web3Chain.ethereum` or `Web3Chain.solana`.

• message

  (Required)

  The EIP-4361 message that was signed by the user's wallet.

• signature

  (Required)

  The signature produced by the wallet. Hex encoded for Ethereum, base64url encoded for Solana.

• captchaToken

  (Optional)

  The verification token received when the user completes the captcha on the app.

Examples

Sign in with an Ethereum wallet

final response = await supabase.auth.signInWithWeb3(
  chain: Web3Chain.ethereum,
  message: message, // The EIP-4361 message signed by the wallet.
  signature: signature, // Hex encoded signature.
);
final session = response.session;

Sign in with a Solana wallet

final response = await supabase.auth.signInWithWeb3(
  chain: Web3Chain.solana,
  message: message, // The message signed by the wallet.
  signature: signature, // base64url encoded signature.
);
final session = response.session;