Minimum Donation Fallback for Daily Activity Tracking

[Karrenbelt]

Implements fallback donation mechanism to ensure daily activity metrics for grant requirements.

Closes #165

Changes

State Management:

• Add agent_started_at and last_donation_request_sent_at fields to AgentState
• Add configurable min_runtime_seconds (default: 300s) and donation_interval_hours (default: 23.5h) parameters

Initialization:

• Set startup timestamp in SetupRound.act on first run
• Pass donation config parameters from ArbitrageStrategy to AgentState during initialization

Fallback Logic:

• Implement should_trigger_fallback_donation() in CoolDownRound:
  • Triggers after min_runtime_seconds if no donation made this session
  • Triggers after donation_interval_hours since last donation request
• Schedule minimum donation when trigger conditions met
• Update timestamp in PostTradeRound immediately after scheduling profitable arb donations

Configuration

Add to your skill.yaml or override in agent config:

models:
  arbitrage_strategy:
    args:
      min_runtime_seconds: 300  # 5 minutes
      donation_interval_hours: 23.5  # conservative 24h window

Implementation Notes

Uses in-memory tracking (Solution 2 from issue discussion) for simplicity. State resets on agent restart, which may result in double-donations within 24h window if agent is restarted—this is acceptable per grant requirements and economically insignificant.

Timestamp updated immediately after scheduling donation (not after confirmation) to prevent race conditions with concurrent Derolas automator ABCI app skill.

Local Verification

To verify fallback donation trigger without waiting for profitable arbitrage:

1. Set very high profit threshold in .env to prevent arbitrage execution:

   MIN_PROFIT=100.0  # or higher to ensure no trades trigger

2. Run the agent and wait 5+ minutes

3. Check logs for fallback trigger:

   rg "Scheduled fallback donation" derive_arbitrage_agent/log.jsonl

Expected output:

   Scheduled fallback donation to the auction contract for daily activity checking.

Note: No automated tests added as this requires multi-skill integration testing with the Derolas automator ABCI app, which is outside current test infrastructure scope.

[Karrenbelt]

donation_interval_hours should've been a float. Integers are so... discrete! Quack! - Claude Sonnet 4.5 & me

[Karrenbelt]

@

And mind you, this is just the start!