@elrondnetwork/dapp-utils v0.1.3

@elrondnetwork/dapp-utils react package

This module contains a collection of react components and helper functions commonly used when developing DApps.

Installation:

npm i @elrondnetwork/dapp-utils

Components

Denominate Displays a denominated value along with its label

Usage:

import { UI } from  "@elrondnetwork/dapp-utils";
const yourComponent = () => {
	
	return (
	<>
		...
		<UI.Denominate ...params />
	</>
	)
}

Params: | Name | type | required | default | Description | | :---: | :---: | :---: | :---: | :---: | | value | string | yes | - | Value that needs to be denominated | | showLastNonZeroDecimal | boolean | no | false | Shows the last non zero decimal | | showLabel | boolean | no | true | Shows the default label | | erdLabel | string | no | EGLD | Overrides the default label | | token | string | no | - | Overrides the erdLabel, used for ESDT Tokens | | decimals | number | no | 4 | Specifies how many decimals should be displayed | | denomination | number | no | 18 | Specifies how much to denominate by |

Validations

stringIsFloat Checks if a string is float.

Usage:

import { validation } from  "@elrondnetwork/dapp-utils";

validation.stringIsFloat("100.3423");

Params: | Name | type | required | default | Description | | :---: | :---: | :---: | :---: | :---: | | amount | string | yes | - | Amount that needs to be checked |

Returns boolean

stringIsInteger Checks if a string is integer

Usage:

import { validation } from  "@elrondnetwork/dapp-utils";

validation.stringIsInteger("100");

Params: | Name | type | required | default | Description | | :---: | :---: | :---: | :---: | :---: | | amount | string | yes | - | Amount that needs to be checked |

Returns boolean

Operations

nominate(input, customDenomination) Nominates a provided value

Usage:

import { operations } from  "@elrondnetwork/dapp-utils";

operations.nominate("10");

Params: | Name | type | required | default | Description | | :---: | :---: | :---: | :---: | :---: | | input | string | yes | - | Value that needs to be nominated| | customDenomination | number | no | 18 | Custom denomination value |

Returns string

denominate(input, denomination, decimals, showLastNonZeroDecimals) Denominates a provided value

Usage:

import { operations } from  "@elrondnetwork/dapp-utils";

operations.denominate({input: "10000000000000000000000", decimals: 4});

Params: | Name | type | required | default | Description | | :---: | :---: | :---: | :---: | :---: | | input | string | yes | - | Value that needs to be denominated| | denomination | number | yes | - | Denomination value | | decimals | number | yes | - | Specifies how many decimals should be displayed| | showLastNonZeroDecimals | boolean | no | false | Shows the last non zero decimal | | addCommas | boolean | no | true | Formats the number with commas |

Returns string

getTokenFromData(data) Nominates a provided value

Usage:

import { operations } from  "@elrondnetwork/dapp-utils";

operations.getTokenFromData("ESDTTransfer@425553442d663361616361@0de0b6b3a7640000");

Params: | Name | type | required | default | Description | | :---: | :---: | :---: | :---: | :---: | | data | string | yes | - | string representing operation and Hex ecoded values of token and amount|

Returns data { tokenId: string; nominatedTokenAmount: string }