46 lines
1.4 KiB
TypeScript
46 lines
1.4 KiB
TypeScript
// Copyright 2017-2021 @polkadot/util authors & contributors
|
|
// SPDX-License-Identifier: Apache-2.0
|
|
|
|
import { assert } from '../assert';
|
|
import { isHex } from '../is/hex';
|
|
import { hexStripPrefix } from './stripPrefix';
|
|
|
|
/**
|
|
* @name hexToU8a
|
|
* @summary Creates a Uint8Array object from a hex string.
|
|
* @description
|
|
* `null` inputs returns an empty `Uint8Array` result. Hex input values return the actual bytes value converted to a Uint8Array. Anything that is not a hex string (including the `0x` prefix) throws an error.
|
|
* @example
|
|
* <BR>
|
|
*
|
|
* ```javascript
|
|
* import { hexToU8a } from '@polkadot/util';
|
|
*
|
|
* hexToU8a('0x80001f'); // Uint8Array([0x80, 0x00, 0x1f])
|
|
* hexToU8a('0x80001f', 32); // Uint8Array([0x00, 0x80, 0x00, 0x1f])
|
|
* ```
|
|
*/
|
|
export function hexToU8a (_value?: string | null, bitLength = -1): Uint8Array {
|
|
if (!_value) {
|
|
return new Uint8Array();
|
|
}
|
|
|
|
assert(isHex(_value), () => `Expected hex value to convert, found '${_value}'`);
|
|
|
|
const value = hexStripPrefix(_value);
|
|
const valLength = value.length / 2;
|
|
const bufLength = Math.ceil(
|
|
bitLength === -1
|
|
? valLength
|
|
: bitLength / 8
|
|
);
|
|
const result = new Uint8Array(bufLength);
|
|
const offset = Math.max(0, bufLength - valLength);
|
|
|
|
for (let index = 0; index < bufLength; index++) {
|
|
result[index + offset] = parseInt(value.substr(index * 2, 2), 16);
|
|
}
|
|
|
|
return result;
|
|
}
|