feat: ACTUS events

[cusma]

No description provided.

[Copilot]

Pull request overview

This PR introduces ACTUS event emission (as ARC-28 events) from payment-agent methods, plus documentation and a new test intended to exercise event logs end-to-end.

Changes:

• Add Event ARC-4 struct schema and ACTUS event type constants (PR/IP), and emit events from pay_coupon and pay_principal.
• Add a Fixed Coupon Bond test helper to extract/decode event logs and a new test to run through coupon + principal payments.
• Update docs and CI workflow to include/validate ACTUS events behavior.

Reviewed changes

Copilot reviewed 15 out of 25 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
modules/payment_agent/principal.py	Emit PR event during principal payment.
modules/payment_agent/coupon.py	Emit IP event during coupon payment.
smart_contracts/events.py	Define the ARC-4 Event struct used for ARC-28 emission.
smart_contracts/enums.py	Add ACTUS event type constants (EVT_TYPE_PR, EVT_TYPE_IP).
tests/utils.py	Add utilities to extract and decode emitted event logs.
tests/fixed_coupon_bond/test_actus_events.py	Add a scenario test intended to exercise event emission for a fixed coupon bond.
docs/interfaces/payment-agent/pay-coupon.md	Document emitted IP event for pay_coupon.
docs/interfaces/payment-agent/pay-principal.md	Document emitted PR event for pay_principal.
docs/events/events.md	Add event schema documentation and supported event types list.
docs/SUMMARY.md	Link the new Events documentation page in the docs summary.
pyproject.toml	Relax Ruff line-length enforcement across tests/** via E501 ignore.
.github/workflows/d-asa-ci.yaml	Add a dedicated CI job to run the ACTUS events test.
modules/core_financial/coupon.py	Import formatting only.
smart_contracts/artifacts/*/*.approval.teal	Regenerated TEAL artifacts reflecting event emission changes.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.