Skip to content

Commit ae0eea9

Browse files
committed
feat(storage): extract provider selection to synapse-core and update docs for multi-copy
Move provider selection logic (selectProviders, fetchProviderSelectionInput, findMatchingDataSets) from SDK internals to synapse-core as public API for DIY users. Simplify selection from 4-tier fallback to 2-tier preference (existing dataset -> new dataset) since endorsedIds already controls the eligible pool. Clean up createContexts() to three explicit paths (dataSetIds, providerIds, smartSelect) with count validation and duplicate-provider guard. Update storage docs to reflect multi-copy as the default upload path.
1 parent cf6babd commit ae0eea9

26 files changed

Lines changed: 1855 additions & 869 deletions

docs/src/content/docs/developer-guides/components.mdx

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -81,19 +81,19 @@ Check out the [Payment Operations](/developer-guides/payments/payment-operations
8181

8282
### StorageManager
8383

84-
**Purpose**: High-level, auto-managed storage operations - upload and download data to and from the Filecoin Onchain Cloud.
84+
**Purpose**: High-level storage operations with multi-copy durability. `upload()` stores data on multiple providers automatically. Also handles provider-agnostic downloads.
8585

8686
**API Reference**: [StorageManager API Reference](/reference/filoz/synapse-sdk/storage/classes/storagemanager/)
8787

8888
Check out the [Storage Operations](/developer-guides/storage/storage-operations/) guide for more details.
8989

9090
### StorageContext
9191

92-
**Purpose**: Provider-specific storage operations - upload and download data to and from the Filecoin Onchain Cloud.
92+
**Purpose**: Provider-specific split operations (`store``pull``commit`). Used for batch uploads, custom error handling, and manual orchestration of multi-copy flows.
9393

9494
**API Reference**: [StorageContext API Reference](/reference/filoz/synapse-sdk/storage/classes/storagecontext/)
9595

96-
Check out the [Storage Context](/developer-guides/storage/storage-context/) guide for more details.
96+
Check out the [Split Operations](/developer-guides/storage/storage-context/) guide for more details.
9797

9898
### WarmStorageService
9999

@@ -162,8 +162,8 @@ Choose your learning path based on your immediate needs:
162162

163163
Jump straight to code with the [**Getting Started Guide →**](/getting-started/)
164164

165-
- [**Storage Operations →**](/developer-guides/storage/storage-operations/) - Upload and download your first file
166-
- [**Storage Context**](/developer-guides/storage/storage-context/) - Advanced storage operations and batch uploads
165+
- [**Storage Operations →**](/developer-guides/storage/storage-operations/) - Multi-copy uploads and downloads
166+
- [**Split Operations**](/developer-guides/storage/storage-context/) - Manual control over store, pull, and commit
167167
- [**Payment Operations →**](/developer-guides/payments/payment-operations/) - Fund your account and manage payments
168168
- [**Rails & Settlement →**](/developer-guides/payments/rails-settlement/) - Payment mechanics and settlement strategies
169169

0 commit comments

Comments
 (0)