Prover Status

Check the current status of prover operations that generate zero-knowledge proofs for database operations.

Definition

await zkdb
  .db(databaseName: string)
  .proverStatus(): Promise<TProverStatusResponse>;

Parameters

• None

Returns

• Promise<EQueueTaskStatus>: Returns the current operational state of the zero-knowledge proof generation system. This status reflects the aggregate health of both document processing and rollup preparation queues, helping you determine when proofs are ready for verification or rollup operations.

type TProverStatusResponse = EQueueTaskStatus;

enum EQueueTaskStatus {
  Queued = 'Queued',
  Processing = 'Processing',
  Success = 'Success', 
  Failed = 'Failed',
  Unknown = 'Unknown'
}

Status Meanings:

Status	Description
Queued	The proof generation request is in the queue waiting for available prover resources
Processing	The prover is actively generating zero-knowledge proofs for pending operations
Success	All pending operations have been successfully proven and are ready for verification
Failed	Proof generation encountered errors and requires attention or retry
Unknown	Status cannot be determined, possibly due to system unavailability

tip

• Failed status → use proverRetry()
• Processing operations may take several minutes

Example

import { ZkDatabase } from 'zkdb';

const zkdb = await ZkDatabase.connect({
  userName: "chiro-user",
  privateKey: "EKFTciRxyxshZjimay9sktsn7v5PvmC5zPq7q4JnitHUytxUVnFP",
  environment: "node",
  // This URL is for test environment
  url: "https://api.zkdatabase.org/graphql",
});

await zkdb.auth.signIn();

const dbTest = zkdb.db('zkdb_test');
const status = await dbTest.proverStatus();
console.log('Prover status:', status);

await zkdb.auth.signOut();

Result:

Prover status: "Success"