Initial commit: Deal orchestration tool - Freeze-resistant arbitrage loop

- Implemented complete arbitrage loop (Steps 0-4)
- Risk control service with hard caps (30% LTV, 25% USDTz exposure)
- Progressive redemption testing (0k → 50k → cd /home/intlc/projects/proxmox/dbis_core/src/core/defi/arbitrage && git commit -m "Initial commit: Deal orchestration tool - Freeze-resistant arbitrage loop

- Implemented complete arbitrage loop (Steps 0-4)
- Risk control service with hard caps (30% LTV, 25% USDTz exposure)
- Progressive redemption testing ($50k → $250k → $1M+)
- Graceful failure handling and state management
- CLI interface and programmatic API
- Comprehensive documentation

Features:
- Capital split into three buckets (Core ETH, Working Liquidity, Opportunistic)
- ETH wrapping and collateral supply
- USDT borrowing at controlled LTV
- Discount arbitrage execution
- Partial monetization with redemption testing
- Loop closing with profit capture

Design Principles:
- One-way risk only
- Anchor asset (ETH) untouchable
- No leverage on discounted assets
- Independent leg settlement"M+)
- Graceful failure handling and state management
- CLI interface and programmatic API
- Comprehensive documentation

Features:
- Capital split into three buckets (Core ETH, Working Liquidity, Opportunistic)
- ETH wrapping and collateral supply
- USDT borrowing at controlled LTV
- Discount arbitrage execution
- Partial monetization with redemption testing
- Loop closing with profit capture

Design Principles:
- One-way risk only
- Anchor asset (ETH) untouchable
- No leverage on discounted assets
- Independent leg settlement

README.md

@@ -0,0 +1,150 @@
+# Deal Orchestration Tool
+
+**Freeze-Resistant, Capital-Preserving Arbitrage Loop**
+
+A sophisticated TypeScript-based deal orchestration tool that executes freeze-resistant arbitrage loops designed to preserve capital even when individual legs fail. Built for ChainID 138 (SMOM-DBIS-138) with ETH/WETH, USDT/cUSDT, and discounted USDTz.
+
+## 🎯 Quick Start
+
+```bash
+# Install dependencies (from parent workspace)
+pnpm install
+
+# Execute a deal via CLI
+node cli.js execute \
+  --totalEthValue 10000000 \
+  --participantBankId BANK001 \
+  --moduleId MODULE001
+```
+
+## 📖 Documentation
+
+For comprehensive documentation, see **[README_SUBMODULE.md](./README_SUBMODULE.md)** which includes:
+- Complete architecture overview
+- Detailed step-by-step loop explanation
+- Risk control mechanisms
+- Failure scenario handling
+- API reference
+- Configuration guide
+
+## 🏗️ Architecture
+
+```
+arbitrage/
+├── types.ts                      # Type definitions
+├── config.ts                     # ChainID 138 configuration
+├── risk-control.service.ts       # Risk validation & enforcement
+├── step-execution.service.ts     # Step implementations (0-4)
+├── redemption-test.service.ts    # Progressive redemption testing
+├── deal-orchestrator.service.ts  # Main orchestrator
+├── cli.ts                        # CLI interface
+└── index.ts                      # Exports
+```
+
+## 🔒 Design Principles
+
+1. **One-Way Risk Only**: Redemption is upside, not critical for principal recovery
+2. **Anchor Asset Untouchable**: ETH/WETH (50%) never touched in risky operations
+3. **No Leverage on Discounted Assets**: USDTz never borrowed against
+4. **Independent Leg Settlement**: Each leg can settle independently
+
+## 🔄 The Arbitrage Loop
+
+### STEP 0: Capital Split
+- 50% Core ETH (untouchable)
+- 30% Working Liquidity
+- 20% Opportunistic USDTz
+
+### STEP 1: Generate Working Liquidity
+- Wrap ETH → WETH
+- Supply as collateral
+- Borrow USDT at ≤30% LTV
+
+### STEP 2: Execute Discount Arbitrage
+- Buy USDTz at 40% discount
+- Never pledge or bridge without testing
+
+### STEP 3: Partial Monetization
+- 35% attempt redemption
+- 65% hold cold
+- Progressive testing: $50k → $250k → $1M+
+
+### STEP 4: Close the Loop
+- Repay borrow
+- Unlock ETH
+- Capture profit
+
+## ⚠️ Risk Controls
+
+- **Max LTV**: 30% (hard cap)
+- **Max USDTz Exposure**: <25% of total NAV
+- **No Rehypothecation**: USDTz never used as collateral
+- **Progressive Testing**: Redemption tested incrementally
+
+## 💻 Usage
+
+### CLI
+
+```bash
+node cli.js execute \
+  --totalEthValue 10000000 \
+  --participantBankId BANK001 \
+  --moduleId MODULE001 \
+  --usdtzDiscount 0.40 \
+  --maxLtv 0.30
+```
+
+### Programmatic
+
+```typescript
+import { dealOrchestratorService } from '@/core/defi/arbitrage';
+
+const result = await dealOrchestratorService.executeDeal({
+  totalEthValue: '10000000',
+  participantBankId: 'BANK001',
+  moduleId: 'MODULE001',
+});
+
+console.log('Status:', result.status);
+console.log('Profit:', result.finalProfit?.toString());
+```
+
+## 🛡️ Failure Scenarios
+
+The system gracefully handles:
+- **USDTz Redemption Freezes**: ETH safe, loan healthy, USDTz held as upside
+- **USDT Borrow Market Freezes**: Low LTV allows waiting, no forced unwind
+- **ChainID 138 Congestion**: No cross-chain dependencies, can wait
+
+## 📋 Requirements
+
+- Node.js 16+
+- TypeScript 5.0+
+- Prisma ORM
+- Winston Logger
+- Decimal.js
+
+## 🔗 Token Addresses (ChainID 138)
+
+- **WETH**: `0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2`
+- **WETH10**: `0xf4BB2e28688e89fCcE3c0580D37d36A7672E8A9f`
+- **cUSDT**: `0x93E66202A11B1772E55407B32B44e5Cd8eda7f22`
+- **cUSDC**: `0xf22258f57794CC8E06237084b353Ab30fFfa640b`
+
+## 📝 Notes
+
+- This loop **cannot blow up** unless ETH collapses or LTV discipline is violated
+- USDTz is treated as **a deeply discounted call option, not money**
+- Everything else becomes a **timing issue**, not a solvency issue
+
+## 📚 See Also
+
+- [Comprehensive Documentation](./README_SUBMODULE.md)
+- [ChainID 138 Token Addresses](../../../../docs/11-references/CHAIN138_TOKEN_ADDRESSES.md)
+- [DeFi Swap Service](../sovereign/defi-swap.service.ts)
+
+---
+
+**Version**: 1.0.0  
+**Created**: January 27, 2026  
+**License**: UNLICENSED