Events Prefab/Class (#21)

Author: 0xFirekeeper

Assets/Thirdweb/Core/Scripts/Contract.cs

@@ -30,6 +30,10 @@ public class Contract : Routable
         /// Call any Pack supported functions
         /// </summary>
         public Pack pack;
+        /// <summary>
+        /// Call any Contract Event functions
+        /// </summary>
+        public Events events;
 
         public Contract(string chain, string address, string abi = null) : base(abi != null ? $"{address}{Routable.subSeparator}{abi}" : address)
         {
@@ -41,6 +45,7 @@ public Contract(string chain, string address, string abi = null) : base(abi != n
             this.ERC1155 = new ERC1155(baseRoute);
             this.marketplace = new Marketplace(chain, address);
             this.pack = new Pack(chain, address);
+            this.events = new Events(baseRoute);
         }
 
         public async Task<CurrencyValue> GetBalance()

Assets/Thirdweb/Core/Scripts/Events.cs

@@ -0,0 +1,37 @@
+using System.Collections.Generic;
+using System.Threading.Tasks;
+
+namespace Thirdweb
+{
+    public class Events : Routable
+    {
+        public Events(string parentRoute) : base(Routable.append(parentRoute, "events"))
+        {
+
+        }
+
+        // READ FUNCTIONS
+
+        /// <summary>
+        /// Request specific events from a contract
+        /// </summary>
+        /// <param name="eventName">The event name as defined in the contract</param>
+        /// <param name="eventQueryOptions">Optional query filters</param>
+        /// <typeparam name="T">The event data structure to deserialize into</typeparam>
+        /// <returns>List of ContractEvent<T></returns>
+        public async Task<List<ContractEvent<T>>> Get<T>(string eventName, EventQueryOptions eventQueryOptions = null)
+        {
+            return await Bridge.InvokeRoute<List<ContractEvent<T>>>(getRoute("getEvents"), Utils.ToJsonStringArray(eventName, eventQueryOptions));
+        }
+
+        /// <summary>
+        /// Request all events from a contract
+        /// </summary>
+        /// <param name="eventQueryOptions">Optional query filters</param>
+        /// <returns>List of ContractEvent<object></returns>
+        public async Task<List<ContractEvent<object>>> GetAll(EventQueryOptions eventQueryOptions = null)
+        {
+            return await Bridge.InvokeRoute<List<ContractEvent<object>>>(getRoute("getAllEvents"), Utils.ToJsonStringArray(eventQueryOptions));
+        }
+    }
+}

Assets/Thirdweb/Core/Scripts/Events.cs.meta

@@ -456,4 +456,73 @@ public struct FundWalletOptions
         public int chainId;
         public List<string> assets;
     }
+
+    // Events
+
+    [System.Serializable]
+    public class EventQueryOptions
+    {
+        public int? fromBlock;
+        public string order; // "asc" or "desc"
+        public int? toBlock;
+        public Dictionary<string, object> filters;
+
+        public EventQueryOptions(Dictionary<string, object> filters = null, int? fromBlock = null, int? toBlock = null, string order = null)
+        {
+            this.fromBlock = fromBlock;
+            this.order = order;
+            this.toBlock = toBlock;
+            this.filters = filters;
+        }
+    }
+
+    [System.Serializable]
+    public struct ContractEvent<T>
+    {
+        public string eventName;
+        public T data;
+        public EventTransaction transaction;
+
+        public override string ToString()
+        {
+            return
+            $"ContractEvent:"
+            + $"\n>eventName: {eventName}"
+            + $"\n>data: {data.ToString()}"
+            + $"\n{transaction.ToString()}";
+        }
+    }
+
+    [System.Serializable]
+    public struct EventTransaction
+    {
+        public int blockNumber;
+        public string blockHash;
+        public int transactionIndex;
+        public bool removed;
+        public string address;
+        public string data;
+        public List<string> topics;
+        public string transactionHash;
+        public int logIndex;
+        public string @event;
+        public string eventSignature;
+
+        public override string ToString()
+        {
+            return
+            $"EventTransaction:"
+            + $"\n>blockNumber: {blockNumber}"
+            + $"\n>blockHash: {blockHash}"
+            + $"\n>transactionIndex: {transactionIndex}"
+            + $"\n>removed: {removed}"
+            + $"\n>address: {address}"
+            + $"\n>data: {data}"
+            + $"\n>topics: {topics}"
+            + $"\n>transactionHash: {transactionHash}"
+            + $"\n>logIndex: {logIndex}"
+            + $"\n>event: {@event}"
+            + $"\n>eventSignature: {eventSignature}";
+        }
+    }
 }