https://github.com/edycutjong/skeet
📈 Fully autonomous PvP momentum trading agent and real-time telemetry console for BID Protocol.
https://github.com/edycutjong/skeet
ai crypto defi hackathon nextjs trading-bot typescript
Last synced: 20 days ago
JSON representation
📈 Fully autonomous PvP momentum trading agent and real-time telemetry console for BID Protocol.
- Host: GitHub
- URL: https://github.com/edycutjong/skeet
- Owner: edycutjong
- License: mit
- Created: 2026-06-01T18:40:49.000Z (29 days ago)
- Default Branch: main
- Last Pushed: 2026-06-03T01:00:00.000Z (28 days ago)
- Last Synced: 2026-06-03T02:13:39.904Z (28 days ago)
- Topics: ai, crypto, defi, hackathon, nextjs, trading-bot, typescript
- Language: TypeScript
- Homepage: https://skeet.edycu.dev
- Size: 1.6 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
🎯 Skeet — PVP Trading Agent
Skeet is a fully autonomous trading agent built specifically for Creatorbid's BID Protocol "Beat the House" PvP trading competition.
[](https://skeet.edycu.dev/)
[](https://skeet.edycu.dev/pitch/index.html)
[](https://dorahacks.io/hackathon/bid-protocol/detail)
[](https://github.com/edycutjong/skeet/actions/workflows/ci.yml)
---
## 📸 See it in Action
*(Insert a high-quality GIF here showing the core workflow of your app)*
## 💡 The Problem & Solution
In PvP trading competitions, speed, precise timing, and risk management are critical, and human execution is too slow to compete at the edge.
**Skeet** solves this by reading the on-chain game clock and capturing the dissolution reserve split that naive momentum bots miss.
**Key Features:**
- ⚡ **Autonomous Execution:** State machine handles WATCH ➔ TRADE ➔ EXIT/HOLD transitions seamlessly.
- 🔒 **Protocol-Native Edge:** Synchronizes natively with BID Protocol's clock to execute precise actions according to the selected strategy mode.
- 🎨 **Real-Time Telemetry:** Dashboard UI to monitor real-time PnL and active round execution charts.
- 🛡️ **Budget Guards:** Sizing fractions are calculated natively against the EOA/Safe balances on chain `42069`.
## 🏗️ Architecture & Tech Stack
We built the trading daemon using **TypeScript**, **ethers.js**, and **better-sqlite3** for persistence. The telemetry dashboard is powered by **Next.js 16** and **Tailwind CSS**.
```mermaid
flowchart TD
subgraph Chain["BID Protocol Testnet"]
GS[Game Phase + Clock]
AMM[AMM Price + Reserves]
TX[Swap Txns]
end
subgraph Agent["Skeet Agent (TypeScript)"]
FEED[Feed Listener]
STATE[State Machine: WATCH ➔ TRADE ➔ EXIT]
SIG[Signals Engine: EMA + Volatility]
RISK[Risk Engine: Kelly + Throttle]
DEC[decide Brain]
EXEC[Safe Executor]
LOG[(SQLite Database)]
end
GS --> FEED
AMM --> FEED
FEED --> STATE --> SIG --> RISK --> DEC --> EXEC --> TX
DEC --> LOG
EXEC --> LOG
```
### 🚀 Performance Benchmarks & Testing
* **Vitest Suite**: 185 tests passing (173 daemon tests + 12 dashboard tests, with 100% statement coverage on the core decision engine).
* **Latency**: Running `npm run bench` over 1,000 mock tick evaluations returns a **Median (p50)** evaluation latency of **0.0005 ms** (Max: 0.0636 ms).
## 🏆 Sponsor Tracks Targeted
* **Creatorbid's BID Protocol**: Skeet leverages native protocol features like `GET /api/game` for exact server timelines and optimizes against the AMM dissolution phase payload structure on chain `42069`.
## 🚀 Run it Locally (For Judges)
1. **Clone the repo:** `git clone https://github.com/edycutjong/skeet.git`
2. **Install dependencies:** `npm install && cd dashboard && npm install && cd ..`
3. **Set up environment variables:** Rename `.env.example` to `.env` and add your BID access code.
4. **Run safety verifications and start the daemon:**
```bash
npm test
npm run verify-offline
npm start
```
5. **Run the telemetry dashboard:**
```bash
cd dashboard
npm run dev
# Open http://localhost:3000
```
> **Note for Judges:**
> You can bypass live trading and view our offline backtest evaluations by running `npm run backtest`.