v0.20.0

0.20.0 (2026-03-31)

Features

• core,dx: contexts in executeUpload, provider targeting docs, pass 'source' option through (#373) (b307beb)

Chores

• deps: bump @libp2p/identify from 4.0.12 to 4.0.13 (#381) (b4cb693)
• deps: bump @libp2p/tcp from 11.0.12 to 11.0.13 (#378) (2e386d2)
• deps: bump @sentry/node from 10.43.0 to 10.44.0 (#377) (95d4386)
• deps: bump libp2p from 3.1.5 to 3.1.6 (#379) (f594bfe)
• deps: bump viem from 2.47.2 to 2.47.4 (#380) (1d4e59b)
• release 0.20.0 (baef391)

v0.19.0

NOTE An accidental v1.0.0 was tagged released to npm, this has since been deprecated and the latest dist-tag in npm now points to v0.19.0. We will continue in the pre-v1 series for the time being but are preparing a proper v1.x release very soon. See #187 for more details.

0.19.0 (2026-03-20)

⚠ BREAKING CHANGES

• compare IPNI providers as normalized URIs (#368)
• update to synapse-sdk@0.40.0 (#369)

Features

• update to synapse-sdk@0.40.0 (#369) (83da89d)

Bug Fixes

• compare IPNI providers as normalized URIs (#368) (7994400)
• use pnpm (#370) (6563a33)

Chores

• 7day dep update cooldown, use npm ci for stable install in action (#359) (56d5f69)
• deps: bump undici from 6.23.0 to 6.24.1 in /upload-action (#361) (ef7062f)
• docs: changelog tweak (#355) (751032f)

Documentation

• add a security policy (#358) (79a8a9a)

Full Changelog: v1.0.0...v0.19.0

v1.0.0

NOTE: This was an accidental release and has been replaced with v0.19.0 with the same set of changes. v1.0.0 has been deprecated in npm and the latest dist-tag now points to v0.19.0. See #187 for more information.

1.0.0 (2026-03-20)

⚠ BREAKING CHANGES

• compare IPNI providers as normalized URIs (#368)
• update to synapse-sdk@0.40.0 (#369)

Features

• update to synapse-sdk@0.40.0 (#369) (83da89d)

Bug Fixes

• compare IPNI providers as normalized URIs (#368) (7994400)
• use pnpm (#370) (6563a33)

Chores

• 7day dep update cooldown, use npm ci for stable install in action (#359) (56d5f69)
• deps: bump undici from 6.23.0 to 6.24.1 in /upload-action (#361) (ef7062f)
• docs: changelog tweak (#355) (751032f)

Documentation

• add a security policy (#358) (79a8a9a)

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)