Account order

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "instant-acme"
-version = "0.6.0"
+version = "0.6.1"
 edition = "2021"
 rust-version = "1.64"
 license = "Apache-2.0"

src/lib.rs

@@ -179,6 +179,11 @@ impl Order {
         Ok(&self.state)
     }
 
+    /// Extract the URL and last known state from the `Order`
+    pub fn into_parts(self) -> (String, OrderState) {
+        (self.url, self.state)
+    }
+
     /// Get the last known state of the order
     ///
     /// Call `refresh()` to get the latest state from the server.
@@ -347,7 +352,7 @@ impl Account {
     /// Create a new order based on the given [`NewOrder`]
     ///
     /// Returns an [`Order`] instance. Use the [`Order::state()`] method to inspect its state.
-    pub async fn new_order<'a>(&'a self, order: &NewOrder<'_>) -> Result<Order, Error> {
+    pub async fn new_order(&self, order: &NewOrder<'_>) -> Result<Order, Error> {
         let rsp = self
             .inner
             .post(Some(order), None, &self.inner.client.urls.new_order)
@@ -371,6 +376,24 @@ impl Account {
         })
     }
 
+    /// Fetch the order state for an existing order based on the given `url`
+    ///
+    /// This might fail if the given URL's order belongs to a different account.
+    ///
+    /// Returns an [`Order`] instance. Use the [`Order::state`] method to inspect its state.
+    pub async fn order(&self, url: String) -> Result<Order, Error> {
+        let rsp = self.inner.post(None::<&Empty>, None, &url).await?;
+        Ok(Order {
+            account: self.inner.clone(),
+            nonce: nonce_from_response(&rsp),
+            // Order of fields matters! We return errors from Problem::check
+            // before emitting an error if there is no order url. Or the
+            // simple no url error hides the causing error in `Problem::check`.
+            state: Problem::check::<OrderState>(rsp).await?,
+            url,
+        })
+    }
+
     /// Revokes a previously issued certificate
     pub async fn revoke<'a>(&'a self, payload: &RevocationRequest<'a>) -> Result<(), Error> {
         let revoke_url = match self.inner.client.urls.revoke_cert.as_deref() {