{"id":14992081,"url":"https://github.com/Sovereign-Labs/sovereign-sdk","last_synced_at":"2025-09-25T14:30:48.698Z","repository":{"id":65229786,"uuid":"563098217","full_name":"Sovereign-Labs/sovereign-sdk","owner":"Sovereign-Labs","description":"A flexible toolkit for building real-time blockchains","archived":false,"fork":false,"pushed_at":"2025-09-23T14:26:09.000Z","size":48456,"stargazers_count":439,"open_issues_count":181,"forks_count":139,"subscribers_count":16,"default_branch":"nightly","last_synced_at":"2025-09-23T14:43:03.372Z","etag":null,"topics":["blockchain","modular","optimistic-rollup","rust","sdk","sovereign","verifiable-server","zk-rollup"],"latest_commit_sha":null,"homepage":"https://docs.sovereign.xyz","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Sovereign-Labs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"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":"CLA.md"}},"created_at":"2022-11-07T22:40:19.000Z","updated_at":"2025-09-23T13:01:11.000Z","dependencies_parsed_at":"2023-12-20T13:26:31.128Z","dependency_job_id":"605f2627-3409-4e5e-bef5-ee30544a885b","html_url":"https://github.com/Sovereign-Labs/sovereign-sdk","commit_stats":null,"previous_names":["sovereign-labs/sovereign-sdk","sovereign-labs/sovereign"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Sovereign-Labs/sovereign-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sovereign-Labs%2Fsovereign-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sovereign-Labs%2Fsovereign-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sovereign-Labs%2Fsovereign-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sovereign-Labs%2Fsovereign-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Sovereign-Labs","download_url":"https://codeload.github.com/Sovereign-Labs/sovereign-sdk/tar.gz/refs/heads/nightly","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sovereign-Labs%2Fsovereign-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276932070,"owners_count":25730717,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-25T02:00:09.612Z","response_time":80,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["blockchain","modular","optimistic-rollup","rust","sdk","sovereign","verifiable-server","zk-rollup"],"created_at":"2024-09-24T15:00:43.353Z","updated_at":"2025-09-25T14:30:48.692Z","avatar_url":"https://github.com/Sovereign-Labs.png","language":"Rust","funding_links":[],"categories":["Web3 and ZKP Framework","Rust"],"sub_categories":[],"readme":"![](./docs/assets/banner.jpg)\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://codecov.io/gh/Sovereign-Labs/sovereign-sdk\" \u003e \n      \u003cimg alt=\"Coverage\" src=\"https://codecov.io/gh/Sovereign-Labs/sovereign-sdk/branch/nightly/graph/badge.svg\"/\u003e \n  \u003c/a\u003e\n  \u003cimg alt=\"GitHub Workflow Status (with event)\" src=\"https://img.shields.io/github/actions/workflow/status/sovereign-labs/sovereign-sdk/prerelease_checks.yml?label=Pre-release%20checks\"\u003e\n\u003c/div\u003e\n\n## What is the Sovereign SDK?\n\nThe Sovereign SDK is a flexible toolkit for building rollups. It provides real time (sub 10ms) soft-confirmations and excellent performance (thousands of TPS) while giving developers\nfull control over their application logic.\n\nKey features include...\n- Gasless transactions (via the Paymaster module)\n- Integrated bridging via Hyperlane\n- Wallet integrations (including Phantom, Privy, Metamask, and many more)\n- Complete customizability (including transaction delays, hooks, and custom address types)\n- Out-of-the-box observability (via InfluxDB and Grafana)\n\nNote that the Sovereign SDK is provided under a revenue share agreement for commercial applications. See the LICENSE file for more details.\n\n## Getting Started\n\nThe fastest way to get up and running is to follow the [starter guide](https://docs.sovereign.xyz/2-running-starter.html) at \u003cdocs.sovereign.xyz\u003e. You can also find a customizable rollup\ntemplate in the [Rollup Starter](https://github.com/Sovereign-Labs/rollup-starter) repository. \n\n## What's Inside?\n\nThe core tooling for the SDK lives in the `crates` directory. Inside, you'll find the following: \n\n### Module System\n\nThe `module-system` crate defines interfaces that make it easy to re-use business logic across different rollups (located in `sov-modules-api`). It also provides a large collection\nof pre-build modules for common functionality. Some examples include...\n - The `bank` module for creating and transferring tokens\n - The `paymaster` module for sponsoring transactions\n - The `hyperlane` modules, which support efficient bridging to and from Sovereign SDK rollups.\n\n### Full Node\n\nThe `full-node` folder provides components for the full-node - including the database, APIs, the soft-confirming sequencer, and the full node itself.\n\nThe full node is responsible for downloading transactions from the DA layer and executing them to produce the rollup state. State is stored in an authenticated key-value \nstore - either a Jellyfish Merkle Tree (JMT), or a [Nearly Optimal Merkle Tree](https://sovereign.mirror.xyz/jfx_cJ_15saejG9ZuQWjnGnG-NfahbazQH98i1J3NN8).\n\nThe sequencer is responsible for accepting new transactions, providing instant soft-confirmations, and then placing bundles of confirmed transactions  onto the DA layer for\nfull nodes to execute. \n\n### Adapters\n\nThe Sovereign SDK is configurable to run on top of almost any Data Availability layer or zkVM. The `adapters` folder contain the logic integrating 3rd party codebases\ninto the Sovereign SDK. \n\nCurrently, we maintain zkVM adapters for:\n- [`Risc0`](https://www.risczero.com)\n- [`SP1`](https://succinct.xyz)\n\nAnd DA layer adapters for:\n- [`Celestia`](https://www.celestia.org)\n- [`Bitcoin`](https://bitcoin.org/en/)\n\n## License\n\nSee the [LICENSE](LICENSE.md) file for license rights and limitations. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSovereign-Labs%2Fsovereign-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSovereign-Labs%2Fsovereign-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSovereign-Labs%2Fsovereign-sdk/lists"}