Account control

From ArdorDocs
Jump to: navigation, search
Other languages:


Any account can be restricted to only be allowed to issue phased transactions subject to a specific voting model. This is achieved by the account submitting a setPhasingOnly transaction using the setPhasingOnlyControl API. The getPhasingOnlyControl API can be used to retrieve the status of an account phasing control, and getAllPhasingOnlyControls to get all accounts subject to phasing control with their respective restrictions. The account control feature relies on the Phasing feature and is available in both Nxt and Ardor.

In Ardor, only child chain transactions can be phased. Therefore, when account control is set for an account, it can no longer submit Ardor chain transactions.

Phasing parameters that refer to transaction IDs must now use transaction full hashes instead, prefixed with the chain ID separated with ':'.

It is possible to refer to transactions on other chains when approving a phased transaction, or setting up a by-transaction phasing voting model. The controlMaxFees parameter when setting mandatory approval now accepts multiple values, each fee being prefixed with the child chain ID and ':', to indicate which child chain the limit applies to. If no max fee has been set for a child chain, there is no phasing transactions fees total limit on it for the controlled account. Currently, the UI only supports setting max fee for the current chain.

These features present some interesting account usage scenarios:

  • Multi-signature account [1]
  • Tagging an account as a "savings" account, with no ability to send tokens
  • Using a locked account as an "escrow" account
  • limiting the ability to transfer assets, aliases, or other entities from an account

Setting Account Control

To set account control on your account, click on the "Account Balance" tile.

figure 1

Then select the "Account Control" tab then click on the "Setup Mandatory Approval" link.

figure 2

This will load the "Mandatory Approval" dialog.

In Ardor, select the "Control Approval Model" from the available approval models defined in the Approval Models page.

The rest of the parameters are explained using balloon text on the dialog. Use the same method to remove the account control from an account that is under account control, account control removal transaction is subject to the same account control restrictions.

figure 3

Using Account Control

When creating a transaction from an account that is under account control. The additional widget appears on the transaction dialog. It allows the user to select the specific phasing height and links to the account control information.

figure 4

Note: Some exchanges do not accept phased transactions. In such cases, the approach would be to transfer first into a non-controlled account ("Hot Wallet"), and from there transfer to the exchange.

  1. For a detailed step-by-step guide, you can have a look at the advance guide How to use the phasing feature to emulate multisig accounts in the Ardor platform