changelog entries, document in event-dispatcher.md

CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unrelease]
+
+### Added
+
+- `/drop_mempool_tx` endpoint to notify event observers when a mempool
+  transaction has been removed the mempool.
+- `"reward_slot_holders"` field to the `new_burn_block` event
+
 ## [2.0.6] - 2021-02-15
 
 The database schema has not changed since 2.0.5, so when spinning up a

docs/event-dispatcher.md

@@ -128,3 +128,25 @@ Example:
   "0x80800000000400f942874ce525e87f21bbe8c121b12fac831d02f4000000000000000000000000000003e800006ae29867aec4b0e4f776bebdcea7f6d9a24eeff370c8c739defadfcbb52659b30736ad4af021e8fb741520a6c65da419fdec01989fdf0032fc1838f427a9a36102010000000000051ac2d519faccba2e435f3272ff042b89435fd160ff00000000000003e800000000000000000000000000000000000000000000000000000000000000000000"
 ]
 ```
+
+
+### `POST /drop_mempool_tx`
+
+This payload includes raw transactions newly received in the
+node's mempool.
+
+Example:
+
+```json
+{
+  "dropped_txids": ["d7b667bb93898b1d3eba4fee86617b06b95772b192f3643256dd0821b476e36f"],
+  "reason": "ReplaceByFee"
+}
+```
+
+Reason can be one of:
+
+* `ReplaceByFee` - replaced by a transaction with the same nonce, but a higher fee
+* `ReplaceAcrossFork` - replaced by a transaction with the same nonce but in the canonical fork
+* `TooExpensive` - the transaction is too expensive to include in a block
+* `StaleGarbageCollect` - transaction was dropped because it became stale