README.md

metadata

title: Membra Liquidity Automation
emoji: 💧
colorFrom: blue
colorTo: green
sdk: docker
pinned: false
license: mit

Membra Liquidity Automation Aggregator + Windsurf Bridge

Generated: 2026-06-11T01:15:09+00:00

This is a local-first automation/control plane for a 24/7 liquidity loop.

It is not a live trading bot. It is not a Gate.io executor. It does not place orders. It does not store private keys. It does not upload files.

It aggregates events, risk state, task state, evidence, and strategy/repo audit requirements, then emits Windsurf-ready implementation packets and hash-chained receipts.

What it solves

Your 24/7 liquidity loop needs a supervisor that can continuously answer:

• What should be monitored?
• What changed?
• What is unsafe?
• Which repo/module needs a patch?
• Which task should Windsurf implement next?
• Which order path is unguarded?
• Which capital loop step requires human approval?
• Which evidence packet proves the system state?

This project creates that supervisor layer.

Architecture

event sources
  -> automation aggregator
  -> risk governor
  -> liquidity loop state machine
  -> receipt ledger
  -> windsurf bridge packet builder
  -> human-reviewed repo patching in Windsurf

Main capabilities

• SQLite event/receipt/task ledger
• Hash-chained receipts
• Local HTTP API
• CLI
• Dry-run by default
• Risk-state gate
• Emergency halt gate
• Windsurf packet generator
• Liquidity loop finite-state machine
• Secret redaction helpers
• JSONL-style event ingestion
• Markdown implementation packets

Quick start

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

python3 -m membra_liquidity_agg init
python3 -m membra_liquidity_agg ingest --kind market_signal --source manual --payload '{"symbol":"SOL_USDT","note":"observe only"}'
python3 -m membra_liquidity_agg loop-step
python3 -m membra_liquidity_agg build-windsurf-packet --goal "Guard all Gate.io order paths and verify 24/7 liquidity loop safety"
python3 -m membra_liquidity_agg serve --host 127.0.0.1 --port 8787

API

• GET /health
• POST /events
• GET /events
• POST /loop/step
• GET /loop/state
• POST /windsurf/packet
• GET /receipts
• POST /halt
• POST /resume

Safety default

The system starts in dry-run/control-plane posture.

To integrate with real trading later, do not put exchange credentials here. Add a separate guarded executor process and expose only a safe command surface that rejects unsafe actions.