Skip to content

mrphatom/reactive-sentinel

Repository files navigation

Reactive Sentinel 🛡️⛓️

An automated, cross-chain security state machine powered by Reactive Network. Reactive Sentinel monitors smart contract events on an origin chain (Ethereum Sepolia) in real-time and instantly triggers emergency mitigation callbacks on a destination chain (Base Sepolia) within seconds of an exploit or critical state change.


🏗️ Architecture Overview

Reactive Sentinel eliminates the latency of traditional centralized keepers by executing low-latency, decentralized event-driven reactions directly at the consensus level.

  1. Origin Event: A state-changing event (e.g., a mock attack or deposit) is triggered on EthOriginVault.
  2. Reactive Interception: The SentinelReactive contract deployed on the Reactive Lasna Testnet intercepts the log emission instantly via sub-graphless event subcription.
  3. Cross-Chain Callback: The reactive engine computes the state mutation and dispatches an automated, authorized callback down to BaseOriginVault to lock states or alter permissions.

📍 Deployed Contract Addresses

The architecture is fully compiled, optimized, and deployed across the following testnet layers:

Contract Network Live Explorer Address
EthOriginVault Ethereum Sepolia 0xB51aAaC9604250987978...
BaseOriginVault Base Sepolia 0x71A80Ff1868B05753d83...
SentinelReactive Reactive Lasna 0x2F51F0dB9e7F3966CA0F...

💻 Tech Stack

  • Smart Contracts: Solidity (Hardhat compilation pipeline)
  • Reactive Layer: Reactive Network (Lasna Testnet)
  • Frontend: Vite + React + TypeScript + TailwindCSS
  • Package Management: PNPM Workspaces

🧪 How It Works (Simulation & Testing)

You can test the end-to-end automated reaction flow using the interactive frontend dashboard or directly via block explorers:

1. Trigger the Event

Connect your Web3 wallet (MetaMask / Phantom) to the Ethereum Sepolia Testnet and call the deposit() or simulated trigger function on the EthOriginVault contract.

2. Observe the Reactive Pipeline

Open the Reactive Omni Explorer (lasna-omni.reactscan.net) and paste the SentinelReactive address. You will observe the reactive transaction capturing the origin event emit.

3. Verify Cross-Chain State Sync

Check the transaction history of BaseOriginVault on Base Sepolia Etherscan. Within blocks, an automated callback transaction origin from the Reactive Network will be executed, proving fully autonomous cross-chain synchronization.

About

A cross-chain, event-driven security system that detects dangerous on-chain events and automatically issues low-latency freeze callbacks via the Reactive Network. It combines Solidity contracts (Hardhat) that run on multiple EVM testnets with a Vite + React TypeScript dashboard & workspace libraries that support deployment, an API server, and more

Topics

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors