Skip to main content

Developer Tooling

Overview​

Interacting with Polymesh (both Public and Private) is possible through several methods:

  • Direct RPC access via HTTP or WebSocket.
  • Accessing the chains API directly via the polkadot.js API.
  • Utilizing the purpose-built Polymesh SDK (Typescript).
  • Utilizing the Polymesh REST API (constructed with the Polymesh SDK).
  • Utilizing the Chain indexer (based on SubQuery), which offers a PostgreSQL database and GraphQL API for accessing current state and historical data.
  • Utilizing various other generic tools compatible with multiple Substrate-based blockchains.

GitHub Repos​

The Polymesh Private chain and associated tooling is available within the Polymesh GitHub organisation.

Each repository has its own README.md file to help get started with building and deploying the chain and each tool.

Please see repo licenses for details of usage restrictions.

Development Environment​

To ease the setup of a developer environment for Polymesh Private instances, we provide a Docker compose file that spins up a preconfigured Polymesh Private chain, and associated tooling.

The repository https://github.com/PolymeshAssociation/Polymesh-private-dev-env provides the required docker files and configuration for this.

This environment includes:

Refer to this projects README for details on how to quickly launch an environment.

Alternatively you can set up and connect the various tools individually by referring to the individual repositories of those tools described in the following sections.

Polymesh Private Chain​

https://github.com/PolymeshAssociation/polymesh-private

This repo is where you would source the binary required to run an instance of the Polymesh Private chain.

Polymesh SDK​

https://github.com/PolymeshAssociation/polymesh-private-sdk

This repository contains our Polymesh SDK for Polymesh Private instances.

It is a Typescript based SDK providing purpose-built objects and APIs to interact with Polymesh.

The Polymesh SDK uses the polkadot.js API and the Polymesh GraphQL API to source data required for various SDK functionality. For a methods marked as using middleware in the SDK documentation an instance of the Polymesh GraphQL API is required to be connected.

The Polymesh SDK uses a Signing Manager (https://github.com/PolymeshAssociation/signing-managers) to manage keys required to sign and submit messages to the Polymesh chain. Signing Managers are pluggable components allowing a variety of approaches for key management and security, including local storage for development and Hashicorp Vault for production grade security. Signing Managers can also be used to integrate with third-party key custodians such as Fireblocks.

Polymesh REST API​

https://github.com/PolymeshAssociation/polymesh-private-rest-api

This repository provides a REST API interface that under the covers uses the above Polymesh SDK to interact with a Polymesh Private chain instance.

Polymesh GraphQL API​

https://github.com/PolymeshAssociation/polymesh-subquery

This repository provides a chain indexing service which will ingest the events and extrinsics in each observed Polymesh block, and build an indexed PostgreSQL database that tracks corresponding chain data.

Its GraphQL API can be used to query for historical or current chain data.

It is used by the Polymesh REST API to gather data required for certain transactions and getter APIs, so its endpoint must be passed as a parameter when starting an instance of the Polymesh REST API.

Tool Usage​

The above tools are designed to be used seamlessly together. The Polymesh SDK uses the GraphQL API to gather chain data as needed, and the Polymesh REST API uses the Polymesh SDK to allow users to easily interact with the chain. It is also possible to use the GraphQL API as a standalone service, rather than only through the REST API and Polymesh SDK.