Emblem Auth SDK

Self-custody authentication system that connects user identity to multi-chain vaults. The entry point for all Emblem services—authenticate once, access everything.

View on npm

Choose Your Path

React Components

Recommended

Pre-built UI components with authentication hooks. Perfect for React applications.

App.tsx

✓Pre-built ConnectButton & AuthStatus components

✓Wallet-based authentication with session management

✓Auto token refresh & persistence

Core SDK

Universal

Direct API access for custom implementations. Works in browsers and Node.js.

index.js

✓CLI tools & Node.js scripts

✓Custom integrations & frameworks

✓Session persistence with custom storage

Core Features

🔐

Multi-Chain Identity

Single vault identity across EVM, Solana, Bitcoin, and Hedera networks

🔑

Multiple Auth Methods

Wallet signatures (EVM, Solana, Hedera) or OAuth (Twitter, Google)

⚡

JWT Sessions

Secure token management with automatic refresh and persistence

✍️

Library Signers

Adapters for Viem, Ethers, Web3.js, Solana, and Bitcoin PSBT signing

🌐

Universal Compatibility

Works in browsers, Node.js, Next.js, Express, and more

🎨

Self-Custody

Users control their own keys—no API key sharing required

Built For

Web3 Apps

DeFi platforms, NFT marketplaces, token dashboards

Trading Apps

Portfolio managers, automated bots, market analysis tools

Multi-Chain Tools

Cross-chain wallets, bridge interfaces, aggregators

Backend Services

API servers, automation scripts, blockchain indexers

How It Works

User Connects

User signs a message with their wallet or authenticates via OAuth (Twitter/Google)

Vault Identity Created

Emblem creates or retrieves the user's vault containing multi-chain addresses and encrypted keys

JWT Session Issued

Your app receives a JWT token for authenticated API calls and secure session management

Sign Transactions

Create library-specific signers (Viem, Ethers, Web3.js, Solana, Bitcoin) to sign and submit transactions

What's Available Where

Feature	React	SDK
Pre-built UI Components	✓	—
Wallet Authentication	✓	✓
OAuth Authentication	✓	✓
JWT Session Management	✓	✓
Multi-Chain Signers	✓	✓
Session Persistence	✓	✓
React Hooks	✓	—
Node.js Support	—	✓

Installation

React Components

terminal

Core SDK Only

terminal

Get Started

Choose your preferred path and explore the documentation:

For React Apps

→ Quick Start - React setup guide
→ Components - ConnectButton & AuthStatus
→ Hooks - useEmblemAuth & more
→ Signers - Multi-chain transaction signing

For Custom Apps

→ API Reference - Core SDK methods
→ Signers - Viem, Ethers, Web3.js, Solana, Bitcoin
→ Node.js - Session persistence patterns