regen-ledger

A distributed ledger for ecological assets and data claims

Introduction

Regen Ledger is a blockchain application for ecological assets and data claims built on top of Cosmos SDK and Tendermint Core. Leveraging these tools, Regen Ledger provides the infrastructure for a Proof-of-Stake blockchain network governed by a community dedicated to planetary regeneration.

Features specific to Regen Ledger are developed within this repository as custom modules that are then wired up to the main application. The custom modules developed within Regen Ledger follow the same architecture and pattern as modules developed within Cosmos SDK and other Cosmos SDK applications.

The core features that Regen Ledger aims to provide include the following:

• infrastructure for managing the issuance and retirement of ecosystem service credits
• a database of ecological state and change of state claims that spans both on and off-chain data sources
• mechanisms for automating the assessment of ecological state, making payments, and issuing assets

Regen Ledger is under heavy development and as result the above features are implemented to varying degrees of completeness. For more information about our approach and vision, see Regen Ledger Specification.

Documentation

Documentation for Regen Ledger is hosted at docs.regen.network. This includes installation instructions for users and developers, information about live networks running Regen Ledger, instructions on how to interact with local and live networks, infrastructure and module-specific documentation, tutorials for users and developers, migration guides for developers, upgrade guides for validators, a complete list of available commands, and more.

Contributing

Contributions are more than welcome and greatly appreciated. All the information you need to get started should be available in Contributing Guidelines. Please take the time to read through the contributing guidelines before opening an issue or pull request. The following prerequisites and commands cover the basics.

Prerequisites

• Git >=2
• Make >=4
• Go >=1.19

Go Tools

Install go tools:

make tools

Git Hooks

Configure git hooks:

git config core.hooksPath scripts/githooks

Lint and Format

Run linter in all go modules:

make lint

Run linter and attempt to fix errors in all go modules:

make lint-fix

Run formatting in all go modules:

make format

Run linter for all proto files:

make proto-lint

Run linter and attempt to fix errors for all proto files:

make proto-lint-fix

Run formatting for all proto files:

make proto-format

Running Tests

Run all unit and integrations tests:

make test

Manual Testing

Build the regen binary:

make build

View the available commands:

./build/regen help

Related Repositories

• regen-network/governance - guidelines and long-form proposals for Regen Mainnet
• regen-network/mainnet - additional information and historical record for Regen Mainnet
• regen-network/testnets - additional information and historical record for Regen Testnets
• regen-network/regen-js - a JavaScript client library for interacting with Regen Ledger
• regen-network/regen-web - user interfaces for Regen Network and Regen Registry

Sleeping in the Forest

I thought the earth remembered me,
she took me back so tenderly,
arranging her dark skirts, her pockets
full of lichens and seeds.

I slept as never before, a stone on the river bed,
nothing between me and the white fire of the stars
but my thoughts, and they floated light as moths
among the branches of the perfect trees.

All night I heard the small kingdoms
breathing around me, the insects,
and the birds who do their work in the darkness.

All night I rose and fell, as if in water,
grappling with a luminous doom. By morning
I had vanished at least a dozen times
into something better.

― Mary Oliver