@hiero-ledger/sdk 2.70.0

package/lib/file/FileAppendTransaction.js.map

@@ -0,0 +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(\"@hashgraph/proto\").proto.ITransaction} HieroProto.proto.ITransaction\n * @typedef {import(\"@hashgraph/proto\").proto.ISignedTransaction} HieroProto.proto.ISignedTransaction\n * @typedef {import(\"@hashgraph/proto\").proto.TransactionBody} HieroProto.proto.TransactionBody\n * @typedef {import(\"@hashgraph/proto\").proto.ITransactionBody} HieroProto.proto.ITransactionBody\n * @typedef {import(\"@hashgraph/proto\").proto.ITransactionResponse} HieroProto.proto.ITransactionResponse\n * @typedef {import(\"@hashgraph/proto\").proto.IFileAppendTransactionBody} HieroProto.proto.IFileAppendTransactionBody\n * @typedef {import(\"@hashgraph/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(\"../client/Client.js\").default<Channel, *>} 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 {?import(\"../client/Client.js\").default<Channel, *>} 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 {import(\"../client/Client.js\").default<Channel, *>} 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 {import(\"../client/Client.js\").default<Channel, *>} 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/file/FileContentsQuery.cjs

@@ -0,0 +1,159 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _Query = _interopRequireWildcard(require("../query/Query.cjs"));
+var _FileId = _interopRequireDefault(require("./FileId.cjs"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+// SPDX-License-Identifier: Apache-2.0
+
+/**
+ * @namespace proto
+ * @typedef {import("@hashgraph/proto").proto.IQuery} HieroProto.proto.IQuery
+ * @typedef {import("@hashgraph/proto").proto.IQueryHeader} HieroProto.proto.IQueryHeader
+ * @typedef {import("@hashgraph/proto").proto.IResponse} HieroProto.proto.IResponse
+ * @typedef {import("@hashgraph/proto").proto.IResponseHeader} HieroProto.proto.IResponseHeader
+ * @typedef {import("@hashgraph/proto").proto.IFileGetContentsQuery} HieroProto.proto.IFileGetContentsQuery
+ * @typedef {import("@hashgraph/proto").proto.IFileGetContentsResponse} HieroProto.proto.IFileGetContentsResponse
+ * @typedef {import("@hashgraph/proto").proto.FileGetContentsResponse.IFileContents} HieroProto.proto.FileGetContentsResponse.IFileContents
+ */
+
+/**
+ * @typedef {import("../channel/Channel.js").default} Channel
+ * @typedef {import("../client/Client.js").default<*, *>} Client
+ * @typedef {import("../account/AccountId.js").default} AccountId
+ */
+
+/**
+ * @augments {Query<Uint8Array>}
+ * Retrieve the content of a file in HFS.<br/>
+ * Note that this query retrieves _only_ the file content, not any of
+ * the metadata for the file.
+ */
+class FileContentsQuery extends _Query.default {
+  /**
+   * @param {object} [props]
+   * @param {FileId | string} [props.fileId]
+   */
+  constructor(props = {}) {
+    super();
+
+    /**
+     * @type {?FileId}
+     * @private
+     */
+    this._fileId = null;
+    if (props.fileId != null) {
+      this.setFileId(props.fileId);
+    }
+  }
+
+  /**
+   * @internal
+   * @param {HieroProto.proto.IQuery} query
+   * @returns {FileContentsQuery}
+   */
+  static _fromProtobuf(query) {
+    const contents = /** @type {HieroProto.proto.IFileGetContentsQuery} */
+    query.fileGetContents;
+    return new FileContentsQuery({
+      fileId: contents.fileID != null ? _FileId.default._fromProtobuf(contents.fileID) : undefined
+    });
+  }
+
+  /**
+   * @param {Client} client
+   */
+  _validateChecksums(client) {
+    if (this._fileId != null) {
+      this._fileId.validateChecksum(client);
+    }
+  }
+
+  /**
+   * @override
+   * @internal
+   * @param {Channel} channel
+   * @param {HieroProto.proto.IQuery} request
+   * @returns {Promise<HieroProto.proto.IResponse>}
+   */
+  _execute(channel, request) {
+    return channel.file.getFileContent(request);
+  }
+
+  /**
+   * @returns {?FileId}
+   */
+  get fileId() {
+    return this._fileId;
+  }
+
+  /**
+   * Set the file ID for which the info is being requested.
+   *
+   * @param {FileId | string} fileId
+   * @returns {FileContentsQuery}
+   */
+  setFileId(fileId) {
+    this._fileId = typeof fileId === "string" ? _FileId.default.fromString(fileId) : fileId.clone();
+    return this;
+  }
+
+  /**
+   * @override
+   * @internal
+   * @param {HieroProto.proto.IResponse} response
+   * @returns {HieroProto.proto.IResponseHeader}
+   */
+  _mapResponseHeader(response) {
+    const fileGetContents = /** @type {HieroProto.proto.IFileGetContentsResponse} */
+    response.fileGetContents;
+    return /** @type {HieroProto.proto.IResponseHeader} */fileGetContents.header;
+  }
+
+  /**
+   * @protected
+   * @override
+   * @param {HieroProto.proto.IResponse} response
+   * @returns {Promise<Uint8Array>}
+   */
+  _mapResponse(response) {
+    const fileContentsResponse = /** @type {HieroProto.proto.IFileGetContentsResponse} */
+    response.fileGetContents;
+    const fileConents = /** @type {HieroProto.proto.FileGetContentsResponse.IFileContents} */
+    fileContentsResponse.fileContents;
+    const contents = /** @type {Uint8Array} */fileConents.contents;
+    return Promise.resolve(contents);
+  }
+
+  /**
+   * @override
+   * @internal
+   * @param {HieroProto.proto.IQueryHeader} header
+   * @returns {HieroProto.proto.IQuery}
+   */
+  _onMakeRequest(header) {
+    return {
+      fileGetContents: {
+        header,
+        fileID: this._fileId != null ? this._fileId._toProtobuf() : null
+      }
+    };
+  }
+
+  /**
+   * @returns {string}
+   */
+  _getLogId() {
+    const timestamp = this._paymentTransactionId != null && this._paymentTransactionId.validStart != null ? this._paymentTransactionId.validStart : this._timestamp;
+    return `FileContentsQuery:${timestamp.toString()}`;
+  }
+}
+
+// eslint-disable-next-line @typescript-eslint/unbound-method
+exports.default = FileContentsQuery;
+_Query.QUERY_REGISTRY.set("fileGetContents", FileContentsQuery._fromProtobuf);

package/lib/file/FileContentsQuery.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @namespace proto
+ * @typedef {import("@hashgraph/proto").proto.IQuery} HieroProto.proto.IQuery
+ * @typedef {import("@hashgraph/proto").proto.IQueryHeader} HieroProto.proto.IQueryHeader
+ * @typedef {import("@hashgraph/proto").proto.IResponse} HieroProto.proto.IResponse
+ * @typedef {import("@hashgraph/proto").proto.IResponseHeader} HieroProto.proto.IResponseHeader
+ * @typedef {import("@hashgraph/proto").proto.IFileGetContentsQuery} HieroProto.proto.IFileGetContentsQuery
+ * @typedef {import("@hashgraph/proto").proto.IFileGetContentsResponse} HieroProto.proto.IFileGetContentsResponse
+ * @typedef {import("@hashgraph/proto").proto.FileGetContentsResponse.IFileContents} HieroProto.proto.FileGetContentsResponse.IFileContents
+ */
+/**
+ * @typedef {import("../channel/Channel.js").default} Channel
+ * @typedef {import("../client/Client.js").default<*, *>} Client
+ * @typedef {import("../account/AccountId.js").default} AccountId
+ */
+/**
+ * @augments {Query<Uint8Array>}
+ * Retrieve the content of a file in HFS.<br/>
+ * Note that this query retrieves _only_ the file content, not any of
+ * the metadata for the file.
+ */
+export default class FileContentsQuery extends Query<Uint8Array<ArrayBufferLike>> {
+    /**
+     * @internal
+     * @param {HieroProto.proto.IQuery} query
+     * @returns {FileContentsQuery}
+     */
+    static _fromProtobuf(query: HieroProto.proto.IQuery): FileContentsQuery;
+    /**
+     * @param {object} [props]
+     * @param {FileId | string} [props.fileId]
+     */
+    constructor(props?: {
+        fileId?: string | FileId | undefined;
+    });
+    /**
+     * @type {?FileId}
+     * @private
+     */
+    private _fileId;
+    /**
+     * @returns {?FileId}
+     */
+    get fileId(): FileId | null;
+    /**
+     * Set the file ID for which the info is being requested.
+     *
+     * @param {FileId | string} fileId
+     * @returns {FileContentsQuery}
+     */
+    setFileId(fileId: FileId | string): FileContentsQuery;
+    /**
+     * @protected
+     * @override
+     * @param {HieroProto.proto.IResponse} response
+     * @returns {Promise<Uint8Array>}
+     */
+    protected override _mapResponse(response: HieroProto.proto.IResponse): Promise<Uint8Array>;
+}
+export namespace HieroProto {
+    namespace proto {
+        type IQuery = import("@hashgraph/proto").proto.IQuery;
+        type IQueryHeader = import("@hashgraph/proto").proto.IQueryHeader;
+        type IResponse = import("@hashgraph/proto").proto.IResponse;
+        type IResponseHeader = import("@hashgraph/proto").proto.IResponseHeader;
+        type IFileGetContentsQuery = import("@hashgraph/proto").proto.IFileGetContentsQuery;
+        type IFileGetContentsResponse = import("@hashgraph/proto").proto.IFileGetContentsResponse;
+        namespace FileGetContentsResponse {
+            type IFileContents = import("@hashgraph/proto").proto.FileGetContentsResponse.IFileContents;
+        }
+    }
+}
+export type Channel = import("../channel/Channel.js").default;
+export type Client = import("../client/Client.js").default<any, any>;
+export type AccountId = import("../account/AccountId.js").default;
+import Query from "../query/Query.js";
+import FileId from "./FileId.js";

package/lib/file/FileContentsQuery.js

@@ -0,0 +1,2 @@
+import e,{QUERY_REGISTRY as t}from"../query/Query.js";import i from"./FileId.js";class n extends e{constructor(e={}){super(),this._fileId=null,null!=e.fileId&&this.setFileId(e.fileId)}static _fromProtobuf(e){const t=e.fileGetContents;return new n({fileId:null!=t.fileID?i._fromProtobuf(t.fileID):void 0})}_validateChecksums(e){null!=this._fileId&&this._fileId.validateChecksum(e)}_execute(e,t){return e.file.getFileContent(t)}get fileId(){return this._fileId}setFileId(e){return this._fileId="string"==typeof e?i.fromString(e):e.clone(),this}_mapResponseHeader(e){return e.fileGetContents.header}_mapResponse(e){const t=e.fileGetContents.fileContents.contents;return Promise.resolve(t)}_onMakeRequest(e){return{fileGetContents:{header:e,fileID:null!=this._fileId?this._fileId._toProtobuf():null}}}_getLogId(){return`FileContentsQuery:${(null!=this._paymentTransactionId&&null!=this._paymentTransactionId.validStart?this._paymentTransactionId.validStart:this._timestamp).toString()}`}}t.set("fileGetContents",n._fromProtobuf);export{n as default};
+//# sourceMappingURL=FileContentsQuery.js.map

package/lib/file/FileContentsQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileContentsQuery.js","sources":["../../src/file/FileContentsQuery.js"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\nimport Query, { QUERY_REGISTRY } from \"../query/Query.js\";\nimport FileId from \"./FileId.js\";\n\n/**\n * @namespace proto\n * @typedef {import(\"@hashgraph/proto\").proto.IQuery} HieroProto.proto.IQuery\n * @typedef {import(\"@hashgraph/proto\").proto.IQueryHeader} HieroProto.proto.IQueryHeader\n * @typedef {import(\"@hashgraph/proto\").proto.IResponse} HieroProto.proto.IResponse\n * @typedef {import(\"@hashgraph/proto\").proto.IResponseHeader} HieroProto.proto.IResponseHeader\n * @typedef {import(\"@hashgraph/proto\").proto.IFileGetContentsQuery} HieroProto.proto.IFileGetContentsQuery\n * @typedef {import(\"@hashgraph/proto\").proto.IFileGetContentsResponse} HieroProto.proto.IFileGetContentsResponse\n * @typedef {import(\"@hashgraph/proto\").proto.FileGetContentsResponse.IFileContents} HieroProto.proto.FileGetContentsResponse.IFileContents\n */\n\n/**\n * @typedef {import(\"../channel/Channel.js\").default} Channel\n * @typedef {import(\"../client/Client.js\").default<*, *>} Client\n * @typedef {import(\"../account/AccountId.js\").default} AccountId\n */\n\n/**\n * @augments {Query<Uint8Array>}\n * Retrieve the content of a file in HFS.<br/>\n * Note that this query retrieves _only_ the file content, not any of\n * the metadata for the file.\n */\nexport default class FileContentsQuery extends Query {\n    /**\n     * @param {object} [props]\n     * @param {FileId | string} [props.fileId]\n     */\n    constructor(props = {}) {\n        super();\n\n        /**\n         * @type {?FileId}\n         * @private\n         */\n        this._fileId = null;\n        if (props.fileId != null) {\n            this.setFileId(props.fileId);\n        }\n    }\n\n    /**\n     * @internal\n     * @param {HieroProto.proto.IQuery} query\n     * @returns {FileContentsQuery}\n     */\n    static _fromProtobuf(query) {\n        const contents = /** @type {HieroProto.proto.IFileGetContentsQuery} */ (\n            query.fileGetContents\n        );\n\n        return new FileContentsQuery({\n            fileId:\n                contents.fileID != null\n                    ? FileId._fromProtobuf(contents.fileID)\n                    : undefined,\n        });\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.IQuery} request\n     * @returns {Promise<HieroProto.proto.IResponse>}\n     */\n    _execute(channel, request) {\n        return channel.file.getFileContent(request);\n    }\n\n    /**\n     * @returns {?FileId}\n     */\n    get fileId() {\n        return this._fileId;\n    }\n\n    /**\n     * Set the file ID for which the info is being requested.\n     *\n     * @param {FileId | string} fileId\n     * @returns {FileContentsQuery}\n     */\n    setFileId(fileId) {\n        this._fileId =\n            typeof fileId === \"string\"\n                ? FileId.fromString(fileId)\n                : fileId.clone();\n\n        return this;\n    }\n\n    /**\n     * @override\n     * @internal\n     * @param {HieroProto.proto.IResponse} response\n     * @returns {HieroProto.proto.IResponseHeader}\n     */\n    _mapResponseHeader(response) {\n        const fileGetContents =\n            /** @type {HieroProto.proto.IFileGetContentsResponse} */ (\n                response.fileGetContents\n            );\n        return /** @type {HieroProto.proto.IResponseHeader} */ (\n            fileGetContents.header\n        );\n    }\n\n    /**\n     * @protected\n     * @override\n     * @param {HieroProto.proto.IResponse} response\n     * @returns {Promise<Uint8Array>}\n     */\n    _mapResponse(response) {\n        const fileContentsResponse =\n            /** @type {HieroProto.proto.IFileGetContentsResponse} */ (\n                response.fileGetContents\n            );\n        const fileConents =\n            /** @type {HieroProto.proto.FileGetContentsResponse.IFileContents} */ (\n                fileContentsResponse.fileContents\n            );\n        const contents = /** @type {Uint8Array} */ (fileConents.contents);\n\n        return Promise.resolve(contents);\n    }\n\n    /**\n     * @override\n     * @internal\n     * @param {HieroProto.proto.IQueryHeader} header\n     * @returns {HieroProto.proto.IQuery}\n     */\n    _onMakeRequest(header) {\n        return {\n            fileGetContents: {\n                header,\n                fileID:\n                    this._fileId != null ? this._fileId._toProtobuf() : null,\n            },\n        };\n    }\n\n    /**\n     * @returns {string}\n     */\n    _getLogId() {\n        const timestamp =\n            this._paymentTransactionId != null &&\n            this._paymentTransactionId.validStart != null\n                ? this._paymentTransactionId.validStart\n                : this._timestamp;\n\n        return `FileContentsQuery:${timestamp.toString()}`;\n    }\n}\n\n// eslint-disable-next-line @typescript-eslint/unbound-method\nQUERY_REGISTRY.set(\"fileGetContents\", FileContentsQuery._fromProtobuf);\n"],"names":["FileContentsQuery","Query","constructor","props","super","this","_fileId","fileId","setFileId","_fromProtobuf","query","contents","fileID","FileId","undefined","_validateChecksums","client","validateChecksum","_execute","channel","request","file","getFileContent","fromString","clone","_mapResponseHeader","response","_mapResponse","Promise","resolve","_onMakeRequest","header","fileGetContents","_toProtobuf","_getLogId","_paymentTransactionId","validStart","_timestamp","toString","QUERY_REGISTRY","set"],"mappings":"iFA4Be,MAAMA,UAA0BC,EAK3C,WAAAC,CAAYC,EAAQ,IAChBC,QAMAC,KAAKC,QAAU,KACK,MAAhBH,EAAMI,QACNF,KAAKG,UAAUL,EAAMI,OAEjC,CAOI,oBAAOE,CAAcC,GACjB,MAAMC,EACFD,EACH,gBAED,OAAO,IAAIV,EAAkB,CACzBO,OACuB,MAAnBI,EAASC,OACHC,EAAOJ,cAAcE,EAASC,aAC9BE,GAEtB,CAKI,kBAAAC,CAAmBC,GACK,MAAhBX,KAAKC,SACLD,KAAKC,QAAQW,iBAAiBD,EAE1C,CASI,QAAAE,CAASC,EAASC,GACd,OAAOD,EAAQE,KAAKC,eAAeF,EAC3C,CAKI,UAAIb,GACA,OAAOF,KAAKC,OACpB,CAQI,SAAAE,CAAUD,GAMN,OALAF,KAAKC,QACiB,iBAAXC,EACDM,EAAOU,WAAWhB,GAClBA,EAAOiB,QAEVnB,IACf,CAQI,kBAAAoB,CAAmBC,GAKf,OAFQA,EACH,gBAGb,MACA,CAQI,YAAAC,CAAaD,GACT,MAQMf,EANEe,EACH,gBAIA,aAC2D,SAEhE,OAAOE,QAAQC,QAAQlB,EAC/B,CAQI,cAAAmB,CAAeC,GACX,MAAO,CACHC,gBAAiB,CACbD,SACAnB,OACoB,MAAhBP,KAAKC,QAAkBD,KAAKC,QAAQ2B,cAAgB,MAGxE,CAKI,SAAAC,GAOI,MAAO,sBAL2B,MAA9B7B,KAAK8B,uBACoC,MAAzC9B,KAAK8B,sBAAsBC,WACrB/B,KAAK8B,sBAAsBC,WAC3B/B,KAAKgC,YAEuBC,YAC9C,EAIAC,EAAeC,IAAI,kBAAmBxC,EAAkBS"}

package/lib/file/FileCreateTransaction.cjs

@@ -0,0 +1,259 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _Hbar = _interopRequireDefault(require("../Hbar.cjs"));
+var _Transaction = _interopRequireWildcard(require("../transaction/Transaction.cjs"));
+var utf8 = _interopRequireWildcard(require("../encoding/utf8.cjs"));
+var _Timestamp = _interopRequireDefault(require("../Timestamp.cjs"));
+var _Key = _interopRequireDefault(require("../Key.cjs"));
+var _KeyList = _interopRequireDefault(require("../KeyList.cjs"));
+var _long = _interopRequireDefault(require("long"));
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// SPDX-License-Identifier: Apache-2.0
+
+/**
+ * @namespace proto
+ * @typedef {import("@hashgraph/proto").proto.ITransaction} HieroProto.proto.ITransaction
+ * @typedef {import("@hashgraph/proto").proto.ISignedTransaction} HieroProto.proto.ISignedTransaction
+ * @typedef {import("@hashgraph/proto").proto.TransactionBody} HieroProto.proto.TransactionBody
+ * @typedef {import("@hashgraph/proto").proto.ITransactionBody} HieroProto.proto.ITransactionBody
+ * @typedef {import("@hashgraph/proto").proto.ITransactionResponse} HieroProto.proto.ITransactionResponse
+ * @typedef {import("@hashgraph/proto").proto.IFileCreateTransactionBody} HieroProto.proto.IFileCreateTransactionBody
+ */
+
+/**
+ * @typedef {import("../channel/Channel.js").default} Channel
+ * @typedef {import("../account/AccountId.js").default} AccountId
+ * @typedef {import("../transaction/TransactionId.js").default} TransactionId
+ */
+
+/**
+ * Create a new Hedera™ crypto-currency file.
+ */
+class FileCreateTransaction extends _Transaction.default {
+  /**
+   * @param {object} [props]
+   * @param {Key[] | KeyList} [props.keys]
+   * @param {Timestamp | Date} [props.expirationTime]
+   * @param {Uint8Array | string} [props.contents]
+   * @param {string} [props.fileMemo]
+   */
+  constructor(props = {}) {
+    super();
+
+    /**
+     * @private
+     * @type {?Key[]}
+     */
+    this._keys = null;
+
+    /**
+     * @private
+     * @type {Timestamp}
+     */
+    this._expirationTime = new _Timestamp.default(0, 0).plusNanos(_long.default.fromNumber(Date.now()).mul(1000000).add(_Transaction.DEFAULT_AUTO_RENEW_PERIOD.mul(1000000000)));
+
+    /**
+     * @private
+     * @type {?Uint8Array}
+     */
+    this._contents = null;
+
+    /**
+     * @private
+     * @type {?string}
+     */
+    this._fileMemo = null;
+    this._defaultMaxTransactionFee = new _Hbar.default(5);
+    if (props.keys != null) {
+      this.setKeys(props.keys);
+    }
+    if (props.expirationTime != null) {
+      this.setExpirationTime(props.expirationTime);
+    }
+    if (props.contents != null) {
+      this.setContents(props.contents);
+    }
+    if (props.fileMemo && props.fileMemo != null) {
+      this.setFileMemo(props.fileMemo);
+    }
+  }
+
+  /**
+   * @internal
+   * @param {HieroProto.proto.ITransaction[]} transactions
+   * @param {HieroProto.proto.ISignedTransaction[]} signedTransactions
+   * @param {TransactionId[]} transactionIds
+   * @param {AccountId[]} nodeIds
+   * @param {HieroProto.proto.ITransactionBody[]} bodies
+   * @returns {FileCreateTransaction}
+   */
+  static _fromProtobuf(transactions, signedTransactions, transactionIds, nodeIds, bodies) {
+    const body = bodies[0];
+    const create = /** @type {HieroProto.proto.IFileCreateTransactionBody} */
+    body.fileCreate;
+    return _Transaction.default._fromProtobufTransactions(new FileCreateTransaction({
+      keys: create.keys != null ? create.keys.keys != null ? create.keys.keys.map(key => _Key.default._fromProtobufKey(key)) : undefined : undefined,
+      expirationTime: create.expirationTime != null ? _Timestamp.default._fromProtobuf(create.expirationTime) : undefined,
+      contents: create.contents != null ? create.contents : undefined,
+      fileMemo: create.memo != null ? create.memo : undefined
+    }), transactions, signedTransactions, transactionIds, nodeIds, bodies);
+  }
+
+  /**
+   * @returns {?Key[]}
+   */
+  get keys() {
+    return this._keys;
+  }
+
+  /**
+   * Set the keys which must sign any transactions modifying this file. Required.
+   *
+   * All keys must sign to modify the file's contents or keys. No key is required
+   * to sign for extending the expiration time (except the one for the operator account
+   * paying for the transaction). Only one key must sign to delete the file, however.
+   *
+   * To require more than one key to sign to delete a file, add them to a
+   * KeyList and pass that here.
+   *
+   * The network currently requires a file to have at least one key (or key list or threshold key)
+   * but this requirement may be lifted in the future.
+   *
+   * @param {Key[] | KeyList} keys
+   * @returns {this}
+   */
+  setKeys(keys) {
+    this._requireNotFrozen();
+    if (keys instanceof _KeyList.default && keys.threshold != null) {
+      throw new Error("Cannot set threshold key as file key");
+    }
+    this._keys = keys instanceof _KeyList.default ? keys.toArray() : keys;
+    return this;
+  }
+
+  /**
+   * @returns {Timestamp}
+   */
+  get expirationTime() {
+    return this._expirationTime;
+  }
+
+  /**
+   * Set the instant at which this file will expire, after which its contents will no longer be
+   * available.
+   *
+   * Defaults to 1/4 of a Julian year from the instant FileCreateTransaction
+   * was invoked.
+   *
+   * May be extended using FileUpdateTransaction#setExpirationTime(Timestamp).
+   *
+   * @param {Timestamp | Date} expirationTime
+   * @returns {this}
+   */
+  setExpirationTime(expirationTime) {
+    this._requireNotFrozen();
+    this._expirationTime = expirationTime instanceof _Timestamp.default ? expirationTime : _Timestamp.default.fromDate(expirationTime);
+    return this;
+  }
+
+  /**
+   * @returns {?Uint8Array}
+   */
+  get contents() {
+    return this._contents;
+  }
+
+  /**
+   * Set the given byte array as the file's contents.
+   *
+   * This may be omitted to create an empty file.
+   *
+   * Note that total size for a given transaction is limited to 6KiB (as of March 2020) by the
+   * network; if you exceed this you may receive a HederaPreCheckStatusException
+   * with Status#TransactionOversize.
+   *
+   * In this case, you will need to break the data into chunks of less than ~6KiB and execute this
+   * transaction with the first chunk and then use FileAppendTransaction with
+   * FileAppendTransaction#setContents(Uint8Array) for the remaining chunks.
+   *
+   * @param {Uint8Array | string} contents
+   * @returns {this}
+   */
+  setContents(contents) {
+    this._requireNotFrozen();
+    this._contents = contents instanceof Uint8Array ? contents : utf8.encode(contents);
+    return this;
+  }
+
+  /**
+   * @returns {?string}
+   */
+  get fileMemo() {
+    return this._fileMemo;
+  }
+
+  /**
+   * @param {string} memo
+   * @returns {this}
+   */
+  setFileMemo(memo) {
+    this._requireNotFrozen();
+    this._fileMemo = memo;
+    return this;
+  }
+
+  /**
+   * @override
+   * @internal
+   * @param {Channel} channel
+   * @param {HieroProto.proto.ITransaction} request
+   * @returns {Promise<HieroProto.proto.ITransactionResponse>}
+   */
+  _execute(channel, request) {
+    return channel.file.createFile(request);
+  }
+
+  /**
+   * @override
+   * @protected
+   * @returns {NonNullable<HieroProto.proto.TransactionBody["data"]>}
+   */
+  _getTransactionDataCase() {
+    return "fileCreate";
+  }
+
+  /**
+   * @override
+   * @protected
+   * @returns {HieroProto.proto.IFileCreateTransactionBody}
+   */
+  _makeTransactionData() {
+    return {
+      keys: this._keys != null ? {
+        keys: this._keys.map(key => key._toProtobufKey())
+      } : null,
+      expirationTime: this._expirationTime._toProtobuf(),
+      contents: this._contents,
+      memo: this._fileMemo
+    };
+  }
+
+  /**
+   * @returns {string}
+   */
+  _getLogId() {
+    const timestamp = /** @type {import("../Timestamp.js").default} */
+    this._transactionIds.current.validStart;
+    return `FileCreateTransaction:${timestamp.toString()}`;
+  }
+}
+
+// eslint-disable-next-line @typescript-eslint/unbound-method
+exports.default = FileCreateTransaction;
+_Transaction.TRANSACTION_REGISTRY.set("fileCreate", FileCreateTransaction._fromProtobuf);