Struct IntentCall 

pub struct IntentCall {
    pub op: String,
    pub summary: String,
    /* private fields */
}

A metadata-resolved call plus immutable product-level transaction semantics.

The call target, parameters, signer, and policy classification are private so callers cannot change the encoded call after a trusted constructor has attached its spend/subnet semantics. Use IntentCall::new only for an arbitrary call: it is deliberately classified as raw, unbounded, and unknown/all-subnet scope. Narrower semantics are available only through fixed operation-specific constructors in this module.

Fields

op: String

summary: String

Implementations

impl IntentCall

pub fn new( op: impl Into<String>, signer: SignerRole, pallet: impl Into<String>, function: impl Into<String>, params: Value, ) -> Self

Construct an arbitrary metadata call.

Arbitrary calls are always raw, Spend::Unbounded, and treated as affecting every subnet. This fail-closed classification means they require explicit allow_raw_calls, cannot pass a spend cap, and cannot pass an explicit subnet allowlist. Callers cannot downgrade that classification after construction.

pub fn raw_call( op: impl Into<String>, signer: SignerRole, pallet: impl Into<String>, function: impl Into<String>, params: Value, ) -> Self

Explicitly named alias for IntentCall::new.

pub fn op(&self) -> &str

Stable operation name used in plans and diagnostics.

pub fn signer_role(&self) -> SignerRole

Signer selected by the constructor. Read-only: callers cannot change it.

pub fn pallet(&self) -> &str

Metadata call target. Read-only: callers cannot replace the trusted call.

pub fn function(&self) -> &str

Metadata function target. Read-only: callers cannot replace the trusted call.

pub fn params(&self) -> &Value

SCALE input value. Read-only: callers cannot replace trusted parameters.

pub fn summary(self, summary: impl Into<String>) -> Self

Replace presentation text only. This cannot alter policy semantics.

pub fn spend(self, spend: Spend) -> Self

Compatibility policy floor for older call sites. This can only make a trusted classification stricter. Arbitrary calls remain unbounded.

pub fn touches(self, netuids: impl IntoIterator<Item = u16>) -> Self

Compatibility policy floor for older call sites. Supplied netuids are unioned with constructor-derived scope; they can never remove scope.

pub fn affects_all_subnets(self) -> Self

Broaden this call’s subnet scope. There is intentionally no inverse.

pub fn raw(self) -> Self

Force the arbitrary-call classification. There is intentionally no inverse that can turn a raw call into a trusted call.

pub fn transfer(dest: impl Into<String>, amount_rao: u128) -> Self

A bounded keep-alive TAO transfer.

pub fn fund_evm_key(mirror: impl Into<String>, amount_rao: u128) -> Self

Fund the native mirror of an EVM address with a bounded TAO amount.

pub fn transfer_allow_death(dest: impl Into<String>, amount_rao: u128) -> Self

A bounded TAO transfer that may reap the sender.

pub fn transfer_all(dest: impl Into<String>, keep_alive: bool) -> Self

Transfer the account’s full transferable balance.

pub fn add_stake( hotkey: impl Into<String>, netuid: u16, amount_rao: u128, ) -> Self

Stake a bounded amount of TAO on one subnet.

pub fn add_stake_limit( hotkey: impl Into<String>, netuid: u16, amount_rao: u128, limit_price_rao: u128, allow_partial: bool, ) -> Self

Stake a bounded amount of TAO with a limit price.

pub fn remove_stake( hotkey: impl Into<String>, netuid: u16, amount_alpha_rao: u128, ) -> Self

Remove alpha stake from one subnet. This moves value back to the signer, so it is subnet-scoped but not an outgoing spend.

pub fn remove_stake_limit( hotkey: impl Into<String>, netuid: u16, amount_alpha_rao: u128, limit_price_rao: u128, allow_partial: bool, ) -> Self

Remove alpha stake from one subnet with a limit price.

pub fn register_subnet(hotkey: impl Into<String>) -> Self

Register a subnet. The live registration cost is not known locally.

pub fn start_call(netuid: u16) -> Self

Activate one owned subnet.

pub fn burned_register(netuid: u16, hotkey: impl Into<String>) -> Self

Register a hotkey by burning the subnet’s live registration cost.

pub fn root_register(hotkey: impl Into<String>) -> Self

Register a hotkey on root.

pub fn move_stake( origin_hotkey: impl Into<String>, origin_netuid: u16, destination_hotkey: impl Into<String>, destination_netuid: u16, amount_alpha_rao: u128, ) -> Self

Move stake between hotkeys/subnets without transferring ownership.

pub fn move_stake_limit( origin_hotkey: impl Into<String>, origin_netuid: u16, destination_hotkey: impl Into<String>, destination_netuid: u16, amount_alpha_rao: u128, limit_price: u128, allow_partial: bool, ) -> Self

Move stake between hotkeys/subnets with a relative cross-subnet price limit.

pub fn swap_stake( hotkey: impl Into<String>, origin_netuid: u16, destination_netuid: u16, amount_alpha_rao: u128, ) -> Self

Swap stake between two subnets on one hotkey.

pub fn transfer_stake( destination_coldkey: impl Into<String>, hotkey: impl Into<String>, origin_netuid: u16, destination_netuid: u16, amount_alpha_rao: u128, ) -> Self

Transfer stake ownership to another coldkey. The alpha value is not cheaply TAO-bounded, so a spend cap must reject it.

pub fn transfer_stake_and_hotkey( destination_coldkey: impl Into<String>, origin_hotkey: impl Into<String>, destination_hotkey: impl Into<String>, origin_netuid: u16, destination_netuid: u16, amount_alpha_rao: u128, ) -> Self

Transfer stake ownership to another coldkey, landing it on a different hotkey. Like transfer_stake, the alpha value is not cheaply TAO-bounded, so a spend cap must reject it.

pub fn unstake_all(hotkey: impl Into<String>) -> Self

Unstake from every subnet on one hotkey.

pub fn unstake_all_alpha(hotkey: impl Into<String>) -> Self

Move all alpha stake to root across every subnet on one hotkey.

pub fn set_hyperparameter( netuid: u16, name: &str, value: Value, ) -> Result<Self, CoreError>

Construct an owner-settable subnet hyperparameter call while rejecting root-only or compound parameters before signing.

pub fn set_root_claim_type( claim_type: &str, subnets: Option<Vec<u16>>, ) -> Result<Self, CoreError>

Construct and validate the runtime’s root-claim enum.

pub fn set_take( client: &Client, hotkey: impl Into<String>, take: u16, ) -> Result<Self, CoreError>

Set a delegate take to an absolute value, selecting the runtime’s directional call from the current on-chain take. This mirrors the semantic set_take intent without hard-coding a direction at callers.

pub fn encode(&self, client: &Client) -> Result<Vec<u8>, CoreError>

pub fn batch(client: &Client, children: Vec<Self>) -> Result<Self, CoreError>

Build an all-or-nothing Utility.batch_all, aggregating signer, spend, and subnet policy metadata across every child.

Trait Implementations

impl Clone for IntentCall

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IntentCall

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

Formats the value using the given formatter.