HyperCHAN

🚀 HyperCHAN: Intelligent Agent Service and Telegram Trading Bot

Features:

• Auto LP Farmer (ALF): Goal-based agent for personal automated LP repositioning using LiquidSwap.
• LiquidLaunch: LiquidLabs fair token launchpad
• LiquidSwap: LiquidLabs HyperEVM aggregator

Components:

• ALF: HyperCHAN Auto Liquidity Position (LP) Farmer
• HyperCHAN_bot: https://t.me/HyperCHAN_bot

🔍 Description

HyperCHAN_bot: Telegram Bot

• LiquidLaunch: Fair token launchpad with creation alerts and instant token buying at launch
• LiquidSwap: HyperEVM aggregator for swaps, also powering ALF repositioning
• ALF: One-click V3 Liquidity Positions (LP) and personal automated repositioning
• UX: Persistent menu with no clutter and only one command

HyperCHAN_bot Main Menu:
Minimum Viable Product Platform for ALF

ALF: Auto LP Farmer Application

• Simulate the cheapest price range to enter using your selection, balance, and required deposits or swaps
• One-click LP creation with automated calculations and transactions handled for you
• Automated repositioning available for all V3 positions
• Funds and LPs remain in your wallet, with the ability to cancel or stop anytime

ALF Telegram Interface Main Menu

Possible Next Steps: App to DApp

• Smart contract interface for a hybrid decentralised, private server agent service
• Agent operation through prior approval for autonomous execution
• Non-custodial personal automated LP repositioning
• Extendable architecture for other intelligent agent implementations

Possible Development Pipeline (adapted from 42 Productions, 2008)

🛠️ How It Works

HyperCHAN_bot: Telegram Bot

• LiquidLaunch and LiquidSwap integrated with the LiquidLabs ABI/API
• Command flow: start -> @Your_Bot -> command start -> use persistent menu
• Use your HyperCHAN key or import a key, deposit/withdraw/bridge with your wallet app
• ALF integration automatically uses your default wallet

HyperCHAN_bot is written in JavaScript and runs on Node.js. It manages multiple processes with ALF as a separate application. (See appendix for file structure).

ALF: Auto LP Farmer Application

• Choose tokens, pool fee, range, funding to create an LP with one click
• When enabled, ALF autonomously manages LP repositioning
• Build on a listen-think-act architecture (see figure 2.13 for design reference)
• Listens for percept input, evaluates world state and action outcomes, applies goals to select and execute actions

ALF is a goal-based agent using the above implementation (Russell & Norvig, 2020, Fig 2.13)

This model-based goal-driven agent is more technical to implement, but it is easily customizable. Additional behaviours can be added to the same agent by introducing more goals and actions, provided there are appropriate percept inputs and sufficient modeling. ALF currently supports three simple custom strategy options: reposition with center bias, early reposition bias, and reposition with time delay.

💻 Demo

Video/YouTube[HD]: https://www.youtube.com/watch?v=l54e7hxYYT0

📂 Project Links

Twitter/X: https://x.com/HyperCHAN_hl

Discord Server: https://discord.gg/NKarZHkF3d

Telegram Bot: https://t.me/HyperCHAN_bot

Code: Closed Source, Uploaded to Proton, Public link sent to @hl_hackathon by direct message

Code (Password Protected Zip): https://drive.proton.me/urls/JABAB4MAGG#PIBxKpSx7763

🐱 Dev

Twitter/X: https://x.com/hyperchan_dev

Telegram: https://t.me/hyperchan_dev

Discord: hyperchan_dev

📚 References

• 42 Productions. (2008). Caterpie Metapod Butterfree [Digital artwork]. DeviantArt. https://www.deviantart.com/42productions/art/Caterpie-Metapod-Butterfree-80194544
• Russell, S., & Norvig, P. (2020). Artificial Intelligence: A Modern Approach (4th ed.). Pearson.

🗄 Appendix

Runtime Environment

• Node.js https://nodejs.org/en

Runtime Information

Entry Point:

• launcher.js
• one process

Telegram Bot:

• worker.js
• one process per telegram bot token

ALF:

• farmer.js
• one process per telegram bot token

Total Processes:

• Total Processes = 1 + 2 x number of telegram bot tokens
  
  

File Structure

• 15 directories
• 137 files

.
├── actions
│   ├── actionLLTokenBuy.js
│   ├── actionLLTokenSell.js
│   ├── actionsAlerts.js
│   ├── actionsALF
│   │   ├── actionALFAmount.js
│   │   ├── actionALFClose.js
│   │   ├── actionALFCollect.js
│   │   ├── actionALFConfirm.js
│   │   ├── actionALFDemo.js
│   │   ├── actionALFGas.js
│   │   ├── actionALFRange.js
│   │   ├── actionALFStart.js
│   │   ├── actionALFStop.js
│   │   ├── actionALFTokenA.js
│   │   └── actionALFTokenB.js
│   ├── actionsALF.js
│   ├── actionsLL.js
│   ├── actionsLS
│   │   ├── actionLSEditSwap.js
│   │   ├── actionLSGas.js
│   │   ├── actionLSQuote.js
│   │   ├── actionLSSlippage.js
│   │   ├── actionLSSwap.js
│   │   ├── actionLSTokenIn.js
│   │   └── actionLSTokenOut.js
│   ├── actionsLS.js
│   ├── actions_requestPrivateKey.js
│   ├── actionsWorker.js
│   └── mainActions.js
├── alf
│   ├── adjustBigInt.js
│   ├── alfActionError.js
│   ├── alfClose.js
│   ├── alfCollect.js
│   ├── alf.js
│   ├── alfPrepareAndCreate.js
│   ├── alfSimulate.js
│   ├── alfStart.js
│   ├── closer.js
│   ├── generatePositions.js
│   ├── getGasPrice.js
│   ├── getLpRatio.js
│   ├── getLpTokenAmounts.js
│   ├── getRange.js
│   ├── getRx.js
│   ├── increaser.js
│   ├── minter.js
│   ├── observer.js
│   ├── positionActive.js
│   ├── reppaws.js
│   ├── swapper.js
│   ├── uncollectedFees.js
│   └── v3Math.js
├── bot
│   ├── bot.js
│   └── router_bot.js
├── commands
│   └── myCommands.js
├── config
│   ├── abiHSV3Nft.js
│   ├── abiHSV3PoolFactory.js
│   ├── abiHSV3Pool.js
│   ├── abiPrjXNft.js
│   ├── abiPrjXPoolFactory.js
│   ├── ERC20_ABI.js
│   ├── getAlfConfig.js
│   ├── rpc_url.js
│   └── WHYPE_ABI.js
├── farmer.js
├── launcher.js
├── menu
│   ├── menuAlerts.js
│   ├── menuALF
│   │   ├── menuALFAmount.js
│   │   ├── menuALFClose.js
│   │   ├── menuALFCollect.js
│   │   ├── menuALFCreate.js
│   │   ├── menuALFFee.js
│   │   ├── menuALFGas.js
│   │   ├── menuALFmain.js
│   │   ├── menuALFPosition.js
│   │   ├── menuALFPositions.js
│   │   ├── menuALFRange.js
│   │   ├── menuALFSimulate.js
│   │   ├── menuALFSlippage.js
│   │   ├── menuALFTokenA.js
│   │   └── menuALFTokenB.js
│   ├── menu.js
│   ├── menuLL
│   │   ├── menuLLBuyHype.js
│   │   ├── menuLLBuyList.js
│   │   ├── menuLLBuyPercent.js
│   │   ├── menuLLGasBase.js
│   │   ├── menuLLGasFlat.js
│   │   ├── menuLLGas.js
│   │   ├── menuLLMain.js
│   │   ├── menuLLSellList.js
│   │   └── menuLLSellPercent.js
│   ├── menuLS
│   │   ├── menuLSEditHype.js
│   │   ├── menuLSEditPercent.js
│   │   ├── menuLSGasBase.js
│   │   ├── menuLSGasFlat.js
│   │   ├── menuLSGas.js
│   │   ├── menuLSMain.js
│   │   ├── menuLSQuote.js
│   │   ├── menuLSSlippage.js
│   │   ├── menuLSTokenIn.js
│   │   └── menuLSTokenOut.js
│   ├── menuMain.js
│   └── menuWallet.js
├── scenes
│   ├── sceneLiquidswapTokenIn.js
│   ├── sceneLLBuyHype.js
│   ├── sceneLLBuyPercent.js
│   ├── sceneLLGasBase.js
│   ├── sceneLLGasFlat.js
│   ├── sceneLLSellPercent.js
│   ├── sceneLSEditHype.js
│   ├── sceneLSEditPercent.js
│   ├── sceneLSGasBase.js
│   ├── sceneLSGasFlat.js
│   ├── sceneLSQuote.js
│   ├── sceneLSSlippage.js
│   ├── scenesAlertsDevBuy.js
│   ├── scenesAlertsDev.js
│   ├── scenesAlertsName.js
│   ├── scenesAlertsSymbol.js
│   └── scenes.js
├── services
│   ├── ALFGetPrice.js
│   ├── ALFGetRoute.js
│   ├── liquidlaunchAbi.js
│   ├── LLBuy.js
│   ├── LLEstimateBuy.js
│   ├── LLEstimateSell.js
│   ├── LLSell.js
│   ├── LLTokenCreatedAlert.js
│   ├── LLTokenCreated.js
│   ├── LSExecuteSwap.js
│   └── LSGetRoute.js
├── utils
│   ├── databaseALF.js
│   ├── database.js
│   ├── databaseLLAlerts.js
│   ├── databaseLL.js
│   ├── databaseLLTokenCreated.js
│   ├── databaseLS.js
│   └── dbRegistry.js
└── worker.js

15 directories, 137 files