@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

  • .asciiToTxHex(input)

  • .txsToAscii(txs)

  • .txBits(input)

  • .txs(txBits)

  • .value(txBits)

  • .fromValue(value)

  • .toTxBytes(value, padding)

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:

1. We get the decimal unicode value of an individual ASCII character this code can be represented in a Byte

2. Decimal value is then converted into hexadecimal value

Example:

Lets say we want to convert ascii character Z.

1. Z has a decimal unicode value of 90.

2. 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