FuzzyBot: Updating to match new version of source page

2021-08-17T15:04:32Z

Updating to match new version of source page

New page

<languages />
{{#seo:
|title=Account Control
|titlemode=replace
|keywords=ardor learning hub, ardor documentation, blockchain, proof of stake, ardor, ignis, jelurida, development, ardor wiki, wiki, account control, account control feature
|description=Explanation of the Account Control feature: Any account can be restricted to only be allowed to issue phased transactions subject to a specific voting model.
}}
[[Category:Features]]
__TOC__
==Description==
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 (f)|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 <ref>For a detailed step-by-step guide, you can have a look at the advance guide [[Emulating_Multi_Signature_Accounts_on_the_Blockchain|How to use the phasing feature to emulate multisig accounts in the Ardor platform]]</ref>
* 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.
[[File:Account.Control.Balance.png|figure 1|none|border|200px]]

Then select the "Account Control" tab then click on the "Setup Mandatory Approval" link.
[[File:Account.Control.Approval.Link.png|figure 2|none|border|400px]]

This will load the "Mandatory Approval" dialog.

In Ardor, select the "Control Approval Model" from the available approval models defined in the [[Composite_phasing#Setting_up_an_Approval_Model phasing|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.

[[File:account.control.png|figure 3|none|border|600px]]

==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.

[[File:account.control.on.create.transaction.png|||figure 4|none|border|600px]]

''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.''

Account control/en - Revision history

FuzzyBot: Updating to match new version of source page