add descriptions for newly added workflows

crates/icepick/workflows/cosmos/broadcast.yaml

@@ -1,7 +1,13 @@
 name: "broadcast"
+description: |-
+  Broadcast a transaction on a Cosmos-based blockchain.
 inputs:
-- "nonce_address"
+- name: "nonce_address"
-- "chain_name"
+  description: >-
+    The address of the account used for the transaction nonce.
+- name: "chain_name"
+  description: >-
+    The name of the Cosmos chain to broadcast a transaction on.
 step:
 - type: "cosmos-get-chain-info"
   inputs:
@@ -34,4 +40,4 @@ step:
     status: "status"
     url: "url"
     error: "error"
-    error_code: "error_code"
+    error_code: "error_code"

crates/icepick/workflows/cosmos/transfer.yaml

@@ -1,10 +1,22 @@
 name: "transfer"
+description: |-
+  Transfer a Cosmos coin.
 inputs:
-- "from_address"
+- name: "from_address"
-- "to_address"
+  description: >-
-- "asset_name"
+    The address from which to send coin.
-- "chain_name"
+- name: "to_address"
-- "asset_amount"
+  description: >-
+    The address to send coins to.
+- name: "asset_name"
+  description: >-
+    The name of the asset to send.
+- name: "chain_name"
+  description: >-
+    The name of the Cosmos chain the asset lives on.
+- name: "asset_amount"
+  description: >-
+    The amount of the asset to send.
 step:
 - type: "cosmos-get-chain-info"
   inputs:
@@ -40,4 +52,4 @@ step:
   values:
     filename: "transaction.json"
   inputs:
-    transaction: "signed_transaction"
+    transaction: "signed_transaction"

crates/icepick/workflows/sol/broadcast.yaml

@@ -1,7 +1,15 @@
 name: "broadcast"
+description: |-
+  Broadcast a transaction on the Solana blockchain.
 inputs:
-- "nonce_address"
+- name: "nonce_address"
-- "cluster"
+  description: >-
+    The address of the nonce account.
+- name: "cluster"
+  description: >-
+    The name of the Solana cluster to broadcast the transaction on, if not
+    mainnet-beta.
+  optional: true
 step:
 - type: "sol-get-nonce-account-data"
   inputs:
@@ -29,4 +37,4 @@ step:
   outputs:
     status: "status"
     url: "url"
-    error: "error"
+    error: "error"

crates/icepick/workflows/sol/generate-nonce-account.yaml

@@ -1,7 +1,20 @@
 name: "generate-nonce-account"
+description: |-
+  Using a temporary Keyfork instance, generate a nonce address for the given
+  authorization address.
 inputs:
-- "cluster"
+- name: "cluster"
-- "authorization_address"
+  description: >-
+    Name of the Solana cluster to generate the nonce account on, if not
+    mainnet-beta.
+- name: "authorization_address"
+  description: >-
+    The address used to authorize advancing the nonce.
+
+    The authorization address (also called "address" or "pubkey" in other
+    workflows) is required to be a signer of the transaction, so the
+    authorization address is often the principal address - the one performing
+    the transaction.
 step:
 - type: "sol-generate-wallet"
 - type: "sol-get-wallet-address"
@@ -59,4 +72,4 @@ step:
     status: "status"
     url: "url"
     nonce_account: "nonce_account"
-    error: "error"
+    error: "error"

crates/icepick/workflows/sol/transfer.yaml

@@ -1,8 +1,16 @@
 name: "transfer"
+description: |-
+  Transfer SOL from one address to another.
 inputs:
-- "to_address"
+- name: "to_address"
-- "from_address"
+  description: >-
-- "amount"
+    The address to send SOL to.
+- name: "from_address"
+  description: >-
+    The address to send SOL from.
+- name: "amount"
+  description: >-
+    The amount of SOL to send.
 step:
 - type: "internal-load-file"
   values:
@@ -38,4 +46,4 @@ step:
   values:
     filename: "transaction.json"
   inputs:
-    transaction: "signed_transaction"
+    transaction: "signed_transaction"