Pocket Network

opencollection: 1.0.0
info:
  name: Pocket Network Shannon RPC API
  version: v1
items:
- info:
    name: Blocks
    type: folder
  items:
  - info:
      name: Get Latest Shannon Block
      type: http
    http:
      method: GET
      url: https://shannon-grove-api.mainnet.poktroll.com/cosmos/base/tendermint/v1beta1/blocks/latest
    docs: Return the most recently committed CometBFT block.
  - info:
      name: Get Shannon Block By Height
      type: http
    http:
      method: GET
      url: https://shannon-grove-api.mainnet.poktroll.com/cosmos/base/tendermint/v1beta1/blocks/:height
      params:
      - name: height
        value: ''
        type: path
        description: Block height.
    docs: Return the Shannon block at a specific height.
- info:
    name: Transactions
    type: folder
  items:
  - info:
      name: Get Shannon Transaction By Hash
      type: http
    http:
      method: GET
      url: https://shannon-grove-api.mainnet.poktroll.com/cosmos/tx/v1beta1/txs/:hash
      params:
      - name: hash
        value: ''
        type: path
        description: Transaction hash (hex, 64 chars).
    docs: Return a Shannon transaction by its hash.
  - info:
      name: Broadcast Shannon Transaction
      type: http
    http:
      method: POST
      url: https://shannon-grove-api.mainnet.poktroll.com/cosmos/tx/v1beta1/txs
      body:
        type: json
        data: '{}'
    docs: 'Broadcast a signed Shannon transaction. The request body is a TxRaw-encoded transaction with broadcast mode (sync,
      async, block).

      '
- info:
    name: Bank
    type: folder
  items:
  - info:
      name: Get Shannon Address Balances
      type: http
    http:
      method: GET
      url: https://shannon-grove-api.mainnet.poktroll.com/cosmos/bank/v1beta1/balances/:address
      params:
      - name: address
        value: ''
        type: path
        description: Bech32 Shannon address (pokt1...).
    docs: Return all coin balances for a Shannon address (upokt and IBC tokens).
  - info:
      name: Get Shannon Total Supply
      type: http
    http:
      method: GET
      url: https://shannon-grove-api.mainnet.poktroll.com/cosmos/bank/v1beta1/supply
    docs: Return the total Shannon supply for every denom (upokt and IBC).
- info:
    name: Validators
    type: folder
  items:
  - info:
      name: List Shannon Validators
      type: http
    http:
      method: GET
      url: https://shannon-grove-api.mainnet.poktroll.com/cosmos/staking/v1beta1/validators
    docs: List Cosmos staking validators for the Shannon chain.
- info:
    name: Application
    type: folder
  items:
  - info:
      name: List Shannon Applications
      type: http
    http:
      method: GET
      url: https://shannon-grove-api.mainnet.poktroll.com/pocket/application/v1/application
    docs: 'List every Application module entry. Applications stake POKT to consume relays via gateways for one or more services.

      '
  - info:
      name: Get Shannon Application
      type: http
    http:
      method: GET
      url: https://shannon-grove-api.mainnet.poktroll.com/pocket/application/v1/application/:address
      params:
      - name: address
        value: ''
        type: path
        description: Bech32 Shannon address (pokt1...).
    docs: Return a single Application by Shannon address.
- info:
    name: Supplier
    type: folder
  items:
  - info:
      name: List Shannon Suppliers
      type: http
    http:
      method: GET
      url: https://shannon-grove-api.mainnet.poktroll.com/pocket/supplier/v1/supplier
    docs: 'List every Supplier module entry. Suppliers stake POKT and run a RelayMiner to serve relays for the services they
      support.

      '
  - info:
      name: Get Shannon Supplier
      type: http
    http:
      method: GET
      url: https://shannon-grove-api.mainnet.poktroll.com/pocket/supplier/v1/supplier/:address
      params:
      - name: address
        value: ''
        type: path
        description: Bech32 Shannon operator address.
    docs: Return a single Supplier by Shannon operator address.
- info:
    name: Gateway
    type: folder
  items:
  - info:
      name: List Shannon Gateways
      type: http
    http:
      method: GET
      url: https://shannon-grove-api.mainnet.poktroll.com/pocket/gateway/v1/gateway
    docs: 'List every Gateway module entry. Gateways stake POKT and are authorized by Applications to sign relays on their
      behalf.

      '
- info:
    name: Service
    type: folder
  items:
  - info:
      name: List Shannon Services
      type: http
    http:
      method: GET
      url: https://shannon-grove-api.mainnet.poktroll.com/pocket/service/v1/service
    docs: 'List every service registered on Shannon. A service represents an external data source (e.g. eth, solana, base,
      arbitrum) the network can serve relays for. Each service has compute-unit pricing.

      '
  - info:
      name: Get Shannon Service
      type: http
    http:
      method: GET
      url: https://shannon-grove-api.mainnet.poktroll.com/pocket/service/v1/service/:serviceId
      params:
      - name: serviceId
        value: ''
        type: path
        description: Service identifier (e.g. "eth", "solana", "base").
    docs: Return a single service definition.
- info:
    name: Session
    type: folder
  items:
  - info:
      name: Get Shannon Session
      type: http
    http:
      method: GET
      url: https://shannon-grove-api.mainnet.poktroll.com/pocket/session/v1/get_session
      params:
      - name: application_address
        value: ''
        type: query
      - name: service_id
        value: ''
        type: query
      - name: block_height
        value: ''
        type: query
    docs: 'Return the active session for a given application/service pair at a given block height. Sessions group applications
      and suppliers for the duration of a session window.

      '
- info:
    name: Proof
    type: folder
  items:
  - info:
      name: Get Shannon Proof Parameters
      type: http
    http:
      method: GET
      url: https://shannon-grove-api.mainnet.poktroll.com/pocket/proof/v1/params
    docs: 'Return the parameters of the on-chain Proof module (claim and proof windows, minimum relay difficulty, target submission
      probability).

      '
- info:
    name: Tokenomics
    type: folder
  items:
  - info:
      name: Get Shannon Tokenomics Parameters
      type: http
    http:
      method: GET
      url: https://shannon-grove-api.mainnet.poktroll.com/pocket/tokenomics/v1/params
    docs: 'Return the Shannon tokenomics parameters — mint ratio, allocations to DAO/proposer/source-owner/supplier, and global
      inflation/deflation settings (post-PIP-41 deflationary 97.5% mint ratio).

      '
bundled: true