Skip to content

test: add Stellar SDK v14 regression suite#408

Open
DeePrincipal-dev-lang wants to merge 5 commits into
Disciplr-Org:mainfrom
DeePrincipal-dev-lang:chore/stellar-sdk-regression-suite
Open

test: add Stellar SDK v14 regression suite#408
DeePrincipal-dev-lang wants to merge 5 commits into
Disciplr-Org:mainfrom
DeePrincipal-dev-lang:chore/stellar-sdk-regression-suite

Conversation

@DeePrincipal-dev-lang
Copy link
Copy Markdown

@DeePrincipal-dev-lang DeePrincipal-dev-lang commented May 27, 2026

Closes #350


Summary

Adds a Stellar SDK v14 regression suite to protect the backend against future SDK breaking changes.

What changed

  • Added stellarSdkRegression.test.ts
    • Verifies SDK exports required by src/services/soroban.ts
    • Covers Contract, TransactionBuilder, nativeToScVal
    • Covers xdr.ScVal.fromXDR, scValToNative from src/services/eventParser.ts
    • Validates rpc.Server shape without making live network calls
    • Includes XDR roundtrip tests for string, i128, and u128 values
    • Includes integration-style coverage for Soroban submit and event parsing flows
  • Added upgrade documentation
    • docs/STELLAR_SDK_UPGRADE_PROCESS.md
    • docs/STELLAR_SDK_REGRESSION_SUITE.md
    • docs/STELLAR_SDK_REGRESSION_TEST_OUTPUT.md

Why

Protects the repo from future @stellar/stellar-sdk upgrades by pinning and asserting the exact SDK surface the backend relies on.

Test plan

  • npm test -- stellarSdkRegression.test.ts
  • Result: PASS ./stellarSdkRegression.test.ts with 34 passed, 34 total

Notes

  • No Jest config changes were required; root-level .test.ts files are already included.
  • Network behavior is not tested live; only API shape is asserted.

- Implement comprehensive regression test suite for @stellar/stellar-sdk v14
- 34 test assertions covering all critical SDK exports
- Tests for Contract, TransactionBuilder, XDR conversion, rpc.Server APIs
- XDR roundtrip validation for string, i128, u128 types
- Integration tests for Soroban submission and event parsing flows
- Mock network calls; validate shape not live behavior
- 100% pass rate, ~0.95s execution time

- Add STELLAR_SDK_UPGRADE_PROCESS.md with step-by-step upgrade guide
- Add STELLAR_SDK_REGRESSION_SUITE.md with implementation details
- Add STELLAR_SDK_REGRESSION_TEST_OUTPUT.md with test results

Covers SDK exports used by:
  - src/services/soroban.ts: Contract, TransactionBuilder, nativeToScVal, Keypair, rpc.Server
  - src/services/eventParser.ts: xdr, scValToNative, xdr.ScVal.fromXDR

Integrated into Jest config; runs automatically in CI via 'npm test'
@drips-wave
Copy link
Copy Markdown

drips-wave Bot commented May 27, 2026

@DeePrincipal-dev-lang 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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Replace stub stellarSdkRegression.test.ts with a pinned Stellar SDK v14 regression suite

2 participants