Exploring promises

How to explore promises through the website?


How to reach the 'Explore promises' page from the website
Go to the Explore promises page from the menu.
The Explore Promises page shows the last created promises, and allows you to search through the available content. You can make a search using a promise name, an Ethereum address, the name or the Twitter handle of a participant.

What does a promise look like?

An example of promise as it is displayed on the website
An example promise as it is displayed on the App.
All information and variables of the promise are stored on-chain, in its own smart contract, and fetched before it can be displayed. The content is requested from IPFS to be displayed as well. There are various sections in the promise card:
Contract address
The address of the contract, generated by the factory when the promise was created. It holds all information, and only its participants can interact with it.
The IPFS hash pointing to the content uploaded by the creator of the promise.
The verification status
Shown as a Ribbon, the verification status is the result of the request to the Chainlink External Adapter, to verify the issuance of the promise, and therefore the reliability of the provided links (cf. IPFS & Arweave verification).
It can hold various states:
Verification pending...
-> The promise was just created, and it is not yet verified.
Not verified
-> The External Adapter could not verify the promise, which means that it was not created through the App. Therefore, the source of the IPFS CID & Arweave ID cannot be insured.
Verified (IPFS)
-> The promise was created using the App. Thus, a deal was made for us to pick up (pin) the content of the promise, through the Filecoin network (cf. Sending to the IPFS network).
Verified (IPFS & Arweave)
-> Everything mentioned above + the content was zipped and sent permanently to the Arweave blockchain, using Bundlr. The archive can be downloaded from Arweave by clicking a link, shown when hovering on the badge.
A Ribbon badge showing the verification status of the promise.
The verification status.
Involved parties
A lock is shown in the header, stating either Locked or Unlocked.
-> The default status: the promise is still being edited by the participants ; they can add new members to the contract, and approve it. Each time a new participant is added, the approvals are revoked, so everyone can approve it again with the new organization. Once all participants have approved, the promise can finally be locked.
-> The promise has been locked by a participant. None can be added anymore, and the approvals cannot be revoked. The participants can still verify their Twitter handle.
The table shows the following sections for each user - the first one being the creator of the promise:
  • Address: the Ethereum address of the user ; if they approved the promise, they used this provided address to perform the transaction.
  • Name: a name chosen by the author of the promise for each participant.
  • Twitter handle: a handle provided by the author of the promise ; it is not required, yet highly recommended.
  • Twitter verified: any handle can be provided during the promise creation ; if this section shows "✓ Yes", it means the ownership of this account was verified for the associated Ethereum address.
  • Promise approved: whether this participant has approved the promise or not, meaning both approving what is included, and corroborating they own this Ethereum address.
IPFS directory
Right in the header is a
icon. It will show the IPFS status of the promise, disclaiming how much peers are currently pinning the content. It also provides its ID, so users can choose to pin this specific content and contribute to making it persistent.
The IPFS directory is displayed just below. If it includes only a PDF, it will be directly embedded. If there are multiple files and/or folders, one can browse through folders in the usual way, and open files by clicking them.
The message shown with peers pinning the IPFS content of a promise.
The pinning status of the promise IPFS content.
The Graph