Add Protocol Fee Parameters and Accrual

[mikewheeleer]

Add Configurable Protocol Fee on Escrow Operations

Description

Introduce basis-point or fixed fee parameters collected on funding or settlement, with explicit recipient and accounting so principal and yield math remain auditable.

Requirements and context

• Must be secure, tested, and documented
• Should be efficient and easy to review

Suggested execution

• Fork the repo and create a branch
• git checkout -b feature/escrow-protocol-fees
• Implement changes
• Write contract: escrow/src/lib.rs
• Write comprehensive tests: escrow/src/test.rs
• Add documentation: README.md
• Include Rust doc comments for fee caps and rounding
• Validate assumptions to prevent fee bypass and arithmetic edge cases

Test and commit

• Run tests
• Cover edge cases
• Include test output and security notes

Example commit message

feat(escrow): add configurable protocol fee accrual and settlement

Guidelines

• Minimum 95 percent test coverage
• Clear documentation
• Timeframe: 96 hours

[Sadeequ]

@Sadeequ has applied to work on this issue as part of the Stellar Wave Program's 3rd wave.

Would you like me me to fix this issue for you?

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Sadeequ to this issue.