DarkCircle Suite Docs
Docs / DarkSafe

🔐 DarkSafe Beta

A Safe{Wallet}-style multi-signature vault dashboard for Quai Network's Cyprus-1 execution shard: on-chain proposals, a native timelock, quorum checks, and no DELEGATECALL. Source: multisigows/ · Route: /multisigows/

What it is

Creating a vault

The "Create Vault" wizard (connect → owners → security → review) goes through the DarkSafe v2 factory. It:

  1. mines a CREATE2 salt so the address lands in Cyprus-1 on the Quai ledger;
  2. checks that address against the factory's own predictWalletAddress;
  3. simulates the creation, sends it, and waits for confirmations;
  4. requires the WalletCreated event to name the predicted address;
  5. verifies the new vault on chain (code, implementation, factory registration, owners, threshold, timelock) before saving it.

"Add existing vault" accepts only vaults the verified factory created. The factory address comes from packages/contracts/deployments via pinned.ts, or from VITE_V2_FACTORY_ADDRESS, and is checked on chain against the pinned build before the app uses it.

Review before every write

Every propose, approve and execute goes through a review screen that decodes the call and lists risks; shows full addresses, exact amounts and raw calldata with a typed confirmation for admin changes; re-derives the transaction hash from its stored contents; and compares vault and transaction state across the app's RPC, an optional second RPC and the wallet's own node. A disagreement blocks every write.

Build and run

cd multisigows
pnpm install
pnpm build        # contracts, all packages, then the web app
pnpm test
pnpm dev          # dashboard dev server

Point the dashboard at a network at build/dev time in apps/web:

VITE_QUAI_NETWORK=mainnet|testnet     # default: testnet (Orchard)
VITE_QUAI_RPC_URL=<override>          # default: the profile's canonical rpcUrl
VITE_V2_FACTORY_ADDRESS=0x00...       # optional: a factory to use instead of the recorded one
VITE_QUAI_SECONDARY_RPC_URL=<url>     # optional: a second RPC to cross-check vault state

Security status

Unaudited

The vault contracts have not had an independent audit. The app shows a beta banner, and mainnet vault creation is off unless a build sets VITE_ALLOW_MAINNET_VAULTS=true. The road to mainnet is gated step by step in docs/LAUNCH.md inside multisigows/.