From 16895706f43baff40ace5f88d3ed89ef6e53c838 Mon Sep 17 00:00:00 2001 From: "David E. Perez Negron R" Date: Fri, 21 Oct 2022 16:23:16 -0500 Subject: [PATCH 1/4] Migrating from gitlab --- LICENSE | 146 +++++++++++ MaxGreenPoW/MAXCOIN_GREEN_ENERGY_PROPOSAL.md | 241 +++++++++++++++++++ README.md | 3 + _resources/ElectricSchematic.jpg | Bin 0 -> 50610 bytes 4 files changed, 390 insertions(+) create mode 100644 LICENSE create mode 100644 MaxGreenPoW/MAXCOIN_GREEN_ENERGY_PROPOSAL.md create mode 100644 README.md create mode 100644 _resources/ElectricSchematic.jpg diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..5878baf --- /dev/null +++ b/LICENSE @@ -0,0 +1,146 @@ + +GNU Free Documentation License + +Version 1.3, 3 November 2008 + +Copyright © 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc. + +Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. +0. PREAMBLE + +The purpose of this License is to make a manual, textbook, or other functional and useful document "free" in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or without modifying it, either commercially or noncommercially. Secondarily, this License preserves for the author and publisher a way to get credit for their work, while not being considered responsible for modifications made by others. + +This License is a kind of "copyleft", which means that derivative works of the document must themselves be free in the same sense. It complements the GNU General Public License, which is a copyleft license designed for free software. + +We have designed this License in order to use it for manuals for free software, because free software needs free documentation: a free program should come with manuals providing the same freedoms that the software does. But this License is not limited to software manuals; it can be used for any textual work, regardless of subject matter or whether it is published as a printed book. We recommend this License principally for works whose purpose is instruction or reference. +1. APPLICABILITY AND DEFINITIONS + +This License applies to any manual or other work, in any medium, that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License. Such a notice grants a world-wide, royalty-free license, unlimited in duration, to use that work under the conditions stated herein. The "Document", below, refers to any such manual or work. Any member of the public is a licensee, and is addressed as "you". You accept the license if you copy, modify or distribute the work in a way requiring permission under copyright law. + +A "Modified Version" of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modifications and/or translated into another language. + +A "Secondary Section" is a named appendix or a front-matter section of the Document that deals exclusively with the relationship of the publishers or authors of the Document to the Document's overall subject (or to related matters) and contains nothing that could fall directly within that overall subject. (Thus, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any mathematics.) The relationship could be a matter of historical connection with the subject or with related matters, or of legal, commercial, philosophical, ethical or political position regarding them. + +The "Invariant Sections" are certain Secondary Sections whose titles are designated, as being those of Invariant Sections, in the notice that says that the Document is released under this License. If a section does not fit the above definition of Secondary then it is not allowed to be designated as Invariant. The Document may contain zero Invariant Sections. If the Document does not identify any Invariant Sections then there are none. + +The "Cover Texts" are certain short passages of text that are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says that the Document is released under this License. A Front-Cover Text may be at most 5 words, and a Back-Cover Text may be at most 25 words. + +A "Transparent" copy of the Document means a machine-readable copy, represented in a format whose specification is available to the general public, that is suitable for revising the document straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters. A copy made in an otherwise Transparent file format whose markup, or absence of markup, has been arranged to thwart or discourage subsequent modification by readers is not Transparent. An image format is not Transparent if used for any substantial amount of text. A copy that is not "Transparent" is called "Opaque". + +Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo input format, LaTeX input format, SGML or XML using a publicly available DTD, and standard-conforming simple HTML, PostScript or PDF designed for human modification. Examples of transparent image formats include PNG, XCF and JPG. Opaque formats include proprietary formats that can be read and edited only by proprietary word processors, SGML or XML for which the DTD and/or processing tools are not generally available, and the machine-generated HTML, PostScript or PDF produced by some word processors for output purposes only. + +The "Title Page" means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the material this License requires to appear in the title page. For works in formats which do not have any title page as such, "Title Page" means the text near the most prominent appearance of the work's title, preceding the beginning of the body of the text. + +The "publisher" means any person or entity that distributes copies of the Document to the public. + +A section "Entitled XYZ" means a named subunit of the Document whose title either is precisely XYZ or contains XYZ in parentheses following text that translates XYZ in another language. (Here XYZ stands for a specific section name mentioned below, such as "Acknowledgements", "Dedications", "Endorsements", or "History".) To "Preserve the Title" of such a section when you modify the Document means that it remains a section "Entitled XYZ" according to this definition. + +The Document may include Warranty Disclaimers next to the notice which states that this License applies to the Document. These Warranty Disclaimers are considered to be included by reference in this License, but only as regards disclaiming warranties: any other implication that these Warranty Disclaimers may have is void and has no effect on the meaning of this License. +2. VERBATIM COPYING + +You may copy and distribute the Document in any medium, either commercially or noncommercially, provided that this License, the copyright notices, and the license notice saying this License applies to the Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this License. You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of copies you must also follow the conditions in section 3. + +You may also lend copies, under the same conditions stated above, and you may publicly display copies. +3. COPYING IN QUANTITY + +If you publish printed copies (or copies in media that commonly have printed covers) of the Document, numbering more than 100, and the Document's license notice requires Cover Texts, you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly identify you as the publisher of these copies. The front cover must present the full title with all words of the title equally prominent and visible. You may add other material on the covers in addition. Copying with changes limited to the covers, as long as they preserve the title of the Document and satisfy these conditions, can be treated as verbatim copying in other respects. + +If the required texts for either cover are too voluminous to fit legibly, you should put the first ones listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacent pages. + +If you publish or distribute Opaque copies of the Document numbering more than 100, you must either include a machine-readable Transparent copy along with each Opaque copy, or state in or with each Opaque copy a computer-network location from which the general network-using public has access to download using public-standard network protocols a complete Transparent copy of the Document, free of added material. If you use the latter option, you must take reasonably prudent steps, when you begin distribution of Opaque copies in quantity, to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public. + +It is requested, but not required, that you contact the authors of the Document well before redistributing any large number of copies, to give them a chance to provide you with an updated version of the Document. +4. MODIFICATIONS + +You may copy and distribute a Modified Version of the Document under the conditions of sections 2 and 3 above, provided that you release the Modified Version under precisely this License, with the Modified Version filling the role of the Document, thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it. In addition, you must do these things in the Modified Version: + + A. Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, and from those of previous versions (which should, if there were any, be listed in the History section of the Document). You may use the same title as a previous version if the original publisher of that version gives permission. + B. List on the Title Page, as authors, one or more persons or entities responsible for authorship of the modifications in the Modified Version, together with at least five of the principal authors of the Document (all of its principal authors, if it has fewer than five), unless they release you from this requirement. + C. State on the Title page the name of the publisher of the Modified Version, as the publisher. + D. Preserve all the copyright notices of the Document. + E. Add an appropriate copyright notice for your modifications adjacent to the other copyright notices. + F. Include, immediately after the copyright notices, a license notice giving the public permission to use the Modified Version under the terms of this License, in the form shown in the Addendum below. + G. Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document's license notice. + H. Include an unaltered copy of this License. + I. Preserve the section Entitled "History", Preserve its Title, and add to it an item stating at least the title, year, new authors, and publisher of the Modified Version as given on the Title Page. If there is no section Entitled "History" in the Document, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence. + J. Preserve the network location, if any, given in the Document for public access to a Transparent copy of the Document, and likewise the network locations given in the Document for previous versions it was based on. These may be placed in the "History" section. You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission. + K. For any section Entitled "Acknowledgements" or "Dedications", Preserve the Title of the section, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein. + L. Preserve all the Invariant Sections of the Document, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles. + M. Delete any section Entitled "Endorsements". Such a section may not be included in the Modified Version. + N. Do not retitle any existing section to be Entitled "Endorsements" or to conflict in title with any Invariant Section. + O. Preserve any Warranty Disclaimers. + +If the Modified Version includes new front-matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document, you may at your option designate some or all of these sections as invariant. To do this, add their titles to the list of Invariant Sections in the Modified Version's license notice. These titles must be distinct from any other section titles. + +You may add a section Entitled "Endorsements", provided it contains nothing but endorsements of your Modified Version by various parties—for example, statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard. + +You may add a passage of up to five words as a Front-Cover Text, and a passage of up to 25 words as a Back-Cover Text, to the end of the list of Cover Texts in the Modified Version. Only one passage of Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any one entity. If the Document already includes a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one. + +The author(s) and publisher(s) of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version. +5. COMBINING DOCUMENTS + +You may combine the Document with other documents released under this License, under the terms defined in section 4 above for modified versions, provided that you include in the combination all of the Invariant Sections of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice, and that you preserve all their Warranty Disclaimers. + +The combined work need only contain one copy of this License, and multiple identical Invariant Sections may be replaced with a single copy. If there are multiple Invariant Sections with the same name but different contents, make the title of each such section unique by adding at the end of it, in parentheses, the name of the original author or publisher of that section if known, or else a unique number. Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work. + +In the combination, you must combine any sections Entitled "History" in the various original documents, forming one section Entitled "History"; likewise combine any sections Entitled "Acknowledgements", and any sections Entitled "Dedications". You must delete all sections Entitled "Endorsements". +6. COLLECTIONS OF DOCUMENTS + +You may make a collection consisting of the Document and other documents released under this License, and replace the individual copies of this License in the various documents with a single copy that is included in the collection, provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects. + +You may extract a single document from such a collection, and distribute it individually under this License, provided you insert a copy of this License into the extracted document, and follow this License in all other respects regarding verbatim copying of that document. +7. AGGREGATION WITH INDEPENDENT WORKS + +A compilation of the Document or its derivatives with other separate and independent documents or works, in or on a volume of a storage or distribution medium, is called an "aggregate" if the copyright resulting from the compilation is not used to limit the legal rights of the compilation's users beyond what the individual works permit. When the Document is included in an aggregate, this License does not apply to the other works in the aggregate which are not themselves derivative works of the Document. + +If the Cover Text requirement of section 3 is applicable to these copies of the Document, then if the Document is less than one half of the entire aggregate, the Document's Cover Texts may be placed on covers that bracket the Document within the aggregate, or the electronic equivalent of covers if the Document is in electronic form. Otherwise they must appear on printed covers that bracket the whole aggregate. +8. TRANSLATION + +Translation is considered a kind of modification, so you may distribute translations of the Document under the terms of section 4. Replacing Invariant Sections with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections. You may include a translation of this License, and all the license notices in the Document, and any Warranty Disclaimers, provided that you also include the original English version of this License and the original versions of those notices and disclaimers. In case of a disagreement between the translation and the original version of this License or a notice or disclaimer, the original version will prevail. + +If a section in the Document is Entitled "Acknowledgements", "Dedications", or "History", the requirement (section 4) to Preserve its Title (section 1) will typically require changing the actual title. +9. TERMINATION + +You may not copy, modify, sublicense, or distribute the Document except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense, or distribute it is void, and will automatically terminate your rights under this License. + +However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation. + +Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice. + +Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, receipt of a copy of some or all of the same material does not give you any rights to use it. +10. FUTURE REVISIONS OF THIS LICENSE + +The Free Software Foundation may publish new, revised versions of the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. See https://www.gnu.org/licenses/. + +Each version of the License is given a distinguishing version number. If the Document specifies that a particular numbered version of this License "or any later version" applies to it, you have the option of following the terms and conditions either of that specified version or of any later version that has been published (not as a draft) by the Free Software Foundation. If the Document does not specify a version number of this License, you may choose any version ever published (not as a draft) by the Free Software Foundation. If the Document specifies that a proxy can decide which future versions of this License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Document. +11. RELICENSING + +"Massive Multiauthor Collaboration Site" (or "MMC Site") means any World Wide Web server that publishes copyrightable works and also provides prominent facilities for anybody to edit those works. A public wiki that anybody can edit is an example of such a server. A "Massive Multiauthor Collaboration" (or "MMC") contained in the site means any set of copyrightable works thus published on the MMC site. + +"CC-BY-SA" means the Creative Commons Attribution-Share Alike 3.0 license published by Creative Commons Corporation, a not-for-profit corporation with a principal place of business in San Francisco, California, as well as future copyleft versions of that license published by that same organization. + +"Incorporate" means to publish or republish a Document, in whole or in part, as part of another Document. + +An MMC is "eligible for relicensing" if it is licensed under this License, and if all works that were first published under this License somewhere other than this MMC, and subsequently incorporated in whole or in part into the MMC, (1) had no cover texts or invariant sections, and (2) were thus incorporated prior to November 1, 2008. + +The operator of an MMC Site may republish an MMC contained in the site under CC-BY-SA on the same site at any time before August 1, 2009, provided the MMC is eligible for relicensing. +ADDENDUM: How to use this License for your documents + +To use this License in a document you have written, include a copy of the License in the document and put the following copyright and license notices just after the title page: + + Copyright (C) 2022 DECENTRALIZED CLIMATE FOUNDATION A.C. + Permission is granted to copy, distribute and/or modify this document + under the terms of the GNU Free Documentation License, Version 1.3 + or any later version published by the Free Software Foundation; + with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. + A copy of the license is included in the section entitled "GNU + Free Documentation License". + +If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, replace the "with … Texts." line with this: + + with the Invariant Sections being LIST THEIR TITLES, with the + Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST. + +If you have Invariant Sections without Cover Texts, or some other combination of the three, merge those two alternatives to suit the situation. + +If your document contains nontrivial examples of program code, we recommend releasing these examples in parallel under your choice of free software license, such as the GNU General Public License, to permit their use in free software. diff --git a/MaxGreenPoW/MAXCOIN_GREEN_ENERGY_PROPOSAL.md b/MaxGreenPoW/MAXCOIN_GREEN_ENERGY_PROPOSAL.md new file mode 100644 index 0000000..a79e6c8 --- /dev/null +++ b/MaxGreenPoW/MAXCOIN_GREEN_ENERGY_PROPOSAL.md @@ -0,0 +1,241 @@ +# MAXCOIN GREEN ENERGY PROPOSAL + +## LICENSE + +``` +Copyright (C) DECENTRALIZED CLIMATE FOUNDATION A.C. +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.3 +or any later version published by the Free Software Foundation; +with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. +A copy of the license is included in the section entitled "GNU +Free Documentation License". +``` + +## DESCRIPTION + +A system which can be a functional low scale proof of concept, by tracing real green energy data and representing it as tokens plus a proof of work that ensures the security and online operation consistency in an embedded hardware attached to a solar panel, we intend to achieve the original Satoshi vision (decentralization, and avoid double counting) and thus tokenize measured data with a small range of error. + +The goal the following document is a proposal for building a proof of concept system with both hardware and software in a small scale model, this work is not only limited to that but also making some proposals that consider 3rd generation blockchains developments such as the blockchain trilemma , DAOs for management of trust and verification of Green Energy datasets based on embedded open hardware technology, Liquidity Pools and Energy pools (Batteries) with real parity between the real energy and tokens representations of energy. + +Following a fully free software as following the main philosophies of the Maxcoin Project (Max Current) and Decentralized Climate Foundation, and finally taking the DECA 2.0 protocol and Maxcoin’s Blockchain as base technologies and other second layer and multichain solutions, as base technologies that will ensure the security and scalability of the system. + +## MVP GOALS + +## ELECTRICAL SCHEMATIC + + +![ElectricSchematic.jpg](../_resources/ElectricSchematic.jpg) + + +## USE CASE + +```plantuml +@startuml +title MAXCOIN GREEN ENERGY PROPOSAL USE CASES +left to right direction +skinparam packageStyle rect +skinparam actorStyle awesome + +actor "MultiChain Miner" as MM +actor "Technical DAO" as TDAO + +rectangle "DECA2 DAPP" as DAPP { + usecase "Gets MultiChain Miner Request" as DAPP1 + usecase "Approves MultiChain Miner Request " as DAPP2 + usecase "Set MultiChain Miner SBT attributes" as DAPP3 + usecase "Gets mint request" as DAPP4 + usecase "Approved Minting (Baliot)" as DAPP5 + usecase "Gets Payment Request Order" as DAPP6 + usecase "Gets Energy Measurement Data" as DAPP7 + usecase "Verifies Payment Request Order" as DAPP8 + usecase "Gets SBT" as DAPP9 + usecase "Verify all data and vote" as DAPP10 + usecase "Not Approved" as DAPP11 + usecase "Votes module update" as DAPP12 + usecase "Mints DECA" as DAPP13 + usecase "Mints Energy Token" as DAPP14 + usecase "Fills Energy Request" as DAPP15 + + rectangle DAO_Vaults{ + usecase "Stores DECA2" as DV1 + } +} +MM -right- DAPP1 +TDAO -left- DAPP2 +MM -right- DAPP3 +MM -right- DAPP4 +MM -right- DAPP15 +DAPP2 .down.> DAPP1 : <> +DAPP2 .down.> DAPP3 : <> +DAPP3 .down.> DAPP9 : <> +TDAO -left- DAPP4 +DAPP4 .down.> DAPP10: <> +DAPP5 .down.> DAPP10: <> +DAPP11 .down.> DAPP10: <> +DAPP5 .down.> DAPP13: <> +DAPP5 .down.> DAPP14: <> +DAPP13 .down.> DV1: <> +MM -right- DAPP6 +TDAO -left- DAPP8 + + +rectangle "DECA2 DistributedDB" as DOD { + usecase "Stores Energy Measurements" as ODB1 + usecase "Updates Measured Sent Energy" as ODB2 + usecase "Stores Received Energy Data" as ODB3 + usecase "Updates Measured Received Energy" as ODB4 + usecase "Verifies Data Integrity Reltated to the Miner" as ODB5 + usecase "Provides Access to the DECA2 DAPP" as ODB6 + usecase ODB7 as "Stores SBT Miner Data: + -- + Mining Pool Data + Miner Hardware Status" + usecase "Updates Mining Pool Data" as ODB8 + usecase "Updates Miner HW Status" as ODB9 +} + +note right of ODB3: Verify Transmision Loss + +MM -right- ODB1 +MM -right- ODB2 +MM -right- ODB4 +TDAO -left- ODB5 +DAPP7 .> ODB6: <> +DAPP3 .> ODB7: <> +ODB8 .down.> ODB7: <> +ODB9 .down.> ODB7: <> +DAPP9 .up.> ODB7: <> + +TDAO -left- DAPP12 +MM -right- DAPP12 +TDAO -left- DAPP10 + +rectangle "Node Storage Energy" as NSE { + usecase "Accepts Energy Storage Request" as NSE1 + usecase "Update Measured Received Energy" as NSE2 + usecase "Accepts Energy Take Out Request" as NSE3 + usecase "Transfers Energy to the Miner" as NSE4 +} +MM -right- NSE1 +MM -right- NSE4 +NSE3 .> NSE4: <> +NSE2 .> ODB3 : <> +NSE3 .> DAPP15: <> + +rectangle "MaxCoin Green Mining Pool" as MMP { + usecase "Stores Online Miner Time + Hashes" as MMP1 + usecase "Uploads Data" as MMP2 + usecase "Logs in with SBT" as MMP3 +} +MMP2 .> ODB7 +MM -- MMP3 +MMP3 .> MMP1: <> + +rectangle "Liquidity Pool" as LP{ + usecase "Gets % per transaction" as LP1 + usecase "Swaps Tokens" as LP2 + usecase "Provides liquidity DECA2/Energy Tokens" as LP3 + usecase "Gets Energy Tokens" as LP4 +} + +MM -right- LP1 +MM -right- LP2 +MM -right- LP4 +DV1.> LP1 : <> +DV1.> LP3 : <> +DAPP14.> LP3 : <> + +note right of LP + Paired with DECA2 + Paired with Carbon Token +end note +@enduml +``` + +## COMPONENT DIAGRAM + +## SEQUENCE DIAGRAM + +```plantuml +@startuml +participant "Multichain Miner" as MM +participant "Technical DAO" as DAO +participant "MAXCoin Mining Pool" as MMP +participant "DECA2 DistributedDB" as DOD +participant "DECA2 DAPP" as DAPP +participant "Liquidity Pool" as LP +participant "Node Storage Energy" as NSE +MM->DAPP: Applies for getting a clean energy system (miner) +activate DAPP +DAO->DAPP: Verifies and Approves Applications +DAPP-->MM: Gets a SBT paired the clean energy system (miner) +deactivate DAPP + loop Operation Process + MM->MMP: Starts PoW the mining Process + MM->DOD: Stores Energy Measurements + alt if "Sells Excess of Energy" + MM->NSE: Start sending energy to the NSE + MM->DOD: Updates Measured Sent Energy + NSE->DOD: Stores Received Energy (-looses) + MM->DOD: Updates Measured Received Energy + MM->DAPP: Request Payment (Example Monthly) + activate DAPP + DAPP->DOD: Gets Measurments + DAO->DAPP: Verifies Payment Request Order + DAO->DOD: Verifies data integrity related to the Miner + DAO->MMP: Verifies Continues MaxCoin Mining data + DAO->MM: Verifies Miner Hardware Integrity + DAO->DAPP: DAO Votes If Complies + alt if "it gets approved" + DAPP->LP: Mints DECA(EnergyToken to LP) + DAPP->LP: Mints MaxCoin (Pay to LP) + DAPP->DAO: Mints DECA/Maxcoin Payment to DAO + deactivate DAPP + else if "it does not" + DAO-->DOD: Update Status + DAO-->MM: Request Updates + end + else if "Buys Energy" + '-------------------------TODO + LP-->MM: Gets Energy Tokens + MM->DAPP: Sets Fill Energy Request + NSE->DAPP: Accepts Requests + NSE-->MM: Sends Energy to the Miner + end + end + LP->LP: Generates % for\nthe Miner and the NSE + alt if Miner Requests EnergyToken + MM->LP: Request EnergyToken + LP->MM: Gets EnergyToken + else if Miner Requests Maxcoin + MM->LP: Request Maxcoin + LP->MM: Gets Maxcoin equivalent to EnergyToken owned + end +@enduml +``` + +## GANTT DIAGRAM + +## FUTURE ACHIEVABLES + +## CONCLUSION + +## REFERENCES + +\[1\] Manisa Pipattanasomporn; Murat Kuzlu; Saifur Rahman, "A Blockchain-based Platform for Exchange of Solar Energy: Laboratory-scale Implementation", https://ieeexplore.ieee.org/stamp/stamp.jsp?tp=&arnumber=8635679, 2018. + +\[2\] Joint Research Centre (JRC), "Energy system blockchain solutions", https://ses.jrc.ec.europa.eu/node/31977, October 2022. + +\[3\] Anselma Wörner, Arne Meeuw, Liliane Ableitner, Felix Wortmann, Sandro Schopfer and +Verena Tiefenbeck, "Trading solar energy within the neighborhood: field implementation of a blockchain-based electricity market",https://energyinformatics.springeropen.com/track/pdf/10.1186/s42162-019-0092-0.pdf, September 2019. + +\[4\] Merlinda Andoni, Valentin Robu, David Flynn, Simone Abram, Dale Geach, David Jenkins, Peter McCallum, Andrew Peacock, "Blockchain technology in the energy sector: A systematic review of challenges and opportunities", https://www.sciencedirect.com/science/article/pii/S1364032118307184?via%3Dihub,  February 2019. + +\[5\] Subin Kwak, Joohyung Lee, Jangkyum Kim, and Hyeontaek Oh, "EggBlock: Design and Implementation of Solar Energy Generation and Trading Platform in Edge-Based IoT Systemswith Blockchain", https://www.ncbi.nlm.nih.gov/pmc/articles/PMC8951093/pdf/sensors-22-02410.pdf, March 2022. + +\[6\] Naiyu Wang, Xiao Zhou, Xin Lu, Zhitao Guan, "When Energy Trading meets Blockchain in ElectricalPower System: The State of the Art", https://arxiv.org/ftp/arxiv/papers/1902/1902.07233.pdf, 2018. + +\[7\] Energypedia.info, "Blockchain Techologies For the Energy Access Sector", [https://energypedia.info/wiki/Blockchain\_Techologies\_For\_the\_Energy\_Access\_Sector#ImpactPPA](https://energypedia.info/wiki/Blockchain_Techologies_For_the_Energy_Access_Sector#ImpactPPA), 2022. + + diff --git a/README.md b/README.md new file mode 100644 index 0000000..636dc5d --- /dev/null +++ b/README.md @@ -0,0 +1,3 @@ +# MaxCoin Green Energy + +MAXCOIN Green Energy diff --git a/_resources/ElectricSchematic.jpg b/_resources/ElectricSchematic.jpg new file mode 100644 index 0000000000000000000000000000000000000000..3b3831da4d634d527f33e9da4f6bbb99de7f20d8 GIT binary patch literal 50610 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 c Date: Tue, 25 Oct 2022 19:57:09 -0500 Subject: [PATCH 2/4] Diagrams Updates --- MaxGreenPoW/MAXCOIN_GREEN_ENERGY_PROPOSAL.md | 7 ++++++- .../components_diagram.jpg | Bin MaxGreenPoW/network_diagram.png | Bin 0 -> 102771 bytes 3 files changed, 6 insertions(+), 1 deletion(-) rename _resources/ElectricSchematic.jpg => MaxGreenPoW/components_diagram.jpg (100%) create mode 100644 MaxGreenPoW/network_diagram.png diff --git a/MaxGreenPoW/MAXCOIN_GREEN_ENERGY_PROPOSAL.md b/MaxGreenPoW/MAXCOIN_GREEN_ENERGY_PROPOSAL.md index a79e6c8..71e526f 100644 --- a/MaxGreenPoW/MAXCOIN_GREEN_ENERGY_PROPOSAL.md +++ b/MaxGreenPoW/MAXCOIN_GREEN_ENERGY_PROPOSAL.md @@ -25,7 +25,6 @@ Following a fully free software as following the main philosophies of the Maxcoi ## ELECTRICAL SCHEMATIC -![ElectricSchematic.jpg](../_resources/ElectricSchematic.jpg) ## USE CASE @@ -155,6 +154,12 @@ end note ## COMPONENT DIAGRAM +![Components Diagram](components_diagram.jpg) + +## NETWORK DIAGRAM + +![NETWORK Diagram](components_diagram.jpg) + ## SEQUENCE DIAGRAM ```plantuml diff --git a/_resources/ElectricSchematic.jpg b/MaxGreenPoW/components_diagram.jpg similarity index 100% rename from _resources/ElectricSchematic.jpg rename to MaxGreenPoW/components_diagram.jpg diff --git a/MaxGreenPoW/network_diagram.png b/MaxGreenPoW/network_diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..ca40e4894795308ac7b43d92511d5ef9fbbb02d0 GIT binary patch literal 102771 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�Px5&kOMmH{VX%w&v)CE} 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⁣6nl`6kh)>7Fs7nnihbPfM0U>*$E0wV&n&4 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 Date: Tue, 25 Oct 2022 20:01:34 -0500 Subject: [PATCH 3/4] Hotfix diagram name error --- MaxGreenPoW/MAXCOIN_GREEN_ENERGY_PROPOSAL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/MaxGreenPoW/MAXCOIN_GREEN_ENERGY_PROPOSAL.md b/MaxGreenPoW/MAXCOIN_GREEN_ENERGY_PROPOSAL.md index 71e526f..cd71444 100644 --- a/MaxGreenPoW/MAXCOIN_GREEN_ENERGY_PROPOSAL.md +++ b/MaxGreenPoW/MAXCOIN_GREEN_ENERGY_PROPOSAL.md @@ -158,7 +158,7 @@ end note ## NETWORK DIAGRAM -![NETWORK Diagram](components_diagram.jpg) +![NETWORK Diagram](network_diagram.png) ## SEQUENCE DIAGRAM From 48d51ae0043a9bc0409f0441498e66e109c9ab71 Mon Sep 17 00:00:00 2001 From: HackMD <37423+hackmd-hub[bot]@users.noreply.github.com> Date: Tue, 3 Jan 2023 23:10:07 +0000 Subject: [PATCH 4/4] last changed at Jan 3, 2023 5:01 PM, pushed by P1R0 First Version Release --- MaxGreenPoW/MAXCOIN_GREEN_ENERGY_PROPOSAL.md | 412 ++++++++++++++++++- 1 file changed, 393 insertions(+), 19 deletions(-) diff --git a/MaxGreenPoW/MAXCOIN_GREEN_ENERGY_PROPOSAL.md b/MaxGreenPoW/MAXCOIN_GREEN_ENERGY_PROPOSAL.md index cd71444..5cef0f7 100644 --- a/MaxGreenPoW/MAXCOIN_GREEN_ENERGY_PROPOSAL.md +++ b/MaxGreenPoW/MAXCOIN_GREEN_ENERGY_PROPOSAL.md @@ -1,4 +1,9 @@ -# MAXCOIN GREEN ENERGY PROPOSAL +# MAXCOIN CLEAN ENERGY PROPOSAL + +:::info +#### Table of Contents +[TOC] +::: ## LICENSE @@ -9,22 +14,271 @@ under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU -Free Documentation License". +Free Documentation License". ``` ## DESCRIPTION A system which can be a functional low scale proof of concept, by tracing real green energy data and representing it as tokens plus a proof of work that ensures the security and online operation consistency in an embedded hardware attached to a solar panel, we intend to achieve the original Satoshi vision (decentralization, and avoid double counting) and thus tokenize measured data with a small range of error. -The goal the following document is a proposal for building a proof of concept system with both hardware and software in a small scale model, this work is not only limited to that but also making some proposals that consider 3rd generation blockchains developments such as the blockchain trilemma , DAOs for management of trust and verification of Green Energy datasets based on embedded open hardware technology, Liquidity Pools and Energy pools (Batteries) with real parity between the real energy and tokens representations of energy. - -Following a fully free software as following the main philosophies of the Maxcoin Project (Max Current) and Decentralized Climate Foundation, and finally taking the DECA 2.0 protocol and Maxcoin’s Blockchain as base technologies and other second layer and multichain solutions, as base technologies that will ensure the security and scalability of the system. ## MVP GOALS -## ELECTRICAL SCHEMATIC +The goal the following document is a proposal for building a proof of concept system with both hardware and software in a small scale model, this work is not only limited to that but also making some proposals that consider 3rd generation blockchains developments such as the blockchain trilemma , DAOs for management of trust and verification of Clean Energy datasets based on embedded open hardware technology, Liquidity Pools and Energy pools (Batteries) with real parity between the real energy and tokens representations of energy. + +Following a fully free software as following the main philosophies of the Maxcoin Project (Max Current) and Decentralized Climate Foundation, and finally taking the DECA 2.0 protocol and Maxcoin’s Blockchain as base technologies and other second layer and multichain solutions, as base technologies that will ensure the security and scalability of the system. + +## COMPONENT DIAGRAM + +![](https://i.imgur.com/xSp0jG3.png) +Img1. Maxcoin Clean Energy Component Diagram +**Photovoltaic cells.** + +To take advantage of this energy from solar radiation, a photovoltaic cell is needed. Photovoltaic cells generate electricity directly from the electrons released by the interaction of radiant energy with the semiconductor materials of the photovoltaic cells. Sunlight is made up of photons, or beams of radiant energy. When photons strike a photovoltaic cell, they can be reflected, absorbed, or transmitted through the cell. Only absorbed photons generate electricity. + +A photovoltaic cell is a device that is used to convert sunlight into electricity by the photovoltaic effect, that is, it is a transducer that converts the radiant energy of the Sun directly into electricity and is basically a semiconductor diode capable of developing a voltage of 0.5-1.0 V and a current density of 20-40 mA/cm2 depending on the materials used for its manufacture and the sunlight conditions. In the figure, you can see the electrical symbol of a photovoltaic cell in which the current flows from cathode to anode, that is, it flows internally from the semiconductor type N to type P (opposite to the direction of a diode) towards a resistance. + +![](https://i.imgur.com/PGQtdCc.png) + +Img2. Electrical symbol of a photovoltaic cell. + +**Photovoltaic cell components.** + +Every modern solar cell usually consists of the following components: + +* **Glass plate.** It is one that allows light to enter the cells and protects the semiconductors in the cell from the elements. + +* **Anti-reflective layer.** It is the one that is between the glass plate and the semiconductor, and has the function of minimizing the loss of light by reflection. + +* **The n-type semiconductor layer.** It is one that has a concentration of excited electrons greater than that of the p-type layer, which causes the electrical charges of this layer to pass to the p-type layer, causing a potential difference with the other layer. + +* **N-type and P-type semiconductor plate.** It is the one in which the n-type and p-type semiconductors are placed and are linked through a path or pathway that acts as a conductor through which the electrons circulate to go from the n-type to the p-type semiconductor, generating an electric field in this cable. + +* **The p-type semiconductor layer.** It is one that has an electron deficiency, which attracts the excited electrons from the n-type layer, causing a potential difference to be generated between the two layers of the semiconductor. + +![](https://i.imgur.com/coTt6f9.png) + +Img3. Main elements and functions of a photovoltaic cell. + + + +**Types of photovoltaic cells.** + +There are different technologies on the market, each of them has different characteristics. Silicon-based technologies currently account for 90% of global photovoltaic production and are the most dominant technologies. There are mainly three types of cells on the market according to the crystal type technology, all of them made of silicon. + +**Crystalline silicon**. + +It has an efficiency of 22%. +* Made up of a single crystal of very high purity silicon. +* They have very good performance and a useful life of up to 25 years. +* They are of the highest price in the market. +* Homogeneous blue color. + +**Multicrystalline silicon.** + + It has an efficiency of 18%. +* Made of silicon mixed with Arsenium and Gallium. +* Lower price compared to the previous one. +* Yield less than 20 years. +* Color with different shades of blue. + +**Amorphous.** + + It has an efficiency of 13%. +* Made of a thin layer of silicon. +* Performance and low prices. +* Homogeneous brown color. + +**Solar panel.** + +A solar panel, also called a photovoltaic module, is a set of cells electrically interconnected and protected against the elements, usually with a tempered glass front cover and a tempered aluminum frame that facilitates transport and installation. + +A certain number of solar cells are electrically associated in the panel and the entire compact is protected by sealing it under vacuum, see figure. + +![](https://i.imgur.com/FGsHYxa.png) + +Img4. Diagram illustrating the composition of a solar panel + +**Electrical characteristics of a solar panel.** + +In the documentation provided by the manufacturer, as well as in the label attached to the solar panel, there is an electrical terminology that, in addition to general information on the product, the type of cell, the physical characteristics of the panel (width, length, thickness and the weight), the type of connection box, diagram or description with the distances of the fixing holes of the frame, what is called the I-V curve (intensity-voltage curve) of the solar panel appears. The standard test conditions (CEP) or STC (from English: Standard Test Conditions) are those laboratory conditions under which the power of a solar panel is measured and established. They correspond to a radiant light intensity of 1000 W/m^2 and a cell temperature of 25 ºC. Here, the maximum power (P max) that the panel can supply, the short-circuit current (Icc) and the open-circuit voltage (V oc) are measured. The knowledge of the three mentioned parameters P max., I cc, and V oc is enough to know the behavior of the panel in any operating condition defined by an irradiance value. + +**Environmental effects on solar panels.** + +The working temperature of the cells can be 20º to 25 ºC higher than room temperature. And, as in many electrical and/or electronic devices, excessive temperatures reduce effectiveness. As the cell temperature increases, the module current increases moderately while the voltage decreases significantly. + +**Classification of photovoltaic systems.** + +Depending on the functional and operational requirements of a system, there are isolated or independent systems, connected to the grid or hybrid with some conventional backup source, where different additional subsystems are required, such as storage, regulation and distribution, included in the latter that of protection. + +![](https://i.imgur.com/LBe7BVh.png) + +Img5. Basic diagram of an isolated photovoltaic system. + +![](https://i.imgur.com/pTtv5Vr.png) + +Img6. Basic diagram of a photovoltaic system connected to the electrical network. + +**Batteries.** + +Batteries, also called accumulators, are energy storage devices that convert stored energy into electrical energy through a chemical reaction. The figure shows the symbol used to represent a battery, accumulator or a battery of batteries. The most suitable batteries for photovoltaic systems are lead acid. + +![](https://i.imgur.com/tFmKC2O.png) + +Img7. Electrical symbol of a battery or accumulator. + +The behavior of a battery is fundamentally determined by two factors: the capacity in ampere-hours and the depth of discharge. + +**Battery capacity.** + +The storage capacity of a battery is defined as the amount of current that it will be able to deliver for a given number of hours at its nominal voltage and at a temperature of 25 °C. Capacity is designated in ampere-hours (Ah), and is the product of current in amperes and time in hours. +Generally the capacity of a battery is in indices of 100, 20 or 5 hours; to refer to the capacity of a battery the letter C is used, for example the previous capacities are defined as C100, C20 and C5. +The capacity is influenced by the temperature, if the temperature decreases the capacity decreases, but it is also worth mentioning that the high temperature causes a reduction in the battery life. + +**Battery types.** + +Batteries can be classified as primary or secondary cells. The first are used with the intention of being used only once, examples of these are carbon-zinc, alkaline and lithium batteries. The secondary cell stores electrical energy in a reversible chemical reaction, allowing the battery to produce current repeatedly, but the investment process does not occur 100% since there are losses due to heating and +voltage difference some examples are nickel-cadmium, lead-acid and nickel-iron batteries. + +Most photovoltaic systems use lead-acid batteries because of their low cost compared to other batteries. + +**Lead acid battery (Pb-Acid).** + +The commercial battery, in order to offer a practical output voltage, has several of these cells connected in series. Each cell is composed of several positive and negative plates, which have intermediate spacers. All plates of the same polarity, within a cell, are connected in parallel. The use of several plates of the same polarity allows increasing the active surface of a cell. + +In it, the two electrodes are made of lead and the electrolyte is a solution of distilled water and sulfuric acid. When the battery is charged, the positive electrode has a deposit of lead dioxide and the negative is lead. When discharged, the chemical reaction that takes place causes both the positive and negative plates to have a lead sulfate deposit. + +The most commonly used lead-acid batteries for photovoltaic applications are classified into two types: liquid batteries and valve-regulated batteries (VRLA - Valve Regulated Lead Acid battery). + +**Liquid Batteries.** + +They exist in an open version with lids that allow the water to be replaced and are low maintenance, but there are closed ones with valves so that possible gases can escape during excessive loads. Their advantages apart from the price is that they have fewer problems if they are overloaded. The disadvantages are the danger of losing the acid, a control of the water level is necessary and its typical short life is approximately 400 charge and discharge cycles. VRLA type batteries. + +**Gel batteries.** + +In these batteries, the acid is in the form of a gel. Their great advantage is that there is no longer a liquid that can be lost, they are closed. Corrosion is reduced and they are more resistant to low temperatures. Their life is much greater than the life of liquid batteries and compared to others, they are the least affected in cases of deep discharge. The disadvantages are a little higher internal resistance that reduces the maximum current flow, they are somewhat more delicate to charge and they carry a higher price. + + + +**AGM batteries.** + +They are increasingly being used in solar and wind systems. Its advantages in addition to those of gel batteries are high resistance in cold climates, its self-discharge over time is minimal, and it has the highest efficiency of all lead batteries (up to 95%). They have a low internal resistance that allows high currents. The disadvantage, apart from the higher price, is its higher vulnerability to deep discharges. + +**Controller.** + +The controller is the device in charge of controlling the processes against charges and discharges of the battery. Among its main functions are: +Avoid battery overloads since once the battery is charged (EDC=100%), it does not continue with the charging process. This prevents the gasification process and temperature rise in the batteries. +Anticipates over discharges in periods where there is insufficient sunlight, thus preventing the battery charge from being exhausted excessively and consequently reducing its useful life. Ensures system operation at the point of maximum efficiency. + +The current controllers introduce microcontrollers for the correct management of a photovoltaic system. Its elaborate programming allows a control capable of automatically adapting to different situations, allowing the annual modification of its operating parameters for special installations. + +![](https://i.imgur.com/tiGMnnC.png) + +Img8. Controller. + +The most important electrical characteristics of a controller are: the nominal voltage that indicates working voltage (12, 24, 48 V), maximum current that the controller will support, polarity and input and output connections. + +**Operation of a controller.** + +The controllers allow basing their operation based on the states of the load. Equalization. This response from the controller allows the automatic carrying out of accumulator equalization charges after a period of time in which the state of charge has been low, otherwise minimizing gassing. + +**Deep charge.** After equalization, the regulation system allows charging current to enter the accumulators without interruption until the final charge voltage point is reached. Once this point is reached, the regulation system stops charging and the control system goes on to the second phase, floating. When the final charge voltage is reached, the battery has reached a charge level close to 90% of its capacity, in the next phase the charge will be completed. + +**Final charge and flotation.** The final charge of the accumulator is carried out by establishing a zone of action of the regulation system within what is called the Dynamic Float Band. (B.F.D.). The BFD is a voltage range whose maximum and minimum values are set between the end of charge voltage and the nominal voltage + 10% approximately. +Once the full charge voltage value of the battery is reached, the controller injects a small current to maintain it at full charge, that is, it injects the float current. This current is therefore responsible for maintaining the battery at full charge, and when no energy is consumed it is used to compensate for the self-discharge of the batteries. + +**Controller types.** + +There are two types of controllers, parallel and series. In low power installations, controllers are used in parallel and for high power, controllers in series. + +* **Serial controller:** The operation of this type of controller is to cut off the power supply from the generator (photovoltaic array) before it reaches the maximum battery voltage, thus avoiding reaching the battery overload level. + +* **Parallel controller:** The operation of this type of controller is to trigger power, with the purpose of eliminating the excess energy generated. The controller consists of a transistor located in parallel with the photovoltaic generator. For this type of controller, it is necessary to have a control circuit, which will be in charge of conducting the transistor depending on the battery voltage, that is, when the voltage is higher than a threshold (VSC) that it conducts and that when it is lower that it does not conduct. + +**Inverter.** + +The converters are devices whose function is to transform the voltage and characteristics of the intensity they receive, converting it to the appropriate one for the necessary uses, commonly the one used for photovoltaic systems is of the direct current type to alternating current (c.c./c.a.), since photovoltaic panels generate electrical energy in direct current and due to the type of loads for domestic use that exist, an element that performs this function is necessary. This type of converter is called an inverter. + +![](https://i.imgur.com/zlseYpm.png) + +Img9. Basic scheme of operation of an inverter + +* Oscillator: Circuit that generates the output alternating current frequency, made up of a high frequency ceramic resonator or similar, which is divided by the corresponding factor until the required value is obtained. This procedure establishes a high output frequency stability. +* Converter: The converter circuit receives the direct input voltage from the batteries and the frequency of the oscillator and thereby generates the alternating current output. +* Protection: This circuit is responsible for monitoring the consumption of alternating current to block the converter in the event of an excess. + +**MultiChain Miner Hardware/Software Especifications.** + +The requirements are an embedded computer with electronics interfaces to measure the clean energy and other types of sensors required, plus an ASIC/FPGA low consumption PoW Maxcoin Miner. On the Software side the requirements must for fill to have a Maxcoin Node connected to a Mining Pool, a IPFS node connected to the distributed database and a light wallet or way to interact with low storage consumption to the Ethereum Network and specifically with the DECA 2.0 Protocol. + +On the Communications end, the requirements for the prototype the 802.11 can be enough but maybe in the future versions and to cover a wide range of area we should consider LoRAWAN with some mesh network features so that the system is even decentralized in the communications perspective. + +The proposal can be a low energy consumption computer that has enough computing power to handle both the hardware the software specifications, such as Raspberry PI 4 B or even a Raspberry Pi Zero 2W if the laboratory tests prove its reliability. + +## NETWORK DIAGRAM + +![](https://i.imgur.com/6ZhhluB.png) +Img10. Maxcoin Clean Energy Network Diagram + +The Img10. Describes the Maxcoin Clean Energy Network Diagram model based on multiple MultiChain miners (as described in the Components diagram Img4.) and Node Storage Energy Systems (Which can be any type of storage energy methods). The Goal of such topology is to create a decentralized distribution energy network where MultiChain Miners and Node Storage Energy Systems can interact in a free market for buying and selling energy in a decentralized way. + +There can be multiple Use Cases, Market differences and Technical differences between the process of buying/selling and transmitting the energy from different endpoints of this network. Also, there are multiple variables that can be considered in such a network whether getting energy is cheaper from a shorter distance seller, or a node storage energy system has a more efficient and cheaper way to store the energy that can make it cheaper. There can be other variables to support more the decision-making on who and where someone wants to buy or sell the energy, based not only on technicalities to be price or energy efficient, but also to specific communities, technologies and others where we can have a truly decentralized free market. + +### CURRENT ELECTRIC NETWORKS + +![](https://i.imgur.com/tl0Xcnh.png) +Img11. Electric Schematic + +**Fossil fuel energy.** + +They are an energy system that humanity has been using for decades, which has made it more accessible to one through all the resources that are possessed and that have been created over the years, allowing them to exploit their benefits to the maximum. It must be affirmed that with all the resources that are available, it is easier to transport, sell, market and even contain fossil fuels that at some point can serve as a means of energy. + +On the other hand, fossil fuels have their disadvantages since after all these years of exploitation they have created damage to the environment through climatic changes, contamination of water, soil, and even air due to the gases that are released, in addition to the fact that large-scale conflicts have been created simply by having control of this means of energy since they are not found anywhere in the world. It is a highly coveted system. + +This is just to mention a few aspects of fossil fuel energy. Another important aspect to mention is that this type of energy is mostly monopolised by large energy corporations that monopolise the world market and that together represent a great economic, political and even military power that influences the decision making in different countries and in our own lives. + +In the different processes that electricity generated by traditional means, both renewable (wind, hydro, nuclear) and non-renewable (gas, oil, coal) are: generation, transformation and distribution, which will be explained in detail below, and in which solar energy is also involved as it is interconnected to the traditional electricity grid. + +**Energy Transmission and Distribution.** + +Once solar radiation is transformed into electrical energy through solar cells, the first electrical process is called transmission to a medium power transformer that in turn transports the generated energy to the substation for be processed, stored and forwarded. + +This process is called Transmission and Distribution of Energy. + +In order to minimise energy losses and to reduce the cable cross-section, the cables are transported at high voltage. + +To understand a little more in detail the process of transmission and distribution of electrical energy, it is necessary to understand a little about reactive power, active power and apparent power. + +We know that the union between active and reactive power is what is called apparent power, that total power that includes the electrical and magnetic phenomena. + +![](https://i.imgur.com/IrL9Vvt.png) + +Img12. Aparent Power + +The Apparent Power is defined by the multiplication between the voltage and the intensity of electric current. + +$$ S = I * V $$ + +In such a way that for an equal value of power if the voltage is increased there will be less current passing through the cables because they are inversely proportional magnitudes. + +$$ I= \dfrac {S}{V} $$ + +The Joule effect says that the power lost in thermal energy due to the conduction of electricity through a cable is equal to the resistance times the intensity squared, that is, the lower the resistance, the much less power will be lost in the form In addition, in this way it is possible to reduce the section of the cables (cable size) and in this way the weight that the structures have to support is also reduced. + +$$ P = I^2 * R$$ + +For all this, the voltage is raised to transport high-voltage energy and then the voltage is lowered again when it is close to cities to bring that voltage level to normal levels for consumption and precisely the substation those places that allow the rise and fall of voltage. They are that key piece of the electricity transmission network. + + +![](https://i.imgur.com/V7lC5CE.jpg) +Img13. Electric Substation + +When solar cells transform solar radiation into electrical energy, this is transferred to a transformer which increases or decreases the electrical voltage. In order for the energy to be able to travel to different areas, it is connected to a special location called a substation and begins to be transported, especially over long distances. The transmission lines are interconnected with other electrical nodes, which in turn have the function of increasing or decreasing the electrical voltage of the pylons in order to distribute the energy. + + +> "Due to the achievable of this first version is to make a small scale model, we consider this section to be limited as this general description, it should be considered to further develop this section in the FUTURE ACHIEVABLE. The recommendations for these sections can be efficient distributed/decentralized smart energy grids and efficient ways to store big amounts of energy (for Node Storage Energy Systems proposals)" [name=P1R0] ## USE CASE @@ -122,7 +376,7 @@ NSE3 .> NSE4: <> NSE2 .> ODB3 : <> NSE3 .> DAPP15: <> -rectangle "MaxCoin Green Mining Pool" as MMP { +rectangle "MaxCoin Clean Mining Pool" as MMP { usecase "Stores Online Miner Time + Hashes" as MMP1 usecase "Uploads Data" as MMP2 usecase "Logs in with SBT" as MMP3 @@ -151,14 +405,71 @@ note right of LP end note @enduml ``` +Img14. Maxcoin Clean Energy Systems, Actors and Use Cases -## COMPONENT DIAGRAM +The Use Case Diagram Img6. Describes most of the use cases for the Decentralized Energy Market operations, this diagram not only specifies the use cases but also the systems and the actors involved. +> Note: The system requires Hardware and Network described in bouth the Compenent Diagram Img4. and the Network Diagram Img5. it also requires the DECA 2 Protocol and some other Ethereum based Protocols and Smart contracts which are being generalized as systems. -![Components Diagram](components_diagram.jpg) +### Systems involved -## NETWORK DIAGRAM +1. Node Storage Energy: Any system which can store energy, send and receive (distribute) that is synchronized with the DECA2 Protocol. Each Node Storage should have its own equivalent of a Liquidity Pool Paired with the Energy token so that its tokens are equivalent with the total energy stored as watts. + Use Cases: + * Accepts Energy Storage Request Form a MultiChain Miner + * Update Measured Received Energy From a MultiChain Miner + * Accepts Energy Take Out Request From a MultiChain Miner + * Transfers Energy to the MultiChain Miner -![NETWORK Diagram](network_diagram.png) +2. Maxcoin Clean Mining Pool: A system that is a Maxcoin Mining pool (Ideal to be a P2PPool) where the Maxcoin miner operations are easily to verify. This Maxcoin Miner is part of the MultiChain Miner and thus based on the mining operations should comply with the Clean Energy Generation and The Energy Token information. Proof of Work in a simple ASIC/FPGA (Low Power Consumption) might help us to provide enough proofs that the Clean Energy is being generated. + Use Cases: + * Stores Online Miner Time + Processed Hash Power + * Uploads Mining Data to the DECA2 Distributed Database + * Logs in with SBT (Each MultiChain Miner has an SBT as ID) + + +3. Liquidity Pool: A System/Smart contract based on protocols similar to uniswap that the Node Storage Energy should have to be a market maker by pairing the Energy Token to the physical energy storage with other Tokens like DECA (governance) and/or Maxcoin. + Use Cases: + * The Multichain Miners and Liquidity providers "Gets a percentage per transaction" + * Swaps Tokens as Energy commodity with other types of tokens and proxies + * Provides liquidity DECA2/Energy Tokens (Default Payment to the Multichain Miner to add Liquidity) + * The MultiChain Miner "Gets Energy Tokens" when requested. + +4. DECA2 Distributed Database (orbitDB): Stores and Decentralize all the acquisition systems data like Measured Energy in both Miners and Nodes Storage Energy, SBT Data, Maxcoin Pool Data, DECA Measurements Data, and others. + Use Cases: + * Stores Energy Measurements + * Updates Measured Sent Energy + * Stores Received Energy Data + * Updates Measured Received Energy + * Verifies Data Integrity Related to the Miner + * Provides Access to the DECA2 DAPP + * Stores SBT Miner Data (Pool Data, Hardware Status) + * Updates Mining Pool Data + * Updates Miner HW Status + +5. DECA2 DAPP: The DECA2 Decentralized Application is the main interface based on the DECA2 Protocol and other components required to for filling the Decentralized Maxcoin Clean Energy System Operations. The Actors are the end users of this system. + + Use Cases: + * Gets MultiChain Miner Request from a miner candidate + * Approves MultiChain Miner Request approved by the DAO + * Set MultiChain Miner SBT attributes approved by the DAO + * Gets mint request from the Multichain Miner that the DAO approves + * Approved Minting (Ballot) for Mining Equivalent Energy Tokens + * Gets Payment Request Order from the Multichain Miner + * Gets Energy Measurement Data from the Distributed Database Registries + * Verifies Payment Request Order by the Technical DAO + * Gets SBT if they are a Miner or a Node Storage Energy system. + * Verify all data and vote, a process done by the Technical DAO + * Not Approved are some process to be done if rejected + * Votes module update To vote any system or module updates + * Mints DECA requires the DECA2 Protocol + * Mints Energy Token Usually delivered to the Liquidity Pool + * Fills Energy Request Usually done by the Node Storage System + * Stores DECA2 to the DAOs Vault to incentivize the DAO participants. + +### Actors involved + +1. MultiChain Miner: Defined as both a Miner Hardware (which consist on generation and measurement system) and the Person that performs the mining process. + +2. Technical DAO: Defined as both a group of People that handles the governance and also the system required for this process operations over Ethereum and DECA Protocol (Probably based on Aragon.org DAO developments) ## SEQUENCE DIAGRAM @@ -183,7 +494,7 @@ deactivate DAPP MM->NSE: Start sending energy to the NSE MM->DOD: Updates Measured Sent Energy NSE->DOD: Stores Received Energy (-looses) - MM->DOD: Updates Measured Received Energy + NSE->DOD: Updates Measured Received Energy MM->DAPP: Request Payment (Example Monthly) activate DAPP DAPP->DOD: Gets Measurments @@ -219,28 +530,91 @@ deactivate DAPP end @enduml ``` +Img15. Max coin Clean Energy The Mining Sequence diagram -## GANTT DIAGRAM +The mining process is represented by the Sequence diagram Img.7. In this diagram, we show the "Participants" previously described by the Img6 as systems and actors. +> **Note:** This is a proof of concept model, there should be a deeper review on who and how to manage the Node Storage Energy Systems, if the Mining should either tokenize only the energy sent to the Node Storage System and/org also the energy that the MultiChain Miner Stores. In this example we consider that the tokens will be created once it is sent to the Node Storage Energy System so that we have 3 parameters for verification that the Energy is Clean, The Maxcoin Pool, The MultiChain Miner Data and the Node Storage Energy Measurements. + +**The Mining Process Description:** + +1. **Multichain Candidate:** The *MultiChain Miner* requests getting the Maxcoin Clean Energy System, this should be installed and attached to the Clean energy generator as described in the component Diagram Img4. and linked to the network as shown in the Network Diagram Img.5, The DAO verifies if the Miner Candidate Complies with the System and DAO requirements. If he complies, he will get the hardware and a SBT linked to the MultiChain Miner. the Process takes place at the DECA2 DAPP. + +2. **The Mining Process:** Once the system is setup with the Green Energy Generator paired with the MultiChain Miner and following the models from the components and network diagrams, the Mining Process can start with the following states: + + 2.1 The Mining Process is a loop where the Maxcoin System starts mining PoW with low energy consumption, and connected to the Maxcoin Pool that records the Hash power and online time, the DECA Mining Process requires measuring Real Time Energy Generation and Storage/Usage Data which gets decentralized using the OrbitDB system and thus updating the DECA2 DAPP display information to the Technical DAO and other Actors. + + 2.2 While the Miner is operating the mining process, actions can be to either buy and sell energy to any Node Storage Energy System or even between different MultiChain Miners. In this sequence diagram, we interact with a Node Storage Energy system (NSE) for buying and/or selling clean energy. + + a). If the MultiChain Miner wants to Sell an excess of its energy, the MultiChain Miner starts sending energy to the Node Storage Energy (NSE), after the Multichain Miner should record the Measured Energy Sent to the Distributed Database using the DECA2 DAPP. A similar procedure should be done by the NSE where it reports the received energy - energy looses during the transmission. + + b). If the Miner wants to request payment of this energy from the Node Storage Energy for example Monthly, he should execute the request from the DECA2 DAPP, The Technical DAO then Verifies Data integrity related to the Miner and the NSE, Maxcoin Pool Mining Data, and The MultiChain Miner Hardware integrity. + + * If the payment request gets approved by the DAO: The Minting Mechanism gets executed by the DAO at the DECA2 DAPP, The Energy tokens are set as liquidity to the Liquidity pool represented by the Node Storage Energy that stores the energy received. Alternatively the Maxcoin Pool could also send the Mined Maxcoin to the Liquidity Pool of the Node Storage Energy for generating some yield to the Multichain Miner. Also, there should be some minted DECA/Energy Tokens or Maxcoin Tokens to pay to the DAO for handling verifications and operations. + + * If the payment request gets rejected by the DAO: The technical DAO should report the reasons and update the Status to the MultiChain Miner at the DECA2 DAPP. + + c) If the MultiChain Miner wants to buy energy from the Node Storage Energy system it can use either DECA2 Tokens, Maxcoin or others that are paired with the Energy Tokens at the liquidity pool that represents the Node Storage energy, once the user gets the Energy tokens can request the energy equivalent to it to be sent from the NSE to the Multichain Miner once the process gets done, the Energy Tokens can be burned into the SBT to display the Clean Energy Consumption and even justify Carbon footprint reduction based on DECA2 Protocol. + +3. **Requesting the Tokens from the Liquidity Pool:** The DECA2 DAPP and the protocol should incentivize as default to provide liquidity to the Liquidity Pools to create a more liquid market, therefore we consider in the model that they earn a yield in each transaction based on how uniswap or other Decentralized Liquidity Pools work. The Tokens in the Liquidity Pool should be assigned to the ownership of the MultiChain Miner and if he requests the Energy tokens or a Paired Token on the liquidity Pool the transaction request can always be executed. + > Note we require to do a deeper research to make this either an option or a default because the impermanent loss can be an issue + +## FUTURE ACHIEVABLE + +Considering that this system, its modeling and its implications are of high scale and complexity we consider that each model should be developed in phases, also the first tests should be done based on proof of concepts, low scale prototypes and further research. A small proposal for building next steps can be the following: + +1. Development of DECA2 Protocol for filling or at least a base proof of concept code that can be paired with the protocol once it is ready. + +2. Development of all the logic and decentralized software requirements (smart contracts, DAO, orbitdb, LP, etc...) with modularity and base operations functions so that it can be developed and improved gradually. + +3. Development of a small scale system for the Components diagram and a simplified Network Model (MultiChain Miner, battery, solar panels and a small grid to share energy), that can interact with 2. + +4. Further Research. And Laboratory reports after the prototype. + +5. High Scale Prototype requires: Security Audits, Production Development and Deployment, Economic support and a community that is willing to use the Prototype. -## FUTURE ACHIEVABLES ## CONCLUSION +There are multiple research documents, some of our research in which we find smart (pseudo)decentralized energy grids based technologies that want to implement blockchain y cryptocurrency technologies yet without understanding the real goal and philosophy of the cryptospace and thus have issues in the perspective of decentralization(double-counting) scalability and security. Other projects have multiple ideas and non development, and finally some that are too expensive and complex to implement that might require multiple years and research and thus economic resources. + +The Maxcoin Clean Energy system is a complex system that requires a lot of resources, time and research to be developed. Our proposed model intends to provide a decentralized in all its components and layers, from software, hardware, infrastructure, decentralized finance, tokenomics to social organizations for operations such as DAOs. The advantage that such a system can provide is beyond a reliable and secure model, but also a change of paradigm on the way transparency, governance and social implications that can contribute for a free market of clean energy that can be considered as less corrupt by providing transparency in all its means and layers. + +Searching for an efficient clean energy generation with the current intermittent methods and limited/expensive that its storage can be, specially for these types of energies (solar and wind powered) we are still far to be an alternative in what the production and storage of clean energy market price can be against the current energy prices of fossil fuels, but considering the advantages on the autodeterminance of societies that are dependent to geopolitical situations that can affect their reliability on such type of centralized energy systems, it should not be considered as an expensive alternative but an investment perspective that can enhance trust and reliability by building their communities stronger against external interest that can destabilize a whole community because their dependence on manipulated markets of the fossil and other types of centralized energy sources. + +> "We do not know how the future of energy and society will be, but we have already some tools that can be integrated to make a more transparent, reliable and cleaner energy system than the one we currently have." [name=P1R0] + +> ""We live in times of great change and in the energy field even more accelerated changes are required to make the generation and distribution of energy to a large number of people and value chains more efficient, as these competitive advantages determine the economic power of a country. Innovative tools exist that allow for a better distribution of energy sources and we present one of the many proposals that exist to make energy reach more people at a lower cost and greater benefit."[name=Bleecker] + +## CONTACT + +- [David E. Perez Negron R.](mailto:david@neetsec.com) +- [Octavio Valdez](mailto:ohuerta@decentralizedclimate.org) + ## REFERENCES \[1\] Manisa Pipattanasomporn; Murat Kuzlu; Saifur Rahman, "A Blockchain-based Platform for Exchange of Solar Energy: Laboratory-scale Implementation", https://ieeexplore.ieee.org/stamp/stamp.jsp?tp=&arnumber=8635679, 2018. \[2\] Joint Research Centre (JRC), "Energy system blockchain solutions", https://ses.jrc.ec.europa.eu/node/31977, October 2022. -\[3\] Anselma Wörner, Arne Meeuw, Liliane Ableitner, Felix Wortmann, Sandro Schopfer and -Verena Tiefenbeck, "Trading solar energy within the neighborhood: field implementation of a blockchain-based electricity market",https://energyinformatics.springeropen.com/track/pdf/10.1186/s42162-019-0092-0.pdf, September 2019. +\[3\] Anselma Wörner; Arne Meeuw; Liliane Ableitner; Felix Wortmann; Sandro Schopfer and Verena Tiefenbeck, "Trading solar energy within the neighborhood: field implementation of a blockchain-based electricity market",https://energyinformatics.springeropen.com/track/pdf/10.1186/s42162-019-0092-0.pdf, September 2019. -\[4\] Merlinda Andoni, Valentin Robu, David Flynn, Simone Abram, Dale Geach, David Jenkins, Peter McCallum, Andrew Peacock, "Blockchain technology in the energy sector: A systematic review of challenges and opportunities", https://www.sciencedirect.com/science/article/pii/S1364032118307184?via%3Dihub,  February 2019. +\[4\] Merlinda Andoni; Valentin Robu; David Flynn; Simone Abram; Dale Geach; David Jenkins; Peter McCallum; Andrew Peacock, "Blockchain technology in the energy sector: A systematic review of challenges and opportunities", https://www.sciencedirect.com/science/article/pii/S1364032118307184?via%3Dihub,  February 2019. -\[5\] Subin Kwak, Joohyung Lee, Jangkyum Kim, and Hyeontaek Oh, "EggBlock: Design and Implementation of Solar Energy Generation and Trading Platform in Edge-Based IoT Systemswith Blockchain", https://www.ncbi.nlm.nih.gov/pmc/articles/PMC8951093/pdf/sensors-22-02410.pdf, March 2022. +\[5\] Subin Kwak; Joohyung Lee; Jangkyum Kim; and Hyeontaek Oh, "EggBlock: Design and Implementation of Solar Energy Generation and Trading Platform in Edge-Based IoT Systemswith Blockchain", https://www.ncbi.nlm.nih.gov/pmc/articles/PMC8951093/pdf/sensors-22-02410.pdf, March 2022. -\[6\] Naiyu Wang, Xiao Zhou, Xin Lu, Zhitao Guan, "When Energy Trading meets Blockchain in ElectricalPower System: The State of the Art", https://arxiv.org/ftp/arxiv/papers/1902/1902.07233.pdf, 2018. +\[6\] Naiyu Wang; Xiao Zhou; Xin Lu; Zhitao Guan, "When Energy Trading meets Blockchain in ElectricalPower System: The State of the Art", https://arxiv.org/ftp/arxiv/papers/1902/1902.07233.pdf, 2018. \[7\] Energypedia.info, "Blockchain Techologies For the Energy Access Sector", [https://energypedia.info/wiki/Blockchain\_Techologies\_For\_the\_Energy\_Access\_Sector#ImpactPPA](https://energypedia.info/wiki/Blockchain_Techologies_For_the_Energy_Access_Sector#ImpactPPA), 2022. +\[8\] Michael Mylrea; Sri Nikhil Gupta Gourisetti, "Blockchain for smart grid resilience: Exchanging distributed energy at speed, scale and security", [https://ieeexplore.ieee.org/document/8088642](https://ieeexplore.ieee.org/document/8088642), 2017. + +### ToDo +- [x] Technical writing and language verification +- [ ] DEEPER RESEARCH IN THE NETWORK DIAGRAM FOR EFFICIENT WAYS OF TRANSMISSION BETWEEN COMMUNITIES. + - [ ] CURRENT ELECTRIC NETWORKS + - [ ] Smart Electrical Grids + - [ ] Efficient high energy storage methods +- [ ] HUMAN AND ECONOMIC RESOURCES REQUIREMENTS. +- [ ] GANTT DIAGRAM FOR PROTOTYPE DEVELOPMENT. +- [ ] VERSION CONTROL. \ No newline at end of file