Skip to content

Releases: StellarClear/stellarclear-app

v0.1.1 - Hardened SettlementRegistry Integration & Testnet Reconciliation

Choose a tag to compare

@smog123 smog123 released this 06 Oct 10:25
f38e126

Release Provenance

  • Application Commit: f38e126f69572b45c48071db359726aedd4d17f6
  • Application Release Tag: v0.1.1
  • Active Hardened Contract ID: CCPCMPIUTKBLSJVSGPPSUHTBBY6HHT3OTE3CKUXC5BD2B3YEDSAROGC5
  • Contract Release: v0.1.1 (Commit: 2032666be97e8bf09ba9073952041ae3e4573ff1)
  • Contract WASM SHA-256: 0073a4cb2027140ac34e4db6c64c2d4104590ec60cf0ef2e424909eba9ae36ac (32,773 bytes)
  • Historical Prototype: CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC (v0.1.0 prototype provenance preserved)

Major Protocol Integration Changes

  • Hardened Contract Integration: Deployed and pinned the authoritative v0.1.1 Soroban SettlementRegistry contract on Stellar Testnet (CCPCMPIUTKBLSJVSGPPSUHTBBY6HHT3OTE3CKUXC5BD2B3YEDSAROGC5, ledger 5048699).
  • Observer Quorum Verification: Complete typed SDK, API, and contract support for pure M-of-N threshold observer quorum (setCaseQuorum, getCaseQuorum, submitObserverAttestation, getAttestedObservers) with historical attestation persistence and revocation safety.
  • Dispute State Machine & Expiration TTL: Strict BREAK-only dispute entry, two-party matching resolution enforcement, custom dispute TTL support (openDisputeWithTtl, getDisputeExpiration, expireDispute), and indexer ingestion of DisputeExpired events.
  • Real-Time Streaming Indexer: WebSocket contract event streaming with atomic cursor failure isolation, bounded replay buffer, and database fallback.
  • Transaction Hash Integrity: Strict 64-character hex transaction hash extraction eliminating simulated hashes from production paths.

Testnet Verification & Evidence

All 7 required lifecycle flows executed directly against CCPCMPIUTKBLSJVSGPPSUHTBBY6HHT3OTE3CKUXC5BD2B3YEDSAROGC5 on Stellar Testnet:

  • Flow A (Match Path): Finalization confirmed on-chain in tx a488dd6ae980fb7c36734b9fe7d9132955a6b480bcaf4da7b6883bdf75057081 (ledger 5049439).
  • Flow B (Negative Quorum): Rejection with ObserverQuorumNotMet (Error #19) verified when 2 of 3 required observers attested.
  • Flow C (Pure M-of-N): Quorum satisfied and finalization confirmed on-chain in tx 874217b5f3ed23ad80d245be9e87bdef767eb0229495b562d04ff19902db4869 (ledger 5049470) without the initial observation observer.
  • Flow D (Historical Attestation Survival): Attestation recorded in tx a8ded3bd0726c7105d580aff9f338278d15f3a300fbc70f4e7e0160363acdb54 (ledger 5049285) survived observer revocation in tx 0a3620f61afb0b991cb79cb079586b0ea8bb147e7d42fe9091254c9ec43f09b6 (ledger 5049287).
  • Flow E (Dispute & Mutual Resolution): State preserved as Disputed after 1st resolution (55e7dccab63ca6da7d076e49a9024322d271447f4245f3dbb9e99076bebb5a24, ledger 5049489), transitioned to Resolved after 2nd matching resolution (0f9018a6fbc577c765c6701e3d81781fa44ba702c5cd2d59cff25f451c7955e7, ledger 5049491).
  • Flow F (Dispute Expiration with Custom TTL): Custom TTL of 120 ledgers recorded on-chain in tx cdaa30dc13c314117cf3cadde1d375b3d27309a81188b4a393b7a0e33c5c0552 (ledger 5049500); premature expiration blocked with DisputeNotExpired (Error #20).
  • Flow G (Finalized Immutability): Mutation attempts on finalized case blocked on-chain with CaseAlreadyFinalized (Error #7).

Verification Results

  • Full automated test suite: 234 / 234 pass (100%).
  • Security & adversarial regression suites: 28 / 28 pass (100%).
  • Soroban integration suites: 43 / 43 pass (100%).
  • Release readiness verification: 8 / 8 checks pass (100%).
  • GitHub Actions CI: 6 / 6 workflows green.

Known Post-Release Enhancements (Non-Blockers)

  • Issue #18: Prometheus-compatible metrics endpoint for operational telemetry.
  • Issue #19: Exponential backoff and jitter for indexer RPC recovery.

v0.1.0 - Initial Protocol Release

Choose a tag to compare

@smog123 smog123 released this 01 Oct 13:52

StellarClear Protocol v0.1.0

Initial release of the StellarClear application monorepo, including API service, settlement indexer, matching engine, and SDK.

Deployed Soroban Contracts (Testnet)

  • SettlementRegistry: CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC

Associated Contract Repository