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

EMC Perps: show Phoenix TWAP progress and time until next suborder #101

New Issue
Open
opened 2026-10-24 18:54:35 +02:00 by minimons · 0 comments
minimons commented 2026-10-24 18:54:35 +02:00
Owner
Copy Link
Copy Source

Formål

Tilføj en TWAP-kolonne i EMC's Perps-tabel, så ejeren kan se fremdrift og tid til næste delordre for en igangværende Phoenix TWAP. Det supplerer positionsoverblikket fra #100 og gør igangværende opbygning eller afvikling af en position synlig.

Aftalt visning

  • Kolonnen indeholder en progressbar med antal udførte delordrer / samlet antal delordrer som fremdrift.
  • Teksten oven på baren viser estimeret resterende tid indtil næste planlagte delordre i formatet H+:mm:ss.
  • Timer må ikke rulle rundt ved 24: 28:32:10 betyder 28 timer, 32 minutter og 10 sekunder. Også eksempelvis 128:32:10 skal kunne vises.
  • En TWAP vises kun på en eksisterende Phoenix-position, og først når TWAP-ordren selv har fået sit første faktiske fill (baseLotsFilled > 0). En ordre uden fills skal ikke kunne ses andre steder i overblikket, heller ikke når der i forvejen findes en position på markedet. Opret ingen nye positionsrækker alene på grund af en TWAP-ordre.
  • Rækker uden en relevant TWAP har en tom TWAP-celle. Der indføres ingen TWAP-opsummering på grupper eller andre venues i denne opgave.
  • Behold den nuværende periodiske opdatering. Hurtigere polling, streaming og realtime-opdateringer hører til en senere opgave.

Tooltip

Vis som minimum:

Progress: 12/25 (48.0%)
Estimated completion: <weekday yyyy/MM/dd HH:mm:ss timezone>
Order size: <total quantity> <symbol> (≈ $<value>)
Next suborder size: <next quantity> <symbol> (≈ $<value>)
Filled: <filled quantity> <symbol>
Updated: <observation timestamp>
  • Estimated completion er det forventede sluttidspunkt for tidsplanen. Det må ikke præsenteres som en faktisk afslutning eller en garanti for fuld eksekvering.
  • Progress måler udførte delordrer. Faktisk handlet mængde vises særskilt, da udførte delordrer og fuldt fyldt mængde ikke nødvendigvis følges ad.
  • Restordrer (dust) kan være mindre end normale delordrer. Beregn samlet ordrestørrelse med den korrekte fordeling, og vis størrelsen på den næste relevante delordre. Tooltip skal forklare forskellige delordrestørrelser, når det er relevant.
  • Ukendte oplysninger må ikke blive til nul. En passeret tidsplan eller forældede data må heller ikke vises som en negativ eller omrullet varighed eller som bevis for, at en handel er sket.

Datagrundlag og pris

Phoenix' officielle SDK har et særskilt læse-endpoint:

GET /v1/trader/{authority}/twap?traderPdaIndex=0

Snapshot indeholder bl.a. assetId, trader/PDA/subaccount-identitet, nChildOrders, childOrdersExecuted, childOrdersRemaining, baseLotsFilled, quoteLotsFilled, numBaseLots, nDustOrders, dustOrderSize, dueSlot og cooldownSlots. Der er allerede verificeret aktive TWAP-ordrer via læseopslag mod de konfigurerede konti.

  • Knyt ordren til den korrekte wallet, trader-PDA, subaccount og marked; symbol alene er ikke tilstrækkeligt.
  • Omregn lots med Phoenix' markedsmetadata. Håndter normale delordrer og både nyere og ældre dust-formater korrekt; vis ukendt, hvis nødvendige oplysninger mangler.
  • Næste delordre og forventet afslutning udledes fra slots og interval. Klokkeslæt er estimater, og lastValidSlot er udløb, ikke forventet afslutning. Fastlæg og dokumentér en forsvarlig omregning fra slots til tid.
  • TWAP-snapshot indeholder ikke en færdig aktuel USD-vurdering af hele ordren. Den eksisterende Phoenix-integration henter allerede markpris via GET /v1/market/{symbol}/mark-price til positionsværdi og uPnL. Genbrug den samme pris til totalmængde og næste delordres mængde, uden en afhængighed af Tickeren.
  • USD-beløb er mængde × senest hentede Phoenix-markpris og markeres som omtrentlige. De er ikke den historiske eller garanterede fremtidige handelsomkostning. Mangler en brugbar pris, vis tokenmængden med ukendt USD-værdi.
  • Bevar eksisterende håndtering af rate limits og fejl. En TWAP-læsefejl må ikke skjules som, at ordren er afsluttet eller ikke findes.

Kilder:

Implementering og verifikation

  • Brug OpenSpec til implementeringen.
  • Opdatér relevant eksisterende dokumentation i repositoryet og r35157_docs, og fjern påstande, som ikke længere passer. Tilføj kun dokumentation, der forklarer reel adfærd eller begrænsninger.
  • Verificér især varigheder over 24 og 100 timer, skjulte ordrer uden fills, præcis tilknytning til positioner, forskellige delordrestørrelser, manglende pris og forældede/fejlede opslag.
  • Implementeringen skal ikke committe eller pushe koden.

Dette issue samler de aftalte krav; oprettelsen af issuet er ikke i sig selv en bestilling på at implementere ændringen nu.

## Formål Tilføj en `TWAP`-kolonne i EMC's Perps-tabel, så ejeren kan se fremdrift og tid til næste delordre for en igangværende Phoenix TWAP. Det supplerer positionsoverblikket fra #100 og gør igangværende opbygning eller afvikling af en position synlig. ## Aftalt visning - Kolonnen indeholder en progressbar med antal udførte delordrer / samlet antal delordrer som fremdrift. - Teksten oven på baren viser estimeret resterende tid indtil næste planlagte delordre i formatet `H+:mm:ss`. - Timer må ikke rulle rundt ved 24: `28:32:10` betyder 28 timer, 32 minutter og 10 sekunder. Også eksempelvis `128:32:10` skal kunne vises. - En TWAP vises kun på en eksisterende Phoenix-position, og først når TWAP-ordren selv har fået sit første faktiske fill (`baseLotsFilled > 0`). En ordre uden fills skal ikke kunne ses andre steder i overblikket, heller ikke når der i forvejen findes en position på markedet. Opret ingen nye positionsrækker alene på grund af en TWAP-ordre. - Rækker uden en relevant TWAP har en tom TWAP-celle. Der indføres ingen TWAP-opsummering på grupper eller andre venues i denne opgave. - Behold den nuværende periodiske opdatering. Hurtigere polling, streaming og realtime-opdateringer hører til en senere opgave. ## Tooltip Vis som minimum: ```text Progress: 12/25 (48.0%) Estimated completion: <weekday yyyy/MM/dd HH:mm:ss timezone> Order size: <total quantity> <symbol> (≈ $<value>) Next suborder size: <next quantity> <symbol> (≈ $<value>) Filled: <filled quantity> <symbol> Updated: <observation timestamp> ``` - `Estimated completion` er det forventede sluttidspunkt for tidsplanen. Det må ikke præsenteres som en faktisk afslutning eller en garanti for fuld eksekvering. - Progress måler udførte delordrer. Faktisk handlet mængde vises særskilt, da udførte delordrer og fuldt fyldt mængde ikke nødvendigvis følges ad. - Restordrer (dust) kan være mindre end normale delordrer. Beregn samlet ordrestørrelse med den korrekte fordeling, og vis størrelsen på den næste relevante delordre. Tooltip skal forklare forskellige delordrestørrelser, når det er relevant. - Ukendte oplysninger må ikke blive til nul. En passeret tidsplan eller forældede data må heller ikke vises som en negativ eller omrullet varighed eller som bevis for, at en handel er sket. ## Datagrundlag og pris Phoenix' officielle SDK har et særskilt læse-endpoint: ```http GET /v1/trader/{authority}/twap?traderPdaIndex=0 ``` Snapshot indeholder bl.a. `assetId`, trader/PDA/subaccount-identitet, `nChildOrders`, `childOrdersExecuted`, `childOrdersRemaining`, `baseLotsFilled`, `quoteLotsFilled`, `numBaseLots`, `nDustOrders`, `dustOrderSize`, `dueSlot` og `cooldownSlots`. Der er allerede verificeret aktive TWAP-ordrer via læseopslag mod de konfigurerede konti. - Knyt ordren til den korrekte wallet, trader-PDA, subaccount og marked; symbol alene er ikke tilstrækkeligt. - Omregn lots med Phoenix' markedsmetadata. Håndter normale delordrer og både nyere og ældre dust-formater korrekt; vis ukendt, hvis nødvendige oplysninger mangler. - Næste delordre og forventet afslutning udledes fra slots og interval. Klokkeslæt er estimater, og `lastValidSlot` er udløb, ikke forventet afslutning. Fastlæg og dokumentér en forsvarlig omregning fra slots til tid. - TWAP-snapshot indeholder ikke en færdig aktuel USD-vurdering af hele ordren. Den eksisterende Phoenix-integration henter allerede markpris via `GET /v1/market/{symbol}/mark-price` til positionsværdi og uPnL. Genbrug den samme pris til totalmængde og næste delordres mængde, uden en afhængighed af Tickeren. - USD-beløb er mængde × senest hentede Phoenix-markpris og markeres som omtrentlige. De er ikke den historiske eller garanterede fremtidige handelsomkostning. Mangler en brugbar pris, vis tokenmængden med ukendt USD-værdi. - Bevar eksisterende håndtering af rate limits og fejl. En TWAP-læsefejl må ikke skjules som, at ordren er afsluttet eller ikke findes. Kilder: - [Phoenix SDK: TWAP-snapshot og felter](https://github.com/Ellipsis-Labs/rise-public/blob/master/ts/src/api/traders/twap.ts) - [Phoenix SDK: TWAP-læse-endpoint](https://github.com/Ellipsis-Labs/rise-public/blob/master/ts/src/api/traders/client.ts) - [Phoenix SDK: delordrer og dust](https://github.com/Ellipsis-Labs/rise-public/blob/master/ts/src/core/ixBuilders/Twap/types.ts) - [Phoenix: markpris](https://docs.phoenix.trade/api/exchange/get-mark-price) ## Implementering og verifikation - Brug OpenSpec til implementeringen. - Opdatér relevant eksisterende dokumentation i repositoryet og `r35157_docs`, og fjern påstande, som ikke længere passer. Tilføj kun dokumentation, der forklarer reel adfærd eller begrænsninger. - Verificér især varigheder over 24 og 100 timer, skjulte ordrer uden fills, præcis tilknytning til positioner, forskellige delordrestørrelser, manglende pris og forældede/fejlede opslag. - Implementeringen skal ikke committe eller pushe koden. Dette issue samler de aftalte krav; oprettelsen af issuet er ikke i sig selv en bestilling på at implementere ændringen nu.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bug
Something is not working
 duplicate
This issue or pull request already exists
 enhancement
New feature
 help wanted
Need some help
 invalid
Something is wrong
 question
More information is needed
 wontfix
This won't be fixed
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
builder (CICD User) minimons (Morten Green Hermansen)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: r35157/com_r35157_nenjim-hubd-impl_ref#101