Forking Strategy

• main: Follows Snowfork/go-substrate-rpc-client's main.
• solochain: Default branch with this fork's changes.
• There's a PR to track the diff between solochain and main.

Go Substrate RPC Client (GSRPC)

Substrate RPC client in Go. It provides APIs and types around Polkadot and any Substrate-based chain RPC calls. This client is modelled after polkadot-js/api.

State

This package is feature complete, but it is relatively new and might still contain bugs. We advice to use it with caution in production. It comes without any warranties, please refer to LICENCE for details.

Documentation & Usage Examples

Please refer to https://godoc.org/github.com/centrifuge/go-substrate-rpc-client

Contributing

1. Run tests: make test
2. Lint: make lint (you can use make lint-fix to automatically fix issues)
3. Clean up: make clean
4. View available commands: make help

Running Tests

Run tests in a Docker container against the Substrate Default Docker image

1. Run the docker container: make test-dockerized

Run tests locally against the Substrate Default Docker image

1. Start the Substrate Default Docker image: make run-substrate-docker
2. In another terminal, run the tests against that image: make test
3. Visit https://polkadot.js.org/apps for inspection

Run tests locally against any substrate endpoint

1. Set the endpoint: export RPC_URL="http://example.com:9933"
2. Run the tests: make test
3. Run tests with coverage report: make test-cover