new Testing environment

neo-devpack-dotnet.sln

@@ -1,6 +1,6 @@
 Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio Version 16
-VisualStudioVersion = 16.0.28803.452
+# Visual Studio Version 17
+VisualStudioVersion = 17.7.34003.232
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Neo.SmartContract.Framework", "src\Neo.SmartContract.Framework\Neo.SmartContract.Framework.csproj", "{C30B5859-D4B9-46E8-A797-6B0A1B49B590}"
 EndProject
@@ -16,22 +16,26 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{79389FC0-C62
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "tests", "tests", "{D5266066-0AFD-44D5-A83E-2F73668A63C8}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Neo.Compiler.CSharp.TestContracts", "tests\Neo.Compiler.CSharp.TestContracts\Neo.Compiler.CSharp.TestContracts.csproj", "{8D67DD5A-D683-481F-915E-98683EA38791}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Neo.Compiler.CSharp.TestContracts", "tests\Neo.Compiler.CSharp.TestContracts\Neo.Compiler.CSharp.TestContracts.csproj", "{8D67DD5A-D683-481F-915E-98683EA38791}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Neo.SmartContract.Framework.TestContracts", "tests\Neo.SmartContract.Framework.TestContracts\Neo.SmartContract.Framework.TestContracts.csproj", "{A372F1D6-51FF-472C-9508-FDAF7E6FEB13}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Neo.SmartContract.Framework.TestContracts", "tests\Neo.SmartContract.Framework.TestContracts\Neo.SmartContract.Framework.TestContracts.csproj", "{A372F1D6-51FF-472C-9508-FDAF7E6FEB13}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Neo.SmartContract.TestEngine", "tests\Neo.SmartContract.TestEngine\Neo.SmartContract.TestEngine.csproj", "{D0153204-6AEF-4D94-B0E1-8124C38C91D4}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Neo.SmartContract.TestEngine", "tests\Neo.SmartContract.TestEngine\Neo.SmartContract.TestEngine.csproj", "{D0153204-6AEF-4D94-B0E1-8124C38C91D4}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Neo", "neo\src\Neo\Neo.csproj", "{73223FBD-C562-4FA0-9722-C7F1C382A9DE}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Neo", "neo\src\Neo\Neo.csproj", "{73223FBD-C562-4FA0-9722-C7F1C382A9DE}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Neo.Cryptography.BLS12_381", "neo\src\Neo.Cryptography.BLS12_381\Neo.Cryptography.BLS12_381.csproj", "{D541BCE9-65BC-475B-94E5-19B6BFFF2B8E}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Neo.Cryptography.BLS12_381", "neo\src\Neo.Cryptography.BLS12_381\Neo.Cryptography.BLS12_381.csproj", "{D541BCE9-65BC-475B-94E5-19B6BFFF2B8E}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Neo.Json", "neo\src\Neo.Json\Neo.Json.csproj", "{35A34EBD-F2BF-4D83-A096-D5F007B12732}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Neo.Json", "neo\src\Neo.Json\Neo.Json.csproj", "{35A34EBD-F2BF-4D83-A096-D5F007B12732}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Neo.VM", "neo\src\Neo.VM\Neo.VM.csproj", "{D6D53889-5A10-46A4-BA66-E78B56EC1881}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Neo.VM", "neo\src\Neo.VM\Neo.VM.csproj", "{D6D53889-5A10-46A4-BA66-E78B56EC1881}"
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Dependency", "Dependency", "{49D5873D-7B38-48A5-B853-85146F032091}"
 EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Neo.SmartContract.Testing", "src\Neo.SmartContract.Testing\Neo.SmartContract.Testing.csproj", "{648DCE6F-A0BA-4032-951B-20CF5BBFD998}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Neo.SmartContract.Testing.UnitTests", "tests\Neo.SmartContract.Testing.UnitTests\Neo.SmartContract.Testing.UnitTests.csproj", "{B772B8A9-9362-4C6F-A6D3-2A4138439B2C}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -86,6 +90,14 @@ Global
 		{D6D53889-5A10-46A4-BA66-E78B56EC1881}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{D6D53889-5A10-46A4-BA66-E78B56EC1881}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{D6D53889-5A10-46A4-BA66-E78B56EC1881}.Release|Any CPU.Build.0 = Release|Any CPU
+		{648DCE6F-A0BA-4032-951B-20CF5BBFD998}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{648DCE6F-A0BA-4032-951B-20CF5BBFD998}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{648DCE6F-A0BA-4032-951B-20CF5BBFD998}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{648DCE6F-A0BA-4032-951B-20CF5BBFD998}.Release|Any CPU.Build.0 = Release|Any CPU
+		{B772B8A9-9362-4C6F-A6D3-2A4138439B2C}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{B772B8A9-9362-4C6F-A6D3-2A4138439B2C}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{B772B8A9-9362-4C6F-A6D3-2A4138439B2C}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{B772B8A9-9362-4C6F-A6D3-2A4138439B2C}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -101,8 +113,10 @@ Global
 		{D0153204-6AEF-4D94-B0E1-8124C38C91D4} = {D5266066-0AFD-44D5-A83E-2F73668A63C8}
 		{73223FBD-C562-4FA0-9722-C7F1C382A9DE} = {49D5873D-7B38-48A5-B853-85146F032091}
 		{D541BCE9-65BC-475B-94E5-19B6BFFF2B8E} = {49D5873D-7B38-48A5-B853-85146F032091}
-		{D6D53889-5A10-46A4-BA66-E78B56EC1881} = {49D5873D-7B38-48A5-B853-85146F032091}
 		{35A34EBD-F2BF-4D83-A096-D5F007B12732} = {49D5873D-7B38-48A5-B853-85146F032091}
+		{D6D53889-5A10-46A4-BA66-E78B56EC1881} = {49D5873D-7B38-48A5-B853-85146F032091}
+		{648DCE6F-A0BA-4032-951B-20CF5BBFD998} = {79389FC0-C621-4CEA-AD2B-6074C32E7BCA}
+		{B772B8A9-9362-4C6F-A6D3-2A4138439B2C} = {D5266066-0AFD-44D5-A83E-2F73668A63C8}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {6DA935E1-C674-4364-B087-F1B511B79215}

src/Neo.Compiler.CSharp/Neo.Compiler.CSharp.csproj

@@ -28,6 +28,7 @@
     <ProjectReference Include="..\Neo.SmartContract.Framework\Neo.SmartContract.Framework.csproj">
       <Aliases>scfx</Aliases>
     </ProjectReference>
+    <ProjectReference Include="..\Neo.SmartContract.Testing\Neo.SmartContract.Testing.csproj" />
   </ItemGroup>
 
 </Project>

src/Neo.Compiler.CSharp/Program.cs

@@ -14,6 +14,7 @@
 using Neo.Optimizer;
 using Neo.SmartContract;
 using Neo.SmartContract.Manifest;
+using Neo.SmartContract.Testing;
 using System;
 using System.CommandLine;
 using System.CommandLine.Invocation;
@@ -176,6 +177,12 @@ private static int ProcessOutputs(Options options, string folder, CompilationCon
                     return 1;
                 }
                 Console.WriteLine($"Created {path}");
+                // Create artifacts
+                {
+                    path = Path.Combine(outputFolder, $"{baseName}.artifacts.cs");
+                    File.WriteAllText(path, Artifacts.CreateSourceFromManifest(baseName, manifest.Abi));
+                    Console.WriteLine($"Created {path}");
+                }
                 if (options.Debug)
                 {
                     path = Path.Combine(outputFolder, $"{baseName}.nefdbgnfo");

src/Neo.SmartContract.Template/templates/neocontractnep17/Contract1.cs

@@ -1,5 +1,4 @@
 using Neo;
-using Neo.SmartContract;
 using Neo.SmartContract.Framework;
 using Neo.SmartContract.Framework.Attributes;
 using Neo.SmartContract.Framework.Native;
@@ -25,19 +24,10 @@ public class Contract1 : Nep17Token
 
         private const byte Prefix_Owner = 0xff;
 
-        // TODO: Replace it with your own address.
-        [InitialValue("<Your Address Here>", Neo.SmartContract.ContractParameterType.Hash160)]
-        private static readonly UInt160 InitialOwner = default;
-
         [Safe]
         public static UInt160 GetOwner()
         {
-            var currentOwner = Storage.Get(new[] { Prefix_Owner });
-
-            if (currentOwner == null)
-                return InitialOwner;
-
-            return (UInt160)currentOwner;
+            return (UInt160)Storage.Get(new[] { Prefix_Owner });
         }
 
         private static bool IsOwner() =>
@@ -52,24 +42,22 @@ public static void SetOwner(UInt160 newOwner)
         {
             if (IsOwner() == false)
                 throw new InvalidOperationException("No Authorization!");
-            if (newOwner != null && newOwner.IsValid)
-            {
-                Storage.Put(new[] { Prefix_Owner }, newOwner);
-                OnSetOwner(newOwner);
-            }
+
+            ExecutionEngine.Assert(newOwner.IsValid && !newOwner.IsZero, "owner must be valid");
+
+            Storage.Put(new[] { Prefix_Owner }, newOwner);
+            OnSetOwner(newOwner);
         }
 
         #endregion
 
         #region NEP17
 
-        // NOTE: Valid Range 0-31
-        [Safe]
-        public override byte Decimals() => 8;
-
         // TODO: Replace "EXAMPLE" with a short name all UPPERCASE 3-8 characters
-        [Safe]
-        public override string Symbol() => "EXAMPLE";
+        public override string Symbol { [Safe] get => "EXAMPLE"; }
+
+        // NOTE: Valid Range 0-31
+        public override byte Decimals { [Safe] get => 8; }
 
         public static new void Burn(UInt160 account, BigInteger amount)
         {
@@ -141,6 +129,16 @@ public static void _deploy(object data, bool update)
                 return;
             }
 
+            // Init method, you must deploy the contract with the owner as an argument, or it will take the sender
+            if (data is null) data = Runtime.Transaction.Sender;
+
+            UInt160 initialOwner = (UInt160)data;
+
+            ExecutionEngine.Assert(initialOwner.IsValid && !initialOwner.IsZero, "owner must exists");
+
+            Storage.Put(new[] { Prefix_Owner }, initialOwner);
+            OnSetOwner(initialOwner);
+
             // This will be executed during deploy
             Storage.Put(Storage.CurrentContext, "Hello", "World");
         }

src/Neo.SmartContract.Testing/Artifacts.cs

@@ -0,0 +1,160 @@
+using Neo.SmartContract.Manifest;
+using System.Linq;
+using System.Text;
+
+namespace Neo.SmartContract.Testing
+{
+    public class Artifacts
+    {
+        /// <summary>
+        /// Create source code from contract Abi
+        /// </summary>
+        /// <param name="name">Contract name</param>
+        /// <param name="abi">Abi</param>
+        /// <returns>Source</returns>
+        public static string CreateSourceFromManifest(string name, ContractAbi abi)
+        {
+            StringBuilder sourceCode = new();
+
+            sourceCode.AppendLine("using System.Collections.Generic;");
+            sourceCode.AppendLine("using System.Numerics;");
+            sourceCode.AppendLine("");
+            sourceCode.AppendLine("namespace Neo.SmartContract.Testing;");
+            sourceCode.AppendLine("");
+            sourceCode.AppendLine($"public abstract class {name} : Neo.SmartContract.Testing.SmartContract");
+            sourceCode.AppendLine("{");
+
+            // Crete events
+
+            if (abi.Events.Any())
+            {
+                sourceCode.AppendLine("#region Events");
+
+                foreach (var ev in abi.Events.OrderBy(u => u.Name))
+                {
+                    sourceCode.Append(CreateSourceEventFromManifest(ev));
+                }
+
+                sourceCode.AppendLine("#endregion");
+            }
+
+            // Crete methods
+
+            if (abi.Methods.Any(u => u.Safe))
+            {
+                sourceCode.AppendLine("#region Safe methods");
+
+                foreach (var method in abi.Methods.Where(u => u.Safe).OrderBy(u => u.Name))
+                {
+                    // This method can't be called, so avoid them
+
+                    if (method.Name.StartsWith("_")) continue;
+
+                    sourceCode.Append(CreateSourceMethodFromManifest(method));
+                }
+
+                sourceCode.AppendLine("#endregion");
+            }
+
+            if (abi.Methods.Any(u => !u.Safe))
+            {
+                sourceCode.AppendLine("#region Unsafe methods");
+
+                foreach (var method in abi.Methods.Where(u => !u.Safe).OrderBy(u => u.Name))
+                {
+                    // This method can't be called, so avoid them
+
+                    if (method.Name.StartsWith("_")) continue;
+
+                    sourceCode.Append(CreateSourceMethodFromManifest(method));
+                }
+                sourceCode.AppendLine("#endregion");
+            }
+
+            // Create constructor
+
+            sourceCode.AppendLine("#region Constructor for internal use only");
+            sourceCode.AppendLine($"    protected {name}(Neo.SmartContract.Testing.TestEngine testEngine, Neo.UInt160 hash) : base(testEngine, hash) {{}}");
+            sourceCode.AppendLine("#endregion");
+
+            sourceCode.AppendLine("}");
+
+            return sourceCode.ToString();
+        }
+
+        /// <summary>
+        /// Create source code from event
+        /// </summary>
+        /// <param name="ev">Event</param>
+        /// <returns>Source</returns>
+        private static string CreateSourceEventFromManifest(ContractEventDescriptor ev)
+        {
+            StringBuilder sourceCode = new();
+
+            sourceCode.Append($"    public delegate void del{ev.Name}(");
+
+            bool isFirst = true;
+            foreach (var arg in ev.Parameters)
+            {
+                if (!isFirst) sourceCode.Append(", ");
+                else isFirst = false;
+
+                sourceCode.Append($"{TypeToSource(arg.Type)} {arg.Name}");
+            }
+
+            sourceCode.AppendLine(");");
+            sourceCode.AppendLine($"    public event del{ev.Name}? {ev.Name};");
+
+            return sourceCode.ToString();
+        }
+
+        /// <summary>
+        /// Create source code from manifest method
+        /// </summary>
+        /// <param name="method">Contract method</param>
+        /// <returns>Source</returns>
+        private static string CreateSourceMethodFromManifest(ContractMethodDescriptor method)
+        {
+            StringBuilder sourceCode = new();
+
+            sourceCode.Append($"    public abstract {TypeToSource(method.ReturnType)} {method.Name}(");
+
+            bool isFirst = true;
+            foreach (var arg in method.Parameters)
+            {
+                if (!isFirst) sourceCode.Append(", ");
+                else isFirst = false;
+
+                sourceCode.Append($"{TypeToSource(arg.Type)} {arg.Name}");
+            }
+
+            sourceCode.AppendLine(");");
+
+            return sourceCode.ToString();
+        }
+
+        /// <summary>
+        /// Type to source
+        /// </summary>
+        /// <param name="type">Type</param>
+        /// <returns>c# type</returns>
+        private static string TypeToSource(ContractParameterType type)
+        {
+            return type switch
+            {
+                ContractParameterType.Boolean => "bool",
+                ContractParameterType.Integer => "BigInteger",
+                ContractParameterType.String => "string",
+                ContractParameterType.Hash160 => "UInt160",
+                ContractParameterType.Hash256 => "UInt256",
+                ContractParameterType.PublicKey => "ECPoint",
+                ContractParameterType.ByteArray => "byte[]",
+                ContractParameterType.Signature => "byte[]",
+                ContractParameterType.Array => "List<object>",
+                ContractParameterType.Map => "IDictionary<object,object>",
+                ContractParameterType.Void => "void",
+                _ => "object",
+            };
+        }
+    }
+}

src/Neo.SmartContract.Testing/Native/ContractManagement.cs

@@ -0,0 +1,34 @@
+using System.Collections.Generic;
+using System.Numerics;
+
+namespace Neo.SmartContract.Testing;
+
+public abstract class ContractManagement : Neo.SmartContract.Testing.SmartContract
+{
+    #region Events
+    public delegate void delDeploy(UInt160 Hash);
+    public event delDeploy? Deploy;
+    public delegate void delDestroy(UInt160 Hash);
+    public event delDestroy? Destroy;
+    public delegate void delUpdate(UInt160 Hash);
+    public event delUpdate? Update;
+    #endregion
+    #region Safe methods
+    public abstract List<object> getContract(UInt160 hash);
+    public abstract List<object> getContractById(BigInteger id);
+    public abstract object getContractHashes();
+    public abstract BigInteger getMinimumDeploymentFee();
+    public abstract bool hasMethod(UInt160 hash, string method, BigInteger pcount);
+    #endregion
+    #region Unsafe methods
+    public abstract List<object> deploy(byte[] nefFile, byte[] manifest);
+    public abstract List<object> deploy(byte[] nefFile, byte[] manifest, object data);
+    public abstract void destroy();
+    public abstract void setMinimumDeploymentFee(BigInteger value);
+    public abstract void update(byte[] nefFile, byte[] manifest);
+    public abstract void update(byte[] nefFile, byte[] manifest, object data);
+    #endregion
+    #region Constructor for internal use only
+    protected ContractManagement(Neo.SmartContract.Testing.TestEngine testEngine, Neo.UInt160 hash) : base(testEngine, hash) { }
+    #endregion
+}

src/Neo.SmartContract.Testing/Native/CryptoLib.cs

@@ -0,0 +1,23 @@
+using System.Collections.Generic;
+using System.Numerics;
+
+namespace Neo.SmartContract.Testing;
+
+public abstract class CryptoLib : Neo.SmartContract.Testing.SmartContract
+{
+    #region Safe methods
+    public abstract object bls12381Add(object x, object y);
+    public abstract object bls12381Deserialize(byte[] data);
+    public abstract bool bls12381Equal(object x, object y);
+    public abstract object bls12381Mul(object x, byte[] mul, bool neg);
+    public abstract object bls12381Pairing(object g1, object g2);
+    public abstract byte[] bls12381Serialize(object g);
+    public abstract byte[] murmur32(byte[] data, BigInteger seed);
+    public abstract byte[] ripemd160(byte[] data);
+    public abstract byte[] sha256(byte[] data);
+    public abstract bool verifyWithECDsa(byte[] message, byte[] pubkey, byte[] signature, BigInteger curve);
+    #endregion
+    #region Constructor for internal use only
+    protected CryptoLib(Neo.SmartContract.Testing.TestEngine testEngine, Neo.UInt160 hash) : base(testEngine, hash) { }
+    #endregion
+}