Skip to content
develop
Switch branches/tags
Code

Latest commit

* Feature network: Ansible code (#1844)

* Feature network

* Fixes to align to develop

* Download custom snapshot during image build. (#1857)

* Download custom snapshot during image build.

* Improve Docker build caching.

* Fix download script.

* Address review comments.

* Use different library to download from zippyshare.

* Add support for default feature network snapshot.

* Update URL of default feature network snapshot.

* Feature network GitHub action (#1860)

* Feature network

* Fixes to align to develop

* Download custom snapshot during image build.

* Add github action to deploy feature network with custom snapshot.

* Improve Docker build caching.

* Fix download script.

* Trigger workflow execution

* Trigger workflow execution manually

* Address review comments.

* Remove unnecessary lines.

* Parametrize Docker Image

* Add missing Ansible variable.

* Fix argname.

* Fix input name

* Use different library to download from zippyshare.

* Add support for default feature network snapshot.

* Add supoort for default feature network snapshot.

* Update URL of default feature network snapshot.

* Fix entrynode URL

* Update entrynode public key

* Parametrize genesis public key

* Simplify workflow parameters

* Remove extra feature-deploy.yml playbook file

Co-authored-by: Andrea Villa <1577639+karimodm@users.noreply.github.com>
Co-authored-by: Georgy Savva <georgy.savva@gmail.com>

* Remote debugging (#1894)

* Introduce Delve debugger to Dockerfile

* Add "--continue" flag to dlv binary to startup the goshimmer process right away

* Add delve debugger port to docker-compose

* Enable Remote Debugging for feature network

* Temporarily enable feature-network deployment on push

* Remove "entrypoint" statement from the docker-compose files

* Revert "Temporarily enable feature-network deployment on push"

This reverts commit 0b4c166.

* Update .github/workflows/feature-network-deploy.yml

Co-authored-by: Piotr Macek <piotr.macek@iota.org>
Co-authored-by: Georgy Savva <georgy.savva@gmail.com>
Co-authored-by: Georgy Savva <georgy.savva@ext.iota.org>
45026e5

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 


Prototype node software for an IOTA network without the Coordinator

Developer documentation portal

Discord StackExchange Apache 2.0 license Go version Latest release

AboutDesignGetting startedClient-Library and HTTP API referenceSupporting the projectJoining the discussion


About

This repository, called GoShimmer, is where the IOTA Foundation's Research Department tests the IOTA 2.0 modules to study and evaluate their performance.

GoShimmer is first and foremost a research prototype. As such, breaking changes can often happen. We invite researchers and developers to make use of this project as you see fit. Running experiments, test out new ideas, build PoC are all very welcome initiatives.

For a documentation, including tutorials and resources, we refer to the Documentation (Github link).

Design

The code in GoShimmer is modular, where each module represents either one of the IOTA 2.0 components, or a basic node function such as the gossip, ledger state, and API - just to mention a few.

Layers

GoShimmer's modularity is based on a combination of event-driven and layer-based approaches.

Client-Library and HTTP API reference

You can use the Go client-library to interact with GoShimmer (located under github.com/iotaledger/goshimmer/client).

You can find more info about this on our client-lib and Web API documentation.

Getting started

You can find tutorials on how to setup a GoShimmer node, writing a dApp, obtaining tokens from the faucet and more in the GoShimmer documentation.

Compiling from source

We always recommend running your node via Docker. However, you can also compile the source and run the node from the compiled binary. GoShimmer uses RocksDB as its underlying db engine. That requires a few dependencies before building the project:

  • librocksdb
  • libsnappy
  • libz
  • liblz4
  • libzstd

Please follow this guide: https://github.com/facebook/rocksdb/blob/master/INSTALL.md to build above libs.

When compiling GoShimmer, just run the build script:

./scripts/build.sh

If you also want to link the libraries statically (only on Linux) run this instead:

./scripts/build_goshimmer_rocksdb_builtin.sh

Finally, download the latest snapshot and make sure to place it in the root folder of GoShimmer:

wget -O snapshot.bin https://dbfiles-goshimmer.s3.eu-central-1.amazonaws.com/snapshots/nectar/snapshot-latest.bin

Supporting the project

If you want to contribute to the code, consider posting a bug report, feature request or a pull request.

When creating a pull request, we recommend that you do the following:

  1. Clone the repository
  2. Create a new branch for your fix or feature. For example, git checkout -b fix/my-fix or git checkout -b feat/my-feature.
  3. Run the go fmt command to make sure your code is well formatted
  4. Document any exported packages
  5. Target your pull request to be merged with dev

Joining the discussion

If you want to get involved in the community, need help getting started, have any issues related to the repository or just want to discuss blockchain, distributed ledgers, and IoT with other people, feel free to join our Discord.