clodds 1.2.9 → 1.4.0

package/dist/skills/bundled/verify/SKILL.md

@@ -0,0 +1,199 @@
+---
+name: verify
+description: "Verify agent identity using ERC-8004 on-chain registry"
+emoji: "🔐"
+---
+
+# Verify - Agent Identity Verification
+
+Verify any agent's on-chain identity using ERC-8004. Prevents impersonation attacks.
+
+## Why This Matters
+
+On January 29, 2026, an agent named "samaltman" attempted to hijack bots via prompt injection. Anyone can claim to be anyone. ERC-8004 provides cryptographic proof of identity.
+
+---
+
+## Chat Commands
+
+### Verify Agent
+
+```
+/verify 1234                           # Verify agent by ID
+/verify 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7  # Verify by address
+/verify eip155:8453:0x7177...Dd09A:1234             # Full format
+```
+
+### Check Before Copy Trading
+
+```
+/verify trader 0x123...                # Verify trader before copying
+/verify whale 0xabc...                 # Verify whale identity
+```
+
+### Register Clodds
+
+```
+/verify register                       # Register this Clodds instance
+/verify register --name "MyBot"        # With custom name
+```
+
+### Stats
+
+```
+/verify stats                          # Show total registered agents
+/verify reputation 1234                # Get agent's reputation score
+```
+
+---
+
+## TypeScript API
+
+### Quick Verification
+
+```typescript
+import { verifyAgent, hasIdentity } from 'clodds/identity';
+
+// Verify by agent ID
+const result = await verifyAgent(1234);
+if (result.verified) {
+  console.log(`Verified: ${result.name}`);
+  console.log(`Owner: ${result.owner}`);
+  console.log(`Reputation: ${result.reputation?.averageScore}/100`);
+}
+
+// Check if address has identity
+const hasId = await hasIdentity('0x742d35Cc...');
+```
+
+### Full Client
+
+```typescript
+import { createERC8004Client } from 'clodds/identity';
+
+const client = createERC8004Client('base-sepolia');
+
+// Get agent details
+const agent = await client.getAgent(1234);
+console.log(agent?.card?.name);
+console.log(agent?.card?.description);
+
+// Verify ownership
+const isOwner = await client.verifyOwnership(1234, '0x742...');
+
+// Get reputation
+const rep = await client.getReputation(1234);
+console.log(`Score: ${rep?.averageScore}/100 (${rep?.feedbackCount} reviews)`);
+
+// Give feedback
+const txHash = await client.giveFeedback(1234, 85, 'Great trading signals');
+```
+
+### Register Agent
+
+```typescript
+import { createERC8004Client, buildAgentCard } from 'clodds/identity';
+
+const client = createERC8004Client('base', process.env.PRIVATE_KEY);
+
+// Build agent card
+const card = buildAgentCard({
+  name: 'Clodds Trading Bot',
+  description: 'AI-powered prediction market assistant',
+  walletAddress: '0x742d35Cc...',
+  apiEndpoint: 'https://api.cloddsbot.com/agent',
+});
+
+// Upload to IPFS (use Pinata, web3.storage, etc.)
+const ipfsUri = await uploadToIPFS(card);
+
+// Register on-chain
+const { agentId, txHash } = await client.register(ipfsUri);
+console.log(`Registered as agent #${agentId}`);
+```
+
+---
+
+## Contract Addresses
+
+Same on all EVM chains (CREATE2 deterministic):
+
+| Contract | Address |
+|----------|---------|
+| Identity Registry | `0x7177a6867296406881E20d6647232314736Dd09A` |
+| Reputation Registry | `0xB5048e3ef1DA4E04deB6f7d0423D06F63869e322` |
+| Validation Registry | `0x662b40A526cb4017d947e71eAF6753BF3eeE66d8` |
+
+**Live on:** Ethereum, Base, Optimism, Arbitrum, Polygon (and testnets)
+
+---
+
+## Supported Networks
+
+| Network | Status | Default |
+|---------|--------|---------|
+| Base | Live | ✓ |
+| Ethereum | Live | |
+| Optimism | Live | |
+| Arbitrum | Live | |
+| Polygon | Live | |
+| Sepolia (testnet) | Live | |
+| Base Sepolia | Live | |
+
+Mainnet launched **January 29, 2026**. 19,000+ agents already registered.
+
+---
+
+## Use Cases
+
+### Copy Trading Verification
+
+Before copying a trader, verify their identity:
+
+```typescript
+const result = await verifyAgent(traderAgentId);
+if (!result.verified) {
+  console.warn('UNVERIFIED TRADER - Proceed with caution');
+}
+if (result.reputation?.averageScore < 50) {
+  console.warn('LOW REPUTATION - Consider skipping');
+}
+```
+
+### Whale Tracking
+
+Verify whale identity claims:
+
+```typescript
+const isVerified = await hasIdentity(whaleAddress);
+// Only trust signals from verified whales
+```
+
+### Bot-to-Bot Communication
+
+Verify other agents before interaction:
+
+```typescript
+const agent = await client.getAgent(otherAgentId);
+if (agent?.card?.endpoints?.find(e => e.name === 'A2A')) {
+  // Safe to communicate via A2A protocol
+}
+```
+
+---
+
+## Best Practices
+
+1. **Always verify before copy trading** - Don't trust unverified traders
+2. **Check reputation scores** - Low scores indicate potential issues
+3. **Verify on the right network** - Use same network as trading
+4. **Register your bot** - Build trust with verified identity
+5. **Give feedback** - Help build the trust graph
+
+---
+
+## Links
+
+- [ERC-8004 Spec](https://eips.ethereum.org/EIPS/eip-8004)
+- [Reference Implementation](https://github.com/nuwa-protocol/nuwa-8004)
+- [Awesome ERC-8004](https://github.com/sudeepb02/awesome-erc8004)

package/dist/skills/bundled/verify/index.d.ts

@@ -12,9 +12,6 @@ declare const _default: {
     name: string;
     description: string;
     commands: string[];
-    requires: {
-        env: string[];
-    };
     handle: typeof execute;
 };
 export default _default;

package/dist/skills/bundled/verify/index.js

@@ -151,7 +151,6 @@ exports.default = {
     name: 'verify',
     description: 'ERC-8004 on-chain agent identity verification to prevent impersonation',
     commands: ['/verify'],
-    requires: { env: ['PRIVATE_KEY'] },
     handle: execute,
 };
 //# sourceMappingURL=index.js.map

package/dist/skills/bundled/verify/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/skills/bundled/verify/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/skills/bundled/verify/index.ts"],"names":[],"mappings":"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"}

package/dist/skills/bundled/virtuals/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: virtuals
+description: "Virtuals Protocol AI Agent marketplace (Base chain)"
+emoji: "🤖"
+commands:
+  - /virt
+---
+
+# Virtuals Protocol
+
+Integration with Virtuals Protocol, an AI Agent marketplace on Base chain. View agents, prices, and bonding curve data.
+
+## Quick Start
+
+```bash
+# Search agents
+/virt search luna
+
+# Get agent details
+/virt agent <id>
+
+# Trending agents
+/virt trending
+
+# New agents
+/virt new
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `/virt search [query]` | Search agents |
+| `/virt agent <id>` | Get agent details |
+| `/virt agents` | List all agents |
+| `/virt trending` | Trending agents (by volume) |
+| `/virt new` | Recently launched agents |
+| `/virt price <tokenAddress>` | Get bonding curve price |
+| `/virt graduation <tokenAddress>` | Check graduation progress |
+
+**Examples:**
+```bash
+/virt search gaming         # Search gaming agents
+/virt agent abc123          # Get specific agent
+/virt trending              # Top volume agents
+/virt graduation 0x...      # Check if graduated
+```
+
+## Features
+
+- **AI Agents** - Discover AI agents with unique personalities
+- **Bonding Curves** - Price discovery via bonding curves
+- **Graduation** - Track agents graduating to Uniswap
+- **Categories** - Gaming, social, utility, etc.
+
+## Agent Status
+
+| Status | Description |
+|--------|-------------|
+| prototype | New, on bonding curve |
+| sentient | Active, growing community |
+| graduated | Migrated to Uniswap |
+
+## Bonding Curve
+
+Agents start on bonding curves:
+- Price increases with demand
+- ~42K VIRTUAL triggers graduation
+- Graduation creates Uniswap pair
+- LP tokens sent to creator vault
+
+## Configuration
+
+```bash
+# Optional - custom RPC
+export BASE_RPC_URL="https://mainnet.base.org"
+```
+
+## Resources
+
+- [Virtuals Protocol](https://virtuals.io/)
+- [Base Chain](https://base.org/)

package/dist/skills/bundled/voice/SKILL.md

@@ -0,0 +1,217 @@
+---
+name: voice
+description: "Voice recognition, wake words, and voice-controlled trading"
+emoji: "🎤"
+gates:
+  envs:
+    anyOf:
+      - OPENAI_API_KEY
+      - WHISPER_MODEL_PATH
+---
+
+# Voice - Complete API Reference
+
+Voice-controlled interface with wake word detection, speech-to-text, and text-to-speech.
+
+---
+
+## Chat Commands
+
+### Voice Control
+
+```
+/voice start                                Start voice listening
+/voice stop                                 Stop voice listening
+/voice status                               Check voice status
+/voice wake "hey clodds"                    Set wake word
+```
+
+### Settings
+
+```
+/voice language en-US                       Set language
+/voice sensitivity high                     Wake word sensitivity
+/voice timeout 30                           Silence timeout (seconds)
+/voice continuous on                        Enable continuous mode
+```
+
+---
+
+## TypeScript API Reference
+
+### Create Voice Assistant
+
+```typescript
+import { createVoiceAssistant } from 'clodds/voice';
+
+const voice = createVoiceAssistant({
+  // Wake word
+  wakeWord: 'hey clodds',
+  wakeWordSensitivity: 0.5,  // 0-1
+
+  // Speech-to-text
+  stt: {
+    provider: 'whisper',  // 'whisper' | 'vosk' | 'google'
+    model: 'base',        // 'tiny' | 'base' | 'small' | 'medium' | 'large'
+    language: 'en',
+  },
+
+  // Text-to-speech
+  tts: {
+    provider: 'elevenlabs',  // 'elevenlabs' | 'say' | 'espeak'
+    voice: 'rachel',
+    speed: 1.0,
+  },
+
+  // Timeouts
+  silenceTimeoutMs: 3000,
+  maxRecordingMs: 30000,
+});
+```
+
+### Start/Stop Listening
+
+```typescript
+// Start listening for wake word
+await voice.start();
+
+// Check if listening
+const isListening = voice.isListening();
+
+// Stop listening
+await voice.stop();
+```
+
+### Event Handlers
+
+```typescript
+// Wake word detected
+voice.on('wake', () => {
+  console.log('Wake word detected!');
+});
+
+// Speech recognized
+voice.on('speech', (text: string) => {
+  console.log(`User said: ${text}`);
+});
+
+// Transcription complete
+voice.on('transcript', (result) => {
+  console.log(`Final: ${result.text}`);
+  console.log(`Confidence: ${result.confidence}`);
+  console.log(`Duration: ${result.durationMs}ms`);
+});
+
+// Error handling
+voice.on('error', (error) => {
+  console.error('Voice error:', error);
+});
+
+// Silence detected
+voice.on('silence', () => {
+  console.log('User stopped speaking');
+});
+```
+
+### Speak (TTS)
+
+```typescript
+// Speak text
+await voice.speak('Your order has been placed');
+
+// Speak with options
+await voice.speak('Market is up 5%', {
+  voice: 'josh',
+  speed: 1.2,
+  pitch: 1.0,
+});
+
+// Cancel speaking
+voice.cancelSpeech();
+```
+
+### Manual Transcription
+
+```typescript
+// Transcribe audio buffer
+const result = await voice.transcribe(audioBuffer, {
+  language: 'en',
+  prompt: 'Trading commands',  // Context hint
+});
+
+console.log(`Text: ${result.text}`);
+console.log(`Language: ${result.language}`);
+```
+
+### Voice Activity Detection
+
+```typescript
+// Check if user is speaking
+const vad = voice.getVAD();
+
+vad.on('speechStart', () => {
+  console.log('User started speaking');
+});
+
+vad.on('speechEnd', (audio) => {
+  console.log('User stopped speaking');
+  // audio contains the recorded speech
+});
+```
+
+---
+
+## Wake Word Configuration
+
+| Setting | Values | Description |
+|---------|--------|-------------|
+| `wakeWord` | Any phrase | Trigger phrase |
+| `sensitivity` | 0.0 - 1.0 | Detection threshold |
+
+**Built-in wake words:**
+- "hey clodds"
+- "okay clodds"
+- "clodds"
+
+---
+
+## STT Providers
+
+| Provider | Quality | Speed | Offline |
+|----------|---------|-------|---------|
+| **Whisper** | Excellent | Medium | Yes |
+| **Vosk** | Good | Fast | Yes |
+| **Google** | Excellent | Fast | No |
+
+---
+
+## TTS Providers
+
+| Provider | Quality | Voices | API Key |
+|----------|---------|--------|---------|
+| **ElevenLabs** | Premium | 30+ | Required |
+| **say** (macOS) | Good | System | None |
+| **espeak** | Basic | Many | None |
+
+---
+
+## Voice Commands Examples
+
+Once voice is active, speak naturally:
+
+```
+"Hey Clodds, what's my portfolio value?"
+"Hey Clodds, buy 100 dollars of Trump YES"
+"Hey Clodds, what are the top arbitrage opportunities?"
+"Hey Clodds, set a price alert for Bitcoin at 100k"
+```
+
+---
+
+## Best Practices
+
+1. **Quiet environment** — Background noise affects accuracy
+2. **Clear speech** — Speak clearly for best recognition
+3. **Short commands** — Keep voice commands concise
+4. **Confirmation** — Enable confirmations for trades
+5. **Fallback** — Text input always available

package/dist/skills/bundled/voice/index.js

@@ -166,8 +166,8 @@ async function execute(args) {
                 return helpText();
         }
     }
-    catch {
-        return helpText();
+    catch (error) {
+        return `Error: ${error instanceof Error ? error.message : String(error)}`;
     }
 }
 function helpText() {

package/dist/skills/bundled/voice/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/skills/bundled/voice/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/skills/bundled/voice/index.ts"],"names":[],"mappings":"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"}

package/dist/skills/bundled/weather/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: weather
+description: "Weather betting - NOAA data for Polymarket weather markets"
+command: weather
+emoji: "🌤️"
+gates:
+  envs:
+    - POLY_API_KEY
+---
+
+# Weather Betting
+
+Use NOAA weather forecasts to find edge on Polymarket weather markets.
+
+## Commands
+
+```
+/weather scan                              Scan all weather markets for edge
+/weather forecast <city>                   Get NOAA forecast for a city
+/weather markets                           List active weather markets
+/weather edge <market-id>                  Calculate edge for specific market
+/weather bet <market-id> <amount>          Execute bet
+/weather auto [--threshold 10]             Auto-bet on high-edge markets
+/weather history                           View bet history
+```
+
+## Examples
+
+```
+/weather forecast "New York"
+/weather scan
+/weather edge abc123
+/weather bet abc123 10
+/weather auto --threshold 15
+```
+
+## How It Works
+
+1. **Fetch NOAA Forecast**: Get official NWS weather data (free, no API key)
+2. **Match to Markets**: Find Polymarket weather markets for the same location/date
+3. **Calculate Edge**: Compare NOAA probability to market YES price
+4. **Bet if Edge**: If NOAA probability differs significantly from market, bet
+
+## Edge Calculation
+
+```
+Edge = NOAA Probability - Market Price
+
+Example:
+  NOAA says 80% chance of rain in NYC tomorrow
+  Polymarket "Will it rain in NYC?" YES price: 0.65 (65%)
+  Edge = 80% - 65% = +15% -> Bet YES
+```
+
+## Supported Market Types
+
+- **Temperature**: "Will NYC exceed 90°F on Saturday?"
+- **Precipitation**: "Will it rain in LA tomorrow?"
+- **Snow**: "Will Chicago get 6+ inches of snow?"
+- **Record**: "Will Phoenix hit a record high this week?"
+
+## Confidence Levels
+
+- **High**: Edge >= 15%, reliable forecast data
+- **Medium**: Edge 10-15%, some uncertainty
+- **Low**: Edge 5-10%, more speculative
+
+## Position Sizing
+
+Uses quarter-Kelly criterion for conservative sizing:
+
+```
+Bet Size = Bankroll * (Edge / Odds) * 0.25
+```
+
+Capped at 10% of bankroll per bet.
+
+## Supported Cities
+
+Major US cities including: New York, Los Angeles, Chicago, Houston, Phoenix, Philadelphia, San Antonio, San Diego, Dallas, San Jose, Austin, Jacksonville, San Francisco, Seattle, Denver, Washington DC, Boston, Nashville, Detroit, and more.

package/dist/skills/bundled/weather/index.js

@@ -272,6 +272,9 @@ Minimum recommended: 5%`;
         // Calculate shares from dollar amount
         // shares = amount / price
         const price = side === 'YES' ? edge.marketPrice : (1 - edge.marketPrice);
+        if (price <= 0) {
+            return `Cannot calculate shares: market price is ${(edge.marketPrice * 100).toFixed(1)}%.`;
+        }
         const shares = Math.floor(amount / price);
         if (shares < 1) {
             return `Amount too small. Minimum bet is $${price.toFixed(2)} for 1 share.`;