The Filecoin integration

Velic does not reimplement storage or proofs; it integrates the Filecoin Onchain Cloud through the Synapse SDK at the application layer, with no custom FVM contracts.

Synapse SDK

The Synapse SDK (@filoz/synapse-sdk, with @filoz/synapse-core) is the single integration surface for piece upload/download, dataset management, PDP/proof reads, and Filecoin Pay rails. Velic wraps it in an adapter that connects with the operator signer and exposes typed storage, PDP, and payment operations.

Building blocks

Filecoin Warm Storage Service (FWSS): verifiable warm storage. Masters are stored as a dataset with the default of two independent copies and fault-triggered auto-replacement; payment rails are bound to the dataset.
PDP / PDPVerifier: the continuous on-chain proof engine. Velic reads verifier state (whether a dataset is live, the next challenge epoch, active piece and leaf counts, the storage provider) to drive the dashboard and certificates.
Filecoin Pay: proof-gated operator payment rails used for settlement.
USDFC: the default settlement currency, abstracted away from end users.

Pieces and proofs

Each piece is at most ~1 GiB (the maximum upload size is 1,065,353,216 bytes, 1 GiB adjusted by 127/128 for fr32 padding).
Each piece's PieceCID is computed with the fr32-sha2-256-trunc254-padded-binary-tree commitment, the same scheme the SDK and the PDPVerifier use.
Proof cadence is roughly every 30 minutes on Calibration and daily on mainnet.

Networks and addresses

This version builds and verifies on the Calibration testnet (chain ID 314159); mainnet is 314.

Addresses resolved at init, never hardcoded

The FWSS, PDPVerifier, Filecoin Pay, and USDFC contract addresses are resolved at startup from the installed @filoz/synapse-core package for the configured chain, not pasted into configuration. The default RPC is the public Glif Calibration endpoint. Treat the beta contracts as the primary risk: pin versions and confirm network state before any mainnet use.

What Velic adds, and what it doesn't

Velic adds the product around these primitives: browser-side encryption, the asset catalogue, the proof-indexer, the operator treasury, the dashboard, and the certificate. It does not add erasure coding, a custom proving cadence, region placement, a CDN/streaming path, or any custom Solidity; it relies on FWSS and PDP defaults.