From 4da941bf54e8b77e5877984be2b5b5b71e2a7da9 Mon Sep 17 00:00:00 2001 From: J-Dog Date: Wed, 22 May 2024 12:09:05 -0700 Subject: [PATCH] cleaned up `SLEEP` spec and added `MEMO` param --- docs/actions/SLEEP.md | 20 ++++++++++++++++---- 1 file changed, 16 insertions(+), 4 deletions(-) diff --git a/docs/actions/SLEEP.md b/docs/actions/SLEEP.md index 872b3e0..269f6d7 100644 --- a/docs/actions/SLEEP.md +++ b/docs/actions/SLEEP.md @@ -7,6 +7,7 @@ This command pauses all `token` `ACTIONS` until `RESUME_BLOCK` is reached | `VERSION` | String | Broadcast Format Version | | `TICK` | String | 1 to 250 characters in length | | `RESUME_BLOCK` | String | Block index to resume BTNS `ACTION` commands | +| `MEMO` | String | An optional memo to include | ## Formats @@ -22,7 +23,18 @@ This example pauses/sleeps ALL BTNS `ACTION` commands on JDOG `token` until bloc ## Rules ## Notes -- USE WITH CAUTION! `SLEEP` will stop/pause all BTNS actions, including dispenses. -- `SLEEP` can result in loss of user funds, as payments to BTNS dispensers will be ignored. -- Can use `LOCK_SLEEP` in `ISSUE` command to prevent `SLEEP` command -- Can issue a `SLEEP` before `RESUME_BLOCK` to extend a `SLEEP` \ No newline at end of file +- `SLEEP` does _NOT_ prevent `DISPENSER` dispenses, as that could result in a loss of user funds. +- `SLEEP` does _NOT_ prevent usage of the `SLEEP` command +- `SLEEP` with `RESUME_BLOCK` set to `0` value, will unpause actions immediately. +- `SLEEP` with `RESUME_BLOCK` set to `-1` value, will pause actions indefinitely. +- `ISSUE` `TICK` with `LOCK_SLEEP` set to `1` to permanently prevent use of the `SLEEP` command +- Can use `BATCH` commands to stop `SLEEP`, execute `ACTION` commands, and then resume `SLEEP`, etc. +` +bt:BATCH|0| +SLEEP|0|JDOG|0; +ISSUE|1|JDOG|We are working to resolve the problem; +ISSUE|2|JDOG||1000; +SEND|0|JDOG|1000|1JDogZS6tQcSxwfxhv6XKKjcyicYA4Feev|Funding contract address; +MINT|0|JDOG||1000|1JDogZS6tQcSxwfxhv6XKKjcyicYA4Feev; +SLEEP|0|JDOG|-1 +`