How yunus-0x/meridian works
Meridian is an autonomous Solana liquidity-management agent. Its scheduled screening and management cycles gather pool/position data, let role-specific LLM agents select tool actions, then deploy, monitor, claim fees, or close Meteora DLMM positions. Closed-position outcomes feed lessons and screening-threshold evolution. The README also documents Telegram chat and alerts, optional Discord signals, and a terminal CLI. Several internal calls are supported by the SOURCE INDEX rather than sampled call sites; optional or externally mediated links are marked dashed where appropriate.
Main entry points: executor.js Tool execution · index.js Cycle orchestrator · agent.js Agent harness · screening.js Pool screening
Components 22
Agent runtime
- Cycle orchestrator
index.js - Agent harness
agent.js - Prompt assembly
prompt.js - Runtime configuration
config.js
Screening and trading
- Pool screening
tools/screening.js - Tool execution
tools/executor.js - Position operations
tools/dlmm.js - Wallet and swaps
tools/wallet.js - Token research
tools/token.js
Memory and learning
- Position state
state.js - Decision history
decision-log.js - Performance learning
lessons.js - Pool history
pool-memory.js - Signal weights
signal-weights.js
User interfaces
- Telegram interface
telegram.js - Terminal interface
cli.js - Discord listener
discord-listener/index.js
External integrations
- Solana network
- Pool and token APIs
- OpenRouter models
- Meridian API
Other components
- Operator
Connections 28
- Operator → Cycle orchestrator: starts
README.md - Cycle orchestrator → Agent harness: runs cycles
index.js - Agent harness → Prompt assembly: builds prompts
agent.js - Agent harness → Tool execution: dispatches tools
agent.js - Prompt assembly → OpenRouter models: requests reasoning
README.md - Cycle orchestrator → Pool screening: fetches candidates
index.js - Cycle orchestrator → Position operations: checks positions
index.js - Cycle orchestrator → Telegram interface: sends reports
index.js - Tool execution → Pool screening: invokes screening
tools/executor.js - Tool execution → Position operations: invokes position tools
tools/executor.js - Tool execution → Wallet and swaps: invokes wallet tools
tools/executor.js - Tool execution → Token research: invokes token tools
tools/executor.js - Tool execution → Position state: updates position state
tools/executor.js - Position operations → Solana network: submits transactions
tools/dlmm.js - Wallet and swaps → Solana network: reads balances
tools/wallet.js - Pool screening → Pool and token APIs: queries pool data
README.md - Token research → Pool and token APIs: queries token data
tools/token.js - Position operations → Performance learning: records outcomes
tools/dlmm.js - Performance learning → Pool history: updates pool history
lessons.js - Performance learning → Signal weights: recalculates weights
lessons.js - Agent harness → Decision history: logs decisions
README.md - Agent harness → Position state: loads live state
README.md - Telegram interface → Cycle orchestrator: requests agent actions
README.md - Operator → Terminal interface: issues commands
README.md - Terminal interface → Tool execution: runs tool actions
cli.js - Discord listener → Meridian API: queues signals
README.md - Pool screening → Meridian API: loads signal candidates
tools/screening.js - Meridian API → Pool screening: provides signal candidates
README.md