🎓Concepts

Basic concepts in Hi5 Network

Beneficiary

• A beneficiary is an externally owned account (EOA) wallet that is listed within a letter and stands eligible to receive ETH rewards. This occurs when one of the letter's recipients responds in a positive manner.

• Each beneficiary within a letter has a specific rank based on their seniority. Of the five beneficiaries, it's always the oldest one that is replaced during the letter's propagation. This mechanism ensures rotation and fairness.

• Each beneficiary can appear in up to five propagation rounds, thereby optimizing their chances for exposure and potential financial rewards.

Recipient

• A recipient refers to an externally owned account (EOA) wallet designated to receive letters.

• Every recipient can hold up to five letters within their mailbox.

• Propagation of letters by the recipient follows a "first in, first out" mechanism, ensuring that letters are propagated sequentially.

Sequence

• A sequence represents a grouping construct for letters.

• At its core, all letters within a sequence share a common root, stemming from the very first letter formed in that sequence.

• This structure allows for effective categorization of letters within particular groups, communities, or ecosystems.

• Each sequence can uniquely determine its method of distribution and growth, tailoring its spread based on the specific context it represents.

Mailbox

• A mailbox is a digital storage system for letters associated with a recipient's EOA (Externally Owned Account) wallet.

• It functions as the receiving point where letters sent to a recipient are collected and stored.

• Each mailbox can store up to five letters at any given time.

• The letters in a mailbox follow a "first in, first out" rule, meaning the earliest received letter must be propagated first before the next one in line.

• A mailbox keeps track of the position of last unsent letter in order to efficiently propagate any letter that has not been processed.

• Once a mailbox is full for a player, this player can no longer receive new letters.

• The limit of receiving up to five letters is a way of reducing the chances of sending letters to blackhole wallets.

Letter

• Core Concept: Akin to a physical letter in a traditional pen-pal game, the "Letter" in hi5.network has been reimagined for the blockchain era.

• Token Representation: Each letter is manifested as an ERC1155 token. Every token has a distinct letter ID, yet multiple identical copies of this letter can exist.

• Letter Components:

  • Sequence ID: Indicates which sequence the letter belongs to.

  • Depth: Specifies the position of the letter within its sequence.

  • Beneficiaries: An array of five beneficiaries, each of whom stands to gain rewards should the letter be propagated.

• Lifecycle:

  • On positive response, the original letter (ERC1155 token) is burned.

  • A fresh letter emerges with an updated beneficiaries list and depth. This is done by minting new ERC1155 tokens.

  • This new token is dispatched to its recipients, embodying a transfer of ERC1155 tokens.

• Traceability: With each positive interaction, the receiving of letters can be tracked on Etherscan under the ERC1155 Token Txns section.

Pool

• Universal Pool: At its core, a pool represents a dynamic collection of wallets. These wallets are potential candidates, selected at random, to either receive a letter or benefit from the chain-letter mechanism. As more users input qualified wallets, the pool's size and diversity increase, naturally promoting a richer and more varied engagement.

  • Voluntary Entropy: To make the system more unpredictable and organic, users have the autonomy to freely add wallets to this universal pool. This act not only amplifies the randomness but also reinforces the participatory nature of the platform.

  • Automated Removal of Invalid Wallets: During the propagation process, the system is designed to identify and remove wallets that are no longer deemed valid. A primary reason for a wallet's invalidation could be its 'mailbox being full'. Such wallets, when encountered, are automatically excluded from the pool with the following benefits:

    • Ensuring Validity: By continuously monitoring and cleaning the pool, we ensure that letters are always dispatched to receptive and valid wallets.

    • Avoiding Bottlenecks: This auto-cleanup mechanism prevents scenarios where letters might end up in a 'full mailbox', thus ensuring a seamless flow and enhancing the user experience.

• Sender's Priority with the Sender Pool: Recognizing the value and commitment of those who send out letters, the Hi5 Network has instituted a dedicated 'Sender Pool'. This pool is specifically crafted to prioritize past senders when distributing letters. The rationale? To ensure that those who contribute to the network's vibrancy by sending letters are promptly acknowledged, fostering a sense of immediacy and appreciation.