Skip to content
foc Filecoin Onchain Cloud Documentation

ContextCreateContextsOptions

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

Options for creating multiple storage contexts via createContexts()

Extends BaseContextOptions with plural provider/dataset selection and count for multi-provider redundancy.

Provider targeting is mutually exclusive, use ONE of:

  • providerIds to target specific providers (SDK handles dataset resolution)
  • dataSetIds to target specific existing datasets
  • Neither, to let the SDK auto-select providers

Extends

Section titled “Extends”

Properties

Section titled “Properties”

callbacks?

Section titled “callbacks?”

optional callbacks?: StorageContextCallbacks

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

Callbacks for creation process

Inherited from

Section titled “Inherited from”

CreateContextsOptions.callbacks

copies?

Section titled “copies?”

optional copies?: number

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

Number of storage copies to create (optional, defaults to 2)

Inherited from

Section titled “Inherited from”

CreateContextsOptions.copies

dataSetIds?

Section titled “dataSetIds?”

optional dataSetIds?: bigint[]

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

Specific data set IDs to target. Each must be an active data set owned by the caller. Mutually exclusive with providerIds.

Use this only when resuming into a known data set from a prior operation. For first-time uploads to specific providers, use providerIds instead, the SDK handles data set creation automatically.

Inherited from

Section titled “Inherited from”

CreateContextsOptions.dataSetIds

excludeProviderIds?

Section titled “excludeProviderIds?”

optional excludeProviderIds?: bigint[]

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

Do not select any of these providers

Inherited from

Section titled “Inherited from”

CreateContextsOptions.excludeProviderIds

metadata?

Section titled “metadata?”

optional metadata?: Record<string, string>

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

Custom metadata for data sets (key-value pairs). Used to match existing data sets during provider selection.

Inherited from

Section titled “Inherited from”

CreateContextsOptions.metadata

providerIds?

Section titled “providerIds?”

optional providerIds?: bigint[]

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

Specific provider IDs to upload to. The SDK resolves or creates data sets on each provider automatically. Mutually exclusive with dataSetIds.

This is the recommended way to target specific providers. Do not call createContext() to resolve data sets first, pass provider IDs here and the SDK handles the rest.

Example

Section titled “Example”
await synapse.storage.upload(data, { providerIds: [4n, 9n] })

Inherited from

Section titled “Inherited from”

CreateContextsOptions.providerIds

synapse

Section titled “synapse”

synapse: Synapse

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

The Synapse instance

warmStorageService

Section titled “warmStorageService”

warmStorageService: WarmStorageService

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

The WarmStorageService instance

withCDN?

Section titled “withCDN?”

optional withCDN?: boolean

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

Whether to enable CDN services

Inherited from

Section titled “Inherited from”

CreateContextsOptions.withCDN