diff --git a/tools/getcoins_from_gratitude_box.sh b/tools/getcoins_from_gratitude_box.sh
index 4313c47e8..850af192c 100755
--- a/tools/getcoins_from_gratitude_box.sh
+++ b/tools/getcoins_from_gratitude_box.sh
@@ -1,4 +1,11 @@
 #!/bin/bash
+##########################
+## GRATITUDE BOX SIMULATOR
+##########################
+## distribute 30 units on 10 coins.
+##  get a random coin, read units
+##  GRATITUDE ~= 3 ( min = 1  max = 21 )
+##########################
 
 put_units_on_coins() {
       local coins=()