{"id":26484322,"url":"https://github.com/sonr-io/sonr","last_synced_at":"2026-05-08T09:02:31.229Z","repository":{"id":37001100,"uuid":"308211255","full_name":"sonr-io/sonr","owner":"sonr-io","description":"A Decentralized Identity Network built for the InterChain 🌐","archived":false,"fork":false,"pushed_at":"2025-12-15T03:01:47.000Z","size":39645,"stargazers_count":643,"open_issues_count":23,"forks_count":37,"subscribers_count":7,"default_branch":"master","last_synced_at":"2026-03-02T13:46:39.017Z","etag":null,"topics":["cosmos-sdk","decentralized-identity","did","dwn","libp2p","sonr"],"latest_commit_sha":null,"homepage":"https://sonr.dev","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sonr-io.png","metadata":{"files":{"readme":".github/README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-10-29T03:51:46.000Z","updated_at":"2026-02-12T20:19:14.000Z","dependencies_parsed_at":"2023-01-17T12:30:21.596Z","dependency_job_id":"d43e8fee-169e-433a-b97e-1cac2179c06b","html_url":"https://github.com/sonr-io/sonr","commit_stats":{"total_commits":439,"total_committers":3,"mean_commits":"146.33333333333334","dds":0.1070615034168565,"last_synced_commit":"2a128af2270d16299fbefc89996694c2b48f36a1"},"previous_names":["sonr-io/core","sonrhq/sonr","sonr-io/sonr","didao-org/sonr","di-dao/sonr","onsonr/sonr","sonr-io/snrd"],"tags_count":316,"template":false,"template_full_name":null,"purl":"pkg:github/sonr-io/sonr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonr-io%2Fsonr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonr-io%2Fsonr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonr-io%2Fsonr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonr-io%2Fsonr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sonr-io","download_url":"https://codeload.github.com/sonr-io/sonr/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonr-io%2Fsonr/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32773858,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"ssl_error","status_checked_at":"2026-05-08T08:22:45.650Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cosmos-sdk","decentralized-identity","did","dwn","libp2p","sonr"],"created_at":"2025-03-20T05:22:34.322Z","updated_at":"2026-05-08T09:02:31.006Z","avatar_url":"https://github.com/sonr-io.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"\n[![Go Reference](https://pkg.go.dev/badge/github.com/sonr-io/sonr.svg)](https://pkg.go.dev/github.com/sonr-io/sonr)\n![GitHub commit activity](https://img.shields.io/github/commit-activity/w/sonr-io/sonr)\n[![Static Badge](https://img.shields.io/badge/homepage-sonr.io-blue?style=flat-square)](https://sonr.io)\n[![Go Report Card](https://goreportcard.com/badge/github.com/sonr-io/sonr)](https://goreportcard.com/report/github.com/sonr-io/sonr)\n\n[![Sonr](./banner.png)](https://sonr.io)\n\n\u003e **Sonr is a blockchain ecosystem combining decentralized identity, secure data storage, and multi-chain interoperability. Built on Cosmos SDK v0.50.14, it provides users with self-sovereign identity through W3C DIDs, WebAuthn authentication, and personal data vaults—all without requiring cryptocurrency for onboarding.**\n\n## 💡 Key Features\n\n### 🔐 Gasless Onboarding\n\nCreate your first decentralized identity without owning cryptocurrency:\n\n```bash\n# Register with WebAuthn (no tokens required!)\nsnrd auth register --username alice\n\n# Register with automatic vault creation\nsnrd auth register --username bob --auto-vault\n```\n\n### 🌐 Multi-Chain Support\n\n- **Cosmos SDK**: Native integration with IBC ecosystem\n- **EVM Compatibility**: Ethereum smart contract support\n- **External Wallets**: MetaMask, Keplr, and more\n\n### 🔑 Advanced Authentication\n\n- **WebAuthn/Passkeys**: Biometric authentication\n- **Hardware Security Keys**: YubiKey, Titan Key support\n- **Multi-Signature**: Multiple verification methods per DID\n\n### 📦 Decentralized Storage\n\n- **IPFS Integration**: Distributed file storage\n- **Encrypted Vaults**: Hardware-backed encryption\n- **Protocol Schemas**: Structured data validation\n\n## 📚 Technical Specifications\n\n- **Cosmos SDK**: v0.50.14\n- **CometBFT**: v0.38.17\n- **IBC**: v8.7.0\n- **Go**: 1.24.1 (toolchain 1.24.4)\n- **WebAssembly**: CosmWasm v1.5.8\n- **Task Queue**: Asynq (Redis-based)\n- **Actor System**: Proto.Actor\n- **Storage**: IPFS, LevelDB\n\n## 🔒 Security\n\n### Gasless Transaction Security\n\n- Limited to WebAuthn registration only\n- Full cryptographic validation required\n- Credential uniqueness enforcement\n- Anti-replay protection\n\n### WebAuthn Security\n\n- Origin validation\n- Challenge-response authentication\n- Device binding\n- Attestation verification\n\n### Multi-Algorithm Support\n\n- Ed25519 (quantum-resistant)\n- ECDSA (secp256k1, P-256)\n- RSA (2048, 3072, 4096 bits)\n- WebAuthn (ES256, RS256)\n\n## 🚀 Quick Start\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/sonr-io/sonr\ncd sonr\n\n# Install the binary\nmake install\n\n# Verify installation\nsnrd version\n```\n\n### Running a Local Node\n\n```bash\n# Start single-node testnet (quick iteration)\nmake localnet\n\n# Start multi-node testnet with Starship\nmake testnet-start\n\n# Stop testnet\nmake testnet-stop\n```\n\n### Building from Source\n\n```bash\n# Build snrd blockchain node\nmake build\n\n# Build Docker image\nmake docker\n\n# Generate code from proto files\nmake proto-gen\n```\n\n### Local Development Network\n\n```bash\n# Standard localnet (auto-detects best method for your system)\nmake localnet     # Works on Arch Linux, Ubuntu, macOS, etc.\n\n# Docker-based localnet (requires Docker)\nmake dockernet    # Runs in detached mode\n\n# One-time setup for your system (optional)\n./scripts/setup_localnet.sh  # Installs dependencies and configures environment\n```\n\n### Testing\n\n```bash\n# Run all tests\nmake test-all\n\n# Module-specific tests\nmake test-did     # DID module tests\nmake test-dwn     # DWN module tests\nmake test-svc     # Service module tests\n\n# E2E tests\nmake ictest-basic # Basic chain functionality\nmake ictest-ibc   # IBC transfers\nmake ictest-wasm  # CosmWasm integration\n\n# Test with coverage\nmake test-cover\n```\n\n### Infrastructure\n\n```bash\n# IPFS for vault operations\nmake ipfs-up      # Start IPFS infrastructure\nmake ipfs-down    # Stop IPFS infrastructure\nmake ipfs-status  # Check IPFS connectivity\n```\n\n## 🏗️ Architecture\n\nSonr is a Cosmos SDK-based blockchain with integrated IPFS storage and three custom modules:\n\n### Core Components\n\n#### **Blockchain Node (`snrd`)**\n\nThe main blockchain daemon built with Cosmos SDK v0.50.14, providing:\n\n- AutoCLI for command generation\n- EVM compatibility via Evmos integration\n- IBC for cross-chain communication\n- CosmWasm smart contract support\n- IPFS integration for decentralized storage\n\n## 📖 Module Documentation\n\n### DID Module\n\nW3C DID specification implementation with:\n\n- **Gasless WebAuthn Registration**: Create DIDs without cryptocurrency\n- **Multi-Algorithm Signatures**: Ed25519, ECDSA, RSA, WebAuthn\n- **External Wallet Linking**: MetaMask, Keplr integration\n- **Verifiable Credentials**: W3C-compliant credential issuance\n\n```bash\n# Create a DID\nsnrd tx did create-did did:sonr:alice '{\"id\":\"did:sonr:alice\",...}' --from alice\n\n# Link external wallet\nsnrd tx did link-external-wallet did:sonr:alice \\\n  --wallet-address 0x742d35Cc6635C0532925a3b8c17C6e583F4d6A42 \\\n  --wallet-type ethereum \\\n  --from alice\n\n# Query DID\nsnrd query did resolve did:sonr:alice\n```\n\n[Full DID Module Documentation](x/did/README.md)\n\n### DWN Module\n\nPersonal data stores with:\n\n- **Structured Data Records**: Hierarchical data organization\n- **Protocol-Based Interactions**: Enforceable data schemas\n- **Secure Vaults**: Enclave-based key management\n- **Multi-Chain Support**: Cosmos SDK and EVM transaction building\n\n```bash\n# Create a vault\nsnrd tx dwn create-vault --from alice\n\n# Store a record\nsnrd tx dwn write-record '{\"data\":\"...\", \"protocol\":\"example.com\"}' --from alice\n\n# Query records\nsnrd query dwn records --owner alice\n```\n\n[Full DWN Module Documentation](x/dwn/README.md)\n\n### Service Module\n\nDecentralized service registry featuring:\n\n- **Domain Verification**: DNS-based ownership proof\n- **Service Registration**: Verified service endpoints\n- **Permission Management**: UCAN capability integration\n\n```bash\n# Verify domain ownership\nsnrd tx svc initiate-domain-verification example.com --from alice\nsnrd tx svc verify-domain example.com --from alice\n\n# Register service\nsnrd tx svc register-service my-service example.com \\\n  --permissions \"read,write\" --from alice\n```\n\n[Full Service Module Documentation](x/svc/README.md)\n\n## 🔧 Configuration\n\n### Environment Variables\n\nEnvironment variables can be configured for local development:\n\n```bash\n# Chain configuration\nexport CHAIN_ID=\"localchain_9000-1\"\nexport BLOCK_TIME=\"1000ms\"\n\n# Network selection for Starship\nexport NETWORK=\"devnet\"  # or \"testnet\"\n\n# IPFS configuration\nIPFS_API_URL=http://127.0.0.1:5001\n```\n\nEnvironment variables can be set directly or via a `.env` file in the project root.\n\n### Starship Configuration\n\nEdit `starship.yml` to configure multi-node testnets:\n\n```yaml\nchains:\n  - id: sonrtest_1-1\n    name: custom\n    numValidators: 3\n    image: onsonr/snrd:latest\n    # ... additional configuration\n```\n\n## 🏗️ Project Structure\n\n```\nsonr/\n├── app/              # Application setup and module wiring\n├── cmd/              # Binary entry points\n│   └── snrd/        # Blockchain node\n├── x/               # Custom chain modules\n│   ├── did/         # W3C DID implementation\n│   ├── dwn/         # Decentralized Web Nodes\n│   └── svc/         # Service management\n├── types/           # Internal packages\n│   ├── coins/       # Coin utilities\n│   └── ipfs/        # IPFS integration\n├── proto/           # Protobuf definitions\n├── scripts/         # Utility scripts\n├── test/            # Integration tests\n└── docs/            # Documentation site\n```\n\n## 🤝 Community \u0026 Support\n\n- [GitHub Discussions](https://github.com/sonr-io/sonr/discussions) - Community forum\n- [GitHub Issues](https://github.com/sonr-io/sonr/issues) - Bug reports and feature requests\n- [Twitter](https://sonr.io/twitter) - Latest updates\n- [Documentation Wiki](https://github.com/sonr-io/sonr/wiki) - Detailed guides\n\n\n## 📄 License\n\nCopyright © 2024 Sonr, Inc.\n\nLicensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for details.\n\n---\n\n\u003cp align=\"center\"\u003e\n  Built with ❤️ by the Sonr team\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsonr-io%2Fsonr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsonr-io%2Fsonr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsonr-io%2Fsonr/lists"}