Transactions

kill-pure-proxy

Close a pure proxy account and return its reserved deposit.

View as Markdown

Must be signed by the pure proxy itself (i.e. dispatched through it with proxy_for=<pure proxy>), and the parameters must reproduce the exact creation: spawner, type, index, plus the block height and extrinsic index of the create_pure_proxy call. Irreversible — any funds left in the account become permanently inaccessible, so empty it first.

SignerOriginPalletWraps
coldkeysigned account (pallet role may apply)ProxyProxy.kill_pure

Parameters

ParameterTypeRequiredDescription
spawner_ss58stringyesAccount that originally created the pure proxy.
proxy_typestringnoType the pure proxy was created with (must match exactly).
indexintegernoIndex the pure proxy was created with (must match exactly).
heightintegernoBlock number of the creating create_pure_proxy call.
ext_indexintegernoExtrinsic index of the creating call within that block.

Address parameters (--hotkey, --coldkey, --dest, ...) accept a raw ss58 address, an address-book or proxy-book name, or a local wallet/hotkey name.

CLI

Preview with --dry-run (shows fee, effects, and policy result without submitting), then submit:

btcli tx kill-pure-proxy \
  --spawner <ss58|name> --dry-run
btcli tx kill-pure-proxy \
  --spawner <ss58|name> -w my_coldkey

Python

import bittensor as bt
from bittensor.wallet import Wallet

wallet = Wallet(name="my_coldkey", hotkey="my_hotkey")
intent = bt.KillPureProxy(spawner_ss58="5F...")

sub = bt.Subtensor()
plan = sub.plan(intent, wallet)   # fee, effects, policy — no submission
result = sub.execute(intent, wallet)
if not result.success:
    print(result.error.code, result.error.remediation)

(bt.Subtensor is also the async client — async with bt.Subtensor() as client: — see The client.) Or build the intent by op name, as an agent would:

result = sub.execute_tool("kill_pure_proxy", {...}, wallet)

On-chain implementation

Proxy.kill_purepallets/proxy/src/lib.rs#L384:

#[pallet::call_index(5)]
#[pallet::weight(T::WeightInfo::kill_pure(T::MaxProxies::get()))]
pub fn kill_pure(
    origin: OriginFor<T>,
    spawner: AccountIdLookupOf<T>,
    proxy_type: T::ProxyType,
    index: u16,
    #[pallet::compact] height: BlockNumberFor<T>,
    #[pallet::compact] ext_index: u32,
) -> DispatchResult {
    let who = ensure_signed(origin)?;
    let spawner = T::Lookup::lookup(spawner)?;

    let when = (height, ext_index);
    let proxy = Self::pure_account(&spawner, &proxy_type, index, Some(when))?;
    ensure!(proxy == who, Error::<T>::NoPermission);

    let (_, deposit) = Proxies::<T>::take(&who);
    T::Currency::unreserve(&spawner, deposit);

    Self::deposit_event(Event::PureKilled {
        pure: who,
        spawner,
        proxy_type,
        disambiguation_index: index,
    });

    Ok(())
}

Delegates to pure_account.

Every file is browsable under /code exactly as built into the runtime, or as plain text under /code/raw/<path> (index: /code/index.json).