In this guide, we will walk through the Data API and a simple example implementation of an IoT use case. Complete code for this guide can be found in the metagraph examples repo on Github. See the Data API - Water and Energy Use example.
Want more detail?
Looking for additional detail on the Data API and Data Application development? More information is available in Data API.
Before You Start
In order to get started, install dependencies as described in the Quick Start Guide. You will need at least the
metagraph-l1-data containers enabled in your
euclid.json file for this guide.
Example euclid.json values
"github_token": "<your token>",
Run hydra install
./scripts hydra install
Within your Euclid modules directory (source/project/custom-project/modules) you will see three module directories: l0 (metagraph l0), l1 (currency l1), and data_l1 (data l1). Each module has a Main.scala file that defines the application that will run at each corresponding layer.
- custom-project (your-project-name)
Copy Example Files
To get started with this guide, copy everything under the example template/modules directory in the example into your project (custom-project) modules directory.
You'll also need to copy the
scripts directory to a local directory and run
npm install to install the necessary dependencies.
send_data_transaction.js script and fill in the
walletPrivateKey variables. The private key can be generated with the
dag4.keystore.generatePrivateKey() method if you don't already have one.
Once the variables are updated, save the file. You can now run
node send_data_transaction.js to send data to the
Check State Updates
Using the custom endpoint created in the data_l1 Main.scala
routes method, we can check the metagraph state as updates are sent.
Using your browser, navigate to
<your L1 base url>/data-application/addresses to see the complete state including all devices that have sent data. You can also check the state of an individual device using the
<your L1 base url>/data-application/addresses/:address endpoint.
You should see a response like this:
This brief guide demonstrates the ability to update and view on-chain state based on the Currency Framework's Data API. Detailed information about the framework methods used can be found in the example README file and in comments throughout the code. Also see additional break downs of the application lifecycle methods in the Data API section.