common

Aragon JS SDK Common

@aragon/sdk-common provides general purpose components to use across the entire Aragon SDK:

• Interfaces
• Constants
• Types
• Enumerations
• Helpers

Installation

Use npm or yarn to install @aragon/sdk-common.

npm install @aragon/sdk-common
yarn add @aragon/sdk-common

Usage

Constants

Encoding

Converting buffers and hex strings

import { hexToBytes, bytesToHex } from "@aragon/sdk-common";

const buff = hexToBytes("0xffffffff");
// [255, 255, 255, 255]

const str = bytesToHex(new Uint8Array([100, 100, 100, 100, 100, 100]));
// "646464646464"

const str0x = bytesToHex(new Uint8Array([100, 100, 100, 100, 100, 100]), true);
// "0x646464646464"

Converting between buffers and big integers

import { bigIntToBuffer, bigIntToLeBuffer } from "@aragon/sdk-common";

const bi = BigInt("111122223333444455556666777788889999000011112222333344445555666677778888999900")
const buff = bigIntToBuffer(bi);
// Uint8Array(32) [ 245, 172, 243,  22, 170, 44,  13,  78, ..., 220 ]

const buffLe = bigIntToLeBuffer(bi);
// Uint8Array(32) [ 220,  67, 63, 224,  21,  50, 154, 103, ..., 245 ]

import { bufferToBigInt, bufferLeToBigInt } from "@aragon/sdk-common";

const buff = new Uint8Array([
  245, 172, 243,  22, 170, 44,  13,  78,
  106,  70,  70, 147, 249, 71, 137, 190,
  155,  21, 186,  14, 206, 88,  97, 129,
  103, 154,  50,  21, 224, 63,  67, 220
]);
const hex = bufferToBigInt(buff);
// 111122223333444455556666777788889999000011112222333344445555666677778888999900n

const buffLe = new Uint8Array([
  220,  67, 63, 224,  21,  50, 154, 103,
  129,  97, 88, 206,  14, 186,  21, 155,
  190, 137, 71, 249, 147,  70,  70, 106,
   78,  13, 44, 170,  22, 243, 172, 245
]);
const hex = bufferLeToBigInt(buffLe);
// 111122223333444455556666777788889999000011112222333344445555666677778888999900n

Percent ratios stored on-chain

Encodes ratio values between 0 and 1 translated into an integer range with the given digit precision

import { encodeRatio, decodeRatio } from "@aragon/sdk-common";

let digits = 1
encodeRatio(0.5, digits) // 5
encodeRatio(0.53625, digits) // 5
encodeRatio(0.57625, digits) // 6

digits = 4
encodeRatio(0.5, digits) // 5000
encodeRatio(0.53625, digits) // 5362
encodeRatio(0.57625, digits) // 5762

Hex prefix guards

import { strip0x, ensure0x } from "@aragon/sdk-common";

strip0x("1234")
// "1234"
strip0x("0x1234")
// "1234"

ensure0x("1234")
// "0x1234"
ensure0x("0x1234")
// "0x1234"

Random

import { Random } from "@aragon/sdk-common";

// Bytes
Random.getBytes(1); // Uint8Array(1) [34]
Random.getBytes(2); // Uint8Array(1) [63, 215]
Random.getBytes(8); // Uint8Array(1) [2, 194, 201, 142, 26, 5, 77, 152]

// Hex (32 bytes)
Random.getHex(); // "9a6dbc9176afdb69d6fb9a76fdb917613bd971a6bd9176adf3b791d1bda19d17"

// Big integer up to the given number
Random.getBigInt(256n); // 251n

Random.getFloat(); // 0.24152366327234

Random.shuffle([1, 2, 3, 4]);  // [3, 1, 4, 2]

Errors

Promises

Types