Mirrored from filpgf.io — ProPGF Batch 3 (Karma program 1479, application 6a283f440b011f45d4f808a4, status: pending). Contact details redacted; canonical application lives on filpgf.io. 1.1 Project Name synapse-go 1.2 Project Github https://github.com/strahe/synapse-go 1.3 Project Website https://pkg.go.dev/github.com/strahe/synapse-go 1.4 Team Lead/Point of Contact Lee, Lead Maintainer. Preferred contact: Telegram @octal5 1.5 Category [ "Core Infrastructure" ] 1.6 Open Source Status Fully Open Source 2.1 Project Summary synapse-go is a Go SDK for Filecoin Onchain Cloud, ported from the FilOz TypeScript Synapse SDK. It provides Go developers with client APIs for FOC storage upload/download, FWSS dataset lifecycle, Filecoin Pay/USDFC funding, storage provider discovery, PDP provider APIs, FilBeam retrieval, session-key authorization, and PieceCID tooling. The work supports Go application builders, storage onramps, backend services, data pipelines, provider-facing tools, and Filecoin infrastructure teams. It addresses the current gap that FOC has a TypeScript SDK but no comparable Go SDK for teams building in the language widely used across Filecoin infrastructure. By removing the need to hand-build FEVM contract calls, EIP-712 signing, PDP HTTP clients, and Filecoin-specific content-addressing logic, synapse-go lowers integration risk for Go-based FOC adoption. The SDK is already in beta with public documentation, runnable examples, CI, unit tests, and integration-test workflows. 2.2 Who does this work support? [ "Onramps", "Storage Providers", "Application Builders", "Network Infrastructure" ] 2.3 Total Funding Requested (USD) 50000 2.4 Milestones & Budget [ { "title": "Core SDK Foundation", "description": "Built the foundational Go SDK modules required for applications to connect to Filecoin Onchain Cloud.\n\nDeliverables:\n- Public Go module: github.com/strahe/synapse-go\n- Root client for initializing FOC services from Go\n- Mainnet and Calibration chain configuration\n- Contract address handling and generated contract bindings\n- Typed Go packages for payments, warmstorage, spregistry, sessionkey, filbeam, pdp, piece, costs, signer, chain, storage, and shared types", "dueDate": "2026-07-15", "fundingRequested": "20000", "completionCriteria": "- Public Go module and root client are available.\n- Mainnet/Calibration config, contract bindings, and core typed packages are implemented.\n- The SDK builds with `go build ./...`." }, { "title": "End-to-End FOC Workflows", "description": "Implemented the main workflows needed by Go applications and infrastructure services to use FOC.\n\nDeliverables:\n- Multi-provider upload and download flows\n- Provider selection and dataset creation or reuse\n- Piece upload, secondary provider pull, onchain AddPieces submission, and retrieval URL handling\n- Filecoin Pay/USDFC balance, deposit, approval, funding, and account-state flows\n- Cost estimation and funding preflight before upload\n- FWSS dataset discovery and lifecycle operations\n- PDP provider HTTP client\n- PieceCID calculation and download validation\n- Session-key authorization support", "dueDate": "2026-08-15", "fundingRequested": "20000", "completionCriteria": "- Upload/download, provider selection, and dataset flows are implemented.\n- Filecoin Pay/USDFC funding and cost preflight flows are implemented.\n- PDP, PieceCID, and session-key support are implemented." }, { "title": "Public Beta Readiness", "description": "Prepared the SDK for external Go builders to evaluate and use.\n\nDeliverables:\n- README and getting-started documentation\n- pkg.go.dev API reference\n- Runnable examples for quickstart, upload, download, provider listing, dataset listing, and PieceCID inspection\n- GitHub Actions CI for build, vet, lint, unit tests, and vulnerability checks\n- Unit tests across SDK packages\n- Integration-test workflows for Calibration validation\n- Public beta release tags", "dueDate": "2026-09-15", "fundingRequested": "10000", "completionCriteria": "- README, getting-started docs, pkg.go.dev API docs, and examples are available.\n- CI runs build, vet, lint, tests, and vulnerability checks.\n- Calibration integration-test workflows are available." } ] 3.1 Impact pathway synapse-go provides a maintained Go SDK for FOC storage, payment, provider, PDP, session-key, FilBeam, and PieceCID workflows. Go builders can integrate FOC with less custom protocol code and lower implementation risk. This makes it easier for Go-based applications, onramps, and infrastructure services to use paid Filecoin storage. The SDK does not directly own downstream storage demand, but it enables more teams to create that demand through reliable Go integrations. 3.2 Verification metrics 1. Quality: All required CI checks pass on the main branch and release tags, including build, vet, lint, unit tests, and govulncheck. Test coverage remains above 80% for non-generated SDK packages. 2. Content: Provide at least 5 runnable end-to-end examples covering quickstart, upload, download, provider listing, dataset listing, and PieceCID inspection, linked from README and visible through Go package documentation where applicable. 3. Adoption: Onboard 2-3 early-adopter Go teams or storage providers in the Filecoin ecosystem during the grant cycle, verified through integration feedback, issues/PRs, test reports, or public references where possible. 3.3 References N/A 4.1 Monthly Operating Burn [ "< $10K (basic solo operation or part-time team)" ] 4.2 What % of total team monthly burn depends on this grant? 100 4.3 If this grant is not awarded, what happens? The completed SDK work will remain open source. Future validation, documentation polish, adopter support, and protocol-alignment work will continue more slowly as a personal open-source effort. 4.4 Core Team synapse-go is an independent project led by Lee. Lee has over 10 years of software development experience, has been part of the IPFS/Filecoin community for 7 years, and has worked at storage provider companies for more than 5 years. He is responsible for the SDK implementation, testing, documentation, releases, and community support. 4.5 Has your team received a ProPGF grant or funding from PLFIF before? [ "Yes" ] 5.1 Key risks & dependencies There are no major delivery risks for the completed milestones. The core SDK is already implemented and available in public beta. Remaining risks are normal external dependencies for an SDK: FOC contract/API changes, provider endpoint behavior, and Calibration/mainnet differences. Contributing to Core Infrastructure? FilOz maintains the TypeScript SDK for Filecoin Onchain Cloud. synapse-go provides the Go client infrastructure for the same FOC integration path. It is intended for Go application builders, storage onramps, backend services, data pipelines, provider-facing tools, and Filecoin infrastructure teams that need to use FOC from Go. The SDK is currently in beta, so its dependents are early evaluators and Go teams preparing FOC integrations, rather than established production systems yet. Objective 1 Indirect Objective 2 Indirect Objective 3 Indirect