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

# blockSubscribe

> Subscribe to receive notification anytime a new block is confirmed or finalized.

### Parameters

<ParamField query="chainId" type="string" default="solana-devnet" required>
  Unique identifier for a blockchain network.
</ParamField>

<ParamField body="id" type="number" default={1} required>
  Request identifier used to match responses.
</ParamField>

<ParamField body="jsonrpc" type="string" default="2.0" required>
  JSON-RPC version.
</ParamField>

<ParamField body="method" type="string" default="blockSubscribe" required>
  JSON-RPC method name.
</ParamField>

<ParamField body="params" type="object" default={[{"mentionsAccountOrProgram":"LieKvPRE8XeX3Y2xVNHjKlpAScD12lYySBVQ4HqoJ5op"},{"commitment":"confirmed","encoding":"base64","showRewards":true,"transactionDetails":"full"}]} placeholder="[{&#x22;mentionsAccountOrProgram&#x22;:&#x22;LieKvPRE8XeX3Y2xVNHjKlpAScD12lYySBVQ4HqoJ5op&#x22;},{&#x22;commitment&#x22;:&#x22;confirmed&#x22;,&#x22;encoding&#x22;:&#x22;base64&#x22;,&#x22;showRewards&#x22;:true,&#x22;transactionDetails&#x22;:&#x22;full&#x22;}]" required>
  Parameters for method blockSubscribe: \[filter, config]

  Positional parameters for <code>blockSubscribe</code>:

  <ul>
    <li><code>params\[0]</code>: Filter criteria for block subscription: "all" includes all transactions in the block.</li>
    <li><code>params\[1]</code>: Optional configuration object.</li>
  </ul>
</ParamField>

### Returns

<ResponseField name="result" type="integer">
  Subscription ID returned for the block subscription (used for unsubscribing). Example: <code>9876</code>.
</ResponseField>

<RequestExample>
  ```bash Curl theme={null}
  curl --request POST \
    --url https://api.uniblock.dev/uni/v1/json-rpc?chainId=solana-devnet \
    --header 'content-type: application/json' \
    --data '{
      "id": 1,
      "jsonrpc": "2.0",
      "method": "blockSubscribe",
      "params": [
        {
          "mentionsAccountOrProgram": "LieKvPRE8XeX3Y2xVNHjKlpAScD12lYySBVQ4HqoJ5op"
        },
        {
          "commitment": "confirmed",
          "encoding": "base64",
          "showRewards": true,
          "transactionDetails": "full"
        }
      ]
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "jsonrpc": "2.0",
    "id": 1,
    "result": 9876
  }
  ```
</ResponseExample>