Products
SWSS Governance
Pre-launch
Section
Products
Documentation category
Type
Guide
Technical reference
Summary
SWSS Governance, the on-chain governance framework for SwssChain protocol parameter changes, ecosystem fund allocation, and validator set management.
SWSS Foundation Notice

This documentation is restricted to authorised members of the SWSS Developer Community. Access is granted exclusively through SWSS DevHub, after KYB and SWSS Foundation approval.

All SwssChain GitHub repositories are private. Significant updates are currently deploying across the full SWSS Ecosystem. SDK and API specifications are subject to change at any time in accordance with security requirements and SwssChain Foundation governance decisions.

Join SWSS DevHub →Have a question? Use the Need Help? button below.
SDK Update Notice

SWSS SDK v2.1 is deploying across the ecosystem. API signatures may change during this period. Ensure your integration uses the latest schema from SWSS DevHub.

Article Content

SWSS Governance

SWSS Governance is the on-chain framework through which SWSS Coin holders and validator node operators participate in protocol parameter decisions, ecosystem development fund allocation, and validator set composition changes. All governance proposals, votes, and execution outcomes are recorded on SwssChain, ensuring a transparent and auditable decision-making process.

Governance Participants

Participant Type Voting Weight Eligibility
SWSS Coin Stakers1 vote per staked SWSS CoinMinimum 1,000 SWSS Coin staked
Validator OperatorsWeighted by delegated stake + operator stakeActive SAPE node with minimum stake
Core ContributorsAdvisory: non-bindingDesignated core development team

Proposal Categories

  • Protocol Parameter Changes: Adjustments to network parameters such as the Transactional Settlement Levy rate, the ERRP distribution ratio, block gas limits, and the BFTFA threshold. Parameter changes require a supermajority (66.7%) of participating voting weight to pass.
  • Ecosystem Fund Allocation: Proposals to deploy funds from the SwssChain Ecosystem Development Reserve for specific initiatives: grants, audits, integrations, or infrastructure projects. Requires simple majority (50%+) of participating voting weight.
  • Validator Set Changes: Admission or removal of validator node operators from the active SAPE set. Requires supermajority approval and a mandatory review period of 14 days.
  • Emergency Actions: Fast-track proposals for critical security responses. Require 75% approval with a minimum 24-hour voting period and are limited in scope to security-critical changes only.

Proposal Lifecycle

  1. Draft: A proposal is authored and published on-chain with a deposit of SWSS Coin. The deposit is refunded if the proposal passes or reaches quorum; forfeited if the proposal is rejected below quorum threshold.
  2. Review Period: A mandatory review period (7 days for standard proposals, 1 day for emergency) during which the community discusses the proposal without voting.
  3. Voting Period: The active voting window (14 days for standard, 24 hours for emergency). Votes are cast on-chain and are publicly visible.
  4. Execution: Proposals that pass are executed automatically by the Governance contract after a 48-hour time-lock. Emergency proposals have a 1-hour time-lock.
  5. Veto: A veto mechanism allows the Core Contributor group to delay (but not permanently block) execution for a further 48-hour review period in cases of suspected procedural irregularity.

Voting via SDK

import { SwssChain, networks } from '@swsschain/sdk';
import { GovernanceClient } from '@swsschain/governance-sdk';

const client = new SwssChain({
  network: networks.mainnet,
  privateKey: process.env.PRIVATE_KEY as `0x${string}`,
});

const gov = new GovernanceClient(client);

// Fetch active proposals
const proposals = await gov.getProposals({ status: 'active' });

// Cast vote
const txHash = await gov.castVote({
  proposalId: proposals[0].id,
  vote: 'for',  // 'for' | 'against' | 'abstain'
});

console.log('Vote submitted:', txHash);

Governance Dashboard

The SWSS Governance Dashboard, reached from the SWSS App governance module, provides a full interface for proposal discovery, discussion, and voting without requiring any SDK knowledge. The dashboard displays proposal details, current vote tallies, and time remaining in each proposal phase. Historical governance decisions are permanently accessible through the dashboard and on the SwssChain Explorer.

Status

The initial SWSS Governance framework is live on mainnet for informational proposal tracking. On-chain binding voting for protocol parameter changes will be activated following the conclusion of the mandatory 365+ day testing period and confirmation of validator set stability.