From f716dea3183ed1f8c5d4190fe781de730fe8c076 Mon Sep 17 00:00:00 2001 From: TippyFlits Date: Tue, 10 Jun 2025 14:02:33 +0000 Subject: [PATCH 1/3] GITBOOK-1: No subject --- storage-providers/pdp/README.md | 22 +++++++++++++++++++ storage-providers/pdp/enable-pdp.md | 17 ++++++++++---- .../pdp/install-and-run-curio.md | 4 ++-- .../pdp/install-and-run-lotus.md | 10 ++++++++- storage-providers/pdp/use-pdp.md | 15 ++++++++++--- 5 files changed, 58 insertions(+), 10 deletions(-) diff --git a/storage-providers/pdp/README.md b/storage-providers/pdp/README.md index 8760b9e84..02aff5475 100644 --- a/storage-providers/pdp/README.md +++ b/storage-providers/pdp/README.md @@ -1,2 +1,24 @@ +--- +layout: + title: + visible: true + description: + visible: true + tableOfContents: + visible: true + outline: + visible: true + pagination: + visible: true +--- + # PDP +{% hint style="danger" %} +**DEPRECATED DEVELOPER TOOL**\ +\ +This documentation refers to the legacy `pdptool`, which is intended only for low-level developer testing.\ +It is not the recommended method for onboarding or interacting with PDP Storage Providers. + +For current usage, including working with live PDP SPs and submitting real deals, please use the [Synapse SDK](https://github.com/FilOzone/synapse-sdk) and [Synapse dApp Tutorial](https://github.com/FIL-Builders/fs-upload-dapp). +{% endhint %} diff --git a/storage-providers/pdp/enable-pdp.md b/storage-providers/pdp/enable-pdp.md index a26d2762c..5f3196586 100644 --- a/storage-providers/pdp/enable-pdp.md +++ b/storage-providers/pdp/enable-pdp.md @@ -7,6 +7,15 @@ description: >- # Enable PDP +{% hint style="danger" %} +**DEPRECATED DEVELOPER TOOL**\ +\ +This documentation refers to the legacy `pdptool`, which is intended only for low-level developer testing.\ +It is not the recommended method for onboarding or interacting with PDP Storage Providers. + +For current usage, including working with live PDP SPs and submitting real deals, please use the [Synapse SDK](https://github.com/FilOzone/synapse-sdk) and [Synapse dApp Tutorial](https://github.com/FIL-Builders/fs-upload-dapp). +{% endhint %} +
PDP DocumentationCurio_placeholder.webp
Filecoin Slack - #fil-pdpFilecoin.svg.png
Filecoin Wallet - MetaMask SetupFilecoin.svg.png
### Attach Storage Locations @@ -52,7 +61,7 @@ In the HTTP section: * 📡 ListenAddress: `0.0.0.0:443` {% hint style="info" %} - You must point your domain’s A record to your server’s public IP address for Let’s Encrypt to issue a certificate. +You must point your domain’s A record to your server’s public IP address for Let’s Encrypt to issue a certificate. {% endhint %} *** @@ -116,7 +125,7 @@ You can display your Lotus wallets at any time by running: lotus wallet list ``` -Export & convert your new delegated wallet address private key: +Export & convert your new delegated wallet address private key: ```sh lotus wallet export | xxd -r -p | jq -r '.PrivateKey' | base64 -d | xxd -p -c 32 @@ -135,7 +144,7 @@ Browse to the **PDP** page of the Curio GUI and in the **Owner Address** section * Select **Import Key** {% hint style="success" %} -Your 0x wallet address - the delegated Ethereum address derived from your Filecoin Metamask private key - will be added to the **Owner Address** section of the Curio PDP page. +Your 0x wallet address - the delegated Ethereum address derived from your Filecoin Metamask 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 to your 0x wallet - we recommend 5 FIL to ensure uninterrupted PDP operation during initial setup and testing. @@ -155,7 +164,7 @@ curio run --layers=gui,pdp ``` {% hint style="warning" %} - If you encounter errors binding to port 443 when starting Curio with the pdp configuration layer, run: +If you encounter errors binding to port 443 when starting Curio with the pdp configuration layer, run: {% endhint %} ```sh diff --git a/storage-providers/pdp/install-and-run-curio.md b/storage-providers/pdp/install-and-run-curio.md index 04522d3f7..195984507 100644 --- a/storage-providers/pdp/install-and-run-curio.md +++ b/storage-providers/pdp/install-and-run-curio.md @@ -31,11 +31,11 @@ Clone the repository and switch to the PDP branch: ```sh git clone https://github.com/filecoin-project/curio.git cd curio -git checkout feat/pdp +git checkout synapse ``` {% hint style="info" %} -Curio is compiled for a specific Filecoin network at build time. Choose the appropriate build command below. +Curio is compiled for a specific Filecoin network at build time. Choose the appropriate build command below. {% endhint %} ```sh diff --git a/storage-providers/pdp/install-and-run-lotus.md b/storage-providers/pdp/install-and-run-lotus.md index fe53f8853..1ecae6e0c 100644 --- a/storage-providers/pdp/install-and-run-lotus.md +++ b/storage-providers/pdp/install-and-run-lotus.md @@ -63,6 +63,14 @@ lotus daemon --import-snapshot snapshot.car.zst --remove-existing-chain --halt-a nohup lotus daemon > ~/lotus.log 2>&1 & ``` +{% hint style="warning" %} +If you encounter errors related to `EnableEthRPC` or `EnableIndexer`, run the command below and restart Lotus +{% endhint %} + +```sh +sed -i 's/EnableEthRPC = .*/EnableEthRPC = true/; s/EnableIndexer = .*/EnableIndexer = true/' ~/.lotus/config.toml +``` + #### **Monitor Sync Progress** ```sh @@ -96,7 +104,7 @@ lotus wallet new bls # Create worker wallet lotus wallet list # List all created wallets ``` -Make sure to send a small amount of FIL to each wallet - we recommend 1 FIL per wallet to ensure the creation of your Storage Provider in Curio. +Make sure to send a small amount of FIL to each wallet - we recommend 1 FIL per wallet to ensure the creation of your Storage Provider in Curio. [Calibration test FIL faucet information](https://docs.filecoin.io/smart-contracts/developing-contracts/get-test-tokens). {% hint style="info" %} Both wallets will be used during Curio initialisation. diff --git a/storage-providers/pdp/use-pdp.md b/storage-providers/pdp/use-pdp.md index 71d988291..17c8e7e50 100644 --- a/storage-providers/pdp/use-pdp.md +++ b/storage-providers/pdp/use-pdp.md @@ -7,6 +7,15 @@ description: >- # Use PDP +{% hint style="danger" %} +DEPRECATED DEVELOPER TOOL + +This documentation refers to the legacy `pdptool`, which is intended only for low-level developer testing. \ +It is not the recommended method for onboarding or interacting with PDP Storage Providers.\ + \ +For current usage, including working with live PDP SPs and submitting real deals, please use the [Synapse SDK](https://github.com/FilOzone/synapse-sdk) and [Synapse dApp Tutorial](https://github.com/FIL-Builders/fs-upload-dapp). +{% endhint %} + PDP ensures that your data is verifiably stored by a Filecoin Storage Provider using cryptographic proofs without needing to retrieve the file itself. ### Prerequisites @@ -33,7 +42,7 @@ go build . *** -### Authenticate Your Client (JWT Token) +### Authenticate Your Client (JWT Token) You first need to authenticate your pdptool with a PDP-enabled Storage Provider @@ -95,7 +104,7 @@ Location: /pdp/proof-sets/created/0xf91617ef532748efb5a51e64391112e5328fbd9a5b9a Response: ``` -Use the `0x` transaction hash from the previous output to monitor proof set creation status: +Use the `0x` transaction hash from the previous output to monitor proof set creation status: ```sh ./pdptool get-proof-set-create-status \ @@ -234,6 +243,6 @@ You’ve now: 🧭 Next: Track your proof sets in the PDP Explorer * [Calibration PDP Explorer](https://calibration.pdp-explorer.eng.filoz.org) -* [Mainnet PDP Explorer](https://pdp-explorer.eng.filoz.org) +* [Mainnet PDP Explorer](https://pdp-explorer.eng.filoz.org) 💬 Questions? Join the conversation on Filecoin Slack: [#fil-pdp](https://filecoinproject.slack.com/archives/C0717TGU7V2) From 4f4c1d9b7291d7a67bf0345de9b65124d5861f98 Mon Sep 17 00:00:00 2001 From: TippyFlits Date: Wed, 11 Jun 2025 13:59:46 +0100 Subject: [PATCH 2/3] Update install-and-run-lotus.md Added FIL / tFIL clarification --- storage-providers/pdp/install-and-run-lotus.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/storage-providers/pdp/install-and-run-lotus.md b/storage-providers/pdp/install-and-run-lotus.md index 1ecae6e0c..2b1d1b909 100644 --- a/storage-providers/pdp/install-and-run-lotus.md +++ b/storage-providers/pdp/install-and-run-lotus.md @@ -104,7 +104,7 @@ lotus wallet new bls # Create worker wallet lotus wallet list # List all created wallets ``` -Make sure to send a small amount of FIL to each wallet - we recommend 1 FIL per wallet to ensure the creation of your Storage Provider in Curio. [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 (Mainnet) or tFIL (Calibration) to each wallet - we recommend 1 FIL/tFIL per wallet to ensure the creation of your Storage Provider in Curio. [Calibration test FIL faucet information](https://docs.filecoin.io/smart-contracts/developing-contracts/get-test-tokens). {% hint style="info" %} Both wallets will be used during Curio initialisation. From dbfeaf0f5ee00c10e4be1d38bf8140d98f1d02d4 Mon Sep 17 00:00:00 2001 From: TippyFlits Date: Wed, 11 Jun 2025 14:06:34 +0100 Subject: [PATCH 3/3] Update use-pdp.md --- storage-providers/pdp/use-pdp.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/storage-providers/pdp/use-pdp.md b/storage-providers/pdp/use-pdp.md index 17c8e7e50..ea3620ab2 100644 --- a/storage-providers/pdp/use-pdp.md +++ b/storage-providers/pdp/use-pdp.md @@ -10,9 +10,10 @@ description: >- {% hint style="danger" %} DEPRECATED DEVELOPER TOOL -This documentation refers to the legacy `pdptool`, which is intended only for low-level developer testing. \ -It is not the recommended method for onboarding or interacting with PDP Storage Providers.\ - \ +This documentation refers to the legacy `pdptool`, which is intended only for low-level developer testing. + +It is not the recommended method for onboarding or interacting with PDP Storage Providers. + For current usage, including working with live PDP SPs and submitting real deals, please use the [Synapse SDK](https://github.com/FilOzone/synapse-sdk) and [Synapse dApp Tutorial](https://github.com/FIL-Builders/fs-upload-dapp). {% endhint %}