/// <summary>
/// Retrieves the network address associated with the specified smart contract id.
/// </summary>
/// <param name="smartContractId">
/// The smart contract ID to look up.
/// </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>
/// The network address associated with the smart contract ID.
/// </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>
public async Task <Address> GetAddressFromSmartContractId(string smartContractId, Action <IContext>?configure = null)
{
smartContractId = RequireInputParameter.SmartContractId(smartContractId);
var context = CreateChildContext(configure);
var gateway = RequireInContext.Gateway(context);
var payer = RequireInContext.Payer(context);
var transfers = Transactions.CreateCryptoTransferList((payer, -context.FeeLimit), (gateway, context.FeeLimit));
var transactionId = Transactions.GetOrCreateTransactionID(context);
var transactionBody = Transactions.CreateCryptoTransferTransactionBody(context, transfers, transactionId, "Get Contract By Solidity ID");
var query = new Query
{
GetBySolidityID = new GetBySolidityIDQuery
{
Header = Transactions.SignQueryHeader(transactionBody, payer),
SolidityID = smartContractId
}
};
var response = await Transactions.ExecuteRequestWithRetryAsync(context, query, getRequestMethod, getResponseCode);
ValidateResult.PreCheck(transactionId, getResponseCode(response));
var data = response.GetBySolidityID;
if (data.ContractID != null)
{
return(Protobuf.FromContractID(data.ContractID));
}
if (data.AccountID != null)
{
return(Protobuf.FromAccountID(data.AccountID));
}
if (data.FileID != null)
{
return(Protobuf.FromFileID(data.FileID));
}
throw new TransactionException($"Address from Smart Contract ID {smartContractId} was not found.", Protobuf.FromTransactionId(transactionId), ResponseCode.Unknown);
public void ExposesAccountValue()
{
var transactionId = Generator.TransactionID();
var txId = Protobuf.FromTransactionId(transactionId);
Assert.Equal(txId.Address, Protobuf.FromAccountID(transactionId.AccountID));
}
/// <summary>
/// Internal implementation for Create Account
/// Returns either a receipt or record or throws
/// an exception.
/// </summary>
private async Task <TResult> CreateAccountImplementationAsync <TResult>(CreateAccountParams createParameters, Action <IContext>?configure) where TResult : new()
{
createParameters = RequireInputParameter.CreateParameters(createParameters);
var context = CreateChildContext(configure);
RequireInContext.Gateway(context);
var payer = RequireInContext.Payer(context);
var transactionId = Transactions.GetOrCreateTransactionID(context);
var transactionBody = Transactions.CreateEmptyTransactionBody(context, transactionId, "Create Account");
// Create Account requires just the 32 bits of the public key, without the prefix.
var publicKeyWithoutPrefix = Keys.ImportPublicEd25519KeyFromBytes(createParameters.PublicKey).Export(KeyBlobFormat.PkixPublicKey).TakeLast(32).ToArray();
transactionBody.CryptoCreateAccount = new CryptoCreateTransactionBody
{
Key = new Proto.Key {
Ed25519 = ByteString.CopyFrom(publicKeyWithoutPrefix)
},
InitialBalance = createParameters.InitialBalance,
SendRecordThreshold = createParameters.SendThresholdCreateRecord,
ReceiveRecordThreshold = createParameters.ReceiveThresholdCreateRecord,
ReceiverSigRequired = createParameters.RequireReceiveSignature,
AutoRenewPeriod = Protobuf.ToDuration(createParameters.AutoRenewPeriod),
};
var request = Transactions.SignTransaction(transactionBody, 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 create account, status: {receipt.Status}", Protobuf.FromTransactionId(transactionId), (ResponseCode)receipt.Status);
}
var result = new TResult();
if (result is AccountReceipt arcpt)
{
Protobuf.FillReceiptProperties(transactionId, receipt, arcpt);
arcpt.Address = Protobuf.FromAccountID(receipt.AccountID);
}
else if (result is AccountRecord arec)
{
var record = await GetTransactionRecordAsync(context, transactionId);
Protobuf.FillRecordProperties(record, arec);
arec.Address = Protobuf.FromAccountID(receipt.AccountID);
}
return(result);
/// <summary>
/// Internal implementation for Create Account
/// Returns either a receipt or record or throws
/// an exception.
/// </summary>
private async Task <TResult> CreateAccountImplementationAsync <TResult>(CreateAccountParams createParameters, Action <IContext>?configure) where TResult : new()
{
var publicKey = RequireInputParameter.KeysFromEndorsements(createParameters);
await using var context = CreateChildContext(configure);
RequireInContext.Gateway(context);
var payer = RequireInContext.Payer(context);
var signatories = Transactions.GatherSignatories(context, createParameters.Signatory);
var transactionId = Transactions.GetOrCreateTransactionID(context);
var transactionBody = Transactions.CreateTransactionBody(context, transactionId);
transactionBody.CryptoCreateAccount = new CryptoCreateTransactionBody
{
Key = publicKey,
InitialBalance = createParameters.InitialBalance,
SendRecordThreshold = createParameters.SendThresholdCreateRecord,
ReceiveRecordThreshold = createParameters.ReceiveThresholdCreateRecord,
ReceiverSigRequired = createParameters.RequireReceiveSignature,
AutoRenewPeriod = Protobuf.ToDuration(createParameters.AutoRenewPeriod),
ProxyAccountID = createParameters.Proxy is null ? null : Protobuf.ToAccountID(createParameters.Proxy),
};
var request = await Transactions.SignTransactionAsync(transactionBody, signatories);
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 create account, status: {receipt.Status}", Protobuf.FromTransactionId(transactionId), (ResponseCode)receipt.Status);
}
var result = new TResult();
if (result is CreateAccountRecord arec)
{
var record = await GetTransactionRecordAsync(context, transactionId);
Protobuf.FillRecordProperties(record, arec);
arec.Address = Protobuf.FromAccountID(receipt.AccountID);
}
else if (result is CreateAccountReceipt arcpt)
{
Protobuf.FillReceiptProperties(transactionId, receipt, arcpt);
arcpt.Address = Protobuf.FromAccountID(receipt.AccountID);
}
return(result);
/// <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>
/// Retreives the accounts that are proxy staking to this account.
/// </summary>
/// <param name="address">
/// The Hedera Network Address to retrieve the stakers of.
/// </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 dictionary mapping account addresses to the amount of stake.
/// </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>
// NOTE: Marked internal at this point because it is not yet implemented by the network
internal async Task <Dictionary <Address, long> > GetStakers(Address address, Action <IContext>?configure = null)
{
address = RequireInputParameter.Address(address);
var context = CreateChildContext(configure);
var gateway = RequireInContext.Gateway(context);
var payer = RequireInContext.Payer(context);
var transfers = Transactions.CreateCryptoTransferList((payer, -context.FeeLimit), (gateway, context.FeeLimit));
var transactionId = Transactions.GetOrCreateTransactionID(context);
var transactionBody = Transactions.CreateCryptoTransferTransactionBody(context, transfers, transactionId, "Get Account Info");
var query = new Query
{
CryptoGetProxyStakers = new CryptoGetStakersQuery
{
Header = Transactions.SignQueryHeader(transactionBody, payer),
AccountID = Protobuf.ToAccountID(address)
}
};
var response = await Transactions.ExecuteRequestWithRetryAsync(context, query, getRequestMethod, getResponseCode);
ValidateResult.PreCheck(transactionId, getResponseCode(response));
return(response.CryptoGetProxyStakers.Stakers.ProxyStaker.ToDictionary(ps => Protobuf.FromAccountID(ps.AccountID), ps => ps.Amount));
/// <summary>
/// Retreives the accounts that are proxy staking to this account.
/// </summary>
/// <param name="address">
/// The Hedera Network Address to retrieve the stakers of.
/// </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 dictionary mapping account addresses to the amount of stake.
/// </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>
///
/// <remarks>
/// Marked internal at this point because it is not yet implemented by the network
/// </remarks>
internal async Task <Dictionary <Address, long> > GetStakers(Address address, Action <IContext>?configure = null)
{
address = RequireInputParameter.Address(address);
await using var context = CreateChildContext(configure);
var query = new Query
{
CryptoGetProxyStakers = new CryptoGetStakersQuery
{
Header = Transactions.CreateAskCostHeader(),
AccountID = Protobuf.ToAccountID(address)
}
};
var response = await Transactions.ExecuteUnsignedAskRequestWithRetryAsync(context, query, getRequestMethod, getResponseHeader);
long cost = (long)response.CryptoGetProxyStakers.Header.Cost;
if (cost > 0)
{
var transactionId = Transactions.GetOrCreateTransactionID(context);
query.CryptoGetProxyStakers.Header = await Transactions.CreateAndSignQueryHeaderAsync(context, cost, transactionId);
response = await Transactions.ExecuteSignedRequestWithRetryAsync(context, query, getRequestMethod, getResponseHeader);
ValidateResult.ResponseHeader(transactionId, getResponseHeader(response));
}
return(response.CryptoGetProxyStakers.Stakers.ProxyStaker.ToDictionary(ps => Protobuf.FromAccountID(ps.AccountID), ps => ps.Amount));