spl-governance 4.0.0

Solana Program Library Governance Program
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

//! Program state processor

use {
    crate::{
        error::GovernanceError,
        state::{
            enums::ProposalState, governance::get_governance_data_for_realm,
            proposal::get_proposal_data_for_governance, realm::assert_is_valid_realm,
            signatory_record::get_signatory_record_data_for_seeds,
            token_owner_record::get_token_owner_record_data_for_proposal_owner,
        },
    },
    solana_program::{
        account_info::{next_account_info, AccountInfo},
        clock::Clock,
        entrypoint::ProgramResult,
        pubkey::Pubkey,
        sysvar::Sysvar,
    },
};

/// Processes SignOffProposal instruction
pub fn process_sign_off_proposal(program_id: &Pubkey, accounts: &[AccountInfo]) -> ProgramResult {
    let account_info_iter = &mut accounts.iter();

    let realm_info = next_account_info(account_info_iter)?; // 0
    let governance_info = next_account_info(account_info_iter)?; // 1
    let proposal_info = next_account_info(account_info_iter)?; // 2

    let signatory_info = next_account_info(account_info_iter)?; // 3

    let clock = Clock::get()?;

    assert_is_valid_realm(program_id, realm_info)?;

    let governance_data =
        get_governance_data_for_realm(program_id, governance_info, realm_info.key)?;

    let mut proposal_data =
        get_proposal_data_for_governance(program_id, proposal_info, governance_info.key)?;

    proposal_data.assert_can_sign_off()?;

    if governance_data.required_signatories_count > 0
        && proposal_data.signatories_count < governance_data.required_signatories_count
    {
        return Err(GovernanceError::MissingRequiredSignatories.into());
    }

    // If the owner of the proposal hasn't appointed any signatories then can sign
    // off the proposal themself
    if proposal_data.signatories_count == 0 {
        let proposal_owner_record_info = next_account_info(account_info_iter)?; // 4

        let proposal_owner_record_data = get_token_owner_record_data_for_proposal_owner(
            program_id,
            proposal_owner_record_info,
            &proposal_data.token_owner_record,
        )?;

        // Proposal owner (TokenOwner) or its governance_delegate must be the signatory
        // and sign this transaction
        proposal_owner_record_data.assert_token_owner_or_delegate_is_signer(signatory_info)?;

        proposal_data.signing_off_at = Some(clock.unix_timestamp);
    } else {
        let signatory_record_info = next_account_info(account_info_iter)?; // 4

        let mut signatory_record_data = get_signatory_record_data_for_seeds(
            program_id,
            signatory_record_info,
            proposal_info.key,
            signatory_info.key,
        )?;

        signatory_record_data.assert_can_sign_off(signatory_info)?;

        signatory_record_data.signed_off = true;
        signatory_record_data.serialize(&mut signatory_record_info.data.borrow_mut()[..])?;

        if proposal_data.signatories_signed_off_count == 0 {
            proposal_data.signing_off_at = Some(clock.unix_timestamp);
            proposal_data.state = ProposalState::SigningOff;
        }

        proposal_data.signatories_signed_off_count = proposal_data
            .signatories_signed_off_count
            .checked_add(1)
            .unwrap();
    }

    // If all Signatories signed off we can start voting
    if proposal_data.signatories_signed_off_count == proposal_data.signatories_count {
        proposal_data.voting_at = Some(clock.unix_timestamp);
        proposal_data.voting_at_slot = Some(clock.slot);
        proposal_data.state = ProposalState::Voting;
    }

    proposal_data.serialize(&mut proposal_info.data.borrow_mut()[..])?;

    Ok(())
}