Updates the API docs to reflect the new endpoint

API.md

@@ -48,7 +48,7 @@
 * paych.redeem
 * paych.voucher
 * [ping](#ping)
-* retrievalClient.retrievePiece
+* [retrievalClient.retrievePiece](#retrievalclientretrievepiece)
 * [show.block](#showblock)
 * [stats.bandwidth](#statsbandwidth)
 * [swarm.connect](#swarmconnect)
@@ -847,6 +847,35 @@ After first iteration:
 */
 ```
 
+## `retrievalClient.retrievePiece`
+
+> Read out piece data stored by a miner on the network
+
+### `retrievalClient.retrievePiece(miner, cid, [options])`
+
+#### Parameters
+
+| Name | Type | Description |
+|------|------|-------------|
+| miner address | `String` | Retrieval miner actor address |
+| cid | `String` | Content identifier of piece to read |
+| options | `Object` | Optional options |
+| options.signal | [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) | A signal that can be used to abort the request |
+
+#### Returns
+
+| Type | Description |
+|------|-------------|
+| `AsyncIterable<Buffer\|UInt8Array>` | Content of the file, yields `Buffer` objects in Node.js and `UInt8Array` objects in the browser |
+
+#### Example
+
+```js
+let data = Buffer.alloc(0)
+for await (const chunk of fc.retrievalClient.retrievePiece('t2u2r6nyaxdspozci5t2i2xtfw23lxa35rvkul7di','QmSB6t4fVfE4fZ46EFBodtK89RJaCRTtPRaEYFx8EQxh8a'))
+  data = Buffer.concat([data, chunk])
+```
+
 ## `show.block`
 
 > Show a filecoin block by its CID

test/unit/cmd/retrieval-client/retrieve-piece.test.js

@@ -16,4 +16,4 @@ test('should read out piece data stored by a miner on the network', async t => {
   }
 
   t.deepEqual(data, Buffer.concat(chunks))
-})
+})