Skip to content

chickenzah/helios-testnet-sim

Repository files navigation

Helios Testnet XP Simulator

This repository contains Solidity smart contracts to simulate XP (experience points) interactions on the Helios testnet.
It includes multiple contracts for ledger management, auto XP generation, staking, bridging, governance, airdrops, and a full demo runner.


📂 Folder Structure

  • contracts/ – All Solidity contracts
    • HXPLedger.sol – Ledger to track XP per user
    • HAutoXPv2.sol – Auto XP generation simulation
    • MyContractXPLight.sol – Lightweight contract for fast XP interactions
    • HeliosStakeSim.sol – Stake simulation contract
    • HMockBridge.sol – Mock cross-chain bridge
    • HGovTest.sol – Governance proposals and voting simulation
    • HXPAirdrop.sol – XP airdrop contract
    • HeliosFullTestRunner.sol – Runs full demo with all contracts

⚡ Quick Start

  1. Open Remix IDE
  2. Create a new workspace or folder in Remix
  3. Copy the contracts from contracts/ into Remix
  4. Compile using Solidity 0.8.20 (except MyContractXPLight.sol uses 0.8.19)
  5. Deploy contracts one by one on the Helios testnet
  6. Optionally, deploy HeliosFullTestRunner.sol last to simulate all interactions automatically

🛠 How to Run Demos

  • HAutoXPv2.sol – Call runDemo() to simulate auto XP staking and bridging
  • MyContractXPLight.sol – Call setMessage() and sendTip() for test transactions
  • HeliosStakeSim.sol – Call runDemo() to stake/unstake ETH
  • HMockBridge.sol – Call runDemo() to simulate bridging
  • HGovTest.sol – Call runDemo() to create proposals and vote
  • HXPAirdrop.sol – Call claimAirdrop() to receive XP
  • HeliosFullTestRunner.sol – Call runFullDemo() to execute all contract demos once per wallet

📌 Notes

  • These contracts are for testnet/demo purposes only
  • Do not deploy on mainnet
  • Gas usage is minimized for testing, some interactions are simulated via events
  • XP values and token balances are for demonstration only

🔗 Useful Links


📝 License

MIT License. See LICENSE file.

About

Helios testnet Solidity contracts simulator

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors