Skip to content
Overview
Overview
Overview
Overview

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.

meta

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!,non-null

The network identifier where the transaction is intended to run. Example: "mainnet01" or "testnet04".

nonce
String!,non-null

A user-specified nonce string that ensures transaction uniqueness. Typically includes random or timestamp data to prevent replay.

payload

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!]!,non-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.

Sample
{ "meta": { "__typename": "TransactionMeta" }, "networkId": "Example String", "nonce": "Example String", "payload": { "__typename": "ContinuationPayload" }, "signers": [ { "__typename": "Signer" } ] }
Referenced in

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.

chainId
BigInt!,non-null

The ID of the chain where the transaction will be executed.

creationTime
DateTime!,non-null

The timestamp when the transaction was created. Used by the network to validate transaction age and enforce time-to-live rules.

gasLimit
BigInt!,non-null

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!,non-null

The price (in KDA) to pay per unit of gas. Determines the total transaction fee when multiplied by gasLimit.

sender
String!,non-null

The account name of the sender responsible for paying gas fees.

ttl
BigInt!,non-null

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.

Sample
{ "chainId": "Example Custom Scalar", "creationTime": "Example Custom Scalar", "gasLimit": "Example Custom Scalar", "gasPrice": "Example String", "sender": "Example String", "ttl": "Example Custom Scalar" }

List of capabilities associated with/installed by this signer.

sig
String!,non-null
Sample
{ "sig": "Example String" }
Referenced in

The payload of an cont transaction.

data
String!,non-null

The environment data made available to the transaction. Formatted as raw JSON.

pactId

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

The proof provided to continue the cross-chain transaction.

rollback

Whether or not this transaction can be rolled back.

step

The step-number when this is an execution of a defpact, aka multi-step transaction.

Sample
{ "data": "Example String", "pactId": "Example String", "proof": "Example String", "rollback": true, "step": 40 }
Referenced in

The payload of an exec transaction.

code

The Pact expressions executed in this transaction when it is an exec transaction.

data
String!,non-null

The environment data made available to the transaction. Formatted as raw JSON.

Sample
{ "code": "Example String", "data": "Example String" }
Referenced in

The mempool information.

status

The status of the mempool.

Sample
{ "status": "Example String" }
Referenced in

The result of a transaction.

badResult

The transaction result when it was successful. Formatted as raw JSON.

continuation

The JSON stringified continuation in the case that it is a continuation.

eventCount
gas
BigInt!,non-null
goodResult

The transaction result when it was successful. Formatted as raw JSON.

logs

Identifier to retrieve the logs for the execution of the transaction.

transactionId
height
BigInt!,non-nulldeprecated

The height of the block this transaction belongs to.

Deprecation reason

Use block.height instead.

metadata
String!,non-nulldeprecated
Deprecation reason

Not used.

block
Block!,non-null
afterbeforefirstlast
afterbeforefirstlast
Sample
{ "badResult": "Example String", "continuation": "Example String", "eventCount": "Example Custom Scalar", "gas": "Example Custom Scalar", "goodResult": "Example String", "logs": "Example String", "transactionId": "Example Custom Scalar", "height": "Example Custom Scalar", "metadata": "Example String", "block": { "__typename": "Block" }, "transfers": { "__typename": "TransactionResultTransfersConnection" }, "events": { "__typename": "TransactionResultEventsConnection" } }
Referenced in
pageInfo
PageInfo!,non-null
totalCount
Int!,non-null
Sample
{ "edges": [ { "cursor": "Example String", "node": { "id": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "name": "Example String", "block": { "__typename": "Block" }, "chainId": "Example Custom Scalar", "height": "Example Custom Scalar", "moduleName": "Example String", "orderIndex": "Example Custom Scalar", "requestKey": "Example String", "parameters": "Example String", "parameterText": "Example String", "qualifiedName": "Example String", "transaction": { "__typename": "Transaction" } } } ], "pageInfo": { "startCursor": "Example String", "endCursor": "Example String", "hasNextPage": true, "hasPreviousPage": true }, "totalCount": 40 }

TransactionResultEventsConnectionEdge

cursor
String!,non-null
node
Event!,non-null
Sample
{ "cursor": "Example String", "node": { "id": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "name": "Example String", "block": { "__typename": "Block" }, "chainId": "Example Custom Scalar", "height": "Example Custom Scalar", "moduleName": "Example String", "orderIndex": "Example Custom Scalar", "requestKey": "Example String", "parameters": "Example String", "parameterText": "Example String", "qualifiedName": "Example String", "transaction": { "__typename": "Transaction" } } }

TransactionResultTransfersConnection

pageInfo
PageInfo!,non-null
totalCount
Int!,non-null
Sample
{ "edges": [ { "cursor": "Example String", "node": { "amount": "Example Custom Scalar", "block": { "__typename": "Block" }, "blockHash": "Example String", "chainId": "Example Custom Scalar", "creationTime": "Example Custom Scalar", "crossChainTransfer": { "__typename": "Transfer" }, "height": "Example Custom Scalar", "id": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "moduleHash": "Example String", "moduleName": "Example String", "orderIndex": "Example Custom Scalar", "receiverAccount": "Example String", "requestKey": "Example String", "senderAccount": "Example String", "tokenId": "Example String", "transaction": { "__typename": "Transaction" } } } ], "pageInfo": { "startCursor": "Example String", "endCursor": "Example String", "hasNextPage": true, "hasPreviousPage": true }, "totalCount": 40 }

TransactionResultTransfersConnectionEdge

cursor
String!,non-null
node
Transfer!,non-null
Sample
{ "cursor": "Example String", "node": { "amount": "Example Custom Scalar", "block": { "__typename": "Block" }, "blockHash": "Example String", "chainId": "Example Custom Scalar", "creationTime": "Example Custom Scalar", "crossChainTransfer": { "__typename": "Transfer" }, "height": "Example Custom Scalar", "id": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "moduleHash": "Example String", "moduleName": "Example String", "orderIndex": "Example Custom Scalar", "receiverAccount": "Example String", "requestKey": "Example String", "senderAccount": "Example String", "tokenId": "Example String", "transaction": { "__typename": "Transaction" } } }
Overview
Overview
Overview
Overview