Add browser and edge runtime compatibility tests

[Lakes41]

Difficulty: Advanced

Type: Test

Summary

Add runtime compatibility tests for browser-like and edge-like environments so the universal SDK claim remains reliable.

Current Behaviour

The SDK is documented as working in Node.js, browsers, and Edge runtimes, but the test suite mainly runs in a Node-style environment.

Expected Behaviour

CI should verify that supported SDK entry points do not rely on Node-only globals in browser and edge runtime scenarios.

Suggested Implementation

Add Vitest projects or lightweight compatibility test bundles for Node, jsdom or browser-like runtime, and edge-like runtime. Verify imports, client construction with custom fetch, service calls with mocked transport, and address utilities.

Files or Areas Likely Affected

• vitest.config.ts
• tests/compat/
• package.json
• tsup.config.ts
• .github/workflows/ci.yml
• README.md

Acceptance Criteria

• Compatibility tests run in a Node runtime
• Compatibility tests run in a browser-like runtime
• Compatibility tests cover a custom fetch transport
• SDK imports do not require Node-only globals in browser-like tests
• Build output remains compatible with declared package exports
• README documents tested runtime support

Additional Notes

This should not duplicate package export smoke tests. It should focus on runtime behaviour after imports succeed.

[Meet-hybrid]

Can I work on this please?

[Oluwasuyi-Oluwatimilehin-Daniel]

Hello maintainers I'm a full stack developer with experience in building scalable systems I can handle this perfectly if assigned

[gloskull]

Hello, I have 4 years of experience delivering solutions for projects like this, covering backend, frontend, and smart contract development. After carefully reviewing your requirements, I have a clear understanding of the task and am confident in my ability to deliver a clean, efficient, and thoroughly tested solution on time. I prioritize code quality, maintainability, and industry best practices throughout the development process.
My PR will be submitted in under 10hours.

[grantfox-oss]

🦊 GrantFox — @Oluwasuyi-Timilehin has been assigned to this issue as part of the Official Campaign campaign!

Next steps:

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

Good luck! Track your progress on GrantFox.