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 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. La fenêtre propose d’abord les portefeuilles détectés sur votre navigateur, MetaMask et WalletConnect. Le compte Google et l’adresse de courrier électronique sont regroupés sous « Autres options ». Toutes ces méthodes ouvrent exactement les mêmes droits sur le protocole. Si vous ne disposez encore d’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 « Connexion » en haut à droite. Choisissez la méthode 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.

Le protocole vit sur Base, son réseau principal depuis le 1ᵉʳ mai 2026. L’application n’est configurée que pour ce réseau, aucun autre n’est proposé à la connexion. La phase de tests menée sur Arbitrum Sepolia est archivée et ne concerne plus l’utilisation courante.

Avant la première transaction, vous devez disposer d’un peu d’éther sur Base pour payer les frais de réseau. L’éther s’obtient par un pont depuis Ethereum, ou s’achète directement via Coinbase. La page consacrée au transfert d’USDC vers Base détaille ce parcours.

Le Pass d’accès KalAccessPassV5_2 est un jeton non transférable qui ouvre les fonctionnalités graduées du protocole. Il est en service depuis le 7 juin 2026 et remplace le KalAccessPassV5_1. La migration des Pass existants s’opère par la fonction migrateFromV5_1, réservée au propriétaire des contrats : elle recopie le solde et le niveau du détenteur sans achat nouveau et sans démarche de sa part.

4 niveaux sont proposés. Bronze coûte 1,00 USDC par jour et n’ouvre aucune réduction. Argent coûte 1,50 USDC par jour et ouvre 5 pour cent de réduction. Or coûte 2,50 USDC par jour et ouvre 10 pour cent. Diamant coûte 5,00 USDC par jour, ouvre 15 pour cent et applique un facteur de 1,5 fois sur le veKAL que vous détenez déjà. Le Pass ne crée pas de veKAL, il amplifie celui qui existe, et il ne confère aucun droit de vote.

Pour activer un Pass, ouvrez https://app.kalmydas.com/access-pass, sélectionnez le niveau souhaité, choisissez le mode de paiement, USDC ou KAL, puis validez la transaction. Le paiement en KAL bénéficie d’une remise de 30 pour cent sur le tarif en USDC, valeur lue dans le contrat. Une fois la transaction confirmée, le Pass apparaît dans votre portefeuille sous forme de jeton non fongible. Les fonctions de transfert du contrat sont désactivées et rejettent tout appel : le Pass ne peut être ni vendu, ni transféré, ni prêté.

Le solde du Pass est débité chaque jour de la redevance journalière de votre niveau. Tant que ce solde couvre la redevance, le Pass reste actif sans intervention de votre part. Quand le solde ne la couvre plus, le contrat solde le compte, désactive le Pass et détruit le jeton associé. Une recharge ultérieure rouvre un Pass au niveau Bronze, avec un nouveau jeton, et non au niveau précédent. Il n’y a ni frais de réactivation, ni délai d’attente.

Kal Mydas est en Phase Beta depuis le 15 juillet 2026. Le Niveau 2 Communauté de la prévente est le seul palier ouvert et sa fermeture, inscrite dans le contrat, est fixée au 16 septembre 2026 à 18 h 00 heure suisse. L’ouverture de la Phase Public, prévue le 14 septembre 2026, reste conditionnée à l’atteinte du palier de viabilité.

La prévente est portée par le contrat KalPresaleV4 depuis le 19 juillet 2026. Ce contrat distribue un stock de KAL déjà existant, il ne crée aucun jeton et n’est pas autorisé à en créer. La grille compte 10 niveaux à prix croissant, de 0,30 à 8,00 USDC par KAL. Les niveaux s’ouvrent un à un par une transaction du propriétaire des contrats, aucun enchaînement automatique n’est implémenté.

Pour acheter, ouvrez https://app.kalmydas.com/presale et sélectionnez le niveau ouvert. Saisissez le montant en USDC que vous souhaitez engager, dans la limite du plafond par portefeuille propre à ce niveau. Ce plafond est de 500 USDC sur le Niveau 2 Communauté, seul niveau ouvert à ce jour. Les plafonds des autres niveaux vont de 500 à 3 000 USDC, ils sont inscrits dans le contrat et l’application affiche celui qui s’applique au moment de votre achat. L’application affiche également en temps réel la quantité de KAL que vous obtiendrez, bonus compris 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. Aucune période de blocage ni calendrier de libération n’est inscrit dans le contrat. Vous pouvez immédiatement les conserver, les verrouiller en veKAL ou les utiliser pour fournir de la liquidité.

Les 3 premiers niveaux portent un bonus en KAL, de 20 pour cent sur le Niveau 0 Amorçage, 10 pour cent sur le Niveau 1 Stratégique et 5 pour cent sur le Niveau 2 Communauté. Les niveaux suivants n’en portent aucun. L’ensemble de la prévente est plafonné à environ 492 798 KAL, valeur arrondie du plafond inscrit dans le contrat. Ce plafond est la borne dure : quelle que soit la répartition des ventes entre les 10 niveaux, le contrat ne remettra jamais davantage. Les 10 niveaux totalisent 482 498 KAL avant bonus, et les bonus des 3 premiers portent ce total à 499 998 KAL, un montant supérieur au plafond. Le plafond prime, et la prévente s’arrête à son atteinte, même si un niveau reste ouvert.

5 pools de stratégie sont actifs : HORIZON, VALKYRIE, REVOLUTION, TREASURY et ORION. Chacun met en œuvre un algorithme distinct sur le marché XAUUSD, l’or au comptant contre dollar. Vous pouvez déposer dans un ou plusieurs pools simultanément, dans les proportions de votre choix. Aucune répartition n’est imposée, c’est votre arbitrage personnel.

Pour déposer, ouvrez https://app.kalmydas.com : la page d’accueil liste les 5 stratégies. Ouvrez la fiche de celle que vous visez, par exemple https://app.kalmydas.com/pool/HORIZON. Cette fiche indique la performance simulée de la stratégie, l’enfoncement maximal observé en simulation, les frais en vigueur et le 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 la suivez sur la page de transparence, https://app.kalmydas.com/transparency. Chaque opération y figure avec sa date, sa stratégie, son résultat, son statut, ouverte ou fermée, et le lien vers la transaction correspondante sur Basescan. Aucune information n’est masquée derrière un rapport agrégé, chaque ligne se vérifie une par une.

Les frais de performance ne sont prélevés que sur les gains réalisés qui dépassent le plus haut niveau déjà atteint par le prix de part. Ils ne portent jamais sur le capital, ni sur des gains non encore réalisés. Ils sont de 10 pour cent sur HORIZON et de 20 pour cent sur les 4 autres stratégies.

Les frais de gestion sont prélevés mensuellement sur le capital sous gestion, au taux mensuel inscrit dans chaque pool : 0,10 pour cent pour HORIZON, 0,20 pour cent pour VALKYRIE, 0,50 pour cent pour REVOLUTION et pour TREASURY, et aucun frais de gestion pour ORION. Ces taux mensuels correspondent respectivement à 1,2 pour cent, 2,4 pour cent, 6 pour cent, 6 pour cent et 0 pour cent par an. Le détail des prélèvements figure dans l’historique de votre position.

Le retrait est libre, aucune durée de blocage ne s’applique à votre position. Deux conditions sont cependant portées par le contrat. Le pool doit disposer, au moment de la transaction, du solde en USDC correspondant à la valeur des parts que vous retirez. Le retrait est par ailleurs suspendu si le propriétaire des contrats a mis le pool en pause globale, au même titre que la sortie d’urgence décrite plus bas.

Simulations historiques sur 4 à 21 ans de données XAUUSD. L’exécution réelle via gTrade peut produire des résultats différents. Risque de perte partielle ou totale du capital. Les performances passées ne garantissent pas les performances futures.

Verrouiller du KAL crée des veKAL non transférables qui ouvrent 3 droits. Le premier est le vote en gouvernance. Le deuxième est la perception d’une part hebdomadaire des frais en USDC, versée au titre de l’indemnité de service technique qui rétribue la fourniture du service de sécurisation et de gouvernance au protocole. Le troisième est un facteur appliqué aux récompenses de minage de liquidité, jusqu’à 2,5 fois. Ce facteur porte sur les seules récompenses de minage de liquidité, il ne s’applique pas à l’émission globale.

La durée de verrouillage est libre entre 1 semaine et 4 ans. Plus la durée choisie est longue, plus la conversion du KAL en veKAL est favorable. Pour verrouiller, ouvrez https://app.kalmydas.com/gouvernance 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, selon la formule linéaire du KAL verrouillé multiplié par la durée puis divisé par 4 ans. Validez la transaction.

Le poids en veKAL décroît ensuite linéairement jusqu’à l’échéance, avec une résolution hebdomadaire. À l’expiration de la durée choisie, vous récupérez vos KAL initiaux. Les sommes déjà perçues, indemnité de service technique en USDC et récompenses de liquidité, restent acquises. Vous pouvez aussi prolonger votre verrouillage avant l’échéance, la nouvelle durée devant toujours respecter les bornes de 1 semaine et de 4 ans.

Le contrat FeeShareBooster est déployé et peut majorer la part versée aux détenteurs de veKAL. Aucun barème n’est publié dans cette documentation. Le seul barème opposable est celui que l’application affiche au moment de votre opération, ne présumez aucun facteur avant de verrouiller.

Toute personne détenant au moins 1 pour cent du veKAL en circulation peut déposer une proposition de gouvernance. Une proposition porte au maximum 10 actions, et un même auteur doit attendre 24 heures entre 2 dépôts. Toute personne détenant un veKAL non nul peut voter pour, contre, ou s’abstenir. Les propositions portent sur 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/gouvernance, elles y sont listées sur la même page que le verrouillage. Chaque proposition affiche son auteur, son objet, le code complet des actions à exécuter en cas d’adoption, ses dates d’ouverture et de clôture, ainsi que l’état du décompte des votes. La période de vote est de 3 jours. Elle est paramétrable par le propriétaire des contrats entre 1 et 14 jours, et toute modification est publique.

Pour voter, sélectionnez la proposition et cliquez sur « Pour », « Contre » ou « Abstention », puis validez la transaction. Votre poids dans le scrutin est déterminé par votre veKAL à l’instantané pris lors du dépôt de la proposition, pas au moment où vous votez. Cette mécanique neutralise par construction les attaques dites de verrouillage éclair, qui consistent à verrouiller juste avant un vote pour faire pencher la balance.

L’adoption exige 2 conditions à la clôture. Le total des voix exprimées, abstentions comprises, doit représenter au moins 10 pour cent du veKAL en circulation à l’instantané, et le total des voix favorables doit dépasser le total des voix défavorables.

Une proposition adoptée n’est pas exécutable immédiatement. Un délai de 48 heures s’écoule avant qu’elle puisse l’être, puis l’exécution doit intervenir dans les 7 jours, faute de quoi la proposition expire et doit être redéposée. Ce délai de 48 heures est porté par le contrat de gouvernance. Il ne se confond pas avec les constantes du contrat de temporisation, qui sont de 24 heures de délai minimum, 7 jours de délai maximum et 48 heures de fenêtre d’exécution. Pendant ces périodes, le retrait de vos dépôts reste possible dans les conditions ordinaires du pool.

Si vous détenez du veKAL, vous percevez chaque semaine une part des frais de performance du protocole, libellée en USDC. 10 pour cent des frais de performance sont versés aux détenteurs de veKAL, au titre de l’indemnité de service technique qui rétribue la fourniture du service de sécurisation au protocole. Le contrat FeeDistributor calcule votre part au prorata de votre veKAL au début de la période et la rend disponible après la clôture hebdomadaire. Le versement est en USDC, immédiatement utilisable hors de l’écosystème.

Pour récupérer les sommes accumulées, ouvrez https://app.kalmydas.com/fee-sharing et cliquez sur « Récupérer ». L’application liste les semaines pour lesquelles un montant vous revient. Une seule transaction suffit pour tout récupérer en bloc, vous pouvez aussi choisir une semaine précise. Les fonds sont transférés directement sur votre adresse.

Le contrat FeeShareBooster peut ajouter une part supplémentaire à ce versement. Elle apparaît séparément dans l’interface, la part standard et la part additionnelle restant distinctes. Comme indiqué à l’étape précédente, aucun barème n’est publié dans cette documentation.

Chaque pool de stratégie dispose de 2 fonctions de protection ajoutées en avril 2026. La sortie d’urgence vous rend la totalité de votre position en une seule transaction, au prix de part courant et sans frais supplémentaire. 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 réserve sur https://app.kalmydas.com/pool/HORIZON (en remplaçant HORIZON par le nom de votre stratégie), 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 2 mécanismes sont déclenchés par vous seul, et personne ne peut vous forcer à sortir. Une limite doit en revanche être dite clairement. La sortie d’urgence porte, dans le contrat KalPool, le même verrou de pause que le retrait ordinaire : si le propriétaire des contrats met le pool en pause, elle devient indisponible tant que la pause dure. Ce verrou a été ajouté volontairement par un correctif de sécurité, pour empêcher qu’une sortie s’exécute sur une comptabilité de parts figée ou faussée. La propriété des contrats repose aujourd’hui sur un portefeuille multisignature à un seul signataire, et c’est le principal risque résiduel que nous publions. Voir la page Audits de sécurité.

La pause individuelle, elle, n’est soumise à aucun verrou. Elle reste activable même si le pool est en pause globale, parce qu’elle ne déplace aucun fonds : elle inscrit un signal que le robot opérateur lit pour cesser d’ouvrir des positions avec la fraction de capital correspondant à vos parts.

Le marché principal du KAL est le contrat KalSwapV2, un teneur de marché automatisé inspiré d’Uniswap V2. La première version du contrat, KalSwap, n’est plus approvisionnée depuis le 5 juin 2026 et n’a plus vocation à être utilisée. En apportant simultanément du KAL et de l’USDC à la réserve KAL/USDC, vous recevez un jeton de part qui matérialise votre quote-part dans cette réserve, et vous percevez une fraction des frais d’échange chaque fois qu’un autre participant échange par cette paire.

Pour fournir de la liquidité, ouvrez https://app.kalmydas.com/liquidity. L’application vous demande une quantité, en KAL ou en USDC, et calcule la quantité équivalente de l’autre jeton à apporter, selon le ratio courant de la réserve. Validez les 2 transactions, l’autorisation de chaque jeton puis le dépôt en réserve.

En sus des frais d’échange, vous recevez une part de l’émission de KAL programmée par le contrat LiquidityRewardsV6_3. Le minage de liquidité est plafonné à 150 000 KAL au total, soit 1,5 pour cent du plafond dur de 10 millions de KAL, répartis entre 3 réserves pondérées à 50, 30 et 20 pour cent. L’émission suit un modèle de halving : le plafond d’une époque de 730 jours est divisé par 2 à l’époque suivante. Votre part est calculée au prorata de votre quote-part dans la réserve, puis amplifiée par votre facteur veKAL si vous verrouillez en parallèle, jusqu’à 2,5 fois.

Pour retirer votre liquidité, l’opération est symétrique : vous rendez votre jeton de part au contrat et récupérez le KAL et l’USDC correspondants, au ratio de la réserve à cet instant. Ce ratio évolue avec les échanges, la valeur retirée peut donc différer de la valeur apportée, en plus ou en moins, selon l’évolution du prix relatif des 2 jetons.