r35157/com_r35157_nenjim-hubd-impl_ref
0
0
Fork 0
Code Issues 18 Pull Requests Actions Packages Projects Releases Wiki Activity

100: Add Perps collateral, leverage, value, uPnL and gross-exposure totals in EMC

Browse Source
This commit is contained in:
minimons
2026-10-24 14:52:12 +02:00
parent 7e36b7ef95
commit bcb6b435f2
29 changed files with 8965 additions and 180 deletions
Download Patch File Download Diff File Expand all files Collapse all files
openspec/changes/100-perps-capital-and-risk/proposal.md
+29
View File
@@ -0,0 +1,29 @@
# Proposal
## Why
The owner cannot assess Evelyn's committed capital and risk from direction and size alone. Issue #100 adds a first inspectable, read-only valuation overview for existing wallets, directly supporting safe Evelyn operation.
## What Changes
- Show Position, Direction, Margin, Collateral, Leverage, Exposure, Value and uPnL beneath a visible Perpetual Contracts root.
- **BREAKING**: Extend snapshot and Phoenix result record contracts to represent shared Cross accounts separately from isolated positions, retaining funded empty Cross accounts.
- Publish precise venue valuations and complete gross exposure, dollar uPnL and closing-value totals without counting shared capital twice. Unsupported metrics remain explicitly unavailable.
- Add an overview-only Jupiter REST reader; preserve the existing trading, signing, alarm and entry-price integration.
- Preserve background refresh timing, independent last-success retention, immutable snapshots and stable UI reconciliation; explain retained or incomplete data.
## Capabilities
### New Capabilities
- `jupiter-perps-overview`: Validated read-only Jupiter position metrics, independent of transaction operations.
### Modified Capabilities
- `evelyn-perps-service`: Account-aware immutable metrics and complete, field-specific aggregation with independent refresh status.
- `evelyn-perps-overview`: Eight columns, Cross hierarchy, totals, formatting and definitions.
- `phoenix-perps-service`: Shared balances, exact price PnL, initial margin and account closing-value estimates.
## Impact
Changes are limited to `.tjava` integration/service/presentation code, passive Hub wiring, OpenSpec and applicable project/shared documentation. No new dependencies, configuration system, trading operations, live Hub restart, commits or pushes. Verification uses the normal build and temporary focused/read-only JavaFX harnesses.