quantumcoin 6.14.5 → 7.0.2

package/src.ts/providers/network.ts

@@ -1,327 +0,0 @@
-/**
- *  A **Network** encapsulates the various properties required to
- *  interact with a specific chain.
- *
- *  @_subsection: api/providers:Networks  [networks]
- */
-
-import { accessListify } from "../transaction/index.js";
-import { getBigInt, assertArgument } from "../utils/index.js";
-
-import {
-    EnsPlugin, GasCostPlugin
-} from "./plugins-network.js";
-
-import type { BigNumberish } from "../utils/index.js";
-import type { TransactionLike } from "../transaction/index.js";
-
-import type { NetworkPlugin } from "./plugins-network.js";
-
-
-/**
- *  A Networkish can be used to allude to a Network, by specifing:
- *  - a [[Network]] object
- *  - a well-known (or registered) network name
- *  - a well-known (or registered) chain ID
- *  - an object with sufficient details to describe a network
- */
-export type Networkish = Network | number | bigint | string | {
-    name?: string,
-    chainId?: number,
-    //layerOneConnection?: Provider,
-    ensAddress?: string,
-    ensNetwork?: number
-};
-
-
-
-
-/* * * *
-// Networks which operation against an L2 can use this plugin to
-// specify how to access L1, for the purpose of resolving ENS,
-// for example.
-export class LayerOneConnectionPlugin extends NetworkPlugin {
-    readonly provider!: Provider;
-// @TODO: Rename to ChainAccess and allow for connecting to any chain
-    constructor(provider: Provider) {
-        super("org.ethers.plugins.layer-one-connection");
-        defineProperties<LayerOneConnectionPlugin>(this, { provider });
-    }
-
-    clone(): LayerOneConnectionPlugin {
-        return new LayerOneConnectionPlugin(this.provider);
-    }
-}
-*/
-
-
-const Networks: Map<string | bigint, () => Network> = new Map();
-
-
-/**
- *  A **Network** provides access to a chain's properties and allows
- *  for plug-ins to extend functionality.
- */
-export class Network {
-    #name: string;
-    #chainId: bigint;
-
-    #plugins: Map<string, NetworkPlugin>;
-
-    /**
-     *  Creates a new **Network** for %%name%% and %%chainId%%.
-     */
-    constructor(name: string, chainId: BigNumberish) {
-        this.#name = name;
-        this.#chainId = getBigInt(chainId);
-        this.#plugins = new Map();
-    }
-
-    /**
-     *  Returns a JSON-compatible representation of a Network.
-     */
-    toJSON(): any {
-        return { name: this.name, chainId: String(this.chainId) };
-    }
-
-    /**
-     *  The network common name.
-     *
-     *  This is the canonical name, as networks migh have multiple
-     *  names.
-     */
-    get name(): string { return this.#name; }
-    set name(value: string) { this.#name =  value; }
-
-    /**
-     *  The network chain ID.
-     */
-    get chainId(): bigint { return this.#chainId; }
-    set chainId(value: BigNumberish) { this.#chainId = getBigInt(value, "chainId"); }
-
-    /**
-     *  Returns true if %%other%% matches this network. Any chain ID
-     *  must match, and if no chain ID is present, the name must match.
-     *
-     *  This method does not currently check for additional properties,
-     *  such as ENS address or plug-in compatibility.
-     */
-    matches(other: Networkish): boolean {
-        if (other == null) { return false; }
-
-        if (typeof(other) === "string") {
-            try {
-                return (this.chainId === getBigInt(other));
-            } catch (error) { }
-            return (this.name === other);
-        }
-
-        if (typeof(other) === "number" || typeof(other) === "bigint") {
-            try {
-                return (this.chainId === getBigInt(other));
-            } catch (error) { }
-            return false;
-        }
-
-        if (typeof(other) === "object") {
-            if (other.chainId != null) {
-                try {
-                    return (this.chainId === getBigInt(other.chainId));
-                } catch (error) { }
-                return false;
-            }
-            if (other.name != null) {
-                return (this.name === other.name);
-            }
-            return false;
-        }
-
-        return false;
-    }
-
-    /**
-     *  Returns the list of plugins currently attached to this Network.
-     */
-    get plugins(): Array<NetworkPlugin> {
-        return Array.from(this.#plugins.values());
-    }
-
-    /**
-     *  Attach a new %%plugin%% to this Network. The network name
-     *  must be unique, excluding any fragment.
-     */
-    attachPlugin(plugin: NetworkPlugin): this {
-        if (this.#plugins.get(plugin.name)) {
-            throw new Error(`cannot replace existing plugin: ${ plugin.name } `);
-        }
-        this.#plugins.set(plugin.name, plugin.clone());
-        return this;
-    }
-
-    /**
-     *  Return the plugin, if any, matching %%name%% exactly. Plugins
-     *  with fragments will not be returned unless %%name%% includes
-     *  a fragment.
-     */
-    getPlugin<T extends NetworkPlugin = NetworkPlugin>(name: string): null | T {
-        return <T>(this.#plugins.get(name)) || null;
-    }
-
-    /**
-     *  Gets a list of all plugins that match %%name%%, with otr without
-     *  a fragment.
-     */
-    getPlugins<T extends NetworkPlugin = NetworkPlugin>(basename: string): Array<T> {
-        return <Array<T>>(this.plugins.filter((p) => (p.name.split("#")[0] === basename)));
-    }
-
-    /**
-     *  Create a copy of this Network.
-     */
-    clone(): Network {
-        const clone = new Network(this.name, this.chainId);
-        this.plugins.forEach((plugin) => {
-            clone.attachPlugin(plugin.clone());
-        });
-        return clone;
-    }
-
-    /**
-     *  Compute the intrinsic gas required for a transaction.
-     *
-     *  A GasCostPlugin can be attached to override the default
-     *  values.
-     */
-    computeIntrinsicGas(tx: TransactionLike): number {
-        const costs = this.getPlugin<GasCostPlugin>("org.ethers.plugins.network.GasCost") || (new GasCostPlugin());
-
-        let gas = costs.txBase;
-        if (tx.to == null) { gas += costs.txCreate; }
-        if (tx.data) {
-            for (let i = 2; i < tx.data.length; i += 2) {
-                if (tx.data.substring(i, i + 2) === "00") {
-                    gas += costs.txDataZero;
-                } else {
-                    gas += costs.txDataNonzero;
-                }
-            }
-        }
-
-        if (tx.accessList) {
-            const accessList = accessListify(tx.accessList);
-            for (const addr in accessList) {
-                gas += costs.txAccessListAddress + costs.txAccessListStorageKey * accessList[addr].storageKeys.length;
-            }
-        }
-
-        return gas;
-    }
-
-    /**
-     *  Returns a new Network for the %%network%% name or chainId.
-     */
-    static from(network?: Networkish): Network {
-        injectCommonNetworks();
-
-        // Default network
-        if (network == null) { return Network.from("mainnet"); }
-
-        // Canonical name or chain ID
-        if (typeof(network) === "number") { network = BigInt(network); }
-        if (typeof(network) === "string" || typeof(network) === "bigint") {
-            const networkFunc = Networks.get(network);
-            if (networkFunc) { return networkFunc(); }
-            if (typeof(network) === "bigint") {
-                return new Network("unknown", network);
-            }
-
-            assertArgument(false, "unknown network", "network", network);
-        }
-
-        // Clonable with network-like abilities
-        if (typeof((<Network>network).clone) === "function") {
-            const clone = (<Network>network).clone();
-            //if (typeof(network.name) !== "string" || typeof(network.chainId) !== "number") {
-            //}
-            return clone;
-        }
-
-        // Networkish
-        if (typeof(network) === "object") {
-            assertArgument(typeof(network.name) === "string" && typeof(network.chainId) === "number",
-                "invalid network object name or chainId", "network", network);
-
-            const custom = new Network(<string>(network.name), <number>(network.chainId));
-
-            if ((<any>network).ensAddress || (<any>network).ensNetwork != null) {
-                custom.attachPlugin(new EnsPlugin((<any>network).ensAddress, (<any>network).ensNetwork));
-            }
-
-            //if ((<any>network).layerOneConnection) {
-            //    custom.attachPlugin(new LayerOneConnectionPlugin((<any>network).layerOneConnection));
-            //}
-
-            return custom;
-        }
-
-        assertArgument(false, "invalid network", "network", network);
-    }
-
-    /**
-     *  Register %%nameOrChainId%% with a function which returns
-     *  an instance of a Network representing that chain.
-     */
-    static register(nameOrChainId: string | number | bigint, networkFunc: () => Network): void {
-        if (typeof(nameOrChainId) === "number") { nameOrChainId = BigInt(nameOrChainId); }
-        const existing = Networks.get(nameOrChainId);
-        if (existing) {
-            assertArgument(false, `conflicting network for ${ JSON.stringify(existing.name) }`, "nameOrChainId", nameOrChainId);
-        }
-        Networks.set(nameOrChainId, networkFunc);
-    }
-}
-
-
-type Options = {
-    ensNetwork?: number;
-    altNames?: Array<string>;
-    plugins?: Array<NetworkPlugin>;
-};
-
-let injected = false;
-function injectCommonNetworks(): void {
-    if (injected) { return; }
-    injected = true;
-
-    /// Register popular Ethereum networks
-    function registerEth(name: string, chainId: number, options: Options): void {
-        const func = function() {
-            const network = new Network(name, chainId);
-
-            // We use 0 to disable ENS
-            if (options.ensNetwork != null) {
-                network.attachPlugin(new EnsPlugin(null, options.ensNetwork));
-            }
-
-            network.attachPlugin(new GasCostPlugin());
-
-            (options.plugins || []).forEach((plugin) => {
-                network.attachPlugin(plugin);
-            });
-
-            return network;
-        };
-
-        // Register the network by name and chain ID
-        Network.register(name, func);
-        Network.register(chainId, func);
-
-        if (options.altNames) {
-            options.altNames.forEach((name) => {
-                Network.register(name, func);
-            });
-        }
-    }
-
-    registerEth("mainnet", 123123, { ensNetwork: 1, altNames: [ "quantumcoin" ] });
-}

package/src.ts/providers/pagination.ts

@@ -1,8 +0,0 @@
-export interface PaginationResult<R> extends Array<R> {
-    next(): Promise<PaginationResult<R>>;
-
-    // The total number of results available or null if unknown
-    totalResults: null | number;
-
-    done: boolean;
-}

package/src.ts/providers/plugin-fallback.ts

@@ -1,35 +0,0 @@
-
-import { AbstractProviderPlugin } from "./abstract-provider.js";
-import { defineProperties } from "../utils/index.js";
-
-import type { AbstractProvider, PerformActionRequest } from "./abstract-provider.js";
-
-
-export const PluginIdFallbackProvider = "org.ethers.plugins.provider.QualifiedPlugin";
-
-export class CheckQualifiedPlugin implements AbstractProviderPlugin {
-    declare name: string;
-
-    constructor() {
-        defineProperties<CheckQualifiedPlugin>(this, { name: PluginIdFallbackProvider });
-    }
-
-    connect(provider: AbstractProvider): CheckQualifiedPlugin {
-        return this;
-    }
-
-    // Retruns true if this value should be considered qualified for
-    // inclusion in the quorum.
-    isQualified(action: PerformActionRequest, result: any): boolean {
-        return true;
-    }
-}
-
-export class PossiblyPrunedTransactionPlugin extends CheckQualifiedPlugin {
-    isQualified(action: PerformActionRequest, result: any): boolean {
-        if (action.method === "getTransaction" || action.method === "getTransactionReceipt") {
-            if (result == null) { return false; }
-        }
-        return super.isQualified(action, result);
-    }
-}

package/src.ts/providers/plugins-network.ts

@@ -1,281 +0,0 @@
-import { defineProperties } from "../utils/properties.js";
-
-import { assertArgument } from "../utils/index.js";
-
-import type { FeeData, Provider } from "./provider.js";
-import type { FetchRequest } from "../utils/fetch.js";
-
-
-const EnsAddress = "0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e";
-
-/**
- *  A **NetworkPlugin** provides additional functionality on a [[Network]].
- */
-export class NetworkPlugin {
-    /**
-     *  The name of the plugin.
-     *
-     *  It is recommended to use reverse-domain-notation, which permits
-     *  unique names with a known authority as well as hierarchal entries.
-     */
-    readonly name!: string;
-
-    /**
-     *  Creates a new **NetworkPlugin**.
-     */
-    constructor(name: string) {
-        defineProperties<NetworkPlugin>(this, { name });
-    }
-
-    /**
-     *  Creates a copy of this plugin.
-     */
-    clone(): NetworkPlugin {
-        return new NetworkPlugin(this.name);
-    }
-
-//    validate(network: Network): NetworkPlugin {
-//        return this;
-//    }
-}
-
-
-/**
- *  The gas cost parameters for a [[GasCostPlugin]].
- */
-export type GasCostParameters = {
-    /**
-     *  The transactions base fee.
-     */
-    txBase?: number;
-
-    /**
-     *  The fee for creating a new account.
-     */
-    txCreate?: number;
-
-    /**
-     *  The fee per zero-byte in the data.
-     */
-    txDataZero?: number;
-
-    /**
-     *  The fee per non-zero-byte in the data.
-     */
-    txDataNonzero?: number;
-
-    /**
-     *  The fee per storage key in the [[link-eip-2930]] access list.
-     */
-    txAccessListStorageKey?: number;
-
-    /**
-     *  The fee per address in the [[link-eip-2930]] access list.
-     */
-    txAccessListAddress?: number;
-};
-
-/**
- *  A **GasCostPlugin** allows a network to provide alternative values when
- *  computing the intrinsic gas required for a transaction.
- */
-export class GasCostPlugin extends NetworkPlugin implements GasCostParameters {
-    /**
-     *  The block number to treat these values as valid from.
-     *
-     *  This allows a hardfork to have updated values included as well as
-     *  mulutiple hardforks to be supported.
-     */
-    readonly effectiveBlock!: number;
-
-    /**
-     *  The transactions base fee.
-     */
-    readonly txBase!: number;
-
-    /**
-     *  The fee for creating a new account.
-     */
-    readonly txCreate!: number;
-
-    /**
-     *  The fee per zero-byte in the data.
-     */
-    readonly txDataZero!: number;
-
-    /**
-     *  The fee per non-zero-byte in the data.
-     */
-    readonly txDataNonzero!: number;
-
-    /**
-     *  The fee per storage key in the [[link-eip-2930]] access list.
-     */
-    readonly txAccessListStorageKey!: number;
-
-    /**
-     *  The fee per address in the [[link-eip-2930]] access list.
-     */
-    readonly txAccessListAddress!: number;
-
-
-    /**
-     *  Creates a new GasCostPlugin from %%effectiveBlock%% until the
-     *  latest block or another GasCostPlugin supercedes that block number,
-     *  with the associated %%costs%%.
-     */
-    constructor(effectiveBlock?: number, costs?: GasCostParameters) {
-        if (effectiveBlock == null) { effectiveBlock = 0; }
-        super(`org.ethers.network.plugins.GasCost#${ (effectiveBlock || 0) }`);
-
-        const props: Record<string, number> = { effectiveBlock };
-        function set(name: keyof GasCostParameters, nullish: number): void {
-            let value = (costs || { })[name];
-            if (value == null) { value = nullish; }
-            assertArgument(typeof(value) === "number", `invalud value for ${ name }`, "costs", costs);
-            props[name] = value;
-        }
-
-        set("txBase", 21000);
-        set("txCreate", 32000);
-        set("txDataZero", 4);
-        set("txDataNonzero", 16);
-        set("txAccessListStorageKey", 1900);
-        set("txAccessListAddress", 2400);
-
-        defineProperties<GasCostPlugin>(this, props);
-    }
-
-    clone(): GasCostPlugin {
-        return new GasCostPlugin(this.effectiveBlock, this);
-    }
-}
-
-/**
- *  An **EnsPlugin** allows a [[Network]] to specify the ENS Registry
- *  Contract address and the target network to use when using that
- *  contract.
- *
- *  Various testnets have their own instance of the contract to use, but
- *  in general, the mainnet instance supports multi-chain addresses and
- *  should be used.
- */
-export class EnsPlugin extends NetworkPlugin {
-
-    /**
-     *  The ENS Registrty Contract address.
-     */
-    readonly address!: string;
-
-    /**
-     *  The chain ID that the ENS contract lives on.
-     */
-    readonly targetNetwork!: number;
-
-    /**
-     *  Creates a new **EnsPlugin** connected to %%address%% on the
-     *  %%targetNetwork%%. The default ENS address and mainnet is used
-     *  if unspecified.
-     */
-    constructor(address?: null | string, targetNetwork?: null | number) {
-        super("org.ethers.plugins.network.Ens");
-        defineProperties<EnsPlugin>(this, {
-            address: (address || EnsAddress),
-            targetNetwork: ((targetNetwork == null) ? 1: targetNetwork)
-        });
-    }
-
-    clone(): EnsPlugin {
-        return new EnsPlugin(this.address, this.targetNetwork);
-    }
-}
-
-/**
- *  A **FeeDataNetworkPlugin** allows a network to provide and alternate
- *  means to specify its fee data.
- *
- *  For example, a network which does not support [[link-eip-1559]] may
- *  choose to use a Gas Station site to approximate the gas price.
- */
-export class FeeDataNetworkPlugin extends NetworkPlugin {
-    readonly #feeDataFunc: (provider: Provider) => Promise<FeeData>;
-
-    /**
-     *  The fee data function provided to the constructor.
-     */
-    get feeDataFunc(): (provider: Provider) => Promise<FeeData> {
-        return this.#feeDataFunc;
-    }
-
-    /**
-     *  Creates a new **FeeDataNetworkPlugin**.
-     */
-    constructor(feeDataFunc: (provider: Provider) => Promise<FeeData>) {
-        super("org.ethers.plugins.network.FeeData");
-        this.#feeDataFunc = feeDataFunc;
-    }
-
-    /**
-     *  Resolves to the fee data.
-     */
-    async getFeeData(provider: Provider): Promise<FeeData> {
-        return await this.#feeDataFunc(provider);
-    }
-
-    clone(): FeeDataNetworkPlugin {
-        return new FeeDataNetworkPlugin(this.#feeDataFunc);
-    }
-}
-
-export class FetchUrlFeeDataNetworkPlugin extends NetworkPlugin {
-    readonly #url: string;
-    readonly #processFunc: (f: () => Promise<FeeData>, p: Provider, r: FetchRequest) => Promise<{ gasPrice?: null | bigint, maxFeePerGas?: null | bigint, maxPriorityFeePerGas?: null | bigint }>;
-
-    /**
-     *  The URL to initialize the FetchRequest with in %%processFunc%%.
-     */
-    get url(): string { return this.#url; }
-
-    /**
-     *  The callback to use when computing the FeeData.
-     */
-    get processFunc(): (f: () => Promise<FeeData>, p: Provider, r: FetchRequest) => Promise<{ gasPrice?: null | bigint, maxFeePerGas?: null | bigint, maxPriorityFeePerGas?: null | bigint }> { return this.#processFunc; }
-
-    /**
-     *  Creates a new **FetchUrlFeeDataNetworkPlugin** which will
-     *  be used when computing the fee data for the network.
-     */
-    constructor(url: string, processFunc: (f: () => Promise<FeeData>, p: Provider, r: FetchRequest) => Promise<{ gasPrice?: null | bigint, maxFeePerGas?: null | bigint, maxPriorityFeePerGas?: null | bigint }>) {
-        super("org.ethers.plugins.network.FetchUrlFeeDataPlugin");
-        this.#url = url;
-        this.#processFunc = processFunc;
-    }
-
-    // We are immutable, so we can serve as our own clone
-    clone(): FetchUrlFeeDataNetworkPlugin { return this; }
-}
-
-/*
-export class CustomBlockNetworkPlugin extends NetworkPlugin {
-    readonly #blockFunc: (provider: Provider, block: BlockParams<string>) => Block<string>;
-    readonly #blockWithTxsFunc: (provider: Provider, block: BlockParams<TransactionResponseParams>) => Block<TransactionResponse>;
-
-    constructor(blockFunc: (provider: Provider, block: BlockParams<string>) => Block<string>, blockWithTxsFunc: (provider: Provider, block: BlockParams<TransactionResponseParams>) => Block<TransactionResponse>) {
-        super("org.ethers.network-plugins.custom-block");
-        this.#blockFunc = blockFunc;
-        this.#blockWithTxsFunc = blockWithTxsFunc;
-    }
-
-    async getBlock(provider: Provider, block: BlockParams<string>): Promise<Block<string>> {
-        return await this.#blockFunc(provider, block);
-    }
-
-    async getBlockions(provider: Provider, block: BlockParams<TransactionResponseParams>): Promise<Block<TransactionResponse>> {
-        return await this.#blockWithTxsFunc(provider, block);
-    }
-
-    clone(): CustomBlockNetworkPlugin {
-        return new CustomBlockNetworkPlugin(this.#blockFunc, this.#blockWithTxsFunc);
-    }
-}
-*/