mirror of
https://github.com/sonr-io/sonr.git
synced 2026-09-16 23:16:25 +00:00
283 lines
8.9 KiB
Plaintext
283 lines
8.9 KiB
Plaintext
---
|
|
title: Introduction
|
|
description: 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
|
|
icon: "house"
|
|
sidebar:
|
|
label: "Introduction"
|
|
---
|
|
|
|
Sonr is a Cosmos SDK chain that replaces wallet addresses with W3C DIDs, seed
|
|
phrases with passkeys, and unlimited token approvals with scoped UCAN
|
|
capabilities. Start wherever you are:
|
|
|
|
<CardGroup cols={2}>
|
|
<Card title="Install snrd" href="/install" icon="download">
|
|
Get the binary, join a network, and run your first query.
|
|
</Card>
|
|
<Card title="Set up your environment" href="/development" icon="code">
|
|
The development workflow: local node, codegen, and testing.
|
|
</Card>
|
|
<Card title="Become a validator" href="/onboarding" icon="boxes">
|
|
Join the active set and start signing blocks.
|
|
</Card>
|
|
<Card title="Module reference" href="/reference/modules/did" icon="boxes">
|
|
`x/did`, `x/dwn`, `x/svc`, and `x/dex` — messages, queries, and state.
|
|
</Card>
|
|
</CardGroup>
|
|
|
|
:::note[Who this is for]
|
|
**Developers** integrating identity and payments with standard web APIs.
|
|
**Validators** securing the network. **Users** who want sovereign identity
|
|
without seed phrases. This page covers architecture and integration patterns —
|
|
for hands-on walkthroughs start with [Get Started](/development), and for exact
|
|
signatures see the [Reference](/reference).
|
|
:::
|
|
|
|
## 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
|
|
|
|
<CardGroup>
|
|
<Card title="Decentralized Identity (DID)" href="/reference/modules/did">
|
|
W3C-compliant identity system using WebAuthn for passwordless authentication
|
|
</Card>
|
|
<Card title="Decentralized Web Nodes (DWN)" href="/reference/concepts/sonrmodules/dwn/">
|
|
Personal Vaults acting as user-controlled agents for blockchain interactions
|
|
</Card>
|
|
<Card title="UCAN Authorization" href="/reference/modules/svc">
|
|
Capability-based permissions replacing dangerous unlimited approve patterns
|
|
</Card>
|
|
<Card title="Service Registry" href="/reference/modules/svc">
|
|
Stake-based trust system for service discovery and DNS verification
|
|
</Card>
|
|
</CardGroup>
|
|
|
|
## 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:
|
|
|
|
```html
|
|
<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
|
|
|
|
<CardGroup>
|
|
<Card title="Browser Integration" href="/onboardingbrowser">
|
|
Web browser integration patterns and examples
|
|
</Card>
|
|
<Card title="Highway Wallet" href="/highway/">
|
|
Highway system powering user sovereignty
|
|
</Card>
|
|
<Card title="Payment Integration" href="/highway/wallets/sending-payments">
|
|
Payment integration guide
|
|
</Card>
|
|
<Card title="Blockchain Modules" href="/reference/concepts/sonr">
|
|
Core blockchain modules and architecture
|
|
</Card>
|
|
</CardGroup>
|
|
|
|
## For Validators
|
|
|
|
### Network Components
|
|
|
|
Validators secure four critical systems:
|
|
|
|
<CardGroup>
|
|
<Card title="Blockchain Core" href="/reference/concepts/sonr">
|
|
Cosmos SDK with IBC for cross-chain operations
|
|
</Card>
|
|
<Card title="Token Economics" href="/reference/concepts/sonrtoken/">
|
|
Tokenomics, staking, and governance
|
|
</Card>
|
|
<Card title="Highway Proxy" href="/highway/">
|
|
HTTP bridge supporting WebAuthn authentication
|
|
</Card>
|
|
<Card title="Validator Setup" href="/deployment">
|
|
Validator node setup and operations
|
|
</Card>
|
|
</CardGroup>
|
|
|
|
### 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
|
|
|
|
<CardGroup>
|
|
<Card title="Identity System" href="/reference/modules/did">
|
|
W3C DIDs with WebAuthn for digital sovereignty
|
|
</Card>
|
|
<Card title="DID Module" href="/reference/modules/did">
|
|
Blockchain implementation of identity management
|
|
</Card>
|
|
</CardGroup>
|
|
|
|
### Data Sovereignty
|
|
|
|
<CardGroup>
|
|
<Card title="DWN Module" href="/reference/concepts/sonrmodules/dwn/">
|
|
Personal Vaults for user-controlled data and agents
|
|
</Card>
|
|
<Card title="Blockchain Network" href="/reference/concepts/sonrnetwork">
|
|
Network architecture and specifications
|
|
</Card>
|
|
</CardGroup>
|
|
|
|
### Authorization System
|
|
|
|
<CardGroup>
|
|
<Card title="UCAN Module" href="/reference/modules/svc">
|
|
Capability-based permissions for secure delegation
|
|
</Card>
|
|
<Card title="Service Module" href="/reference/modules/svc">
|
|
Registration, verification, and trust management
|
|
</Card>
|
|
</CardGroup>
|
|
|
|
### Cross-Chain Features
|
|
|
|
<CardGroup>
|
|
<Card title="Blockchain Network" href="/reference/concepts/sonrnetwork">
|
|
Network architecture and cross-chain features
|
|
</Card>
|
|
<Card title="Payment Handler" href="/highway/wallets/sending-payments">
|
|
W3C API for seamless crypto payments
|
|
</Card>
|
|
</CardGroup>
|
|
|
|
## Getting Started
|
|
|
|
### Developers
|
|
|
|
Build Web3 applications without blockchain complexity:
|
|
|
|
<CardGroup>
|
|
<Card title="Quick Start" href="/onboarding">
|
|
Create your first Sonr application in 10 minutes
|
|
</Card>
|
|
<Card title="Browser Integration" href="/onboardingbrowser">
|
|
Real-world integration patterns for web applications
|
|
</Card>
|
|
<Card title="CLI Tools" href="/onboardingcli">
|
|
Command line tools and utilities
|
|
</Card>
|
|
</CardGroup>
|
|
|
|
### Validators
|
|
|
|
Secure the future of digital sovereignty:
|
|
|
|
<CardGroup>
|
|
<Card title="Node Setup" href="/deployment">
|
|
Complete validator installation guide
|
|
</Card>
|
|
<Card title="Token Economics" href="/reference/concepts/sonrtoken/">
|
|
Token distribution, staking, and governance
|
|
</Card>
|
|
<Card title="Security" href="/reference/security/">
|
|
Security practices and compliance
|
|
</Card>
|
|
</CardGroup>
|
|
|
|
### Users
|
|
|
|
Experience true digital ownership:
|
|
|
|
<CardGroup>
|
|
<Card title="Create Identity" href="/onboarding">
|
|
30-second setup with biometric authentication
|
|
</Card>
|
|
<Card title="Use Your Vault" href="/reference/concepts/sonrmodules/dwn/">
|
|
Master your personal Web3 agent
|
|
</Card>
|
|
<Card title="Security Guide" href="/reference/security/">
|
|
Privacy and sovereignty protection
|
|
</Card>
|
|
</CardGroup>
|
|
|
|
## Next Steps
|
|
|
|
:::note[Ready to Build?]
|
|
**Developers**: Start with the [Quick Start Guide](/onboarding) to build your first Sonr application.
|
|
|
|
**Validators**: Follow the [Node Setup Guide](/deployment) to join the network.
|
|
|
|
**Users**: [Create your identity](/onboarding) 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.
|