Destroy standard

nep-X1.mediawiki

@@ -0,0 +1,60 @@
+<pre>
+  NEP: 31
+  Title: Contract Destroy Function
+  Author: Owen Zhang <zhangzhihong@ngd.neo.org>
+  Type: Standard
+  Status: Draft
+  Created: 2024-09-11
+</pre>
+
+==Abstract==
+
+This proposal standardizes the destroy function which is necessary for contract storage deletion.
+
+==Motivation==
+
+N3 already provided contract destroy mechanism but it hasn't been summarized in a standard. This standard will show details.
+
+==Specification==
+
+Neo N3 has a native <code>ContractManagement</code> contract that is used for contract destroy via <code>destroy</code> method. When <code>destroy</code> is executed, it will callback the <code>destroy</code> method in <code>ContractManagement</code>. Finally, it will delete all storage and entries of this contract. It will block the contract address in native <code>Policy</code> contract as well.
+
+===Methods===
+
+====destroy====
+
+<pre>
+{
+  "name": "destroy",
+  "safe": false,
+  "parameters": [],
+  "returntype": "Void"
+}
+</pre>
+This method will automatically invoke <code>destroy</code> method of <code>ContractManagement</code> contract when a contract is destroyed.
+
+===Events===
+
+====Destroy====
+
+<pre>
+{
+  "name": "Destroy",
+  "parameters": [
+    {
+      "name": "contract",
+      "type": "Hash160"
+    }
+  ]
+}
+</pre>
+
+<code>Destroy</code>notification will be emitted automatically by native <code>ContractManagement</code> contract as well. It will notify contract hash in event.
+
+==References==
+
+
+==Implementation==
+
+* C#: https://github.com/neo-project/neo-devpack-dotnet/blob/003a50095efe88f63f518a0c989921be086409f3/examples/Example.SmartContract.NFT/Loot.Admin.cs#L79
+