UploadCallbacks

Defined in: packages/synapse-sdk/src/types.ts:489

Callbacks for upload operations

These callbacks provide visibility into the upload lifecycle:

• store → pull to secondaries → commit flow

Provider-scoped callbacks follow a consistent signature pattern: (providerId, pieceCid, …extra) for correlating events with both the provider and the specific piece.

Extended by

• UploadOptions

Properties

onCopyComplete()?

optional onCopyComplete: (providerId, pieceCid) => void

Defined in: packages/synapse-sdk/src/types.ts:500

Called when a copy to a secondary provider 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:503

Called when a copy to a secondary provider fails

Parameters

Parameter	Type
providerId	bigint
pieceCid	PieceLink
error	Error

Returns

void

---

onPieceAdded()?

optional onPieceAdded: (providerId, pieceCid) => void

Defined in: packages/synapse-sdk/src/types.ts:506

Called when the addPieces transaction has been submitted for a provider (before on-chain confirmation)

Parameters

Parameter	Type
providerId	bigint
pieceCid	PieceLink

Returns

void

---

onPieceConfirmed()?

optional onPieceConfirmed: (providerId, pieceCid, pieceId) => void

Defined in: packages/synapse-sdk/src/types.ts:509

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

Parameters

Parameter	Type
providerId	bigint
pieceCid	PieceLink
pieceId	bigint

Returns

void

---

onProgress()?

optional onProgress: (bytesUploaded) => void

Defined in: packages/synapse-sdk/src/types.ts:491

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:497

Called with progress updates during pull to secondary providers

Parameters

Parameter	Type
providerId	bigint
pieceCid	PieceLink
status	PullStatus

Returns

void

---

onStored()?

optional onStored: (providerId, pieceCid) => void

Defined in: packages/synapse-sdk/src/types.ts:494

Called after data is stored on a provider (uploaded but not yet committed on-chain)

Parameters

Parameter	Type
providerId	bigint
pieceCid	PieceLink

Returns

void