治理

Savitri Network 具备链上治理功能，使代币持有者能够提出、投票并执行网络变更。

概述

治理系统支持：

• 提案创建：包含标题、描述和投票周期
• 代币加权投票（支持/反对）
• 已批准提案的自动执行
• 联邦学习（FL）提案，用于 AI 模型治理
• 基于 PoU 层级的投票代币奖励

提案生命周期

1. Create Proposal
       │
2. Voting Period (configurable, e.g., 7 days)
       │
3. Tally Votes
       │
   ├── Approved (majority support) → 4. Execute
   └── Rejected → Archived

创建提案

通过 SDK

use savitri_sdk::{ContractClient, Wallet};

let contract = ContractClient::from_url_and_wallet(url, wallet)?;
let gov = contract.governance();

let tx = gov.create_proposal(
    &governance_address,
    "Increase block size",
    "Proposal to increase max block transactions from 32 to 64",
    604800,  // 7-day voting period (seconds)
).await?;

通过 TransactionBuilder

use savitri_sdk::{TransactionBuilder, GovernanceAction};

let tx = TransactionBuilder::new()
    .create_fl_proposal(
        "governance_contract_address",
        "Deploy model v2",
        "Replace current FL model with GPT-4 fine-tuned variant",
        604800,
    )
    .nonce(nonce)
    .fee(5_000_000_000_000_000)
    .build_and_sign(&wallet)?;

投票

// Vote in favor
let tx = gov.vote(&governance_address, proposal_id, true).await?;

// Vote against
let tx = gov.vote(&governance_address, proposal_id, false).await?;

// Via TransactionBuilder
let tx = TransactionBuilder::new()
    .governance_call(
        "governance_address",
        proposal_id,
        GovernanceAction::Vote(true),
    )
    .nonce(nonce)
    .build_and_sign(&wallet)?;

执行提案

任何参与者均可执行已批准的提案：

let tx = gov.execute(&governance_address, proposal_id).await?;

查询状态

let status = gov.get_proposal_status(&governance_address, proposal_id).await?;

println!("Title: {}", status.title);
println!("Status: {}", status.status);  // "active", "passed", "rejected", "executed"
println!("Votes: {} for / {} against", status.votes_for, status.votes_against);
println!("Executed: {}", status.executed);

投票代币

验证者根据其 PoU 层级获得投票代币：

层级	PoU 分数	每轮投票代币
铜牌	300-499	10
银牌	500-699	25
金牌	700-899	50
铂金	900-1000	100

投票代币决定治理提案中的投票权重。

治理合约

治理系统由多个链上模块组成：

模块	文件	用途
提案	governance/proposals.rs	提案创建和管理
投票	governance/voting.rs	投票投递和计票
执行	governance/execution.rs	已批准提案的执行
押金	governance/deposit.rs	提案押金（防垃圾）
投票代币	governance/vote_token.rs	投票代币发行和跟踪
FL 提案	governance/fl_proposals.rs	联邦学习专项提案

FL 治理

联邦学习提案是用于管理分布式 AI 训练的专项治理行为：

• 模型注册表：提议新模型用于训练
• 任务生命周期：创建、管理和完成 FL 任务
• 模型更新：对模型版本升级进行投票
• 资源分配：通过治理分配计算资源