EremosCore · ays-tech · Aug 17, 2025 · Aug 17, 2025
diff --git a/.env.local b/.env.local
@@ -0,0 +1 @@
+# No required environment variables yet
diff --git a/README.md b/README.md
@@ -1,12 +1,30 @@
 # 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.
+**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.
+
+## Table of Contents 📚
+- [Features](#features)
+- [Architecture](#architecture)
+- [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)
 ---
 
 <p align="center">
@@ -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:
@@ -61,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)
@@ -94,12 +144,15 @@ 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
 ```
 
 ---
 
-## Key Folders
+## Key Folders 
 
 - `/agents` - Agent templates + logic  
 - `/utils` - Shared signal/logging utilities  
@@ -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
@@ -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
diff --git 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;
 }
+
+
Original file line number	Diff line number	Diff line change
Expand Up		@@ -3,3 +3,5 @@ export function generateSignalHash(event: any): string {
		const hash = Buffer.from(base).toString("base64").slice(0, 10);
		return "sig_" + hash;
		}