Skip to content
foc Filecoin Onchain Cloud Documentation

All versions since 0.7.0
All versions

0.7.0

Features

  • storage: implement smart provider selection to prefer existing relationships (8433899)

0.8.0

Features

  • return TransactionResponse objects from payment methods (23d1d9d)

Bug Fixes

  • storage: retry logic around proofset creation tx lookup (454c721)

Trivial Changes

0.8.1

Bug Fixes

  • addroots: report full padded piece size to contract to match Curio (277e015)

0.9.0

Features

  • pdp: add transaction tracking for root additions with server verification (00de2b2)

Trivial Changes

  • add conventional commits guidelines (bc68d04)

0.9.1

Trivial Changes

  • transactions: increase default wait confidence to 1 (f6e42cb)

0.10.0

Features

  • admin: expose addServiceProvider on PandoraService (0270e7b)

Trivial Changes

  • admin: remove pandora-admin html in preference of gh-pages branch (1708857)

0.11.0

Features

  • retriever: implement PieceRetriever pattern for flexible piece downloads (16d9a84)

Bug Fixes

  • retriever: use Promise.any instead of Promise.race for provider selection (c291821)

Trivial Changes

  • pdp: use extracted utility functions for url building (7e96345)

0.12.0

Features

  • cdn: add complete FilCDN retriever implementation (#106) (e2ff94b)

0.13.0

Features

  • enhance checkAllowanceForStorage with customizable lockup periods (52c3204)

Bug Fixes

  • correct depositAmountNeeded assignment in PandoraService (bdc1827)

Tests

  • add checks for depositAmountNeeded in PandoraService tests (e07ae2d)

0.14.0

Features

  • pdp: always validate and return CommP (CID) objects from server (d3b30da)

Trivial Changes

  • pdp: validate server responses (d2e135b)

0.15.0

Features

  • pdp: add ping method to check connectivity with SP (46a3223)

0.16.0

Features

  • pdp: implement ping validation for storage providers in selection process (#119) (12a5bf7)

0.16.1

0.17.0

Features

  • add provider info and storage info APIs (#124) (af8afb1)

0.18.0

Features

  • add SDK methods to fetch proofset roots and metadata (#111) (a6ec128)

0.19.0

Features

Trivial Changes

  • Update .github/workflows/add-issues-and-prs-to-fs-project-board.yml [skip ci] (579ef07)

0.19.1

Trivial Changes

  • add Claude Code GitHub Workflow [skip-ci] (#128) (3878254)

0.19.2

Bug Fixes

  • pdp: handle Curio’s “proofsetCreated” casing (#130) (594c4ae)

0.19.3

Trivial Changes

0.19.4

Trivial Changes

  • update docs for add-issues-and-prs-to-fs-project-board.yml (#133) (20ea7f3)

0.20.0

Features

  • doc: dual license as Apache 2.0 & MIT (#134) (5170b19)

0.20.1

Trivial Changes

1.0.0

⚠ BREAKING CHANGES

  • add pdpVerifierAddress option to SynapseOptions (#138)

Features

  • add pdpVerifierAddress option to SynapseOptions (#138) (d35b40d)

0.21.0

Features

  • add pdpVerifierAddress option to SynapseOptions (#138) (965592e)
  • reset versioning to continue 0.x development (ce58d21)

Trivial Changes

  • release: 1.0.0 [skip ci] (9d998b5), closes #138
  • reset version to 0.20.1 after accidental major release (1cfe165)

0.22.0

Features

  • add batching for parallel uploads (48b46b0)
  • upload batch size, add simple debounce for uploads (c54f36b)

0.23.0

Features

  • use Performance API, update docs with additional timing input (b4fe5f0)

Trivial Changes

  • add comprehensive performance and timing analysis documentation (d9eb5f1), closes #125

0.23.1

Trivial Changes

  • ci: delete Claude Code PR review workflow (#152) (ec26b4b)

0.23.2

Trivial Changes

  • deps: bump actions/checkout from 4 to 5 (#150) (efc8018)

0.24.0

Features

  • add synapse.storage and StorageContext (#153) (7485b84)
  • commp: transition to CommPv2 (c0c39a4)
  • commp: use “PieceCID” terminology, use v2 exclusively (81f9ea8)
  • commpv2: Curio CommPv2 compatibility (#156) (d529e0b)
  • EIP712 signing support for metadata in CreateDataSet and AddPices (#173) (f396e0d)
  • major rename - pandora->warm storage, proof sets->data sets, roots->pieces (6e1a743)
  • sp registry (e680f82)
  • utils: split client and provider functionality to make setup easier (66c9d02)
  • warmstorage: discover dependent contract addresses from WarmStorage (984966b)

Bug Fixes

  • ignore deleted providers when searching for retrieval options (#159) (2b8c427)
  • pdp: encode the metadata correctly in extraData (c4aea98)
  • pdp: isComplete on data set creation should include server status (#158) (5cf3dc1)
  • trim trailing slash from serviceURL (cf8be53)
  • warmstorage: adapt to view contract using extsload (f56f00e)

Trivial Changes

0.24.1

Trivial Changes

  • deps-dev: bump typescript from 5.8.3 to 5.9.2 (#193) (8892319)

0.24.2

Bug Fixes

  • pdp: select provider on ID, allow graceful fallback when no match (#195) (30d32af)

0.24.3

Trivial Changes

0.24.4

Trivial Changes

  • update testing setup and dependencies (#171) (eb3e590)

0.24.5

Trivial Changes

0.24.6

0.24.7

Trivial Changes

0.24.8

Trivial Changes

  • docs: initialize documentation site with Astro and Starlight (#180) (770efcb)

0.24.9

Trivial Changes

  • docs: add GitHub Pages deployment workflow and enable GitHub Pages in Astro config (#210) (4158abf)

0.24.10

Bug Fixes

  • select data set using providerId, not payee (#211) (6382e81)

Trivial Changes

  • no-release: fix docs (70d2c43)
  • no-release: fix docs base path (11ed22d)
  • no-release: fix docs index urls for github pages (d31669b)
  • no-release: github urls again (1c1aee5)
  • no-release: make docs run only on master (04a6f2b)

0.24.11

Trivial Changes

  • deps-dev: bump @biomejs/biome from 2.2.3 to 2.2.4 (#213) (d79ba37)
  • deps: bump actions/setup-node from 4 to 5 (#212) (32ec07a)

0.25.0

Features

Trivial Changes

  • deps-dev: bump type-fest from 4.41.0 to 5.0.0 (#217) (d3a3608)
  • no-release: disable eslint and prettier in VSCode settings (#214) (0631dbf)

0.25.1

Bug Fixes

0.26.0

Features

  • add mainnet address, add —network flag to sp-tool (#231) (d0b5242)

0.27.0

Features

  • allow custom metadata for data sets & roots (fe41931), closes #201
  • expose metadata as Record<string,string>; check constraints (68ed29b)
  • match data set for auto-selection based on all metadata (unordered) (50eb97a)

Bug Fixes

  • exact match of metadata, ignoring order, when selecting data set to reuse (5f80a64)
  • pass metadata to context create, match cached contexts on metadata (967f272)

0.29.0

Features

Bug Fixes

Chores

  • ci: switch from semantic-release to release-please (#233) (9f84cc6)

0.29.1

Bug Fixes

  • import constants (#246) (53e0c97)
  • resolve data sets in getClientDataSetsWithDetails without rail indirection (#235) (d0e8fb9)

0.29.2

Bug Fixes

  • clean up synapse-sdk readme (8a7f949)

0.29.3

Bug Fixes

  • update package.json paths to use ‘dist/src’ directory (625b269)

0.30.0

Features

Bug Fixes

  • generate-abi from correct contracts git tag (#279) (742c041)

Chores

  • update mock service worker package version to 2.10.5 (e201a48)

0.30.1

Bug Fixes

  • more careful checks for EIP-1193 provider (#290) (bfeee48)

0.31.0

Features

  • sp-tool: add full PDP offering updates and capabilities (#294) (e71fb8c)

0.31.1

Bug Fixes

  • resolves bug of using client address instead of signer for datsetId lookup (7320c2b)
  • Use clientAddress for next dataset ID (#299) (7320c2b)

0.32.0

Features

0.33.0

Features

  • getSizeFromPieceCID(cid) to extract size from PieceCIDv2 (#283) (5fac7a6)
  • PDPServer#getPieceStatus(pieceCid) (#315) (fb45df4)

Bug Fixes

  • multi-uploads, smarter batching, handle multiple files in example (#301) (3d41d21)
  • use providerId or providerAddress if provided with forceCreateDataSet (#314) (9d717d3)

0.34.0

Features

  • allowing deposits to secondary addresses (4629f1f)
  • deposit to any address (#316) (4629f1f)

Bug Fixes

  • getPDPService always returns a pdpOffering (#324) (42389da)

Chores

0.35.0

⚠ BREAKING CHANGES

  • create dataset and add pieces (#357)

Features

Bug Fixes

  • mocks: mock BatchJsonrpc errors with their request id (#338) (1167900)
  • resolves bug of using client address instead of signer for datsetId lookup (328ae43)
  • update lockup period from 10 to 30 days (34362fa)
  • use bigint in PDP auth, clientDataSetId now needs to be large (620b32e)

Chores

  • update ABIs for next contracts (6f1ebda)
  • update for M3 contracts (52f841c)
  • update for M3 contracts (52f841c)
  • update to M3 calibnet contracts in next-branch (#319) (52f841c)
  • v0.35.0-dev.1 (next) (1e43029)

0.35.1

Features

Bug Fixes

  • get pieces from contract instead of pdpServer (#249) (dc4aac2)
  • timing: increase transaction propagation timeout to 180s (#370) (63e749f), closes #359

0.35.2

Bug Fixes

  • core abis in sdk (#372) (2b70909)
  • sp-registry: no double-lookup to get provider by address (#367) (efd3dc2)
  • storage: forward the isApproved and use that in storage info (#377) (fa9d4cf)

Chores

  • convert fwss tests to jsonrpc mocks (#384) (947c25e)
  • deps-dev: bump @biomejs/biome from 2.2.7 to 2.3.1 (#352) (ed8cee6)
  • telemetry fixups based off learnings from filecoin-pin integration (#378) (e607834)

0.35.3

Features

Bug Fixes

  • default dev to false in selectProviderWithPing (a5c428c)
  • maxLockupPeriod should be a bigint (#383) (2fdf629)
  • normalize telemetry http call wrapping (#398) (c9a2f95)
  • remove debug logs from provider filtering (#395) (f86e085)
  • use serviceStatus=dev for dev provider filtering (#376) (a5c428c)

Chores

  • simplify linting and make sure git hook works (#394) (ee8a83d)
  • update Sentry DSN in telemetry service (#399) (44af935)

0.36.0

⚠ BREAKING CHANGES

  • revert golden path upload() API + minor fixes (#446)

Features

  • streaming upload support (9510752)

Bug Fixes

  • error outputs out of lotus are weird (#411) (341eeff)
  • revert golden path upload() API + minor fixes (#446) (12d11e9)

Chores

0.36.1

Bug Fixes

Chores

  • deps-dev: bump @biomejs/biome from 2.3.5 to 2.3.6 (#448) (ebcab4e)
  • deps-dev: bump @biomejs/biome from 2.3.6 to 2.3.7 (#459) (d3c65a8)
  • deps-dev: bump @biomejs/biome from 2.3.7 to 2.3.8 (#476) (d95f812)
  • export StorageManagerUploadOptions (#462) (c5897f2)

0.37.0 Latest

⚠ BREAKING CHANGES

  • change to only export Synapse from the main entrypoint

Features

  • Add API for querying remaining egress (#430) (c40d6b8)
  • change to only export Synapse from the main entrypoint (4c0cc47), closes #232
  • move ethers to peer dependencies (242a2c1)
  • storage: rename “pieces” callbacks, add piece info & dataSetId (#439) (f1bd585)

Bug Fixes

  • cache clientDataSetId in StorageContext (#489) (ec1345a)
  • createStorageContext without getClientDataSetsWithDetails (#438) (76e2439)
  • expose getScheduledRemovals on storageContext (#490) (6a3b5cc)
  • remove settlement fee (#502) (8c7537e), closes #243
  • treat status code 202 for findPiece as a retry (6b9e03f)
  • warm-storage: check metadata withCDN key in addition to cdnRailId for CDN status (#505) (db234e5)

Chores