SocketFi Auth

Hosted authentication and transaction authorization service for the SocketFi ecosystem.

auth.socket.fi powers:

• Passkey-based authentication
• Hosted sign in / sign up flows
• Secure transaction confirmation
• Wallet authorization flows
• OAuth-style redirects for apps integrating SocketFi

Built with React, Vite, TypeScript, and WebAuthn.

---

Features

• Passwordless authentication with WebAuthn
• Passkey-secured transaction approvals
• Hosted authentication UI
• OAuth-style redirect flow
• Popup and redirect support
• Mobile-optimized authorization screens
• Secure temporary session handling
• Transaction review and confirmation UI

---

Routes

Authentication

/oauth/signin
/oauth/signup

Transaction Authorization

/transaction?txSession=...

---

Environment Variables

Create a .env file:

VITE_SOCKETFI_SERVER=http://localhost:3020

Example production configuration:

VITE_SOCKETFI_SERVER=https://api.socket.fi

---

Development

Install dependencies:

bun install

Start development server:

bun run dev

---

Production Build

bun run build

Preview production build:

bun run preview

---

Tech Stack

• React
• TypeScript
• Vite
• React Router
• WebAuthn
• @simplewebauthn/browser

---

Authentication Flow

App
  → api.socket.fi
      → temp access token issued
          → redirect to auth.socket.fi
              → passkey authentication
                  → verification
                      → redirect back to app

---

Transaction Authorization Flow

App
  → create tx session
      → redirect to auth.socket.fi/transaction
          → user reviews request
              → passkey confirmation
                  → signed transaction returned

---

Security

• WebAuthn / passkey authentication
• Temporary access sessions
• Secure redirect validation
• Cookie-based session support
• User verification required
• Transaction confirmation before signing

---

License

MIT