Managing requests

A request is created after critical actions are taken in the vault. This is so that these actions can only be completed when a certain number of users have approved this action.

Overview

• Understand the possible statuses of requests. A request is submitted for approval whenever you create/edit/delete/revoke the following objects: Transactions, Users, Accounts, Groups, Whitelists, and Admin rule.

• Once a request is approved, its status will change. For example, if you requested the revocation of a user, they'll be revoked once all approvals have been collected. The status of the user will go from Active to Pending revocation , and then Revoked .

• Beware of requests limitations.

Transaction requests status

The status of a transaction request is displayed in the Status column of the transaction page. This table describes all possible statuses.

Note that for XRP and XLM the Unconfirmed status will be displayed until the transaction is Confirmed.

Status	Description
Awaiting approval	You haven't reviewed the request and your approval is required.
Pending approval	You've approved the request, but additional approvals must be collected.
Approved	One of the following reasons applies: The necessary number of approvals has been collected, but the transaction hasn't been broadcasted. The necessary number of approvals has been collected, but the HSM failed to sign the transaction.
Signed	The transaction has been signed by the HSM but the wallet daemon failed to broadcast it.
Unconfirmed	(XRP and XLM only) Because Ripple and Stellar don't have the notion of confirmation, the status Unconfirmed will be shown until the transaction is Confirmed.
Submitted	The transaction has been approved and broadcasted to the blockchain network. It hasn't received any confirmations yet.
Confirmed	The transaction has received its first confirmation from the blockchain network. We recommend waiting for more confirmations to consider the transaction as completed.
Failed	The transaction couldn't be broadcasted because the account's transaction rules have changed or the approval workflow is invalid. It must be recreated.
Failed to broadcast	The transaction couldn't be broadcasted because of connection issues with the Wallet Daemon. When this status appears, the transaction won't be broadcasted again. You must recreate a transaction.
Rejected	An Operator has rejected the request.
Dropped	The submitted request has been rejected by the blockchain. This can happen when: the blockchain has been reorganized. double-spending UTXOs. the wrong nonce was used to send the transaction (Ethereum only).
Expired	The request hasn't been approved before the 7-day expiry date.

Requests status

Requests can have different statuses as described in the following table.

	Request name	Possible status
Users	Create Operator Create Administrator Revoke user	Awaiting approval: Your approval is required on the request. Pending approval: You've approved the request and more approvals must be collected to authorize it. Approved: The request has been approved. Rejected: An Administrator has rejected the request. Failed: The request has failed because it conflicts with a request that has just been authorized. See the section below for additional information. Expired: The request hasn't been approved or rejected within the allocated time period: 7 days . Pending registration: (user requests only) An invitation URL has been sent to the user and you're now waiting for them to register.
Accounts	Create account Edit account
Groups	Create group Edit group Delete group
Whitelists	Create whitelist Edit whitelist

Additional information on the Failed status

Failed is the status given to requests that were interrupted because they conflict with another request which has just been authorized.

Admin rule request

Action			Failing reason
I want to...	Edit the Admin rule of my workspace...	While an account, group, user, or transaction request is pending approval...	You can either: Edit the admin rule in which case, all these requests will fail and will have to be recreated because the expected quorum of approval has changed. Or, Process these requests and then edit the admin rule to avoid having to recreate them.

Operator request

Action			Failing reason
I want to...	Revoke an Operator who...	Has been added to a group pending creation...	You can revoke the Operator but the Create group request will fail once the revocation is approved.
		Belongs to a group pending to be edit...	You can revoke the Operator but the Edit group request will fail once the revocation is approved.
		Belongs to a group pending to be deleted...	You can revoke the Operator but the Delete group request will fail once the revocation is approved.
		Is used in an account pending to be created...	You can revoke the Operator but the Create account request will fail once the revocation is approved
		Is used in an account pending to be edited...	You can revoke the Operator but the Edit account request will fail once the revocation is approved
		Has approved a transaction that is still pending to be approved...	You can revoke the Operator but the transaction request will fail once the revocation is approved.

Requests limitations

Occasionally, you'll be prevented from creating a request because it conflicts with another request pending approval. This request will first have to be approved or rejected to allow you to create the new one. Below is a summary of possible use cases.

Admin rule

Action			Blocking reason
I want to...	Edit the admin rule when...	A new Administrator is pending invitation...	You'll be prevented from editing the admin rule until the new Administrator is active.
		An Administrator is pending revocation...	You'll be prevented from editing the admin rule until the Administrator is revoked.
		Another edit admin rule request is pending...	You'll be prevented from editing the admin rule if another Edit admin rule request is pending.

Users

Action			Blocking reason
I want to...	Invite a new Administrator when...	Another Create Administrator request is pending...	You'll be prevented from inviting the Administrator. Unlike Operators, Administrators can't be created in bulk. They must be created one after the other.
		An Administrator is pending revocation...	You'll be prevented from inviting the Administrator until the revocation request is approved or rejected.
		An edit admin rule request is pending...	You'll be prevented from editing the admin rule if another Edit admin rule request is pending.
	Revoke an Administrator when...	A new Administrator is pending invitation...	You'll be prevented from editing the admin rule until the new Administrator is active.
		Another Administrator is pending revocation...	You'll be prevented from editing the admin rule until the Administrator is revoked.v
		An edit admin rule request is pending...	You'll be prevented from editing the admin rule if another Edit admin rule request is pending.
	Revoke an Operator when...	They must approve a pending transaction...	You'll be prevented from revoking the Operator until the transaction is approved or rejected.
		It breaks the approval workflow of an account...	You'll be prevented from revoking the Operator until you edit the approval workflow of the account.

Group

Action	Blocking reason
I want to...	Edit or delete a group when...	An Operator in this group is pending revocation...	You'll be prevented from editing the group until the Operator's revocation request is approved or rejected.
		An account using this group is pending creation...	You'll be prevented from editing or deleting the group until the account's creation request is approved or rejected.
		An account using this group is pending to be edited...	You'll be prevented from editing the group until the account's edit request is approved or rejected.
		An account using this group is pending deletion...	You'll be prevented from deleting the group as it's used in the approval workflow of the account. It must first be removed from the account's approval workflow.
		A transaction is pending approval...	You'll be prevented from editing the group until the transaction request is approved or rejected.
		It's used in the approval workflow of an account...	You'll be prevented from deleting the group as it's used in the approval workflow of an account. It must first be removed from the account's approval workflow by editing the account.

Account

Action			Blocking reason
I want to...	Edit an account when...	One of its members is pending revocation...	You'll be prevented from editing the account until the Operator's revocation request is approved or rejected.
		A group used in its approval workflow is pending to be edited...	You can't edit the account until the group's edit request is approved or rejected.
		A whitelist used in its transaction rules is pending to be edited or deletion...	You can't edit the account until the whitelist's edit request is approved or rejected or deleted.
		A transaction is pending approval...	You'll be prevented from editing the account until the transaction is approved or rejected.

Action			Blocking reason
I want to...	Edit an Ethereum account when...	One of its linked ERC20 accounts is pending to be edited...	You'll be prevented from editing the Ethereum account until the edit request is processed.
	Edit an ERC20 account when...	Its parent Ethereum account is pending to be edited...	You'll be prevented from editing the ERC20 account until the edit request is processed.
		Another ERC20 account linked to the same parent Ethereum account is pending to be edited...	You'll be prevented from editing the ERC20 account until the edit request is processed.

Transactions

Action			Blocking reason
I want to...	Create a transaction when...	A group that must approve it is pending to be edited...	You'll be prevented from creating the transaction until the group edit request is approved or rejected.
		The account is pending to be edited...	You'll be prevented from creating a transaction until the account edit request is approved or rejected.
		A whitelist used by this account is pending to be edited ...	You'll be prevented from creating the transaction until the whitelist edit request is approved or rejected.

Whitelists

Action	Blocking reason
I want to...	Edit a whitelist when...	An account using this whitelist is pending to be edited...	You'll be prevented from editing the whitelist until the account's edit request is approved or rejected.
		A transaction is pending approval...	You'll be prevented from editing the whitelist until the account's transaction request is approved or rejected.
		It's used in the transaction rules of an account...	You'll be prevented from editing the whitelist if it no longer contains addresses in the currency of accounts using it. In this case, you must first unlink the whitelist from the affected accounts.

Objects

Objects (Users, Accounts, Groups, Whitelists, and Admin rule) can have the following statuses.

Object type	Object status
Users	Pending registration: An invitation URL has been sent to the user and you must wait for them to register. Pending: A new Operator or Administrator is being created. Additional approvals are pending to be collected to activate the user. Active: The Administrator or Operator is active and can operate in your workspace. Active Ÿ : The Administrator or Operator is active but a revocation request is in progress. If it's authorized the user will be revoked. Access suspended: The Operator has been temporarily suspended. Revoked: The Administrator or Operator has been revoked from your workspace.
Accounts	Pending: A new account is being created. Additional approvals are pending to be collected to activate the account. Active: The account is active and can be used to create transactions. Active Ÿ : An edit request is in progress on this account. If it's authorized the edits will be implemented. View-only: The approval workflow of the account (Ethereum or ERC20 only) hasn't been provided. For more information, see View-only Ethereum accounts .
Groups	Pending: A new group is being created. Additional approvals are pending to be collected to activate the group. Active: The group is active and can be used in the approval workflow of any account. Active Ÿ : An edit or delete request is in progress on this group. If it's authorized the group will be edited or deleted. Deleted: The group has been deleted.
Whitelists	Pending: A new whitelist is being created. Additional approvals are pending to be collected to activate the whitelist. Active: The whitelist is active and can be used in the transaction rules of any compatible account. Active Ÿ : An edit request is in progress on this whitelist. If it's authorized the whitelist will be edited.
Transactions	Pending: A new transaction is pending. Additional approvals must be collected before it's approved. Approved: The transaction has been approved and broadcasted to the blockchain network. Rejected: The transaction has been rejected by an Operator.