> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kronex.network/llms.txt
> Use this file to discover all available pages before exploring further.

# krnx_getAuxPow

> AuxPoW payload and validation status for a block



## OpenAPI

````yaml specs/krnx_getAuxPow.json POST /
openapi: 3.1.0
info:
  description: >-
    Generated from internal/krnxapi/api.go by tools/rpcdocgen. Do not edit by
    hand.
  title: KRNX JSON-RPC
  version: 1.0.0
servers:
  - url: https://rpc.kronex.network
security: []
paths:
  /:
    post:
      summary: krnx_getAuxPow
      description: >-
        Returns the AuxPoW extension carried by a KRNX block together with its
        validation status.


        With `verbose` set to `false` the parent-chain `auxWork` and `auxProof`
        blobs are stripped, which keeps responses small for explorers that only
        need the status and the parent-chain identity.
      operationId: krnx_getAuxPow
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Request'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
          description: JSON-RPC response
components:
  schemas:
    Request:
      properties:
        id:
          example: 1
          type: integer
        jsonrpc:
          enum:
            - '2.0'
          example: '2.0'
          type: string
        method:
          enum:
            - krnx_getAuxPow
          example: krnx_getAuxPow
          type: string
        params:
          description: >-
            Positional parameters: 1. `blockNrOrHash` (string, required). 2.
            `verbose` (boolean, optional).
          example:
            - latest
            - true
          maxItems: 2
          minItems: 1
          type: array
      required:
        - jsonrpc
        - method
        - params
        - id
      type: object
    Response:
      properties:
        error:
          description: Present instead of `result` when the call fails.
          properties:
            code:
              example: -32602
              type: integer
            message:
              type: string
          type: object
        id:
          example: 1
          type: integer
        jsonrpc:
          example: '2.0'
          type: string
        result:
          $ref: '#/components/schemas/krnxAuxPowResult'
      type: object
    krnxAuxPowResult:
      properties:
        acceptedShareCount:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        actualCommitment:
          example: '0x0000000000000000000000000000000000000000000000000000000000000000'
          pattern: ^0x[0-9a-fA-F]{64}$
          type: string
        auxProofBytes:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        auxRoot:
          example: '0x0000000000000000000000000000000000000000000000000000000000000000'
          pattern: ^0x[0-9a-fA-F]{64}$
          type: string
        auxWorkBytes:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        auxpowFifoOrderOk:
          type: boolean
        auxpowFirstSelectedSeq:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        auxpowLastSelectedSeq:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        auxpowLeftPendingAfterSelected:
          type: boolean
        auxpowMaxSelectedSeqGap:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        auxpowNewestPendingSeqBefore:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        auxpowOldestLeftPendingSeqAfter:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        auxpowOldestPendingSeqBefore:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        auxpowPendingQueueSizeAfterBlock:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        auxpowPendingQueueSizeBeforeBlock:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        auxpowSelectedCount:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        auxpowSelectedOldestFirst:
          type: boolean
        auxpowSelectedSeqContiguous:
          type: boolean
        bchCandidateCountInBlock:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        bchWorksharesConsumedCount:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        bchWorksharesIncludedCount:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        bchWorksharesLeftPendingAfterBlock:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        bchWorksharesLimit:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        bestShareDifficultyInBlock:
          type: string
        bits:
          type: string
        builderCommitment:
          example: '0x0000000000000000000000000000000000000000000000000000000000000000'
          pattern: ^0x[0-9a-fA-F]{64}$
          type: string
        canonicalPayloadHash:
          example: '0x0000000000000000000000000000000000000000000000000000000000000000'
          pattern: ^0x[0-9a-fA-F]{64}$
          type: string
        classAuditMismatchReason:
          type: string
        classAuditSumsMatch:
          type: boolean
        coinbaseTx:
          description: 0x-prefixed hex byte string.
          pattern: ^0x([0-9a-fA-F]{2})*$
          type: string
        coinbaseTxHash:
          example: '0x0000000000000000000000000000000000000000000000000000000000000000'
          pattern: ^0x[0-9a-fA-F]{64}$
          type: string
        commitment:
          example: '0x0000000000000000000000000000000000000000000000000000000000000000'
          pattern: ^0x[0-9a-fA-F]{64}$
          type: string
        commitmentFields:
          type: object
        commitmentInputHash:
          example: '0x0000000000000000000000000000000000000000000000000000000000000000'
          pattern: ^0x[0-9a-fA-F]{64}$
          type: string
        expectedCommitment:
          example: '0x0000000000000000000000000000000000000000000000000000000000000000'
          pattern: ^0x[0-9a-fA-F]{64}$
          type: string
        expiredSelectedDespiteEnoughValidPending:
          type: boolean
        expiredSelectedDespiteEnoughValidPendingAnyClass:
          type: boolean
        expiredSelectedDespiteEnoughValidPendingSameClass:
          type: boolean
        extension:
          type: object
        headerAuxWorkDecoded:
          type: boolean
        merkleBranch:
          items:
            example: '0x0000000000000000000000000000000000000000000000000000000000000000'
            pattern: ^0x[0-9a-fA-F]{64}$
            type: string
          type: array
        merkleIndex:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        merkleRoot:
          example: '0x0000000000000000000000000000000000000000000000000000000000000000'
          pattern: ^0x[0-9a-fA-F]{64}$
          type: string
        minShareDifficulty:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        minerAddress:
          example: '0x0000000000000000000000000000000000000000'
          pattern: ^0x[0-9a-fA-F]{40}$
          type: string
        newestExpiredPendingAgeDistance:
          type: integer
        newestValidPendingAgeDistance:
          type: integer
        oldestExpiredPendingAgeDistance:
          type: integer
        oldestValidPendingAgeDistance:
          type: integer
        orderingMetadataAvailable:
          type: boolean
        parentBlockHash:
          example: '0x0000000000000000000000000000000000000000000000000000000000000000'
          pattern: ^0x[0-9a-fA-F]{64}$
          type: string
        parentBlockHeight:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        parentChain:
          type: string
        parentChainID:
          type: integer
        parentHeader:
          description: 0x-prefixed hex byte string.
          pattern: ^0x([0-9a-fA-F]{2})*$
          type: string
        payloadSource:
          type: string
        pendingExpiredBeforeSelection:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        pendingExpiredBeforeSelectionByClass:
          additionalProperties:
            description: 0x-prefixed hex quantity.
            pattern: ^0x[0-9a-fA-F]+$
            type: string
          type: object
        pendingTotalBeforeSelection:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        pendingTotalBeforeSelectionByClass:
          additionalProperties:
            description: 0x-prefixed hex quantity.
            pattern: ^0x[0-9a-fA-F]+$
            type: string
          type: object
        pendingUnknownAnchorBeforeSelection:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        pendingUnknownAnchorBeforeSelectionByClass:
          additionalProperties:
            description: 0x-prefixed hex quantity.
            pattern: ^0x[0-9a-fA-F]+$
            type: string
          type: object
        pendingValidBeforeSelection:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        pendingValidBeforeSelectionByClass:
          additionalProperties:
            description: 0x-prefixed hex quantity.
            pattern: ^0x[0-9a-fA-F]+$
            type: string
          type: object
        powId: {}
        previousblockhash:
          type: string
        rejectedShareCount:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        selectedExpired:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        selectedExpiredByClass:
          additionalProperties:
            description: 0x-prefixed hex quantity.
            pattern: ^0x[0-9a-fA-F]+$
            type: string
          type: object
        selectedExpiredCurrentBindingWhileValidOnlyOutsideCurrentBinding:
          type: boolean
        selectedTotal:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        selectedTotalByClass:
          additionalProperties:
            description: 0x-prefixed hex quantity.
            pattern: ^0x[0-9a-fA-F]+$
            type: string
          type: object
        selectedUnknownAnchor:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        selectedUnknownAnchorByClass:
          additionalProperties:
            description: 0x-prefixed hex quantity.
            pattern: ^0x[0-9a-fA-F]+$
            type: string
          type: object
        selectedValid:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        selectedValidByClass:
          additionalProperties:
            description: 0x-prefixed hex quantity.
            pattern: ^0x[0-9a-fA-F]+$
            type: string
          type: object
        shareCount:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        sidecarDecoded:
          type: boolean
        source:
          type: string
        status:
          type: string
        target:
          type: string
        templateBindingHash:
          type: string
        templateHeight:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        templateKRNXBlockHash:
          type: string
        templateKRNXBlockNumber:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        templateTxs:
          items:
            type: string
          type: array
        validPendingCouldFillLimitBeforeSelection:
          type: boolean
        validatorExpectedCommitment:
          example: '0x0000000000000000000000000000000000000000000000000000000000000000'
          pattern: ^0x[0-9a-fA-F]{64}$
          type: string
        workshares:
          items:
            $ref: '#/components/schemas/KRNXAuxPowWorkshare'
          type: array
        worksharesIncludedByParentChain:
          additionalProperties:
            type: integer
          type: object
      required:
        - acceptedShareCount
        - auxRoot
        - auxpowFifoOrderOk
        - auxpowLeftPendingAfterSelected
        - auxpowMaxSelectedSeqGap
        - auxpowPendingQueueSizeAfterBlock
        - auxpowPendingQueueSizeBeforeBlock
        - auxpowSelectedCount
        - auxpowSelectedOldestFirst
        - auxpowSelectedSeqContiguous
        - bchCandidateCountInBlock
        - bchWorksharesConsumedCount
        - bchWorksharesIncludedCount
        - bchWorksharesLeftPendingAfterBlock
        - bchWorksharesLimit
        - bestShareDifficultyInBlock
        - classAuditSumsMatch
        - commitment
        - expiredSelectedDespiteEnoughValidPending
        - expiredSelectedDespiteEnoughValidPendingAnyClass
        - expiredSelectedDespiteEnoughValidPendingSameClass
        - minShareDifficulty
        - minerAddress
        - newestExpiredPendingAgeDistance
        - newestValidPendingAgeDistance
        - oldestExpiredPendingAgeDistance
        - oldestValidPendingAgeDistance
        - orderingMetadataAvailable
        - pendingExpiredBeforeSelection
        - pendingExpiredBeforeSelectionByClass
        - pendingTotalBeforeSelection
        - pendingTotalBeforeSelectionByClass
        - pendingUnknownAnchorBeforeSelection
        - pendingUnknownAnchorBeforeSelectionByClass
        - pendingValidBeforeSelection
        - pendingValidBeforeSelectionByClass
        - rejectedShareCount
        - selectedExpired
        - selectedExpiredByClass
        - selectedExpiredCurrentBindingWhileValidOnlyOutsideCurrentBinding
        - selectedTotal
        - selectedTotalByClass
        - selectedUnknownAnchor
        - selectedUnknownAnchorByClass
        - selectedValid
        - selectedValidByClass
        - shareCount
        - status
        - validPendingCouldFillLimitBeforeSelection
      type: object
    KRNXAuxPowWorkshare:
      properties:
        acceptedAtKRNXBlockNumber:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        acceptedAtTime:
          type: integer
        acceptedAtUnixNano:
          type: integer
        auxMerkleBranch:
          items:
            type: string
          type: array
        auxMerkleIndex:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        auxpowPendingSeq:
          type: integer
        bits:
          type: string
        boundKRNXBlockNumber:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        chainIdTag:
          type: string
        coinbaseTx:
          type: string
        coinbaseTxHash:
          type: string
        commitmentNonce:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        daaStateDigest:
          type: string
        dedupeKey:
          type: string
        jobId:
          type: string
        merkleBranch:
          items:
            type: string
          type: array
        merkleIndex:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        merkleRoot:
          type: string
        minerAddress:
          type: string
        parentBlockHash:
          type: string
        parentChain:
          type: string
        parentChainID:
          type: integer
        parentHeader:
          type: string
        parentHeaderHash:
          type: string
        parentTemplateBindingHash:
          type: string
        parentTemplateFamilyHash:
          type: string
        pendingQueueIndex:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        powId: {}
        previousblockhash:
          type: string
        receivedAt:
          type: integer
        sequenceNumber:
          type: integer
        shareDifficulty:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        shareHash:
          type: string
        shareTarget:
          type: string
        signature:
          type: string
        signedAuxTemplate:
          type: string
        signer:
          type: string
        source:
          type: string
        status:
          type: string
        target:
          type: string
        templateBindingHash:
          type: string
        templateHeight:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        templateKRNXBlockHash:
          type: string
        templateKRNXBlockNumber:
          description: 0x-prefixed hex quantity.
          pattern: ^0x[0-9a-fA-F]+$
          type: string
        templateTxs:
          items:
            type: string
          type: array
        workshareId:
          type: string
      required:
        - coinbaseTx
        - coinbaseTxHash
        - merkleBranch
        - merkleIndex
        - minerAddress
        - parentBlockHash
        - parentChain
        - parentHeader
        - powId
        - receivedAt
        - shareHash
        - shareTarget
      type: object

````