feat: (foc-localnet-v1-rc) Add Localnet Support to Synapse SDK

[redpanda-f]

This PR adds comprehensive support for local Filecoin networks to enable easier development and testing.

Changes

• Add localnet support to Synapse SDK for local Filecoin network development
• Introduce localnet configuration utilities with environment variable support for chain ID, RPC URLs, and contract addresses
• Update FilecoinNetworkType to include 'localnet' alongside mainnet and calibration
• Enhance network detection to automatically recognize localnet by chain ID
• Add localnet contract address resolution with required/optional address validation
• Update example scripts (storage-e2e, post-deploy-setup) to support --network localnet option
• Export localnet configuration from synapse-core and synapse-sdk packages
• Maintain backward compatibility with existing mainnet/calibration functionality

Environment Variables

The following environment variables can be used to configure localnet:

• LOCALNET_CHAIN_ID (default: 1414)
• LOCALNET_RPC_URL (default: http://127.0.0.1:5700/rpc/v1)
• LOCALNET_RPC_WS_URL (default: ws://127.0.0.1:5700/rpc/v1)
• LOCALNET_BLOCK_EXPLORER_URL (default: http://localhost:8080)
• LOCALNET_MULTICALL3_ADDRESS,
• LOCALNET_USDFC_ADDRESS, etc. for contract addresses

[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	Updated (UTC)
❌ Deployment failed View logs	synapse-dev	5c094bc	Jan 12 2026, 04:07 PM

[BigLep]

@redpanda-f : will you take care of the lint failures?

[rvagg]

I think this was a mistake? we recently removed a bunch of stuff from here, are they needed for this PR?

[rvagg]

let's not do this, it already uses env vars and we can stick to that, I don't really want to overcomplicate it for now and keep it ~clean, let's just extend the env var use to add in the devnet variables

[rvagg]

as above, I don't think this is required, make the caller specify RPC_URL