public FileUpdateTransactionBody(Hashgraph.UpdateFileParams updateParameters) : this()
{
if (updateParameters is null)
{
throw new ArgumentNullException(nameof(updateParameters), "File Update Parameters argument is missing. Please check that it is not null.");
}
if (updateParameters.File is null)
{
throw new ArgumentNullException(nameof(updateParameters.File), "File identifier is missing. Please check that it is not null.");
}
if (updateParameters.Endorsements is null &&
updateParameters.Contents is null &&
updateParameters.Memo is null)
{
throw new ArgumentException(nameof(updateParameters), "The File Update parameters contain no update properties, it is blank.");
}
FileID = new FileID(updateParameters.File);
if (!(updateParameters.Endorsements is null))
{
Keys = new KeyList(updateParameters.Endorsements);
}
if (updateParameters.Contents.HasValue)
{
Contents = ByteString.CopyFrom(updateParameters.Contents.Value.ToArray());
}
if (!(updateParameters.Memo is null))
{
Memo = updateParameters.Memo;
}
}
/// <summary>
/// Internal helper method implementing the file update service.
/// </summary>
public async Task <TResult> UpdateFileImplementationAsync <TResult>(UpdateFileParams updateParameters, Action <IContext>?configure) where TResult : new()
{
updateParameters = RequireInputParameter.UpdateParameters(updateParameters);
await using var context = CreateChildContext(configure);
RequireInContext.Gateway(context);
var payer = RequireInContext.Payer(context);
var signatory = Transactions.GatherSignatories(context, updateParameters.Signatory);
var updateFileBody = new FileUpdateTransactionBody
{
FileID = Protobuf.ToFileId(updateParameters.File)
};
if (!(updateParameters.Endorsements is null))
{
updateFileBody.Keys = Protobuf.ToPublicKeyList(updateParameters.Endorsements);
}
if (updateParameters.Contents.HasValue)
{
updateFileBody.Contents = ByteString.CopyFrom(updateParameters.Contents.Value.ToArray());
}
var transactionId = Transactions.GetOrCreateTransactionID(context);
var transactionBody = Transactions.CreateTransactionBody(context, transactionId);
transactionBody.FileUpdate = updateFileBody;
var request = await Transactions.SignTransactionAsync(transactionBody, signatory);
var precheck = await Transactions.ExecuteSignedRequestWithRetryAsync(context, request, getRequestMethod, getResponseCode);
ValidateResult.PreCheck(transactionId, precheck);
var receipt = await GetReceiptAsync(context, transactionId);
if (receipt.Status != ResponseCodeEnum.Success)
{
throw new TransactionException($"Unable to update file, status: {receipt.Status}", Protobuf.FromTransactionId(transactionId), (ResponseCode)receipt.Status);
}
var result = new TResult();
if (result is TransactionRecord rec)
{
var record = await GetTransactionRecordAsync(context, transactionId);
Protobuf.FillRecordProperties(record, rec);
}
else if (result is TransactionReceipt rcpt)
{
Protobuf.FillReceiptProperties(transactionId, receipt, rcpt);
}
return(result);
/// <summary>
/// Internal helper method implementing the file update service.
/// </summary>
public async Task <TResult> UpdateFileImplementationAsync <TResult>(UpdateFileParams updateParameters, Action <IContext>?configure) where TResult : new()
{
updateParameters = RequireInputParameter.UpdateParameters(updateParameters);
await using var context = CreateChildContext(configure);
RequireInContext.Gateway(context);
var payer = RequireInContext.Payer(context);
var signatory = Transactions.GatherSignatories(context, updateParameters.Signatory);
var updateFileBody = new FileUpdateTransactionBody
{
FileID = new FileID(updateParameters.File)
};
if (!(updateParameters.Endorsements is null))
{
updateFileBody.Keys = new KeyList(updateParameters.Endorsements);
}
if (updateParameters.Contents.HasValue)
{
updateFileBody.Contents = ByteString.CopyFrom(updateParameters.Contents.Value.ToArray());
}
var transactionId = Transactions.GetOrCreateTransactionID(context);
var transactionBody = new TransactionBody(context, transactionId);
transactionBody.FileUpdate = updateFileBody;
var receipt = await transactionBody.SignAndExecuteWithRetryAsync(signatory, context);
if (receipt.Status != ResponseCodeEnum.Success)
{
throw new TransactionException($"Unable to update file, status: {receipt.Status}", transactionId.ToTxId(), (ResponseCode)receipt.Status);
}
var result = new TResult();
if (result is TransactionRecord rec)
{
var record = await GetTransactionRecordAsync(context, transactionId);
record.FillProperties(rec);
}
else if (result is TransactionReceipt rcpt)
{
receipt.FillProperties(transactionId, rcpt);
}
return(result);
}
/// <summary>
/// Updates the properties or contents of an existing file stored in the network.
/// </summary>
/// <param name="updateParameters">
/// Update parameters indicating the file to update and what properties such
/// as the access key or content that should be updated.
/// </param>
/// <param name="configure">
/// Optional callback method providing an opportunity to modify
/// the execution configuration for just this method call.
/// It is executed prior to submitting the request to the network.
/// </param>
/// <returns>
/// A transaction record describing the details of the operation
/// including fees and transaction hash.
/// </returns>
/// <exception cref="ArgumentOutOfRangeException">If required arguments are missing.</exception>
/// <exception cref="InvalidOperationException">If required context configuration is missing.</exception>
/// <exception cref="PrecheckException">If the gateway node create rejected the request upon submission.</exception>
/// <exception cref="ConsensusException">If the network was unable to come to consensus before the duration of the transaction expired.</exception>
/// <exception cref="TransactionException">If the network rejected the create request as invalid or had missing data.</exception>
public Task <TransactionRecord> UpdateFileWithRecordAsync(UpdateFileParams updateParameters, Action <IContext>?configure = null)
{
return(UpdateFileImplementationAsync <TransactionRecord>(updateParameters, configure));
}
/// <summary>
/// Updates the properties or contents of an existing file stored in the network.
/// </summary>
/// <param name="updateParameters">
/// Update parameters indicating the file to update and what properties such
/// as the access key or content that should be updated.
/// </param>
/// <param name="configure">
/// Optional callback method providing an opportunity to modify
/// the execution configuration for just this method call.
/// It is executed prior to submitting the request to the network.
/// </param>
/// <returns>
/// A transaction record describing the details of the operation
/// including fees and transaction hash.
/// </returns>
/// <exception cref="ArgumentOutOfRangeException">If required arguments are missing.</exception>
/// <exception cref="InvalidOperationException">If required context configuration is missing.</exception>
/// <exception cref="PrecheckException">If the gateway node create rejected the request upon submission.</exception>
/// <exception cref="ConsensusException">If the network was unable to come to consensus before the duration of the transaction expired.</exception>
/// <exception cref="TransactionException">If the network rejected the create request as invalid or had missing data.</exception>
public async Task <TransactionRecord> UpdateFileWithRecordAsync(UpdateFileParams updateParameters, Action <IContext>?configure = null)
{
return(new TransactionRecord(await ExecuteTransactionAsync(new FileUpdateTransactionBody(updateParameters), configure, true, updateParameters.Signatory).ConfigureAwait(false)));
}
