Skip to content
This repository was archived by the owner on Apr 12, 2026. It is now read-only.

Commit c8c9f28

Browse files
committed
docs: polish readme hero section
1 parent 803f95e commit c8c9f28

1 file changed

Lines changed: 70 additions & 9 deletions

File tree

README.md

Lines changed: 70 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,62 @@
11
# Nulla
22

3-
Nulla is a cross-chain approval firewall for Safe. It uses a single Reactive contract on Lasna to watch risky approval activity across Ethereum Sepolia and Base Sepolia, revoke the approval on the source chain, and push the peer chain into Shield Mode.
3+
<p>
4+
<strong>Detect once. Defend across chains.</strong>
5+
</p>
6+
7+
<hr />
8+
9+
<p align="center">
10+
<a href="./docs/from-zero-to-dual-chain-demo.en.md">
11+
<img alt="Language English" src="https://img.shields.io/badge/Language-English-1677ff">
12+
</a>
13+
<a href="./docs/from-zero-to-dual-chain-demo.md">
14+
<img alt="语言 简体中文" src="https://img.shields.io/badge/%E8%AF%AD%E8%A8%80-%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87-e67e22">
15+
</a>
16+
</p>
17+
18+
<p align="center">
19+
<img alt="License MIT" src="https://img.shields.io/badge/License-MIT-f1c40f">
20+
<img alt="Chains Ethereum Sepolia + Base Sepolia" src="https://img.shields.io/badge/Chains-Ethereum%20Sepolia%20%2B%20Base%20Sepolia-2980b9">
21+
<img alt="Reactive Network Lasna" src="https://img.shields.io/badge/Reactive-Lasna-8e44ad">
22+
<img alt="Safe approval firewall" src="https://img.shields.io/badge/Safe-approval%20firewall-27ae60">
23+
<img alt="Frontend Next.js" src="https://img.shields.io/badge/Frontend-Next.js-111111">
24+
</p>
25+
26+
<p align="center">
27+
<img alt="Demo same address Safe" src="https://img.shields.io/badge/Demo-Same--address%20Safe-34495e">
28+
<img alt="Recovery manual and automatic" src="https://img.shields.io/badge/Recovery-manual%20%2B%20automatic-e67e22">
29+
<img alt="Execution Reactive + Safe" src="https://img.shields.io/badge/Execution-Reactive%20%2B%20Safe-16a085">
30+
</p>
31+
32+
<p>
33+
Nulla is a cross-chain approval firewall for Safe. It uses a single Reactive contract on Lasna to watch risky approval activity across Ethereum Sepolia and Base Sepolia, revoke the approval on the source chain, and push the peer chain into Shield Mode.
34+
</p>
35+
36+
<p>
37+
<strong>Quick Links</strong>
38+
</p>
39+
40+
- 🚀 [English Demo Guide](./docs/from-zero-to-dual-chain-demo.en.md)
41+
- 🇨🇳 [中文双链测试流程](./docs/from-zero-to-dual-chain-demo.md)
42+
- 🎯 [Hackathon Final Submission](./deployments/hackathon-final-submit.md)
43+
- 🧾 [Demo Evidence](./deployments/demo-evidence.md)
44+
45+
## Table of Contents
46+
47+
- [🚨 Why Nulla](#why-nulla)
48+
- [🧱 Stack](#stack)
49+
- [🔄 Core Demo Flow](#core-demo-flow)
50+
- [📚 Guides](#guides)
51+
- [🛠 Local Commands](#local-commands)
52+
53+
## Why Nulla
54+
55+
- Dangerous approvals are everywhere in Web3.
56+
- Granting approvals is easy; cleaning them up is usually manual.
57+
- Same-address multi-chain Safe deployments increase shared blast radius.
58+
- Nulla turns that problem into a single cross-chain security workflow:
59+
detect risk, revoke locally, shield the peer chain, then recover.
460

561
## Stack
662

@@ -9,16 +65,21 @@ Nulla is a cross-chain approval firewall for Safe. It uses a single Reactive con
965
- Safe modules and guards for approval enforcement
1066
- Next.js for the demo UI, onboarding flow, and control console
1167

12-
## Core demo flow
68+
## Core Demo Flow
69+
70+
1. Enable Guardian Mode for the shared Safe.
71+
2. Trigger a risky approval on one chain.
72+
3. Let Lasna react and coordinate cross-chain protection.
73+
4. Revoke the source-chain approval.
74+
5. Enter Shield Mode on the peer chain.
75+
6. Exit Shield manually or automatically after the recovery window.
76+
77+
## Guides
1378

14-
1. Enable Guardian Mode for the shared Safe
15-
2. Trigger a risky approval on one chain
16-
3. Let Lasna react and coordinate cross-chain protection
17-
4. Revoke the source-chain approval
18-
5. Enter Shield Mode on the peer chain
19-
6. Exit Shield manually or automatically after the recovery window
79+
- [English end-to-end demo guide](./docs/from-zero-to-dual-chain-demo.en.md)
80+
- [中文双链测试流程](./docs/from-zero-to-dual-chain-demo.md)
2081

21-
## Local commands
82+
## Local Commands
2283

2384
```bash
2485
rtk forge build

0 commit comments

Comments
 (0)