init: foc-devnet-info library in synapse-core

[redpanda-f]

Introduce: foc-devnet-info library

• Parses and produces synapse type Chain from DevnetInfo exported by foc-devnet
• e2e test uses this library now, as an example to interface with foc-devnet
• mocked tests to check for functionality

[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	ff67e43	Commit Preview URL Branch Preview URL	Feb 16 2026, 11:47 AM

[redpanda-f]

Things to fix (synced with @hugomrdias ) :

• Instead of returning ViemChain, we need to return Chain from synapse-sdk?
• Use synapse-core/mocks for JSON-RPC testing

[redpanda-f]

Did more debugging on this, this needs some more work, and a sister PR on the foc-devnet side as well.

[redpanda-f]

Works with latest foc-devnet:

Loading devnet info from: /Users/redpanda/.foc-devnet/state/latest/devnet-info.json
Devnet run: 20260211T1206_DitzyPip (started: 2026-02-11T06:43:31.713665+00:00)
Using user: USER_1 (0x47cc9101fd026fc112d7fadf6b3c9df5be7d4a8c)
SPs available: 1
No file paths provided, using default test file: /Users/redpanda/.foc-devnet/state/latest/devnet-info.json
=== Synapse SDK Storage E2E Example ===

Mode: FOC DevNet
Reading file...
  Reading file: /Users/redpanda/.foc-devnet/state/latest/devnet-info.json

--- Initializing Synapse SDK ---
RPC URL: http://localhost:5701/rpc/v1
Chain: FOC DevNet (ID: 31415926)
Warm Storage Address: 0x4A8a81765bFBe09D6fDd167EF954a1D3401340e5
Multicall3 Address: 0x2e1F1424b41ad7b2E34b0a60501edFc82FEf5BE8
USDFC Address: 0xB514FeE11119E0923950C09A181F1fa3aa62C80b
Endorsements Address: 0x583456fB91a637807d480d1B6E37029805C1978E
✓ Synapse instance created
Wallet address: 0x47CC9101fD026fC112D7FADf6B3c9DF5bE7D4A8c

--- Checking Balances ---
FIL balance: 999.9999900506001 FIL
USDFC balance: 99999.000000 USDFC

--- Setting Up Storage Context ---
✓ Selected service provider: 0x446339aE7245e3cd1FeD701b685C196C69af695e
✓ Using existing data set: 1
Data set ID: 1
Data set contains 1 piece CIDs

--- Service Provider Details ---
Provider ID: 1
Provider Address: 0x446339aE7245e3cd1FeD701b685C196C69af695e
Provider Name: PDP_SP_1
Active: undefined
PDP Service URL: http://host.docker.internal:5714

--- Preflight Upload Check ---
Estimated costs:
  Per epoch (30s): 0.000000 USDFC
  Per day: 0.000000 USDFC
  Per month: 0.000000 USDFC
✓ Sufficient allowances available

--- Uploading ---
Uploading file to service provider...

  Upload progress: 2.95 KB / 2.95 KB (100.0%)
✓ Upload complete! PieceCID: bafkzcibdsyeapurw4m5m6mu7kjhyatucbdkkernmau6qpjua7mll7wnc35islyz5
✓ Piece addition transaction: 0xfc1bd442a78d722c79b4bf447da7886b721f4aad0c9cac51510d3d9a679f296c
✓ Piece addition confirmed! ID(s): 1

--- Upload Summary ---
File 1: /Users/redpanda/.foc-devnet/state/latest/devnet-info.json
    PieceCID: bafkzcibdsyeapurw4m5m6mu7kjhyatucbdkkernmau6qpjua7mll7wnc35islyz5
    Size: 2.95 KB
    Piece ID: 1

--- Downloading Files ---
Downloading file...

  Downloading file 1: bafkzcibdsyeapurw4m5m6mu7kjhyatucbdkkernmau6qpjua7mll7wnc35islyz5

✓ Downloaded 1 file successfully

--- Verifying Data ---
File 1 (/Users/redpanda/.foc-devnet/state/latest/devnet-info.json): ✅ MATCH (2.95 KB)

✅ SUCCESS: All downloaded files match originals!

--- Piece Status ---
Data set exists on provider: true
Data set last proven: 1/1/1970, 6:20:30 AM
Data set next proof due: 1/1/1970, 7:25:30 AM
Hours until challenge window: 0.9

--- Storage Information ---
Your 1 file is now stored on the Filecoin network:
- Data set ID: 1
- Service provider: 0x446339aE7245e3cd1FeD701b685C196C69af695e

Uploaded pieces:

  File 1: /Users/redpanda/.foc-devnet/state/latest/devnet-info.json
    PieceCID: bafkzcibdsyeapurw4m5m6mu7kjhyatucbdkkernmau6qpjua7mll7wnc35islyz5
    Piece ID: 1
    Size: 2.95 KB
    Retrieval URL: http://host.docker.internal:5714/piece/bafkzcibdsyeapurw4m5m6mu7kjhyatucbdkkernmau6qpjua7mll7wnc35islyz5

The service provider(s) will periodically prove they still have your data.

Needs the sister PR on foc-devnet for working well: FilOzone/foc-devnet#61

[BigLep]

This is being done in support of FilOzone/foc-devnet#7, and more specifically I believe it closes #589

[Copilot]

Pull request overview

Introduces a new foc-devnet-info helper in @filoz/synapse-core to validate foc-devnet’s devnet-info.json and convert it into a Synapse Chain, and updates the utils E2E example to use this new flow.

Changes:

• Add foc-devnet-info library (Zod schema + toChain converter) and export it from @filoz/synapse-core.
• Add unit tests covering devnet-info validation and chain conversion.
• Update utils/example-storage-e2e.js to load config from devnet-info by default and switch from ethers-based usage to viem-based usage.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 8 comments.

Show a summary per file

File	Description
utils/package.json	Add workspace dependency on @filoz/synapse-core and switch utils to viem.
utils/example-storage-e2e.js	Load devnet config from devnet-info by default; update to viem + new foc-devnet-info helpers.
packages/synapse-sdk/src/test/synapse.test.ts	Remove unused session-key-related import.
packages/synapse-core/test/foc-devnet-info.test.ts	Add tests for devnet-info validation and chain construction.
packages/synapse-core/src/index.ts	Export the new focDevnetInfo module from synapse-core.
packages/synapse-core/src/foc-devnet-info/src/schema.ts	New Zod schema + validation wrapper for devnet-info.json.
packages/synapse-core/src/foc-devnet-info/src/index.ts	New public API: loadDevnetInfo + toChain (+ re-exports).
packages/synapse-core/package.json	Add package export + typesVersions mapping for ./foc-devnet-info.
package.json	Adjust Node devEngine version constraint.
examples/script-tag/biome.json	Update Biome schema reference URL.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[redpanda-f]

@rvagg request re-review. Especially biome.json? not opinionated, but needs fixing.

[hugomrdias]

LGTM just rebase from master to fix biome things

[redpanda-f]

LGTM just rebase from master to fix biome things

Request signoff and merge @hugomrdias @rjan90

[rjan90]

Given that this has been rebased, and Hugo gave a thumbs up for merging here in slack, I will go ahead and merge this

PR has been rebased