openclaw/agents/stock/workspace/scripts/orders/ledger.py

"""
Append-only 주문 ledger.

state/order_log.jsonl 에 매매 모든 라이프사이클(card_issued, pin_issued, approved,
rejected, expired, canceled, submitted, filled, partial, failed, dryrun)을 KST 타임스탬프와
함께 한 줄씩 기록한다. 토큰·시크릿 평문 기록을 차단한다.
"""

from __future__ import annotations

import hashlib
import json
import os
from datetime import datetime, timezone, timedelta
from pathlib import Path
from typing import Optional

WORKSPACE_ROOT = Path(__file__).resolve().parent.parent.parent
LIMITS_FILE = Path(__file__).resolve().parent / 'limits.json'

KST = timezone(timedelta(hours=9))


def _load_limits() -> dict:
    return json.loads(LIMITS_FILE.read_text(encoding='utf-8'))


def _ledger_path() -> Path:
    return WORKSPACE_ROOT / _load_limits()['ledger']['log_file']


def _now_iso() -> str:
    return datetime.now(KST).isoformat()


def _mask(value: str, keep: int = 4) -> str:
    if not value:
        return '***'
    s = str(value)
    if len(s) <= keep:
        return '***'
    return s[:keep] + '*' * (len(s) - keep)


def _scrub_secrets(payload: dict) -> dict:
    out = {}
    for k, v in payload.items():
        kl = k.lower()
        if any(s in kl for s in ('token', 'secret', 'pin', 'password', 'appkey', 'appsecret')):
            out[k] = _mask(v, 2) if v is not None else None
        elif isinstance(v, dict):
            out[k] = _scrub_secrets(v)
        elif isinstance(v, list):
            out[k] = [_scrub_secrets(x) if isinstance(x, dict) else x for x in v]
        else:
            out[k] = v
    return out


def append(event: str, payload: dict) -> None:
    limits = _load_limits()
    allowed = set(limits['ledger']['events'])
    if event not in allowed:
        raise ValueError(f'unknown ledger event: {event}')
    safe_payload = _scrub_secrets(payload) if limits['ledger']['mask_token_in_logs'] else payload
    record = {'ts': _now_iso(), 'event': event, 'payload': safe_payload}
    path = _ledger_path()
    path.parent.mkdir(parents=True, exist_ok=True)
    with path.open('a', encoding='utf-8') as f:
        f.write(json.dumps(record, ensure_ascii=False) + '\n')
    try:
        os.chmod(path, 0o600)
    except OSError:
        pass


def idempotency_hash(account: str, symbol: str, side: str, qty: int, price: int | str) -> str:
    """동일 (계좌·종목·방향·수량·가격) 60초 윈도우 중복 주문 차단용 해시."""
    minute = int(datetime.now(KST).timestamp() // 60)
    key = f'{account}|{symbol}|{side}|{qty}|{price}|{minute}'
    return hashlib.sha256(key.encode('utf-8')).hexdigest()[:16]


# 멱등성 매칭 대상 — **이중 발주 위험이 실재하는 이벤트만** 본다.
#   submitted : 키움이 접수했다 (확정)
#   failed    : 네트워크 에러 — 나갔는지 모른다 (가장 위험, 반드시 차단)
# rejected(브로커 거부·idem 중복)·dryrun 은 접수되지 않은 게 확정이라 재시도를 막지 않는다.
# ⚠️ 이게 없으면 키움이 거부한 직후 같은 주문을 다시 내는 게 90초간 IDEMPOTENCY_DUP 으로
#    막혀, 관리자님이 영문 모를 두 번째 실패를 본다 (2026-09-21 SOR 스톱 거부 때 실측).
IDEM_MATCH_EVENTS = ('submitted', 'failed')


def find_recent_idempotency(h: str, within_seconds: int = 90) -> Optional[dict]:
    path = _ledger_path()
    if not path.exists():
        return None
    cutoff = datetime.now(KST) - timedelta(seconds=within_seconds)
    with path.open('r', encoding='utf-8') as f:
        lines = f.readlines()
    for line in reversed(lines):
        line = line.strip()
        if not line:
            continue
        try:
            rec = json.loads(line)
            ts = datetime.fromisoformat(rec['ts'])
        except (ValueError, KeyError):
            continue
        if ts < cutoff:
            return None
        if (rec.get('event') in IDEM_MATCH_EVENTS
                and rec.get('payload', {}).get('idem_hash') == h):
            return rec
    return None


def last_event_for_symbol(account: str, symbol: str, events: tuple[str, ...] = ('submitted', 'filled', 'partial')) -> Optional[dict]:
    """동일 종목 딜레이 계산을 위해 가장 최근 '실주문 접수 이후' 매칭 이벤트를 반환.

    rejected/canceled/expired/failed 는 키움 접수 전 실패이므로 쿨다운 대상 아님.
    """
    path = _ledger_path()
    if not path.exists():
        return None
    with path.open('r', encoding='utf-8') as f:
        lines = f.readlines()
    for line in reversed(lines):
        line = line.strip()
        if not line:
            continue
        try:
            rec = json.loads(line)
        except ValueError:
            continue
        if rec.get('event') not in events:
            continue
        p = rec.get('payload', {})
        if p.get('account') == account and p.get('symbol') == symbol:
            return rec
    return None


def last_terminal_event(events: tuple[str, ...] = ('submitted', 'filled', 'partial')) -> Optional[dict]:
    """전체 거래 간 60초 딜레이 계산을 위해 가장 최근 '실주문 접수 이후' 이벤트를 반환.

    rejected/canceled/expired/failed 는 키움 접수 전 실패이므로 쿨다운 대상 아님.
    """
    path = _ledger_path()
    if not path.exists():
        return None
    with path.open('r', encoding='utf-8') as f:
        lines = f.readlines()
    for line in reversed(lines):
        line = line.strip()
        if not line:
            continue
        try:
            rec = json.loads(line)
        except ValueError:
            continue
        if rec.get('event') in events:
            return rec
    return None