PHP WebShell
Текущая директория: /opt/BitGoJS/node_modules/@hashgraph/sdk/src/contract
Просмотр файла: ContractExecuteTransaction.js
/*-
*
* Hedera JavaScript SDK
*
* Copyright (C) 2020 - 2022 Hedera Hashgraph, LLC
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*/
import Hbar from "../Hbar.js";
import Transaction, {
TRANSACTION_REGISTRY,
} from "../transaction/Transaction.js";
import ContractId from "./ContractId.js";
import ContractFunctionParameters from "./ContractFunctionParameters.js";
import Long from "long";
/**
* @namespace proto
* @typedef {import("@hashgraph/proto").proto.ITransaction} HashgraphProto.proto.ITransaction
* @typedef {import("@hashgraph/proto").proto.ISignedTransaction} HashgraphProto.proto.ISignedTransaction
* @typedef {import("@hashgraph/proto").proto.TransactionBody} HashgraphProto.proto.TransactionBody
* @typedef {import("@hashgraph/proto").proto.ITransactionBody} HashgraphProto.proto.ITransactionBody
* @typedef {import("@hashgraph/proto").proto.ITransactionResponse} HashgraphProto.proto.ITransactionResponse
* @typedef {import("@hashgraph/proto").proto.IContractCallTransactionBody} HashgraphProto.proto.IContractCallTransactionBody
* @typedef {import("@hashgraph/proto").proto.IAccountID} HashgraphProto.proto.IAccountID
* @typedef {import("@hashgraph/proto").proto.IContractID} HashgraphProto.proto.IContractID
* @typedef {import("@hashgraph/proto").proto.IFileID} HashgraphProto.proto.IFileID
*/
/**
* @typedef {import("bignumber.js").default} BigNumber
* @typedef {import("../channel/Channel.js").default} Channel
* @typedef {import("../client/Client.js").default<*, *>} Client
* @typedef {import("../account/AccountId.js").default} AccountId
* @typedef {import("../transaction/TransactionId.js").default} TransactionId
*/
/**
* @typedef {object} FunctionParameters
* @property {string} name
* @property {ContractFunctionParameters} parameters
*/
export default class ContractExecuteTransaction extends Transaction {
/**
* @param {object} [props]
* @param {ContractId | string} [props.contractId]
* @param {number | Long} [props.gas]
* @param {number | string | Long | BigNumber | Hbar} [props.amount]
* @param {Uint8Array} [props.functionParameters]
* @param {FunctionParameters} [props.function]
*/
constructor(props = {}) {
super();
/**
* @private
* @type {?ContractId}
*/
this._contractId = null;
/**
* @private
* @type {?Long}
*/
this._gas = null;
/**
* @private
* @type {?Hbar}
*/
this._amount = null;
/**
* @private
* @type {?Uint8Array}
*/
this._functionParameters = null;
if (props.contractId != null) {
this.setContractId(props.contractId);
}
if (props.gas != null) {
this.setGas(props.gas);
}
if (props.amount != null) {
this.setPayableAmount(props.amount);
}
if (props.functionParameters != null) {
this.setFunctionParameters(props.functionParameters);
} else if (props.function != null) {
this.setFunction(props.function.name, props.function.parameters);
}
}
/**
* @internal
* @param {HashgraphProto.proto.ITransaction[]} transactions
* @param {HashgraphProto.proto.ISignedTransaction[]} signedTransactions
* @param {TransactionId[]} transactionIds
* @param {AccountId[]} nodeIds
* @param {HashgraphProto.proto.ITransactionBody[]} bodies
* @returns {ContractExecuteTransaction}
*/
static _fromProtobuf(
transactions,
signedTransactions,
transactionIds,
nodeIds,
bodies
) {
const body = bodies[0];
const call =
/** @type {HashgraphProto.proto.IContractCallTransactionBody} */ (
body.contractCall
);
return Transaction._fromProtobufTransactions(
new ContractExecuteTransaction({
contractId:
call.contractID != null
? ContractId._fromProtobuf(
/** @type {HashgraphProto.proto.IContractID} */ (
call.contractID
)
)
: undefined,
gas: call.gas != null ? call.gas : undefined,
amount:
call.amount != null
? Hbar.fromTinybars(call.amount)
: undefined,
functionParameters:
call.functionParameters != null
? call.functionParameters
: undefined,
}),
transactions,
signedTransactions,
transactionIds,
nodeIds,
bodies
);
}
/**
* @returns {?ContractId}
*/
get contractId() {
return this._contractId;
}
/**
* Sets the contract ID which is being executed in this transaction.
*
* @param {ContractId | string} contractId
* @returns {ContractExecuteTransaction}
*/
setContractId(contractId) {
this._requireNotFrozen();
this._contractId =
typeof contractId === "string"
? ContractId.fromString(contractId)
: contractId.clone();
return this;
}
/**
* @returns {?Long}
*/
get gas() {
return this._gas;
}
/**
* Sets the contract ID which is being executed in this transaction.
*
* @param {number | Long} gas
* @returns {ContractExecuteTransaction}
*/
setGas(gas) {
this._requireNotFrozen();
this._gas = gas instanceof Long ? gas : Long.fromValue(gas);
return this;
}
/**
* @returns {?Hbar}
*/
get payableAmount() {
return this._amount;
}
/**
* Sets the contract ID which is being executed in this transaction.
*
* @param {number | string | Long | BigNumber | Hbar} amount
* @returns {ContractExecuteTransaction}
*/
setPayableAmount(amount) {
this._requireNotFrozen();
this._amount = amount instanceof Hbar ? amount : new Hbar(amount);
return this;
}
/**
* @returns {?Uint8Array}
*/
get functionParameters() {
return this._functionParameters;
}
/**
* @param {Uint8Array} functionParameters
* @returns {this}
*/
setFunctionParameters(functionParameters) {
this._requireNotFrozen();
this._functionParameters = functionParameters;
return this;
}
/**
* @param {string} name
* @param {ContractFunctionParameters} [functionParameters]
* @returns {this}
*/
setFunction(name, functionParameters) {
this._requireNotFrozen();
this._functionParameters =
functionParameters != null
? functionParameters._build(name)
: new ContractFunctionParameters()._build(name);
return this;
}
/**
* @param {Client} client
*/
_validateChecksums(client) {
if (this._contractId != null) {
this._contractId.validateChecksum(client);
}
}
/**
* @override
* @internal
* @param {Channel} channel
* @param {HashgraphProto.proto.ITransaction} request
* @returns {Promise<HashgraphProto.proto.ITransactionResponse>}
*/
_execute(channel, request) {
return channel.smartContract.contractCallMethod(request);
}
/**
* @override
* @protected
* @returns {NonNullable<HashgraphProto.proto.TransactionBody["data"]>}
*/
_getTransactionDataCase() {
return "contractCall";
}
/**
* @override
* @protected
* @returns {HashgraphProto.proto.IContractCallTransactionBody}
*/
_makeTransactionData() {
return {
contractID:
this._contractId != null
? this._contractId._toProtobuf()
: null,
gas: this._gas,
amount: this._amount != null ? this._amount.toTinybars() : null,
functionParameters: this._functionParameters,
};
}
/**
* @returns {string}
*/
_getLogId() {
const timestamp = /** @type {import("../Timestamp.js").default} */ (
this._transactionIds.current.validStart
);
return `ContractExecuteTransaction:${timestamp.toString()}`;
}
}
TRANSACTION_REGISTRY.set(
"contractCall",
// eslint-disable-next-line @typescript-eslint/unbound-method
ContractExecuteTransaction._fromProtobuf
);
Выполнить команду
Для локальной разработки. Не используйте в интернете!