eteres 0.0.1-security → 6.7.1

package/lib.esm/providers/subscriber-polling.d.ts

@@ -0,0 +1,94 @@
+import type { AbstractProvider, Subscriber } from "./abstract-provider.js";
+import type { EventFilter, OrphanFilter, ProviderEvent } from "./provider.js";
+/**
+ *  Return the polling subscriber for common events.
+ *
+ *  @_docloc: api/providers/abstract-provider
+ */
+export declare function getPollingSubscriber(provider: AbstractProvider, event: ProviderEvent): Subscriber;
+/**
+ *  A **PollingBlockSubscriber** polls at a regular interval for a change
+ *  in the block number.
+ *
+ *  @_docloc: api/providers/abstract-provider
+ */
+export declare class PollingBlockSubscriber implements Subscriber {
+    #private;
+    /**
+     *  Create a new **PollingBlockSubscriber** attached to %%provider%%.
+     */
+    constructor(provider: AbstractProvider);
+    /**
+     *  The polling interval.
+     */
+    get pollingInterval(): number;
+    set pollingInterval(value: number);
+    start(): void;
+    stop(): void;
+    pause(dropWhilePaused?: boolean): void;
+    resume(): void;
+}
+/**
+ *  An **OnBlockSubscriber** can be sub-classed, with a [[_poll]]
+ *  implmentation which will be called on every new block.
+ *
+ *  @_docloc: api/providers/abstract-provider
+ */
+export declare class OnBlockSubscriber implements Subscriber {
+    #private;
+    /**
+     *  Create a new **OnBlockSubscriber** attached to %%provider%%.
+     */
+    constructor(provider: AbstractProvider);
+    /**
+     *  Called on every new block.
+     */
+    _poll(blockNumber: number, provider: AbstractProvider): Promise<void>;
+    start(): void;
+    stop(): void;
+    pause(dropWhilePaused?: boolean): void;
+    resume(): void;
+}
+/**
+ *  @_ignore:
+ *
+ *  @_docloc: api/providers/abstract-provider
+ */
+export declare class PollingOrphanSubscriber extends OnBlockSubscriber {
+    #private;
+    constructor(provider: AbstractProvider, filter: OrphanFilter);
+    _poll(blockNumber: number, provider: AbstractProvider): Promise<void>;
+}
+/**
+ *  A **PollingTransactionSubscriber** will poll for a given transaction
+ *  hash for its receipt.
+ *
+ *  @_docloc: api/providers/abstract-provider
+ */
+export declare class PollingTransactionSubscriber extends OnBlockSubscriber {
+    #private;
+    /**
+     *  Create a new **PollingTransactionSubscriber** attached to
+     *  %%provider%%, listening for %%hash%%.
+     */
+    constructor(provider: AbstractProvider, hash: string);
+    _poll(blockNumber: number, provider: AbstractProvider): Promise<void>;
+}
+/**
+ *  A **PollingEventSubscriber** will poll for a given filter for its logs.
+ *
+ *  @_docloc: api/providers/abstract-provider
+ */
+export declare class PollingEventSubscriber implements Subscriber {
+    #private;
+    /**
+     *  Create a new **PollingTransactionSubscriber** attached to
+     *  %%provider%%, listening for %%filter%%.
+     */
+    constructor(provider: AbstractProvider, filter: EventFilter);
+    start(): void;
+    stop(): void;
+    pause(dropWhilePaused?: boolean): void;
+    resume(): void;
+}
+//# sourceMappingURL=subscriber-polling.d.ts.map

package/lib.esm/providers/subscriber-polling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriber-polling.d.ts","sourceRoot":"","sources":["../../src.ts/providers/subscriber-polling.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAM9E;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,EAAE,aAAa,GAAG,UAAU,CAOjG;AAID;;;;;GAKG;AACH,qBAAa,sBAAuB,YAAW,UAAU;;IAUrD;;OAEG;gBACS,QAAQ,EAAE,gBAAgB;IAQtC;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,CAA2B;IACxD,IAAI,eAAe,CAAC,KAAK,EAAE,MAAM,EAA6B;IAqC9D,KAAK,IAAI,IAAI;IAMb,IAAI,IAAI,IAAI;IAMZ,KAAK,CAAC,eAAe,CAAC,EAAE,OAAO,GAAG,IAAI;IAKtC,MAAM,IAAI,IAAI;CAGjB;AAED;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,UAAU;;IAKhD;;OAEG;gBACS,QAAQ,EAAE,gBAAgB;IAQtC;;OAEG;IACG,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3E,KAAK,IAAI,IAAI;IAQb,IAAI,IAAI,IAAI;IAOZ,KAAK,CAAC,eAAe,CAAC,EAAE,OAAO,GAAG,IAAI;IACtC,MAAM,IAAI,IAAI;CACjB;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,iBAAiB;;gBAG9C,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,YAAY;IAKtD,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAI9E;AAED;;;;;GAKG;AACH,qBAAa,4BAA6B,SAAQ,iBAAiB;;IAG/D;;;OAGG;gBACS,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM;IAK9C,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAI9E;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,UAAU;;IAWrD;;;OAGG;gBACS,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,WAAW;IAqC3D,KAAK,IAAI,IAAI;IAYb,IAAI,IAAI,IAAI;IAOZ,KAAK,CAAC,eAAe,CAAC,EAAE,OAAO,GAAG,IAAI;IAKtC,MAAM,IAAI,IAAI;CAGjB"}

package/lib.esm/providers/subscriber-polling.js

@@ -0,0 +1,265 @@
+import { assert, isHexString } from "../utils/index.js";
+function copy(obj) {
+    return JSON.parse(JSON.stringify(obj));
+}
+/**
+ *  Return the polling subscriber for common events.
+ *
+ *  @_docloc: api/providers/abstract-provider
+ */
+export function getPollingSubscriber(provider, event) {
+    if (event === "block") {
+        return new PollingBlockSubscriber(provider);
+    }
+    if (isHexString(event, 32)) {
+        return new PollingTransactionSubscriber(provider, event);
+    }
+    assert(false, "unsupported polling event", "UNSUPPORTED_OPERATION", {
+        operation: "getPollingSubscriber", info: { event }
+    });
+}
+// @TODO: refactor this
+/**
+ *  A **PollingBlockSubscriber** polls at a regular interval for a change
+ *  in the block number.
+ *
+ *  @_docloc: api/providers/abstract-provider
+ */
+export class PollingBlockSubscriber {
+    #provider;
+    #poller;
+    #interval;
+    // The most recent block we have scanned for events. The value -2
+    // indicates we still need to fetch an initial block number
+    #blockNumber;
+    /**
+     *  Create a new **PollingBlockSubscriber** attached to %%provider%%.
+     */
+    constructor(provider) {
+        this.#provider = provider;
+        this.#poller = null;
+        this.#interval = 4000;
+        this.#blockNumber = -2;
+    }
+    /**
+     *  The polling interval.
+     */
+    get pollingInterval() { return this.#interval; }
+    set pollingInterval(value) { this.#interval = value; }
+    async #poll() {
+        try {
+            const blockNumber = await this.#provider.getBlockNumber();
+            // Bootstrap poll to setup our initial block number
+            if (this.#blockNumber === -2) {
+                this.#blockNumber = blockNumber;
+                return;
+            }
+            // @TODO: Put a cap on the maximum number of events per loop?
+            if (blockNumber !== this.#blockNumber) {
+                for (let b = this.#blockNumber + 1; b <= blockNumber; b++) {
+                    // We have been stopped
+                    if (this.#poller == null) {
+                        return;
+                    }
+                    await this.#provider.emit("block", b);
+                }
+                this.#blockNumber = blockNumber;
+            }
+        }
+        catch (error) {
+            // @TODO: Minor bump, add an "error" event to let subscribers
+            //        know things went awry.
+            //console.log(error);
+        }
+        // We have been stopped
+        if (this.#poller == null) {
+            return;
+        }
+        this.#poller = this.#provider._setTimeout(this.#poll.bind(this), this.#interval);
+    }
+    start() {
+        if (this.#poller) {
+            return;
+        }
+        this.#poller = this.#provider._setTimeout(this.#poll.bind(this), this.#interval);
+        this.#poll();
+    }
+    stop() {
+        if (!this.#poller) {
+            return;
+        }
+        this.#provider._clearTimeout(this.#poller);
+        this.#poller = null;
+    }
+    pause(dropWhilePaused) {
+        this.stop();
+        if (dropWhilePaused) {
+            this.#blockNumber = -2;
+        }
+    }
+    resume() {
+        this.start();
+    }
+}
+/**
+ *  An **OnBlockSubscriber** can be sub-classed, with a [[_poll]]
+ *  implmentation which will be called on every new block.
+ *
+ *  @_docloc: api/providers/abstract-provider
+ */
+export class OnBlockSubscriber {
+    #provider;
+    #poll;
+    #running;
+    /**
+     *  Create a new **OnBlockSubscriber** attached to %%provider%%.
+     */
+    constructor(provider) {
+        this.#provider = provider;
+        this.#running = false;
+        this.#poll = (blockNumber) => {
+            this._poll(blockNumber, this.#provider);
+        };
+    }
+    /**
+     *  Called on every new block.
+     */
+    async _poll(blockNumber, provider) {
+        throw new Error("sub-classes must override this");
+    }
+    start() {
+        if (this.#running) {
+            return;
+        }
+        this.#running = true;
+        this.#poll(-2);
+        this.#provider.on("block", this.#poll);
+    }
+    stop() {
+        if (!this.#running) {
+            return;
+        }
+        this.#running = false;
+        this.#provider.off("block", this.#poll);
+    }
+    pause(dropWhilePaused) { this.stop(); }
+    resume() { this.start(); }
+}
+/**
+ *  @_ignore:
+ *
+ *  @_docloc: api/providers/abstract-provider
+ */
+export class PollingOrphanSubscriber extends OnBlockSubscriber {
+    #filter;
+    constructor(provider, filter) {
+        super(provider);
+        this.#filter = copy(filter);
+    }
+    async _poll(blockNumber, provider) {
+        throw new Error("@TODO");
+        console.log(this.#filter);
+    }
+}
+/**
+ *  A **PollingTransactionSubscriber** will poll for a given transaction
+ *  hash for its receipt.
+ *
+ *  @_docloc: api/providers/abstract-provider
+ */
+export class PollingTransactionSubscriber extends OnBlockSubscriber {
+    #hash;
+    /**
+     *  Create a new **PollingTransactionSubscriber** attached to
+     *  %%provider%%, listening for %%hash%%.
+     */
+    constructor(provider, hash) {
+        super(provider);
+        this.#hash = hash;
+    }
+    async _poll(blockNumber, provider) {
+        const tx = await provider.getTransactionReceipt(this.#hash);
+        if (tx) {
+            provider.emit(this.#hash, tx);
+        }
+    }
+}
+/**
+ *  A **PollingEventSubscriber** will poll for a given filter for its logs.
+ *
+ *  @_docloc: api/providers/abstract-provider
+ */
+export class PollingEventSubscriber {
+    #provider;
+    #filter;
+    #poller;
+    #running;
+    // The most recent block we have scanned for events. The value -2
+    // indicates we still need to fetch an initial block number
+    #blockNumber;
+    /**
+     *  Create a new **PollingTransactionSubscriber** attached to
+     *  %%provider%%, listening for %%filter%%.
+     */
+    constructor(provider, filter) {
+        this.#provider = provider;
+        this.#filter = copy(filter);
+        this.#poller = this.#poll.bind(this);
+        this.#running = false;
+        this.#blockNumber = -2;
+    }
+    async #poll(blockNumber) {
+        // The initial block hasn't been determined yet
+        if (this.#blockNumber === -2) {
+            return;
+        }
+        const filter = copy(this.#filter);
+        filter.fromBlock = this.#blockNumber + 1;
+        filter.toBlock = blockNumber;
+        const logs = await this.#provider.getLogs(filter);
+        // No logs could just mean the node has not indexed them yet,
+        // so we keep a sliding window of 60 blocks to keep scanning
+        if (logs.length === 0) {
+            if (this.#blockNumber < blockNumber - 60) {
+                this.#blockNumber = blockNumber - 60;
+            }
+            return;
+        }
+        for (const log of logs) {
+            this.#provider.emit(this.#filter, log);
+            // Only advance the block number when logs were found to
+            // account for networks (like BNB and Polygon) which may
+            // sacrifice event consistency for block event speed
+            this.#blockNumber = log.blockNumber;
+        }
+    }
+    start() {
+        if (this.#running) {
+            return;
+        }
+        this.#running = true;
+        if (this.#blockNumber === -2) {
+            this.#provider.getBlockNumber().then((blockNumber) => {
+                this.#blockNumber = blockNumber;
+            });
+        }
+        this.#provider.on("block", this.#poller);
+    }
+    stop() {
+        if (!this.#running) {
+            return;
+        }
+        this.#running = false;
+        this.#provider.off("block", this.#poller);
+    }
+    pause(dropWhilePaused) {
+        this.stop();
+        if (dropWhilePaused) {
+            this.#blockNumber = -2;
+        }
+    }
+    resume() {
+        this.start();
+    }
+}
+//# sourceMappingURL=subscriber-polling.js.map

package/lib.esm/providers/subscriber-polling.js.map

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

package/lib.esm/providers/ws-browser.d.ts

@@ -0,0 +1,3 @@
+declare const _WebSocket: any;
+export { _WebSocket as WebSocket };
+//# sourceMappingURL=ws-browser.d.ts.map

package/lib.esm/providers/ws-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-browser.d.ts","sourceRoot":"","sources":["../../src.ts/providers/ws-browser.ts"],"names":[],"mappings":"AAQA,QAAA,MAAM,UAAU,KAAwB,CAAC;AAEzC,OAAO,EAAE,UAAU,IAAI,SAAS,EAAE,CAAC"}

package/lib.esm/providers/ws-browser.js

@@ -0,0 +1,16 @@
+function getGlobal() {
+    if (typeof self !== 'undefined') {
+        return self;
+    }
+    if (typeof window !== 'undefined') {
+        return window;
+    }
+    if (typeof global !== 'undefined') {
+        return global;
+    }
+    throw new Error('unable to locate global object');
+}
+;
+const _WebSocket = getGlobal().WebSocket;
+export { _WebSocket as WebSocket };
+//# sourceMappingURL=ws-browser.js.map

package/lib.esm/providers/ws-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-browser.js","sourceRoot":"","sources":["../../src.ts/providers/ws-browser.ts"],"names":[],"mappings":"AACA,SAAS,SAAS;IAChB,IAAI,OAAO,IAAI,KAAK,WAAW,EAAE;QAAE,OAAO,IAAI,CAAC;KAAE;IACjD,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE;QAAE,OAAO,MAAM,CAAC;KAAE;IACrD,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE;QAAE,OAAO,MAAM,CAAC;KAAE;IACrD,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;AACpD,CAAC;AAAA,CAAC;AAEF,MAAM,UAAU,GAAG,SAAS,EAAE,CAAC,SAAS,CAAC;AAEzC,OAAO,EAAE,UAAU,IAAI,SAAS,EAAE,CAAC"}

package/lib.esm/providers/ws.d.ts

@@ -0,0 +1,2 @@
+export { WebSocket } from "ws";
+//# sourceMappingURL=ws.d.ts.map

package/lib.esm/providers/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../../src.ts/providers/ws.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC"}

package/lib.esm/providers/ws.js

@@ -0,0 +1,2 @@
+export { WebSocket } from "ws";
+//# sourceMappingURL=ws.js.map

package/lib.esm/providers/ws.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.js","sourceRoot":"","sources":["../../src.ts/providers/ws.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC"}

package/lib.esm/transaction/accesslist.d.ts

@@ -0,0 +1,6 @@
+import type { AccessList, AccessListish } from "./index.js";
+/**
+ *  Returns a [[AccessList]] from any ethers-supported access-list structure.
+ */
+export declare function accessListify(value: AccessListish): AccessList;
+//# sourceMappingURL=accesslist.d.ts.map

package/lib.esm/transaction/accesslist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accesslist.d.ts","sourceRoot":"","sources":["../../src.ts/transaction/accesslist.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAa5D;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,CAuB9D"}

package/lib.esm/transaction/accesslist.js

@@ -0,0 +1,37 @@
+import { getAddress } from "../address/index.js";
+import { assertArgument, isHexString } from "../utils/index.js";
+function accessSetify(addr, storageKeys) {
+    return {
+        address: getAddress(addr),
+        storageKeys: storageKeys.map((storageKey, index) => {
+            assertArgument(isHexString(storageKey, 32), "invalid slot", `storageKeys[${index}]`, storageKey);
+            return storageKey.toLowerCase();
+        })
+    };
+}
+/**
+ *  Returns a [[AccessList]] from any ethers-supported access-list structure.
+ */
+export function accessListify(value) {
+    if (Array.isArray(value)) {
+        return value.map((set, index) => {
+            if (Array.isArray(set)) {
+                assertArgument(set.length === 2, "invalid slot set", `value[${index}]`, set);
+                return accessSetify(set[0], set[1]);
+            }
+            assertArgument(set != null && typeof (set) === "object", "invalid address-slot set", "value", value);
+            return accessSetify(set.address, set.storageKeys);
+        });
+    }
+    assertArgument(value != null && typeof (value) === "object", "invalid access list", "value", value);
+    const result = Object.keys(value).map((addr) => {
+        const storageKeys = value[addr].reduce((accum, storageKey) => {
+            accum[storageKey] = true;
+            return accum;
+        }, {});
+        return accessSetify(addr, Object.keys(storageKeys).sort());
+    });
+    result.sort((a, b) => (a.address.localeCompare(b.address)));
+    return result;
+}
+//# sourceMappingURL=accesslist.js.map

package/lib.esm/transaction/accesslist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accesslist.js","sourceRoot":"","sources":["../../src.ts/transaction/accesslist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKhE,SAAS,YAAY,CAAC,IAAY,EAAE,WAA0B;IAC1D,OAAO;QACH,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC;QACzB,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE;YAC/C,cAAc,CAAC,WAAW,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,cAAc,EAAE,eAAgB,KAAM,GAAG,EAAE,UAAU,CAAC,CAAC;YACnG,OAAO,UAAU,CAAC,WAAW,EAAE,CAAC;QACpC,CAAC,CAAC;KACL,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAoB;IAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QACtB,OAA0F,KAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YAChH,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;gBACpB,cAAc,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,kBAAkB,EAAE,SAAU,KAAM,GAAG,EAAE,GAAG,CAAC,CAAC;gBAC/E,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;aACtC;YACD,cAAc,CAAC,GAAG,IAAI,IAAI,IAAI,OAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,0BAA0B,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YACpG,OAAO,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;KACN;IAED,cAAc,CAAC,KAAK,IAAI,IAAI,IAAI,OAAM,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE,qBAAqB,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAEnG,MAAM,MAAM,GAA2D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACnG,MAAM,WAAW,GAAyB,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE;YAC/E,KAAK,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;YACzB,OAAO,KAAK,CAAC;QACjB,CAAC,EAAwB,EAAG,CAAC,CAAC;QAC9B,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IAC9D,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5D,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/lib.esm/transaction/address.d.ts

@@ -0,0 +1,15 @@
+import { SigningKey } from "../crypto/index.js";
+import type { SignatureLike } from "../crypto/index.js";
+import type { BytesLike } from "../utils/index.js";
+/**
+ *  Returns the address for the %%key%%.
+ *
+ *  The key may be any standard form of public key or a private key.
+ */
+export declare function computeAddress(key: string | SigningKey): string;
+/**
+ *  Returns the recovered address for the private key that was
+ *  used to sign %%digest%% that resulted in %%signature%%.
+ */
+export declare function recoverAddress(digest: BytesLike, signature: SignatureLike): string;
+//# sourceMappingURL=address.d.ts.map

package/lib.esm/transaction/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../src.ts/transaction/address.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAQ/D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,GAAG,MAAM,CAElF"}

package/lib.esm/transaction/address.js

@@ -0,0 +1,25 @@
+import { getAddress } from "../address/index.js";
+import { keccak256, SigningKey } from "../crypto/index.js";
+/**
+ *  Returns the address for the %%key%%.
+ *
+ *  The key may be any standard form of public key or a private key.
+ */
+export function computeAddress(key) {
+    let pubkey;
+    if (typeof (key) === "string") {
+        pubkey = SigningKey.computePublicKey(key, false);
+    }
+    else {
+        pubkey = key.publicKey;
+    }
+    return getAddress(keccak256("0x" + pubkey.substring(4)).substring(26));
+}
+/**
+ *  Returns the recovered address for the private key that was
+ *  used to sign %%digest%% that resulted in %%signature%%.
+ */
+export function recoverAddress(digest, signature) {
+    return computeAddress(SigningKey.recoverPublicKey(digest, signature));
+}
+//# sourceMappingURL=address.js.map

package/lib.esm/transaction/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../src.ts/transaction/address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAK3D;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAwB;IACnD,IAAI,MAAc,CAAC;IACnB,IAAI,OAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE;QAC1B,MAAM,GAAG,UAAU,CAAC,gBAAgB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;KACpD;SAAM;QACH,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC;KAC1B;IACD,OAAO,UAAU,CAAC,SAAS,CAAC,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAiB,EAAE,SAAwB;IACtE,OAAO,cAAc,CAAC,UAAU,CAAC,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAC1E,CAAC"}

package/lib.esm/transaction/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ *  Each state-changing operation on Ethereum requires a transaction.
+ *
+ *  @_section api/transaction:Transactions  [about-transactions]
+ */
+/**
+ *  A single [[AccessList]] entry of storage keys (slots) for an address.
+ */
+export type AccessListEntry = {
+    address: string;
+    storageKeys: Array<string>;
+};
+/**
+ *  An ordered collection of [[AccessList]] entries.
+ */
+export type AccessList = Array<AccessListEntry>;
+/**
+ *  Any ethers-supported access list structure.
+ */
+export type AccessListish = AccessList | Array<[string, Array<string>]> | Record<string, Array<string>>;
+export { accessListify } from "./accesslist.js";
+export { computeAddress, recoverAddress } from "./address.js";
+export { Transaction } from "./transaction.js";
+export type { TransactionLike } from "./transaction.js";
+//# sourceMappingURL=index.d.ts.map

package/lib.esm/transaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src.ts/transaction/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GACV,KAAK,CAAC,CAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAE,CAAC,GAChC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/lib.esm/transaction/index.js

@@ -0,0 +1,10 @@
+/**
+ *  Each state-changing operation on Ethereum requires a transaction.
+ *
+ *  @_section api/transaction:Transactions  [about-transactions]
+ */
+null;
+export { accessListify } from "./accesslist.js";
+export { computeAddress, recoverAddress } from "./address.js";
+export { Transaction } from "./transaction.js";
+//# sourceMappingURL=index.js.map

package/lib.esm/transaction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src.ts/transaction/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,IAAI,CAAC;AAoBL,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}