Pyramids

_images/pyramid-blue.png

Multihash pyramids are a way to give a unique address on the network to content that you are regularly updating. It could be a website you’re working on, a blog, a code repository, a distributed web app that you want to share with the world without the hassle of distributing the new cryptographic identifiers of your work every time you’re making some changes.

To ensure that the IPNS records are maintained you can leave the application running (closing the main window will minimize the app to the system tray).

Basic pyramid

The basic pyramid can be seen as a simple stack of IPFS objects, with the top of the pyramid automatically associated with the pyramid’s IPNS key. Just share the IPNS address with whoever you want so that they can always access the latest content.

This pyramid type has no DAG associated to it (it just keeps a history of what you throw at it).

Usage

From the right toolbar, click on the blue pyramid button and then select Create pyramid (basic). After entering the different parameters and validating the dialog, you will see your new pyramid appear in the right toolbar.

Updating the pyramid works by drag-and-dropping IPFS objects on the pyramid (from the filemanager, browser, ipfssearch results …). Just drag-and-drop a valid IPFS object on the pyramid’s button and this object will be at the top of the stack and will be published to the pyramid’s IPNS key.

You can also add the current clipboard item to the pyramid, by using the Add current clipboard item to the pyramid action in the pyramid’s menu.

From the pyramid’s menu you can copy the IPNS address of the pyramid, as well as create a QR code image for the IPNS key.

DAG building pyramids

These types of pyramids have a DAG associated to them. The pyramid’s IPNS key is always matching the latest version of the DAG.