Staking Reward Scheduler

WHAT IT DOES

Staking Reward Scheduler gives DeFi protocol administrators and developers full control over staking reward programs. It reads live on-chain staking contract state including reward schedules, staked balances per user, reward rates, total rewards distributed, pending rewards, and claimable amounts. You can create reward schedules with configurable durations and rates, update reward rates dynamically, pause or resume reward distributions, and claim earned rewards. The tool shows you in real time the current reward rate, schedule duration, total distributed, pending rewards, total staked, and claimable amounts for any user—so you can optimize incentive structures based on protocol participation.

HOW TO USE

Connect your EVM wallet (must be the contract owner or authorized address). Enter the staking contract address and reward token address. Set the schedule duration in seconds (e.g., 2592000 for 30 days) and the reward rate per second (e.g., 0.001 tokens per second). Use "Check staking state" to see the current rate, duration, total distributed, pending rewards, pause status, total staked, and claimable amount for your address. Click "Create schedule" to deploy a new reward schedule with the configured duration and rate. Use "Update rate" to adjust the reward rate for an existing schedule. "Pause rewards" and "Resume rewards" control whether rewards are accruing. "Claim rewards" sends your earned rewards to your wallet. Each action generates a transaction you review and sign in your wallet.

TECHNICAL APPROACH

This tool queries live contract state using ethers v5.7.2. It calls rewardRate(), scheduleDuration(), totalDistributed(), pendingRewards(), paused(), totalStaked(), and claimable(address) directly on the staking contract to confirm current status—avoiding the trap of assuming state based on events alone. All RPC calls are wrapped in a robust error handler that extracts the actual failure reason from Ethers error objects, digging three levels deep to avoid showing "[object Object]" when a transaction reverts. For transaction costing, it uses receipt.effectiveGasPrice post-EIP-1559 rather than tx.gasPrice, which overstates actual spend. When creating schedules, the tool converts human-readable rates and durations to the correct uint256 values expected by the contract. It also checks for pause status before allowing certain operations and provides clear feedback on transaction confirmations.

WHAT IT CANNOT SEE

This tool cannot predict user staking behavior, future participation rates, or market conditions. It cannot verify off-chain reward calculations or guarantee that scheduled rewards will be claimed. It cannot detect whether users will continue staking or whether rewards will be distributed evenly. It cannot simulate execution or test whether a reward schedule will be accepted by the contract. It cannot see pending staking operations that are not yet broadcast to the public mempool. It cannot detect contract-specific permission rules beyond the standard staking interface. The tool manages staking reward schedules, but it does not guarantee that users will stake or that rewards will be claimed.

PLEASE NOTE

This tool supports EVM‑compatible chains only (Ethereum, Goerli, Sepolia, Arbitrum, Optimism, Polygon). Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, and XRP are not supported. This is a read‑write tool that requires signing transactions—always verify the staking contract address, reward token, duration, and rate before approving. No contract addresses are hardcoded; you paste the contract you are using, so you are responsible for verifying its safety and ensuring it implements the expected staking interface. The tool is free and open under the BotGentz PLAYBOOK‑C specification.