[ranjan1969x]

Summary

Enforces party distinction on escrow creation by rejecting payer == beneficiary with a new Error::InvalidParties (#22), documents the single-use ID and persistent storage retention rules in contracts/README.md, and synchronizes TypeScript shared error codes and client enums.

Changes

• Smart Contract (contracts/payment_escrow/src/lib.rs):
  • Added InvalidParties = 22 variant to pub enum Error.
  • Added validation check if payer == beneficiary { return Err(Error::InvalidParties); } to create.
• Documentation (contracts/README.md):
  • Added InvalidParties (#22) to the Error Codes table.
  • Documented Parties Validation and ID Uniqueness Rules (IDs are single-use for the entire lifetime of the contract; resolved escrows permanently retain their storage entry to prevent ID reuse and guarantee idempotency).
• TypeScript Integration:
  • Updated contracts/shared/error-codes.ts with InvalidParties = 22 and name mapping.
  • Updated ContractError enum in backend/src/payments/soroban/escrow-contract.client.ts.
• Tests:
  • Added unit test identical_payer_and_beneficiary_is_rejected in contracts/payment_escrow/tests/edge_cases.rs.
  • Added unit test id_reuse_after_release_is_rejected verifying that re-creating an escrow with a released ID is rejected with AlreadyExists.

Verification

• cargo test --workspace (31/31 contract tests passing, 100% green)
• npm test -- src/payments/soroban/ (9 test suites passed, 78/78 tests green)

Closes #2003

[vercel]

@ranjan1969x is attempting to deploy a commit to the naijabuz's projects Team on Vercel.

A member of the Team first needs to authorize it.