Code Examples

drand is easy to use with clients in Go and JavaScript as shown here.

The HTTP API is how other languages can interact with drand. A Python example is provided below.

Golang

First, install Go if needed. With Homebrew the command is brew install go.
Then set up your project directory, the main.go file if you need it, and your go.mod file.
```
mkdir myproject
cd myproject
touch main.go
touch go.mod
```

Add the drand library to your go.mod file with:

go mod init myproject
go get github.com/drand/drand

We show a simple main.go illustrating how to instantiate a client and get randomness from drand.

package main

import (
    "context"
    "encoding/hex"
    "fmt"
    "github.com/drand/drand/client"
    "github.com/drand/drand/client/http"
    "log"
)

var urls = []string{
    "https://api.drand.sh",         // Official drand API server
    "https://drand.cloudflare.com", // Cloudflare's drand API server
}

var chainHash, _ = hex.DecodeString("8990e7a9aaed2ffed73dbd7092123d6f289930540d7651336225dc172e51b2ce")

func main() {
    c, err := client.New(
        client.From(http.ForURLs(urls, chainHash)...),
        client.WithChainHash(chainHash),
    )
    if err != nil {
    log.Fatalf("error creating client: %v", err)
    }
    
    rand, err := c.Get(context.Background(), 0)
    if err != nil {
        log.Fatalf("Failed to get randomness: %v", err)
    }

    fmt.Printf("drand randomness: %s\n", hex.EncodeToString(rand.Randomness()))
}

Then to run the code:

go run main.go

go build -o myproject main.go
./myproject

This should output something like:

drand randomness: d4ab1d7798a2aa7c9bc0d436088c72ca35b8e4a859cafda4f827b7b93905188d

JavaScript

Install Node.js if needed. The Homebrew command is brew install node.
Set up your project directory, the index.js file if you need it, and your package.json file.
```
mkdir myproject
cd myproject
mkdir src
touch package.json 
touch src/index.js
```
Add your package.json file like so:

{
    "name": "myproject",
    "version": "1.0.0",
    "description": "",
    "main": "src/index.js",
    "type": "module",
    "scripts": {
        "start": "node src/index.js"
    },
    "private": true,
    "dependencies": {
        "drand-client": "^1.2.6"
    }
}

Install the drand Javascript client library drand-client:
```
npm install -S drand-client
```
We show a simple index.js illustrating how to instantiate a client and get randomness from drand.

import {FastestNodeClient, fetchBeacon, HttpCachingChain, HttpChainClient} from "drand-client";


const chainHash = '8990e7a9aaed2ffed73dbd7092123d6f289930540d7651336225dc172e51b2ce' // (hex encoded)
const publicKey = '868f005eb8e6e4ca0a47c8a77ceaa5309a47978a7c71bc5cce96366b5d7a569937c529eeda66c7293784a9402801af31' // (hex encoded)

const options = {
  disableBeaconVerification: false, // `true` disables checking of signatures on beacons - faster but insecure!!!
  noCache: false, // `true` disables caching when retrieving beacons for some providers
  chainVerificationParams: {chainHash, publicKey}  // these are optional, but recommended! They are compared for parity against the `/info` output of a given node
}

// shows creating a basic client for a specific node and getting randomness from that client
async function getRandomness() {
   const chain = new HttpCachingChain('https://api.drand.sh', options)
   const client = new HttpChainClient(chain, options)
   const beacon = await fetchBeacon(client)
   return beacon.randomness
}

// shows creating a client that finds the fastest node and gets randomness from that node
async function getRandomnessFastNode(){
   const urls = [
      'https://api.drand.sh',
      'https://drand.cloudflare.com'
   ]
   const client2 = new FastestNodeClient(urls, options)
   client2.start()
   const fastBeacon = await fetchBeacon(client2)
   client2.stop()
   return fastBeacon.randomness
}

getRandomness()
        .then((randomness) => console.log(`Randomness is: ${randomness}`))
        .catch((err) => console.error('error', err))

getRandomnessFastNode()
        .then((randomness) => console.log(`Randomness from fastest node is: ${randomness}`))
        .catch((err) => console.error('error', err))

Then you can run your project with npm start or node src/index.js. The output will look like:

Randomness from fastest node is: 7b1f0db59345bcaa48e6d385fab911cd7a9d705b0a7f2bdf27ca7a7f47c1b1b6
Randomness is: 7b1f0db59345bcaa48e6d385fab911cd7a9d705b0a7f2bdf27ca7a7f47c1b1b6

Golang​

JavaScript​

Golang

JavaScript