Rationale

Until swarm is stable, it would be of great benefit to dapps if they can count on content being available from the local node at all times.

Owner

@justelad

Stakeholder Point of Contact

Gregor Žavcer & Zahoor Mohamed

Dependencies

Description

As a user, I want to upload content to my local node so that it is available at all times.
There should be HTTP APIs to do pinning operations

1. POST http://127.0.0.1:8500/bzz-pin:/ to pin an already existing swarm collection
   2)POST http://127.0.0.1:8500/bzz-pin:/?raw=true to pin a existing RAW file
   3)DELETE http://127.0.0.1:8500/bzz-pin:/ to unpin the hash
2. GET http://127.0.0.1:8500/bzz-pin:/ to list all the pinned files, their size, the pincounter.

Context

The pinned content will be made available through the localstore infrastructure. This will require to update the setup of indexes and APIs to access, maintain and retrieve pinned content.

Issues

• Pinned Content in Swarm swarm#1274
• HTTP API support for pinning contents swarm#1658

Acceptance criteria

Upload a RAW file and pin it. The file should be available at all times (for acceptance: 24hrs)
Upload a collection and pin it. The collection should be available at all times (for acceptance: 24hrs)

Proof

Download of the file or collection after 24hrs succeeds.