{"id":31923986,"url":"https://github.com/chainsafe/gossamer","last_synced_at":"2026-01-12T00:56:46.795Z","repository":{"id":37285223,"uuid":"168006517","full_name":"ChainSafe/gossamer","owner":"ChainSafe","description":"🕸️ Go Implementation of the Polkadot Host","archived":false,"fork":false,"pushed_at":"2025-09-29T00:02:05.000Z","size":245715,"stargazers_count":455,"open_issues_count":406,"forks_count":143,"subscribers_count":20,"default_branch":"development","last_synced_at":"2025-10-02T02:53:27.879Z","etag":null,"topics":["golang","p2p","polkadot","wasm"],"latest_commit_sha":null,"homepage":"https://chainsafe.github.io/gossamer","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ChainSafe.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","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":"copyright.txt","agents":null,"dco":null,"cla":null}},"created_at":"2019-01-28T17:40:01.000Z","updated_at":"2025-09-21T19:03:30.000Z","dependencies_parsed_at":"2023-09-28T21:41:30.223Z","dependency_job_id":"451cb797-1426-465f-a084-b1b42ed436c0","html_url":"https://github.com/ChainSafe/gossamer","commit_stats":null,"previous_names":["chainsafesystems/gossamer","chainsafesystems/go-pre"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/ChainSafe/gossamer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChainSafe%2Fgossamer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChainSafe%2Fgossamer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChainSafe%2Fgossamer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChainSafe%2Fgossamer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ChainSafe","download_url":"https://codeload.github.com/ChainSafe/gossamer/tar.gz/refs/heads/development","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChainSafe%2Fgossamer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279017175,"owners_count":26086019,"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-10-13T02:00:06.723Z","response_time":61,"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":["golang","p2p","polkadot","wasm"],"created_at":"2025-10-13T23:59:03.926Z","updated_at":"2025-10-13T23:59:37.076Z","avatar_url":"https://github.com/ChainSafe.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg alt=\"Gossamer logo\" src=\"/docs/docs/assets/img/gossamer_banner.png\" width=\"600\" /\u003e\n\u003c/div\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://www.gnu.org/licenses/gpl-3.0\"\u003e\n    \u003cimg alt=\"License: GPL v3\" src=\"https://img.shields.io/badge/License-GPLv3-blue.svg?style=for-the-badge\u0026label=License\" height=\"20\"/\u003e\n  \u003c/a\u003e\n    \u003ca href=\"https://github.com/ChainSafe/gossamer/actions\"\u003e\n    \u003cimg alt=\"build status\" src=\"https://img.shields.io/github/actions/workflow/status/ChainSafe/gossamer/build.yml?branch=development\u0026style=for-the-badge\u0026logo=github\u0026label=build\" height=\"20\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://godoc.org/github.com/ChainSafe/gossamer\"\u003e\n    \u003cimg alt=\"go doc\" src=\"http://img.shields.io/badge/godoc-reference-5272B4.svg?style=for-the-badge\" height=\"20\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://goreportcard.com/report/github.com/ChainSafe/gossamer\"\u003e\n    \u003cimg alt=\"go report card\" src=\"https://goreportcard.com/badge/github.com/ChainSafe/gossamer?style=for-the-badge\" height=\"20\" /\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://app.codecov.io/gh/ChainSafe/gossamer\"\u003e\n    \u003cimg alt=\"Test Coverage\" src=\"https://img.shields.io/codecov/c/github/ChainSafe/gossamer/development?style=for-the-badge\" height=\"20\" /\u003e\n  \u003c/a\u003e\n    \u003ca href=\"https://discord.gg/zy8eRF7FG2\"\u003e\n    \u003cimg alt=\"Discord\" src=\"https://img.shields.io/discord/593655374469660673.svg?style=for-the-badge\u0026label=Discord\u0026logo=discord\" height=\"20\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://medium.com/chainsafe-systems/tagged/polkadot\"\u003e\n    \u003cimg alt=\"Gossamer Blog\" src=\"https://img.shields.io/badge/Medium-grey?style=for-the-badge\u0026logo=medium\" height=\"20\" /\u003e\n  \u003c/a\u003e\n    \u003ca href=\"https://medium.com/chainsafe-systems/tagged/polkadot\"\u003e\n    \u003cimg alt=\"Twitter\" src=\"https://img.shields.io/twitter/follow/chainsafeth?color=blue\u0026label=follow\u0026logo=twitter\u0026style=for-the-badge\" height=\"20\"/\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\u003cbr /\u003e\n\n\u003e **Warning**\n\u003e\n\u003e The Gossamer Polkadot Host is pre-production software [2022-12-01]\n\n\u003eDeveloped by [ChainSafe](https://chainsafe.io) and funded by a Web3 Foundation grant and Polkadot [Treasury proposals](https://polkadot.polkassembly.io/treasury/808?tab=description).\n\u003e\n\nGossamer is a [Golang](https://go.dev/) implementation of the\n[Polkadot Host](https://wiki.polkadot.network/docs/learn-polkadot-host): an\nexecution environment for the Polkadot runtime, which is materialized as a Web\nAssembly (Wasm) blob. In addition to running an embedded Wasm executor, a\nPolkadot Host must orchestrate a number of interrelated services, such as\n[networking](dot/network/README.md), block production, block finalization, a\nJSON-RPC server, [and more](cmd/gossamer/README.md#client-components).\n\n\n## Getting Started\n\nTo get started with Gossamer, follow the steps below to build the source code\nand start a development network.\n\n### Prerequisites\n\n[Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) is required\nto acquire the Gossamer source code, and\n[Make](https://tilburgsciencehub.com/building-blocks/configure-your-computer/automation-and-workflows/make/)\nis used to build it. Building Gossamer requires version 1.20 or higher of\n[Golang](https://go.dev/dl/).\n\n### Installation\n\nClone the [Gossamer](https://github.com/ChainSafe/gossamer) repository and\ncheckout the `development` branch:\n\n```sh\ngit clone git@github.com:ChainSafe/gossamer\ncd gossamer\ngit checkout development\n```\n\nBuild Gossamer:\n\n```sh\nmake gossamer\n```\n\nOr build Gossamer _and_ move the resulting executable to `$GOPATH/bin`:\n\n```sh\nmake install\n```\n\nTo install Gossamer\n\n## Use Gossamer\n\nA comprehensive guide to\n[Gossamer's end-user capabilities](cmd/gossamer/README.md) is located in the\n`cmd/gossamer` directory. What follows is a guide to Gossamer's capabilities as\na Polkadot Host.\n\n### Chain Specifications\n\nA chain specification is a JSON document that defines the\n[genesis](https://wiki.polkadot.network/docs/glossary#genesis) block of a\nblockchain network, as well as network parameters and metadata (e.g. network\nname, bootnodes,\n[telemetry endpoints](https://wiki.polkadot.network/docs/build-node-management#monitoring-and-telemetry),\netc). It is necessary to provide Gossamer with a chain specification in order to\nuse it as a Polkadot Host. The Gossamer repository includes a number of chain\nspecifications, some of which will be used in this guide.\n\n### Configuration Files\n\nGossamer exposes a number of configuration parameters, such as the location of a\nchain specification file. Although it's possible to use command-line parameters,\nthis guide will focus on the usage of Gossamer TOML configuration files, which\ndefine a set of configuration values in a declarative, portable, reusable\nformat. The chain specifications that are used in this guide are each\naccompanied by one or more configuration files.\n\n### Single-Node Development Network\n\nThe name of the Polkadot test network is \"Westend\", and the Gossamer repository\nincludes a chain specification and configuration file for a single-node, local\nWestend test network.\n\nFirst, initialize the directory that will be used by the Gossamer node to manage\nits state:\n\n```sh\n./bin/gossamer init --force --chain westend-dev\n```\n\nNow, start Gossamer as a host for the local Westend development chain:\n\n```sh\n./bin/gossamer --chain westend-dev\n```\n\n### Multi-Node Development Network\n\nThe multi-node development network includes three participants: the Alice, Bob,\nand Charlie test accounts. In three separate terminals, initialize the data\ndirectories for the three Gossamer instances:\n\n```sh\n./bin/gossamer init --force --chain westend-local --alice\n```\n\n```sh\n./bin/gossamer init --force --chain westend-local --bob\n```\n\n```sh\n./bin/gossamer init --force --config westend-local --charlie\n```\n\nThen start the three hosts:\n\n```sh\n./bin/gossamer --chain westend-local --alice\n```\n\n```sh\n./bin/gossamer --chain westend-local --bob\n```\n\n```sh\n./bin/gossamer --chain westend-local --charlie\n```\n\n## Standalone Packages\n\nIn addition to the core functionality provided by Gossamer, we have developed some standalone packages that can be used independently. These packages are located in the `pkg` directory and serve various utility purposes. Here’s an overview of some of these packages:\n\n### Scale\n\nTo support parity's [scale type encoding](https://docs.substrate.io/reference/scale-codec/) in golang.  \nMore details [here](./pkg/scale/README.md)\n\n### Trie\n\nThe `trie` package includes multiple implementations of polkadot merkle tries. These implementations are useful for various applications requiring efficient data structures. Here are the key implementations:\n\n#### In-Memory Trie\n\nThis implementation supports polkadot merkle tries that are stored entirely in memory. It includes features for backing up the trie using a database to ensure persistence.\n\n#### TrieDB\n\nAn evolution of the in-memory trie, `TrieDB` introduces lazy loading capabilities from the underlying database. This approach optimizes performance and resource usage by loading data only as needed.\n\nFor more details on how to use `TrieDB`, refer to the specific [README](pkg/trie/triedb/README.md)\n\n\n## Contribute\n\n- Check out the [Contributing Guidelines](.github/CONTRIBUTING.md) and our\n  [style guide](.github/CODE_STYLE.md).\n- Have questions or just want to say hi? Join us on\n  [Discord](https://discord.gg/Xdc5xjE)!\n\n## Donate\n\nOur work on Gossamer is funded by the community. If you'd like to support us\nwith a donation:\n\n- DOT:\n  [`14gaKBxYkbBh2SKGtRDdhuhtyGAs5XLh55bE5x4cDi5CmL75`](https://polkadot.subscan.io/account/14gaKBxYkbBh2SKGtRDdhuhtyGAs5XLh55bE5x4cDi5CmL75)\n- KSM:\n  [`FAjhFSFoM6X8CxeSp6JE2fPECauCA5NxyB1rAGNSkrVaMtf`](https://kusama.subscan.io/account/FAjhFSFoM6X8CxeSp6JE2fPECauCA5NxyB1rAGNSkrVaMtf)\n- ETH/DAI: `0x764001D60E69f0C3D0b41B0588866cFaE796972c`\n\n## ChainSafe Security Policy\n\nWe take all security issues seriously, if you believe you have found a security\nissue within a ChainSafe project please notify us immediately. If an issue is\nconfirmed, we will take all necessary precautions to ensure a statement and\npatch release is made in a timely manner.\n\n### Reporting a Security Bug\n\nPlease email us a description of the flaw and any related information (e.g.\nreproduction steps, version) to\n[security at chainsafe dot io](mailto:security@chainsafe.io).\n\n## License\n\n_GNU Lesser General Public License v3.0_\n\n\u003cbr /\u003e\n\u003cp align=\"center\"\u003e\n \u003cimg src=\"/docs/docs/assets/img/chainsafe_gopher.png\"\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchainsafe%2Fgossamer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchainsafe%2Fgossamer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchainsafe%2Fgossamer/lists"}