@feelyourprotocol/rlp 8141.0.0

package/dist/cjs/index.js

@@ -0,0 +1,300 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RLP = exports.utils = void 0;
+exports.hexToBytes = hexToBytes;
+exports.encode = encode;
+exports.decode = decode;
+const errors_ts_1 = require("./errors.js");
+__exportStar(require("./errors.js"), exports);
+/**
+ * Parse integers. Check if there is no leading zeros
+ * @param v The value to parse
+ */
+function decodeLength(v) {
+    if (v[0] === 0) {
+        throw (0, errors_ts_1.EthereumJSErrorWithoutCode)('invalid RLP: extra zeros');
+    }
+    return parseHexByte(bytesToHex(v));
+}
+function encodeLength(len, offset) {
+    if (len < 56) {
+        return Uint8Array.from([len + offset]);
+    }
+    const hexLength = numberToHex(len);
+    const lLength = hexLength.length / 2;
+    const firstByte = numberToHex(offset + 55 + lLength);
+    return Uint8Array.from(hexToBytes(firstByte + hexLength));
+}
+/**
+ * Slices a Uint8Array, throws if the slice goes out-of-bounds of the Uint8Array.
+ * E.g. `safeSlice(hexToBytes('aa'), 1, 2)` will throw.
+ * @param input
+ * @param start
+ * @param end
+ */
+function safeSlice(input, start, end) {
+    if (end > input.length) {
+        throw (0, errors_ts_1.EthereumJSErrorWithoutCode)('invalid RLP (safeSlice): end slice of Uint8Array out-of-bounds');
+    }
+    return input.slice(start, end);
+}
+/** Decode an input with RLP */
+function _decode(input) {
+    let length, lLength, data, innerRemainder, d;
+    const decoded = [];
+    const firstByte = input[0];
+    if (firstByte <= 0x7f) {
+        // a single byte whose value is in the [0x00, 0x7f] range, that byte is its own RLP encoding.
+        return {
+            data: input.slice(0, 1),
+            remainder: input.subarray(1),
+        };
+    }
+    else if (firstByte <= 0xb7) {
+        // string is 0-55 bytes long. A single byte with value 0x80 plus the length of the string followed by the string
+        // The range of the first byte is [0x80, 0xb7]
+        length = firstByte - 0x7f;
+        // set 0x80 null to 0
+        if (firstByte === 0x80) {
+            data = Uint8Array.from([]);
+        }
+        else {
+            data = safeSlice(input, 1, length);
+        }
+        if (length === 2 && data[0] < 0x80) {
+            throw (0, errors_ts_1.EthereumJSErrorWithoutCode)('invalid RLP encoding: invalid prefix, single byte < 0x80 are not prefixed');
+        }
+        return {
+            data,
+            remainder: input.subarray(length),
+        };
+    }
+    else if (firstByte <= 0xbf) {
+        // string is greater than 55 bytes long. A single byte with the value (0xb7 plus the length of the length),
+        // followed by the length, followed by the string
+        lLength = firstByte - 0xb6;
+        if (input.length - 1 < lLength) {
+            throw (0, errors_ts_1.EthereumJSErrorWithoutCode)('invalid RLP: not enough bytes for string length');
+        }
+        length = decodeLength(safeSlice(input, 1, lLength));
+        if (length <= 55) {
+            throw (0, errors_ts_1.EthereumJSErrorWithoutCode)('invalid RLP: expected string length to be greater than 55');
+        }
+        data = safeSlice(input, lLength, length + lLength);
+        return {
+            data,
+            remainder: input.subarray(length + lLength),
+        };
+    }
+    else if (firstByte <= 0xf7) {
+        // a list between 0-55 bytes long
+        length = firstByte - 0xbf;
+        innerRemainder = safeSlice(input, 1, length);
+        while (innerRemainder.length) {
+            d = _decode(innerRemainder);
+            decoded.push(d.data);
+            innerRemainder = d.remainder;
+        }
+        return {
+            data: decoded,
+            remainder: input.subarray(length),
+        };
+    }
+    else {
+        // a list over 55 bytes long
+        lLength = firstByte - 0xf6;
+        length = decodeLength(safeSlice(input, 1, lLength));
+        if (length < 56) {
+            throw (0, errors_ts_1.EthereumJSErrorWithoutCode)('invalid RLP: encoded list too short');
+        }
+        const totalLength = lLength + length;
+        if (totalLength > input.length) {
+            throw (0, errors_ts_1.EthereumJSErrorWithoutCode)('invalid RLP: total length is larger than the data');
+        }
+        innerRemainder = safeSlice(input, lLength, totalLength);
+        while (innerRemainder.length) {
+            d = _decode(innerRemainder);
+            decoded.push(d.data);
+            innerRemainder = d.remainder;
+        }
+        return {
+            data: decoded,
+            remainder: input.subarray(totalLength),
+        };
+    }
+}
+const cachedHexes = Array.from({ length: 256 }, (_v, i) => i.toString(16).padStart(2, '0'));
+function bytesToHex(uint8a) {
+    // Pre-caching chars with `cachedHexes` speeds this up 6x
+    let hex = '';
+    for (let i = 0; i < uint8a.length; i++) {
+        hex += cachedHexes[uint8a[i]];
+    }
+    return hex;
+}
+function parseHexByte(hexByte) {
+    const byte = Number.parseInt(hexByte, 16);
+    if (Number.isNaN(byte))
+        throw (0, errors_ts_1.EthereumJSErrorWithoutCode)('Invalid byte sequence');
+    return byte;
+}
+// Borrowed from @noble/curves to avoid dependency
+// Original code here - https://github.com/paulmillr/noble-curves/blob/d0a8d2134c5737d9d0aa81be13581cd416ebdeb4/src/abstract/utils.ts#L63-L91
+const asciis = { _0: 48, _9: 57, _A: 65, _F: 70, _a: 97, _f: 102 };
+function asciiToBase16(char) {
+    if (char >= asciis._0 && char <= asciis._9)
+        return char - asciis._0;
+    if (char >= asciis._A && char <= asciis._F)
+        return char - (asciis._A - 10);
+    if (char >= asciis._a && char <= asciis._f)
+        return char - (asciis._a - 10);
+    return;
+}
+/**
+ * @example hexToBytes('0xcafe0123') // Uint8Array.from([0xca, 0xfe, 0x01, 0x23])
+ */
+function hexToBytes(hex) {
+    if (hex.slice(0, 2) === '0x')
+        hex = hex.slice(0, 2);
+    if (typeof hex !== 'string')
+        throw (0, errors_ts_1.EthereumJSErrorWithoutCode)('hex string expected, got ' + typeof hex);
+    const hl = hex.length;
+    const al = hl / 2;
+    if (hl % 2)
+        throw (0, errors_ts_1.EthereumJSErrorWithoutCode)('padded hex string expected, got unpadded hex of length ' + hl);
+    const array = new Uint8Array(al);
+    for (let ai = 0, hi = 0; ai < al; ai++, hi += 2) {
+        const n1 = asciiToBase16(hex.charCodeAt(hi));
+        const n2 = asciiToBase16(hex.charCodeAt(hi + 1));
+        if (n1 === undefined || n2 === undefined) {
+            const char = hex[hi] + hex[hi + 1];
+            throw (0, errors_ts_1.EthereumJSErrorWithoutCode)('hex string expected, got non-hex character "' + char + '" at index ' + hi);
+        }
+        array[ai] = n1 * 16 + n2;
+    }
+    return array;
+}
+/** Concatenates two Uint8Arrays into one. */
+function concatBytes(...arrays) {
+    if (arrays.length === 1)
+        return arrays[0];
+    const length = arrays.reduce((a, arr) => a + arr.length, 0);
+    const result = new Uint8Array(length);
+    for (let i = 0, pad = 0; i < arrays.length; i++) {
+        const arr = arrays[i];
+        result.set(arr, pad);
+        pad += arr.length;
+    }
+    return result;
+}
+function utf8ToBytes(utf) {
+    return new TextEncoder().encode(utf);
+}
+/** Transform an integer into its hexadecimal value */
+function numberToHex(integer) {
+    if (integer < 0) {
+        throw (0, errors_ts_1.EthereumJSErrorWithoutCode)('Invalid integer as argument, must be unsigned!');
+    }
+    const hex = integer.toString(16);
+    return hex.length % 2 ? `0${hex}` : hex;
+}
+/** Pad a string to be even */
+function padToEven(a) {
+    return a.length % 2 ? `0${a}` : a;
+}
+/** Check if a string is prefixed by 0x */
+function isHexString(str) {
+    return str.length >= 2 && str[0] === '0' && str[1] === 'x';
+}
+/** Removes 0x from a given String */
+function stripHexPrefix(str) {
+    if (typeof str !== 'string') {
+        return str;
+    }
+    return isHexString(str) ? str.slice(2) : str;
+}
+/** Transform anything into a Uint8Array */
+function toBytes(v) {
+    if (v instanceof Uint8Array) {
+        return v;
+    }
+    if (typeof v === 'string') {
+        if (isHexString(v)) {
+            return hexToBytes(padToEven(stripHexPrefix(v)));
+        }
+        return utf8ToBytes(v);
+    }
+    if (typeof v === 'number' || typeof v === 'bigint') {
+        if (!v) {
+            return Uint8Array.from([]);
+        }
+        return hexToBytes(numberToHex(v));
+    }
+    if (v === null || v === undefined) {
+        return Uint8Array.from([]);
+    }
+    throw (0, errors_ts_1.EthereumJSErrorWithoutCode)('toBytes: received unsupported type ' + typeof v);
+}
+/**
+ * RLP Encoding based on https://ethereum.org/en/developers/docs/data-structures-and-encoding/rlp/
+ * This function takes in data, converts it to Uint8Array if not,
+ * and adds a length for recursion.
+ * @param input Will be converted to Uint8Array
+ * @returns Uint8Array of encoded data
+ **/
+function encode(input) {
+    if (Array.isArray(input)) {
+        const output = [];
+        let outputLength = 0;
+        for (let i = 0; i < input.length; i++) {
+            const encoded = encode(input[i]);
+            output.push(encoded);
+            outputLength += encoded.length;
+        }
+        return concatBytes(encodeLength(outputLength, 192), ...output);
+    }
+    const inputBuf = toBytes(input);
+    if (inputBuf.length === 1 && inputBuf[0] < 128) {
+        return inputBuf;
+    }
+    return concatBytes(encodeLength(inputBuf.length, 128), inputBuf);
+}
+function decode(input, stream = false) {
+    if (typeof input === 'undefined' || input === null || input.length === 0) {
+        return Uint8Array.from([]);
+    }
+    const inputBytes = toBytes(input);
+    const decoded = _decode(inputBytes);
+    if (stream) {
+        return {
+            data: decoded.data,
+            remainder: decoded.remainder.slice(),
+        };
+    }
+    if (decoded.remainder.length !== 0) {
+        throw (0, errors_ts_1.EthereumJSErrorWithoutCode)('invalid RLP: remainder must be zero');
+    }
+    return decoded.data;
+}
+exports.utils = {
+    bytesToHex,
+    concatBytes,
+    hexToBytes,
+    utf8ToBytes,
+};
+exports.RLP = { encode, decode };
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+    "type": "commonjs"
+}

package/dist/esm/errors.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Generic EthereumJS error class with metadata attached
+ *
+ * Kudos to https://github.com/ChainSafe/lodestar monorepo
+ * for the inspiration :-)
+ * See: https://github.com/ChainSafe/lodestar/blob/unstable/packages/utils/src/errors.ts
+ */
+export type EthereumJSErrorMetaData = Record<string, string | number | null>;
+export type EthereumJSErrorObject = {
+    message: string;
+    stack: string;
+    className: string;
+    type: EthereumJSErrorMetaData;
+};
+export declare const DEFAULT_ERROR_CODE = "ETHEREUMJS_DEFAULT_ERROR_CODE";
+/**
+ * Generic EthereumJS error with attached metadata
+ */
+export declare class EthereumJSError<T extends {
+    code: string;
+}> extends Error {
+    type: T;
+    constructor(type: T, message?: string, stack?: string);
+    getMetadata(): EthereumJSErrorMetaData;
+    /**
+     * Get the metadata and the stacktrace for the error.
+     */
+    toObject(): EthereumJSErrorObject;
+}
+/**
+ * @deprecated Use `EthereumJSError` with a set error code instead
+ * @param message Optional error message
+ * @param stack Optional stack trace
+ * @returns
+ */
+export declare function EthereumJSErrorWithoutCode(message?: string, stack?: string): EthereumJSError<{
+    code: string;
+}>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/esm/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,CAAA;AAC5E,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,uBAAuB,CAAA;CAC9B,CAAA;AAKD,eAAO,MAAM,kBAAkB,kCAAkC,CAAA;AAEjE;;GAEG;AACH,qBAAa,eAAe,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAE,SAAQ,KAAK;IACpE,IAAI,EAAE,CAAC,CAAA;gBACK,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;IAMrD,WAAW,IAAI,uBAAuB;IAItC;;OAEG;IACH,QAAQ,IAAI,qBAAqB;CAQlC;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;;GAE1E"}

package/dist/esm/errors.js

@@ -0,0 +1,39 @@
+// In order to update all our errors to use `EthereumJSError`, temporarily include the
+// unset error code. All errors throwing this code should be updated to use the relevant
+// error code.
+export const DEFAULT_ERROR_CODE = 'ETHEREUMJS_DEFAULT_ERROR_CODE';
+/**
+ * Generic EthereumJS error with attached metadata
+ */
+export class EthereumJSError extends Error {
+    constructor(type, message, stack) {
+        super(message ?? type.code);
+        this.type = type;
+        if (stack !== undefined)
+            this.stack = stack;
+    }
+    getMetadata() {
+        return this.type;
+    }
+    /**
+     * Get the metadata and the stacktrace for the error.
+     */
+    toObject() {
+        return {
+            type: this.getMetadata(),
+            message: this.message ?? '',
+            stack: this.stack ?? '',
+            className: this.constructor.name,
+        };
+    }
+}
+/**
+ * @deprecated Use `EthereumJSError` with a set error code instead
+ * @param message Optional error message
+ * @param stack Optional stack trace
+ * @returns
+ */
+export function EthereumJSErrorWithoutCode(message, stack) {
+    return new EthereumJSError({ code: DEFAULT_ERROR_CODE }, message, stack);
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAeA,sFAAsF;AACtF,wFAAwF;AACxF,cAAc;AACd,MAAM,CAAC,MAAM,kBAAkB,GAAG,+BAA+B,CAAA;AAEjE;;GAEG;AACH,MAAM,OAAO,eAA4C,SAAQ,KAAK;IAEpE,YAAY,IAAO,EAAE,OAAgB,EAAE,KAAc;QACnD,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IAC7C,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE;YACxB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;YAC3B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;YACvB,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;SACjC,CAAA;IACH,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAgB,EAAE,KAAc;IACzE,OAAO,IAAI,eAAe,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;AAC1E,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,42 @@
+export * from './errors.ts';
+export type Input = string | number | bigint | Uint8Array | Array<Input> | null | undefined;
+export type NestedUint8Array = Array<Uint8Array | NestedUint8Array>;
+export interface Decoded {
+    data: Uint8Array | NestedUint8Array;
+    remainder: Uint8Array;
+}
+declare function bytesToHex(uint8a: Uint8Array): string;
+/**
+ * @example hexToBytes('0xcafe0123') // Uint8Array.from([0xca, 0xfe, 0x01, 0x23])
+ */
+export declare function hexToBytes(hex: string): Uint8Array;
+/** Concatenates two Uint8Arrays into one. */
+declare function concatBytes(...arrays: Uint8Array[]): Uint8Array;
+declare function utf8ToBytes(utf: string): Uint8Array;
+/**
+ * RLP Encoding based on https://ethereum.org/en/developers/docs/data-structures-and-encoding/rlp/
+ * This function takes in data, converts it to Uint8Array if not,
+ * and adds a length for recursion.
+ * @param input Will be converted to Uint8Array
+ * @returns Uint8Array of encoded data
+ **/
+export declare function encode(input: Input): Uint8Array;
+/**
+ * RLP Decoding based on https://ethereum.org/en/developers/docs/data-structures-and-encoding/rlp/
+ * @param input Will be converted to Uint8Array
+ * @param stream Is the input a stream (false by default)
+ * @returns decoded Array of Uint8Arrays containing the original message
+ **/
+export declare function decode(input: Input, stream?: false): Uint8Array | NestedUint8Array;
+export declare function decode(input: Input, stream?: true): Decoded;
+export declare const utils: {
+    bytesToHex: typeof bytesToHex;
+    concatBytes: typeof concatBytes;
+    hexToBytes: typeof hexToBytes;
+    utf8ToBytes: typeof utf8ToBytes;
+};
+export declare const RLP: {
+    encode: typeof encode;
+    decode: typeof decode;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAA;AAE3B,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,SAAS,CAAA;AAE3F,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,UAAU,GAAG,gBAAgB,CAAC,CAAA;AAEnE,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,UAAU,GAAG,gBAAgB,CAAA;IACnC,SAAS,EAAE,UAAU,CAAA;CACtB;AAoID,iBAAS,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAO9C;AAkBD;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAqBlD;AAED,6CAA6C;AAC7C,iBAAS,WAAW,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAUxD;AAMD,iBAAS,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAE5C;AAoDD;;;;;;IAMI;AACJ,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,CAgB/C;AAED;;;;;IAKI;AACJ,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,gBAAgB,CAAA;AACnF,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,CAAA;AAsB5D,eAAO,MAAM,KAAK;;;;;CAKjB,CAAA;AAED,eAAO,MAAM,GAAG;;;CAAqB,CAAA"}