From 55e1625dfb052017f826862ffb9e515bc637e6fb Mon Sep 17 00:00:00 2001
From: woodser <woodser@protonmail.com>
Date: Mon, 17 Sep 2018 15:10:34 -0400
Subject: [PATCH] update submit_block rpc documentation with example

---
 .../ar/resources/developer-guides/daemon-rpc.md | 17 ++++++++++++++++-
 .../en/resources/developer-guides/daemon-rpc.md | 17 ++++++++++++++++-
 .../es/resources/developer-guides/daemon-rpc.md | 17 ++++++++++++++++-
 .../fr/resources/developer-guides/daemon-rpc.md | 17 ++++++++++++++++-
 .../it/resources/developer-guides/daemon-rpc.md | 17 ++++++++++++++++-
 5 files changed, 80 insertions(+), 5 deletions(-)

diff --git a/_i18n/ar/resources/developer-guides/daemon-rpc.md b/_i18n/ar/resources/developer-guides/daemon-rpc.md
index fcd5d984..a9606aed 100644
--- a/_i18n/ar/resources/developer-guides/daemon-rpc.md
+++ b/_i18n/ar/resources/developer-guides/daemon-rpc.md
@@ -204,12 +204,27 @@ Alias: *submitblock*.
 
 Inputs:
 
-* Block blob data - string
+* Block blob data - array of strings; list of block blobs which have been mined.  See [get_block_template](#get_block_template) to get a blob on which to mine.
 
 Outputs:
 
 * *status* - string; Block submit status.
 
+In this example, a block blob which has not been mined is submitted:
+
+```
+$ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"submit_block","params":["0707e6bdfedc053771512f1bc27c62731ae9e8f2443db64ce742f4e57f5cf8d393de28551e441a0000000002fb830a01ffbf830a018cfe88bee283060274c0aae2ef5730e680308d9c00b6da59187ad0352efe3c71d36eeeb28782f29f2501bd56b952c3ddc3e350c2631d3a5086cac172c56893831228b17de296ff4669de020200000000"]' -H 'Content-Type: application/json'
+
+{
+  "id": "0",
+  "jsonrpc": "2.0",
+  "error": {
+    "code": -7,
+    "message": "Block not accepted"
+  }
+}
+```
+
 
 ### **get_last_block_header**
 
diff --git a/_i18n/en/resources/developer-guides/daemon-rpc.md b/_i18n/en/resources/developer-guides/daemon-rpc.md
index 1cf8310b..11fe435e 100644
--- a/_i18n/en/resources/developer-guides/daemon-rpc.md
+++ b/_i18n/en/resources/developer-guides/daemon-rpc.md
@@ -204,12 +204,27 @@ Alias: *submitblock*.
 
 Inputs:
 
-* Block blob data - string
+* Block blob data - array of strings; list of block blobs which have been mined.  See [get_block_template](#get_block_template) to get a blob on which to mine.
 
 Outputs:
 
 * *status* - string; Block submit status.
 
+In this example, a block blob which has not been mined is submitted:
+
+```
+$ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"submit_block","params":["0707e6bdfedc053771512f1bc27c62731ae9e8f2443db64ce742f4e57f5cf8d393de28551e441a0000000002fb830a01ffbf830a018cfe88bee283060274c0aae2ef5730e680308d9c00b6da59187ad0352efe3c71d36eeeb28782f29f2501bd56b952c3ddc3e350c2631d3a5086cac172c56893831228b17de296ff4669de020200000000"]' -H 'Content-Type: application/json'
+
+{
+  "id": "0",
+  "jsonrpc": "2.0",
+  "error": {
+    "code": -7,
+    "message": "Block not accepted"
+  }
+}
+```
+
 
 ### **get_last_block_header**
 
diff --git a/_i18n/es/resources/developer-guides/daemon-rpc.md b/_i18n/es/resources/developer-guides/daemon-rpc.md
index fcd5d984..a9606aed 100644
--- a/_i18n/es/resources/developer-guides/daemon-rpc.md
+++ b/_i18n/es/resources/developer-guides/daemon-rpc.md
@@ -204,12 +204,27 @@ Alias: *submitblock*.
 
 Inputs:
 
-* Block blob data - string
+* Block blob data - array of strings; list of block blobs which have been mined.  See [get_block_template](#get_block_template) to get a blob on which to mine.
 
 Outputs:
 
 * *status* - string; Block submit status.
 
+In this example, a block blob which has not been mined is submitted:
+
+```
+$ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"submit_block","params":["0707e6bdfedc053771512f1bc27c62731ae9e8f2443db64ce742f4e57f5cf8d393de28551e441a0000000002fb830a01ffbf830a018cfe88bee283060274c0aae2ef5730e680308d9c00b6da59187ad0352efe3c71d36eeeb28782f29f2501bd56b952c3ddc3e350c2631d3a5086cac172c56893831228b17de296ff4669de020200000000"]' -H 'Content-Type: application/json'
+
+{
+  "id": "0",
+  "jsonrpc": "2.0",
+  "error": {
+    "code": -7,
+    "message": "Block not accepted"
+  }
+}
+```
+
 
 ### **get_last_block_header**
 
diff --git a/_i18n/fr/resources/developer-guides/daemon-rpc.md b/_i18n/fr/resources/developer-guides/daemon-rpc.md
index fcd5d984..a9606aed 100644
--- a/_i18n/fr/resources/developer-guides/daemon-rpc.md
+++ b/_i18n/fr/resources/developer-guides/daemon-rpc.md
@@ -204,12 +204,27 @@ Alias: *submitblock*.
 
 Inputs:
 
-* Block blob data - string
+* Block blob data - array of strings; list of block blobs which have been mined.  See [get_block_template](#get_block_template) to get a blob on which to mine.
 
 Outputs:
 
 * *status* - string; Block submit status.
 
+In this example, a block blob which has not been mined is submitted:
+
+```
+$ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"submit_block","params":["0707e6bdfedc053771512f1bc27c62731ae9e8f2443db64ce742f4e57f5cf8d393de28551e441a0000000002fb830a01ffbf830a018cfe88bee283060274c0aae2ef5730e680308d9c00b6da59187ad0352efe3c71d36eeeb28782f29f2501bd56b952c3ddc3e350c2631d3a5086cac172c56893831228b17de296ff4669de020200000000"]' -H 'Content-Type: application/json'
+
+{
+  "id": "0",
+  "jsonrpc": "2.0",
+  "error": {
+    "code": -7,
+    "message": "Block not accepted"
+  }
+}
+```
+
 
 ### **get_last_block_header**
 
diff --git a/_i18n/it/resources/developer-guides/daemon-rpc.md b/_i18n/it/resources/developer-guides/daemon-rpc.md
index fcd5d984..a9606aed 100644
--- a/_i18n/it/resources/developer-guides/daemon-rpc.md
+++ b/_i18n/it/resources/developer-guides/daemon-rpc.md
@@ -204,12 +204,27 @@ Alias: *submitblock*.
 
 Inputs:
 
-* Block blob data - string
+* Block blob data - array of strings; list of block blobs which have been mined.  See [get_block_template](#get_block_template) to get a blob on which to mine.
 
 Outputs:
 
 * *status* - string; Block submit status.
 
+In this example, a block blob which has not been mined is submitted:
+
+```
+$ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"submit_block","params":["0707e6bdfedc053771512f1bc27c62731ae9e8f2443db64ce742f4e57f5cf8d393de28551e441a0000000002fb830a01ffbf830a018cfe88bee283060274c0aae2ef5730e680308d9c00b6da59187ad0352efe3c71d36eeeb28782f29f2501bd56b952c3ddc3e350c2631d3a5086cac172c56893831228b17de296ff4669de020200000000"]' -H 'Content-Type: application/json'
+
+{
+  "id": "0",
+  "jsonrpc": "2.0",
+  "error": {
+    "code": -7,
+    "message": "Block not accepted"
+  }
+}
+```
+
 
 ### **get_last_block_header**
 
-- 
GitLab