Feat/sdk integration tests

[Babigdk]

Closes #165

🧪 Feature: Integration Tests with Local Soroban

📌 Overview

This PR introduces integration tests for the SDK that interact with a local Soroban node to validate real contract deployment and interaction flows.

---

✅ What’s Included

• Integration test suite under:
  src/deployer/__tests__/integration

• Tests cover:

  • WASM upload
  • Contract deployment
  • Basic interaction

• Environment-based configuration via .env.integration

---

⚙️ How to Run

1. Start local Soroban node:

stellar contract sandbox start

<!-- This is an auto-generated comment: release notes by coderabbit.ai -->

## Summary by CodeRabbit

* **Tests**
  * Introduced integration test infrastructure for contract deployment and interaction testing
  * Added integration test configuration and setup with environment variables for Soroban RPC connectivity
  * Updated test runner configuration to isolate integration tests from standard test execution

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

This change introduces integration test infrastructure for the SDK by adding an environment configuration file, a test setup module that exports configuration from environment variables, and initial integration test file placeholders for contract deployment and interaction scenarios.

Changes

Cohort / File(s)	Summary
Integration Test Configuration packages/sdk/.env.integration, packages/sdk/vitest.config.ts	Adds environment variable configuration for integration tests (SOROBAN_RPC_URL, SOROBAN_NETWORK_PASSPHRASE, TEST_SECRET_KEY) and updates test exclusion patterns to isolate integration tests from standard test runs.
Test Setup packages/sdk/src/__tests__/integration/setup.ts	Introduces TEST_CONFIG export that loads and validates integration test configuration from environment variables with runtime guards.
Integration Test Suites packages/sdk/src/__tests__/integration/deploy.test.ts, packages/sdk/src/__tests__/integration/interaction.test.ts	Adds placeholder integration test cases for contract deployment (uploadWasm, deployContract) and contract interaction workflows with assertions on returned values.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

• Feat/sdk multisig contract deployer #247: Introduces Signer type parameter changes to ContractDeployer API methods (uploadWasm, deployContract) that the new integration tests directly invoke.
• feat(sdk): add ContractDeployer module with fee estimation and error … #110: Adds ContractDeployer functionality and integration test initialization that closely parallels the setup and deployment test patterns introduced here.
• feat(sdk): add comprehensive TSDoc comments to deployer module - Docu… #228: Updates JSDoc documentation for ContractDeployer.uploadWasm and ContractDeployer.deployContract methods that are exercised by the new integration tests.

Poem

🐰 Integration tests now hop in place,
With .env files and setup grace,
Soroban contracts we'll soon embrace,
Through deployment tests we'll find our race! 🌟

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'Feat/sdk integration tests' clearly summarizes the main change - introduction of integration tests for the SDK.
Linked Issues check	✅ Passed	The PR successfully implements integration tests that interact with a local Soroban node, excludes them from standard test runs via vitest config, and configures environment-based setup as required by #165.
Out of Scope Changes check	✅ Passed	All changes are directly related to setting up integration tests for the SDK as specified in issue #165; no out-of-scope modifications detected.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Review rate limit: 0/1 reviews remaining, refill in 60 minutes.}

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[drips-wave]

@Babigdk 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