Core TypeScript client for [Alien SSO](https://alien.org) authentication. Provides OIDC-compatible authentication with blockchain and TEE backing.
npm install @alien_org/sso-sdk-coreCore TypeScript client for Alien SSO authentication. Provides OIDC-compatible authentication with blockchain and TEE backing.
This is an early alpha version. The SDK is under active development and may contain bugs or undergo breaking changes. Use with caution in production environments.
``bash`
npm install @alien_org/sso-sdk-core
- ✅ TypeScript-first with full type safety
- ✅ Runtime validation via Zod schemas
- ✅ PKCE support for secure authorization
- ✅ Dual exports: ESM and CJS
- ✅ Zero UI dependencies - use in any JavaScript environment
- ✅ Storage management for tokens and session data
📚 Full documentation at dev.alien.org/docs
- Integration Guide - Complete integration walkthrough
- API Reference - Detailed API documentation
- What is Alien Session? - Session architecture explained
- Demo App - Example application
If you're using React, check out @alien_org/sso-sdk-react for hooks and pre-built components:
`bash`
npm install @alien_org/sso-sdk-react
1. Generate deeplink → Display QR code or redirect
2. User authenticates in Alien mobile app
3. Poll for completion → Get authorization code
4. Exchange code → Receive access token
5. Verify token → Validate with server (optional)
The SDK uses browser storage for session management:
- localStorage: alien-sso_access_token - Access tokenalien-sso_code_verifier
- sessionStorage: - PKCE code verifier
Register your application at the Developer Portal to get your provider credentials.
Includes full TypeScript declarations with Zod runtime validation:
`typescript``
import type {
AlienSsoClientConfig,
AuthorizeResponse,
PollResponse,
ExchangeCodeResponse,
TokenInfo
} from '@alien_org/sso-sdk-core';
- Modern browsers with ES2020+ support
- Chrome, Firefox, Safari, Edge (latest versions)
MIT