Popularity
6.6
Stable
Activity
9.4
Growing
415
18
106

Programming language: Go
License: GNU Lesser General Public License v3.0 only
Tags: Blockchain    
Latest version: v0.6.0

gossamer alternatives and similar packages

Based on the "Blockchain" category.
Alternatively, view gossamer alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of gossamer or a related project?

Add another 'Blockchain' Package

README

A Go Implementation of the Polkadot Host

Warning 2022-11-01: Gossamer is pre-production software

Gossamer is an implementation of the Polkadot Host: an execution environment for the Polkadot runtime, which is materialized as a Web Assembly (Wasm) blob. In addition to running an embedded Wasm executor, a Polkadot Host must orchestrate a number of interrelated services, such as [networking](dot/network/README.md), block production, block finalization, a JSON-RPC server, [and more](cmd/gossamer/README.md).

For more information about Gossamer, check out the Gossamer Docs.

Get Started

Prerequisites

Install Go version >=1.18

Installation

get the ChainSafe/gossamer repository:

git clone [email protected]:ChainSafe/gossamer
cd gossamer

build gossamer command:

make gossamer

Troubleshooting for Apple Silicon users

If you are facing the following problem with the wasmer:

undefined: cWasmerImportObjectT
undefined: cWasmerImportFuncT
undefined: cWasmerValueTag

Make sure you have the following Golang enviroment variables:

  • GOARCH="amd64"
  • CGO_ENABLED="1"

use go env to see all the Golang enviroment variables

use go env -w ENV_NAME=ENV_VALUE to set the new value

Run Development Node

To initialise a development node:

./bin/gossamer --chain dev init

To start the development node:

./bin/gossamer --chain dev

The development node is configured to produce a block every slot and to finalise a block every round (as there is only one authority, alice.)

Run Gossamer Node

The gossamer node runs by default as an authority with 9 authorites set at genesis. The built-in keys, corresponding to the authorities, that are available for the node are alice, bob, charlie, dave, eve, ferdie, george, and ian.

To initialise a gossamer node:

./bin/gossamer --chain gssmr init

To start the gossamer node:

./bin/gossamer --chain gssmr --key alice

Note: If you only run one gossamer node, the node will not build blocks every slot or finalize blocks; it will appear that the node is doing nothing, but it is actually waiting for a slot to build a block. This is because there are 9 authorities set, so at least 6 of the authorities should be run for a functional network. If you wish to reduce the number of authorities, you can modify the genesis file in chain/gssmr/genesis-spec.json.

Run Kusama Node

Kusama is currently supported as a full node, ie. it can sync the chain but not act as an authority.

To initialise a kusama node:

./bin/gossamer --chain kusama init

To start the kusama node:

./bin/gossamer --chain kusama

The node may not appear to do anything for the first minute or so (it's bootstrapping to the network.) If you wish to see what is it doing in this time, you can turn on debug logs in chain/gssmr/config.toml:

[log]
network = "debug"

After it's finished bootstrapping, the node should begin to sync.

Run Polkadot Node

Polkadot is currently supported as a full node, ie. it can sync the chain but not act as an authority.

To initialise a polkadot node:

./bin/gossamer --chain polkadot init

To start the polkadot node:

./bin/gossamer --chain polkadot

Contribute

  • Check out [Contributing Guidelines](.github/CONTRIBUTING.md) and our [code style](.github/CODE_STYLE.md) document
  • Have questions? Say hi on Discord!

Donate

Our work on Gossamer is funded by the community. If you'd like to support us with a donation:

ChainSafe Security Policy

Reporting a Security Bug

We take all security issues seriously, if you believe you have found a security issue within a ChainSafe project please notify us immediately. If an issue is confirmed, we will take all necessary precautions to ensure a statement and patch release is made in a timely manner.

Please email us a description of the flaw and any related information (e.g. reproduction steps, version) to security at chainsafe dot io.

License

GNU Lesser General Public License v3.0


*Note that all licence references and agreements mentioned in the gossamer README section above are relevant to that project's source code only.