CLRTY-1-ALE-Atomic-Liquidity

CLRTY-1 Atomic Liquidity Engine — Signal → 1inch Fusion → USDT settlement
CLRTY-1 (chain 1202) service · TypeScript/Node · Creator Chandler William Ferguson
Org clarity-fintech/CLRTY-1-ALE-Atomic-Liquidity · package @clarity-fintech/clrty-ale-atomic-liquidity

This repository is self-contained and downloadable: clone it, install once, and it builds, tests, and runs against CLRTY-1 with the scripts documented below.

Contents

• What this is

• Quickstart

• Command reference

• Architecture

• Configuration

• HTTP surface

• Testing

• CLRTY-1 integration

• Security

• MIS kernel binding

• Backlinks

Related MCP server: near-intent-swaps

What this is

CLRTY-1-ALE-Atomic-Liquidity — CLRTY-1 Atomic Liquidity Engine — Signal → 1inch Fusion → USDT settlement

• Language: TypeScript (ES modules), entry dist/server.js

• Runtime: Node.js ≥ 18, HTTP service via express

• Settlement context: CLRTY-1 / chain 1202

Quickstart

git clone https://github.com/clarity-fintech/CLRTY-1-ALE-Atomic-Liquidity
cd CLRTY-1-ALE-Atomic-Liquidity
npm install
npm run build          # compile TypeScript -> dist/
cp .env.example .env         # then edit the values (see Configuration)
npm run dev            # hot-reload dev server
npm start              # run the built service

Command reference

Architecture

Source lives in src/. Module-by-module:

Configuration

Copy .env.example to .env and set:

HTTP surface

The service starts an HTTP server (see src/server.ts). Route handlers are defined in the modules listed under Architecture; start it with npm start (or npm run dev) and call it over the port configured in your .env.

Testing

npm test               # unit tests (vitest)
npm run smoke          # CLRTY-1 connectivity smoke test
CLRTY_LIVE=1 npm run test:live   # live CLRTY-1 integration

Test files: tests/ale.test.ts, tests/clrty1_live.test.ts, tests/smoke.test.ts

CLRTY-1 integration

• src/clrty1.ts holds the CLRTY-1 client (chain 1202), used by the service to read settlement context and submit/observe activity.

• Configure the endpoint via the .env values above; the smoke script verifies reachability.

Networks — all clusters share chain clrty-1 / 1202 and a ~400 ms confirmation/finality cap (CLRTY1_NETWORKS / CLRTY1_FINALITY_CAP_MS in src/clrty1.ts):

Security

• security/CHECKLIST.md — pre-deploy security checklist.

• security/ebpf/ — eBPF settlement-path filters (settlement_path.bpf.c, filters.yaml).

MIS kernel binding

This service is bound into the MIS substrate: see MIS_KERNEL.md and manifests/mis_kernel.json. It settles on the same CLRTY-1 / chain 1202 network as the MIS .mis modules, compiled by the CLRTY-MIS-Kernel misc compiler.

Backlinks

• clarity-fintech/CLRTY-MIS-Kernel — MIS misc compiler & kernel

• clarity-fintech/moniversive_invariant_static_ML — MIS language root

• clarity-fintech/CLRTY-1-ALE-Atomic-Liquidity — this repository

CLRTY-1 (chain 1202) · Creator Chandler William Ferguson