# Introduction ## What is Dozer Finance? Dozer Finance is a DeFi Protocol optimized for efficient markets, delivering zero-fee transactions and instant finality. Built on the Hathor Network, it combines a trading and lending platform with built-in MEV protection, alongside a no-code Framework for rapid development and deployment of Web3 applications. Our mission is simple: "Unlocking DeFi for everyone" by removing the barriers to crypto adoption through drastically lower costs and simplified development processes. ## Key Features ### Zero-Fee Trading Platform Our trading platform eliminates gas fees while providing instant transaction finality. Users can trade confidently in a protected environment with built-in MEV protection, accessing simplified DeFi operations through our intent-based architecture. ### Dozer Blueprints Framework The Blueprints Framework revolutionizes Web3 development with no-code solutions. Developers can leverage pre-audited smart contract templates and ready-to-use UI components to implement key DeFi features without extensive coding expertise. ### Built for Efficiency Dozer Finance processes up to 10,000 transactions per second through its hybrid DAG-blockchain architecture. The platform maintains Bitcoin-grade security through merged mining while remaining accessible, requiring only consumer-grade hardware with 8GB RAM minimum. ## Technical Foundation Dozer Finance is built on the Hathor Network, combining a hybrid DAG-blockchain architecture with a zero-fee transaction model. This foundation enables instant finality for immediate settlements and incorporates built-in MEV protection mechanisms, all secured through Bitcoin PoW merged mining. ## Getting Started To begin using Dozer Finance: 1. Visit our [testnet](https://testnet.dozer.finance/swap) to explore zero-fee trading 2. Check out Dozer Blueprints for building Web3 applications 3. Explore our comprehensive guides for users and developers ## Connect with Us Visit us at [dozer.finance](https://dozer.finance), follow us on Twitter [@DozerProtocol](https://twitter.com/DozerProtocol), or reach out directly at . # Quick Start Get started with Dozer Finance in minutes. This guide will walk you through the essential steps to begin using our platform for trading and accessing DeFi services. ## Prerequisites To get started, you'll need a Hathor Network compatible wallet (download [Hathor Wallet](https://hathor.network/developers/#try-it-out-now)), some HTR tokens for transactions, and a modern web browser like Chrome, Firefox, or Brave. ## 1. Connect Your Wallet 1. Visit [dozer.finance/swap](https://dozer.finance/swap) 2. Click the "Connect Wallet" button in the top right corner 3. Follow your wallet's prompts to complete the connection (Reown option under "Settings" if needed) ## 2. Get Started with Trading ### Make Your First Swap 1. Select the token you want to swap from 2. Choose the token you want to receive 3. Enter the amount you want to trade 4. Click "Swap" to execute the transaction 5. Confirm the transaction in your wallet > πŸ’‘ **Tip**: All transactions on Dozer have instant finality and are protected from MEV exploitation. ## 3. Provide Liquidity To earn rewards as a liquidity provider: 1. Navigate to the "Pool" section 2. Click "Add Liquidity" 3. Select the token pair 4. Enter the amounts you wish to provide 5. Click "Add Liquidity" and confirm the transaction ## Next Steps Deepen your understanding of Dozer Finance by exploring our [Trading Guide](/trading-platform/trading-guide) for detailed trading strategies. Learn about [Liquidity Provision](/user-guides/liquidity-provision) to maximize your earnings, and understand how your trades are protected with our [MEV Protection](/trading-platform/mev-protection) system. ## Common Questions
Are my assets safe? Dozer Finance never holds custody of your assets. All trades are executed through smart contracts, and you maintain full control of your tokens at all times. The security of your assets is your responsibility - we recommend following best practices for wallet security and private key management.
Are there any fees for trading? Dozer offers low-fee transactions for simple operations, making it highly cost-effective for users.
How fast are transactions? All transactions have instant finality, meaning they are confirmed immediately.
Is my trading protected? Yes, Dozer implements built-in MEV protection mechanisms to ensure fair and efficient trading.
For more detailed answers and additional questions, check out our [FAQ](/getting-started/faq). ## Need Help? Connect with our community through various channels: join our [Discord community](https://discord.gg/KRhaCp6P) for support, participate in our [Telegram group](https://t.me/DozerFinance) for quick questions, follow us on [Twitter](https://twitter.com/DozerProtocol) for updates, or reach out directly at . # Core Concepts This guide introduces the fundamental concepts behind Dozer Finance. Understanding these core concepts will help you navigate the protocol efficiently and make the most of its features. ## Protocol Architecture ### DAG-Blockchain Hybrid Dozer Finance is built on an innovative hybrid DAG-blockchain architecture. This design enables parallel transaction processing for high throughput, featuring real-time validation with O(1) complexity. The system achieves efficient network propagation through a compact block structure averaging just 190 bytes. ### Low-Fee Transactions Dozer Finance implements an efficient transaction model with minimal fees, making micro-transactions cost-effective and increasing accessibility for users in developing economies. This approach supports frequent DeFi interactions while driving market efficiency towards traditional finance standards, all while maintaining sustainable protocol operations. ### MEV Protection Dozer implements robust MEV protection through a sophisticated system that uses transaction ordering based on block hash entropy. This creates deterministic yet unpredictable sequencing while maintaining network-wide consensus and preventing validator manipulation. ## Trading Platform ### Instant Finality All transactions on Dozer achieve instant finality through our advanced system architecture. This includes real-time transaction validation, fast block propagation in the P2P network, DAG-based parallel processing, and deterministic transaction ordering. ### Liquidity Pools Dozer's liquidity pools operate using Automated Market Making (AMM) with a dynamic fee structure based on pool volume. We offer impermanent loss protection programs and incentivized liquidity provision to ensure a robust trading environment. ## Security Model ### Bitcoin-Grade Security Dozer inherits robust security through merged mining with Bitcoin, giving us access to Bitcoin's substantial hashrate. This provides enhanced protection against 51% attacks while maintaining an energy-efficient security model. ### Safety Module Our Safety Module provides additional protocol protection through a DZR token staking mechanism that balances risk and reward for stakers. This system is governed by the community and features dynamic risk management capabilities. ## Token Economics ### DZR Token Utility The DZR token is central to our ecosystem, enabling governance participation, Safety Module staking, protocol development incentives, and liquidity mining rewards. ### Dynamic Fee Structure Dozer implements a sophisticated volume-based fee model designed to optimize market efficiency. Fees adapt based on pool volume and market conditions, with higher fees for low-volume pools to incentivize liquidity and lower fees for high-volume pools to encourage trading. All fees are distributed to liquidity providers to ensure sustainable pools, with a hard-capped maximum fee determined by governance. ## Next Steps Now that you understand the core concepts, you can start trading on the platform, provide liquidity to earn rewards, explore Dozer Blueprints for development, or participate in governance. For detailed guides on each aspect, check out our [User Guides](https://github.com/Dozer-Protocol/white-paper/blob/main/gitbook/users/guides/trading-guide.md) section. # FAQ ## General Questions
What is Dozer Finance? Dozer Finance is a DeFi protocol built on the Hathor Network, designed to provide low-fee transactions and instant finality. It offers a trading platform with built-in MEV protection and a no-code framework (Blueprints) for rapid development of Web3 applications.
Can I buy Dozer Tokens? Yes! More details at our Telegram Channel.
What makes Dozer different from other DeFi protocols? Dozer stands out through its zero-fee transaction model for simple transactions, built-in MEV protection, and instant finality for all transactions. We also offer a no-code development framework through Blueprints and integrate with Bitcoin's security through the Hathor Network.
Is Dozer available on mainnet? Yes, at [dozer.finance](https://dozer.finance).
## Trading Platform
How does Dozer achieve zero-fee transactions? Dozer leverages Hathor Network's architecture to enable fee-less transactions for simple operations. This is possible due to the efficient DAG-blockchain hybrid structure and parallel transaction processing.
How does Dozer protect against MEV? Dozer implements a unique transaction ordering mechanism based on block hash entropy, making it computationally infeasible for validators to manipulate transaction sequences. This prevents common MEV exploitation methods like front-running and sandwich attacks.
What is the transaction speed on Dozer? Dozer's architecture enables processing of up to 10,000 transactions per second (TPS) with instant finality, meaning transactions are confirmed immediately without needing multiple block confirmations.
## Technical Questions
What blockchain is Dozer built on? Dozer is built on the Hathor Network, which uses a hybrid DAG-blockchain architecture. This provides the benefits of both technologies while maintaining Bitcoin-grade security through merged mining.
What are the hardware requirements to run a node? Hathor Network is designed to run on consumer-grade hardware with minimal requirements. You'll need at least 8GB RAM, a standard CPU, and a regular internet connection to operate a node.
How does Dozer ensure security? Dozer inherits security from both Bitcoin's network (through Hathor's merged mining) and implements additional security measures through its architecture and MEV protection mechanisms.
## Blueprints
What are Dozer Blueprints? Blueprints are pre-made, customizable smart contract templates that allow users to deploy various DeFi applications without coding knowledge. These templates are pre-audited and secure.
What can I build with Blueprints? You can use Blueprints to: * Create tokens * Deploy liquidity pools
Do I need coding experience to use Blueprints? No, Blueprints are designed to be user-friendly and require no coding experience for basic implementations. However, advanced customization options are available for those with technical knowledge.
## Future Development
How can I stay updated on Dozer's progress? Stay connected with Dozer's progress by following @DozerProtocol on Twitter, checking our documentation regularly, joining our community channels, and subscribing to updates through our website.
# Overview Dozer Finance's trading platform is designed to address core DeFi adoption challenges through innovative solutions and efficient market mechanisms. Our platform focuses on delivering a seamless trading experience with low fees, instant finality, and built-in protections. ## Core Features ### ⚑ Low-Fee Trading Our platform offers zero-fee transactions for simple operations, making trading accessible to users of all volumes. Complex transactions are designed to be cost-effective, with efficient liquidity utilization to minimize trading costs. ### πŸ›‘οΈ Built-in MEV Protection Our unique transaction ordering mechanism ensures fair trading by protecting against front-running and preventing sandwich attacks. The system maintains fair transaction sequencing through a deterministic yet unpredictable ordering process. ### ⚑ Instant Finality By leveraging Hathor Network's architecture, we achieve immediate transaction confirmation and real-time settlement. This eliminates pending transaction delays and ensures reliable trading execution. ### πŸ’§ Liquidity Infrastructure The platform features efficient liquidity pool management with permissionless pool creation capabilities. Users can customize pool templates and benefit from our streamlined liquidity provision process. ## Platform Benefits ### Market Efficiency We maintain a fair trading environment through protected transaction execution and competitive pricing. Real-time settlements ensure optimal market efficiency for all participants. ### Cost Effectiveness Through minimal transaction fees and efficient resource utilization, we've created a platform that's accessible to trades of all sizes. Our focus on reducing trading costs helps maximize value for users. ### User Experience Users benefit from an intuitive interface design that works seamlessly across mobile and desktop devices. Real-time updates and a simplified trading process ensure a smooth trading experience. ## Technical Foundation ### Architecture Our platform is built on Hathor Network, utilizing a DAG-blockchain hybrid structure that enables parallel transaction processing. This scalable infrastructure forms the foundation of our high-performance trading platform. ### Security We achieve Bitcoin-grade security through merged mining, complemented by protected transaction ordering and a robust consensus mechanism. Our comprehensive security measures ensure safe trading for all users. ## Current Status The trading platform is currently in testnet phase, offering a fully functional mobile and desktop dApp interface with core trading capabilities. Users can access liquidity pool management, execute token swaps with MEV protection, and monitor transactions in real-time. ## Next Steps Explore our other documentation sections to learn more: * [Trading Features](/trading-platform/features) * [Trading Guide](/trading-platform/trading-guide) * [Liquidity Pools](/trading-platform/liquidity-pools) * [MEV Protection](/trading-platform/mev-protection) # Features ## Transaction Features ### Zero-Fee Swaps
How it works Our zero-fee swap feature executes simple token swaps without any fees by leveraging Hathor Network's DAG structure. This enables efficient micro-transactions and is particularly beneficial for frequent traders and small transactions.
### Instant Settlement
Implementation details Our platform achieves instant settlement through real-time transaction confirmation, eliminating the need to wait for multiple block confirmations. With parallel transaction processing, we can handle up to 10,000 TPS, ensuring rapid and reliable settlements.
### Transaction Privacy
Protection mechanisms Transaction privacy is ensured through private transaction ordering and protected execution paths. Our system implements unpredictable sequence placement while maintaining fair transaction inclusion for all users.
## Trading Features ### Token Swaps
Available functionality Execute direct token-to-token exchanges with automated price calculations and real-time rate updates. Our system ensures efficient path execution for optimal trading outcomes.
### Pool Creation
Pool management Deploy liquidity pools without permission and customize pool parameters to your needs. The system handles automated market making and provides real-time pool statistics for effective management.
### Liquidity Provision
LP features Add liquidity easily while tracking your positions in real-time. The system automatically distributes rewards and provides clear visualization of your pool share.
## Platform Features ### Wallet Integration
Connection options Connect your wallet seamlessly with WalletConnect support. Enjoy secure transaction signing and real-time balance updates throughout your trading session.
### User Interface
UI components Experience a responsive design optimized for both desktop and mobile devices. The interface provides real-time data updates, intuitive navigation, and clear transaction information for a seamless trading experience.
### Data Visualization
Available displays Access comprehensive data visualizations including pool statistics, trading volumes, price charts, position information, and detailed transaction history.
## Security Features ### MEV Protection
Protection mechanisms Our MEV protection utilizes block hash entropy for transaction ordering and randomized sequencing to prevent front-running and sandwich attacks.
### Network Security
Security implementation Security is ensured through Bitcoin merged mining and distributed consensus, complemented by secure transaction validation and protected state transitions.
### Transaction Validation
Validation process Transactions undergo real-time verification with robust double-spend prevention and state consistency checks. Automated security protocols ensure the integrity of every transaction.
## Testnet-Specific Features ### Test Tokens
Testing capabilities Create test tokens freely with support for multiple token types and customizable parameters. Our isolated testing environment ensures safe experimentation.
### Development Tools
Available tools Access comprehensive development tools including transaction explorers, debug information, testing interfaces, and network monitoring capabilities.
### Feedback System
User interaction Engage with our feedback system in our Discord server to report issues, request features, provide performance feedback, and track bugs during the testnet phase.
## Coming Features We are actively developing several major enhancements including EVM Bridge Integration, External APIs, Additional Blueprint Templates, and Enhanced Analytics capabilities. ## Get Started Begin your journey with Dozer Finance by exploring our [Trading Guide](/trading-platform/trading-guide), learning about [Liquidity Pools](/trading-platform/liquidity-pools), and understanding our [MEV Protection](/trading-platform/mev-protection) mechanisms. # Trading Guide Welcome to the Dozer Finance trading guide. This comprehensive walkthrough will help you get started with trading on our decentralized exchange platform. ## Video Demo {% embed url="" %} ## Required Setup ### 1. Download Hathor Wallet To begin trading on Dozer Finance, you'll need to install the official Hathor Wallet on your device. You can download it from: [Android - Google Play Store](https://play.google.com/store/apps/details?id=network.hathor.wallet\&hl=en) [iOS - App Store](https://apps.apple.com/us/app/hathor-wallet/id1465041963) ### 2. Access Dozer Platform Visit our platform at [dozer.finance/swap](https://dozer.finance/swap) ## Wallet Configuration ### Network Setup 1. Open your Hathor Wallet 2. Go to Settings 3. Select Network Settings 4. Choose "Nanos Testnet" 5. Accept any network change notifications 6. Wait for wallet synchronization to complete ### Connecting to Dozer 1. In your Hathor Wallet: * Open "Reown" option in Settings screen. * Select "Add" * When prompted for WalletConnect, read the QR Code on Dozer Interface or click in "Add manual" to input the connection URL 2. Approve the connection request 3. Wait for the Dozer interface to initialize ## Trading Basics ### Getting Test Tokens 1. Access the faucet through your account menu 2. Request test tokens 3. Wait for transaction confirmation 4. Tokens will appear in your wallet automatically Note: Test tokens have no real value and are for testing purposes only. ### Making Your First Trade #### Step 1: Prepare for Swap 1. Navigate to the Swap interface 2. Select your source token 3. Choose your destination token 4. Enter the amount you wish to trade 5. Click "Swap" to proceed #### Step 2: Complete Transaction 1. Review the Nano Contract details carefully 2. Register the new contract 3. Approve the transaction in your wallet 4. Enter your PIN to authorize 5. Wait for transaction confirmation ### Token Registration 1. Navigate to the Tokens page 2. Select the token you want to register 3. Copy the configuration string in the Token header 4. Click in "Register Token" in your wallet 5. Paste the configuration string and complte the registration ## Best Practices ### Before Trading Before initiating any trades, ensure your wallet is properly connected and you have sufficient tokens available. Always double-check your token selections and amounts, and take time to review all transaction details before confirming. ### During Trading Maintain an active wallet connection throughout your trading session and wait for transaction confirmations before proceeding with new trades. Keep an eye on your transaction status and regularly verify your token balances after completing trades. ## Common Issues and Solutions ### Wallet Connection Issues If you experience connection problems, first verify you're on the correct network, then try refreshing the connection. A stable internet connection is essential for uninterrupted trading. ### Transaction Failed When a transaction fails, first check if you have sufficient balance for the trade. Verify the network status is normal, and if issues persist, wait a few minutes before trying again. ### Token Not Showing If you can't see your tokens, make sure they are properly registered in your wallet. Allow time for synchronization to complete, and verify your token configuration settings are correct.\ Also make sure they are in the first Hathor wallet address as Dozer only have access to this address. ## Next Steps To enhance your trading experience, take time to learn about our [Liquidity Pools](/trading-platform/liquidity-pools), understand our [MEV Protection](/trading-platform/mev-protection) mechanisms, and review our complete set of [Platform Features](/trading-platform/features). # Liquidity Pools Dozer Finance's liquidity pools enable users to provide liquidity and participate in the platform's trading ecosystem. Our pools are inspired by Uniswap v2 but optimized for low fees and instant finality. ## Understanding Liquidity Pools ### What are Liquidity Pools? Liquidity pools are smart contracts that hold pairs of tokens, allowing users to: * Trade between token pairs * Provide liquidity to earn fees * Participate in the platform's growth ### Pool Features * Zero-fee transactions for simple operations * Instant finality for all operations * MEV protection through transaction ordering * Real-time pool statistics and monitoring ## Pool Operations ### Adding Liquidity To add liquidity to a pool: 1. Navigate to the Pool section 2. Select the token pair 3. Enter the amount for one token 4. The interface will automatically calculate the required amount of the second token 5. Click in "Add Liquidity" and review details 6. Approve the transaction in your wallet 7. Receive LP tokens representing your pool share ### Removing Liquidity To remove your liquidity: 1. Go to your active pools 2. Select the pool you want to exit 3. Choose the amount of liquidity you want to remove 4. Click in "Remove Liquidity" 5. Approve the transaction 6. Receive your tokens back ## Pool Economics ### Fee Structure * Trading fees: 0.3% per swap * Protocol fees: Configurable percentage of trading fees * Zero platform fees for simple operations ### Earning as a Liquidity Provider Liquidity providers earn through: * A share of the trading fees proportional to their pool contribution * Additional incentives during promotional periods ## Technical Details ### Pool Initialization * Pools require initial deposits of both tokens * Initial price is determined by the first liquidity provider ### Pool Calculations Pool prices are dynamically determined by the token reserves using the automated market maker (AMM) formula x \* y = k. To protect users, we implement slippage protection through minimum output amounts, ensuring fair trade execution. ### Price Impact Our interface provides real-time price impact information before trade confirmation. While smaller trades typically have minimal impact, larger trades may experience more significant price effects. This transparency helps users make informed trading decisions. ## Pool Management ### Viewing Pool Statistics Monitor your pool performance through our comprehensive dashboard, which displays current liquidity, volume, fees earned, your pool share, and maximum withdrawal amounts. This information helps you make informed decisions about your liquidity positions. ### Tracking Rewards Our platform provides detailed tracking of your accumulated trading fees, current pool positions, and total value locked (TVL). This transparency ensures you can always monitor your earnings and position value. ## Best Practices ### Before Providing Liquidity 1. Understand impermanent loss 2. Have sufficient amounts of both tokens 3. Review pool statistics and volume 4. Check current pool ratios ### Risk Management We recommend starting with smaller amounts to familiarize yourself with the system. Regular monitoring of your positions is essential, as pool ratios can change based on market conditions. Stay informed about market movements that might affect your liquidity position. ## Next Steps Deepen your understanding of our platform by reviewing our comprehensive [Trading Guide](/trading-platform/trading-guide), learning about our [MEV Protection](/trading-platform/mev-protection), and exploring our [Platform Features](/trading-platform/features). # MEV Protection ## What is MEV? Maximal Extractable Value (MEV) represents the potential profit miners or validators can extract by manipulating transaction ordering within blocks. Common MEV exploitation methods include front-running (placing orders ahead of known upcoming trades), sandwich attacks (placing orders before and after a target trade), and back-running (placing orders immediately after profitable trades). ## Dozer's MEV Protection ### Enhanced Network Protection Dozer Finance leverages and enhances Hathor Network's built-in MEV protection through: 1. **Transaction Ordering Mechanism** * Uses block hash entropy for transaction sequencing * Makes transaction ordering unpredictable yet deterministic * Prevents validators from manipulating transaction order 2. **Fair Execution Environment** * All transactions are treated equally * No privileged transaction positioning * Protected execution paths for all trades 3. **Instant Finality** * Transactions confirm immediately * Reduces window for MEV exploitation * Ensures trade execution at expected prices ## How It Works ### Network Level Protection 1. **DAG Structure** * Parallel transaction processing * No sequential block ordering * Natural protection against traditional MEV vectors 2. **Consensus Mechanism** * Deterministic yet unpredictable ordering * Network-wide transaction validation * Consistent execution across all nodes ### Platform Level Enhancements 1. **Trade Protection** * Protected swap execution paths * Fair price calculation mechanisms * Built-in slippage controls 2. **Order Management** * Real-time trade execution * Protected order submission * Fair order processing ## User Benefits ### Protected Trading Trade with complete confidence knowing your orders cannot be front-run by other traders. You'll consistently get expected execution prices and avoid losses from sandwich attacks, ensuring a fair trading experience. ### Fair Market Our system ensures equal access for all traders with no privileged transaction ordering. This creates a truly fair environment with protected price discovery mechanisms. ### Cost Savings Traders benefit from the elimination of MEV-related losses and fair transaction fees. There's no need for additional protection mechanisms as security is built into the core platform. ## Technical Implementation ### Transaction Processing 1. **Order Submission** * Orders enter the network randomly * No predictable submission patterns * Protected transaction paths 2. **Execution** * Deterministic execution order * Network-wide consensus on ordering * Protected state transitions 3. **Confirmation** * Instant trade finality * Protected settlement process * Verifiable execution path ## Best Practices ### Trading Safely 1. **Use the Interface** * Our interface includes all protection mechanisms * Follow recommended slippage settings * Monitor trade execution 2. **Transaction Monitoring** * Watch your transactions in real-time * Verify execution prices * Check trade outcomes ### Understanding Protection Our MEV protection works automatically and is built into every transaction on the platform. You don't need to take any additional steps to benefit from these security measures. ## Future Enhancements We maintain an ongoing collaboration with the Hathor Network team to enhance our protection mechanisms, improve transaction ordering, and further strengthen market fairness. Our commitment to security drives continuous improvement in our MEV protection capabilities. ## Learn More Deepen your understanding of our platform by reviewing our comprehensive [Trading Guide](/trading-platform/trading-guide), learning about our [Liquidity Pools](/trading-platform/liquidity-pools), and exploring our [Platform Features](/trading-platform/features). # Overview Dozer Project Launch Tools deploy a complete token ecosystem β€” vesting, public sale, liquidity, staking, and DAO governance β€” directly from a browser, with each on-chain action confirmed in the project owner's wallet. The landing page at [testnet.tools.dozer.finance](https://testnet.tools.dozer.finance/) is the entry point for both project creators and token holders. Dozer Tools landing page hero ## What You Can Deploy | Tool | Purpose | | ------------------ | --------------------------------------------------------------- | | **Token** | Create a Hathor token with custom name, symbol, and supply | | **Vesting** | Lock and release tokens over time for team, advisors, ecosystem | | **Launchpad** | Run a public crowdsale with soft/hard caps and refunds | | **Liquidity Pool** | Seed a DZR/token pool on the Dozer DEX | | **Staking** | Distribute rewards to token holders who lock their tokens | | **DAO Governance** | On-chain proposals and quorum-based voting | ## The Project Setup Flow Once you connect a wallet and select a project, the admin dashboard shows a six-step checklist: 1. **Create Token** β€” set name, symbol, supply, and metadata 2. **Configure Vesting** β€” split your supply across ecosystem allocations and custom schedules 3. **Token Sale** β€” run an optional public crowdsale 4. **Liquidity Pool** β€” provide initial liquidity on the Dozer DEX 5. **Staking Contract** β€” activate the rewards pool defined in vesting 6. **DAO Governance** β€” enable on-chain voting Vesting gates everything else. Inside vesting, each Special Allocation % unlocks its corresponding tool: **Public Sale %** unlocks the Launchpad, **Liquidity Pool %** unlocks the Liquidity tool, **Staking Rewards %** auto-deploys the staking pool. DAO Governance additionally requires a Staking Contract β€” you can't set it up without one. Project Setup six-step checklist on the admin dashboard ## Prerequisites * **Hathor wallet** with Reown (WalletConnect) support β€” [Hathor Wallet desktop or mobile](https://hathor.network/wallets/) * **HTR** (or **DZR**) for transaction fees and the credits balance * **Modern browser** (Chrome, Brave, Edge, Firefox) > **Testnet**: For testing on `testnet.tools.dozer.finance`, use the **Faucet 100k HTR** button in the sidebar to top up the wallet balance. ## Connecting Your Wallet 1. From the admin dashboard, click **Connect Wallet**. 2. A WalletConnect modal appears with a QR code and a copy-link icon. 3. In your Hathor wallet, open the **QR-code icon** at the top right, choose **Manual**, then **Reown Connection**. 4. Paste the URI and click **Connect**. Approve the session request that follows. The wallet address shown in the sidebar footer changes from `Connect Wallet` to your address with a green "Connected" indicator. ## Credits Most on-chain operations (creating staking pools, DAOs, crowdsales, liquidity pools) are paid from a per-project **Credits** balance, not directly from the wallet. * Credits can be funded in **HTR** or **DZR** * DZR is preferred when both are available (lower fees) * Unused credits can be withdrawn at any time Minimum HTR deposit is **100.00 HTR**. See the [Credits screen](/project-launch-tools/overview) inside each project for current balance and deposit/withdraw forms. ## Next Steps * [Project Creation Guide](/project-launch-tools/project-creation) β€” create your token * [Vesting Configuration](/project-launch-tools/vesting-configuration) β€” define how tokens unlock * [Launchpad / Crowdsale](/project-launch-tools/crowdsale) β€” run a public sale * [Staking](/project-launch-tools/staking) β€” distribute rewards to holders * [Token Claiming](/project-launch-tools/token-claiming) β€” claim vested or purchased tokens ## Support * [Discord](https://discord.gg/KRhaCp6P) * # Project Creation This guide walks through creating a new token project on [testnet.tools.dozer.finance](https://testnet.tools.dozer.finance/). The same flow applies on mainnet when it launches. ## Prerequisites * Hathor wallet with Reown / WalletConnect support * HTR for the creation fee (currently **100 HTR**) β€” or **50 DZR** if you hold DZR * Token plan: name, symbol, supply, and optional metadata ## Step 1 β€” Open the Admin Dashboard 1. Visit [testnet.tools.dozer.finance](https://testnet.tools.dozer.finance/). 2. Click **Launch your project**. 3. The admin dashboard loads at `/admin` with a "Get Started with Your First Project" card and a **Connect Wallet** button. Admin dashboard β€” Get Started with Your First Project ## Step 2 β€” Connect Your Wallet 1. Click **Connect Wallet** in the center card (or in the sidebar footer). 2. A **WalletConnect** modal appears with a QR code and a copy-link icon. WalletConnect modal with QR code and copy URI button 3. Click the **copy** icon to copy the connection URI. 4. Open the Hathor wallet and click the **QR-code icon** in the top right. 5. Tap **Manual** β†’ **Reown Connection**, paste the URI, then **Connect**. 6. Approve the session request in the wallet. The dashboard reloads in its connected state: the sidebar footer shows your address with a green **Connected** indicator, and the **Create Project** button appears at the top of the sidebar. ## Step 3 β€” Open the Create Project Form Click **+ Create Project** in the top-left of the sidebar. You land on the **New Project** form. Empty Create Project form ## Step 4 β€” Fill the Form ### Required Fields | Field | Notes | | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | **Token Name** | Full display name (e.g. "My Token"). Permanent. | | **Symbol** | Short ticker (typically 3-5 chars, e.g. "MTK"). Permanent and must be unique on the network β€” a green βœ“ **Available** badge confirms it as you type. | | **Total Supply** | Maximum tokens that will ever exist. Permanent. Default `1,000,000`. | ### Optional Fields | Field | Notes | | --------------- | ------------------------------------------------------- | | **Category** | Categorisation in the public token explorer | | **Description** | Shown on the public token page | | **Logo** | PNG/JPG/JPEG, max 5 MB | | **Links** | Website, Twitter, Telegram, Discord, GitHub, Whitepaper | ### Creation Fee Choose how to pay the deployment fee: * **HTR Β· 100** (default) * **DZR Β· 50** Filled Create Project form showing the Available symbol badge > ⚠️ **Permanent fields**: Token Name, Symbol, and Total Supply cannot be changed after deployment. Double-check before submitting. ## Step 5 β€” Deploy 1. Scroll to the bottom of the form. The total **Fee** is shown next to the **Create Project** button. 2. Click **Create Project**. The button changes to **Accept in wallet…** 3. Approve the transaction in the Hathor wallet and enter your PIN. 4. Wait for confirmation. You'll be redirected to the project's admin dashboard. ## Step 6 β€” Project Dashboard After deployment, the project dashboard shows: * **Header card**: token icon, name, symbol, holders, market cap, total supply, price, plus **View on Explorer** and **Manage Token** buttons. * **Project Setup**: a six-step checklist tracking the remaining setup actions. Project dashboard with header and 6-step Project Setup checklist | Step | Status flag | Action | | ------------------------- | --------------------------------------------- | ------------- | | 1. Create Token | βœ… done | β€” | | 2. Configure Vesting | required next | **Manage** | | 3. Token Sale (Launchpad) | unlocks after #2 | **Manage** | | 4. Liquidity Pool | unlocks after #2 | **Configure** | | 5. Staking Contract | created by #2 if you allocate Staking Rewards | **Manage** | | 6. DAO Governance | **requires Staking Contract** | **Set up** | ## Token Manager Options From the sidebar's **Token Manager** section, four actions are available: * **Melt Authority** β€” Transfer melt rights to your wallet so you can decrease total supply. * **Edit Metadata** β€” Update description, social links, category, etc. * **Transfer Authority** β€” Permanently transfer project ownership to another developer address. * **Cancel Project** β€” Only available before vesting is configured. After vesting deploys, the project cannot be cancelled. Token Manager page with 4 management option cards ## Troubleshooting | Symptom | Fix | | --------------------------- | ----------------------------------------------------------------- | | Wallet won't connect | The Reown URI expires quickly β€” copy and paste in one go | | Symbol shows as unavailable | Another project already uses it; pick a different one | | Transaction fails | Confirm HTR balance covers the 100 HTR fee, or switch to DZR Β· 50 | | "Connecting…" button stuck | Refresh and reconnect; sessions can drop after long idle | ## Next Steps Once your token is created, continue with [Vesting Configuration](/project-launch-tools/vesting-configuration) at `/admin/vesting/create` β€” vesting is required before any other tool unlocks, and the form offers Quick-start Templates if you want a sensible default. # Token Management Once your token is created, the **Token Manager** screen at `/admin/token/management` exposes the post-deployment actions that fall outside of Vesting, Launchpad, Liquidity, Staking, and DAO. Open it from the sidebar's **Token Manager** entry under **Token Management**. The header shows the token name, symbol, and current supply. Below it, four action cards. Token Management page with 4 action cards ## Melt Authority > Transfer melt authority to your wallet. When a token is created, Hathor issues a **melt authority** that allows decreasing total supply. By default this authority lives in the project contract. Pulling it into your wallet lets you burn tokens β€” useful for buybacks, supply cuts, or correcting accidental mints. * **What happens**: The melt authority is transferred from the project to your connected wallet address. * **Reversible?** No. Once moved out of the project, it stays in the wallet you choose. * **Then what?** With the authority in your wallet you can burn tokens through any Hathor wallet supporting token authorities. Click **Get Authority**, approve the transaction in the wallet, enter your PIN. ## Edit Metadata > Update project description, social links, and other metadata. The token's name, symbol, and supply are permanent. Everything else β€” description, website, Twitter, Telegram, Discord, GitHub, Whitepaper, logo, category β€” can be updated here at any time. Click **Edit Metadata** to open the edit form, change the fields you need, and submit. Metadata updates do not require a blockchain transaction. ## Transfer Authority > Transfer project ownership to another developer address. Permanently hands over **project ownership and developer authority** to a different Hathor address. The new owner gains full admin access β€” they can manage vesting, launchpad, liquidity, staking, DAO, and the Token Manager actions on this page. > ⚠️ **Irreversible.** Triple-check the recipient address. Once transferred, you cannot reclaim ownership. Use cases: * Moving a project from a personal dev wallet to a multisig * Handing off after acquisition * Decentralising control to a foundation address Click **Transfer Authority**, enter the new owner address, confirm, sign in wallet. ## Cancel Project > Cannot delete project after vesting is configured. Available **only before vesting deploys**. Once vesting is configured the card shows **Not Available** with the explanation that projects with vesting cannot be cancelled, for security reasons. If your project has no vesting yet and you want to abandon it, click **Cancel Project** and confirm. ## When to Use Each Action | Situation | Action | | ---------------------------------------------- | ----------------------------------------------------- | | Need to burn tokens / reduce supply | **Melt Authority** β†’ Get Authority β†’ burn from wallet | | Updated social links or logo | **Edit Metadata** | | Handing off to a DAO multisig | **Transfer Authority** | | Test project deployed by mistake (pre-vesting) | **Cancel Project** | ## Troubleshooting | Symptom | Fix | | ------------------------------------ | ----------------------------------------------------------------------------- | | Cancel Project shows "Not Available" | Vesting is already configured β€” cancellation is permanently disabled | | Edit Metadata changes not visible | Refresh the public token page; CDN may cache for a few minutes | | Transfer Authority fails | Address must be a valid Hathor address; ensure the wallet has HTR for the fee | ## Related * [Project Creation](/project-launch-tools/project-creation) β€” initial setup before reaching this screen * [Credits](/project-launch-tools/credits) β€” how project operations are paid for * [Vesting Configuration](/project-launch-tools/vesting-configuration) β€” once vesting deploys, Cancel Project is permanently disabled # Project Credits Each project has a **Credits** balance β€” a per-project prepaid pool of HTR and/or DZR used to pay for on-chain operations: creating staking contracts, DAOs, crowdsales, and liquidity pools. Open the Credits screen at `/admin/credits` (sidebar β†’ **Credits**). Project Credits screen with Current Balance, Deposit, Withdraw, and About sections ## Why credits exist Most Project Launch Tools actions are submitted by the project contract, not directly by your wallet. The project needs its own balance to cover those fees. The Credits screen is where you fund and reclaim that balance. ## Current Balance Two rows: **HTR Balance** and **DZR Balance**. Minimum HTR deposit is **100.00 HTR** β€” smaller deposits are not accepted. ## Deposit Credits Add HTR or DZR to the project balance. 1. Pick **Token Type** (HTR or DZR). 2. Enter an **Amount**. 3. Click **Deposit Credits**, confirm in the wallet, sign with PIN. The deposit goes from your connected wallet to the project's credit pool. ## Withdraw Credits Reclaim unused HTR or DZR. Each transaction can withdraw **only one token type** β€” withdraw HTR and DZR separately if needed. 1. Pick **Token Type** (HTR or DZR). The available balance is shown next to each option, and the **Max** link fills the amount field with the full balance. 2. Enter the amount to withdraw. 3. Click **Withdraw Credits**, confirm in the wallet. The withdrawal goes back to your connected wallet. ## HTR vs DZR β€” Which to Use? > DZR credits are preferred over HTR when both are available, as they typically have lower fees. Practical guidance: * **HTR**: easier to obtain, especially on testnet (use the **Faucet 100k HTR** button in the sidebar). * **DZR**: lower per-action cost; keeps your project lean as it scales. Most projects start with HTR for setup and refill in DZR once they hold some. ## What credits get spent on Any action that the project contract submits on-chain, including: * Creating a Liquidity Pool * Creating a Crowdsale / Launchpad * Setting up a DAO * Adding rewards to a Staking pool * Some token-management actions (when they require contract calls) Wallet-paid actions β€” like the initial project creation, vesting deploy, or melt-authority transfer β€” are paid directly from the user's wallet, not from credits. ## Best Practices * **Top up before a busy launch week** β€” pre-fund credits so a wallet hiccup doesn't block a planned action. * **Use DZR once available** β€” lower fees mean more operations per credit. * **Withdraw before sunsetting a project** β€” credits don't expire, but they're locked to the project until withdrawn. * **Keep a buffer** β€” leave at least one full transaction's worth in credits so urgent actions (pausing a sale, for example) don't fail. ## Troubleshooting | Symptom | Fix | | ------------------------------------ | ------------------------------------------------------------- | | Deposit Credits button is disabled | You're below the 100.00 HTR minimum, or amount field is empty | | "Insufficient balance" on deposit | Top up your wallet HTR or DZR first | | Action fails with "credits required" | The project pool ran dry β€” deposit more credits | | Withdraw button disabled | Selected token's available balance is 0 | ## Related * [Token Management](/project-launch-tools/token-management) β€” the other admin-only screen for an existing project * [Project Creation](/project-launch-tools/project-creation) β€” initial setup, paid from wallet (not credits) * [Vesting Configuration](/project-launch-tools/vesting-configuration), [Crowdsale](/project-launch-tools/crowdsale), [Staking](/project-launch-tools/staking) β€” features whose deployments consume credits # Vesting Configuration Vesting is the gatekeeper of every other Project Launch Tool. Until vesting deploys, the Launchpad, Liquidity Pool, Staking, and DAO steps are locked. A vesting plan does two things: 1. Splits part of the supply into **Special Allocations** (Staking Rewards, Public Sale, Liquidity Pool) β€” these unlock the corresponding tools. 2. Splits the rest into **Vesting Allocations** (Team, Advisors, Ecosystem reserve, etc.) with per-beneficiary cliffs and durations. Total of all allocations must equal exactly **100%** β€” the form blocks submission otherwise. ## Prerequisites * Project created (see [Project Creation Guide](/project-launch-tools/project-creation)) * HTR or DZR for the vesting transaction fee * Allocation plan: percentages, beneficiary addresses, cliff/vest periods ## Opening Vesting Setup From the project dashboard's setup checklist, click **Manage** on **Configure Vesting** β€” or use the sidebar's **Vesting** entry under **Finance**. For a project where vesting has not yet been configured, you land on the **Configure Project Vesting** form at `/admin/vesting/create`. For projects where vesting already exists, you land on the **Vesting Manage** view at `/admin/vesting/manage` (covered at the bottom of this page). If you arrive at this page by clicking **Manage** on a still-locked feature (Launchpad, Liquidity, Staking, DAO), an amber **Unlock hint** banner at the top tells you which Special Allocation field to fill to unlock it. Vesting setup form with Quick-start Templates, Special Allocations and Vesting Allocations sections ## Quick-start Templates At the top of the setup form, three presets seed the entire allocation in one click. You can edit any value after applying: | Template | Style | | ------------------- | ------------------------------------------------------------------- | | **Balanced DeFi** | Classic DeFi launch β€” split across public sale, ecosystem, and team | | **Community First** | More tokens for public sale and staking, less for insiders | | **Minimal / Solo** | Simple distribution for a solo founder or small team | ## Special Allocations These three fields unlock the corresponding tools when set above 0%: | Field | What it does | | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | **Staking Rewards (%)** | Creates a staking pool that distributes this % of the supply over the configured pool duration. Also required before DAO Governance can be set up. | | **Public Sale (%)** | Reserves this % of the supply for the Launchpad crowdsale. | | **Liquidity Pool (%)** | Reserves this % to seed the Dozer DEX pool. | For staking, you also pick a **Staking Pool Duration** from a dropdown. The UI automatically derives the daily reward rate from `staking allocation Γ· duration`. Special Allocations: Staking Rewards, Public Sale, Liquidity Pool fields ## Vesting Allocations Add one row per beneficiary group. Common patterns: | Group | Suggested cliff | Suggested vest | Typical % | | --------- | --------------- | -------------- | --------- | | Team | 6–12 mo | 24–48 mo | 15–25% | | Advisors | 0–3 mo | 12–24 mo | 2–5% | | Investors | per agreement | 12–36 mo | 20–40% | | Ecosystem | 0 mo | 24–36 mo | varies | Per-row fields: * **Name** β€” display label (e.g. "Team, Advisors, etc.") * **Percentage (%)** β€” share of total supply * **Beneficiary Address** β€” Hathor address that can claim the vested tokens (toggle **Use owner address** to default to your wallet) * **Cliff (months)** β€” initial lock period; nothing unlocks during this * **Vesting (months)** β€” linear release window after the cliff The **Allocation Summary** card at the bottom of the form tallies Special + Vesting totals. The **Configure Vesting** button stays disabled until the total equals exactly 100% with no unfilled rows. Vesting Allocations rows with Name, Percentage, Beneficiary, Cliff, Vesting (months) ## Review & Deploy 1. Verify percentages add up as planned. 2. Verify every beneficiary address β€” these are irreversible. 3. Click **Configure Vesting**. 4. Approve the transaction in the Hathor wallet and enter your PIN. Once confirmed: * The corresponding tools (Launchpad / Liquidity / Staking) unlock in the dashboard checklist. * The staking pool is live immediately if a Staking Rewards % was set. * The Liquidity Pool reserves the DZR allocation, ready to pair with HTR via the [Liquidity tool](/project-launch-tools/vesting-configuration). ## The Vesting Manage View After deployment, the Vesting page shows the active configuration. Vesting Manage view showing Status, Total allocated, Ecosystem Allocations table, and Your Vesting Schedule table Header KPIs: * **Status** β€” Active / Inactive * **Total allocated** β€” full supply allocated through vesting * **Total vested** β€” sum already unlocked across all beneficiaries **Ecosystem Allocations** (the label used in the Manage view) lists Staking, Public Sale, Liquidity Pool β€” each with a **Manage** button that links to the corresponding tool (Create for ones not yet deployed). **Your Vesting Schedule** is a per-allocation table: | Column | Notes | | ------------ | --------------------------------------- | | Allocation | Name + Vesting tag | | Beneficiary | Truncated Hathor address | | Total | Total tokens reserved | | Progress | % unlocked so far (linear progress bar) | | Cliff / Vest | e.g. `12mo / 24mo` | Beneficiaries view this same schedule from the public token page β€” see the [Token Claiming](/project-launch-tools/token-claiming) guide. ## Best Practices * **Plan ecosystem % first**: it determines how much remains for team/advisors/investors. * **Test on testnet** with realistic allocations before mainnet. * **Use multisig addresses** for large team or treasury allocations. * **Document publicly**: post your vesting schedule on your project's site for transparency. ## Troubleshooting | Symptom | Fix | | ---------------------------------------- | ---------------------------------------------------------------- | | `Configure Vesting` button disabled | Total allocations exceed 100% β€” reduce some rows | | Beneficiary field rejects address | Address must be a valid Hathor address; check for whitespace | | Staking tool doesn't unlock after deploy | Staking Rewards % was 0 β€” re-configure or skip staking | | Transaction fails | Check HTR/DZR balance and that the wallet session hasn't expired | ## Next Steps * [Launchpad / Crowdsale](/project-launch-tools/crowdsale) β€” if you allocated a Public Sale % * [Staking](/project-launch-tools/staking) β€” if you allocated Staking Rewards % * [Token Claiming](/project-launch-tools/token-claiming) β€” what beneficiaries see and how they claim # Crowdsale The Launchpad tool runs a public token sale for the % of supply reserved as **Public Sale** in your vesting configuration. The dapp surfaces it as **Launchpad** in the sidebar; admin and public pages title it **Crowdsale Management** and **Token Sale** respectively. This page covers the **project creator side** β€” creating, managing, and finalizing the sale. If you're a buyer looking to participate, see [Participating in a Token Sale](/user-guides/participating-in-token-sale). ## Prerequisites * Project created and **vesting configured with a Public Sale %** (see [Vesting Configuration](/project-launch-tools/vesting-configuration)). * HTR or DZR in the project Credits balance for the deployment transaction. * Wallet connected as project owner. ## Step 1 β€” Open Launchpad Setup From the project dashboard's setup checklist, click **Manage** on **Token Sale** β€” or use the sidebar's **Launchpad** entry under **Finance**. For a project with no existing sale, the setup form loads. For projects where a sale already exists, the **Crowdsale Management** panel loads. Launchpad setup form with sale parameters ## Step 2 β€” Configure Sale Parameters The form has two cards: **Sale Allocation** (the rate) and **Sale Configuration** (caps, dates): | Field | Notes | | ------------------------------- | ----------------------------------------------------------------------------------- | | **Token Rate (Tokens per HTR)** | Exchange rate, e.g. `500` tokens per 1 HTR | | **Soft Cap (HTR)** | Minimum funding goal. If unreached at end of sale, buyers can refund their HTR. | | **Minimum Deposit (HTR)** | Per-transaction minimum, e.g. `10.00 HTR` | | **Start sale immediately** | Checkbox; when on, the Start Date field is hidden and the sale opens on deployment. | | **Start Date** | Sale opens at this timestamp (hidden if Start immediately is checked) | | **End Date** | Sale closes at this timestamp | The **Hard Cap is calculated automatically** as `tokens available Γ— rate` β€” no field for it. Tokens available comes from your vesting Public Sale allocation. The full allocation is reserved at deployment; unsold tokens can be withdrawn after finalization. ## Step 3 β€” Deploy 1. Click **Create Crowdsale**. 2. Approve in the Hathor wallet and enter your PIN. 3. After confirmation, the dashboard's Token Sale step shows βœ… and the Launchpad menu now opens the **Crowdsale Management** view. ## The Crowdsale Management View The management panel runs the sale through its lifecycle states (from `formatSaleState`): | State | Meaning | | -------------------- | --------------------------------------------------------------------------- | | **Upcoming** | Deployed but Start Date hasn't been reached yet | | **Ready** | Past Start Date but admin still needs to start the sale (manual start mode) | | **Live** | Accepting purchases | | **Paused** | Admin paused; purchases blocked | | **Soft Cap Reached** | Soft Cap met but sale still running (admin may finalize early) | | **Successful** | Finalized and Soft Cap was reached β€” buyers can claim, admin can withdraw | | **Failed** | Finalized and Soft Cap was not reached β€” buyers can refund | Crowdsale Management view: status, Sale Progress, Token Allocation, Sale Statistics, Sale Configuration Top of page: * **Status badge** (Upcoming / Live / Paused / Ended) * **Countdown** to start or end * **Start Sale Early** button (for Upcoming sales) / **Pause / Resume** / **Finalize** buttons depending on state * **Preview Token Sale** link (top right) β€” opens the public sale page in a new tab Sections: | Section | Shows | | ---------------------- | ------------------------------------------------------------------------ | | **Sale Progress** | Raised amount, Hard Cap goal, % of Hard Cap, participants | | **Token Allocation** | Allocation % from vesting, Total Allocated tokens, Sold % | | **Sale Statistics** | Total Raised, Tokens Sold | | **Sale Configuration** | Read-only summary: Rate, Soft Cap, Hard Cap, Start/End Time, Min Deposit | ## Pausing & Resuming Use Pause only for emergencies (a discovered exploit, regulatory inquiry, etc.): 1. Click **Pause Sale**, approve in wallet, enter PIN. 2. Status changes to **Paused**. Buyers see a banner on the public page and the purchase form is disabled. 3. Click **Resume Sale** to re-open. ## Finalizing & Withdrawing Once the sale has ended (or you choose to close it early after the Soft Cap is reached): 1. Click **Finalize Sale** β†’ approve in wallet. 2. The management panel updates with final results. 3. **Withdraw Raised HTR** β€” sends the raised HTR to your wallet. 4. **Withdraw Remaining Tokens** β€” returns any unsold portion of the Public Sale allocation to your wallet. > ⚠️ If the Soft Cap was **not** reached, the sale enters refund mode. Buyers can withdraw their HTR from the public page; you cannot withdraw the raised funds. ## For Token Buyers The buyer-facing flow β€” finding a sale, purchasing, refunds, and claiming β€” is documented in [Participating in a Token Sale](/user-guides/participating-in-token-sale). ## Best Practices * **Realistic Soft Cap** β€” Set it to your minimum viable funding. Too high risks sale failure and refunds. * **Allow enough time** β€” 7–14 days minimum for community participation. Don't run a sale across a major regional holiday. * **Pre-announce** β€” At least one week ahead, share the token address and the official `/launchpad/` URL. * **Pause sparingly** β€” It shakes buyer confidence. Reserve for emergencies. ## Troubleshooting | Symptom | Fix | | --------------------------------- | --------------------------------------------------------------------------------------- | | Cannot create sale | Vesting must have Public Sale % > 0 | | Sale stuck in Upcoming past start | If "Start sale immediately" was off, click **Start Sale Early** in the management panel | | Finalize button disabled | Sale period must have ended OR Soft Cap reached | | Withdraw HTR fails | Sale must be finalized first; check the Credits balance | ## Next Steps * [Staking](/project-launch-tools/staking) β€” set up a rewards pool for your token holders * [Token Claiming](/project-launch-tools/token-claiming) β€” concept overview of how beneficiaries access their tokens # Staking The Staking tool creates a rewards pool funded from your token's vesting allocation. Holders lock tokens for a fixed period and earn a share of daily rewards proportional to their stake. A staking pool is **created automatically** the moment vesting is deployed with a Staking Rewards % above 0. You don't deploy it separately β€” you only **manage** it afterwards. This page covers the **project creator side** β€” managing the pool, topping up rewards, pausing in emergencies. If you're a token holder looking to stake, see [Staking Tokens](/user-guides/staking-tokens). ## Prerequisites * Project created * Vesting configured with **Staking Rewards %** > 0 (see [Vesting Configuration](/project-launch-tools/vesting-configuration)) ## Opening the Management Panel From the project dashboard, click **Manage** on the **Staking Contract** step β€” or use the sidebar's **Staking** entry under **Governance**. Staking Pool admin management page with statistics, controls, and rewards section ## Pool Statistics Top-left block shows real-time pool health: | Metric | Meaning | | ----------------- | --------------------------------------------------------------- | | **APY** | Estimated annual yield based on current Total Staked vs rewards | | **Total Staked** | Tokens currently staked by all users | | **Daily Rewards** | Tokens distributed per day across all stakers | | **Rewards Last** | Days remaining until the rewards pool is depleted | ## Admin Overview Shows your rewards reserve and pool status: * **Rewards Balance** β€” tokens left to distribute * **Total Staked** β€” duplicated from above for quick reference * **Pool Status** β€” Active / Paused * **Health** β€” Healthy / Warning / Depleted (based on days remaining) ## Add Reward Tokens Top up the rewards pool from your wallet balance. The form shows: * **Current Reward Pool** β€” Owner balance, Days remaining, Daily distribution * **Amount to Add** β€” with a recommended figure (e.g. "624,999.6 for 30 days") * **Recommendation panel** β€” guidance on minimum reserve Adding more rewards either **extends the pool duration** (if daily rate is kept) or **increases the APY**. ## Pool Controls The **Pause Pool** button (red) immediately halts new stakes and unstakes. Use for emergencies β€” security issues, contract maintenance, or imminent reward depletion. Resume re-enables normal activity. ## Rewards Reserve Projection Chart in the lower-right showing the estimated rewards balance over time at the current distribution rate. A 30-day rewards-reserve warning threshold is marked with a dashed line β€” top up before crossing it. ## Contract Information Bottom card surfaces the on-chain contract ID and token reference for inclusion in your project docs or block-explorer links. ## For Token Holders The holder-facing flow β€” staking, unstaking, monitoring rewards β€” is documented in [Staking Tokens](/user-guides/staking-tokens). ## Best Practices * **Top up before depletion** β€” Add rewards before crossing the 30-day warning line on the reserve projection. APY collapses fast when reserves dry. * **Announce top-ups** β€” They materially affect APY; holders watch this. * **Pause sparingly** β€” Use only for security issues or contract maintenance. Communicate proactively when you do. * **Plan duration ahead** β€” Set the Staking Pool Duration in vesting to match your roadmap; extending later means adding rewards. ## Troubleshooting | Symptom | Fix | | ------------------------------- | -------------------------------------------------------------------- | | Add Reward Tokens button greyed | Your wallet balance is 0, or amount is below the recommended minimum | | Pool Status stuck on "Paused" | You (or a previous admin) paused β€” click **Unpause Pool** to resume | | APY is 0% | Either the rewards pool is empty or no one has staked yet | | Health shows "Warning" | Rewards Last is below 30 days β€” top up rewards | ## Next Steps * [Token Claiming](/project-launch-tools/token-claiming) β€” concept overview of token claiming * [Project Credits](/project-launch-tools/credits) β€” fund the pool with reward top-up transactions # Token Claiming Token claiming is the user-facing side of vesting and Launchpad sales β€” it's how beneficiaries and buyers actually receive the tokens that have been allocated to them on-chain. This page is a concept overview for project creators. **End users** should use the dedicated user guides: * [πŸͺ™ Claiming Vested Tokens](/user-guides/claiming-vested-tokens) β€” for vesting beneficiaries (team, advisors, ecosystem allocations) * [πŸ”₯ Participating in a Token Sale](/user-guides/participating-in-token-sale) β€” for Launchpad sale buyers (includes the claim step after a successful sale) ## Two Claim Surfaces Dozer Tools exposes claiming in two different places, depending on where the allocation came from. ### 1. Vesting claims β€” Token Vesting section For tokens distributed through your project's **vesting plan** (team, advisors, ecosystem reserves, custom investor allocations). * **Where**: The public token page at `/tokens/`, in the **Token Vesting** section. * **Tabs**: Allocations (claim here), Distribution (visualization), Vesting Schedule (timeline). * **Status states**: Cliff Period, Vesting in Progress, Available to Claim, Nothing to Claim, Fully Claimed. * **Per-row claim**: Each beneficiary row has its own Claim button. ### 2. Launchpad claims β€” Public sale page For tokens purchased through a **Launchpad crowdsale**. * **Where**: The public sale page at `/launchpad/`, in the **Your Participation** panel. * **Available after**: The project owner finalizes a Successful sale. * **Failed sale**: Same panel exposes a **Refund** button instead, returning HTR to the buyer. ## What Project Creators Should Know * You don't claim on behalf of beneficiaries β€” they claim themselves. * Beneficiaries claim **per allocation**, **per project**. Cross-project bulk claiming is not supported. * Each claim costs the beneficiary a small HTR transaction fee. Most users batch claims rather than claiming every unlock cycle. * The status badges and progress bars on the Token Vesting tab update automatically β€” beneficiaries can use the page as a read-only monitor. ## What to Tell Your Beneficiaries When onboarding a new beneficiary group (team, advisors, investors), include in your communication: 1. The **token contract address** (or public token page URL: `/tokens/`) 2. The **exact Hathor address** you registered as their beneficiary 3. A link to the [Claiming Vested Tokens](/user-guides/claiming-vested-tokens) guide 4. The **cliff and vesting duration** so they know when to expect first unlocks ## Related * [Vesting Configuration](/project-launch-tools/vesting-configuration) β€” where beneficiary addresses and schedules are set * [Crowdsale](/project-launch-tools/crowdsale) β€” sale management; the buyer claim flow is in the user guide * [Claiming Vested Tokens (User Guide)](/user-guides/claiming-vested-tokens) * [Participating in a Token Sale (User Guide)](/user-guides/participating-in-token-sale) # Wallet Setup This guide will walk you through setting up your wallet to use Dozer Finance. ## Installing Hathor Wallet ### Download Options * [Android - Google Play Store](https://play.google.com/store/apps/details?id=network.hathor.wallet\&hl=en) * [iOS - App Store](https://apps.apple.com/us/app/hathor-wallet/id1465041963) ### First Time Setup 1. Install the app from your device's app store 2. Create a new wallet 3. Securely store your seed phrase 4. Set up a PIN for transactions ### Security Settings To ensure the security of your wallet, start by enabling biometric authentication if your device supports it. You'll need to set up a secure PIN for transactions. Remember to store your seed phrase in a safe place and never share your private keys with anyone. ## Connecting to Dozer ### Initial Connection 1. Visit [testnet.dozer.finance/swap](https://testnet.dozer.finance/swap) 2. Click "Connect Wallet" 3. In your Hathor Wallet: * Open "Reown" in "Settings" screen * Select "Add" * Read the QR Code or input the WalletConnect URL manually. 4. Approve the connection request ### Managing Connections Take an active role in managing your wallet connections. Regularly review your active connections and disconnect any unused sessions. Always verify new connection requests carefully and keep track of which sites are connected to your wallet. ## Best Practices ### Security Your wallet security should be a top priority. Never share your seed phrase with anyone and always use secure PINs for transactions. Take advantage of additional security features offered by the wallet, and make sure to keep your wallet application updated with the latest version. ### Usage Tips Before engaging in any trading activity, always check the network status to ensure smooth transactions. Take time to verify all transaction details carefully and regularly monitor your balances. Maintaining awareness of your connected services will help ensure a secure trading experience. ### Wallet Demo Mobile App {% embed url="" fullWidth="false" %} ## Troubleshooting Common Issues ### Connection Problems * Ensure you're on the correct network * Check internet connection * Try refreshing the connection * Clear app cache if needed ### Synchronization Issues * Wait for full synchronization * Check network status * Restart the app if needed * Verify network settings ## Next Steps * Learn how to [Trade](https://github.com/Dozer-Protocol/white-paper/blob/main/gitbook/users/guides/trading-guide.md) * Provide [Liquidity](/user-guides/liquidity-provision) * Review [Troubleshooting](/user-guides/troubleshooting) if needed # Liquidity Provision This guide will help you understand how to provide liquidity on Dozer Finance and earn rewards. ## Understanding Liquidity Provision ### What is Liquidity Provision? Liquidity provision is the process of contributing tokens to trading pools, which enables trading for other users on the platform. As a liquidity provider, you'll earn rewards from trading fees while playing a crucial role in supporting market efficiency. ### Benefits By providing liquidity, you'll earn 0.3% in trading fees from all trades in your pool. This not only provides you with a steady income stream but also helps support the Dozer ecosystem, enables more efficient markets, and allows you to actively participate in the platform's growth. ## Getting Started ### Prerequisites Before getting started, ensure you have a Hathor Wallet connected to the testnet and sufficient amounts of both tokens you wish to provide as liquidity. You should also have a good understanding of impermanent loss and basic knowledge of how liquidity pools work. ### Finding Pools 1. Navigate to Pools section 2. Browse available pools 3. Review pool statistics: * Total liquidity * Volume * Fee earnings * Your potential share ## Adding Liquidity ### Step-by-Step Process 1. Select your pool 2. Choose "Add Liquidity" 3. Enter amount for first token 4. System calculates second token amount 5. Review your contribution 6. Approve transaction in wallet ### Important Considerations When adding liquidity, you'll need to maintain the correct token ratio for the pool. Make sure to account for slippage and understand the minimum amounts required. Review any associated fees and carefully check your potential pool share before confirming your contribution. ## Managing Your Position ### Monitoring 1. View your active pools 2. Track earned fees 3. Monitor pool share 4. Check current values ### Liquidity Management The liquidity position is registered inside the Liquidity Pool nano contract, so you can view your position in the Dozer in two ways: * Inside the pool page, in "My Positions" section * In Pools Table, you can acess "My positions" tab ## Removing Liquidity ### Withdrawal Process 1. Go to Pools section 2. Select active pool 3. Choose "Remove Liquidity" 4. Enter LP token amount 5. Review token returns 6. Confirm transaction 7. Receive tokens back ### Considerations * Check withdrawal timing * Account for price changes * Verify returned amounts * Monitor transaction status ## Understanding Risks ### Impermanent Loss * Price change effects * How to calculate * Risk management * Mitigation strategies ### Market Risks Providing liquidity comes with exposure to market risks including price volatility and pool balance changes. You should monitor volume fluctuations and overall market conditions that could affect your position. ## Best Practices ### Before Adding Liquidity 1. Research the pool 2. Understand the risks 3. Check pool metrics 4. Have sufficient tokens 5. Plan your strategy ### Active Management 1. Monitor your position 2. Track earned fees 3. Assess market conditions 4. Plan exit strategies ## Rewards and Earnings ### Fee Structure Liquidity providers earn a 0.3% fee from all trades in their pool, distributed proportionally based on their pool share. These fees accumulate automatically and can be tracked in real-time through the platform interface. ### Viewing Earnings 1. Check pool interface 2. Monitor fee accumulation 3. Track total returns 4. Calculate APR ## Advanced Topics ### Pool Analysis Successful liquidity provision requires a deep understanding of pool metrics including depth, volume patterns, and potential fee earnings. Consider the market impact of your positions and use this analysis to inform your strategy. ### Strategy Development * Position sizing * Entry/exit timing * Pool selection * Risk management ## Troubleshooting ### Common Issues * Transaction failures * Price impact issues * Slippage problems * Balance discrepancies ### Solutions * Check wallet connection * Verify token approvals * Review pool status * Contact support if needed ## Next Steps * Review [Trading Guide](https://github.com/Dozer-Protocol/white-paper/blob/main/gitbook/users/guides/trading-guide.md) * Understand [MEV Protection](/trading-platform/mev-protection) * Check [Troubleshooting](/user-guides/troubleshooting) if needed # Participating in a Token Sale This guide shows how to buy tokens from a project's public sale on Dozer Tools. The sale page is sometimes called the **Launchpad** or **Crowdsale** β€” they're the same thing. ## What You Need * A **Hathor wallet** with Reown / WalletConnect support * **HTR** for the purchase plus a small extra for transaction fees * The **token URL** or token symbol of the sale you want to join ## Step 1 β€” Find the Sale Three ways to reach a sale: * **Explore β†’ Token Sales** in the top navigation β€” lists all active and upcoming sales. * **Explore β†’ All Tokens** β€” open any token's page; if it has an active sale, the **Token Sale** card surfaces it. * **Direct link** β€” projects usually publish a `/launchpad/` URL on their social channels. ## Step 2 β€” Connect Your Wallet 1. Click **Connect Wallet** in the top right (or anywhere a connect prompt appears). 2. Copy the WalletConnect URI from the modal. 3. In your Hathor wallet, open the **QR icon β†’ Manual β†’ Reown Connection**, paste the URI, click **Connect**. 4. Approve the session request in your wallet. Once connected, the top-right button shows your address (truncated, e.g. `WbvoFb...9GrE`). ## Step 3 β€” Read the Sale Page Public Launchpad page | Section | What it shows | | ----------------------- | -------------------------------------------------------------------------------- | | **Status badge** | Upcoming / Ready / Live / Paused / Soft Cap Reached / Successful / Failed | | **Sale Progress** | HTR raised vs Hard Cap, countdown to start (Upcoming) or end (Live) | | **Sale Details** | Token Price, Soft Cap, Hard Cap, Min Purchase, Start/End Time, participant count | | **Your Participation** | What you've already contributed, claim status | | **Participate in Sale** | Form that appears when the sale is Live | ### Status meanings * **Upcoming** β€” Not started yet. You can read the details but cannot buy. * **Ready** β€” Past the start time but not yet activated; the project admin will start it manually. * **Live** β€” Purchases open. * **Paused** β€” Project admin temporarily disabled purchases. Wait or move on. * **Soft Cap Reached** β€” Sale met its minimum goal but is still accepting purchases. * **Successful** β€” Sale ended and Soft Cap was reached. Claim your tokens. * **Failed** β€” Sale ended without reaching Soft Cap. Refund your HTR. ## Step 4 β€” Buy Tokens (Live sales) 1. In **Participate in Sale**, enter the **HTR amount** you want to spend (must be β‰₯ Min Purchase). 2. The UI shows how many tokens you'll receive at the configured rate. 3. Click **Participate in Sale**. 4. In your wallet, review the transaction details, enter your PIN, sign. 5. After confirmation, the **Your Participation** panel updates: * **Your Deposit** β€” HTR you've contributed in total * **Refundable** β€” recoverable if the sale fails * **Tokens Allocated** β€” what you'll receive at claim time * **Claim Status** β€” `Not Claimed` until you claim after a Successful finalize You can purchase multiple times during a sale; amounts accumulate. ## Step 5 β€” Claim or Refund After the Sale Ends Once the project admin **finalizes** the sale, the **Participate in Sale** form is replaced by a single action button in the Your Participation panel. The button's label and color depend on three things: | Sale state | You deposited? | Already claimed? | Button label | Style | | ----------------- | -------------- | ---------------- | ---------------- | ----------------- | | Successful | Yes | No | **Claim Tokens** | Primary (default) | | Successful | Yes | Yes | Already Claimed | Disabled | | Failed | Yes | No | **Claim Refund** | Red (destructive) | | Failed | Yes | Yes | Already Claimed | Disabled | | Any state | No | β€” | No Participation | Disabled | | Not yet finalized | β€” | β€” | Not Available | Disabled | So **the same panel handles both outcomes** β€” you don't navigate to a different page. The Sale Progress badge at the top will read **Successful** or **Failed** so you know which action you're confirming. ### How to claim or refund 1. Make sure the badge at the top shows **Successful** or **Failed** (the project has finalized the sale). 2. Click **Claim Tokens** (success) or **Claim Refund** (failure). 3. Approve the transaction in your wallet, enter your PIN. 4. After confirmation: * **Successful sale** β€” your purchased tokens land in your wallet; Claim Status switches to **Claimed**. * **Failed sale** β€” your HTR deposit returns to your wallet; Claim Status switches to **Claimed**. > The button stays active until you've claimed. It costs a small HTR transaction fee whether you're claiming tokens or a refund. If after a successful claim the token doesn't appear in your wallet, register it manually: **QR icon β†’ Manual β†’ Register Token** in Hathor wallet, then paste the token's contract address from the public token page. ## Safety Checks * **Verify the URL** β€” Always confirm you're on `testnet.tools.dozer.finance` (or the official mainnet domain). Phishing copies exist. * **Check the token contract** β€” Open the token's public page from the official project channels, not from random links. * **Read the vesting plan** β€” Public Sale tokens may have their own cliff or unlock schedule. Visible in the **Token Vesting** section of the token's public page. * **Keep some HTR aside** β€” Claiming and refunding both cost a small transaction fee. ## Troubleshooting | Symptom | Fix | | -------------------------------------- | --------------------------------------------------------------- | | Participate button disabled | Sale is not Live, or amount is below Min Purchase | | Transaction rejected | Wallet session expired β€” disconnect and reconnect | | Tokens not in wallet after claim | Refresh; if still missing, register the token manually | | Refund button missing on a Failed sale | The sale may still be processing finalization β€” wait 1-2 blocks | ## Related * [Wallet Setup](/user-guides/wallet-setup) β€” install and connect a Hathor wallet * [Claiming Vested Tokens](/user-guides/claiming-vested-tokens) β€” beneficiary-side claims (team, advisors, etc.) * [Staking Tokens](/user-guides/staking-tokens) β€” stake your newly purchased tokens for rewards # Staking Tokens This guide shows how to stake project tokens on Dozer Tools to earn a share of the project's reward pool. ## What You Need * A **Hathor wallet** with Reown / WalletConnect support * A **balance of the token** you want to stake (held in your connected wallet) * A small amount of **HTR** for transaction fees ## How Staking Works A project creator allocates a portion of their token supply as **Staking Rewards**, distributed over a fixed pool duration. Anyone holding the token can stake and receive a daily share of those rewards proportional to their stake. Each pool has: * A **minimum** and **maximum** stake amount * A **timelock period** (typically 30 days) β€” staked tokens cannot be withdrawn until it elapses * An **APY** that updates as more (or fewer) tokens stake * A **rewards reserve** that the project can top up to extend the pool's lifetime ## Step 1 β€” Open the Staking Page Three ways: * **Explore β†’ Staking** in the top nav β€” lists all active pools. * **Token page β†’ Staking card** β€” opens the pool for that token. * **Direct URL** β€” `/staking/`. Public staking page with Pool Statistics, Stake, and Unstake forms The page is a 3-column layout. ### Left column β€” Pool stats + your position * **Pool Statistics** β€” APY, Total Staked across all users, Daily Rewards distributed, Rewards Last (days remaining) * **My Position** β€” your stake, pending rewards, lock status. Empty until you stake. ### Center column β€” Stake Tokens * Amount input with **Min / Max** labels showing the per-pool limits * Available balance from your wallet * **Staking Requirements** panel summarises minimum, maximum, timelock, and auto-compounding ### Right column β€” Unstake Tokens * Amount input with a **Max** quick-fill * **Withdrawal Breakdown** β€” your staked deposits and the maximum you can withdraw right now * **Important** panel with the unstaking rules ## Step 2 β€” Stake 1. Connect your wallet. 2. In **Stake Tokens**, enter an amount (within Min/Max). 3. Click **Stake Tokens**, approve in wallet, enter PIN. After confirmation: * The **My Position** card updates with your stake. * Pending rewards start accruing daily. * Your **30-day timelock countdown** begins. ## Step 3 β€” Watch Rewards Accrue Rewards are distributed daily. Your share = `your stake / Total Staked Γ— Daily Rewards`. The My Position card shows your **pending rewards** in real-time. They are **auto-compounded** β€” every time you stake more or unstake, accrued rewards are claimed and added to / sent with your transaction. ## Step 4 β€” Unstake Once the timelock has elapsed (default 30 days from your latest stake): 1. Enter the amount in **Unstake Tokens** β€” or click **Max** for a full exit. 2. Click **Unstake Tokens**, approve in wallet. 3. Your principal **plus accrued rewards** lands in your wallet. > ⚠️ **Partial unstakes restart the timelock** on the remaining balance. To avoid resetting your timer, withdraw the full **Max** amount in one transaction. ## Best Practices * **Plan around the timelock** β€” don't stake tokens you'll need within the lock period. * **Compare APYs** β€” but factor in the project's risk, not just the rate. A 1000% APY on an inactive token isn't a deal. * **Watch the Rewards Last counter** β€” if a pool's reserve drops below 30 days, APY may collapse soon unless the project tops it up. * **Don't dust-unstake** β€” pulling 1% to "test" still resets the 30-day clock on the other 99%. ## Troubleshooting | Symptom | Fix | | ---------------------------------- | ----------------------------------------------------------------------------------------------------------- | | Staking page shows "Not Available" | You hold 0 of the token. Buy some via a [token sale](/user-guides/participating-in-token-sale) or DEX first | | Stake button disabled | Amount is below Min, above Max, or above your wallet balance | | Unstake button disabled | Timelock hasn't elapsed since your last stake | | APY is 0% | The pool has no rewards left, or no one has staked yet | | Pending rewards stuck at 0 | Wait at least one day after your first stake for the first cycle | ## Related * [Wallet Setup](/user-guides/wallet-setup) β€” install and connect a Hathor wallet * [Participating in a Token Sale](/user-guides/participating-in-token-sale) β€” get tokens to stake * [Claiming Vested Tokens](/user-guides/claiming-vested-tokens) β€” for beneficiaries with vesting allocations # Claiming Vested Tokens This guide is for **beneficiaries** β€” addresses that received a vesting allocation from a project's launch plan (team, advisors, ecosystem reserve, investor groups, etc.). For Launchpad sale claims, see [Participating in a Token Sale](/user-guides/participating-in-token-sale) instead. ## What You Need * A **Hathor wallet** connected to Dozer Tools, holding the exact address that received the allocation * A small amount of **HTR** for the claim transaction fee ## Where Vesting Lives Each project's vesting plan is published on its **public token page** at `/tokens/`, in a section called **Token Vesting**. You can reach it via: * **Explore β†’ All Tokens** β†’ click the project * A direct link the project shared with you Token Vesting section on a public token page ## Reading the Token Vesting Section Three tabs: | Tab | What it shows | | -------------------- | ------------------------------------------------------------------- | | **Allocations** | Per-beneficiary rows with claim status, next unlock, and % unlocked | | **Distribution** | Visualisation of how the total supply is split | | **Vesting Schedule** | Timeline of unlocks across the full plan | The **Allocations** tab is where you claim. Each row shows: * **Name** (e.g. Team, Advisors, Ecosystem) * **Beneficiary** (a truncated address) * **Next unlock** β€” amount and date of the next release * **Status badge** (see below) * **% Unlocked** so far * **Total** tokens in this allocation Find the row whose Beneficiary matches your connected wallet address. If you don't see your address, the project may have used a different one β€” confirm with the project team. ## Status Badges | Badge | What it means | | ------------------------- | ----------------------------------------------------------------- | | πŸ”’ **Cliff Period** | Initial lock; no tokens vested yet. Cliff end date is shown. | | ⏳ **Vesting in Progress** | Tokens unlocking linearly. Next unlock date and amount shown. | | 🟒 **Available to Claim** | One or more unlocks are ready. The Claim button is active. | | βœ… **Fully Claimed** | Everything is already withdrawn for this allocation. | | βž– **Nothing to Claim** | Vesting is active but nothing has unlocked since your last claim. | ## How to Claim When a row shows **Available to Claim**: 1. Click the row's **Claim** button. 2. Approve the transaction in your wallet, enter PIN. 3. After confirmation, the tokens appear in your wallet and the row's progress bar updates. Each beneficiary row is claimed independently. If you have multiple allocations across different projects, you claim them per project, per row. ## When Not to Claim Claiming has a small HTR fee. If you only have a tiny amount available, it may be more efficient to **wait and batch** β€” claim once a month or once a quarter rather than every time a sliver unlocks. The **Allocations** tab is safe to use as a read-only monitor between claims: * Bookmark the token page * Status badges and next-unlock dates update automatically * Use the **Vesting Schedule** tab to plan around upcoming unlocks ## Adding the Token to Your Wallet After claiming, the token might not appear automatically in your wallet's token list. **Option A β€” Add from the dapp** (when supported): * Click **Add to Wallet** in the top right of the token's public page header. **Option B β€” Manual registration:** 1. Copy the **token contract address** from the public token page header. 2. In Hathor wallet: **QR icon β†’ Manual β†’ Register Token**. 3. Paste the address and confirm. ## Troubleshooting | Symptom | Fix | | -------------------------------------- | ------------------------------------------------------------------- | | Your address not in any allocation row | Confirm with the project team which address was registered | | Claim button missing on your row | Status is Cliff, or nothing has unlocked since your last claim | | Transaction fails | Top up HTR for the fee; reconnect the wallet if the session expired | | Tokens claimed but not in wallet | Wait for the next block, then register the token manually if needed | | Wrong amount shown | Contact the project team β€” beneficiary addresses cannot be changed | ## Security * **Verify the token contract** against the project's official channels before claiming. * **Never share your seed phrase or PIN.** Dozer staff will never ask. * For **large allocations**, claim into a hardware-backed wallet and consider moving the tokens to cold storage immediately after. * **Beware look-alike pages.** Always navigate from the project's official link or `testnet.tools.dozer.finance` directly. ## Related * [Wallet Setup](/user-guides/wallet-setup) β€” install and connect a Hathor wallet * [Participating in a Token Sale](/user-guides/participating-in-token-sale) β€” claim Launchpad purchases (different flow) * [Staking Tokens](/user-guides/staking-tokens) β€” what to do with your claimed tokens # Troubleshooting This guide helps you resolve common issues you might encounter while using Dozer Finance. ## Wallet Connection Issues ### Cannot Connect Wallet 1. Check if you're on the correct Network 2. Ensure your wallet is properly updated 3. Try refreshing the page 4. Clear browser cache if needed ### Mobile Wallet Transactions 1. Keep the Hathor Wallet app active in the foreground while using Dozer Finance 2. Don't switch to other apps or lock your screen 3. Make sure your wallet app is running and visible to receive transaction prompts 4. If you miss a prompt, go back to the wallet app and check Recent Sessions ### Wallet Disconnects 1. Check your internet connection 2. Ensure wallet app is running 3. Try reconnecting manually 4. Check for wallet app updates ## Transaction Issues ### Transaction Pending 1. Verify wallet connection 2. Check network status 3. Ensure sufficient balance 4. Try refreshing the page ### Transaction Failed Transactions can fail for several reasons, including insufficient balance, network congestion, low slippage tolerance, high price impact, or an inactive wallet app on mobile devices. To resolve transaction failures, follow these steps: 1. Check your token balance 2. Adjust slippage tolerance 3. Review transaction amount 4. Try smaller amounts 5. Keep wallet app in foreground on mobile ## Pool Management Issues ### Cannot Add Liquidity When encountering issues adding liquidity to pools, follow these troubleshooting steps: 1. Verify you have sufficient amounts of both tokens 2. Ensure tokens are properly registered in your wallet 3. Check that pool ratios align with your deposit amounts 4. Confirm you have approved token spending ### Liquidity Removal Problems If you're having trouble removing liquidity: 1. Confirm you have the required LP tokens 2. Verify the network status is stable 3. Check that withdrawal amounts meet minimum requirements 4. Ensure your wallet is properly connected and authorized ## Price Impact and Slippage ### High Price Impact When experiencing high price impact: 1. Reduce your transaction amount 2. Split large trades into smaller ones 3. Check pool liquidity depth 4. Consider using a different trading pair ### Slippage Issues To resolve slippage-related problems: 1. Adjust your slippage tolerance settings 2. Try trading smaller amounts 3. Monitor market volatility 4. Wait for more stable market conditions ## Technical Problems ### Interface Not Loading If the interface isn't loading properly: 1. Clear your browser cache 2. Disable browser extensions 3. Try a different supported browser 4. Check your internet connection ### Data Not Updating When experiencing data update issues: 1. Refresh the page 2. Check your internet connection 3. Clear local storage 4. Ensure your wallet is properly connected ## Recovery Steps ### Lost Transaction If you've lost track of a transaction: 1. Check your wallet's transaction history 2. Review the block explorer 3. Verify token balances 4. Contact support if needed ### Account Recovery For account-related issues: 1. Ensure you have your seed phrase accessible 2. Verify you're using the correct network 3. Try removing and re-adding your wallet connection 4. Check for any pending approvals ## Getting Additional Help ### Community Support Get help from our community through our various support channels: Discord: [Join our server](https://discord.gg/KRhaCp6P) Telegram: [Join our group](https://t.me/DozerFinance) Email: ### Reporting Issues When reporting issues, please provide: 1. A detailed description of the problem 2. Steps to reproduce the issue 3. Any error messages received 4. Your wallet address (if relevant) 5. Screenshots if applicable ### Documentation Find additional troubleshooting resources in our: * [Documentation Portal](https://docs.dozer.finance) * [GitHub Repository](https://github.com/dozerfinance) * [FAQ Section](/getting-started/faq) # Oasis Overview Project Oasis is Hathor Network's flagship liquidity incentive program. It is designed to bootstrap deep and sustainable liquidity while protecting liquidity providers from common DeFi risks. The program introduces innovative features that make providing liquidity more attractive and secure than traditional DeFi approaches. ### Key Benefits #### πŸ’§ Equal $HTR Matching Oasis matches one dollar worth of HTR from its reserve pool for every dollar worth of tokens you provide. This instantly doubles the pool liquidity, enhancing the service provided and potentially generating more volume and earnings. When you provide liquidity to Oasis, you deposit your chosen token (hUSDC), and Oasis automatically matches your deposit with an equal-value HTR. Both tokens are added to the respective liquidity pool, creating your position with the combined liquidity. For example, if you deposit 1000 hUSDC, Oasis will add HTR of equivalent value, effectively doubling your liquidity position. #### 🎁 Instant Bonus Rewards Receive immediate **HTR** bonuses based on your chosen lock period: | Lock Period | Bonus | Strategy | | ----------- | ---------------- | ---------------------------- | | 6 months | 10% bonus in HTR | Shorter term, lower reward | | 9 months | 15% bonus in HTR | Medium term, balanced reward | | 12 months | 20% bonus in HTR | Longest term, highest reward | These bonuses are calculated based on your deposit value and paid immediately in HTR tokens. They're available for withdrawal right after deposit and remain independent of your locked position. #### πŸ›‘οΈ Value Protection Your deposit is protected against impermanent loss through sophisticated protection mechanics. **Impermanent Loss Protection** Oasis offers complete protection up to 4x price divergence between tokens. The protection is calculated at withdrawal, and compensation is paid in HTR tokens. You also receive additional protection through accumulated trading fees. **Price Divergence Examples** For hUSDC/HTR pools, if the HTR price increases, you will experience no impermanent loss and keep your entire deposit value. If the HTR price decreases, you're protected up to a 4x price decline. ### Supported Assets Oasis initially supports hUSDC (Hathor-wrapped Circle USD - Arbitrum), with more to come! Each pool pairs the deposited token with HTR, creating deep liquidity for essential trading pairs on the Hathor Network. ### Earning Mechanisms #### Trading Fees You earn fees from trades in your pool throughout the lock period. These fees accumulate during your lock period and are collected when you withdraw your liquidity. #### Bonus Token Strategies You can choose between two strategies for your HTR bonus: **Strategy 1: Hold Bonus** Keep your HTR bonus until the lock period ends and benefit from potential HTR price appreciation. You remain protected against impermanent loss and earn trading fees throughout the lock period. The bonus does not impact your protected deposit and can be withdrawn later. **Strategy 2: Sell Bonus Immediately** Claim and sell your bonus right after the deposit to lock in immediate profits. You'll continue earning trading fees and maintaining complete impermanent loss protection without impacting your protected deposit. Our built-in simulation tool helps you visualize potential returns under different market conditions. ### Program Capacity The Oasis program has a fixed capacity for each pool. The available reserve is displayed in the Dozer interface, and new deposits are paused when the reserve is depleted. ### Time-based Operations #### Deposit Phase When you deposit, you'll receive an immediate HTR bonus, your position will be locked for your chosen period, and you'll start earning trading fees immediately. #### During Lock Period During the lock period, you can monitor your position value and collect trading fees. You can withdraw your HTR bonus, but your position remains locked. #### After Lock Period After the lock period ends, you can withdraw your original deposit, collect all accumulated fees, receive any impermanent loss protection, and fully close your position. ### Position Management Your Oasis position includes your original token deposit (locked), matched HTR amount (locked), HTR bonus (available immediately), accumulated trading fees, and any IL protection that may apply. You can monitor these values through the Oasis interface to track your position's performance over time. ### Getting Started To start earning with Oasis: 1. Visit [dozer](https://dozer.finance/pool/oasis) 2. Connect your wallet 3. Choose your preferred token and lock period 4. Deposit and start earning immediately ### Next Steps * Ready to start? Follow our [Step-by-Step Guide](/yield-farm-oasis/liquidity-guide) * Understand protection details in[ Protection Mechanics](/yield-farm-oasis/protection-mechanics) # Liquidity Guide This comprehensive guide walks you through the complete lifecycle of providing liquidity on Oasis - from initial setup to final withdrawal. Follow these steps to start earning rewards, understand your position, and manage your tokens effectively. ### Prerequisites Before you begin, ensure you have: * **Hathor Mobile Wallet**. [Learn how to set up a wallet](https://docs.hathor.network/tutorials/how-to-create-a-wallet) * **hUSDC tokens** in your wallet. [Learn how to use the Bridge](https://docs.hathor.network/tutorials/how-to-use-the-bridge) * Enough **HTR** for transaction fees ### Providing Liquidity #### Step 1: Access Oasis 1. Visit [Dozer](https://dozer.finance/pool/oasis) 2. Click the "Connect" button in the top right corner 3. Read the QR Code or paste the string in the Reown option of the Hathor Wallet 4. Accept the connection with Dozer Finance #### Step 2: Choose Your Deposit **Select Token** * Click the token selector dropdown (default is hUSDC) **Enter Amount** 1. In the "Amount to lock up" field, enter your desired deposit amount 2. The interface will show: * Amount to be deposited * HTR to be matched * HTR bonus you'll receive **Choose Lock Period** 1. Click the "Lock up time" dropdown 2. Select your preferred duration: * 6 months (10% bonus) * 9 months (15% bonus) * 12 months (20% bonus) > πŸ’‘ **Tip**: Longer lock periods offer higher bonus rewards. Consider your investment timeline when choosing. #### Step 3: Review Position Details Before confirming, verify: 1. Token and amount 2. Lock period and bonus percentage 3. HTR matching amount 4. Unlock date If providing non-stable tokens, you can also: 1. Use the price change slider to simulate different scenarios 2. Click "Simulate Gains" to view potential returns 3. Compare "Hold Bonus" vs "Sell Immediately" strategies #### Step 4: Add Liquidity 1. Click the "Add Liquidity" button 2. Review the transaction in your wallet 3. Confirm the transaction 4. Wait for confirmation > ⚠️ **Note**: Ensure you understand the lock period. Your deposited tokens will be locked until the unlock date shown. ### Understanding Your Position After providing liquidity, you can view and understand your position details: #### Accessing Your Positions 1. Visit [oasis.dozer.finance](https://oasis.dozer.finance/) 2. Connect your wallet 3. Click the "My Position" tab #### Core Position Information Your position display includes several key metrics: * **Locked Amount**: The original amount of tokens you deposited * **Unlock Date**: The exact date and time when your position becomes available for withdrawal * **Max withdraw USDC**: Maximum amount of deposited token you can withdraw * **Max withdraw HTR**: Maximum HTR amount, including matching and protection * **HTR Bonus available**: HTR bonus tokens available for immediate withdrawal #### Position Status Your position will display its status: * **Locked**: Position is still within the lock period * **Available for withdrawal**: Position has reached maturity and can be withdrawn #### Simulation Tool To understand potential returns: 1. Click "Simulate Gains" 2. Adjust the token price slider 3. View the chart showing: * Yellow line: Returns if holding bonus * Green line: Returns if selling bonus immediately ### Managing Your Position #### Increasing Your Position You can increase an existing position by adding more tokens: 1. Navigate to the "Deposit Now" tab 2. Enter the additional deposit amount on the "Amount to lock up" input field 3. Choose a lock period for the new deposit 4. Review the new unlock date calculation 5. Confirm transaction **Understanding Unlock Date Calculation** When you add to a position, the new unlock date is calculated using a weighted average: * The original amount and unlock date * The new amount and selected lock period * Weights based on deposit amounts For example: * Current position: 1000 hUSDC unlocking in 3 months * New deposit: 500 hUSDC with a 6-month lock * The new unlock date will be weighted: * (1000 Γ— 3 months + 500 Γ— 6 months) Γ· (1000 + 500) * Resulting in approximately 4 months to unlock **Benefits of Increasing Position** * Keep positions consolidated * Single withdrawal at maturity * Combined IL protection * Unified bonus management > πŸ’‘ **Tip**: Consider aligning lock periods with your existing position to maintain your preferred timeline. #### Managing HTR Bonus Your HTR bonus is separate from your locked position and offers flexible management options. **Immediate Withdrawal Strategy** If you choose to withdraw your bonus immediately: 1. Navigate to "My Position" 2. Locate your active position 3. Click "Remove Liquidity" or "Withdraw Bonus" 4. Choose the amount of HTR bonus to withdraw 5. Confirm the transaction in your wallet **Hold Strategy** If you choose to hold your bonus: * The bonus remains in your position * Can be withdrawn later with your main position * May benefit from HTR price appreciation * There is no impact on your position's IL protection ### Position Lifecycle #### During Lock Period While your position is locked: * The main deposit remains locked until the unlock date * HTR bonus can be withdrawn at any time * Position accumulates trading fees * IL protection remains active #### At Maturity When your position reaches its unlock date: * Status changes to "Available for withdrawal" * The whole position (deposit + remaining bonus) can be withdrawn * IL protection is automatically calculated * Trading fees are included in the withdrawal ### Withdrawing Your Position #### Full Position Withdrawal Once unlocked: 1. Navigate to "My Position" 2. Click "Close Position" then "Remove Liquidity" 3. Review withdrawal amounts 4. Confirm the transaction #### Withdrawal Calculations Your withdrawal amount includes: * Original deposit (adjusted for IL protection if needed) * HTR amount from the IL protection (if needed) * Accumulated trading fees * Any remaining HTR bonus > πŸ’‘ **Tip**: The "Max withdraw" amounts shown include all IL protection calculations. ### Monitoring Tools #### Position Performance Track your position's status: * The current value of locked tokens * Available HTR bonus * Time remaining until unlock * Accumulated trading fees #### Market Impact * Use the price change slider to simulate market movements * View potential returns under different scenarios * Understand IL protection impact ### Common Scenarios #### HTR Price Increases * The original deposit remains protected * HTR bonus value may increase * No impermanent loss impact #### HTR Price Decreases * Original deposit protected up to 4x price divergence * Protection paid in HTR #### Token Price Changes * IL protection considers both token prices * The protection ensures value preservation within limits * Withdrawal amounts are updated in real-time ### Next Steps * Understand protection calculations in [Protection Mechanics](https://docs.dozer.finance/protection-mechanics) * Review technical implementation in [Technical Details](https://docs.dozer.finance/technical-details) # Protection Mechanics Oasis introduces sophisticated protection mechanisms to safeguard liquidity providers against common DeFi risks. This guide explains how these protections work and how they benefit your position. ### About Oasis Protection Incentives The impermanent loss protection offered by Oasis is not magical - Hathor Labs fund it as part of their strategic initiative to grow the Hathor ecosystem. This protection mechanism represents a deliberate investment by Hathor Labs to incentivize liquidity growth and build trust in the ecosystem. By providing this security to liquidity providers, Hathor aims to foster the development of more DeFi services and increase the utility of the HTR token across the network. This approach allows early liquidity providers to participate with reduced risk while the network builds sustainable trading volume and depth. ### Understanding Impermanent Loss Protection #### What is Impermanent Loss? Impermanent Loss (IL) occurs in liquidity pools when the relative price of paired tokens changes. In traditional liquidity pools, this can result in having less value than if you had held your tokens. #### How Oasis Protects You Oasis provides comprehensive protection against impermanent loss through full protection up to 4x price divergence, with protection payments made in HTR tokens. The protection is automatically calculated at withdrawal, and users do not need to take any action. #### Protection Coverage For price divergence up to 4x, 100% of impermanent loss is covered with protection paid in HTR tokens. There is no reduction in deposit value, and the calculation happens automatically when you withdraw. ### How Protection Works #### For hUSDC Pools **When HTR Price Increases** Your original hUSDC deposit remains fully protected. No impermanent loss occurs, so you keep your full deposit value and benefit from any HTR bonus appreciation. **When the HTR Price Decreases** For decreases up to 4x, your hUSDC value is fully protected, and compensation is paid in HTR. #### Protection Scenarios **When both prices move:** Protection is based on the relative change, with the 4x limit applied to the price ratio. Complete protection is maintained within this range. **When prices move differently:** The protection adjusts automatically and considers the net value impact to maintain fair protection. Trading fees supplement this protection. #### Position Closing Implementation Oasis uses a two-step position closing process to protect users from slippage: 1. **Close Position**: Removes liquidity from the pool and calculates final token amounts 2. **Withdraw Funds**: Transfers previously calculated and stored token amounts to the user This approach ensures you receive exactly the token amounts calculated at position closing, regardless of any transactions between closing and withdrawing. ### Protection in Practice #### Monitoring Protection The interface shows your position value, potential withdrawal amounts, protection status, and available HTR compensation. #### Protection Calculation Example For a 1000 hUSDC deposit: 1. HTR decreases by 50%: * Full protection applies * Receive additional HTR to maintain value * Original hUSDC value preserved 2. HTR decreases by 75%: * Still within 4x protection range * Full compensation in HTR * Value maintained at 1000 hUSDC ### Understanding the Simulation Tool #### Using the Tool Click "Simulate Gains" and adjust the price change sliders for the token price to view its impact on returns. You can observe two scenarios: hold bonus (yellow line) and Sell Bonus (green line). #### Reading the Chart The x-axis shows the HTR price change percentage, while the y-axis shows the return percentage. The yellow line represents the total return when holding the bonus, and the green line shows the return when selling the bonus immediately. The protection impact is visible in negative price zones. πŸ’‘ **Tip**: Use the simulation tool to understand how protection works under different market conditions. ### Protection and Bonus Interaction #### Independent Systems Protection applies to the position, while bonus tokens are managed separately. Your protection remains unaffected by your bonus strategy, allowing you to choose your bonus strategy independently. #### Strategy Considerations **Hold Bonus Strategy:** With this strategy, your position remains protected while your bonus is exposed to HTR price, offering potential upside capture with no impact on protection. **Sell Bonus Strategy:** This approach lets you lock in immediate value while protecting your position. You'll have reduced market exposure, but your protection remains unchanged. ### Common Questions #### When does protection apply? Protection is active throughout the lock period and calculated at withdrawal. The application is automatic and requires no user action. #### How is protection paid? Protection is always paid in HTR tokens, calculated automatically, and included in the withdrawal amount. The Dozer interface displays this. #### Does protection expire? Protection remains active until your position is withdrawn with no expiration date. You must withdraw to claim protection, which will be preserved even if you delay your withdrawal. #### How do I withdraw my funds? To withdraw your funds: 1. Wait for your position to unlock (based on the time lock) 2. Call the `close_position` function to define your withdrawal amounts 3. Call the `user_withdraw` function to receive your tokens ### Next Steps * Review technical implementation in [Technical Details](/yield-farm-oasis/technical-details) * Learn about position management in [Position Management](/yield-farm-oasis/old-position-management) # Technical Details This section provides a deeper technical understanding of how Oasis works. While not necessary for using the platform, these details offer insights into the mathematical foundations and mechanisms that ensure the protocol's security and efficiency. ### Core Mathematical Framework #### Position Value Calculations When you provide liquidity, several key values are calculated: **Initial Position Setup** For a deposit amount `D_token`: ``` HTR_matched = D_token / P_htr_i ``` Where: * `D_token`: Initial token deposit amount * `P_htr_i`: Initial HTR price * `HTR_matched`: Amount of HTR matched by Oasis **Bonus Calculation** ``` HTR_bonus = (D_token Γ— Bonus_rate) / P_htr_i ``` Where: * `Bonus_rate`: Set by lock duration (10%, 15%, or 20%) * `HTR_bonus`: Amount of bonus HTR tokens received ### Protection Mathematics #### Value Preservation Model The protocol maintains constant product AMM mathematics: ``` x Γ— y = K ``` Where: * x: Token amount in pool * y: HTR amount in pool * K: Constant product #### Price Ratio Calculations ``` R = P_htr_f / P_token_f ``` Where: * `P_htr_f`: Final HTR price * `P_token_f`: Final token price * `R`: Price ratio #### Protection Calculations **Value Deficit Calculation** ``` Token_deficit = max(0, D_token - x_f) ``` Where: * `x_f`: Final token balance * `Token_deficit`: Amount requiring protection **Protection Payment** When protection applies: ``` HTR_protection = Token_deficit / P_htr_f ``` ### Liquidity Pool Mechanics #### Pool Balance Adjustments For any new price ratio R, new pool balances are calculated as: ``` y/x = R x Γ— y = K ``` Therefore: ``` x = sqrt(K/R) y = x Γ— R ``` #### Pool Value Protection Protection ensures that for any price movement within 4x: ``` withdrawal_value β‰₯ initial_deposit_value ``` Where withdrawal\_value includes: * Original token amount (or equivalent) * Protection compensation in HTR * Accumulated trading fees ### Return Calculations #### Total Position Value For positions with held bonus: ``` V_total_hold = LP_value + (B_htr Γ— P_htr_f) ``` For positions with sold bonus: ``` V_total_sell = LP_value + (B_htr Γ— P_htr_i) ``` Where: * `LP_value`: Liquidity position value * `B_htr`: Bonus HTR amount * `P_htr_f`: Final HTR price * `P_htr_i`: Initial HTR price #### Return Metrics Percentage return calculation: ``` Return_% = ((V_total / D_token) - 1) Γ— 100 ``` ### Risk Management #### Protection Boundaries Full Protection Range: * Up to 4x price divergence * Complete value preservation * Automatic calculation #### Reserve Management The protocol maintains: * HTR reserve for each pool * Automated matching system * Protection reserve allocation * Dynamic capacity management (new HTR deposits can be made to increase the reserve available) ### Market Simulation Model #### Return Scenario Calculations The simulation tool models returns using: 1. Price movement inputs: * HTR price change * Token price change (for hBTC) 2. Strategy comparisons: * Hold bonus path * Immediate sell path * Protection impacts * Fee accumulation ### Performance Characteristics #### Operational Parameters 1. Transaction Processing: * Instant matching * Automatic protection * Real-time calculations 2. Value Tracking: * Continuous monitoring * Price feed integration * Protection threshold checks ### Additional Resources * [Oasis RFC](https://github.com/Dozer-Protocol/hathor-rfcs/blob/oasis/text/oasis.md) * [Oasis Blueprint](https://github.com/hBulldozer/dozer/blob/oasis/contracts/oasis.py) # old Providing Liquidity ## Providing Liquidity on Oasis This guide walks you through the process of providing liquidity on Oasis, from connecting your wallet to completing your deposit. Follow these steps to start earning rewards and benefits from the Oasis program. ### Prerequisites Before you begin, ensure you have: * Hathor Mobile Wallet. [Learn how to set up a wallet](/user-guides/wallet-setup) * hUSDC tokens in your wallet. [Learn how to use the Bridge](https://www.youtube.com/watch?v=_YnRp5qUBxs) * Enough HTR for transaction fees ### Step 1: Access Oasis 1. Visit [oasis.dozer.finance](https://oasis.dozer.finance/pool/oasis) 2. Click the "Connect" button in the top right corner 3. Read the QR Code or paste the string in the Reown option of the Hathor Wallet 4. Accept the connection with Dozer Finance ### Step 2: Choose Your Deposit #### Select Token Click the token selector dropdown (default is hUSDC) #### Enter Amount 1. In the "Amount to lock up" field, enter your desired deposit amount 2. The interface will show: * Amount to be deposited * HTR to be matched * HTR bonus you'll receive #### Choose Lock Period 1. Click the "Lock up time" dropdown 2. Select your preferred duration: * 6 months (10% bonus) * 9 months (15% bonus) * 12 months (20% bonus) > πŸ’‘ **Tip**: Longer lock periods offer higher bonus rewards. Consider your investment timeline when choosing. ### Step 3: Review Position Details Before confirming, verify: 1. Token and amount 2. Lock period and bonus percentage 3. HTR matching amount 4. Unlock date If providing not stable tokens, you can also: 1. Use the price change slider to simulate different scenarios 2. Click "Simulate Gains" to view potential returns 3. Compare "Hold Bonus" vs "Sell Immediately" strategies ### Step 4: Add Liquidity 1. Click the "Add Liquidity" button 2. Review the transaction in your wallet 3. Confirm the transaction 4. Wait for confirmation > ⚠️ **Note**: Ensure you understand the lock period. Your deposited tokens will be locked until the unlock date shown. ### Step 5: Manage Your Position After the deposit, you can: 1. Click the "My Position" tab to view your active positions 2. See details including: * Locked Amount * Unlock Date * Max withdrawal amounts * HTR Bonus available * Position metrics #### Withdraw HTR Bonus You can withdraw your HTR bonus: 1. Immediately after deposit 2. At any time during the lock period 3. Together with your position at unlock To withdraw: 1. Go to "My Position" 2. Click "Withdraw Bonus" for locked positions 3. Click "Close Position" for unlocked positions 4. Click "Remove Liquidity" for unlocked positions 5. Choose the amount to withdraw 6. Confirm the transaction ### Understanding Position Status Your position will show: * **Locked Amount**: Your initial deposit * **Unlock Date**: When you can withdraw your position * **Max withdraw amounts**: Available tokens considering IL protection * **HTR Bonus available**: Bonus HTR available for withdrawal ### Simulation Tool To understand potential returns: 1. Click "Simulate Gains." 2. Adjust the token price slider 3. View the chart showing: * Yellow line: Returns if holding bonus * Green line: Returns if selling bonus immediately ### Next Steps * Learn about managing your position in [Position Management](/yield-farm-oasis/old-position-management) * Understand protection mechanics in [Protection Mechanics](/yield-farm-oasis/protection-mechanics) * Review technical details in [Technical Details](/yield-farm-oasis/technical-details) # old Position Management Once you've provided liquidity to Oasis, you'll want to monitor and manage your position effectively. This guide explains how to track your position's performance, manage your HTR bonus, and handle withdrawals. ### Viewing Your Positions #### Access Your Positions 1. Visit [oasis.dozer.finance](https://oasis.dozer.finance/pool/oasis) 2. Connect your wallet 3. Click the "My Position" tab #### Understanding Position Details Your position display includes several key metrics: **Core Position Information** * **Locked Amount**: The original amount of tokens you deposited * **Unlock Date**: The exact date and time when your position becomes available for withdrawal * **Max withdraw USDC**: Maximum amount of deposited token you can withdraw * **Max withdraw HTR**: Maximum HTR amount, including matching and protection * **HTR Bonus available**: HTR bonus tokens available for immediate withdrawal ### Increasing Your Position You can increase an existing position by adding more tokens. When you do this, the unlock date is recalculated based on the amounts and lock periods. #### How to Increase Position 1. Navigate to the "Deposit Now" tab 2. Enter the additional deposit amount on the "Amount to lock up" input field 3. Choose a lock period for the new deposit 4. Review the new unlock date calculation 5. Confirm transaction #### Understanding Unlock Date Calculation When you add to a position, the new unlock date is calculated using a weighted average: * The original amount and unlock date * The new amount and selected lock period * Weights based on deposit amounts For example: * Current position: 1000 hUSDC unlocking in 3 months * New deposit: 500 hUSDC with a 6-month lock * The New unlock date will be weighted: * (1000 Γ— 3 months + 500 Γ— 6 months) Γ· (1000 + 500) * Resulting in approximately 4 months to unlock #### Benefits * Keep positions consolidated * Single withdrawal at maturity * Combined IL protection * Unified bonus management > πŸ’‘ **Tip**: Consider aligning lock periods with your existing position to maintain your preferred timeline. ### Managing HTR Bonus Your HTR bonus is separate from your locked position and offers flexible management options. #### Immediate Withdrawal Strategy If you choose to withdraw your bonus immediately: 1. Navigate to "My Position" 2. Locate your active position 3. Click "Remove Liquidity" 4. Choose the amount of HTR bonus to withdraw 5. Confirm the transaction in your wallet #### Hold Strategy If you choose to hold your bonus: * The bonus remains in your position * Can be withdrawn later with your main position * May benefit from HTR price appreciation * There is no impact on your position's IL protection ### Position Lifecycle #### During Lock Period While your position is locked: * The main deposit remains locked until the unlock date * HTR bonus can be withdrawn at any time * Position accumulates trading fees * IL protection remains active #### At Maturity When your position reaches its unlock date: 1. Status changes to "Available for withdrawal" 2. The whole position (deposit + remaining bonus) can be withdrawn 3. IL protection is automatically calculated 4. Trading fees are included in the withdrawal ### Withdrawing Your Position #### Full Position Withdrawal Once unlocked: 1. Navigate to "My Position" 2. Click "Remove Liquidity" 3. Review withdrawal amounts: 4. Confirm the transaction #### Withdrawal Calculations Your withdrawal amount includes: * Original deposit (adjusted for IL protection if needed) * HTR amount from the IL protection (if needed) * Accumulated trading fees * Any remaining HTR bonus > πŸ’‘ **Tip**: The "Max withdraw" amounts shown include all IL protection calculations, so you don't need to calculate these manually. ### Monitoring Tools #### Position Performance Track your position's status: * The current value of locked tokens * Available HTR bonus * Time remaining until unlock * Accumulated trading fees #### Market Impact * Use the price change slider to simulate market movements * View potential returns under different scenarios * Understand IL protection impact ### Common Scenarios #### HTR Price Increases * The original deposit remains protected * HTR bonus value may increase * No impermanent loss impact #### HTR Price Decreases * Original deposit protected up to 4x price divergence * Protection paid in HTR #### Token Price Changes * IL protection considers both token prices * The protection ensures value preservation within limits * Withdrawal amounts are updated in real-time ### Next Steps * Understand protection calculations in [Protection Mechanics](/yield-farm-oasis/protection-mechanics) * Review technical implementation in [Technical Details](/yield-farm-oasis/technical-details) # Dozer API Documentation This section documents the public View methods of the Dozer Pool Manager contract, allowing you to build frontends, analytics tools, or arbitrage bots directly on the Hathor Node API. ### Core Guides 1. **Price Fetching**\ How to fetch the USD price of HTR and other tokens. 2. **Pool Information**\ Fetch global pool stats, reserves, volumes, and list all active pools. 3. **User Data**\ Get personalized data including liquidity positions, share percentages, and PnL. 4. **Quotes & Swaps**\ Calculate trade execution: find the best swap path, estimate output amounts, and check price impact. ### Usage All examples use `curl` and the public Hathor Mainnet Node: `https://node1.mainnet.hathor.network/v1a/nano_contract/state` **Contract ID (Mainnet)**: `000080350ca5ef204bc29b3232bb197e12bec6b473f5e6bdb749a6921197e83c` # Token Prices This guide explains how to fetch the USD price of any token from the Dozer Pool Manager using the public Hathor mainnet node. ### Contract IDs * **Mainnet**: `000080350ca5ef204bc29b3232bb197e12bec6b473f5e6bdb749a6921197e83c` * **Testnet**: `00000eecf6a990576c12bfa9e12ee089a5b1ea65e6de1456687ba1f4dc7fd463` ### 1. Fetching HTR Price (Example) Fetching the price of HTR (Token UID `00`) using the **Mainnet** contract ID. > **Note**: The argument `"00"` must be in double quotes because the Node API parses arguments as JSON. ```bash curl -s -G "https://node1.mainnet.hathor.network/v1a/nano_contract/state" \ --data-urlencode "id=000080350ca5ef204bc29b3232bb197e12bec6b473f5e6bdb749a6921197e83c" \ --data-urlencode 'calls[]=get_token_price_in_usd("00")' \ | jq '.calls["get_token_price_in_usd(\"00\")"].value / 100000000' ``` ### 2. Fetching Other Token Prices You can fetch the price of **any token** by replacing `"00"` with the token's UID (hex string). #### Command Template Replace `TOKEN_UID` with the actual token ID (e.g., `00000000...`). ```bash # Define the Token UID you want to check TOKEN_UID="YOUR_TOKEN_UID_HERE" curl -s -G "https://node1.mainnet.hathor.network/v1a/nano_contract/state" \ --data-urlencode "id=000080350ca5ef204bc29b3232bb197e12bec6b473f5e6bdb749a6921197e83c" \ --data-urlencode "calls[]=get_token_price_in_usd(\"$TOKEN_UID\")" \ | jq --arg uid "$TOKEN_UID" '.calls["get_token_price_in_usd(\"" + $uid + "\")"].value / 100000000' ``` #### Example: Fetching specific Token Value If you wanted to fetch the price for a token with UID `00002b66...`: ```bash curl -s -G "https://node1.mainnet.hathor.network/v1a/nano_contract/state" \ --data-urlencode "id=000080350ca5ef204bc29b3232bb197e12bec6b473f5e6bdb749a6921197e83c" \ --data-urlencode 'calls[]=get_token_price_in_usd("00002b66...")' \ | jq '.calls["get_token_price_in_usd(\"00002b66...\")"].value / 100000000' ``` # Quotes & Swaps ## This guide explains how to get exact swap quotes and find the best trading paths (multi-hop) using the Dozer Pool Manager. ### Contract IDs * **Mainnet**: `000080350ca5ef204bc29b3232bb197e12bec6b473f5e6bdb749a6921197e83c` * **Testnet**: `00000eecf6a990576c12bfa9e12ee089a5b1ea65e6de1456687ba1f4dc7fd463` *** ### 1. Best Swap Path (Quote) Calculate the optimal swap path and expected output amount for a given input. This method checks direct pools and multi-hop paths to find the best price. **Method**: `find_best_swap_path(amount_in, token_in, token_out, max_hops)`\ **Args**: * `amount_in` (Integer): The input amount (remember to include decimals). * `token_in` (Hex String): UID of the token being sold. * `token_out` (Hex String): UID of the token being bought. * `max_hops` (Integer): Maximum trading pairs to route through (e.g., 2 or 3). #### Example Request Get a quote for swapping **100 HTR** (`00`) to **hUSDC**. * `amount_in` = 100 \* 10^0 = 100 (HTR is 2 decimals? No, native HTR is handled as integer cents usually? Actually contract uses 8 decimals for pricing but reserves are native. Let's assume input is 100 units). * *Wait, HTR decimals on Hathor are 2, but the contract might use raw integer values. Always check token decimals.* ```bash # Example: Swap 1000 HTR (10.00) for hUSDC AMOUNT_IN=1000 TOKEN_IN="00" TOKEN_OUT="00008035..." # hUSDC UID MAX_HOPS=2 curl -s -G "https://node1.mainnet.hathor.network/v1a/nano_contract/state" \ --data-urlencode "id=000080350ca5ef204bc29b3232bb197e12bec6b473f5e6bdb749a6921197e83c" \ --data-urlencode "calls[]=find_best_swap_path($AMOUNT_IN, \"$TOKEN_IN\", \"$TOKEN_OUT\", $MAX_HOPS)" \ | jq ``` #### Response Structure Returns a `SwapPathInfo` object. ```json { "return": [ "00/UID.../80", // path (string of pool keys joined by +?) [100, 200], // amounts (List of amounts for each hop) 95000, // amount_out (The final output amount) 50 // price_impact (Basis points, 50 = 0.5%) ] } ``` *** ### 2. Simple Quote (No Fees) Get a simple `k = x * y` quote for a single pair without considering fees or liquidity depths. Useful for quick estimations but **not** for actual execution. **Method**: `quote(amount_a, reserve_a, reserve_b)`\ **Args**: Inputs for the constant product formula. **Note**: You must fetch reserves first using `get_reserves` to use this method effectively. We recommend using `find_best_swap_path` instead for accuracy. # Pool Information This guide explains how to fetch pool data from the Dozer Pool Manager using the public Hathor Node API. ### Contract IDs * **Mainnet**: `000080350ca5ef204bc29b3232bb197e12bec6b473f5e6bdb749a6921197e83c` * **Testnet**: `00000eecf6a990576c12bfa9e12ee089a5b1ea65e6de1456687ba1f4dc7fd463` *** ### 1. List All Pools Get a list of all active pool keys in the contract. **Method**: `get_all_pools()`\ **Returns**: List of strings (Pool Keys)\ **Pool Key Format**: `TOKEN_A_UID/TOKEN_B_UID/FEE_INT` #### Example Request ```bash curl -s -G "https://node1.mainnet.hathor.network/v1a/nano_contract/state" \ --data-urlencode "id=000080350ca5ef204bc29b3232bb197e12bec6b473f5e6bdb749a6921197e83c" \ --data-urlencode "calls[]=get_all_pools()" \ | jq ``` #### Response ```json { "success": true, "calls": { "get_all_pools()": { "return": [ "00000000.../00002b66.../50", "00000000.../0000abcd.../30" ] } } } ``` *** ### 2. Get Pool Details Get detailed statistics and state for a specific pool. **Method**: `front_end_api_pool(pool_key)`\ **Args**: `pool_key` (string) - The unique identifier from `get_all_pools()` #### Example Request Fetch details for a specific pool (replace `POOL_KEY` with actual key). ```bash # Example Pool Key: HTR (00) / hUSDC (...) / 80 fee (0.8%) POOL_KEY="00/00008035.../80" curl -s -G "https://node1.mainnet.hathor.network/v1a/nano_contract/state" \ --data-urlencode "id=000080350ca5ef204bc29b3232bb197e12bec6b473f5e6bdb749a6921197e83c" \ --data-urlencode "calls[]=front_end_api_pool(\"$POOL_KEY\")" \ | jq ``` #### Response Structure The response returns a `PoolApiInfo` object. ```json { "return": [ 200000, // reserve0 (Amount) 500000, // reserve1 (Amount) 80, // fee (Amount, basis points) 10000, // volume (Amount) 50, // fee0 (Accumulated Token 0 Fees) 120, // fee1 (Accumulated Token 1 Fees) 1000, // dzr_rewards (Amount) 25, // transactions (Count) 1, // is_signed (1 = true, 0 = false) "Habc..." // signer (Address hex or null) ] } ``` **Note**: All Amounts are integers. You typically need to apply token decimals (usually 2 or 8) to get human-readable values. # User Data This guide explains how to fetch detailed user position data, including liquidity shares and profit/loss metrics. ### Contract IDs * **Mainnet**: `000080350ca5ef204bc29b3232bb197e12bec6b473f5e6bdb749a6921197e83c` * **Testnet**: `00000eecf6a990576c12bfa9e12ee089a5b1ea65e6de1456687ba1f4dc7fd463` *** ### 1. Get All User Positions Fetch all liquidity positions for a specific user address across all pools. **Method**: `get_user_positions(address)`\ **Args**: `address` (string) - The user's wallet address (or Caller ID). #### Example Request ```bash USER_ADDRESS="H..." # Replace with actual address curl -s -G "https://node1.mainnet.hathor.network/v1a/nano_contract/state" \ --data-urlencode "id=000080350ca5ef204bc29b3232bb197e12bec6b473f5e6bdb749a6921197e83c" \ --data-urlencode "calls[]=get_user_positions(\"$USER_ADDRESS\")" \ | jq ``` #### Response Structure Returns a dictionary where keys are Pool Keys and values are `UserPosition` objects. ```json { "return": { "POOL_KEY_STRING": [ 1000, // liquidity (Amount) 500, // token0Amount (Amount) 500, // token1Amount (Amount) 1000, // share (Amount, basis points e.g. 1000 = 10%) 0, // balance_a (Amount) 0, // balance_b (Amount) "00", // token_a (UID) "UID..." // token_b (UID) ] } } ``` *** ### 2. Get User Profit Info Get the profit and loss (PnL) analysis for a user's position in a specific pool. **Method**: `get_user_profit_info(address, pool_key)`\ **Args**: * `address`: User's wallet address * `pool_key`: The unique pool identifier #### Example Request ```bash USER_ADDRESS="H..." POOL_KEY="00/UID.../80" curl -s -G "https://node1.mainnet.hathor.network/v1a/nano_contract/state" \ --data-urlencode "id=000080350ca5ef204bc29b3232bb197e12bec6b473f5e6bdb749a6921197e83c" \ --data-urlencode "calls[]=get_user_profit_info(\"$USER_ADDRESS\", \"$POOL_KEY\")" \ | jq ``` #### Response Structure Returns a `UserProfitInfo` object. ```json { "return": [ 2000, // current_value_usd (Amount) 1500, // initial_value_usd (Amount) 500, // profit_amount_usd (Amount) 3333, // profit_percentage (Amount, 3333 = 33.33%) 1700000000 // last_action_timestamp (Integer) ] } ``` # DAG-Blockchain Architecture ## Architecture Overview Dozer Finance leverages Hathor Network's hybrid DAG-blockchain architecture to deliver exceptional performance and security. This innovative design combines the scalability benefits of a Directed Acyclic Graph (DAG) with the robust security features of traditional blockchain technology. ### Hybrid Design The architecture merges DAG's parallel processing capabilities with blockchain's proven security model. This combination enables instant finality while maintaining high security standards through Bitcoin merged mining. ### Key Components The DAG layer handles parallel transaction processing, enabling high throughput and efficient data structuring. Meanwhile, the blockchain layer provides security anchoring through Bitcoin merged mining and ensures consensus finality. ## Technical Features ### Parallel Processing Our system achieves up to 10,000 TPS through parallel transaction processing and real-time validation. This high throughput is made possible by eliminating traditional blockchain limitations while maintaining security. ### Network Structure The architecture employs compact block design, averaging just 190 bytes per block. This efficiency in data organization enables rapid network propagation and optimized storage utilization across the network. ## Performance Benefits ### Speed and Efficiency Transaction processing occurs instantly through parallel validation, eliminating the need for block confirmation waiting times. This design ensures real-time state updates and efficient processing without compromising security. ### Resource Optimization The system operates effectively on consumer-grade hardware, requiring only 8GB RAM minimum. This accessibility ensures broad participation possibilities while maintaining network robustness. ## Implementation Details ### Transaction Flow When a transaction enters the network, it undergoes immediate parallel processing and validation. The system achieves instant finality through efficient conflict resolution and state consistency checks, all while maintaining network-wide consensus. ### Validation Process Transactions are validated through a multi-step process: * Initial validation and conflict checking * Parallel processing with state verification * Network-wide consensus achievement * Final state confirmation ## Network Participation The low barrier to entry encourages broad network participation. Standard consumer hardware can effectively run nodes, supporting network decentralization while maintaining performance. ## Future Developments ### Continuous Improvement Our development team actively works on optimizing the architecture's performance and capabilities. Future improvements will focus on enhanced parallelization, improved efficiency, and advanced feature implementation. ### Network Evolution The system will continue to evolve through performance optimizations and feature enhancements, always maintaining the balance between accessibility and security that makes our architecture unique. # Consensus Mechanism ## Overview Dozer Finance utilizes Hathor Network's innovative consensus mechanism, combining Bitcoin's proven security through merged mining with efficient DAG-based transaction processing. This hybrid approach ensures both security and performance. ## Core Components ### Merged Mining Through integration with Bitcoin's network, our consensus mechanism inherits robust security while maintaining energy efficiency. This approach provides strong network protection without requiring additional energy expenditure. ### Transaction Processing The consensus process begins with basic verification, including format validation and signature verification. Network-wide agreement is achieved through consistent application of consensus rules and efficient state transition validation. ## Transaction Ordering ### Block Hash Entropy Our system implements a unique ordering mechanism based on block hash entropy. This ensures that transaction ordering is both random and deterministic, providing natural protection against MEV exploitation while maintaining predictable finality. ### Settlement Process Transaction settlement occurs immediately upon validation. The system updates states in real-time and propagates confirmations across the network, ensuring consistent and rapid finalization. ## Security Features ### Network Protection The integration with Bitcoin's hashpower provides fundamental security against network attacks. This protection is enhanced by distributed validation processes and comprehensive double-spend prevention mechanisms. ### Consensus Guarantees Our consensus mechanism ensures network-wide agreement on transaction ordering and state transitions. This maintains consistent data integrity and transaction immutability across the network. ## Performance Characteristics The system achieves instant finality through efficient parallel processing and quick validation. This performance scales linearly with network growth while maintaining resource efficiency. ## Implementation Details ### Node Operations Nodes maintain network consensus through continuous validation of transactions and blocks. This process includes comprehensive state verification and adherence to network consensus rules. ### System Requirements The consensus mechanism operates efficiently on standard hardware configurations, requiring only basic processing power and regular network connectivity. ## Future Development ### Ongoing Research Our team continuously researches potential improvements to the consensus mechanism. Focus areas include enhanced efficiency, increased throughput, and expanded feature sets while maintaining security standards. ### Development Areas Future improvements will target: 1. Enhanced transaction processing efficiency 2. Improved scalability mechanisms 3. Advanced security features 4. Optimized resource utilization # Security Model ## Core Security Design ### Multi-Layer Protection Dozer Finance implements a comprehensive security model: 1. Bitcoin Network Security 2. Protocol-Level Protection 3. Smart Contract Security 4. Transaction Safety ### Bitcoin Security Integration * Merged mining with Bitcoin * Inherited network security * Hashpower protection * Attack resistance ## Protocol Security ### Transaction Protection 1. **Validation** * Signature verification * Double-spend prevention * State consistency checks * Format validation 2. **MEV Protection** * Fair transaction ordering * Front-running prevention * Sandwich attack protection * Price manipulation resistance ### Network Security * Distributed validation * Node synchronization * State consistency * Data integrity ## Smart Contract Security ### Contract Design * Pre-audited templates * Security-first approach * Robust testing * Best practices implementation ### Protection Mechanisms * Access controls * Input validation * State management * Error handling ## Operational Security ### Infrastructure 1. **Node Operation** * Secure configuration * Regular updates * Performance monitoring * Attack detection 2. **Network Participation** * Distributed operation * Peer verification * Data validation * State synchronization ### System Protection * Resource management * Access control * Monitoring systems * Incident response ## User Security ### Transaction Safety 1. **Submission** * Secure processing * MEV protection * Front-running prevention * Price protection 2. **Validation** * State verification * Balance checks * Permission validation * Error handling ### Account Protection * Wallet security * Transaction signing * Access controls * Safe defaults ## Risk Management ### Attack Prevention 1. **Common Attacks** * 51% attack resistance * Double-spend prevention * Sybil attack protection * Eclipse attack mitigation 2. **DeFi-Specific** * Flash loan protection * Price manipulation resistance * Front-running prevention * Exploit protection ### Incident Response * Detection systems * Quick response * Recovery procedures * User protection ## Future Security ### Ongoing Development * Security enhancement * Feature protection * System hardening * Protocol improvements ### Research Focus * Attack vectors * Protection mechanisms * Security optimization * Risk mitigation # Tokenomics ## DZR Token Overview Dozer Finance's utility token, DZR, serves as the cornerstone of our ecosystem, enabling governance participation and providing various platform utilities. The token is designed to align incentives between users, liquidity providers, and protocol development. ## Current Status The project is currently in its pre-seed phase and has successfully raised 50% of its 100k community funding goal. Interested participants can join through our community pre-sale form: [Community Form](https://forms.gle/riqWWAtYL8ZX9RQA8) ## Token Utilities ### Governance Rights Token holders will participate in protocol governance through proposal creation and voting. This includes decisions on parameter changes, feature additions, and protocol upgrades. ### Platform Benefits DZR token holders will receive various benefits including fee sharing and participation in protocol incentive programs. The token serves as the key to accessing enhanced platform features and community rewards. ## Economic Model ### Fee Structure The platform implements a transparent fee structure: 1. Trading fees set at 0.3% 2. Variable protocol fee percentage 3. Community allocation mechanisms 4. Development funding streams ### Value Generation The protocol generates value through multiple channels including trading fees, platform usage, and service fees. This value flows back to token holders through various mechanism designed to reward long-term participation. ## Token Distribution Final token distribution allocations will be determined through community governance processes. This ensures fair representation of all stakeholder interests while maintaining protocol sustainability. ### Vesting Schedules Detailed vesting schedules will be announced alongside token launch information. These schedules will be designed to ensure long-term alignment of interests between all participants. ## Future Development ### Economic Evolution The token economics will evolve through community governance, focusing on: 1. Parameter optimization 2. Feature expansion 3. Incentive alignment 4. Community growth ### Strategic Growth Platform development will prioritize sustainable growth through careful market expansion and feature enhancement. All changes will undergo thorough community review and approval processes. # Governance ## Current Status Dozer Finance's governance is currently in development, with smart contracts being built to enable on-chain governance. During this development phase, we maintain an active governance system through our Discord DAO channel, exclusively available to pre-sale participants (Donors). ### Discord DAO Our current governance process operates through a dedicated Discord channel where Donors can: * Participate in strategic decisions * Access alpha information about the project * Vote on immediate platform decisions * Engage in direct discussions with the team ## Future Governance Model The protocol will transition to on-chain governance once the smart contracts are deployed. This system will expand upon our current DAO structure while maintaining special privileges for early supporters. ### Governance Framework The governance process will begin with proposal creation, followed by community discussion and voting. DZR token holders will have voting power proportional to their holdings, with potential additional benefits for long-term holders and early supporters. ### Decision-Making Areas Governance will cover crucial protocol aspects including: Protocol parameters and fee structures will be managed through community voting, ensuring fair and efficient operation. Strategic decisions about new features and platform development will involve community input and formal proposal processes. ## Community Participation Participation methods will evolve as we transition to on-chain governance, but will maintain our commitment to community-driven decision-making. ### Current Engagement Discord DAO members actively participate in: * Strategic discussions about protocol development * Early testing of new features * Feedback on platform improvements * Voting on immediate protocol decisions ### Future Implementation The on-chain governance system will include: Technical changes will require thorough review and testing before implementation. This process will involve security audits and community feedback to ensure safe and effective updates. Development will focus on creating efficient voting mechanisms and clear proposal processes while maintaining the strong community engagement we've built through our Discord DAO. ## Future Development Our governance system will evolve to include: Advanced voting mechanisms will ensure fair representation while protecting against common governance attacks. The proposal system will balance accessibility with protection against spam and low-quality submissions. ### Research Priorities The team is actively researching governance models that can: * Scale effectively with growing community size * Protect minority stakeholder interests * Enable efficient decision-making * Maintain security and stability ## Joining Governance To participate in current governance: 1. Join the pre-sale through our [community form](https://forms.gle/riqWWAtYL8ZX9RQA8) 2. Gain access to the exclusive Discord DAO channel 3. Engage in voting and discussions 4. Receive alpha information about project developments # Security Features ## Core Security Features ### Transaction Protection Our transaction protection system encompasses comprehensive MEV protection through block hash entropy ordering. This mechanism ensures fair execution by preventing front-running and sandwich attacks while maintaining transaction integrity. The validation system performs real-time verification with continuous state consistency checks. This includes robust double-spend prevention and thorough signature validation. ### Network Security Through integration with Bitcoin's network via merged mining, we inherit substantial security benefits and hashpower protection. This foundation is enhanced by our DAG structure security and parallel processing capabilities. ## Protocol Security ### Smart Contract Safety Our security-first approach to smart contract development emphasizes pre-audited templates and industry best practices. Implementation includes comprehensive access controls and state management systems while maintaining thorough error handling. ### Trading Protection We ensure trade safety through multiple mechanisms including price protection and slippage controls. The order management system provides protected submission paths and fair processing while maintaining execution verification standards. ## User Protection ### Account Security Wallet integration follows strict security protocols, including secure connection management and robust transaction signing. Our permission management system ensures appropriate access control at all levels. ### Data Protection Transaction privacy and data protection are maintained through comprehensive security measures. State management ensures consistency while protecting against unauthorized access or modifications. ## System Protection ### Infrastructure Security Node operation security includes regular updates and continuous performance monitoring. Network management relies on distributed operation principles with ongoing peer verification and state synchronization. ## Future Security Development ### Enhancement Focus Security development prioritizes continuous improvement of existing systems while researching and implementing new protection mechanisms. This includes ongoing system hardening and protocol security enhancements. ### Implementation Strategy Our security implementation follows a methodical approach: 1. Regular system updates and improvements 2. Comprehensive security testing 3. Performance validation 4. Continuous monitoring and adjustment