eos-common

eos-common

EOSIO Smart Contract common library used for Typescript

Goal

To implement the most commonly used EOSIO C++ Classes into Typescript:

• Asset
• Symbol
• SymbolCode
• ExtendedAsset
• ExtendedSymbol

Installation

Using Yarn:

yarn add eos-common

or using NPM:

npm install --save eos-common

Quick Start

import { Asset, Symbol } from "eos-common"

const quantity = new Asset(10000, new Symbol("EOS", 4));
quantity.toString() //=> "1.0000 EOS";
quantity.symbol.code() //=> "EOS"
quantity.symbol.precision //=> 4

API

Table of Contents

• Asset
  • Parameters
  • Examples
  • amount
  • is_amount_within_range
  • is_valid
  • max_amount
• check
  • Parameters
  • Examples
• SymbolCode
• Symbol
  • Parameters
  • Examples
• stake2vote
  • Parameters
• vote2stake
  • Parameters
• voteWeightToday
• split
  • Parameters
  • Examples

Asset

Asset

Parameters

• amount number The amount of the asset
• sym Symbol The name of the symbol

Examples

const quantity = new Asset(10000, new Symbol("EOS", 4));
quantity.toString() //=> "1.0000 EOS";
quantity.symbol.code() //=> "EOS"
quantity.symbol.precision //=> 4

Returns Asset Asset

amount

{int64_t} The amount of the asset

is_amount_within_range

Check if the amount doesn't exceed the max amount

Returns any true - if the amount doesn't exceed the max amount

Returns any false - otherwise

is_valid

Check if the asset is valid. %A valid asset has its amount <= max_amount and its symbol name valid

Returns any true - if the asset is valid

Returns any false - otherwise

max_amount

{constexpr int64_t} Maximum amount possible for this asset. It's capped to 2^62 - 1

check

Assert if the predicate fails and use the supplied message.

Parameters

• pred boolean Pre-condition
• msg string Error Message

Examples

check(a == b, "a does not equal b");

Returns void

SymbolCode

Symbol

Symbol

Parameters

• code string Symbol Code
• precision number Precision

Examples

const sym = new Symbol("EOS", 4);
sym.code() //=> "EOS"
sym.precision //=> 4

Returns Symbol Symbol

stake2vote

Convert EOS stake into decaying value

Parameters

• staked
• vote number vote

vote2stake

Convert vote decay value into EOS stake

Parameters

• vote
• staked number staked

voteWeightToday

voteWeightToday computes the stake2vote weight for EOS, in order to compute the decaying value.

split

Split quantity string

Parameters

• quantity string Quantity string

Examples

const quantity = split("1.0000 EOS");
quantity.amount //=> 10000
quantity.symbol.precision //=> 4
quantity.symbol.code() //=> "EOS"

Returns Asset