This section helps developers build applications that use drand as a source of randomness. For help running your own drand network, see the Operator's Guide.
The current public League of Entropy drand mainnet API endpoints are:
https://api.drand.sh(HTTPS endpoint, also available over HTTP)
https://api2.drand.sh(HTTPS endpoint, also available over HTTP)
https://api3.drand.sh(HTTPS endpoint, also available over HTTP)
/dnsaddr/api.drand.sh(1st-level libp2p gossipsub relay endpoint)
/dnsaddr/api2.drand.sh(1st-level libp2p gossipsub relay endpoint)
/dnsaddr/api3.drand.sh(1st-level libp2p gossipsub relay endpoint)
There are two networks on mainnet:
defaultwhich is running the chained scheme with public keys on G1
fastnetwhich is running the unchained scheme with public keys on G2
default network chain hash:
fastnet network chain hash:
In order to retrieve randomness from a drand network you should preferentially use the drand client libraries or the drand-client CLI, which support the different mechanisms and perform verification for every value obtained.
Alternatively, you can interact directly with the endpoints. Make sure to manually verify every value:
- HTTP API reference
- Pubsub-based randomness distribution
- gRPC API: usually not publicly accessible. A gRPC API is supported by the drand client libraries, the
drand-clientCLI application and the drand application itself (using
drand get public).