Origin 24/7 SDK - Energy API module

Description

Energy API module is responsible for managing meter readings. It can accept readings, for which precise proofs are created. The readings themselves are stored in Influx DB.

Module is built to be used with 24/7 applications, that utilize https://github.com/energywebfoundation/origin and other 24/7 packages.

Important information:

1. It saves proof request to database, and waits some time to collect more readings, that can be batched under one proof (one proof can contain one deviceId, but many readings).
2. It queues proof issuance to avoid transaction conflicts.
3. In case of any error during creating proofs, it's saved in database. Successfully processed requests are removed from database.
4. Reading timestamp is rounded down to seconds

Requirements

• Nest.js application (origin-247-energy-api is Nest.js module)
• TypeORM configured
• InfluxDB (v1 or v2)

Installation

1. Import EnergyApi247Module into your application:

import { EnergyApi247Module } from '@energyweb/origin-247-energy-api';

@Module({
    imports: [EnergyApi247Module]
})
export class SomeModule {}

2. Add entities to TypeORM.forRoot entities:

import { entities as EnergyApiEntities } from '@energyweb/origin-247-energy-api';

...
TypeORM.forRoot({
  entities: [
    ...EnergyApiEntities
  ]
})

3. Run migrations on startup:

// package.json
{
    "scripts": {
        "typeorm:run:energy-api": "node_modules/typeorm/cli.js migration:run --config node_modules/@energyweb/origin-247-energy-api/dist/js/ormconfig.js"
    }
}

4. Add necessary configuration environment variables (for Origin Energy API Influx DB):

# --- SMART METER READINGS --- #
INFLUXDB_URL=http://localhost:8086
INFLUXDB_TOKEN=admin:admin
INFLUXDB_ORG=
INFLUXDB_BUCKET=energy/autogen

# Blockchain - deploy key is used for managing proofs on blockchain
WEB3=http://localhost:8545
DEPLOY_KEY=0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaa

Usage

1. Import module (as in installation step)
2. Inject EnergyApi247Facade into your service, and use it to store readings and access readings or proofs.
3. Using ReadingProofProcessedEvent (from NestJS CQRS event bus) you can listen to reading batch being processed and react on that.

Configuration

Environment variables

1. ENERGY_REQUEST_PROCESS_AGGREGATE_SECONDS - default 10 - how long application should wait to aggregate as many readings into batch as possible
2. DEPLOY_KEY - required - used for managing proofs on blockchain. Note, that it cannot be the same as issuer key used in origin-247-certificate, because otherwise transactions will conflict.
3. WEB3 - required - RPC address to which proofs will be published

Questions and Support

For questions and support please use Energy Web's Discord channel

Or reach out to us via email: [email protected]

EW-DOS

The Energy Web Decentralized Operating System is a blockchain-based, multi-layer digital infrastructure.

The purpose of EW-DOS is to develop and deploy an open and decentralized digital operating system for the energy sector in support of a low-carbon, customer-centric energy future.

We develop blockchain technology, full-stack applications and middleware packages that facilitate participation of Distributed Energy Resources on the grid and create open market places for transparent and efficient renewable energy trading.

• To learn about more about the EW-DOS tech stack, see our documentation.

• For an overview of the energy-sector challenges our use cases address, go here.

For a deep-dive into the motivation and methodology behind our technical solutions, we encourage you to read our White Papers:

• Energy Web White Paper on Vision and Purpose
• Energy Web White Paper on Technology Detail

Connect with Energy Web

• Twitter
• Discord
• Telegram