{"id":51648208,"url":"https://github.com/nunchi-labs/sdk","last_synced_at":"2026-07-29T07:00:24.709Z","repository":{"id":363985073,"uuid":"1256284679","full_name":"nunchi-labs/sdk","owner":"nunchi-labs","description":"financial primitives for commonware chains","archived":false,"fork":false,"pushed_at":"2026-07-14T08:59:28.000Z","size":1628,"stargazers_count":6,"open_issues_count":19,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-14T10:31:35.857Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/nunchi-labs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-06-01T16:23:46.000Z","updated_at":"2026-07-10T06:34:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/nunchi-labs/sdk","commit_stats":null,"previous_names":["nunchi-labs/sdk"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nunchi-labs/sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nunchi-labs%2Fsdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nunchi-labs%2Fsdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nunchi-labs%2Fsdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nunchi-labs%2Fsdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nunchi-labs","download_url":"https://codeload.github.com/nunchi-labs/sdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nunchi-labs%2Fsdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36022278,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-07-29T02:00:04.910Z","response_time":95,"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":[],"created_at":"2026-07-14T01:00:32.155Z","updated_at":"2026-07-29T07:00:24.699Z","avatar_url":"https://github.com/nunchi-labs.png","language":"Rust","funding_links":[],"categories":["Rust"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"image.png\" alt=\"Nunchi\" width=\"240\" /\u003e\n\u003c/p\u003e\n\n\u003ch3 align=\"center\"\u003eNunchi SDK\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n  modular blockchain framework adding financial primitives to commonware-based chains\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://docs.nunchi.trade\"\u003e\u003cstrong\u003eDocs\u003c/strong\u003e\u003c/a\u003e \u0026nbsp;\u0026bull;\u0026nbsp;\n  \u003ca href=\"https://discord.gg/nunchi\"\u003e\u003cstrong\u003eDiscord\u003c/strong\u003e\u003c/a\u003e \u0026nbsp;\u0026bull;\u0026nbsp;\n  \u003ca href=\"https://x.com/nunchi\"\u003e\u003cstrong\u003eX\u003c/strong\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://app.codecov.io/gh/nunchi-labs/sdk\"\u003e\n    \u003cimg src=\"https://codecov.io/gh/nunchi-labs/sdk/graph/badge.svg\" alt=\"Codecov\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n\n# What this is\nThe Nunchi SDK is an easy-to-use modular blockchain framework offering financial primitives for commonware-based chains. The core of the framework can be found in the [`nunchi-coins`](coins/) crate\n\nA chain built with the Nunchi SDK adopts our coin and account model, dkg resharing, and bridging setup. The SDK is handcrafted for the requirements of specialized low-latency finance.\n\n## Modules\n\nThis repository will contain modules for building public and private blockchains, as well as sequencer systems / rollups. \n\n### Blockchain Basics\n\n* [`nunchi-coins`](coins/) - defines what a coin and account are\n* [`nunchi-common`](common/) - core abstractions for addresses, state db, and runtime\n* [`nunchi-crypto`](crypto/) - core primitives/wrappers around commonware cryptographic primitives\n* [`nunchi-rpc`](rpc/) - core abstractions for modular RPC\n* [`nunchi-dkg`](dkg/) - contains dkg resharing ceremony logic and a consensus engine orchestator\n* [`nunchi-bridge`](bridge/) - bridges state roots from other chains, to verify against\n* [`nunchi-mempool`](mempool/) - simple p2p mempool\n* [`nunchi-oracle`](oracle/) - ingests namespaced, arbitrary data for interpretation by other modules \n* `nunchi-chat` - allows humans or agents to publish to permanent on-chain public conversations\n* `nunchi-factory` - wrapper of coins for mass issuance \n\n### Network Infrastructure \n\n* [`nunchi-authority`](authority/) - provides a proof of authority setup for a chain\n* `nunchi-pos` - provides a proof of stake security setup for a chain\n\n* [`nunchi-narae`](narae/) - local devnet runner\n* [`nunchi-chain`](chain/) - runtime primitives for generated nunchi chains.\n\n### Financial Primitives\n\n* `nunchi-margin` - user has BTC + nunchi and doesn't want to sell, and deposits BTC+nunchi and gets a stablecoin.  Could be backed by other coins, not just btc and nunchi. \n* `nunchi-securities` - Non-synthetic perps contracts (delivery of tokenized stock)\n* `nunchi-vaults` - a module for running vaults composed of many types of capital, traded by an authorised offchain party\n* [`nunchi-clob`](clob/) - used on the global chain, provides liquidity between local chain tokens\n* `nunchi-derivatives` - ingests a price feed and creates derivatives products\n* `nunchi-stablecoin` - a wrapper of coins special for the needs of stablecoins\n\n### Chain Examples\n\n* [`coins-chain`](examples/coins/chain) - default PoA chain\n* [`bridge-chain`](examples/bridge-chain) - two chains bridging consensus certificates\n* [`custom-module`](examples/custom-module) - starter template for creating a custom nunchi module\n\n## Commonware compatibility\n\nThis workspace pins `commonware-*` crates to **2026.7.0**.\n\nWhen upgrading nodes:\n\n* Do not run mixed commonware versions in the same peer set (marshal coding / ZODA shards and other wire formats are not interchangeable).\n* Mid-sync glue metadata from v2026.5.0 cannot resume after upgrading to v2026.7.0; clear or re-sync any node that crashed mid state-sync before the bump.\n* Fresh joining nodes can enable peer QMDB state sync with `state_sync = true`. Nunchi's resolver preserves Commonware's standard wire layout while decoding variable-value operations with the chain-wide 512 KiB value bound.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnunchi-labs%2Fsdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnunchi-labs%2Fsdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnunchi-labs%2Fsdk/lists"}