@hiero-ledger/sdk 2.83.0-beta.1 → 2.83.0-beta.2

package/lib/EthereumTransactionDataEip7702.js.map

@@ -1 +1 @@
-{"version":3,"file":"EthereumTransactionDataEip7702.js","sources":["../src/EthereumTransactionDataEip7702.js"],"sourcesContent":["import { decodeRlp, encodeRlp } from \"ethers\";\nimport * as hex from \"./encoding/hex.js\";\nimport EthereumTransactionData from \"./EthereumTransactionData.js\";\nimport CACHE from \"./Cache.js\";\n\n/**\n * @typedef {object} EthereumTransactionDataEip7702JSON\n * @property {string} chainId\n * @property {string} nonce\n * @property {string} maxPriorityGas\n * @property {string} maxGas\n * @property {string} gasLimit\n * @property {string} to\n * @property {string} value\n * @property {string} callData\n * @property {Array<[string, string, string, string, string, string]>} authorizationList - Array of [chainId, contractAddress, nonce, yParity, r, s] tuples\n * @property {string[]} accessList\n * @property {string} recId\n * @property {string} r\n * @property {string} s\n */\n\nexport default class EthereumTransactionDataEip7702 extends EthereumTransactionData {\n    /**\n     * @private\n     * @param {object} props\n     * @param {Uint8Array} props.chainId\n     * @param {Uint8Array} props.nonce\n     * @param {Uint8Array} props.maxPriorityGas\n     * @param {Uint8Array} props.maxGas\n     * @param {Uint8Array} props.gasLimit\n     * @param {Uint8Array} props.to\n     * @param {Uint8Array} props.value\n     * @param {Uint8Array} props.callData\n     * @param {Array<[Uint8Array, Uint8Array, Uint8Array, Uint8Array, Uint8Array, Uint8Array]>} props.authorizationList - Array of [chainId, contractAddress, nonce, yParity, r, s] tuples\n     * @param {Uint8Array[]} props.accessList\n     * @param {Uint8Array} props.recId\n     * @param {Uint8Array} props.r\n     * @param {Uint8Array} props.s\n     */\n    constructor(props) {\n        super(props);\n\n        this.chainId = props.chainId;\n        this.nonce = props.nonce;\n        this.maxPriorityGas = props.maxPriorityGas;\n        this.maxGas = props.maxGas;\n        this.gasLimit = props.gasLimit;\n        this.to = props.to;\n        this.value = props.value;\n        this.callData = props.callData;\n        this.authorizationList = props.authorizationList;\n        this.accessList = props.accessList;\n        this.recId = props.recId;\n        this.r = props.r;\n        this.s = props.s;\n    }\n\n    /**\n     * @param {Uint8Array} bytes\n     * @returns {EthereumTransactionData}\n     */\n    static fromBytes(bytes) {\n        if (bytes.length === 0) {\n            throw new Error(\"empty bytes\");\n        }\n\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n        const decoded = /** @type {string[]} */ (decodeRlp(bytes.subarray(1)));\n\n        if (!Array.isArray(decoded)) {\n            throw new Error(\"ethereum data is not a list\");\n        }\n\n        if (decoded.length !== 13) {\n            throw new Error(\"invalid ethereum transaction data\");\n        }\n\n        // Decode authorization list: array of [chainId, contractAddress, nonce, yParity, r, s] tuples\n        // Authorization list can be empty (empty array is valid)\n        if (!Array.isArray(decoded[9])) {\n            throw new Error(\"authorization list must be an array\");\n        }\n        // @ts-ignore\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n        const authorizationList = /** @type {string[]} */ (decoded[9]).map(\n            (authTuple) => {\n                if (!Array.isArray(authTuple) || authTuple.length !== 6) {\n                    throw new Error(\n                        \"invalid authorization list entry: must be [chainId, contractAddress, nonce, yParity, r, s]\",\n                    );\n                }\n                return [\n                    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n                    hex.decode(/** @type {string} */ (authTuple[0])), // chainId\n                    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n                    hex.decode(/** @type {string} */ (authTuple[1])), // contractAddress (20 bytes)\n                    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n                    hex.decode(/** @type {string} */ (authTuple[2])), // nonce\n                    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n                    hex.decode(/** @type {string} */ (authTuple[3])), // yParity (0 or 1)\n                    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n                    hex.decode(/** @type {string} */ (authTuple[4])), // r (32 bytes)\n                    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n                    hex.decode(/** @type {string} */ (authTuple[5])), // s (32 bytes)\n                ];\n            },\n        );\n\n        return new EthereumTransactionDataEip7702({\n            chainId: hex.decode(/** @type {string} */ (decoded[0])),\n            nonce: hex.decode(/** @type {string} */ (decoded[1])),\n            maxPriorityGas: hex.decode(/** @type {string} */ (decoded[2])),\n            maxGas: hex.decode(/** @type {string} */ (decoded[3])),\n            gasLimit: hex.decode(/** @type {string} */ (decoded[4])),\n            to: hex.decode(/** @type {string} */ (decoded[5])),\n            value: hex.decode(/** @type {string} */ (decoded[6])),\n            callData: hex.decode(/** @type {string} */ (decoded[7])),\n            // @ts-ignore\n            accessList: /** @type {string[]} */ (decoded[8]).map((v) =>\n                hex.decode(v),\n            ),\n            // @ts-ignore\n            authorizationList: authorizationList,\n            recId: hex.decode(/** @type {string} */ (decoded[10])),\n            r: hex.decode(/** @type {string} */ (decoded[11])),\n            s: hex.decode(/** @type {string} */ (decoded[12])),\n        });\n    }\n\n    /**\n     * @returns {Uint8Array}\n     */\n    toBytes() {\n        const encoded = encodeRlp([\n            this.chainId,\n            this.nonce,\n            this.maxPriorityGas,\n            this.maxGas,\n            this.gasLimit,\n            this.to,\n            this.value,\n            this.callData,\n            this.accessList,\n            this.authorizationList,\n            this.recId,\n            this.r,\n            this.s,\n        ]);\n        return hex.decode(\"04\" + encoded.substring(2));\n    }\n\n    /**\n     * @returns {string}\n     */\n    toString() {\n        return JSON.stringify(this.toJSON(), null, 2);\n    }\n\n    /**\n     * @returns {EthereumTransactionDataEip7702JSON}\n     */\n    toJSON() {\n        return {\n            chainId: hex.encode(this.chainId),\n            nonce: hex.encode(this.nonce),\n            maxPriorityGas: hex.encode(this.maxPriorityGas),\n            maxGas: hex.encode(this.maxGas),\n            gasLimit: hex.encode(this.gasLimit),\n            to: hex.encode(this.to),\n            value: hex.encode(this.value),\n            callData: hex.encode(this.callData),\n            authorizationList: this.authorizationList.map(\n                ([chainId, contractAddress, nonce, yParity, r, s]) => [\n                    hex.encode(chainId),\n                    hex.encode(contractAddress),\n                    hex.encode(nonce),\n                    hex.encode(yParity),\n                    hex.encode(r),\n                    hex.encode(s),\n                ],\n            ),\n            accessList: this.accessList.map((v) => hex.encode(v)),\n            recId: hex.encode(this.recId),\n            r: hex.encode(this.r),\n            s: hex.encode(this.s),\n        };\n    }\n}\n\nCACHE.setEthereumTransactionDataEip7702FromBytes((bytes) =>\n    EthereumTransactionDataEip7702.fromBytes(bytes),\n);\n"],"names":["EthereumTransactionDataEip7702","EthereumTransactionData","constructor","props","super","this","chainId","nonce","maxPriorityGas","maxGas","gasLimit","to","value","callData","authorizationList","accessList","recId","r","s","fromBytes","bytes","length","Error","decoded","decodeRlp","subarray","Array","isArray","map","authTuple","hex.decode","v","toBytes","encoded","encodeRlp","substring","toString","JSON","stringify","toJSON","hex.encode","contractAddress","yParity","CACHE","setEthereumTransactionDataEip7702FromBytes"],"mappings":"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"}
+{"version":3,"file":"EthereumTransactionDataEip7702.js","sources":["../src/EthereumTransactionDataEip7702.js"],"sourcesContent":["import { decodeRlp, encodeRlp } from \"ethers\";\nimport * as hex from \"./encoding/hex.js\";\nimport EthereumTransactionData from \"./EthereumTransactionData.js\";\nimport CACHE from \"./Cache.js\";\n\n/**\n * @typedef {[Uint8Array, Uint8Array[]]} AccessListItem - [address, storageKeys[]]\n */\n\n/**\n * @typedef {[Uint8Array, Uint8Array, Uint8Array, Uint8Array, Uint8Array, Uint8Array]} AuthorizationItem - [chainId, contractAddress, nonce, yParity, r, s]\n */\n\n/**\n * @typedef {object} AccessListItemJSON\n * @property {string} address\n * @property {string[]} storageKeys\n */\n\n/**\n * @typedef {object} EthereumTransactionDataEip7702JSON\n * @property {string} chainId\n * @property {string} nonce\n * @property {string} maxPriorityGas\n * @property {string} maxGas\n * @property {string} gasLimit\n * @property {string} to\n * @property {string} value\n * @property {string} callData\n * @property {Array<[string, string, string, string, string, string]>} authorizationList - Array of [chainId, contractAddress, nonce, yParity, r, s] tuples\n * @property {AccessListItemJSON[]} accessList\n * @property {string} recId\n * @property {string} r\n * @property {string} s\n */\n\nexport default class EthereumTransactionDataEip7702 extends EthereumTransactionData {\n    /**\n     * @private\n     * @param {object} props\n     * @param {Uint8Array} props.chainId\n     * @param {Uint8Array} props.nonce\n     * @param {Uint8Array} props.maxPriorityGas\n     * @param {Uint8Array} props.maxGas\n     * @param {Uint8Array} props.gasLimit\n     * @param {Uint8Array} props.to\n     * @param {Uint8Array} props.value\n     * @param {Uint8Array} props.callData\n     * @param {AuthorizationItem[]} props.authorizationList - Array of [chainId, contractAddress, nonce, yParity, r, s] tuples\n     * @param {AccessListItem[]} props.accessList\n     * @param {Uint8Array} props.recId\n     * @param {Uint8Array} props.r\n     * @param {Uint8Array} props.s\n     */\n    constructor(props) {\n        super(props);\n\n        this.chainId = props.chainId;\n        this.nonce = props.nonce;\n        this.maxPriorityGas = props.maxPriorityGas;\n        this.maxGas = props.maxGas;\n        this.gasLimit = props.gasLimit;\n        this.to = props.to;\n        this.value = props.value;\n        this.callData = props.callData;\n        this.authorizationList = props.authorizationList;\n        this.accessList = props.accessList;\n        this.recId = props.recId;\n        this.r = props.r;\n        this.s = props.s;\n    }\n\n    /**\n     * @param {Uint8Array} bytes\n     * @returns {EthereumTransactionData}\n     */\n    static fromBytes(bytes) {\n        if (bytes.length === 0) {\n            throw new Error(\"empty bytes\");\n        }\n\n        const decoded = /** @type {unknown[]} */ (\n            /** @type {unknown} */ (decodeRlp(bytes.subarray(1)))\n        );\n\n        if (!Array.isArray(decoded)) {\n            throw new Error(\"ethereum data is not a list\");\n        }\n\n        if (decoded.length !== 13) {\n            throw new Error(\"invalid ethereum transaction data\");\n        }\n\n        // Decode authorization list: array of [chainId, contractAddress, nonce, yParity, r, s] tuples\n        // Authorization list can be empty (empty array is valid)\n        if (!Array.isArray(decoded[9])) {\n            throw new Error(\"authorization list must be an array\");\n        }\n        const authorizationList = /** @type {AuthorizationItem[]} */ (\n            /** @type {Array<[string, string, string, string, string, string]>} */ (\n                /** @type {unknown} */ (decoded[9])\n            ).map((authTuple) => {\n                if (!Array.isArray(authTuple) || authTuple.length !== 6) {\n                    throw new Error(\n                        \"invalid authorization list entry: must be [chainId, contractAddress, nonce, yParity, r, s]\",\n                    );\n                }\n                return [\n                    hex.decode(authTuple[0]), // chainId\n                    hex.decode(authTuple[1]), // contractAddress (20 bytes)\n                    hex.decode(authTuple[2]), // nonce\n                    hex.decode(authTuple[3]), // yParity (0 or 1)\n                    hex.decode(authTuple[4]), // r (32 bytes)\n                    hex.decode(authTuple[5]), // s (32 bytes)\n                ];\n            })\n        );\n\n        return new EthereumTransactionDataEip7702({\n            chainId: hex.decode(/** @type {string} */ (decoded[0])),\n            nonce: hex.decode(/** @type {string} */ (decoded[1])),\n            maxPriorityGas: hex.decode(/** @type {string} */ (decoded[2])),\n            maxGas: hex.decode(/** @type {string} */ (decoded[3])),\n            gasLimit: hex.decode(/** @type {string} */ (decoded[4])),\n            to: hex.decode(/** @type {string} */ (decoded[5])),\n            value: hex.decode(/** @type {string} */ (decoded[6])),\n            callData: hex.decode(/** @type {string} */ (decoded[7])),\n            accessList: /** @type {AccessListItem[]} */ (\n                /** @type {Array<[string, string[]]>} */ (\n                    /** @type {unknown} */ (decoded[8])\n                ).map((item) => {\n                    if (!Array.isArray(item) || item.length !== 2) {\n                        throw new Error(\n                            \"invalid access list entry: must be [address, storageKeys[]]\",\n                        );\n                    }\n                    return [\n                        hex.decode(item[0]),\n                        item[1].map((key) => hex.decode(key)),\n                    ];\n                })\n            ),\n            authorizationList: authorizationList,\n            recId: hex.decode(/** @type {string} */ (decoded[10])),\n            r: hex.decode(/** @type {string} */ (decoded[11])),\n            s: hex.decode(/** @type {string} */ (decoded[12])),\n        });\n    }\n\n    /**\n     * @returns {Uint8Array}\n     */\n    toBytes() {\n        const encoded = encodeRlp([\n            this.chainId,\n            this.nonce,\n            this.maxPriorityGas,\n            this.maxGas,\n            this.gasLimit,\n            this.to,\n            this.value,\n            this.callData,\n            this.accessList,\n            this.authorizationList,\n            this.recId,\n            this.r,\n            this.s,\n        ]);\n        return hex.decode(\"04\" + encoded.substring(2));\n    }\n\n    /**\n     * @returns {string}\n     */\n    toString() {\n        return JSON.stringify(this.toJSON(), null, 2);\n    }\n\n    /**\n     * @returns {EthereumTransactionDataEip7702JSON}\n     */\n    toJSON() {\n        return {\n            chainId: hex.encode(this.chainId),\n            nonce: hex.encode(this.nonce),\n            maxPriorityGas: hex.encode(this.maxPriorityGas),\n            maxGas: hex.encode(this.maxGas),\n            gasLimit: hex.encode(this.gasLimit),\n            to: hex.encode(this.to),\n            value: hex.encode(this.value),\n            callData: hex.encode(this.callData),\n            authorizationList: this.authorizationList.map(\n                ([chainId, contractAddress, nonce, yParity, r, s]) => [\n                    hex.encode(chainId),\n                    hex.encode(contractAddress),\n                    hex.encode(nonce),\n                    hex.encode(yParity),\n                    hex.encode(r),\n                    hex.encode(s),\n                ],\n            ),\n            accessList: this.accessList.map(([address, storageKeys]) => ({\n                address: hex.encode(address),\n                storageKeys: storageKeys.map((key) => hex.encode(key)),\n            })),\n            recId: hex.encode(this.recId),\n            r: hex.encode(this.r),\n            s: hex.encode(this.s),\n        };\n    }\n}\n\nCACHE.setEthereumTransactionDataEip7702FromBytes((bytes) =>\n    EthereumTransactionDataEip7702.fromBytes(bytes),\n);\n"],"names":["EthereumTransactionDataEip7702","EthereumTransactionData","constructor","props","super","this","chainId","nonce","maxPriorityGas","maxGas","gasLimit","to","value","callData","authorizationList","accessList","recId","r","s","fromBytes","bytes","length","Error","decoded","decodeRlp","subarray","Array","isArray","map","authTuple","hex.decode","item","key","toBytes","encoded","encodeRlp","substring","toString","JSON","stringify","toJSON","hex.encode","contractAddress","yParity","address","storageKeys","CACHE","setEthereumTransactionDataEip7702FromBytes"],"mappings":"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"}

package/lib/EthereumTransactionDataLegacy.cjs

@@ -57,9 +57,8 @@ class EthereumTransactionDataLegacy extends _EthereumTransactionData.default {
     if (bytes.length === 0) {
       throw new Error("empty bytes");
     }
-
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-    const decoded = /** @type {string[]} */(0, _ethers.decodeRlp)(bytes);
+    const decoded = /** @type {unknown[]} */
+    /** @type {unknown} */(0, _ethers.decodeRlp)(bytes);
     if (decoded.length != 9) {
       throw new Error("invalid ethereum transaction data");
     }

package/lib/EthereumTransactionDataLegacy.js.map

@@ -1 +1 @@
-{"version":3,"file":"EthereumTransactionDataLegacy.js","sources":["../src/EthereumTransactionDataLegacy.js"],"sourcesContent":["import { decodeRlp, encodeRlp } from \"ethers\";\nimport * as hex from \"./encoding/hex.js\";\nimport EthereumTransactionData from \"./EthereumTransactionData.js\";\nimport CACHE from \"./Cache.js\";\n\n/**\n * @typedef {object} EthereumTransactionDataLegacyJSON\n * @property {string} nonce\n * @property {string} gasPrice\n * @property {string} gasLimit\n * @property {string} to\n * @property {string} value\n * @property {string} callData\n * @property {string} v\n * @property {string} r\n * @property {string} s\n */\n\nexport default class EthereumTransactionDataLegacy extends EthereumTransactionData {\n    /**\n     * @private\n     * @param {object} props\n     * @param {Uint8Array} props.nonce\n     * @param {Uint8Array} props.gasPrice\n     * @param {Uint8Array} props.gasLimit\n     * @param {Uint8Array} props.to\n     * @param {Uint8Array} props.value\n     * @param {Uint8Array} props.callData\n     * @param {Uint8Array} props.v\n     * @param {Uint8Array} props.r\n     * @param {Uint8Array} props.s\n     */\n    constructor(props) {\n        super(props);\n\n        this.nonce = props.nonce;\n        this.gasPrice = props.gasPrice;\n        this.gasLimit = props.gasLimit;\n        this.to = props.to;\n        this.value = props.value;\n        this.v = props.v;\n        this.r = props.r;\n        this.s = props.s;\n    }\n\n    /**\n     * @param {Uint8Array} bytes\n     * @returns {EthereumTransactionData}\n     */\n    static fromBytes(bytes) {\n        if (bytes.length === 0) {\n            throw new Error(\"empty bytes\");\n        }\n\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n        const decoded = /** @type {string[]} */ (decodeRlp(bytes));\n\n        if (decoded.length != 9) {\n            throw new Error(\"invalid ethereum transaction data\");\n        }\n\n        return new EthereumTransactionDataLegacy({\n            nonce: hex.decode(/** @type {string} */ (decoded[0])),\n            gasPrice: hex.decode(/** @type {string} */ (decoded[1])),\n            gasLimit: hex.decode(/** @type {string} */ (decoded[2])),\n            to: hex.decode(/** @type {string} */ (decoded[3])),\n            value: hex.decode(/** @type {string} */ (decoded[4])),\n            callData: hex.decode(/** @type {string} */ (decoded[5])),\n            v: hex.decode(/** @type {string} */ (decoded[6])),\n            r: hex.decode(/** @type {string} */ (decoded[7])),\n            s: hex.decode(/** @type {string} */ (decoded[8])),\n        });\n    }\n\n    /**\n     * @returns {Uint8Array}\n     */\n    toBytes() {\n        return hex.decode(\n            encodeRlp([\n                this.nonce,\n                this.gasPrice,\n                this.gasLimit,\n                this.to,\n                this.value,\n                this.callData,\n                this.v,\n                this.r,\n                this.s,\n            ]),\n        );\n    }\n\n    /**\n     * @returns {string}\n     */\n    toString() {\n        return JSON.stringify(this.toJSON(), null, 2);\n    }\n\n    /**\n     * @returns {EthereumTransactionDataLegacyJSON}\n     */\n    toJSON() {\n        return {\n            nonce: hex.encode(this.nonce),\n            gasPrice: hex.encode(this.gasPrice),\n            gasLimit: hex.encode(this.gasLimit),\n            to: hex.encode(this.to),\n            value: hex.encode(this.value),\n            callData: hex.encode(this.callData),\n            v: hex.encode(this.v),\n            r: hex.encode(this.r),\n            s: hex.encode(this.s),\n        };\n    }\n}\n\nCACHE.setEthereumTransactionDataLegacyFromBytes((bytes) =>\n    EthereumTransactionDataLegacy.fromBytes(bytes),\n);\n"],"names":["EthereumTransactionDataLegacy","EthereumTransactionData","constructor","props","super","this","nonce","gasPrice","gasLimit","to","value","v","r","s","fromBytes","bytes","length","Error","decoded","decodeRlp","hex.decode","callData","toBytes","encodeRlp","toString","JSON","stringify","toJSON","hex.encode","CACHE","setEthereumTransactionDataLegacyFromBytes"],"mappings":"+KAkBe,MAAMA,UAAsCC,EAcvD,WAAAC,CAAYC,GACRC,MAAMD,GAENE,KAAKC,MAAQH,EAAMG,MACnBD,KAAKE,SAAWJ,EAAMI,SACtBF,KAAKG,SAAWL,EAAMK,SACtBH,KAAKI,GAAKN,EAAMM,GAChBJ,KAAKK,MAAQP,EAAMO,MACnBL,KAAKM,EAAIR,EAAMQ,EACfN,KAAKO,EAAIT,EAAMS,EACfP,KAAKQ,EAAIV,EAAMU,CACnB,CAMA,gBAAOC,CAAUC,GACb,GAAqB,IAAjBA,EAAMC,OACN,MAAM,IAAIC,MAAM,eAIpB,MAAMC,EAAmCC,EAAUJ,GAEnD,GAAsB,GAAlBG,EAAQF,OACR,MAAM,IAAIC,MAAM,qCAGpB,OAAO,IAAIjB,EAA8B,CACrCM,MAAOc,EAAkCF,EAAQ,IACjDX,SAAUa,EAAkCF,EAAQ,IACpDV,SAAUY,EAAkCF,EAAQ,IACpDT,GAAIW,EAAkCF,EAAQ,IAC9CR,MAAOU,EAAkCF,EAAQ,IACjDG,SAAUD,EAAkCF,EAAQ,IACpDP,EAAGS,EAAkCF,EAAQ,IAC7CN,EAAGQ,EAAkCF,EAAQ,IAC7CL,EAAGO,EAAkCF,EAAQ,KAErD,CAKA,OAAAI,GACI,OAAOF,EACHG,EAAU,CACNlB,KAAKC,MACLD,KAAKE,SACLF,KAAKG,SACLH,KAAKI,GACLJ,KAAKK,MACLL,KAAKgB,SACLhB,KAAKM,EACLN,KAAKO,EACLP,KAAKQ,IAGjB,CAKA,QAAAW,GACI,OAAOC,KAAKC,UAAUrB,KAAKsB,SAAU,KAAM,EAC/C,CAKA,MAAAA,GACI,MAAO,CACHrB,MAAOsB,EAAWvB,KAAKC,OACvBC,SAAUqB,EAAWvB,KAAKE,UAC1BC,SAAUoB,EAAWvB,KAAKG,UAC1BC,GAAImB,EAAWvB,KAAKI,IACpBC,MAAOkB,EAAWvB,KAAKK,OACvBW,SAAUO,EAAWvB,KAAKgB,UAC1BV,EAAGiB,EAAWvB,KAAKM,GACnBC,EAAGgB,EAAWvB,KAAKO,GACnBC,EAAGe,EAAWvB,KAAKQ,GAE3B,EAGJgB,EAAMC,0CAA2Cf,GAC7Cf,EAA8Bc,UAAUC"}
+{"version":3,"file":"EthereumTransactionDataLegacy.js","sources":["../src/EthereumTransactionDataLegacy.js"],"sourcesContent":["import { decodeRlp, encodeRlp } from \"ethers\";\nimport * as hex from \"./encoding/hex.js\";\nimport EthereumTransactionData from \"./EthereumTransactionData.js\";\nimport CACHE from \"./Cache.js\";\n\n/**\n * @typedef {object} EthereumTransactionDataLegacyJSON\n * @property {string} nonce\n * @property {string} gasPrice\n * @property {string} gasLimit\n * @property {string} to\n * @property {string} value\n * @property {string} callData\n * @property {string} v\n * @property {string} r\n * @property {string} s\n */\n\nexport default class EthereumTransactionDataLegacy extends EthereumTransactionData {\n    /**\n     * @private\n     * @param {object} props\n     * @param {Uint8Array} props.nonce\n     * @param {Uint8Array} props.gasPrice\n     * @param {Uint8Array} props.gasLimit\n     * @param {Uint8Array} props.to\n     * @param {Uint8Array} props.value\n     * @param {Uint8Array} props.callData\n     * @param {Uint8Array} props.v\n     * @param {Uint8Array} props.r\n     * @param {Uint8Array} props.s\n     */\n    constructor(props) {\n        super(props);\n\n        this.nonce = props.nonce;\n        this.gasPrice = props.gasPrice;\n        this.gasLimit = props.gasLimit;\n        this.to = props.to;\n        this.value = props.value;\n        this.v = props.v;\n        this.r = props.r;\n        this.s = props.s;\n    }\n\n    /**\n     * @param {Uint8Array} bytes\n     * @returns {EthereumTransactionData}\n     */\n    static fromBytes(bytes) {\n        if (bytes.length === 0) {\n            throw new Error(\"empty bytes\");\n        }\n\n        const decoded = /** @type {unknown[]} */ (\n            /** @type {unknown} */ (decodeRlp(bytes))\n        );\n\n        if (decoded.length != 9) {\n            throw new Error(\"invalid ethereum transaction data\");\n        }\n\n        return new EthereumTransactionDataLegacy({\n            nonce: hex.decode(/** @type {string} */ (decoded[0])),\n            gasPrice: hex.decode(/** @type {string} */ (decoded[1])),\n            gasLimit: hex.decode(/** @type {string} */ (decoded[2])),\n            to: hex.decode(/** @type {string} */ (decoded[3])),\n            value: hex.decode(/** @type {string} */ (decoded[4])),\n            callData: hex.decode(/** @type {string} */ (decoded[5])),\n            v: hex.decode(/** @type {string} */ (decoded[6])),\n            r: hex.decode(/** @type {string} */ (decoded[7])),\n            s: hex.decode(/** @type {string} */ (decoded[8])),\n        });\n    }\n\n    /**\n     * @returns {Uint8Array}\n     */\n    toBytes() {\n        return hex.decode(\n            encodeRlp([\n                this.nonce,\n                this.gasPrice,\n                this.gasLimit,\n                this.to,\n                this.value,\n                this.callData,\n                this.v,\n                this.r,\n                this.s,\n            ]),\n        );\n    }\n\n    /**\n     * @returns {string}\n     */\n    toString() {\n        return JSON.stringify(this.toJSON(), null, 2);\n    }\n\n    /**\n     * @returns {EthereumTransactionDataLegacyJSON}\n     */\n    toJSON() {\n        return {\n            nonce: hex.encode(this.nonce),\n            gasPrice: hex.encode(this.gasPrice),\n            gasLimit: hex.encode(this.gasLimit),\n            to: hex.encode(this.to),\n            value: hex.encode(this.value),\n            callData: hex.encode(this.callData),\n            v: hex.encode(this.v),\n            r: hex.encode(this.r),\n            s: hex.encode(this.s),\n        };\n    }\n}\n\nCACHE.setEthereumTransactionDataLegacyFromBytes((bytes) =>\n    EthereumTransactionDataLegacy.fromBytes(bytes),\n);\n"],"names":["EthereumTransactionDataLegacy","EthereumTransactionData","constructor","props","super","this","nonce","gasPrice","gasLimit","to","value","v","r","s","fromBytes","bytes","length","Error","decoded","decodeRlp","hex.decode","callData","toBytes","encodeRlp","toString","JSON","stringify","toJSON","hex.encode","CACHE","setEthereumTransactionDataLegacyFromBytes"],"mappings":"+KAkBe,MAAMA,UAAsCC,EAcvD,WAAAC,CAAYC,GACRC,MAAMD,GAENE,KAAKC,MAAQH,EAAMG,MACnBD,KAAKE,SAAWJ,EAAMI,SACtBF,KAAKG,SAAWL,EAAMK,SACtBH,KAAKI,GAAKN,EAAMM,GAChBJ,KAAKK,MAAQP,EAAMO,MACnBL,KAAKM,EAAIR,EAAMQ,EACfN,KAAKO,EAAIT,EAAMS,EACfP,KAAKQ,EAAIV,EAAMU,CACnB,CAMA,gBAAOC,CAAUC,GACb,GAAqB,IAAjBA,EAAMC,OACN,MAAM,IAAIC,MAAM,eAGpB,MAAMC,EACsBC,EAAUJ,GAGtC,GAAsB,GAAlBG,EAAQF,OACR,MAAM,IAAIC,MAAM,qCAGpB,OAAO,IAAIjB,EAA8B,CACrCM,MAAOc,EAAkCF,EAAQ,IACjDX,SAAUa,EAAkCF,EAAQ,IACpDV,SAAUY,EAAkCF,EAAQ,IACpDT,GAAIW,EAAkCF,EAAQ,IAC9CR,MAAOU,EAAkCF,EAAQ,IACjDG,SAAUD,EAAkCF,EAAQ,IACpDP,EAAGS,EAAkCF,EAAQ,IAC7CN,EAAGQ,EAAkCF,EAAQ,IAC7CL,EAAGO,EAAkCF,EAAQ,KAErD,CAKA,OAAAI,GACI,OAAOF,EACHG,EAAU,CACNlB,KAAKC,MACLD,KAAKE,SACLF,KAAKG,SACLH,KAAKI,GACLJ,KAAKK,MACLL,KAAKgB,SACLhB,KAAKM,EACLN,KAAKO,EACLP,KAAKQ,IAGjB,CAKA,QAAAW,GACI,OAAOC,KAAKC,UAAUrB,KAAKsB,SAAU,KAAM,EAC/C,CAKA,MAAAA,GACI,MAAO,CACHrB,MAAOsB,EAAWvB,KAAKC,OACvBC,SAAUqB,EAAWvB,KAAKE,UAC1BC,SAAUoB,EAAWvB,KAAKG,UAC1BC,GAAImB,EAAWvB,KAAKI,IACpBC,MAAOkB,EAAWvB,KAAKK,OACvBW,SAAUO,EAAWvB,KAAKgB,UAC1BV,EAAGiB,EAAWvB,KAAKM,GACnBC,EAAGgB,EAAWvB,KAAKO,GACnBC,EAAGe,EAAWvB,KAAKQ,GAE3B,EAGJgB,EAAMC,0CAA2Cf,GAC7Cf,EAA8Bc,UAAUC"}

package/lib/file/FileAppendTransaction.cjs

@@ -72,6 +72,13 @@ class FileAppendTransaction extends _Transaction.default {
     this._maxChunks = 20;
 
     /**
+     * The default chunk size in bytes for file append operations.
+     *
+     * The network limits total transaction size (SignedTransaction) to 6144 bytes.
+     * Each Ed25519 signature adds ~102 bytes of overhead (pubKeyPrefix + signature + wrapping).
+     * With 4096-byte chunks, transactions fit within the limit for up to ~19 signatures.
+     * For files requiring more signers, callers should use setChunkSize() with a smaller value.
+     *
      * @private
      * @type {number}
      */

package/lib/file/FileAppendTransaction.d.ts

@@ -63,6 +63,13 @@ export default class FileAppendTransaction extends Transaction {
      */
     private _maxChunks;
     /**
+     * The default chunk size in bytes for file append operations.
+     *
+     * The network limits total transaction size (SignedTransaction) to 6144 bytes.
+     * Each Ed25519 signature adds ~102 bytes of overhead (pubKeyPrefix + signature + wrapping).
+     * With 4096-byte chunks, transactions fit within the limit for up to ~19 signatures.
+     * For files requiring more signers, callers should use setChunkSize() with a smaller value.
+     *
      * @private
      * @type {number}
      */

package/lib/file/FileAppendTransaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"FileAppendTransaction.js","sources":["../../src/file/FileAppendTransaction.js"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\nimport Hbar from \"../Hbar.js\";\nimport Transaction, {\n    TRANSACTION_REGISTRY,\n} from \"../transaction/Transaction.js\";\nimport * as utf8 from \"../encoding/utf8.js\";\nimport FileId from \"./FileId.js\";\nimport TransactionId from \"../transaction/TransactionId.js\";\nimport Timestamp from \"../Timestamp.js\";\nimport List from \"../transaction/List.js\";\nimport AccountId from \"../account/AccountId.js\";\n\n/**\n * @namespace proto\n * @typedef {import(\"@hiero-ledger/proto\").proto.ITransaction} HieroProto.proto.ITransaction\n * @typedef {import(\"@hiero-ledger/proto\").proto.ISignedTransaction} HieroProto.proto.ISignedTransaction\n * @typedef {import(\"@hiero-ledger/proto\").proto.TransactionBody} HieroProto.proto.TransactionBody\n * @typedef {import(\"@hiero-ledger/proto\").proto.ITransactionBody} HieroProto.proto.ITransactionBody\n * @typedef {import(\"@hiero-ledger/proto\").proto.ITransactionResponse} HieroProto.proto.ITransactionResponse\n * @typedef {import(\"@hiero-ledger/proto\").proto.IFileAppendTransactionBody} HieroProto.proto.IFileAppendTransactionBody\n * @typedef {import(\"@hiero-ledger/proto\").proto.IFileID} HieroProto.proto.IFileID\n */\n\n/**\n * @typedef {import(\"../PublicKey.js\").default} PublicKey\n * @typedef {import(\"../channel/Channel.js\").default} Channel\n * @typedef {import(\"../channel/MirrorChannel.js\").default} MirrorChannel\n * @typedef {import(\"../client/Client.js\").default<Channel, MirrorChannel>} Client\n * @typedef {import(\"../transaction/TransactionResponse.js\").default} TransactionResponse\n * @typedef {import(\"../schedule/ScheduleCreateTransaction.js\").default} ScheduleCreateTransaction\n */\n\n/**\n * A transaction specifically to append data to a file on the network.\n *\n * If a file has multiple keys, all keys must sign to modify its contents.\n */\nexport default class FileAppendTransaction extends Transaction {\n    /**\n     * @param {object} [props]\n     * @param {FileId | string} [props.fileId]\n     * @param {Uint8Array | string} [props.contents]\n     * @param {number} [props.maxChunks]\n     * @param {number} [props.chunkSize]\n     * @param {number} [props.chunkInterval]\n     */\n    constructor(props = {}) {\n        super();\n\n        /**\n         * @private\n         * @type {?FileId}\n         */\n        this._fileId = null;\n\n        /**\n         * @private\n         * @type {?Uint8Array}\n         */\n        this._contents = null;\n\n        /**\n         * @private\n         * @type {number}\n         */\n        this._maxChunks = 20;\n\n        /**\n         * @private\n         * @type {number}\n         */\n        this._chunkSize = 4096;\n\n        /**\n         * @private\n         * @type {number}\n         */\n        this._chunkInterval = 10;\n\n        this._defaultMaxTransactionFee = new Hbar(5);\n\n        if (props.fileId != null) {\n            this.setFileId(props.fileId);\n        }\n\n        if (props.contents != null) {\n            this.setContents(props.contents);\n        }\n\n        if (props.maxChunks != null) {\n            this.setMaxChunks(props.maxChunks);\n        }\n\n        if (props.chunkSize != null) {\n            this.setChunkSize(props.chunkSize);\n        }\n\n        if (props.chunkInterval != null) {\n            this.setChunkInterval(props.chunkInterval);\n        }\n\n        /** @type {List<TransactionId>} */\n        this._transactionIds = new List();\n    }\n\n    /**\n     * @internal\n     * @param {HieroProto.proto.ITransaction[]} transactions\n     * @param {HieroProto.proto.ISignedTransaction[]} signedTransactions\n     * @param {TransactionId[]} transactionIds\n     * @param {AccountId[]} nodeIds\n     * @param {HieroProto.proto.ITransactionBody[]} bodies\n     * @returns {FileAppendTransaction}\n     */\n    static _fromProtobuf(\n        transactions,\n        signedTransactions,\n        transactionIds,\n        nodeIds,\n        bodies,\n    ) {\n        const body = bodies[0];\n        const append =\n            /** @type {HieroProto.proto.IFileAppendTransactionBody} */ (\n                body.fileAppend\n            );\n\n        let contents;\n\n        // The increment value depends on whether the node IDs list is empty or not.\n        // The node IDs list is not empty if the transaction has been frozen\n        // before serialization and deserialization, otherwise, it's empty.\n        const incrementValue = nodeIds.length > 0 ? nodeIds.length : 1;\n\n        for (let i = 0; i < bodies.length; i += incrementValue) {\n            const fileAppend =\n                /** @type {HieroProto.proto.IFileAppendTransactionBody} */ (\n                    bodies[i].fileAppend\n                );\n            if (fileAppend.contents == null) {\n                break;\n            }\n\n            if (contents == null) {\n                contents = new Uint8Array(\n                    /** @type {Uint8Array} */ (fileAppend.contents),\n                );\n                continue;\n            }\n\n            /** @type {Uint8Array} */\n            const concat = new Uint8Array(\n                contents.length +\n                    /** @type {Uint8Array} */ (fileAppend.contents).length,\n            );\n            concat.set(contents, 0);\n            concat.set(\n                /** @type {Uint8Array} */ (fileAppend.contents),\n                contents.length,\n            );\n            contents = concat;\n        }\n        const chunkSize = append.contents?.length || undefined;\n        const maxChunks = bodies.length\n            ? bodies.length / incrementValue\n            : undefined;\n        let chunkInterval;\n        if (transactionIds.length > 1) {\n            const firstValidStart = transactionIds[0].validStart;\n            const secondValidStart = transactionIds[1].validStart;\n            if (firstValidStart && secondValidStart) {\n                chunkInterval = secondValidStart.nanos\n                    .sub(firstValidStart.nanos)\n                    .toNumber();\n            }\n        }\n\n        return Transaction._fromProtobufTransactions(\n            new FileAppendTransaction({\n                fileId:\n                    append.fileID != null\n                        ? FileId._fromProtobuf(\n                              /** @type {HieroProto.proto.IFileID} */ (\n                                  append.fileID\n                              ),\n                          )\n                        : undefined,\n                contents,\n                chunkSize,\n                maxChunks,\n                chunkInterval,\n            }),\n            transactions,\n            signedTransactions,\n            transactionIds,\n            nodeIds,\n            bodies,\n        );\n    }\n\n    /**\n     * @returns {?FileId}\n     */\n    get fileId() {\n        return this._fileId;\n    }\n\n    /**\n     * Set the keys which must sign any transactions modifying this file. Required.\n     *\n     * All keys must sign to modify the file's contents or keys. No key is required\n     * to sign for extending the expiration time (except the one for the operator account\n     * paying for the transaction). Only one key must sign to delete the file, however.\n     *\n     * To require more than one key to sign to delete a file, add them to a\n     * KeyList and pass that here.\n     *\n     * The network currently requires a file to have at least one key (or key list or threshold key)\n     * but this requirement may be lifted in the future.\n     *\n     * @param {FileId | string} fileId\n     * @returns {this}\n     */\n    setFileId(fileId) {\n        this._requireNotFrozen();\n        this._fileId =\n            typeof fileId === \"string\"\n                ? FileId.fromString(fileId)\n                : fileId.clone();\n\n        return this;\n    }\n\n    /**\n     * @override\n     * @returns {number}\n     */\n    getRequiredChunks() {\n        if (this._contents == null) {\n            return 1;\n        }\n\n        const result = Math.ceil(this._contents.length / this._chunkSize);\n\n        return result;\n    }\n\n    /**\n     * @returns {?Uint8Array}\n     */\n    get contents() {\n        return this._contents;\n    }\n\n    /**\n     * Set the given byte array as the file's contents.\n     *\n     * This may be omitted to append an empty file.\n     *\n     * Note that total size for a given transaction is limited to 6KiB (as of March 2020) by the\n     * network; if you exceed this you may receive a HederaPreCheckStatusException\n     * with Status#TransactionOversize.\n     *\n     * In this case, you will need to break the data into chunks of less than ~6KiB and execute this\n     * transaction with the first chunk and then use FileAppendTransaction with\n     * FileAppendTransaction#setContents(Uint8Array) for the remaining chunks.\n     *\n     * @param {Uint8Array | string} contents\n     * @returns {this}\n     */\n    setContents(contents) {\n        this._requireNotFrozen();\n        this._contents =\n            contents instanceof Uint8Array ? contents : utf8.encode(contents);\n\n        return this;\n    }\n\n    /**\n     * @returns {?number}\n     */\n    get maxChunks() {\n        return this._maxChunks;\n    }\n\n    /**\n     * @param {number} maxChunks\n     * @returns {this}\n     */\n    setMaxChunks(maxChunks) {\n        if (maxChunks <= 0) {\n            throw new Error(\"Max chunks must be greater than 0\");\n        }\n        this._requireNotFrozen();\n        this._maxChunks = maxChunks;\n        return this;\n    }\n\n    /**\n     * @returns {?number}\n     */\n    get chunkSize() {\n        return this._chunkSize;\n    }\n\n    /**\n     * @param {number} chunkSize\n     * @returns {this}\n     */\n    setChunkSize(chunkSize) {\n        if (chunkSize <= 0) {\n            throw new Error(\"Chunk size must be greater than 0\");\n        }\n        this._chunkSize = chunkSize;\n        return this;\n    }\n\n    /**\n     * @returns {number}\n     */\n    get chunkInterval() {\n        return this._chunkInterval;\n    }\n\n    /**\n     * @param {number} chunkInterval The valid start interval between chunks in nanoseconds\n     * @returns {this}\n     */\n    setChunkInterval(chunkInterval) {\n        this._chunkInterval = chunkInterval;\n        return this;\n    }\n\n    /**\n     * Freeze this transaction from further modification to prepare for\n     * signing or serialization.\n     *\n     * Will use the `Client`, if available, to generate a default Transaction ID and select 1/3\n     * nodes to prepare this transaction for.\n     *\n     * @param {?Client} client\n     * @returns {this}\n     */\n    freezeWith(client) {\n        super.freezeWith(client);\n\n        if (this._contents == null) {\n            return this;\n        }\n\n        let nextTransactionId = this._getTransactionId();\n\n        // Hack around the locked list. Should refactor a bit to remove such code\n        this._transactionIds.locked = false;\n\n        this._transactions.clear();\n        this._transactionIds.clear();\n        this._signedTransactions.clear();\n\n        for (let chunk = 0; chunk < this.getRequiredChunks(); chunk++) {\n            this._transactionIds.push(nextTransactionId);\n            this._transactionIds.advance();\n\n            for (const nodeAccountId of this._nodeAccountIds.list) {\n                this._signedTransactions.push(\n                    this._makeSignedTransaction(nodeAccountId),\n                );\n            }\n\n            nextTransactionId = new TransactionId(\n                /** @type {AccountId} */ (nextTransactionId.accountId),\n                new Timestamp(\n                    /** @type {Timestamp} */ (\n                        nextTransactionId.validStart\n                    ).seconds,\n                    /** @type {Timestamp} */ (\n                        nextTransactionId.validStart\n                    ).nanos.add(this._chunkInterval),\n                ),\n            );\n        }\n\n        this._transactionIds.advance();\n        this._transactionIds.setLocked();\n\n        return this;\n    }\n\n    /**\n     * @returns {ScheduleCreateTransaction}\n     */\n    schedule() {\n        this._requireNotFrozen();\n\n        if (this._contents != null && this._contents.length > this._chunkSize) {\n            throw new Error(\n                `cannot schedule \\`FileAppendTransaction\\` with message over ${this._chunkSize} bytes`,\n            );\n        }\n\n        return super.schedule();\n    }\n\n    /**\n     * @param {Client} client\n     * @param {number=} requestTimeout\n     * @returns {Promise<TransactionResponse>}\n     */\n    async execute(client, requestTimeout) {\n        return (await this.executeAll(client, requestTimeout))[0];\n    }\n\n    /**\n     * @param {Client} client\n     * @param {number=} requestTimeout\n     * @returns {Promise<TransactionResponse[]>}\n     */\n    async executeAll(client, requestTimeout) {\n        if (this.maxChunks && this.getRequiredChunks() > this.maxChunks) {\n            throw new Error(\n                `cannot execute \\`FileAppendTransaction\\` with more than ${this.maxChunks} chunks`,\n            );\n        }\n\n        if (!super._isFrozen()) {\n            this.freezeWith(client);\n        }\n\n        // on execute, sign each transaction with the operator, if present\n        // and we are signing a transaction that used the default transaction ID\n\n        const transactionId = this._getTransactionId();\n        const operatorAccountId = client.operatorAccountId;\n\n        if (\n            operatorAccountId != null &&\n            operatorAccountId.equals(\n                /** @type {AccountId} */ (transactionId.accountId),\n            )\n        ) {\n            await super.signWithOperator(client);\n        }\n\n        const responses = [];\n        let remainingTimeout = requestTimeout;\n\n        for (let i = 0; i < this._transactionIds.length; i++) {\n            const startTimestamp = Date.now();\n            const response = await super.execute(client, remainingTimeout);\n\n            if (remainingTimeout != null) {\n                remainingTimeout = Date.now() - startTimestamp;\n            }\n\n            await response.getReceipt(client);\n            responses.push(response);\n        }\n\n        return responses;\n    }\n\n    /**\n     * @param {Client} client\n     */\n    _validateChecksums(client) {\n        if (this._fileId != null) {\n            this._fileId.validateChecksum(client);\n        }\n    }\n\n    /**\n     * @override\n     * @internal\n     * @param {Channel} channel\n     * @param {HieroProto.proto.ITransaction} request\n     * @returns {Promise<HieroProto.proto.ITransactionResponse>}\n     */\n    _execute(channel, request) {\n        return channel.file.appendContent(request);\n    }\n\n    /**\n     * @override\n     * @protected\n     * @returns {NonNullable<HieroProto.proto.TransactionBody[\"data\"]>}\n     */\n    _getTransactionDataCase() {\n        return \"fileAppend\";\n    }\n\n    /**\n     * Build all the transactions\n     * when transactions are not complete.\n     * @override\n     * @internal\n     */\n    _buildIncompleteTransactions() {\n        const dummyAccountId = AccountId.fromString(\"0.0.0\");\n        const accountId = this.transactionId?.accountId || dummyAccountId;\n        const validStart =\n            this.transactionId?.validStart || Timestamp.fromDate(new Date());\n\n        if (this.maxChunks && this.getRequiredChunks() > this.maxChunks) {\n            throw new Error(\n                `cannot build \\`FileAppendTransaction\\` with more than ${this.maxChunks} chunks`,\n            );\n        }\n\n        // Hack around the locked list. Should refactor a bit to remove such code\n        this._transactionIds.locked = false;\n\n        this._transactions.clear();\n        this._transactionIds.clear();\n        this._signedTransactions.clear();\n\n        for (let chunk = 0; chunk < this.getRequiredChunks(); chunk++) {\n            let nextTransactionId = TransactionId.withValidStart(\n                accountId,\n                validStart.plusNanos(this._chunkInterval * chunk),\n            );\n            this._transactionIds.push(nextTransactionId);\n            this._transactionIds.advance();\n\n            if (this._nodeAccountIds.list.length === 0) {\n                this._transactions.push(this._makeSignedTransaction(null));\n            } else {\n                for (const nodeAccountId of this._nodeAccountIds.list) {\n                    this._transactions.push(\n                        this._makeSignedTransaction(nodeAccountId),\n                    );\n                }\n            }\n        }\n\n        this._transactionIds.advance();\n        this._transactionIds.setLocked();\n    }\n\n    /**\n     * Build all the signed transactions\n     * @override\n     * @internal\n     */\n    _buildAllTransactions() {\n        if (this.maxChunks && this.getRequiredChunks() > this.maxChunks) {\n            throw new Error(\n                `cannot build \\`FileAppendTransaction\\` with more than ${this.maxChunks} chunks`,\n            );\n        }\n        for (let i = 0; i < this._signedTransactions.length; i++) {\n            this._buildTransaction(i);\n        }\n    }\n\n    /**\n     * @returns {string}\n     */\n    _getLogId() {\n        const timestamp = /** @type {import(\"../Timestamp.js\").default} */ (\n            this._transactionIds.current.validStart\n        );\n        return `FileAppendTransaction:${timestamp.toString()}`;\n    }\n\n    /**\n     * @override\n     * @protected\n     * @returns {HieroProto.proto.IFileAppendTransactionBody}\n     */\n    _makeTransactionData() {\n        const length = this._contents != null ? this._contents.length : 0;\n        const startIndex = this._transactionIds.index * this._chunkSize;\n        const endIndex = Math.min(startIndex + this._chunkSize, length);\n\n        return {\n            fileID: this._fileId != null ? this._fileId._toProtobuf() : null,\n            contents:\n                this._contents != null\n                    ? this._contents.slice(startIndex, endIndex)\n                    : null,\n        };\n    }\n}\n\n// eslint-disable-next-line @typescript-eslint/unbound-method\nTRANSACTION_REGISTRY.set(\"fileAppend\", FileAppendTransaction._fromProtobuf);\n"],"names":["FileAppendTransaction","Transaction","constructor","props","super","this","_fileId","_contents","_maxChunks","_chunkSize","_chunkInterval","_defaultMaxTransactionFee","Hbar","fileId","setFileId","contents","setContents","maxChunks","setMaxChunks","chunkSize","setChunkSize","chunkInterval","setChunkInterval","_transactionIds","List","_fromProtobuf","transactions","signedTransactions","transactionIds","nodeIds","bodies","append","incrementValue","length","i","fileAppend","Uint8Array","concat","set","undefined","firstValidStart","validStart","secondValidStart","nanos","sub","toNumber","_fromProtobufTransactions","fileID","FileId","_requireNotFrozen","fromString","clone","getRequiredChunks","Math","ceil","utf8.encode","Error","freezeWith","client","nextTransactionId","_getTransactionId","locked","_transactions","clear","_signedTransactions","chunk","push","advance","nodeAccountId","_nodeAccountIds","list","_makeSignedTransaction","TransactionId","Timestamp","seconds","add","setLocked","schedule","execute","requestTimeout","executeAll","_isFrozen","transactionId","operatorAccountId","equals","signWithOperator","responses","remainingTimeout","startTimestamp","Date","now","response","getReceipt","_validateChecksums","validateChecksum","_execute","channel","request","file","appendContent","_getTransactionDataCase","_buildIncompleteTransactions","dummyAccountId","AccountId","accountId","fromDate","withValidStart","plusNanos","_buildAllTransactions","_buildTransaction","_getLogId","current","toString","_makeTransactionData","startIndex","index","endIndex","min","_toProtobuf","slice","TRANSACTION_REGISTRY"],"mappings":"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"}
+{"version":3,"file":"FileAppendTransaction.js","sources":["../../src/file/FileAppendTransaction.js"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\nimport Hbar from \"../Hbar.js\";\nimport Transaction, {\n    TRANSACTION_REGISTRY,\n} from \"../transaction/Transaction.js\";\nimport * as utf8 from \"../encoding/utf8.js\";\nimport FileId from \"./FileId.js\";\nimport TransactionId from \"../transaction/TransactionId.js\";\nimport Timestamp from \"../Timestamp.js\";\nimport List from \"../transaction/List.js\";\nimport AccountId from \"../account/AccountId.js\";\n\n/**\n * @namespace proto\n * @typedef {import(\"@hiero-ledger/proto\").proto.ITransaction} HieroProto.proto.ITransaction\n * @typedef {import(\"@hiero-ledger/proto\").proto.ISignedTransaction} HieroProto.proto.ISignedTransaction\n * @typedef {import(\"@hiero-ledger/proto\").proto.TransactionBody} HieroProto.proto.TransactionBody\n * @typedef {import(\"@hiero-ledger/proto\").proto.ITransactionBody} HieroProto.proto.ITransactionBody\n * @typedef {import(\"@hiero-ledger/proto\").proto.ITransactionResponse} HieroProto.proto.ITransactionResponse\n * @typedef {import(\"@hiero-ledger/proto\").proto.IFileAppendTransactionBody} HieroProto.proto.IFileAppendTransactionBody\n * @typedef {import(\"@hiero-ledger/proto\").proto.IFileID} HieroProto.proto.IFileID\n */\n\n/**\n * @typedef {import(\"../PublicKey.js\").default} PublicKey\n * @typedef {import(\"../channel/Channel.js\").default} Channel\n * @typedef {import(\"../channel/MirrorChannel.js\").default} MirrorChannel\n * @typedef {import(\"../client/Client.js\").default<Channel, MirrorChannel>} Client\n * @typedef {import(\"../transaction/TransactionResponse.js\").default} TransactionResponse\n * @typedef {import(\"../schedule/ScheduleCreateTransaction.js\").default} ScheduleCreateTransaction\n */\n\n/**\n * A transaction specifically to append data to a file on the network.\n *\n * If a file has multiple keys, all keys must sign to modify its contents.\n */\nexport default class FileAppendTransaction extends Transaction {\n    /**\n     * @param {object} [props]\n     * @param {FileId | string} [props.fileId]\n     * @param {Uint8Array | string} [props.contents]\n     * @param {number} [props.maxChunks]\n     * @param {number} [props.chunkSize]\n     * @param {number} [props.chunkInterval]\n     */\n    constructor(props = {}) {\n        super();\n\n        /**\n         * @private\n         * @type {?FileId}\n         */\n        this._fileId = null;\n\n        /**\n         * @private\n         * @type {?Uint8Array}\n         */\n        this._contents = null;\n\n        /**\n         * @private\n         * @type {number}\n         */\n        this._maxChunks = 20;\n\n        /**\n         * The default chunk size in bytes for file append operations.\n         *\n         * The network limits total transaction size (SignedTransaction) to 6144 bytes.\n         * Each Ed25519 signature adds ~102 bytes of overhead (pubKeyPrefix + signature + wrapping).\n         * With 4096-byte chunks, transactions fit within the limit for up to ~19 signatures.\n         * For files requiring more signers, callers should use setChunkSize() with a smaller value.\n         *\n         * @private\n         * @type {number}\n         */\n        this._chunkSize = 4096;\n\n        /**\n         * @private\n         * @type {number}\n         */\n        this._chunkInterval = 10;\n\n        this._defaultMaxTransactionFee = new Hbar(5);\n\n        if (props.fileId != null) {\n            this.setFileId(props.fileId);\n        }\n\n        if (props.contents != null) {\n            this.setContents(props.contents);\n        }\n\n        if (props.maxChunks != null) {\n            this.setMaxChunks(props.maxChunks);\n        }\n\n        if (props.chunkSize != null) {\n            this.setChunkSize(props.chunkSize);\n        }\n\n        if (props.chunkInterval != null) {\n            this.setChunkInterval(props.chunkInterval);\n        }\n\n        /** @type {List<TransactionId>} */\n        this._transactionIds = new List();\n    }\n\n    /**\n     * @internal\n     * @param {HieroProto.proto.ITransaction[]} transactions\n     * @param {HieroProto.proto.ISignedTransaction[]} signedTransactions\n     * @param {TransactionId[]} transactionIds\n     * @param {AccountId[]} nodeIds\n     * @param {HieroProto.proto.ITransactionBody[]} bodies\n     * @returns {FileAppendTransaction}\n     */\n    static _fromProtobuf(\n        transactions,\n        signedTransactions,\n        transactionIds,\n        nodeIds,\n        bodies,\n    ) {\n        const body = bodies[0];\n        const append =\n            /** @type {HieroProto.proto.IFileAppendTransactionBody} */ (\n                body.fileAppend\n            );\n\n        let contents;\n\n        // The increment value depends on whether the node IDs list is empty or not.\n        // The node IDs list is not empty if the transaction has been frozen\n        // before serialization and deserialization, otherwise, it's empty.\n        const incrementValue = nodeIds.length > 0 ? nodeIds.length : 1;\n\n        for (let i = 0; i < bodies.length; i += incrementValue) {\n            const fileAppend =\n                /** @type {HieroProto.proto.IFileAppendTransactionBody} */ (\n                    bodies[i].fileAppend\n                );\n            if (fileAppend.contents == null) {\n                break;\n            }\n\n            if (contents == null) {\n                contents = new Uint8Array(\n                    /** @type {Uint8Array} */ (fileAppend.contents),\n                );\n                continue;\n            }\n\n            /** @type {Uint8Array} */\n            const concat = new Uint8Array(\n                contents.length +\n                    /** @type {Uint8Array} */ (fileAppend.contents).length,\n            );\n            concat.set(contents, 0);\n            concat.set(\n                /** @type {Uint8Array} */ (fileAppend.contents),\n                contents.length,\n            );\n            contents = concat;\n        }\n        const chunkSize = append.contents?.length || undefined;\n        const maxChunks = bodies.length\n            ? bodies.length / incrementValue\n            : undefined;\n        let chunkInterval;\n        if (transactionIds.length > 1) {\n            const firstValidStart = transactionIds[0].validStart;\n            const secondValidStart = transactionIds[1].validStart;\n            if (firstValidStart && secondValidStart) {\n                chunkInterval = secondValidStart.nanos\n                    .sub(firstValidStart.nanos)\n                    .toNumber();\n            }\n        }\n\n        return Transaction._fromProtobufTransactions(\n            new FileAppendTransaction({\n                fileId:\n                    append.fileID != null\n                        ? FileId._fromProtobuf(\n                              /** @type {HieroProto.proto.IFileID} */ (\n                                  append.fileID\n                              ),\n                          )\n                        : undefined,\n                contents,\n                chunkSize,\n                maxChunks,\n                chunkInterval,\n            }),\n            transactions,\n            signedTransactions,\n            transactionIds,\n            nodeIds,\n            bodies,\n        );\n    }\n\n    /**\n     * @returns {?FileId}\n     */\n    get fileId() {\n        return this._fileId;\n    }\n\n    /**\n     * Set the keys which must sign any transactions modifying this file. Required.\n     *\n     * All keys must sign to modify the file's contents or keys. No key is required\n     * to sign for extending the expiration time (except the one for the operator account\n     * paying for the transaction). Only one key must sign to delete the file, however.\n     *\n     * To require more than one key to sign to delete a file, add them to a\n     * KeyList and pass that here.\n     *\n     * The network currently requires a file to have at least one key (or key list or threshold key)\n     * but this requirement may be lifted in the future.\n     *\n     * @param {FileId | string} fileId\n     * @returns {this}\n     */\n    setFileId(fileId) {\n        this._requireNotFrozen();\n        this._fileId =\n            typeof fileId === \"string\"\n                ? FileId.fromString(fileId)\n                : fileId.clone();\n\n        return this;\n    }\n\n    /**\n     * @override\n     * @returns {number}\n     */\n    getRequiredChunks() {\n        if (this._contents == null) {\n            return 1;\n        }\n\n        const result = Math.ceil(this._contents.length / this._chunkSize);\n\n        return result;\n    }\n\n    /**\n     * @returns {?Uint8Array}\n     */\n    get contents() {\n        return this._contents;\n    }\n\n    /**\n     * Set the given byte array as the file's contents.\n     *\n     * This may be omitted to append an empty file.\n     *\n     * Note that total size for a given transaction is limited to 6KiB (as of March 2020) by the\n     * network; if you exceed this you may receive a HederaPreCheckStatusException\n     * with Status#TransactionOversize.\n     *\n     * In this case, you will need to break the data into chunks of less than ~6KiB and execute this\n     * transaction with the first chunk and then use FileAppendTransaction with\n     * FileAppendTransaction#setContents(Uint8Array) for the remaining chunks.\n     *\n     * @param {Uint8Array | string} contents\n     * @returns {this}\n     */\n    setContents(contents) {\n        this._requireNotFrozen();\n        this._contents =\n            contents instanceof Uint8Array ? contents : utf8.encode(contents);\n\n        return this;\n    }\n\n    /**\n     * @returns {?number}\n     */\n    get maxChunks() {\n        return this._maxChunks;\n    }\n\n    /**\n     * @param {number} maxChunks\n     * @returns {this}\n     */\n    setMaxChunks(maxChunks) {\n        if (maxChunks <= 0) {\n            throw new Error(\"Max chunks must be greater than 0\");\n        }\n        this._requireNotFrozen();\n        this._maxChunks = maxChunks;\n        return this;\n    }\n\n    /**\n     * @returns {?number}\n     */\n    get chunkSize() {\n        return this._chunkSize;\n    }\n\n    /**\n     * @param {number} chunkSize\n     * @returns {this}\n     */\n    setChunkSize(chunkSize) {\n        if (chunkSize <= 0) {\n            throw new Error(\"Chunk size must be greater than 0\");\n        }\n        this._chunkSize = chunkSize;\n        return this;\n    }\n\n    /**\n     * @returns {number}\n     */\n    get chunkInterval() {\n        return this._chunkInterval;\n    }\n\n    /**\n     * @param {number} chunkInterval The valid start interval between chunks in nanoseconds\n     * @returns {this}\n     */\n    setChunkInterval(chunkInterval) {\n        this._chunkInterval = chunkInterval;\n        return this;\n    }\n\n    /**\n     * Freeze this transaction from further modification to prepare for\n     * signing or serialization.\n     *\n     * Will use the `Client`, if available, to generate a default Transaction ID and select 1/3\n     * nodes to prepare this transaction for.\n     *\n     * @param {?Client} client\n     * @returns {this}\n     */\n    freezeWith(client) {\n        super.freezeWith(client);\n\n        if (this._contents == null) {\n            return this;\n        }\n\n        let nextTransactionId = this._getTransactionId();\n\n        // Hack around the locked list. Should refactor a bit to remove such code\n        this._transactionIds.locked = false;\n\n        this._transactions.clear();\n        this._transactionIds.clear();\n        this._signedTransactions.clear();\n\n        for (let chunk = 0; chunk < this.getRequiredChunks(); chunk++) {\n            this._transactionIds.push(nextTransactionId);\n            this._transactionIds.advance();\n\n            for (const nodeAccountId of this._nodeAccountIds.list) {\n                this._signedTransactions.push(\n                    this._makeSignedTransaction(nodeAccountId),\n                );\n            }\n\n            nextTransactionId = new TransactionId(\n                /** @type {AccountId} */ (nextTransactionId.accountId),\n                new Timestamp(\n                    /** @type {Timestamp} */ (\n                        nextTransactionId.validStart\n                    ).seconds,\n                    /** @type {Timestamp} */ (\n                        nextTransactionId.validStart\n                    ).nanos.add(this._chunkInterval),\n                ),\n            );\n        }\n\n        this._transactionIds.advance();\n        this._transactionIds.setLocked();\n\n        return this;\n    }\n\n    /**\n     * @returns {ScheduleCreateTransaction}\n     */\n    schedule() {\n        this._requireNotFrozen();\n\n        if (this._contents != null && this._contents.length > this._chunkSize) {\n            throw new Error(\n                `cannot schedule \\`FileAppendTransaction\\` with message over ${this._chunkSize} bytes`,\n            );\n        }\n\n        return super.schedule();\n    }\n\n    /**\n     * @param {Client} client\n     * @param {number=} requestTimeout\n     * @returns {Promise<TransactionResponse>}\n     */\n    async execute(client, requestTimeout) {\n        return (await this.executeAll(client, requestTimeout))[0];\n    }\n\n    /**\n     * @param {Client} client\n     * @param {number=} requestTimeout\n     * @returns {Promise<TransactionResponse[]>}\n     */\n    async executeAll(client, requestTimeout) {\n        if (this.maxChunks && this.getRequiredChunks() > this.maxChunks) {\n            throw new Error(\n                `cannot execute \\`FileAppendTransaction\\` with more than ${this.maxChunks} chunks`,\n            );\n        }\n\n        if (!super._isFrozen()) {\n            this.freezeWith(client);\n        }\n\n        // on execute, sign each transaction with the operator, if present\n        // and we are signing a transaction that used the default transaction ID\n\n        const transactionId = this._getTransactionId();\n        const operatorAccountId = client.operatorAccountId;\n\n        if (\n            operatorAccountId != null &&\n            operatorAccountId.equals(\n                /** @type {AccountId} */ (transactionId.accountId),\n            )\n        ) {\n            await super.signWithOperator(client);\n        }\n\n        const responses = [];\n        let remainingTimeout = requestTimeout;\n\n        for (let i = 0; i < this._transactionIds.length; i++) {\n            const startTimestamp = Date.now();\n            const response = await super.execute(client, remainingTimeout);\n\n            if (remainingTimeout != null) {\n                remainingTimeout = Date.now() - startTimestamp;\n            }\n\n            await response.getReceipt(client);\n            responses.push(response);\n        }\n\n        return responses;\n    }\n\n    /**\n     * @param {Client} client\n     */\n    _validateChecksums(client) {\n        if (this._fileId != null) {\n            this._fileId.validateChecksum(client);\n        }\n    }\n\n    /**\n     * @override\n     * @internal\n     * @param {Channel} channel\n     * @param {HieroProto.proto.ITransaction} request\n     * @returns {Promise<HieroProto.proto.ITransactionResponse>}\n     */\n    _execute(channel, request) {\n        return channel.file.appendContent(request);\n    }\n\n    /**\n     * @override\n     * @protected\n     * @returns {NonNullable<HieroProto.proto.TransactionBody[\"data\"]>}\n     */\n    _getTransactionDataCase() {\n        return \"fileAppend\";\n    }\n\n    /**\n     * Build all the transactions\n     * when transactions are not complete.\n     * @override\n     * @internal\n     */\n    _buildIncompleteTransactions() {\n        const dummyAccountId = AccountId.fromString(\"0.0.0\");\n        const accountId = this.transactionId?.accountId || dummyAccountId;\n        const validStart =\n            this.transactionId?.validStart || Timestamp.fromDate(new Date());\n\n        if (this.maxChunks && this.getRequiredChunks() > this.maxChunks) {\n            throw new Error(\n                `cannot build \\`FileAppendTransaction\\` with more than ${this.maxChunks} chunks`,\n            );\n        }\n\n        // Hack around the locked list. Should refactor a bit to remove such code\n        this._transactionIds.locked = false;\n\n        this._transactions.clear();\n        this._transactionIds.clear();\n        this._signedTransactions.clear();\n\n        for (let chunk = 0; chunk < this.getRequiredChunks(); chunk++) {\n            let nextTransactionId = TransactionId.withValidStart(\n                accountId,\n                validStart.plusNanos(this._chunkInterval * chunk),\n            );\n            this._transactionIds.push(nextTransactionId);\n            this._transactionIds.advance();\n\n            if (this._nodeAccountIds.list.length === 0) {\n                this._transactions.push(this._makeSignedTransaction(null));\n            } else {\n                for (const nodeAccountId of this._nodeAccountIds.list) {\n                    this._transactions.push(\n                        this._makeSignedTransaction(nodeAccountId),\n                    );\n                }\n            }\n        }\n\n        this._transactionIds.advance();\n        this._transactionIds.setLocked();\n    }\n\n    /**\n     * Build all the signed transactions\n     * @override\n     * @internal\n     */\n    _buildAllTransactions() {\n        if (this.maxChunks && this.getRequiredChunks() > this.maxChunks) {\n            throw new Error(\n                `cannot build \\`FileAppendTransaction\\` with more than ${this.maxChunks} chunks`,\n            );\n        }\n        for (let i = 0; i < this._signedTransactions.length; i++) {\n            this._buildTransaction(i);\n        }\n    }\n\n    /**\n     * @returns {string}\n     */\n    _getLogId() {\n        const timestamp = /** @type {import(\"../Timestamp.js\").default} */ (\n            this._transactionIds.current.validStart\n        );\n        return `FileAppendTransaction:${timestamp.toString()}`;\n    }\n\n    /**\n     * @override\n     * @protected\n     * @returns {HieroProto.proto.IFileAppendTransactionBody}\n     */\n    _makeTransactionData() {\n        const length = this._contents != null ? this._contents.length : 0;\n        const startIndex = this._transactionIds.index * this._chunkSize;\n        const endIndex = Math.min(startIndex + this._chunkSize, length);\n\n        return {\n            fileID: this._fileId != null ? this._fileId._toProtobuf() : null,\n            contents:\n                this._contents != null\n                    ? this._contents.slice(startIndex, endIndex)\n                    : null,\n        };\n    }\n}\n\n// eslint-disable-next-line @typescript-eslint/unbound-method\nTRANSACTION_REGISTRY.set(\"fileAppend\", FileAppendTransaction._fromProtobuf);\n"],"names":["FileAppendTransaction","Transaction","constructor","props","super","this","_fileId","_contents","_maxChunks","_chunkSize","_chunkInterval","_defaultMaxTransactionFee","Hbar","fileId","setFileId","contents","setContents","maxChunks","setMaxChunks","chunkSize","setChunkSize","chunkInterval","setChunkInterval","_transactionIds","List","_fromProtobuf","transactions","signedTransactions","transactionIds","nodeIds","bodies","append","incrementValue","length","i","fileAppend","Uint8Array","concat","set","undefined","firstValidStart","validStart","secondValidStart","nanos","sub","toNumber","_fromProtobufTransactions","fileID","FileId","_requireNotFrozen","fromString","clone","getRequiredChunks","Math","ceil","utf8.encode","Error","freezeWith","client","nextTransactionId","_getTransactionId","locked","_transactions","clear","_signedTransactions","chunk","push","advance","nodeAccountId","_nodeAccountIds","list","_makeSignedTransaction","TransactionId","Timestamp","seconds","add","setLocked","schedule","execute","requestTimeout","executeAll","_isFrozen","transactionId","operatorAccountId","equals","signWithOperator","responses","remainingTimeout","startTimestamp","Date","now","response","getReceipt","_validateChecksums","validateChecksum","_execute","channel","request","file","appendContent","_getTransactionDataCase","_buildIncompleteTransactions","dummyAccountId","AccountId","accountId","fromDate","withValidStart","plusNanos","_buildAllTransactions","_buildTransaction","_getLogId","current","toString","_makeTransactionData","startIndex","index","endIndex","min","_toProtobuf","slice","TRANSACTION_REGISTRY"],"mappings":"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"}

package/lib/version.js

@@ -1,2 +1,2 @@
-const e="hiero-sdk-js",o="2.83.0-beta.1";export{e as SDK_NAME,o as SDK_VERSION};
+const e="hiero-sdk-js",o="2.83.0-beta.2";export{e as SDK_NAME,o as SDK_VERSION};
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hiero-ledger/sdk",
-  "version": "2.83.0-beta.1",
+  "version": "2.83.0-beta.2",
   "description": "Hiero SDK",
   "types": "./lib/index.d.ts",
   "main": "./lib/index.cjs",

package/src/EthereumTransactionDataEip1559.js

@@ -3,6 +3,16 @@ import * as hex from "./encoding/hex.js";
 import EthereumTransactionData from "./EthereumTransactionData.js";
 import CACHE from "./Cache.js";
 
+/**
+ * @typedef {[Uint8Array, Uint8Array[]]} AccessListItem - [address, storageKeys[]]
+ */
+
+/**
+ * @typedef {object} AccessListItemJSON
+ * @property {string} address
+ * @property {string[]} storageKeys
+ */
+
 /**
  * @typedef {object} EthereumTransactionDataEip1559JSON
  * @property {string} chainId
@@ -13,7 +23,7 @@ import CACHE from "./Cache.js";
  * @property {string} to
  * @property {string} value
  * @property {string} callData
- * @property {string[]} accessList
+ * @property {AccessListItemJSON[]} accessList
  * @property {string} recId
  * @property {string} r
  * @property {string} s
@@ -31,7 +41,7 @@ export default class EthereumTransactionDataEip1559 extends EthereumTransactionD
      * @param {Uint8Array} props.to
      * @param {Uint8Array} props.value
      * @param {Uint8Array} props.callData
-     * @param {Uint8Array[]} props.accessList
+     * @param {AccessListItem[]} props.accessList
      * @param {Uint8Array} props.recId
      * @param {Uint8Array} props.r
      * @param {Uint8Array} props.s
@@ -61,8 +71,9 @@ export default class EthereumTransactionDataEip1559 extends EthereumTransactionD
             throw new Error("empty bytes");
         }
 
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-        const decoded = /** @type {string[]} */ (decodeRlp(bytes.subarray(1)));
+        const decoded = /** @type {unknown[]} */ (
+            /** @type {unknown} */ (decodeRlp(bytes.subarray(1)))
+        );
 
         if (!Array.isArray(decoded)) {
             throw new Error("ethereum data is not a list");
@@ -82,9 +93,20 @@ export default class EthereumTransactionDataEip1559 extends EthereumTransactionD
             to: hex.decode(/** @type {string} */ (decoded[5])),
             value: hex.decode(/** @type {string} */ (decoded[6])),
             callData: hex.decode(/** @type {string} */ (decoded[7])),
-            // @ts-ignore
-            accessList: /** @type {string[]} */ (decoded[8]).map((v) =>
-                hex.decode(v),
+            accessList: /** @type {AccessListItem[]} */ (
+                /** @type {Array<[string, string[]]>} */ (
+                    /** @type {unknown} */ (decoded[8])
+                ).map((item) => {
+                    if (!Array.isArray(item) || item.length !== 2) {
+                        throw new Error(
+                            "invalid access list entry: must be [address, storageKeys[]]",
+                        );
+                    }
+                    return [
+                        hex.decode(item[0]),
+                        item[1].map((key) => hex.decode(key)),
+                    ];
+                })
             ),
             recId: hex.decode(/** @type {string} */ (decoded[9])),
             r: hex.decode(/** @type {string} */ (decoded[10])),
@@ -133,7 +155,10 @@ export default class EthereumTransactionDataEip1559 extends EthereumTransactionD
             to: hex.encode(this.to),
             value: hex.encode(this.value),
             callData: hex.encode(this.callData),
-            accessList: this.accessList.map((v) => hex.encode(v)),
+            accessList: this.accessList.map(([address, storageKeys]) => ({
+                address: hex.encode(address),
+                storageKeys: storageKeys.map((key) => hex.encode(key)),
+            })),
             recId: hex.encode(this.recId),
             r: hex.encode(this.r),
             s: hex.encode(this.s),

package/src/EthereumTransactionDataEip2930.js

@@ -3,6 +3,16 @@ import * as hex from "./encoding/hex.js";
 import EthereumTransactionData from "./EthereumTransactionData.js";
 import CACHE from "./Cache.js";
 
+/**
+ * @typedef {[Uint8Array, Uint8Array[]]} AccessListItem - [address, storageKeys[]]
+ */
+
+/**
+ * @typedef {object} AccessListItemJSON
+ * @property {string} address
+ * @property {string[]} storageKeys
+ */
+
 /**
  * @typedef {object} EthereumTransactionDataEip2930JSON
  * @property {string} chainId
@@ -12,7 +22,7 @@ import CACHE from "./Cache.js";
  * @property {string} to
  * @property {string} value
  * @property {string} callData
- * @property {string[]} accessList
+ * @property {AccessListItemJSON[]} accessList
  * @property {string} recId
  * @property {string} r
  * @property {string} s
@@ -29,7 +39,7 @@ export default class EthereumTransactionDataEip2930 extends EthereumTransactionD
      * @param {Uint8Array} props.to
      * @param {Uint8Array} props.value
      * @param {Uint8Array} props.callData
-     * @param {Uint8Array[]} props.accessList
+     * @param {AccessListItem[]} props.accessList
      * @param {Uint8Array} props.recId
      * @param {Uint8Array} props.r
      * @param {Uint8Array} props.s
@@ -58,8 +68,9 @@ export default class EthereumTransactionDataEip2930 extends EthereumTransactionD
             throw new Error("empty bytes");
         }
 
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-        const decoded = /** @type {string[]} */ (decodeRlp(bytes.subarray(1)));
+        const decoded = /** @type {unknown[]} */ (
+            /** @type {unknown} */ (decodeRlp(bytes.subarray(1)))
+        );
 
         if (!Array.isArray(decoded)) {
             throw new Error("ethereum data is not a list");
@@ -78,9 +89,20 @@ export default class EthereumTransactionDataEip2930 extends EthereumTransactionD
             to: hex.decode(/** @type {string} */ (decoded[4])),
             value: hex.decode(/** @type {string} */ (decoded[5])),
             callData: hex.decode(/** @type {string} */ (decoded[6])),
-            // @ts-ignore
-            accessList: /** @type {string[]} */ (decoded[7]).map((v) =>
-                hex.decode(v),
+            accessList: /** @type {AccessListItem[]} */ (
+                /** @type {Array<[string, string[]]>} */ (
+                    /** @type {unknown} */ (decoded[7])
+                ).map((item) => {
+                    if (!Array.isArray(item) || item.length !== 2) {
+                        throw new Error(
+                            "invalid access list entry: must be [address, storageKeys[]]",
+                        );
+                    }
+                    return [
+                        hex.decode(item[0]),
+                        item[1].map((key) => hex.decode(key)),
+                    ];
+                })
             ),
             recId: hex.decode(/** @type {string} */ (decoded[8])),
             r: hex.decode(/** @type {string} */ (decoded[9])),
@@ -127,7 +149,10 @@ export default class EthereumTransactionDataEip2930 extends EthereumTransactionD
             to: hex.encode(this.to),
             value: hex.encode(this.value),
             callData: hex.encode(this.callData),
-            accessList: this.accessList.map((v) => hex.encode(v)),
+            accessList: this.accessList.map(([address, storageKeys]) => ({
+                address: hex.encode(address),
+                storageKeys: storageKeys.map((key) => hex.encode(key)),
+            })),
             recId: hex.encode(this.recId),
             r: hex.encode(this.r),
             s: hex.encode(this.s),

package/src/EthereumTransactionDataEip7702.js

@@ -3,6 +3,20 @@ import * as hex from "./encoding/hex.js";
 import EthereumTransactionData from "./EthereumTransactionData.js";
 import CACHE from "./Cache.js";
 
+/**
+ * @typedef {[Uint8Array, Uint8Array[]]} AccessListItem - [address, storageKeys[]]
+ */
+
+/**
+ * @typedef {[Uint8Array, Uint8Array, Uint8Array, Uint8Array, Uint8Array, Uint8Array]} AuthorizationItem - [chainId, contractAddress, nonce, yParity, r, s]
+ */
+
+/**
+ * @typedef {object} AccessListItemJSON
+ * @property {string} address
+ * @property {string[]} storageKeys
+ */
+
 /**
  * @typedef {object} EthereumTransactionDataEip7702JSON
  * @property {string} chainId
@@ -14,7 +28,7 @@ import CACHE from "./Cache.js";
  * @property {string} value
  * @property {string} callData
  * @property {Array<[string, string, string, string, string, string]>} authorizationList - Array of [chainId, contractAddress, nonce, yParity, r, s] tuples
- * @property {string[]} accessList
+ * @property {AccessListItemJSON[]} accessList
  * @property {string} recId
  * @property {string} r
  * @property {string} s
@@ -32,8 +46,8 @@ export default class EthereumTransactionDataEip7702 extends EthereumTransactionD
      * @param {Uint8Array} props.to
      * @param {Uint8Array} props.value
      * @param {Uint8Array} props.callData
-     * @param {Array<[Uint8Array, Uint8Array, Uint8Array, Uint8Array, Uint8Array, Uint8Array]>} props.authorizationList - Array of [chainId, contractAddress, nonce, yParity, r, s] tuples
-     * @param {Uint8Array[]} props.accessList
+     * @param {AuthorizationItem[]} props.authorizationList - Array of [chainId, contractAddress, nonce, yParity, r, s] tuples
+     * @param {AccessListItem[]} props.accessList
      * @param {Uint8Array} props.recId
      * @param {Uint8Array} props.r
      * @param {Uint8Array} props.s
@@ -65,8 +79,9 @@ export default class EthereumTransactionDataEip7702 extends EthereumTransactionD
             throw new Error("empty bytes");
         }
 
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-        const decoded = /** @type {string[]} */ (decodeRlp(bytes.subarray(1)));
+        const decoded = /** @type {unknown[]} */ (
+            /** @type {unknown} */ (decodeRlp(bytes.subarray(1)))
+        );
 
         if (!Array.isArray(decoded)) {
             throw new Error("ethereum data is not a list");
@@ -81,30 +96,24 @@ export default class EthereumTransactionDataEip7702 extends EthereumTransactionD
         if (!Array.isArray(decoded[9])) {
             throw new Error("authorization list must be an array");
         }
-        // @ts-ignore
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
-        const authorizationList = /** @type {string[]} */ (decoded[9]).map(
-            (authTuple) => {
+        const authorizationList = /** @type {AuthorizationItem[]} */ (
+            /** @type {Array<[string, string, string, string, string, string]>} */ (
+                /** @type {unknown} */ (decoded[9])
+            ).map((authTuple) => {
                 if (!Array.isArray(authTuple) || authTuple.length !== 6) {
                     throw new Error(
                         "invalid authorization list entry: must be [chainId, contractAddress, nonce, yParity, r, s]",
                     );
                 }
                 return [
-                    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
-                    hex.decode(/** @type {string} */ (authTuple[0])), // chainId
-                    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
-                    hex.decode(/** @type {string} */ (authTuple[1])), // contractAddress (20 bytes)
-                    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
-                    hex.decode(/** @type {string} */ (authTuple[2])), // nonce
-                    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
-                    hex.decode(/** @type {string} */ (authTuple[3])), // yParity (0 or 1)
-                    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
-                    hex.decode(/** @type {string} */ (authTuple[4])), // r (32 bytes)
-                    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
-                    hex.decode(/** @type {string} */ (authTuple[5])), // s (32 bytes)
+                    hex.decode(authTuple[0]), // chainId
+                    hex.decode(authTuple[1]), // contractAddress (20 bytes)
+                    hex.decode(authTuple[2]), // nonce
+                    hex.decode(authTuple[3]), // yParity (0 or 1)
+                    hex.decode(authTuple[4]), // r (32 bytes)
+                    hex.decode(authTuple[5]), // s (32 bytes)
                 ];
-            },
+            })
         );
 
         return new EthereumTransactionDataEip7702({
@@ -116,11 +125,21 @@ export default class EthereumTransactionDataEip7702 extends EthereumTransactionD
             to: hex.decode(/** @type {string} */ (decoded[5])),
             value: hex.decode(/** @type {string} */ (decoded[6])),
             callData: hex.decode(/** @type {string} */ (decoded[7])),
-            // @ts-ignore
-            accessList: /** @type {string[]} */ (decoded[8]).map((v) =>
-                hex.decode(v),
+            accessList: /** @type {AccessListItem[]} */ (
+                /** @type {Array<[string, string[]]>} */ (
+                    /** @type {unknown} */ (decoded[8])
+                ).map((item) => {
+                    if (!Array.isArray(item) || item.length !== 2) {
+                        throw new Error(
+                            "invalid access list entry: must be [address, storageKeys[]]",
+                        );
+                    }
+                    return [
+                        hex.decode(item[0]),
+                        item[1].map((key) => hex.decode(key)),
+                    ];
+                })
             ),
-            // @ts-ignore
             authorizationList: authorizationList,
             recId: hex.decode(/** @type {string} */ (decoded[10])),
             r: hex.decode(/** @type {string} */ (decoded[11])),
@@ -180,7 +199,10 @@ export default class EthereumTransactionDataEip7702 extends EthereumTransactionD
                     hex.encode(s),
                 ],
             ),
-            accessList: this.accessList.map((v) => hex.encode(v)),
+            accessList: this.accessList.map(([address, storageKeys]) => ({
+                address: hex.encode(address),
+                storageKeys: storageKeys.map((key) => hex.encode(key)),
+            })),
             recId: hex.encode(this.recId),
             r: hex.encode(this.r),
             s: hex.encode(this.s),

package/src/EthereumTransactionDataLegacy.js

@@ -52,8 +52,9 @@ export default class EthereumTransactionDataLegacy extends EthereumTransactionDa
             throw new Error("empty bytes");
         }
 
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-        const decoded = /** @type {string[]} */ (decodeRlp(bytes));
+        const decoded = /** @type {unknown[]} */ (
+            /** @type {unknown} */ (decodeRlp(bytes))
+        );
 
         if (decoded.length != 9) {
             throw new Error("invalid ethereum transaction data");

package/src/file/FileAppendTransaction.js

@@ -67,6 +67,13 @@ export default class FileAppendTransaction extends Transaction {
         this._maxChunks = 20;
 
         /**
+         * The default chunk size in bytes for file append operations.
+         *
+         * The network limits total transaction size (SignedTransaction) to 6144 bytes.
+         * Each Ed25519 signature adds ~102 bytes of overhead (pubKeyPrefix + signature + wrapping).
+         * With 4096-byte chunks, transactions fit within the limit for up to ~19 signatures.
+         * For files requiring more signers, callers should use setChunkSize() with a smaller value.
+         *
          * @private
          * @type {number}
          */