Skip to content

ProviderSelectionOptions

Defined in: packages/synapse-core/src/warm-storage/location-types.ts:62

Options for selectProviders(). Combines pre-fetched chain data with selection parameters in a single argument.

clientDataSets: SelectionDataSet[]

Defined in: packages/synapse-core/src/warm-storage/location-types.ts:48

Client’s existing datasets with metadata and piece-presence information

ProviderSelectionInput.clientDataSets


optional count?: number

Defined in: packages/synapse-core/src/warm-storage/location-types.ts:64

Number of providers to select (default: 1)


endorsedIds: bigint[]

Defined in: packages/synapse-core/src/warm-storage/location-types.ts:46

Array of endorsed provider IDs (from endorsements.getProviderIds). Non-empty = restrict to endorsed only. Empty = use all providers.

ProviderSelectionInput.endorsedIds


optional excludeProviderIds?: bigint[]

Defined in: packages/synapse-core/src/warm-storage/location-types.ts:66

Provider IDs to exclude (for retry after ping failure or multi-copy exclusion)


optional legacyPieceStorageIdLimit?: bigint

Defined in: packages/synapse-core/src/warm-storage/location-types.ts:55

Data set ID boundary between legacy and compact piece storage (see FilecoinChain.legacyPieceStorageIdLimit). Data sets at or above this ID are compact and are preferred over legacy ones. Defaults to 0n (every data set treated as compact) when omitted.

ProviderSelectionInput.legacyPieceStorageIdLimit


optional metadata?: MetadataObject

Defined in: packages/synapse-core/src/warm-storage/location-types.ts:68

Desired metadata for dataset matching (empty object matches only empty-metadata datasets)


providers: PDPProvider[]

Defined in: packages/synapse-core/src/warm-storage/location-types.ts:43

Available PDP providers (typically from getApprovedPDPProviders)

ProviderSelectionInput.providers