• Stars
    star
    392
  • Rank 109,735 (Top 3 %)
  • Language
    Go
  • License
    GNU Lesser Genera...
  • Created almost 6 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

🕸️ Go Implementation of the Polkadot Host
Gossamer logo

Warning

The Gossamer Polkadot Host is pre-production software [2022-12-01]

Gossamer is a Golang 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, block production, block finalization, a JSON-RPC server, and more.

Getting Started

To get started with Gossamer, follow the steps below to build the source code and start a development network.

Prerequisites

Git is required to acquire the Gossamer source code, and Make is used to build it. Building Gossamer requires version 1.20 or higher of Golang.

Installation

Clone the Gossamer repository and checkout the development branch:

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

Build Gossamer:

make gossamer

Or build Gossamer and move the resulting executable to $GOPATH/bin:

make install

To install Gossamer

Use Gossamer

A comprehensive guide to Gossamer's end-user capabilities is located in the cmd/gossamer directory. What follows is a guide to Gossamer's capabilities as a Polkadot Host.

Chain Specifications

A chain specification is a JSON document that defines the genesis block of a blockchain network, as well as network parameters and metadata (e.g. network name, bootnodes, telemetry endpoints, etc). It is necessary to provide Gossamer with a chain specification in order to use it as a Polkadot Host. The Gossamer repository includes a number of chain specifications, some of which will be used in this guide.

Configuration Files

Gossamer exposes a number of configuration parameters, such as the location of a chain specification file. Although it's possible to use command-line parameters, this guide will focus on the usage of Gossamer TOML configuration files, which define a set of configuration values in a declarative, portable, reusable format. The chain specifications that are used in this guide are each accompanied by one or more configuration files.

Single-Node Development Network

The name of the Polkadot test network is "Westend", and the Gossamer repository includes a chain specification and configuration file for a single-node, local Westend test network.

First, initialize the directory that will be used by the Gossamer node to manage its state:

./bin/gossamer init --force --chain westend-dev

Now, start Gossamer as a host for the local Westend development chain:

./bin/gossamer --chain westend-dev

Multi-Node Development Network

The multi-node development network includes three participants: the Alice, Bob, and Charlie test accounts. In three separate terminals, initialize the data directories for the three Gossamer instances:

./bin/gossamer init --force --chain westend-local --alice
./bin/gossamer init --force --chain westend-local --bob
./bin/gossamer init --force --config westend-local --charlie

Then start the three hosts:

./bin/gossamer --chain westend-local --alice
./bin/gossamer --chain westend-local --bob
./bin/gossamer --chain westend-local --charlie

Contribute

Donate

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

ChainSafe Security Policy

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.

Reporting a Security Bug

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


More Repositories

1

lodestar

🌟 TypeScript Implementation of Ethereum Consensus
TypeScript
1,012
star
2

web3.unity

🕹 Unity SDK for building games that interact with blockchains.
C#
817
star
3

forest

🌲 Rust Filecoin Node Implementation
Rust
553
star
4

dappeteer

[DEPRECATED]🏌🏼‍E2E testing for dApps using Puppeteer + MetaMask
TypeScript
491
star
5

ChainBridge

🌉 Modular Multi-Directional Blockchain Bridge to interact with Multiple Networks; Ethereum, Ethereum Classic, Substrate, based chains. Stay tuned for ChainBridge Hub!
Go
463
star
6

mina-rs

Rust implementation of the Mina protocol, targeting Wasm and ARM architectures.
Rust
159
star
7

js-libp2p-gossipsub

TypeScript implementation of Gossipsub
TypeScript
139
star
8

chainbridge-solidity

⚙️ Solidity contracts for Sygma (ChainBridge)
JavaScript
119
star
9

filsnap

MetaMask snap for interacting with Filecoin dapps.
HTML
107
star
10

chainbridge-core

🌁 Sygma core library (ChainBridge)
Go
96
star
11

bls

💻 Javascript Implementation of Boneh-Lynn-Shacham Signatures
TypeScript
92
star
12

go-schnorrkel

🍵 Schnorr Signatures over Ristretto255 in pure Go
Go
87
star
13

metamask-snap-polkadot

Metamask plugin for interacting with Polkadot dapps and other Substrate based chains.
TypeScript
84
star
14

Spectre

ZK coprocessor for verifying Beacon chain headers via Altair lightclient protocol
Rust
57
star
15

nodewatch-api

A devp2p crawler targeted at Eth2 nodes
Go
56
star
16

chainbridge-substrate

Rust
55
star
17

ui-monorepo

ChainSafe Files & Storage UI Monorepo
TypeScript
51
star
18

ssz

Typescript implementation of Simple Serialize (SSZ)
TypeScript
49
star
19

ChainGuardian

Eth2.0 desktop validator client
TypeScript
45
star
20

WeiPay

WeiPay is an open source cryptocurrency wallet available for both iOS and Android mobile devices. WeiPay will support Ethereum out of the box with added support for ERC-20 & ERC-223 tokens.
JavaScript
45
star
21

js-libp2p-noise

Noise libp2p handshake for js-libp2p
TypeScript
37
star
22

chainbridge-deploy

Deploy tooling for ChainBridge
JavaScript
35
star
23

Zipline-lightclient

Hackathon for EthBogota - An Eth2 light client using Cannon verifyable computation
C
30
star
24

nodewatch-ui

TypeScript
29
star
25

discv5

A Typescript implementation of the Discv5 protocol
TypeScript
28
star
26

web3js-example-react-app

TypeScript
28
star
27

Multix

Use a Multisig to do anything, on Polkadot
TypeScript
27
star
28

chainbridge-ui

TypeScript
26
star
29

filecoindot

Filecoin to substrate bridge
Rust
24
star
30

denode

a mechanism for incentivizing full nodes
24
star
31

chainbridge-substrate-chain

Simple Substrate chain for testing purposes
Rust
22
star
32

PINT

A Polkadot ecosystem index for investors. A self sustaining auction treasury for parachains.
Rust
21
star
33

eth-local

The purpose of eth-local is to offer a standardized way to store your keystore files on your local machine. While also allowing you to use them in browser.
JavaScript
21
star
34

rust-libp2p-nym

implementation of a libp2p transport using the Nym mixnet
Rust
20
star
35

chaindb

go key-value store using badgerDB
Go
20
star
36

as-sha256

AssemblyScript implementation of SHA256
WebAssembly
19
star
37

blst-ts

Typescript wrapper for https://github.com/supranational/blst native bindings, a highly performant BLS12-381 signature library
TypeScript
18
star
38

bls-keygen

Key management for BLS curves written in TypeScript and browser compatible
TypeScript
17
star
39

chainlink-cosmos

Chainlink on Cosmos: Cosmos SDK module for Chainlink data feeds
Go
17
star
40

das-prototype

Research prototypes of Data Availability Sampling for Ethereum (WIP)
Rust
16
star
41

bls-keystore

Implementation of bls keystore - EIP 2335
TypeScript
16
star
42

bls-js

BLS signature implementation
TypeScript
15
star
43

truffle-plugin-abigen

Truffle plugin to post-process contracts for go-ethereum's abigen
Solidity
14
star
44

web3-context

A React context implementation of Onboard.js & general utilities
TypeScript
13
star
45

Anemone

A testing tool that broadcasts batches of transactions and tests opcodes
TypeScript
12
star
46

persistent-merkle-tree

TypeScript
12
star
47

js-libp2p-yamux

Typescript implementation of Yamux
TypeScript
12
star
48

chainbridge-core-example

Go
11
star
49

ethermint-deploy

JavaScript
11
star
50

audits

This is public repository that holds ChainSafe audit reports
11
star
51

hardhat-plugin-multichain-deploy

Solidity
11
star
52

forest-iac

Infrastructure as Code to support the Forest Filecoin project
HCL
10
star
53

ssz-js

Simple Serialize in TypeScript
TypeScript
9
star
54

chainbridge-utils

Go
9
star
55

dapp-boilerplate

A shared boilerplate for Dapp development
TypeScript
9
star
56

ens-aztec-privacy

[BETA] Sending private transactions to ENS domains using Aztec and custom ENS Resolver contract.
Solidity
9
star
57

go-signature-adaptor

A pure Go implementation of ECDSA signature adaptors
Go
9
star
58

dotcon-0.5

Decentralized Networking with Libp2p
Go
8
star
59

lodestar-quickstart

Scripts to quick start Lodestar and execution clients pre and post-merge Ethereum.
Shell
8
star
60

api3-rust

Rewrite API3 Solidity contracts in Rust (for Solana, Near, Oasis)
Rust
8
star
61

foundry-multichain-deploy

Solidity
8
star
62

W-OTS

Winternitz OTS+ implementation
Rust
7
star
63

hobbits-ts

A TypeScript implementation of the Hobbits Ethereum Wire Protocol
TypeScript
7
star
64

simpleserialize.com

TypeScript
7
star
65

WebZjs

A fully-featured javascript/typescript library for interacting with the Zcash network from the browser
Rust
7
star
66

js-libp2p-quic

Rust
6
star
67

go-cumulus

Go implementation of cumulus. for creating parachains with gossamer
Makefile
6
star
68

ChainSafe-Demo-WebGLProject-Files

Project Files For The ChainSafe Demo
C#
6
star
69

lazy-minting-server

Sample implementation of a lazy minting server
TypeScript
6
star
70

ethersjs-genaddress

a simple script to generate an eth address utilizing ethers.js
JavaScript
6
star
71

game-web3wallet

JavaScript
6
star
72

bls-hd-key

BLS key derivation and hd key utilities
TypeScript
6
star
73

eth-drive

eth-drive is the first disk utility tool designed for ethereum addresses
HTML
6
star
74

mina-snap

Metamask snap for interacting with mina procotol
HTML
6
star
75

eth2-light-client-demo

TypeScript
5
star
76

enr-app

TypeScript
5
star
77

fil-secondary-retrieval-markets

Client and Provider implementations to enable secondary retrieval markets on Filecoin
Go
5
star
78

engineering-handbook

ChainSafe Engineering Handbook
JavaScript
5
star
79

serde-bin-prot

A Rust crate that adds serde support for the bin_prot serialization format
Rust
5
star
80

game-web3gl

JavaScript
5
star
81

files-cli

A cli tool to download and decrypt any file uploaded using ChainSafe Files
TypeScript
5
star
82

chainbridge-docs

HTML
5
star
83

TypeScript-Cli-Generator

A TypeScript CLI Template
TypeScript
5
star
84

AGP-Report

Report for the Aragon Chain
4
star
85

rust-bls-derivation

Rust
4
star
86

beacon-state-upload

TypeScript
4
star
87

EthIndia2019

JavaScript
4
star
88

sha256-rust-wasm

A wrapper around rust implementation of sha256
Rust
4
star
89

zcash-wasm-benchmark

Rust
4
star
90

marketplace-landing

This is the marketplace landing page, currently a waitlist.
TypeScript
4
star
91

Zipline-Casper

A prototype implementation of the Zipline block root oracle using Casper finality
Solidity
4
star
92

aleo-snap

JavaScript
4
star
93

subgraph-arweave-example

Example subgraph for Arweave
TypeScript
4
star
94

web3-plugin-zksync

TypeScript
4
star
95

near-snap

TypeScript
4
star
96

cypress-polkadot-wallet

TypeScript
4
star
97

game-docs-v2

JavaScript
4
star
98

persistent-ts

TypeScript
3
star
99

ECOHacks

JavaScript
3
star
100

web3.js-plugin-chainlink

TypeScript
3
star