Skip to content

Account Operations


account_create_operation (ID 20)

Auth: active of creator

Creates a new blockchain account. The fee is converted to SHARES for the new account.

FieldTypeDescription
feeasset (VIZ)Creation fee ≥ chain account_creation_fee
delegationasset (SHARES)Initial SHARES delegation to new account
creatoraccount_name_typeAccount paying the fee
new_account_nameaccount_name_typeName for the new account
masterauthorityMaster authority
activeauthorityActive authority
regularauthorityRegular authority
memo_keypublic_key_typeMemo public key
json_metadatastringJSON metadata (may be "")
referreraccount_name_typeReferrer account (may be "")
extensionsextensions_typeAlways []
json
[20, {
  "fee": "1.000 VIZ",
  "delegation": "10.000000 SHARES",
  "creator": "alice",
  "new_account_name": "bob",
  "master":  { "weight_threshold": 1, "account_auths": [], "key_auths": [["VIZ5...", 1]] },
  "active":  { "weight_threshold": 1, "account_auths": [], "key_auths": [["VIZ5...", 1]] },
  "regular": { "weight_threshold": 1, "account_auths": [], "key_auths": [["VIZ5...", 1]] },
  "memo_key": "VIZ5...",
  "json_metadata": "",
  "referrer": "",
  "extensions": []
}]
  • All three authorities are required (even if identical keys are used).
  • fee.symbol must be VIZ; delegation.symbol must be SHARES.

account_update_operation (ID 5)

Auth: master of account (if master field present), otherwise active

Updates an account's keys and metadata.

FieldTypeDescription
accountaccount_name_typeAccount to update
masteroptional<authority>New master authority (omit if not changing)
activeoptional<authority>New active authority
regularoptional<authority>New regular authority
memo_keypublic_key_typeNew memo key (required even if unchanged)
json_metadatastringNew JSON metadata
json
[5, {
  "account": "alice",
  "active": { "weight_threshold": 1, "account_auths": [], "key_auths": [["VIZ5new...", 1]] },
  "memo_key": "VIZ5new...",
  "json_metadata": "{\"profile\":\"updated\"}"
}]
  • If master is present → sign with current master key.
  • If master is absent → sign with current active key.
  • memo_key is always required.

account_metadata_operation (ID 21)

Auth: regular of account

Updates only the account's JSON metadata. Lower bandwidth cost than account_update.

FieldTypeDescription
accountaccount_name_typeAccount to update
json_metadatastringNew JSON metadata string
json
[21, {
  "account": "alice",
  "json_metadata": "{\"name\":\"Alice\",\"about\":\"Hello!\"}"
}]

See also: Data Types, Operations Overview.