Skip to main content

sys.xfer_upgrade_to

sys.xfer_upgrade_to sends upgrade(s) to a specified user.

Security Level​

LOWSEC

Syntax​

CLI​

Single upgrade:

sys.xfer_upgrade_to { to: "user", i: 0 }

Multiple upgrades:

sys.xfer_upgrade_to { to: "user", i: [ 0, 1, 2 ] }

Script​

#ls.sys.xfer_upgrade_to({ to: "user", i: [ 0, 1, 2 ] })

Parameters​

Requires 'to' and one of 'i' or 'sn'.

to (required)​

The 'to' argument takes a username as a string and specifies the username where upgrades shall be sent.

i​

The 'i' argument takes a number or array of numbers and specifies which upgrade indexes shall be sent.

sn​

The 'sn' argument takes a serial number string, or array of serial numbers, to specify which serial numbers shall be sent (if they exist on the user).

memo (optional)​

The 'memo' argument allows for an optional memo, up to 50 characters, alongside the upgrade transfer

Return​

Returns a Success or Failure object.

CLI​

>>sys.xfer_upgrade_to { to: "trust", i: 44 }
Success

-k3y_v2- lost to trust

Script​

Success

-k3y_v2- lost to trust

Errors​

Known error responses for a Failure object:

  • You can't transfer to yourself.
  • can't transfer loaded upgrades.
  • invalid index
  • transfer_upgrades could not continue executing because 250ms are not available for execution.
  • Not enough slots available in recipient for transfer. ${N} slots available.
  • Sys needs to be tier ${N} before it can get this upgrade.

Example​

function(context, args)
{
	return #ls.sys.xfer_upgrade_to({ to: "trust", i: 44 })
}