From bf8c5982a2e79f0b5198a0033dd41e9702d093f9 Mon Sep 17 00:00:00 2001
From: Christian Grothoff <christian@grothoff.org>
Date: Sun, 5 Apr 2020 22:05:38 +0200
Subject: make exchange API more uniform in how information is returned

---
 src/json/json.c | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

(limited to 'src/json/json.c')

diff --git a/src/json/json.c b/src/json/json.c
index f0c0aff57..67d62605f 100644
--- a/src/json/json.c
+++ b/src/json/json.c
@@ -92,6 +92,36 @@ TALER_JSON_get_error_code (const json_t *json)
 }
 
 
+/**
+ * Extract the Taler error hint from the given @a json object.
+ * Note that NULL is returned if no "hint" is present.
+ *
+ * @param json response to extract the error hint from
+ * @return the "hint" value from @a json; only valid as long as @a json is valid
+ */
+const char *
+TALER_JSON_get_error_hint (const json_t *json)
+{
+  const json_t *jc;
+
+  if (NULL == json)
+  {
+    GNUNET_break_op (0);
+    return NULL;
+  }
+  jc = json_object_get (json, "hint");
+  if (NULL == jc)
+    return NULL; /* no hint, is allowed */
+  if (! json_is_string (jc))
+  {
+    /* Hints must be strings */
+    GNUNET_break_op (0);
+    return NULL;
+  }
+  return json_string_value (jc);
+}
+
+
 /**
  * Extract the Taler error code from the given @a data object, which is expected to be in JSON.
  * Note that #TALER_EC_INVALID is returned if no "code" is present or if @a data is not in JSON.
-- 
cgit v1.2.3