Poems, short for Proof of the Effective Majority Staked, is an innovative approach that introduces a robust and secure mechanism to validate a shared secret within the INVO system. The process involves securely generating and storing account information, including public and private keys. It then transfers a significant portion of this information to another party to achieve a mutually agreed-upon proof, incentivizing consensus.
- Prerequisites
- Installation Instructions
- Running the Project
- Usage
- Understanding POEMS
- The Easy Explanation
Before proceeding, ensure you have the following tools installed:
WARNING ::: This application is designed to be executed in the command line. There is a React Interface, but is only designed to demonstrate the use of POEMS.
Node.js and npm:
# Check if you have Node.js and npm installed
node -v
npm -v
# If not, download and install Node.js and npm from the official website
# https://nodejs.org/en/download/Vite:
# Install Vite globally
npm install -g create-viteRust and Cargo:
# Download and install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
# Cargo comes with Rust, verify installation
cargo --version
# Download and install aleo cli
git clone https://github.com/AleoHQ/aleo-rust.git
# Install the aleo cli toolkit
cd aleo-rust
#Build aleo SDK globally on the machine
cargo build --release
# install the aleo cli to your path for global use
cargo install --path .
# cun aleo in your command line / terminal
aleo --help - Navigate to the root directory of the Poems project.
cd poems- Build and install the project.
cargo build --release
cargo install --path .
This will install the poems command-line tool on your system.
After installing, you can use the poems command followed by a subcommand:
- First set the server environment variables:
poems environmentIf need INVO's test implementation, refer to this .env example for use :
# You will need to launch your own application first. Please refer to the ALEO Deploy and Execute documentation:
# https://developer.aleo.org/testnet/getting_started/deploy_execute
# To see the full hash mixer contract, refer to this link: https://github.com/Invo-Technologies/poems1mxydh
# You may use this environment to test Invo's implementation directly. If it does not work, it means that WALLETADDRESS needs more credits.
# If aleo1hfl83c9c8y69ed56du46fmflnnfwh2zhu2ye0neywphsv8ek2upsr84he2 requires more credits, please use the Aleo Test Faucet and supply this address for testing purposes.
NETWORK=testnet3
PRIVATE_KEY=APrivateKey1zkp2Q3VWwLuWJ2eZbCJN2TLTTecXgB1mDHt7nUZ9NQpqiF5
VIEWKEY=AViewKey1cVEpPghtw6ujrJ8Fy9M6fMZYcvNjYW4M4RWCc4yKLDE9
WALLETADDRESS=aleo1hfl83c9c8y69ed56du46fmflnnfwh2zhu2ye0neywphsv8ek2upsr84he2
APPNAME=poems1hfl83.aleo
FEE=1
FUNCTION=interpretations
# The network is used to access the network, and the private key is responsible for spending the fee for the record being produced.
# The view key is used to decrypt the record.
# This environment must be set on the server first during configuration using the Poems environment.
- To execute the registration/key generation without the decryption program:
poems registrationWARNING ::: if the environment is not set, COMMAND will fail.
- To execute the decryption program:
poems decryptTIP: Set your browser preferences to Google Chrome for Best results. This will download the interpretations to your Desktop, and they will also automatically open an HTML document in your browser
- if you want to change the code and implement your own binary's, run the following command :
cargo run --bin <COMMAND>Navigate to the directory containing the frontend code.
cd frontendInstall the dependencies.
npm installStart the Vite server.
npm run devOpen the displayed local address in your web browser to interact with the project.
The 'proof of the effective majority' (POEMS) is an innovative approach that enables a staked authority to validate a shared secret through a process that necessitates the exchange of specific records, where neither party possesses any prior knowledge to complete a single proof. The proof involves securely generating and storing account information in the INVO system, including public and private keys, using a series of steps such as key generation, mnemonic creation, hashing, and storage. A significant portion of this information is subsequently transferred to another party, wherein the key master possesses solely a zero-knowledge proof of the keys they generated, without any knowledge of the key's contents. Only when the external party returns the key to unlock the contents, which both parties are aware of, can a mutually agreed-upon proof be approved—a process that inherently incentivizes both parties to reach consensus.
The Proof of the Effective Majority (POEMS) is a sophisticated mechanism designed to validate a shared secret within the INVO system.
To initiate the proofing mechanism, the INVO system generates and securely stores the account information. This includes the creation of public and private keys using a reliable key generation algorithm. The generated keys are essential for subsequent steps in the proofing process.
In parallel to key generation, a BIP39 mnemonic is created to facilitate account recovery. The mnemonic serves as a backup for the account's private keys. Additionally, a hashing function is applied to the mnemonic, generating a secure 256-bit hash. This hash serves as a vital component in the proofing process.
A significant portion of the account information is then transferred to an external party. During this transfer, the key master, who possesses the generated keys, provides a zero-knowledge proof solely based on the keys' creation. Notably, the key master remains unaware of the contents of the keys.
The external party, upon receiving the account information, participates in the exchange of the shared secret. To unlock the contents of the shared secret, the external party returns the key to the key master. Both parties possess prior knowledge of the contents, ensuring mutual agreement and verification.
The POEMS process inherently incentivizes both the key master and the external party to reach consensus on the proof. By agreeing on the shared secret and its unlocking process, the proof is verified and approved, indicating a successful completion of the proofing mechanism.
The Proof of the Effective Majority (POEMS) is a robust and secure mechanism that enables the validation of a shared secret within the INVO system. Through a series of steps involving key generation, mnemonic creation, and the exchange of information, the POEMS process ensures consensus and verification between parties involved.
If you are looking to review and use the hash mixer, coined "mixy", checkout the aleo program's code using this link :
LINK ::: https://github.com/Invo-Technologies/poems1mxydh
Imagine we're playing a game 🎮 ! In this game, I make a magic box 🎁 and magic keys 🔑🔑. I also make an invisible, secret word list 📜. This word list is super special because only you and I know about it , and it can help us make more keys if we ever lose them. 🗑️
Now, I use the secret word list 📜 and make a magic code 🍭. This code is connected to the word list but doesn't give it away. I give you the magic box 🎁, the keys 🔑🔑, and the magic code 🍭. But I keep the word list to myself 📜.
The magic box 🎁 can only be opened with the keys 🔑🔑, but the keys are useless without the secret word list 📜.
This is where it gets interesting!🎉 Even though you have the box 🎁 and keys 🔑🔑, you can't open the box without the secret word list 📜. So, you take the magic code 🍭 that I gave you, and you use it to make your own word list 📃. And guess what? Your word list matches mine! 📜 == 📃
Now that you've made your own word list 📃, you can use it to make a new key 🗝️. And this key opens the magic box 🎁! This proves that you made the same key that I had secretly stored 🔑🔑 = 🗝️🗝️. When the box opens, I can use the secret code 🍭 you used to check that everything matches up!
This way, we've proven that you're the only one who could have opened the box 🎁, because only you and I knew the secret code 🍭, and you were the one who made the word list 📃 that could make the magic key 🗝️. That's what we call 'Proof of the Effective Majority Staked' or POEMS.