@helixnetwork/converter

Methods for converting ascii values to txs, txBits and back.

Installation

Install using npm:

npm install @helixnetwork/converter

or using yarn:

yarn add @helixnetwork/converter

API Reference

converter

The following data types are used in this packages: TxBits - which represents and array of bits, stored in a Int8Array object. TxBytes - which represents and array of unsigned bytes, stored in a Uint8Array object TxHex - which represents the hexadecima string, because of this should contain only 0-91-f and should have a even length.

converter.asciiToTxHex(input)

Param	Type	Description
input	`string`	ascii input

Converts an ascii encoded string to txs.

How conversion works:

An ascii value of 1 Byte can be represented in 2 hexadecimal characters:

We get the decimal unicode value of an individual ASCII character this code can be represented in a Byte
Decimal value is then converted into hexadecimal value

Example:

Lets say we want to convert ascii character Z.

Z has a decimal unicode value of 90.
90 in hexadecimal is 5a

Therefore ascii character Z is represented as 5a in TxHex.

Returns: string - string of txs

converter.txsToAscii(txs)

Param	Type	Description
txs	`string`	txs

Converts txs of even length to an ascii string

Returns: string - string in ascii

converter.txBits(input)

Param	Type	Description
input	`TxHex` \ `Number`	TxHex or value to be converted.

Converts txs or values to txBits

Returns: Int8Array - txBits

converter.txs(txBits)

Param	Type
hBits	`Int8Array`

Converts txBits to txs

Returns: String - txs

converter.value(txBits)

Param	Type
txBits	`Int8Array`

Converts txBits into an integer value

converter.fromValue(value)

Param	Type
value	`Number`

Converts an integer value to txBits

Returns: Int8Array - txBits

converter.toTxBytes(value, padding)

Param	Type	Description
value	`number`	Value that should be converted
padding	`number`	Padding for the converted string

Converts an integer value to byte array

Returns: TxBytes - txBytes