@feelyourprotocol/util 8141.0.0

package/dist/cjs/signature.d.ts

@@ -0,0 +1,47 @@
+import type { PrefixedHexString } from './types.ts';
+export declare function calculateSigRecovery(v: bigint, chainId?: bigint): bigint;
+/**
+ * ECDSA public key recovery from signature.
+ * NOTE: Accepts `v === 0 | v === 1` for EIP1559 transactions
+ * @returns Recovered public key
+ */
+export declare const ecrecover: (msgHash: Uint8Array, v: bigint, r: Uint8Array, s: Uint8Array, chainId?: bigint) => Uint8Array;
+/**
+ * Convert signature parameters into the format of `eth_sign` RPC method.
+ * NOTE: Accepts `v === 0 | v === 1` for EIP1559 transactions
+ * @returns Signature
+ */
+export declare const toRPCSig: (v: bigint, r: Uint8Array, s: Uint8Array, chainId?: bigint) => string;
+/**
+ * Convert signature parameters into the format of Compact Signature Representation (EIP-2098).
+ * NOTE: Accepts `v === 0 | v === 1` for EIP1559 transactions
+ * @returns Signature
+ */
+export declare const toCompactSig: (v: bigint, r: Uint8Array, s: Uint8Array, chainId?: bigint) => string;
+/**
+ * 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 declare const fromRPCSig: (sig: PrefixedHexString) => {
+    v: bigint;
+    r: Uint8Array;
+    s: Uint8Array;
+};
+/**
+ * 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 declare const isValidSignature: (v: bigint, r: Uint8Array, s: Uint8Array, homesteadOrLater?: boolean, chainId?: bigint) => boolean;
+/**
+ * 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 declare const hashPersonalMessage: (message: Uint8Array) => Uint8Array;
+//# sourceMappingURL=signature.d.ts.map

package/dist/cjs/signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.d.ts","sourceRoot":"","sources":["../../src/signature.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEnD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAOxE;AAMD;;;;GAIG;AACH,eAAO,MAAM,SAAS,GACpB,SAAS,UAAU,EACnB,GAAG,MAAM,EACT,GAAG,UAAU,EACb,GAAG,UAAU,EACb,UAAU,MAAM,KACf,UAUF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GACnB,GAAG,MAAM,EACT,GAAG,UAAU,EACb,GAAG,UAAU,EACb,UAAU,MAAM,KACf,MASF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,GACvB,GAAG,MAAM,EACT,GAAG,UAAU,EACb,GAAG,UAAU,EACb,UAAU,MAAM,KACf,MAYF,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GAAa,KAAK,iBAAiB,KAAG;IAC3D,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,UAAU,CAAA;IACb,CAAC,EAAE,UAAU,CAAA;CAgCd,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,GAAG,MAAM,EACT,GAAG,UAAU,EACb,GAAG,UAAU,EACb,mBAAkB,OAAc,EAChC,UAAU,MAAM,KACf,OA0BF,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAa,SAAS,UAAU,KAAG,UAIlE,CAAA"}

package/dist/cjs/signature.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hashPersonalMessage = exports.isValidSignature = exports.fromRPCSig = exports.toCompactSig = exports.toRPCSig = exports.ecrecover = void 0;
+exports.calculateSigRecovery = calculateSigRecovery;
+const secp256k1_js_1 = require("@noble/curves/secp256k1.js");
+const sha3_js_1 = require("@noble/hashes/sha3.js");
+const bytes_ts_1 = require("./bytes.js");
+const constants_ts_1 = require("./constants.js");
+const errors_ts_1 = require("./errors.js");
+const helpers_ts_1 = require("./helpers.js");
+function calculateSigRecovery(v, chainId) {
+    if (v === constants_ts_1.BIGINT_0 || v === constants_ts_1.BIGINT_1)
+        return v;
+    if (chainId === undefined) {
+        return v - constants_ts_1.BIGINT_27;
+    }
+    return v - (chainId * constants_ts_1.BIGINT_2 + BigInt(35));
+}
+function isValidSigRecovery(recovery) {
+    return recovery === constants_ts_1.BIGINT_0 || recovery === constants_ts_1.BIGINT_1;
+}
+/**
+ * ECDSA public key recovery from signature.
+ * NOTE: Accepts `v === 0 | v === 1` for EIP1559 transactions
+ * @returns Recovered public key
+ */
+const ecrecover = function (msgHash, v, r, s, chainId) {
+    const signature = (0, bytes_ts_1.concatBytes)((0, bytes_ts_1.setLengthLeft)(r, 32), (0, bytes_ts_1.setLengthLeft)(s, 32));
+    const recovery = calculateSigRecovery(v, chainId);
+    if (!isValidSigRecovery(recovery)) {
+        throw (0, errors_ts_1.EthereumJSErrorWithoutCode)('Invalid signature v value');
+    }
+    const sig = secp256k1_js_1.secp256k1.Signature.fromBytes(signature).addRecoveryBit(Number(recovery));
+    const senderPubKey = sig.recoverPublicKey(msgHash);
+    return senderPubKey.toBytes(false).slice(1);
+};
+exports.ecrecover = ecrecover;
+/**
+ * Convert signature parameters into the format of `eth_sign` RPC method.
+ * NOTE: Accepts `v === 0 | v === 1` for EIP1559 transactions
+ * @returns Signature
+ */
+const toRPCSig = function (v, r, s, chainId) {
+    const recovery = calculateSigRecovery(v, chainId);
+    if (!isValidSigRecovery(recovery)) {
+        throw (0, errors_ts_1.EthereumJSErrorWithoutCode)('Invalid signature v value');
+    }
+    // geth (and the RPC eth_sign method) uses the 65 byte format used by Bitcoin
+    return (0, bytes_ts_1.bytesToHex)((0, bytes_ts_1.concatBytes)((0, bytes_ts_1.setLengthLeft)(r, 32), (0, bytes_ts_1.setLengthLeft)(s, 32), (0, bytes_ts_1.bigIntToBytes)(v)));
+};
+exports.toRPCSig = toRPCSig;
+/**
+ * Convert signature parameters into the format of Compact Signature Representation (EIP-2098).
+ * NOTE: Accepts `v === 0 | v === 1` for EIP1559 transactions
+ * @returns Signature
+ */
+const toCompactSig = function (v, r, s, chainId) {
+    const recovery = calculateSigRecovery(v, chainId);
+    if (!isValidSigRecovery(recovery)) {
+        throw (0, errors_ts_1.EthereumJSErrorWithoutCode)('Invalid signature v value');
+    }
+    const ss = Uint8Array.from([...s]);
+    if ((v > BigInt(28) && v % constants_ts_1.BIGINT_2 === constants_ts_1.BIGINT_1) || v === constants_ts_1.BIGINT_1 || v === BigInt(28)) {
+        ss[0] |= 0x80;
+    }
+    return (0, bytes_ts_1.bytesToHex)((0, bytes_ts_1.concatBytes)((0, bytes_ts_1.setLengthLeft)(r, 32), (0, bytes_ts_1.setLengthLeft)(ss, 32)));
+};
+exports.toCompactSig = toCompactSig;
+/**
+ * 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.
+ */
+const fromRPCSig = function (sig) {
+    const bytes = (0, bytes_ts_1.hexToBytes)(sig);
+    let r;
+    let s;
+    let v;
+    if (bytes.length >= 65) {
+        r = bytes.subarray(0, 32);
+        s = bytes.subarray(32, 64);
+        v = (0, bytes_ts_1.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((0, bytes_ts_1.bytesToInt)(bytes.subarray(32, 33)) >> 7);
+        s[0] &= 0x7f;
+    }
+    else {
+        throw (0, errors_ts_1.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 + constants_ts_1.BIGINT_27;
+    }
+    return {
+        v,
+        r,
+        s,
+    };
+};
+exports.fromRPCSig = fromRPCSig;
+/**
+ * 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
+ */
+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 = (0, bytes_ts_1.bytesToBigInt)(r);
+    const sBigInt = (0, bytes_ts_1.bytesToBigInt)(s);
+    if (rBigInt === constants_ts_1.BIGINT_0 ||
+        rBigInt >= constants_ts_1.SECP256K1_ORDER ||
+        sBigInt === constants_ts_1.BIGINT_0 ||
+        sBigInt >= constants_ts_1.SECP256K1_ORDER) {
+        return false;
+    }
+    if (homesteadOrLater && sBigInt >= constants_ts_1.SECP256K1_ORDER_DIV_2) {
+        return false;
+    }
+    return true;
+};
+exports.isValidSignature = isValidSignature;
+/**
+ * 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.
+ */
+const hashPersonalMessage = function (message) {
+    (0, helpers_ts_1.assertIsBytes)(message);
+    const prefix = (0, bytes_ts_1.utf8ToBytes)(`\u0019Ethereum Signed Message:\n${message.length}`);
+    return (0, sha3_js_1.keccak_256)((0, bytes_ts_1.concatBytes)(prefix, message));
+};
+exports.hashPersonalMessage = hashPersonalMessage;
+//# sourceMappingURL=signature.js.map

package/dist/cjs/signature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.js","sourceRoot":"","sources":["../../src/signature.ts"],"names":[],"mappings":";;;AA0BA,oDAOC;AAjCD,6DAAsD;AACtD,mDAAkD;AAElD,yCASmB;AACnB,iDAOuB;AACvB,2CAAwD;AACxD,6CAA4C;AAI5C,SAAgB,oBAAoB,CAAC,CAAS,EAAE,OAAgB;IAC9D,IAAI,CAAC,KAAK,uBAAQ,IAAI,CAAC,KAAK,uBAAQ;QAAE,OAAO,CAAC,CAAA;IAE9C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,wBAAS,CAAA;IACtB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,uBAAQ,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;AAC9C,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,OAAO,QAAQ,KAAK,uBAAQ,IAAI,QAAQ,KAAK,uBAAQ,CAAA;AACvD,CAAC;AAED;;;;GAIG;AACI,MAAM,SAAS,GAAG,UACvB,OAAmB,EACnB,CAAS,EACT,CAAa,EACb,CAAa,EACb,OAAgB;IAEhB,MAAM,SAAS,GAAG,IAAA,sBAAW,EAAC,IAAA,wBAAa,EAAC,CAAC,EAAE,EAAE,CAAC,EAAE,IAAA,wBAAa,EAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;IACzE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;IACjD,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,MAAM,IAAA,sCAA0B,EAAC,2BAA2B,CAAC,CAAA;IAC/D,CAAC;IAED,MAAM,GAAG,GAAG,wBAAS,CAAC,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAA;IACrF,MAAM,YAAY,GAAG,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAClD,OAAO,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAC7C,CAAC,CAAA;AAhBY,QAAA,SAAS,aAgBrB;AAED;;;;GAIG;AACI,MAAM,QAAQ,GAAG,UACtB,CAAS,EACT,CAAa,EACb,CAAa,EACb,OAAgB;IAEhB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;IACjD,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,MAAM,IAAA,sCAA0B,EAAC,2BAA2B,CAAC,CAAA;IAC/D,CAAC;IAED,6EAA6E;IAE7E,OAAO,IAAA,qBAAU,EAAC,IAAA,sBAAW,EAAC,IAAA,wBAAa,EAAC,CAAC,EAAE,EAAE,CAAC,EAAE,IAAA,wBAAa,EAAC,CAAC,EAAE,EAAE,CAAC,EAAE,IAAA,wBAAa,EAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC9F,CAAC,CAAA;AAdY,QAAA,QAAQ,YAcpB;AAED;;;;GAIG;AACI,MAAM,YAAY,GAAG,UAC1B,CAAS,EACT,CAAa,EACb,CAAa,EACb,OAAgB;IAEhB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;IACjD,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,MAAM,IAAA,sCAA0B,EAAC,2BAA2B,CAAC,CAAA;IAC/D,CAAC;IAED,MAAM,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IAClC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,uBAAQ,KAAK,uBAAQ,CAAC,IAAI,CAAC,KAAK,uBAAQ,IAAI,CAAC,KAAK,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QACxF,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;IACf,CAAC;IAED,OAAO,IAAA,qBAAU,EAAC,IAAA,sBAAW,EAAC,IAAA,wBAAa,EAAC,CAAC,EAAE,EAAE,CAAC,EAAE,IAAA,wBAAa,EAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;AAC7E,CAAC,CAAA;AAjBY,QAAA,YAAY,gBAiBxB;AAED;;;;;;;GAOG;AACI,MAAM,UAAU,GAAG,UAAU,GAAsB;IAKxD,MAAM,KAAK,GAAe,IAAA,qBAAU,EAAC,GAAG,CAAC,CAAA;IAEzC,IAAI,CAAa,CAAA;IACjB,IAAI,CAAa,CAAA;IACjB,IAAI,CAAS,CAAA;IACb,IAAI,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACvB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QACzB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;QAC1B,CAAC,GAAG,IAAA,wBAAa,EAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAA;IACvC,CAAC;SAAM,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC/B,6EAA6E;QAC7E,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QACzB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;QAC1B,CAAC,GAAG,MAAM,CAAC,IAAA,qBAAU,EAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;QACnD,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;IACd,CAAC;SAAM,CAAC;QACN,MAAM,IAAA,sCAA0B,EAAC,0BAA0B,CAAC,CAAA;IAC9D,CAAC;IAED,gDAAgD;IAChD,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACX,6FAA6F;QAC7F,CAAC,GAAG,CAAC,GAAG,wBAAS,CAAA;IACnB,CAAC;IAED,OAAO;QACL,CAAC;QACD,CAAC;QACD,CAAC;KACF,CAAA;AACH,CAAC,CAAA;AAnCY,QAAA,UAAU,cAmCtB;AAED;;;;GAIG;AACI,MAAM,gBAAgB,GAAG,UAC9B,CAAS,EACT,CAAa,EACb,CAAa,EACb,mBAA4B,IAAI,EAChC,OAAgB;IAEhB,IAAI,CAAC,CAAC,MAAM,KAAK,EAAE,IAAI,CAAC,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACvC,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IAAI,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;QAC1D,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,wBAAa,EAAC,CAAC,CAAC,CAAA;IAChC,MAAM,OAAO,GAAG,IAAA,wBAAa,EAAC,CAAC,CAAC,CAAA;IAEhC,IACE,OAAO,KAAK,uBAAQ;QACpB,OAAO,IAAI,8BAAe;QAC1B,OAAO,KAAK,uBAAQ;QACpB,OAAO,IAAI,8BAAe,EAC1B,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IAAI,gBAAgB,IAAI,OAAO,IAAI,oCAAqB,EAAE,CAAC;QACzD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAhCY,QAAA,gBAAgB,oBAgC5B;AAED;;;;;GAKG;AACI,MAAM,mBAAmB,GAAG,UAAU,OAAmB;IAC9D,IAAA,0BAAa,EAAC,OAAO,CAAC,CAAA;IACtB,MAAM,MAAM,GAAG,IAAA,sBAAW,EAAC,mCAAmC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC/E,OAAO,IAAA,oBAAU,EAAC,IAAA,sBAAW,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AACjD,CAAC,CAAA;AAJY,QAAA,mBAAmB,uBAI/B"}

package/dist/cjs/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/cjs/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/cjs/tasks.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrioritizedTaskExecutor = void 0;
+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;
+    }
+}
+exports.PrioritizedTaskExecutor = PrioritizedTaskExecutor;
+//# sourceMappingURL=tasks.js.map

package/dist/cjs/tasks.js.map

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

package/dist/cjs/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/cjs/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/cjs/types.js

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

package/dist/cjs/types.js.map

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

package/dist/cjs/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/cjs/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/cjs/units.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Units = exports.ETHER_TO_WEI = exports.GWEI_TO_WEI = void 0;
+exports.formatBigDecimal = formatBigDecimal;
+const constants_ts_1 = require("./constants.js");
+const errors_ts_1 = require("./errors.js");
+/** Conversion constants to wei */
+exports.GWEI_TO_WEI = BigInt(10 ** 9); // Multiplier to convert from Gwei to Wei
+exports.ETHER_TO_WEI = BigInt(10 ** 18); // Multiplier to convert from Ether to Wei
+function formatBigDecimal(numerator, denominator, maxDecimalFactor) {
+    if (denominator === constants_ts_1.BIGINT_0) {
+        denominator = constants_ts_1.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}`;
+}
+class Units {
+    static validateInput(amount) {
+        if (typeof amount === 'number' && !Number.isInteger(amount)) {
+            throw (0, errors_ts_1.EthereumJSErrorWithoutCode)('Input must be an integer number');
+        }
+        if (BigInt(amount) < 0) {
+            throw (0, errors_ts_1.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) * exports.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) * exports.GWEI_TO_WEI;
+    }
+}
+exports.Units = Units;
+//# sourceMappingURL=units.js.map

package/dist/cjs/units.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.js","sourceRoot":"","sources":["../../src/units.ts"],"names":[],"mappings":";;;AAOA,4CAeC;AAtBD,iDAAmD;AACnD,2CAAwD;AAExD,kCAAkC;AACrB,QAAA,WAAW,GAAG,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA,CAAC,yCAAyC;AACvE,QAAA,YAAY,GAAG,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAA,CAAC,0CAA0C;AAEvF,SAAgB,gBAAgB,CAC9B,SAAiB,EACjB,WAAmB,EACnB,gBAAwB;IAExB,IAAI,WAAW,KAAK,uBAAQ,EAAE,CAAC;QAC7B,WAAW,GAAG,uBAAQ,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,MAAa,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,IAAA,sCAA0B,EAAC,iCAAiC,CAAC,CAAA;QACrE,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAA,sCAA0B,EAAC,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,oBAAY,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,mBAAW,CAAA;IACrC,CAAC;CACF;AA/BD,sBA+BC"}

package/dist/cjs/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/cjs/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"}