docs: update pricing for per-operation fees#820
Draft
nijoe1 wants to merge 1 commit into
Draft
Conversation
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
synapse-dev | 906a9e4 | Commit Preview URL Branch Preview URL |
Jun 03 2026, 08:45 AM |
Contributor
There was a problem hiding this comment.
Pull request overview
Updates Filecoin Onchain Cloud documentation to reflect the GA pricing model by separating recurring rates (storage + proving) from per-operation fees, and explaining how fees are funded via a lockup reserve.
Changes:
- Replaces the old minimum-floor model with explicit recurring rates (storage per TiB/month/copy + flat proving fee per data set/month).
- Documents small per-operation fees and introduces/clarifies the lockup reserve mechanics (including an explanatory “fees and lockup” section).
- Updates examples and cookbook guidance to align with the new pricing terminology and structure.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 6 comments.
| File | Description |
|---|---|
| docs/src/content/docs/introduction/about.mdx | Updates the About page pricing section and table to the new recurring rates + per-operation fee model. |
| docs/src/content/docs/developer-guides/storage/storage-costs.mdx | Reworks Storage Costs into recurring rates + one-time fees, adds lockup mechanics section, and updates examples/caveats. |
| docs/src/content/docs/cookbooks/payments-and-storage.mdx | Updates the cookbook pricing narrative/tables and adds fee + lockup + SDK-caveat guidance. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comment on lines
+67
to
+68
| | **Storage** | **$2.50/TiB/month/copy** (minimum 2 copies) | Redundant storage with continuous PDP verification. Empty data sets cost nothing, charges begin when the first piece is added. | | ||
| | **Proving Service** | **$0.024/data set/month** | Flat per-data-set fee for proof verification, added on top of the storage rate. | |
| | **Proving Service** | **$0.024/data set/month** | Flat per-data-set fee for proof verification, added on top of the storage rate. | | ||
| | **Add-on Retrieval (Filecoin Beam)** | **Up to $0.014/GiB egress** | Outbound data delivered via Filecoin Beam. Roughly half this when served from cache, up to the full rate on a cache miss. | | ||
|
|
||
| Beyond these recurring rates, each onchain operation (creating a data set, adding or removing pieces, terminating service) carries a small one-time fee paid to the storage provider to cover its gas. These fees are fractions of a cent and only matter at very high operation volumes. See [Storage Costs](/developer-guides/storage/storage-costs/) for the full breakdown. |
Comment on lines
+29
to
+30
| | **Proving Service** | $0.024/data set/month | Flat per-data-set fee, added on top of the storage rate. | | ||
| | **CDN egress** | up to $0.014/GiB downloaded | Optional, via Filecoin Beam. About half this when served from cache. | |
| ## Querying Upload Costs | ||
|
|
||
| :::caution[SDK pricing update in progress] | ||
| The per-operation fees and the additive proving fee above are live in the Warm Storage contract. The SDK cost APIs (`getUploadCosts()`, `prepare()`) are still being updated to surface them, tracked in [synapse-sdk#763](https://github.com/FilOzone/synapse-sdk/issues/763). Until that lands, the returned `rate` and `depositNeeded` values reflect the previous model and may not include every new fee. |
Comment on lines
+48
to
+50
| | **Storage** | $2.50/TiB/month per copy | Charged only while pieces exist. Empty data sets are free | | ||
| | **Proving Service** | $0.024/data set/month | Flat per-data-set fee, added on top of the storage rate | | ||
| | **CDN egress** | up to $0.014/GiB downloaded | Optional, via Filecoin Beam. About half this when served from cache | |
| These are fractions of a cent. They are drawn from a ~$0.10 lockup reserve held while the data set is active, not billed separately on each call. See [Storage Costs: How the fees and lockup work](/developer-guides/storage/storage-costs/#how-the-fees-and-lockup-work) for the mechanics. | ||
|
|
||
| :::caution[SDK pricing update in progress] | ||
| The per-operation fees and the additive proving fee are live in the Warm Storage contract, but the SDK cost APIs (`getUploadCosts()`, `prepare()`) are still being updated to surface them, tracked in [synapse-sdk#763](https://github.com/FilOzone/synapse-sdk/issues/763). Until that lands, returned `rate` and `depositNeeded` values reflect the previous model. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Updates the pricing docs to the new model: recurring storage and proving rates, small per-operation fees, and the fixed lockup reserve.
Touches the About page, the Storage Costs guide, and the Payments & Storage cookbook.
Closes #817