This is an early alpha version of the Alien SSO SDK. The SDK is under active development and may contain bugs or undergo breaking changes. Use with caution in production environments.

This monorepo provides two authentication approaches:

• Standard SSO: Web2-style OIDC authentication with TEE and blockchain backing
• Solana SSO: Blockchain-native authentication with on-chain attestations on Solana

• @alien-id/sso - Core TypeScript client for OIDC-style authentication
• @alien-id/sso-react - React hooks and components for Standard SSO

• @alien-id/sso-solana - Solana-specific authentication client with on-chain attestation support
• @alien-id/sso-solana-react - React hooks and components for Solana SSO

📚 Full documentation available at dev.alien.org/docs

• Standard SSO Integration Guide

  • Core Integration - Vanilla JS/TS
  • React Integration - React hooks and components

• Solana SSO Integration Guide

  • Core Integration - Vanilla JS/TS with Solana
  • React Integration - React with wallet adapters

• Standard SSO Core API - @alien-id/sso
• Standard SSO React API - @alien-id/sso-react
• Solana SSO Core API - @alien-id/sso-solana
• Solana SSO React API - @alien-id/sso-solana-react

• What is Alien Session? - Session architecture and lifecycle
• What is Alien Provider? - Provider registration and management

• Standard SSO Demo App - Example React application
• Solana SSO Demo App - Example Solana dApp

This is a Turborepo monorepo. To work with the SDK locally:

# Install dependencies
npm install

# Build all packages
npm run build

# Run in development mode (watch mode)
npm run dev

# Run tests
npm test

# Run demo apps
npm --filter example-sso-app run dev
npm --filter example-solana-sso-app run dev

To use the SDK, you need a provider address. Register your application at the Developer Portal to get your provider credentials.

• ✅ TypeScript-first with full type safety
• ✅ Runtime validation via Zod schemas
• ✅ React hooks and pre-built components
• ✅ OIDC-compatible standard authentication flow
• ✅ Solana integration with on-chain attestations
• ✅ PKCE support for secure authorization
• ✅ Dual export formats: ESM and CJS
• ✅ Mobile-friendly with QR code and deep link support

• Modern browsers with ES2020+ support
• Chrome, Firefox, Safari, Edge (latest versions)

• 📖 Documentation
• 🐛 Report Issues
• 💬 Discord Community