transfer_keep_alive

Call v101 → current #3

Transfers TAO while ensuring sender account stays alive.

View calls on chain

Click items to navigate. Pan and zoom to explore.

From Chain Metadata

Same as the [`transfer`] call, but with a check that the transfer will not kill the origin account. 99% of the time you want [`transfer`] instead. [`transfer`]: struct.Pallet.html#method.transfer

Input Parameters

#NameTypeDescription
0
dest
MultiAddress AccountIdLookupOf<T>Recipient account address
1
value
Compact<u64> Cpt T::BalanceAmount to transfer (RAO, ÷10⁹ for TAO) (RAO -> TAO (/ 10^9))

Permissions

Origin
Unknown
Required Role

Requirements

  • Sender has sufficient free balance
  • Sender will retain existential deposit after transfer
  • Recipient account can receive funds

Effects

Events Emitted

Storage Modified

Postconditions

  • Sender balance decreased by amount
  • Recipient balance increased by amount
  • Sender account still exists

Side Effects

  • May create recipient account if new
  • Transaction fees deducted from sender

Code Examples

// ----------------------------------------------------------------------
// HEADS UP: 1 arg below has a complex type with no usable default.
// Look for `undefined as any` and replace it with real value
// before running — the snippet compiles, but will fail at runtime as-is.
// ----------------------------------------------------------------------
import { createClient, Binary } from "polkadot-api";
import { getWsProvider } from "polkadot-api/ws";
import { sub } from "@polkadot-api/descriptors"; // generated by: npx papi add sub -w wss://entrypoint-finney.opentensor.ai:443

const client = createClient(getWsProvider("wss://entrypoint-finney.opentensor.ai:443"));
const api = client.getTypedApi(sub);

// Build transfer_keep_alive call (typed, named args)
const dest = undefined as any /* MultiAddress — replace with real value */;
const value = 0n;

const tx = api.tx.Balances.transfer_keep_alive({
  dest,
  value,
});

On-Chain Activity

Usage Frequency
●●●●●○ Core 1M–10M extrinsics

Primary protocol calls

#21 most used call

Success Rate Near-certain

Over 95% of submissions succeed

As of block 7,429,232

Runtime Info

Pallet Index
5
Call Index
3
First Version
v101
Current Version
v411