Build a Reactive Soroban Contract Event Subscription Layer

[meshackyaro]

Description

This issue aims to address the implementation of Build a Reactive Soroban Contract Event Subscription Layer.

The core objective is to: Create a typed useContractEvents hook that streams escrow/dispute contract events, deduplicates across reconnects, and hydrates the UI cache without full refetches.

By completing this feature, we will ensure that the TrustFlow protocol maintains its high standards for security, usability, and decentralized logic. This issue requires careful attention to the Frontend architecture and adherence to the existing project conventions.

When picking up this issue, please ensure you document any new dependencies or architectural decisions made during development.

Component

Frontend

Difficulty

🔴 Hard

Tasks

• Review Next.js App Router structure
• Implement the UI components for: Build a Reactive Soroban Contract Event Subscription Layer
• Ensure responsive design using Tailwind CSS or standard modules
• Add caching for npm dependencies in CI
• Run npm run lint and npm run typecheck
• Run npm run build to verify production bundling

Acceptance Criteria

• Feature accurately implements the objective: Create a typed useContractEvents hook that streams escrow/dispute contract events, deduplicates across reconnects, and hydrates the UI cache without full refetches.
• Any PR that introduces TypeScript errors is automatically blocked
• CI pipeline runs in under 3 minutes per PR
• Code is properly reviewed and approved by codeowners

Estimated Time

3-5 days

[daniella-techie]

Hi! I'd like to work on this issue. I have experience building React/Next.js applications and integrating blockchain event streams into frontend state. I'll implement a typed useContractEvents hook with reliable reconnect handling, event deduplication, and cache hydration to avoid unnecessary refetches, while keeping the implementation aligned with the existing architecture and ensuring all lint, typecheck, build, and CI requirements pass.

[grantfox-oss]

🦊 GrantFox — @daniella-techie has been assigned to this issue as part of the Official Campaign | FWC26 campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #61)
2. Your PR will be reviewed by the trustflow-protocol maintainers

Good luck! Track your progress on GrantFox.