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 str0x = bytesToHex(new Uint8Array([100, 100, 100, 100, 100, 100]));
// "0x646464646464"

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

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"

Proposal ID's

For nonce based proposal ID's

import { encodeProposalId, decodeProposalId } from "@aragon/sdk-common";

encodeProposalId(pluginAddr, nonce)
// 0x1234567890123456789012345678901234567890_0x7

decodeProposalId("0x1234567890123456789012345678901234567890_0x7")
// { pluginAddress: "0x12345...", nonce: 7 }

Errors

Promises

Types

Security

If you believe you've found a security issue, we encourage you to notify us. We welcome working with you to resolve the issue promptly.

Security Contact Email: [email protected]

Please do not use the issue tracker for security issues.