EVM Observability SDK

Lightweight, zero-dependency on-chain observability SDK for EVM smart contracts.

This SDK provides a simple and gas-efficient way to emit structured telemetry events from smart contracts, enabling off-chain analytics, tracing, monitoring, and product metrics — without changing business logic.

🚀 Installation

Install via npm:

npm install @smart-alert/evm-observability

✨ Key Features

• 📡 Function call tracing (who, what, where)
• 📊 Business metrics emitted directly from contracts
• 🧩 Zero runtime dependencies
• ⚡ No external calls, no shared state
• 🛠 Works with any EVM-compatible chain
• 🧠 Contract-agnostic off-chain analytics

📦 What This SDK Is (and Is Not)

✅ This SDK IS

• A Solidity compile-time SDK
• A set of standardized events
• A reusable abstract contract
• A stable on-chain telemetry schema

❌ This SDK is NOT

• A deployed central contract
• A runtime dependency
• A protocol with shared state
• A replacement for business events like Transfer

🏗 Architecture Overview

Smart Contract Architecture

┌──────────────────────────────┐
│ Your Smart Contract          │
│ (Vault, AMM, etc)           │
└─────────────┬────────────────┘
              ▼
┌──────────────────────────────┐
│ Observability.sol (SDK)      │
│ - ObsCall                    │
│ - ObsMetric                  │
└─────────────┬────────────────┘
              ▼
┌──────────────────────────────┐
│ Blockchain Logs              │
└─────────────┬────────────────┘
              ▼
┌──────────────────────────────┐
│ Off-chain SDK / Indexer /    │
│ Analytics                    │
└──────────────────────────────┘