## ChartDataPoint **Type:** GraphQL objects **Description:** A single time-series data point used in historical charts. Each data point represents the value of a given metric (such as TVL or trading volume) at a specific moment in time. ### Fields - timestamp (DateTime): The timestamp associated with this data point. - value (Decimal): The metric value recorded at this timestamp. --- ## PoolCharts **Type:** GraphQL objects **Description:** Chart data for a pool ### Fields - volume (ChartDataPoint, Not Null): Volume data points - timestamp (DateTime): The timestamp associated with this data point. - value (Decimal): The metric value recorded at this timestamp. - tvl (ChartDataPoint, Not Null): TVL data points - timestamp (DateTime): The timestamp associated with this data point. - value (Decimal): The metric value recorded at this timestamp. - fees (ChartDataPoint, Not Null): Fees data points - timestamp (DateTime): The timestamp associated with this data point. - value (Decimal): The metric value recorded at this timestamp. --- ## QueryTransactionsByPactCodeConnection **Type:** GraphQL objects ### Fields - edges (QueryTransactionsByPactCodeConnectionEdge, Not Null): undefined - cursor (String) - node (TransactionSummary) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. --- ## QueryTransactionsByPactCodeConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (TransactionSummary, Not Null): undefined - requestKey (String): The unique request key of the transaction. - height (BigInt): The block height at which the transaction was included. - chainId (BigInt): The chain ID where the transaction was executed. - canonical (Boolean): Whether the transaction was included in the canonical chain (`true`) or an orphaned fork (`false`). - creationTime (DateTime): The timestamp when the transaction was created. - badResult (String): If the transaction failed, contains the error message returned by Pact. - sender (String): The account or contract that submitted the transaction. - gas (String): The total gas consumed during the execution of this transaction. - gasLimit (String): The maximum amount of gas allowed for this transaction. - gasPrice (String): The gas price specified for this transaction. - code (String): The Pact code executed by the transaction, if available. --- ## TransactionSummary **Type:** GraphQL objects **Description:** A lightweight summary of a transaction returned by the `transactionsByPactCode` query. `TransactionSummary` provides essential metadata and execution details about transactions that executed a specific Pact code, without the full payload of a `Transaction` object. It is optimized for querying large sets of transactions efficiently when detailed fields (like signatures, events, or full results) are not needed. Each summary includes fundamental information such as the transaction’s request key, block height, chain, gas usage, sender, and canonical status, as well as the original Pact code if available. ### Fields - requestKey (String): The unique request key of the transaction. - height (BigInt): The block height at which the transaction was included. - chainId (BigInt): The chain ID where the transaction was executed. - canonical (Boolean): Whether the transaction was included in the canonical chain (`true`) or an orphaned fork (`false`). - creationTime (DateTime): The timestamp when the transaction was created. - badResult (String): If the transaction failed, contains the error message returned by Pact. - sender (String): The account or contract that submitted the transaction. - gas (String): The total gas consumed during the execution of this transaction. - gasLimit (String): The maximum amount of gas allowed for this transaction. - gasPrice (String): The gas price specified for this transaction. - code (String): The Pact code executed by the transaction, if available. --- ## QueryBalanceConnection **Type:** GraphQL objects **Description:** Connection type for balance query results. ### Fields - edges (QueryBalanceConnectionEdge, Not Null): undefined - cursor (String) - node (BalanceNode) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. --- ## QueryBalanceConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (BalanceNode, Not Null): undefined - accountName (String): The full account name to retrieve balances for. @example(value: "k:bcbaf20fb2975ae362ae82b27afce1ac4a72774c6c45fa1afd8df394e6141251") - module (String): The name of the module that issued the token. - chainId (String): The chain ID where the balance exists. - balance (String): The balance amount. --- ## BalanceNode **Type:** GraphQL objects **Description:** A representation of a balance in the Kadena blockchain. ### Fields - accountName (String): The full account name to retrieve balances for. @example(value: "k:bcbaf20fb2975ae362ae82b27afce1ac4a72774c6c45fa1afd8df394e6141251") - module (String): The name of the module that issued the token. - chainId (String): The chain ID where the balance exists. - balance (String): The balance amount. --- ## FungibleAccount **Type:** GraphQL objects **Description:** Represents an account associated with a specific fungible token on the Kadena blockchain. A `FungibleAccount` tracks the balance and activity of a single account (such as a user key account or contract) for a given fungible token module (for example, `coin` for KDA). Because Kadena is a multi-chain network, a fungible account may have balances distributed across multiple chains. This type exposes both the aggregated balance and per-chain details, along with historical transactions and transfers. ### Fields - id (ID): Globally unique identifier for this fungible account node. - accountName (String): The full name of the account (e.g., `k:abcdef123456...` for a user account or `free.my-contract` for a contract account). - chainAccounts (FungibleChainAccount, Not Null): Per-chain breakdown of this fungible account. Since Kadena operates multiple braided chains, an account can have different balances on each chain. - id (ID): Globally unique identifier for this chain account node. - accountName (String): The full name of the account (e.g., `k:abcdef123456...` for a user account or `free.my-contract` for a contract account). - balance (Float): The current balance of this account on the specified chain for the given fungible token. - chainId (String): The chain ID where this account exists. - fungibleName (String): The name of the fungible token module associated with this account (e.g., `coin`). - guard (IGuard): The guard that defines the account’s security conditions. A guard determines who must sign transactions in order to spend from this account. - transactions (FungibleChainAccountTransactionsConnection): Paginated list of transactions involving this account on this chain. Transactions represent operations such as transfers, contract calls, or other state changes. - transfers (FungibleChainAccountTransfersConnection): Paginated list of token transfers into or out of this account on this chain. Transfers are a subset of events focused specifically on balance movements. - fungibleName (String): The name of the fungible token module associated with this account (e.g., `coin`). - totalBalance (Decimal): The total balance of this account across all chains for the specified fungible token. - transactions (FungibleAccountTransactionsConnection, Not Null): Paginated list of transactions involving this account. Transactions represent operations such as transfers, contract calls, or other state changes that affect this account. - edges (FungibleAccountTransactionsConnectionEdge) - pageInfo (PageInfo) - totalCount (Int) - transfers (FungibleAccountTransfersConnection, Not Null): Paginated list of transfers associated with this account. Transfers represent direct movements of the fungible token into or out of this account. - edges (FungibleAccountTransfersConnectionEdge) - pageInfo (PageInfo) - totalCount (Int) --- ## FungibleAccountTransactionsConnection **Type:** GraphQL objects ### Fields - edges (FungibleAccountTransactionsConnectionEdge, Not Null): undefined - cursor (String) - node (Transaction) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. - totalCount (Int) --- ## FungibleAccountTransactionsConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (Transaction, Not Null): undefined - id (ID): Globally unique identifier for this transaction node. - cmd (TransactionCommand): The original signed transaction command submitted to the network. Includes metadata, payload, signers, and network information. - hash (String): The unique hash of the transaction. This value is derived from the signed command and serves as the canonical identifier for the transaction on-chain. - result (TransactionInfo): The result of executing the transaction. Includes information such as success/failure status, events, continuation data, and any state changes triggered by execution. - sigs (TransactionSignature): The list of signatures associated with the transaction. Each signature proves authorization from a required signer and is used to validate that the transaction was properly authorized before execution. --- ## FungibleAccountTransfersConnection **Type:** GraphQL objects ### Fields - edges (FungibleAccountTransfersConnectionEdge, Not Null): undefined - cursor (String) - node (Transfer) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. - totalCount (Int) --- ## FungibleAccountTransfersConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (Transfer, Not Null): undefined - amount (Decimal) - block (Block) - blockHash (String) - chainId (BigInt) - creationTime (DateTime) - crossChainTransfer (Transfer): The counterpart of the crosschain-transfer. `null` when it is not a cross-chain-transfer. - height (BigInt) - id (ID) - moduleHash (String) - moduleName (String) - orderIndex (BigInt): The order of the transfer when it is a `defpact` (multi-step transaction) execution. - receiverAccount (String) - requestKey (String) - senderAccount (String) - tokenId (String): The token id if this is a poly-fungible transfer. - transaction (Transaction): The transaction that initiated this transfer. --- ## QueryCompletedBlockHeightsConnection **Type:** GraphQL objects ### Fields - edges (QueryCompletedBlockHeightsConnectionEdge, Not Null): undefined - cursor (String) - node (Block) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. --- ## QueryCompletedBlockHeightsConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (Block, Not Null): undefined - id (ID): Globally unique identifier for this block node. - hash (String): The cryptographic hash of the block. This serves as its unique identifier within the blockchain. - chainId (BigInt): The specific chain where this block was mined. Kadena is a multi-chain system, and each block belongs to exactly one chain. - creationTime (DateTime): The timestamp when this block was created and added to the chain. - difficulty (BigInt): The network difficulty at the time the block was mined. Higher difficulty reflects the amount of computational work required to produce a valid block. - epoch (DateTime): The epoch timestamp marking when the difficulty was last adjusted. Kadena targets ~30 seconds per block, and the difficulty is recalibrated periodically to maintain that target. - flags (Decimal): Consensus flags used internally by the protocol. - height (BigInt): The height (block number) of this block within its chain. The genesis block is height 0, and each subsequent block increments by 1. - nonce (Decimal): A nonce value used in the proof-of-work process. Miners vary this value to discover a hash below the target threshold. - payloadHash (String): The hash of the payload data contained within the block. This ensures the integrity of the transactions and other included data. - weight (String): The cumulative weight of the chain up to and including this block. Weight increases with each mined block and helps determine the canonical chain. - target (String): The target hash threshold that the block’s proof-of-work hash must fall below. This value adjusts with difficulty to regulate block production time. - coinbase (String): The coinbase transaction data. This transaction rewards the miner and may include information about block rewards or other protocol-defined payouts. - neighbors (BlockNeighbor): The neighboring blocks that reference this block as a parent. These neighbors are essential in Kadena’s braided multi-chain architecture. - powHash (String): The proof-of-work hash of the block. This is the result of hashing the block header with the nonce and must satisfy the target condition. - canonical (Boolean): Indicates whether this block is part of the canonical chain. Non-canonical blocks may occur during temporary forks or reorganizations. - parent (Block): The parent block directly preceding this one in the chain. Together with the hash, this forms the cryptographic link that secures the chain. - totalGasUsedInKda (Decimal): The total amount of gas used by all transactions in this block, expressed in KDA. - events (BlockEventsConnection): Paginated list of events emitted by transactions within this block. - minerAccount (FungibleChainAccount): The account that mined this block and received the coinbase reward. - transactions (BlockTransactionsConnection): Paginated list of transactions included in this block. --- ## NonFungibleTokenBalance **Type:** GraphQL objects **Description:** Represents the balance of a specific non-fungible token (NFT) for a given account on a specific chain. Each `NonFungibleTokenBalance` entry links an account, a unique token identifier, and its associated metadata. Unlike fungible balances, which represent divisible amounts, non-fungible balances typically indicate ownership of unique tokens — usually `0` (not owned) or `1` (owned) per token ID. This type is useful for exploring which NFTs an account holds, retrieving metadata about those tokens, and inspecting the chain and guard conditions associated with them. ### Fields - accountName (String): The full name of the account associated with this NFT balance. Example: `"k:abcdef123456..."` for a user account or `"free.my-contract"` for a contract account. - balance (Int): The balance of this specific non-fungible token for the account. Typically `1` if the token is owned or `0` if not. - chainId (String): The chain ID where this token balance is tracked. - guard (IGuard, Not Null): The guard that defines the security conditions for this token. A guard specifies who must sign transactions in order to transfer or interact with this token. - keys (String) - predicate (String) - raw (String) - id (ID): Globally unique identifier for this NFT balance node. - info (NonFungibleToken): Metadata and details of the non-fungible token associated with this balance. - precision (Int): The number of decimal places used by this token. For NFTs this is usually `0`, as they represent indivisible assets. - supply (Int): The total number of tokens minted for this NFT collection or contract. - uri (String): A URI pointing to external metadata for the token. This may include fields like name, description, image, attributes, or links to off-chain data. - tokenId (String): The unique identifier of the non-fungible token. - version (String): The version of the token or contract associated with this NFT. Useful for distinguishing between different token contract versions or upgrades. --- ## NonFungibleToken **Type:** GraphQL objects **Description:** The `NonFungibleToken` type provides key properties of a specific NFT, including its total supply, decimal precision, and a reference URI containing extended metadata such as name, image, description, or external resources. This type is typically returned as part of a `NonFungibleTokenBalance` object. ### Fields - precision (Int): The number of decimal places used by this token. For NFTs this is usually `0`, as they represent indivisible assets. - supply (Int): The total number of tokens minted for this NFT collection or contract. - uri (String): A URI pointing to external metadata for the token. This may include fields like name, description, image, attributes, or links to off-chain data. --- ## QueryTransactionsByPublicKeyConnection **Type:** GraphQL objects ### Fields - edges (QueryTransactionsByPublicKeyConnectionEdge, Not Null): undefined - cursor (String) - node (Transaction) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. - totalCount (Int) --- ## QueryTransactionsByPublicKeyConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (Transaction, Not Null): undefined - id (ID): Globally unique identifier for this transaction node. - cmd (TransactionCommand): The original signed transaction command submitted to the network. Includes metadata, payload, signers, and network information. - hash (String): The unique hash of the transaction. This value is derived from the signed command and serves as the canonical identifier for the transaction on-chain. - result (TransactionInfo): The result of executing the transaction. Includes information such as success/failure status, events, continuation data, and any state changes triggered by execution. - sigs (TransactionSignature): The list of signatures associated with the transaction. Each signature proves authorization from a required signer and is used to validate that the transaction was properly authorized before execution. --- ## QueryEventsConnection **Type:** GraphQL objects ### Fields - edges (QueryEventsConnectionEdge, Not Null): undefined - cursor (String) - node (Event) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. - totalCount (Int) --- ## QueryEventsConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (Event, Not Null): undefined - id (ID): Globally unique identifier for this event. - name (String): The name of the event as defined in the smart contract. Example: `"TRANSFER"`. - block (Block): The block in which this event was emitted. - chainId (BigInt): The ID of the chain where the event occurred. - height (BigInt): The height of the block in which this event was emitted. - moduleName (String): The name of the module that emitted the event. Example: `"coin"`. - orderIndex (BigInt): The index position of this event within the transaction’s event list. Useful when multiple events are emitted by the same transaction. - requestKey (String): The request key of the transaction that emitted this event. - parameters (String): The raw JSON-encoded event parameters as emitted by the contract. - parameterText (String): A human-readable text representation of the event parameters. - qualifiedName (String): The fully qualified event name, combining the module and event name. Example: `"coin.TRANSFER"`. - transaction (Transaction): The transaction that emitted this event. --- ## QueryBlocksFromHeightConnection **Type:** GraphQL objects ### Fields - edges (QueryBlocksFromHeightConnectionEdge, Not Null): undefined - cursor (String) - node (Block) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. - totalCount (Int) --- ## QueryBlocksFromHeightConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (Block, Not Null): undefined - id (ID): Globally unique identifier for this block node. - hash (String): The cryptographic hash of the block. This serves as its unique identifier within the blockchain. - chainId (BigInt): The specific chain where this block was mined. Kadena is a multi-chain system, and each block belongs to exactly one chain. - creationTime (DateTime): The timestamp when this block was created and added to the chain. - difficulty (BigInt): The network difficulty at the time the block was mined. Higher difficulty reflects the amount of computational work required to produce a valid block. - epoch (DateTime): The epoch timestamp marking when the difficulty was last adjusted. Kadena targets ~30 seconds per block, and the difficulty is recalibrated periodically to maintain that target. - flags (Decimal): Consensus flags used internally by the protocol. - height (BigInt): The height (block number) of this block within its chain. The genesis block is height 0, and each subsequent block increments by 1. - nonce (Decimal): A nonce value used in the proof-of-work process. Miners vary this value to discover a hash below the target threshold. - payloadHash (String): The hash of the payload data contained within the block. This ensures the integrity of the transactions and other included data. - weight (String): The cumulative weight of the chain up to and including this block. Weight increases with each mined block and helps determine the canonical chain. - target (String): The target hash threshold that the block’s proof-of-work hash must fall below. This value adjusts with difficulty to regulate block production time. - coinbase (String): The coinbase transaction data. This transaction rewards the miner and may include information about block rewards or other protocol-defined payouts. - neighbors (BlockNeighbor): The neighboring blocks that reference this block as a parent. These neighbors are essential in Kadena’s braided multi-chain architecture. - powHash (String): The proof-of-work hash of the block. This is the result of hashing the block header with the nonce and must satisfy the target condition. - canonical (Boolean): Indicates whether this block is part of the canonical chain. Non-canonical blocks may occur during temporary forks or reorganizations. - parent (Block): The parent block directly preceding this one in the chain. Together with the hash, this forms the cryptographic link that secures the chain. - totalGasUsedInKda (Decimal): The total amount of gas used by all transactions in this block, expressed in KDA. - events (BlockEventsConnection): Paginated list of events emitted by transactions within this block. - minerAccount (FungibleChainAccount): The account that mined this block and received the coinbase reward. - transactions (BlockTransactionsConnection): Paginated list of transactions included in this block. --- ## QueryBlocksFromDepthConnection **Type:** GraphQL objects ### Fields - edges (QueryBlocksFromDepthConnectionEdge, Not Null): undefined - cursor (String) - node (Block) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. - totalCount (Int) --- ## QueryBlocksFromDepthConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (Block, Not Null): undefined - id (ID): Globally unique identifier for this block node. - hash (String): The cryptographic hash of the block. This serves as its unique identifier within the blockchain. - chainId (BigInt): The specific chain where this block was mined. Kadena is a multi-chain system, and each block belongs to exactly one chain. - creationTime (DateTime): The timestamp when this block was created and added to the chain. - difficulty (BigInt): The network difficulty at the time the block was mined. Higher difficulty reflects the amount of computational work required to produce a valid block. - epoch (DateTime): The epoch timestamp marking when the difficulty was last adjusted. Kadena targets ~30 seconds per block, and the difficulty is recalibrated periodically to maintain that target. - flags (Decimal): Consensus flags used internally by the protocol. - height (BigInt): The height (block number) of this block within its chain. The genesis block is height 0, and each subsequent block increments by 1. - nonce (Decimal): A nonce value used in the proof-of-work process. Miners vary this value to discover a hash below the target threshold. - payloadHash (String): The hash of the payload data contained within the block. This ensures the integrity of the transactions and other included data. - weight (String): The cumulative weight of the chain up to and including this block. Weight increases with each mined block and helps determine the canonical chain. - target (String): The target hash threshold that the block’s proof-of-work hash must fall below. This value adjusts with difficulty to regulate block production time. - coinbase (String): The coinbase transaction data. This transaction rewards the miner and may include information about block rewards or other protocol-defined payouts. - neighbors (BlockNeighbor): The neighboring blocks that reference this block as a parent. These neighbors are essential in Kadena’s braided multi-chain architecture. - powHash (String): The proof-of-work hash of the block. This is the result of hashing the block header with the nonce and must satisfy the target condition. - canonical (Boolean): Indicates whether this block is part of the canonical chain. Non-canonical blocks may occur during temporary forks or reorganizations. - parent (Block): The parent block directly preceding this one in the chain. Together with the hash, this forms the cryptographic link that secures the chain. - totalGasUsedInKda (Decimal): The total amount of gas used by all transactions in this block, expressed in KDA. - events (BlockEventsConnection): Paginated list of events emitted by transactions within this block. - minerAccount (FungibleChainAccount): The account that mined this block and received the coinbase reward. - transactions (BlockTransactionsConnection): Paginated list of transactions included in this block. --- ## QueryTransactionsConnection **Type:** GraphQL objects ### Fields - edges (QueryTransactionsConnectionEdge, Not Null): undefined - cursor (String) - node (Transaction) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. - totalCount (Int) --- ## QueryTransactionsConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (Transaction, Not Null): undefined - id (ID): Globally unique identifier for this transaction node. - cmd (TransactionCommand): The original signed transaction command submitted to the network. Includes metadata, payload, signers, and network information. - hash (String): The unique hash of the transaction. This value is derived from the signed command and serves as the canonical identifier for the transaction on-chain. - result (TransactionInfo): The result of executing the transaction. Includes information such as success/failure status, events, continuation data, and any state changes triggered by execution. - sigs (TransactionSignature): The list of signatures associated with the transaction. Each signature proves authorization from a required signer and is used to validate that the transaction was properly authorized before execution. --- ## QueryTransfersConnection **Type:** GraphQL objects ### Fields - edges (QueryTransfersConnectionEdge, Not Null): undefined - cursor (String) - node (Transfer) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. - totalCount (Int) --- ## QueryTransfersConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (Transfer, Not Null): undefined - amount (Decimal) - block (Block) - blockHash (String) - chainId (BigInt) - creationTime (DateTime) - crossChainTransfer (Transfer): The counterpart of the crosschain-transfer. `null` when it is not a cross-chain-transfer. - height (BigInt) - id (ID) - moduleHash (String) - moduleName (String) - orderIndex (BigInt): The order of the transfer when it is a `defpact` (multi-step transaction) execution. - receiverAccount (String) - requestKey (String) - senderAccount (String) - tokenId (String): The token id if this is a poly-fungible transfer. - transaction (Transaction): The transaction that initiated this transfer. --- ## Block **Type:** GraphQL objects **Description:** A **Block** is the fundamental unit of the Kadena blockchain. Each block bundles a verified set of transactions and metadata that secure and extend the chain. Blocks are linked together cryptographically — each one referencing its parent — forming the immutable and tamper-evident chain structure. This type exposes all the core properties of a block, including consensus data (like difficulty, nonce, and proof of work), network metadata (like chain ID and epoch), and relations to transactions, events, and neighboring blocks. ### Fields - id (ID): Globally unique identifier for this block node. - hash (String): The cryptographic hash of the block. This serves as its unique identifier within the blockchain. - chainId (BigInt): The specific chain where this block was mined. Kadena is a multi-chain system, and each block belongs to exactly one chain. - creationTime (DateTime): The timestamp when this block was created and added to the chain. - difficulty (BigInt): The network difficulty at the time the block was mined. Higher difficulty reflects the amount of computational work required to produce a valid block. - epoch (DateTime): The epoch timestamp marking when the difficulty was last adjusted. Kadena targets ~30 seconds per block, and the difficulty is recalibrated periodically to maintain that target. - flags (Decimal): Consensus flags used internally by the protocol. - height (BigInt): The height (block number) of this block within its chain. The genesis block is height 0, and each subsequent block increments by 1. - nonce (Decimal): A nonce value used in the proof-of-work process. Miners vary this value to discover a hash below the target threshold. - payloadHash (String): The hash of the payload data contained within the block. This ensures the integrity of the transactions and other included data. - weight (String): The cumulative weight of the chain up to and including this block. Weight increases with each mined block and helps determine the canonical chain. - target (String): The target hash threshold that the block’s proof-of-work hash must fall below. This value adjusts with difficulty to regulate block production time. - coinbase (String): The coinbase transaction data. This transaction rewards the miner and may include information about block rewards or other protocol-defined payouts. - neighbors (BlockNeighbor, Not Null): The neighboring blocks that reference this block as a parent. These neighbors are essential in Kadena’s braided multi-chain architecture. - chainId (String) - hash (String) - powHash (String): The proof-of-work hash of the block. This is the result of hashing the block header with the nonce and must satisfy the target condition. - canonical (Boolean): Indicates whether this block is part of the canonical chain. Non-canonical blocks may occur during temporary forks or reorganizations. - parent (Block): The parent block directly preceding this one in the chain. Together with the hash, this forms the cryptographic link that secures the chain. - id (ID): Globally unique identifier for this block node. - hash (String): The cryptographic hash of the block. This serves as its unique identifier within the blockchain. - chainId (BigInt): The specific chain where this block was mined. Kadena is a multi-chain system, and each block belongs to exactly one chain. - creationTime (DateTime): The timestamp when this block was created and added to the chain. - difficulty (BigInt): The network difficulty at the time the block was mined. Higher difficulty reflects the amount of computational work required to produce a valid block. - epoch (DateTime): The epoch timestamp marking when the difficulty was last adjusted. Kadena targets ~30 seconds per block, and the difficulty is recalibrated periodically to maintain that target. - flags (Decimal): Consensus flags used internally by the protocol. - height (BigInt): The height (block number) of this block within its chain. The genesis block is height 0, and each subsequent block increments by 1. - nonce (Decimal): A nonce value used in the proof-of-work process. Miners vary this value to discover a hash below the target threshold. - payloadHash (String): The hash of the payload data contained within the block. This ensures the integrity of the transactions and other included data. - weight (String): The cumulative weight of the chain up to and including this block. Weight increases with each mined block and helps determine the canonical chain. - target (String): The target hash threshold that the block’s proof-of-work hash must fall below. This value adjusts with difficulty to regulate block production time. - coinbase (String): The coinbase transaction data. This transaction rewards the miner and may include information about block rewards or other protocol-defined payouts. - neighbors (BlockNeighbor): The neighboring blocks that reference this block as a parent. These neighbors are essential in Kadena’s braided multi-chain architecture. - powHash (String): The proof-of-work hash of the block. This is the result of hashing the block header with the nonce and must satisfy the target condition. - canonical (Boolean): Indicates whether this block is part of the canonical chain. Non-canonical blocks may occur during temporary forks or reorganizations. - parent (Block): The parent block directly preceding this one in the chain. Together with the hash, this forms the cryptographic link that secures the chain. - totalGasUsedInKda (Decimal): The total amount of gas used by all transactions in this block, expressed in KDA. - events (BlockEventsConnection): Paginated list of events emitted by transactions within this block. - minerAccount (FungibleChainAccount): The account that mined this block and received the coinbase reward. - transactions (BlockTransactionsConnection): Paginated list of transactions included in this block. - totalGasUsedInKda (Decimal): The total amount of gas used by all transactions in this block, expressed in KDA. - events (BlockEventsConnection, Not Null): Paginated list of events emitted by transactions within this block. - edges (BlockEventsConnectionEdge) - pageInfo (PageInfo) - totalCount (Int) - minerAccount (FungibleChainAccount, Not Null): The account that mined this block and received the coinbase reward. - id (ID): Globally unique identifier for this chain account node. - accountName (String): The full name of the account (e.g., `k:abcdef123456...` for a user account or `free.my-contract` for a contract account). - balance (Float): The current balance of this account on the specified chain for the given fungible token. - chainId (String): The chain ID where this account exists. - fungibleName (String): The name of the fungible token module associated with this account (e.g., `coin`). - guard (IGuard): The guard that defines the account’s security conditions. A guard determines who must sign transactions in order to spend from this account. - transactions (FungibleChainAccountTransactionsConnection): Paginated list of transactions involving this account on this chain. Transactions represent operations such as transfers, contract calls, or other state changes. - transfers (FungibleChainAccountTransfersConnection): Paginated list of token transfers into or out of this account on this chain. Transfers are a subset of events focused specifically on balance movements. - transactions (BlockTransactionsConnection, Not Null): Paginated list of transactions included in this block. - edges (BlockTransactionsConnectionEdge) - pageInfo (PageInfo) - totalCount (Int) --- ## BlockNeighbor **Type:** GraphQL objects **Description:** The neighbor of a block. ### Fields - chainId (String) - hash (String) --- ## BlockEventsConnection **Type:** GraphQL objects ### Fields - edges (BlockEventsConnectionEdge, Not Null): undefined - cursor (String) - node (Event) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. - totalCount (Int) --- ## BlockEventsConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (Event, Not Null): undefined - id (ID): Globally unique identifier for this event. - name (String): The name of the event as defined in the smart contract. Example: `"TRANSFER"`. - block (Block): The block in which this event was emitted. - chainId (BigInt): The ID of the chain where the event occurred. - height (BigInt): The height of the block in which this event was emitted. - moduleName (String): The name of the module that emitted the event. Example: `"coin"`. - orderIndex (BigInt): The index position of this event within the transaction’s event list. Useful when multiple events are emitted by the same transaction. - requestKey (String): The request key of the transaction that emitted this event. - parameters (String): The raw JSON-encoded event parameters as emitted by the contract. - parameterText (String): A human-readable text representation of the event parameters. - qualifiedName (String): The fully qualified event name, combining the module and event name. Example: `"coin.TRANSFER"`. - transaction (Transaction): The transaction that emitted this event. --- ## PageInfo **Type:** GraphQL objects **Description:** Pagination metadata returned alongside paginated query results. `PageInfo` provides information about the current page of results and whether there are more items available before or after the current set. It is used in all connection-based queries to enable efficient cursor-based pagination. You can use `startCursor` and `endCursor` as the `before` and `after` arguments in subsequent queries to fetch previous or next pages of data. ### Fields - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. --- ## Event **Type:** GraphQL objects **Description:** Represents an event emitted during the execution of a smart contract function. Events are structured outputs generated by Pact code when certain actions occur on-chain — such as token transfers, mints, burns, or other contract-specific behaviors. They are commonly used by explorers, indexers, wallets, and analytics tools to track contract activity, monitor state changes, and trigger off-chain processes. Each event is associated with a specific block, transaction, and request key, and includes metadata like its qualified name (`moduleName.eventName`), parameters, and position within the transaction. ### Fields - id (ID): Globally unique identifier for this event. - name (String): The name of the event as defined in the smart contract. Example: `"TRANSFER"`. - block (Block, Not Null): The block in which this event was emitted. - id (ID): Globally unique identifier for this block node. - hash (String): The cryptographic hash of the block. This serves as its unique identifier within the blockchain. - chainId (BigInt): The specific chain where this block was mined. Kadena is a multi-chain system, and each block belongs to exactly one chain. - creationTime (DateTime): The timestamp when this block was created and added to the chain. - difficulty (BigInt): The network difficulty at the time the block was mined. Higher difficulty reflects the amount of computational work required to produce a valid block. - epoch (DateTime): The epoch timestamp marking when the difficulty was last adjusted. Kadena targets ~30 seconds per block, and the difficulty is recalibrated periodically to maintain that target. - flags (Decimal): Consensus flags used internally by the protocol. - height (BigInt): The height (block number) of this block within its chain. The genesis block is height 0, and each subsequent block increments by 1. - nonce (Decimal): A nonce value used in the proof-of-work process. Miners vary this value to discover a hash below the target threshold. - payloadHash (String): The hash of the payload data contained within the block. This ensures the integrity of the transactions and other included data. - weight (String): The cumulative weight of the chain up to and including this block. Weight increases with each mined block and helps determine the canonical chain. - target (String): The target hash threshold that the block’s proof-of-work hash must fall below. This value adjusts with difficulty to regulate block production time. - coinbase (String): The coinbase transaction data. This transaction rewards the miner and may include information about block rewards or other protocol-defined payouts. - neighbors (BlockNeighbor): The neighboring blocks that reference this block as a parent. These neighbors are essential in Kadena’s braided multi-chain architecture. - powHash (String): The proof-of-work hash of the block. This is the result of hashing the block header with the nonce and must satisfy the target condition. - canonical (Boolean): Indicates whether this block is part of the canonical chain. Non-canonical blocks may occur during temporary forks or reorganizations. - parent (Block): The parent block directly preceding this one in the chain. Together with the hash, this forms the cryptographic link that secures the chain. - totalGasUsedInKda (Decimal): The total amount of gas used by all transactions in this block, expressed in KDA. - events (BlockEventsConnection): Paginated list of events emitted by transactions within this block. - minerAccount (FungibleChainAccount): The account that mined this block and received the coinbase reward. - transactions (BlockTransactionsConnection): Paginated list of transactions included in this block. - chainId (BigInt): The ID of the chain where the event occurred. - height (BigInt): The height of the block in which this event was emitted. - moduleName (String): The name of the module that emitted the event. Example: `"coin"`. - orderIndex (BigInt): The index position of this event within the transaction’s event list. Useful when multiple events are emitted by the same transaction. - requestKey (String): The request key of the transaction that emitted this event. - parameters (String): The raw JSON-encoded event parameters as emitted by the contract. - parameterText (String): A human-readable text representation of the event parameters. - qualifiedName (String): The fully qualified event name, combining the module and event name. Example: `"coin.TRANSFER"`. - transaction (Transaction): The transaction that emitted this event. - id (ID): Globally unique identifier for this transaction node. - cmd (TransactionCommand): The original signed transaction command submitted to the network. Includes metadata, payload, signers, and network information. - hash (String): The unique hash of the transaction. This value is derived from the signed command and serves as the canonical identifier for the transaction on-chain. - result (TransactionInfo): The result of executing the transaction. Includes information such as success/failure status, events, continuation data, and any state changes triggered by execution. - sigs (TransactionSignature): The list of signatures associated with the transaction. Each signature proves authorization from a required signer and is used to validate that the transaction was properly authorized before execution. --- ## FungibleChainAccount **Type:** GraphQL objects **Description:** Represents a fungible account **on a specific chain** in the Kadena blockchain. While a `FungibleAccount` aggregates balances and activity across all chains, a `FungibleChainAccount` focuses on a single chain. It exposes the account’s balance, security guard, and full transaction and transfer history specific to that chain and fungible token (e.g., `coin` for KDA). This type is useful when you need fine-grained, chain-level data — such as for explorers, wallets, or analytics tools that track balances and movements per chain. ### Fields - id (ID): Globally unique identifier for this chain account node. - accountName (String): The full name of the account (e.g., `k:abcdef123456...` for a user account or `free.my-contract` for a contract account). - balance (Float): The current balance of this account on the specified chain for the given fungible token. - chainId (String): The chain ID where this account exists. - fungibleName (String): The name of the fungible token module associated with this account (e.g., `coin`). - guard (IGuard, Not Null): The guard that defines the account’s security conditions. A guard determines who must sign transactions in order to spend from this account. - keys (String) - predicate (String) - raw (String) - transactions (FungibleChainAccountTransactionsConnection, Not Null): Paginated list of transactions involving this account on this chain. Transactions represent operations such as transfers, contract calls, or other state changes. - edges (FungibleChainAccountTransactionsConnectionEdge) - pageInfo (PageInfo) - totalCount (Int) - transfers (FungibleChainAccountTransfersConnection, Not Null): Paginated list of token transfers into or out of this account on this chain. Transfers are a subset of events focused specifically on balance movements. - edges (FungibleChainAccountTransfersConnectionEdge) - pageInfo (PageInfo) - totalCount (Int) --- ## FungibleChainAccountTransactionsConnection **Type:** GraphQL objects ### Fields - edges (FungibleChainAccountTransactionsConnectionEdge, Not Null): undefined - cursor (String) - node (Transaction) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. - totalCount (Int) --- ## FungibleChainAccountTransactionsConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (Transaction, Not Null): undefined - id (ID): Globally unique identifier for this transaction node. - cmd (TransactionCommand): The original signed transaction command submitted to the network. Includes metadata, payload, signers, and network information. - hash (String): The unique hash of the transaction. This value is derived from the signed command and serves as the canonical identifier for the transaction on-chain. - result (TransactionInfo): The result of executing the transaction. Includes information such as success/failure status, events, continuation data, and any state changes triggered by execution. - sigs (TransactionSignature): The list of signatures associated with the transaction. Each signature proves authorization from a required signer and is used to validate that the transaction was properly authorized before execution. --- ## BlockTransactionsConnection **Type:** GraphQL objects ### Fields - edges (BlockTransactionsConnectionEdge, Not Null): undefined - cursor (String) - node (Transaction) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. - totalCount (Int) --- ## BlockTransactionsConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (Transaction, Not Null): undefined - id (ID): Globally unique identifier for this transaction node. - cmd (TransactionCommand): The original signed transaction command submitted to the network. Includes metadata, payload, signers, and network information. - hash (String): The unique hash of the transaction. This value is derived from the signed command and serves as the canonical identifier for the transaction on-chain. - result (TransactionInfo): The result of executing the transaction. Includes information such as success/failure status, events, continuation data, and any state changes triggered by execution. - sigs (TransactionSignature): The list of signatures associated with the transaction. Each signature proves authorization from a required signer and is used to validate that the transaction was properly authorized before execution. --- ## Transaction **Type:** GraphQL objects **Description:** Represents a transaction executed on the Kadena blockchain. A `Transaction` encapsulates the full structure and outcome of a blockchain transaction — from the original signed command to the resulting execution details. Each transaction is uniquely identified by its `hash` and includes the submitted command (`cmd`), associated signatures (`sigs`), and the execution result (`result`). This type is fundamental for querying and analyzing blockchain activity, tracking execution outcomes, and verifying signed payloads. ### Fields - id (ID): Globally unique identifier for this transaction node. - cmd (TransactionCommand, Not Null): The original signed transaction command submitted to the network. Includes metadata, payload, signers, and network information. - meta (TransactionMeta): Transaction-level metadata, such as gas price, gas limit, chain ID, time-to-live (TTL), and creation time. This controls how and when the transaction is processed by the chain. - networkId (String): The network identifier where the transaction is intended to run. Example: `"mainnet01"` or `"testnet04"`. - nonce (String): A user-specified nonce string that ensures transaction uniqueness. Typically includes random or timestamp data to prevent replay. - payload (TransactionPayload): The payload of the transaction, which defines the Pact code to execute or the continuation to resume. This is the core logic being invoked. - signers (Signer): The list of signers required to authorize the transaction. Each signer specifies a public key and associated capabilities that define what actions they are permitted to authorize. - hash (String): The unique hash of the transaction. This value is derived from the signed command and serves as the canonical identifier for the transaction on-chain. - result (TransactionInfo, Not Null): The result of executing the transaction. Includes information such as success/failure status, events, continuation data, and any state changes triggered by execution. - sigs (TransactionSignature, Not Null): The list of signatures associated with the transaction. Each signature proves authorization from a required signer and is used to validate that the transaction was properly authorized before execution. - sig (String) --- ## TransactionCommand **Type:** GraphQL objects **Description:** Represents the full command structure of a transaction on the Kadena blockchain. A `TransactionCommand` defines all the inputs required to construct and execute a Pact transaction, including metadata, payload, signers, and supporting information. It reflects the exact structure submitted to the blockchain for validation and execution. ### Fields - meta (TransactionMeta, Not Null): Transaction-level metadata, such as gas price, gas limit, chain ID, time-to-live (TTL), and creation time. This controls how and when the transaction is processed by the chain. - chainId (BigInt): The ID of the chain where the transaction will be executed. - creationTime (DateTime): The timestamp when the transaction was created. Used by the network to validate transaction age and enforce time-to-live rules. - gasLimit (BigInt): The maximum amount of gas units the transaction is allowed to consume during execution. Acts as a safety limit to prevent excessive gas usage. - gasPrice (String): The price (in KDA) to pay per unit of gas. Determines the total transaction fee when multiplied by `gasLimit`. - sender (String): The account name of the sender responsible for paying gas fees. - ttl (BigInt): The time-to-live (TTL) of the transaction, expressed in seconds. It defines how long the transaction remains valid after its `creationTime`. Once this period passes, the transaction expires and will no longer be accepted. - networkId (String): The network identifier where the transaction is intended to run. Example: `"mainnet01"` or `"testnet04"`. - nonce (String): A user-specified nonce string that ensures transaction uniqueness. Typically includes random or timestamp data to prevent replay. - payload (TransactionPayload, Not Null): The payload of the transaction, which defines the Pact code to execute or the continuation to resume. This is the core logic being invoked. - signers (Signer, Not Null): The list of signers required to authorize the transaction. Each signer specifies a public key and associated capabilities that define what actions they are permitted to authorize. - address (String): The signer for the gas. - id (ID) - orderIndex (Int) - pubkey (String) - scheme (String): The signature scheme that was used to sign. - clist (TransactionCapability) --- ## TransactionMeta **Type:** GraphQL objects **Description:** Execution metadata that defines how a transaction is processed on the Kadena blockchain. `TransactionMeta` contains contextual information that influences transaction execution, such as which chain it runs on, how long it remains valid, its gas configuration, and when it was created. This data is included in every `TransactionCommand` and is critical for determining how the transaction is validated and scheduled by the network. ### Fields - chainId (BigInt): The ID of the chain where the transaction will be executed. - creationTime (DateTime): The timestamp when the transaction was created. Used by the network to validate transaction age and enforce time-to-live rules. - gasLimit (BigInt): The maximum amount of gas units the transaction is allowed to consume during execution. Acts as a safety limit to prevent excessive gas usage. - gasPrice (String): The price (in KDA) to pay per unit of gas. Determines the total transaction fee when multiplied by `gasLimit`. - sender (String): The account name of the sender responsible for paying gas fees. - ttl (BigInt): The time-to-live (TTL) of the transaction, expressed in seconds. It defines how long the transaction remains valid after its `creationTime`. Once this period passes, the transaction expires and will no longer be accepted. --- ## TransactionSignature **Type:** GraphQL objects **Description:** List of capabilities associated with/installed by this signer. ### Fields - sig (String) --- ## ContinuationPayload **Type:** GraphQL objects **Description:** The payload of an cont transaction. ### Fields - data (String): The environment data made available to the transaction. Formatted as raw JSON. - pactId (String): A unique id when a pact (defpact) is initiated. See the "Pact execution scope and pact-id" explanation in the docs for more information. - proof (String): The proof provided to continue the cross-chain transaction. - rollback (Boolean): Whether or not this transaction can be rolled back. - step (Int): The step-number when this is an execution of a `defpact`, aka multi-step transaction. --- ## ExecutionPayload **Type:** GraphQL objects **Description:** The payload of an exec transaction. ### Fields - code (String): The Pact expressions executed in this transaction when it is an `exec` transaction. - data (String): The environment data made available to the transaction. Formatted as raw JSON. --- ## TransactionMempoolInfo **Type:** GraphQL objects **Description:** The mempool information. ### Fields - status (String): The status of the mempool. --- ## TransactionResult **Type:** GraphQL objects **Description:** The result of a transaction. ### Fields - badResult (String): The transaction result when it was successful. Formatted as raw JSON. - continuation (String): The JSON stringified continuation in the case that it is a continuation. - eventCount (BigInt) - gas (BigInt) - goodResult (String): The transaction result when it was successful. Formatted as raw JSON. - logs (String): Identifier to retrieve the logs for the execution of the transaction. - transactionId (BigInt) - height (BigInt): The height of the block this transaction belongs to. - metadata (String) - block (Block, Not Null): undefined - id (ID): Globally unique identifier for this block node. - hash (String): The cryptographic hash of the block. This serves as its unique identifier within the blockchain. - chainId (BigInt): The specific chain where this block was mined. Kadena is a multi-chain system, and each block belongs to exactly one chain. - creationTime (DateTime): The timestamp when this block was created and added to the chain. - difficulty (BigInt): The network difficulty at the time the block was mined. Higher difficulty reflects the amount of computational work required to produce a valid block. - epoch (DateTime): The epoch timestamp marking when the difficulty was last adjusted. Kadena targets ~30 seconds per block, and the difficulty is recalibrated periodically to maintain that target. - flags (Decimal): Consensus flags used internally by the protocol. - height (BigInt): The height (block number) of this block within its chain. The genesis block is height 0, and each subsequent block increments by 1. - nonce (Decimal): A nonce value used in the proof-of-work process. Miners vary this value to discover a hash below the target threshold. - payloadHash (String): The hash of the payload data contained within the block. This ensures the integrity of the transactions and other included data. - weight (String): The cumulative weight of the chain up to and including this block. Weight increases with each mined block and helps determine the canonical chain. - target (String): The target hash threshold that the block’s proof-of-work hash must fall below. This value adjusts with difficulty to regulate block production time. - coinbase (String): The coinbase transaction data. This transaction rewards the miner and may include information about block rewards or other protocol-defined payouts. - neighbors (BlockNeighbor): The neighboring blocks that reference this block as a parent. These neighbors are essential in Kadena’s braided multi-chain architecture. - powHash (String): The proof-of-work hash of the block. This is the result of hashing the block header with the nonce and must satisfy the target condition. - canonical (Boolean): Indicates whether this block is part of the canonical chain. Non-canonical blocks may occur during temporary forks or reorganizations. - parent (Block): The parent block directly preceding this one in the chain. Together with the hash, this forms the cryptographic link that secures the chain. - totalGasUsedInKda (Decimal): The total amount of gas used by all transactions in this block, expressed in KDA. - events (BlockEventsConnection): Paginated list of events emitted by transactions within this block. - minerAccount (FungibleChainAccount): The account that mined this block and received the coinbase reward. - transactions (BlockTransactionsConnection): Paginated list of transactions included in this block. - transfers (TransactionResultTransfersConnection, Not Null): undefined - edges (TransactionResultTransfersConnectionEdge) - pageInfo (PageInfo) - totalCount (Int) - events (TransactionResultEventsConnection, Not Null): undefined - edges (TransactionResultEventsConnectionEdge) - pageInfo (PageInfo) - totalCount (Int) --- ## TransactionResultEventsConnection **Type:** GraphQL objects ### Fields - edges (TransactionResultEventsConnectionEdge, Not Null): undefined - cursor (String) - node (Event) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. - totalCount (Int) --- ## TransactionResultEventsConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (Event, Not Null): undefined - id (ID): Globally unique identifier for this event. - name (String): The name of the event as defined in the smart contract. Example: `"TRANSFER"`. - block (Block): The block in which this event was emitted. - chainId (BigInt): The ID of the chain where the event occurred. - height (BigInt): The height of the block in which this event was emitted. - moduleName (String): The name of the module that emitted the event. Example: `"coin"`. - orderIndex (BigInt): The index position of this event within the transaction’s event list. Useful when multiple events are emitted by the same transaction. - requestKey (String): The request key of the transaction that emitted this event. - parameters (String): The raw JSON-encoded event parameters as emitted by the contract. - parameterText (String): A human-readable text representation of the event parameters. - qualifiedName (String): The fully qualified event name, combining the module and event name. Example: `"coin.TRANSFER"`. - transaction (Transaction): The transaction that emitted this event. --- ## TransactionResultTransfersConnection **Type:** GraphQL objects ### Fields - edges (TransactionResultTransfersConnectionEdge, Not Null): undefined - cursor (String) - node (Transfer) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. - totalCount (Int) --- ## TransactionResultTransfersConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (Transfer, Not Null): undefined - amount (Decimal) - block (Block) - blockHash (String) - chainId (BigInt) - creationTime (DateTime) - crossChainTransfer (Transfer): The counterpart of the crosschain-transfer. `null` when it is not a cross-chain-transfer. - height (BigInt) - id (ID) - moduleHash (String) - moduleName (String) - orderIndex (BigInt): The order of the transfer when it is a `defpact` (multi-step transaction) execution. - receiverAccount (String) - requestKey (String) - senderAccount (String) - tokenId (String): The token id if this is a poly-fungible transfer. - transaction (Transaction): The transaction that initiated this transfer. --- ## Signer **Type:** GraphQL objects **Description:** A signer for a specific transaction. ### Fields - address (String): The signer for the gas. - id (ID) - orderIndex (Int) - pubkey (String) - scheme (String): The signature scheme that was used to sign. - clist (TransactionCapability, Not Null): undefined - args (String) - name (String) --- ## TransactionCapability **Type:** GraphQL objects **Description:** List of capabilities associated with/installed by this signer. ### Fields - args (String) - name (String) --- ## FungibleChainAccountTransfersConnection **Type:** GraphQL objects ### Fields - edges (FungibleChainAccountTransfersConnectionEdge, Not Null): undefined - cursor (String) - node (Transfer) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. - totalCount (Int) --- ## FungibleChainAccountTransfersConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (Transfer, Not Null): undefined - amount (Decimal) - block (Block) - blockHash (String) - chainId (BigInt) - creationTime (DateTime) - crossChainTransfer (Transfer): The counterpart of the crosschain-transfer. `null` when it is not a cross-chain-transfer. - height (BigInt) - id (ID) - moduleHash (String) - moduleName (String) - orderIndex (BigInt): The order of the transfer when it is a `defpact` (multi-step transaction) execution. - receiverAccount (String) - requestKey (String) - senderAccount (String) - tokenId (String): The token id if this is a poly-fungible transfer. - transaction (Transaction): The transaction that initiated this transfer. --- ## Transfer **Type:** GraphQL objects **Description:** A transfer of funds from a fungible between two accounts. ### Fields - amount (Decimal) - block (Block, Not Null): undefined - id (ID): Globally unique identifier for this block node. - hash (String): The cryptographic hash of the block. This serves as its unique identifier within the blockchain. - chainId (BigInt): The specific chain where this block was mined. Kadena is a multi-chain system, and each block belongs to exactly one chain. - creationTime (DateTime): The timestamp when this block was created and added to the chain. - difficulty (BigInt): The network difficulty at the time the block was mined. Higher difficulty reflects the amount of computational work required to produce a valid block. - epoch (DateTime): The epoch timestamp marking when the difficulty was last adjusted. Kadena targets ~30 seconds per block, and the difficulty is recalibrated periodically to maintain that target. - flags (Decimal): Consensus flags used internally by the protocol. - height (BigInt): The height (block number) of this block within its chain. The genesis block is height 0, and each subsequent block increments by 1. - nonce (Decimal): A nonce value used in the proof-of-work process. Miners vary this value to discover a hash below the target threshold. - payloadHash (String): The hash of the payload data contained within the block. This ensures the integrity of the transactions and other included data. - weight (String): The cumulative weight of the chain up to and including this block. Weight increases with each mined block and helps determine the canonical chain. - target (String): The target hash threshold that the block’s proof-of-work hash must fall below. This value adjusts with difficulty to regulate block production time. - coinbase (String): The coinbase transaction data. This transaction rewards the miner and may include information about block rewards or other protocol-defined payouts. - neighbors (BlockNeighbor): The neighboring blocks that reference this block as a parent. These neighbors are essential in Kadena’s braided multi-chain architecture. - powHash (String): The proof-of-work hash of the block. This is the result of hashing the block header with the nonce and must satisfy the target condition. - canonical (Boolean): Indicates whether this block is part of the canonical chain. Non-canonical blocks may occur during temporary forks or reorganizations. - parent (Block): The parent block directly preceding this one in the chain. Together with the hash, this forms the cryptographic link that secures the chain. - totalGasUsedInKda (Decimal): The total amount of gas used by all transactions in this block, expressed in KDA. - events (BlockEventsConnection): Paginated list of events emitted by transactions within this block. - minerAccount (FungibleChainAccount): The account that mined this block and received the coinbase reward. - transactions (BlockTransactionsConnection): Paginated list of transactions included in this block. - blockHash (String) - chainId (BigInt) - creationTime (DateTime) - crossChainTransfer (Transfer): The counterpart of the crosschain-transfer. `null` when it is not a cross-chain-transfer. - amount (Decimal) - block (Block) - blockHash (String) - chainId (BigInt) - creationTime (DateTime) - crossChainTransfer (Transfer): The counterpart of the crosschain-transfer. `null` when it is not a cross-chain-transfer. - height (BigInt) - id (ID) - moduleHash (String) - moduleName (String) - orderIndex (BigInt): The order of the transfer when it is a `defpact` (multi-step transaction) execution. - receiverAccount (String) - requestKey (String) - senderAccount (String) - tokenId (String): The token id if this is a poly-fungible transfer. - transaction (Transaction): The transaction that initiated this transfer. - height (BigInt) - id (ID) - moduleHash (String) - moduleName (String) - orderIndex (BigInt): The order of the transfer when it is a `defpact` (multi-step transaction) execution. - receiverAccount (String) - requestKey (String) - senderAccount (String) - tokenId (String): The token id if this is a poly-fungible transfer. - transaction (Transaction): The transaction that initiated this transfer. - id (ID): Globally unique identifier for this transaction node. - cmd (TransactionCommand): The original signed transaction command submitted to the network. Includes metadata, payload, signers, and network information. - hash (String): The unique hash of the transaction. This value is derived from the signed command and serves as the canonical identifier for the transaction on-chain. - result (TransactionInfo): The result of executing the transaction. Includes information such as success/failure status, events, continuation data, and any state changes triggered by execution. - sigs (TransactionSignature): The list of signatures associated with the transaction. Each signature proves authorization from a required signer and is used to validate that the transaction was properly authorized before execution. --- ## GraphConfiguration **Type:** GraphQL objects **Description:** General information about the GraphQL API. ### Fields - minimumBlockHeight (BigInt): The lowest block-height that is indexed in this endpoint. - version (String): The version of the graphl api. --- ## NetworkInfo **Type:** GraphQL objects **Description:** Detailed information about the current Kadena network and its state. The `NetworkInfo` type provides an overview of the network’s operational and consensus metrics, including circulation supply, hash rate, difficulty, transaction count, and chain topology details. It’s commonly used by explorers, monitoring tools, and analytics dashboards to understand the state, performance, and configuration of the Kadena blockchain network. ### Fields - apiVersion (String): The version of this GraphQL API. Useful to verify compatibility between the client and API. - coinsInCirculation (Float): The current total number of coins in circulation on the network. - networkHashRate (Float): The current aggregate hash rate of the Kadena network. Indicates the total mining power securing the network. - networkHost (String): The host address or domain of the network node serving this API. - networkId (String): The unique identifier of the network (e.g., `mainnet01`, `testnet04`). - totalDifficulty (Float): The cumulative difficulty of all blocks mined so far. A higher value reflects the total work securing the chain. - transactionCount (Int): The total number of transactions that have been processed across the network. - nodeBlockDelay (Int): The current delay (in blocks) between the latest mined block and the block processed by the node. Useful for monitoring node synchronization status. - nodeChains (String): The list of chain IDs that make up the Kadena network. Kadena operates multiple braided chains in parallel. - numberOfChains (Int): The total number of chains in the network. - genesisHeights (GenesisHeight, Not Null): The genesis block height for each chain in the network. Provides insight into the starting point of each chain’s history. - chainId (String) - height (Int) - nodePackageVersion (String): The version of the node software package running this endpoint. - nodeServiceDate (DateTime): The service start date and time of the current node. Useful for tracking uptime and deployment history. - nodeLatestBehaviorHeight (Int): The latest block height known by the node’s behavior monitor. Can be used to assess node synchronization and chain progress. - countersOfEachChain (CountersOfEachChain, Not Null): Transaction counters and statistics broken down by chain. Useful for analyzing per-chain activity levels and throughput. - chainId (String) - blocksCount (Int) - transactionCount (Int) - totalGasUsedInKda (String) --- ## CountersOfEachChain **Type:** GraphQL objects ### Fields - chainId (String) - blocksCount (Int) - transactionCount (Int) - totalGasUsedInKda (String) --- ## GenesisHeight **Type:** GraphQL objects ### Fields - chainId (String) - height (Int) --- ## PactQueryResponse **Type:** GraphQL objects **Description:** The result of executing a Pact query via a local call. Each `PactQueryResponse` corresponds to one `PactQuery` input and contains the execution result, status, and any error message returned by the Pact interpreter. ### Fields - chainId (String): The chain ID on which the query was executed. - code (String): The original Pact code that was executed. - error (String): Any error message returned during execution. `null` if the query was successful. - result (String): The raw JSON-encoded result returned by the Pact execution. - status (String): The execution status, typically `"success"` or `"failure"`. --- ## GasLimitEstimation **Type:** GraphQL objects **Description:** Represents the gas estimation result for a single transaction input. Includes the estimated gas amount and metadata about how the estimation was performed. ### Fields - amount (Int): The estimated gas limit required to execute the transaction. - inputType (String): The detected input type (e.g., `code`, `payload`, `full-transaction`, etc.). - transaction (String): The normalized JSON representation of the transaction used for estimation. - usedPreflight (Boolean): Whether a pre-execution (preflight) simulation was used during estimation. - usedSignatureVerification (Boolean): Whether signature verification was performed as part of the estimation. --- ## NonFungibleAccount **Type:** GraphQL objects **Description:** Represents an account associated with non-fungible tokens (NFTs) on the Kadena blockchain. A `NonFungibleAccount` tracks the ownership and activity of a specific account for non-fungible tokens. Unlike fungible accounts, which hold divisible token balances, non-fungible accounts are associated with unique tokens and their metadata. Because Kadena operates as a multi-chain network, a single account may hold NFTs across multiple chains. This type exposes account-level NFT balances, per-chain details, and historical transaction and transfer data. ### Fields - accountName (String): The full name of the account (e.g., `k:abcdef123456...` for a user account or `free.my-contract` for a contract account). - chainAccounts (NonFungibleChainAccount, Not Null): Per-chain breakdown of this non-fungible account. Since Kadena operates multiple braided chains, NFT balances and activity are tracked separately on each chain. - accountName (String): The full name of the account (e.g., `k:abcdef123456...` for a user account or `free.my-contract` for a contract account). - chainId (String): The chain ID where this non-fungible account exists. - id (ID): Globally unique identifier for this chain-scoped NFT account node. - nonFungibleTokenBalances (NonFungibleTokenBalance): The list of NFT balances held by this account on this chain. Each entry typically includes the token identifier(s), quantity/ownership info, and associated metadata for that token/collection. - transactions (NonFungibleChainAccountTransactionsConnection): Paginated list of NFT-related transactions involving this account on this chain. Transactions can include mints, transfers, or contract interactions that affect NFT state. - transfers (NonFungibleChainAccountTransfersConnection): Paginated list of NFT transfers into or out of this account on this chain. Transfers are a subset of transactions focused specifically on movements of NFTs. - id (ID): Globally unique identifier for this non-fungible account node. - nonFungibleTokenBalances (NonFungibleTokenBalance, Not Null): A list of non-fungible token balances held by this account across all chains. Each balance entry includes token identifiers, metadata, and ownership details. - accountName (String): The full name of the account associated with this NFT balance. Example: `"k:abcdef123456..."` for a user account or `"free.my-contract"` for a contract account. - balance (Int): The balance of this specific non-fungible token for the account. Typically `1` if the token is owned or `0` if not. - chainId (String): The chain ID where this token balance is tracked. - guard (IGuard): The guard that defines the security conditions for this token. A guard specifies who must sign transactions in order to transfer or interact with this token. - id (ID): Globally unique identifier for this NFT balance node. - info (NonFungibleToken): Metadata and details of the non-fungible token associated with this balance. - tokenId (String): The unique identifier of the non-fungible token. - version (String): The version of the token or contract associated with this NFT. Useful for distinguishing between different token contract versions or upgrades. - transactions (NonFungibleAccountTransactionsConnection, Not Null): Paginated list of transactions involving this account. Note: Custom token-related transactions are not included. Transactions here represent operations such as NFT minting, transfers, or contract interactions related to NFTs. - edges (NonFungibleAccountTransactionsConnectionEdge) - pageInfo (PageInfo) - totalCount (Int) - transfers (NonFungibleAccountTransfersConnection, Not Null): Paginated list of NFT transfers associated with this account. Transfers represent movements of non-fungible tokens into or out of this account. - edges (NonFungibleAccountTransfersConnectionEdge) - pageInfo (PageInfo) - totalCount (Int) --- ## NonFungibleAccountTransactionsConnection **Type:** GraphQL objects ### Fields - edges (NonFungibleAccountTransactionsConnectionEdge, Not Null): undefined - cursor (String) - node (Transaction) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. - totalCount (Int) --- ## NonFungibleAccountTransactionsConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (Transaction, Not Null): undefined - id (ID): Globally unique identifier for this transaction node. - cmd (TransactionCommand): The original signed transaction command submitted to the network. Includes metadata, payload, signers, and network information. - hash (String): The unique hash of the transaction. This value is derived from the signed command and serves as the canonical identifier for the transaction on-chain. - result (TransactionInfo): The result of executing the transaction. Includes information such as success/failure status, events, continuation data, and any state changes triggered by execution. - sigs (TransactionSignature): The list of signatures associated with the transaction. Each signature proves authorization from a required signer and is used to validate that the transaction was properly authorized before execution. --- ## NonFungibleChainAccountTransactionsConnection **Type:** GraphQL objects ### Fields - edges (NonFungibleChainAccountTransactionsConnectionEdge, Not Null): undefined - cursor (String) - node (Transaction) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. - totalCount (Int) --- ## NonFungibleAccountTransfersConnection **Type:** GraphQL objects ### Fields - edges (NonFungibleAccountTransfersConnectionEdge, Not Null): undefined - cursor (String) - node (Transfer) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. - totalCount (Int) --- ## NonFungibleAccountTransfersConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (Transfer, Not Null): undefined - amount (Decimal) - block (Block) - blockHash (String) - chainId (BigInt) - creationTime (DateTime) - crossChainTransfer (Transfer): The counterpart of the crosschain-transfer. `null` when it is not a cross-chain-transfer. - height (BigInt) - id (ID) - moduleHash (String) - moduleName (String) - orderIndex (BigInt): The order of the transfer when it is a `defpact` (multi-step transaction) execution. - receiverAccount (String) - requestKey (String) - senderAccount (String) - tokenId (String): The token id if this is a poly-fungible transfer. - transaction (Transaction): The transaction that initiated this transfer. --- ## NonFungibleChainAccountTransactionsConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (Transaction, Not Null): undefined - id (ID): Globally unique identifier for this transaction node. - cmd (TransactionCommand): The original signed transaction command submitted to the network. Includes metadata, payload, signers, and network information. - hash (String): The unique hash of the transaction. This value is derived from the signed command and serves as the canonical identifier for the transaction on-chain. - result (TransactionInfo): The result of executing the transaction. Includes information such as success/failure status, events, continuation data, and any state changes triggered by execution. - sigs (TransactionSignature): The list of signatures associated with the transaction. Each signature proves authorization from a required signer and is used to validate that the transaction was properly authorized before execution. --- ## NonFungibleChainAccount **Type:** GraphQL objects **Description:** Represents a non-fungible (NFT) account **on a specific chain** in the Kadena network. While `NonFungibleAccount` aggregates NFT holdings and activity across all chains for an account, `NonFungibleChainAccount` focuses on a single chain. It exposes the account’s per-chain NFT balances and its transaction/transfer history limited to that chain. This is useful for explorers, wallets, and analytics tools that need precise, chain-level NFT data. ### Fields - accountName (String): The full name of the account (e.g., `k:abcdef123456...` for a user account or `free.my-contract` for a contract account). - chainId (String): The chain ID where this non-fungible account exists. - id (ID): Globally unique identifier for this chain-scoped NFT account node. - nonFungibleTokenBalances (NonFungibleTokenBalance, Not Null): The list of NFT balances held by this account on this chain. Each entry typically includes the token identifier(s), quantity/ownership info, and associated metadata for that token/collection. - accountName (String): The full name of the account associated with this NFT balance. Example: `"k:abcdef123456..."` for a user account or `"free.my-contract"` for a contract account. - balance (Int): The balance of this specific non-fungible token for the account. Typically `1` if the token is owned or `0` if not. - chainId (String): The chain ID where this token balance is tracked. - guard (IGuard): The guard that defines the security conditions for this token. A guard specifies who must sign transactions in order to transfer or interact with this token. - id (ID): Globally unique identifier for this NFT balance node. - info (NonFungibleToken): Metadata and details of the non-fungible token associated with this balance. - tokenId (String): The unique identifier of the non-fungible token. - version (String): The version of the token or contract associated with this NFT. Useful for distinguishing between different token contract versions or upgrades. - transactions (NonFungibleChainAccountTransactionsConnection, Not Null): Paginated list of NFT-related transactions involving this account on this chain. Transactions can include mints, transfers, or contract interactions that affect NFT state. - edges (NonFungibleChainAccountTransactionsConnectionEdge) - pageInfo (PageInfo) - totalCount (Int) - transfers (NonFungibleChainAccountTransfersConnection, Not Null): Paginated list of NFT transfers into or out of this account on this chain. Transfers are a subset of transactions focused specifically on movements of NFTs. - edges (NonFungibleChainAccountTransfersConnectionEdge) - pageInfo (PageInfo) - totalCount (Int) --- ## NonFungibleChainAccountTransfersConnection **Type:** GraphQL objects ### Fields - edges (NonFungibleChainAccountTransfersConnectionEdge, Not Null): undefined - cursor (String) - node (Transfer) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. - totalCount (Int) --- ## NonFungibleChainAccountTransfersConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (Transfer, Not Null): undefined - amount (Decimal) - block (Block) - blockHash (String) - chainId (BigInt) - creationTime (DateTime) - crossChainTransfer (Transfer): The counterpart of the crosschain-transfer. `null` when it is not a cross-chain-transfer. - height (BigInt) - id (ID) - moduleHash (String) - moduleName (String) - orderIndex (BigInt): The order of the transfer when it is a `defpact` (multi-step transaction) execution. - receiverAccount (String) - requestKey (String) - senderAccount (String) - tokenId (String): The token id if this is a poly-fungible transfer. - transaction (Transaction): The transaction that initiated this transfer. --- ## KeysetGuard **Type:** GraphQL objects **Description:** A keyset guard. ### Fields - keys (String) - predicate (String) - raw (String) --- ## UserGuard **Type:** GraphQL objects ### Fields - args (String) - fun (String) - keys (String) - predicate (String) - raw (String) --- ## RawGuard **Type:** GraphQL objects **Description:** DEPRECATED: a fallthrough IGuard type to cover non-KeysetGuard types. ### Fields - keys (String) - predicate (String) - raw (String) --- ## QueryTokensConnection **Type:** GraphQL objects ### Fields - edges (QueryTokensEdge, Not Null): undefined - cursor (String) - node (Token) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. --- ## QueryTokensEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (Token, Not Null): undefined - id (ID) - name (String) - chainId (String) - address (String) --- ## Token **Type:** GraphQL objects ### Fields - id (ID) - name (String) - chainId (String) - address (String) --- ## Pool **Type:** GraphQL objects **Description:** Represents an automated market maker (AMM) liquidity pool for a pair of tokens. A `Pool` tracks on-chain reserves, liquidity (LP) supply, pricing-derived metrics (TVL, volume, fees), and short-term performance indicators (24h / 7d deltas). Prices used to compute TVL/volume/fees are sourced from DIA and refreshed periodically. Use this type to power pool lists, detail pages, analytics dashboards, and historical charts. Note: Numeric reserve and supply values are returned as strings to preserve precision. ### Fields - id (ID): Globally unique identifier for this pool node. - address (String): The on-chain address / module reference for this pool. - token0 (Token, Not Null): The first token in the pair (base/slot-0). - id (ID) - name (String) - chainId (String) - address (String) - token1 (Token, Not Null): The second token in the pair (quote/slot-1). - id (ID) - name (String) - chainId (String) - address (String) - reserve0 (String): Current on-chain reserve of `token0` held by the pool (as a string for full precision). - reserve1 (String): Current on-chain reserve of `token1` held by the pool (as a string for full precision). - totalSupply (String): Total supply of the pool’s LP (liquidity provider) tokens (as a string for full precision). - key (String): A stable key for the pool (e.g., a deterministic pair identifier). - tvlUsd (Float): Total value locked (USD) in this pool, derived from reserves and external pricing. - tvlChange24h (Float): 24-hour percentage change in TVL. - volume24hUsd (Float): Notional 24-hour traded volume (USD). - volumeChange24h (Float): 24-hour percentage change in volume. - volume7dUsd (Float): Notional 7-day traded volume (USD). - fees24hUsd (Float): Notional 24-hour fees accrued by the pool (USD). - feesChange24h (Float): 24-hour percentage change in fees. - transactionCount24h (Int): Count of pool transactions over the last 24 hours. - transactionCountChange24h (Float): 24-hour percentage change in transaction count. - apr24h (Float): 24-hour APR estimate derived from recent fees relative to TVL (as a percentage). - createdAt (DateTime): Timestamp when this pool record was created. - updatedAt (DateTime): Timestamp when this pool record was last updated. - charts (PoolCharts, Not Null): Get chart/series data for this pool over a specified timeframe (e.g., TVL, volume). - volume (ChartDataPoint): Volume data points - tvl (ChartDataPoint): TVL data points - fees (ChartDataPoint): Fees data points - transactions (PoolTransactionsConnection): Get transactions related to this pool, with optional type filtering and cursor-based pagination. - edges (PoolTransactionEdge): List of transaction edges - pageInfo (PageInfo): Pagination information - totalCount (Int): Total number of transactions --- ## QueryPoolsConnection **Type:** GraphQL objects ### Fields - edges (QueryPoolsConnectionEdge, Not Null): undefined - cursor (String) - node (Pool) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. - totalCount (Int) --- ## QueryPoolsConnectionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (Pool, Not Null): undefined - id (ID): Globally unique identifier for this pool node. - address (String): The on-chain address / module reference for this pool. - token0 (Token): The first token in the pair (base/slot-0). - token1 (Token): The second token in the pair (quote/slot-1). - reserve0 (String): Current on-chain reserve of `token0` held by the pool (as a string for full precision). - reserve1 (String): Current on-chain reserve of `token1` held by the pool (as a string for full precision). - totalSupply (String): Total supply of the pool’s LP (liquidity provider) tokens (as a string for full precision). - key (String): A stable key for the pool (e.g., a deterministic pair identifier). - tvlUsd (Float): Total value locked (USD) in this pool, derived from reserves and external pricing. - tvlChange24h (Float): 24-hour percentage change in TVL. - volume24hUsd (Float): Notional 24-hour traded volume (USD). - volumeChange24h (Float): 24-hour percentage change in volume. - volume7dUsd (Float): Notional 7-day traded volume (USD). - fees24hUsd (Float): Notional 24-hour fees accrued by the pool (USD). - feesChange24h (Float): 24-hour percentage change in fees. - transactionCount24h (Int): Count of pool transactions over the last 24 hours. - transactionCountChange24h (Float): 24-hour percentage change in transaction count. - apr24h (Float): 24-hour APR estimate derived from recent fees relative to TVL (as a percentage). - createdAt (DateTime): Timestamp when this pool record was created. - updatedAt (DateTime): Timestamp when this pool record was last updated. - charts (PoolCharts): Get chart/series data for this pool over a specified timeframe (e.g., TVL, volume). - transactions (PoolTransactionsConnection): Get transactions related to this pool, with optional type filtering and cursor-based pagination. --- ## PoolTransaction **Type:** GraphQL objects **Description:** A swap transaction in a pool ### Fields - id (ID): Unique identifier - maker (String): User who made the swap - amount0In (Decimal): Amount of token0 swapped in - amount1In (Decimal): Amount of token1 swapped in - amount0Out (Decimal): Amount of token0 swapped out - amount1Out (Decimal): Amount of token1 swapped out - amountUsd (Decimal): Total amount in USD - timestamp (DateTime): Transaction timestamp - transactionId (Int): ID of the transaction - requestkey (String): Request key of the transaction - transactionType (PoolTransactionType, Not Null): The type of transaction --- ## PoolTransactionsConnection **Type:** GraphQL objects **Description:** Connection type for pool transactions ### Fields - edges (PoolTransactionEdge): List of transaction edges - cursor (String): Cursor for pagination - node (PoolTransaction): The transaction node - pageInfo (PageInfo): Pagination information - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. - totalCount (Int): Total number of transactions --- ## PoolTransactionEdge **Type:** GraphQL objects **Description:** Edge type for pool transactions ### Fields - cursor (String): Cursor for pagination - node (PoolTransaction, Not Null): The transaction node - id (ID): Unique identifier - maker (String): User who made the swap - amount0In (Decimal): Amount of token0 swapped in - amount1In (Decimal): Amount of token1 swapped in - amount0Out (Decimal): Amount of token0 swapped out - amount1Out (Decimal): Amount of token1 swapped out - amountUsd (Decimal): Total amount in USD - timestamp (DateTime): Transaction timestamp - transactionId (Int): ID of the transaction - requestkey (String): Request key of the transaction - transactionType (PoolTransactionType): The type of transaction --- ## LiquidityBalance **Type:** GraphQL objects ### Fields - id (Int) - pairId (String) - liquidity (String) - walletAddress (String) - pair (Pool, Not Null): undefined - id (ID): Globally unique identifier for this pool node. - address (String): The on-chain address / module reference for this pool. - token0 (Token): The first token in the pair (base/slot-0). - token1 (Token): The second token in the pair (quote/slot-1). - reserve0 (String): Current on-chain reserve of `token0` held by the pool (as a string for full precision). - reserve1 (String): Current on-chain reserve of `token1` held by the pool (as a string for full precision). - totalSupply (String): Total supply of the pool’s LP (liquidity provider) tokens (as a string for full precision). - key (String): A stable key for the pool (e.g., a deterministic pair identifier). - tvlUsd (Float): Total value locked (USD) in this pool, derived from reserves and external pricing. - tvlChange24h (Float): 24-hour percentage change in TVL. - volume24hUsd (Float): Notional 24-hour traded volume (USD). - volumeChange24h (Float): 24-hour percentage change in volume. - volume7dUsd (Float): Notional 7-day traded volume (USD). - fees24hUsd (Float): Notional 24-hour fees accrued by the pool (USD). - feesChange24h (Float): 24-hour percentage change in fees. - transactionCount24h (Int): Count of pool transactions over the last 24 hours. - transactionCountChange24h (Float): 24-hour percentage change in transaction count. - apr24h (Float): 24-hour APR estimate derived from recent fees relative to TVL (as a percentage). - createdAt (DateTime): Timestamp when this pool record was created. - updatedAt (DateTime): Timestamp when this pool record was last updated. - charts (PoolCharts): Get chart/series data for this pool over a specified timeframe (e.g., TVL, volume). - transactions (PoolTransactionsConnection): Get transactions related to this pool, with optional type filtering and cursor-based pagination. - createdAt (DateTime) - updatedAt (DateTime) --- ## LiquidityPosition **Type:** GraphQL objects **Description:** Represents a user's liquidity position within a specific AMM pool. A `LiquidityPosition` tracks how much liquidity a given account has supplied to a pool, along with its current USD value, 24-hour APR, and metadata about the associated pool. It is typically used by wallets, dashboards, and DeFi analytics tools to display portfolio holdings, yield performance, and pool-specific details for a user's positions. ### Fields - id (ID): Globally unique identifier for this liquidity position. - pairId (String): The unique identifier (pair ID) of the pool this position belongs to. - liquidity (String): The total liquidity tokens held by this account in the pool. Returned as a string to preserve precision. - walletAddress (String): The Kadena account address that owns this liquidity position. Example: `"k:abcd1234..."` - valueUsd (Decimal): The current USD value of the user's liquidity position, calculated using DIA pricing data. - apr24h (Decimal): The 24-hour annualized percentage rate (APR) earned by this position based on recent pool activity. - pair (Pool, Not Null): Detailed information about the pool associated with this position. - id (ID): Globally unique identifier for this pool node. - address (String): The on-chain address / module reference for this pool. - token0 (Token): The first token in the pair (base/slot-0). - token1 (Token): The second token in the pair (quote/slot-1). - reserve0 (String): Current on-chain reserve of `token0` held by the pool (as a string for full precision). - reserve1 (String): Current on-chain reserve of `token1` held by the pool (as a string for full precision). - totalSupply (String): Total supply of the pool’s LP (liquidity provider) tokens (as a string for full precision). - key (String): A stable key for the pool (e.g., a deterministic pair identifier). - tvlUsd (Float): Total value locked (USD) in this pool, derived from reserves and external pricing. - tvlChange24h (Float): 24-hour percentage change in TVL. - volume24hUsd (Float): Notional 24-hour traded volume (USD). - volumeChange24h (Float): 24-hour percentage change in volume. - volume7dUsd (Float): Notional 7-day traded volume (USD). - fees24hUsd (Float): Notional 24-hour fees accrued by the pool (USD). - feesChange24h (Float): 24-hour percentage change in fees. - transactionCount24h (Int): Count of pool transactions over the last 24 hours. - transactionCountChange24h (Float): 24-hour percentage change in transaction count. - apr24h (Float): 24-hour APR estimate derived from recent fees relative to TVL (as a percentage). - createdAt (DateTime): Timestamp when this pool record was created. - updatedAt (DateTime): Timestamp when this pool record was last updated. - charts (PoolCharts): Get chart/series data for this pool over a specified timeframe (e.g., TVL, volume). - transactions (PoolTransactionsConnection): Get transactions related to this pool, with optional type filtering and cursor-based pagination. - createdAt (DateTime): Timestamp when this liquidity position was first created. - updatedAt (DateTime): Timestamp when this liquidity position was last updated. --- ## LiquidityPositionsConnection **Type:** GraphQL objects ### Fields - edges (LiquidityPositionEdge, Not Null): undefined - cursor (String) - node (LiquidityPosition) - pageInfo (PageInfo, Not Null): undefined - startCursor (String): The cursor representing the first item in the current page of results. Can be used as the `before` value in a subsequent query to fetch the previous page. - endCursor (String): The cursor representing the last item in the current page of results. Can be used as the `after` value in a subsequent query to fetch the next page. - hasNextPage (Boolean): Indicates whether there is another page of results **after** the current one. - hasPreviousPage (Boolean): Indicates whether there is another page of results **before** the current one. - totalCount (Int) --- ## LiquidityPositionEdge **Type:** GraphQL objects ### Fields - cursor (String) - node (LiquidityPosition, Not Null): undefined - id (ID): Globally unique identifier for this liquidity position. - pairId (String): The unique identifier (pair ID) of the pool this position belongs to. - liquidity (String): The total liquidity tokens held by this account in the pool. Returned as a string to preserve precision. - walletAddress (String): The Kadena account address that owns this liquidity position. Example: `"k:abcd1234..."` - valueUsd (Decimal): The current USD value of the user's liquidity position, calculated using DIA pricing data. - apr24h (Decimal): The 24-hour annualized percentage rate (APR) earned by this position based on recent pool activity. - pair (Pool): Detailed information about the pool associated with this position. - createdAt (DateTime): Timestamp when this liquidity position was first created. - updatedAt (DateTime): Timestamp when this liquidity position was last updated. --- ## DexMetrics **Type:** GraphQL objects **Description:** Aggregated performance metrics for a decentralized exchange (DEX). `DexMetrics` provides a snapshot and historical overview of network-wide DeFi activity, including total liquidity (TVL), trading volume, and the number of active pools. It is designed for powering dashboards, analytics views, and protocol-level insights. All USD-denominated values (TVL, volume) are calculated using price data from DIA, and historical data is shaped by the time range specified in the query (defaults to 30 days if none is provided). ### Fields - totalPools (Int): The total number of liquidity pools deployed under the protocol. - currentTvlUsd (Decimal): The current total value locked (TVL) across all pools, expressed in USD. This reflects the combined liquidity available in the protocol at the time of the query. - tvlHistory (ChartDataPoint, Not Null): Historical time-series data points representing TVL evolution over the selected time range. Useful for charting liquidity growth and analyzing protocol trends. - timestamp (DateTime): The timestamp associated with this data point. - value (Decimal): The metric value recorded at this timestamp. - volumeHistory (ChartDataPoint, Not Null): Historical time-series data points representing trading volume over the selected time range. Useful for charting market activity and usage patterns. - timestamp (DateTime): The timestamp associated with this data point. - value (Decimal): The metric value recorded at this timestamp. - totalVolumeUsd (Decimal): The total cumulative trading volume (in USD) observed over the specified time range. --- ## TokenPrice **Type:** GraphQL objects **Description:** Represents the latest known price information for a specific token. `TokenPrice` provides the current valuation of a token in both KDA (the Kadena native token) and USD, along with metadata about the protocol where the token is traded and the timestamp of the most recent price update. ### Fields - id (ID): Globally unique identifier for this token price entry. - token (Token, Not Null): The token associated with this price data. - id (ID) - name (String) - chainId (String) - address (String) - priceInKda (Decimal): The current price of the token denominated in KDA. - priceInUsd (Decimal): The current price of the token denominated in USD. - protocolAddress (String): The protocol/module name on Kadena where this price was retrieved from. - updatedAt (DateTime): The timestamp of the most recent price update.