Guides utilisateur

Ces guides sont conçus pour un utilisateur qui découvre le protocole. Aucune connaissance préalable de la programmation, du fonctionnement interne des contrats ou du langage Solidity n'est nécessaire. Chaque parcours est décrit pas à pas avec la mention de l'écran à ouvrir, du bouton à utiliser, et du résultat attendu après validation.

Si vous êtes plus avancé et souhaitez intégrer le protocole dans une application tierce ou interagir directement avec les contrats, voir la page Ressources qui contient les adresses on-chain, le sous-graphe TheGraph et les fichiers ABI.

Si vous avez besoin de comprendre les mécanismes économiques avant d'agir, voir les pages Tokenomics et Gouvernance pour les chiffres détaillés, et la page Architecture pour les flux entre modules.

L'application Kal Mydas utilise Privy pour la connexion. Cinq méthodes sont disponibles, toutes équivalentes en termes de droits sur le protocole : adresse de courrier électronique avec code à usage unique, compte Google, extension MetaMask, application Coinbase Wallet, ou WalletConnect pour les portefeuilles compatibles. Si vous n'avez encore aucun portefeuille de chaîne, Privy crée automatiquement un portefeuille embarqué associé à votre identifiant — vous n'avez rien à installer.

Pour vous connecter, ouvrez https://app.kalmydas.com et cliquez sur « Se connecter » en haut à droite. La fenêtre Privy propose les cinq options. Choisissez celle qui vous convient et suivez les instructions. Une fois la connexion validée, votre adresse de portefeuille apparaît dans le coin supérieur droit de l'application.

Pour interagir avec le protocole, votre portefeuille doit être positionné sur le bon réseau. En phase testnet (jusqu'au 14 septembre 2026), le réseau utilisé est Arbitrum Sepolia. Au déploiement mainnet, le réseau bascule vers Base. L'application affiche un bandeau d'avertissement si votre portefeuille est sur un mauvais réseau et propose un bouton de bascule en un clic.

Avant la première transaction, vous devez disposer d'un peu d'éther sur le réseau actif pour payer les frais de gaz. Sur Sepolia, un robinet public (faucet) vous en donne quelques fractions gratuitement. Sur Base, l'éther doit être obtenu via un pont depuis Ethereum ou directement acheté via Coinbase.

Le Pass d'accès KalAccessPass V5.1 est un jeton non-transférable qui ouvre certaines fonctionnalités graduées du protocole. Quatre niveaux sont proposés — Bronze, Argent, Or, Diamant — chacun avec sa durée et ses frais journaliers propres. Le paiement peut être effectué en USDC ou en KAL ; le paiement en KAL bénéficie d'une remise de 30 % par rapport au tarif USDC, pour aligner les utilisateurs sur l'écosystème.

Pour activer un Pass, ouvrez https://app.kalmydas.com et naviguez vers la section « Pass d'accès ». Sélectionnez le niveau souhaité, choisissez le mode de paiement (USDC ou KAL), validez la transaction. Une fois confirmée, le Pass apparaît dans votre portefeuille comme un jeton non-fongible. Il est attaché à votre adresse de manière irrévocable — il ne peut être ni vendu, ni transféré, ni prêté.

Le Pass se renouvelle automatiquement tant que votre solde de paiement couvre les frais journaliers. Si le solde devient insuffisant, le Pass se met simplement en sommeil — vous pouvez le réactiver à tout moment en rechargeant. Aucun frais de réactivation, aucun délai d'attente.

La prévente KalPresaleV2 se déroule en deux phases. La Phase 1 (privée) ouvre le 1er mai 2026 et regroupe les paliers SEED, STRATEGIC et COMMUNITY ; elle est réservée aux contributeurs admis sur la liste blanche d'origine. La Phase 2 (publique) ouvre le 15 juillet 2026 et regroupe les sept paliers PUBLIC à FINAL, accessibles sans inscription préalable.

Pour acheter, ouvrez https://app.kalmydas.com/presale et sélectionnez le palier actif. Saisissez le montant en USDC que vous souhaitez consacrer (dans la limite du plafond par portefeuille du palier — 500 $ pour SEED et FINAL, 1 000 $ pour STRATEGIC, 2 000 ou 3 000 $ pour les paliers intermédiaires). L'application affiche en temps réel la quantité de KAL que vous obtiendrez, bonus inclus le cas échéant.

Validez la transaction depuis votre portefeuille. Une fois confirmée on-chain, les KAL sont transférés directement à votre adresse — pas de période de blocage, pas de calendrier de libération. Vous pouvez immédiatement les conserver, les verrouiller en veKAL, ou les utiliser pour fournir de la liquidité.

Pour les paliers d'amorçage (SEED, STRATEGIC, COMMUNITY), un bonus de 20 %, 10 % et 5 % respectivement s'ajoute automatiquement au moment de l'achat. Le contrat applique le bonus dans la limite du plafond global de 500 000 KAL — vous le voyez s'ajouter visuellement sur la confirmation de transaction.

Cinq pools de stratégie sont actifs : HORIZON, VALKYRIE, REVOLUTION, TREASURY et ORION. Chacun met en œuvre un algorithme distinct sur le marché XAUUSD (or contre dollar). Vous pouvez déposer dans un ou plusieurs pools simultanément, dans les proportions de votre choix. Aucune obligation de répartition — c'est votre arbitrage personnel.

Pour déposer, ouvrez https://app.kalmydas.com/pools et sélectionnez le pool souhaité. Consultez sa fiche : performance historique, perte maximale observée, frais en vigueur (frais sur résultats et frais de gestion), capital actuellement sous gestion. Cliquez sur « Déposer », saisissez le montant en USDC, validez la transaction. Vous recevez en échange un solde de parts proportionnel à votre dépôt.

Une fois la position ouverte, vous pouvez la suivre en temps réel sur la page de transparence (https://app.kalmydas.com/transparency). Chaque opération exécutée par l'algorithme affiche son identifiant unique (Trade ID), son statut de santé (HEALTHY, LOW, HIGH, CRITICAL) et son P&L réalisé. Aucune information n'est cachée derrière un rapport agrégé — tout est visible contrat par contrat.

Les frais sur résultats sont prélevés uniquement sur les gains réalisés, jamais sur le capital ni sur des gains non encore distribués. Les frais de gestion sont prélevés mensuellement sur le capital sous gestion à un taux inférieur à 5 % par mois (plafond contractuel). Vous voyez le détail des prélèvements dans l'historique de votre position.

Verrouiller du KAL crée des veKAL non-transférables qui ouvrent trois droits : voter dans la gouvernance, recevoir une part hebdomadaire des frais USDC, multiplier les récompenses de liquidité jusqu'à 2,5×. La durée de verrouillage est libre entre une semaine et quatre ans ; plus la durée est longue, plus le ratio de conversion KAL → veKAL est favorable.

Pour verrouiller, ouvrez https://app.kalmydas.com/governance et sélectionnez « Verrouiller du KAL ». Saisissez la quantité et la durée. L'application affiche en temps réel la quantité de veKAL que vous recevrez (formule linéaire `KAL × durée / 4 ans`). Validez la transaction.

À l'expiration de la durée choisie, vous pouvez retirer vos KAL initiaux. Les bénéfices accumulés (frais USDC reçus chaque semaine, récompenses LP boostées) ont déjà été versés régulièrement et restent acquis. Vous pouvez aussi prolonger votre verrouillage avant échéance — la nouvelle durée doit toujours respecter les bornes 1 semaine et 4 ans.

Pendant les six premiers mois post-mainnet, un programme bonus s'applique aux verrouilleurs : multiplicateur 3× sur les semaines 1 à 4, 2× sur 5 à 12, 1,5× sur 13 à 26. Ce bonus s'ajoute au partage standard via FeeDistributor — il n'est pas un remplacement, c'est une couche supplémentaire.

Toute personne détenant au moins 1 % du veKAL en circulation peut déposer une proposition de gouvernance. Toute personne détenant un veKAL non nul peut voter pour ou contre. Les propositions concernent les paramètres modifiables du protocole : taux de frais en deçà des plafonds, autorisation de nouveaux pools, allocation de la trésorerie.

Pour voir les propositions actives, ouvrez https://app.kalmydas.com/governance/proposals. Chaque proposition affiche son auteur, son objet, son code complet (les actions à exécuter en cas d'adoption), ses dates d'ouverture et de clôture, et l'état actuel du décompte des votes. La période de vote est de trois jours ; au-delà, plus aucun vote n'est accepté.

Pour voter, sélectionnez la proposition et cliquez sur « Pour », « Contre » ou « Abstention ». Validez la transaction. Votre poids dans le scrutin est déterminé par votre veKAL au moment de l'instantané pris en début de période — pas au moment où vous votez. Cette mécanique neutralise par construction les attaques dites de flash-lock (verrouiller juste avant un vote pour faire pencher la balance).

Si la proposition est adoptée (quorum 10 % atteint et plus de « pour » que de « contre »), elle entre dans une fenêtre de 48 heures de délai d'exécution puis 7 jours de fenêtre de grâce. Pendant ces deux périodes, vous pouvez encore retirer vos dépôts si l'adoption ne vous convient pas.

Si vous détenez du veKAL, vous recevez chaque semaine une part des frais sur résultats du protocole, libellée en USDC. Le contrat FeeDistributor calcule automatiquement votre part au prorata de votre veKAL au début de la période, et la rend disponible sur votre compte après la clôture hebdomadaire. Aucune obligation d'accepter du KAL au lieu de stablecoin — c'est de l'USDC, immédiatement utilisable hors écosystème.

Pour récupérer vos frais accumulés, ouvrez https://app.kalmydas.com/governance/fees et cliquez sur « Récupérer ». L'application liste les semaines pour lesquelles vous avez du USDC à percevoir. Une seule transaction suffit pour tout récupérer en bloc, ou vous pouvez choisir une semaine précise. Les fonds sont transférés directement sur votre adresse.

Si vous êtes en plus dans le programme bonus early lockers (premiers six mois post-mainnet), un bonus USDC supplémentaire est ajouté via FeeShareBooster. Ce bonus est visible séparément dans l'interface — vous voyez clairement la part standard et la part bonus, sans confusion possible.

Chaque pool de stratégie dispose de deux fonctions de protection ajoutées en avril 2026 et auditées PASS par Omniscient Security Labs. La sortie d'urgence vous permet de retirer la totalité de votre position immédiatement, sans pause possible par l'administration et sans frais supplémentaires. C'est un retrait au prix de part courant — vous récupérez ce que votre position vaut au moment où vous cliquez.

Pour déclencher une sortie d'urgence, ouvrez la fiche de votre pool sur https://app.kalmydas.com/pools, cliquez sur le bouton « Sortie d'urgence » (zone rouge en bas de la fiche), confirmez par double clic dans les 5 secondes pour éviter une activation accidentelle, validez la transaction. La sortie est exécutée en une seule transaction atomique.

La pause individuelle est plus douce : elle gèle votre position sans la fermer. Vous restez exposé aux résultats du pool, mais vos parts sont marquées comme suspendues — utile par exemple le temps d'analyser un comportement de marché atypique. Vous pouvez relever la pause à tout moment via le bouton « Reprendre ma position ». Le contrat fait la distinction entre les parts en pause et celles en activité, ce qui est visible sur votre tableau de bord.

Ces deux mécanismes sont déclenchés par vous seul. L'administration ne peut pas vous forcer à sortir, ni vous empêcher de sortir si vous le souhaitez. C'est une garantie inscrite dans le contrat KalPool — pas une promesse opérationnelle.

La place de marché secondaire du KAL repose sur le contrat KalSwap, un teneur de marché automatisé inspiré de Uniswap V2. En fournissant simultanément du KAL et de l'USDC à la réserve KAL/USDC, vous obtenez en échange un jeton de part KAL-USDC-LP qui matérialise votre quote-part dans la réserve. Vous percevez automatiquement une fraction des frais d'échange chaque fois qu'un autre utilisateur échange via cette paire.

Pour fournir de la liquidité, ouvrez https://app.kalmydas.com/swap et passez en mode « Fournir de la liquidité ». L'application vous demande de saisir une quantité (en KAL ou en USDC) et calcule automatiquement la quantité équivalente de l'autre jeton à apporter, selon le ratio courant de la réserve. Validez les deux transactions (approbation de chaque jeton, puis dépôt en réserve).

En sus des frais d'échange, vous recevez une part de l'émission KAL programmée par LiquidityRewardsV6 (60 % de l'offre totale, soit 6 millions de KAL distribués sur 50 ans). Cette part est calculée au prorata de votre quote-part dans la réserve, et amplifiée par votre multiplicateur veKAL si vous verrouillez en parallèle (jusqu'à 2,5×).

Pour retirer votre liquidité, l'opération est symétrique : vous brûlez votre jeton de part et récupérez le KAL et l'USDC correspondants au ratio courant. Aucune période de blocage, aucun frais supplémentaire — vous gardez la main sur votre liquidité à tout moment.