IContract

Base interface for smart contracts deployed on chain. Extends the Address interface with contract-specific metadata including deployment information and token standards.

Schema Definition

interface IContract implements Address {
  address: AddressString!
  nonce: Int!
  lastActiveAt: Timestamp
  transactionCount: Int!
  tokenBalances(
    first: Int = 10
    after: Cursor
    where: TokenBalanceFilter
    orderBy: TokenBalanceOrderBy
    orderDirection: OrderDirection
  ): TokenBalanceList!
  nftBalances(
    first: Int = 10
    after: Cursor
    where: NFTBalanceFilter
    orderBy: NFTBalanceOrderBy
    orderDirection: OrderDirection
  ): NFTBalanceList!
  transactions(
    first: Int = 10
    after: Cursor
    where: TransactionFilter
    orderBy: TransactionOrderBy
    orderDirection: OrderDirection
  ): TransactionList!
  standards: [Standard!]!
  name: String
  symbol: String
  createdAt: Timestamp
  createdInBlock: Block
  createdByTransaction: Transaction
  creator: Address
}

Fields

Field	Type	Description
address	AddressString! non-null scalar	The contract address as a checksummed hex string (0x-prefixed, 42 characters).
nonce	Int! non-null scalar	Number of internal transactions or contract interactions initiated by this contract.
lastActiveAt	Timestamp scalar	Timestamp of the most recent transaction involving this contract, or null if never active after deployment.
transactionCount	Int! non-null scalar	Total number of transactions where this contract was involved.
tokenBalances	TokenBalanceList! non-null object	ERC-20 token balances held by this contract, paginated.
nftBalances	NFTBalanceList! non-null object	NFT balances held by this contract, paginated.
transactions	TransactionList! non-null object	Transactions involving this contract, paginated.
standards	[Standard!]! non-null enum	Token standards implemented by this contract, detected via ERC-165 or function signature analysis.
name	String scalar	Human-readable name of the contract or token collection (e.g., USD Coin, Bored Ape Yacht Club), or null if not available.
symbol	String scalar	Token symbol (e.g., USDC, BAYC), or null if not available.
createdAt	Timestamp scalar	Timestamp when the contract was deployed to the blockchain.
createdInBlock	Block object	The block in which the contract was deployed.
createdByTransaction	Transaction object	The transaction that deployed this contract.
creator	Address interface	The address (EOA or contract) that deployed this contract.

tokenBalances Arguments

Argument	Type	Description
first	Int scalar	Maximum number of results to return (default: 10, max: 100).
after	Cursor scalar	Cursor for pagination. Pass the endCursor from a previous query to get the next page.
where	TokenBalanceFilter input	Filter criteria for token balances.
orderBy	TokenBalanceOrderBy enum	Field to sort results by.
orderDirection	OrderDirection enum	Sort direction (ascending or descending).

nftBalances Arguments

Argument	Type	Description
first	Int scalar	Maximum number of results to return (default: 10, max: 100).
after	Cursor scalar	Cursor for pagination. Pass the endCursor from a previous query to get the next page.
where	NFTBalanceFilter input	Filter criteria for NFT balances.
orderBy	NFTBalanceOrderBy enum	Field to sort results by.
orderDirection	OrderDirection enum	Sort direction (ascending or descending).

transactions Arguments

Argument	Type	Description
first	Int scalar	Maximum number of results to return (default: 10, max: 100).
after	Cursor scalar	Cursor for pagination. Pass the endCursor from a previous query to get the next page.
where	TransactionFilter input	Filter criteria for transactions.
orderBy	TransactionOrderBy enum	Field to sort results by.
orderDirection	OrderDirection enum	Sort direction (ascending or descending).

Interfaces

Interface	Description
Address interface	Base interface for any address on chain, whether an externally owned account (EOA) or a smart contract. Provides common fields for address identification, activity tracking, and asset balances.

Returned By

contract query

Member Of

ContractList object ● Transaction object

Implemented By

Contract object ● NFTContract object ● Token object