feat!: remove piece metadata getters

[hugomrdias]

Summary

• Remove FWSS piece metadata getter APIs and related types
• Update SDK, core, React hooks, CLI, mocks, and generated ABI handling
• Document reading piece metadata from PieceAdded events or an indexer
• Update the Synapse React example for pieces without on-chain metadata

Follow-up required

• Once the new filecoin-services commit is available, update FILECOIN_SERVICES_GIT_REF in packages/synapse-core/wagmi.config.ts and run pnpm --dir packages/synapse-core run generate-abi.

Testing

• pnpm test
• pnpm run build
• pnpm --dir examples/cli run lint
• pnpm run check:markdown
• pnpm --dir docs exec astro build

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	synapse-dev	a6b66bd	Commit Preview URL Branch Preview URL	Aug 26 2026, 11:47 AM

[Kubuxu]

Once the new filecoin-services commit is available, update FILECOIN_SERVICES_GIT_REF in packages/synapse-core/wagmi.config.ts and run pnpm --dir packages/synapse-core run generate-abi.

This is the commit: FilOzone/filecoin-services@4cbbea4

it would be done by automated workflow but the job fails due to the metadata

[SgtPooki]

LGTM, but fix PR title and comment message cause this is a breaking change.

Also some merge conflicts.

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/@filoz/synapse-core@936

npm i https://pkg.pr.new/@filoz/synapse-react@936

npm i https://pkg.pr.new/@filoz/synapse-sdk@936

commit: a6b66bd