/snapshot-hub

Primary LanguageTypeScriptMIT LicenseMIT

Snapshot hub

This is a hub for Snapshot network that stores the database and forwards new messages to peers. The hub hold a private keys to sign valid messages.

Install

  1. Install Node.js, clone the repository, then say:
yarn
  1. Copy .env.example, rename it to .env and set a value for these config vars:
  • DATABASE_URL: The database connection string. You will need to run your own MySQL database or use a Cloud service like JawsDB.
  • RELAYER_PK: This is the private key of the hub. The hub counter-sign every accepted message with this key.
  • PINNING_SERVICE: This value must be "fleek" or "pinata". The hub support Pinata or Fleek IPFS pinning services.
  • FLEEK_API_KEY and FLEEK_API_SECRET or PINATA_API_KEY and PINATA_SECRET_API_KEY: You need to setup API keys for the pinning service you've defined.
  1. Create the database schema

Run this query on the MySQL database to create the initial schema with the required tables: https://github.com/snapshot-labs/snapshot-hub/blob/master/src/helpers/database/schema.sql

Run

  • Use this command to run the hub:
yarn start
{
  "name": "snapshot-hub",
  "network": "livenet",
  "version": "0.1.3",
  "tag": "alpha",
  "relayer": "0x8BBE4Ac64246d600BC2889ef5d83809D138F03DF"
}

Usage

Once your hub is running online, the main hub can relay the messages received to your own hub. Please provide the URL of your Snapshot hub to an admin to make sure it's connected to the network.

Load a space setting

To load a space settings in the database you can go on this endpoint http://localhost:3000/api/spaces/yam.eth/poke (change yam.eth with the space you want to activate).