How to Set Up Telegram Alerts for Smart Contract Changes

If you hold a significant position in any DeFi token or monitor a deployed smart contract, Telegram alerts are one of the most practical ways to stay informed. When something changes on-chain — an ownership transfer, a proxy upgrade, a large token movement — you want to know immediately, not hours later when you happen to check.

This guide walks through setting up Telegram smart contract alerts using ChainRaven, which offers native Telegram bot delivery without any code or webhook configuration required.

Why Telegram?

Most monitoring tools default to email or Discord. Telegram has practical advantages for on-chain security:

• Push notifications arrive on mobile instantly, unlike email which often has delays
• Telegram bots can send rich-formatted messages with contract addresses, transaction hashes, and direct links
• No app switching — most crypto traders already have Telegram open throughout the day
• Groups and channels — you can forward alerts to a shared team channel without everyone needing their own account

ChainRaven is one of the few monitoring tools that offers native Telegram delivery. Neither Tenderly nor OpenZeppelin Defender currently offer Telegram integration.

What Events Can You Monitor?

Before setting up alerts, choose which events matter for your use case.

For DeFi investors holding a token:

• Ownership transfer — the contract owner changes hands (often precedes a rug)
• Proxy upgrade — the contract logic is replaced
• Large transfers — whale-sized movements that could indicate an incoming dump
• Mint events — new tokens created (supply dilution)

For developers monitoring your own deployed contracts:

• Ownership changes — detect unauthorized takeover attempts
• Proxy upgrades — confirm your own upgrades executed correctly
• Admin function calls — any privileged operation on your contract
• Unusual activity — transfer patterns outside normal parameters

Step 1: Create a ChainRaven Account

Go to ChainRaven and create a free account. The free tier includes email alerts on one contract. Telegram delivery is available on the Starter plan ($19/month) and above.

If you're testing, you can scan any token without an account — but to save alert configurations and receive Telegram notifications, you'll need to be signed in.

Step 2: Connect Your Telegram Account

1. Go to Settings → Notifications in your ChainRaven dashboard
2. Click Connect Telegram
3. You'll see a link to ChainRaven's Telegram bot — click it to open Telegram
4. Send the /start command to the bot — it responds with a confirmation code
5. Enter that code back in ChainRaven to link your account

Once linked, the bot will send a test message to confirm the connection. Your Telegram user ID is stored and used to deliver all future alert messages.

Step 3: Add a Contract to Monitor

1. Go to the Scanner and scan the token or contract you want to monitor
2. On the token report page, click Monitor this contract (or go to Dashboard → Add Contract)
3. Select the chain (Ethereum, Base, Polygon, Arbitrum, Optimism, Solana)
4. Paste the contract address
5. Give it a label (e.g., "USDC Treasury", "Protocol X Proxy")

Step 4: Configure Your Alert Rules

After adding a contract, you'll see the alert configuration panel. Select which events should trigger a Telegram notification:

For most investor use cases, enabling Ownership Transfer and Proxy Upgrade is the minimum. These two events are the earliest warning signs of a rug in progress.

Step 5: Set Alert Delivery to Telegram

In the delivery settings for each alert rule, select Telegram as the channel. You can also select multiple channels simultaneously — for example, both Telegram (for instant mobile delivery) and email (for a record you can search later).

Save the configuration. That's it — no webhook URL to manage, no bot token to configure, no server to run.

What a Telegram Alert Looks Like

When an alert fires, ChainRaven's bot sends a formatted message like this:

🚨 OWNERSHIP TRANSFERRED
Contract: EXAMPLE TOKEN (0xABC...DEF)
Chain: Ethereum
From: 0x1234...5678 (Deployer)
To: 0x9876...4321
Tx: 0xfeed...cafe
Time: 2026-03-27 14:32 UTC

View full report → chainraven.com/token/0xABC/ethereum

For proxy upgrades:

⚠️ PROXY UPGRADE DETECTED
Contract: PROTOCOL X (0xDEF...ABC)
Chain: Base
New Implementation: 0xNEW...IMPL
Previous: 0xOLD...IMPL
Tx: 0xdead...beef

View report → chainraven.com/token/0xDEF/base

The direct link goes to the ChainRaven token page where you can see the full context, vote, and review the updated implementation.

Monitoring Multiple Contracts

If you're a developer managing multiple deployed contracts, or an investor with positions across several tokens, you can add all of them to a single dashboard. All alerts route to the same Telegram account — so one bot covers your entire watchlist.

Contracts are organized by:

• Label (the name you assign)
• Chain
• Alert status (active / paused)
• Last event received

You can pause alerts for a contract without removing it — useful if you're temporarily not tracking a position.

Team Monitoring: Shared Telegram Channel

For teams, you can forward ChainRaven alerts to a shared Telegram channel:

1. Create a Telegram channel or group for your team's security alerts
2. Add the ChainRaven bot to the channel as an admin
3. In ChainRaven's Telegram settings, select "Send alerts to a channel" and enter the channel ID

Every team member in the channel receives the alert simultaneously. This is useful for protocol operators who need multiple people aware of any on-chain changes.

Alternative: Discord and Webhooks

If your team prefers Discord over Telegram, ChainRaven supports Discord webhooks on Starter plans and above. Go to Settings → Notifications → Discord and paste your webhook URL.

For custom integrations (Slack, PagerDuty, internal tooling), Starter+ plans include HTTP webhook delivery — a POST request with the alert data in JSON format.

Get Started

The fastest path to Telegram monitoring:

1. Create a free account →
2. Scan the token you want to monitor
3. Upgrade to Starter ($19/month) to enable Telegram delivery
4. Connect Telegram and configure your alerts

For most DeFi investors, enabling ownership transfer and proxy upgrade alerts on the tokens you hold is the highest-value, lowest-effort security setup you can have.

Set up contract monitoring →