docs/runtime/index: add documentation about suspended runtimes

oasisprotocol · Jul 22, 2020 · fdcd0f9 · fdcd0f9
1 parent a753635
commit fdcd0f9
Showing 1 changed file with 12 additions and 0 deletions.
diff --git a/docs/runtime/index.md b/docs/runtime/index.md
@@ -159,3 +159,15 @@ specific root. These receipts are verified by the [roothash service] before
 accepting a commitment from a compute node.
 
 [Merklized Key-Value Store (MKVS)]: ../mkvs.md
+
+### Suspending Runtimes
+
+Since periodic maintenance work must be performed on each epoch transition
+(e.g., electing runtime committees), fees for that maintenance are paid by any
+nodes that register to perform work for a specific runtime. Fees are pre-paid
+for the number of epochs a node registers for. If there are no committees for a
+runtime on epoch transition, the runtime is suspended for the epoch.
+The runtime is also suspended in case the registering entity no longer has
+enough stake to cover the entity and runtime deposits. The runtime will be
+resumed on the epoch transition if runtime nodes will register and the
+registering entity will have enough state.