Document single-sided Liq AMM design and original diagrams

README.md

@@ -0,0 +1,25 @@
+# Liq single-sided-funded AMM
+
+Design workspace for native-mainnet **ETH/LiqETH** and **SOL/LiqSOL** swap pools funded by single-sided native-asset deposits.
+
+**Status:** proposed design; no contracts implemented or deployment performed.
+
+## Core idea
+
+An LP deposits native assets. Liq specially mints matching LIQ inventory into the AMM and records a mint liability against the LP position. Trading changes the reserve composition. On withdrawal, the position settles its allocated liability before returning the residual assets to the LP.
+
+The diagrams also propose periodic yield-support payments from the AMM to Liq, triggered by a crank, and a post-swap solvency check.
+
+## Project contents
+
+- [Design and worked examples](docs/design.md)
+- [Open design questions](docs/open-questions.md)
+- [Original diagram index](diagrams/README.md)
+
+The Ethereum examples establish the proposed economic model. Solana needs its own implementation treatment for mint authority, Token-2022 share/transfer-hook accounting, reward distribution and withdrawal receipts.
+
+## Source basis
+
+Initial design supplied by Kyle on November 6, 2026 through four diagrams. Review consulted Wire-context MCP summaries for `wire-ethereum` and `capital-staking`; these are dated source descriptions, not verification of current deployments or implementation of this proposed AMM.
+
+No framework or contract language has been selected for this workspace yet.