eteres 0.0.1-security → 6.7.1

package/src.ts/ethers.ts

@@ -0,0 +1,210 @@
+
+
+/////////////////////////////
+//
+
+export { version } from "./_version.js";
+
+export {
+    decodeBytes32String, encodeBytes32String,
+
+    AbiCoder,
+    ConstructorFragment, ErrorFragment, EventFragment, Fragment, FallbackFragment, FunctionFragment, NamedFragment, ParamType, StructFragment,
+
+    checkResultErrors, ErrorDescription, Indexed, Interface, LogDescription, Result, TransactionDescription,
+    Typed,
+} from "./abi/index.js";
+
+export {
+    getAddress, getIcapAddress,
+    getCreateAddress, getCreate2Address,
+    isAddressable, isAddress, resolveAddress
+} from "./address/index.js";
+
+export {
+    ZeroAddress,
+    WeiPerEther, MaxUint256, MinInt256, MaxInt256, N,
+    ZeroHash,
+    EtherSymbol, MessagePrefix
+} from "./constants/index.js";
+
+export {
+    BaseContract, Contract,
+    ContractFactory,
+    ContractEventPayload, ContractTransactionReceipt, ContractTransactionResponse, ContractUnknownEventPayload, EventLog, UndecodedEventLog
+} from "./contract/index.js";
+
+export {
+    computeHmac,
+    randomBytes,
+    keccak256,
+    ripemd160,
+    sha256, sha512,
+    pbkdf2,
+    scrypt, scryptSync,
+    lock,
+    Signature, SigningKey
+} from "./crypto/index.js";
+
+export {
+    id,
+    ensNormalize, isValidName, namehash, dnsEncode,
+    hashMessage, verifyMessage,
+    solidityPacked, solidityPackedKeccak256, solidityPackedSha256,
+    TypedDataEncoder,
+    verifyTypedData
+} from "./hash/index.js";
+
+export {
+    getDefaultProvider,
+
+    Block, FeeData, Log, TransactionReceipt, TransactionResponse,
+
+    AbstractSigner, NonceManager, VoidSigner,
+
+    AbstractProvider,
+
+    FallbackProvider,
+    JsonRpcApiProvider, JsonRpcProvider, JsonRpcSigner,
+
+    BrowserProvider,
+
+    AlchemyProvider, AnkrProvider, CloudflareProvider, EtherscanProvider,
+    InfuraProvider, InfuraWebSocketProvider, PocketProvider, QuickNodeProvider,
+
+    IpcSocketProvider, SocketProvider, WebSocketProvider,
+
+    EnsResolver,
+    Network,
+
+    EnsPlugin, EtherscanPlugin,
+    FeeDataNetworkPlugin, FetchUrlFeeDataNetworkPlugin,
+    GasCostPlugin, NetworkPlugin, MulticoinProviderPlugin,
+
+    SocketBlockSubscriber, SocketEventSubscriber, SocketPendingSubscriber,
+    SocketSubscriber, UnmanagedSubscriber,
+
+    copyRequest, showThrottleMessage
+} from "./providers/index.js";
+
+export {
+    accessListify,
+    computeAddress, recoverAddress,
+    Transaction
+} from "./transaction/index.js";
+
+export {
+    decodeBase58, encodeBase58,
+    decodeBase64, encodeBase64,
+    concat, dataLength, dataSlice, getBytes, getBytesCopy, hexlify,
+    isHexString, isBytesLike, stripZerosLeft, zeroPadBytes, zeroPadValue,
+    defineProperties, resolveProperties,
+    assert, assertArgument, assertArgumentCount, assertNormalize, assertPrivate,
+    makeError,
+    isCallException, isError,
+    EventPayload,
+    FetchRequest, FetchResponse, FetchCancelSignal,
+    FixedNumber,
+    getBigInt, getNumber, getUint, toBeArray, toBigInt, toBeHex, toNumber, toQuantity,
+    fromTwos, toTwos, mask,
+    formatEther, parseEther, formatUnits, parseUnits,
+    toUtf8Bytes, toUtf8CodePoints, toUtf8String,
+    Utf8ErrorFuncs,
+    decodeRlp, encodeRlp,
+    uuidV4,
+} from "./utils/index.js";
+
+export {
+    Mnemonic,
+    BaseWallet, HDNodeWallet, HDNodeVoidWallet,
+    Wallet,
+
+    defaultPath,
+
+    getAccountPath, getIndexedAccountPath,
+    isCrowdsaleJson, isKeystoreJson,
+
+    decryptCrowdsaleJson, decryptKeystoreJsonSync, decryptKeystoreJson,
+    encryptKeystoreJson, encryptKeystoreJsonSync,
+} from "./wallet/index.js";
+
+export {
+    Wordlist, LangEn, WordlistOwl, WordlistOwlA, wordlists
+} from "./wordlists/index.js";
+
+
+
+/////////////////////////////
+// Types
+
+export type {
+    JsonFragment, JsonFragmentType,
+    FormatType, FragmentType,
+    InterfaceAbi,
+    ParamTypeWalkFunc, ParamTypeWalkAsyncFunc
+} from "./abi/index.js";
+
+export type {
+    Addressable, AddressLike, NameResolver
+} from "./address/index.js";
+
+export type {
+    ConstantContractMethod, ContractEvent, ContractEventArgs, ContractEventName,
+    ContractInterface, ContractMethod, ContractMethodArgs, ContractTransaction,
+    DeferredTopicFilter, Overrides,
+    BaseContractMethod, ContractDeployTransaction, PostfixOverrides,
+    WrappedFallback
+} from "./contract/index.js";
+
+export type { ProgressCallback, SignatureLike } from "./crypto/index.js";
+
+export type { TypedDataDomain, TypedDataField } from "./hash/index.js";
+
+export type {
+    Provider, Signer,
+
+    AbstractProviderOptions, FallbackProviderOptions,
+
+    AbstractProviderPlugin, BlockParams, BlockTag, ContractRunner, DebugEventBrowserProvider,
+    Eip1193Provider, EventFilter, Filter, FilterByBlockHash, GasCostParameters,
+    JsonRpcApiProviderOptions, JsonRpcError, JsonRpcPayload, JsonRpcResult,
+    JsonRpcTransactionRequest, LogParams, MinedBlock, MinedTransactionResponse, Networkish,
+    OrphanFilter, PerformActionFilter, PerformActionRequest, PerformActionTransaction,
+    PreparedTransactionRequest, ProviderEvent, Subscriber, Subscription, TopicFilter,
+    TransactionReceiptParams, TransactionRequest, TransactionResponseParams,
+    WebSocketCreator, WebSocketLike
+} from "./providers/index.js";
+
+export type {
+    AccessList, AccessListish, AccessListEntry,
+    TransactionLike
+} from "./transaction/index.js";
+
+export type {
+    BytesLike,
+    BigNumberish, Numeric,
+    ErrorCode,
+    FixedFormat,
+    Utf8ErrorFunc, UnicodeNormalizationForm, Utf8ErrorReason,
+    RlpStructuredData,
+
+    GetUrlResponse,
+    FetchPreflightFunc, FetchProcessFunc, FetchRetryFunc,
+    FetchGatewayFunc, FetchGetUrlFunc,
+
+    EthersError, UnknownError, NotImplementedError, UnsupportedOperationError, NetworkError,
+    ServerError, TimeoutError, BadDataError, CancelledError, BufferOverrunError,
+    NumericFaultError, InvalidArgumentError, MissingArgumentError, UnexpectedArgumentError,
+    CallExceptionError, InsufficientFundsError, NonceExpiredError, OffchainFaultError,
+    ReplacementUnderpricedError, TransactionReplacedError, UnconfiguredNameError,
+    ActionRejectedError,
+    CodedEthersError,
+
+    CallExceptionAction, CallExceptionTransaction,
+    EventEmitterable, Listener
+} from "./utils/index.js";
+
+export type {
+    CrowdsaleAccount, KeystoreAccount, EncryptOptions
+} from "./wallet/index.js";
+

package/src.ts/hash/id.ts

@@ -0,0 +1,17 @@
+import { keccak256 } from "../crypto/index.js";
+import { toUtf8Bytes } from "../utils/index.js";
+
+/**
+ *  A simple hashing function which operates on UTF-8 strings to
+ *  compute an 32-byte identifier.
+ *
+ *  This simply computes the [UTF-8 bytes](toUtf8Bytes) and computes
+ *  the [[keccak256]].
+ *
+ *  @example:
+ *    id("hello world")
+ *    //_result:
+ */
+export function id(value: string): string {
+    return keccak256(toUtf8Bytes(value));
+}

package/src.ts/hash/index.ts

@@ -0,0 +1,16 @@
+/**
+ *  Utilities for common tasks involving hashing. Also see
+ *  [cryptographic hashing](about-crypto-hashing).
+ *
+ *  @_section: api/hashing:Hashing Utilities  [about-hashing]
+ */
+
+export { id } from "./id.js"
+export { ensNormalize, isValidName, namehash, dnsEncode } from "./namehash.js";
+export { hashMessage, verifyMessage } from "./message.js";
+export {
+    solidityPacked, solidityPackedKeccak256, solidityPackedSha256
+} from "./solidity.js";
+export { TypedDataEncoder, verifyTypedData } from "./typed-data.js";
+
+export type { TypedDataDomain, TypedDataField } from "./typed-data.js";

package/src.ts/hash/message.ts

@@ -0,0 +1,51 @@
+import { keccak256 } from "../crypto/index.js";
+import { MessagePrefix } from "../constants/index.js";
+import { recoverAddress } from "../transaction/index.js";
+import { concat, toUtf8Bytes } from "../utils/index.js";
+
+import type { SignatureLike } from "../crypto/index.js";
+/**
+ *  Computes the [[link-eip-191]] personal-sign message digest to sign.
+ *
+ *  This prefixes the message with [[MessagePrefix]] and the decimal length
+ *  of %%message%% and computes the [[keccak256]] digest.
+ *
+ *  If %%message%% is a string, it is converted to its UTF-8 bytes
+ *  first. To compute the digest of a [[DataHexString]], it must be converted
+ *  to [bytes](getBytes).
+ *
+ *  @example:
+ *    hashMessage("Hello World")
+ *    //_result:
+ *
+ *    // Hashes the SIX (6) string characters, i.e.
+ *    // [ "0", "x", "4", "2", "4", "3" ]
+ *    hashMessage("0x4243")
+ *    //_result:
+ *
+ *    // Hashes the TWO (2) bytes [ 0x42, 0x43 ]...
+ *    hashMessage(getBytes("0x4243"))
+ *    //_result:
+ *
+ *    // ...which is equal to using data
+ *    hashMessage(new Uint8Array([ 0x42, 0x43 ]))
+ *    //_result:
+ *
+ */
+export function hashMessage(message: Uint8Array | string): string {
+    if (typeof(message) === "string") { message = toUtf8Bytes(message); }
+    return keccak256(concat([
+        toUtf8Bytes(MessagePrefix),
+        toUtf8Bytes(String(message.length)),
+        message
+    ]));
+}
+
+/**
+ *  Return the address of the private key that produced
+ *  the signature %%sig%% during signing for %%message%%.
+ */
+export function verifyMessage(message: Uint8Array | string, sig: SignatureLike): string {
+    const digest = hashMessage(message);
+    return recoverAddress(digest, sig);
+}

package/src.ts/hash/namehash.ts

@@ -0,0 +1,98 @@
+
+import { keccak256 } from "../crypto/index.js";
+import {
+    concat, hexlify, assertArgument, toUtf8Bytes
+} from "../utils/index.js";
+
+
+import { ens_normalize } from "@adraffy/ens-normalize";
+
+const Zeros = new Uint8Array(32);
+Zeros.fill(0);
+
+function checkComponent(comp: Uint8Array): Uint8Array {
+    assertArgument(comp.length !== 0, "invalid ENS name; empty component", "comp", comp)
+    return comp;
+}
+
+function ensNameSplit(name: string): Array<Uint8Array> {
+    const bytes = toUtf8Bytes(ensNormalize(name));
+    const comps: Array<Uint8Array> = [ ];
+
+    if (name.length === 0) { return comps; }
+
+    let last = 0;
+    for (let i = 0; i < bytes.length; i++) {
+        const d = bytes[i];
+
+        // A separator (i.e. "."); copy this component
+        if (d === 0x2e) {
+            comps.push(checkComponent(bytes.slice(last, i)));
+            last = i + 1;
+        }
+    }
+
+    // There was a stray separator at the end of the name
+    assertArgument(last < bytes.length, "invalid ENS name; empty component", "name", name);
+
+    comps.push(checkComponent(bytes.slice(last)));
+    return comps;
+}
+
+/**
+ *  Returns the ENS %%name%% normalized.
+ */
+export function ensNormalize(name: string): string {
+    try {
+        return ens_normalize(name);
+    } catch (error: any) {
+        assertArgument(false, `invalid ENS name (${ error.message })`, "name", name);
+    }
+}
+
+/**
+ *  Returns ``true`` if %%name%% is a valid ENS name.
+ */
+export function isValidName(name: string): name is string {
+    try {
+        return (ensNameSplit(name).length !== 0);
+    } catch (error) { }
+    return false;
+}
+
+/**
+ *  Returns the [[link-namehash]] for %%name%%.
+ */
+export function namehash(name: string): string {
+    assertArgument(typeof(name) === "string", "invalid ENS name; not a string", "name", name);
+
+    let result: string | Uint8Array = Zeros;
+
+    const comps = ensNameSplit(name);
+    while (comps.length) {
+        result = keccak256(concat([ result, keccak256(<Uint8Array>(comps.pop()))] ));
+    }
+
+    return hexlify(result);
+}
+
+/**
+ *  Returns the DNS encoded %%name%%.
+ *
+ *  This is used for various parts of ENS name resolution, such
+ *  as the wildcard resolution.
+ */
+export function dnsEncode(name: string): string {
+    return hexlify(concat(ensNameSplit(name).map((comp) => {
+        // DNS does not allow components over 63 bytes in length
+        if (comp.length > 63) {
+            throw new Error("invalid DNS encoded entry; length exceeds 63 bytes");
+        }
+
+        const bytes = new Uint8Array(comp.length + 1);
+        bytes.set(comp, 1);
+        bytes[0] = bytes.length - 1;
+        return bytes;
+
+    }))) + "00";
+}

package/src.ts/hash/solidity.ts

@@ -0,0 +1,117 @@
+import { getAddress } from "../address/index.js";
+import {
+    keccak256 as _keccak256, sha256 as _sha256
+} from "../crypto/index.js";
+import {
+    concat, dataLength, getBytes, hexlify, toBeArray, toTwos, toUtf8Bytes, zeroPadBytes, zeroPadValue,
+    assertArgument
+} from "../utils/index.js";
+
+
+const regexBytes = new RegExp("^bytes([0-9]+)$");
+const regexNumber = new RegExp("^(u?int)([0-9]*)$");
+const regexArray = new RegExp("^(.*)\\[([0-9]*)\\]$");
+
+
+function _pack(type: string, value: any, isArray?: boolean): Uint8Array {
+    switch(type) {
+        case "address":
+            if (isArray) { return getBytes(zeroPadValue(value, 32)); }
+            return getBytes(getAddress(value));
+        case "string":
+            return toUtf8Bytes(value);
+        case "bytes":
+            return getBytes(value);
+        case "bool":
+            value = (!!value ? "0x01": "0x00");
+            if (isArray) { return getBytes(zeroPadValue(value, 32)); }
+            return getBytes(value);
+    }
+
+    let match =  type.match(regexNumber);
+    if (match) {
+        let signed = (match[1] === "int");
+        let size = parseInt(match[2] || "256")
+
+        assertArgument((!match[2] || match[2] === String(size)) && (size % 8 === 0) && size !== 0 && size <= 256, "invalid number type", "type", type);
+
+        if (isArray) { size = 256; }
+
+        if (signed) { value = toTwos(value, size); }
+
+        return getBytes(zeroPadValue(toBeArray(value), size / 8));
+    }
+
+    match = type.match(regexBytes);
+    if (match) {
+        const size = parseInt(match[1]);
+
+        assertArgument(String(size) === match[1] && size !== 0 && size <= 32, "invalid bytes type", "type", type);
+        assertArgument(dataLength(value) === size, `invalid value for ${ type }`, "value", value);
+
+        if (isArray) { return getBytes(zeroPadBytes(value, 32)); }
+        return value;
+    }
+
+    match = type.match(regexArray);
+    if (match && Array.isArray(value)) {
+        const baseType = match[1];
+        const count = parseInt(match[2] || String(value.length));
+        assertArgument(count === value.length, `invalid array length for ${ type }`, "value", value);
+
+        const result: Array<Uint8Array> = [];
+        value.forEach(function(value) {
+            result.push(_pack(baseType, value, true));
+        });
+        return getBytes(concat(result));
+    }
+
+    assertArgument(false, "invalid type", "type", type)
+}
+
+// @TODO: Array Enum
+
+/**
+ *   Computes the [[link-solc-packed]] representation of %%values%%
+ *   respectively to their %%types%%.
+ *
+ *   @example:
+ *       addr = "0x8ba1f109551bd432803012645ac136ddd64dba72"
+ *       solidityPacked([ "address", "uint" ], [ addr, 45 ]);
+ *       //_result:
+ */
+export function solidityPacked(types: ReadonlyArray<string>, values: ReadonlyArray<any>): string {
+    assertArgument(types.length === values.length, "wrong number of values; expected ${ types.length }", "values", values);
+
+    const tight: Array<Uint8Array> = [];
+    types.forEach(function(type, index) {
+        tight.push(_pack(type, values[index]));
+    });
+    return hexlify(concat(tight));
+}
+
+/**
+ *   Computes the [[link-solc-packed]] [[keccak256]] hash of %%values%%
+ *   respectively to their %%types%%.
+ *
+ *   @example:
+ *       addr = "0x8ba1f109551bd432803012645ac136ddd64dba72"
+ *       solidityPackedKeccak256([ "address", "uint" ], [ addr, 45 ]);
+ *       //_result:
+ */
+export function solidityPackedKeccak256(types: ReadonlyArray<string>, values: ReadonlyArray<any>): string {
+    return _keccak256(solidityPacked(types, values));
+}
+
+/**
+ *   Computes the [[link-solc-packed]] [[sha256]] hash of %%values%%
+ *   respectively to their %%types%%.
+ *
+ *   @example:
+ *       addr = "0x8ba1f109551bd432803012645ac136ddd64dba72"
+ *       solidityPackedSha256([ "address", "uint" ], [ addr, 45 ]);
+ *       //_result:
+ */
+export function solidityPackedSha256(types: ReadonlyArray<string>, values: ReadonlyArray<any>): string {
+    return _sha256(solidityPacked(types, values));
+}