๐Ÿฆ HITBNB Vault Contract

https://bscscan.com/address/0x7de1d440a20b3fd16658ad619201eee91ac07de8

Overview

The HITBNB Vault is a smart contract that securely manages reward allocations, token distributions, pending withdrawals, and claim functions for users in the HITBNB ecosystem. It serves as a central hub (it's works decentralized no central control for any transaction ) where all automated and user-initiated token claims are executed.

๐Ÿ” Key Responsibilities

  • Holding HITBNB tokens for monthly ROI, staking, and reward purposes

  • Managing pending claims set by the backend logic (after calculations)

  • Ensuring secure and gas-optimized withdrawals by users

  • Facilitating automated top-holder reward releases (Chainlink Functions)

๐Ÿ” Fund Flow

  1. Tokens enter the vault from the ROI Wallet.

  2. Dapp Back-end sets pending rewards or ROI for a user.

  3. User claims through the Web3 UI โ†’ claimTokens() function.

  4. HITBNB is transferred from Vault to the userโ€™s wallet.

๐Ÿ”ง Core Functions

  • setPendingWithdrawal(address user, uint256 amount) Sets the userโ€™s pending amount available for claim. Callable only by backend/admin.

  • claimTokens() Lets user claim their assigned HITBNB rewards. Automatically transfers to connected wallet.

  • getPendingAmount(address user) View function to check how much HITBNB a user can claim.

๐Ÿ”’ Security Measures

  • Only whitelisted HITBNB dApp wallets can set pending balances

  • Claimable amounts are stored in mappings and not released until the user initiates a claim

  • Vault holds HITBNB in custody until explicitly distributed to ensure automation compatibility

โš™๏ธ Integration Points

  • Chainlink Keepers connects to Vault for setting claimable amounts monthly

  • HITBNB dApp shows claimable balances and triggers claim transactions

  • Chainlink Automation : For top holder monthly reward releases

๐Ÿงช Sample Flow

USDT โ†’ HITBNBBuyer โ†’ Buys HITBNB โ†’ Sent to ROI Wallet
             โ†“
        ROI Wallet โ†’ HITBNB Vault (if needed)
             โ†“
     Admin sets: setPendingWithdrawal(user, 1000)
             โ†“
     User visits dashboard โ†’ Clicks "Claim"
             โ†“
     HITBNB Vault sends 1000 HITBNB to user

๐Ÿ“Œ Notes

  • Vault must always be sufficiently funded buy chainlink automation from ROI Wallet

  • Tokens are not claimable unless explicitly marked as pending

  • Vault helps decouple calculation logic from distribution, improving scalability and modularity

Last updated