Skip to content

StorageServiceOptions

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

Options for creating or selecting a storage context

Used by StorageManager.createContext() and indirectly by StorageManager.upload() when auto-creating contexts. Allows specification of:

  • Provider selection (by ID or address)
  • Data set selection or creation
  • CDN enablement and metadata
  • Creation process callbacks
optional callbacks: StorageCreationCallbacks;

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

Callbacks for creation process


optional dataSetId: number;

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

Specific data set ID to use (optional)


optional dev: boolean;

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


optional excludeProviderIds: number[];

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

Do not select any of these providers


optional forceCreateDataSet: boolean;

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

Force creation of a new data set, even if a candidate exists


optional metadata: Record<string, string>;

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

Custom metadata for the data set (key-value pairs)


optional providerAddress: string;

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

Specific provider address to use (optional)


optional providerId: number;

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

Specific provider ID to use (optional)


optional uploadBatchSize: number;

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

Maximum number of uploads to process in a single batch (default: 32, minimum: 1)


optional withCDN: boolean;

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

Whether to enable CDN services


optional withIpni: boolean;

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