loginOrSignupWithWallet()

Package: react-wallet-kit

Logs in an existing user or signs up a new user using a wallet, creating a new sub-organization if needed.

This function attempts to log in the user by stamping a login request with the provided wallet.
If the wallet’s public key is not associated with an existing sub-organization, a new one is created.
Handles both wallet authentication and sub-organization creation in a single flow.
For Ethereum wallets, derives the public key from the signed request header; for Solana wallets, retrieves it directly from the wallet.
Optionally accepts additional sub-organization parameters, a custom session key, and a custom session expiration.
Stores the resulting session token under the specified session key, or the default session key if not provided.

params

object

required

Show params details

params.createSubOrgParams

CreateSubOrgParams

optional parameters for creating a sub-organization (e.g., authenticators, user metadata).

params.expirationSeconds

string

session expiration time in seconds (defaults to the configured default).

params.sessionKey

string

session key to use for storing the session (defaults to the default session key).

params.walletProvider

WalletProvider

required

wallet provider to use for authentication.

A successful response returns the following fields:

returns

WalletAuthResult & object

required

A promise that resolves to an object containing: