Purpose of the Calculator

The Shardeum Node APY Calculator is designed to help validators estimate their potential earnings in SHM (Shardeum’s native token) by running validator nodes. It calculates rewards, costs, and profitability metrics based on user inputs such as the number of servers, VPS costs, validator stake, hardware investment, and the probability of being selected for validation. The calculator provides a user-friendly interface to explore different scenarios and understand the financial implications of running Shardeum nodes.

Input Fields

• Number of Servers (1–100): The number of servers you are running as validator nodes. Each server requires its own validator stake and incurs separate VPS costs.
• Monthly VPS Costs per Server: The monthly cost to operate each server (e.g., hosting, electricity) in USD, EUR, INR, or SHM. Enter 0 if there are no ongoing costs.
• Validator Stake (SHM) in Each Server (2400–100,000): The amount of SHM staked per server to participate in validation. The minimum stake is 2400 SHM per server, and increasing the stake does not affect rewards but impacts the initial investment.
• Hardware Investment (if applicable): The one-time cost to purchase hardware for each server in USD, EUR, INR, or SHM. Enter 0 if using VPS or rented servers.
• Daily Selection Probability: The probability (%) of a node being selected for validation each day. Choose from:
  • Use Community Probability: Uses the default probability from community data (e.g., 55%), sourced from config.json.
  • Custom Probability (%): Enter a custom daily selection probability (0–100%).
  • Weekly Validations per Node: Enter the number of times your node validates per week (0–7), and the calculator computes the probability as validations ÷ 7.

Note: All inputs except Number of Servers and Validator Stake are optional and default to 0 or community values if not provided.

Output Metrics

• Current SHM Price: The market price of SHM in USD, EUR, and INR, sourced from CoinGecko.
• Initial Investment: Total upfront cost, including hardware investment (Number of Servers × Hardware Cost per Server) plus validator stake (Number of Servers × Validator Stake per Server), displayed in the selected currency and SHM.
• Daily Nodes Cost: Daily operating cost per server (Monthly VPS Costs ÷ 30) × Number of Servers, in selected currency and SHM.
• Monthly Nodes Cost: Monthly operating cost (Monthly VPS Costs × Number of Servers), in selected currency and SHM.
• Annual Nodes Cost: Annual operating cost (Monthly VPS Costs × 12 × Number of Servers), in selected currency and SHM.
• Net Annual Profit: Annual rewards (Daily Rewards × 365) minus Annual Nodes Cost, in selected currency and SHM.
• Weekly Rewards: Weekly rewards (Daily Rewards × 7), where Daily Rewards = Probability × Reward per Validation × Number of Servers, in selected currency and SHM.
• Monthly Rewards: Monthly rewards (Daily Rewards × 30), in selected currency and SHM.
• Net Daily Return (Daily Return on Investment): (Daily Rewards - Daily Nodes Cost) ÷ Initial Investment × 100, displayed as a percentage.
• Net ROI (Return on Investment): Net Annual Profit ÷ Initial Investment × 100, displayed as a percentage.
• Estimated APY (Annual Percentage Yield): Equal to Net ROI (simplified, no compounding), displayed as a percentage.

Note: Metrics are displayed in the selected currency (USD, EUR, INR, or SHM) and SHM for clarity. 'N/A' is shown for ROI, APY, and Daily Return if Initial Investment is 0.

Calculation Formulas

Below are the formulas used to compute the output metrics, where all monetary inputs are converted to SHM using the current SHM price from CoinGecko.

• SHM Conversion:
  • Hardware Cost (SHM) = Hardware Investment ÷ SHM Price (in selected currency)
  • VPS Cost (SHM) = Monthly VPS Costs ÷ SHM Price (in selected currency)
• Probability:
  • Community: From config.json (e.g., 0.55)
  • Custom: Custom Probability Input ÷ 100
  • Weekly Validations: Weekly Validations Input ÷ 7
• Daily Rewards (SHM): Probability × Reward per Validation (from config.json, e.g., 40 SHM) × Number of Servers
• Weekly Rewards (SHM): Daily Rewards × 7
• Monthly Rewards (SHM): Daily Rewards × 30
• Annual Rewards (SHM): Daily Rewards × 365
• Daily Nodes Cost (SHM): (VPS Cost × Number of Servers) ÷ 30
• Monthly Nodes Cost (SHM): VPS Cost × Number of Servers
• Annual Nodes Cost (SHM): VPS Cost × 12 × Number of Servers
• Net Annual Profit (SHM): Annual Rewards - Annual Nodes Cost
• Initial Investment (SHM): (Hardware Cost × Number of Servers) + (Validator Stake × Number of Servers)
• Net Daily Return (%): (Daily Rewards - Daily Nodes Cost) ÷ Initial Investment × 100
• Net ROI (%): Net Annual Profit ÷ Initial Investment × 100
• Estimated APY (%): Equal to Net ROI

Note: All monetary outputs are converted to the selected currency using the current SHM price for display.

How to Use the Calculator

Follow these steps to estimate your Shardeum node earnings:

1. Enter the Number of Servers you plan to run (1–100).
2. Input the Monthly VPS Costs per Server in your preferred currency (USD, EUR, INR, or SHM). Use 0 if there are no costs.
3. Specify the Validator Stake (SHM) in Each Server (minimum 2400 SHM per server).
4. Enter the Hardware Investment (if applicable) per server in your preferred currency. Use 0 for VPS setups.
5. Choose a Daily Selection Probability option:
   • Select Use Community Probability to use the default value from community data.
   • Choose Custom Probability (%) and enter a percentage (0–100%) based on your node’s performance.
   • Select Weekly Validations per Node and enter the number of validations per week (0–7) to calculate the probability.
6. Click Calculate Earnings to view results.
7. Review the output metrics, including costs, rewards, and profitability percentages, displayed in your selected currency and SHM.
8. Use the bar chart to visualize Weekly and Monthly Rewards in your chosen currency.

The calculator uses real-time SHM prices from CoinGecko and community data from config.json (probability and reward per validation). Results are estimates and may vary based on network conditions and SHM price fluctuations.

Technical Details

The Shardeum Node APY Calculator is built using:

• HTML and Tailwind CSS: For responsive design and styling.
• JavaScript: For dynamic calculations and user interaction.
• Chart.js: To render the rewards bar chart.
• noUiSlider: For interactive sliders on input fields.
• CoinGecko API: To fetch real-time SHM prices in USD, EUR, and INR.
• config.json: To store community-driven probability and reward values.

The source code is available at GitHub. For questions or feedback, contact the Shardeum community at shardeum.org.