DAO History Tools
DAO History tools are a collection of tools designed to retrieve contract data associated with DAOs (Decentralized Autonomous Organizations) from the Antelope blockchain. These tools are built upon the components of the history tools starter kit, which utilize MongoDB and EOSjs. The entire operational logic of the history tools is implemented through dependencies, meaning this repository solely contains scripts that execute individual processes and processors necessary for data processing from the designated "featured" contracts.
The contract components are implemented through the
@alien-worlds/aw-contract-<contract_name> packages. These components, such as repositories, entities, and mappers, are exclusively used in processors. All pertinent contracts, along with their actions and deltas, are encompassed within the
dao.featured.json file. If you wish to modify or add a contract, action, or delta, you must include it in this JSON file and create or adjust an existing processor in the
processor/processors directory. Additionally, you should consider potential modifications to the
index.ts file to ensure that all available processors are included.
This package is dependent on the following packages:
Table of Contents
Clone this repository:
git clone https://github.com/Alien-Worlds/aw-history-dao.git
Install the dependencies:
Configure the DAO History Tools by setting up environment variables or editing the configuration files as needed. The list of required variables can be found in the
./empty.envfile and their descriptions here
To run the tools, you must first select the mode:
default (to download current data) or
replay (to download a specific range of blocks). If you choose replay, set the start and end block as well. Having all the configuration, create a separate session for each of the processes and start them. The order doesn't matter but the starting point is
broadcast followed by
# first session
# second session
# third session
# fourth session
# fifth session
A tutorial on how to create a new processor can be found in the tutorials available in the History Tools Starter Kit.
We welcome contributions from the community. Before contributing, please read through the existing issues on this repository to prevent duplicate submissions. New feature requests and bug reports can be submitted as an issue. If you would like to contribute code, please open a pull request.