البنية المعماريّة

أربع مراحل ويدٌ واحدة. كل سهمٍ قرار؛ وكل قرارٍ مُسجَّل.

مقيسٌ، لا مُدَّعى

أربعة أرقام من النظام الذي تقرأ هذا عليه.

ما الذي نحرسه

ثلاث مهام. لا شيء آخر يُوعَد به، وهذه الثلاث لا تُوزَّع على غيرنا.

الواجهة

كلّ ما نضعه بجانب محرّكك — كل سطرٍ منه، دون أيّ اعتماديّات أو نداءاتٍ خفيّة. اقرأه قبل أن تدَعه يقترب من مالك. غرفة المحرّك عندنا تبقى مغلقة؛ وما يعمل في بيتك هو لك لتدقّقه.
يبقى الكود بالإنجليزية — اللغة العالمية للتقنية.

# put one engine under guard
POST https://api.matchtopalgorithm.ai/v1/guard/engines
Authorization: MT-••••-••••-••••      — one key, one operation
Content-Type: application/json

{
  "engine":    "eurusd-hf-01",
  "watch":     ["uptime", "latency", "drawdown", "intrusion"],
  "on_breach": { "halt": true, "seal": true, "notify": ["telegram", "email"] },
  "window":    "24/5",
  "clock":     "Asia/Singapore"      — reports arrive in your hour
}

202 Accepted
{
  "guard_id":   "g_7f3a91c4",
  "watchtower": "live",
  "since":      "2026-10-24T06:12:09Z"
}

"""MatchTop · engine guard — the piece that sits beside your engine.
Standard library only. Nothing we did not write runs with these rights."""

import hmac, json, os, time
from hashlib import sha256
from urllib.request import Request, urlopen

KEY   = bytes.fromhex(os.environ["MT_KEY"])   # one key per engine, never on disk
EDGE  = os.environ["MT_EDGE"]                  # no address baked into the build
GRACE = 3                                     # one lost beat is the network. three is a decision.


def seal(payload: bytes, beat: int) -> str:
    """Every beat is signed and numbered. A replayed beat is not a beat."""
    return hmac.new(KEY, b"%d." % beat + payload, sha256).hexdigest()


def read_verdict(answer: dict, beat: int) -> str:
    """An answer counts only if it comes back signed, for this beat and no other."""
    ours = hmac.new(KEY, b"%d.%s" % (beat, answer["verdict"].encode()), sha256).hexdigest()
    if not hmac.compare_digest(ours, answer.get("seal", "")):   # constant time, always
        return "halt"                                          # unsigned is not trusted
    return answer["verdict"]


def pulse(engine, beat: int) -> str:
    payload = json.dumps({
        "engine":   engine.name,
        "at":       time.time_ns(),           # UTC nanoseconds. local clocks lie.
        "alive":    engine.alive,
        "latency":  engine.latency_ms,
        "drawdown": engine.drawdown,
    }, separators=(",", ":")).encode()

    call = Request(EDGE, payload, {
        "Content-Type": "application/json",
        "X-MT-Beat":    str(beat),
        "X-MT-Seal":    seal(payload, beat),
    })
    with urlopen(call, timeout=4) as answer:      # we dial out. nothing dials in.
        return read_verdict(json.load(answer), beat)


def guard(engine) -> None:
    beat, missed = time.time_ns(), 0
    while True:
        beat += 1
        try:
            verdict, missed = pulse(engine, beat), 0
        except Exception:
            missed += 1
            verdict = "halt" if missed >= GRACE else "run"   # silence is not consent

        if verdict == "halt":
            engine.halt()                     # stop the money first
            engine.seal()                     # then close the path
            return                            # and stay down until a human says otherwise

        time.sleep(engine.beat_seconds)

ما لا يمكن نسخه

ليست ميزاتٍ اخترناها. بل شكل البيت نفسه.

لا شيء من ذلك قائمةُ ميزات، ولهذا بالضبط لا يُزاحَم بالسعر. شركةٌ لها صالة مبيعات لا تستطيع أن تمنحك مهندسها. وشركةٌ عليها أن تنمّي فاتورتها كلّ عام لا تستطيع أن تُخرِج شيئًا. وشركةٌ لا تفعل إلا المراقبة لا تستطيع أن تصلح. هم ليسوا خلفنا — بل مبنيّون على نحوٍ مختلف، ولا يمكنهم العبور إلى هنا دون أن يكفّوا عن كونهم أنفسهم.

ولهذا أيضًا لا توجد قائمة أسعار على هذه الصفحة. نقيس العمليّة أولًا، ثم نسعّر ما قِسناه.