From 2b1e94b73111ece69503f0bdfe0fd622ead7bbf7 Mon Sep 17 00:00:00 2001
From: ivuorinen <ivuorinen@users.noreply.github.com>
Date: Fri, 2 Aug 2024 00:15:02 +0000
Subject: [PATCH] Update cheatsheets

---
 tldr/octez-client | 37 +++++++++++++++++++++++++++++++++++++
 tldr/timeout      | 16 ++++++++++++++--
 2 files changed, 51 insertions(+), 2 deletions(-)
 create mode 100644 tldr/octez-client

diff --git a/tldr/octez-client b/tldr/octez-client
new file mode 100644
index 00000000..3ce3d817
--- /dev/null
+++ b/tldr/octez-client
@@ -0,0 +1,37 @@
+---
+syntax: markdown
+tags: [tldr, common]
+source: https://github.com/tldr-pages/tldr.git
+---
+# octez-client
+
+> Interact with the Tezos blockchain.
+> More information: <https://tezos.gitlab.io/introduction/howtouse.html#client>.
+
+- Configure the client with a connection to a Tezos RPC node such as <https://rpc.ghostnet.teztnets.com>:
+
+`octez-client -E {{endpoint}} config update`
+
+- Create an account and assign a local alias to it:
+
+`octez-client gen keys {{alias}}`
+
+- Get the balance of an account by alias or address:
+
+`octez-client get balance for {{alias_or_address}}`
+
+- Transfer tez to a different account:
+
+`octez-client transfer {{5}} from {{alias|address}} to {{alias|address}}`
+
+- Originate (deploy) a smart contract, assign it a local alias, and set its initial storage as a Michelson-encoded value:
+
+`octez-client originate contract {{alias}} transferring {{0}} from {{alias|address}} running {{path/to/source_file.tz}} --init "{{initial_storage}}" --burn_cap {{1}}`
+
+- Call a smart contract by its alias or address and pass a Michelson-encoded parameter:
+
+`octez-client transfer {{0}} from {{alias|address}} to {{contract}} --entrypoint "{{entrypoint}}" --arg "{{parameter}}" --burn-cap {{1}}`
+
+- Display help:
+
+`octez-client man`
diff --git a/tldr/timeout b/tldr/timeout
index c1997d11..c5376017 100644
--- a/tldr/timeout
+++ b/tldr/timeout
@@ -12,6 +12,18 @@ source: https://github.com/tldr-pages/tldr.git
 
 `timeout 3s sleep 10`
 
-- Send a signal to the command after the time limit expires (SIGTERM by default):
+- Send a [s]ignal to the command after the time limit expires (`TERM` by default, `kill -l` to list all signals):
 
-`timeout --signal {{INT}} {{5s}} {{sleep 10}}`
+`timeout --signal {{INT|HUP|KILL|...}} {{5s}} {{sleep 10}}`
+
+- Send [v]erbose output to `stderr` showing signal sent upon timeout:
+
+`timeout --verbose {{0.5s|1m|1h|1d|...}} {{command}}`
+
+- Preserve the exit status of the command regardless of timing out:
+
+`timeout --preserve-status {{1s|1m|1h|1d|...}} {{command}}`
+
+- Send a forceful `KILL` signal after certain duration if the command ignores initial signal upon timeout:
+
+`timeout --kill-after={{5m}} {{30s}} {{command}}`