# UploadCallbacks

Defined in: [packages/synapse-sdk/src/types.ts:390](https://github.com/FilOzone/synapse-sdk/blob/b11ef4f7e3c201d8bba29973a09628063e6547b1/packages/synapse-sdk/src/types.ts#L390)

## Extended by

- [`UploadOptions`](/reference/filoz/synapse-sdk/synapse/interfaces/uploadoptions/)

## Properties

### onCopyComplete()?

> `optional` **onCopyComplete**: (`providerId`, `pieceCid`) => `void`

Defined in: [packages/synapse-sdk/src/types.ts:400](https://github.com/FilOzone/synapse-sdk/blob/b11ef4f7e3c201d8bba29973a09628063e6547b1/packages/synapse-sdk/src/types.ts#L400)

Called when a secondary copy completes successfully

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `providerId` | `bigint` |
| `pieceCid` | `PieceLink` |

#### Returns

`void`

***

### onCopyFailed()?

> `optional` **onCopyFailed**: (`providerId`, `pieceCid`, `error`) => `void`

Defined in: [packages/synapse-sdk/src/types.ts:402](https://github.com/FilOzone/synapse-sdk/blob/b11ef4f7e3c201d8bba29973a09628063e6547b1/packages/synapse-sdk/src/types.ts#L402)

Called when a secondary copy fails

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `providerId` | `bigint` |
| `pieceCid` | `PieceLink` |
| `error` | [`Error`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Error) |

#### Returns

`void`

***

### onPiecesAdded()?

> `optional` **onPiecesAdded**: (`transaction`, `providerId`, `pieces`) => `void`

Defined in: [packages/synapse-sdk/src/types.ts:396](https://github.com/FilOzone/synapse-sdk/blob/b11ef4f7e3c201d8bba29973a09628063e6547b1/packages/synapse-sdk/src/types.ts#L396)

Called when the addPieces transaction has been submitted for a provider

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `transaction` | `` `0x${string}` `` |
| `providerId` | `bigint` |
| `pieces` | `object`[] |

#### Returns

`void`

***

### onPiecesConfirmed()?

> `optional` **onPiecesConfirmed**: (`dataSetId`, `providerId`, `pieces`) => `void`

Defined in: [packages/synapse-sdk/src/types.ts:398](https://github.com/FilOzone/synapse-sdk/blob/b11ef4f7e3c201d8bba29973a09628063e6547b1/packages/synapse-sdk/src/types.ts#L398)

Called when the addPieces transaction is confirmed on-chain for a provider

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `dataSetId` | `bigint` |
| `providerId` | `bigint` |
| `pieces` | [`PieceRecord`](/reference/filoz/synapse-sdk/synapse/interfaces/piecerecord/)[] |

#### Returns

`void`

***

### onProgress()?

> `optional` **onProgress**: (`bytesUploaded`) => `void`

Defined in: [packages/synapse-sdk/src/types.ts:392](https://github.com/FilOzone/synapse-sdk/blob/b11ef4f7e3c201d8bba29973a09628063e6547b1/packages/synapse-sdk/src/types.ts#L392)

Called periodically during upload with bytes uploaded so far

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `bytesUploaded` | `number` |

#### Returns

`void`

***

### onPullProgress()?

> `optional` **onPullProgress**: (`providerId`, `pieceCid`, `status`) => `void`

Defined in: [packages/synapse-sdk/src/types.ts:404](https://github.com/FilOzone/synapse-sdk/blob/b11ef4f7e3c201d8bba29973a09628063e6547b1/packages/synapse-sdk/src/types.ts#L404)

Called with pull status updates during SP-to-SP transfer

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `providerId` | `bigint` |
| `pieceCid` | `PieceLink` |
| `status` | [`PullStatus`](/reference/filoz/synapse-sdk/synapse/type-aliases/pullstatus/) |

#### Returns

`void`

***

### onStored()?

> `optional` **onStored**: (`providerId`, `pieceCid`) => `void`

Defined in: [packages/synapse-sdk/src/types.ts:394](https://github.com/FilOzone/synapse-sdk/blob/b11ef4f7e3c201d8bba29973a09628063e6547b1/packages/synapse-sdk/src/types.ts#L394)

Called when piece data has been stored on a provider (before on-chain commit)

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `providerId` | `bigint` |
| `pieceCid` | `PieceLink` |

#### Returns

`void`