> ## Documentation Index
> Fetch the complete documentation index at: https://primev-24-evan-kim2028-patch-1.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Commitments

Commitments represent promises made by providers in a cryptographically verifiable manner.

| Key                         | Description                                                           |
| --------------------------- | --------------------------------------------------------------------- |
| `commitmentDigest`          | Represents the hash of the bid structure, including the bid signature |
| `commitmentSignature`       | Represents an ECDSA signature of the `commitmentDigest`               |
| `commitmentProviderAddress` | Represents the address of the provider                                |
| `sharedSecret`              | Represents the shared secret between the bidder and provider          |

```json Example commitment
{
   "result":{
      "txHash":"91a89B633194c0D86C539A1A5B14DCCacfD47094",
      "bidAmount":"2000",
      "blockNumber":"890200",
      "receivedBidDigest":"61634fad9081e1b23a00234a52a85386a91fc0fad3fb32d325891bdc4f8a52a9",
      "receivedBidSignature":"be99f499be5483665d569bd52fa8c4c9ed5c3bed2f94fb9949259bf640d8bd365b1d9a4b9ccb3ace86ffdcd1fdadc605b0f49b3adaf1c6a9ffea25585234664f1c",
      "decayStartTimestamp":"1716935571901",
      "decayEndTimestamp":"1716935572901",
      "nikePublicKey":"04c631d017981efdc0c319b475de36389a10ede86fbbc9adcf573844a858ce8ddcddb41306eb9c34ec4ee9bc0234f7e30684bf389142437166d407e47974d5cbf7",
      "commitmentDigest":"08a98d4c9d45f8431b46d99a23e6e8f82601ccf0773499d4e47bcd857cad92a6",
      "commitmentSignature":"cfc1e4e2ea9cc417027ed5846fa073c8e6031f70f91ffa9b92051b5b7738c0500d8fefb0fc189bce16004b3c0e1c4cfa41260968161adf8b55446ed5c40d1ac51b",
      "commitmentProviderAddress":"0x1234567890123456789012345678901234567890",
      "sharedSecret":"0x1234567890123456789012345678901234567890",
   }
}
```

The commitment consists of the details associated with the bid along with signatures made by the provider.

The provider generates a digest from the commitment, signs it with their private key, stores the digest and signature as an encrypted commitment on the mev-commit chain, and sends the commitment back to the originating bidder via the P2P network.

```json
{
   "result":{
      "commitment":"08a98d4c9d45f8431b46d99a23e6e8f82601ccf0773499d4e47bcd857cad92a6",
      "signature":"cfc1e4e2ea9cc417027ed5846fa073c8e6031f70f91ffa9b92051b5b7738c0500d8fefb0fc189bce16004b3c0e1c4cfa41260968161adf8b55446ed5c40d1ac51b",
   }
}
```