celestia

Celestia Node State API

JSON-RPC methods in the state module of celestia-node. Exposes state-level operations including account balances, transfers, delegations, and most importantly state.SubmitPayForBlob, the canonical entrypoint for submitting PayForBlobs transactions to the celestia-app state machine.

Celestia Node State API is one of 10 APIs that celestia publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 machine-runnable capability that can be deployed as REST, MCP, or Agent Skill surfaces via Naftiko.

Tagged areas include Celestia, JSONRPC, PayForBlobs, and State. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, sample payloads, and 1 Naftiko capability spec.

GitHub OpenAPI

Documentation

📖
Documentation
https://node-rpc-docs.celestia.org/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/celestia/refs/heads/main/openapi/celestia-state-api-openapi.yml

Examples

📝
Example
https://raw.githubusercontent.com/api-evangelist/celestia/refs/heads/main/examples/celestia-state-submitpayforblob-example.json

Other Resources

🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/celestia/refs/heads/main/capabilities/state-payforblobs.yaml

OpenAPI Specification

celestia-state-api-openapi.yml Raw ↑ 
openapi: 3.1.0
info:
  title: Celestia Node State API
  version: 0.30.x
  description: |
    JSON-RPC methods in the `state` module of celestia-node. Exposes state-level
    operations including account balances, transactions, delegations, transfers,
    and submitting PayForBlobs transactions. Acts as a thin client over the
    underlying celestia-app (Cosmos SDK) state machine.
  license:
    name: Apache-2.0
servers:
  - url: http://localhost:26658
tags:
  - name: State
    description: Account, balance, transfer, delegation, and PayForBlobs operations.
paths:
  /:
    post:
      tags: [State]
      summary: Invoke State JSON-RPC Method
      description: |
        Exposes the `state.*` namespace including `state.AccountAddress`,
        `state.Balance`, `state.BalanceForAddress`, `state.Transfer`,
        `state.SubmitPayForBlob`, `state.Delegate`, `state.Undelegate`,
        `state.BeginRedelegate`, `state.CancelUnbondingDelegation`,
        `state.QueryDelegation`, `state.QueryUnbonding`, `state.QueryRedelegations`,
        and `state.GrantFee` / `state.RevokeGrantFee`.
      security:
        - BearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/JsonRpcRequest'
      responses:
        '200':
          description: JSON-RPC response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonRpcResponse'
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
  schemas:
    JsonRpcRequest:
      type: object
      required: [jsonrpc, method, id]
      properties:
        jsonrpc:
          type: string
          enum: ["2.0"]
        id:
          oneOf: [{type: integer}, {type: string}]
        method:
          type: string
          enum:
            - state.AccountAddress
            - state.Balance
            - state.BalanceForAddress
            - state.Transfer
            - state.SubmitPayForBlob
            - state.Delegate
            - state.Undelegate
            - state.BeginRedelegate
            - state.CancelUnbondingDelegation
            - state.QueryDelegation
            - state.QueryUnbonding
            - state.QueryRedelegations
            - state.GrantFee
            - state.RevokeGrantFee
        params:
          type: array
    JsonRpcResponse:
      type: object
      properties:
        jsonrpc: {type: string}
        id: {}
        result: {}
        error:
          type: object
          properties:
            code: {type: integer}
            message: {type: string}