Get smart contract info

A query that returns the current state of a smart contract instance, including its balance. Queries do not change the state of the smart contract or require network consensus. The information is returned from a single node processing the query.

In Services release 0.50, Returning token balance information from the consensus node was deprecated with HIP-367. This query now returns token information by requesting the information from the Hedera Mirror Node APIs via /api/v1/accounts/{id}/tokens. Token symbol is not returned in the response.

Smart Contract Info Response

Field
Description

Contract ID

ID of the contract instance, in the format used in transactions.

Account ID

ID of the cryptocurrency account owned by the contract instance.

Contract Account ID

ID of both the contract instance and the cryptocurrency account owned by the contract.

Admin Key

The state of the instance and its fields can be modified arbitrarily if this key signs a transaction to modify it. If this is null, then such modifications are not possible, and there is no administrator that can override the normal operation of this smart contract instance. Note that if it is created with no admin keys, then there is no administrator to authorize changing the admin keys, so there can never be any admin keys for that instance.

Expiration Time

The current time at which this contract instance (and its account) is set to expire.

Auto Renew Period

The expiration time will extend every this many seconds. If there are insufficient funds, then it extends as long as possible. If the account is empty when it expires, then it is deleted.

Storage

Number of bytes of storage being used by this instance (which affects the cost to extend the expiration time).

Contract Memo

The memo associated with the contract (max 100 bytes).

Balance

The current balance of the contract.

Deleted

Whether the contract has been deleted.

Ledger ID

The ID of the network the response came from. See HIP-198.

Staking Info

The staking metadata for this contract. This includes the staking period start, the pending reward, the account ID or the node ID, whether or not rewards were declined, and how many hbars are staked to this contract account, if any. See HIP-406. Live on: previewnet/testnet

Token Relationships

The metadata of the tokens associated to the contract.

Query Signing Requirements

  • The client operator account's private key (fee payer) is required to sign this query

Query Fees

  • Please see the transaction and query fees table for the base transaction fee

  • Please use the Hedera fee estimator to estimate your query fee

Methods

Method
Type
Description

setContractId(<contractId>)

ContractId

The ID of the smart contract to return the token for

//Create the query
ContractInfoQuery query = new ContractInfoQuery()
    .setContractId(contractId);

//Sign the query with the client operator private key and submit to a Hedera network
ContractInfo info = query.execute(client);

System.out.print(info);
ContractInfo{
     contractId=0.0.104966, 
     accountId=0.0.104966, 
     contractAccountId=0000000000000000000000000000000000019a06,    
     adminKey=302a300506032b6570032100fcd7cce3eef78f76a538c5573ce8f00258 
          386741e03adc17c66075bf659b865d, 
     expirationTime=2021-02-10T22:27:15Z,    
     autoRenewPeriod=PT2160H, 
     storage=523, 
     contractMemo=, 
     balance=0 tℏ
}

Last updated

#2871: HIP-423 long term scheduled transactions

Change request updated