PDPServer

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

Constructors

Constructor

new PDPServer(authHelper, serviceURL): PDPServer;

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

Create a new PDPServer instance

Parameters

Parameter	Type	Description
authHelper	null | PDPAuthHelper	PDPAuthHelper instance for signing operations
serviceURL	string	The PDP service URL (e.g., https://pdp.provider.com)

Returns

PDPServer

Methods

addPieces()

addPieces(
   dataSetId,
   clientDataSetId,
   nextPieceId,
   pieceDataArray,
metadata?): Promise<AddPiecesResponse>;

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

Add pieces to an existing data set

Parameters

Parameter	Type	Description
dataSetId	number	The ID of the data set to add pieces to
clientDataSetId	number	The client’s dataset ID used when creating the data set
nextPieceId	number	The ID to assign to the first piece being added, this should be the next available ID on chain or the signature will fail to be validated
pieceDataArray	| string[] | PieceLink[]	Array of piece data containing PieceCID CIDs and raw sizes
metadata?	MetadataEntry[][]	Optional metadata for each piece (array of arrays, one per piece)

Returns

Promise<AddPiecesResponse>

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

Throws

Error if any CID is invalid

Example

const pieceData = ['bafkzcibcd...']
const metadata = [[{ key: 'snapshotDate', value: '20250711' }]]
await pdpTool.addPieces(dataSetId, clientDataSetId, nextPieceId, pieceData, metadata)

---

createDataSet()

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

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

Create a new data set on the PDP server

Parameters

Parameter	Type	Description
clientDataSetId	number	Unique ID for the client’s dataset
payee	string	Address that will receive payments (service provider)
metadata	MetadataEntry[]	Metadata entries for the data set (key-value pairs)
recordKeeper	string	Address of the Warm Storage contract

Returns

Promise<CreateDataSetResponse>

Promise that resolves with transaction hash and status URL

---

downloadPiece()

downloadPiece(pieceCid): Promise<Uint8Array<ArrayBufferLike>>;

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

Download a piece from a service provider

Parameters

Parameter	Type	Description
pieceCid	string | PieceLink	The PieceCID CID of the piece

Returns

Promise<Uint8Array<ArrayBufferLike>>

The downloaded data

---

findPiece()

findPiece(pieceCid): Promise<FindPieceResponse>;

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

Find a piece by PieceCID and size

Parameters

Parameter	Type	Description
pieceCid	string | PieceLink	The PieceCID CID (as string or PieceCID object)

Returns

Promise<FindPieceResponse>

Piece information if found

---

getAuthHelper()

getAuthHelper(): PDPAuthHelper;

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

Returns

PDPAuthHelper

---

getDataSet()

getDataSet(dataSetId): Promise<DataSetData>;

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

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

---

getDataSetCreationStatus()

getDataSetCreationStatus(txHash): Promise<DataSetCreationStatusResponse>;

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

Check the status of a data set creation

Parameters

Parameter	Type	Description
txHash	string	Transaction hash from createDataSet

Returns

Promise<DataSetCreationStatusResponse>

Promise that resolves with the creation status

---

getPieceAdditionStatus()

getPieceAdditionStatus(dataSetId, txHash): Promise<PieceAdditionStatusResponse>;

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

Check the status of a piece addition transaction

Parameters

Parameter	Type	Description
dataSetId	number	The data set ID
txHash	string	Transaction hash from addPieces

Returns

Promise<PieceAdditionStatusResponse>

Promise that resolves with the addition status

---

getServiceURL()

getServiceURL(): string;

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

Get the service URL for this PDPServer instance

Returns

string

The service URL

---

ping()

ping(): Promise<void>;

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

Ping the service provider to check connectivity

Returns

Promise<void>

Promise that resolves if provider is reachable (200 response)

Throws

Error if provider is not reachable or returns non-200 status

---

uploadPiece()

uploadPiece(data): Promise<UploadResponse>;

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

Upload a piece to the PDP server

Parameters

Parameter	Type	Description
data	| ArrayBuffer | Uint8Array<ArrayBufferLike>	The data to upload

Returns

Promise<UploadResponse>

Upload response with PieceCID and size