Enum KernelAction

pub enum KernelAction {
    BeginAllocating {
        op_id: u64,
        plan: Vec<AllocationPlanEntry>,
        now_ns: TimestampNs,
    },
    Deposit {
        owner: Address,
        receiver: Address,
        assets_in: u128,
        min_shares_out: u128,
        now_ns: TimestampNs,
    },
    AtomicWithdraw {
        owner: Address,
        receiver: Address,
        operator: Address,
        amount: u128,
        kind: AtomicPayoutKind,
        now_ns: TimestampNs,
    },
    RequestWithdraw {
        owner: Address,
        receiver: Address,
        shares: u128,
        min_assets_out: u128,
        now_ns: TimestampNs,
    },
    ExecuteWithdraw {
        now_ns: TimestampNs,
    },
    BeginRefreshing {
        op_id: u64,
        plan: Vec<TargetId>,
        now_ns: TimestampNs,
    },
    FinishAllocating {
        op_id: u64,
        now_ns: TimestampNs,
    },
    SyncExternalAssets {
        new_external_assets: u128,
        op_id: u64,
        now_ns: TimestampNs,
    },
    RebalanceWithdraw {
        op_id: u64,
        amount: u128,
        now_ns: TimestampNs,
    },
    FinishRefreshing {
        op_id: u64,
        now_ns: TimestampNs,
    },
    AbortRefreshing {
        op_id: u64,
    },
    SettlePayout {
        op_id: u64,
        outcome: PayoutOutcome,
    },
    AbortAllocating {
        op_id: u64,
        restore_idle: u128,
    },
    AbortWithdrawing {
        op_id: u64,
        refund_shares: u128,
    },
    RefreshFees {
        now_ns: TimestampNs,
    },
    Pause {
        paused: bool,
    },
    EmergencyReset,
}

Kernel actions supported by the dispatcher.

These actions drive the vault state machine. Each action validates preconditions, updates state, and returns effects to be executed by the chain-specific runtime.

Variants

BeginAllocating

Begin allocating idle assets to external markets according to a plan.

Transition: Idle -> Allocating

Fields

op_id: u64

plan: Vec<AllocationPlanEntry>

now_ns: TimestampNs

Deposit

Deposit assets into the vault and mint shares to the receiver.

Fields

owner: Address

receiver: Address

assets_in: u128

min_shares_out: u128

now_ns: TimestampNs

AtomicWithdraw

Fields

owner: Address

receiver: Address

operator: Address

amount: u128

kind: AtomicPayoutKind

now_ns: TimestampNs

RequestWithdraw

Request a withdrawal by escrowing shares in the queue.

Fields

owner: Address

receiver: Address

shares: u128

min_assets_out: u128

now_ns: TimestampNs

ExecuteWithdraw

Execute the next pending withdrawal from the queue.

Transition: Idle -> Withdrawing

Fields

now_ns: TimestampNs

BeginRefreshing

Begin refreshing external market balances.

Transition: Idle -> Refreshing

Fields

op_id: u64

plan: Vec<TargetId>

now_ns: TimestampNs

FinishAllocating

Complete an allocation operation.

Transition: Allocating -> Idle or Withdrawing

Fields

op_id: u64

now_ns: TimestampNs

SyncExternalAssets

Sync external asset balances during an active operation.

Fields

new_external_assets: u128

op_id: u64

now_ns: TimestampNs

RebalanceWithdraw

Fields

op_id: u64

amount: u128

now_ns: TimestampNs

FinishRefreshing

Complete a refresh operation.

Transition: Refreshing -> Idle

Fields

op_id: u64

now_ns: TimestampNs

AbortRefreshing

Abort a refresh operation (e.g., on external call failure).

Transition: Refreshing -> Idle

Fields

op_id: u64

SettlePayout

Settle a payout after asset transfer attempt.

Transition: Payout -> Idle

Fields

op_id: u64

outcome: PayoutOutcome

AbortAllocating

Abort an allocation operation (e.g., on external call failure).

Transition: Allocating -> Idle

Fields

op_id: u64

restore_idle: u128

AbortWithdrawing

Abort a withdrawal operation (e.g., on external call failure).

Transition: Withdrawing -> Idle

Fields

op_id: u64

refund_shares: u128

RefreshFees

Refresh fee calculations and mint fee shares.

Fields

now_ns: TimestampNs

Pause

Emit a pause-state update for executor-owned pause configuration.

Fields

paused: bool

EmergencyReset

Emergency reset: force the vault back to Idle from any non-Idle state.

Unlike the regular abort actions, this does not require op_id matching. For Withdrawing/Payout states, escrowed shares are refunded to the owner and the queue head is dequeued.

Authorization (Owner-only, timelock-gated) must be enforced by the executor.

Implementations

impl KernelAction

pub fn begin_allocating( op_id: u64, plan: Vec<AllocationPlanEntry>, now_ns: TimestampNs, ) -> Self

pub fn deposit( owner: Address, receiver: Address, assets_in: u128, min_shares_out: u128, now_ns: TimestampNs, ) -> Self

pub fn atomic_withdraw( owner: Address, receiver: Address, operator: Address, assets_out: u128, now_ns: TimestampNs, ) -> Self

pub fn atomic_redeem( owner: Address, receiver: Address, operator: Address, shares: u128, now_ns: TimestampNs, ) -> Self

pub fn request_withdraw( owner: Address, receiver: Address, shares: u128, min_assets_out: u128, now_ns: TimestampNs, ) -> Self

pub fn execute_withdraw(now_ns: TimestampNs) -> Self

pub fn begin_refreshing( op_id: u64, plan: Vec<TargetId>, now_ns: TimestampNs, ) -> Self

pub fn finish_allocating(op_id: u64, now_ns: TimestampNs) -> Self

pub fn sync_external_assets( new_external_assets: u128, op_id: u64, now_ns: TimestampNs, ) -> Self

pub fn rebalance_withdraw(op_id: u64, amount: u128, now_ns: TimestampNs) -> Self

pub fn finish_refreshing(op_id: u64, now_ns: TimestampNs) -> Self

pub fn abort_refreshing(op_id: u64) -> Self

pub fn settle_payout(op_id: u64, outcome: PayoutOutcome) -> Self

pub fn abort_allocating(op_id: u64, restore_idle: u128) -> Self

pub fn abort_withdrawing(op_id: u64, refund_shares: u128) -> Self

pub fn refresh_fees(now_ns: TimestampNs) -> Self

pub fn pause(paused: bool) -> Self

pub const fn emergency_reset() -> Self

pub const fn op_id(&self) -> Option<u64>

pub const fn timestamp_ns(&self) -> Option<TimestampNs>

Trait Implementations

impl BorshDeserialize for KernelAction

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 BorshSerialize for KernelAction

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

impl Clone for KernelAction

fn clone(&self) -> KernelAction

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for KernelAction

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for KernelAction

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl EnumExt for KernelAction

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

Deserialises given variant of an enum from the reader.

impl PartialEq for KernelAction

fn eq(&self, other: &KernelAction) -> 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 KernelAction

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 KernelAction

impl StructuralPartialEq for KernelAction