PDPServer

Defined in: packages/synapse-sdk/src/pdp/server.ts:164

Constructors

Constructor

new PDPServer(options): PDPServer;

Defined in: packages/synapse-sdk/src/pdp/server.ts:181

Create a new PDPServer instance

Parameters

Parameter	Type	Description
`options`	`OptionsType`	PDPServer.OptionsType

Returns

PDPServer

Methods

addPieces()

addPieces(
   dataSetId,
   clientDataSetId,
pieces): Promise<AddPiecesResponse>;

Defined in: packages/synapse-sdk/src/pdp/server.ts:253

Add pieces to an existing data set

Parameters

Parameter	Type	Description
`dataSetId`	`number`	The ID of the data set to add pieces to
`clientDataSetId`	`bigint`	The client’s dataset ID used when creating the data set
`pieces`	`PieceInputWithMetadata`[]	Array of piece data containing PieceCID CIDs and raw sizes

Returns

Promise<AddPiecesResponse>

Promise that resolves when the pieces are added (201 Created)

Throws

Error if any CID is invalid

createAndAddPieces()

createAndAddPieces(
   clientDataSetId,
   payee,
   payer,
   recordKeeper,
   pieces,
metadata): Promise<CreateDataSetResponse>;

Defined in: packages/synapse-sdk/src/pdp/server.ts:225

Creates a data set and adds pieces to it in a combined operation. Users can poll the status of the operation using the returned data set status URL. After which the user can use the returned transaction hash and data set ID to check the status of the piece addition.

Parameters

Parameter	Type	Description
`clientDataSetId`	`bigint`	Unique ID for the client’s dataset
`payee`	`0x${string}`	Address that will receive payments (service provider)
`payer`	`0x${string}`	Address that will pay for the storage (client)
`recordKeeper`	`0x${string}`	Address of the Warm Storage contract
`pieces`	`PieceInputWithMetadata`[]	-
`metadata`	`MetadataObject`	Optional metadata for dataset and each of the pieces.

Returns

Promise<CreateDataSetResponse>

Promise that resolves with transaction hash and status URL

createDataSet()

createDataSet(
   clientDataSetId,
   payee,
   payer,
   metadata,
recordKeeper): Promise<CreateDataSetResponse>;

Defined in: packages/synapse-sdk/src/pdp/server.ts:195

Create a new data set on the PDP server

Parameters

Parameter	Type	Description
`clientDataSetId`	`bigint`	Unique ID for the client’s dataset
`payee`	`0x${string}`	Address that will receive payments (service provider)
`payer`	`0x${string}`	Address that will pay for the storage (client)
`metadata`	`MetadataObject`	Metadata entries for the data set (key-value pairs)
`recordKeeper`	`0x${string}`	Address of the Warm Storage contract

Returns

Promise<CreateDataSetResponse>

Promise that resolves with transaction hash and status URL

getDataSet()

getDataSet(dataSetId): Promise<DataSetData>;

Defined in: packages/synapse-sdk/src/pdp/server.ts:323

Get data set details from the PDP server

Parameters

Parameter	Type	Description
`dataSetId`	`number`	The ID of the data set to fetch

Returns

Promise<DataSetData>

Promise that resolves with data set data

uploadPiece()

uploadPiece(data, options?): Promise<UploadPieceResponse>;

Defined in: packages/synapse-sdk/src/pdp/server.ts:282

Upload a piece to the PDP server using the commp-last protocol.

Accepts data as Uint8Array, AsyncIterable, or ReadableStream. For optimal performance with non-trivial sizes, prefer streaming types (AsyncIterable or ReadableStream) to avoid memory pressure and blocking behavior. See SIZE_CONSTANTS.MAX_UPLOAD_SIZE documentation for detailed guidance.

Parameters

Parameter	Type	Description
`data`	\| `Uint8Array`<`ArrayBufferLike`> \| `AsyncIterable`<`Uint8Array`<`ArrayBufferLike`>, `any`, `any`> \| `ReadableStream`<`Uint8Array`<`ArrayBufferLike`>>	The data to upload (Uint8Array, AsyncIterable, or ReadableStream)
`options?`	`UploadPieceOptions`	Optional upload options

Returns

Promise<UploadPieceResponse>