Electra

Sovereign blockchain solution that enables local micro-grid to operate smoothly between trustless actors enabling a real circular economy based on the exchange of electricity units.
https://github.com/alkia/electra

3-phase-inverter 3-phases blockchain circular-economy cosmos-sdk cosmos-sdk-proto electrical-engineering electricity eolian grid grid-system ignite-cli islanding microgrid minigrid monophased off-grid power power-meter solar

Last synced: about 11 hours ago
JSON representation

Repository metadata

This is Electra blockchain's repository for a decentralized micro-grid electricity exchange solution

• Host: GitHub
• URL: https://github.com/alkia/electra
• Owner: Alkia
• License: bsd-3-clause
• Created: 2022-08-11T07:25:22.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2023-12-27T15:16:15.000Z (5 months ago)
• Last Synced: 2024-05-06T06:05:40.859Z (6 days ago)
• Topics: 3-phase-inverter, 3-phases, blockchain, circular-economy, cosmos-sdk, cosmos-sdk-proto, electrical-engineering, electricity, eolian, grid, grid-system, ignite-cli, islanding, microgrid, minigrid, monophased, off-grid, power, power-meter, solar
• Language: TypeScript
• Homepage:
• Size: 53.1 MB
• Stars: 66
• Watchers: 37
• Forks: 107
• Open Issues: 10
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

README

        
![Electra Logo](/vue/public/Electra.png "Electra")

# Electra

**Electra** is a sovereign blockchain solution that enables local micro-grid to operate smoothly between trustless actors enabling a real circular economy based on the exchange of electricity units (kWh) by the means of pre-purchased tokens.

More about [Electra](https://linktr.ee/alkia) on its link tree. 

## The BlockChain based Micro-Grid Architecture

A **micro-grid**, is a local transport structure semi-isolated from the main transport backbone.

![Electra Logo](/vue/public/Concept.jpg "Architecture")

**BlockChain Meters**, are the key element of the solution. 

- They precisely measure the power exchanged

- They are a circuit breaker for the microgrid

- They embed a secure wallet having the capacity to validate the blocks

- They store a full copy of the local chain 

**The Grid Gateway** 

The grid gateway synchronizes the micro-grid and imports extra energy as needed. This gateway is the master node validating the blocks. In some cases the national grid gateway can export energy too should the microgrid and the regulation enables it. 

- The grit All features of a BlockChain meter +

- Demand response 

- Stake/Validate the local Layer 2 BlockChain AS well AS the Layer 1 main chain.

![Electra Logo](/vue/public/Concept.png "The concept") 

## Responsible Disclosure

Send us an email to report any security related bugs or vulnerabilities at [email protected]

You can encrypt your email message using our public PGP key: [Public key](https://raw.githubusercontent.com/Alkia/electra/master/public_key.pgp)

## Get started

**electra** is built using Cosmos SDK and Tendermint.

```

ignite chain serve

```

`serve` command installs dependencies, builds, initializes, and starts your Electra blockchain in development.

### Configure

Your Electra blockchain in development can be configured with `config.yml`. 

## Test from CLI 

To check the current cycle ID your Electra chain reached, run the following command:

```

electrad query meter currentcycle-id 

```

To prepare a bill:

```

electrad tx meter prepare-bill [cycle-id] [record]

```

## Release

To release a new version of your Electra blockchain, create and push a new tag with `v` prefix. A new draft release with the configured targets will be created.

```

git tag v0.1.5

git push origin v0.1.5

```

After a draft release is created, make your final changes from the release page and publish it.

#### Code review format

Opening a pull request (PR) will automatically create Summary and Test plan fields in the description. In the summary, add a high-level summary of what the change entails. For pull requests that scaffold ignite code, include the ignite scaffold commands run.

###### Summary

Add summary of the pull request here (*E.g. This pull request adds XYZ feature to the x/ABC module and associated unit tests.*)

###### Unit tests

To run unit tests for the whole project, execute:

`make unit-test`

To run unit tests for a particular module (e.g. the meter module), execute:

`make unit-test path=meter`

To run unit tests for a particular package (e.g. the meter module), execute:

`make unit-test path=meter/types`

To inspect unit test coverage, execute:

`make test-cover`

### Install

To install the latest version of your Electra blockchain node's binary, execute the following command on your machine:

```

curl https://get.ignite.com/alkia/electra@latest! | sudo bash

```

`alkia/electra` are the `username` and `repo_name` of the Github repository to which the source code is pushed. 

Edit /etc/security/limits.conf

```

$ ulimit -Sn 16384

$ ulimit -Hn 65536

```

### Web Frontend

Electra has a Vue.js-based web app in the `vue` directory. Run the following commands to install dependencies and start the app:

```

cd vue

npm install

npm run serve

```

The frontend app is built using the `@starport/vue` and `@starport/vuex` packages.

## Deploying an Electra node

To deploy a node on testnet-0 please follp the guide: ![Electra Node](https://github.com/Alkia/testnet-0/blob/main/README.md)

## Implementing the blockchain meter

![Electra Logo](/vue/public/ElectraSmartMeter.png "Electra BlockChain Smart Meter")

The smartmeter specs are under validation before first prototypes start moving to production.

Most Standard IEC energy meters will be upgradeable to blockchain meters using the rugged Electra blockchain appliance. The Electra blockchain appliance connects to legacy meters with its infrared data reading cable following IEC 62056 21 standard.

More on the ![IEC 62056 21 standard](https://community.openhab.org/t/reading-power-consumption-of-the-electricity-meter-with-the-ir-interface/94996).

## Testnets

- [electra-testnet-0](https://github.com/Alkia/electra-testnet-0)

## Disclaimer | No Liability

This project is bleeding-edge and does not conform with Poetry package structure.

As far as the law allows, this software comes as is, without any warranty or condition, and no contributor will be liable to anyone for any damages related to this software or this license, under any kind of legal claim.

## References

https://docs.tendermint.com/master/tendermint-core/validators.html

https://hub.cosmos.network/master/validators/overview.html

## Attribution

Electra is proud to be an open-source project, and we welcome all other projects to use our repo. We use modules from the cosmos-sdk and other open source projects.

We have ourselves used the following modules from fellow Cosmos projects. Big thank you to these projects!

We use the following modules from [Osmosis](https://github.com/osmosis-labs/osmosis) provided  under [this License](https://github.com/osmosis-labs/osmosis/blob/main/LICENSE):

 - x/epochs

 - x/mint

 - x/interchainqueries

## Learn more

- [Alkia IT Services Co., Ltd.](https://alkia.net)

- [Link tree](linktr.ee/alkia)

- [Cosmos SDK docs](https://docs.cosmos.network)

- [Developer Chat](https://discord.gg/ignite)

![Link tree QR](/vue/public/LinktreeQR.png "QR to Link Tree")

Done with love for a carbon free world

      

---

Owner metadata

• Name: Max
• Login: Alkia
• Email:
• Kind: user
• Description: Enthusiast Tech & Blockchain evangelist, having experience developing & operating projects. I'am always on the lookout for new exciting challenge to be part of
• Website: www.alkia.net
• Location: Bangkok
• Twitter:
• Company: Alkia IT Services Co., Ltd.
• Icon url: https://avatars.githubusercontent.com/u/17525857?u=2925dade5f50032f343bc6ac73c8727f4fc08cd9&v=4
• Repositories: 4
• Last ynced at: 2023-03-11T11:40:32.312Z
• Profile URL: https://github.com/Alkia

---

GitHub Events

Total

• Create event: 166
• Issues event: 18
• Release event: 92
• Watch event: 271
• Delete event: 147
• Member event: 2
• Issue comment event: 33
• Push event: 334
• Pull request event: 142
• Fork event: 105

Last Year

• Create event: 27
• Delete event: 20
• Fork event: 2
• Issue comment event: 2
• Issues event: 2
• Pull request event: 46
• Push event: 20
• Watch event: 6

---

Committers metadata

Last synced: 2 days ago

Name	Email	Commits
Max	m****e@a****t	206
dependabot[bot]	4****]	13
maxime	m****e@a****g	5
Electra Z	1****Z	5
Developer Experience team at Tendermint	h****o@t****m	1
omahs	7****s	1

Committer domains:

• tendermint.com: 1
• alkia.org: 1
• alkia.net: 1

---

Issue and Pull Request metadata

Last synced: 1 day ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/alkia/electra

---

---

---

Dependencies

Score: 6.122492809514386