Problem Statement
The test suite runs entirely in an emulated Env::default() host —
isolated from real network conditions (RPC quirks, real Stellar Asset
Contract, real Soroban host behavior).
Why it matters
Soroban tests are deterministic but they are not exhaustive of host
behaviour. Fork tests against testnet catch issues like: actual
symbol_short truncations, real reclaim gas costs, host-side authorization
verification.
Technical Context
Soroban fork testing is supported natively in soroban-sdk 22.x via
the test_snapshot infrastructure.
Expected Outcome
A tests/fork.rs that pulls from testnet RPC, applies the local
TipContract Wasm against real state, and asserts the same set of
invariants as the unit tests but in a fork-mode environment.
Acceptance Criteria
Files/Modules Likely Affected
tests/fork.rs (new)
.github/workflows/ci.yml
Cargo.toml
README.md
Difficulty Hard. Estimated Effort L.
Labels
area:testing, priority:medium
Imported from docs/open-issues-draft.md as draft issue #28 (commit 7becd4b). Original draft-order cross-references in this body have been remapped to current GitHub issue numbers at import time.
Problem Statement
The test suite runs entirely in an emulated
Env::default()host —isolated from real network conditions (RPC quirks, real Stellar Asset
Contract, real Soroban host behavior).
Why it matters
Soroban tests are deterministic but they are not exhaustive of host
behaviour. Fork tests against testnet catch issues like: actual
symbol_short truncations, real reclaim gas costs, host-side authorization
verification.
Technical Context
Soroban fork testing is supported natively in
soroban-sdk22.x viathe
test_snapshotinfrastructure.Expected Outcome
A
tests/fork.rsthat pulls from testnet RPC, applies the localTipContract Wasm against real state, and asserts the same set of
invariants as the unit tests but in a fork-mode environment.
Acceptance Criteria
cargo test --features forklocally.Files/Modules Likely Affected
tests/fork.rs(new).github/workflows/ci.ymlCargo.tomlREADME.mdDifficulty Hard. Estimated Effort L.
Labels
area:testing,priority:mediumImported from
docs/open-issues-draft.mdas draft issue #28 (commit7becd4b). Original draft-order cross-references in this body have been remapped to current GitHub issue numbers at import time.