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:

  1. W3C-compliant DIDs replace wallet addresses
  2. WebAuthn eliminates seed phrases
  3. Personal Vaults automate blockchain operations
  4. 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

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

For Validators

Network Components

Validators secure four critical systems:

Validator Operations

Validators perform five key functions:

  1. Validate identities: Process DID operations and WebAuthn credentials
  2. Execute Vaults: Run capability delegations and revocations
  3. Bridge chains: Process IBC and InterchainAccount transactions
  4. Verify services: Validate DNS ownership and registrations
  5. 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

Data Sovereignty

Authorization System

Cross-Chain Features

Getting Started

Developers

Build Web3 applications without blockchain complexity:

Validators

Secure the future of digital sovereignty:

Users

Experience true digital ownership:

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.