Pin Lifecycle

Content goes through several states when pinned to Pinner.

Pin States

pending

Content has been received but not yet pinned to the network.

pinning

Content is being retrieved and pinned across decentralized network nodes.

pinned

Content is successfully pinned and retrievable across the network.

failed

Content could not be pinned. Check the error message for details.

Checking Pin Status

import { Pinner } from "@lumeweb/pinner";
 
const pinner = new Pinner({ jwt: "YOUR_API_TOKEN" });
 
const status = await pinner.getPinStatus("bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq");
 
console.log("Status:", status.status);
// pinned, pinning, pending, or failed

Retry Strategies

For failed pins, you can:

Retry the upload
Check network connectivity
Verify the content is available on IPFS