Skip to content

TokenFon MultiSig Project

What is TokenFon MultiSig?

TokenFon MultiSig, developed by Cerratech for TokenFon, provides secure on-chain governance and administration for the TokenFon testnet chain through a multisig wallet. This wallet controls the genesis contract and other key contracts on the chain, ensuring that critical decisions require consensus from multiple parties.

The system relies on a council of pre-selected wallet addresses, requiring a set number of confirmations to execute transactions. Based on the upgraded Gnosis Safe contract (Solidity 0.8.19), it ensures transparency, security, and flexibility in managing on-chain decisions while maintaining complete blockchain-based traceability.

What Does It Bring?

Core Functionalities

  • Secure Governance: Multisig wallet for managing TokenFon testnet chain's genesis contract and key contracts
  • Council-Based Control: Pre-selected wallet addresses forming a governance council with confirmation requirements
  • Transaction Management: Submit, confirm, and execute transactions with transparent confirmation processes
  • Dual User Interface: Support for both non-technical users through contract wizard and technical users through detailed forms

Technical Capabilities

  • Blockchain Transparency: Every transaction and decision recorded on-chain for complete traceability
  • Historical Tracking: Comprehensive transaction history with executed and pending transaction lists
  • Flexible Confirmation System: Configurable number of required confirmations for transaction execution
  • Immutable Security: Submitted transactions cannot be deleted, only confirmations can be revoked

How It Works

Architecture Components

The TokenFon MultiSig consists of three main components:

1. User Interface (UI)

  • Design Inspiration: Frontend inspired by the Gnosis Safe app for familiar user experience
  • Council Display: Shows wallet addresses of council members and their transaction statuses
  • Contract Wizard: Simplified interface for non-technical users to generate transaction data easily
  • Technical Interface: Detailed form for developers and technical users to send specific transactions
  • Transaction History: Complete historical view split into executed and pending transaction lists

2. Subgraph Service

  • Data Gathering: Uses The Graph's subgraph service to collect blockchain and transaction data
  • Historical Records: Provides comprehensive historical data tracking for all multisig transactions
  • Real-time Updates: Tracks transactions made through the multisig wallet in real-time
  • Status Monitoring: Enables tracking of transaction progress from submission to execution

3. Smart Contract

  • Gnosis Safe Base: Built on upgraded Gnosis Safe contract design with Solidity 0.8.19
  • Initialization Setup: Contract initialized with predefined wallet addresses and confirmation requirements
  • Transaction Security: Ensures submitted transactions cannot be deleted, maintaining transaction integrity
  • Confirmation Management: Only required confirmations can be revoked, preventing unauthorized changes
  • On-chain Recording: All transactions and decisions permanently recorded on blockchain

Governance Process

  1. Transaction Submission: Council member submits a transaction proposal
  2. Confirmation Collection: Other council members review and confirm the transaction
  3. Threshold Check: System verifies if required number of confirmations is reached
  4. Execution: Once threshold is met, transaction becomes ready for execution
  5. Blockchain Recording: All actions and decisions are permanently recorded on-chain
  6. Historical Tracking: Transaction status and history available through subgraph data

Transaction States

  • Pending: Transaction submitted but awaiting required confirmations
  • Ready-to-Execute: Required confirmations received, transaction can be executed
  • Executed: Transaction successfully completed and recorded on blockchain

Technical Implementation

Technology Stack

  • Smart Contracts: Solidity (upgraded to version 0.8.19)
  • Frontend: React.js with Framework7 UI framework
  • Data Indexing: The Graph subgraph service for blockchain data gathering
  • Contract Base: Upgraded Gnosis Safe contract architecture

Deployment Infrastructure

  • Frontend: Cloudflare Pages for UI deployment
  • Subgraph: Google Cloud for subgraph service deployment

Key Features

  • Gnosis Safe Foundation: Built on proven, battle-tested multisig wallet architecture
  • Dual Interface Design: Contract wizard for simplicity, detailed forms for technical flexibility
  • Complete Transparency: All governance actions visible and traceable on blockchain
  • Robust Security: Upgraded Solidity version ensures contract security and future-proofing
  • Flexible Configuration: Customizable wallet addresses and confirmation thresholds

Project Scope & Limitations

Included Features

  • UI development with a user-friendly design inspired by the Gnosis Safe app
  • Development of a contract wizard for simplified user interactions
  • Subgraph implementation to gather blockchain data and historical records
  • Contract development for secure multisig wallet functionality
  • Integration of transaction status tracking (executed, pending, and ready-to-execute)

Excluded Features

  • Full governance systems beyond multisig control
  • Features not directly related to the multisig wallet (e.g., advanced analytics or non-testnet functionalities)
  • Integration of additional verification mechanisms or multi-factor authentication in the UI

Project Assumptions

  • The TokenFon testnet chain remains stable for the duration of the project
  • Wallet addresses involved in the multisig council are properly managed and secured
  • The Gnosis Safe contract structure remains suitable for the needs of the TokenFon chain governance

This MultiSig implementation provides TokenFon with a secure, transparent, and user-friendly governance solution that ensures critical blockchain decisions require proper consensus while maintaining complete auditability and traceability of all governance actions.