Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file removed .gitbook/assets/1 (1).png
Binary file not shown.
Binary file removed .gitbook/assets/1 (2).png
Binary file not shown.
Binary file removed .gitbook/assets/2 (1).png
Binary file not shown.
Binary file removed .gitbook/assets/2 (2).png
Binary file not shown.
Binary file removed .gitbook/assets/3 (1).png
Binary file not shown.
Binary file removed .gitbook/assets/3 (2).png
Binary file not shown.
Binary file removed .gitbook/assets/4 (1).png
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file removed .gitbook/assets/fvm-3.png
Binary file not shown.
Binary file removed .gitbook/assets/home-fvm-logo-colour.png
Binary file not shown.
Binary file removed .gitbook/assets/home-hero-image-drives.png
Binary file not shown.
Binary file removed .gitbook/assets/home-lotus-logo-colour.png
Binary file not shown.
Binary file removed .gitbook/assets/image (1).png
Binary file not shown.
Binary file removed .gitbook/assets/image.png
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
9 changes: 6 additions & 3 deletions storage-providers/pdp/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
layout:
width: default
title:
visible: true
description:
Expand All @@ -10,14 +11,16 @@ layout:
visible: true
pagination:
visible: true
metadata:
visible: true
---

# PDP

{% hint style="danger" %}
**ALPHA FEATURE - UNDER DEVELOPMENT**
**SOFT LAUNCH – LIMITED RELEASE**

This documentation covers the PDP (Proof of Data Possession) feature, which is currently in alpha and under active development. This tool is intended for testing and experimental use only.
This documentation covers the PDP (Proof of Data Possession) feature, which is now in soft launch and actively evolving. PDP is stable enough for early adopters and real-world integration testing, but changes may still occur as we finalise APIs and service behaviour.

For production use and submitting real deals with live PDP Storage Providers, please use the [Synapse SDK](https://github.com/FilOzone/synapse-sdk).
For full production use and submitting live deals with PDP Storage Providers, please continue to use the [Synapse SDK](https://github.com/FilOzone/synapse-sdk).
{% endhint %}
63 changes: 22 additions & 41 deletions storage-providers/pdp/install-and-run-pdp.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,11 @@ description: >-
# Install & Run PDP

{% hint style="danger" %}
**ALPHA FEATURE - UNDER DEVELOPMENT**
**SOFT LAUNCH – LIMITED RELEASE**

This documentation covers the PDP (Proof of Data Possession) feature, which is currently in alpha and under active development. This tool is intended for testing and experimental use only.
This documentation covers the PDP (Proof of Data Possession) feature, which is now in soft launch and actively evolving. PDP is stable enough for early adopters and real-world integration testing, but changes may still occur as we finalise APIs and service behaviour.

For production use and submitting real deals with live PDP Storage Providers, please use the [Synapse SDK](https://github.com/FilOzone/synapse-sdk).
For full production use and submitting live deals with PDP Storage Providers, please continue to use the [Synapse SDK](https://github.com/FilOzone/synapse-sdk).
{% endhint %}

## 🚀 Prerequisites
Expand All @@ -29,10 +29,10 @@ Before starting, make sure you have a user with **sudo privileges**. This sectio
* **RAM**: 32 GiB+
* **CPU**: 8 Core+
* **Storage**:
* 1 TiB Fast storage (NVMe/SSD)
* 10 TiB Long-term storage (HDD)
* 500 GiB Fast storage (NVMe/SSD)
* 8 TiB Long-term storage (HDD)
* **GPU**: Not required
* **Connectivity**: Public HTTPS endpoint (domain)
* **Connectivity**: Public HTTPS endpoint (domain) supporting HTTP2

***

Expand All @@ -58,7 +58,7 @@ go version
```

{% hint style="success" %}
You should see something like: `go version go1.23.7 linux/amd64`
You should see something like: `go version go1.23.6 linux/amd6464`
{% endhint %}

***
Expand All @@ -79,7 +79,7 @@ rustc --version
```

{% hint style="success" %}
You should see something like: `rustc 1.86.0 (05f9846f8 2025-03-31)`
You should see something like: `rustc 1.83.0 (90b35a623 2024-11-26)`
{% endhint %}

***
Expand Down Expand Up @@ -127,7 +127,7 @@ lotus --version
```

{% hint style="success" %}
You should see something like: `lotus version 1.32.2+calibnet+git.ff88d8269`
You should see something like: `lotus version 1.34.1+mainnet+git.710b4ac66`
{% endhint %}

***
Expand Down Expand Up @@ -293,7 +293,7 @@ Clone the repository and switch to the PDP branch:
```sh
git clone https://github.com/filecoin-project/curio.git
cd curio
git checkout pdpM3d
git checkout pdp/v1.0.3
```

{% hint style="info" %}
Expand Down Expand Up @@ -335,7 +335,7 @@ curio --version
Expected example output:

```sh
curio version 1.24.4+calibnet+git_f954c0a_2025-04-06T15:46:32-04:00
curio version 1.27.0+mainnet+git_e458639d_2025-11-03T10:51:55+01:00
```

***
Expand Down Expand Up @@ -447,6 +447,7 @@ You may find it helpful to search for the setting names in your browser.
* ✅ `EnablePDP`
* ✅ `EnableCommP`
* ✅ `EnableMoveStorage`
* ✅ `NoUnsealedDecode`

In the **HTTP** section:

Expand Down Expand Up @@ -506,7 +507,10 @@ Browse to the **PDP** page of the Curio GUI and in the **Owner Address** section
Your 0x wallet address - the delegated Ethereum address derived from your Filecoin delegated wallet private key - will be added to the **Owner Address** section of the Curio PDP page.
{% endhint %}

Make sure to send a small amount of FIL or tFIL (testnet FIL) to your 0x wallet - we recommend 8 FIL for Mainnet & 5 tFIL for Calibration to ensure uninterrupted PDP operation during initial setup and testing. [Calibration test FIL faucet information](https://docs.filecoin.io/smart-contracts/developing-contracts/get-test-tokens).
Make sure to send a small amount of FIL to your 0x wallet - we recommend:

* 10 FIL for Mainnet to facilitate the 5 FIL SP creation fee and uninterrupted PDP operation during initial setup and testing.
* 5 tFIL (testnet FIL) for Calibration - [Calibration test FIL faucet information](https://docs.filecoin.io/smart-contracts/developing-contracts/get-test-tokens)

{% hint style="warning" %}
**Important:** Secure your private key material. Don't expose or store it in plain text without protection.
Expand Down Expand Up @@ -538,38 +542,15 @@ If you encounter errors binding to port 443 when starting Curio with the pdp con
sudo setcap 'cap_net_bind_service=+ep' /usr/local/bin/curio
```

Test the PDP service:

{% hint style="info" %}
If `pdptool` is not installed, clone and build Curio:
{% endhint %}

```sh
git clone https://github.com/filecoin-project/curio.git
cd curio/cmd/pdptool
go build .
```
***

Generate a service secret:
### 🔗 Test Connectivity

```sh
./pdptool create-service-secret
```
Browse to your PDP node’s domain name in your browser - you should see the following message in your browser window:

```sh
./pdptool ping --service-url https://your-domain.com --service-name public
```

{% hint style="info" %}
Always use `public` for the `--service-name` flag
{% endhint %}

{% hint style="success" %}
Expected output:
{% endhint %}

```sh
Ping successful: Service is reachable and JWT token is valid.
Hello, World!
-Curio
```

***
Expand All @@ -579,7 +560,7 @@ Ping successful: Service is reachable and JWT token is valid.
You've successfully launched a **PDP-enabled Filecoin Storage Provider** stack. Your system is now:

* ✅ Syncing with the Filecoin network via Lotus
* ✅ Recording deal and sector metadata in YugabyteDB
* ✅ Recording deal and piece metadata in YugabyteDB
* ✅ Operating Curio to manage sealing and coordination
* ✅ Enabled Proof of Data Possession (PDP)
* ✅ Connected to your PDP-enabled storage provider
Expand Down
Loading