Enum solana_program::loader_upgradeable_instruction::UpgradeableLoaderInstruction [−][src]
Variants
Initialize a Buffer account.
A Buffer account is an intermediary that once fully populated is used
with the DeployWithMaxDataLen
instruction to populate the program’s
ProgramData account.
The InitializeBuffer
instruction requires no signers and MUST be
included within the same Transaction as the system program’s
CreateAccount
instruction that creates the account being initialized.
Otherwise another party may initialize the account.
Account references
- [writable] source account to initialize.
- [] Buffer authority, optional, if omitted then the buffer will be immutable.
Write program data into a Buffer account.
Account references
- [writable] Buffer account to write program data to.
- [signer] Buffer authority
Fields of Write
Deploy an executable program.
A program consists of a Program and ProgramData account pair.
- The Program account’s address will serve as the program id for any instructions that execute this program.
- The ProgramData account will remain mutable by the loader only and holds the program data and authority information. The ProgramData account’s address is derived from the Program account’s address and created by the DeployWithMaxDataLen instruction.
The ProgramData address is derived from the Program account’s address as follows:
let (program_data_address, _) = Pubkey::find_program_address( &[program_address], &bpf_loader_upgradeable::id() );
The DeployWithMaxDataLen
instruction does not require the ProgramData
account be a signer and therefore MUST be included within the same
Transaction as the system program’s CreateAccount
instruction that
creates the Program account. Otherwise another party may initialize the
account.
Account references
- [signer] The payer account that will pay to create the ProgramData account.
- [writable] The uninitialized ProgramData account.
- [writable] The uninitialized Program account.
- [writable] The Buffer account where the program data has been written. The buffer account’s authority must match the program’s authority
- [] Rent sysvar.
- [] Clock sysvar.
- [] System program (
solana_sdk::system_program::id()
). - [signer] The program’s authority
Fields of DeployWithMaxDataLen
max_data_len: usize
Maximum length that the program can be upgraded to.
Upgrade a program.
A program can be updated as long as the program’s authority has not been
set to None
.
The Buffer account must contain sufficient lamports to fund the ProgramData account to be rent-exempt, any additional lamports left over will be transferred to the spill account, leaving the Buffer account balance at zero.
Account references
- [writable] The ProgramData account.
- [writable] The Program account.
- [writable] The Buffer account where the program data has been written. The buffer account’s authority must match the program’s authority
- [writable] The spill account.
- [] Rent sysvar.
- [] Clock sysvar.
- [signer] The program’s authority.
Set a new authority that is allowed to write the buffer or upgrade the program. To permanently make the buffer immutable or disable program updates omit the new authority.
Account references
[writable]
The Buffer or ProgramData account to change the authority of.[signer]
The current authority.[]
The new authority, optional, if omitted then the program will not be upgradeable.
Trait Implementations
impl Clone for UpgradeableLoaderInstruction
[src]
fn clone(&self) -> UpgradeableLoaderInstruction
[src]
pub fn clone_from(&mut self, source: &Self)
1.0.0[src]
impl Debug for UpgradeableLoaderInstruction
[src]
impl<'de> Deserialize<'de> for UpgradeableLoaderInstruction
[src]
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
__D: Deserializer<'de>,
[src]
__D: Deserializer<'de>,
impl Eq for UpgradeableLoaderInstruction
[src]
impl PartialEq<UpgradeableLoaderInstruction> for UpgradeableLoaderInstruction
[src]
fn eq(&self, other: &UpgradeableLoaderInstruction) -> bool
[src]
fn ne(&self, other: &UpgradeableLoaderInstruction) -> bool
[src]
impl Serialize for UpgradeableLoaderInstruction
[src]
fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
__S: Serializer,
[src]
__S: Serializer,
impl StructuralEq for UpgradeableLoaderInstruction
[src]
impl StructuralPartialEq for UpgradeableLoaderInstruction
[src]
Auto Trait Implementations
impl RefUnwindSafe for UpgradeableLoaderInstruction
impl Send for UpgradeableLoaderInstruction
impl Sync for UpgradeableLoaderInstruction
impl Unpin for UpgradeableLoaderInstruction
impl UnwindSafe for UpgradeableLoaderInstruction
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> DeserializeOwned for T where
T: for<'de> Deserialize<'de>,
[src]
T: for<'de> Deserialize<'de>,
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> Same<T> for T
[src]
type Output = T
Should always be Self
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
pub fn clone_into(&self, target: &mut T)
[src]
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<V, T> VZip<V> for T where
V: MultiLane<T>,
[src]
V: MultiLane<T>,