ondratra 2adbf7d346 query node - bytes converion utf-8 null character handling | 3 éve | |
---|---|---|
.. | ||
generated | 3 éve | |
mappings | 3 éve | |
scripts | 3 éve | |
.gitignore | 3 éve | |
README.md | 3 éve | |
bootstrap.sh | 3 éve | |
build.sh | 3 éve | |
manifest.yml | 3 éve | |
package.json | 3 éve | |
run-tests.sh | 3 éve | |
schema.graphql | 3 éve |
This is a query-node project generated by hydra-cli
. Experiment by modifying schema.graphql
and the mappings in the mappings
folder, defined in manifest.yml
.
Run
yarn && yarn bootstrap
and generate the model files as defined in schema.graphql
, create the database and run all the necessary migrations in one shot.
NB! Don't use in production, as it will delete all the existing records.
A separate tool Hydra Typegen can be used for generating Typescript classes for the event handlers (the mappings).
Run
yarn typegen
to run the typegen for events and extrinsics defined in manifest.yml
(it fetches the metadata from an RPC endpoint and blockhash defined there).
Mappings is a separated TypeScript module created in the mappings folder. The handlers exported by the module should match the ones defined in manifest.yml
in the mappings section. Once the necessary files are generated, build it with
yarn mappings:build
Then run the processor:
yarn processor:start
Afterwards start the GraphQL server in a separate terminal (opens a GraphQL playground at localhost by default):
yarn query-node:start:dev
The Hydra Indexer endpoint used by Hydra processor is defined as environment variable INDEXER_ENDPOINT_URL
sourced from .env
. There are publicly available Hydra indexers for Polkadot and Subsocial. For other chains, a self-hosted indexer should be used.
The simplest way to run an indexer locally is to run docker-compose-indexer.yml
with docker-compose
. The following environment variables must be provided:
Follow the links for more information about the indexer service and indexer-api-gateway.
TODO: remove after integration tests are finished and query node runs without any issues
# build everything
yarn
yarn build
running the processor:
cp types/augment/all/defs.json query-node/mappings/lib/generated/types/typedefs.json
docker-compose up -d db
yarn workspace query-node-root db:create
yarn workspace query-node-root db:migrate