subgraph

Mosaic Subgraph

THIS INFORMATION IS NOT UP-TO-DATE. IT WILL BE UPDATED LATER TO REFLECT MOSAIC'S USAGE OF SUBSQUID OR SUBQUERY.

Contains the entities and dependencies to populate a subgraph for Mosaic protocol.

Development quickstart

You need to run a Graph Node locally.

1. Start your local Mosaic dev chain: cd your_mosaic_repo_path && yarn start-dev-chain

2. Somewhere else, Clone Graph Node: git clone https://github.com/graphprotocol/graph-node

3. Move into the docker directory: cd graph-node/docker

4. Start Graph Node docker instance: docker-compose up -d

5. (Optionally) read the logs from your Graph Node: docker ps | grep graph-node | cut -f 1 -d ' ' | xargs docker logs -f

6. Back in the Mosaic repo, deploy the subgraph to your Graph Node: cd packages/subgraph && yarn prepare-local && yarn create-local && yarn deploy-local

7. Open Graph Node graphql API instance in your browser: http://127.0.0.1:8000/subgraphs/name/mosaic/mosaic

8. Start Mosaic frontend (in the root of the Mosaic repo): yarn start-demo:dev-frontend

Making subgraph code changes

Having done all of the above, if you make subgraph code changes you'll need to run the following:

1. Recompile local changes: yarn prepare:subgraph && yarn build:subgraph

2. Redeploy local changes: cd packages/subgraph && yarn prepare-local && yarn create-local && yarn deploy-local

Gotchas

Stopping and starting dev chain

If you stop and start your local dev chain you need to redeploy your subgraph because the contract addresses will have changed.

Unregistered frontends

Local instance runs with a frontend ID of Ethereum zero address (0x0000000000000000000000000000000000000000) to register the local frontend run mosaic.registerFrontend(0.9).then(console.log) in your browser console and update packages/dev-frontend/src/config's ADDRESS_ZERO to the address returned in your console and refresh the page.