arrng contract package

A library to implement arrng for verifiable rng in blockchain apps. aarng implements an oracle to serve signed randomness from random.org to a number of chains, including:

• mainnet
• blessnet
• arbitrum one
• optimism
• polygon
• eth sepolia
• blessnet sepolia

For more details please see https://www.arrng.io/.

Overview

Installation

$ npm install @arrng/contracts

An alternative to npm is to use the GitHub repository (arrng/arrng-contracts) to retrieve the contracts.

Usage

Once installed, use arrng by importing the consumer contract. Either pass in the arrng controller address on your constructor or use the hardcoded address below.

aarng is at 0x000000000000507620846e6A03237350fD7eD4d5 on all supported chains.

pragma solidity ^0.8.0;

import "@arrng/contracts/ArrngConsumer.sol";

contract MyArrngConsumer is ArrngConsumer {
    constructor() ArrngConsumer(0x000000000000507620846e6A03237350fD7eD4d5) {
    }
}

If you're new to smart contract development, we recommend heading to openzeppelin for a great guide to Developing Smart Contracts, to learn about creating a new project and compiling your contracts.

To request randomness from arrng (for example one number):

iD = arrngController.requestRandomWords {value: msg.value} (1);

The iD returned is a uint256 which uniquely identifies your request on that chain. You will need to send enough native token (e.g. ETH) for the response with the random number. This is served by api.arrng.io. See https://www.arrng.io/ for details.

The arrng oracle will wait for six confirmations before responding. To receive the response and use it in your contract you will need to include the fullfillRandomWords internal function.

See an example contract at https://github.com/arrng/arrng-contracts/blob/main/contracts/mock/MockConsumer.sol.