> For the complete documentation index, see [llms.txt](https://docs.filecoin.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.filecoin.io/build-on-filecoin/filecoin-onchain-cloud.md).

# Filecoin Onchain Cloud

Filecoin Onchain Cloud (FOC) is a programmable storage platform built on the Filecoin Virtual Machine. It combines warm storage, cryptographic storage verification, retrieval, and payments into one developer-facing stack.

Use FOC when you want application-controlled storage on Filecoin without building the storage, payment, provider-selection, and proof flows yourself. The primary integration path is the Synapse SDK; this section points to the maintained [FOC quickstart and Synapse docs](/build-on-filecoin/filecoin-onchain-cloud/synapse-quickstart.md).

## When to use FOC

FOC is a good fit when your application needs:

* **Programmable storage** that can be controlled from a wallet, backend service, agent, or smart-contract-adjacent workflow.
* **Verifiable persistence** through Proof of Data Possession (PDP), so providers regularly prove they still hold the data.
* **Automated payments** through Filecoin Pay, so storage providers are paid through on-chain payment rails.
* **Retrieval paths** for application data, with Filecoin Beam available for faster data delivery.

If you only need a managed IPFS pinning-style workflow, start with [Filecoin Pin](/build-on-filecoin/cookbook/filecoin-pin.md). If you want to run provider infrastructure for the FOC stack, start with the [PDP provider documentation](/provide-storage/pdp.md).

## Core components

FOC is composed of services that can be used together through the Synapse SDK:

| Component     | Role                                                                                                                        |
| ------------- | --------------------------------------------------------------------------------------------------------------------------- |
| FWSS          | Filecoin Warm Storage Service stores data with retrievability-oriented provider selection.                                  |
| PDP           | Proof of Data Possession verifies that providers still hold stored data without requiring a full download.                  |
| Filecoin Pay  | Payment rails fund storage and settle provider payments based on service delivery.                                          |
| Filecoin Beam | Retrieval infrastructure for fast data delivery when your application needs it.                                             |
| Synapse SDK   | TypeScript SDK for funding storage, selecting providers, uploading data, downloading data, and managing storage operations. |

## Developer paths

| Path          | Use when                                                                                         | Start here                                                                                         |
| ------------- | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------- |
| Synapse SDK   | You are building a JavaScript or TypeScript application that stores and retrieves data with FOC. | [FOC quickstart and Synapse docs](/build-on-filecoin/filecoin-onchain-cloud/synapse-quickstart.md) |
| Filecoin Pin  | You want a CLI or API-style path for pinning IPFS-compatible content to Filecoin-backed storage. | [Filecoin Pin](/build-on-filecoin/cookbook/filecoin-pin.md)                                        |
| PDP provider  | You want to run provider infrastructure that can participate in FOC storage.                     | [PDP](/provide-storage/pdp.md)                                                                     |
| Full FOC docs | You need the complete FOC guides, API reference, architecture, pricing, or contract references.  | [docs.filecoin.cloud](https://docs.filecoin.cloud/)                                                |

## Learn more

The FOC documentation is the source of truth for detailed product docs, pricing, API references, and contract addresses:

* [FOC quick start](https://docs.filecoin.cloud/getting-started)
* [Architecture](https://docs.filecoin.cloud/core-concepts/architecture)
* [FWSS overview](https://docs.filecoin.cloud/core-concepts/fwss-overview)
* [PDP overview](https://docs.filecoin.cloud/core-concepts/pdp-overview)
* [Filecoin Pay overview](https://docs.filecoin.cloud/core-concepts/filecoin-pay-overview)
* [Synapse SDK guide](https://docs.filecoin.cloud/developer-guides/synapse)
* [Contract addresses](https://docs.filecoin.cloud/resources/contracts)

[Was this page helpful?](https://airtable.com/apppq4inOe4gmSSlk/pagoZHC2i1iqgphgl/form?prefill_Page+URL=https://docs.filecoin.io/build/filecoin-onchain-cloud)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.filecoin.io/build-on-filecoin/filecoin-onchain-cloud.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.