From 6b290e381aaac6d5d5b2114fc6eea321711278ea Mon Sep 17 00:00:00 2001 From: ays-tech <54658247+ays-tech@users.noreply.github.com> Date: Sun, 17 Aug 2025 08:26:31 +0000 Subject: [PATCH 1/2] added badges and Architecture --- .env.local | 1 + README.md | 96 +++++++++++++++++++++++++++++++++++--------- docs/contributing.md | 21 +++++++--- package-lock.json | 13 ++++++ utils/signal.ts | 2 + 5 files changed, 107 insertions(+), 26 deletions(-) create mode 100644 .env.local create mode 100644 package-lock.json diff --git a/.env.local b/.env.local new file mode 100644 index 0000000..be6cad6 --- /dev/null +++ b/.env.local @@ -0,0 +1 @@ +# No required environment variables yet diff --git a/README.md b/README.md index 2cd120f..0ea1b8d 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,29 @@ # Eremos -![Eremos](docs/banner2.png) +![Eremos Banner](docs/banner2.png) + +[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) +[![Contributors](https://img.shields.io/github/contributors/EremosCore/Eremos.svg)](https://github.com/EremosCore/Eremos/graphs/contributors) +[![Twitter Follow](https://img.shields.io/twitter/follow/EremosCore?style=social)](https://twitter.com/EremosCore) +[![Solana Ecosystem](https://img.shields.io/badge/Built%20for-Solana-blueviolet)](https://solana.com/) +[![Swarm Agents](https://img.shields.io/badge/Swarm-Ready-green)](https://docs.solana.com/developing/on-chain-programs) +[![Build Status](https://img.shields.io/badge/Build-Passing-brightgreen.svg)](https://github.com/EremosCore/Eremos/actions) + **Autonomous swarm agents for early on-chain signal detection** -Eremos is a lightweight framework for deploying modular agents that monitor blockchain activity - tracking wallet clusters, mint patterns, and contract anomalies. -Designed for devs who want low-noise, early signals embedded into their workflows. +Eremos is a lightweight framework for deploying modular agents that monitor blockchain activity - tracking wallet clusters, mint patterns, and contract anomalies. Designed for devs who want low-noise, early signals embedded into their workflows. + +## Table of Contents +- [Features](#features) +- [Example Signal](#example-signal) +- [Signal Confidence](#signal-confidence) +- [Tech Stack](#tech-stack) +- [Getting Started](#getting-started) +- [Key Folders](#key-folders) +- [Contributing](#contributing) +- [License](#license) +- [Links](#links) --- @@ -18,25 +36,57 @@ Designed for devs who want low-noise, early signals embedded into their workflow *The first deployed agent in the swarm. Passive. Pattern-sensitive. Modular and extendable by design.* - **Agent-001 Coming Soon** [Teaser #1](https://x.com/EremosCore/status/1949154939923833239), [Teaser #2](https://x.com/EremosCore/status/1954856345284567218) --- ## Features -- **Modular Agents** - Scoped logic for detecting wallet activity, contract spawns, and anomalies -- **Signal Emission** - Structured signals for logging, alerting, or downstream use -- **Swarm Design** - Each agent operates independently with shared utilities -- **Extensible Core** - Plug in watchers, inference layers, or custom triggers -- **Minimal Output** - Log only what matters -- **Launch Wallet Detection** - Agents can trace freshly funded wallets (e.g. from CEXs), track their contract interactions, and flag high-confidence deploys in real time -- **Ghost Watcher** - Monitors long-dormant wallets that suddenly become active again. Useful for tracing old dev wallets or rug setups. -- *+ More to come.* +Eremos empowers Solana devs with autonomous agents that deliver actionable insights. Key features include: +| Feature | Description | +|--------------------------|-----------------------------------------------------------------------------| +| **Modular Agents** | Scoped logic for detecting wallet activity, contract spawns, and anomalies. | +| **Signal Emission** | Structured signals for logging, alerting, or downstream integration. | +| **Swarm Design** | Independent agents with shared utilities for scalable monitoring. | +| **Extensible Core** | Easily plug in custom watchers, inference layers, or triggers. | +| **Minimal Output** | Logs only high-relevance signals to reduce noise. | +| **Launch Wallet Detection** | Traces fresh funding from CEXs (e.g., Kraken) and flags high-confidence deploys in real-time. | +| **Ghost Watcher** | Monitors dormant wallets for sudden activity, spotting potential rugs or dev revivals. | +| **And More** | Upcoming agents for NFT mints, DeFi pools, and memecoin patterns. | ---- +--- +## Architecture + +```mermaid +flowchart LR + subgraph OnChain[On-Chain Activity] + TX[Transactions] --> DEP[Deployments] + DEP --> FLOWS[Funding Flows] + end + + subgraph Agents + OBS[Observer Agent] --> SIG[Structured Signal] + MEM[Memory Agent] --> SIG + TRIG[Trigger Agent] --> SIG + end + + OnChain --> OBS + OBS --> MEM + MEM --> TRIG + + subgraph Consumers + DASH[Dashboards] + ALERTS[Alerts/Logs] + APPS[Consumer Apps] + end + + SIG --> DASH + SIG --> ALERTS + SIG --> APPS +``` +--- ## Example Signal An example signal emitted by an agent detecting a live token deployment: @@ -94,6 +144,9 @@ Set up your environment: ```bash cp .env.example .env.local +``` +Configure your Solana RPC in .env.local (e.g., RPC_URL=https://api.mainnet-beta.solana.com) for real-time agent monitoring +```bash npm run dev ``` @@ -111,22 +164,25 @@ npm run dev ## Contributing -We’re open to contributors. -If you are experienced in TypeScript and like agent-based systems, check `example.ts` and build your own observer. -If you're a designer, artist, or just have ideas that fit the mythos - send us a DM on Twitter. [@EremosCore](https://x.com/EremosCore) +We’re open to contributors. +If you are experienced in TypeScript and like agent-based systems, check example.ts and build your own observer. If you're a designer, artist, or just have ideas that fit the mythos - send us a DM on Twitter. @EremosCore --- ## License - MIT Β© Eremos LLC + --- ## Links -- **Twitter/X:** [@EremosCore](https://x.com/EremosCore) -- **Website:** [Eremos.io](https://www.eremos.io/) -- **Whitepaper:** [v1.0 PDF](docs/whitepaper.pdf) +[![Last Commit](https://img.shields.io/github/last-commit/EremosCore/Eremos.svg)](https://github.com/EremosCore/Eremos/commits/main) +[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/EremosCore/Eremos/pulls) +[![Made with TypeScript](https://img.shields.io/badge/Made%20with-TypeScript-3178c6.svg)](https://www.typescriptlang.org/) + +- **Twitter/X:** [@EremosCore](https://x.com/EremosCore) +- **Website:** [Eremos.io](https://www.eremos.io/) +- **Whitepaper:** [v1.0 PDF](docs/whitepaper.pdf) _Maintained by the Eremos Core team πŸ’›._ diff --git a/docs/contributing.md b/docs/contributing.md index 979d520..b96ec44 100644 --- a/docs/contributing.md +++ b/docs/contributing.md @@ -1,9 +1,18 @@ -# Contributing to Eremos +# Contributing to Eremos -We're open to signal logic, new agents, and utility extensions. +Eremos is a public good for Solana transparency β€” thanks for helping build the swarm! +We welcome TypeScript devs, designers, and on-chain analysts to extend the framework. -- Fork the repo -- Work on a new agent in `/agents` -- Use `/scripts/dev-agent.ts` to simulate +## How to Contribute +1. **Fork & Branch** β†’ `git checkout -b feat/my-agent` +2. **Install Deps** β†’ `npm install` +3. **Develop** β†’ build or modify an agent under `/agents` + - Use `/scripts/dev-agent.ts` to simulate events locally + - Ensure your Solana RPC is set in `.env.local` +4. **Commit & PR** β†’ keep commits clean, titles descriptive, and avoid bloat -Push clean commits. Avoid bloat. +## Contribution Ideas +- **Agents** β†’ Extend `/agents` with new watchers +- **Signal Logic** β†’ Improve confidence scoring in `/utils` +- **Docs** β†’ Add/update diagrams, improve README or whitepaper +- **Good First Issues** β†’ Check labels like `good-first-issue` (e.g. add tests to `example.ts`) diff --git a/package-lock.json b/package-lock.json new file mode 100644 index 0000000..0c5bb7b --- /dev/null +++ b/package-lock.json @@ -0,0 +1,13 @@ +{ + "name": "eremos-core", + "version": "0.1.0", + "lockfileVersion": 2, + "requires": true, + "packages": { + "": { + "name": "eremos-core", + "version": "0.1.0", + "license": "MIT" + } + } +} diff --git a/utils/signal.ts b/utils/signal.ts index 93ca284..22b5c39 100644 --- a/utils/signal.ts +++ b/utils/signal.ts @@ -3,3 +3,5 @@ export function generateSignalHash(event: any): string { const hash = Buffer.from(base).toString("base64").slice(0, 10); return "sig_" + hash; } + + From 6bbf4c71c86bede6c952cf50844f49e09a6f95ab Mon Sep 17 00:00:00 2001 From: ays-tech <54658247+ays-tech@users.noreply.github.com> Date: Sun, 17 Aug 2025 09:09:59 +0000 Subject: [PATCH 2/2] added emojis for some headers --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 0ea1b8d..7563731 100644 --- a/README.md +++ b/README.md @@ -14,8 +14,9 @@ Eremos is a lightweight framework for deploying modular agents that monitor blockchain activity - tracking wallet clusters, mint patterns, and contract anomalies. Designed for devs who want low-noise, early signals embedded into their workflows. -## Table of Contents +## Table of Contents πŸ“š - [Features](#features) +- [Architecture](#architecture) - [Example Signal](#example-signal) - [Signal Confidence](#signal-confidence) - [Tech Stack](#tech-stack) @@ -24,7 +25,6 @@ Eremos is a lightweight framework for deploying modular agents that monitor bloc - [Contributing](#contributing) - [License](#license) - [Links](#links) - ---

@@ -111,7 +111,7 @@ An example signal emitted by an agent detecting a live token deployment: --- -## Signal Confidence +## Signal Confidence πŸ’‘ Each emitted signal includes a `confidence` score (0-1) based on behavioral heuristics: - CEX-origin funding (e.g. Kraken, Coinbase) @@ -152,7 +152,7 @@ npm run dev --- -## Key Folders +## Key Folders - `/agents` - Agent templates + logic - `/utils` - Shared signal/logging utilities