gRPC Overview#
The gRPC endpoints provide access to information from Dash Platform as well as streaming of events related to blocks and transactions/transitions.
Connecting to gRPC#
Auto-generated Clients#
Clients for a number of languages are built automatically from the protocol definitions and are available in the packages/dapi-grpc/clients folder of the platform repository. The protocol definitions are available in the packages/dapi-grpc/protos folder. Pull requests are welcome to add support for additional languages that are not currently being built.
Command Line Examples#
Some examples shown in the endpoint details pages use a command-line tool named gRPCurl that allows interacting with gRPC servers in a similar way as curl does for the JSON-RPCs. Additional information may be found in the gRPC documentation.
To use gRPCurl as shown in the detailed examples, clone the platform repository and execute the example requests from the packages/dapi-grpc directory of that repository as shown in this example:
## Clone the dapi-grpc repository
git clone https://github.com/dashpay/platform.git
cd platform/packages/dapi-grpc
## Execute gRPCurl command
grpcurl -plaintext -proto protos/...
Browser access#
The gRPC UI tool provides a way to interact with gRPC servers using a browser. The example below shows how to start the tool configured to access Core gRPC endpoints on testnet:
# Use Core gRPC
grpcui -insecure -open-browser -proto protos/core/v0/core.proto seed-1.testnet.networks.dash.org:1443