Skip to content

Commit e602f98

Browse files
authored
Merge pull request #2458 from beck-8/docs/pdp-install-updates
docs(pdp): update pdp install
2 parents 1a414d4 + 7b0ef1c commit e602f98

1 file changed

Lines changed: 51 additions & 29 deletions

File tree

storage-providers/pdp/install-and-run-pdp.md

Lines changed: 51 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ go version
5858
```
5959

6060
{% hint style="success" %}
61-
You should see something like: `go version go1.23.7 linux/amd64`
61+
You should see something like: `go version go1.24.0 linux/amd64`
6262
{% endhint %}
6363

6464
***
@@ -117,7 +117,7 @@ lotus --version
117117
```
118118

119119
{% hint style="success" %}
120-
You should see something like: `lotus version 1.32.2+calibnet+git.ff88d8269`
120+
You should see something like: `lotus version 1.36.0+calibnet+git.154c0c3a4`
121121
{% endhint %}
122122

123123
***
@@ -278,12 +278,12 @@ echo 'net.core.rmem_default=2097152' | sudo tee -a /etc/sysctl.conf
278278

279279
### 🔬 Build Curio
280280

281-
Clone the repository and switch to the PDP branch:
281+
Clone the repository and switch to the latest branch:
282282

283283
```sh
284284
git clone https://github.com/filecoin-project/curio.git
285285
cd curio
286-
git checkout pdpM3d
286+
git checkout $(curl -s https://api.github.com/repos/filecoin-project/curio/releases/latest | jq -r .tag_name)
287287
```
288288

289289
{% hint style="info" %}
@@ -437,6 +437,7 @@ You may find it helpful to search for the setting names in your browser.
437437
*`EnablePDP`
438438
*`EnableCommP`
439439
*`EnableMoveStorage`
440+
*`NoUnsealedDecode`
440441

441442
In the **HTTP** section:
442443

@@ -517,7 +518,7 @@ If you encounter errors related to `EnableEthRPC` or `EnableIndexer`, run the fo
517518
{% endhint %}
518519

519520
```sh
520-
sed -i 's/^\( *\)#*EnableEthRPC = .*/\1EnableEthRPC = true/; s/^\( *\)#*EnableIndexer = .*/\1Enabl
521+
sed -i 's/^\( *\)#*EnableEthRPC = .*/\1EnableEthRPC = true/; s/^\( *\)#*EnableIndexer = .*/\1EnableIndexer = true/' ~/.lotus/config.toml
521522
```
522523

523524
{% hint style="info" %}
@@ -528,39 +529,60 @@ If you encounter errors binding to port 443 when starting Curio with the pdp con
528529
sudo setcap 'cap_net_bind_service=+ep' /usr/local/bin/curio
529530
```
530531

531-
Test the PDP service:
532+
***
532533

533-
{% hint style="info" %}
534-
If `pdptool` is not installed, clone and build Curio:
535-
{% endhint %}
534+
### 🔗 Test Connectivity
535+
536+
Browse to your PDP node's domain name in your browser. You should see the following message in your browser window:
536537

537-
```sh
538-
git clone https://github.com/filecoin-project/curio.git
539-
cd curio/cmd/pdptool
540-
go build .
538+
```
539+
Hello, World!
540+
-Curio
541541
```
542542

543-
Generate a service secret:
543+
***
544544

545-
```sh
546-
./pdptool create-service-secret
547-
```
545+
### 🗳️ Register Your PDP Calibration Node With The Filecoin Warm Storage Service
548546

549-
```sh
550-
./pdptool ping --service-url https://your-domain.com --service-name public
551-
```
547+
Browse to the **PDP** page of the Curio GUI and locate the **Filecoin Service Registry** section.
548+
549+
#### STEP 1 — Update Details
550+
551+
Select **Update Details** and fill in:
552+
553+
| Field | Notes |
554+
| --- | --- |
555+
| Name | ≤ 128 chars |
556+
| Description | ≤ 256 chars |
557+
558+
Select **Update** to submit your node details to the on-chain FWSS contract.
552559

553560
{% hint style="info" %}
554-
Always use `public` for the `--service-name` flag
561+
You can review the names and descriptions of other FWSS providers at [https://filecoin.cloud/service-providers](https://filecoin.cloud/service-providers).
555562
{% endhint %}
556563

557-
{% hint style="success" %}
558-
Expected output:
559-
{% endhint %}
564+
#### STEP 2 — Update PDP Offering
560565

561-
```sh
562-
Ping successful: Service is reachable and JWT token is valid.
563-
```
566+
Select **Update PDP Offering** and set:
567+
568+
| Field | Recommended value |
569+
| --- | --- |
570+
| Minimum Piece Size (Bytes) | `1048576` |
571+
| Maximum Piece Size (Bytes) | `1073741824` |
572+
| Storage Price (USDFC per TiB per day) | `0.833` |
573+
| Minimum Proving Period (Epochs) | `30` |
574+
| Location | e.g. `C=US;ST=California;L=San Francisco` (only `C=` is required) |
575+
576+
Then use **Add Capability** to add the following key/value pairs:
577+
578+
| Key | Value |
579+
| --- | --- |
580+
| `serviceStatus` | `prod` |
581+
| `capacityTib` | your available storage capacity in TiB |
582+
583+
Select **Update PDP** to submit your offering to the on-chain FWSS contract.
584+
585+
You can revisit **Update PDP Offering** at any time to change the Service URL, piece size range, IPNI toggles, price, proving period, location, or custom capabilities.
564586

565587
***
566588

@@ -569,15 +591,15 @@ Ping successful: Service is reachable and JWT token is valid.
569591
You've successfully launched a **PDP-enabled Filecoin Storage Provider** stack. Your system is now:
570592

571593
* ✅ Syncing with the Filecoin network via Lotus
572-
* ✅ Recording deal and sector metadata in YugabyteDB
594+
* ✅ Recording deal and piece metadata in YugabyteDB
573595
* ✅ Operating Curio to manage sealing and coordination
574596
* ✅ Enabled Proof of Data Possession (PDP)
575597
* ✅ Connected to your PDP-enabled storage provider
598+
* ✅ Registered with the Filecoin Warm Storage Service onchain contract
576599

577600
***
578601

579602
## 🔜 Next Steps
580603

581-
* :heavy\_check\_mark: Register your FWSS node
582604
* :link: Explore FWSS & PDP tools & resources at [https://www.filecoin.services](https://www.filecoin.services/)
583605
* 💬 Join the community - Filecoin Slack - [#fil-pdp](https://filecoinproject.slack.com/archives/C0717TGU7V2)

0 commit comments

Comments
 (0)