Introduction

Alien Solana SSO enables blockchain-backed verification and authentication for Solana applications using Alien ID with on-chain attestations.

What is Solana SSO?

Solana SSO is a decentralized solution specifically designed for the Solana ecosystem. Unlike standard SSO which uses JWT tokens, Solana SSO creates verifiable on-chain attestations that prove user verification directly on the Solana blockchain.

Who should use Solana SSO?

Solana SSO is ideal for:

• Solana dApps requiring user verification
• DeFi protocols needing identity verification
• NFT marketplaces and gaming platforms on Solana
• Any Solana program requiring session verification
• Applications that need provable on-chain verification

Key Features

• On-chain attestations: Verification confirmed directly on Solana blockchain
• Wallet integration: Seamless integration with Solana wallet adapters
• TEE-based security: Execution layer based on TEE
• Session management: Long-lived sessions with on-chain verification
• TypeScript-first: Full type safety with Zod validation
• React integration: Pre-built hooks and components for React apps

Packages

• @alien_org/solana-sso-sdk-core - Core client for any JavaScript/TypeScript project
• @alien_org/solana-sso-sdk-react - React hooks, components, and providers for React applications

How it works

1. User connects Solana wallet - User connects their Solana wallet to your dApp
2. Click Sign In - User clicks the Sign In button
3. Check for attestation - System checks if the wallet has an attestation on-chain
4. Two scenarios:
   • Attestation exists → User is verified immediately
   • No attestation → User creates attestation in Alien app and submits transaction on-chain
5. Verification complete - Once attestation exists on-chain, user is verified

Installation

# Core SDK for vanilla JavaScript/TypeScript
npm install @alien_org/solana-sso-sdk-core
 
# For React projects
npm install @alien_org/solana-sso-sdk-react

Solana Programs

Solana SSO interacts with three on-chain programs:

• Credential Signer Program: 9cstDz8WWRAFaq1vVpTjfHz6tjgh6SJaqYFeZWi1pFHG
• Session Registry Program: DeHa6pyZ2CFSbQQiNMm7FgoCXqmkX6tXG77C4Qycpta6
• SAS (Solana Attestation Service): 22zoJMtdu4tQc2PzL74ZUT7FrwgB1Udec8DdW4yw4BdG

These programs handle session creation, verification, and attestation storage on Solana.

Solana Attestation Service Compatibility

All attestations created by Alien Solana SSO are fully compatible with the Solana Attestation Service. Attestations are created using the official Solana Attestation Service programs. This means:

• Attestations are created using the Solana Attestation Service on-chain programs
• All attestations are discoverable and verifiable through attest.solana.com 
• Full interoperability with other Solana attestation-based applications
• Built on Solana’s official attestation infrastructure

On-Chain Attestation Structure

• Session Entry: Created in Session Registry program
• Solana Entry: Maps Solana address to session
• Attestation: Created in SAS (Solana Attestation Service) program
• All linked via PDAs derived from credential, schema, and user public key

Next Steps

Choose your integration path based on your project:

• Core Integration Guide - For vanilla JavaScript/TypeScript projects.
• React Integration Guide - For React applications.
• API Reference - Core - Complete API documentation for Core SDK.
• API Reference - React - Complete API documentation for React SDK.
• Demo App - Example implementation and source code.