{"id":13722976,"url":"https://github.com/Alkia/electra","last_synced_at":"2025-05-07T16:31:34.607Z","repository":{"id":61543837,"uuid":"523625351","full_name":"Alkia/electra","owner":"Alkia","description":"This is Electra blockchain's repository for a decentralized micro-grid electricity exchange solution","archived":false,"fork":false,"pushed_at":"2024-09-24T09:45:12.000Z","size":54885,"stargazers_count":68,"open_issues_count":6,"forks_count":38,"subscribers_count":37,"default_branch":"master","last_synced_at":"2024-10-29T19:54:54.342Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Alkia.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-08-11T07:25:22.000Z","updated_at":"2024-09-10T10:42:51.000Z","dependencies_parsed_at":"2023-09-21T19:33:16.430Z","dependency_job_id":"a90148c6-838b-4661-8500-6220113c8d5f","html_url":"https://github.com/Alkia/electra","commit_stats":{"total_commits":237,"total_committers":6,"mean_commits":39.5,"dds":"0.12236286919831219","last_synced_commit":"7956dbbfbe2216cc506baef2652dc22efef71441"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alkia%2Felectra","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alkia%2Felectra/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alkia%2Felectra/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alkia%2Felectra/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Alkia","download_url":"https://codeload.github.com/Alkia/electra/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224214149,"owners_count":17274524,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2024-08-03T01:01:35.105Z","updated_at":"2024-11-14T12:31:05.582Z","avatar_url":"https://github.com/Alkia.png","language":"TypeScript","readme":"![Electra Logo](/vue/public/Electra.png \"Electra\")\r\n# Electra\r\n**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) through pre-purchased tokens.\r\n\r\nMore about [Electra](https://linktr.ee/alkia) on its link tree. \r\n\r\n## The BlockChain based Micro-Grid Architecture\r\n\r\nA **micro-grid**, is a local transport structure semi-isolated from the main transport backbone.\r\n\r\n![Electra Logo](/vue/public/Concept.jpg \"Architecture\")\r\n\r\n**BlockChain Meters**, are the key element of the solution. \r\n- They precisely measure the power exchanged\r\n- They are a circuit breaker for the microgrid\r\n- They embed a secure wallet having the capacity to validate the blocks\r\n- They store a full copy of the local chain \r\n   \r\n**The Grid Gateway** \r\nThe 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. \r\n\r\n- The grit All features of a BlockChain meter +\r\n- Demand response \r\n- Stake/Validate the local Layer 2 BlockChain AS well AS the Layer 1 main chain.\r\n\r\n![Electra Logo](/vue/public/Concept.png \"The concept\") \r\n\r\n## Responsible Disclosure\r\nSend us an email to report any security related bugs or vulnerabilities at security@alkia.net\r\n\r\nYou can encrypt your email message using our public PGP key: [Public key](https://raw.githubusercontent.com/Alkia/electra/master/public_key.pgp)\r\n\r\n## Get started\r\n\r\n**electra** is built using Cosmos SDK and Tendermint.\r\n\r\n```\r\nignite chain serve\r\n```\r\n\r\n`serve` command installs dependencies, builds, initializes, and starts your Electra blockchain in development.\r\n\r\n### Configure\r\n\r\n\r\nYour Electra blockchain in development can be configured with `config.yml`. \r\n\r\n## Test from CLI \r\n\r\nTo check the current cycle ID your Electra chain reached, run the following command:\r\n```\r\nelectrad query meter currentcycle-id \r\n```\r\nTo prepare a bill:\r\n```\r\nelectrad tx meter prepare-bill [cycle-id] [record]\r\n```\r\n## Release\r\n\r\nTo 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.\r\n\r\n```\r\ngit tag v0.1.5\r\ngit push origin v0.1.5\r\n```\r\n\r\nAfter a draft release is created, make your final changes from the release page and publish it.\r\n\r\n#### Code review format\r\nOpening 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.\r\n###### Summary\r\nAdd summary of the pull request here (*E.g. This pull request adds XYZ feature to the x/ABC module and associated unit tests.*)\r\n###### Unit tests\r\n\r\nTo run unit tests for the whole project, execute:\r\n`make unit-test`\r\nTo run unit tests for a particular module (e.g. the meter module), execute:\r\n`make unit-test path=meter`\r\nTo run unit tests for a particular package (e.g. the meter module), execute:\r\n`make unit-test path=meter/types`\r\nTo inspect unit test coverage, execute:\r\n`make test-cover`\r\n\r\n### Install\r\n\r\nTo install the latest version of your Electra blockchain node's binary, execute the following command on your machine:\r\n\r\n```\r\ncurl https://get.ignite.com/alkia/electra@latest! | sudo bash\r\n```\r\n`alkia/electra` are the `username` and `repo_name` of the Github repository to which the source code is pushed. \r\n\r\nEdit /etc/security/limits.conf\r\n```\r\n$ ulimit -Sn 16384\r\n$ ulimit -Hn 65536\r\n```\r\n\r\n### Web Frontend\r\n\r\nElectra has a Vue.js-based web app in the `vue` directory. Run the following commands to install dependencies and start the app:\r\n\r\n```\r\ncd vue\r\nnpm install\r\nnpm run serve\r\n```\r\n\r\nThe frontend app is built using the `@starport/vue` and `@starport/vuex` packages.\r\n\r\n## Deploying an Electra node\r\nTo deploy a node on testnet-0 please follp the guide: ![Electra Node](https://github.com/Alkia/testnet-0/blob/main/README.md)\r\n\r\n## Implementing the blockchain meter\r\n![Electra Logo](/vue/public/ElectraSmartMeter.png \"Electra BlockChain Smart Meter\")\r\n\r\nThe smartmeter specs are under validation before first prototypes start moving to production.\r\n\r\nMost 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.\r\n\r\nMore on the ![IEC 62056 21 standard](https://community.openhab.org/t/reading-power-consumption-of-the-electricity-meter-with-the-ir-interface/94996).\r\n\r\n## Testnets\r\n\r\n- [electra-testnet-0](https://github.com/Alkia/electra-testnet-0)\r\n\r\n## Disclaimer | No Liability\r\nThis project is bleeding-edge and does not conform with Poetry package structure.\r\n\r\nAs 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.\r\n\r\n## References\r\n\r\nhttps://docs.tendermint.com/master/tendermint-core/validators.html\r\nhttps://hub.cosmos.network/master/validators/overview.html\r\n\r\n## Attribution\r\n\r\nElectra 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.\r\n\r\nWe have ourselves used the following modules from fellow Cosmos projects. Big thank you to these projects!\r\n\r\nWe 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):\r\n - x/epochs\r\n - x/mint\r\n - x/interchainqueries\r\n\r\n## Learn more\r\n- [Alkia IT Services Co., Ltd.](https://alkia.net)\r\n- [Link tree](linktr.ee/alkia)\r\n- [Cosmos SDK docs](https://docs.cosmos.network)\r\n- [Developer Chat](https://discord.gg/ignite)\r\n\r\n\r\n![Link tree QR](/vue/public/LinktreeQR.png \"QR to Link Tree\")\r\n\r\nDone with love for a carbon free world\r\n","funding_links":[],"categories":["Energy Systems"],"sub_categories":["Grid Management and Microgrid"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAlkia%2Felectra","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAlkia%2Felectra","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAlkia%2Felectra/lists"}