Skip to content

feat: Implement clawback health check for regulated assets (Issue #200)#252

Merged
JerryIdoko merged 1 commit intoGrant-Stream:mainfrom
Xhristin3:feature/clawback-health-check
Mar 28, 2026
Merged

feat: Implement clawback health check for regulated assets (Issue #200)#252
JerryIdoko merged 1 commit intoGrant-Stream:mainfrom
Xhristin3:feature/clawback-health-check

Conversation

@Xhristin3
Copy link
Copy Markdown
Contributor

  • Add DeficitRecord and ClawbackBuffer structures for tracking clawback events
  • Add SafetyPaused status to GrantStatus enum
  • Add deficit tracking fields to Grant struct (deficit_detected, deficit_amount, etc.)
  • Implement perform_clawback_health_check() to verify contract balance before withdrawals
  • Implement withdraw_proportional_during_safety_pause() for fair distribution during deficit
  • Add admin functions: resolve_deficit_with_treasury_funds(), activate_safety_pause(), deactivate_safety_pause()
  • Add getter functions: get_deficit_record(), get_clawback_buffer()
  • Emit DeficitDetected event when contract balance < total owed
  • Automatically trigger safety pause to prevent race conditions on clawback
  • Allow proportional withdrawals after 4-hour buffer period expires
  • Add comprehensive integration tests for clawback health check scenarios

Security: Prevents first-withdrawer advantage during external clawback events
Compliance: Handles regulated assets with clawback-enabled tokens gracefully

closes #103

@drips-wave
Copy link
Copy Markdown

drips-wave bot commented Mar 28, 2026

@Xhristin3 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

@JerryIdoko JerryIdoko merged commit 56a9503 into Grant-Stream:main Mar 28, 2026
1 check failed
…nt-Stream#200)

- Add DeficitRecord and ClawbackBuffer structures for tracking clawback events
- Add SafetyPaused status to GrantStatus enum
- Add deficit tracking fields to Grant struct (deficit_detected, deficit_amount, etc.)
- Implement perform_clawback_health_check() to verify contract balance before withdrawals
- Implement withdraw_proportional_during_safety_pause() for fair distribution during deficit
- Add admin functions: resolve_deficit_with_treasury_funds(), activate_safety_pause(), deactivate_safety_pause()
- Add getter functions: get_deficit_record(), get_clawback_buffer()
- Emit DeficitDetected event when contract balance < total owed
- Automatically trigger safety pause to prevent race conditions on clawback
- Allow proportional withdrawals after 4-hour buffer period expires
- Add comprehensive integration tests for clawback health check scenarios

Security: Prevents first-withdrawer advantage during external clawback events
Compliance: Handles regulated assets with clawback-enabled tokens gracefully
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

#60. Support for Native_Asset_Clawback_Detection

2 participants