fix: Bun + Deno runtime compatibility audit

[isaacCodes1]

Overview

This PR adds a runtime compatibility audit for Bun, Deno, Cloudflare Workers, and Vercel Edge, and fixes the Stellar announcement parser so it no longer uses require() inside ESM. It also documents the current runtime matrix and adds an edge-runtime guide for using the SDK outside Node.

Related Issue

Closes #23

Changes

⚙️ Stellar Runtime Fix

• [MODIFY] src/chains/stellar/announcements.ts

• Replaced the inline require('@stellar/stellar-sdk') path with a lazy import() loader.

• Kept the parser compatible with ESM and edge runtimes.

• [ADD] test/chains/stellar/scan.test.ts

• Added a regression test that exercises fetchAnnouncements().

• Verified the Stellar parser path works without require().

🌐 Compatibility Documentation

• [ADD] COMPAT.md

• Added a runtime matrix for Node 20/22, Bun, Deno, Cloudflare Workers, and Vercel Edge.

• Documented working, partial, and caveated runtime states.

• [ADD] docs/running-on-the-edge.md

• Added guidance for Bun, Deno, Cloudflare Workers, and Vercel Edge.

• Included import examples and notes about optional peer dependencies.

• [MODIFY] README.md

• Linked the new compatibility matrix and edge-runtime guide from the main README.

🧪 CI

• [MODIFY] .github/workflows/ci.yml
• Expanded the Node matrix to cover Node 20 and Node 22.
• Added a Bun job so at least one non-Node runtime is verified in CI.

Verification Results

Acceptance Criteria	Status
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)	✅
Stellar announcement parser no longer uses require() inside ESM	✅
Regression test added for the Stellar parsing path	✅

How to Test

# 1. Confirm you're on the branch
git branch --show-current

# 2. Run the full test suite
pnpm test

# 3. Verify Bun compatibility
bun test

# 4. Verify the package builds cleanly
pnpm build

# 5. Check formatting
pnpm format:check

[drips-wave]

@isaacCodes1 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

[truthixify]

COMPAT.md, the edge runtime guide, the require() → dynamic import() fix in announcements.ts, and the CI matrix expansion are all good. Same rebase blocker as the others, your branch is pre-develop.

git fetch origin
git rebase origin/develop
git push --force-with-lease

Resolve by keeping develop's versions for the files you didn't intend to touch, keep your COMPAT.md, docs/running-on-the-edge.md, the CI changes, and the lazy-import fix. Thanks @isaacCodes1.

[isaacCodes1]

Rebased onto upstream/develop and resolved the Stellar announcements conflict by keeping the new range/cursor logic while preserving the edge-safe lazy import fix. @truthixify

[truthixify]

Clean rebase, COMPAT.md + edge-runtime guide + the announcements.ts dynamic-import fix all land cleanly. Merging. Thanks @isaacCodes1.