For the complete documentation index, see llms.txt. This page is also available as Markdown.

Console and explorer

The filecoin-app dashboard, where wallet owners approve agent session keys and fund storage, and PDP Explorer, where anyone can look up stored data.

filecoin relies on two web apps:

  • The filecoin-app dashboard at poc.filecoin.cloud/dashboard. The wallet owner connects their wallet there to approve session keys, deposit USDFC, approve the Warm Storage service, and revoke keys. While filecoin is a prototype, it uses this app instead of the Filecoin Pay console.

  • PDP Explorer at pdp.filecoin.cloud. Public pages for storage providers, data sets, and pieces on mainnet and Calibration. Search by data set ID, provider ID, or PieceCID.

Session keys

A session key lets a tool sign storage requests for your wallet. It can create data sets, add pieces, schedule piece removals, and end service, but it can never move funds.

The dashboard's Session keys page lists every key your wallet authorized, with when each permission expires. Revoke a key there to stop the tool that holds it. You can also generate a key there, authorize it, and copy its private key with Export key, which is how a cloud agent gets a key.

Keys made by filecoin login stay on the agent's machine. The dashboard only approves them.

When filecoin needs the wallet owner, it returns a link to the dashboard's setup page with the request filled in. You review it, change anything you need, connect your wallet, and approve each step. Each step is its own wallet transaction, so nothing is signed until you confirm it in your wallet.

Link
Opens
Sent by

/dashboard/setup?network=<network>&signer=<address>&name=<name>&scopes=<scopes>&days=<days>

The setup page, ready to authorize the session key <address> for the listed scopes

filecoin login

/dashboard/setup?network=<network>&deposit=<USDFC>

The setup page, ready to deposit <USDFC>, with a step to approve the Warm Storage service when the wallet hasn't yet

filecoin status and filecoin put when the account needs funds

scopes is a comma-separated list of createDataSet, addPieces, schedulePieceRemovals, and terminateService. network is mainnet or calibration. When the connected wallet is on the other network, the page asks you to switch before you can review the request, so an approval for Calibration is never granted on mainnet by mistake.

filecoin logout only deletes the key on your machine. To revoke the key on chain, use the Session keys page.

The dashboard is a prototype and interacts directly with the Filecoin Pay and Warm Storage contracts. Check the details in your wallet before you confirm a transaction.

Was this page helpful?

Last updated