NEAR Protocol EXPERIMENTAL Light Client Proof API

openapi: 3.2.0
info:
  description: Low-latency indexed account, token, and public-key lookup APIs for wallets and explorers. Embedded portal clients may forward an optional `apiKey` query parameter, but the public FastNEAR API does not require it.
  title: FastNEAR accounts EXPERIMENTAL Light Client Proof API
  version: 3.0.3
servers:
- description: Mainnet
  url: https://api.fastnear.com
- description: Testnet
  url: https://test.api.fastnear.com
tags:
- name: EXPERIMENTAL Light Client Proof
paths:
  /EXPERIMENTAL_light_client_proof:
    post:
      description: Returns the proofs for a transaction execution.
      operationId: EXPERIMENTAL_light_client_proof
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/JsonRpcRequest_for_EXPERIMENTAL_light_client_proof'
        required: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonRpcResponse_for_RpcLightClientExecutionProofResponse_and_RpcLightClientProofError'
      tags:
      - EXPERIMENTAL Light Client Proof
components:
  schemas:
    TxExecutionError:
      description: Error returned in the ExecutionOutcome in case of failure
      oneOf:
      - additionalProperties: false
        description: An error happened during Action execution
        properties:
          ActionError:
            $ref: '#/components/schemas/ActionError'
        required:
        - ActionError
        type: object
      - additionalProperties: false
        description: An error happened during Transaction execution
        properties:
          InvalidTxError:
            $ref: '#/components/schemas/InvalidTxError'
        required:
        - InvalidTxError
        type: object
    ActionsValidationError:
      description: Describes the error for validating a list of actions.
      oneOf:
      - description: The delete action must be a final action in transaction
        enum:
        - DeleteActionMustBeFinal
        type: string
      - additionalProperties: false
        description: The total prepaid gas (for all given actions) exceeded the limit.
        properties:
          TotalPrepaidGasExceeded:
            properties:
              limit:
                $ref: '#/components/schemas/NearGas'
              total_prepaid_gas:
                $ref: '#/components/schemas/NearGas'
            required:
            - total_prepaid_gas
            - limit
            type: object
        required:
        - TotalPrepaidGasExceeded
        type: object
      - additionalProperties: false
        description: The number of actions exceeded the given limit.
        properties:
          TotalNumberOfActionsExceeded:
            properties:
              limit:
                format: uint64
                minimum: 0
                type: integer
              total_number_of_actions:
                format: uint64
                minimum: 0
                type: integer
            required:
            - total_number_of_actions
            - limit
            type: object
        required:
        - TotalNumberOfActionsExceeded
        type: object
      - additionalProperties: false
        description: The total number of bytes of the method names exceeded the limit in a Add Key action.
        properties:
          AddKeyMethodNamesNumberOfBytesExceeded:
            properties:
              limit:
                format: uint64
                minimum: 0
                type: integer
              total_number_of_bytes:
                format: uint64
                minimum: 0
                type: integer
            required:
            - total_number_of_bytes
            - limit
            type: object
        required:
        - AddKeyMethodNamesNumberOfBytesExceeded
        type: object
      - additionalProperties: false
        description: The length of some method name exceeded the limit in a Add Key action.
        properties:
          AddKeyMethodNameLengthExceeded:
            properties:
              length:
                format: uint64
                minimum: 0
                type: integer
              limit:
                format: uint64
                minimum: 0
                type: integer
            required:
            - length
            - limit
            type: object
        required:
        - AddKeyMethodNameLengthExceeded
        type: object
      - description: Integer overflow during a compute.
        enum:
        - IntegerOverflow
        type: string
      - additionalProperties: false
        description: Invalid account ID.
        properties:
          InvalidAccountId:
            properties:
              account_id:
                type: string
            required:
            - account_id
            type: object
        required:
        - InvalidAccountId
        type: object
      - additionalProperties: false
        description: The size of the contract code exceeded the limit in a DeployContract action.
        properties:
          ContractSizeExceeded:
            properties:
              limit:
                format: uint64
                minimum: 0
                type: integer
              size:
                format: uint64
                minimum: 0
                type: integer
            required:
            - size
            - limit
            type: object
        required:
        - ContractSizeExceeded
        type: object
      - additionalProperties: false
        description: The length of the method name exceeded the limit in a Function Call action.
        properties:
          FunctionCallMethodNameLengthExceeded:
            properties:
              length:
                format: uint64
                minimum: 0
                type: integer
              limit:
                format: uint64
                minimum: 0
                type: integer
            required:
            - length
            - limit
            type: object
        required:
        - FunctionCallMethodNameLengthExceeded
        type: object
      - additionalProperties: false
        description: The length of the arguments exceeded the limit in a Function Call action.
        properties:
          FunctionCallArgumentsLengthExceeded:
            properties:
              length:
                format: uint64
                minimum: 0
                type: integer
              limit:
                format: uint64
                minimum: 0
                type: integer
            required:
            - length
            - limit
            type: object
        required:
        - FunctionCallArgumentsLengthExceeded
        type: object
      - additionalProperties: false
        description: An attempt to stake with a public key that is not convertible to ristretto.
        properties:
          UnsuitableStakingKey:
            properties:
              public_key:
                $ref: '#/components/schemas/PublicKey'
            required:
            - public_key
            type: object
        required:
        - UnsuitableStakingKey
        type: object
      - description: The attached amount of gas in a FunctionCall action has to be a positive number.
        enum:
        - FunctionCallZeroAttachedGas
        type: string
      - description: There should be the only one DelegateAction
        enum:
        - DelegateActionMustBeOnlyOne
        type: string
      - additionalProperties: false
        description: 'The transaction includes a feature that the current protocol version

          does not support.


          Note: we stringify the protocol feature name instead of using

          `ProtocolFeature` here because we don''t want to leak the internals of

          that type into observable borsh serialization.'
        properties:
          UnsupportedProtocolFeature:
            properties:
              protocol_feature:
                type: string
              version:
                format: uint32
                minimum: 0
                type: integer
            required:
            - protocol_feature
            - version
            type: object
        required:
        - UnsupportedProtocolFeature
        type: object
      - additionalProperties: false
        properties:
          InvalidDeterministicStateInitReceiver:
            properties:
              derived_id:
                $ref: '#/components/schemas/AccountId'
              receiver_id:
                $ref: '#/components/schemas/AccountId'
            required:
            - receiver_id
            - derived_id
            type: object
        required:
        - InvalidDeterministicStateInitReceiver
        type: object
      - additionalProperties: false
        properties:
          DeterministicStateInitKeyLengthExceeded:
            properties:
              length:
                format: uint64
                minimum: 0
                type: integer
              limit:
                format: uint64
                minimum: 0
                type: integer
            required:
            - length
            - limit
            type: object
        required:
        - DeterministicStateInitKeyLengthExceeded
        type: object
      - additionalProperties: false
        properties:
          DeterministicStateInitValueLengthExceeded:
            properties:
              length:
                format: uint64
                minimum: 0
                type: integer
              limit:
                format: uint64
                minimum: 0
                type: integer
            required:
            - length
            - limit
            type: object
        required:
        - DeterministicStateInitValueLengthExceeded
        type: object
      - additionalProperties: false
        properties:
          GasKeyInvalidNumNonces:
            properties:
              limit:
                format: uint16
                maximum: 65535
                minimum: 0
                type: integer
              requested_nonces:
                format: uint16
                maximum: 65535
                minimum: 0
                type: integer
            required:
            - requested_nonces
            - limit
            type: object
        required:
        - GasKeyInvalidNumNonces
        type: object
      - additionalProperties: false
        properties:
          AddGasKeyWithNonZeroBalance:
            properties:
              balance:
                $ref: '#/components/schemas/NearToken'
            required:
            - balance
            type: object
        required:
        - AddGasKeyWithNonZeroBalance
        type: object
      - description: Gas keys with FunctionCall permission cannot have an allowance set.
        enum:
        - GasKeyFunctionCallAllowanceNotAllowed
        type: string
      - additionalProperties: false
        description: 'The combined number of `DeployContract` and `DeployGlobalContract`

          actions in one receipt exceeded the limit.'
        properties:
          TotalNumberOfDeployActionsExceeded:
            properties:
              limit:
                format: uint64
                minimum: 0
                type: integer
              number_of_deploy_actions:
                format: uint64
                minimum: 0
                type: integer
            required:
            - number_of_deploy_actions
            - limit
            type: object
        required:
        - TotalNumberOfDeployActionsExceeded
        type: object
    JsonRpcResponse_for_RpcLightClientExecutionProofResponse_and_RpcLightClientProofError:
      oneOf:
      - properties:
          result:
            $ref: '#/components/schemas/RpcLightClientExecutionProofResponse'
        required:
        - result
        type: object
      - properties:
          error:
            $ref: '#/components/schemas/ErrorWrapper_for_RpcLightClientProofError'
        required:
        - error
        type: object
      properties:
        id:
          type: string
        jsonrpc:
          type: string
      required:
      - jsonrpc
      - id
      title: JsonRpcResponse_for_RpcLightClientExecutionProofResponse_and_RpcLightClientProofError
      type: object
    GlobalContractIdentifier:
      oneOf:
      - additionalProperties: false
        properties:
          hash:
            $ref: '#/components/schemas/CryptoHash'
        required:
        - hash
        type: object
      - additionalProperties: false
        properties:
          account_id:
            $ref: '#/components/schemas/AccountId'
        required:
        - account_id
        type: object
    RpcLightClientExecutionProofRequest:
      oneOf:
      - properties:
          sender_id:
            $ref: '#/components/schemas/AccountId'
          transaction_hash:
            $ref: '#/components/schemas/CryptoHash'
          type:
            enum:
            - transaction
            type: string
        required:
        - type
        - transaction_hash
        - sender_id
        type: object
      - properties:
          receipt_id:
            $ref: '#/components/schemas/CryptoHash'
          receiver_id:
            $ref: '#/components/schemas/AccountId'
          type:
            enum:
            - receipt
            type: string
        required:
        - type
        - receipt_id
        - receiver_id
        type: object
      properties:
        light_client_head:
          $ref: '#/components/schemas/CryptoHash'
      required:
      - light_client_head
      title: RpcLightClientExecutionProofRequest
      type: object
    InternalError:
      oneOf:
      - properties:
          info:
            properties:
              error_message:
                type: string
            required:
            - error_message
            type: object
          name:
            enum:
            - INTERNAL_ERROR
            type: string
        required:
        - name
        - info
        type: object
    ActionErrorKind:
      oneOf:
      - additionalProperties: false
        description: Happens when CreateAccount action tries to create an account with account_id which is already exists in the storage
        properties:
          AccountAlreadyExists:
            properties:
              account_id:
                $ref: '#/components/schemas/AccountId'
            required:
            - account_id
            type: object
        required:
        - AccountAlreadyExists
        type: object
      - additionalProperties: false
        description: Happens when TX receiver_id doesn't exist (but action is not Action::CreateAccount)
        properties:
          AccountDoesNotExist:
            properties:
              account_id:
                $ref: '#/components/schemas/AccountId'
            required:
            - account_id
            type: object
        required:
        - AccountDoesNotExist
        type: object
      - additionalProperties: false
        description: A top-level account ID can only be created by registrar.
        properties:
          CreateAccountOnlyByRegistrar:
            properties:
              account_id:
                $ref: '#/components/schemas/AccountId'
              predecessor_id:
                $ref: '#/components/schemas/AccountId'
              registrar_account_id:
                $ref: '#/components/schemas/AccountId'
            required:
            - account_id
            - registrar_account_id
            - predecessor_id
            type: object
        required:
        - CreateAccountOnlyByRegistrar
        type: object
      - additionalProperties: false
        description: A newly created account must be under a namespace of the creator account
        properties:
          CreateAccountNotAllowed:
            properties:
              account_id:
                $ref: '#/components/schemas/AccountId'
              predecessor_id:
                $ref: '#/components/schemas/AccountId'
            required:
            - account_id
            - predecessor_id
            type: object
        required:
        - CreateAccountNotAllowed
        type: object
      - additionalProperties: false
        description: 'Administrative actions like `DeployContract`, `Stake`, `AddKey`, `DeleteKey`. can be proceed only if sender=receiver

          or the first TX action is a `CreateAccount` action'
        properties:
          ActorNoPermission:
            properties:
              account_id:
                $ref: '#/components/schemas/AccountId'
              actor_id:
                $ref: '#/components/schemas/AccountId'
            required:
            - account_id
            - actor_id
            type: object
        required:
        - ActorNoPermission
        type: object
      - additionalProperties: false
        description: Account tries to remove an access key that doesn't exist
        properties:
          DeleteKeyDoesNotExist:
            properties:
              account_id:
                $ref: '#/components/schemas/AccountId'
              public_key:
                $ref: '#/components/schemas/PublicKey'
            required:
            - account_id
            - public_key
            type: object
        required:
        - DeleteKeyDoesNotExist
        type: object
      - additionalProperties: false
        description: The public key is already used for an existing access key
        properties:
          AddKeyAlreadyExists:
            properties:
              account_id:
                $ref: '#/components/schemas/AccountId'
              public_key:
                $ref: '#/components/schemas/PublicKey'
            required:
            - account_id
            - public_key
            type: object
        required:
        - AddKeyAlreadyExists
        type: object
      - additionalProperties: false
        description: Account is staking and can not be deleted
        properties:
          DeleteAccountStaking:
            properties:
              account_id:
                $ref: '#/components/schemas/AccountId'
            required:
            - account_id
            type: object
        required:
        - DeleteAccountStaking
        type: object
      - additionalProperties: false
        description: ActionReceipt can't be completed, because the remaining balance will not be enough to cover storage.
        properties:
          LackBalanceForState:
            properties:
              account_id:
                allOf:
                - $ref: '#/components/schemas/AccountId'
                description: An account which needs balance
              amount:
                allOf:
                - $ref: '#/components/schemas/NearToken'
                description: Balance required to complete an action.
            required:
            - account_id
            - amount
            type: object
        required:
        - LackBalanceForState
        type: object
      - additionalProperties: false
        description: Account is not yet staked, but tries to unstake
        properties:
          TriesToUnstake:
            properties:
              account_id:
                $ref: '#/components/schemas/AccountId'
            required:
            - account_id
            type: object
        required:
        - TriesToUnstake
        type: object
      - additionalProperties: false
        description: The account doesn't have enough balance to increase the stake.
        properties:
          TriesToStake:
            properties:
              account_id:
                $ref: '#/components/schemas/AccountId'
              balance:
                $ref: '#/components/schemas/NearToken'
              locked:
                $ref: '#/components/schemas/NearToken'
              stake:
                $ref: '#/components/schemas/NearToken'
            required:
            - account_id
            - stake
            - locked
            - balance
            type: object
        required:
        - TriesToStake
        type: object
      - additionalProperties: false
        properties:
          InsufficientStake:
            properties:
              account_id:
                $ref: '#/components/schemas/AccountId'
              minimum_stake:
                $ref: '#/components/schemas/NearToken'
              stake:
                $ref: '#/components/schemas/NearToken'
            required:
            - account_id
            - stake
            - minimum_stake
            type: object
        required:
        - InsufficientStake
        type: object
      - additionalProperties: false
        description: An error occurred during a `FunctionCall` Action, parameter is debug message.
        properties:
          FunctionCallError:
            $ref: '#/components/schemas/FunctionCallError'
        required:
        - FunctionCallError
        type: object
      - additionalProperties: false
        description: 'Error occurs when a new `ActionReceipt` created by the `FunctionCall` action fails

          receipt validation.'
        properties:
          NewReceiptValidationError:
            $ref: '#/components/schemas/ReceiptValidationError'
        required:
        - NewReceiptValidationError
        type: object
      - additionalProperties: false
        description: 'Error occurs when a `CreateAccount` action is called on a NEAR-implicit or ETH-implicit account.

          See NEAR-implicit account creation NEP: <https://github.com/nearprotocol/NEPs/pull/71>.

          Also, see ETH-implicit account creation NEP: <https://github.com/near/NEPs/issues/518>.


          TODO(#8598): This error is named very poorly. A better name would be

          `OnlyNamedAccountCreationAllowed`.'
        properties:
          OnlyImplicitAccountCreationAllowed:
            properties:
              account_id:
                $ref: '#/components/schemas/AccountId'
            required:
            - account_id
            type: object
        required:
        - OnlyImplicitAccountCreationAllowed
        type: object
      - additionalProperties: false
        description: Delete account whose state is large is temporarily banned.
        properties:
          DeleteAccountWithLargeState:
            properties:
              account_id:
                $ref: '#/components/schemas/AccountId'
            required:
            - account_id
            type: object
        required:
        - DeleteAccountWithLargeState
        type: object
      - description: Signature does not match the provided actions and given signer public key.
        enum:
        - DelegateActionInvalidSignature
        type: string
      - additionalProperties: false
        description: Receiver of the transaction doesn't match Sender of the delegate action
        properties:
          DelegateActionSenderDoesNotMatchTxReceiver:
            properties:
              receiver_id:
                $ref: '#/components/schemas/AccountId'
              sender_id:
                $ref: '#/components/schemas/AccountId'
            required:
            - sender_id
            - receiver_id
            type: object
        required:
        - DelegateActionSenderDoesNotMatchTxReceiver
        type: object
      - description: Delegate action has expired. `max_block_height` is less than actual block height.
        enum:
        - DelegateActionExpired
        type: string
      - additionalProperties: false
        description: The given public key doesn't exist for Sender account
        properties:
          DelegateActionAccessKeyError:
            $ref: '#/components/schemas/InvalidAccessKeyError'
        required:
        - DelegateActionAccessKeyError
        type: object
      - additionalProperties: false
        description: DelegateAction nonce must be greater sender[public_key].nonce
        properties:
          DelegateActionInvalidNonce:
            properties:
              ak_nonce:
                format: uint64
                minimum: 0
                type: integer
              delegate_nonce:
                format: uint64
                minimum: 0
                type: integer
            required:
            - delegate_nonce
            - ak_nonce
            type: object
        required:
        - DelegateActionInvalidNonce
        type: object
      - additionalProperties: false
        description: DelegateAction nonce is larger than the upper bound given by the block height
        properties:
          DelegateActionNonceTooLarge:
            properties:
              delegate_nonce:
                format: uint64
                minimum: 0
                type: integer
              upper_bound:
                format: uint64
                minimum: 0
                type: integer
            required:
            - delegate_nonce
            - upper_bound
            type: object
        required:
        - DelegateActionNonceTooLarge
        type: object
      - additionalProperties: false
        properties:
          GlobalContractDoesNotExist:
            properties:
              identifier:
                $ref: '#/components/schemas/GlobalContractIdentifier'
            required:
            - identifier
            type: object
        required:
        - GlobalContractDoesNotExist
        type: object
      - additionalProperties: false
        description: Gas key does not exist for the specified public key
        properties:
          GasKeyDoesNotExist:
            properties:
              account_id:
                $ref: '#/components/schemas/AccountId'
              public_key:
                $ref: '#/components/schemas/PublicKey'
            required:
            - account_id
            - public_key
            type: object
        required:
        - GasKeyDoesNotExist
        type: object
      - additionalProperties: false
        description: Gas key does not have sufficient balance for the requested withdrawal
        properties:
          InsufficientGasKeyBalance:
            properties:
              account_id:
                $ref: '#/components/schemas/AccountId'
              balance:
                $ref: '#/components/schemas/NearToken'
              public_key:
                $ref: '#/components/schemas/PublicKey'
              required:
                $ref: '#/components/schemas/NearToken'
            required:
            - account_id
            - public_key
            - balance
            - required
            type: object
        required:
        - InsufficientGasKeyBalance
        type: object
      - additionalProperties: false
        description: Gas key balance is too high to burn during deletion
        properties:
          GasKeyBalanceTooHigh:
            properties:
              account_id:
                $ref: '#/components/schemas/AccountId'
              balance:
                $ref: '#/components/schemas/NearToken'
              public_key:
                anyOf:
                - $ref: '#/components/schemas/PublicKey'
                - enum:
                  - null
                description: Set for DeleteKey (specific key), None for DeleteAccount (aggregate)
            required:
            - account_id
            - balance
            type: object
        required:
        - GasKeyBalanceTooHigh
        type: object
      - additionalProperties: false
        description: DelegateAction nonce index is outside the gas key's nonce range
        properties:
          DelegateActionInvalidNonceIndex:
            properties:
              nonce_index:
                format: uint16
                maximum: 65535
                minimum: 0
                type: integer
              num_nonces:
                format: uint16
                maximum: 65535
                minimum: 0
                type: integer
            required:
            - nonce_index
            - num_nonces
            type: object
        required:
        - DelegateActionInvalidNonceIndex
        type: object
    RpcLightClientExecutionProofResponse:
      properties:
        block_header_lite:
          $ref: '#/components/schemas/LightClientBlockLiteView'
        block_proof:
          items:
            $ref: '#/components/schemas/MerklePathItem'
          type: array
        outcome_proof:
          $ref: '#/components/schemas/ExecutionOutcomeWithIdView'
        outcome_root_proof:
          items:
            $ref: '#/components/schemas/MerklePathItem'
          type: array
      required:
      - outcome_proof
      - outcome_root_proof
      - block_header_lite
      - block_proof
      type: object
    ExecutionMetadataView:
      properties:
        contracts:
          description: 'One entry per action in the receipt (V4+ only): the contract attached

            to the receiver account immediately before that action ran. The inner

            `Option` is `Some` (a tagged contract object) when the account had a

            contract and `None` (rendered as JSON `null`) when it did not (e.g. an

            account with no code, or one that did not yet exist). The outer

            `Option` is `None` for older metadata versions.'
          items:
            anyOf:
            - $ref: '#/components/schemas/AccountContractView'
            - enum:
              - null
          type:
          - array
          - 'null'
        gas_profile:
          items:
            $ref: '#/components/schemas/CostGasUsed'
          type:
          - array
          - 'null'
        version:
          format: uint32
          minimum: 0
          type: integer
      required:
      - version
      type: object
    DepositCostFailureReason:
      description: 'Reason why a gas key transaction failed at the deposit/account level.

        In these cases, gas is still charged from the gas key.'
      enum:
      - NotEnoughBalance
      - LackBalanceForState
      type: string
    CompilationError:
      oneOf:
      - additionalProperties: false
        properties:
          CodeDoesNotExist:
            properties:
              account_id:
                $ref: '#/components/schemas/AccountId'
            required:
            - account_id
            type: object
        required:
        - CodeDoesNotExist
        type: object
      - additionalProperties: false
        properties:
          PrepareError:
            $ref: '#/components/schemas/PrepareError'
        required:
        - PrepareError
        type: object
      - additionalProperties: false
        description: 'This is for defense in depth.

          We expect our runtime-independent preparation code to fully catch all invalid wasms,

          but, if it ever misses something we’ll emit this error'
        properties:
          WasmerCompileError:
            properties:
              msg:
                type: string
            required:
            - msg
            type: object
        required:
        - WasmerCompileError
        type: object
    MethodResolveError:
      enum:
      - MethodEmptyName
      - MethodNotFound
      - MethodInvalidSignature
      type: string
    PublicKey:
      type: string
    CostGasUsed:
      description: Shows gas profile. More info [here](https://near.github.io/nearcore/architecture/gas/gas_profile.html?highlight=WASM_HOST_COST#example-transaction-gas-profile).
      properties:
        cost:
          type: string
        cost_category:
          description: Either ACTION_COST or WASM_HOST_COST.
          type: string
        gas_used:
          type: string
      required:
      - cost_category
      - cost
      - gas_used
      type: object
    NearGas:
      format: uint64
      minimum: 0
      type: integer
    NearToken:
      type: string
    WasmTrap:
      description: A kind of a trap happened during execution of a binary
      oneOf:
      - description: An `unreachable` opcode was executed.
        enum:
        - Unreachable
        type: string
      - description: Call indirect incorrect signature trap.
        enum:
        - IncorrectCallIndirectSignature
        type: string
      - description: Memory out of bounds trap.
        enum:
        - MemoryOutOfBounds
        type: string
      - description: Call indirect out of bounds trap.
        enum:
        - CallIndirectOOB
        type: string
      - description: An arithmetic exception, e.g. divided by zero.
        enum:
        - IllegalArithmetic
        type: string
      - description: Misaligned atomic access trap.
        enum:
        - MisalignedAtomicAccess
        type: string
      - description: Indirect call to null.
        enum:
        - Indi

# --- truncated at 32 KB (80 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/near/refs/heads/main/openapi/near-experimental-light-client-proof-api-openapi.yml