Skip to content

Transfer Operations


transfer_operation (ID 2)

Auth: active of from (VIZ) / master of from (SHARES)

Transfers VIZ or SHARES tokens between accounts.

FieldTypeDescription
fromaccount_name_typeSending account
toaccount_name_typeReceiving account
amountassetAmount to transfer (VIZ or SHARES)
memostringMemo text (plain or encrypted; may be "")
json
[2, {
  "from": "alice",
  "to": "bob",
  "amount": "10.000 VIZ",
  "memo": "payment for services"
}]
  • amount.symbol must be VIZ or SHARES.
  • VIZ transfers require active authority; SHARES transfers require master authority.
  • Encrypted memo format: # followed by base58-encoded ciphertext.

transfer_to_vesting_operation (ID 3)

Auth: active of from

Converts liquid VIZ into SHARES (staking). The SHARES can be credited to a different account.

FieldTypeDescription
fromaccount_name_typeAccount providing VIZ
toaccount_name_typeAccount receiving SHARES (may equal from)
amountasset (VIZ)Amount of VIZ to stake
json
[3, {
  "from": "alice",
  "to": "alice",
  "amount": "100.000 VIZ"
}]
  • amount.symbol must be VIZ.
  • to may be any existing account — useful for gifting staked shares.

withdraw_vesting_operation (ID 4)

Auth: active of account

Initiates a gradual withdrawal of SHARES back to liquid VIZ over multiple intervals.

FieldTypeDescription
accountaccount_name_typeAccount initiating withdrawal
vesting_sharesasset (SHARES)Total SHARES to withdraw; 0.000000 SHARES cancels
json
[4, {
  "account": "alice",
  "vesting_shares": "1000.000000 SHARES"
}]
  • Withdrawal is spread over withdraw_intervals intervals (chain property, default 28).
  • Each interval: vesting_shares / withdraw_intervals SHARES are converted.
  • Set to "0.000000 SHARES" to cancel an active withdrawal.

set_withdraw_vesting_route_operation (ID 11)

Auth: active of from_account

Routes a percentage of vesting withdrawals to a specified account, optionally re-vesting the routed portion.

FieldTypeDescription
from_accountaccount_name_typeAccount whose withdrawals are routed
to_accountaccount_name_typeDestination account
percentuint16_tPercentage to route (0–10000 basis points)
auto_vestboolIf true, routed tokens are immediately re-vested in to_account
json
[11, {
  "from_account": "alice",
  "to_account": "bob",
  "percent": 5000,
  "auto_vest": false
}]
  • percent = 0 deletes this route to to_account.
  • The sum of all routes from from_account must not exceed 10000.
  • Multiple routes to different accounts are allowed.

delegate_vesting_shares_operation (ID 19)

Auth: active of delegator

Delegates SHARES to another account. The delegatee gains bandwidth and voting power; ownership stays with the delegator.

FieldTypeDescription
delegatoraccount_name_typeAccount delegating SHARES
delegateeaccount_name_typeAccount receiving the delegation
vesting_sharesasset (SHARES)Amount to delegate; 0.000000 SHARES removes delegation
json
[19, {
  "delegator": "alice",
  "delegatee": "bob",
  "vesting_shares": "500.000000 SHARES"
}]
  • vesting_shares must be ≥ min_delegation chain property, or exactly 0.000000 SHARES to remove.
  • When delegation is removed, the SHARES enter a 7-day return window before crediting back.
  • Virtual return_vesting_delegation_operation fires when the return window ends.

See also: Data Types, Operations Overview.