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

# Tracking Proof Requests

> Check the status of your proof request in the Boundless market.

## Using the CLI

The [Boundless CLI](/developers/tooling/cli) provides the following command:

```shell Terminal theme={null}
boundless requestor status
```

## Programmatically

When you submit a proof request to Boundless, you can track its status programmatically using the Boundless client. This allows you to integrate request monitoring directly into your applications.

### Basic Request Tracking

Here's how to wait for a request to be fulfilled:

```rust no_run theme={null}
#

// Submit your request
let request = client.new_request()
    .with_program(program)
    .with_stdin(input);

let (request_id, expires_at) = client.submit(request).await?;

// Wait for the request to be fulfilled
tracing::info!("Waiting for request {:x} to be fulfilled", request_id);
let fulfillment = client
    .wait_for_request_fulfillment(
        request_id,
        Duration::from_secs(5), // check every 5 seconds
        expires_at,
    )
    .await?;
tracing::info!("Request {:x} fulfilled", request_id);
```

### How It Works

The `wait_for_request_fulfillment` method:

1. *Polls the request status* at the specified interval (e.g., every 5 seconds)
2. *Checks for completion states*:
   * `Fulfilled`: Request completed successfully - returns journal and seal
   * `Expired`: Request timed out - returns an error
   * Other states: Continues polling
3. *Provides status updates* via logging during the wait

### Request Status Types

Boundless tracks these request states:

* *Unknown*: Request may be open for bidding or not exist
* *Locked*: A prover has committed to fulfilling the request
* *Fulfilled*: Proof generation completed successfully
* *Expired*: Request timed out before fulfillment

### Error Handling

When tracking requests, handle these potential outcomes:

```rust no_run theme={null}
#

match client.wait_for_request_fulfillment(request_id, check_interval, expires_at).await {
    Ok(fulfillment) => {
        // Process the fulfilled proof
        tracing::info!("Proof received with fulfillment data: {:?}", fulfillment.data()?);
    }
    Err(ClientError::MarketError(MarketError::RequestHasExpired(_))) => {
        tracing::error!("Request expired before fulfillment");
        // Handle expiration - maybe retry with different parameters
    }
    Err(e) => {
        tracing::error!("Request tracking failed: {}", e);
        // Handle other errors
    }
}
```

### Advanced Tracking

For more control, you can manually check request status:

```rust no_run theme={null}
#

// Check status once
let status = client.boundless_market.get_status(request_id, Some(expires_at)).await?;
match status {
    RequestStatus::Fulfilled => {
        // Retrieve the fulfillment for the fulfilled request
        let fulfillment = client
            .wait_for_request_fulfillment(request_id, Duration::from_secs(1), expires_at)
            .await?;
    }
    RequestStatus::Locked => {
        tracing::info!("Request locked by a prover, awaiting fulfillment");
    }
    RequestStatus::Expired => {
        tracing::warn!("Request has expired");
    }
    RequestStatus::Unknown => {
        tracing::info!("Request is open for bidding");
    }
}
```

## Boundless Explorer

### Getting Started

The [Boundless Explorer](https://explorer.boundless.network/) provides a straightforward web interface to monitor and analyze proof activity on the Boundless network.

Developers can track live proof request statuses, analyze associated costs, review transaction details, and assess proof performance metrics. Provers can monitor active requests, track earnings, evaluate their efficiency, and benchmark performance against peers.

<img src="https://mintcdn.com/boundless/SgkYpsrMj9zy3PYU/images/explorer.png?fit=max&auto=format&n=SgkYpsrMj9zy3PYU&q=85&s=4dd27427b55bb31d5ae692b5c2018939" alt="Boundless Explorer" width="3806" height="1962" data-path="images/explorer.png" />

Access the explorer to:

* Search through [Orders](https://explorer.boundless.network/orders) and their current status.
* Check the list of all [Boundless Requestors](https://explorer.boundless.network/requestors).
* Check the list of all [Boundless Provers](https://explorer.boundless.network/provers).
* View trends and analyze network patterns on the [Stats](https://explorer.boundless.network/stats) page.

### Need Help?

* Join our [Discord community](https://discord.gg/aXRuD6spez)
* Report issues via [GitHub](https://github.com/boundless-xyz/boundless)