# Prover API

**A Prover** is a participant that receives confirmed Cohort information from **the Manager** and provides it in a static form. **The Prover** can be an API or a decentralized static file system. Unlike the Manager API, the Prover API protocol must utilize precise implementations. External systems must appropriately call the API according to the Prover version to obtain Proof.

### Release Versions <a href="#release-versions" id="release-versions"></a>

* 1.0.0 Initial Prover API

## Supported Prover Protocol Version

#### GET /prover/config <a href="#get-prover-config" id="get-prover-config"></a>

* This endpoint provides the version of the protocol offered by this Prover path.

{% code lineNumbers="true" %}

```
//response
{
	"statusCode": 200,
	"data": {
		"major": 1,
		"minor": 0,
		"patch": 0
	},
	"message": "success"
}

```

{% endcode %}

## Rollup Information Provision

#### GET /cohort/{cohortId}/rollup/info.json

* /cohort/{cohortId}/rollup/infos
* Provides the current information that the Prover is aware of for a specific cohort.
* application/json

{% code lineNumbers="true" %}

```
// response
{
  "successCode": 200,
  "data": {
    // Latest Snapshot
    "current": {
      "cohortId" : 1,
      "nonce": 12,
      "merkleRoot" : "0xd0e15e9b115375b9725e57604121792e871db3128dc0c5683601d8288f755930",
      "signature":"0x99502d2cd9ea810a6a70f16374466fc45795d2c06f74e48....be8d1982ab130f9c257c73a1955479de6aeacd132133d3f861b"
      "snapshotTime": 1724151658,
      "totalCount": 0,
      "totalWeight": "0",
      "prover": "<https://api-cohort.silicon.network.dev.ozys.work>",
      "status": 0,
      "createdAt": 1724119258
    },
    
    "latestRollup": [ 
      {
        "cohortId": 11,
        "nonce": 0,
        "merkleRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
        "signature": "0x0000000000000000000000000000000000000000000000000000000000000000",
        "snapshotTime": 1724151658,
        "totalCount": 0,
        "totalWeight": "0",
        "prover": "<https://api-cohort.silicon.network.dev.ozys.work>",
        "status": 0,
        "createdAt": 1724119258
      }
    ]
  },
  "message": "success"
}

// fail response
// Responds in the same manner regardless of CohortId validation failure or other errors without error messages.
{
  "statusCode": error_code
}

```

{% endcode %}

## **Rollup Information Dump**

#### GET /cohort/{cohortId}/rollup/chunk/{n}.csv <a href="#get-cohort-cohortid-rollup-chunk-n00-.csv" id="get-cohort-cohortid-rollup-chunk-n00-.csv"></a>

* Provides the current information that the Prover is aware of for a specific cohort, in units of 100.
  * `/cohort/{cohortId}/rollup/chunk/0`: Provides Rollup information for nonce 0 to 99.
  * `/cohort/{cohortId}/rollup/chunk/1`: Provides Rollup information for nonce 100 to 199.
  * `/cohort/{cohortId}/rollup/chunk/100`: Provides Rollup information for nonce 10000 to 10099.<br>
* text/csv

{% code lineNumbers="true" %}

```
merkleRoot,singingTimestamp,signature,nonce
0x2222...8888,1718266000,0x9952...,0
0x3333...7777,1718266010,0x9953...,1
0x4444...6666,1718266020,0x9954...,2

```

{% endcode %}

## **Snapshot Basic Information Provision**

#### GET /prover/{0xMerkleRootHash}/member/count <a href="#get-prover-0xmerkleroothash-member-count" id="get-prover-0xmerkleroothash-member-count"></a>

* Provides the current information that the Prover is aware of for a specific cohort.

{% code lineNumbers="true" %}

```
// response
{
  "statusCode": 200,
  "data": {
    "merkleRoot": "0x8d6e8e9749e227c6fa9e06b342df074e71ac3e9e859db776b72fd801ea078f83",
    "totalCount": 4,
    "totalWeight": "10"
  },

	"message": "success"
}

// fail response
{
  "statusCode": error_code
}

```

{% endcode %}

#### GET /prover/{0xMerkleRootHash}/member/chunk/{n} <a href="#get-prover-0xmerkleroothash-member-chunk-n" id="get-prover-0xmerkleroothash-member-chunk-n"></a>

* Provides the current information that the Prover is aware of for a specific cohort.
* Query members for a specific merkle root in units of 10000
  * `/prover/{0xMerkleRootHash}/chunk/0`: Provides information for index 0 to 9999.
  * `/prover/{0xMerkleRootHash}/chunk/1`: Provides information for index 10000 to 19999.
  * `/prover/{0xMerkleRootHash}/chunk/2`: Provides information for index 20000 to 29999.

{% code lineNumbers="true" %}

```
// response
{
  "statusCode": 200,
  "data": {
    "participants": [
      {
        "address": "0xe265082f598d288e0cbafc009e2dcd1193b2cef1",
        "weight": "4"
      },
      {
        "address": "0x4774ba6738c1c739811744f5b6f8e3631825a88d",
        "weight": "3"
      },
      {
        "address": "0x2d761c33fc8e4d4a42c1379b817b84060e04de54",
        "weight": "2"
      },
      {
        "address": "0x29524b9eab6e86afa6891c89db62e7eba959bbf4",
        "weight": "1"
      }, ... 
    ]
  }
}

// fail response
{
  "statusCode": error_code
}

```

{% endcode %}

#### GET /prover/{0xMerkleRootHash}/info.json

* Provides information for a specific snapshot.
* application/json

{% code lineNumbers="true" %}

```
// response
{
  "successCode": 200,
  "data": {
    "totalCount": 11,
    "totalWeight": "72"
  }
}

// fail response
// Responds in the same manner regardless of merkleRootHash validation failure or other errors without error messages.
{
  "successCode":500
  "message": "internal_server_error"
}
```

{% endcode %}

## Snapshot Proof Information Dump

#### GET /prover/{0xMerkleRootHash}/chunk/{n}.csv

* Provides all associated addresses and information that can prove the merkleRootHash for a specific snapshot. Provided in units of 10000.
  * `/prover/{0xMerkleRootHash}/chunk/0.csv`: Provides information for index 1 to 10000.
  * `/prover/{0xMerkleRootHash}/chunk/1.csv`: Provides information for index 10001 to 20000.
  * `/prover/{0xMerkleRootHash}/chunk/2.csv`: Provides information for index 20001 to 30000.<br>
* text/csv

{% code lineNumbers="true" %}

```
index,address,weight
1,0xc6a2ad8cc6e4a7e08fc37cc5954be07d499e7654,0x445435
2,0x2f3713f388bc4b8b364a7a2d8d57c5ff4e054830,0x2454
3,0x662b67d00a13faf93254714dd601f5ed49ef2f51,0x1454
4,0xa323d7386b671e8799dca3582d6658fdcdcd940a,0x44
...

```

{% endcode %}

## **Snapshot Proof Information Retrieval**

#### GET /prover/{0xMerkleRootHash}/proof/{0xAddress}

* Provides the proof information for the requested address in the specified snapshot.
* application/json

{% code lineNumbers="true" %}

```
// response
{
  "statusCode": 200,
  "data": {
    "merkleRoot": "0x0000000000000006d5a671e01e395d007592733b7350b46496125d7d13e",
    "accountAddress": "0x000000000B1c24066781dcf6D5a2E0a8e580D1bd",
    "index": "0",
    "weight": "11",
    "proofs": [
      "0x48d95521cdc425f30d203135600000000000020e7833945b6b932590fe1d2b47",
      "0x775ba10acf69f4c46f9c4d06a000000000000dc3fa2e9179fd92dbe1d1755732",
      "0x2537ad083a72a378000000000000000000000fcdc6644b4eb70fa4707148e043",
      "0xbd53d4a35056a7fb1e031e2cbdac1e3a0d00000000000000629669c5a34bf6162"
    ]
  }
  
// fail response
{
  "statusCode": 500,
  "message": error_message
}
```

{% endcode %}

## **Identity-EOA Mapping Signature Information Retrieval**

#### GET /identity/signature/{signer}/{0xIdentity}

* Provides the proof information for the requested address in the specified snapshot.
* application/json

{% code lineNumbers="true" %}

```
{
  "successCode": 200,
  "data":{
    "signature":"0xd0e15e9b115375b9725e57604121792e871db3128dc0c5683601d8288f75593099f80a49c04a10a3158e13edf16c9f87f5e1cab776e930f036f6f00d2e2c4d401b"	
  }
}

// fail response
{
  "statusCode": error_code,
  "message": error_message
}
```

{% endcode %}

## **Identity-EOA Mapping Signature Information Dump**

#### GGET /identity/chunk/{signer}/{n}.csv

* Provides EOA mappings for all identities related to a specific cohort. Provided in units of 10000.
  * `/identity/{signer}/chunk/0.csv`: Provides the first mapping from 1 to 10000.
  * `/identity/{signer}/chunk/1.csv`: Provides mapping information from 10001 to 20000.
  * `/identity/{signer}/chunk/2.csv`: Provides mapping information from 20001 to 30000.<br>
* text/csv

{% code lineNumbers="true" %}

```
identity,address,signature
0x0000000000000000000000000000000000000400,0xc6a2ad8cc6e4a7e08fc37cc5954be07d499e7654,0xd0e15e9b115375b9725e57604121792e871db3128dc0c...b776e930f036f6f00d2e2c4d401b
0x0000000000000000000000000000000000000500,0x2f3713f388bc4b8b364a7a2d8d57c5ff4e054830,0x93099f80a49c040a49a10a3158e13edf3128dc9f87f5e1cab...d0e0c5683601d8288f755d1b
0x0000000000000000000000000000000000000600,0x662b67d00a13faf93254714dd601f5ed49ef2f51,0x792e810a3158e13edf8e13edf16c7f5e1cab77...115375b9725e576041213099f80a49c041c
0x0000000000000000000000000000000000000700,0xa323d7386b671e8799dca3582d6658fdcdcd940a,0x31f87f5e1cab776e930f...3158e513edf16c9d0e15e9b115375b9725e57604121792e871d1b
...

```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.silicon.network/builders/opencohort/framework/developer/protocol/prover-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.