sp

Service Provider HTTP Operations

Example

import * as SP from '@filoz/synapse-core/sp'

Namespaces

Namespace	Description
addPieces	-
addPiecesApiRequest	-
createDataSet	-
createDataSetAndAddPieces	-
createDataSetAndAddPiecesApiRequest	-
createDataSetApiRequest	-
deletePiece	-
findPiece	-
getDataSet	-
pullPieces	-
pullPiecesApiRequest	-
schedulePieceDeletion	-
terminateService	-
terminateServiceApiRequest	-
upload	-
uploadPiece	-
uploadPieceStreaming	-
waitForAddPieces	-
waitForCreateDataSet	-
waitForCreateDataSetAddPieces	-
waitForPullPieces	-
waitForPullPiecesApiRequest	-
waitForTerminateService	-

Classes

Class	Description
AbortError	-
NetworkError	-
TimeoutError	-

Type Aliases

Type Alias	Description
AddPiecesOutput	-
AddPiecesPending	-
AddPiecesRejected	-
AddPiecesResponse	-
AddPiecesSuccess	-
BasePullPiecesOptions	Base options for pulling pieces.
CreateDataSetAndAddPiecesOptions	-
CreateDataSetPending	-
CreateDataSetRejected	-
CreateDataSetResponse	-
CreateDataSetSuccess	-
DataSet	Data set from the PDP API.
PullPieceInput	Input piece for a pull request with typed PieceCID.
PullToExistingDataSetOptions	Options for pulling pieces into an existing data set.
PullToNewDataSetOptions	Options for creating a new data set and pulling pieces into it.
TerminateServiceStatusPending	-
TerminateServiceStatusResponse	-
TerminateServiceStatusSuccess	-
UploadPieceStreamingData	-

Variables

Variable	Description
AddPiecesPendingSchema	-
AddPiecesRejectedSchema	-
AddPiecesSuccessSchema	-
CreateDataSetPendingSchema	Schema for the create data set pending response.
CreateDataSetRejectedSchema	Schema for the create data set rejected response.
CreateDataSetSuccessSchema	Schema for the create data set success response.
DataSetSchema	-
TerminateServiceStatusPendingSchema	Schema for the termination status while the provider’s transaction is pending. The hash is empty until the provider’s relay task sends the transaction.
TerminateServiceStatusSuccessSchema	Schema for the confirmed termination status. The hash may be empty when the service was already terminated on chain without a provider transaction.

Functions

Function	Description
addPieces	Add pieces to a data set
addPiecesApiRequest	Add pieces to a data set on the PDP API.
createDataSet	Create a data set
createDataSetAndAddPieces	Create a data set and add pieces to it
createDataSetAndAddPiecesApiRequest	Create a data set and add pieces to it on PDP API
createDataSetApiRequest	Create a data set on PDP API
deletePiece	Delete a piece from a data set on the PDP API.
findPiece	Find a piece on the PDP API.
getDataSet	Get a data set from the PDP API.
ping	Ping the PDP API.
pullPieces	Pull pieces from external storage providers into a data set.
pullPiecesApiRequest	Initiate a piece pull request or get status of an existing one.
schedulePieceDeletion	Schedule a piece deletion
terminateService	Terminate a data set service via the service provider
terminateServiceApiRequest	Request data set termination on the PDP API.
terminateServiceStatusUrl	Build the termination status URL for a data set, pollable with waitForTerminateService. Useful for resuming tracking of a previously requested termination.
upload	Upload multiple pieces to a data set on the PDP API.
uploadPiece	Upload a piece to the PDP API.
uploadPieceStreaming	Upload piece data using the 3-step CommP-last streaming protocol.
validateAddPiecesBatch	Validate the piece count for an addPieces (or createDataSetAndAddPieces) batch, failing early instead of reverting on-chain.
waitForAddPieces	Wait for the add pieces status.
waitForCreateDataSet	Wait for the data set creation status.
waitForCreateDataSetAddPieces	Wait for the data set creation status.
waitForPullPieces	Wait for pull pieces completion.
waitForPullPiecesApiRequest	Wait for pull pieces completion API request.
waitForTerminateService	Wait for the data set termination status.