Torch Market

• Vous souhaitez échanger des tokens qui peuvent se trouver sur une bonding curve ou un pool DEX Raydium et avez besoin d'un routage automatique sans gérer vous-même la différence.
• Vous construisez un agent ou un bot qui exécute des trades Solana côté serveur et avez besoin d'une architecture de vault qui sépare le keypair de l'agent (dust uniquement) des fonds de l'utilisateur (contrôlés par une authority).
• Vous devez interagir avec le cycle de vie complet de Torch Market : lancement de tokens, emprunt de SOL contre un collatéral en tokens, collecte des frais de transfert, ou déclenchement de cranks de trésorerie sans permission.
• Vous souhaitez un accès en lecture seule à l'état du marché on-chain — listings de tokens, positions de prêt, soldes de vaults, paramètres de prêt — sans jamais fournir de clé privée.

• Vous recherchez un agrégateur DEX Solana polyvalent qui fonctionne sur des protocoles arbitraires au-delà de Torch Market et de Raydium.
• Vous avez besoin d'une exécution d'agent autonome et non supervisée : cette compétence définit disable-model-invocation: true et ne doit être invoquée qu'à l'initiative explicite de l'utilisateur.
• Votre cas d'usage n'implique pas spécifiquement le protocole Torch Market (Program ID : 8hbUkonssSEEtkqzwM7ZcZrD9evacM92TcWSooVF4BeT).

getBuyQuote + buildBuyTransaction (ou sendBuy) fonctionne que le token soit sur une courbe de liaison ou dans un pool Raydium CPMM migré. Le SDK route automatiquement en fonction de l'état du token, de sorte que les appelants n'ont jamais besoin de se brancher sur la phase du cycle de vie.

Tous les SOL et les tokens sont détenus dans un coffre-fort on-chain contrôlé par l'autorité humaine, et non par la paire de clés de l'agent. La clé de l'agent est jetable (~0,01 SOL pour le gas) ; en cas de compromission, l'autorité la révoque en une seule transaction et le capital de trading reste intact.

Sans SOLANA_PRIVATE_KEY, la compétence fonctionne en mode lecture seule : elle interroge l'état on-chain et retourne des objets VersionedTransaction non signés pour une signature externe (par exemple Phantom, Ledger). Aucun matériel de clé n'entre jamais dans l'environnement d'exécution.

Les jetons post-migration permettent d'emprunter du SOL en utilisant des jetons comme garantie, jusqu'à 50 % du ratio prêt/valeur (LTV), avec un seuil de liquidation à 65 % et un bonus de liquidateur de 10 %. Les intérêts et les frais de transfert (0,04 %, immuables) sont reversés à la trésorerie communautaire, renforçant l'économie interne du jeton.

Toutes les transactions utilisent des messages v0 compressés avec des ALT codés en dur (14 adresses statiques réduites de 32 octets à 1 octet chacune). Cela se traduit par des transactions plus légères, une plus grande marge pour les instructions et moins d'échecs on-chain.

L'arithmétique de base du protocole est prouvée correcte grâce à 48 harnais de preuve Kani, tous validés. Les rapports d'audit et de vérification sont disponibles publiquement sur torch.market/audit_sdk.md.

Un agent côté serveur utilise createEphemeralAgent() comme contrôleur jetable lié à un coffre appartenant à un humain. Il appelle getBuyQuote + buildBuyTransaction, signe localement et envoie des transactions brutes — aucune fenêtre contextuelle de portefeuille, aucun risque de garde. Si la clé de l'agent est compromise, l'autorité du coffre la révoque instantanément.

Une application web appelle sendBuy ou buildSellTransaction avec un WalletAdapter encapsulant la fonction sendTransaction de Phantom. Le SDK gère le routage, la protection contre le glissement de prix et la simulation ; Phantom reçoit une VersionedTransaction finale pour approbation par l'utilisateur, sans avertissement de mutation.

Un moniteur automatisé appelle getAllLoanPositions pour analyser les positions dépassant le seuil de liquidation de 65 % du ratio prêt/valeur, puis appelle buildLiquidateTransaction pour réclamer le bonus de liquidateur de 10 %. Les flux d'intérêts et de garanties sont tous acheminés par le coffre, ce qui permet de séparer le capital du bot des produits de liquidation.

Un bot keeper sans permission appelle périodiquement buildHarvestFeesTransaction et buildSwapFeesToSolTransaction pour collecter les frais de transfert Token-2022 depuis le mint, les échanger en SOL via Raydium, et alimenter le pool de prêt communautaire — aucune autorité spéciale requise.