Enum UpgradeSource

#[repr(u8)]
pub enum UpgradeSource {
    GlobalHash(Base58CryptoHash),
    Code(Base64VecU8),
}

Where an upgrade’s new code comes from — a raw blob, or a global contract pinned by code hash. Both are immutable: exactly this code is deployed, then migrate runs. (Global-by-account-id is deliberately excluded: it is a live delegation to the publisher, so a later republish would swap the code with no proposal, timelock, or migrate — bypassing governance and bricking versioned state.)

JSON: Code is untagged (a bare base64 string, matching the pre-UpgradeSource wire), so serde requires it declared last; GlobalHash is externally tagged. Borsh tags are pinned via explicit discriminants (use_discriminant), decoupling the persisted tag from declaration order — UpgradeSource lives in pending governance proposals, so a future variant just takes its own discriminant without disturbing the stored ones.

Variants

GlobalHash(Base58CryptoHash)

A NEAR global contract referenced by its (immutable) code hash.

Code(Base64VecU8)

A raw WASM blob deployed onto the account.

Implementations

impl UpgradeSource

pub fn is_empty_code(&self) -> bool

A Code variant carrying an empty blob is never a valid deploy.

pub fn summary(&self) -> UpgradeSummary

A compact UpgradeSummary for event logging (Code → its sha256, via the on-chain host).

pub fn deploy_and_migrate( self, migrate_method: impl Into<String>, migrate_args: Base64VecU8, gas: Gas, ) -> Promise

Atomically deploy the new code and run migrate_method on it in a single receipt: a failed migration reverts the code change too. The deploy always targets the current account, so this is a self-upgrade primitive; the caller owns access control.

Trait Implementations

impl BorshDeserialize for UpgradeSource

fn deserialize_reader<__R: Read>(reader: &mut __R) -> Result<Self, Error>

fn deserialize(buf: &mut &[u8]) -> Result<Self, Error>

Deserializes this instance from a given slice of bytes. Updates the buffer to point at the remaining bytes.

fn try_from_slice(v: &[u8]) -> Result<Self, Error>

Deserialize this instance from a slice of bytes.

fn try_from_reader<R>(reader: &mut R) -> Result<Self, Error>

where R: Read,

impl BorshSchema for UpgradeSource

fn declaration() -> Declaration

Get the name of the type without brackets.

fn add_definitions_recursively( definitions: &mut BTreeMap<Declaration, Definition>, )

Recursively, using DFS, add type definitions required for this type. Type definition partially explains how to serialize/deserialize a type.

impl BorshSerialize for UpgradeSource

fn serialize<__W: Write>(&self, writer: &mut __W) -> Result<(), Error>

impl Clone for UpgradeSource

fn clone(&self) -> UpgradeSource

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UpgradeSource

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for UpgradeSource

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl EnumExt for UpgradeSource

fn deserialize_variant<__R: Read>( reader: &mut __R, variant_tag: u8, ) -> Result<Self, Error>

Deserialises given variant of an enum from the reader.

impl JsonSchema for UpgradeSource

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl PartialEq for UpgradeSource

fn eq(&self, other: &UpgradeSource) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for UpgradeSource

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for UpgradeSource

impl StructuralPartialEq for UpgradeSource