Blockchain-in-a-Box

A batteries-included ethereum blockchain for bootstrapping the Metaverse. 🚀🚀🚀

Includes contracts for identity, inventory, currency and trade. Can be extended for any kind of marketplace application, but the goal is fast, free interoperable transfer of all user data from one server-authoritative platform to another. The ideal use case we imagine is a portal between two separate virtual worlds, sharing user data over the blockchain.

Docs

https://blockchain.etherealengine.org/v1/api-docs/

What Is This?

A Node.js-based REST API, Ethereum node, cache service and smart contracts to deploy your own Ethereum-based sidechain for identity and durable assets. Users can transfer assets created on your platform to the Ethereum or Polygon main networks.

Who Is It For?

1. Javascript developers who want to build interoperable applications with durable digital assets but don't have the resources to write everything from scratch and need a starting point which they can mold to their needs.

2. Developers interested in creating metaverse-scale interoperable applications where users may want to move their assets and identity to other platforms.

3. Developers of existing applications who cannot reasonably remove their database from their application and want to mirror this data onto blockchain or vice versa.

4. Organizations who wish to build blockchains with other organizations and need a standard and conventional way to do so.

Full GUI management of a Custodial SideChain

What are sidechains? They are either:

1. Custodial - assets are moved to a parallel chain with its own consensus mechanism & security.

2. Non-custodial - assets are held & state is secured by smart contracts on Ethereum (= can survive an attack of the sidechain).

Any Resources to Help Me Learn What's Going On?

How to Code a Crypto Collectible: ERC-721 ASSET Tutorial (Ethereum) https://www.youtube.com/watch?v=YPbgjPPC1d0

Build Your First Blockchain App Using Ethereum Smart Contracts and Solidity https://www.youtube.com/watch?v=coQ5dg8wM2o

Node.js and Express.js - Full Course https://www.youtube.com/watch?v=Oe421EPjeBE

Redis Caching with Node.js https://www.youtube.com/watch?v=oaJq1mQ3dFI

Building an IPFS app with Node.js https://www.youtube.com/watch?v=RMlo9_wfKYU

Pinata Cloud - The Broken Token (how Pinata can make NFTs more durable) https://www.youtube.com/watch?v=0iuAvE-a0fI

where can I find the code?

Everything is in the packages folder. You shouldn't need to change much, beyond setup.

packages/api

The API is what you'll interact with. Generate wallets, mint tokens, etc. Additional documentation here

Developer Reference API Server

https://blockchain.etherealengine.org/v1/api-docs/

packages/cache

The cache server listens to the chain for events and posts them to Redis/Elasticache Additional documentation here

packages/ethereum

Ethereum, EthStats, Remix IDE and all related services as Docker/Kubernetes YAML files Additional documentation here

packages/market

A marketplace for your blockchain Additional documentation here

packages/market-service

Backend services for the marketplace Additional documentation here

packages/terraform-eks

Simple deployment to Amazon EKS using Terraform Additional documentation here

Setup and Installation

Configure .env file

In the root folder create a clone of .env.default file and name it .env. Update the content of .env file with your resources.

Setup Pinata Account

Pinata allows you to upload and manage files on IPFS. It provides IPFS API through which you can easily perform IPFS pinning service.

1. Open https://pinata.cloud/ and signup/login.
2. Navigate to https://pinata.cloud/keys and create a new key. Make sure to check Admin key switch button in the modal.
3. Update .env file with following entries from generated key.

   PINATA_API_KEY=
   PINATA_SECRET_API_KEY=
   

Deployment

Local deployment

Local deployment can be done using Kubectl and Minikube. Full instructions are here

Deployment to AWS

AWS setup and deployment are done via Terraform, but there are also instructions on deploying directly to EKS here and here

Contributing

Pull requests are gladly accepted!

For bug fixes, please submit an issue. If you can fix the bug, submit a PR and link the issue.

For features, please submit an issue with your intention to add the feature and make a draft PR as soon as possible.

Please try to minimize changes to number of files or make multiple pull requests to minimize confusion or possible introduction of bugs.