Bun + Deno runtime compatibility audit

[truthixify]

Labels: Stellar Wave, compat, audit, drips, help-wanted
Tier: M (2–4 days)
Type: compat / audit

Context

The SDK is tested on Node 22. Modern serverless and edge platforms increasingly target Bun and Deno. Cloudflare Workers, Vercel Edge, and Deno Deploy are common deployment targets for "scan announcements for incoming payments" cron jobs. If the SDK silently fails on those runtimes, we've cut off a substantial integration surface.

Scope

Run the SDK test suite under each runtime and document the result:

1. Bun (latest)
   • Install via bun install.
   • Run bun test (or wire vitest through bun's compat shim).
   • Document failures.
2. Deno (latest, with --unstable-sloppy-imports if needed)
   • Use the npm specifier: import { ... } from "npm:@wraith-protocol/sdk@1.x/chains/stellar".
   • Run a smoke script that does the basic flow.
3. Cloudflare Workers (workerd runtime)
   • Spin up wrangler dev and import the SDK.
   • Note any failures (likely crypto.randomBytes vs. crypto.getRandomValues).

For each runtime:

• Document working / broken / partially-working state.
• Identify the root cause of each break (missing API, different ESM resolution, etc.).
• Fix the SDK where the fix is small and broadly applicable; document a polyfill or workaround where it isn't.

Acceptance criteria

• COMPAT.md table covering Node 20/22, Bun, Deno, Cloudflare Workers, Vercel Edge.
• All fixable issues fixed.
• CI matrix expanded to include at least one non-Node runtime (Bun is easiest).
• Docs guide added for "running Wraith on the edge."

Why this matters

Spectre, a Stellar-scanning cron, or any "watch this address" service is a natural fit for edge runtimes. Closing the gap unlocks a wave of integrators who don't want to run Node infrastructure.

Resources

• Bun: https://bun.sh
• Deno: https://deno.land
• Cloudflare Workers: https://developers.cloudflare.com/workers/

[isaacCodes1]

@isaacCodes1 has applied to work on this issue as part of the Stellar Wave Program's 5th wave.

Hello Maintainer, I’ve reviewed the issue description and I’m confident I can work on it effectively. Please assign it to me.

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

[JafetCHVDev]

@JafetCHVDev has applied to work on this issue as part of the Stellar Wave Program's 5th wave.

Hello Team,

My Background

My name is Cristian, and I’m a passionate full-stack developer from Costa Rica 🇨🇷💻. I’m excited about the opportunity to contribute to your Stellar-based project during Drips Wave! 🌊
I enjoy building web applications that combine clean user interfaces with solid back-end logic and reliable databases.

Experience

I have experience developing web applications using technologies such as React, .NET Core, SQL Server, and Firebase. I’ve worked on projects that include role-based systems, CRUD platforms, booking systems, and data-driven web apps.
While I’m still growing in Web3 and blockchain, I’m highly motivated to learn and apply these technologies, especially within the Stellar ecosystem.

I’m driven by the opportunity to improve my skills, collaborate with a talented team, and make a meaningful contribution to your project.

Links

You can find my profiles and links here:

GitHub: https://github.com/JafetCHVDev

Thank you for considering my candidacy. I am excited about the opportunity to contribute to this project and create a positive impact. Please let me know if you have any questions or need additional information.

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

[drips-wave]

Congratulations, @isaacCodes1! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 2, 2026.

🧑‍💻 @isaacCodes1: 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 🌊

[truthixify]

Resolved by #37 (merged into develop).

[drips-wave]

This issue has been completed by @isaacCodes1 as part of the Stellar Wave Program's 5th Wave 🥳

😎 @isaacCodes1: 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. You can also Leave a review to share your experience working on this issue.

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