Class AccountInfo

Information about a Hedera Address, including public key, evm address and other account related information.

Inheritance

object

AccountInfo

Implements

IEquatable<AccountInfo>

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Namespace: Hiero

Assembly: Hiero.dll

Syntax

public sealed record AccountInfo : IEquatable<AccountInfo>

Properties

Address

The Hedera address of this account.

Declaration

public EntityId Address { get; }

Property Value

Type	Description
EntityId

AutoAssociationLimit

The maximum number of tokens (fungible or NFT) that this account may be automatically associated with, which happens when it receives a token it is not yet associated with. A value of -1 means no limit; 0 means every token must be associated explicitly.

Declaration

public int AutoAssociationLimit { get; }

Property Value

Type	Description
int

AutoRenewPeriod

Incremental period for auto-renewal of the account. If account does not have sufficient funds to renew at the expiration time, it will be renewed for a period of time the remaining funds can support. If no funds remain, the account will be deleted.

Declaration

public TimeSpan AutoRenewPeriod { get; }

Property Value

Type	Description
TimeSpan

Balance

Address Balance in Tinybars

Declaration

public ulong Balance { get; }

Property Value

Type	Description
ulong

Deleted

True

if this account has been deleted. Its existence in the network will cease after the expiration date for the account lapses. It cannot participate in transactions except to extend the expiration/removal date.

Declaration

public bool Deleted { get; }

Property Value

Type	Description
bool

Endorsement

Address's Public Key (typically a single Ed25519 key).

Declaration

public Endorsement Endorsement { get; }

Property Value

Type	Description
Endorsement

EvmAddress

The identity of the Hedera Address in a form to be used with smart contracts. This can also be the ID of a smart contract instance if this is the account associated with a smart contract.

Declaration

public EvmAddress EvmAddress { get; }

Property Value

Type	Description
EvmAddress

EvmNonce

The smart contract (EVM) transaction counter nonce associated with this account.

Declaration

public long EvmNonce { get; }

Property Value

Type	Description
long

Expiration

The account expiration time, at which it will attempt to renew if sufficient funds remain in the account.

Declaration

public ConsensusTimeStamp Expiration { get; }

Property Value

Type	Description
ConsensusTimeStamp

KeyAlias

The alternate identifier associated with this account that is
in the form of a public key.  If an alternate identifier for this
account does not exist, this value will be 

None

.

Declaration

public Endorsement KeyAlias { get; }

Property Value

Type	Description
Endorsement

Ledger

Identification of the Ledger (Network) this account information was retrieved from.

Declaration

public BigInteger Ledger { get; }

Property Value

Type	Description
BigInteger

Memo

A short description associated with the account.

Declaration

public string Memo { get; }

Property Value

Type	Description
string

NftCount

The number of NFTs (non fungible tokens) held by this account.

Declaration

public long NftCount { get; }

Property Value

Type	Description
long

ReceiveSignatureRequired

True

if any receipt of funds requires a signature from this account.

Declaration

public bool ReceiveSignatureRequired { get; }

Property Value

Type	Description
bool

StakingInfo

Staking Metadata Information for the account.

Declaration

public StakingInfo StakingInfo { get; }

Property Value

Type	Description
StakingInfo

Tokens

[DEPRECATED] Balances of tokens and NFTs associated with this account.

Declaration

[Obsolete("Deprecated by HIP-367: the network caps this list and does not report truncation, so it may be silently incomplete. Use MirrorRestClient.GetAccountTokenHoldingsAsync for a complete, paged result.")]
public IReadOnlyList<TokenBalance> Tokens { get; }

Property Value

Type	Description
IReadOnlyList<TokenBalance>

Remarks

This list may be silently incomplete. HIP-367 removed the limit on how many tokens an account may be associated with, so the network caps what it returns here and does not report that it has done so. An account with few associations yields a correct list; one with many yields a truncated list and no error — which makes the shortfall easy to miss in testing and easy to hit in production.

For a complete result, query the Mirror Node instead: GetAccountTokenHoldingsAsync(MirrorRestClient, EntityId, CancellationToken, params IMirrorQueryParameter[]) pages through every holding, and GetAccountTokenBalanceAsync(MirrorRestClient, EntityId, EntityId, CancellationToken, params IMirrorQueryParameter[]) fetches one token's balance directly.

This member is retained because the network still populates it and turning it off has been deferred repeatedly; removing it would break systems that depend on it today.

Implements

IEquatable<T>