docs(reorg): rename DEX_P2P -> DEX_P2P_FiatOnOff; dissolve dApp/Betting

- Parameters/DEX_P2P -> Parameters/DEX_P2P_FiatOnOff (git mv, 5 files) — the folder is the P2P fiat on/off-ramp + order-book material, so the name now says what it is.
- dApp/Betting dissolved: its subfolders lifted one level into dApp/ (Pari_P2P via git mv; the parallel session's untracked Pari_escrow via filesystem mv; Tote had already been lifted by that session). Empty Betting folder removed.

Swept references with a FILESYSTEM grep rather than git grep, so untracked parallel files were covered too. Used the trailing-slash path form (DEX_P2P/ -> DEX_P2P_FiatOnOff/) so the substitution can't double-apply to the new name. Memory checked.

Verified: all 527 links resolve.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Local Dev 2026-07-19 22:56:43 +02:00
parent a701a3ec01
commit 3a6d6736bc
27 changed files with 10 additions and 10 deletions

View file

@ -33,7 +33,7 @@ not ASM ([`../ASM_DEX_Taxonomy.md`](../ASM_DEX_Taxonomy.md)).*
|---|---|
| [`../../ASM_CrossChain/T6_BitcoinCash_LN/`](../../ASM_CrossChain/T6_BitcoinCash_LN/) | The **BTC↔BCH** track. Its HTLC swap-in *is* an atomic swap, but T6 is a coherent track (channels, Model-3 BTC-IOU, M3-bond, the "escape the channel, swap into on-chain" thesis) — splitting the swap chapter out would fragment it. See `btc-on-bch-rails_test-program.md` + `T6_BTC-BCH_complete-record.md`. |
| [`../../ASM_CrossChain/Chains/cross-chain-send-receive_chain-landscape.md`](../../ASM_CrossChain/Chains/cross-chain-send-receive_chain-landscape.md) | The **List A vs List B** chain/asset landscape — which chains can do HTLCs at all. Covers both rails, so it belongs with the cross-chain landscape. |
| [`../../DEX_P2P/dex-architecture.md`](../../DEX_P2P/dex-architecture.md) · [`../../DEX_P2P/bch-dex-development.md`](../../DEX_P2P/bch-dex-development.md) | The order book / matching engine. The ramp doc is their companion — it is the *boundary* mechanism, deliberately quarantined from the matching engine. |
| [`../../DEX_P2P_FiatOnOff/dex-architecture.md`](../../DEX_P2P_FiatOnOff/dex-architecture.md) · [`../../DEX_P2P_FiatOnOff/bch-dex-development.md`](../../DEX_P2P_FiatOnOff/bch-dex-development.md) | The order book / matching engine. The ramp doc is their companion — it is the *boundary* mechanism, deliberately quarantined from the matching engine. |
| [`../../ASM_CrossChain/ASM-Multichain.md`](../../ASM_CrossChain/ASM-Multichain.md) | The **opposite** cell (lock→oracle→mint IOU). Referenced for contrast. |
## How to add here

View file

@ -1,8 +1,8 @@
# Cross-Chain HTLC Entry Ramp — Development Document
The engineering spec for the **HTLC swap ramp**: the bidirectional, trustless, ownership-crossing on/off-ramp between BCH-native assets and external native assets (BTC, LTC, any hashlock-capable chain; EVM via contract). This is the companion to [`bch-dex-development.md`](../../DEX_P2P/bch-dex-development.md) (which specs the order book).
The engineering spec for the **HTLC swap ramp**: the bidirectional, trustless, ownership-crossing on/off-ramp between BCH-native assets and external native assets (BTC, LTC, any hashlock-capable chain; EVM via contract). This is the companion to [`bch-dex-development.md`](../../DEX_P2P_FiatOnOff/bch-dex-development.md) (which specs the order book).
**Scope discipline:** this ramp is an *entry mechanism at the boundary*, **not** part of the matching engine. It exchanges ownership of real assets across chains; it issues no claim and adds no inventory to the book (per [`dex-architecture.md`](../../DEX_P2P/dex-architecture.md) Part II). The matching engine never sees a cross-chain operation — it only ever trades assets already resting on BCH. All cross-chain logic is quarantined here.
**Scope discipline:** this ramp is an *entry mechanism at the boundary*, **not** part of the matching engine. It exchanges ownership of real assets across chains; it issues no claim and adds no inventory to the book (per [`dex-architecture.md`](../../DEX_P2P_FiatOnOff/dex-architecture.md) Part II). The matching engine never sees a cross-chain operation — it only ever trades assets already resting on BCH. All cross-chain logic is quarantined here.
---
@ -97,7 +97,7 @@ State baked into the covenant: `(H, claimerPubKey, depositorPubKey, T)`.
| **EVM (ETH, USDC, etc.)** | an HTLC *contract* (hashlock + `block.timestamp` deadline) | heavier (gas, a deployed contract), but standard; lets USDC/USDT enter |
| **Chains without hashlock + timelock** | **none** | no ramp; do **not** substitute a custodial bridge |
For USDC/USDT specifically (the stated goal of bringing them into BCH): they live on EVM chains, so the counterparty leg is an EVM HTLC contract holding the ERC-20, locked to the same `SHA256(s)`. The BCH leg delivers a BCH-native asset (BCH, or a BCH-native stablecoin, or — via a *separate* subsequent ASM mint — a sovereign unit). The ramp itself only ever swaps *ownership of real assets*; turning incoming value into a sovereign claim is a distinct, later step (see [`dex-architecture.md`](../../DEX_P2P/dex-architecture.md) Part II, and the FIATμ doc).
For USDC/USDT specifically (the stated goal of bringing them into BCH): they live on EVM chains, so the counterparty leg is an EVM HTLC contract holding the ERC-20, locked to the same `SHA256(s)`. The BCH leg delivers a BCH-native asset (BCH, or a BCH-native stablecoin, or — via a *separate* subsequent ASM mint — a sovereign unit). The ramp itself only ever swaps *ownership of real assets*; turning incoming value into a sovereign claim is a distinct, later step (see [`dex-architecture.md`](../../DEX_P2P_FiatOnOff/dex-architecture.md) Part II, and the FIATμ doc).
---
@ -137,7 +137,7 @@ Either way, **the ramp needs a counterparty holding inventory on both chains**
└──────────────────────────┘
```
The ramp ends the moment value is a BCH UTXO. From there it is the order book's job ([`bch-dex-development.md`](../../DEX_P2P/bch-dex-development.md)), and — if the user wants a sovereign backed unit rather than a swapped asset — the ASM mint's job (FIATμ doc). **Three clean stages: cross (HTLC) → optionally mint (ASM) → trade (book). This document is only the first.**
The ramp ends the moment value is a BCH UTXO. From there it is the order book's job ([`bch-dex-development.md`](../../DEX_P2P_FiatOnOff/bch-dex-development.md)), and — if the user wants a sovereign backed unit rather than a swapped asset — the ASM mint's job (FIATμ doc). **Three clean stages: cross (HTLC) → optionally mint (ASM) → trade (book). This document is only the first.**
---
@ -162,4 +162,4 @@ The ramp ends the moment value is a BCH UTXO. From there it is the order book's
| A market maker holding both-chain inventory who fills the swap | **solver** |
| An IOU desk that wraps an asset across chains (avoid) | **bridge** |
(Full decoder in [`dex-architecture.md`](../../DEX_P2P/dex-architecture.md).)
(Full decoder in [`dex-architecture.md`](../../DEX_P2P_FiatOnOff/dex-architecture.md).)

View file

@ -7,7 +7,7 @@
**Entry model:** a bot-controlled **guided form** (buttons + prompts), so every order looks identical.
**Trading layer:** orders carry **inventory** that is reserved by a timed, two-party-confirmed **deal** handshake, with **5-star reputation**, a **cash+city** option, and **fixed or floating** (central-bank ± offset) rates. See §6.
**Relationship:** the stripped-down **catalogue / discovery layer** (§3.1) of
[`Parameters/DEX_P2P/fiat-ramp-product.md`](../DEX_P2P/fiat-ramp-product.md).
[`Parameters/DEX_P2P_FiatOnOff/fiat-ramp-product.md`](../DEX_P2P_FiatOnOff/fiat-ramp-product.md).
**Recent (built after v2, all LIVE — see code for detail):**
- **Full RU + EN i18n** — per-user language (`/language`, auto-offer on first `/start`), 368 keys × 2 locales in `src/locales/{en,ru}.ts`, `src/i18n.ts` `t()`/`plural()`; recipient-language DMs (`dmLang`); `time.ts`/`format.ts` take `lang`. Greek scaffolding not started. Terminology: order→«заявка», Cash→«Наличные» (label only; id stays `Cash`).
@ -499,7 +499,7 @@ Production: `npm run build` → `npm run serve` (`node dist/index.js`).
**Out of scope by design:** escrow, payment oracle / fiat-leg proof, dispute
resolution, reputation, geo/compliance, banking rails — all the engine of
[`fiat-ramp-product.md`](../DEX_P2P/fiat-ramp-product.md). This build is only the
[`fiat-ramp-product.md`](../DEX_P2P_FiatOnOff/fiat-ramp-product.md). This build is only the
directory.
**Candidate extensions** (not built):

View file

@ -34,7 +34,7 @@ See the **“ASM / Orbital Swap / Potidaea / Anthemus”** section of [snapshots
## Specs (`Parameters/`)
- [`Parameters/Anthemus_DEX/ASM_DEX_Taxonomy.md`](../../Parameters/Anthemus_DEX/ASM_DEX_Taxonomy.md) (the ASM-vs-DEX 2×2) · [`Parameters/ASM_Native/Potidaea_OrbitalSwap/`](../../Parameters/ASM_Native/Potidaea_OrbitalSwap/) · [`Parameters/Anthemus_DEX/`](../../Parameters/Anthemus_DEX/) · [`Parameters/DEX_P2P/`](../../Parameters/DEX_P2P/) · [`Parameters/ASM_Native/MBA_Shares/`](../../Parameters/ASM_Native/MBA_Shares/)
- [`Parameters/Anthemus_DEX/ASM_DEX_Taxonomy.md`](../../Parameters/Anthemus_DEX/ASM_DEX_Taxonomy.md) (the ASM-vs-DEX 2×2) · [`Parameters/ASM_Native/Potidaea_OrbitalSwap/`](../../Parameters/ASM_Native/Potidaea_OrbitalSwap/) · [`Parameters/Anthemus_DEX/`](../../Parameters/Anthemus_DEX/) · [`Parameters/DEX_P2P_FiatOnOff/`](../../Parameters/DEX_P2P_FiatOnOff/) · [`Parameters/ASM_Native/MBA_Shares/`](../../Parameters/ASM_Native/MBA_Shares/)
## Code

View file

@ -29,7 +29,7 @@ See the **“Games / Tote / AnyHedge / Pari-mutuel”** section of [snapshots/IN
## Specs (`Parameters/`)
- [`Parameters/dApp/Betting/Pari_P2P/`](../../Parameters/dApp/Betting/Pari_P2P/) · [`Parameters/dApp/CheckersIntegration/`](../../Parameters/dApp/CheckersIntegration/)
- [`Parameters/dApp/Pari_P2P/`](../../Parameters/dApp/Pari_P2P/) · [`Parameters/dApp/CheckersIntegration/`](../../Parameters/dApp/CheckersIntegration/)
## Code