@feelyourprotocol/util 8141.0.0

package/dist/esm/signature.js

@@ -0,0 +1,137 @@
+import { secp256k1 } from '@noble/curves/secp256k1.js';
+import { keccak_256 } from '@noble/hashes/sha3.js';
+import { bigIntToBytes, bytesToBigInt, bytesToHex, bytesToInt, concatBytes, hexToBytes, setLengthLeft, utf8ToBytes, } from "./bytes.js";
+import { BIGINT_0, BIGINT_1, BIGINT_2, BIGINT_27, SECP256K1_ORDER, SECP256K1_ORDER_DIV_2, } from "./constants.js";
+import { EthereumJSErrorWithoutCode } from "./errors.js";
+import { assertIsBytes } from "./helpers.js";
+export function calculateSigRecovery(v, chainId) {
+    if (v === BIGINT_0 || v === BIGINT_1)
+        return v;
+    if (chainId === undefined) {
+        return v - BIGINT_27;
+    }
+    return v - (chainId * BIGINT_2 + BigInt(35));
+}
+function isValidSigRecovery(recovery) {
+    return recovery === BIGINT_0 || recovery === BIGINT_1;
+}
+/**
+ * ECDSA public key recovery from signature.
+ * NOTE: Accepts `v === 0 | v === 1` for EIP1559 transactions
+ * @returns Recovered public key
+ */
+export const ecrecover = function (msgHash, v, r, s, chainId) {
+    const signature = concatBytes(setLengthLeft(r, 32), setLengthLeft(s, 32));
+    const recovery = calculateSigRecovery(v, chainId);
+    if (!isValidSigRecovery(recovery)) {
+        throw EthereumJSErrorWithoutCode('Invalid signature v value');
+    }
+    const sig = secp256k1.Signature.fromBytes(signature).addRecoveryBit(Number(recovery));
+    const senderPubKey = sig.recoverPublicKey(msgHash);
+    return senderPubKey.toBytes(false).slice(1);
+};
+/**
+ * Convert signature parameters into the format of `eth_sign` RPC method.
+ * NOTE: Accepts `v === 0 | v === 1` for EIP1559 transactions
+ * @returns Signature
+ */
+export const toRPCSig = function (v, r, s, chainId) {
+    const recovery = calculateSigRecovery(v, chainId);
+    if (!isValidSigRecovery(recovery)) {
+        throw EthereumJSErrorWithoutCode('Invalid signature v value');
+    }
+    // geth (and the RPC eth_sign method) uses the 65 byte format used by Bitcoin
+    return bytesToHex(concatBytes(setLengthLeft(r, 32), setLengthLeft(s, 32), bigIntToBytes(v)));
+};
+/**
+ * Convert signature parameters into the format of Compact Signature Representation (EIP-2098).
+ * NOTE: Accepts `v === 0 | v === 1` for EIP1559 transactions
+ * @returns Signature
+ */
+export const toCompactSig = function (v, r, s, chainId) {
+    const recovery = calculateSigRecovery(v, chainId);
+    if (!isValidSigRecovery(recovery)) {
+        throw EthereumJSErrorWithoutCode('Invalid signature v value');
+    }
+    const ss = Uint8Array.from([...s]);
+    if ((v > BigInt(28) && v % BIGINT_2 === BIGINT_1) || v === BIGINT_1 || v === BigInt(28)) {
+        ss[0] |= 0x80;
+    }
+    return bytesToHex(concatBytes(setLengthLeft(r, 32), setLengthLeft(ss, 32)));
+};
+/**
+ * Convert signature format of the `eth_sign` RPC method to signature parameters
+ *
+ * NOTE: For an extracted `v` value < 27 (see Geth bug https://github.com/ethereum/go-ethereum/issues/2053)
+ * `v + 27` is returned for the `v` value
+ * NOTE: After EIP1559, `v` could be `0` or `1` but this function assumes
+ * it's a signed message (EIP-191 or EIP-712) adding `27` at the end. Remove if needed.
+ */
+export const fromRPCSig = function (sig) {
+    const bytes = hexToBytes(sig);
+    let r;
+    let s;
+    let v;
+    if (bytes.length >= 65) {
+        r = bytes.subarray(0, 32);
+        s = bytes.subarray(32, 64);
+        v = bytesToBigInt(bytes.subarray(64));
+    }
+    else if (bytes.length === 64) {
+        // Compact Signature Representation (https://eips.ethereum.org/EIPS/eip-2098)
+        r = bytes.subarray(0, 32);
+        s = bytes.subarray(32, 64);
+        v = BigInt(bytesToInt(bytes.subarray(32, 33)) >> 7);
+        s[0] &= 0x7f;
+    }
+    else {
+        throw EthereumJSErrorWithoutCode('Invalid signature length');
+    }
+    // support both versions of `eth_sign` responses
+    if (v < 27) {
+        // TODO: verify this behavior, and verify in which context this method (`fromRPCSig`) is used
+        v = v + BIGINT_27;
+    }
+    return {
+        v,
+        r,
+        s,
+    };
+};
+/**
+ * Validate a ECDSA signature.
+ * NOTE: Accepts `v === 0 | v === 1` for EIP1559 transactions
+ * @param homesteadOrLater Indicates whether this is being used on either the homestead hardfork or a later one
+ */
+export const isValidSignature = function (v, r, s, homesteadOrLater = true, chainId) {
+    if (r.length !== 32 || s.length !== 32) {
+        return false;
+    }
+    if (!isValidSigRecovery(calculateSigRecovery(v, chainId))) {
+        return false;
+    }
+    const rBigInt = bytesToBigInt(r);
+    const sBigInt = bytesToBigInt(s);
+    if (rBigInt === BIGINT_0 ||
+        rBigInt >= SECP256K1_ORDER ||
+        sBigInt === BIGINT_0 ||
+        sBigInt >= SECP256K1_ORDER) {
+        return false;
+    }
+    if (homesteadOrLater && sBigInt >= SECP256K1_ORDER_DIV_2) {
+        return false;
+    }
+    return true;
+};
+/**
+ * Returns the keccak-256 hash of `message`, prefixed with the header used by the `eth_sign` RPC call.
+ * The output of this function can be fed into `ecsign` to produce the same signature as the `eth_sign`
+ * call for a given `message`, or fed to `ecrecover` along with a signature to recover the public key
+ * used to produce the signature.
+ */
+export const hashPersonalMessage = function (message) {
+    assertIsBytes(message);
+    const prefix = utf8ToBytes(`\u0019Ethereum Signed Message:\n${message.length}`);
+    return keccak_256(concatBytes(prefix, message));
+};
+//# sourceMappingURL=signature.js.map

package/dist/esm/signature.js.map

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

package/dist/esm/tasks.d.ts

@@ -0,0 +1,32 @@
+export declare class PrioritizedTaskExecutor {
+    /** The maximum size of the pool */
+    private maxPoolSize;
+    /** The current size of the pool */
+    private currentPoolSize;
+    /** The task queue */
+    private queue;
+    /**
+     * Executes tasks up to maxPoolSize at a time, other items are put in a priority queue.
+     * @class PrioritizedTaskExecutor
+     * @private
+     * @param maxPoolSize The maximum size of the pool
+     */
+    constructor(maxPoolSize: number);
+    /**
+     * Executes the task or queues it if no spots are available.
+     * When a task is added, check if there are spots left in the pool.
+     * If a spot is available, claim that spot and give back the spot once the asynchronous task has been resolved.
+     * When no spots are available, add the task to the task queue. The task will be executed at some point when another task has been resolved.
+     * @private
+     * @param priority The priority of the task
+     * @param fn The function that accepts the callback, which must be called upon the task completion.
+     */
+    executeOrQueue(priority: number, fn: Function): void;
+    /**
+     * Checks if the taskExecutor is finished.
+     * @private
+     * @returns Returns `true` if the taskExecutor is finished, otherwise returns `false`.
+     */
+    finished(): boolean;
+}
+//# sourceMappingURL=tasks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/tasks.ts"],"names":[],"mappings":"AAKA,qBAAa,uBAAuB;IAClC,mCAAmC;IACnC,OAAO,CAAC,WAAW,CAAQ;IAC3B,mCAAmC;IACnC,OAAO,CAAC,eAAe,CAAQ;IAC/B,qBAAqB;IACrB,OAAO,CAAC,KAAK,CAAQ;IAErB;;;;;OAKG;gBACS,WAAW,EAAE,MAAM;IAM/B;;;;;;;;OAQG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ;IAgB7C;;;;OAIG;IACH,QAAQ,IAAI,OAAO;CAGpB"}

package/dist/esm/tasks.js

@@ -0,0 +1,47 @@
+export class PrioritizedTaskExecutor {
+    /**
+     * Executes tasks up to maxPoolSize at a time, other items are put in a priority queue.
+     * @class PrioritizedTaskExecutor
+     * @private
+     * @param maxPoolSize The maximum size of the pool
+     */
+    constructor(maxPoolSize) {
+        this.maxPoolSize = maxPoolSize;
+        this.currentPoolSize = 0;
+        this.queue = [];
+    }
+    /**
+     * Executes the task or queues it if no spots are available.
+     * When a task is added, check if there are spots left in the pool.
+     * If a spot is available, claim that spot and give back the spot once the asynchronous task has been resolved.
+     * When no spots are available, add the task to the task queue. The task will be executed at some point when another task has been resolved.
+     * @private
+     * @param priority The priority of the task
+     * @param fn The function that accepts the callback, which must be called upon the task completion.
+     */
+    executeOrQueue(priority, fn) {
+        if (this.currentPoolSize < this.maxPoolSize) {
+            this.currentPoolSize++;
+            fn(() => {
+                this.currentPoolSize--;
+                if (this.queue.length > 0) {
+                    this.queue.sort((a, b) => b.priority - a.priority);
+                    const item = this.queue.shift();
+                    this.executeOrQueue(item.priority, item.fn);
+                }
+            });
+        }
+        else {
+            this.queue.push({ priority, fn });
+        }
+    }
+    /**
+     * Checks if the taskExecutor is finished.
+     * @private
+     * @returns Returns `true` if the taskExecutor is finished, otherwise returns `false`.
+     */
+    finished() {
+        return this.currentPoolSize === 0;
+    }
+}
+//# sourceMappingURL=tasks.js.map

package/dist/esm/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/tasks.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,uBAAuB;IAQlC;;;;;OAKG;IACH,YAAY,WAAmB;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAC9B,IAAI,CAAC,eAAe,GAAG,CAAC,CAAA;QACxB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAA;IACjB,CAAC;IAED;;;;;;;;OAQG;IACH,cAAc,CAAC,QAAgB,EAAE,EAAY;QAC3C,IAAI,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC5C,IAAI,CAAC,eAAe,EAAE,CAAA;YACtB,EAAE,CAAC,GAAG,EAAE;gBACN,IAAI,CAAC,eAAe,EAAE,CAAA;gBACtB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC1B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAA;oBAClD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;oBAC/B,IAAI,CAAC,cAAc,CAAC,IAAK,CAAC,QAAQ,EAAE,IAAK,CAAC,EAAE,CAAC,CAAA;gBAC/C,CAAC;YACH,CAAC,CAAC,CAAA;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAA;QACnC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,eAAe,KAAK,CAAC,CAAA;IACnC,CAAC;CACF"}

package/dist/esm/types.d.ts

@@ -0,0 +1,64 @@
+import type { Address } from './address.ts';
+import type { ToBytesInputTypes } from './bytes.ts';
+export type BigIntLike = bigint | PrefixedHexString | number | Uint8Array;
+export type BytesLike = Uint8Array | number[] | number | bigint | TransformableToBytes | PrefixedHexString;
+export type NumericString = `${number}`;
+export type PrefixedHexString = `0x${string}`;
+/**
+ * A type that represents an input that can be converted to an Address.
+ */
+export type AddressLike = Address | Uint8Array | PrefixedHexString;
+export interface TransformableToBytes {
+    toBytes?(): Uint8Array;
+}
+export type NestedUint8Array = Array<Uint8Array | NestedUint8Array>;
+export declare function isNestedUint8Array(value: unknown): value is NestedUint8Array;
+export type TypeOutput = (typeof TypeOutput)[keyof typeof TypeOutput];
+export declare const TypeOutput: {
+    readonly Number: 0;
+    readonly BigInt: 1;
+    readonly Uint8Array: 2;
+    readonly PrefixedHexString: 3;
+};
+export type TypeOutputReturnType = {
+    [TypeOutput.Number]: number;
+    [TypeOutput.BigInt]: bigint;
+    [TypeOutput.Uint8Array]: Uint8Array;
+    [TypeOutput.PrefixedHexString]: PrefixedHexString;
+};
+/**
+ * Convert an input to a specified type.
+ * Input of null/undefined returns null/undefined regardless of the output type.
+ * @param input value to convert
+ * @param outputType type to output
+ */
+export declare function toType<T extends TypeOutput>(input: null, outputType: T): null;
+export declare function toType<T extends TypeOutput>(input: undefined, outputType: T): undefined;
+export declare function toType<T extends TypeOutput>(input: ToBytesInputTypes, outputType: T): TypeOutputReturnType[T];
+/**
+ * EIP-7702 Authorization list types
+ */
+export type EOACode7702AuthorizationListItemUnsigned = {
+    chainId: PrefixedHexString;
+    address: PrefixedHexString;
+    nonce: PrefixedHexString;
+};
+export type EOACode7702AuthorizationListItem = {
+    yParity: PrefixedHexString;
+    r: PrefixedHexString;
+    s: PrefixedHexString;
+} & EOACode7702AuthorizationListItemUnsigned;
+export type EOACode7702AuthorizationListBytesItem = [
+    Uint8Array,
+    Uint8Array,
+    Uint8Array,
+    Uint8Array,
+    Uint8Array,
+    Uint8Array
+];
+export type EOACode7702AuthorizationListBytes = EOACode7702AuthorizationListBytesItem[];
+export type EOACode7702AuthorizationList = EOACode7702AuthorizationListItem[];
+export type EOACode7702AuthorizationListBytesItemUnsigned = [Uint8Array, Uint8Array, Uint8Array];
+export declare function isEOACode7702AuthorizationListBytes(input: EOACode7702AuthorizationListBytes | EOACode7702AuthorizationList): input is EOACode7702AuthorizationListBytes;
+export declare function isEOACode7702AuthorizationList(input: EOACode7702AuthorizationListBytes | EOACode7702AuthorizationList): input is EOACode7702AuthorizationList;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAKnD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,iBAAiB,GAAG,MAAM,GAAG,UAAU,CAAA;AAKzE,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,MAAM,EAAE,GACR,MAAM,GACN,MAAM,GACN,oBAAoB,GACpB,iBAAiB,CAAA;AAKrB,MAAM,MAAM,aAAa,GAAG,GAAG,MAAM,EAAE,CAAA;AAKvC,MAAM,MAAM,iBAAiB,GAAG,KAAK,MAAM,EAAE,CAAA;AAE7C;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,UAAU,GAAG,iBAAiB,CAAA;AAElE,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,IAAI,UAAU,CAAA;CACvB;AAED,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,UAAU,GAAG,gBAAgB,CAAC,CAAA;AAEnE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAc5E;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAA;AAErE,eAAO,MAAM,UAAU;;;;;CAKb,CAAA;AAEV,MAAM,MAAM,oBAAoB,GAAG;IACjC,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IAC3B,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IAC3B,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,UAAU,CAAA;IACnC,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;CAClD,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,GAAG,IAAI,CAAA;AAC9E,wBAAgB,MAAM,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,GAAG,SAAS,CAAA;AACxF,wBAAgB,MAAM,CAAC,CAAC,SAAS,UAAU,EACzC,KAAK,EAAE,iBAAiB,EACxB,UAAU,EAAE,CAAC,GACZ,oBAAoB,CAAC,CAAC,CAAC,CAAA;AA2C1B;;GAEG;AACH,MAAM,MAAM,wCAAwC,GAAG;IACrD,OAAO,EAAE,iBAAiB,CAAA;IAC1B,OAAO,EAAE,iBAAiB,CAAA;IAC1B,KAAK,EAAE,iBAAiB,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,gCAAgC,GAAG;IAC7C,OAAO,EAAE,iBAAiB,CAAA;IAC1B,CAAC,EAAE,iBAAiB,CAAA;IACpB,CAAC,EAAE,iBAAiB,CAAA;CACrB,GAAG,wCAAwC,CAAA;AAG5C,MAAM,MAAM,qCAAqC,GAAG;IAClD,UAAU;IACV,UAAU;IACV,UAAU;IACV,UAAU;IACV,UAAU;IACV,UAAU;CACX,CAAA;AACD,MAAM,MAAM,iCAAiC,GAAG,qCAAqC,EAAE,CAAA;AACvF,MAAM,MAAM,4BAA4B,GAAG,gCAAgC,EAAE,CAAA;AAE7E,MAAM,MAAM,6CAA6C,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAAA;AAEhG,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,iCAAiC,GAAG,4BAA4B,GACtE,KAAK,IAAI,iCAAiC,CAS5C;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,iCAAiC,GAAG,4BAA4B,GACtE,KAAK,IAAI,4BAA4B,CAEvC"}

package/dist/esm/types.js

@@ -0,0 +1,71 @@
+import { bytesToBigInt, bytesToHex, toBytes } from "./bytes.js";
+import { EthereumJSErrorWithoutCode } from "./errors.js";
+import { isHexString } from "./internal.js";
+export function isNestedUint8Array(value) {
+    if (!Array.isArray(value)) {
+        return false;
+    }
+    for (const item of value) {
+        if (Array.isArray(item)) {
+            if (!isNestedUint8Array(item)) {
+                return false;
+            }
+        }
+        else if (!(item instanceof Uint8Array)) {
+            return false;
+        }
+    }
+    return true;
+}
+export const TypeOutput = {
+    Number: 0,
+    BigInt: 1,
+    Uint8Array: 2,
+    PrefixedHexString: 3,
+};
+export function toType(input, outputType) {
+    if (input === null) {
+        return null;
+    }
+    if (input === undefined) {
+        return undefined;
+    }
+    if (typeof input === 'string' && !isHexString(input)) {
+        throw EthereumJSErrorWithoutCode(`A string must be provided with a 0x-prefix, given: ${input}`);
+    }
+    else if (typeof input === 'number' && !Number.isSafeInteger(input)) {
+        throw EthereumJSErrorWithoutCode('The provided number is greater than MAX_SAFE_INTEGER (please use an alternative input type)');
+    }
+    const output = toBytes(input);
+    switch (outputType) {
+        case TypeOutput.Uint8Array:
+            return output;
+        case TypeOutput.BigInt:
+            return bytesToBigInt(output);
+        case TypeOutput.Number: {
+            const bigInt = bytesToBigInt(output);
+            if (bigInt > BigInt(Number.MAX_SAFE_INTEGER)) {
+                throw EthereumJSErrorWithoutCode('The provided number is greater than MAX_SAFE_INTEGER (please use an alternative output type)');
+            }
+            return Number(bigInt);
+        }
+        case TypeOutput.PrefixedHexString:
+            return bytesToHex(output);
+        default:
+            throw EthereumJSErrorWithoutCode('unknown outputType');
+    }
+}
+export function isEOACode7702AuthorizationListBytes(input) {
+    if (input.length === 0) {
+        return true;
+    }
+    const firstItem = input[0];
+    if (Array.isArray(firstItem)) {
+        return true;
+    }
+    return false;
+}
+export function isEOACode7702AuthorizationList(input) {
+    return !isEOACode7702AuthorizationListBytes(input); // This is exactly the same method, except the output is negated.
+}
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

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

package/dist/esm/units.d.ts

@@ -0,0 +1,22 @@
+/** Conversion constants to wei */
+export declare const GWEI_TO_WEI: bigint;
+export declare const ETHER_TO_WEI: bigint;
+export declare function formatBigDecimal(numerator: bigint, denominator: bigint, maxDecimalFactor: bigint): string;
+export declare class Units {
+    static validateInput(amount: number | bigint): void;
+    /**
+     * Convert a number or bigint input of ether to wei
+     *
+     * @param {number | bigint} amount amount of units of ether to convert to wei
+     * @returns {bigint} amount of units in wei
+     */
+    static ether(amount: number | bigint): bigint;
+    /**
+     * Convert a number or bigint input of gwei to wei
+     *
+     * @param amount amount of units of gwei to convert to wei
+     * @returns {bigint} amount of units in wei
+     */
+    static gwei(amount: number | bigint): bigint;
+}
+//# sourceMappingURL=units.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"units.d.ts","sourceRoot":"","sources":["../../src/units.ts"],"names":[],"mappings":"AAGA,kCAAkC;AAClC,eAAO,MAAM,WAAW,QAAkB,CAAA;AAC1C,eAAO,MAAM,YAAY,QAAmB,CAAA;AAE5C,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAWR;AAED,qBAAa,KAAK;IAChB,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IASnD;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAK7C;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;CAI7C"}

package/dist/esm/units.js

@@ -0,0 +1,46 @@
+import { BIGINT_0, BIGINT_1 } from "./constants.js";
+import { EthereumJSErrorWithoutCode } from "./errors.js";
+/** Conversion constants to wei */
+export const GWEI_TO_WEI = BigInt(10 ** 9); // Multiplier to convert from Gwei to Wei
+export const ETHER_TO_WEI = BigInt(10 ** 18); // Multiplier to convert from Ether to Wei
+export function formatBigDecimal(numerator, denominator, maxDecimalFactor) {
+    if (denominator === BIGINT_0) {
+        denominator = BIGINT_1;
+    }
+    const full = numerator / denominator;
+    const fraction = ((numerator - full * denominator) * maxDecimalFactor) / denominator;
+    // zeros to be added post decimal are number of zeros in maxDecimalFactor - number of digits in fraction
+    const zerosPostDecimal = String(maxDecimalFactor).length - 1 - String(fraction).length;
+    return `${full}.${'0'.repeat(zerosPostDecimal)}${fraction}`;
+}
+export class Units {
+    static validateInput(amount) {
+        if (typeof amount === 'number' && !Number.isInteger(amount)) {
+            throw EthereumJSErrorWithoutCode('Input must be an integer number');
+        }
+        if (BigInt(amount) < 0) {
+            throw EthereumJSErrorWithoutCode('Input must be a positive number');
+        }
+    }
+    /**
+     * Convert a number or bigint input of ether to wei
+     *
+     * @param {number | bigint} amount amount of units of ether to convert to wei
+     * @returns {bigint} amount of units in wei
+     */
+    static ether(amount) {
+        Units.validateInput(amount);
+        return BigInt(amount) * ETHER_TO_WEI;
+    }
+    /**
+     * Convert a number or bigint input of gwei to wei
+     *
+     * @param amount amount of units of gwei to convert to wei
+     * @returns {bigint} amount of units in wei
+     */
+    static gwei(amount) {
+        Units.validateInput(amount);
+        return BigInt(amount) * GWEI_TO_WEI;
+    }
+}
+//# sourceMappingURL=units.js.map

package/dist/esm/units.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.js","sourceRoot":"","sources":["../../src/units.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAExD,kCAAkC;AAClC,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA,CAAC,yCAAyC;AACpF,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAA,CAAC,0CAA0C;AAEvF,MAAM,UAAU,gBAAgB,CAC9B,SAAiB,EACjB,WAAmB,EACnB,gBAAwB;IAExB,IAAI,WAAW,KAAK,QAAQ,EAAE,CAAC;QAC7B,WAAW,GAAG,QAAQ,CAAA;IACxB,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,GAAG,WAAW,CAAA;IACpC,MAAM,QAAQ,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI,GAAG,WAAW,CAAC,GAAG,gBAAgB,CAAC,GAAG,WAAW,CAAA;IAEpF,wGAAwG;IACxG,MAAM,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAA;IACtF,OAAO,GAAG,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,QAAQ,EAAE,CAAA;AAC7D,CAAC;AAED,MAAM,OAAO,KAAK;IAChB,MAAM,CAAC,aAAa,CAAC,MAAuB;QAC1C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5D,MAAM,0BAA0B,CAAC,iCAAiC,CAAC,CAAA;QACrE,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,0BAA0B,CAAC,iCAAiC,CAAC,CAAA;QACrE,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,MAAuB;QAClC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;QAC3B,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,YAAY,CAAA;IACtC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,MAAuB;QACjC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;QAC3B,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,WAAW,CAAA;IACrC,CAAC;CACF"}

package/dist/esm/withdrawal.d.ts

@@ -0,0 +1,72 @@
+import { Address } from './address.ts';
+import type { AddressLike, BigIntLike, PrefixedHexString } from './types.ts';
+/**
+ * Flexible input data type for EIP-4895 withdrawal data with amount in Gwei to
+ * match CL representation and for eventual ssz withdrawalsRoot
+ */
+export type WithdrawalData = {
+    index: BigIntLike;
+    validatorIndex: BigIntLike;
+    address: AddressLike;
+    amount: BigIntLike;
+};
+/**
+ * JSON RPC interface for EIP-4895 withdrawal data with amount in Gwei to
+ * match CL representation and for eventual ssz withdrawalsRoot
+ */
+export interface JSONRPCWithdrawal {
+    index: PrefixedHexString;
+    validatorIndex: PrefixedHexString;
+    address: PrefixedHexString;
+    amount: PrefixedHexString;
+}
+export type WithdrawalBytes = [Uint8Array, Uint8Array, Uint8Array, Uint8Array];
+/**
+ * Convert a withdrawal to a byte array
+ * @param withdrawal the withdrawal to convert
+ * @returns byte array of the withdrawal
+ */
+export declare function withdrawalToBytesArray(withdrawal: Withdrawal | WithdrawalData): WithdrawalBytes;
+/**
+ * Representation of EIP-4895 withdrawal data
+ */
+export declare class Withdrawal {
+    readonly index: bigint;
+    readonly validatorIndex: bigint;
+    readonly address: Address;
+    readonly amount: bigint;
+    /**
+     * This constructor assigns and validates the values.
+     * Use the static factory methods to assist in creating a Withdrawal object from varying data types.
+     * Its amount is in Gwei to match CL representation and for eventual ssz withdrawalsRoot
+     */
+    constructor(index: bigint, validatorIndex: bigint, address: Address, amount: bigint);
+    raw(): WithdrawalBytes;
+    toValue(): {
+        index: bigint;
+        validatorIndex: bigint;
+        address: Uint8Array<ArrayBufferLike>;
+        amount: bigint;
+    };
+    toJSON(): {
+        index: `0x${string}`;
+        validatorIndex: `0x${string}`;
+        address: `0x${string}`;
+        amount: `0x${string}`;
+    };
+}
+/**
+ * Creates a validator withdrawal request to be submitted to the consensus layer
+ * @param withdrawalData the consensus layer index and validator index values for the
+ * validator requesting the withdrawal and the address and withdrawal amount of the request
+ * @returns a {@link Withdrawal} object
+ */
+export declare function createWithdrawal(withdrawalData: WithdrawalData): Withdrawal;
+/**
+ * Creates a validator withdrawal request to be submitted to the consensus layer from
+ * an RLP list
+ * @param withdrawalArray decoded RLP list of withdrawal data elements
+ * @returns a {@link Withdrawal} object
+ */
+export declare function createWithdrawalFromBytesArray(withdrawalArray: WithdrawalBytes): Withdrawal;
+//# sourceMappingURL=withdrawal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"withdrawal.d.ts","sourceRoot":"","sources":["../../src/withdrawal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAKtC,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAE5E;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,UAAU,CAAA;IACjB,cAAc,EAAE,UAAU,CAAA;IAC1B,OAAO,EAAE,WAAW,CAAA;IACpB,MAAM,EAAE,UAAU,CAAA;CACnB,CAAA;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,iBAAiB,CAAA;IACxB,cAAc,EAAE,iBAAiB,CAAA;IACjC,OAAO,EAAE,iBAAiB,CAAA;IAC1B,MAAM,EAAE,iBAAiB,CAAA;CAC1B;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAAA;AAC9E;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,cAAc,GAAG,eAAe,CAmB/F;AACD;;GAEG;AACH,qBAAa,UAAU;IACrB,SAAgB,KAAK,EAAE,MAAM,CAAA;IAC7B,SAAgB,cAAc,EAAE,MAAM,CAAA;IACtC,SAAgB,OAAO,EAAE,OAAO,CAAA;IAChC,SAAgB,MAAM,EAAE,MAAM,CAAA;IAE9B;;;;OAIG;gBACS,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;IAOnF,GAAG;IAIH,OAAO;;;;;;IASP,MAAM;;;;;;CAQP;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,cAAc,cAa9D;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,eAAe,EAAE,eAAe,cAM9E"}

package/dist/esm/withdrawal.js

@@ -0,0 +1,86 @@
+import { Address } from "./address.js";
+import { bigIntToHex, bytesToHex, toBytes } from "./bytes.js";
+import { BIGINT_0 } from "./constants.js";
+import { TypeOutput, toType } from "./types.js";
+/**
+ * Convert a withdrawal to a byte array
+ * @param withdrawal the withdrawal to convert
+ * @returns byte array of the withdrawal
+ */
+export function withdrawalToBytesArray(withdrawal) {
+    const { index, validatorIndex, address, amount } = withdrawal;
+    const indexBytes = toType(index, TypeOutput.BigInt) === BIGINT_0
+        ? new Uint8Array()
+        : toType(index, TypeOutput.Uint8Array);
+    const validatorIndexBytes = toType(validatorIndex, TypeOutput.BigInt) === BIGINT_0
+        ? new Uint8Array()
+        : toType(validatorIndex, TypeOutput.Uint8Array);
+    const addressBytes = address instanceof Address ? address.bytes : toType(address, TypeOutput.Uint8Array);
+    const amountBytes = toType(amount, TypeOutput.BigInt) === BIGINT_0
+        ? new Uint8Array()
+        : toType(amount, TypeOutput.Uint8Array);
+    return [indexBytes, validatorIndexBytes, addressBytes, amountBytes];
+}
+/**
+ * Representation of EIP-4895 withdrawal data
+ */
+export class Withdrawal {
+    /**
+     * This constructor assigns and validates the values.
+     * Use the static factory methods to assist in creating a Withdrawal object from varying data types.
+     * Its amount is in Gwei to match CL representation and for eventual ssz withdrawalsRoot
+     */
+    constructor(index, validatorIndex, address, amount) {
+        this.index = index;
+        this.validatorIndex = validatorIndex;
+        this.address = address;
+        this.amount = amount;
+    }
+    raw() {
+        return withdrawalToBytesArray(this);
+    }
+    toValue() {
+        return {
+            index: this.index,
+            validatorIndex: this.validatorIndex,
+            address: this.address.bytes,
+            amount: this.amount,
+        };
+    }
+    toJSON() {
+        return {
+            index: bigIntToHex(this.index),
+            validatorIndex: bigIntToHex(this.validatorIndex),
+            address: bytesToHex(this.address.bytes),
+            amount: bigIntToHex(this.amount),
+        };
+    }
+}
+/**
+ * Creates a validator withdrawal request to be submitted to the consensus layer
+ * @param withdrawalData the consensus layer index and validator index values for the
+ * validator requesting the withdrawal and the address and withdrawal amount of the request
+ * @returns a {@link Withdrawal} object
+ */
+export function createWithdrawal(withdrawalData) {
+    const { index: indexData, validatorIndex: validatorIndexData, address: addressData, amount: amountData, } = withdrawalData;
+    const index = toType(indexData, TypeOutput.BigInt);
+    const validatorIndex = toType(validatorIndexData, TypeOutput.BigInt);
+    const address = addressData instanceof Address ? addressData : new Address(toBytes(addressData));
+    const amount = toType(amountData, TypeOutput.BigInt);
+    return new Withdrawal(index, validatorIndex, address, amount);
+}
+/**
+ * Creates a validator withdrawal request to be submitted to the consensus layer from
+ * an RLP list
+ * @param withdrawalArray decoded RLP list of withdrawal data elements
+ * @returns a {@link Withdrawal} object
+ */
+export function createWithdrawalFromBytesArray(withdrawalArray) {
+    if (withdrawalArray.length !== 4) {
+        throw Error(`Invalid withdrawalArray length expected=4 actual=${withdrawalArray.length}`);
+    }
+    const [index, validatorIndex, address, amount] = withdrawalArray;
+    return createWithdrawal({ index, validatorIndex, address, amount });
+}
+//# sourceMappingURL=withdrawal.js.map

package/dist/esm/withdrawal.js.map

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