Skip to content

README_1752562560411.md

Latest commit

 

History

History
145 lines (101 loc) · 4.94 KB

README_1752562560411.md

File metadata and controls

145 lines (101 loc) · 4.94 KB
Raw

🔐 Gnosis-vault Organization README

🚫 PRIVATE: Internal Use Only — Visible to Gnosis-vault🔐 Members

This repository is the operational HQ of the Safe-Wallet-Custom-Secure-dApp project, governed and maintained by the Gnosis-vault🔐 org.

🧠 What Is This?

This is not just a multisig vault. This is:

  • 🧰 A GitHub-native Safe coordination system
  • ⚙️ GitHub Actions + Reown-based proposal orchestration
  • 📡 Realtime alerts to Discord, Telegram, and frontend dashboards
  • 📊 Safe status synced into markdown + APIs
  • 🌐 Production dashboards hosted via Vercel + Replit
  • 🧪 DevOps logic to manage proposals, signers, and frontend uptime

Built for humans. Powered by code. Backed by vault-grade security.

✅ Vault Status

Role Safe Address Network Balance Threshold
Legacy Vault 0x10A1...2e4f Ethereum {{balance_legacy}} {{threshold_legacy}}
Primary Org Vault 0x821f...Ed675 Arbitrum {{balance_primary}} {{threshold_primary}}
Signer Key Vault 0xAfD5...A0A0 Ethereum {{balance_signer}} {{threshold_signer}}

Last synced: {{last_updated}}

🔁 Live Proposals

These are auto-fetched daily via GitHub Actions.

Date Description Status Safe
{{proposals_table}}

📂 View full proposal history → .github-private/logs/safe-proposals.json

🌐 Frontend Environments

Platform Link Description
🧪 Replit Gnosis-vault Dev Dev testing UI for Safe proposals
🚀 Vercel chatgtp-bot-reown.xyz Production multichain Safe dashboard
📊 Reown AppKit AppKit Interface Safe x Reown integration template

📶 System Health & Status

Component Badge Status
GitHub Actions CI ✅ Daily sync running
Vercel UI Vercel ✅ Domain resolves
Replit Preview Replit ✅ Manually available
Safe Frontend Status status.json ✅ Generated & monitored

🧪 Uptime can be tracked via /status route (coming soon).

🧑‍💼 Org Roles & Workflow

🧭 Members

  • @thegoodeth12 – Vault Architect, Infra
  • @gnosisbot – GitHub Bot, Automation
  • @Reown – Signing interface

🛠 Onboarding Steps

  1. Accept GitHub org invite.
  2. Get added to Safe signers.
  3. Install Reown.
  4. Join Discord & Telegram for alerts.
  5. Approve transactions from UI or GitHub.

🧾 Workflow Structure

File/Dir Purpose
scripts/update-readme.ts Injects balances + threshold into this README
scripts/fetch-proposals.ts Pulls Safe proposals from Arbitrum/Ethereum
.github/workflows/update-readme.yml GitHub Action to sync every 24h
config/safes.json Source of truth for Safe metadata
logs/safe-proposals.json Proposal log history
status.json Tracks frontend + GitHub + Safe uptime

🤖 Integrations

  • 🟣 Discord: Pings on new proposals, confirmation alerts
  • 🟦 GitHub App: Issues/PRs can create Safe proposals
  • 🔐 Reown: Secure MPC signing — no keys needed
  • 🟡 Slack: (Coming Soon)
  • 🚀 Telegram Bot: @vault_signer_bot (Beta)
  • 🌐 API Ready: Turn README & status into a live endpoint

👮 Rules of the Vault

  • ✅ 2FA required for all contributors
  • 🚫 Never commit secrets, private keys, or RPC URLs
  • 🗳️ All proposals must flow through PR/issue trigger
  • 🔐 Only Reown-verified signers can confirm transactions
  • 🧼 main = clean code only — use dev for draft logic

🧭 Roadmap — Q3 / Q4

Feature Status
✅ Proposal table in README Done
✅ GitHub Action CI Done
✅ Live signer dashboard Done
✅ Replit/Vercel deploys Done
🔜 Telegram signer approval In beta
🔜 Safe batch proposal builder Planned
🔜 /status JSON endpoint Planned
🔜 Slack bot notifications Planned
🔜 Live PR-to-Proposal comment automation Building

🧙 Final Words

“A vault is only as powerful as the people who coordinate it.”

This README is more than documentation — it's the brainstem of your multisig infrastructure. Automated. Synced. Alive.

Built with 🧠 by @thegoodeth12
Maintained by the Gnosis-vault🔐 org
Powered by Safe, Reown, GitHub, Discord, and DevOps sauce 🌐