Repository Public
1/**2 * DEVELOPMENT BUILDS ONLY (imported by mockLive.ts alone). A verbatim COPY of the server-authored texts of controlled live3 * trading — services/api/src/derivatives/live-texts.ts — so that the dev mock answers with the same French and English4 * sentences as the backend (the web app cannot import from services/). Only the import below and the two aliases at the end5 * differ. If the server's texts change, copy them again.6 */7// Server-authored human texts of controlled live trading, in French and English. They are selected by a `locale` parameter8// (query `?locale=fr|en` on GET routes, the `locale` field of the body on the prepare routes; default `en`, which is the text9// these routes always returned). Machine-readable codes never change with the locale. Shape: docs/v4/API-LIVE-NOTES.md.10import { VENUE_MANDATE_WIND_DOWN_S } from '../../../../packages/derivatives/src/live/mandate.ts';1112export type LiveLocale = 'fr' | 'en';13export const LIVE_LOCALES = ['fr', 'en'] as const;14export const liveLocale = (x: unknown): LiveLocale => (x === 'fr' ? 'fr' : 'en');1516const HOURS = VENUE_MANDATE_WIND_DOWN_S / 3600;17type Both = Record<LiveLocale, string>;1819/** reasons the server gives for a refusal that the UI shows as a sentence; the key is the error code */20export const LIVE_REASONS = {21 mainnet_disabled: {22 en: 'live trading on Hyperliquid MAINNET is disabled on this server (SPW_DERIV_LIVE_MAINNET is not "on"): nothing was built, signed or sent. The testnet account works.',23 fr: 'la négociation réelle sur le MAINNET de Hyperliquid est désactivée sur ce serveur (SPW_DERIV_LIVE_MAINNET n\'est pas à « on ») : rien n\'a été construit, signé ni envoyé. Le compte testnet fonctionne.',24 },25 mandate_mainnet_disabled: {26 en: 'autonomous (mandate) trading on Hyperliquid MAINNET is disabled on this server: it needs SPW_DERIV_LIVE_MAINNET=on AND SPW_DERIV_MANDATE_MAINNET=on. Nothing was built, signed or sent. Mandates work on the testnet account.',27 fr: 'la négociation autonome (mandat) sur le MAINNET de Hyperliquid est désactivée sur ce serveur : elle exige SPW_DERIV_LIVE_MAINNET=on ET SPW_DERIV_MANDATE_MAINNET=on. Rien n\'a été construit, signé ni envoyé. Les mandats fonctionnent sur le compte testnet.',28 },29 mandate_unavailable: {30 en: 'derivative mandates are not available on this server (the signer connection does not offer them)',31 fr: 'les mandats de dérivés ne sont pas disponibles sur ce serveur (la connexion au signataire ne les offre pas)',32 },33} as const satisfies Record<string, Both>;34export type LiveReasonCode = keyof typeof LIVE_REASONS;35export const liveReason = (code: LiveReasonCode, locale: LiveLocale = 'en'): string => LIVE_REASONS[code][locale];3637const T = {38 depositsHow: {39 en: 'docs/v4/venues/hyperliquid.md, section 15: native USDC on Arbitrum sent by the wallet itself to the pinned venue bridge, with the passkey (venue minimum 5 USDC; the wallet refuses less than 6) — routes …/collateral/status and …/collateral/deposit/…; mainnet only (testnet collateral is mock USDC from the venue faucet)',40 fr: 'docs/v4/venues/hyperliquid.md, section 15 : USDC natif sur Arbitrum envoyé par le portefeuille lui-même au pont épinglé de la plateforme, avec la clé d\'accès (minimum de la plateforme 5 USDC ; le portefeuille refuse moins de 6) — routes …/collateral/status et …/collateral/deposit/… ; réseau principal seulement (sur le testnet, la garantie est de l\'USDC fictif du robinet de la plateforme)',41 },42 withdrawalsHow: {43 en: 'routes …/collateral/withdraw/…: the user-signed withdraw3 action, signed by the wallet key after a passkey approval, to the wallet\'s own address only; venue fee 1 USDC (same section)',44 fr: 'routes …/collateral/withdraw/… : l\'action withdraw3 signée par la clé du portefeuille après approbation par clé d\'accès, uniquement vers l\'adresse du portefeuille ; frais de la plateforme 1 USDC (même section)',45 },46 agentNote: {47 en: 'On the venue an API wallet could also move collateral between the account\'s own balances; the signer refuses to sign anything but orders, cancels and leverage changes.',48 fr: 'Sur la plateforme, un portefeuille API pourrait aussi déplacer la garantie entre les soldes du compte lui-même ; le signataire refuse de signer autre chose que des ordres, des annulations et des changements de levier.',49 },50 byMainKey: {51 en: 'one approveAgent action naming the trading key above (the wallet key signs nothing else to trade; its only other venue message is a withdrawal to the wallet\'s own address, approved separately with the passkey)',52 fr: 'une seule action approveAgent désignant la clé de négociation ci-dessus (la clé du portefeuille ne signe rien d\'autre pour négocier ; son seul autre message pour la plateforme est un retrait vers l\'adresse du portefeuille, approuvé à part avec la clé d\'accès)',53 },54 byPasskey: {55 en: 'the SHA-256 of this authorization, which includes the hash of the acknowledgement text',56 fr: 'le SHA-256 de cette autorisation, qui inclut l\'empreinte du texte de reconnaissance',57 },58 mandateByPasskey: {59 en: 'the SHA-256 of this mandate: every limit below, the strategy code hash, the agent, the expiry and the hash of the acknowledgement text. Nothing is signed by a key at this step.',60 fr: 'le SHA-256 de ce mandat : chaque limite ci-dessous, l\'empreinte du code de la stratégie, l\'agent, l\'échéance et l\'empreinte du texte de reconnaissance. Aucune clé ne signe quoi que ce soit à cette étape.',61 },62 mandateWarning: {63 en: 'After this approval, orders inside these limits are placed WITHOUT asking for your passkey. Manual orders still need it.',64 fr: 'Après cette approbation, les ordres à l\'intérieur de ces limites sont placés SANS demander votre clé d\'accès. Les ordres manuels l\'exigent toujours.',65 },66 windDown: {67 en: `When the mandate is revoked or expires, no order that can add exposure is signed any more. For ${HOURS} hours the signer still signs cancels and reduce-only orders, so that the engine can close positions; after that, nothing. Revoking the venue authorization stops everything at once, cancels and closes included. Open positions are NOT closed by a revocation: close them, or let the engine do it during the wind-down.`,68 fr: `Quand le mandat est révoqué ou expire, plus aucun ordre pouvant ajouter de l'exposition n'est signé. Pendant ${HOURS} heures, le signataire signe encore les annulations et les ordres en réduction seule, pour que le moteur puisse fermer les positions ; ensuite, plus rien. Révoquer l'autorisation de la plateforme arrête tout immédiatement, annulations et fermetures comprises. Une révocation NE ferme PAS les positions ouvertes : fermez-les, ou laissez le moteur le faire pendant la période de liquidation.`,69 },70 venueAgent: {71 en: 'The trading key stays registered at the venue until its expiry, but it exists only in the signer, which now refuses to use it.',72 fr: 'La clé de négociation reste enregistrée sur la plateforme jusqu\'à son échéance, mais elle n\'existe que dans le signataire, qui refuse désormais de l\'utiliser.',73 },74} as const satisfies Record<string, Both>;7576const LISTS = {77 can: { en: ['place orders', 'cancel orders', 'change leverage'], fr: ['placer des ordres', 'annuler des ordres', 'changer le levier'] },78 cannot: { en: ['withdraw', 'transfer to another address'], fr: ['retirer des fonds', 'transférer vers une autre adresse'] },79 enforcedBySigner: {80 en: [81 'allowed instruments; one order per signature; orders, cancels and leverage changes only',82 'notional of each order; price of each order and trigger within the band around the signer\'s own price (two exchanges)',83 'worst-case position per instrument and worst-case gross exposure: the venue\'s positions read by the signer itself, plus every resting order and every order it signed that could still fill, plus the new order',84 'orders per day and per hour, daily turnover (orders that can add exposure)',85 'account value floor: below it, only cancels and reduce-only orders',86 'leverage: never above the mandate; no margin-mode change while a position is open',87 'venue expiry of every signature (at most 120 s), nonce and client id never reused',88 ],89 fr: [90 'instruments permis ; un ordre par signature ; ordres, annulations et changements de levier seulement',91 'notionnel de chaque ordre ; prix de chaque ordre et de chaque déclencheur dans la bande autour du prix propre du signataire (deux bourses)',92 'position maximale par instrument et exposition brute maximale dans le pire cas : les positions de la plateforme lues par le signataire lui-même, plus chaque ordre en attente et chaque ordre signé pouvant encore s\'exécuter, plus le nouvel ordre',93 'ordres par jour et par heure, volume quotidien (ordres pouvant ajouter de l\'exposition)',94 'plancher de valeur du compte : en dessous, seulement des annulations et des ordres en réduction seule',95 'levier : jamais au-dessus du mandat ; aucun changement de mode de marge tant qu\'une position est ouverte',96 'échéance de chaque signature sur la plateforme (120 s au plus), nonce et identifiant client jamais réutilisés',97 ],98 },99 trustedBySigner: {100 en: [101 'the venue\'s public info endpoint, for the size of the positions, the resting orders and the account value (the venue already holds the funds and executes the orders)',102 'the venue, to enforce reduce-only and the expiry of a signed order',103 'two public exchanges (Coinbase, Kraken), for prices',104 ],105 fr: [106 'le point d\'accès public d\'information de la plateforme, pour la taille des positions, les ordres en attente et la valeur du compte (la plateforme détient déjà les fonds et exécute les ordres)',107 'la plateforme, pour faire respecter la réduction seule et l\'échéance d\'un ordre signé',108 'deux bourses publiques (Coinbase, Kraken), pour les prix',109 ],110 },111 notEnforced: {112 en: [113 'that the strategy code running is the one whose hash you approved (the hash is recorded, not verified)',114 'profit: inside its limits a strategy can lose money; exposure is bounded when an order is signed, at the price of that moment',115 ],116 fr: [117 'que le code de stratégie exécuté soit celui dont vous avez approuvé l\'empreinte (l\'empreinte est consignée, pas vérifiée)',118 'le profit : à l\'intérieur de ses limites, une stratégie peut perdre de l\'argent ; l\'exposition est bornée au moment où un ordre est signé, au prix de ce moment',119 ],120 },121} as const satisfies Record<string, Record<LiveLocale, readonly string[]>>;122123export function liveTexts(locale: LiveLocale = 'en') {124 const t = <K extends keyof typeof T>(k: K): string => T[k][locale];125 const l = <K extends keyof typeof LISTS>(k: K): string[] => [...LISTS[k][locale]];126 return {127 locale, depositsHow: t('depositsHow'), withdrawalsHow: t('withdrawalsHow'), agentNote: t('agentNote'), byMainKey: t('byMainKey'), byPasskey: t('byPasskey'), venueAgent: t('venueAgent'),128 mandateByPasskey: t('mandateByPasskey'), mandateWarning: t('mandateWarning'), windDown: t('windDown'),129 can: l('can'), cannot: l('cannot'), enforcedBySigner: l('enforcedBySigner'), trustedBySigner: l('trustedBySigner'), notEnforced: l('notEnforced'),130 };131}132133export type MockLocale = LiveLocale;134export const mockLiveReasons = LIVE_REASONS;135export const mockLiveTexts = (locale: unknown) => liveTexts(liveLocale(locale));136