ui-use-key-value-store.adoc

Use the Key-Value store

This section provides instructions on how to use the Manifest Key-Value store. The key-value store allows one to

• Write arbitrary data to the blockchain

• Read arbitrary data from the blockchain

• Update existing data

• Mark data as immutable

• Delete (disable) data

The Manifest Key-Value store feature can be accessed using the Gwen web application.

Requirements

• A MANY identity

• Recent browser

  • Firefox >= 78

  • Safari >= 12

  • Edge >= 79

  • Chrome >= 64

  • Opera >= 51

Instructions

1. Open Gwen

   

2. Login using your MANY identity

   Note	Only Social login, PEM file and seed phrase are currently supported by the kvstore

3. Click on the MANIFEST network menu

   

4. Click on Add Network

5. Set the following values

   

   Name

   MANIFEST KVSTORE

   URL

   https://alpha-testnet.liftedinit.tech/api/kvstore

6. Click on Save

7. Verify that MANIFEST KVSTORE is selected in the network menu

Write arbitrary data

To write new data in the kvstore,

1. Open Gwen

   

2. Click on Services

   

3. Click on Data

   

4. Click on Create New Key

5. Fill the Key and Value fields

   

   Note	The maximum number of bytes for the Key and Value fields is 248 and 64000 respectively.

6. Click on Save

   

Read arbitrary data

The kvstore data is displayed from the Gwen Data page

Update existing data

To update existing data,

1. Click on the icon

2. Fill the Key and Value fields

3. Click on Save

Mark data as immutable

To mark data as immutable,

1. Click on the icon

   

2. Click the Mark Immutable button

   

   Warning

   This operation cannot be undone.

Delete data

To delete existing data,

1. Click on the icon

   

2. Click on the Delete Key button

   

   NOTE

   The data is disabled rather than being deleted; its value still exists but cannot be accessed.

   WARNING

   The deleted key cannot be reused by anyone other than the original owner.