Frequently Asked Questions

Hereditas Protocol V2 is the latest version of our decentralized inheritance management system. It allows you to securely manage and distribute your digital assets, specifically ERC20 tokens, to your beneficiaries based on predefined conditions and time periods.

Hereditas V2 operates through a single Inheritance Plan managed by an InheritanceManager smart contract. You can set up your plan by specifying your beneficiaries, their respective shares, and defining inactivity and grace periods. Unlike V1, your assets remain in your personal wallet until distribution is initiated, ensuring they remain liquid and under your control.

• Single Inheritance Plan: Manage one inheritance plan at a time, simplifying asset distribution.
• ERC20 Token Support Only: Exclusively supports ERC20 tokens, ensuring compatibility and security.
• Fee Structure: Developer and executor fees are only deducted during the asset distribution process.
• Liquid Assets: Assets remain in your personal wallet until you choose to distribute them, maintaining liquidity and control.
• Automatic Contract Deletion: After assets are distributed, the inheritance contract is automatically deleted from the blockchain, ensuring privacy and security.
• Secure and Transparent: Built with robust security measures to protect your assets and ensure transparent operations.

1. Connect Your Wallet: Use a compatible Ethereum wallet (e.g., MetaMask) to connect to the Hereditas platform.
2. Access the Dashboard: Navigate to the Hereditas dashboard where you can manage your inheritance plan.
3. Create a New Plan:
   • Beneficiaries: Enter the addresses of your beneficiaries and assign their respective shares.
   • Inactivity Period: Define the period of inactivity (in days) after which the inheritance process begins.
   • Grace Period: Set an additional period (in days) during which only beneficiaries can initiate distribution.
   • Approve ERC20 Tokens: Register any ERC20 tokens you wish to include in the plan through the approval process.
4. Submit the Plan: Confirm and deploy the inheritance plan. Developer and executor fees will be automatically deducted during the distribution process.
5. Manage Your Plan: Use the dashboard to view, update, or delete your inheritance plan as needed.

Hereditas V2 exclusively supports ERC20 tokens. Unlike V1, native ETH is not supported to ensure greater compatibility and security with a wide range of digital assets.

• ERC20 Tokens: Any token that complies with the ERC20 standard, allowing for a diverse range of digital assets to be included in your inheritance plan.

Native ETH is not supported because it doesn't utilize the approval mechanism required for secure asset management and distribution. Instead, users can use Wrapped Ether (WETH), which is an ERC20-compliant version of ETH. WETH allows for seamless integration with the approval system, ensuring that your assets are managed securely within your inheritance plan.

Unlike V1, assets are not deposited directly into the inheritance contract. Instead, they remain in your personal wallet until you choose to distribute them. This approach ensures that your assets remain liquid and under your control until the distribution conditions are met.

• ERC20 Tokens: Approve the inheritance contract to access your ERC20 tokens. The tokens remain in your wallet and are only transferred to beneficiaries during the distribution process.

1. Navigate to Manage Tokens: Within your inheritance plan, go to the "Manage Tokens" section.
2. Enter Token Details:
   • Token Address: Input the ERC20 token contract address.
   • Amount to Approve: Specify the amount of tokens you wish to approve for the inheritance contract.
3. Approve Tokens: Click the "Approve" button to authorize the inheritance contract to handle the specified amount of tokens.
4. Register Tokens: Once approved, you can register the token for inclusion in the inheritance plan by clicking "Register".
5. Manage Registered Tokens: View and unregister tokens as needed through the "Registered Tokens" list.

Note: Tokens must be registered after approval. If you unregister a token, it will NOT be included during distribution, even if the approval is still active.

The Grace Period is an additional timeframe following the inactivity period. During this period:

• Beneficiaries: Only designated beneficiaries can initiate the distribution of assets.
• Executors: After the grace period, executors (non-beneficiaries) can also trigger the distribution, subject to a 1% executor fee deducted from the distributed assets.

This ensures that your assets are distributed smoothly while providing flexibility in case of unforeseen circumstances.

Hereditas Protocol V2 incorporates a transparent fee structure that is only applied during the asset distribution process:

• Developer Fee: A 0.1% fee is automatically deducted from the total assets being distributed. This fee supports the ongoing development and maintenance of the Hereditas protocol.
• Executor Fee: A 1% fee is applied when executors (non-beneficiaries) initiate the distribution after the grace period.

Additional Notes:

• ERC20 Tokens: Fees are only deducted from ERC20 token distributions and are transparent in all transactions.
• Fee Transparency: All fees are clearly displayed during the distribution process, ensuring users are aware of the deductions.

Yes, as the contract owner, you can:

• Add or Remove Beneficiaries: Modify the list of beneficiaries. The system automatically adjusts the shares to maintain a total of 100% distribution.
• Update Periods: Change the inactivity and grace periods as needed to reflect your current wishes.
• Register/Unregister Tokens: Change and manage the tokens you want to be distributed.
• Delete Your Plan: You can choose to delete your inheritance plan if you wish.

Important: You can only have one active inheritance plan at any given time. Once you delete your current plan, you can create a new one.

Note: These actions reset the inactivity timer, ensuring that the inheritance process aligns with your latest settings.

Hereditas V2 prioritizes security through multiple layers of protection:

• Smart Contract Audits: Utilizes well-audited OpenZeppelin contracts to prevent vulnerabilities.
• Reentrancy Protection: Implements ReentrancyGuard to safeguard against reentrancy attacks.
• Secure Token Handling: Uses SafeERC20 to ensure safe interactions with ERC20 tokens.
• Transparent Operations: All transactions and distributions are recorded on the blockchain, ensuring transparency and immutability.

Best Practices: Users are encouraged to keep their private keys secure and interact with the contract only through trusted interfaces.

While you cannot directly change the shares of existing beneficiaries, you can:

• Add Beneficiaries: Introduce new beneficiaries and assign their shares. The system will automatically adjust the shares of existing beneficiaries proportionally to accommodate the new allocation.
• Remove Beneficiaries: Eliminate existing beneficiaries from the plan. The system will automatically redistribute their shares proportionally among the remaining beneficiaries.

Note: The total shares must always sum up to 100% (10,000 basis points). The system ensures proportional adjustments to maintain this balance.

Interactions with the contract are any actions that indicate activity and reset the inactivity period. These interactions include:

• Approving Tokens: Registering or updating ERC20 tokens for your inheritance plan.
• Managing Beneficiaries: Adding or removing beneficiaries.
• Calling the "Heartbeat": Heartbeat is a gas-minimal way to manually refresh the inactivity timer.

Each of these interactions updates the lastActive timestamp, effectively resetting the inactivity period countdown. This mechanism ensures that the inheritance process is only initiated when there has been no activity for the specified inactivity period.

Importance of Interactions:

Regular interactions prevent the unintended initiation of the inheritance process by signaling ongoing management and activity by the contract owner.

No, assets can only be distributed after the defined inactivity and grace periods have been met. This ensures that the inheritance process is only triggered under the specified conditions, maintaining the integrity and intent of your inheritance plan.

Hereditas V2 is deployed on the Ethereum blockchain and Base L2, leveraging their robust infrastructures and widespread adoption to ensure reliability and security.

The deployed contract addresses are as follows:

Ethereum Mainnet: 0x861ca0324a485aB3F920AbE3c23e29e0B6652f51

Base L2: 0x1e1b366bc794f270f4a1d0f08159ca50619d2b43

1. Install a Compatible Wallet: Use wallets like MetaMask or WalletConnect.
2. Navigate to Hereditas V2: Visit the Hereditas platform through your web browser.
3. Click "Connect Wallet": Initiate the connection process.
4. Authorize Connection: Follow the prompts in your wallet to grant Hereditas access.
5. Start Managing Your Plan: Once connected, you can create, view, and manage your inheritance plan through the dashboard.

Yes, Hereditas V2 incorporates a transparent fee structure that is only applied during the asset distribution process:

• Developer Fee: A 0.1% fee is automatically deducted from the total assets being distributed. This fee supports the ongoing development and maintenance of the Hereditas protocol.
• Executor Fee: A 1% fee is applied when executors (non-beneficiaries) initiate the distribution after the grace period.

Additional Notes:

• ERC20 Deposits: Fees are only deducted during the distribution process, ensuring that your assets remain liquid and under your control until you choose to distribute them.
• Fee Transparency: All fees are clearly displayed during the distribution process, ensuring users are aware of the deductions.

Yes, you can include multiple ERC20 tokens within a single inheritance plan. Simply register each token through the approval process, and they will be managed and distributed according to the shares you assign to your beneficiaries.

Once assets are distributed:

• Automatic Deletion: The inheritance contract is automatically deleted from the blockchain, ensuring that no further actions can be taken.
• Immutable Record: While the contract is deleted, all distribution actions remain recorded on the blockchain for transparency and reference.
• Final State: After deletion, your inheritance plan is considered complete, and a new plan can be created if needed.

Note: Ensure that all desired assets have been distributed before deleting the contract, as this action is irreversible.