Development Guide

Overview

The ledger data service is based on the immutability and time-stamped feature of the blockchain technology. The VeChain ToolChain®️ platform adopts the hash ledger, which is to process raw data using a hashing calculation and upload it via Hash API. VeChain ToolChain®️ will upload the data onto the blockchain. The Hash ledger adopts key-value, with key being VID, and the value being a 32-bytes-long hash value. All the VIDs on VeChain ToolChain®️ are unique, and can be embedded within different devices such as NFC chips, QR codes or data VID.

There are two typical uses of Hash Ledger:

1. Cost control: the hashed data will be limited to 32 bytes, which greatly reduces the use of blockchain storage space and reduces network costs;
2. Data privacy: When you do not want to expose the original data to the end user, you can hash it to make it unreadable to third parties. Hashing encrypts data into a new value (any content, even a punctuation mark, will have a different hash value). Therefore, when the hash value is stored on the blockchain, the end user can only see the hash value on the blockchain, and cannot infer the specific data content.

How to use

Prepare

• Access token

  The access token is used by the VeChain ToolChain®️ back-end server to authenticate the client. Therefore, before calling the VeChain ToolChain®️ api, the client must call the "get token" api to get the access token. The token expires every 24 hours. For details, please refer to here.

• Create operator

  Method 1: Create through VeChain ToolChain®️ console

  1. Log in to the system with an administrator account, click Console->User Management->User List, click new user, and select Supervisors as the role.

     

  2. After the user is created, click Details to view the operatorUID.

     

  Method 2: Create through APIs

  The VeChain ToolChain®️ platform opens up various business capabilities in the form of interfaces. Developers can meet business demands through interface combinations. For creating operator interfaces, please refer to here.

  Note: Enterprises can configure a fixed operator UID to upload data to the blockchain.

Execution order