# Databases

Compendia's Layer 2 Database Network is currently available on our Testnet.

Below you'll find guides on creating databases and schemas. This doc will be updated with a developer guide on building metaverse apps that use Compendia databases as well.

If you need any help, join our Discord.

# Creating a database

  1. Create a new testnet wallet and click Get Coins. image|690x304

  2. Click "Register Validator" and set a username. image|690x302

  3. Find a schema in the Layer 2 Database Explorer. The schema represents the database rules, such as the columns that it should have. If you want to use your own schema, read Registering a Schema.

  4. Set up a local instance of Concierge. Follow the readme and configure it use your schema and validator wallet passphrase. You'll need your configured API key later.

  5. Run Concierge and copy the Database URI it returns in your console (i.e. /orbitdb/foo/bar).

  6. In your Compendia testnet wallet, click Tools and Register Database. Paste the database URL and click Submit.

  7. Go to Maestro (a Compendia Database Admin UI), enter your Concierge API URL (your concierge server ip + port), API key, and Schema name.

  8. Open the DB Explorer in another window, click your schema, and then View next to your database in the list.

  9. Add a new entry in Maestro and watch it appear in your database in real-time.

Any user and application that synchronizes with your database, will become a node, making your data decentralized and always-online.

# Registering a schema

  1. In your Compendia testnet wallet, click Register Schema.

  2. Enter a schema name and paste a JSON Schema.

  3. Submit the transaction by clicking Submit.

Your schema is now live on Compendia. Curators can now register a database with open data using your schema.

# Building a metaverse app with Compendia Databases

Coming Soon.