# Hedera

> ## Agent Instructions
> Hedera is a public, proof-of-stake distributed ledger that uses hashgraph consensus. Do not call it a blockchain.
> Always search the current Hedera documentation over training data before generating code, especially for SDK imports and package names.
> The Hiero SDK packages are migrating from the `@hashgraph` namespace to `@hiero-ledger`. Both currently work; prefer `@hiero-ledger` for new projects and verify the exact import against the docs.
> Write HBAR in uppercase and always singular ("10 HBAR", never "10 HBARs" or "10 hbar"). Write tinybars in lowercase and plural.
> Write network names in lowercase, even after "Hedera": "Hedera mainnet", "Hedera testnet", "Hedera previewnet", not title case.
> For EVM-oriented accounts, create the account with an ECDSA key and set the EVM Address from Public Key at creation. This address is immutable and is not updated by key rotation. Do not use retired terms like "EVM alias" or "Account Number Alias".

## Docs

- [Hedera consensus node release notes](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/networks/release-notes/services.md): Release notes for Hedera consensus node (services) versions, covering new features, protocol changes, performance updates, and network upgrade details.
- [List account entities on network](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/accounts/list-account-entities-on-network.md): Returns a list of all account entity items on the network.
- [Get account by alias, id, or evm address](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/accounts/get-account-by-alias-id-or-evm-address.md): Return the account transactions and balance information given an account alias, an account id, or an evm address. The information will be limited to at most 1000 token balances for the account as outlined in HIP-367. When the timestamp parameter is supplied, we will return transactions and account s…
- [Get crypto allowances for an account info](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/accounts/get-crypto-allowances-for-an-account-info.md): Returns information for all crypto allowances for an account.
- [Get past staking reward payouts for an account](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/accounts/get-past-staking-reward-payouts-for-an-account.md): Returns information for all past staking reward payouts for an account.
- [Get token relationships info for an account](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/accounts/get-token-relationships-info-for-an-account.md): Returns information for all token relationships for an account.
- [Get outstanding token airdrops sent by an account](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/airdrops/get-outstanding-token-airdrops-sent-by-an-account.md): Returns outstanding token airdrops that have been sent by an account.
- [Get pending token airdrops received by an account](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/airdrops/get-pending-token-airdrops-received-by-an-account.md): Returns pending token airdrops that have been received by an account.
- [Get fungible token allowances for an account](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/accounts/get-fungible-token-allowances-for-an-account.md): Returns information for fungible token allowances for an account.
- [Get non fungible token allowances for an account](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/accounts/get-non-fungible-token-allowances-for-an-account.md): Returns an account's non-fungible token allowances.
- [Get nfts for an account info](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/accounts/get-nfts-for-an-account-info.md): Returns information for all non-fungible tokens for an account.
- [List account balances](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/balances/list-account-balances.md): Returns a list of account and token balances on the network. The latest balance information is returned when there is no timestamp query parameter, otherwise, the information is retrieved from snapshots with 15-minute granularity. This information is limited to at most 50 token balances per account…
- [List blocks](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/blocks/list-blocks.md): Returns a list of blocks on the network.
- [Get block by hash or number](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/blocks/get-block-by-hash-or-number.md): Returns the block information by given hash or number.
- [List contract entities on network](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/contracts/list-contract-entities-on-network.md): Returns a list of all contract entity items on the network.
- [Get contract by id](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/contracts/get-contract-by-id.md): Return the contract information given an id
- [List contract results from all contracts on the network](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/contracts/list-contract-results-from-all-contracts-on-the-network.md): Returns a list of all ContractResults for all contract's function executions.
- [Get the contract result from a contract on the network for a given transactionId or ethereum transaction hash](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/contracts/get-the-contract-result-from-a-contract-on-the-network-for-a-given-transactionid-or-ethereum-transaction-hash.md): Returns a single ContractResult for a contract's function executions for a given transactionId or ethereum transaction hash.
- [List contract results from a contract on the network](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/contracts/list-contract-results-from-a-contract-on-the-network.md): Returns a list of all ContractResults for a contract's function executions.
- [The contract state from a contract on the network](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/contracts/the-contract-state-from-a-contract-on-the-network.md): Returns a list of all contract's slots. If no timestamp is provided, returns the current state.
- [Get the contract actions from a contract on the network for a given transactionId or ethereum transaction hash](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/contracts/get-the-contract-actions-from-a-contract-on-the-network-for-a-given-transactionid-or-ethereum-transaction-hash.md): Returns a list of ContractActions for a contract's function executions for a given transactionId or ethereum transaction hash.
- [Get the contract result from a contract on the network executed at a given timestamp](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/contracts/get-the-contract-result-from-a-contract-on-the-network-executed-at-a-given-timestamp.md): Returns a single ContractResult for a contract's function executions at a specific timestamp.
- [List contract logs from a contract on the network](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/contracts/list-contract-logs-from-a-contract-on-the-network.md): Search the logs of a specific contract across multiple contract calls. Chained logs are not included but can be found by calling `/api/v1/contracts/{contractId}/results/{timestamp}` or `/api/v1/contracts/results/{transactionId}`. When searching by topic a timestamp parameter must be supplied and spa…
- [List contracts logs across many contracts on the network](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/contracts/list-contracts-logs-across-many-contracts-on-the-network.md): Search the logs across many contracts with multiple contract calls. Chained logs are not included but can be found by calling `/api/v1/contracts/{contractId}/results/{timestamp}` or `/api/v1/contracts/results/{transactionId}`. When searching by topic a timestamp parameter must be supplied and span a…
- [Get the opcode traces for a historical transaction on the network with the given transaction ID or hash](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/contracts/get-the-opcode-traces-for-a-historical-transaction-on-the-network-with-the-given-transaction-id-or-hash.md): Re-executes a transaction and returns a result containing detailed information for the execution, including all values from the {@code stack}, {@code memory} and {@code storage} and the entire trace of opcodes that were executed during the replay.
- [Invoke a smart contract](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/contracts/invoke-a-smart-contract.md): Returns a result from EVM execution such as cost-free execution of read-only smart contract queries, gas estimation, and transient simulation of read-write operations. If the `estimate` field is set to true gas estimation is executed. This API can process calls against the `latest` block or specific…
- [List tokens](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/tokens/list-tokens.md): Returns a list of tokens on the network.
- [Get token by id](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/tokens/get-token-by-id.md): Returns token entity information given the id
- [List token balances](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/tokens/list-token-balances.md): Returns a list of token balances given the id. This represents the Token supply distribution across the network
- [List nfts](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/tokens/list-nfts.md): Returns a list of non-fungible tokens
- [Get nft info](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/tokens/get-nft-info.md): Returns information for a non-fungible token
- [Get an nfts transction history](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/tokens/get-an-nfts-transction-history.md): Returns a list of transactions for a given non-fungible token
- [Get topic by ID](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/topics/get-topic-by-id.md): Returns the topic details for the given topic ID.
- [List topic messages by id](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/topics/list-topic-messages-by-id.md): Returns the list of topic messages for the given topic id.
- [Get topic message by id and sequence number](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/topics/get-topic-message-by-id-and-sequence-number.md): Returns a single topic message for the given topic id and sequence number.
- [Get topic message by consensusTimestamp](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/topics/get-topic-message-by-consensustimestamp.md): Returns a topic message the given the consensusTimestamp.
- [List transactions](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/transactions/list-transactions.md): Lists transactions on the network. This includes successful and unsuccessful transactions.
- [Get transaction by id](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/transactions/get-transaction-by-id.md): Returns transaction information based on the given transaction id
- [List schedules entities](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/schedules/list-schedules-entities.md): Lists schedules on the network that govern the execution logic of scheduled transactions. This includes executed and non executed schedules.
- [Get schedule by id](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/schedules/get-schedule-by-id.md): Returns schedule information based on the given schedule id
- [Get the network exchange rate to estimate costs](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/network/get-the-network-exchange-rate-to-estimate-costs.md): Returns the network's exchange rate, current and next.
- [Get the network fees](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/network/get-the-network-fees.md): Returns the estimated gas in tinybars per each transaction type. Default order is ASC. Currently only `ContractCall`, `ContractCreate` and `EthereumTransaction` transaction types are supported.
- [Estimate network fees](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/network/estimate-network-fees.md): Given a protobuf-encoded HAPI transaction, returns an itemized fee estimate in tinycents. The response is broken down into `node`, `network`, and `service` components, each with a `base` price and a list of `extras` (e.g., signatures, memo bytes). The `total` field is the sum of all subtotals.
- [Get the network address book nodes](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/network/get-the-network-address-book-nodes.md): Returns the network's list of nodes used in consensus
- [Get registered nodes](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/network/get-registered-nodes.md): Returns the list of registered nodes
- [Get network stake information](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/network/get-network-stake-information.md): Returns the network's current stake information.
- [Get the network supply](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/network/get-the-network-supply.md): Returns the network's released supply of hbars
- [Retrieve a summary of the status page.](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/retrieve-a-summary-of-the-status-page.md): Get a summary of the status page, including a status indicator, component statuses, unresolved incidents, and any upcoming or in-progress scheduled maintenances.
- [Retrieve the current status of the Hedera network](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/retrieve-the-current-status-of-the-hedera-network.md): Fetches the overall status and health indicators of the Hedera network.
- [List all components](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/list-all-components.md): Provides detailed information about each component of the Hedera network.
- [Retrieve all incidents](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/retrieve-all-incidents.md): Fetches a list of all incidents, both resolved and unresolved, affecting the Hedera network.
- [Retrieve unresolved incidents](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/retrieve-unresolved-incidents.md): Provides information about all currently unresolved incidents affecting the Hedera network.
- [Retrieve all scheduled maintenances](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/retrieve-all-scheduled-maintenances.md): Fetches details about all scheduled maintenance events for the Hedera network.
- [Retrieve upcoming scheduled maintenances](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/retrieve-upcoming-scheduled-maintenances.md): Provides information about all upcoming scheduled maintenance events for the Hedera network.
- [Retrieve active scheduled maintenances](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/retrieve-active-scheduled-maintenances.md): Fetches details about all currently active scheduled maintenance events for the Hedera network.
- [Verify Contract (Standard JSON)](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/verify-contracts/verify-contract-standard-json.md): Submit a contract for verification via the [Solidity standard JSON input](https://docs.soliditylang.org/en/latest/using-the-compiler.html#input-description), [Vyper JSON input](https://docs.vyperlang.org/en/stable/compiling-a-contract.html#input-json-description), or Fe JSON input (a Sourcify-define…
- [Verify Contract (using Solidity metadata.json)](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/verify-contracts/verify-contract-using-solidity-metadatajson.md): Endpoint to submit a verification with the Solidity [metadata.json](https://docs.soliditylang.org/en/latest/metadata.html)
- [Import from Etherscan](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/verify-contracts/import-from-etherscan.md): Import a contract verified on an Etherscan instance or a service with Etherscan-alike API
- [Verify contract via similarity search](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/verify-contracts/verify-contract-via-similarity-search.md): Starts a verification job that searches the Sourcify database for contracts whose runtime bytecode is similar to the contract deployed at the given address. The job will attempt to verify against each candidate until a match is found or the candidate list is exhausted.
- [Check verification job status](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/verification-jobs/check-verification-job-status.md): Endpoint to get the status of a verification job.
- [Get verified contract](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/contract-lookup/get-verified-contract.md): By default returns minimal information about the contract: `match`, `creation_match`, `runtime_match`, `chainId`, `address`, and `verifiedAt`
- [Get verified contract at an address on all chains](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/contract-lookup/get-verified-contract-at-an-address-on-all-chains.md): Returns all verified deployments at an address on all Sourcify chains (including deprecated ones).
- [List of verified contracts per chain](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/contract-lookup/list-of-verified-contracts-per-chain.md): Retrieve the verified contracts on a chain
- [Health check endpoint](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/other/health-check-endpoint.md): Returns server health status
- [Get version information](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/other/get-version-information.md): Returns version information for the server and its dependencies, along with the git commit hash
- [Get the list of supported and deprecated chains](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/api-reference/other/get-the-list-of-supported-and-deprecated-chains.md)

## OpenAPI Specs

- [smart-contract-verification-api](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/smart-contract-verification-api.yaml)
- [openapi](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/openapi.yaml)
- [hedera-status-api](https://hedera-0c6e0218-automation-consensus-node-release-notes.mintlify.site/hedera-status-api.yaml)

## Optional

- [Status](http://status.hedera.com/)
- [Discord](https://hedera.com/discord)
- [Playground](https://portal.hedera.com/playground)
- [Blog](https://hedera.com/blog)