Feat/flexible fee destination routing (#593)

[Chucks1093]

Closes #593

Changes

• Flexible fee routing model added to bounty escrow

  • Added FeeRoutingConfig with:
    • treasury_recipient
    • treasury_bps
    • partner_recipient (optional)
    • partner_bps
  • Added storage key: DataKey::FeeRouting(u64) for per-bounty routing.

• New admin configuration entrypoints

  • set_fee_routing(bounty_id, treasury_recipient, treasury_bps, partner_recipient, partner_bps)
  • clear_fee_routing(bounty_id)
  • get_fee_routing(bounty_id)

• Deterministic routing + validation

  • Routing config validation enforces:
    • treasury_bps >= 0
    • partner_bps >= 0
    • treasury_bps + partner_bps == 10_000
    • partner_bps > 0 requires partner_recipient
    • partner_bps == 0 requires no partner_recipient
  • Deterministic split behavior:
    • Treasury fee = total_fee * treasury_bps / 10_000 (floor)
    • Partner fee = total_fee - treasury_fee (remainder-safe, no drift)

• Fee routing integrated into payout paths

  • Lock-side fee routing applied in:
    • lock_funds
    • batch_lock_funds
  • Release-side fee routing applied in:
    • release_funds
    • batch_release_funds
    • partial_release
    • release_with_capability
    • claim
    • claim_with_capability
    • claim_with_ticket

• Backward-compatible default behavior

  • If no bounty-specific routing is configured, routing defaults to existing fee recipient:
    • 100% to FeeConfig.fee_recipient
    • 0% partner split

• New events for full accounting visibility

  • FeeRoutingUpdated emitted when routing config changes
  • FeeRouted emitted on fee distribution with complete split details

Testing

• Added new test module:

  • contracts/bounty_escrow/contracts/escrow/src/test_fee_routing.rs

• New coverage includes:

  • Treasury + partner split routing on lock fees
  • Deterministic remainder handling on release fees
  • Default fallback routing to existing fee recipient
  • Rejection of invalid routing basis-point configs

• Validation run:

  • cargo test --lib test_fee_routing -- --nocapture ✅
  • cargo test --lib -- --nocapture in bounty escrow crate ✅ (519 passed)

Notes

• Implementation is scoped to the active bounty escrow contract:
  • contracts/bounty_escrow/contracts/escrow
• Existing fee configuration APIs remain intact; routing extends behavior without breaking existing callers.

[vercel]

@Chucks1093 is attempting to deploy a commit to the Jagadeesh B's projects Team on Vercel.

A member of the Team first needs to authorize it.

[Jagadeeshftw]

please resolve the conflicts

[Jagadeeshftw]

Did you mind resolving the conflicts? @Chucks1093