agentlaunch-templates 0.1.0

package/dist/templates/data-analyzer.js

@@ -0,0 +1,565 @@
+/**
+ * data-analyzer.ts — Serves structured data feeds and query results
+ *
+ * Platform constants (source of truth: deployed smart contracts):
+ *   - Deploy fee: 120 FET (read dynamically, can change via multi-sig)
+ *   - Graduation target: 30,000 FET -> auto DEX listing
+ *   - Trading fee: 2% -> 100% to protocol treasury (NO creator fee)
+ */
+export const template = {
+    name: "data-analyzer",
+    description: "Serves structured data feeds and query results from the AgentLaunch platform",
+    category: "Data",
+    variables: [
+        { name: "agent_name", required: true, description: "Name of the agent" },
+        {
+            name: "description",
+            default: "Serves structured data feeds and query results from the AgentLaunch platform",
+            description: "Short description of what this agent does",
+        },
+        {
+            name: "cache_ttl_seconds",
+            default: "300",
+            description: "How long to cache data feed results (seconds)",
+        },
+        {
+            name: "max_results",
+            default: "20",
+            description: "Maximum number of results to return per query",
+        },
+        {
+            name: "rate_limit_per_minute",
+            default: "20",
+            description: "Max requests per user per minute",
+        },
+        {
+            name: "free_requests_per_day",
+            default: "10",
+            description: "Free tier daily request quota",
+        },
+        {
+            name: "premium_token_threshold",
+            default: "1000",
+            description: "Token balance required for premium tier",
+        },
+    ],
+    dependencies: ["requests"],
+    secrets: ["AGENTVERSE_API_KEY", "AGENTLAUNCH_API_KEY", "AGENT_ADDRESS", "AGENT_OWNER_ADDRESS"],
+    code: `#!/usr/bin/env python3
+"""
+{{agent_name}} — AgentLaunch Data Analyzer Agent
+Generated by: agentlaunch scaffold {{agent_name}} --type data-analyzer
+
+Serves structured data feeds from the AgentLaunch platform:
+  - Token listings (paginated, sorted by market cap)
+  - Individual token statistics
+  - Platform-wide market summary
+
+Platform constants (source of truth: deployed smart contracts):
+  - Deploy fee: 120 FET (read dynamically, can change via multi-sig)
+  - Graduation target: 30,000 FET -> auto DEX listing
+  - Trading fee: 2% -> 100% to protocol treasury (NO creator fee)
+"""
+
+from uagents import Agent, Context, Protocol
+from uagents_core.contrib.protocols.chat import (
+    ChatAcknowledgement,
+    ChatMessage,
+    EndSessionContent,
+    TextContent,
+    chat_protocol_spec,
+)
+
+import json
+import os
+import time
+from collections import defaultdict
+from datetime import datetime
+from typing import Any, Dict, List, Optional
+from uuid import uuid4
+
+import requests
+
+# ==============================================================================
+# API CONFIG — Override via environment variables, never hardcode
+# ==============================================================================
+
+AGENTLAUNCH_API = os.environ.get("AGENTLAUNCH_API", "https://agent-launch.ai/api")
+
+# ==============================================================================
+# BUSINESS CONFIG
+# ==============================================================================
+
+OWNER_ADDRESS = os.environ.get("AGENT_OWNER_ADDRESS", "")
+
+BUSINESS = {
+    "name": "{{agent_name}}",
+    "description": "{{description}}",
+    "version": "1.0.0",
+    "cache_ttl_seconds": int("{{cache_ttl_seconds}}"),
+    "max_results": int("{{max_results}}"),
+    "free_requests_per_day": {{free_requests_per_day}},
+    "premium_token_threshold": {{premium_token_threshold}},
+    "rate_limit_per_minute": {{rate_limit_per_minute}},
+    "max_input_length": 5000,
+}
+
+
+# ==============================================================================
+# LAYER 1: FOUNDATION
+# ==============================================================================
+
+
+class Logger:
+    """Structured logging with audit trail."""
+
+    @staticmethod
+    def info(ctx: Context, event: str, data: Optional[Dict] = None) -> None:
+        ctx.logger.info(f"[{event}] {json.dumps(data or {})}")
+
+    @staticmethod
+    def audit(ctx: Context, user: str, action: str) -> None:
+        ctx.logger.info(
+            f"[AUDIT] user={user[:20]} action={action} "
+            f"ts={datetime.utcnow().isoformat()}"
+        )
+
+    @staticmethod
+    def error(ctx: Context, event: str, error: str) -> None:
+        ctx.logger.error(f"[{event}] {error}")
+
+
+# ==============================================================================
+# LAYER 2: SECURITY
+# ==============================================================================
+
+
+class Security:
+    """Rate limiting and input validation."""
+
+    def __init__(self) -> None:
+        self._requests: Dict[str, List[float]] = defaultdict(list)
+        self._check_count: int = 0
+
+    def check(self, ctx: Context, user_id: str, message: str) -> tuple:
+        now = time.time()
+
+        self._requests[user_id] = [
+            t for t in self._requests[user_id] if now - t < 60
+        ]
+        if len(self._requests[user_id]) >= BUSINESS["rate_limit_per_minute"]:
+            return None, "Rate limit exceeded. Please wait a moment."
+        self._requests[user_id].append(now)
+
+        self._check_count += 1
+        if self._check_count % 100 == 0:
+            stale = [
+                k
+                for k, v in self._requests.items()
+                if not v or (now - max(v)) > 300
+            ]
+            for k in stale:
+                del self._requests[k]
+
+        if not message or not message.strip():
+            return None, "Empty message."
+        if len(message) > BUSINESS["max_input_length"]:
+            return None, f"Message too long (max {BUSINESS['max_input_length']} chars)."
+
+        return message.strip(), None
+
+
+# ==============================================================================
+# LAYER 3: STABILITY
+# ==============================================================================
+
+
+class Health:
+    """Track uptime and error rate."""
+
+    def __init__(self) -> None:
+        self._start: datetime = datetime.utcnow()
+        self._requests: int = 0
+        self._errors: int = 0
+
+    def record(self, success: bool) -> None:
+        self._requests += 1
+        if not success:
+            self._errors += 1
+
+    def status(self) -> Dict[str, Any]:
+        uptime = (datetime.utcnow() - self._start).total_seconds()
+        error_rate = (self._errors / self._requests * 100) if self._requests else 0
+        return {
+            "status": "healthy" if error_rate < 10 else "degraded",
+            "uptime_seconds": int(uptime),
+            "requests": self._requests,
+            "error_rate": f"{error_rate:.1f}%",
+        }
+
+
+# ==============================================================================
+# LAYER 4: SPEED
+# ==============================================================================
+
+
+class Cache:
+    """In-memory TTL cache."""
+
+    def __init__(self, max_size: int = 1000) -> None:
+        self._data: Dict[str, tuple] = {}
+        self._max_size: int = max_size
+
+    def get(self, key: str) -> Any:
+        if key in self._data:
+            value, expires = self._data[key]
+            if expires > time.time():
+                return value
+            del self._data[key]
+        return None
+
+    def set(self, key: str, value: Any, ttl: int = 300) -> None:
+        if len(self._data) >= self._max_size:
+            now = time.time()
+            expired = [k for k, (_, exp) in self._data.items() if exp <= now]
+            for k in expired:
+                del self._data[k]
+            if len(self._data) >= self._max_size:
+                to_drop = sorted(self._data.items(), key=lambda x: x[1][1])[
+                    : self._max_size // 10
+                ]
+                for k, _ in to_drop:
+                    del self._data[k]
+        self._data[key] = (value, time.time() + ttl)
+
+
+# ==============================================================================
+# LAYER 5: REVENUE
+# ==============================================================================
+
+
+class Revenue:
+    """Token-gated access and daily usage quotas."""
+
+    def __init__(self, cache: Cache) -> None:
+        self._cache = cache
+        self._usage: Dict[str, List[str]] = defaultdict(list)
+
+    def get_tier(self, user_address: str) -> str:
+        cached = self._cache.get(f"tier:{user_address}")
+        if cached is not None:
+            return cached
+        try:
+            r = requests.get(
+                f"{AGENTLAUNCH_API}/agents/token/{user_address}", timeout=5
+            )
+            if r.status_code == 200:
+                data = r.json()
+                balance = data.get("balance", 0)
+                tier = (
+                    "premium"
+                    if balance >= BUSINESS["premium_token_threshold"]
+                    else "free"
+                )
+                self._cache.set(f"tier:{user_address}", tier, ttl=300)
+                return tier
+        except Exception:
+            pass
+        return "free"
+
+    def check_quota(self, user_id: str, tier: str) -> tuple:
+        today = datetime.utcnow().date().isoformat()
+        self._usage[user_id] = [
+            t for t in self._usage[user_id] if t.startswith(today)
+        ]
+        today_usage = len(self._usage[user_id])
+        limit = 1000 if tier == "premium" else BUSINESS["free_requests_per_day"]
+        if today_usage >= limit:
+            if tier == "free":
+                return False, (
+                    f"Free limit reached ({limit}/day). "
+                    f"Hold {BUSINESS['premium_token_threshold']} tokens for premium!"
+                )
+            return False, f"Daily limit reached ({limit}/day)."
+        self._usage[user_id].append(datetime.utcnow().isoformat())
+        return True, None
+
+
+# ==============================================================================
+# AGENTLAUNCH INTEGRATION
+# ==============================================================================
+
+
+class AgentLaunch:
+    """Create and manage tokens on AgentLaunch."""
+
+    @staticmethod
+    def tokenize() -> Dict:
+        agent_address = os.environ.get("AGENT_ADDRESS")
+        if not agent_address:
+            return {"error": "AGENT_ADDRESS env var not set."}
+        try:
+            r = requests.post(
+                f"{AGENTLAUNCH_API}/agents/tokenize",
+                headers={
+                    "X-API-Key": os.environ.get("AGENTLAUNCH_API_KEY", ""),
+                    "Content-Type": "application/json",
+                },
+                json={
+                    "agentAddress": agent_address,
+                    "name": BUSINESS["name"],
+                    "description": BUSINESS["description"],
+                },
+                timeout=30,
+            )
+            return r.json() if r.status_code in [200, 201] else {"error": r.text}
+        except Exception as e:
+            return {"error": str(e)}
+
+
+# ==============================================================================
+# DATA ANALYZER BUSINESS LOGIC
+# ==============================================================================
+
+
+class DataAnalyzerBusiness:
+    """
+    Queries the AgentLaunch REST API and returns structured data:
+      - Token listings sorted by market cap
+      - Individual token detail
+      - Platform summary statistics
+
+    All results are cached locally to avoid hammering the API.
+
+    Note: Trading fee is 2% -> 100% to protocol treasury (no creator fee).
+    """
+
+    def __init__(self, cache: Cache) -> None:
+        self._cache = cache
+
+    def fetch_tokens(self, page: int = 1) -> Optional[List[Dict]]:
+        cache_key = f"tokens:page:{page}"
+        cached = self._cache.get(cache_key)
+        if cached is not None:
+            return cached
+        try:
+            r = requests.get(
+                f"{AGENTLAUNCH_API}/agents/tokens",
+                params={"page": page, "limit": BUSINESS["max_results"]},
+                timeout=10,
+            )
+            if r.status_code == 200:
+                data = r.json()
+                tokens = data.get("data") or data.get("tokens") or data
+                if isinstance(tokens, list):
+                    self._cache.set(cache_key, tokens, ttl=BUSINESS["cache_ttl_seconds"])
+                    return tokens
+        except Exception:
+            pass
+        return None
+
+    def fetch_token(self, address: str) -> Optional[Dict]:
+        cache_key = f"token:{address}"
+        cached = self._cache.get(cache_key)
+        if cached is not None:
+            return cached
+        try:
+            r = requests.get(
+                f"{AGENTLAUNCH_API}/agents/token/{address}", timeout=10
+            )
+            if r.status_code == 200:
+                data = r.json()
+                token = data.get("data") or data
+                if isinstance(token, dict):
+                    self._cache.set(cache_key, token, ttl=BUSINESS["cache_ttl_seconds"])
+                    return token
+        except Exception:
+            pass
+        return None
+
+    def format_token_row(self, token: Dict, index: int) -> str:
+        name = token.get("name", "Unknown")[:20]
+        symbol = token.get("symbol", "???")[:8]
+        price = token.get("price") or token.get("currentPrice") or 0
+        market_cap = token.get("marketCap") or token.get("market_cap") or 0
+        return f"{index:>3}. {name:<22} ({symbol:<8}) | {float(price):.6f} FET | MC: {float(market_cap):,.0f} FET"
+
+    async def handle(self, ctx: Context, user_id: str, message: str, tier: str) -> str:
+        lower = message.lower()
+
+        # "tokens" or "list" — paginated token listing
+        if lower in ("tokens", "list", "top"):
+            tokens = self.fetch_tokens(page=1)
+            if tokens is None:
+                return "Could not fetch token listing. Please try again."
+            if not tokens:
+                return "No tokens found."
+            lines = ["**Top Tokens by Market Cap**\\n"]
+            for i, tok in enumerate(tokens[: BUSINESS["max_results"]], start=1):
+                lines.append(self.format_token_row(tok, i))
+            lines.append(f"\\nShowing {len(tokens)} tokens. Cache TTL: {BUSINESS['cache_ttl_seconds']}s")
+            return "\\n".join(lines)
+
+        # "token <address>" — single token detail
+        if lower.startswith("token "):
+            parts = message.split()
+            if len(parts) >= 2:
+                address = parts[1].strip()
+                token = self.fetch_token(address)
+                if token is None:
+                    return f"Could not find token at address {address}."
+                name = token.get("name", "Unknown")
+                symbol = token.get("symbol", "???")
+                price = token.get("price") or token.get("currentPrice") or 0
+                market_cap = token.get("marketCap") or token.get("market_cap") or 0
+                listed = token.get("listed") or token.get("isListed") or False
+                description = token.get("description", "N/A")[:200]
+                return (
+                    f"**{name}** ({symbol})\\n"
+                    f"Address: {address}\\n"
+                    f"Price: {float(price):.6f} FET\\n"
+                    f"Market Cap: {float(market_cap):,.0f} FET\\n"
+                    f"Listed on DEX: {'Yes' if listed else 'No'}\\n"
+                    f"Graduation target: 30,000 FET\\n"
+                    f"Description: {description}"
+                )
+
+        return (
+            f"Welcome to {BUSINESS['name']}!\\n\\n"
+            f"Commands:\\n"
+            f"  tokens              — list top tokens by market cap\\n"
+            f"  token <address>     — get detail for a specific token\\n\\n"
+            f"Platform: agent-launch.ai | Fee: 2% -> 100% protocol treasury"
+        )
+
+
+# ==============================================================================
+# REPLY HELPER
+# ==============================================================================
+
+
+async def reply(ctx: Context, sender: str, text: str, end: bool = False) -> None:
+    content = [TextContent(type="text", text=text)]
+    if end:
+        content.append(EndSessionContent(type="end-session"))
+    try:
+        await ctx.send(
+            sender,
+            ChatMessage(timestamp=datetime.utcnow(), msg_id=uuid4(), content=content),
+        )
+    except Exception as e:
+        ctx.logger.error(f"Failed to send reply to {sender[:20]}: {e}")
+
+
+# ==============================================================================
+# MAIN AGENT
+# ==============================================================================
+
+cache = Cache(max_size=1000)
+security = Security()
+health = Health()
+revenue = Revenue(cache)
+business = DataAnalyzerBusiness(cache)
+
+agent = Agent()
+chat_proto = Protocol(spec=chat_protocol_spec)
+
+
+@chat_proto.on_message(ChatMessage)
+async def handle_chat(ctx: Context, sender: str, msg: ChatMessage) -> None:
+    try:
+        await ctx.send(
+            sender,
+            ChatAcknowledgement(
+                timestamp=datetime.utcnow(), acknowledged_msg_id=msg.msg_id
+            ),
+        )
+    except Exception as e:
+        ctx.logger.error(f"Failed to send ack to {sender[:20]}: {e}")
+
+    text = " ".join(
+        item.text for item in msg.content if isinstance(item, TextContent)
+    ).strip()
+    text = text[: BUSINESS["max_input_length"]]
+
+    clean, error = security.check(ctx, sender, text)
+    if error:
+        health.record(False)
+        await reply(ctx, sender, error, end=True)
+        return
+
+    Logger.audit(ctx, sender, "request")
+
+    lower = clean.lower()
+
+    if lower in ("help", "?"):
+        tier = revenue.get_tier(sender)
+        await reply(
+            ctx,
+            sender,
+            f"**{BUSINESS['name']}** v{BUSINESS['version']}\\n\\n"
+            f"{BUSINESS['description']}\\n\\n"
+            f"Your tier: {tier.upper()}\\n\\n"
+            f"Commands: help, status, tokenize, tokens, token <addr>",
+        )
+        return
+
+    if lower == "status":
+        s = health.status()
+        await reply(
+            ctx,
+            sender,
+            f"Status: {s['status']} | Uptime: {s['uptime_seconds']}s | "
+            f"Requests: {s['requests']} | Error rate: {s['error_rate']}",
+        )
+        return
+
+    if "tokenize" in lower:
+        if OWNER_ADDRESS and sender != OWNER_ADDRESS:
+            await reply(ctx, sender, "Only the agent owner can trigger tokenization.", end=True)
+            return
+        result = AgentLaunch.tokenize()
+        link = result.get("data", {}).get("handoff_link") or result.get("handoff_link")
+        await reply(
+            ctx,
+            sender,
+            f"Token created! Deploy here: {link}" if link else f"Result: {json.dumps(result)}",
+            end=True,
+        )
+        return
+
+    tier = revenue.get_tier(sender)
+    allowed, quota_error = revenue.check_quota(sender, tier)
+    if not allowed:
+        health.record(False)
+        await reply(ctx, sender, quota_error, end=True)
+        return
+
+    try:
+        response = await business.handle(ctx, sender, clean, tier)
+        health.record(True)
+    except Exception as e:
+        health.record(False)
+        Logger.error(ctx, "business_handle", str(e))
+        response = "Something went wrong. Please try again."
+
+    await reply(ctx, sender, response, end=True)
+
+
+@chat_proto.on_message(ChatAcknowledgement)
+async def handle_ack(ctx: Context, sender: str, msg: ChatAcknowledgement) -> None:
+    ctx.logger.debug(f"Ack from {sender[:20]} for msg {msg.acknowledged_msg_id}")
+
+
+@agent.on_interval(period=3600)
+async def periodic_health(ctx: Context) -> None:
+    ctx.logger.info(f"[HEALTH] {json.dumps(health.status())}")
+
+
+agent.include(chat_proto, publish_manifest=True)
+
+if __name__ == "__main__":
+    agent.run()
+`,
+};
+//# sourceMappingURL=data-analyzer.js.map

package/dist/templates/data-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-analyzer.js","sourceRoot":"","sources":["../../src/templates/data-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,8EAA8E;IAC3F,QAAQ,EAAE,MAAM;IAChB,SAAS,EAAE;QACT,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,mBAAmB,EAAE;QACxE;YACE,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,8EAA8E;YACvF,WAAW,EAAE,2CAA2C;SACzD;QACD;YACE,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,+CAA+C;SAC7D;QACD;YACE,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,+CAA+C;SAC7D;QACD;YACE,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,kCAAkC;SAChD;QACD;YACE,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,+BAA+B;SAC7C;QACD;YACE,IAAI,EAAE,yBAAyB;YAC/B,OAAO,EAAE,MAAM;YACf,WAAW,EAAE,yCAAyC;SACvD;KACF;IACD,YAAY,EAAE,CAAC,UAAU,CAAC;IAC1B,OAAO,EAAE,CAAC,oBAAoB,EAAE,qBAAqB,EAAE,eAAe,EAAE,qBAAqB,CAAC;IAC9F,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmgBP;CACA,CAAC"}

package/dist/templates/gifter.d.ts

@@ -0,0 +1,15 @@
+/**
+ * gifter.ts — FET Gifter pattern: distributes testnet FET and BNB to new developers
+ *
+ * This template is based on the FET Gifter agent pattern (faucet type from
+ * packages/cli/src/commands/scaffold.ts). It adapts the gifter use case for
+ * Agentverse-native deployment with Chat Protocol v0.3.0.
+ *
+ * Platform constants (source of truth: deployed smart contracts):
+ *   - Deploy fee: 120 FET (read dynamically, can change via multi-sig)
+ *   - Graduation target: 30,000 FET -> auto DEX listing
+ *   - Trading fee: 2% -> 100% to protocol treasury (NO creator fee)
+ */
+import type { AgentTemplate } from "../registry.js";
+export declare const template: AgentTemplate;
+//# sourceMappingURL=gifter.d.ts.map

package/dist/templates/gifter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gifter.d.ts","sourceRoot":"","sources":["../../src/templates/gifter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,eAAO,MAAM,QAAQ,EAAE,aAgsBtB,CAAC"}