Client libraries enable easy access to drand randomness in specific programming languages. They also provide peace of mind by verifying randomness rounds and add additional features like failover, racing, aggregation, and caching.

Drand randomness is available over HTTP, libp2p PubSub and gRPC.

Currently, the following client libraries are available:

• Go
• JavaScript

If your application cannot use the libraries above, you can still use the drand-client CLI or make requests to the HTTP API endpoints. If you have created a client library or know of a client library not listed here, please let us know by opening an issue.

Install

go get github.com/drand/drand

Usage

The Go drand client library is structured with a base client interface in /client, and with protocol-specific transport implementations in /client/http, /client/grpc and /lp2p/client. The main client package holds transport agnostic logic for retrying, validation, and caching.

For documentation and examples please check the Go clients reference:

• Transport agnostic top-level client: **https://pkg.go.dev/github.com/drand/drand/client**

Client implementations (to be used with the above):

• HTTP client: **https://pkg.go.dev/github.com/drand/drand/client/http**
• libp2p gossip client: **https://pkg.go.dev/github.com/drand/drand/lp2p/client**
• gRPC client: **https://pkg.go.dev/github.com/drand/drand/client/grpc**

Install