VaultDelete
Permanently deletes an existing Vault
object from the ledger, removes all associated ledger entries, and returns the owner reserve to the Vault Owner.
Only the Vault Owner can initiate this transaction, and the vault must be completely empty before deletion.
(Requires the Single Asset Vault amendment )
Example VaultDelete JSON
{
"TransactionType": "VaultDelete",
"Account": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
"Fee": "12",
"Flags": 0,
"LastLedgerSequence": 7108682,
"Sequence": 8,
"VaultID": "77D6234D074E505024D39C04C3F262997B773719AB29ACFA83119E4210328776"
}
VaultDelete Fields
In addition to the common fields, VaultDelete
transactions use the following fields:
Field Name | JSON Type | Internal Type | Required? | Description |
---|---|---|---|---|
VaultID | String | Hash256 | Yes | The unique identifier of the vault that needs to be deleted. |
VaultDelete Flags
There are no flags defined for VaultDelete
transactions.
Error Cases
Besides errors that can occur for all transactions, VaultCreate transactions can result in the following transaction result codes:
Error Code | Description |
---|---|
tecNO_ENTRY | The Vault object with the provided VaultID does not exist on the ledger. |
tecNO_PERMISSION | The account submitting the transaction is not the Owner of the vault. |
tecHAS_OBLIGATIONS | The vault to be deleted is connected to objects that cannot be deleted in the ledger. For example, the owner directory of the vault's pseudo-account contains references to any objects other than the vault, shares, or assets. |