Authors: Roman Mazur (https://github.com/mazurroman), Simon Arvaux (https://github.com/saimeunt)
Date last updated: October 9, 2025
Created for: https://gov.optimism.io/t/open-governance-fund-mission-request-open-source-monitoring-alerting/10293
This document provides a technical exploration of the ruleset design and TypeScript SDK API for Walnut’s proposal for the Open-Source Monitoring & Alerting Mission Request on OP Gov Forum.
Each rule below includes a pseudocode implementation. Writing these pseudocode examples helps us validate the design of our TypeScript SDK and ensure it remains flexible enough to support a wide range of rulesets.
This is an early exploration, and the work will evolve as we continue developing the SDK.
The below list contains a comprehensive set of example rulesets from basic to advanced, covering multiple scenarios and touching two leading protocols — Aave and Uniswap.
All of these rulesets will be implemented as part of Walnut’s application to https://gov.optimism.io/t/open-governance-fund-mission-request-open-source-monitoring-alerting/10293.
Table of Content
This rule listens for balance change of given accounts, if the balance goes below a certain amount an alert is triggered, eg. a faucet contract being almost depleted.
Arguments: