Use PDP
This guide walks you through using the PDP client tool (pdptool) to interact with a Filecoin Storage Provider running the Proof of Data Possession (PDP) service.
Last updated
Was this helpful?
This guide walks you through using the PDP client tool (pdptool) to interact with a Filecoin Storage Provider running the Proof of Data Possession (PDP) service.
Last updated
Was this helpful?
PDP ensures that your data is verifiably stored by a Filecoin Storage Provider using cryptographic proofs without needing to retrieve the file itself.
Before beginning, ensure:
You have access to a terminal with internet connectivity
Your system has pdptool installed (bundled with Curio)
Option 1: Clone Curio and build pdptool:
Option 2: Install the of pdptool - Provided by our friends at
You first need to authenticate your pdptool with a PDP-enabled Storage Provider
Generate a service secret:
Start by pinging the PDP service to confirm availability:
You should see something like:
Start by creating an empty proof set. This step must happen before uploading files:
Use the 0x transaction hash from the previous output to monitor proof set creation status:
You should see something like:
Once your proof set is ready, you can begin uploading files:
Example output:
After uploading each file, extract its CID and add it to your proof set:
Example using the information returned in the previous steps:
Example output:
You can retrieve a proof set or inspect a file root directly:
Example output:
Download a file using an ordered chunks list:
You’ve now:
✅ Connected to a PDP-enabled storage provider ✅ Created a proof set ✅ Uploaded files and added file roots ✅ Verified availability and proof status
🧭 Next: Track your proof sets in the PDP Explorer
Reach out in the channel in Filecoin Slack to register your public key with a PDP-enabled Storage Provider
In the above example, --proof-set-id came from the step, and --root from the step.
💡In the above example, –chunk-file and –output-file flags were defined in the
💬 Questions? Join the conversation on Filecoin Slack: