A CLI tool for monitoring Starknet smart contracts and streaming events to Datadog dashboards. Starky automatically parses contract ABIs, extracts events and function calls, and creates real-time dashboards.

• 🚀 Automatic ABI Parsing: Supports both Dojo manifests and Scarb contract classes
• 📊 Real-time Dashboards: Creates and manages Datadog dashboards automatically
• 🔍 Event Monitoring: Tracks contract events with human-readable names
• ⚡ Function Call Detection: Monitors contract function invocations
• 🔧 Multi-Contract Support: Monitor multiple contracts simultaneously

# Clone the repository
git clone https://github.com/dubzn/starky.git
cd starky

# Install dependencies
npm install

# Build the project
npm run build

# Link globally
npm link

# Set up environment variables
cp .env.example .env
export $(grep -v '^#' .env | xargs)

Create a .env file with your Datadog credentials:

# Datadog Configuration
DD_API_KEY=your_datadog_api_key
DD_APP_KEY=your_datadog_app_key
DD_SITE=us5.datadoghq.com  # or your Datadog site

# Starknet RPC (optional, defaults to Alchemy)
# Supports any RPC included Katana
STARKNET_RPC_URL=rpc_url

starky board create "my-starknet-monitor"

For Dojo projects (automatic contract detection):

starky setup ./manifest.json

For Scarb contracts (manual setup):

# Edit starky.config.json manually
{
  "activeBoardId": "your-board-id",
  "abiFile": "./contract_class.json",
  "contracts": ["0x1234...", "0x5678..."]
}

# Monitor from latest block
starky ingest --from-block latest

# Monitor from specific block
starky ingest --from-block 1000000

# Monitor with custom interval
starky ingest --from-block latest --interval-ms 2000

# Create a new dashboard
starky board create "dashboard-name"

# Auto-setup for Dojo projects
starky setup ./manifest.json

# Basic monitoring
starky ingest

# Advanced options
starky ingest --from-block latest --lookback-blocks 10 --interval-ms 1500 --verbose

{
  "activeBoardId": "your-datadog-board-id",
  "abiFile": "./contract_class.json",
  "contracts": [
    "0x1234567890abcdef...",
    "0xabcdef1234567890..."
  ],
  "eventNames": []
}

Starky automatically creates dashboards with:

• 📊 Event Counts: Real-time event occurrence statistics
• 🔧 Function Calls: Contract function invocation tracking
• 📈 Time Series: Historical event and function call trends
• 🎯 Contract Filtering: Filter by specific contracts
• 🔍 Event Details: Detailed event data and parameters
• 📋 Live Logs: Real-time log stream from Datadog

Starky automatically detects and processes:

• ✅ Contract events with human-readable names
• ✅ Event selectors and parameters
• ✅ Block numbers and transaction hashes
• ✅ Timestamps and contract addresses

• ✅ Function names and selectors
• ✅ Target contract addresses
• ✅ Transaction details
• ✅ Call parameters and results

• 🚀 Smart Block Skipping: Only processes new blocks using starknet_blockNumber
• ⚡ Efficient RPC Usage: Minimal API calls for maximum performance
• 🔄 Automatic Retry: Handles RPC errors gracefully
• 📊 Memory Efficient: Optimized data structures for large-scale monitoring

Missing Events

• Verify contract addresses in starky.config.json
• Check ABI file path and format
• Ensure contracts are deployed and active

Apache License 2.0 - see LICENSE file for details.

Starky - Making Starknet monitoring simple and powerful! 🚀