v0.18.0

0.18.0 (2026-03-10)

This release introduces multi-copy storage for data durability. Uploads now automatically store 2 copies of your data across independent Filecoin storage providers. Each copy is independently proven on-chain, so a single provider failure doesn't result in data loss. The number of copies can be controlled with --count, and you only upload your data once regardless of copy count.

Also fixes --mainnet support across the CLI, a terminate command for dataset lifecycle management, and local devnet support for development.

Features

• multi-copy storage: uploads now create 2 independently-proven copies across different storage providers by default for data durability (synapse-sdk 0.38, synapse-core 0.2) (#343) (9a87038)
• provider selection: target specific providers with --provider-ids or specific data sets with --data-set-ids, and control copy count with --count (#343)
• add terminate command to terminate a dataset (#307) (50179c2)
• add devnet network support and --skip-ipni-verification flag (#354) (f4eb4fc)

Bug Fixes

• support mainnet CLI network and payment guidance (#353) (3e4e330)

Chores

• deps-dev: bump @biomejs/biome from 2.4.4 to 2.4.5 (#346) (43fd0ce)

v0.17.0

0.17.0 (2026-02-23)

Features

• rm: add --all option to remove all pieces from DataSet (#320) (b27050c)

Bug Fixes

• executeUpload and uploadToSynapse to use abortSignals (#332) (060257e)

Chores

• deps-dev: bump @biomejs/biome from 2.3.14 to 2.3.15 (#331) (6cb403e)
• deps-dev: bump @biomejs/biome from 2.3.15 to 2.4.2 (#336) (2119892)
• deps-dev: bump @biomejs/biome from 2.4.2 to 2.4.3 (#337) (a4b3730)
• deps-dev: bump @biomejs/biome from 2.4.3 to 2.4.4 (#338) (5926600)

v0.16.0

0.16.0 (2026-02-07)

Features

• add --data-set and --new-data-set flags to add command (#296) (e03719b)
• add provider command with info and ping subcommands (#295) (c52ebbf)

Bug Fixes

• use namespace import for Sentry SDK v8+ ESM compatibility (#319) (320a461)

Chores

• deps-dev: bump @biomejs/biome from 2.3.13 to 2.3.14 (#318) (97f6f1b)
• deps: bump @clack/prompts from 0.11.0 to 1.0.0 (#315) (63b34e0)

v0.15.1

0.15.1 (2026-01-29)

Bug Fixes

• mainnet flag consideration in payments setup (#311) (e74f504)
• pass callbacks to synapse-sdk properly (#316) (be6f3e8)

Chores

• deps-dev: bump @biomejs/biome from 2.3.11 to 2.3.13 (#312) (8c1db16)

v0.15.0

0.15.0 (2026-01-16)

Features

• add filecoin pay funding planner (#286) (f22a6c6)
• allow read-only operations with wallet addr (#284) (167c148)

Bug Fixes

• allow validation of descendent CIDs (#304) (57ada31)

Chores

• deps-dev: bump @biomejs/biome from 2.3.10 to 2.3.11 (#297) (049d750)
• deps-dev: bump @biomejs/biome from 2.3.8 to 2.3.10 (#294) (61eda02)
• deps-dev: bump @types/node from 24.10.3 to 25.0.0 (#289) (a320f51)
• deps: bump @helia/unixfs from 6.0.4 to 7.0.0 (#301) (d74b6b5)

Documentation

• fix missing upload-action npm install step (#302) (81e5884)

v0.14.0

0.14.0 (2025-12-08)

Features

• align main exports across node and browser (#259) (70dd804)

Bug Fixes

• add shared guard to prevent zero pricing (#237) (7e87f4c)
• createStorageContext does not require logger (#267) (8b88561)
• intializeSynapse extends synapse.create options (#242) (5d1ca39)
• pad rawSize for payment calculations (#251) (4b2b28f)
• payment status storage is accurate (#276) (d1ac3d3)
• pieces can be removed from a data-set (#253) (c557d95)
• remove npm cache from docs workflow (no lockfile) (#266) (5c1b0cb)
• update upload-action deps (#265) (5dd4954)
• use StorageManager for upload (#262) (1ed5283)

Chores

• deps-dev: bump @biomejs/biome from 2.3.4 to 2.3.7 (#261) (565e126)
• deps-dev: bump @biomejs/biome from 2.3.7 to 2.3.8 (#274) (981a7ab)
• deps: bump @octokit/request-error and @actions/artifact (#225) (beec41b)
• deps: bump actions/checkout from 5 to 6 (#255) (bc15ef8)
• deps: bump actions/checkout from 5 to 6 (#272) (0e1ce5b)
• deps: bump actions/github-script from 7 to 8 (#177) (d724718)
• deps: bump actions/upload-pages-artifact from 3 to 4 (#271) (b8e98dc)

Documentation

• fix wrong service providers URL (#270) (2a16a47)
• generate api docs and publish to gh pages (#260) (46d0cf7)

v0.13.0

0.13.0 (2025-11-14)

Features

• add --network flag for mainnet and calibration network selection (#240) (ced63da)
• allow passing metadata via cli commands (#226) (f5a1e6e)

Bug Fixes

• correct Filfox explorer URL format for mainnet and use dynamic network in PDP URLs (#239) (ff610e6)
• ipni indexer fetch errors are caught (#241) (996af92)
• network option works (#243) (40c400b)

Documentation

• add glossary, add explainer, and content routing FAQ (#233) (65f13b0)

v0.12.0

0.12.0 (2025-11-13)

Features

• add core/data-set methods (#210) (6d81508)
• data-set CLI uses filecoin-pin/core/data-set (#211) (443e285)
• deposit with permit integration (#202) (121e342)
• perform update checks (#219) (d27e6e6)

Bug Fixes

• add/import validate capacity with floor pricing (#218) (70e780f)
• filecoin-pin/upload-action always builds filecoin-pin (#204) (ecfb9e0)
• IPNI validation confirms provider in indexer response (#231) (71f157d)
• piece metadata is displayed as is (#222) (00e7ff9)
• refresh payments status CLI output (#223) (13f557e)
• remove known-good-providers recommendation in examples (#214) (f46eab4)
• upload-action pr comment uses consistent spacing (#206) (39a03c0)

Chores

• add dataset alias for 'data-set' subcommand (#224) (391cd79)
• deps-dev: bump @biomejs/biome from 2.3.3 to 2.3.4 (#212) (4edab90)

v0.11.1

0.11.1 (2025-11-04)

Chores

• deps-dev: bump @biomejs/biome from 2.2.7 to 2.3.3 (#198) (2e6a20e)
• update to synapse-sdk-v0.35.3 (#203) (6a24f00)

v0.11.0

0.11.0 (2025-11-03)

⚠️ Breaking Functionality

With the update to synpase 0.35.x, filecoin-pin is now using a new set of Filecoin Onchain Cloud contracts. DataSets created previously are no longer accessible through this release of filecoin-pin.

Features

• add more details to upload-flow (#169) (9ab3f8c)
• use synapse-sdk telemetry (#154) (15c00ee)

Bug Fixes

• add signer support to initializeSynapse (#172) (1d5988a)
• check ipni advertisement during upload (#183) (b020a42)
• ci: handle duplicate items in add-to-project workflow (#184) (0e80256)
• gh-action lints and typechecks on core changes (#170) (107a023)
• move gh-action logic to filecoin-pin/core (#143) (ef6adc1)
• only typecheck upload-action in CI for now (#196) (27e507c)
• properly silence logging for CLI (#195) (d25734d)
• upload-flow renders correct spacing and IPNI info (#191) (9a7a484)

Chores

• improve telemetry docs/collecting (#192) (ff8e07c)
• move to the version of synapse-sdk on next branch (#146) (528c6fa)

Documentation

• link to more examples (#181) (849b333)