SafeVault is a full-stack Safe App that enhances the governance and coordination of Safe{Wallet} users through GitHub-native workflows, automation, and real-time tooling. • 🧠 Built on Safe SDK + AppKit (Reown) • ⚙️ GitHub Actions-powered Safe proposal creation • 🧾 PWA frontend with multi-network support • 🔔 Telegram preview bots for signer updates • 🛂 Reown login + Safe connection • 🌐 Hosted on GitHub Pages / Safe Apps iframe
⸻
📦 Features • ✅ GitHub → Safe Transaction: Issue comment → Proposal command • ✅ Reown wallet login & Safe signer mapping • ✅ Safe App SDK integration for direct multisig execution • ✅ Owner threshold management + status tracking • ✅ Telegram + Email notification support (via bot/webhooks) • ✅ Supports: Ethereum, Arbitrum, Optimism, Polygon, Gnosis, Base, zkSync, Sepolia
⸻
🚀 Live Demo
🧪 SafeVault App
🧠 Reown AppKit
⸻
🧩 Safe App Configuration
Required to list your app on Safe{Wallet} and run it inside the Safe App browser. { "name": "SafeVault", "description": "Governance and automation platform for Safe{Wallet}", "iconUrl": "https://your-safevault-url.com/icon.png", "url": "https://your-safevault-url.com", "chainIds": [1, 10, 137, 42161, 100, 8453, 1101], "provider": "Reown", "accessControl": { "type": "no_restriction" } }
⚙️ Environment Configuration
Create a .env.local file in the root: NEXT_PUBLIC_SAFE_ADDRESS=<default 0xAfD5f60aA8eb4F488eAA0eF98c1C5B0645D9A0A0> NEXT_PUBLIC_REOWN_PROJECT_ID=< 0e86b980-2298-4978-8dd5-0b9e7af95016> NEXT_PUBLIC_TELEGRAM_BOT_URL= https://t.me/mysafenotifier_bot NEXT_PUBLIC_SUPPORTED_CHAINS=1,10,137,42161,100 NEXT_PUBLIC_SITE_URL=https://your-safevault-url.com
🛠️ Development Setup git clone https://github.com/your-org/SafeVault.git cd SafeVault npm install npm run dev Local app will run at: http://localhost:3000
🧪 GitHub Actions Integration
Use proposal commands in issues to trigger Safe transactions.
• GitHub Workflow: .github/workflows/trigger-safe-proposal.yml
• Available Commands:
• /transfer
• /change-threshold
• /add-owner
• /remove-owner
See /backend/commands/ for full logic.
⸻
🛡️ Safe SDK & AppKit • Safe SDK Docs • @safe-global/safe-apps-react-sdk • Reown AppKit
⸻
🚢 Deployment
🔁 GitHub Pages (Static Export) npm run export Then push the /out directory to the gh-pages branch. You can automate this with:
uses: peaceiris/actions-gh-pages@v4
🛂 Permissions & Security • Uses official Safe contracts only • No private key management • Reown handles auth and wallet mapping • GitHub Actions scoped to repo-level automation
⸻
🧾 License
MIT License © 2025 TheGoodEth
⸻
📬 Contact / Support • 🔗 Telegram Support: @SafeVaultBot • ✉️ Email: [email protected]