moonstream/README.md

66 wiersze
3.0 KiB
Markdown
Czysty Zwykły widok Historia

2021-08-04 23:11:13 +00:00
# moonstream
2021-08-13 13:41:26 +00:00
\[[Live at https://moonstream.to/](https://moonstream.to)\] | \[[Join us on Discord](https://discord.gg/pYE65FuNSz)\]
## What is Moonstream?
2022-02-09 15:30:16 +00:00
Moonstream makes tools that help people build, manage, and maintain their blockchain economies.
2021-08-13 13:41:26 +00:00
2022-02-09 15:30:16 +00:00
In order to provide this functionality, we build a lot of technology to crawl blockchains and makes sense of crawled transactions and events. This repository contains that code.
2021-08-13 13:41:26 +00:00
## Who uses Moonstream?
2022-02-09 15:30:16 +00:00
Game designers and economists, data scientists, smart contract developers, backend engineers, and teams managing loyalty programs for blockchain projects.
Some of our prominents customers:
1. [Laguna Games](https://laguna.games), makers of [Crypto Unicorns](https://cryptounicorns.fun)
2. [RealtyBits](https://realtybits.com)
2021-08-13 13:41:26 +00:00
## Free software
Proprietary technologies are not inclusive technologies, and we believe in inclusion.
All of our technology is open source. This repository contains all the code that powers
https://moonstream.to. The code is licensed with the [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0).
You are and _will always be_ free to host your own instance of Moonstream.
## Architecture
This monorepo contains the following components:
2022-02-09 15:30:16 +00:00
1. [`frontend`](./frontend): A web frontend for Moonstream. Allows users to create dashboards and monitor the activity of accounts and smart contracts on multiple blockchains. Built in [React](https://reactjs.org/).
2. [`backend`'](./backend): The Moonstream API allows users to programmatically consume data about transactions and events taking place on blockchains crawled by Moonstream. Built in [Python](https://www.python.org/) using [Fast API](https://fastapi.tiangolo.com/).
3. [`crawlers`](./crawlers): This part of the code base contains workers which extract data from blockchains, transaction pools, and other sources. We have many crawlers and each crawler can utilize a different tech stack.
2021-08-13 13:41:26 +00:00
4. [`db`](./db): Moonstream stores blockchain data in [Postgres](https://www.postgresql.org/). This
directory contains the code we use to manage the schema in our Postgres database. For sources that
send higher volumes of data, we use a separate Postgres database and interface with it using
2022-02-09 15:30:16 +00:00
[Bugout](https://bugout.dev).
2021-08-13 13:41:26 +00:00
### Installation and setup
#### Run server with Docker Compose
If you want to deploy Moonstream in isolation against live services, then docker compose is your choice!
2021-12-01 12:54:34 +00:00
- Run script `backend/configs/docker_generate_env.bash` which prepare for you:
- `backend/configs/docker.moonstreamapi.env` with environment variables
2021-12-01 12:54:34 +00:00
- Run script `db/configs/docker_generate_env.bash` which prepare for you:
- `db/configs/alembic.moonstreamdb.ini` with postgresql uri
```bash
2021-12-01 12:54:34 +00:00
./backend/configs/docker_generate_env.bash
./db/configs/docker_generate_env.bash
```
- Run local setup
```bash
docker-compose up --build
```
2021-08-13 13:41:26 +00:00
## Contributing
If you would like to contribute to Moonstream, please reach out to @zomglings on the [Moonstream Discord](https://discord.gg/pYE65FuNSz).