internal CryptoUpdateTransactionBody(Hashgraph.UpdateAccountParams updateParameters) : this()
{
if (updateParameters is null)
{
throw new ArgumentNullException(nameof(updateParameters), "Account Update Parameters argument is missing. Please check that it is not null.");
}
if (updateParameters.Address is null)
{
throw new ArgumentNullException(nameof(updateParameters.Address), "Account is missing. Please check that it is not null.");
}
if (Hashgraph.Endorsement.None.Equals(updateParameters.Endorsement))
{
throw new ArgumentOutOfRangeException(nameof(updateParameters.Endorsement), "Endorsement can not be 'None', it must contain at least one key requirement.");
}
if (updateParameters.Endorsement is null &&
updateParameters.RequireReceiveSignature is null &&
updateParameters.Expiration is null &&
updateParameters.AutoRenewPeriod is null &&
updateParameters.Proxy is null &&
updateParameters.Memo is null &&
updateParameters.AutoAssociationLimit is null)
{
throw new ArgumentException(nameof(updateParameters), "The Account Updates contains no update properties, it is blank.");
}
AccountIDToUpdate = new AccountID(updateParameters.Address);
if (!(updateParameters.Endorsement is null))
{
Key = new Key(updateParameters.Endorsement);
}
if (updateParameters.RequireReceiveSignature.HasValue)
{
ReceiverSigRequiredWrapper = updateParameters.RequireReceiveSignature.Value;
}
if (updateParameters.AutoRenewPeriod.HasValue)
{
AutoRenewPeriod = new Duration(updateParameters.AutoRenewPeriod.Value);
}
if (updateParameters.Expiration.HasValue)
{
ExpirationTime = new Timestamp(updateParameters.Expiration.Value);
}
if (!(updateParameters.Proxy is null))
{
ProxyAccountID = new AccountID(updateParameters.Proxy);
}
if (!(updateParameters.Memo is null))
{
Memo = updateParameters.Memo;
}
if (!(updateParameters.AutoAssociationLimit is null))
{
var limit = updateParameters.AutoAssociationLimit.Value;
if (limit < 0 || limit > 1000)
{
throw new ArgumentOutOfRangeException(nameof(updateParameters.AutoAssociationLimit), "The maximum number of auto-associaitons must be between zero and 1000.");
}
MaxAutomaticTokenAssociations = updateParameters.AutoAssociationLimit.Value;
}
}
/// <summary>
/// Internal implementation of the update account functionality.
/// </summary>
private async Task <TResult> UpdateAccountImplementationAsync <TResult>(UpdateAccountParams 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 updateAccountBody = new CryptoUpdateTransactionBody
{
AccountIDToUpdate = new AccountID(updateParameters.Address)
};
if (!(updateParameters.Endorsement is null))
{
updateAccountBody.Key = new Key(updateParameters.Endorsement);
}
if (updateParameters.RequireReceiveSignature.HasValue)
{
updateAccountBody.ReceiverSigRequiredWrapper = updateParameters.RequireReceiveSignature.Value;
}
if (updateParameters.AutoRenewPeriod.HasValue)
{
updateAccountBody.AutoRenewPeriod = new Duration(updateParameters.AutoRenewPeriod.Value);
}
if (updateParameters.Expiration.HasValue)
{
updateAccountBody.ExpirationTime = new Timestamp(updateParameters.Expiration.Value);
}
if (!(updateParameters.Proxy is null))
{
updateAccountBody.ProxyAccountID = new AccountID(updateParameters.Proxy);
}
var signatory = Transactions.GatherSignatories(context, updateParameters.Signatory);
var transactionId = Transactions.GetOrCreateTransactionID(context);
var transactionBody = new TransactionBody(context, transactionId);
transactionBody.CryptoUpdateAccount = updateAccountBody;
var receipt = await transactionBody.SignAndExecuteWithRetryAsync(signatory, context);
if (receipt.Status != ResponseCodeEnum.Success)
{
throw new TransactionException($"Unable to update account, 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 changeable properties of a hedera network account.
/// </summary>
/// <param name="updateParameters">
/// The account update parameters, includes a required
/// <see cref="Address"/> reference to the account to update plus
/// a number of changeable properties of the account.
/// </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 containing the details of the results.
/// of the request.
/// </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> UpdateAccountWithRecordAsync(UpdateAccountParams updateParameters, Action <IContext>?configure = null)
{
return(new TransactionRecord(await ExecuteTransactionAsync(new CryptoUpdateTransactionBody(updateParameters), configure, true, updateParameters.Signatory).ConfigureAwait(false)));
}
/// <summary>
/// Updates the changeable properties of a hedera network account.
/// </summary>
/// <param name="updateParameters">
/// The account update parameters, includes a required
/// <see cref="Address"/> reference to the account to update plus
/// a number of changeable properties of the account.
/// </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 containing the details of the results.
/// of the request.
/// </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> UpdateAccountWithRecordAsync(UpdateAccountParams updateParameters, Action <IContext>?configure = null)
{
return(UpdateAccountImplementationAsync <TransactionRecord>(updateParameters, configure));
}
/// <summary>
/// Internal implementation of the update account functionality.
/// </summary>
private async Task <TResult> UpdateAccountImplementationAsync <TResult>(UpdateAccountParams updateParameters, Action <IContext>?configure) where TResult : new()
{
updateParameters = RequireInputParameter.UpdateParameters(updateParameters);
var context = CreateChildContext(configure);
RequireInContext.Gateway(context);
var payer = RequireInContext.Payer(context);
var updateAccountBody = new CryptoUpdateTransactionBody
{
AccountIDToUpdate = Protobuf.ToAccountID(updateParameters.Account)
};
if (!(updateParameters.Endorsement is null))
{
updateAccountBody.Key = Protobuf.ToPublicKey(updateParameters.Endorsement);
}
if (updateParameters.SendThresholdCreateRecord.HasValue)
{
updateAccountBody.SendRecordThresholdWrapper = updateParameters.SendThresholdCreateRecord.Value;
}
if (updateParameters.ReceiveThresholdCreateRecord.HasValue)
{
updateAccountBody.ReceiveRecordThresholdWrapper = updateParameters.ReceiveThresholdCreateRecord.Value;
}
if (updateParameters.AutoRenewPeriod.HasValue)
{
updateAccountBody.AutoRenewPeriod = Protobuf.ToDuration(updateParameters.AutoRenewPeriod.Value);
}
if (updateParameters.Expiration.HasValue)
{
updateAccountBody.ExpirationTime = Protobuf.ToTimestamp(updateParameters.Expiration.Value);
}
var transactionId = Transactions.GetOrCreateTransactionID(context);
var transactionBody = Transactions.CreateEmptyTransactionBody(context, transactionId, "Update Account");
transactionBody.CryptoUpdateAccount = updateAccountBody;
var request = Transactions.SignTransaction(transactionBody, updateParameters.Account, payer);
var precheck = await Transactions.ExecuteRequestWithRetryAsync(context, request, getRequestMethod, getResponseCode);
ValidateResult.PreCheck(transactionId, precheck.NodeTransactionPrecheckCode);
var receipt = await GetReceiptAsync(context, transactionId);
if (receipt.Status != ResponseCodeEnum.Success)
{
throw new TransactionException($"Unable to update account, status: {receipt.Status}", Protobuf.FromTransactionId(transactionId), (ResponseCode)receipt.Status);
}
var result = new TResult();
if (result is AccountRecord arec)
{
var record = await GetTransactionRecordAsync(context, transactionId);
Protobuf.FillRecordProperties(record, arec);
arec.Address = Protobuf.FromAccountID(receipt.AccountID);
}
else if (result is AccountReceipt arcpt)
{
Protobuf.FillReceiptProperties(transactionId, receipt, arcpt);
arcpt.Address = Protobuf.FromAccountID(receipt.AccountID);
}
return(result);
/// <summary>
/// Updates the changeable properties of a hedera network account.
/// </summary>
/// <param name="updateParameters">
/// The account update parameters, includes a required
/// <see cref="Address"/> reference to the account to update plus
/// a number of changeable properties of the account.
/// </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 receipt indicating success of the operation.
/// of the request.
/// </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 <AccountReceipt> UpdateAccountAsync(UpdateAccountParams updateParameters, Action <IContext>?configure = null)
{
return(UpdateAccountImplementationAsync <AccountReceipt>(updateParameters, configure));
}