Sign in now

XLDB is the easiest and most direct way to put blockchain to use. It allows developers and business users alike to utilize blockchain like a regular database without needing to understand or deploy smart contracts.

Create your XLDB by clicking Get Started under XLDB tile and select the network you want XLDB to be deployed on. You can straightaway write data to it.


Write to the XLDB blockchain ledger

Using Xooa console

We can invoke functions directly from the UI. You won’t even need the API token.

  1. Go to the World State tab, and then select Add.

  2. Select Use Sample. It will populate the key and value fields for you.

  3. Click Save.




You have saved data in a blockchain ledger by using Xooa.

Using API Explorer

We can invoke functions from the API documentation, but you will need the API token.

Let’s create an API token first.
  1. Go to the XLDB > Identities tab, and then click Add New.

  2. Enter an identity name and under API Access Permission, select Read+Write.

  3. Click Create. You’ll get a message that the identity has been enrolled and the API token generated.

  4. Before you dismiss the message, click Copy. The token is now in the clipboard.

  5. Store the token somewhere safe. You will need it to authorize every API request.


Xooa does not store the API token. If you lose the token, you will have to generate a new one, invalidating any existing API clients.


Let’s invoke functions from the API documentation.
  1. Go to the API tab, and then click Explore APIs. The API Explorer, including the API documentation, will open.

  2. At the top left, there is an input field for the API token. Paste the token that you copied earlier here.

  3. From the navigation, go to XLDB > Create.

  4. In the key-value field, enter the data you want to store in the ledger in the format:

    [ "<key>", "<value>" ]

  5. Click TRY.



    If your HTTP response code was 200, you have saved data in a blockchain ledger by using Xooa. Check instructions in the message or the API documentation for other return codes.

Read from the XLDB blockchain ledger

  1. To view transactions, go to Transactions tab inside the app.
  2. Click the tx ID to get additional details about the transaction
  3. To view World State, go to World State.
  4. Expand the row from listed states to get the detailed structure of values.

Ledger database videos

Last updated: November 27, 2019