Introduction
The peer-to-peer identity and asset management system that makes Web3 as easy as Web2 through DID documents, WebAuthn, and IPFS—providing users with secure, portable decentralized identity
Introduction to Sonr
Scope
This document introduces Sonr's blockchain architecture, core components, and integration patterns. It covers identity management, authentication, data sovereignty, and cross-chain operations. This document does not cover implementation details or code examples—see the Quick Start Guide for hands-on tutorials.
Audience
Developers building Web3 applications who want simple integration patterns. Validators interested in securing a next-generation blockchain network. Users seeking sovereign digital identity solutions. Prerequisites: Basic understanding of web development (HTML/JavaScript) for developers; blockchain consensus for validators.
Summary
Sonr is a Cosmos SDK blockchain that simplifies Web3 through Decentralized Identity (DIDs), passwordless authentication (WebAuthn), and user-controlled agents (Vaults). Developers integrate crypto features using standard web technologies. Validators secure a network bridging Web2 and Web3. Users gain digital sovereignty without complexity.
What is Sonr?
Sonr transforms blockchain interaction through four innovations:
- W3C-compliant DIDs replace wallet addresses
- WebAuthn eliminates seed phrases
- Personal Vaults automate blockchain operations
- UCAN permissions prevent unlimited approvals
These components create a system where users onboard in 30 seconds using biometrics, developers add crypto features with HTML forms, and validators earn rewards securing digital sovereignty.
Why Sonr Matters
Current Problems
Traditional Web3 forces users to:
- Manage 24-word seed phrases
- Install browser extensions
- Understand gas fees
- Navigate multiple wallets
One mistake loses everything.
Sonr's Solution
Sonr provides:
- 30-second onboarding with Face ID or fingerprint
- No seed phrases through WebAuthn security
- No gas fees for account creation
- Universal compatibility across all devices
- Automatic recovery via social and biometric methods
Core Architecture
Decentralized Identity (DID)
W3C-compliant identity system using WebAuthn for passwordless authentication
Decentralized Web Nodes (DWN)
Personal Vaults acting as user-controlled agents for blockchain interactions
UCAN Authorization
Capability-based permissions replacing dangerous unlimited approve patterns
Service Registry
Stake-based trust system for service discovery and DNS verification
For Developers
Integration Benefits
Sonr enables crypto features without blockchain knowledge:
- Use existing skills: HTML, CSS, JavaScript
- Zero dependencies: No SDKs or wallet libraries
- Progressive enhancement: Start simple, add features
- Enterprise ready: Integrates with existing auth systems
Simple Payment Example
Transform any HTML form into a crypto payment interface:
<form hx-post="/api/sonr/payment" hx-target="#result">
<input type="email" name="recipient" placeholder="alice@sonr.id" />
<input type="number" name="amount" placeholder="25.00" />
<select name="currency">
<option value="USDC">USDC</option>
<option value="ATOM">ATOM</option>
</select>
<button type="submit">Send Payment</button>
</form>
Users approve with biometrics. Vaults handle transactions. No wallet connections required.
Developer Resources
Client Integration
HTMX, iFrames, and Browser APIs for crypto features
Wallet Architecture
Four-pillar system powering user sovereignty
Payment Systems
W3C Payment Handler API with DWN protocols
Service Registration
DNS verification and stake-based trust
For Validators
Network Components
Validators secure four critical systems:
Blockchain Core
Cosmos SDK with IBC for cross-chain operations
IPFS Network
Private storage for MPC shares and user data
Highway Proxy
HTTP bridge supporting WebAuthn authentication
Motr Enclaves
WASM environment for secure Vault execution
Validator Operations
Validators perform five key functions:
- Validate identities: Process DID operations and WebAuthn credentials
- Execute Vaults: Run capability delegations and revocations
- Bridge chains: Process IBC and InterchainAccount transactions
- Verify services: Validate DNS ownership and registrations
- Coordinate MPC: Participate in multi-party key management
Economic Incentives
- Block rewards: Earn from transaction fees and inflation
- Service fees: Share revenue from registrations
- MEV protection: Built-in maximal extractable value prevention
- Sustainable model: Long-term network health design
Key Concepts
Identity Management
Identity System
W3C DIDs with WebAuthn for digital sovereignty
DID Module
Blockchain implementation of identity management
Data Sovereignty
DWN Module
Personal Vaults for user-controlled data and agents
IPFS Storage
Private network for MPC and content addressing
Authorization System
UCAN Module
Capability-based permissions for secure delegation
Service Module
Registration, verification, and trust management
Cross-Chain Features
IBC Protocol
Bridgeless transactions via InterchainAccounts
Payment Handler
W3C API for seamless crypto payments
Getting Started
Developers
Build Web3 applications without blockchain complexity:
Quick Start
Create your first Sonr application in 10 minutes
Examples
Real-world integration patterns and code samples
SDKs
APIs and tools for every platform
Validators
Secure the future of digital sovereignty:
Node Setup
Complete validator installation guide
Operations
Daily maintenance and best practices
Economics
Rewards, risks, and tokenomics explained
Users
Experience true digital ownership:
Create Identity
30-second setup with biometric authentication
Use Your Vault
Master your personal Web3 agent
Security Guide
Privacy and sovereignty protection
Next Steps
Ready to Build?
Developers: Start with the Quick Start Guide to build your first Sonr application.
Validators: Follow the Node Setup Guide to join the network.
Users: Create your identity in under 30 seconds.
Explore the concepts above or dive into specific topics using the navigation menu. Join us in building the sovereign internet where identity belongs to individuals, not platforms.