StorageContext

Defined in: packages/synapse-sdk/src/storage/context.ts:62

Constructors

Constructor

new StorageContext(
   synapse,
   warmStorageService,
   provider,
   dataSetId,
   options,
   dataSetMetadata): StorageContext;

Defined in: packages/synapse-sdk/src/storage/context.ts:142

Parameters

Parameter	Type
`synapse`	`Synapse`
`warmStorageService`	`WarmStorageService`
`provider`	`ProviderInfo`
`dataSetId`	`number`
`options`	`StorageServiceOptions`
`dataSetMetadata`	`Record`<`string`, `string`>

Returns

StorageContext

Properties

dataSetId

readonly dataSetId: number;

Defined in: packages/synapse-sdk/src/storage/context.ts:92

serviceProvider

readonly serviceProvider: string;

Defined in: packages/synapse-sdk/src/storage/context.ts:93

Accessors

dataSetMetadata

Get Signature

get dataSetMetadata(): Record<string, string>;

Defined in: packages/synapse-sdk/src/storage/context.ts:106

Returns

Record<string, string>

provider

Get Signature

get provider(): ProviderInfo;

Defined in: packages/synapse-sdk/src/storage/context.ts:101

Returns

ProviderInfo

withCDN

Get Signature

get withCDN(): boolean;

Defined in: packages/synapse-sdk/src/storage/context.ts:96

Returns

boolean

Methods

deletePiece()

deletePiece(piece): Promise<string>;

Defined in: packages/synapse-sdk/src/storage/context.ts:1439

Delete a piece with given CID from this data set

Parameters

Parameter	Type	Description
`piece`	\| `string` \| `number` \| `PieceLink`	The PieceCID identifier or a piece number to delete by pieceID

Returns

Promise<string>

Transaction hash of the delete operation

download()

download(pieceCid, options?): Promise<Uint8Array<ArrayBufferLike>>;

Defined in: packages/synapse-sdk/src/storage/context.ts:1384

Download data from this specific service provider

Parameters

Parameter	Type	Description
`pieceCid`	`string` \| `PieceLink`	The PieceCID identifier
`options?`	`DownloadOptions`	Download options

Returns

Promise<Uint8Array<ArrayBufferLike>>

The downloaded data

getDataSetPieces()

getDataSetPieces(): Promise<PieceLink[]>;

Defined in: packages/synapse-sdk/src/storage/context.ts:1415

Get the list of piece CIDs for this service service’s data set by querying the PDP server.

Returns

Promise<PieceLink[]>

Array of piece CIDs as PieceCID objects

getProviderInfo()

getProviderInfo(): Promise<ProviderInfo>;

Defined in: packages/synapse-sdk/src/storage/context.ts:1407

Get information about the service provider used by this service

Returns

Promise<ProviderInfo>

Provider information including pricing (currently same for all providers)

hasPiece()

hasPiece(pieceCid): Promise<boolean>;

Defined in: packages/synapse-sdk/src/storage/context.ts:1451

Check if a piece exists on this service provider.

Parameters

Parameter	Type	Description
`pieceCid`	`string` \| `PieceLink`	The PieceCID (piece CID) to check

Returns

Promise<boolean>

True if the piece exists on this provider, false otherwise

pieceStatus()

pieceStatus(pieceCid): Promise<PieceStatus>;

Defined in: packages/synapse-sdk/src/storage/context.ts:1477

Check if a piece exists on this service provider and get its proof status. Also returns timing information about when the piece was last proven and when the next proof is due.

Note: Proofs are submitted for entire data sets, not individual pieces. The timing information returned reflects when the data set (containing this piece) was last proven and when the next proof is due.

Parameters

Parameter	Type	Description
`pieceCid`	`string` \| `PieceLink`	The PieceCID (piece CID) to check

Returns

Promise<PieceStatus>

Status information including existence, data set timing, and retrieval URL

preflightUpload()

preflightUpload(size): Promise<PreflightInfo>;

Defined in: packages/synapse-sdk/src/storage/context.ts:1016

Run preflight checks for an upload

Parameters

Parameter	Type	Description
`size`	`number`	The size of data to upload in bytes

Returns

Promise<PreflightInfo>

Preflight information including costs and allowances

providerDownload()

providerDownload(pieceCid, options?): Promise<Uint8Array<ArrayBufferLike>>;

Defined in: packages/synapse-sdk/src/storage/context.ts:1398

Download data from the service provider

Parameters

Parameter	Type
`pieceCid`	`string` \| `PieceLink`
`options?`	`DownloadOptions`

Returns

Promise<Uint8Array<ArrayBufferLike>>

terminate()

terminate(): Promise<TransactionResponse>;

Defined in: packages/synapse-sdk/src/storage/context.ts:1604

Terminates the data set by sending on-chain message. This will also result in the removal of all pieces in the data set.

Returns

Promise<TransactionResponse>

Transaction response

upload()

upload(data, options?): Promise<UploadResult>;

Defined in: packages/synapse-sdk/src/storage/context.ts:1036

Upload data to the service provider

Parameters

Parameter	Type
`data`	\| `ArrayBuffer` \| `Uint8Array`<`ArrayBufferLike`>
`options?`	`UploadOptions`

Returns

Promise<UploadResult>

create()

static create(
   synapse,
   warmStorageService,
options): Promise<StorageContext>;

Defined in: packages/synapse-sdk/src/storage/context.ts:252

Static factory method to create a StorageContext Handles provider selection and data set selection/creation

Parameters

Parameter	Type
`synapse`	`Synapse`
`warmStorageService`	`WarmStorageService`
`options`	`StorageServiceOptions`

Returns

Promise<StorageContext>

createContexts()

static createContexts(
   synapse,
   warmStorageService,
options): Promise<StorageContext[]>;

Defined in: packages/synapse-sdk/src/storage/context.ts:176

Parameters

Parameter	Type
`synapse`	`Synapse`
`warmStorageService`	`WarmStorageService`
`options`	`CreateContextsOptions`

Returns

Promise<StorageContext[]>

performPreflightCheck()

static performPreflightCheck(
   warmStorageService,
   paymentsService,
   size,
withCDN): Promise<PreflightInfo>;

Defined in: packages/synapse-sdk/src/storage/context.ts:983

Static method to perform preflight checks for an upload

Parameters

Parameter	Type	Description
`warmStorageService`	`WarmStorageService`	WarmStorageService instance
`paymentsService`	`PaymentsService`	PaymentsService instance
`size`	`number`	The size of data to upload in bytes
`withCDN`	`boolean`	Whether CDN is enabled

Returns

Promise<PreflightInfo>

Preflight check results without provider/dataSet specifics