A JavaScript/TypeScript SDK to request, verify, and derive randomness from the dcipher network, supported by the randomness-solidity contract.

This project provides a client-side SDK to request on-chain randomness from the supported blockchains by interacting with the RandomnessSender contract implemented in randomness-solidity. It allows you to:

• Integrate with a deployed RandomnessSender smart contract
• Request and verify on-chain randomness from your dApp frontend/backend

Install the randomness-js library into your frontend project.

npm install randomness-js
# or
yarn add randomness-js

Create an instance of randomness for your preferred network.

import { Randomness } from "randomness-js"
import { JsonRpcProvider, Wallet } from "ethers"

// set up your ethers objects
const rpc = new JsonRpcProvider("https://api.calibration.node.glif.io/rpc/v1")
const wallet = new Wallet("<YOUR PRIVATE KEY HERE>", rpc)

// create randomness instance on Base Sepolia testnet
const randomness = Randomness.createBaseSepolia(wallet)

You can also create the randomness instance for your desired network using its chainId. Check the supported networks for details.

//create randomness instance using the chainID
const randomness = Randomness.createFromChainId(wallet, <SUPPORTED_CHAIN_ID>)

const response = await randomness.requestRandomness()

The smart contracts verify the randomness anyway, but it doesn't hurt to verify it for yourself to be sure.

await randomness.verify(response)

You can avoid throwing errors on verification failure by passing config parameters like so:

const isVerified = await randomness.verify(response, { shouldBlowUp: false })

Clone the repo

git clone https://github.com/randa-mu/randomness-js.git
cd randomness-js
git submodule update --init --recursive

Install the dependencies and build the projects to generate contract files.

npm install
npm run build

For running the tests, you need to create a .env file at the project root, filling in the fields detailed in .env.sample.

npm run test

We welcome pull requests and issues. If you find a bug or want to request a feature, feel free to open an issue or PR!

This project is licensed under the MIT License.