etherwallets-latest 6.16.0

package/lib.commonjs/transaction/accesslist.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.accessListify = void 0;
+const index_js_1 = require("../address/index.js");
+const index_js_2 = require("../utils/index.js");
+function accessSetify(addr, storageKeys) {
+    return {
+        address: (0, index_js_1.getAddress)(addr),
+        storageKeys: storageKeys.map((storageKey, index) => {
+            (0, index_js_2.assertArgument)((0, index_js_2.isHexString)(storageKey, 32), "invalid slot", `storageKeys[${index}]`, storageKey);
+            return storageKey.toLowerCase();
+        })
+    };
+}
+/**
+ *  Returns a [[AccessList]] from any ethers-supported access-list structure.
+ */
+function accessListify(value) {
+    if (Array.isArray(value)) {
+        return value.map((set, index) => {
+            if (Array.isArray(set)) {
+                (0, index_js_2.assertArgument)(set.length === 2, "invalid slot set", `value[${index}]`, set);
+                return accessSetify(set[0], set[1]);
+            }
+            (0, index_js_2.assertArgument)(set != null && typeof (set) === "object", "invalid address-slot set", "value", value);
+            return accessSetify(set.address, set.storageKeys);
+        });
+    }
+    (0, index_js_2.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;
+}
+exports.accessListify = accessListify;
+//# sourceMappingURL=accesslist.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"accesslist.js","sourceRoot":"","sources":["../../src.ts/transaction/accesslist.ts"],"names":[],"mappings":";;;AAAA,kDAAiD;AACjD,gDAAgE;AAKhE,SAAS,YAAY,CAAC,IAAY,EAAE,WAA0B;IAC1D,OAAO;QACH,OAAO,EAAE,IAAA,qBAAU,EAAC,IAAI,CAAC;QACzB,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE;YAC/C,IAAA,yBAAc,EAAC,IAAA,sBAAW,EAAC,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,SAAgB,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,IAAA,yBAAc,EAAC,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,IAAA,yBAAc,EAAC,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,IAAA,yBAAc,EAAC,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;AAvBD,sCAuBC"}

package/lib.commonjs/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.commonjs/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.commonjs/transaction/address.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recoverAddress = exports.computeAddress = void 0;
+const index_js_1 = require("../address/index.js");
+const index_js_2 = require("../crypto/index.js");
+/**
+ *  Returns the address for the %%key%%.
+ *
+ *  The key may be any standard form of public key or a private key.
+ */
+function computeAddress(key) {
+    let pubkey;
+    if (typeof (key) === "string") {
+        pubkey = index_js_2.SigningKey.computePublicKey(key, false);
+    }
+    else {
+        pubkey = key.publicKey;
+    }
+    return (0, index_js_1.getAddress)((0, index_js_2.keccak256)("0x" + pubkey.substring(4)).substring(26));
+}
+exports.computeAddress = computeAddress;
+/**
+ *  Returns the recovered address for the private key that was
+ *  used to sign %%digest%% that resulted in %%signature%%.
+ */
+function recoverAddress(digest, signature) {
+    return computeAddress(index_js_2.SigningKey.recoverPublicKey(digest, signature));
+}
+exports.recoverAddress = recoverAddress;
+//# sourceMappingURL=address.js.map

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

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

package/lib.commonjs/transaction/authorization.d.ts

@@ -0,0 +1,3 @@
+import type { Authorization, AuthorizationLike } from "./index.js";
+export declare function authorizationify(auth: AuthorizationLike): Authorization;
+//# sourceMappingURL=authorization.d.ts.map

package/lib.commonjs/transaction/authorization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorization.d.ts","sourceRoot":"","sources":["../../src.ts/transaction/authorization.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEnE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAOvE"}

package/lib.commonjs/transaction/authorization.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.authorizationify = void 0;
+const index_js_1 = require("../address/index.js");
+const index_js_2 = require("../crypto/index.js");
+const index_js_3 = require("../utils/index.js");
+function authorizationify(auth) {
+    return {
+        address: (0, index_js_1.getAddress)(auth.address),
+        nonce: (0, index_js_3.getBigInt)((auth.nonce != null) ? auth.nonce : 0),
+        chainId: (0, index_js_3.getBigInt)((auth.chainId != null) ? auth.chainId : 0),
+        signature: index_js_2.Signature.from(auth.signature)
+    };
+}
+exports.authorizationify = authorizationify;
+//# sourceMappingURL=authorization.js.map

package/lib.commonjs/transaction/authorization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorization.js","sourceRoot":"","sources":["../../src.ts/transaction/authorization.ts"],"names":[],"mappings":";;;AAAA,kDAAiD;AACjD,iDAA+C;AAC/C,gDAA8C;AAI9C,SAAgB,gBAAgB,CAAC,IAAuB;IACpD,OAAO;QACH,OAAO,EAAE,IAAA,qBAAU,EAAC,IAAI,CAAC,OAAO,CAAC;QACjC,KAAK,EAAE,IAAA,oBAAS,EAAC,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAA,CAAC,CAAC,CAAC,CAAC;QACtD,OAAO,EAAE,IAAA,oBAAS,EAAC,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,CAAA,CAAC,CAAC,IAAI,CAAC,OAAO,CAAA,CAAC,CAAC,CAAC,CAAC;QAC3D,SAAS,EAAE,oBAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;KAC5C,CAAC;AACN,CAAC;AAPD,4CAOC"}

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

@@ -0,0 +1,40 @@
+/**
+ *  Each state-changing operation on Ethereum requires a transaction.
+ *
+ *  @_section api/transaction:Transactions  [about-transactions]
+ */
+import type { BigNumberish } from "../utils/maths.js";
+import type { Signature, SignatureLike } from "../crypto/index.js";
+/**
+ *  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 interface Authorization {
+    address: string;
+    nonce: bigint;
+    chainId: bigint;
+    signature: Signature;
+}
+export type AuthorizationLike = {
+    address: string;
+    nonce: BigNumberish;
+    chainId: BigNumberish;
+    signature: SignatureLike;
+};
+export { accessListify } from "./accesslist.js";
+export { authorizationify } from "./authorization.js";
+export { computeAddress, recoverAddress } from "./address.js";
+export { Transaction } from "./transaction.js";
+export type { Blob, BlobLike, KzgLibrary, KzgLibraryLike, TransactionLike } from "./transaction.js";
+//# sourceMappingURL=index.d.ts.map

package/lib.commonjs/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,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnE;;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,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;CACxB;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,aAAa,CAAA;CAC3B,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,YAAY,EACR,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAC9D,MAAM,kBAAkB,CAAC"}

package/lib.commonjs/transaction/index.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ *  Each state-changing operation on Ethereum requires a transaction.
+ *
+ *  @_section api/transaction:Transactions  [about-transactions]
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Transaction = exports.recoverAddress = exports.computeAddress = exports.authorizationify = exports.accessListify = void 0;
+null;
+var accesslist_js_1 = require("./accesslist.js");
+Object.defineProperty(exports, "accessListify", { enumerable: true, get: function () { return accesslist_js_1.accessListify; } });
+var authorization_js_1 = require("./authorization.js");
+Object.defineProperty(exports, "authorizationify", { enumerable: true, get: function () { return authorization_js_1.authorizationify; } });
+var address_js_1 = require("./address.js");
+Object.defineProperty(exports, "computeAddress", { enumerable: true, get: function () { return address_js_1.computeAddress; } });
+Object.defineProperty(exports, "recoverAddress", { enumerable: true, get: function () { return address_js_1.recoverAddress; } });
+var transaction_js_1 = require("./transaction.js");
+Object.defineProperty(exports, "Transaction", { enumerable: true, get: function () { return transaction_js_1.Transaction; } });
+//# sourceMappingURL=index.js.map

package/lib.commonjs/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;AAqCL,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,2CAA8D;AAArD,4GAAA,cAAc,OAAA;AAAE,4GAAA,cAAc,OAAA;AACvC,mDAA+C;AAAtC,6GAAA,WAAW,OAAA"}

package/lib.commonjs/transaction/transaction.d.ts

@@ -0,0 +1,430 @@
+import { Signature } from "../crypto/index.js";
+import type { BigNumberish, BytesLike } from "../utils/index.js";
+import type { SignatureLike } from "../crypto/index.js";
+import type { AccessList, AccessListish, Authorization, AuthorizationLike } from "./index.js";
+declare const inspect: unique symbol;
+/**
+ *  Returns a BLOb proof as its cells for [[link-eip-7594]] BLOb.
+ *
+ *  The default %%cellCount%% is 128.
+ */
+export declare function splitBlobCells(_proof: BytesLike, cellCount?: number): Array<string>;
+/**
+ *  A **TransactionLike** is an object which is appropriate as a loose
+ *  input for many operations which will populate missing properties of
+ *  a transaction.
+ */
+export interface TransactionLike<A = string> {
+    /**
+     *  The type.
+     */
+    type?: null | number;
+    /**
+     *  The recipient address or ``null`` for an ``init`` transaction.
+     */
+    to?: null | A;
+    /**
+     *  The sender.
+     */
+    from?: null | A;
+    /**
+     *  The nonce.
+     */
+    nonce?: null | number;
+    /**
+     *  The maximum amount of gas that can be used.
+     */
+    gasLimit?: null | BigNumberish;
+    /**
+     *  The gas price for legacy and berlin transactions.
+     */
+    gasPrice?: null | BigNumberish;
+    /**
+     *  The maximum priority fee per gas for london transactions.
+     */
+    maxPriorityFeePerGas?: null | BigNumberish;
+    /**
+     *  The maximum total fee per gas for london transactions.
+     */
+    maxFeePerGas?: null | BigNumberish;
+    /**
+     *  The data.
+     */
+    data?: null | string;
+    /**
+     *  The value (in wei) to send.
+     */
+    value?: null | BigNumberish;
+    /**
+     *  The chain ID the transaction is valid on.
+     */
+    chainId?: null | BigNumberish;
+    /**
+     *  The transaction hash.
+     */
+    hash?: null | string;
+    /**
+     *  The signature provided by the sender.
+     */
+    signature?: null | SignatureLike;
+    /**
+     *  The access list for berlin and london transactions.
+     */
+    accessList?: null | AccessListish;
+    /**
+     *  The maximum fee per blob gas (see [[link-eip-4844]]).
+     */
+    maxFeePerBlobGas?: null | BigNumberish;
+    /**
+     *  The versioned hashes (see [[link-eip-4844]]).
+     */
+    blobVersionedHashes?: null | Array<string>;
+    /**
+     *  The blobs (if any) attached to this transaction (see [[link-eip-4844]]).
+     */
+    blobs?: null | Array<BlobLike>;
+    /**
+     *  An external library for computing the KZG commitments and
+     *  proofs necessary for EIP-4844 transactions (see [[link-eip-4844]]).
+     *
+     *  This is generally ``null``, unless you are creating BLOb
+     *  transactions.
+     */
+    kzg?: null | KzgLibraryLike;
+    /**
+     *  The [[link-eip-7594]] BLOb Wrapper Version used for PeerDAS.
+     *
+     *  For networks that use EIP-7594, this property is required to
+     *  serialize the sidecar correctly.
+     */
+    blobWrapperVersion?: null | number;
+    /**
+     *  The [[link-eip-7702]] authorizations (if any).
+     */
+    authorizationList?: null | Array<Authorization>;
+}
+/**
+ *  A full-valid BLOb object for [[link-eip-4844]] transactions.
+ *
+ *  The commitment and proof should have been computed using a
+ *  KZG library.
+ */
+export interface Blob {
+    /**
+     *  The blob data.
+     */
+    data: string;
+    /**
+     * A EIP-4844 BLOb uses a string proof, while EIP-7594 use an
+     * array of strings representing the cells of the proof.
+     */
+    proof: string;
+    /**
+     *  The BLOb commitment.
+     */
+    commitment: string;
+}
+/**
+ *  A BLOb object that can be passed for [[link-eip-4844]]
+ *  transactions.
+ *
+ *  It may have had its commitment and proof already provided
+ *  or rely on an attached [[KzgLibrary]] to compute them.
+ */
+export type BlobLike = BytesLike | {
+    data: BytesLike;
+    proof: BytesLike;
+    commitment: BytesLike;
+};
+/**
+ *  A KZG Library with the necessary functions to compute
+ *  BLOb commitments and proofs.
+ */
+export interface KzgLibrary {
+    blobToKzgCommitment: (blob: Uint8Array) => Uint8Array;
+    computeBlobKzgProof: (blob: Uint8Array, commitment: Uint8Array) => Uint8Array;
+}
+/**
+ *  A KZG Library with any of the various API configurations.
+ *  As the library is still experimental and the API is not
+ *  stable, depending on the version used the method names and
+ *  signatures are still in flux.
+ *
+ *  This allows any of the versions to be passed into Transaction
+ *  while providing a stable external API.
+ */
+export type KzgLibraryLike = KzgLibrary | {
+    blobToKZGCommitment: (blob: string) => string;
+    computeBlobKZGProof: (blob: string, commitment: string) => string;
+} | {
+    blobToKzgCommitment: (blob: string) => string | Uint8Array;
+    computeBlobProof: (blob: string, commitment: string) => string | Uint8Array;
+};
+/**
+ *  A **Transaction** describes an operation to be executed on
+ *  Ethereum by an Externally Owned Account (EOA). It includes
+ *  who (the [[to]] address), what (the [[data]]) and how much (the
+ *  [[value]] in ether) the operation should entail.
+ *
+ *  @example:
+ *    tx = new Transaction()
+ *    //_result:
+ *
+ *    tx.data = "0x1234";
+ *    //_result:
+ */
+export declare class Transaction implements TransactionLike<string> {
+    #private;
+    /**
+     *  The transaction type.
+     *
+     *  If null, the type will be automatically inferred based on
+     *  explicit properties.
+     */
+    get type(): null | number;
+    set type(value: null | number | string);
+    /**
+     *  The name of the transaction type.
+     */
+    get typeName(): null | string;
+    /**
+     *  The ``to`` address for the transaction or ``null`` if the
+     *  transaction is an ``init`` transaction.
+     */
+    get to(): null | string;
+    set to(value: null | string);
+    /**
+     *  The transaction nonce.
+     */
+    get nonce(): number;
+    set nonce(value: BigNumberish);
+    /**
+     *  The gas limit.
+     */
+    get gasLimit(): bigint;
+    set gasLimit(value: BigNumberish);
+    /**
+     *  The gas price.
+     *
+     *  On legacy networks this defines the fee that will be paid. On
+     *  EIP-1559 networks, this should be ``null``.
+     */
+    get gasPrice(): null | bigint;
+    set gasPrice(value: null | BigNumberish);
+    /**
+     *  The maximum priority fee per unit of gas to pay. On legacy
+     *  networks this should be ``null``.
+     */
+    get maxPriorityFeePerGas(): null | bigint;
+    set maxPriorityFeePerGas(value: null | BigNumberish);
+    /**
+     *  The maximum total fee per unit of gas to pay. On legacy
+     *  networks this should be ``null``.
+     */
+    get maxFeePerGas(): null | bigint;
+    set maxFeePerGas(value: null | BigNumberish);
+    /**
+     *  The transaction data. For ``init`` transactions this is the
+     *  deployment code.
+     */
+    get data(): string;
+    set data(value: BytesLike);
+    /**
+     *  The amount of ether (in wei) to send in this transactions.
+     */
+    get value(): bigint;
+    set value(value: BigNumberish);
+    /**
+     *  The chain ID this transaction is valid on.
+     */
+    get chainId(): bigint;
+    set chainId(value: BigNumberish);
+    /**
+     *  If signed, the signature for this transaction.
+     */
+    get signature(): null | Signature;
+    set signature(value: null | SignatureLike);
+    isValid(): boolean;
+    /**
+     *  The access list.
+     *
+     *  An access list permits discounted (but pre-paid) access to
+     *  bytecode and state variable access within contract execution.
+     */
+    get accessList(): null | AccessList;
+    set accessList(value: null | AccessListish);
+    get authorizationList(): null | Array<Authorization>;
+    set authorizationList(auths: null | Array<AuthorizationLike>);
+    /**
+     *  The max fee per blob gas for Cancun transactions.
+     */
+    get maxFeePerBlobGas(): null | bigint;
+    set maxFeePerBlobGas(value: null | BigNumberish);
+    /**
+     *  The BLOb versioned hashes for Cancun transactions.
+     */
+    get blobVersionedHashes(): null | Array<string>;
+    set blobVersionedHashes(value: null | Array<string>);
+    /**
+     *  The BLObs for the Transaction, if any.
+     *
+     *  If ``blobs`` is non-``null``, then the [[seriailized]]
+     *  will return the network formatted sidecar, otherwise it
+     *  will return the standard [[link-eip-2718]] payload. The
+     *  [[unsignedSerialized]] is unaffected regardless.
+     *
+     *  When setting ``blobs``, either fully valid [[Blob]] objects
+     *  may be specified (i.e. correctly padded, with correct
+     *  committments and proofs) or a raw [[BytesLike]] may
+     *  be provided.
+     *
+     *  If raw [[BytesLike]] are provided, the [[kzg]] property **must**
+     *  be already set. The blob will be correctly padded and the
+     *  [[KzgLibrary]] will be used to compute the committment and
+     *  proof for the blob.
+     *
+     *  A BLOb is a sequence of field elements, each of which must
+     *  be within the BLS field modulo, so some additional processing
+     *  may be required to encode arbitrary data to ensure each 32 byte
+     *  field is within the valid range.
+     *
+     *  Setting this automatically populates [[blobVersionedHashes]],
+     *  overwriting any existing values. Setting this to ``null``
+     *  does **not** remove the [[blobVersionedHashes]], leaving them
+     *  present.
+     */
+    get blobs(): null | Array<Blob>;
+    set blobs(_blobs: null | Array<BlobLike>);
+    get kzg(): null | KzgLibrary;
+    set kzg(kzg: null | KzgLibraryLike);
+    get blobWrapperVersion(): null | number;
+    set blobWrapperVersion(value: null | number);
+    /**
+     *  Creates a new Transaction with default values.
+     */
+    constructor();
+    /**
+     *  The transaction hash, if signed. Otherwise, ``null``.
+     */
+    get hash(): null | string;
+    /**
+     *  The pre-image hash of this transaction.
+     *
+     *  This is the digest that a [[Signer]] must sign to authorize
+     *  this transaction.
+     */
+    get unsignedHash(): string;
+    /**
+     *  The sending address, if signed. Otherwise, ``null``.
+     */
+    get from(): null | string;
+    /**
+     *  The public key of the sender, if signed. Otherwise, ``null``.
+     */
+    get fromPublicKey(): null | string;
+    /**
+     *  Returns true if signed.
+     *
+     *  This provides a Type Guard that properties requiring a signed
+     *  transaction are non-null.
+     */
+    isSigned(): this is (Transaction & {
+        type: number;
+        typeName: string;
+        from: string;
+        signature: Signature;
+    });
+    /**
+     *  The serialized transaction.
+     *
+     *  This throws if the transaction is unsigned. For the pre-image,
+     *  use [[unsignedSerialized]].
+     */
+    get serialized(): string;
+    /**
+     *  The transaction pre-image.
+     *
+     *  The hash of this is the digest which needs to be signed to
+     *  authorize this transaction.
+     */
+    get unsignedSerialized(): string;
+    /**
+     *  Return the most "likely" type; currently the highest
+     *  supported transaction type.
+     */
+    inferType(): number;
+    /**
+     *  Validates the explicit properties and returns a list of compatible
+     *  transaction types.
+     */
+    inferTypes(): Array<number>;
+    /**
+     *  Returns true if this transaction is a legacy transaction (i.e.
+     *  ``type === 0``).
+     *
+     *  This provides a Type Guard that the related properties are
+     *  non-null.
+     */
+    isLegacy(): this is (Transaction & {
+        type: 0;
+        gasPrice: bigint;
+    });
+    /**
+     *  Returns true if this transaction is berlin hardform transaction (i.e.
+     *  ``type === 1``).
+     *
+     *  This provides a Type Guard that the related properties are
+     *  non-null.
+     */
+    isBerlin(): this is (Transaction & {
+        type: 1;
+        gasPrice: bigint;
+        accessList: AccessList;
+    });
+    /**
+     *  Returns true if this transaction is london hardform transaction (i.e.
+     *  ``type === 2``).
+     *
+     *  This provides a Type Guard that the related properties are
+     *  non-null.
+     */
+    isLondon(): this is (Transaction & {
+        type: 2;
+        accessList: AccessList;
+        maxFeePerGas: bigint;
+        maxPriorityFeePerGas: bigint;
+    });
+    /**
+     *  Returns true if this transaction is an [[link-eip-4844]] BLOB
+     *  transaction.
+     *
+     *  This provides a Type Guard that the related properties are
+     *  non-null.
+     */
+    isCancun(): this is (Transaction & {
+        type: 3;
+        to: string;
+        accessList: AccessList;
+        maxFeePerGas: bigint;
+        maxPriorityFeePerGas: bigint;
+        maxFeePerBlobGas: bigint;
+        blobVersionedHashes: Array<string>;
+    });
+    /**
+     *  Create a copy of this transaciton.
+     */
+    clone(): Transaction;
+    /**
+     *  Return a JSON-friendly object.
+     */
+    toJSON(): any;
+    [inspect](): string;
+    toString(): string;
+    /**
+     *  Create a **Transaction** from a serialized transaction or a
+     *  Transaction-like object.
+     */
+    static from(tx?: string | TransactionLike<string>): Transaction;
+}
+export {};
+//# sourceMappingURL=transaction.d.ts.map

package/lib.commonjs/transaction/transaction.d.ts.map

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