#numbers #javascript

bn-rs

bn.js and ethers.js BigNumber bindings for Rust & WebAssembly

7 releases

0.2.4 Nov 21, 2022
0.2.3 Feb 20, 2022
0.2.2 Nov 5, 2021
0.1.2 Nov 3, 2021

#368 in WebAssembly

Download history 25/week @ 2024-02-04 96/week @ 2024-02-18 69/week @ 2024-02-25 30/week @ 2024-03-03 48/week @ 2024-03-10 7/week @ 2024-03-17 46/week @ 2024-03-24 100/week @ 2024-03-31

204 downloads per month
Used in 2 crates

MIT/Apache

23KB
532 lines

bn.rs

bn.js and ethers.js BigNumber bindings for Rust & WebAssembly with primitive-types support


Write Rust code that uses bn.js and ethers.js BigNumber numbers

use primitive_types::{H160, U128};
use wasm_bindgen::prelude::*;

use bn_rs::{BigNumber, BN};

#[wasm_bindgen]
pub fn sum(a: BigNumber, b: BN) -> Result<BigNumber, JsValue> {
    // `BigNumberError` and `BNError` implement `Into<JsValue>`, so we can use `?` here

    let a = i128::try_from(a)?; // std uints are supported
    let b: U128 = b.try_into()?; // primitive-types uints supported too

    let result = a + b.as_u128() as i128;

    Ok(result.into())
}

#[wasm_bindgen]
pub fn is_dead(target_hash: BN, dead_hash: BigNumber) -> Result<bool, JsValue> {
    // primitive-types hashes supported too
    let hash = H160::try_from(target_hash)?;
    let dead = H160::try_from(dead_hash)?;

    Ok(hash == dead)
}

Call it from JavaScript

import {sum, is_dead} from './pkg'
import BN from 'bn.js'
import {BigNumber} from "@ethersproject/bignumber"

// Initialize bn.js and ethers.js BigNumber numbers
const a = BigNumber.from(2 ** 26)
const b = new BN(2 ** 26, 10)
const hash = new BN('dead', 'hex')
const dead = BigNumber.from('0xdead')

// Call Rust code with both BN and BigNumber passed and returned
console.log(sum(a, b)) // == BigNumber.from(4)
console.log(is_dead(hash, dead)) // == true

Run example

$ cd example
$ yarn
$ yarn start

Dependencies

~1.5–2.4MB
~43K SLoC