Documentation

Quick Start Guide

Get up and running with ChainRaven in minutes

You're 5 minutes away from real-time smart contract monitoring. Follow the steps below to add your first contract and start receiving alerts.

What You'll Need


Step 1: Sign In

Go to chainraven.com and click Sign In in the top-right corner.

No account yet? Click Get Started to create a free account. No credit card required.


Step 2: Add Your First Contract

Once signed in, you'll land on your Dashboard. To add a contract:

  1. Click Add Contract in the left sidebar
  2. Paste your contract address — e.g. 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
  3. Select the blockchain network (Ethereum, Base, Polygon, etc.)
  4. Click Start Monitoring

Your contract will appear in the contract list with a green pulse indicator showing it's actively being monitored.


Step 3: Review Your Alert Settings

ChainRaven automatically monitors for the following event types:

Alert TypeWhat It DetectsDefault Severity
Ownership TransferContract owner has changedHigh
Proxy UpgradeImplementation address changedCritical
Admin ChangeAdmin role granted or revokedHigh
Large TransferToken transfer exceeds your thresholdConfigurable

By default, email alerts are enabled for all event types. Head to Alert Preferences to customize channels, cooldowns, and thresholds.


Step 4: Explore Your Dashboard

Your dashboard gives you a live view of everything:

  • Contract List — All monitored contracts with health status indicators
  • Event Feed — Real-time events detected on your contracts
  • Sent Alerts — Full history of notifications delivered to you

Contract Health Indicators

Each contract shows a color-coded health badge:

IndicatorMeaning
🟢 HealthyNo concerning events detected
🟡 ElevatedSome events detected — worth reviewing
🔴 CriticalHigh-severity events — investigate immediately

Filtering the Event Feed

Use the filter bar above the event feed to narrow results:

  • By event type (ownership, proxy, role, transfer)
  • By severity level (Low, Medium, High, Critical)
  • By contract address

What's Next?

Tip: Setting up Telegram takes under 2 minutes and gives you instant mobile push notifications — highly recommended.

Explore the rest of the docs to get the most out of ChainRaven:


Need Help?

If you run into any issues, email us at support@chainraven.io and we'll help you get set up.