Async update calls with await

src/Candid/Models/RequestId.cs

@@ -21,6 +21,16 @@ public RequestId(byte[] rawValue)
 			this.RawValue = rawValue;
 		}
 
+		/// <summary>
+		/// Creates a request id from raw bytes, same as the constructor
+		/// </summary>
+		/// <param name="bytes">Raw request id bytes</param>
+		/// <returns>A request id object</returns>
+		public static RequestId FromBytes(byte[] bytes)
+		{
+			return new RequestId(bytes);
+		}
+
 		/// <summary>
 		/// Converts a hashable object into a request id
 		/// </summary>

src/PocketIC/IPocketIcHttpClient.cs

@@ -163,7 +163,7 @@ Task<IngressStatus> GetIngressStatusAsync(
 		EffectivePrincipal effectivePrincipal);
 
 	/// <summary>
-	/// Submits an ingress message to a canister without waiting for execution
+	/// Executes an ingress message on a canister and waits for the response
 	/// </summary>
 	/// <param name="instanceId">The id of the PocketIC instance</param>
 	/// <param name="sender">The principal sending the message</param>
@@ -172,7 +172,7 @@ Task<IngressStatus> GetIngressStatusAsync(
 	/// <param name="request">The raw candid request argument</param>
 	/// <param name="effectivePrincipal">Optional effective principal for the call, defaults to canister id</param>
 	/// <returns>The raw candid response</returns>
-	Task<CandidArg> SubmitIngressMessageAsync(
+	Task<CandidArg> ExecuteIngressMessageAsync(
 		int instanceId,
 		Principal sender,
 		Principal canisterId,
@@ -181,16 +181,16 @@ Task<CandidArg> SubmitIngressMessageAsync(
 		EffectivePrincipal? effectivePrincipal = null);
 
 	/// <summary>
-	/// Executes an ingress message on a canister and waits for the response
+	/// Submits an ingress message to a canister without waiting for execution
 	/// </summary>
 	/// <param name="instanceId">The id of the PocketIC instance</param>
 	/// <param name="sender">The principal sending the message</param>
 	/// <param name="canisterId">The target canister id</param>
 	/// <param name="method">The method name to call</param>
 	/// <param name="request">The raw candid request argument</param>
 	/// <param name="effectivePrincipal">Optional effective principal for the call, defaults to canister id</param>
-	/// <returns>The raw candid response</returns>
-	Task<CandidArg> ExecuteIngressMessageAsync(
+	/// <returns>The request id for the message</returns>
+	Task<RequestId> SubmitIngressMessageAsync(
 		int instanceId,
 		Principal sender,
 		Principal canisterId,
@@ -202,9 +202,9 @@ Task<CandidArg> ExecuteIngressMessageAsync(
 	/// Waits for an ingress message to complete execution
 	/// </summary>
 	/// <param name="instanceId">The id of the PocketIC instance</param>
-	/// <param name="messageId">The id of the ingress message</param>
+	/// <param name="requestId">The id of the ingress message</param>
 	/// <param name="effectivePrincipal">Effective principal for the call</param>
-	Task AwaitIngressMessageAsync(int instanceId, RequestId messageId, EffectivePrincipal effectivePrincipal);
+	Task<CandidArg> AwaitIngressMessageAsync(int instanceId, RequestId requestId, EffectivePrincipal effectivePrincipal);
 
 	/// <summary>
 	/// Sets the current time of the IC instance

src/PocketIC/PocketIc.cs

@@ -4,6 +4,7 @@
 using EdjCase.ICP.Candid.Models;
 using EdjCase.ICP.PocketIC.Client;
 using EdjCase.ICP.PocketIC.Models;
+using Org.BouncyCastle.Asn1.Ocsp;
 
 namespace EdjCase.ICP.PocketIC
 {
@@ -745,7 +746,7 @@ public async Task<CandidArg> UpdateCallRawAsync(
 			Principal sender,
 			Principal canisterId,
 			string method,
-			CandidArg arg,
+			CandidArg? arg = null,
 			EffectivePrincipal? effectivePrincipal = null
 		)
 		{
@@ -754,11 +755,60 @@ public async Task<CandidArg> UpdateCallRawAsync(
 				sender,
 				canisterId,
 				method,
-				arg,
+				arg ?? CandidArg.Empty(),
 				effectivePrincipal
 			);
 		}
 
+		/// <summary>
+		/// Submits an update call on a canister with a raw CandidArg and gets a request id 
+		/// in the response that can be awaited with <see cref="AwaitUpdateCallAsync(RequestId, Principal)"/> method
+		/// </summary>
+		/// <param name="sender">The principal making the call</param>
+		/// <param name="canisterId">The target canister ID</param>
+		/// <param name="method">The method name to call</param>
+		/// <param name="arg">The raw candid argument for the call</param>
+		/// <param name="effectivePrincipal">Optional effective principal for the call, defaults to canister id</param>
+		/// <returns>A raw candid argument from the response</returns>
+		public async Task<RequestId> UpdateCallRawAsynchronousAsync(
+			Principal sender,
+			Principal canisterId,
+			string method,
+			CandidArg? arg = null,
+			EffectivePrincipal? effectivePrincipal = null
+		)
+		{
+			return await this.HttpClient.SubmitIngressMessageAsync(
+				this.InstanceId,
+				sender,
+				canisterId,
+				method,
+				arg ?? CandidArg.Empty(),
+				effectivePrincipal
+			);
+		}
+
+		/// <summary>
+		/// Awaits an update call response for a given request id, from the <see cref="UpdateCallRawAsynchronousAsync"/> method
+		/// </summary>
+		/// <param name="requestId">The request id to await</param>
+		/// <param name="effectivePrincipal">The effective principal for the request</param>
+		/// <returns>The response from the update call</returns>
+		public async Task<CandidArg> AwaitUpdateCallAsync(RequestId requestId, EffectivePrincipal effectivePrincipal)
+		{
+			return await this.HttpClient.AwaitIngressMessageAsync(this.InstanceId, requestId, effectivePrincipal);
+		}
+
+		/// <summary>
+		/// Awaits an update call response for a given request id, from the <see cref="UpdateCallRawAsynchronousAsync"/> method
+		/// </summary>
+		/// <param name="requestId">The request id to await</param>
+		/// <param name="canisterId">The canister id for the request</param>
+		public async Task<CandidArg> AwaitUpdateCallAsync(RequestId requestId, Principal canisterId)
+		{
+			return await this.AwaitUpdateCallAsync(requestId, EffectivePrincipal.Canister(canisterId));
+		}
+
 		/// <summary>
 		/// Disposes of the PocketIC instance by deleting the instance
 		/// </summary>