# gasLimitEstimate

**Type:** GraphQL queries

**Description:**
Estimate the gas limit required to execute one or more transactions on the Kadena blockchain.

This query accepts one or more JSON-encoded transaction inputs and analyzes them to calculate
the expected gas usage. It automatically infers the transaction type based on the fields provided
and returns the estimated gas limit for each input.
If any transaction is invalid or cannot be parsed, the query will throw an error.

Supported input types and required fields:

- `full-transaction`: A fully signed transaction object.
  Required: `cmd`, `hash`, `sigs`

- `stringified-command`: A JSON-stringified command.
  Required: `cmd` (optional: `sigs`)

- `full-command`: A complete command object.
  Required: `payload`, `meta`, `signers`

- `partial-command`: A partially defined command.
  Required: `payload` and either `meta` or `signers`
  (optional: `chainId` if `signers` is provided without `meta`)

- `payload`: Only the payload of a command.
  Required: `payload`, `chainId`

- `code`: Pact execution code.
  Required: `code`, `chainId`

All input types optionally accept `networkId` to override the default network configured in the environment.

<pre style="font-size: 0.85em;"><code class="language-graphql">
query {
  gasLimitEstimate(
    input: [
      "{
        \"code\": \"(coin.details \\\"k:1234\\\")\",
        \"chainId\": \"3\"
      }"
    ]
  ) {
    amount
    inputType
  }
}
</code></pre>

## Arguments
- input (String): One or more JSON-encoded transaction inputs to estimate gas for.
Each entry must follow one of the supported input type structures listed above.

## Response
**Type:** GasLimitEstimation
**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.