feat(contract): expose version() view function on PaymentRouter

[abrak01]

Summary

Adds a version() read-only function to the PaymentRouter Soroban smart contract. The UI and any integration client can call this before submitting transactions to confirm they are talking to a compatible deployment.

---

Implementation

const CONTRACT_VERSION: &str = "1.0.0";

pub fn version(env: Env) -> String {
    String::from_str(&env, CONTRACT_VERSION)
}

• CONTRACT_VERSION is a compile-time constant following MAJOR.MINOR.PATCH semver:
  • MAJOR — breaking change to the public interface
  • MINOR — backwards-compatible new function or behaviour
  • PATCH — internal fix with no interface change
• version() is a pure view function — no ledger writes, costs only the base invocation fee.
• To bump for a future release, update CONTRACT_VERSION in src/lib.rs and redeploy. No storage migration is needed.

---

Acceptance criteria

• Exposes a version() view function
• Returns a string version ("1.0.0")

Tests

Two unit tests added in src/lib.rs:

Test	What it verifies
test_version_returns_expected_string	Return value equals String::from_str(&env, CONTRACT_VERSION) — constant and function can never drift apart
test_version_is_non_empty	Return value length > 0 — guards against accidental empty string

Run with:

cd payment_router
cargo test --features testutils

---

Closes #260
Closes #269

[vercel]

@abrak01 is attempting to deploy a commit to the Abdulazeem's projects Team on Vercel.

A member of the Team first needs to authorize it.

[drips-wave]

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

[Abdulazeem-code]

Resolve conflicts and failed checks

[Abdulazeem-code]

Please resolve conflicts

[Abdulazeem-code]

Kindly resolve conflicts

[abrak01]

Conflicts has been resolve

…

On Sat, Oct 3, 2026 at 1:04 PM Abdulazeem ***@***.***> wrote: *Abdulazeem-code* left a comment (Abdulazeem-code/stellar-tags#807) <#807 (comment)> Kindly resolve conflicts — Reply to this email directly, view it on GitHub <#807?email_source=notifications&email_token=A6Y6RIV3TEVDFSXDOOXT3ET5SDTMZA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTKOJWHA4TONZXGY42M4TFMFZW63VHNVSW45DJN5XKKZLWMVXHJLDGN5XXIZLSL5RWY2LDNM#issuecomment-5968977769>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/A6Y6RIT2VWMSNM2LKK6UYT35SDTMZAVCNFSNUABGKJSXA33TNF2G64TZHMYTEMZQGI3DGMZWGI5US43TOVSTWNJVHA2TQOBVGMYTPILWAI> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/A6Y6RISKYQQMMFRMHLXLE335SDTMZA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTKOJWHA4TONZXGY42M4TFMFZW63VHNVSW45DJN5XKKZLWMVXHJKTGN5XXIZLSL5UW64Y> and Android <https://github.com/notifications/mobile/android/A6Y6RIWKTVTITN76YQA2NYT5SDTMZA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTKOJWHA4TONZXGY42M4TFMFZW63VHNVSW45DJN5XKKZLWMVXHJLTGN5XXIZLSL5QW4ZDSN5UWI>. Download it today! You are receiving this because you were mentioned.Message ID: ***@***.***>