smom-dbis-138/docs/hybx-omnl

HYBX OMNL documentation

Multi-chain instrument registry, reserve commitments, compliance core, IPSAS-aligned GL reporting, and optional CCIP mirror to ALL Mainnet (651940).

Document	Purpose
HYBX_OMNL_POLICY_SPEC.md	On-chain policy math (1.2× M0, 5× M1) and limits
DEPLOYMENT_CHECKLIST.md	Contracts, env, API, verification
CCIP_MIRROR_FLOW.md	Primary → mirror CCIP payload and roles
OMNL_IPSAS_API.md	REST routes for compliance + IPSAS / Fineract GL
OMNL_RECONCILE_CRON_AND_CI.md	Anchor hash: cron, omnl-reconcile-artifact.sh, CI artifacts
EXTERNAL_AUDIT_CHECKLIST.md	Third-party audit scope checklist
OPERATIONAL_COMPLIANCE.md	Webhooks, logs, break-glass, data minimization
RUNBOOK_CIRCUIT_BREAKERS.md	Circuit breaker operations
SECURITY_THREAT_MODEL.md	Threat notes
ZK_INTEGRATION.md	Optional ZK reserve proof verifier hook

Configuration: config/hybx-omnl-policy.json, config/hybx-omnl-cross-chain-lines.json, config/omnl-ipsas-gl-registry.json, config/omnl-journal-matrix.json, config/deployment-omnl.example.env.

Contracts: contracts/hybx-omnl/. Tests: pnpm run forge:test:omnl or bash scripts/forge/scope.sh test hybx-omnl. Full check: pnpm run omnl:verify (repo root). Anchor files: pnpm run omnl:reconcile:artifact.

GitHub Actions: .github/workflows/hybx-omnl-ts.yml (TypeScript build + anchor on PR/push), .github/workflows/omnl-reconcile.yml (weekly anchor + CI meta); both support workflow_dispatch. Publish snapshot smom-dbis-138-publish/ uses the same workflows; Forge-heavy checks run in the main repo only (pnpm run omnl:verify).

Scripts: bash scripts/hybx-omnl/sync-to-publish.sh (mirror OMNL paths to publish tree), node scripts/hybx-omnl/validate-cross-chain-config.mjs (JSON shape + addresses for hybx-omnl-cross-chain-lines.json).