@alien_org/solana-sso-sdk-core
v1.0.4
Published
Solana-specific authentication client for [Alien SSO](https://alien.org) with on-chain attestation support. Enables blockchain-native authentication with session verification on Solana.
Readme
@alien_org/solana-sso-sdk-core
Solana-specific authentication client for Alien SSO with on-chain attestation support. Enables blockchain-native authentication with session verification on Solana.
⚠️ Alpha Version Notice
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.
Installation
npm install @alien_org/solana-sso-sdk-core @solana/web3.jsFeatures
- ✅ On-chain attestations - Verifiable sessions on Solana blockchain
- ✅ PDA derivation utilities - All necessary account derivations
- ✅ Transaction building - Ready-to-sign attestation transactions
- ✅ TypeScript-first with full type safety
- ✅ Runtime validation via Zod schemas
- ✅ Multi-program support - Credential Signer, Session Registry, SAS
Documentation
📚 Full documentation at dev.alien.org/docs
- Solana Integration Guide - Complete integration walkthrough
- API Reference - Detailed API documentation
- What is Alien Session? - Session architecture explained
- Demo dApp - Example Solana application
React Integration
For React applications with Solana wallet adapters, check out @alien_org/solana-sso-sdk-react:
npm install @alien_org/solana-sso-sdk-reactAuthentication Flow
- User connects Solana wallet
- Generate deeplink with wallet address → Display QR code
- User authenticates in Alien mobile app
- Poll for completion → Get oracle signature and session data
- Build transaction → Create on-chain attestation
- Sign and send → User signs with wallet, transaction confirms
- Verify attestation → Check on-chain session validity
On-Chain Programs
The SDK integrates with three Solana programs:
- Credential Signer (
9cstDz8WWRAFaq1vVpTjfHz6tjgh6SJaqYFeZWi1pFHG) - Manages credentials - Session Registry (
DeHa6pyZ2CFSbQQiNMm7FgoCXqmkX6tXG77C4Qycpta6) - Stores sessions - SAS (
22zoJMtdu4tQc2PzL74ZUT7FrwgB1Udec8DdW4yw4BdG) - Solana Attestation Service
All program IDs are configurable via constructor options.
Getting a Provider Address
Register your application at the Developer Portal to get your provider credentials.
TypeScript Support
Includes full TypeScript declarations with Zod runtime validation:
import type {
AlienSolanaSsoClientConfig,
SolanaLinkResponse,
SolanaPollResponse,
SolanaAttestationResponse
} from '@alien_org/solana-sso-sdk-core';Peer Dependencies
@solana/web3.js- Solana blockchain interaction
License
MIT
