# getClientNonce

> **getClientNonce**(`client`, `options`): [`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<`bigint`\>

Defined in: [packages/synapse-core/src/warm-storage/get-client-nonce.ts:67](https://github.com/FilOzone/synapse-sdk/blob/56f1ef3fb5ccfea19fb80cb59e997e381f37d85a/packages/synapse-core/src/warm-storage/get-client-nonce.ts#L67)

Read the raw value FWSS stores for a used replay-protection nonce.

Prefer [getAddPiecesResult](/reference/filoz/synapse-core/warm-storage/namespaces/getaddpiecesresult/toc/), [getCreateDataSetResult](/reference/filoz/synapse-core/warm-storage/namespaces/getcreatedatasetresult/toc/) or [getCreateDataSetAndAddPiecesResult](/reference/filoz/synapse-core/warm-storage/namespaces/getcreatedatasetandaddpiecesresult/toc/),
which decode it.

## Parameters

| Parameter | Type | Description |
| ------ | ------ | ------ |
| `client` | `Client`\<`Transport`, `Chain`\> | The client to use to read the nonce. |
| `options` | [`OptionsType`](/reference/filoz/synapse-core/warm-storage/namespaces/getclientnonce/type-aliases/optionstype/) | [getClientNonce.OptionsType](/reference/filoz/synapse-core/warm-storage/namespaces/getclientnonce/type-aliases/optionstype/) |

## Returns

[`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<`bigint`\>

The stored value [getClientNonce.OutputType](/reference/filoz/synapse-core/warm-storage/namespaces/getclientnonce/type-aliases/outputtype/)

## Throws

Errors [getClientNonce.ErrorType](/reference/filoz/synapse-core/warm-storage/namespaces/getclientnonce/type-aliases/errortype/)

## Example

```ts
import { getClientNonce } from '@filoz/synapse-core/warm-storage'
import { createPublicClient, http } from 'viem'
import { calibration } from '@filoz/synapse-core/chains'

const client = createPublicClient({
  chain: calibration,
  transport: http(),
})

const value = await getClientNonce(client, {
  payer: '0x0000000000000000000000000000000000000000',
  nonce: 1n,
})

console.log(value === 0n ? 'unused' : 'used')
```