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.

La connexion se fait sur home.kalmydas.com. L’écran de connexion propose trois portes : kal pay, le portefeuille de l’écosystème, qui se crée sur place en une minute ; MetaMask ou tout portefeuille installé dans votre navigateur ; et WalletConnect, pour un portefeuille sur téléphone. Toutes ouvrent exactement les mêmes droits sur le protocole, et aucune ne demande de compte, de mot de passe ou de courriel.

Pour vous connecter, ouvrez https://home.kalmydas.com et touchez « Connecter un portefeuille ». Choisissez votre porte et suivez les instructions. Une fois la connexion validée, votre adresse apparaît dans 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 est un jeton non fongible et non transférable. Sans Pass actif, le contrat de la stratégie refuse le dépôt. Le retrait, lui, reste possible sans Pass. Un portefeuille ne détient qu’un Pass actif à la fois. Pendant une période d’entrée libre annoncée sur home, le dépôt est ouvert sans Pass. Cette entrée libre n’ouvre pas les salons de la messagerie.

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 % de réduction. Or coûte 2,50 USDC par jour et ouvre 10 %. Diamant coûte 5,00 USDC par jour, ouvre 15 % 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 prendre un Pass, ouvrez https://home.kalmydas.com/v2.1/strategies/. Choisissez le niveau, la durée, de 1 à 365 jours avec une remise qui monte jusqu’à 30 % sur une année, et la monnaie de règlement, USDC ou KAL. Touchez « Prendre ce Pass » et signez. Le paiement en KAL bénéficie d’un rabais de 30 %, et le KAL reçu n’est jamais brûlé. 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.

L’état du protocole et de la prévente, palier ouvert compris, se lit en direct dans l’application, sur home.kalmydas.com. Cette documentation n’en publie ni date, ni montant, ni compte à rebours, parce que ces valeurs bougent.

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://home.kalmydas.com/v2.1/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. Les plafonds vont de 500 à 3 000 USDC selon le niveau, 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 % sur le Niveau 0 Amorçage, 10 % sur le Niveau 1 Stratégique et 5 % 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. L’enveloppe totale de la prévente est de 500 000 KAL : ce plafond, plus les 7 202 KAL déjà remis par le contrat de prévente précédent, hors service depuis le 19 juillet 2026. 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.

6 pools de stratégie sont déployés, HORIZON, VALKYRIE, REVOLUTION, TREASURY et ORION sur l’or (XAUUSD), GENESIS sur le bitcoin. Chacun met en œuvre un algorithme distinct. L’état de chacun s’affiche sur sa carte dans l’application, y compris le fait qu’il accepte ou non un dépôt. 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://home.kalmydas.com/v2.1/strategies/ : chaque stratégie y a sa carte. Sa fiche détaillée, par exemple https://home.kalmydas.com/v2.1/pool/ORION/, indique la performance simulée, l’enfoncement maximal observé en simulation et les frais. Le montant minimum est lu sur le contrat et affiché au dépôt. Saisissez le montant sur la carte de la stratégie et signez. Vous recevez des parts au prix de part du moment. Votre dépôt est une part d’un livre tenu par le protocole. Le robot travaille avec la réserve du protocole. Votre dépôt porte sa part des gains et des pertes de cette réserve et peut baisser jusqu’à zéro.

Une fois la position ouverte, vous la suivez sur la page de transparence, https://home.kalmydas.com/v2.1/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 20 % sur chaque stratégie et de 10 % pour un dépôt en KAL. Ces taux se lisent sur chaque contrat de pool.

Aucun frais de gestion n’est prélevé, le taux est à zéro sur les contrats en service. Le contrat de pool prévoit ce prélèvement mensuel et le plafonne à 5 % par mois ; le taux est réglable par le propriétaire des contrats, et tout prélèvement figurerait dans l’historique de votre position.

Aucune durée de blocage ne s’applique à votre position. Vous retirez sans Pass et sans délai, au prix de part du moment, dans la limite de l’USDC présent dans le pool. Le retrait n’est suspendu que pendant une pause d’urgence décidée par le propriétaire du contrat.

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. Pour GENESIS, la stratégie sur le bitcoin, l’avertissement est le suivant. Simulation rétrospective algorithmique sur données historiques BTCUSD (2013-2026). Aucun historique d’exécution réelle sur la blockchain. Risque de perte partielle ou totale du capital. Les simulations passées ne préjugent pas des résultats futurs.

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é, 1 + 1,5 × (votre veKAL ÷ veKAL total), plafonné à 2,5. 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://home.kalmydas.com/v2.1/vekal/ et choisissez de 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 % 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://home.kalmydas.com/v2.1/gouvernance/, elles y sont listées. 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 % 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 % 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://home.kalmydas.com/v2.1/vekal/. L’écran affiche ce qui vous revient au titre de l’indemnité de service technique et le geste pour le réclamer. 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.

Vous sortez par le retrait ordinaire, depuis la carte de la stratégie sur home.kalmydas.com. Vous retirez sans Pass et sans délai, au prix de part du moment, dans la limite de l’USDC présent dans le pool. Le retrait n’est suspendu que pendant une pause d’urgence décidée par le propriétaire du contrat. Vous recevez de l’USDC au prix de part du moment. Si la réserve a reculé, ce montant peut être inférieur à votre dépôt, jusqu’à zéro.

Une limite doit être dite clairement. Le retrait est suspendu si le propriétaire des contrats met le pool en pause globale, tant que la pause dure. Les 6 pools de stratégie en service sont en rodage. Pendant leur période de rodage, ces contrats appartiennent à la clé de déploiement du protocole. Leur propriété passera ensuite au multisig. C’est le principal risque résiduel que nous publions. Voir la page Audits de sécurité.

Le marché du KAL dans l’écosystème repose sur des réserves de liquidité automatisées, dont la paire KAL/USDC. En apportant simultanément du KAL et de l’USDC à une réserve, vous recevez un jeton de part qui matérialise votre quote-part, et vous percevez une fraction des frais chaque fois qu’un autre participant passe par cette paire.

Pour fournir de la liquidité, ouvrez https://home.kalmydas.com/v2.1/liquidite/. 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, une part de l’émission de KAL programmée pour la liquidité peut vous revenir, au prorata de votre quote-part. Son rythme est freiné tant que la liquidité du marché n’est pas installée. La page Liquidité de home affiche ce qui s’applique. Le veKAL augmente votre part de cette émission par un multiplicateur de 1 + 1,5 × (votre veKAL ÷ veKAL total), plafonné à 2,5. Il se recalcule à la mise en jeu, au retrait et à la réclamation. L’écran veKAL propose de l’appliquer après un verrouillage.

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.