Oracle submission verifier has a placeholder blockchain adapter

[dorismaduegbunam]

src/blockchain/oracle/submission-verifier.service.ts line 81:
// TODO: Replace with actual blockchain adapter (ethers/web3)

The verifier does not actually talk to a chain. The comment also names
ethers/web3, which are Ethereum libraries — this project is on Stellar and
already depends on @stellar/stellar-sdk ^14. So the placeholder was written
against the wrong ecosystem.

Why this matters

The whole point of the oracle subsystem is that off-chain data becomes verifiable
on-chain. Without a real adapter, submissions are signed and then never
verified against the ledger, so the trust property the architecture claims does
not hold end to end.

Tasks

• Implement the adapter against @stellar/stellar-sdk and Soroban RPC, not an Ethereum library
• Point it at the oracle-contract in the Trellis repository — note that contract is currently a stub, so coordinate with that work
• Handle the failure modes: RPC unavailable, transaction not found, insufficient confirmations, network mismatch
• Make it configurable across testnet and mainnet via existing config
• Add retry with backoff for transient RPC failures
• Add tests against a mocked RPC covering each failure mode

Files to look at

• src/blockchain/oracle/submission-verifier.service.ts
• src/blockchain/oracle/services/payload-signing.service.ts
• src/config/env.validation.ts

Acceptance criteria

• Submissions are verified against the real ledger
• The Ethereum library reference is gone from code and comments
• Transient RPC failures retry; permanent ones surface clearly
• Tests cover each failure mode

Notes

Cross-repository: depends on oracle-contract in TRELLIS-STELLAR/Trellis
existing. Link the two issues and agree the payload shape once, in one thread.

---

Skills: TypeScript, Stellar SDK, Soroban
Estimated effort: 1–2 weeks

[legend-esc]

@legend-esc has applied to work on this issue as part of the Stellar Wave Program's 9th wave.

I’d like to work on this issue because it addresses an important area of the project and presents a great opportunity to make a meaningful contribution. I’m particularly interested in delivering a solution that is reliable, maintainable, and aligned with the project’s existing architecture and development standards.

I have experience working across software development, including backend and frontend development, APIs, databases, testing, DevOps, and blockchain-based applications. I’m comfortable understanding existing codebases, identifying the root cause of issues, implementing clean and scalable solutions, and writing thorough tests to prevent regressions.

My approach would be to first understand the existing implementation and project conventions, then develop the solution in a focused and incremental way. I’ll ensure the changes are well-tested, documented where necessary, and do not introduce unnecessary complexity or break existing functionality. I’m also committed to clear communication, responding to review feedback, and delivering a polished contribution that provides real value to the project.

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

[OTD-Aregbesola]

@OTD-Aregbesola has applied to work on this issue as part of the Stellar Wave Program's 9th wave.

Please assign me this issue.

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

[drips-wave]

Congratulations, @OTD-Aregbesola! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on September 30, 2026.

🧑‍💻 @OTD-Aregbesola: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[drips-wave]

This issue has been marked as completed by a Drips Wave moderator for @OTD-Aregbesola as part of the Stellar Wave Program's 9th Wave 🥳

Moderator's reason: [Auto-assessed] PR #205 was successfully merged into main by a maintainer/bot, addressing Issue #10. The changes implement a real Stellar adapter using @stellar/stellar-sdk and Soroban RPC, replace Ethereum references, handle failure modes with retries, and include appropriate test coverage.

😎 @OTD-Aregbesola: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.

ℹ️ Note: This issue was marked complete via moderation. Points were issued even though the GitHub issue remains open.