migrator 0.1.0

A Solana program for deploying and upgrading programs.
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
103
104

//! Program for managing and outsourcing program deploys and upgrades.

#[macro_use]
mod macros;

pub mod account_contexts;
mod account_validators;
pub mod bpf_loader_upgradeable;
pub mod instructions;
mod migrate;
pub mod state;

use account_contexts::*;
use anchor_lang::prelude::*;
use vipers::validate::Validate;

declare_id!("M1G1VdgdfvjMCdUhVtzaejnutPmLknEiraq2F59YGxr");

/// The [migrator] program.
#[program]
pub mod migrator {
    use super::*;

    //////////////////////////////////////////
    // Approver instructions
    //////////////////////////////////////////

    /// Creates a new [Migrator].
    pub fn new_migrator(
        ctx: Context<NewMigrator>,
        bump: u8,
        name: String,
        description: String,
    ) -> ProgramResult {
        ctx.accounts.validate()?;
        instructions::approver::new_migrator(ctx, bump, name, description)
    }

    /// Deploys a program with a migration.
    pub fn deploy_program(ctx: Context<DeployProgram>) -> ProgramResult {
        ctx.accounts.validate()?;
        instructions::approver::deploy_program(ctx)
    }

    /// Upgrades a program.
    pub fn upgrade_program(ctx: Context<UpgradeProgram>) -> ProgramResult {
        ctx.accounts.validate()?;
        instructions::approver::upgrade_program(ctx)
    }

    /// Approves a [Migration].
    pub fn approve_migration(ctx: Context<ApproveMigration>, deadline: i64) -> ProgramResult {
        ctx.accounts.validate()?;
        instructions::approver::approve_migration(ctx, deadline)
    }
    /// Approves a [Migration].
    pub fn reject_migration(ctx: Context<RejectMigration>) -> ProgramResult {
        ctx.accounts.validate()?;
        instructions::approver::reject_migration(ctx)
    }

    //////////////////////////////////////////
    // Public instructions
    //////////////////////////////////////////

    /// Proposes a [Migration].
    pub fn propose_migration(
        ctx: Context<ProposeMigration>,
        bump: u8,
        title: String,
        description: String,
    ) -> ProgramResult {
        ctx.accounts.validate()?;
        instructions::public::propose_migration(ctx, bump, title, description)
    }

    /// Reserves a new program ID to be administered by its migrator.
    pub fn reserve_program_id(ctx: Context<ReserveProgramID>) -> ProgramResult {
        ctx.accounts.validate()?;
        instructions::public::reserve_program_id(ctx)
    }
}

#[error]
pub enum ErrorCode {
    #[msg("Could not deserialize UpgradeableLoaderState.")]
    ParseError,
    #[msg("Must be signer of an uninitialized program.")]
    ProgramIdNotSigner,
    #[msg("Buffer authority mismatch.")]
    BufferAuthorityMismatch,
    #[msg("No approved migration.")]
    NoApprovedMigration,
    #[msg("Migration approval window expired.")]
    MigrationWindowExpired,
    #[msg("Insufficient lamports remaining for rent exemption.")]
    InsufficientLamports,
    #[msg("Migration rejected.")]
    MigrationRejected,
    #[msg("Migration already executed.")]
    MigrationAlreadyExecuted,
    #[msg("Migration expiry time must be in the future.")]
    ExpiryMustBeInFuture,
}