getters: last_checkpoint_ledger (#255), vesting_dates (#256), emergency_withdrawal_count (#257), upgrade_count (#258)

[thefadah]

Four small analytics/UX getters requested across the farming-pool, vesting-wallet, and factory contracts.

#255 — last_checkpoint_ledger on FarmingPool

checkpoint() resets UserStake.start_ledger to the current ledger on every stake / unstake / set_boost, so it is the origin the user's next credit accrual is measured from — it just wasn't exposed.

pub fn last_checkpoint_ledger(env: Env, user: Address) -> Option<u32>

Returns that ledger, or None when the user has no active continuous stake.

#256 — vesting_dates on the vesting wallet

The three schedule ledgers were only reachable one private getter at a time.

pub fn vesting_dates(env: Env) -> Result<(u32, u32, u32), VestingError>

Returns (start_ledger, cliff_ledger, end_ledger) in a single read, require_initialized-gated like get_vesting_schedule.

#257 — emergency_withdrawal_count on FarmingPool

New DataKey::EmergencyWithdrawalCount, incremented on each successful emergency_withdraw (right before the emrg_exit event), exposed via:

pub fn emergency_withdrawal_count(env: Env) -> u32

#258 — upgrade_count on Factory

New DataKey::UpgradeCount, incremented on each successful upgrade_pool (right before the pool_upg event), exposed via:

pub fn upgrade_count(env: Env) -> Result<u32, FactoryError>

Incidental

farming-pool/src/lib.rs already calls env.storage().instance().get/set(&DataKey::StakedUserCount, …) in increment_staked_user_count / decrement_staked_user_count, but DataKey::StakedUserCount was never declared in the enum. Added it. #[contracttype] enum keys encode by variant name, so adding variants does not change any existing on-chain key.

Not built or tested locally.

Closes #255
Closes #256
Closes #257
Closes #258

[netlify]

✅ Deploy Preview for sdcontracts ready!

Name	Link
🔨 Latest commit	c645cbd
🔍 Latest deploy log	https://app.netlify.com/projects/sdcontracts/deploys/6a92007278189f000811afd4
😎 Deploy Preview	https://deploy-preview-265--sdcontracts.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[drips-wave]

@thefadah Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits