diff --git a/.env.example b/.env.example index be6cad6..2bb2913 100644 --- a/.env.example +++ b/.env.example @@ -1 +1,2 @@ -# No required environment variables yet +SOLANA_RPC_URL="https://solana-mainnet.g.alchemy.com/v2/" +ETH_RPC_URL="https://eth-mainnet.g.alchemy.com/v2/" diff --git a/README.md b/README.md index 2cd120f..bcbf570 100644 --- a/README.md +++ b/README.md @@ -37,6 +37,80 @@ Modular and extendable by design.* --- + +## Agents + +The Eremos framework ships with several modular agents. Each one runs independently, watches a chain or activity type, and emits structured signals when something notable happens. + +### SolanaWatcher (◎) +- **Role:** Blockchain Monitor +- **WatchType:** `onchain_activity` +- **Description:** Monitors Solana activity using **HTTP polling** (instead of WebSocket subscriptions for broader RPC compatibility). +- **Behavior:** Emits `high_activity_detected` when a transaction logs at least `N` messages (default: 5). +- **Configurable:** `SOLANA_RPC_URL`, `POLL_INTERVAL`, `ACTIVITY_THRESHOLD` + +### EthereumWatcher (Ξ) +- **Role:** Blockchain Monitor +- **WatchType:** `onchain_activity` +- **Description:** Polls Ethereum L1 blocks via ethers.js HTTP provider. +- **Behavior:** Emits `high_block_activity` if a block has more than `N` transactions (default: 50). +- **Configurable:** `ETH_RPC_URL`, `POLL_INTERVAL`, `ACTIVITY_THRESHOLD` + + +## Example Agent Output + +With the new EthereumWatcher (Ξ) and SolanaWatcher (◎), signals are emitted in a clean narrative form followed by a structured JSON object for downstream use. + +```ts +[SolanaWatcher] → emitting signal (high_activity_detected) at 2025-08-17T21:38:23.592Z +[SolanaWatcher] → signature: 5KdisD3hSpxfFvFvqrr9DwycJifiEkkmB25Wnx88DdNviaE8yA5Et7WqVPEceSCkKddNnhiXsGk6z4D6vokK6j2S +[SolanaWatcher] → logCount: 2 +[SolanaWatcher] → slot: 360742065 +[SolanaWatcher] → preview: ["Program 11111111111111111111111111111111 invoke [1]","Program 11111111111111111111111111111111 success"] + +{ + "type": "high_activity_detected", + "hash": "sig_eyJ0eXBlIj", + "timestamp": "2025-08-17T21:38:23.592Z", + "source": "SolanaWatcher", + "details": { + "signature": "5KdisD3hSpxfFvFvqrr9DwycJifiEkkmB25Wnx88DdNviaE8yA5Et7WqVPEceSCkKddNnhiXsGk6z4D6vokK6j2S", + "logCount": 2, + "slot": 360742065, + "preview": [ + "Program 11111111111111111111111111111111 invoke [1]", + "Program 11111111111111111111111111111111 success" + ] + }, + "agent": "SolanaWatcher", + "glyph": "◎" +} + +[EthereumWatcher] → emitting signal (high_block_activity) at 2025-08-17T21:39:43.933Z +[EthereumWatcher] → blockNumber: 23163521 +[EthereumWatcher] → blockHash: 0xb2b47d3b60c24b2ea83cb3d51301be1d25fdd19451b48b1cf5272db016accaf0 +[EthereumWatcher] → txCount: 241 + +{ + "type": "high_block_activity", + "hash": "sig_eyJ0eXBlIj", + "timestamp": "2025-08-17T21:39:43.933Z", + "source": "EthereumWatcher", + "details": { + "blockNumber": 23163521, + "blockHash": "0xb2b47d3b60c24b2ea83cb3d51301be1d25fdd19451b48b1cf5272db016accaf0", + "txCount": 241 + }, + "agent": "EthereumWatcher", + "glyph": "Ξ" +} +``` + +--- + + + + ## Example Signal An example signal emitted by an agent detecting a live token deployment: @@ -94,7 +168,23 @@ Set up your environment: ```bash cp .env.example .env.local -npm run dev + +Edit .env.local + +# Solana RPC endpoint +SOLANA_RPC_URL="" + +# Ethereum RPC endpoint +ETH_RPC_URL="" + +# Run all agents (default) +npm run dev + +# Run only the Solana watcher (◎) +npm run dev sol + +# Run only the Ethereum watcher (Ξ) +npm run dev eth ``` --- diff --git a/agents/ethereum-watcher.ts b/agents/ethereum-watcher.ts new file mode 100644 index 0000000..06353c1 --- /dev/null +++ b/agents/ethereum-watcher.ts @@ -0,0 +1,93 @@ +import { Agent } from "../types/agent"; +import { ethers } from "ethers"; +import { ETH_RPC_URL } from "../utils/config"; +import { generateSignalHash, createSignal } from "../utils/signal"; +import { logSignal } from "../utils/logger"; + +let provider: ethers.JsonRpcProvider; +let pollHandle: NodeJS.Timeout | null = null; + +const POLL_INTERVAL = 1_000; // 1s +const TX_THRESHOLD = 10; + +export const EthereumWatcher: Agent = { + id: "agent-ethereum-watcher", + name: "EthereumWatcher", + role: "blockchain-monitor", + watchType: "onchain_activity", + glyph: "Ξ", + triggerThreshold: TX_THRESHOLD, + lastSignal: null, + originTimestamp: new Date().toISOString(), + description: "Monitors Ethereum blocks with high transaction counts using HTTP polling.", + + init: async () => { + provider = new ethers.JsonRpcProvider(ETH_RPC_URL); + const net = await provider.getNetwork(); + console.log(`[EthereumWatcher] Connected to Ethereum (chainId=${net.chainId})`); + + // Polling loop + pollHandle = setInterval(async () => { + try { + const block = await provider.getBlock("latest", true); // include tx list + if (!block) return; + + EthereumWatcher.observe({ + type: "onchain_activity", + payload: { + blockNumber: block.number, + blockHash: block.hash, + txCount: block.transactions.length, + }, + }); + } catch (err) { + console.error("[EthereumWatcher] Poll error:", err); + } + }, POLL_INTERVAL); + + console.log(`[EthereumWatcher] Polling every ${POLL_INTERVAL / 1000}s for blocks...`); + }, + + observe: (event) => { + if (event?.type !== "onchain_activity") return; + const { blockNumber, txCount, blockHash } = event.payload || {}; + + if (typeof txCount !== "number") return; + + if (txCount >= EthereumWatcher.triggerThreshold) { + const hash = generateSignalHash(event); + + const signal = createSignal({ + type: "high_block_activity", + hash, + timestamp: new Date().toISOString(), + source: EthereumWatcher.name, + details: { blockNumber, blockHash, txCount }, + }); + + if (signal) { + logSignal({ + agent: EthereumWatcher.name, + type: signal.type, + glyph: EthereumWatcher.glyph, + hash: signal.hash, + timestamp: signal.timestamp, + details: signal.details, + }); + EthereumWatcher.lastSignal = signal.hash; + } + } + }, + + getMemory: () => [ + EthereumWatcher.lastSignal || "no_signals_yet", + "watching_ethereum_blocks", + ], + + cleanup: async () => { + if (pollHandle) { + clearInterval(pollHandle); + console.log("[EthereumWatcher] Polling stopped."); + } + }, +}; \ No newline at end of file diff --git a/agents/observer.ts b/agents/observer.ts index 2a6c052..fa95ebf 100644 --- a/agents/observer.ts +++ b/agents/observer.ts @@ -17,3 +17,4 @@ export const Observer: Agent = { } } } + diff --git a/agents/solana-watcher.ts b/agents/solana-watcher.ts new file mode 100644 index 0000000..98a2c82 --- /dev/null +++ b/agents/solana-watcher.ts @@ -0,0 +1,119 @@ +// agents/solana-watcher.ts + +import { Agent } from "../types/agent"; +import { Connection, PublicKey } from "@solana/web3.js"; +import { SOLANA_RPC_URL } from "../utils/config"; +import { generateSignalHash } from "../utils/signal"; +import { logSignal } from "../utils/logger"; + +let connection: Connection; +let pollHandle: NodeJS.Timeout | null = null; +let lastFetched: string | null = null; + +const WATCH_PROGRAM = new PublicKey("11111111111111111111111111111111"); + +// Emit a signal if a tx logs at least this many messages +const SIGNAL_THRESHOLD = 2; +// Poll interval +const POLL_INTERVAL = 1_000; // 1s + +export const SolanaWatcher: Agent = { + id: "agent-solana-watcher", + name: "SolanaWatcher", + role: "blockchain-monitor", + glyph: "◎", + watchType: "onchain_activity", + triggerThreshold: SIGNAL_THRESHOLD, + lastSignal: null, + originTimestamp: new Date().toISOString(), + description: "Monitors Solana for high-activity transactions using HTTP polling.", + + init: async () => { + console.log(`[${SolanaWatcher.name}] Initializing with HTTP RPC: ${SOLANA_RPC_URL}`); + connection = new Connection(SOLANA_RPC_URL, { commitment: "confirmed" }); + + try { + const version = await connection.getVersion(); + console.log(`[${SolanaWatcher.name}] Connected to Solana ${version["solana-core"]}`); + } catch (error) { + console.error(`[${SolanaWatcher.name}] Failed to connect`, error); + } + + // Start polling loop + pollHandle = setInterval(async () => { + try { + const sigs = await connection.getSignaturesForAddress(WATCH_PROGRAM, { + limit: 5, + before: lastFetched ?? undefined, + }); + + if (sigs.length === 0) return; + + // Process oldest → newest + for (const sig of sigs.reverse()) { + const tx = await connection.getParsedTransaction(sig.signature, { + maxSupportedTransactionVersion: 0, + commitment: "confirmed", + }); + + if (tx?.meta?.logMessages) { + SolanaWatcher.observe({ + type: "onchain_activity", + payload: { + signature: sig.signature, + logs: tx.meta.logMessages, + slot: tx.slot, + err: tx.meta.err, + }, + }); + } + + lastFetched = sig.signature; + } + } catch (err) { + console.error(`[${SolanaWatcher.name}] Poll error:`, err); + } + }, POLL_INTERVAL); + + console.log(`[${SolanaWatcher.name}] Polling every ${POLL_INTERVAL / 1000}s for activity...`); + }, + + observe: (event) => { + if (event?.type !== "onchain_activity") return; + const { signature, logs, slot, err } = event.payload; + if (err || !logs) return; + + if (logs.length >= SolanaWatcher.triggerThreshold) { + const hash = generateSignalHash(event); + logSignal({ + agent: SolanaWatcher.name, + type: "high_activity_detected", + glyph: SolanaWatcher.glyph, + hash, + timestamp: new Date().toISOString(), + details: { + signature, + logCount: logs.length, + slot, + preview: logs.slice(0, 3), + }, + }); + + SolanaWatcher.lastSignal = hash; + } + }, + + getMemory: () => [ + SolanaWatcher.lastSignal || "no_signals_yet", + `lastFetched_${lastFetched}`, + `watching_${WATCH_PROGRAM.toBase58()}`, + ], + + cleanup: async () => { + if (pollHandle) { + clearInterval(pollHandle); + console.log(`[${SolanaWatcher.name}] Polling stopped.`); + } + }, +}; + diff --git a/package-lock.json b/package-lock.json new file mode 100644 index 0000000..0d948de --- /dev/null +++ b/package-lock.json @@ -0,0 +1,896 @@ +{ + "name": "eremos-core", + "version": "0.1.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "eremos-core", + "version": "0.1.0", + "license": "MIT", + "dependencies": { + "@solana/web3.js": "^1.98.4", + "dotenv": "^16.4.5", + "ethers": "^6.15.0" + }, + "devDependencies": { + "@types/node": "^20.14.10", + "ts-node": "^10.9.2", + "typescript": "^5.5.3" + } + }, + "node_modules/@adraffy/ens-normalize": { + "version": "1.10.1", + "resolved": "https://registry.npmjs.org/@adraffy/ens-normalize/-/ens-normalize-1.10.1.tgz", + "integrity": "sha512-96Z2IP3mYmF1Xg2cDm8f1gWGf/HUVedQ3FMifV4kG/PQ4yEP51xDtRAEfhVNt5f/uzpNkZHwWQuUcu6D6K+Ekw==" + }, + "node_modules/@babel/runtime": { + "version": "7.28.3", + "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.28.3.tgz", + "integrity": "sha512-9uIQ10o0WGdpP6GDhXcdOJPJuDgFtIDtN/9+ArJQ2NAfAmiuhTQdzkaTGR33v43GYS2UrSA0eX2pPPHoFVvpxA==", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@cspotcode/source-map-support": { + "version": "0.8.1", + "resolved": "https://registry.npmjs.org/@cspotcode/source-map-support/-/source-map-support-0.8.1.tgz", + "integrity": "sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw==", + "dev": true, + "dependencies": { + "@jridgewell/trace-mapping": "0.3.9" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/@jridgewell/resolve-uri": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz", + "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==", + "dev": true, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@jridgewell/sourcemap-codec": { + "version": "1.5.5", + "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz", + "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==", + "dev": true + }, + "node_modules/@jridgewell/trace-mapping": { + "version": "0.3.9", + "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.9.tgz", + "integrity": "sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ==", + "dev": true, + "dependencies": { + "@jridgewell/resolve-uri": "^3.0.3", + "@jridgewell/sourcemap-codec": "^1.4.10" + } + }, + "node_modules/@noble/curves": { + "version": "1.9.7", + "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.9.7.tgz", + "integrity": "sha512-gbKGcRUYIjA3/zCCNaWDciTMFI0dCkvou3TL8Zmy5Nc7sJ47a0jtOeZoTaMxkuqRo9cRhjOdZJXegxYE5FN/xw==", + "dependencies": { + "@noble/hashes": "1.8.0" + }, + "engines": { + "node": "^14.21.3 || >=16" + }, + "funding": { + "url": "https://paulmillr.com/funding/" + } + }, + "node_modules/@noble/hashes": { + "version": "1.8.0", + "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.8.0.tgz", + "integrity": "sha512-jCs9ldd7NwzpgXDIf6P3+NrHh9/sD6CQdxHyjQI+h/6rDNo88ypBxxz45UDuZHz9r3tNz7N/VInSVoVdtXEI4A==", + "engines": { + "node": "^14.21.3 || >=16" + }, + "funding": { + "url": "https://paulmillr.com/funding/" + } + }, + "node_modules/@solana/buffer-layout": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/@solana/buffer-layout/-/buffer-layout-4.0.1.tgz", + "integrity": "sha512-E1ImOIAD1tBZFRdjeM4/pzTiTApC0AOBGwyAMS4fwIodCWArzJ3DWdoh8cKxeFM2fElkxBh2Aqts1BPC373rHA==", + "dependencies": { + "buffer": "~6.0.3" + }, + "engines": { + "node": ">=5.10" + } + }, + "node_modules/@solana/codecs-core": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/@solana/codecs-core/-/codecs-core-2.3.0.tgz", + "integrity": "sha512-oG+VZzN6YhBHIoSKgS5ESM9VIGzhWjEHEGNPSibiDTxFhsFWxNaz8LbMDPjBUE69r9wmdGLkrQ+wVPbnJcZPvw==", + "dependencies": { + "@solana/errors": "2.3.0" + }, + "engines": { + "node": ">=20.18.0" + }, + "peerDependencies": { + "typescript": ">=5.3.3" + } + }, + "node_modules/@solana/codecs-numbers": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/@solana/codecs-numbers/-/codecs-numbers-2.3.0.tgz", + "integrity": "sha512-jFvvwKJKffvG7Iz9dmN51OGB7JBcy2CJ6Xf3NqD/VP90xak66m/Lg48T01u5IQ/hc15mChVHiBm+HHuOFDUrQg==", + "dependencies": { + "@solana/codecs-core": "2.3.0", + "@solana/errors": "2.3.0" + }, + "engines": { + "node": ">=20.18.0" + }, + "peerDependencies": { + "typescript": ">=5.3.3" + } + }, + "node_modules/@solana/errors": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/@solana/errors/-/errors-2.3.0.tgz", + "integrity": "sha512-66RI9MAbwYV0UtP7kGcTBVLxJgUxoZGm8Fbc0ah+lGiAw17Gugco6+9GrJCV83VyF2mDWyYnYM9qdI3yjgpnaQ==", + "dependencies": { + "chalk": "^5.4.1", + "commander": "^14.0.0" + }, + "bin": { + "errors": "bin/cli.mjs" + }, + "engines": { + "node": ">=20.18.0" + }, + "peerDependencies": { + "typescript": ">=5.3.3" + } + }, + "node_modules/@solana/web3.js": { + "version": "1.98.4", + "resolved": "https://registry.npmjs.org/@solana/web3.js/-/web3.js-1.98.4.tgz", + "integrity": "sha512-vv9lfnvjUsRiq//+j5pBdXig0IQdtzA0BRZ3bXEP4KaIyF1CcaydWqgyzQgfZMNIsWNWmG+AUHwPy4AHOD6gpw==", + "dependencies": { + "@babel/runtime": "^7.25.0", + "@noble/curves": "^1.4.2", + "@noble/hashes": "^1.4.0", + "@solana/buffer-layout": "^4.0.1", + "@solana/codecs-numbers": "^2.1.0", + "agentkeepalive": "^4.5.0", + "bn.js": "^5.2.1", + "borsh": "^0.7.0", + "bs58": "^4.0.1", + "buffer": "6.0.3", + "fast-stable-stringify": "^1.0.0", + "jayson": "^4.1.1", + "node-fetch": "^2.7.0", + "rpc-websockets": "^9.0.2", + "superstruct": "^2.0.2" + } + }, + "node_modules/@swc/helpers": { + "version": "0.5.17", + "resolved": "https://registry.npmjs.org/@swc/helpers/-/helpers-0.5.17.tgz", + "integrity": "sha512-5IKx/Y13RsYd+sauPb2x+U/xZikHjolzfuDgTAl/Tdf3Q8rslRvC19NKDLgAJQ6wsqADk10ntlv08nPFw/gO/A==", + "dependencies": { + "tslib": "^2.8.0" + } + }, + "node_modules/@tsconfig/node10": { + "version": "1.0.11", + "resolved": "https://registry.npmjs.org/@tsconfig/node10/-/node10-1.0.11.tgz", + "integrity": "sha512-DcRjDCujK/kCk/cUe8Xz8ZSpm8mS3mNNpta+jGCA6USEDfktlNvm1+IuZ9eTcDbNk41BHwpHHeW+N1lKCz4zOw==", + "dev": true + }, + "node_modules/@tsconfig/node12": { + "version": "1.0.11", + "resolved": "https://registry.npmjs.org/@tsconfig/node12/-/node12-1.0.11.tgz", + "integrity": "sha512-cqefuRsh12pWyGsIoBKJA9luFu3mRxCA+ORZvA4ktLSzIuCUtWVxGIuXigEwO5/ywWFMZ2QEGKWvkZG1zDMTag==", + "dev": true + }, + "node_modules/@tsconfig/node14": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/@tsconfig/node14/-/node14-1.0.3.tgz", + "integrity": "sha512-ysT8mhdixWK6Hw3i1V2AeRqZ5WfXg1G43mqoYlM2nc6388Fq5jcXyr5mRsqViLx/GJYdoL0bfXD8nmF+Zn/Iow==", + "dev": true + }, + "node_modules/@tsconfig/node16": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/@tsconfig/node16/-/node16-1.0.4.tgz", + "integrity": "sha512-vxhUy4J8lyeyinH7Azl1pdd43GJhZH/tP2weN8TntQblOY+A0XbT8DJk1/oCPuOOyg/Ja757rG0CgHcWC8OfMA==", + "dev": true + }, + "node_modules/@types/connect": { + "version": "3.4.38", + "resolved": "https://registry.npmjs.org/@types/connect/-/connect-3.4.38.tgz", + "integrity": "sha512-K6uROf1LD88uDQqJCktA4yzL1YYAK6NgfsI0v/mTgyPKWsX1CnJ0XPSDhViejru1GcRkLWb8RlzFYJRqGUbaug==", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@types/node": { + "version": "20.19.11", + "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.11.tgz", + "integrity": "sha512-uug3FEEGv0r+jrecvUUpbY8lLisvIjg6AAic6a2bSP5OEOLeJsDSnvhCDov7ipFFMXS3orMpzlmi0ZcuGkBbow==", + "dependencies": { + "undici-types": "~6.21.0" + } + }, + "node_modules/@types/uuid": { + "version": "8.3.4", + "resolved": "https://registry.npmjs.org/@types/uuid/-/uuid-8.3.4.tgz", + "integrity": "sha512-c/I8ZRb51j+pYGAu5CrFMRxqZ2ke4y2grEBO5AUjgSkSk+qT2Ea+OdWElz/OiMf5MNpn2b17kuVBwZLQJXzihw==" + }, + "node_modules/@types/ws": { + "version": "7.4.7", + "resolved": "https://registry.npmjs.org/@types/ws/-/ws-7.4.7.tgz", + "integrity": "sha512-JQbbmxZTZehdc2iszGKs5oC3NFnjeay7mtAWrdt7qNtAVK0g19muApzAy4bm9byz79xa2ZnO/BOBC2R8RC5Lww==", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/acorn": { + "version": "8.15.0", + "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz", + "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==", + "dev": true, + "bin": { + "acorn": "bin/acorn" + }, + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/acorn-walk": { + "version": "8.3.4", + "resolved": "https://registry.npmjs.org/acorn-walk/-/acorn-walk-8.3.4.tgz", + "integrity": "sha512-ueEepnujpqee2o5aIYnvHU6C0A42MNdsIDeqy5BydrkuC5R1ZuUFnm27EeFJGoEHJQgn3uleRvmTXaJgfXbt4g==", + "dev": true, + "dependencies": { + "acorn": "^8.11.0" + }, + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/aes-js": { + "version": "4.0.0-beta.5", + "resolved": "https://registry.npmjs.org/aes-js/-/aes-js-4.0.0-beta.5.tgz", + "integrity": "sha512-G965FqalsNyrPqgEGON7nIx1e/OVENSgiEIzyC63haUMuvNnwIgIjMs52hlTCKhkBny7A2ORNlfY9Zu+jmGk1Q==" + }, + "node_modules/agentkeepalive": { + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/agentkeepalive/-/agentkeepalive-4.6.0.tgz", + "integrity": "sha512-kja8j7PjmncONqaTsB8fQ+wE2mSU2DJ9D4XKoJ5PFWIdRMa6SLSN1ff4mOr4jCbfRSsxR4keIiySJU0N9T5hIQ==", + "dependencies": { + "humanize-ms": "^1.2.1" + }, + "engines": { + "node": ">= 8.0.0" + } + }, + "node_modules/arg": { + "version": "4.1.3", + "resolved": "https://registry.npmjs.org/arg/-/arg-4.1.3.tgz", + "integrity": "sha512-58S9QDqG0Xx27YwPSt9fJxivjYl432YCwfDMfZ+71RAqUrZef7LrKQZ3LHLOwCS4FLNBplP533Zx895SeOCHvA==", + "dev": true + }, + "node_modules/base-x": { + "version": "3.0.11", + "resolved": "https://registry.npmjs.org/base-x/-/base-x-3.0.11.tgz", + "integrity": "sha512-xz7wQ8xDhdyP7tQxwdteLYeFfS68tSMNCZ/Y37WJ4bhGfKPpqEIlmIyueQHqOyoPhE6xNUqjzRr8ra0eF9VRvA==", + "dependencies": { + "safe-buffer": "^5.0.1" + } + }, + "node_modules/base64-js": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz", + "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ] + }, + "node_modules/bn.js": { + "version": "5.2.2", + "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-5.2.2.tgz", + "integrity": "sha512-v2YAxEmKaBLahNwE1mjp4WON6huMNeuDvagFZW+ASCuA/ku0bXR9hSMw0XpiqMoA3+rmnyck/tPRSFQkoC9Cuw==" + }, + "node_modules/borsh": { + "version": "0.7.0", + "resolved": "https://registry.npmjs.org/borsh/-/borsh-0.7.0.tgz", + "integrity": "sha512-CLCsZGIBCFnPtkNnieW/a8wmreDmfUtjU2m9yHrzPXIlNbqVs0AQrSatSG6vdNYUqdc83tkQi2eHfF98ubzQLA==", + "dependencies": { + "bn.js": "^5.2.0", + "bs58": "^4.0.0", + "text-encoding-utf-8": "^1.0.2" + } + }, + "node_modules/bs58": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/bs58/-/bs58-4.0.1.tgz", + "integrity": "sha512-Ok3Wdf5vOIlBrgCvTq96gBkJw+JUEzdBgyaza5HLtPm7yTHkjRy8+JzNyHF7BHa0bNWOQIp3m5YF0nnFcOIKLw==", + "dependencies": { + "base-x": "^3.0.2" + } + }, + "node_modules/buffer": { + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/buffer/-/buffer-6.0.3.tgz", + "integrity": "sha512-FTiCpNxtwiZZHEZbcbTIcZjERVICn9yq/pDFkTl95/AxzD1naBctN7YO68riM/gLSDY7sdrMby8hofADYuuqOA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "dependencies": { + "base64-js": "^1.3.1", + "ieee754": "^1.2.1" + } + }, + "node_modules/bufferutil": { + "version": "4.0.9", + "resolved": "https://registry.npmjs.org/bufferutil/-/bufferutil-4.0.9.tgz", + "integrity": "sha512-WDtdLmJvAuNNPzByAYpRo2rF1Mmradw6gvWsQKf63476DDXmomT9zUiGypLcG4ibIM67vhAj8jJRdbmEws2Aqw==", + "hasInstallScript": true, + "optional": true, + "dependencies": { + "node-gyp-build": "^4.3.0" + }, + "engines": { + "node": ">=6.14.2" + } + }, + "node_modules/chalk": { + "version": "5.6.0", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.6.0.tgz", + "integrity": "sha512-46QrSQFyVSEyYAgQ22hQ+zDa60YHA4fBstHmtSApj1Y5vKtG27fWowW03jCk5KcbXEWPZUIR894aARCA/G1kfQ==", + "engines": { + "node": "^12.17.0 || ^14.13 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/commander": { + "version": "14.0.0", + "resolved": "https://registry.npmjs.org/commander/-/commander-14.0.0.tgz", + "integrity": "sha512-2uM9rYjPvyq39NwLRqaiLtWHyDC1FvryJDa2ATTVims5YAS4PupsEQsDvP14FqhFr0P49CYDugi59xaxJlTXRA==", + "engines": { + "node": ">=20" + } + }, + "node_modules/create-require": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/create-require/-/create-require-1.1.1.tgz", + "integrity": "sha512-dcKFX3jn0MpIaXjisoRvexIJVEKzaq7z2rZKxf+MSr9TkdmHmsU4m2lcLojrj/FHl8mk5VxMmYA+ftRkP/3oKQ==", + "dev": true + }, + "node_modules/delay": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/delay/-/delay-5.0.0.tgz", + "integrity": "sha512-ReEBKkIfe4ya47wlPYf/gu5ib6yUG0/Aez0JQZQz94kiWtRQvZIQbTiehsnwHvLSWJnQdhVeqYue7Id1dKr0qw==", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/diff": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/diff/-/diff-4.0.2.tgz", + "integrity": "sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A==", + "dev": true, + "engines": { + "node": ">=0.3.1" + } + }, + "node_modules/dotenv": { + "version": "16.6.1", + "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-16.6.1.tgz", + "integrity": "sha512-uBq4egWHTcTt33a72vpSG0z3HnPuIl6NqYcTrKEg2azoEyl2hpW0zqlxysq2pK9HlDIHyHyakeYaYnSAwd8bow==", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://dotenvx.com" + } + }, + "node_modules/es6-promise": { + "version": "4.2.8", + "resolved": "https://registry.npmjs.org/es6-promise/-/es6-promise-4.2.8.tgz", + "integrity": "sha512-HJDGx5daxeIvxdBxvG2cb9g4tEvwIk3i8+nhX0yGrYmZUzbkdg8QbDevheDB8gd0//uPj4c1EQua8Q+MViT0/w==" + }, + "node_modules/es6-promisify": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/es6-promisify/-/es6-promisify-5.0.0.tgz", + "integrity": "sha512-C+d6UdsYDk0lMebHNR4S2NybQMMngAOnOwYBQjTOiv0MkoJMP0Myw2mgpDLBcpfCmRLxyFqYhS/CfOENq4SJhQ==", + "dependencies": { + "es6-promise": "^4.0.3" + } + }, + "node_modules/ethers": { + "version": "6.15.0", + "resolved": "https://registry.npmjs.org/ethers/-/ethers-6.15.0.tgz", + "integrity": "sha512-Kf/3ZW54L4UT0pZtsY/rf+EkBU7Qi5nnhonjUb8yTXcxH3cdcWrV2cRyk0Xk/4jK6OoHhxxZHriyhje20If2hQ==", + "funding": [ + { + "type": "individual", + "url": "https://github.com/sponsors/ethers-io/" + }, + { + "type": "individual", + "url": "https://www.buymeacoffee.com/ricmoo" + } + ], + "dependencies": { + "@adraffy/ens-normalize": "1.10.1", + "@noble/curves": "1.2.0", + "@noble/hashes": "1.3.2", + "@types/node": "22.7.5", + "aes-js": "4.0.0-beta.5", + "tslib": "2.7.0", + "ws": "8.17.1" + }, + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/ethers/node_modules/@noble/curves": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.2.0.tgz", + "integrity": "sha512-oYclrNgRaM9SsBUBVbb8M6DTV7ZHRTKugureoYEncY5c65HOmRzvSiTE3y5CYaPYJA/GVkrhXEoF0M3Ya9PMnw==", + "dependencies": { + "@noble/hashes": "1.3.2" + }, + "funding": { + "url": "https://paulmillr.com/funding/" + } + }, + "node_modules/ethers/node_modules/@noble/hashes": { + "version": "1.3.2", + "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.3.2.tgz", + "integrity": "sha512-MVC8EAQp7MvEcm30KWENFjgR+Mkmf+D189XJTkFIlwohU5hcBbn1ZkKq7KVTi2Hme3PMGF390DaL52beVrIihQ==", + "engines": { + "node": ">= 16" + }, + "funding": { + "url": "https://paulmillr.com/funding/" + } + }, + "node_modules/ethers/node_modules/@types/node": { + "version": "22.7.5", + "resolved": "https://registry.npmjs.org/@types/node/-/node-22.7.5.tgz", + "integrity": "sha512-jML7s2NAzMWc//QSJ1a3prpk78cOPchGvXJsC3C6R6PSMoooztvRVQEz89gmBTBY1SPMaqo5teB4uNHPdetShQ==", + "dependencies": { + "undici-types": "~6.19.2" + } + }, + "node_modules/ethers/node_modules/tslib": { + "version": "2.7.0", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.7.0.tgz", + "integrity": "sha512-gLXCKdN1/j47AiHiOkJN69hJmcbGTHI0ImLmbYLHykhgeN0jVGola9yVjFgzCUklsZQMW55o+dW7IXv3RCXDzA==" + }, + "node_modules/ethers/node_modules/undici-types": { + "version": "6.19.8", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.19.8.tgz", + "integrity": "sha512-ve2KP6f/JnbPBFyobGHuerC9g1FYGn/F8n1LWTwNxCEzd6IfqTwUQcNXgEtmmQ6DlRrC1hrSrBnCZPokRrDHjw==" + }, + "node_modules/ethers/node_modules/ws": { + "version": "8.17.1", + "resolved": "https://registry.npmjs.org/ws/-/ws-8.17.1.tgz", + "integrity": "sha512-6XQFvXTkbfUOZOKKILFG1PDK2NDQs4azKQl26T0YS5CxqWLgXajbPZ+h4gZekJyRqFU8pvnbAbbs/3TgRPy+GQ==", + "engines": { + "node": ">=10.0.0" + }, + "peerDependencies": { + "bufferutil": "^4.0.1", + "utf-8-validate": ">=5.0.2" + }, + "peerDependenciesMeta": { + "bufferutil": { + "optional": true + }, + "utf-8-validate": { + "optional": true + } + } + }, + "node_modules/eventemitter3": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.1.tgz", + "integrity": "sha512-GWkBvjiSZK87ELrYOSESUYeVIc9mvLLf/nXalMOS5dYrgZq9o5OVkbZAVM06CVxYsCwH9BDZFPlQTlPA1j4ahA==" + }, + "node_modules/eyes": { + "version": "0.1.8", + "resolved": "https://registry.npmjs.org/eyes/-/eyes-0.1.8.tgz", + "integrity": "sha512-GipyPsXO1anza0AOZdy69Im7hGFCNB7Y/NGjDlZGJ3GJJLtwNSb2vrzYrTYJRrRloVx7pl+bhUaTB8yiccPvFQ==", + "engines": { + "node": "> 0.1.90" + } + }, + "node_modules/fast-stable-stringify": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/fast-stable-stringify/-/fast-stable-stringify-1.0.0.tgz", + "integrity": "sha512-wpYMUmFu5f00Sm0cj2pfivpmawLZ0NKdviQ4w9zJeR8JVtOpOxHmLaJuj0vxvGqMJQWyP/COUkF75/57OKyRag==" + }, + "node_modules/humanize-ms": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/humanize-ms/-/humanize-ms-1.2.1.tgz", + "integrity": "sha512-Fl70vYtsAFb/C06PTS9dZBo7ihau+Tu/DNCk/OyHhea07S+aeMWpFFkUaXRa8fI+ScZbEI8dfSxwY7gxZ9SAVQ==", + "dependencies": { + "ms": "^2.0.0" + } + }, + "node_modules/ieee754": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz", + "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ] + }, + "node_modules/isomorphic-ws": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/isomorphic-ws/-/isomorphic-ws-4.0.1.tgz", + "integrity": "sha512-BhBvN2MBpWTaSHdWRb/bwdZJ1WaehQ2L1KngkCkfLUGF0mAWAT1sQUQacEmQ0jXkFw/czDXPNQSL5u2/Krsz1w==", + "peerDependencies": { + "ws": "*" + } + }, + "node_modules/jayson": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/jayson/-/jayson-4.2.0.tgz", + "integrity": "sha512-VfJ9t1YLwacIubLhONk0KFeosUBwstRWQ0IRT1KDjEjnVnSOVHC3uwugyV7L0c7R9lpVyrUGT2XWiBA1UTtpyg==", + "dependencies": { + "@types/connect": "^3.4.33", + "@types/node": "^12.12.54", + "@types/ws": "^7.4.4", + "commander": "^2.20.3", + "delay": "^5.0.0", + "es6-promisify": "^5.0.0", + "eyes": "^0.1.8", + "isomorphic-ws": "^4.0.1", + "json-stringify-safe": "^5.0.1", + "stream-json": "^1.9.1", + "uuid": "^8.3.2", + "ws": "^7.5.10" + }, + "bin": { + "jayson": "bin/jayson.js" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jayson/node_modules/@types/node": { + "version": "12.20.55", + "resolved": "https://registry.npmjs.org/@types/node/-/node-12.20.55.tgz", + "integrity": "sha512-J8xLz7q2OFulZ2cyGTLE1TbbZcjpno7FaN6zdJNrgAdrJ+DZzh/uFR6YrTb4C+nXakvud8Q4+rbhoIWlYQbUFQ==" + }, + "node_modules/jayson/node_modules/commander": { + "version": "2.20.3", + "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz", + "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==" + }, + "node_modules/json-stringify-safe": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/json-stringify-safe/-/json-stringify-safe-5.0.1.tgz", + "integrity": "sha512-ZClg6AaYvamvYEE82d3Iyd3vSSIjQ+odgjaTzRuO3s7toCdFKczob2i0zCh7JE8kWn17yvAWhUVxvqGwUalsRA==" + }, + "node_modules/make-error": { + "version": "1.3.6", + "resolved": "https://registry.npmjs.org/make-error/-/make-error-1.3.6.tgz", + "integrity": "sha512-s8UhlNe7vPKomQhC1qFelMokr/Sc3AgNbso3n74mVPA5LTZwkB9NlXf4XPamLxJE8h0gh73rM94xvwRT2CVInw==", + "dev": true + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==" + }, + "node_modules/node-fetch": { + "version": "2.7.0", + "resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-2.7.0.tgz", + "integrity": "sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==", + "dependencies": { + "whatwg-url": "^5.0.0" + }, + "engines": { + "node": "4.x || >=6.0.0" + }, + "peerDependencies": { + "encoding": "^0.1.0" + }, + "peerDependenciesMeta": { + "encoding": { + "optional": true + } + } + }, + "node_modules/node-gyp-build": { + "version": "4.8.4", + "resolved": "https://registry.npmjs.org/node-gyp-build/-/node-gyp-build-4.8.4.tgz", + "integrity": "sha512-LA4ZjwlnUblHVgq0oBF3Jl/6h/Nvs5fzBLwdEF4nuxnFdsfajde4WfxtJr3CaiH+F6ewcIB/q4jQ4UzPyid+CQ==", + "optional": true, + "bin": { + "node-gyp-build": "bin.js", + "node-gyp-build-optional": "optional.js", + "node-gyp-build-test": "build-test.js" + } + }, + "node_modules/rpc-websockets": { + "version": "9.1.3", + "resolved": "https://registry.npmjs.org/rpc-websockets/-/rpc-websockets-9.1.3.tgz", + "integrity": "sha512-I+kNjW0udB4Fetr3vvtRuYZJS0PcSPyyvBcH5sDdoV8DFs5E4W2pTr7aiMlKfPxANTClP9RlqCPolj9dd5MsEA==", + "dependencies": { + "@swc/helpers": "^0.5.11", + "@types/uuid": "^8.3.4", + "@types/ws": "^8.2.2", + "buffer": "^6.0.3", + "eventemitter3": "^5.0.1", + "uuid": "^8.3.2", + "ws": "^8.5.0" + }, + "funding": { + "type": "paypal", + "url": "https://paypal.me/kozjak" + }, + "optionalDependencies": { + "bufferutil": "^4.0.1", + "utf-8-validate": "^5.0.2" + } + }, + "node_modules/rpc-websockets/node_modules/@types/ws": { + "version": "8.18.1", + "resolved": "https://registry.npmjs.org/@types/ws/-/ws-8.18.1.tgz", + "integrity": "sha512-ThVF6DCVhA8kUGy+aazFQ4kXQ7E1Ty7A3ypFOe0IcJV8O/M511G99AW24irKrW56Wt44yG9+ij8FaqoBGkuBXg==", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/rpc-websockets/node_modules/ws": { + "version": "8.18.3", + "resolved": "https://registry.npmjs.org/ws/-/ws-8.18.3.tgz", + "integrity": "sha512-PEIGCY5tSlUt50cqyMXfCzX+oOPqN0vuGqWzbcJ2xvnkzkq46oOpz7dQaTDBdfICb4N14+GARUDw2XV2N4tvzg==", + "engines": { + "node": ">=10.0.0" + }, + "peerDependencies": { + "bufferutil": "^4.0.1", + "utf-8-validate": ">=5.0.2" + }, + "peerDependenciesMeta": { + "bufferutil": { + "optional": true + }, + "utf-8-validate": { + "optional": true + } + } + }, + "node_modules/safe-buffer": { + "version": "5.2.1", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", + "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ] + }, + "node_modules/stream-chain": { + "version": "2.2.5", + "resolved": "https://registry.npmjs.org/stream-chain/-/stream-chain-2.2.5.tgz", + "integrity": "sha512-1TJmBx6aSWqZ4tx7aTpBDXK0/e2hhcNSTV8+CbFJtDjbb+I1mZ8lHit0Grw9GRT+6JbIrrDd8esncgBi8aBXGA==" + }, + "node_modules/stream-json": { + "version": "1.9.1", + "resolved": "https://registry.npmjs.org/stream-json/-/stream-json-1.9.1.tgz", + "integrity": "sha512-uWkjJ+2Nt/LO9Z/JyKZbMusL8Dkh97uUBTv3AJQ74y07lVahLY4eEFsPsE97pxYBwr8nnjMAIch5eqI0gPShyw==", + "dependencies": { + "stream-chain": "^2.2.5" + } + }, + "node_modules/superstruct": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/superstruct/-/superstruct-2.0.2.tgz", + "integrity": "sha512-uV+TFRZdXsqXTL2pRvujROjdZQ4RAlBUS5BTh9IGm+jTqQntYThciG/qu57Gs69yjnVUSqdxF9YLmSnpupBW9A==", + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/text-encoding-utf-8": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/text-encoding-utf-8/-/text-encoding-utf-8-1.0.2.tgz", + "integrity": "sha512-8bw4MY9WjdsD2aMtO0OzOCY3pXGYNx2d2FfHRVUKkiCPDWjKuOlhLVASS+pD7VkLTVjW268LYJHwsnPFlBpbAg==" + }, + "node_modules/tr46": { + "version": "0.0.3", + "resolved": "https://registry.npmjs.org/tr46/-/tr46-0.0.3.tgz", + "integrity": "sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==" + }, + "node_modules/ts-node": { + "version": "10.9.2", + "resolved": "https://registry.npmjs.org/ts-node/-/ts-node-10.9.2.tgz", + "integrity": "sha512-f0FFpIdcHgn8zcPSbf1dRevwt047YMnaiJM3u2w2RewrB+fob/zePZcrOyQoLMMO7aBIddLcQIEK5dYjkLnGrQ==", + "dev": true, + "dependencies": { + "@cspotcode/source-map-support": "^0.8.0", + "@tsconfig/node10": "^1.0.7", + "@tsconfig/node12": "^1.0.7", + "@tsconfig/node14": "^1.0.0", + "@tsconfig/node16": "^1.0.2", + "acorn": "^8.4.1", + "acorn-walk": "^8.1.1", + "arg": "^4.1.0", + "create-require": "^1.1.0", + "diff": "^4.0.1", + "make-error": "^1.1.1", + "v8-compile-cache-lib": "^3.0.1", + "yn": "3.1.1" + }, + "bin": { + "ts-node": "dist/bin.js", + "ts-node-cwd": "dist/bin-cwd.js", + "ts-node-esm": "dist/bin-esm.js", + "ts-node-script": "dist/bin-script.js", + "ts-node-transpile-only": "dist/bin-transpile.js", + "ts-script": "dist/bin-script-deprecated.js" + }, + "peerDependencies": { + "@swc/core": ">=1.2.50", + "@swc/wasm": ">=1.2.50", + "@types/node": "*", + "typescript": ">=2.7" + }, + "peerDependenciesMeta": { + "@swc/core": { + "optional": true + }, + "@swc/wasm": { + "optional": true + } + } + }, + "node_modules/tslib": { + "version": "2.8.1", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", + "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==" + }, + "node_modules/typescript": { + "version": "5.9.2", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.2.tgz", + "integrity": "sha512-CWBzXQrc/qOkhidw1OzBTQuYRbfyxDXJMVJ1XNwUHGROVmuaeiEm3OslpZ1RV96d7SKKjZKrSJu3+t/xlw3R9A==", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/undici-types": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz", + "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==" + }, + "node_modules/utf-8-validate": { + "version": "5.0.10", + "resolved": "https://registry.npmjs.org/utf-8-validate/-/utf-8-validate-5.0.10.tgz", + "integrity": "sha512-Z6czzLq4u8fPOyx7TU6X3dvUZVvoJmxSQ+IcrlmagKhilxlhZgxPK6C5Jqbkw1IDUmFTM+cz9QDnnLTwDz/2gQ==", + "hasInstallScript": true, + "optional": true, + "dependencies": { + "node-gyp-build": "^4.3.0" + }, + "engines": { + "node": ">=6.14.2" + } + }, + "node_modules/uuid": { + "version": "8.3.2", + "resolved": "https://registry.npmjs.org/uuid/-/uuid-8.3.2.tgz", + "integrity": "sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg==", + "bin": { + "uuid": "dist/bin/uuid" + } + }, + "node_modules/v8-compile-cache-lib": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/v8-compile-cache-lib/-/v8-compile-cache-lib-3.0.1.tgz", + "integrity": "sha512-wa7YjyUGfNZngI/vtK0UHAN+lgDCxBPCylVXGp0zu59Fz5aiGtNXaq3DhIov063MorB+VfufLh3JlF2KdTK3xg==", + "dev": true + }, + "node_modules/webidl-conversions": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-3.0.1.tgz", + "integrity": "sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==" + }, + "node_modules/whatwg-url": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-5.0.0.tgz", + "integrity": "sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw==", + "dependencies": { + "tr46": "~0.0.3", + "webidl-conversions": "^3.0.0" + } + }, + "node_modules/ws": { + "version": "7.5.10", + "resolved": "https://registry.npmjs.org/ws/-/ws-7.5.10.tgz", + "integrity": "sha512-+dbF1tHwZpXcbOJdVOkzLDxZP1ailvSxM6ZweXTegylPny803bFhA+vqBYw4s31NSAk4S2Qz+AKXK9a4wkdjcQ==", + "engines": { + "node": ">=8.3.0" + }, + "peerDependencies": { + "bufferutil": "^4.0.1", + "utf-8-validate": "^5.0.2" + }, + "peerDependenciesMeta": { + "bufferutil": { + "optional": true + }, + "utf-8-validate": { + "optional": true + } + } + }, + "node_modules/yn": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/yn/-/yn-3.1.1.tgz", + "integrity": "sha512-Ux4ygGWsu2c7isFWe8Yu1YluJmqVhxqK2cLXNQA5AcC3QfbGNpM7fu0Y8b/z16pXLnFxZYvWhd3fhBY9DLmC6Q==", + "dev": true, + "engines": { + "node": ">=6" + } + } + } +} diff --git a/package.json b/package.json index 75703f0..5c3de3e 100644 --- a/package.json +++ b/package.json @@ -4,7 +4,10 @@ "description": "Modular agent framework for on-chain activity monitoring.", "main": "index.js", "scripts": { - "dev": "echo 'Running dev mode...'" + "dev": "ts-node scripts/run-agents.ts", + "start": "node dist/scripts/run-agents.js", + "build": "tsc", + "test": "ts-node scripts/validate-agent.ts" }, "keywords": [ "agent", @@ -14,5 +17,15 @@ "framework" ], "license": "MIT", - "author": "EremosCore" + "author": "EremosCore", + "dependencies": { + "@solana/web3.js": "^1.98.4", + "dotenv": "^16.4.5", + "ethers": "^6.15.0" + }, + "devDependencies": { + "@types/node": "^20.14.10", + "ts-node": "^10.9.2", + "typescript": "^5.5.3" + } } diff --git a/scripts/run-agents.ts b/scripts/run-agents.ts new file mode 100644 index 0000000..b13d3c9 --- /dev/null +++ b/scripts/run-agents.ts @@ -0,0 +1,65 @@ +import "dotenv/config"; +import { Agent } from "../types/agent"; +import { ExampleAgent } from "../agents/example"; +import { Harvester } from "../agents/harvester"; +import { Observer } from "../agents/observer"; +import { SolanaWatcher } from "../agents/solana-watcher"; +import { EthereumWatcher } from "../agents/ethereum-watcher"; + +// CLI arg, example: npm run dev sol OR npm run dev eth +const arg = process.argv[2]?.toLowerCase(); + +let agents: Agent[]; + +if (!arg) { + console.log("No agent selected → running all agents.\n"); + agents = [ExampleAgent, Harvester, Observer, SolanaWatcher, EthereumWatcher]; +} else if (arg === "sol") { + agents = [SolanaWatcher]; +} else if (arg === "eth") { + agents = [EthereumWatcher]; +} else { + console.error(`Unknown agent option: ${arg}`); + console.log(" Usage: npm run dev [sol|eth]"); + process.exit(1); +} + +async function startAgents() { + console.log("Starting Eremos agent swarm...\n"); + + for (const agent of agents) { + try { + console.log(`⚡ Initializing ${agent.name} (${agent.id})`); + console.log(` Role: ${agent.role} | Glyph: ${agent.glyph}`); + console.log(` Watching: ${agent.watchType}\n`); + + if (agent.init) { + await agent.init(); + } + } catch (error) { + console.error(`Failed to initialize ${agent.name}:`, error); + } + } + + console.log("\n All agents initialized. Listening for events...\n"); + + process.on("SIGINT", async () => { + console.log("\n\n Shutting down agents..."); + + for (const agent of agents) { + if (agent.cleanup) { + await agent.cleanup(); + } + } + + console.log("Agents terminated. Goodbye!"); + process.exit(0); + }); + + process.stdin.resume(); +} + +startAgents().catch((error) => { + console.error("Fatal error:", error); + process.exit(1); +}); \ No newline at end of file diff --git a/types/agent.ts b/types/agent.ts index df8786d..beb4851 100644 --- a/types/agent.ts +++ b/types/agent.ts @@ -1,13 +1,15 @@ export type Agent = { - id: string - name: string - role: string - glyph: string - watchType: string - triggerThreshold: number - lastSignal: string | null - originTimestamp: string - description: string - observe: (event: any) => void - getMemory?: () => string[] -} + id: string; + name: string; + role: string; + glyph: string; + watchType: string; + triggerThreshold: number; + lastSignal: string | null; + originTimestamp: string; + description: string; + observe: (event: any) => void; + getMemory?: () => string[]; + init?: () => Promise; + cleanup?: () => Promise; +} \ No newline at end of file diff --git a/types/signal.ts b/types/signal.ts index 445b00e..019d3ce 100644 --- a/types/signal.ts +++ b/types/signal.ts @@ -3,6 +3,36 @@ export type Signal = { hash: string; timestamp: string; source: string; + details?: Record; }; -// TODO: add error handling for malformed signal payloads +/** + * Validate and safely create a Signal object. + * Returns null if the payload is malformed. + */ +export function createSignal(payload: Partial): Signal | null { + if (!payload.type || typeof payload.type !== "string") { + console.error("[Signal] Missing or invalid type:", payload); + return null; + } + if (!payload.hash || typeof payload.hash !== "string") { + console.error("[Signal] Missing or invalid hash:", payload); + return null; + } + if (!payload.timestamp || isNaN(Date.parse(payload.timestamp))) { + console.error("[Signal] Missing or invalid timestamp:", payload); + return null; + } + if (!payload.source || typeof payload.source !== "string") { + console.error("[Signal] Missing or invalid source:", payload); + return null; + } + + return { + type: payload.type, + hash: payload.hash, + timestamp: payload.timestamp, + source: payload.source, + details: payload.details, + }; +} \ No newline at end of file diff --git a/utils/config.ts b/utils/config.ts new file mode 100644 index 0000000..830c69b --- /dev/null +++ b/utils/config.ts @@ -0,0 +1,28 @@ +import * as dotenv from "dotenv"; +dotenv.config(); + +/** + * Solana RPC URL + */ +export const SOLANA_RPC_URL = + process.env.SOLANA_RPC_URL || "https://api.mainnet-beta.solana.com"; + +if (!process.env.SOLANA_RPC_URL) { + console.warn(" SOLANA_RPC_URL not found in .env, defaulting to public mainnet endpoint (rate limited)."); +} + +/** + * Ethereum RPC URL + */ +export const ETH_RPC_URL = + process.env.ETH_RPC_URL || "https://eth.llamarpc.com"; + +if (!process.env.ETH_RPC_URL) { + console.warn("ETH_RPC_URL not found in .env, using free public RPC (may be unreliable)."); +} + +/** + * Polling defaults + */ +export const DEFAULT_POLL_INTERVAL = Number(process.env.POLL_INTERVAL || 10_000); // 10s +export const DEFAULT_ACTIVITY_THRESHOLD = Number(process.env.ACTIVITY_THRESHOLD || 5); // generic fallback \ No newline at end of file diff --git a/utils/logger.ts b/utils/logger.ts index ddb7a7f..c63a431 100644 --- a/utils/logger.ts +++ b/utils/logger.ts @@ -1,3 +1,5 @@ +import { Signal } from "../types/signal"; + export function logSignal(signal: { agent: string; type: string; @@ -6,8 +8,29 @@ export function logSignal(signal: { timestamp: string; details?: Record; }) { - console.log(`[${signal.agent}] stored signal ${signal.hash} (${signal.type}) at ${signal.timestamp}`); + console.log( + `[${signal.agent}] → emitting signal (${signal.type}) at ${signal.timestamp}` + ); + if (signal.details) { - console.log(`├─ context:`, JSON.stringify(signal.details, null, 2)); + Object.entries(signal.details).forEach(([key, val]) => { + const pretty = + typeof val === "object" ? JSON.stringify(val).slice(0, 120) : val; + console.log(`[${signal.agent}] → ${key}: ${pretty}`); + }); } -} + + const structured: Signal & { agent: string; glyph: string } = { + type: signal.type, + hash: signal.hash, + timestamp: signal.timestamp, + source: signal.agent, + details: signal.details, + agent: signal.agent, + glyph: signal.glyph, + }; + + console.log(""); + console.log(JSON.stringify(structured, null, 2)); + console.log(""); +} \ No newline at end of file diff --git a/utils/signal.ts b/utils/signal.ts index 93ca284..424ee42 100644 --- a/utils/signal.ts +++ b/utils/signal.ts @@ -1,5 +1,42 @@ +import { Signal } from "../types/signal"; + +/** + * Generate a deterministic-but-unique signal hash from event data. + */ export function generateSignalHash(event: any): string { const base = JSON.stringify(event) + Date.now(); const hash = Buffer.from(base).toString("base64").slice(0, 10); return "sig_" + hash; } + +/** + * Safely create a Signal object from a payload. + * Ensures required fields exist and are valid. + * Returns null if validation fails. + */ +export function createSignal(payload: Partial): Signal | null { + if (!payload.type || typeof payload.type !== "string") { + console.error("[Signal] Missing or invalid type:", payload); + return null; + } + if (!payload.hash || typeof payload.hash !== "string") { + console.error("[Signal] Missing or invalid hash:", payload); + return null; + } + if (!payload.timestamp || isNaN(Date.parse(payload.timestamp))) { + console.error("[Signal] Missing or invalid timestamp:", payload); + return null; + } + if (!payload.source || typeof payload.source !== "string") { + console.error("[Signal] Missing or invalid source:", payload); + return null; + } + + return { + type: payload.type, + hash: payload.hash, + timestamp: payload.timestamp, + source: payload.source, + details: payload.details ?? {}, + }; +} \ No newline at end of file