openapi: 3.0.3
info:
  title: Explorer API
  description: This API allows you to get the information for explorer
  version: 1.0.0
tags:
- name: accounts
- name: address
- name: auth
- name: blocks
- name: elections
- name: messages
- name: search
- name: stats
- name: transactions
servers:
- url: https://api.everscan.io/v1
- url: https://api-test.everscan.io/v1
paths:
  /authorize:
    post:
      tags:
      - auth
      summary: Authorize address and return JWT
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LoginRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JwtResponse'
  /api-token:
    get:
      tags:
      - auth
      summary: Get user api token
      security:
      - Bearer: []
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiKeyResponse'
  /time:
    get:
      tags:
      - stats
      summary: Server UTC timestamp (milliseconds)
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                type: integer
                format: uint64
  /address/global-info:
    post:
      tags:
      - address
      summary: Get address global description
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetContractInfoRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContractInfoResponse'
  /address/info:
    post:
      tags:
      - address
      summary: Get address user description
      security:
      - Bearer: []
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetContractInfoRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContractInfoResponse'
  /address/add-info:
    post:
      tags:
      - address
      summary: Add new user description for address
      security:
      - Bearer: []
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddContractInfoRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                description: Always `null`
                nullable: true
                type: string
                format: 'null'
  /stats:
    get:
      tags:
      - stats
      summary: Blockchain statistics
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BlockChainStatsResponse'
  /stats/accounts:
    post:
      tags:
      - stats
      summary: Accounts statistics
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StatsRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountsStatsResponse'
  /stats/accounts/active:
    post:
      tags:
      - stats
      summary: Accounts statistics
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StatsRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DateStatsResponse'
  /stats/transactions:
    post:
      tags:
      - stats
      summary: Transactions statistics
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StatsRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DateStatsResponse'
  /stats/messages:
    post:
      tags:
      - stats
      summary: Messages statistics
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StatsRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DateStatsResponse'
  /stats/total_supply:
    post:
      tags:
      - stats
      summary: Total supply per day
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StatsRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DateStatsResponse'
  /cmc/total_supply:
    get:
      tags:
      - stats
      summary: Total supply
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                type: string
  /cmc/circulating_supply:
    get:
      tags:
      - stats
      summary: Circulating supply
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                type: string
  /convert_address:
    post:
      tags:
      - accounts
      summary: Convert address
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountByIdRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConvertedAddressResponse'
  /accounts:
    post:
      tags:
      - accounts
      summary: Account data
      description: Get Account data.
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountByIdRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountResponse'
  /accounts/state:
    post:
      tags:
      - accounts
      summary: Account state
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountByIdRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountStateResponse'
  /accounts/list:
    post:
      tags:
      - accounts
      summary: Accounts data
      description: Get Accounts data.
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountsRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AccountResponse'
  /accounts/count:
    post:
      tags:
      - accounts
      summary: Accounts count data
      description: Get Accounts count data.
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountsCountRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CountResponse'
  /transactions:
    post:
      tags:
      - transactions
      summary: Transaction data
      description: Get Transaction data.
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HashRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionResponse'
  /transactions/raw:
    post:
      tags:
      - transactions
      summary: Raw transaction data
      description: Get raw transaction data
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HashRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RawTransactionResponse'
  /transactions/list:
    post:
      tags:
      - transactions
      summary: Transactions data
      description: Get Transactions data.
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TransactionsRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TransactionBriefResponse'
  /transactions/count:
    post:
      tags:
      - transactions
      summary: Transactions count data
      description: Get Transactions count data.
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TransactionsRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CountResponse'
  /messages:
    post:
      tags:
      - messages
      summary: Message data
      description: Get Message data.
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HashRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
  /messages/raw:
    post:
      tags:
      - messages
      summary: Raw message data
      description: Get raw message data
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HashRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RawMessageResponse'
  /messages/occurrences:
    post:
      tags:
      - messages
      summary: Message occurrences in transactions
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HashRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MessageOccurrenceResponse'
  /messages/list:
    post:
      tags:
      - messages
      summary: Messages data
      description: Get Messages data.
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MessagesRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TransactionMessageResponse'
  /messages/tree:
    post:
      tags:
      - messages
      summary: 'Returns tree of messages, traversing from to graph. Input: message hash'
      description: Get Message tree.
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HashRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TreeResponse'
  /messages/count:
    post:
      tags:
      - messages
      summary: Messages count data
      description: Get Messages count data.
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MessagesCountRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CountResponse'
  /blocks:
    post:
      tags:
      - blocks
      summary: Blocks data
      description: Get Blocks data.
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExactBlockRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BlockResponse'
  /blocks/messages:
    post:
      tags:
      - blocks
      summary: Blocks in and out messages
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HashRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BlockMessagesResponse'
  /blocks/list:
    post:
      tags:
      - blocks
      summary: Blocks list data
      description: Get Blocks list data.
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BlocksRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/BlockBriefResponse'
  /blocks/count:
    post:
      tags:
      - blocks
      summary: Blocks count data
      description: Get Blocks count data.
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BlocksCountRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CountResponse'
  /blocks/key-block-config:
    post:
      tags:
      - blocks
      summary: Get key block config by clock seqno
      description: Get key block config by clock seqno
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BlockConfigRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KeyBlockResponseDTO'
  /elections/config:
    get:
      tags:
      - elections
      summary: Brief elections config
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ElectionsConfigResponse'
  /elections/state:
    get:
      tags:
      - elections
      summary: Full elections state
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ElectorDataResponse'
  /elections/bonuses:
    get:
      tags:
      - elections
      summary: Validator set bonuses for recent election
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ElectionBonusesResponse'
  /elections/current_validators_top:
    get:
      tags:
      - elections
      summary: Brief current validators set (at most 10 items)
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CurrentValidatorResponse'
  /search:
    post:
      tags:
      - search
      summary: Search in all tables
      description: Search accounts by code hash, address, blocks by seqno, root hash, messages by hash, transaction by hash.
      requestBody:
        required: true
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchRequest'
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SearchMatchResponse'
components:
  schemas:
    AccountBlocks:
      type: array
      items:
        description: Account block brief info
        type: object
        properties:
          address:
            description: Hash part of account address
            type: string
            format: '[a-fA-F0-9]{64}'
            example: '0000000000000000000000000000000000000000000000000000000000000000'
          newHash:
            description: New account state hash
            type: string
            format: '[a-fA-F0-9]{64}'
          oldHash:
            description: Old account state hash
            type: string
            format: '[a-fA-F0-9]{64}'
          transactionCount:
            description: Account transaction count
            type: integer
          wc:
            description: Account workchain
            type: integer
            example: '0'
        required:
        - wc
        - address
        - oldHash
        - newHash
        - transactionCount
    AccountByIdRequest:
      description: Account by id request
      type: object
      properties:
        id:
          $ref: '#/components/schemas/Address'
      required:
      - id
    AccountColumn:
      description: Account column
      type: string
      enum:
      - createdAt
      - updatedAt
      - balance
      example: createdAt
    AccountReferenceResponse:
      description: Account reference
      type: object
      properties:
        address:
          type: string
        balance:
          type: string
          format: int64
        state:
          $ref: '#/components/schemas/AccountState'
        workchain:
          type: integer
          format: int8
      required:
      - workchain
      - address
      - state
      - balance
    AccountResponse:
      description: Account response
      nullable: true
      type: object
      properties:
        address:
          type: string
        balance:
          type: string
        codeHash:
          nullable: true
          type: string
          format: '[0-9a-f]{64}'
        createdAt:
          type: integer
          format: uint32
        creatorAddress:
          nullable: true
          type: string
        creatorWc:
          type: integer
          format: int8
        dataHash:
          nullable: true
          type: string
          format: '[0-9a-f]{64}'
        initCodeHash:
          nullable: true
          type: string
          format: '[0-9a-f]{64}'
        state:
          $ref: '#/components/schemas/AccountState'
        updatedAt:
          type: integer
          format: uint32
        updatedLt:
          type: string
          format: int64
        workchain:
          type: integer
          format: int8
      required:
      - workchain
      - address
      - state
      - balance
      - initCodeHash
      - codeHash
      - dataHash
      - creatorAddress
      - creatorWc
      - createdAt
      - updatedAt
      - updatedLt
    AccountState:
      type: string
      enum:
      - NonExist
      - Uninit
      - Active
      - Frozen
      - Deleted
      example: NonExist
    AccountStateResponse:
      description: Account state response
      type: object
      properties:
        state:
          $ref: '#/components/schemas/RawAccountState'
      required:
      - state
    AccountStatusChange:
      type: string
      enum:
      - Unchanged
      - Frozen
      - Deleted
      example: Unchanged
    AccountStorageInfo:
      type: object
      properties:
        duePayment:
          nullable: true
          type: integer
          format: uint64
        lastPaid:
          type: integer
          format: uint32
        used:
          $ref: '#/components/schemas/AccountStorageUsed'
      required:
      - used
      - lastPaid
      - duePayment
    AccountStorageUsed:
      type: object
      properties:
        bits:
          type: string
          format: int64
        cells:
          type: string
          format: int64
        publicCells:
          type: string
          format: int64
      required:
      - cells
      - bits
      - publicCells
    AccountsCountRequest:
      description: Accounts count request
      type: object
      properties:
        accountGt:
          type: string
          format: '[0-9a-fA-F]'
        accountLt:
          type: string
          format: '[0-9a-fA-F]'
        balanceGe:
          type: string
          format: int64
        balanceLe:
          type: string
          format: int64
        codeHash:
          type: string
          format: '[0-9a-fA-F]'
        createdAtGe:
          nullable: true
          type: integer
          format: uint32
        createdAtLe:
          nullable: true
          type: integer
          format: uint32
        initCodeHash:
          type: string
          format: '[0-9a-fA-F]'
        state:
          $ref: '#/components/schemas/AccountState'
        updatedAtGe:
          nullable: true
          type: integer
          format: uint32
        updatedAtLe:
          nullable: true
          type: integer
          format: uint32
        workchain:
          nullable: true
          type: integer
          format: int8
    AccountsCumCount:
      type: object
      properties:
        active:
          type: integer
          format: uint64
        created:
          type: integer
          format: uint64
      required:
      - created
      - active
    AccountsOrdering:
      description: Transactions ordering
      nullable: true
      type: object
      properties:
        column:
          $ref: '#/components/schemas/AccountColumn'
        direction:
          $ref: '#/components/schemas/Direction'
      required:
      - column
      - direction
    AccountsRequest:
      description: Accounts request
      type: object
      properties:
        accountGt:
          type: string
          format: '[0-9a-fA-F]'
        accountLt:
          type: string
          format: '[0-9a-fA-F]'
        balanceGe:
          type: string
          format: int64
        balanceLe:
          type: string
          format: int64
        codeHash:
          type: string
          format: '[0-9a-fA-F]'
        createdAtGe:
          nullable: true
          type: integer
          format: uint32
        createdAtLe:
          nullable: true
          type: integer
          format: uint32
        initCodeHash:
          type: string
          format: '[0-9a-fA-F]'
        limit:
          type: integer
          format: uint64
        offset:
          type: integer
          format: uint64
        ordering:
          $ref: '#/components/schemas/AccountsOrdering'
        state:
          $ref: '#/components/schemas/AccountState'
        updatedAtGe:
          nullable: true
          type: integer
          format: uint32
        updatedAtLe:
          nullable: true
          type: integer
          format: uint32
        workchain:
          nullable: true
          type: integer
          format: int8
      required:
      - limit
      - offset
    AccountsStatsResponse:
      type: array
      items:
        type: array
        items:
          oneOf:
          - description: Date without timezone
            type: string
            format: date
            example: 2020-06-26
          - $ref: '#/components/schemas/AccountsCumCount'
    AddContractInfoRequest:
      type: object
      properties:
        address:
          type: string
        codeHash:
          nullable: true
          type: string
        description:
          nullable: true
          type: string
        name:
          type: string
        socials:
          nullable: true
          type: string
        url:
          nullable: true
          type: string
      required:
      - address
      - name
      - description
      - codeHash
      - socials
      - url
    Address:
      description: StdAddr in any format
      type: string
      format: (-1|0):[0-9a-fA-F]{64}
      example: 0:0000000000000000000000000000000000000000000000000000000000000000
    ApiKey:
      nullable: true
      type: object
      properties:
        apiKey:
          type: string
        secret:
          type: string
      required:
      - apiKey
      - secret
    ApiKeyResponse:
      type: object
      properties:
        keyData:
          $ref: '#/components/schemas/ApiKey'
      required:
      - keyData
    AvgBlockTime:
      description: Average interval between blocks (in milliseconds)
      type: object
      additionalProperties:
        type: integer
        format: uint64
    BlkPrevInfo:
      oneOf:
      - type: object
        properties:
          kind:
            description: BlkPrevInfo type variant
            type: string
            enum:
            - Block
            example: Block
          prev:
            $ref: '#/components/schemas/ExtBlkRef'
        required:
        - prev
        - kind
      - type: object
        properties:
          kind:
            description: BlkPrevInfo type variant
            type: string
            enum:
            - Blocks
            example: Blocks
          prev1:
            $ref: '#/components/schemas/ExtBlkRef'
          prev2:
            $ref: '#/components/schemas/ExtBlkRef'
        required:
        - prev1
        - prev2
        - kind
    BlockBriefResponse:
      description: Block brief response
      type: object
      properties:
        genSoftwareVersion:
          type: integer
          format: uint32
        genUtime:
          type: integer
          format: uint32
        isKeyBlock:
          type: boolean
        rootHash:
          type: string
          format: '[0-9a-f]{64}'
        seqno:
          type: integer
          format: uint32
        shard:
          type: string
        transactionCount:
          type: integer
          format: uint16
        workchain:
          type: integer
          format: int8
      required:
      - workchain
      - shard
      - seqno
      - rootHash
      - isKeyBlock
      - transactionCount
      - genUtime
      - genSoftwareVersion
    BlockChainStatsResponse:
      description: Blockhain stats
      type: object
      properties:
        accountsActive1h:
          type: integer
          format: int64
        accountsActive24h:
          type: integer
          format: int64
        accountsActiveTotal:
          type: integer
          format: int64
        accountsCreated1h:
          type: integer
          format: int64
        accountsCreated24h:
          type: integer
          format: int64
        avgBlockTime:
          $ref: '#/components/schemas/AvgBlockTime'
        circulationSupply:
          type: string
          format: int64
        fetchedAt:
          type: integer
          format: int64
        latestMcSeqno:
          type: integer
          format: uint32
        messages1h:
          type: integer
          format: int64
        messages24h:
          type: integer
          format: int64
        messagesTotal:
          type: integer
          format: int64
        shardchainCount:
          type: integer
          format: int64
        totalSupply:
          type: string
          format: int64
        transactionTotal:
          type: integer
          format: int64
        transactions1h:
          type: integer
          format: int64
        transactions24h:
          type: integer
          format: int64
        validatorCount:
          type: integer
          format: uint32
        volume24h:
          type: string
          format: int64
      required:
      - fetchedAt
      - transactionTotal
      - messagesTotal
      - accountsActiveTotal
      - volume24h
      - transactions24h
      - messages24h
      - accountsActive24h
      - accountsCreated24h
      - transactions1h
      - messages1h
      - accountsActive1h
      - accountsCreated1h
      - totalSupply
      - circulationSupply
      - latestMcSeqno
      - shardchainCount
      - validatorCount
      - avgBlockTime
    BlockColumn:
      description: Transaction column
      type: string
      enum:
      - genUtime
      - seqno
      example: genUtime
    BlockConfigRequest:
      description: Block config request
      type: object
      properties:
        seqno:
          nullable: true
          type: integer
          format: uint32
    BlockCreationFeesDTO:
      type: object
      properties:
        basechainBlockFee:
          type: integer
          format: uint64
        masterchainBlockFee:
          type: integer
          format: uint64
      required:
      - masterchainBlockFee
      - basechainBlockFee
    BlockInfo:
      description: Block info
      type: object
      properties:
        afterMerge:
          description: Is this block after shards merge
          type: boolean
        afterSplit:
          description: Is this block after splitting the shards
          type: boolean
        beforeSplit:
          description: Is this block before splitting the shards
          type: boolean
        endLt:
          description: Maximum logical time in block
          type: string
          example: '0'
        flags:
          description: Block flags
          type: integer
          example: '0'
        genCatchainSeqno:
          description: The sequence number of catchain session which generated this block
          type: integer
          example: '0'
        genSoftware:
          $ref: '#/components/schemas/GlobalVersion'
        genValidatorListHashShort:
          description: Short hash of the set of validators that generated this block
          type: integer
          example: '0'
        keyBlock:
          description: Is this block a key block
          type: boolean
        masterRef:
          $ref: '#/components/schemas/ExtBlkRef'
        minRefMcSeqno:
          description: Minimal references masterchain seqno
          type: integer
          example: '0'
        prevKeyBlockSeqno:
          description: Previous key block sequence number
          type: integer
        prevRef:
          $ref: '#/components/schemas/BlkPrevInfo'
        prevVertRef:
          $ref: '#/components/schemas/BlkPrevInfo'
        startLt:
          description: Minimal logical time in block
          type: string
          example: '0'
        version:
          description: Block version
          type: integer
          example: '0'
        vertSeqNo:
          description: Vertical sequence number
          type: integer
          example: '0'
        vertSeqNoIncr:
          description: Yes
          type: integer
          example: '0'
        wantMerge:
          description: Will the current shard ever be merged
          type: boolean
        wantSplit:
          description: Will the current shard ever be split
          type: boolean
      required:
      - flags
      - startLt
      - endLt
      - genValidatorListHashShort
      - genCatchainSeqno
      - minRefMcSeqno
      - prevKeyBlockSeqno
      - genSoftware
      - prevRef
    BlockLimitsDTO:
      type: object
      properties:
        basechain:
          $ref: '#/components/schemas/BlockLimitsEntryDTO'
        masterchain:
          $ref: '#/components/schemas/BlockLimitsEntryDTO'
      required:
      - masterchain
      - basechain
    BlockLimitsEntryDTO:
      nullable: true
      type: object
      properties:
        bytes:
          $ref: '#/components/schemas/BlockLimitsParamDTO'
        gas:
          $ref: '#/components/schemas/BlockLimitsParamDTO'
        ltDelta:
          $ref: '#/components/schemas/BlockLimitsParamDTO'
      required:
      - bytes
      - gas
      - ltDelta
    BlockLimitsParamDTO:
      type: object
      properties:
        hardLimit:
          type: integer
          format: uint32
        softLimit:
          type: integer
          format: uint32
        underload:
          type: integer
          format: uint32
      required:
      - underload
      - softLimit
      - hardLimit
    BlockMessagesResponse:
      description: Block messages response
      type: object
      properties:
        inMessages:
          type: array
          items:
            $ref: '#/components/schemas/TransactionMessageResponse'
        outMessages:
          type: array
          items:
            $ref: '#/components/schemas/TransactionMessageResponse'
      required:
      - inMessages
      - outMessages
    BlockResponse:
      description: Block response
      nullable: true
      type: object
      properties:
        accountBlocks:
          $ref: '#/components/schemas/AccountBlocks'
        additionalInfo:
          $ref: '#/components/schemas/ValueFlow'
        blockInfo:
          $ref: '#/components/schemas/BlockInfo'
        fileHash:
          type: string
          format: '[0-9a-f]{64}'
        genSoftwareVersion:
          type: integer
          format: uint32
        genUtime:
          type: integer
          format: uint32
        isKeyBlock:
          type: boolean
        prev:
          $ref: '#/components/schemas/PrevBlockId'
        prevKeyBlock:
          type: integer
          format: uint32
        rootHash:
          type: string
          format: '[0-9a-f]{64}'
        seqno:
          type: integer
          format: uint32
        shard:
          type: string
        shardRelations:
          $ref: '#/components/schemas/ShardRelations'
        shardsInfo:
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/ShardDescrInfoItem'
        transactionCount:
          type: integer
          format: uint16
        valueFlow:
          $ref: '#/components/schemas/ValueFlow'
        workchain:
          type: integer
          format: int8
      required:
      - workchain
      - shard
      - seqno
      - rootHash
      - fileHash
      - isKeyBlock
      - transactionCount
      - genUtime
      - genSoftwareVersion
      - prev
      - prevKeyBlock
      - shardRelations
      - blockInfo
      - valueFlow
      - accountBlocks
      - shardsInfo
      - additionalInfo
    BlocksCountRequest:
      description: Blocks count request
      type: object
      properties:
        genUtimeGe:
          nullable: true
          type: integer
          format: uint32
        genUtimeLe:
          nullable: true
          type: integer
          format: uint32
        seqnoGe:
          nullable: true
          type: integer
          format: uint32
        seqnoLe:
          nullable: true
          type: integer
          format: uint32
        shard:
          nullable: true
          type: integer
          format: uint64
        transactionCountGe:
          nullable: true
          type: integer
          format: uint16
        transactionCountLe:
          nullable: true
          type: integer
          format: uint16
        workchain:
          nullable: true
          type: integer
          format: int8
    BlocksOrdering:
      description: Blocks ordering
      nullable: true
      type: object
      properties:
        column:
          $ref: '#/components/schemas/BlockColumn'
        direction:
          $ref: '#/components/schemas/Direction'
      required:
      - column
      - direction
    BlocksRequest:
      description: Blocks request
      type: object
      properties:
        genUtimeGe:
          nullable: true
          type: integer
          format: uint32
        genUtimeLe:
          nullable: true
          type: integer
          format: uint32
        limit:
          type: integer
          format: uint64
        offset:
          type: integer
          format: uint64
        ordering:
          $ref: '#/components/schemas/BlocksOrdering'
        seqnoGe:
          nullable: true
          type: integer
          format: uint32
        seqnoLe:
          nullable: true
          type: integer
          format: uint32
        shard:
          type: string
          format: '[0-9a-fA-F]{16}'
        transactionCountGe:
          nullable: true
          type: integer
          format: uint16
        transactionCountLe:
          nullable: true
          type: integer
          format: uint16
        workchain:
          nullable: true
          type: integer
          format: int8
      required:
      - limit
      - offset
    CatchainParamsDTO:
      nullable: true
      type: object
      properties:
        isolateMcValidators:
          type: boolean
        mcCatchainLifetime:
          type: integer
          format: uint32
        shardCatchainLifetime:
          type: integer
          format: uint32
        shardValidatorsLifetime:
          type: integer
          format: uint32
        shardValidatorsNum:
          type: integer
          format: uint32
        shuffleMcValidators:
          type: boolean
      required:
      - shuffleMcValidators
      - isolateMcValidators
      - mcCatchainLifetime
      - shardCatchainLifetime
      - shardValidatorsLifetime
      - shardValidatorsNum
    CollatorRange:
      type: object
      properties:
        collator:
          type: integer
          format: uint16
        collator_info:
          $ref: '#/components/schemas/ValidatorDescr'
        finish:
          type: integer
          format: uint32
        start:
          type: integer
          format: uint32
        unexpected_finish:
          nullable: true
          type: integer
          format: uint32
      required:
      - collator
      - collator_info
      - start
      - finish
      - unexpected_finish
    ComputeSkipReason:
      type: string
      enum:
      - NoState
      - BadState
      - NoGas
      - Suspended
      example: NoState
    ConfigVotingParamsDTO:
      type: object
      properties:
        bitPrice:
          type: integer
          format: uint32
        cellPrice:
          type: integer
          format: uint32
        maxLosses:
          type: integer
          format: uint8
        maxStoreSec:
          type: integer
          format: uint32
        maxTotalRounds:
          type: integer
          format: uint8
        minStoreSec:
          type: integer
          format: uint32
        minTotalRounds:
          type: integer
          format: uint8
        minWins:
          type: integer
          format: uint8
      required:
      - minTotalRounds
      - maxTotalRounds
      - minWins
      - maxLosses
      - minStoreSec
      - maxStoreSec
      - bitPrice
      - cellPrice
    ConfigVotingSetupDTO:
      nullable: true
      type: object
      properties:
        criticalParams:
          $ref: '#/components/schemas/ConfigVotingParamsDTO'
        normalParams:
          $ref: '#/components/schemas/ConfigVotingParamsDTO'
      required:
      - normalParams
      - criticalParams
    ConsensusParamsDTO:
      nullable: true
      type: object
      properties:
        attemptDuration:
          type: integer
          format: uint32
        catchainMaxDeps:
          type: integer
          format: uint32
        consensusTimeoutMs:
          type: integer
          format: uint32
        fastAttempts:
          type: integer
          format: uint32
        maxBlockBytes:
          type: integer
          format: uint32
        maxCollatedBytes:
          type: integer
          format: uint32
        newCatchainIds:
          type: boolean
        nextCandidateDelayMs:
          type: integer
          format: uint32
        roundCandidates:
          type: integer
          format: uint32
      required:
      - newCatchainIds
      - roundCandidates
      - nextCandidateDelayMs
      - consensusTimeoutMs
      - fastAttempts
      - attemptDuration
      - catchainMaxDeps
      - maxBlockBytes
      - maxCollatedBytes
    ContractInfo:
      nullable: true
      type: object
      properties:
        description:
          nullable: true
          type: string
        name:
          type: string
        socials: {}
        url:
          nullable: true
          type: string
      required:
      - name
      - description
      - socials
      - url
    ContractInfoResponse:
      type: object
      properties:
        contractInfo:
          $ref: '#/components/schemas/ContractInfo'
      required:
      - contractInfo
    ConvertedAddressResponse:
      description: Different address representations
      type: object
      properties:
        base64Bounceable:
          type: string
        base64NonBounceable:
          type: string
        base64UrlBounceable:
          type: string
        base64UrlNonBounceable:
          type: string
        unpacked:
          type: string
      required:
      - unpacked
      - base64Bounceable
      - base64UrlBounceable
      - base64NonBounceable
      - base64UrlNonBounceable
    CountResponse:
      type: object
      properties:
        count:
          type: integer
          format: int64
      required:
      - count
    CurrencyDTO:
      type: object
      properties:
        id:
          type: integer
          format: uint32
        totalSupply:
          type: string
      required:
      - id
      - totalSupply
    CurrentElectionData:
      description: Current election info
      nullable: true
      type: object
      properties:
        electAt:
          description: Election start
          type: integer
          example: '0'
        electClose:
          description: Election end
          type: integer
          example: '0'
        failed:
          description: Whether these elections were failed
          type: boolean
        finished:
          description: Whether these elections were finished
          type: boolean
        members:
          type: array
          items:
            $ref: '#/components/schemas/ElectionMember'
        minStake:
          description: Minimal validator stake
          type: string
          format: int64
          example: '0'
        totalStake:
          description: Total validator stakes
          type: string
          format: int64
          example: '0'
      required:
      - electAt
      - electClose
      - minStake
      - totalStake
      - members
      - failed
      - finished
    CurrentValidatorResponse:
      description: Current validator brief info
      type: object
      properties:
        address:
          type: string
          format: '[0-9a-f]{64}'
        bonuses:
          type: string
          format: int64
        weight:
          type: number
          format: double
      required:
      - address
      - weight
      - bonuses
    DateStatsResponse:
      type: array
      items:
        type: array
        items:
          oneOf:
          - description: Date without timezone
            type: string
            format: date
            example: 2020-06-26
          - type: integer
            format: uint64
    DelectorParamsDTO:
      nullable: true
      type: object
      properties:
        delectionsStep:
          type: integer
          format: uint32
        stakerInitCodeHash:
          type: string
        validatorInitCodeHash:
          type: string
      required:
      - delectionsStep
      - validatorInitCodeHash
      - stakerInitCodeHash
    Direction:
      description: Transactions ordering
      type: string
      enum:
      - ASC
      - DESC
      example: ASC
    ElectionBonusesResponse:
      description: Validator set bonuses
      type: object
      properties:
        bonuses:
          type: string
          format: int64
        electionId:
          type: integer
          format: uint32
      required:
      - electionId
      - bonuses
    ElectionMember:
      description: Current election member
      type: object
      properties:
        adnlAddr:
          type: string
          format: '[0-9a-f]{64}'
        createdAt:
          type: integer
          format: uint32
        maxFactor:
          type: integer
          format: uint32
        msgValue:
          type: string
          format: int64
        pubkey:
          type: string
          format: '[0-9a-f]{64}'
        srcAddr:
          type: string
          format: '[0-9a-f]{64}'
      required:
      - pubkey
      - msgValue
      - createdAt
      - maxFactor
      - srcAddr
      - adnlAddr
    ElectionsConfigResponse:
      description: Brief elector config
      type: object
      properties:
        electionsEndBefore:
          type: integer
          format: uint32
        electionsStartBefore:
          type: integer
          format: uint32
        maxMainValidators:
          type: integer
          format: uint32
        maxStake:
          type: string
          format: int64
        maxStakeFactor:
          type: integer
          format: uint32
        maxValidators:
          type: integer
          format: uint32
        minStake:
          type: string
          format: int64
        minTotalStake:
          type: string
          format: int64
        minValidators:
          type: integer
          format: uint32
        stakeHeldFor:
          type: integer
          format: uint32
        validatorsElectedFor:
          type: integer
          format: uint32
      required:
      - validatorsElectedFor
      - electionsStartBefore
      - electionsEndBefore
      - stakeHeldFor
      - maxValidators
      - maxMainValidators
      - minValidators
      - minStake
      - maxStake
      - minTotalStake
      - maxStakeFactor
    ElectorDataResponse:
      description: Elector data
      type: object
      properties:
        activeHash:
          description: Active validator set hash
          type: string
          format: '[a-fA-F0-9]{64}'
          example: '0000000000000000000000000000000000000000000000000000000000000000'
        activeId:
          description: Active election id
          type: integer
          example: '0'
        currentElection:
          $ref: '#/components/schemas/CurrentElectionData'
        pastElections:
          type: array
          items:
            $ref: '#/components/schemas/PastElectionData'
      required:
      - currentElection
      - pastElections
      - activeId
      - activeHash
    ElectorParamsDTO:
      nullable: true
      type: object
      properties:
        electionsEndBefore:
          type: integer
          format: uint32
        electionsStartBefore:
          type: integer
          format: uint32
        stakeHeldFor:
          type: integer
          format: uint32
        validatorsElectedFor:
          type: integer
          format: uint32
      required:
      - validatorsElectedFor
      - electionsStartBefore
      - electionsEndBefore
      - stakeHeldFor
    ExactBlockRequest:
      description: Request entity by hash
      oneOf:
      - type: object
        properties:
          id:
            type: string
            format: '[0-9a-fA-F]'
          kind:
            description: ExactBlockRequest type variant
            type: string
            enum:
            - ByHash
            example: ByHash
        required:
        - id
        - kind
      - type: object
        properties:
          kind:
            description: ExactBlockRequest type variant
            type: string
            enum:
            - BySeqno
            example: BySeqno
          seqno:
            type: integer
            format: uint32
          shard:
            type: string
            format: '[0-9a-fA-F]{16}'
          workchain:
            type: integer
            format: int8
        required:
        - workchain
        - shard
        - seqno
        - kind
    ExtBlkRef:
      type: object
      properties:
        endLt:
          type: string
          format: int64
        rootHash:
          type: string
          format: '[0-9a-f]{64}'
        seqNo:
          type: integer
          format: uint32
      required:
      - endLt
      - seqNo
      - rootHash
    FrozenStake:
      type: object
      properties:
        addr:
          type: string
          format: '[0-9a-f]{64}'
        pubkey:
          type: string
          format: '[0-9a-f]{64}'
        stake:
          type: string
          format: int64
        weight:
          type: string
          format: int64
      required:
      - pubkey
      - addr
      - weight
      - stake
    FutureSplitMerge:
      oneOf:
      - type: object
        properties:
          kind:
            description: FutureSplitMerge type variant
            type: string
            enum:
            - None
            example: None
        required:
        - kind
      - type: object
        properties:
          interval:
            type: integer
            format: uint32
          kind:
            description: FutureSplitMerge type variant
            type: string
            enum:
            - Split
            example: Split
          splitUtime:
            type: integer
            format: uint32
        required:
        - splitUtime
        - interval
        - kind
      - type: object
        properties:
          interval:
            type: integer
            format: uint32
          kind:
            description: FutureSplitMerge type variant
            type: string
            enum:
            - Merge
            example: Merge
          mergeUtime:
            type: integer
            format: uint32
        required:
        - mergeUtime
        - interval
        - kind
    GasPricesDTO:
      type: object
      properties:
        basechain:
          $ref: '#/components/schemas/GasPricesEntryDTO'
        masterchain:
          $ref: '#/components/schemas/GasPricesEntryDTO'
      required:
      - masterchain
      - basechain
    GasPricesEntryDTO:
      nullable: true
      type: object
      properties:
        blockGasLimit:
          type: integer
          format: uint64
        deleteDueLimit:
          type: integer
          format: uint64
        flatGasLimit:
          type: integer
          format: uint64
        flatGasPrice:
          type: integer
          format: uint64
        freezeDueLimit:
          type: integer
          format: uint64
        gasCredit:
          type: integer
          format: uint64
        gasLimit:
          type: integer
          format: uint64
        gasPrice:
          type: integer
          format: uint64
        specialGasLimit:
          type: integer
          format: uint64
      required:
      - gasPrice
      - gasLimit
      - specialGasLimit
      - gasCredit
      - blockGasLimit
      - freezeDueLimit
      - deleteDueLimit
      - flatGasLimit
      - flatGasPrice
    GetContractInfoRequest:
      type: object
      properties:
        address:
          type: string
      required:
      - address
    GlobalVersion:
      type: object
      properties:
        capabilities:
          type: string
          format: int64
        version:
          type: integer
          format: uint32
      required:
      - version
      - capabilities
    HashRequest:
      description: Request entity by hash
      type: object
      properties:
        id:
          type: string
          format: '[0-9a-fA-F]'
      required:
      - id
    JwtResponse:
      type: object
      properties:
        jwt:
          type: string
      required:
      - jwt
    KeyBlockResponseDTO:
      type: object
      properties:
        blockCreationFees:
          $ref: '#/components/schemas/BlockCreationFeesDTO'
        blockLimits:
          $ref: '#/components/schemas/BlockLimitsDTO'
        catchainParams:
          $ref: '#/components/schemas/CatchainParamsDTO'
        configAddress:
          type: string
        consensusParams:
          $ref: '#/components/schemas/ConsensusParamsDTO'
        criticalParams:
          type: array
          items:
            type: integer
            format: uint32
        currencies:
          type: array
          items:
            $ref: '#/components/schemas/CurrencyDTO'
        delectorParams:
          $ref: '#/components/schemas/DelectorParamsDTO'
        electorAddress:
          type: string
        electorParams:
          $ref: '#/components/schemas/ElectorParamsDTO'
        fundamentalAddresses:
          type: array
          items:
            type: string
        gasPrices:
          $ref: '#/components/schemas/GasPricesDTO'
        globalCapabilities:
          type: string
        globalVersion:
          type: integer
          format: uint32
        mandatoryParams:
          type: array
          items:
            type: integer
            format: uint32
        minterAddress:
          type: string
        msgForwardPrices:
          $ref: '#/components/schemas/MsgForwardPricesDTO'
        slashingConfig:
          $ref: '#/components/schemas/SlashingConfigDTO'
        stakeParams:
          $ref: '#/components/schemas/StakeParamsDTO'
        storagePrices:
          type: array
          items:
            $ref: '#/components/schemas/StoragePricesDTO'
        validatorCount:
          $ref: '#/components/schemas/ValidatorCountDTO'
        validatorsPublicKeys:
          type: array
          items:
            type: string
        votingSetup:
          $ref: '#/components/schemas/ConfigVotingSetupDTO'
        workchains:
          type: array
          items:
            $ref: '#/components/schemas/WorkchainDescriptionDTO'
      required:
      - configAddress
      - electorAddress
      - minterAddress
      - currencies
      - globalVersion
      - globalCapabilities
      - mandatoryParams
      - criticalParams
      - votingSetup
      - workchains
      - blockCreationFees
      - electorParams
      - validatorCount
      - stakeParams
      - storagePrices
      - gasPrices
      - blockLimits
      - msgForwardPrices
      - catchainParams
      - consensusParams
      - fundamentalAddresses
      - validatorsPublicKeys
      - delectorParams
      - slashingConfig
    LoginRequest:
      type: object
      properties:
        publicKey:
          type: string
        signature:
          type: string
        timestamp:
          type: integer
          format: uint64
      required:
      - publicKey
      - timestamp
      - signature
    MessageColumn:
      description: Message column
      type: string
      enum:
      - transactionTime
      - messageValue
      example: transactionTime
    MessageOccurrenceResponse:
      description: Message occurrence in transaction
      type: object
      properties:
        indexInTransaction:
          type: integer
          format: uint16
        isOut:
          type: boolean
        transactionHash:
          type: string
          format: '[0-9a-f]{64}'
        transactionTime:
          type: integer
          format: uint32
      required:
      - transactionHash
      - indexInTransaction
      - isOut
      - transactionTime
    MessageReferenceResponse:
      description: Message reference
      type: object
      properties:
        createdAt:
          type: integer
          format: uint32
        dstAddress:
          nullable: true
          type: string
        dstWorkchain:
          type: integer
          format: int8
        messageHash:
          type: string
          format: '[0-9a-f]{64}'
        messageType:
          $ref: '#/components/schemas/MessageType'
        messageValue:
          type: string
          format: int64
        srcAddress:
          nullable: true
          type: string
        srcWorkchain:
          type: integer
          format: int8
      required:
      - messageHash
      - srcWorkchain
      - srcAddress
      - dstWorkchain
      - dstAddress
      - messageType
      - messageValue
      - createdAt
    MessageResponse:
      description: Message response
      type: object
      properties:
        bounce:
          type: boolean
        bounced:
          type: boolean
        createdAt:
          type: integer
          format: uint32
        createdLt:
          type: string
          format: int64
        dstAddress:
          nullable: true
          type: string
        dstWorkchain:
          type: integer
          format: int8
        fwdFee:
          type: string
          format: int64
        ihrFee:
          type: string
          format: int64
        importFee:
          type: string
          format: int64
        messageHash:
          type: string
          format: '[0-9a-f]{64}'
        messageType:
          $ref: '#/components/schemas/MessageType'
        messageValue:
          type: string
          format: int64
        methodName:
          nullable: true
          type: string
        parsedId:
          nullable: true
          type: integer
          format: uint32
        parsedType:
          nullable: true
          type: string
          format: FunctionInput | FunctionOutput | BouncedFunction | Event
        srcAddress:
          nullable: true
          type: string
        srcWorkchain:
          type: integer
          format: int8
      required:
      - messageHash
      - srcWorkchain
      - srcAddress
      - dstWorkchain
      - dstAddress
      - messageType
      - messageValue
      - ihrFee
      - fwdFee
      - importFee
      - createdLt
      - createdAt
      - bounced
      - bounce
      - parsedId
      - parsedType
      - methodName
    MessageType:
      type: string
      enum:
      - Internal
      - ExternalIn
      - ExternalOut
      example: Internal
    MessagesCountRequest:
      description: Messages count request
      type: object
      properties:
        block:
          type: string
          format: '[0-9a-fA-F]{64}'
        excludeAccounts:
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/Address'
        excludeDstAccounts:
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/Address'
        excludeSrcAccounts:
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/Address'
        includeAccounts:
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/Address'
        includeDstAccounts:
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/Address'
        includeSrcAccounts:
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/Address'
        messageTypes:
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/MessageType'
        messageValueGe:
          type: string
          format: int64
        messageValueLe:
          type: string
          format: int64
        transactionTimeGe:
          nullable: true
          type: integer
          format: uint32
        transactionTimeLe:
          nullable: true
          type: integer
          format: uint32
    MessagesOrdering:
      description: Messages ordering
      nullable: true
      type: object
      properties:
        column:
          $ref: '#/components/schemas/MessageColumn'
        direction:
          $ref: '#/components/schemas/Direction'
      required:
      - column
      - direction
    MessagesRequest:
      description: Messages request
      type: object
      properties:
        block:
          type: string
          format: '[0-9a-fA-F]{64}'
        excludeAccounts:
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/Address'
        excludeDstAccounts:
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/Address'
        excludeSrcAccounts:
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/Address'
        includeAccounts:
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/Address'
        includeDstAccounts:
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/Address'
        includeSrcAccounts:
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/Address'
        limit:
          type: integer
          format: uint64
        messageTypes:
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/MessageType'
        messageValueGe:
          type: string
          format: int64
        messageValueLe:
          type: string
          format: int64
        offset:
          type: integer
          format: uint64
        ordering:
          $ref: '#/components/schemas/MessagesOrdering'
        transactionTimeGe:
          nullable: true
          type: integer
          format: uint32
        transactionTimeLe:
          nullable: true
          type: integer
          format: uint32
      required:
      - limit
      - offset
    MsgForwardPricesDTO:
      type: object
      properties:
        basechain:
          $ref: '#/components/schemas/MsgForwardPricesEntryDTO'
        masterchain:
          $ref: '#/components/schemas/MsgForwardPricesEntryDTO'
      required:
      - masterchain
      - basechain
    MsgForwardPricesEntryDTO:
      nullable: true
      type: object
      properties:
        bitPrice:
          type: integer
          format: uint64
        cellPrice:
          type: integer
          format: uint64
        firstFrac:
          type: integer
          format: uint16
        ihrPriceFactor:
          type: integer
          format: uint32
        lumpPrice:
          type: integer
          format: uint64
        nextFrac:
          type: integer
          format: uint16
      required:
      - lumpPrice
      - bitPrice
      - cellPrice
      - ihrPriceFactor
      - firstFrac
      - nextFrac
    PastElectionData:
      description: Past election info
      type: object
      properties:
        bonuses:
          description: Total bonuses received by this validator set
          type: string
          format: int64
          example: '0'
        electionId:
          description: Election ID
          type: integer
          example: '0'
        frozenDict:
          type: array
          items:
            $ref: '#/components/schemas/FrozenStake'
        stakeHeld:
          description: Stake freeze duration
          type: integer
          example: '0'
        totalStake:
          description: Total validator stakes
          type: string
          format: int64
          example: '0'
        unfreezeAt:
          description: Time of stakes unfreeze
          type: integer
          example: '0'
        vsetHash:
          description: Validator set hash
          type: string
          format: '[a-fA-F0-9]{64}'
          example: '0000000000000000000000000000000000000000000000000000000000000000'
      required:
      - electionId
      - unfreezeAt
      - stakeHeld
      - vsetHash
      - frozenDict
      - totalStake
      - bonuses
    PrevBlockId:
      oneOf:
      - type: object
        properties:
          kind:
            description: PrevBlockId type variant
            type: string
            enum:
            - Block
            example: Block
          prev1:
            type: string
            format: '[0-9a-f]{64}'
          prev1Seqno:
            type: integer
            format: uint32
        required:
        - prev1
        - prev1Seqno
        - kind
      - type: object
        properties:
          kind:
            description: PrevBlockId type variant
            type: string
            enum:
            - Blocks
            example: Blocks
          prev1:
            type: string
            format: '[0-9a-f]{64}'
          prev1Seqno:
            type: integer
            format: uint32
          prev1Shard:
            type: string
            format: '[0-9a-f]{16}'
          prev2:
            type: string
            format: '[0-9a-f]{64}'
          prev2Seqno:
            type: integer
            format: uint32
          prev2Shard:
            type: string
            format: '[0-9a-f]{16}'
        required:
        - prev1
        - prev1Shard
        - prev1Seqno
        - prev2
        - prev2Shard
        - prev2Seqno
        - kind
    RawAccountState:
      nullable: true
      type: object
      properties:
        codeBoc:
          nullable: true
          type: string
        dataBoc:
          nullable: true
          type: string
        storageStat:
          $ref: '#/components/schemas/AccountStorageInfo'
      required:
      - storageStat
      - dataBoc
      - codeBoc
    RawMessageResponse:
      description: Raw message data
      nullable: true
      type: object
      properties:
        boc:
          type: string
        body:
          nullable: true
          type: string
        stateInit:
          nullable: true
          type: string
      required:
      - boc
      - body
      - stateInit
    RawTransactionResponse:
      nullable: true
      type: object
      properties:
        boc:
          type: string
      required:
      - boc
    SearchMatchResponse:
      description: Message response
      type: object
      properties:
        data:
          description: Message response
          oneOf:
          - $ref: '#/components/schemas/BlockBriefResponse'
          - $ref: '#/components/schemas/MessageReferenceResponse'
          - $ref: '#/components/schemas/TransactionReferenceResponse'
          - $ref: '#/components/schemas/AccountReferenceResponse'
        kind:
          description: SearchMatchResponse type variant
          type: string
          enum:
          - Block
          - Message
          - Transaction
          - Account
          example: Block
      required:
      - kind
      - data
    SearchRequest:
      description: Search request
      type: object
      properties:
        query:
          type: string
      required:
      - query
    ShardCollators:
      nullable: true
      type: object
      properties:
        current:
          $ref: '#/components/schemas/CollatorRange'
        next:
          $ref: '#/components/schemas/CollatorRange'
        next2:
          $ref: '#/components/schemas/CollatorRange'
        prev:
          $ref: '#/components/schemas/CollatorRange'
        prev2:
          $ref: '#/components/schemas/CollatorRange'
      required:
      - prev
      - prev2
      - current
      - next
      - next2
    ShardDescrInfo:
      description: Shard info description
      type: object
      properties:
        beforeMerge:
          description: Whether this shard is going to merge
          type: boolean
        beforeSplit:
          description: Whether this shard is going to split
          type: boolean
        collators_info:
          $ref: '#/components/schemas/ShardCollators'
        endLt:
          description: Logical time range upper bound
          type: string
          format: int64
        feesCollected:
          description: Total fees collected
          type: string
          format: int64
        fileHash:
          description: File hash of the latest block in this shard
          type: string
          format: '[a-fA-F0-9]{64}'
          example: '0000000000000000000000000000000000000000000000000000000000000000'
        flags:
          description: Shard flags
          type: integer
        fundsCreated:
          description: Funds emission
          type: string
          format: int64
        genUtime:
          description: Unix timestamp of the latest block in shard
          type: integer
        minRefMcSeqno:
          description: Minimal referenced masterchain block seqno
          type: integer
        nextCatchainSeqno:
          description: Next catchain seqno
          type: integer
        nextValidatorShard:
          description: Yes
          type: string
        nxCcUpdated:
          description: Yes
          type: boolean
        regMcSeqno:
          description: Registration mc seqno
          type: integer
        rootHash:
          description: Root hash of the latest block in this shard
          type: string
          format: '[a-fA-F0-9]{64}'
          example: '0000000000000000000000000000000000000000000000000000000000000000'
        seqNo:
          description: Latest block seqno
          type: integer
          example: '0'
        splitMergeAt:
          $ref: '#/components/schemas/FutureSplitMerge'
        startLt:
          description: Logical time range lower bound
          type: string
          format: int64
          example: '0'
        wantMerge:
          description: Whether this shard is ready to merge
          type: boolean
        wantSplit:
          description: Whether this shard is ready to split
          type: boolean
      required:
      - seqNo
      - regMcSeqno
      - startLt
      - endLt
      - rootHash
      - fileHash
      - beforeSplit
      - beforeMerge
      - wantSplit
      - wantMerge
      - nxCcUpdated
      - flags
      - nextCatchainSeqno
      - nextValidatorShard
      - minRefMcSeqno
      - genUtime
      - splitMergeAt
      - feesCollected
      - fundsCreated
    ShardDescrInfoItem:
      type: object
      properties:
        info:
          $ref: '#/components/schemas/ShardDescrInfo'
        shardIdent:
          $ref: '#/components/schemas/ShardId'
      required:
      - shardIdent
      - info
    ShardId:
      type: object
      properties:
        shardPrefix:
          type: string
          format: int64
        wc:
          type: integer
          format: int32
      required:
      - wc
      - shardPrefix
    ShardRelations:
      type: object
      properties:
        leftChild:
          type: string
          format: '[0-9a-f]{16}'
        parent:
          type: string
          format: '[0-9a-f]{16}'
        rightChild:
          type: string
          format: '[0-9a-f]{16}'
      required:
      - parent
      - leftChild
      - rightChild
    SlashingConfigDTO:
      nullable: true
      type: object
      properties:
        collationsScoreWeight:
          type: integer
          format: uint32
        minSamplesCount:
          type: integer
          format: uint32
        minSlashingProtectionScore:
          type: integer
          format: uint32
        resendMcBlocksCount:
          type: integer
          format: uint32
        signingScoreWeight:
          type: integer
          format: uint32
        slashingPeriodMcBlocksCount:
          type: integer
          format: uint32
        zParamDenominator:
          type: integer
          format: uint32
        zParamNumerator:
          type: integer
          format: uint32
      required:
      - slashingPeriodMcBlocksCount
      - resendMcBlocksCount
      - minSamplesCount
      - collationsScoreWeight
      - signingScoreWeight
      - minSlashingProtectionScore
      - zParamNumerator
      - zParamDenominator
    StakeParamsDTO:
      nullable: true
      type: object
      properties:
        maxStake:
          type: integer
          format: uint64
        maxStakeFactor:
          type: integer
          format: uint32
        minStake:
          type: integer
          format: uint64
        minTotalStake:
          type: integer
          format: uint64
      required:
      - minStake
      - maxStake
      - minTotalStake
      - maxStakeFactor
    StatsRequest:
      type: object
      properties:
        end_date:
          nullable: true
          type: integer
          format: int64
        start_date:
          nullable: true
          type: integer
          format: int64
    StoragePricesDTO:
      type: object
      properties:
        bitPricePs:
          type: integer
          format: uint64
        cellPricePs:
          type: integer
          format: uint64
        mcBitPricePs:
          type: integer
          format: uint64
        mcCellPricePs:
          type: integer
          format: uint64
        utimeSince:
          type: integer
          format: uint32
      required:
      - utimeSince
      - bitPricePs
      - cellPricePs
      - mcBitPricePs
      - mcCellPricePs
    StorageUsedShort:
      type: object
      properties:
        bits:
          type: string
          format: int64
        cells:
          type: string
          format: int64
      required:
      - cells
      - bits
    TransactionAccountStatus:
      type: string
      enum:
      - Uninit
      - Active
      - Frozen
      - NonExist
      example: Uninit
    TransactionActionPhase:
      nullable: true
      type: object
      properties:
        actionListHash:
          type: string
        msgsCreated:
          type: integer
          format: int16
        noFunds:
          type: boolean
        resultArg:
          nullable: true
          type: integer
          format: int32
        resultCode:
          type: integer
          format: int32
        skippedActions:
          type: integer
          format: int16
        specActions:
          type: integer
          format: int16
        statusChange:
          $ref: '#/components/schemas/AccountStatusChange'
        success:
          type: boolean
        totActions:
          type: integer
          format: int16
        totMsgSize:
          $ref: '#/components/schemas/StorageUsedShort'
        totalActionFees:
          type: string
          format: int64
        totalFwdFees:
          type: string
          format: int64
        valid:
          type: boolean
      required:
      - success
      - valid
      - noFunds
      - statusChange
      - totalFwdFees
      - totalActionFees
      - resultCode
      - resultArg
      - totActions
      - specActions
      - skippedActions
      - msgsCreated
      - actionListHash
      - totMsgSize
    TransactionBouncePhase:
      oneOf:
      - type: object
        properties:
          kind:
            description: TransactionBouncePhase type variant
            type: string
            enum:
            - Negfunds
            example: Negfunds
        required:
        - kind
      - type: object
        properties:
          kind:
            description: TransactionBouncePhase type variant
            type: string
            enum:
            - Nofunds
            example: Nofunds
          msgSize:
            $ref: '#/components/schemas/StorageUsedShort'
          reqFwdFees:
            type: string
            format: int64
        required:
        - msgSize
        - reqFwdFees
        - kind
      - type: object
        properties:
          fwdFees:
            type: string
            format: int64
          kind:
            description: TransactionBouncePhase type variant
            type: string
            enum:
            - Ok
            example: Ok
          msgFees:
            type: string
            format: int64
          msgSize:
            $ref: '#/components/schemas/StorageUsedShort'
        required:
        - msgSize
        - msgFees
        - fwdFees
        - kind
    TransactionBriefResponse:
      description: 'Transactions Info Response '
      type: object
      properties:
        aborted:
          type: boolean
        accountId:
          type: string
        balanceChange:
          type: string
        blockHash:
          type: string
          format: '[0-9a-f]{64}'
        blockSeqno:
          type: integer
          format: uint32
        blockShard:
          type: string
        exitCode:
          nullable: true
          type: integer
          format: int32
        hash:
          type: string
        lt:
          type: string
        methodName:
          nullable: true
          type: string
        parsedId:
          nullable: true
          type: integer
          format: uint32
        parsedType:
          nullable: true
          type: string
          format: FunctionInput | FunctionOutput | BouncedFunction | Event
        resultCode:
          nullable: true
          type: integer
          format: int32
        time:
          type: integer
          format: uint32
        txType:
          $ref: '#/components/schemas/TransactionType'
        workchain:
          type: integer
          format: int8
      required:
      - workchain
      - accountId
      - lt
      - time
      - hash
      - blockShard
      - blockSeqno
      - blockHash
      - txType
      - aborted
      - balanceChange
      - exitCode
      - resultCode
      - methodName
      - parsedId
      - parsedType
    TransactionColumn:
      description: Transaction column
      type: string
      enum:
      - time
      - balanceChange
      example: time
    TransactionComputePhase:
      oneOf:
      - type: object
        properties:
          kind:
            description: TransactionComputePhase type variant
            type: string
            enum:
            - Skipped
            example: Skipped
          reason:
            $ref: '#/components/schemas/ComputeSkipReason'
        required:
        - reason
        - kind
      - type: object
        properties:
          accountActivated:
            type: boolean
          exitArg:
            nullable: true
            type: integer
            format: int32
          exitCode:
            type: integer
            format: int32
          gasCredit:
            nullable: true
            type: integer
            format: uint32
          gasFees:
            type: string
            format: int64
          gasLimit:
            type: string
            format: int64
          gasUsed:
            type: string
            format: int64
          kind:
            description: TransactionComputePhase type variant
            type: string
            enum:
            - Vm
            example: Vm
          mode:
            type: integer
            format: int8
          msgStateUsed:
            type: boolean
          success:
            type: boolean
          vmFinalStateHash:
            type: string
          vmInitStateHash:
            type: string
          vmSteps:
            type: integer
            format: uint32
        required:
        - success
        - msgStateUsed
        - accountActivated
        - gasFees
        - gasUsed
        - gasLimit
        - gasCredit
        - mode
        - exitCode
        - exitArg
        - vmSteps
        - vmInitStateHash
        - vmFinalStateHash
        - kind
    TransactionCreditPhase:
      nullable: true
      type: object
      properties:
        credit:
          type: string
          format: int64
        dueFeesCollected:
          type: string
          format: int64
      required:
      - dueFeesCollected
      - credit
    TransactionDescription:
      oneOf:
      - type: object
        properties:
          aborted:
            type: boolean
          actionPh:
            $ref: '#/components/schemas/TransactionActionPhase'
          bounce:
            $ref: '#/components/schemas/TransactionBouncePhase'
          computePh:
            $ref: '#/components/schemas/TransactionComputePhase'
          creditFirst:
            type: boolean
          creditPh:
            $ref: '#/components/schemas/TransactionCreditPhase'
          destroyed:
            type: boolean
          storagePh:
            $ref: '#/components/schemas/TransactionStoragePhase'
          txType:
            description: TransactionDescription type variant
            type: string
            enum:
            - Ordinary
            example: Ordinary
        required:
        - creditFirst
        - storagePh
        - creditPh
        - computePh
        - actionPh
        - aborted
        - destroyed
        - txType
      - type: object
        properties:
          txType:
            description: TransactionDescription type variant
            type: string
            enum:
            - Storage
            example: Storage
        required:
        - txType
      - type: object
        properties:
          aborted:
            type: boolean
          actionPh:
            $ref: '#/components/schemas/TransactionActionPhase'
          computePh:
            $ref: '#/components/schemas/TransactionComputePhase'
          destroyed:
            type: boolean
          storagePh:
            $ref: '#/components/schemas/TransactionStoragePhase'
          tt:
            $ref: '#/components/schemas/TransactionTickTock'
          txType:
            description: TransactionDescription type variant
            type: string
            enum:
            - TickTock
            example: TickTock
        required:
        - tt
        - storagePh
        - computePh
        - actionPh
        - aborted
        - destroyed
        - txType
      - type: object
        properties:
          txType:
            description: TransactionDescription type variant
            type: string
            enum:
            - SplitPrepare
            example: SplitPrepare
        required:
        - txType
      - type: object
        properties:
          txType:
            description: TransactionDescription type variant
            type: string
            enum:
            - SplitInstall
            example: SplitInstall
        required:
        - txType
      - type: object
        properties:
          txType:
            description: TransactionDescription type variant
            type: string
            enum:
            - MergePrepare
            example: MergePrepare
        required:
        - txType
      - type: object
        properties:
          txType:
            description: TransactionDescription type variant
            type: string
            enum:
            - MergeInstall
            example: MergeInstall
        required:
        - txType
    TransactionMessageResponse:
      description: 'Transaction Message Response '
      type: object
      properties:
        bounce:
          type: boolean
        bounced:
          type: boolean
        dstAddress:
          nullable: true
          type: string
        dstWorkchain:
          type: integer
          format: int8
        indexInTransaction:
          type: integer
          format: uint16
        isOut:
          type: boolean
        messageHash:
          type: string
          format: '[0-9a-f]{64}'
        messageType:
          $ref: '#/components/schemas/MessageType'
        messageValue:
          type: string
          format: int64
        methodName:
          nullable: true
          type: string
        parsedId:
          nullable: true
          type: integer
          format: uint32
        parsedType:
          nullable: true
          type: string
          format: FunctionInput | FunctionOutput | BouncedFunction | Event
        srcAddress:
          nullable: true
          type: string
        srcWorkchain:
          type: integer
          format: int8
        transactionHash:
          type: string
          format: '[0-9a-f]{64}'
        transactionTime:
          type: integer
          format: uint32
      required:
      - transactionHash
      - indexInTransaction
      - isOut
      - transactionTime
      - dstWorkchain
      - dstAddress
      - srcWorkchain
      - srcAddress
      - messageHash
      - messageType
      - messageValue
      - bounced
      - bounce
      - parsedId
      - parsedType
      - methodName
    TransactionReferenceResponse:
      description: Transaction reference
      type: object
      properties:
        accountId:
          type: string
        hash:
          type: string
        time:
          type: integer
          format: uint32
        txType:
          $ref: '#/components/schemas/TransactionType'
        workchain:
          type: integer
          format: int8
      required:
      - workchain
      - accountId
      - hash
      - time
      - txType
    TransactionResponse:
      description: 'Transactions With Messages Response '
      nullable: true
      type: object
      properties:
        aborted:
          type: boolean
        accountId:
          type: string
        balanceChange:
          type: string
          format: int64
        blockHash:
          type: string
          format: '[0-9a-f]{64}'
        blockSeqno:
          type: integer
          format: uint32
        blockShard:
          type: string
        description:
          $ref: '#/components/schemas/TransactionDescription'
        destroyed:
          type: boolean
        endStatus:
          $ref: '#/components/schemas/TransactionAccountStatus'
        hash:
          type: string
        inMessage:
          $ref: '#/components/schemas/MessageResponse'
        lt:
          type: string
          format: int64
        newHash:
          type: string
          format: '[0-9a-f]{64}'
        oldHash:
          type: string
          format: '[0-9a-f]{64}'
        origStatus:
          $ref: '#/components/schemas/TransactionAccountStatus'
        outMessages:
          type: array
          items:
            $ref: '#/components/schemas/MessageResponse'
        prevTransactionHash:
          type: string
          format: '[0-9a-f]{64}'
        prevTransactionLt:
          type: string
          format: int64
        time:
          type: integer
          format: uint32
        totalFees:
          type: string
          format: int64
        workchain:
          type: integer
          format: int8
      required:
      - workchain
      - accountId
      - lt
      - time
      - hash
      - blockShard
      - blockSeqno
      - blockHash
      - prevTransactionHash
      - prevTransactionLt
      - origStatus
      - endStatus
      - balanceChange
      - totalFees
      - aborted
      - destroyed
      - description
      - oldHash
      - newHash
      - outMessages
    TransactionStoragePhase:
      nullable: true
      type: object
      properties:
        statusChange:
          $ref: '#/components/schemas/AccountStatusChange'
        storageFeesCollected:
          type: string
          format: int64
        storageFeesDue:
          type: string
          format: int64
      required:
      - storageFeesCollected
      - storageFeesDue
      - statusChange
    TransactionTickTock:
      type: string
      enum:
      - Tick
      - Tock
      example: Tick
    TransactionType:
      type: string
      enum:
      - Ordinary
      - Storage
      - TickTock
      - SplitPrepare
      - SplitInstall
      - MergePrepare
      - MergeInstall
      example: Ordinary
    TransactionsOrdering:
      description: Transactions ordering
      nullable: true
      type: object
      properties:
        column:
          $ref: '#/components/schemas/TransactionColumn'
        direction:
          $ref: '#/components/schemas/Direction'
      required:
      - column
      - direction
    TransactionsRequest:
      description: Transactions request
      type: object
      properties:
        balanceChangeGe:
          type: string
          format: int64
        balanceChangeLe:
          type: string
          format: int64
        block:
          type: string
          format: '[0-9a-fA-F]{64}'
        excludeAccounts:
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/Address'
        includeAccounts:
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/Address'
        limit:
          type: integer
          format: uint64
        offset:
          type: integer
          format: uint64
        ordering:
          $ref: '#/components/schemas/TransactionsOrdering'
        timeGe:
          nullable: true
          type: integer
          format: uint32
        timeLe:
          nullable: true
          type: integer
          format: uint32
        txTypes:
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/TransactionType'
        workchain:
          nullable: true
          type: integer
          format: int8
      required:
      - limit
      - offset
    TreeResponse:
      description: 'Transaction tree Response '
      type: object
      properties:
        contractName:
          nullable: true
          type: string
        message:
          $ref: '#/components/schemas/TransactionMessageResponse'
        transaction:
          $ref: '#/components/schemas/TransactionBriefResponse'
      required:
      - message
      - transaction
      - contractName
    ValidatorCountDTO:
      nullable: true
      type: object
      properties:
        maxMainValidators:
          type: integer
          format: uint32
        maxValidators:
          type: integer
          format: uint32
        minValidators:
          type: integer
          format: uint32
      required:
      - minValidators
      - maxValidators
      - maxMainValidators
    ValidatorDescr:
      nullable: true
      type: object
      properties:
        adnl_addr:
          nullable: true
          type: string
        mc_seq_no_since:
          type: integer
          format: uint32
        public_key:
          type: string
        weight:
          type: integer
          format: uint64
      required:
      - public_key
      - weight
      - adnl_addr
      - mc_seq_no_since
    ValueFlow:
      description: Block value flow
      type: object
      properties:
        created:
          description: Value exported with external messages
          type: string
          format: int64
          example: '0'
        exported:
          description: Value exported with external messages
          type: string
          format: int64
          example: '0'
        feesCollected:
          description: Value exported with external messages
          type: string
          format: int64
          example: '0'
        feesImported:
          description: Value exported with external messages
          type: string
          format: int64
          example: '0'
        fromPrevBlk:
          description: Value from the previous block
          type: string
          format: int64
          example: '0'
        imported:
          description: Value imported with external messages
          type: string
          format: int64
          example: '0'
        minted:
          description: Value exported with external messages
          type: string
          format: int64
          example: '0'
        recovered:
          description: Value exported with external messages
          type: string
          format: int64
          example: '0'
        toNextBlk:
          description: Value to the next block
          type: string
          format: int64
          example: '0'
    WorkchainDescriptionDTO:
      type: object
      properties:
        acceptMsgs:
          type: boolean
        active:
          type: boolean
        enabledSince:
          nullable: true
          type: integer
          format: uint32
        flags:
          type: integer
          format: uint16
        maxSplit:
          type: integer
          format: uint8
        minSplit:
          type: integer
          format: uint8
        vmMode:
          type: string
        vmVersion:
          type: integer
          format: int32
        workchainId:
          type: integer
          format: uint32
      required:
      - workchainId
      - enabledSince
      - minSplit
      - maxSplit
      - flags
      - active
      - acceptMsgs
      - vmVersion
      - vmMode
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT