Skip to content
 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

325 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Status: Active License: MIT Version: 0.1.0 Soroban SDK: 21.0.0 Rust: stable Platform: Stellar Network Coverage

ApexChainx Smart Contracts

Frequently Asked Questions

What is ApexChainx?

ApexChainx is a smart contract platform built on the Stellar network for deterministic SLA (Service Level Agreement) calculation, payment escrow, and multi-party settlement.

What blockchain does this use?

These contracts run on the Stellar network using the Soroban smart contract platform.

How is SLA calculated?

The contract takes severity level, measured MTTR (Mean Time To Repair), and configured thresholds to determine whether SLA targets were met. Results include status (met/violated), payment type (reward/penalty), and rating.

Can I call contracts directly from the frontend?

No. All contract invocations must go through the backend API layer. The frontend never interacts with contracts directly.

How are contract upgrades handled?

The contract includes a version negotiation protocol (get_version_info()) that allows backends to verify compatibility before deployment.

What stops an operator from spamming the same outage ID?

calculate_sla is idempotent: resubmitting an outage with an unchanged config hash and identical inputs returns the stored result and writes nothing — no history entry, no statistics, no telemetry, no events — so retries are safe and cannot skew reported violation rates. Resubmitting the same outage with different inputs is rejected (DuplicateOutageInput), and a config change opens a new stored generation for that outage, capped at 16 retained entries (OutageRecalcLimit) so one outage cannot crowd others out of the retention window. Admin pruning frees that headroom again.

Is the contract upgradeable?

No. The contract is not natively upgradeable. Upgrades require deploying a new contract and migrating state through the backend.

Soroban-based SLA calculator and multi-contract coordination suite for the Stellar network.

This repository is the execution-layer side of the 3-repo architecture.

Related Repositories

Repository Description
apexchainx-fe Frontend application (React/TypeScript)
apexchainx-be Backend API and contract bridge

Development Setup

Quick Start with Dev Container (#281)

A dev container is provided for GitHub Codespaces and VS Code:

# Open in Codespaces or VS Code — the devcontainer auto-configures:
# - Rust toolchain + wasm32-unknown-unknown target
# - just command runner
# - Node.js + npx for tooling scripts

Local Setup

# Bootstrap the dev environment
just bootstrap

# Run the full CI pipeline locally
just ci

See CONTRIBUTING.md for detailed setup instructions.

Security & Supply Chain

  • Release Artifact Provenance Policy — Guidelines for WASM output checksums and snapshot check-ins.
  • Dependency auditing: cargo audit runs on CI for every push
  • WASM integrity: Release artifacts include SHA-256 manifests
  • Reproducible builds: Local builds can be verified against CI-generated manifests

About

ApexChainx is a smart contract platform built on the Stellar network that enables deterministic SLA calculation, secure payment escrow, and multi-party settlement. Designed for reliability and transparency, ApexChainx simplifies automated service-level enforcement and financial settlement across decentralized participants.

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages