@feelyourprotocol/util 8141.0.0

package/dist/esm/address.js

@@ -0,0 +1,125 @@
+import { generateAddress, generateAddress2, isValidAddress, privateToAddress, pubToAddress, } from "./account.js";
+import { bigIntToBytes, bytesToBigInt, bytesToHex, equalsBytes, hexToBytes, setLengthLeft, } from "./bytes.js";
+import { BIGINT_0 } from "./constants.js";
+import { EthereumJSErrorWithoutCode } from "./errors.js";
+/**
+ * Handling and generating Ethereum addresses
+ */
+export class Address {
+    constructor(bytes) {
+        if (bytes.length !== 20) {
+            throw EthereumJSErrorWithoutCode('Invalid address length');
+        }
+        this.bytes = bytes;
+    }
+    /**
+     * Is address equal to another.
+     */
+    equals(address) {
+        return equalsBytes(this.bytes, address.bytes);
+    }
+    /**
+     * Is address zero.
+     */
+    isZero() {
+        return this.equals(new Address(new Uint8Array(20)));
+    }
+    /**
+     * True if address is in the address range defined
+     * by EIP-1352
+     */
+    isPrecompileOrSystemAddress() {
+        const address = bytesToBigInt(this.bytes);
+        const rangeMin = BIGINT_0;
+        const rangeMax = BigInt('0xffff');
+        return address >= rangeMin && address <= rangeMax;
+    }
+    /**
+     * Returns hex encoding of address.
+     */
+    toString() {
+        return bytesToHex(this.bytes);
+    }
+    /**
+     * Returns a new Uint8Array representation of address.
+     */
+    toBytes() {
+        return new Uint8Array(this.bytes);
+    }
+}
+/**
+ * Returns the zero address.
+ */
+export function createZeroAddress() {
+    return new Address(new Uint8Array(20));
+}
+/**
+ * Returns an Address object from a bigint address (they are stored as bigints on the stack)
+ * @param value The bigint address
+ */
+export function createAddressFromBigInt(value) {
+    const bytes = bigIntToBytes(value);
+    if (bytes.length > 20) {
+        throw EthereumJSErrorWithoutCode(`Invalid address, too long: ${bytes.length}`);
+    }
+    return new Address(setLengthLeft(bytes, 20));
+}
+/**
+ * Returns an Address object from a hex-encoded string.
+ * @param str - Hex-encoded address
+ */
+export function createAddressFromString(str) {
+    if (!isValidAddress(str)) {
+        throw EthereumJSErrorWithoutCode(`Invalid address input=${str}`);
+    }
+    return new Address(hexToBytes(str));
+}
+/**
+ * Returns an address for a given public key.
+ * @param pubKey The two points of an uncompressed key
+ */
+export function createAddressFromPublicKey(pubKey) {
+    if (!(pubKey instanceof Uint8Array)) {
+        throw EthereumJSErrorWithoutCode('Public key should be Uint8Array');
+    }
+    const bytes = pubToAddress(pubKey);
+    return new Address(bytes);
+}
+/**
+ * Returns an address for a given private key.
+ * @param privateKey A private key must be 256 bits wide
+ */
+export function createAddressFromPrivateKey(privateKey) {
+    if (!(privateKey instanceof Uint8Array)) {
+        throw EthereumJSErrorWithoutCode('Private key should be Uint8Array');
+    }
+    const bytes = privateToAddress(privateKey);
+    return new Address(bytes);
+}
+/**
+ * Generates an address for a newly created contract.
+ * @param from The address which is creating this new address
+ * @param nonce The nonce of the from account
+ */
+export function createContractAddress(from, nonce) {
+    if (typeof nonce !== 'bigint') {
+        throw EthereumJSErrorWithoutCode('Expected nonce to be a bigint');
+    }
+    return new Address(generateAddress(from.bytes, bigIntToBytes(nonce)));
+}
+/**
+ * Generates an address for a contract created using CREATE2.
+ * @param from The address which is creating this new address
+ * @param salt A salt
+ * @param initCode The init code of the contract being created
+ */
+export function createContractAddress2(from, salt, initCode) {
+    if (!(salt instanceof Uint8Array)) {
+        throw EthereumJSErrorWithoutCode('Expected salt to be a Uint8Array');
+    }
+    if (!(initCode instanceof Uint8Array)) {
+        throw EthereumJSErrorWithoutCode('Expected initCode to be a Uint8Array');
+    }
+    return new Address(generateAddress2(from.bytes, salt, initCode));
+}
+//# sourceMappingURL=address.js.map

package/dist/esm/address.js.map

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

package/dist/esm/authorization.d.ts

@@ -0,0 +1,41 @@
+import { secp256k1 } from '@noble/curves/secp256k1.js';
+import { Address } from './address.ts';
+import type { EOACode7702AuthorizationListBytesItem, EOACode7702AuthorizationListBytesItemUnsigned, EOACode7702AuthorizationListItem, EOACode7702AuthorizationListItemUnsigned } from './types.ts';
+export declare const EOA_CODE_7702_AUTHORITY_SIGNING_MAGIC: Uint8Array<ArrayBufferLike>;
+/**
+ * Converts an authorization list to a JSON format
+ * @param authorizationList
+ * @returns authorizationList in JSON format
+ */
+export declare function eoaCode7702AuthorizationListBytesItemToJSON(authorizationList: EOACode7702AuthorizationListBytesItem): EOACode7702AuthorizationListItem;
+/**
+ * Converts an authority list in JSON to a bytes format
+ * @param authorizationList
+ * @returns bytes format of the authority list
+ */
+export declare function eoaCode7702AuthorizationListJSONItemToBytes(authorizationList: EOACode7702AuthorizationListItem): EOACode7702AuthorizationListBytesItem;
+/**
+ * Returns the bytes (RLP-encoded) to sign
+ * @param input Either the bytes or the object format of the authorization list item
+ * @returns
+ */
+export declare function eoaCode7702AuthorizationMessageToSign(input: EOACode7702AuthorizationListItemUnsigned | EOACode7702AuthorizationListBytesItemUnsigned): Uint8Array<ArrayBuffer>;
+/**
+ * Hashes the RLP-encoded message to sign
+ * @param input
+ * @returns
+ */
+export declare function eoaCode7702AuthorizationHashedMessageToSign(input: EOACode7702AuthorizationListItemUnsigned | EOACode7702AuthorizationListBytesItemUnsigned): Uint8Array<ArrayBufferLike>;
+/**
+ * Signs an authorization list item and returns it in `bytes` format.
+ * To get the JSON format, use `authorizationListBytesToJSON([signed])[0] to convert it`
+ * @param input
+ * @param privateKey
+ * @param ecSign
+ * @returns
+ */
+export declare function eoaCode7702SignAuthorization(input: EOACode7702AuthorizationListItemUnsigned | EOACode7702AuthorizationListBytesItemUnsigned, privateKey: Uint8Array, ecSign?: (msg: Uint8Array, pk: Uint8Array, ecSignOpts?: {
+    extraEntropy?: Uint8Array | boolean;
+}) => Pick<ReturnType<typeof secp256k1.Signature.fromBytes>, 'recovery' | 'r' | 's'>): EOACode7702AuthorizationListBytesItem;
+export declare function eoaCode7702RecoverAuthority(input: EOACode7702AuthorizationListItem | EOACode7702AuthorizationListBytesItem): Address;
+//# sourceMappingURL=authorization.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"authorization.d.ts","sourceRoot":"","sources":["../../src/authorization.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAGtD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAWtC,OAAO,KAAK,EACV,qCAAqC,EACrC,6CAA6C,EAC7C,gCAAgC,EAChC,wCAAwC,EACzC,MAAM,YAAY,CAAA;AAEnB,eAAO,MAAM,qCAAqC,6BAAqB,CAAA;AAEvE;;;;GAIG;AACH,wBAAgB,2CAA2C,CACzD,iBAAiB,EAAE,qCAAqC,GACvD,gCAAgC,CAUlC;AAED;;;;GAIG;AACH,wBAAgB,2CAA2C,CACzD,iBAAiB,EAAE,gCAAgC,GAClD,qCAAqC,CAoBvC;AAWD;;;;GAIG;AACH,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,wCAAwC,GAAG,6CAA6C,2BAgBhG;AAED;;;;GAIG;AACH,wBAAgB,2CAA2C,CACzD,KAAK,EAAE,wCAAwC,GAAG,6CAA6C,+BAGhG;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,wCAAwC,GAAG,6CAA6C,EAC/F,UAAU,EAAE,UAAU,EACtB,MAAM,CAAC,EAAE,CACP,GAAG,EAAE,UAAU,EACf,EAAE,EAAE,UAAU,EACd,UAAU,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,UAAU,GAAG,OAAO,CAAA;CAAE,KACjD,IAAI,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,GAAG,GAAG,GAAG,CAAC,GAClF,qCAAqC,CA0BvC;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,gCAAgC,GAAG,qCAAqC,GAC9E,OAAO,CAeT"}

package/dist/esm/authorization.js

@@ -0,0 +1,126 @@
+// Utility helpers to convert authorization lists from the byte format and JSON format and vice versa
+import { EthereumJSErrorWithoutCode, RLP } from '@feelyourprotocol/rlp';
+import { secp256k1 } from '@noble/curves/secp256k1.js';
+import { keccak_256 } from '@noble/hashes/sha3.js';
+import { publicToAddress } from "./account.js";
+import { Address } from "./address.js";
+import { bigIntToUnpaddedBytes, bytesToBigInt, bytesToHex, concatBytes, hexToBytes, setLengthLeft, unpadBytes, } from "./bytes.js";
+import { ecrecover } from "./signature.js";
+export const EOA_CODE_7702_AUTHORITY_SIGNING_MAGIC = hexToBytes('0x05');
+/**
+ * Converts an authorization list to a JSON format
+ * @param authorizationList
+ * @returns authorizationList in JSON format
+ */
+export function eoaCode7702AuthorizationListBytesItemToJSON(authorizationList) {
+    const [chainId, address, nonce, yParity, r, s] = authorizationList;
+    return {
+        chainId: bytesToHex(chainId),
+        address: bytesToHex(address),
+        nonce: bytesToHex(nonce),
+        yParity: bytesToHex(yParity),
+        r: bytesToHex(r),
+        s: bytesToHex(s),
+    };
+}
+/**
+ * Converts an authority list in JSON to a bytes format
+ * @param authorizationList
+ * @returns bytes format of the authority list
+ */
+export function eoaCode7702AuthorizationListJSONItemToBytes(authorizationList) {
+    const requiredFields = ['chainId', 'address', 'nonce', 'yParity', 'r', 's'];
+    // Validate all required fields are present
+    for (const field of requiredFields) {
+        if (authorizationList[field] === undefined) {
+            throw EthereumJSErrorWithoutCode(`EIP-7702 authorization list invalid: ${field} is not defined`);
+        }
+    }
+    return [
+        unpadBytes(hexToBytes(authorizationList.chainId)),
+        hexToBytes(authorizationList.address),
+        unpadBytes(hexToBytes(authorizationList.nonce)),
+        unpadBytes(hexToBytes(authorizationList.yParity)),
+        unpadBytes(hexToBytes(authorizationList.r)),
+        unpadBytes(hexToBytes(authorizationList.s)),
+    ];
+}
+/** Authorization signing utility methods */
+function unsignedAuthorizationListToBytes(input) {
+    const { chainId: chainIdHex, address: addressHex, nonce: nonceHex } = input;
+    const chainId = unpadBytes(hexToBytes(chainIdHex));
+    const address = setLengthLeft(hexToBytes(addressHex), 20);
+    const nonce = unpadBytes(hexToBytes(nonceHex));
+    return [chainId, address, nonce];
+}
+/**
+ * Returns the bytes (RLP-encoded) to sign
+ * @param input Either the bytes or the object format of the authorization list item
+ * @returns
+ */
+export function eoaCode7702AuthorizationMessageToSign(input) {
+    if (Array.isArray(input)) {
+        // The address is validated, the chainId and nonce will be `unpadBytes` such that these are valid
+        const [chainId, address, nonce] = input;
+        if (address.length !== 20) {
+            throw EthereumJSErrorWithoutCode('Cannot sign authority: address length should be 20 bytes');
+        }
+        return concatBytes(EOA_CODE_7702_AUTHORITY_SIGNING_MAGIC, RLP.encode([unpadBytes(chainId), address, unpadBytes(nonce)]));
+    }
+    else {
+        const [chainId, address, nonce] = unsignedAuthorizationListToBytes(input);
+        return concatBytes(EOA_CODE_7702_AUTHORITY_SIGNING_MAGIC, RLP.encode([chainId, address, nonce]));
+    }
+}
+/**
+ * Hashes the RLP-encoded message to sign
+ * @param input
+ * @returns
+ */
+export function eoaCode7702AuthorizationHashedMessageToSign(input) {
+    return keccak_256(eoaCode7702AuthorizationMessageToSign(input));
+}
+/**
+ * Signs an authorization list item and returns it in `bytes` format.
+ * To get the JSON format, use `authorizationListBytesToJSON([signed])[0] to convert it`
+ * @param input
+ * @param privateKey
+ * @param ecSign
+ * @returns
+ */
+export function eoaCode7702SignAuthorization(input, privateKey, ecSign) {
+    const msgHash = eoaCode7702AuthorizationHashedMessageToSign(input);
+    const secp256k1Sign = (msgHash, pk) => {
+        return (ecSign?.(msgHash, pk) ??
+            secp256k1.Signature.fromBytes(secp256k1.sign(msgHash, pk, { prehash: false, format: 'recovered' }), 'recovered'));
+    };
+    const signed = secp256k1Sign(msgHash, privateKey);
+    const [chainId, address, nonce] = Array.isArray(input)
+        ? input
+        : unsignedAuthorizationListToBytes(input);
+    return [
+        unpadBytes(chainId),
+        address,
+        unpadBytes(nonce),
+        bigIntToUnpaddedBytes(BigInt(signed.recovery)),
+        bigIntToUnpaddedBytes(signed.r),
+        bigIntToUnpaddedBytes(signed.s),
+    ];
+}
+export function eoaCode7702RecoverAuthority(input) {
+    const inputBytes = Array.isArray(input)
+        ? input
+        : eoaCode7702AuthorizationListJSONItemToBytes(input);
+    const [chainId, address, nonce, yParity, r, s] = [
+        unpadBytes(inputBytes[0]),
+        inputBytes[1],
+        unpadBytes(inputBytes[2]),
+        unpadBytes(inputBytes[3]),
+        unpadBytes(inputBytes[4]),
+        unpadBytes(inputBytes[5]),
+    ];
+    const msgHash = eoaCode7702AuthorizationHashedMessageToSign([chainId, address, nonce]);
+    const pubKey = ecrecover(msgHash, bytesToBigInt(yParity), r, s);
+    return new Address(publicToAddress(pubKey));
+}
+//# sourceMappingURL=authorization.js.map

package/dist/esm/authorization.js.map

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

package/dist/esm/bal.d.ts

@@ -0,0 +1,129 @@
+import type { PrefixedHexString } from './types.ts';
+type BALAddressHex = PrefixedHexString;
+type BALStorageKeyBytes = Uint8Array;
+type BALStorageKeyHex = PrefixedHexString;
+type BALStorageValueBytes = Uint8Array;
+type BALStorageValueHex = PrefixedHexString;
+type BALAccessIndexNumber = number;
+type BALAccessIndexHex = PrefixedHexString;
+type BALBalanceBigInt = bigint;
+type BALBalanceHex = PrefixedHexString;
+type BALNonceBigInt = bigint;
+type BALNonceHex = PrefixedHexString;
+type BALByteCodeBytes = Uint8Array;
+type BALByteCodeHex = PrefixedHexString;
+type BALRawStorageChange = [BALAccessIndexNumber, BALStorageValueBytes];
+type BALRawBalanceChange = [BALAccessIndexNumber, BALBalanceHex];
+type BALRawNonceChange = [BALAccessIndexNumber, BALNonceHex];
+type BALRawCodeChange = [BALAccessIndexNumber, BALByteCodeBytes];
+type BALRawSlotChanges = [BALStorageKeyHex, BALRawStorageChange[]];
+type BALRawAccountChanges = [
+    BALAddressHex,
+    BALRawSlotChanges[],
+    BALStorageKeyHex[],
+    BALRawBalanceChange[],
+    BALRawNonceChange[],
+    BALRawCodeChange[]
+];
+type BALRawBlockAccessList = BALRawAccountChanges[];
+export type Accesses = Record<BALAddressHex, {
+    nonceChanges: Map<BALAccessIndexNumber, BALNonceHex>;
+    balanceChanges: Map<BALAccessIndexNumber, BALBalanceHex>;
+    codeChanges: BALRawCodeChange[];
+    storageChanges: Record<BALStorageKeyHex, BALRawStorageChange[]>;
+    storageReads: Set<BALStorageKeyHex>;
+}>;
+interface BALJSONBalanceChange {
+    blockAccessIndex: BALAccessIndexHex;
+    postBalance: BALBalanceHex;
+}
+interface BALJSONNonceChange {
+    blockAccessIndex: BALAccessIndexHex;
+    postNonce: BALNonceHex;
+}
+interface BALJSONCodeChange {
+    blockAccessIndex: BALAccessIndexHex;
+    newCode: BALByteCodeHex;
+}
+interface BALJSONStorageChange {
+    blockAccessIndex: BALAccessIndexHex;
+    postValue: BALStorageValueHex;
+}
+interface BALJSONSlotChanges {
+    slot: BALStorageKeyHex;
+    slotChanges: BALJSONStorageChange[];
+}
+interface BALJSONAccountChanges {
+    address: BALAddressHex;
+    balanceChanges: BALJSONBalanceChange[];
+    nonceChanges: BALJSONNonceChange[];
+    codeChanges: BALJSONCodeChange[];
+    storageChanges: BALJSONSlotChanges[];
+    storageReads: BALStorageKeyHex[];
+}
+export type BALJSONBlockAccessList = BALJSONAccountChanges[];
+export type { BALJSONAccountChanges, BALJSONStorageChange, BALJSONSlotChanges, BALJSONBalanceChange, BALJSONNonceChange, BALJSONCodeChange, };
+/**
+ * Structural helper class for block level access lists
+ *
+ * EXPERIMENTAL: DO NOT USE IN PRODUCTION!
+ */
+export declare class BlockLevelAccessList {
+    accesses: Accesses;
+    blockAccessIndex: number;
+    private checkpoints;
+    private originalBalances;
+    private originalCodesAtIndex;
+    constructor(accesses?: Accesses);
+    /**
+     * Serializes the block level access list to RLP.
+     *
+     * @returns the RLP encoded block level access list
+     */
+    serialize(): Uint8Array;
+    /**
+     * This hash is used in the block header
+     *
+     * @returns the hash of the serialized block level access list
+     */
+    hash(): Uint8Array;
+    checkpoint(): void;
+    commit(): void;
+    revert(): void;
+    private cloneAccesses;
+    /**
+     * Returns the raw block level access list with values
+     * correctly sorted.
+     *
+     * @returns the raw block level access list
+     */
+    raw(): BALRawBlockAccessList;
+    addAddress(address: BALAddressHex): void;
+    addStorageWrite(address: BALAddressHex, storageKey: BALStorageKeyBytes, value: BALStorageValueBytes, blockAccessIndex: BALAccessIndexNumber, originalValue?: BALStorageValueBytes): void;
+    addStorageRead(address: BALAddressHex, storageKey: BALStorageKeyBytes): void;
+    addBalanceChange(address: BALAddressHex, balance: BALBalanceBigInt, blockAccessIndex: BALAccessIndexNumber, originalBalance?: BALBalanceBigInt): void;
+    /**
+     * EIP-7928: Remove balance changes for addresses where final balance equals first balance.
+     * Call this at the end of each transaction to clean up net-zero balance changes.
+     */
+    cleanupNetZeroBalanceChanges(): void;
+    addNonceChange(address: BALAddressHex, nonce: BALNonceBigInt, blockAccessIndex: BALAccessIndexNumber): void;
+    addCodeChange(address: BALAddressHex, code: BALByteCodeBytes, blockAccessIndex: BALAccessIndexNumber, originalCode?: BALByteCodeBytes): void;
+    /**
+     * EIP-7928: For selfdestructed accounts, drop all state changes while
+     * preserving read footprints. Any storageChanges are converted to storageReads.
+     *
+     * Per EIP-7928: "if the account had a positive balance pre-transaction,
+     * the balance change to zero MUST be recorded."
+     */
+    /**
+     * Converts the internal representation to the JSON format (BALJSONBlockAccessList).
+     * Inverse of createBlockLevelAccessListFromJSON().
+     */
+    toJSON(): BALJSONBlockAccessList;
+    cleanupSelfdestructed(addresses: Array<BALAddressHex>): void;
+}
+export declare function createBlockLevelAccessList(): BlockLevelAccessList;
+export declare function createBlockLevelAccessListFromJSON(json: BALJSONBlockAccessList): BlockLevelAccessList;
+export declare function createBlockLevelAccessListFromRLP(rlp: Uint8Array): BlockLevelAccessList;
+//# sourceMappingURL=bal.d.ts.map

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

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