Wallet Connection

Eroteme uses wallet-based authentication — no usernames or passwords. Your Ethereum wallet is your identity.

Supported Wallets

MetaMask

• Install the MetaMask browser extension
• Connect directly with your existing wallet
• Full control over private keys
• Requires POL for gas fees on Polygon

Magic Link

• Sign in with just your email address
• Wallet created automatically behind the scenes
• Gasless transactions via Pimlico smart accounts
• No crypto knowledge required

Authentication Flow

1. User clicks "Connect Wallet"
2. Wallet provider prompts for connection
3. User signs a message to prove ownership
4. Server verifies signature
5. Session established with wallet address

Signature Verification

Every state-changing API request is authenticated with wallet signatures:

• User signs a message containing the action and timestamp
• Server verifies the signature matches the wallet address
• Signatures expire after 5 minutes (prevents replay attacks)

Profile Setup

After connecting, users can set up their profile:

Profiles are tied to wallet addresses — switch wallets, switch profiles.