etherjs-util 7.1.5

package/dist/signature.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hashPersonalMessage = exports.isValidSignature = exports.fromRpcSig = exports.toCompactSig = exports.toRpcSig = exports.ecrecover = exports.ecsign = void 0;
+const secp256k1_1 = require("ethereum-cryptography/secp256k1");
+const externals_1 = require("./externals");
+const bytes_1 = require("./bytes");
+const hash_1 = require("./hash");
+const helpers_1 = require("./helpers");
+const types_1 = require("./types");
+function ecsign(msgHash, privateKey, chainId) {
+    const { signature, recid: recovery } = (0, secp256k1_1.ecdsaSign)(msgHash, privateKey);
+    const r = Buffer.from(signature.slice(0, 32));
+    const s = Buffer.from(signature.slice(32, 64));
+    if (!chainId || typeof chainId === 'number') {
+        // return legacy type ECDSASignature (deprecated in favor of ECDSASignatureBuffer to handle large chainIds)
+        if (chainId && !Number.isSafeInteger(chainId)) {
+            throw new Error('The provided number is greater than MAX_SAFE_INTEGER (please use an alternative input type)');
+        }
+        const v = chainId ? recovery + (chainId * 2 + 35) : recovery + 27;
+        return { r, s, v };
+    }
+    const chainIdBN = (0, types_1.toType)(chainId, types_1.TypeOutput.BN);
+    const v = chainIdBN.muln(2).addn(35).addn(recovery).toArrayLike(Buffer);
+    return { r, s, v };
+}
+exports.ecsign = ecsign;
+function calculateSigRecovery(v, chainId) {
+    const vBN = (0, types_1.toType)(v, types_1.TypeOutput.BN);
+    if (vBN.eqn(0) || vBN.eqn(1))
+        return (0, types_1.toType)(v, types_1.TypeOutput.BN);
+    if (!chainId) {
+        return vBN.subn(27);
+    }
+    const chainIdBN = (0, types_1.toType)(chainId, types_1.TypeOutput.BN);
+    return vBN.sub(chainIdBN.muln(2).addn(35));
+}
+function isValidSigRecovery(recovery) {
+    const rec = new externals_1.BN(recovery);
+    return rec.eqn(0) || rec.eqn(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 = Buffer.concat([(0, bytes_1.setLengthLeft)(r, 32), (0, bytes_1.setLengthLeft)(s, 32)], 64);
+    const recovery = calculateSigRecovery(v, chainId);
+    if (!isValidSigRecovery(recovery)) {
+        throw new Error('Invalid signature v value');
+    }
+    const senderPubKey = (0, secp256k1_1.ecdsaRecover)(signature, recovery.toNumber(), msgHash);
+    return Buffer.from((0, secp256k1_1.publicKeyConvert)(senderPubKey, 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 new Error('Invalid signature v value');
+    }
+    // geth (and the RPC eth_sign method) uses the 65 byte format used by Bitcoin
+    return (0, bytes_1.bufferToHex)(Buffer.concat([(0, bytes_1.setLengthLeft)(r, 32), (0, bytes_1.setLengthLeft)(s, 32), (0, bytes_1.toBuffer)(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 new Error('Invalid signature v value');
+    }
+    const vn = (0, types_1.toType)(v, types_1.TypeOutput.Number);
+    let ss = s;
+    if ((vn > 28 && vn % 2 === 1) || vn === 1 || vn === 28) {
+        ss = Buffer.from(s);
+        ss[0] |= 0x80;
+    }
+    return (0, bytes_1.bufferToHex)(Buffer.concat([(0, bytes_1.setLengthLeft)(r, 32), (0, bytes_1.setLengthLeft)(ss, 32)]));
+};
+exports.toCompactSig = toCompactSig;
+/**
+ * Convert signature format of the `eth_sign` RPC method to signature parameters
+ * NOTE: all because of a bug in geth: https://github.com/ethereum/go-ethereum/issues/2053
+ * 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 buf = (0, bytes_1.toBuffer)(sig);
+    let r;
+    let s;
+    let v;
+    if (buf.length >= 65) {
+        r = buf.slice(0, 32);
+        s = buf.slice(32, 64);
+        v = (0, bytes_1.bufferToInt)(buf.slice(64));
+    }
+    else if (buf.length === 64) {
+        // Compact Signature Representation (https://eips.ethereum.org/EIPS/eip-2098)
+        r = buf.slice(0, 32);
+        s = buf.slice(32, 64);
+        v = (0, bytes_1.bufferToInt)(buf.slice(32, 33)) >> 7;
+        s[0] &= 0x7f;
+    }
+    else {
+        throw new Error('Invalid signature length');
+    }
+    // support both versions of `eth_sign` responses
+    if (v < 27) {
+        v += 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) {
+    const SECP256K1_N_DIV_2 = new externals_1.BN('7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a0', 16);
+    const SECP256K1_N = new externals_1.BN('fffffffffffffffffffffffffffffffebaaedce6af48a03bbfd25e8cd0364141', 16);
+    if (r.length !== 32 || s.length !== 32) {
+        return false;
+    }
+    if (!isValidSigRecovery(calculateSigRecovery(v, chainId))) {
+        return false;
+    }
+    const rBN = new externals_1.BN(r);
+    const sBN = new externals_1.BN(s);
+    if (rBN.isZero() || rBN.gt(SECP256K1_N) || sBN.isZero() || sBN.gt(SECP256K1_N)) {
+        return false;
+    }
+    if (homesteadOrLater && sBN.cmp(SECP256K1_N_DIV_2) === 1) {
+        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_1.assertIsBuffer)(message);
+    const prefix = Buffer.from(`\u0019Ethereum Signed Message:\n${message.length}`, 'utf-8');
+    return (0, hash_1.keccak)(Buffer.concat([prefix, message]));
+};
+exports.hashPersonalMessage = hashPersonalMessage;
+//# sourceMappingURL=signature.js.map

package/dist/signature.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,62 @@
+/// <reference types="bn.js" />
+/// <reference types="node" />
+import { BN } from './externals';
+import { Address } from './address';
+import { ToBufferInputTypes } from './bytes';
+export declare type BNLike = BN | PrefixedHexString | number | Buffer;
+export declare type BufferLike = Buffer | Uint8Array | number[] | number | BN | TransformableToBuffer | PrefixedHexString;
+export declare type PrefixedHexString = string;
+/**
+ * A type that represents an Address-like value.
+ * To convert to address, use `new Address(toBuffer(value))`
+ */
+export declare type AddressLike = Address | Buffer | PrefixedHexString;
+export interface TransformableToArray {
+    toArray(): Uint8Array;
+    toBuffer?(): Buffer;
+}
+export interface TransformableToBuffer {
+    toBuffer(): Buffer;
+    toArray?(): Uint8Array;
+}
+export declare type NestedUint8Array = Array<Uint8Array | NestedUint8Array>;
+export declare type NestedBufferArray = Array<Buffer | NestedBufferArray>;
+/**
+ * Convert BN to 0x-prefixed hex string.
+ */
+export declare function bnToHex(value: BN): PrefixedHexString;
+/**
+ * Convert value from BN to an unpadded Buffer
+ * (useful for RLP transport)
+ * @param value value to convert
+ */
+export declare function bnToUnpaddedBuffer(value: BN): Buffer;
+/**
+ * Deprecated alias for {@link bnToUnpaddedBuffer}
+ * @deprecated
+ */
+export declare function bnToRlp(value: BN): Buffer;
+/**
+ * Type output options
+ */
+export declare enum TypeOutput {
+    Number = 0,
+    BN = 1,
+    Buffer = 2,
+    PrefixedHexString = 3
+}
+export declare type TypeOutputReturnType = {
+    [TypeOutput.Number]: number;
+    [TypeOutput.BN]: BN;
+    [TypeOutput.Buffer]: Buffer;
+    [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: ToBufferInputTypes, outputType: T): TypeOutputReturnType[T];

package/dist/types.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toType = exports.TypeOutput = exports.bnToRlp = exports.bnToUnpaddedBuffer = exports.bnToHex = void 0;
+const externals_1 = require("./externals");
+const internal_1 = require("./internal");
+const bytes_1 = require("./bytes");
+/**
+ * Convert BN to 0x-prefixed hex string.
+ */
+function bnToHex(value) {
+    return `0x${value.toString(16)}`;
+}
+exports.bnToHex = bnToHex;
+/**
+ * Convert value from BN to an unpadded Buffer
+ * (useful for RLP transport)
+ * @param value value to convert
+ */
+function bnToUnpaddedBuffer(value) {
+    // Using `bn.toArrayLike(Buffer)` instead of `bn.toBuffer()`
+    // for compatibility with browserify and similar tools
+    return (0, bytes_1.unpadBuffer)(value.toArrayLike(Buffer));
+}
+exports.bnToUnpaddedBuffer = bnToUnpaddedBuffer;
+/**
+ * Deprecated alias for {@link bnToUnpaddedBuffer}
+ * @deprecated
+ */
+function bnToRlp(value) {
+    return bnToUnpaddedBuffer(value);
+}
+exports.bnToRlp = bnToRlp;
+/**
+ * Type output options
+ */
+var TypeOutput;
+(function (TypeOutput) {
+    TypeOutput[TypeOutput["Number"] = 0] = "Number";
+    TypeOutput[TypeOutput["BN"] = 1] = "BN";
+    TypeOutput[TypeOutput["Buffer"] = 2] = "Buffer";
+    TypeOutput[TypeOutput["PrefixedHexString"] = 3] = "PrefixedHexString";
+})(TypeOutput = exports.TypeOutput || (exports.TypeOutput = {}));
+function toType(input, outputType) {
+    if (input === null) {
+        return null;
+    }
+    if (input === undefined) {
+        return undefined;
+    }
+    if (typeof input === 'string' && !(0, internal_1.isHexString)(input)) {
+        throw new Error(`A string must be provided with a 0x-prefix, given: ${input}`);
+    }
+    else if (typeof input === 'number' && !Number.isSafeInteger(input)) {
+        throw new Error('The provided number is greater than MAX_SAFE_INTEGER (please use an alternative input type)');
+    }
+    const output = (0, bytes_1.toBuffer)(input);
+    if (outputType === TypeOutput.Buffer) {
+        return output;
+    }
+    else if (outputType === TypeOutput.BN) {
+        return new externals_1.BN(output);
+    }
+    else if (outputType === TypeOutput.Number) {
+        const bn = new externals_1.BN(output);
+        const max = new externals_1.BN(Number.MAX_SAFE_INTEGER.toString());
+        if (bn.gt(max)) {
+            throw new Error('The provided number is greater than MAX_SAFE_INTEGER (please use an alternative output type)');
+        }
+        return bn.toNumber();
+    }
+    else {
+        // outputType === TypeOutput.PrefixedHexString
+        return `0x${output.toString('hex')}`;
+    }
+}
+exports.toType = toType;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAAA,2CAAgC;AAChC,yCAAwC;AAExC,mCAAmE;AAiDnE;;GAEG;AACH,SAAgB,OAAO,CAAC,KAAS;IAC/B,OAAO,KAAK,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAA;AAClC,CAAC;AAFD,0BAEC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,KAAS;IAC1C,4DAA4D;IAC5D,sDAAsD;IACtD,OAAO,IAAA,mBAAW,EAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAA;AAC/C,CAAC;AAJD,gDAIC;AAED;;;GAGG;AACH,SAAgB,OAAO,CAAC,KAAS;IAC/B,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAA;AAClC,CAAC;AAFD,0BAEC;AAED;;GAEG;AACH,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,+CAAM,CAAA;IACN,uCAAE,CAAA;IACF,+CAAM,CAAA;IACN,qEAAiB,CAAA;AACnB,CAAC,EALW,UAAU,GAAV,kBAAU,KAAV,kBAAU,QAKrB;AAqBD,SAAgB,MAAM,CACpB,KAAyB,EACzB,UAAa;IAEb,IAAI,KAAK,KAAK,IAAI,EAAE;QAClB,OAAO,IAAI,CAAA;KACZ;IACD,IAAI,KAAK,KAAK,SAAS,EAAE;QACvB,OAAO,SAAS,CAAA;KACjB;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,IAAA,sBAAW,EAAC,KAAK,CAAC,EAAE;QACpD,MAAM,IAAI,KAAK,CAAC,sDAAsD,KAAK,EAAE,CAAC,CAAA;KAC/E;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE;QACpE,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAA;KACF;IAED,MAAM,MAAM,GAAG,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAA;IAE9B,IAAI,UAAU,KAAK,UAAU,CAAC,MAAM,EAAE;QACpC,OAAO,MAAiC,CAAA;KACzC;SAAM,IAAI,UAAU,KAAK,UAAU,CAAC,EAAE,EAAE;QACvC,OAAO,IAAI,cAAE,CAAC,MAAM,CAA4B,CAAA;KACjD;SAAM,IAAI,UAAU,KAAK,UAAU,CAAC,MAAM,EAAE;QAC3C,MAAM,EAAE,GAAG,IAAI,cAAE,CAAC,MAAM,CAAC,CAAA;QACzB,MAAM,GAAG,GAAG,IAAI,cAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAA;QACtD,IAAI,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE;YACd,MAAM,IAAI,KAAK,CACb,8FAA8F,CAC/F,CAAA;SACF;QACD,OAAO,EAAE,CAAC,QAAQ,EAA6B,CAAA;KAChD;SAAM;QACL,8CAA8C;QAC9C,OAAO,KAAK,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAA6B,CAAA;KAChE;AACH,CAAC;AAtCD,wBAsCC"}

package/dist.browser/account.d.ts

@@ -0,0 +1,120 @@
+/// <reference types="bn.js" />
+/// <reference types="node" />
+import { BN } from './externals';
+import { BNLike, BufferLike } from './types';
+export interface AccountData {
+    nonce?: BNLike;
+    balance?: BNLike;
+    stateRoot?: BufferLike;
+    codeHash?: BufferLike;
+}
+export declare class Account {
+    nonce: BN;
+    balance: BN;
+    stateRoot: Buffer;
+    codeHash: Buffer;
+    static fromAccountData(accountData: AccountData): Account;
+    static fromRlpSerializedAccount(serialized: Buffer): Account;
+    static fromValuesArray(values: Buffer[]): Account;
+    /**
+     * This constructor assigns and validates the values.
+     * Use the static factory methods to assist in creating an Account from varying data types.
+     */
+    constructor(nonce?: BN, balance?: BN, stateRoot?: Buffer, codeHash?: Buffer);
+    private _validate;
+    /**
+     * Returns a Buffer Array of the raw Buffers for the account, in order.
+     */
+    raw(): Buffer[];
+    /**
+     * Returns the RLP serialization of the account as a `Buffer`.
+     */
+    serialize(): Buffer;
+    /**
+     * Returns a `Boolean` determining if the account is a contract.
+     */
+    isContract(): boolean;
+    /**
+     * Returns a `Boolean` determining if the account is empty complying to the definition of
+     * account emptiness in [EIP-161](https://eips.ethereum.org/EIPS/eip-161):
+     * "An account is considered empty when it has no code and zero nonce and zero balance."
+     */
+    isEmpty(): boolean;
+}
+/**
+ * Checks if the address is a valid. Accepts checksummed addresses too.
+ */
+export declare const isValidAddress: (hexAddress: string) => boolean;
+/**
+ * Returns a checksummed address.
+ *
+ * If an eip1191ChainId is provided, the chainId will be included in the checksum calculation. This
+ * has the effect of checksummed addresses for one chain having invalid checksums for others.
+ * For more details see [EIP-1191](https://eips.ethereum.org/EIPS/eip-1191).
+ *
+ * WARNING: Checksums with and without the chainId will differ and the EIP-1191 checksum is not
+ * backwards compatible to the original widely adopted checksum format standard introduced in
+ * [EIP-55](https://eips.ethereum.org/EIPS/eip-55), so this will break in existing applications.
+ * Usage of this EIP is therefore discouraged unless you have a very targeted use case.
+ */
+export declare const toChecksumAddress: (hexAddress: string, eip1191ChainId?: BNLike) => string;
+/**
+ * Checks if the address is a valid checksummed address.
+ *
+ * See toChecksumAddress' documentation for details about the eip1191ChainId parameter.
+ */
+export declare const isValidChecksumAddress: (hexAddress: string, eip1191ChainId?: BNLike) => boolean;
+/**
+ * Generates an address of a newly created contract.
+ * @param from The address which is creating this new address
+ * @param nonce The nonce of the from account
+ */
+export declare const generateAddress: (from: Buffer, nonce: Buffer) => Buffer;
+/**
+ * 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 declare const generateAddress2: (from: Buffer, salt: Buffer, initCode: Buffer) => Buffer;
+/**
+ * Checks if the private key satisfies the rules of the curve secp256k1.
+ */
+export declare const isValidPrivate: (privateKey: Buffer) => boolean;
+/**
+ * Checks if the public key satisfies the rules of the curve secp256k1
+ * and the requirements of Ethereum.
+ * @param publicKey The two points of an uncompressed key, unless sanitize is enabled
+ * @param sanitize Accept public keys in other formats
+ */
+export declare const isValidPublic: (publicKey: Buffer, sanitize?: boolean) => boolean;
+/**
+ * Returns the ethereum address of a given public key.
+ * Accepts "Ethereum public keys" and SEC1 encoded keys.
+ * @param pubKey The two points of an uncompressed key, unless sanitize is enabled
+ * @param sanitize Accept public keys in other formats
+ */
+export declare const pubToAddress: (pubKey: Buffer, sanitize?: boolean) => Buffer;
+export declare const publicToAddress: (pubKey: Buffer, sanitize?: boolean) => Buffer;
+/**
+ * Returns the ethereum public key of a given private key.
+ * @param privateKey A private key must be 256 bits wide
+ */
+export declare const privateToPublic: (privateKey: Buffer) => Buffer;
+/**
+ * Returns the ethereum address of a given private key.
+ * @param privateKey A private key must be 256 bits wide
+ */
+export declare const privateToAddress: (privateKey: Buffer) => Buffer;
+/**
+ * Converts a public key to the Ethereum format.
+ */
+export declare const importPublic: (publicKey: Buffer) => Buffer;
+/**
+ * Returns the zero address.
+ */
+export declare const zeroAddress: () => string;
+/**
+ * Checks if a given address is the zero address.
+ */
+export declare const isZeroAddress: (hexAddress: string) => boolean;