add cw state tooltips

docs/cloud-wallet/tooltips.md

@@ -240,3 +240,135 @@ Token issuers can send messages with a variety of different topics. You can subs
 - /company/general
 - /company/airdrops
 - /company/meetups/miami
+
+## Transaction states
+
+These labels describe the lifecycle of a transaction in your vault. For more on clawbacks and pending activity, see [Clawback](#clawback) and the [FAQ](/cloud-wallet/faq/).
+
+### Transaction UNSIGNED
+
+The transaction is a draft and coins are still in your vault but are locked in reserve for the transaction. **Action:** Sign the transaction and it will be submitted to the mempool or delete the transaction to unlock the coins for use in another transaction.
+
+### Transaction SIGNED
+
+Transaction is ready for submission to the mempool. **Action:** The transaction will be automatically submitted to the blockchain; if the transaction remains in this state for more than 10 minutes please contact our support team with the in-app form or in [discord](https://discord.gg/chia).
+
+### Transaction MEMPOOL
+
+The transaction has been submitted to the blockchain and the associated coins have left your available balance but are not yet confirmed. **Action:** Wait for the network to include the transaction in a block; if the transaction remains in this state for more than 10 minutes please contact our support team with the in-app form or in [discord](https://discord.gg/chia).
+
+### Transaction PENDING
+
+The transaction is being prepared or is waiting on another step (for example vault coordination or signer availability) before it can be submitted or advance to the mempool. It is not yet fully signed or broadcast. **Action:** Complete any prompts or signing steps in the Cloud Wallet; if the status does not change for an extended time, refresh the app or contact our support team with the in-app form or in [discord](https://discord.gg/chia).
+
+### Transaction SETTLED
+
+Transaction has completed and coins have successfully transferred to the destination. **Action:** None. Transaction is complete.
+
+### Transaction RE_ORG
+
+This transaction was part of a blockchain re-org and coins have not been transferred. **Action:** Confirm the coin status with the other party of the transaction and ensure they resync their wallet as needed; you will likely need to recreate and submit this transaction from the initiating wallet. If questions arise please contact our support team with the in-app form or in [discord](https://discord.gg/chia).
+
+### Transaction INVALID
+
+The transaction failed (likely due to low fees or a conflict) and coins have not been transferred. **Action:** Re-create the transaction with corrected details.
+
+## Offer states
+
+These labels describe the lifecycle of an offer. For context on vault-based offers, see [Known issues](/cloud-wallet/known-issues/).
+
+### Offer OPEN
+
+The offer is active and available for others to accept (others will need a copy of the offer file to accept it). Coins are reserved in your vault and may have been moved to an offer reservation address controlled by your vault (based on whether you enabled the auto-split feature when creating the offer). **Action:** Wait for a counterparty to accept or cancel the offer if you no longer wish to trade.
+
+### Offer MEMPOOL
+
+An acceptance of the offer has been broadcast to the network. The associated coins have left your available balance but are not yet confirmed. **Action:** Wait for the transaction to be included in a block; if the transaction remains in this state for more than 10 minutes please contact our support team with the in-app form or in [discord](https://discord.gg/chia).
+
+### Offer SETTLED
+
+The trade is successful and the exchange of coins is final. **Action:** None. The offer is complete.
+
+### Offer RE_ORG
+
+This offer was part of a blockchain re-org and coins have not been transferred. **Action:** Confirm the coin status with the other party and ensure they resync their wallet as needed; you may need to recreate or resubmit this offer. If questions arise please contact our support team with the in-app form or in [discord](https://discord.gg/chia).
+
+### Offer EXPIRED
+
+The time limit for this offer has passed and coins are no longer reserved. **Action:** Create a new offer if you still wish to trade.
+
+### Offer INVALID
+
+The offer can no longer be fulfilled (e.g., coins were spent elsewhere or fees were too low). **Action:** Remove the offer and create a new one with available funds.
+
+### Offer PENDING
+
+The offer is being prepared, validated, or updated; reserved coins may still be settling into the correct shape for the offer. **Action:** Wait for the status to advance to Open or another terminal state; if it stays pending for an extended time, try refreshing or contact our support team with the in-app form or in [discord](https://discord.gg/chia).
+
+## Vault recovery states
+
+These are workflow states during a vault [recovery](#recovery). See [Instant Recovery](#instant-recovery) and [Timelocked Recovery](#timelocked-recovery) for types of recovery.
+
+### Recovery IDLE
+
+No recovery is in progress, or the last recovery-related transaction has settled and the vault is no longer in an active recovery workflow. **Action:** None unless you intend to start or continue a recovery.
+
+### Recovery AWAITING_REVIEW
+
+A recovery request has been submitted and is waiting for review by a [recovery provider](#recovery-provider), when one is configured. **Action:** Wait for the provider; follow any email or in-app instructions. If nothing changes for an unusually long time, contact the recovery provider or support with the in-app form or in [discord](https://discord.gg/chia).
+
+### Recovery PENDING
+
+The recovery request is waiting for your signature (after provider approval, if applicable, or when using a direct recovery path). **Action:** Open the signing flow and complete the required signatures.
+
+### Recovery SIGNED
+
+The recovery transaction has been signed on your side but has not yet been submitted to the blockchain. **Action:** Wait for submission; if it remains here, retry or check connectivity, or contact support with the in-app form or in [discord](https://discord.gg/chia).
+
+### Recovery SUBMITTED
+
+The recovery transaction has been submitted to the blockchain and is awaiting confirmation or further processing. **Action:** Wait for block inclusion; see [Transaction MEMPOOL](#transaction-mempool) if you need general context on mempool behavior.
+
+### Recovery TIMELOCK
+
+The recovery has been processed by blockchain sync: your vault is in the recovery timelock period described under [Recovery timer](#recovery-timer) and [Recovery clawback](#recovery-clawback). **Action:** Monitor the timer; you can cancel the recovery with the spend key during this window if appropriate, or wait until the timelock completes.
+
+### Recovery TIMELOCK_COMPLETE
+
+The recovery timelock has completed according to chain state. You may [claw back](#clawback) the recovery attempt or finish the recovery, depending on your situation. **Action:** Follow the Cloud Wallet prompts to either complete recovery or cancel it.
+
+### Recovery FINISH_SIGNED
+
+The transaction to finish recovery has been signed but not yet submitted. **Action:** Wait for broadcast or complete any remaining submit step.
+
+### Recovery FINISH_SUBMITTED
+
+The finish-recovery transaction has been submitted to the blockchain. **Action:** Wait for confirmation before assuming recovery is complete.
+
+### Recovery CLAWBACK_SIGNED
+
+The transaction to claw back the recovery attempt has been signed but not yet submitted. **Action:** Wait for broadcast or complete any remaining submit step.
+
+### Recovery CLAWBACK_SUBMITTED
+
+The clawback transaction has been submitted to the blockchain. **Action:** Wait for confirmation and verify vault status in the vault.
+
+## Wallet state
+
+These labels describe high-level vault status. They overlap with [Vault recovery states](#vault-recovery-states) when a recovery is in progress.
+
+### Wallet READY
+
+The wallet is available for transfers and normal operations.
+
+### Wallet VAULT_PENDING_CREATE
+
+The vault singleton has been minted and is in the mempool; the vault is not fully ready until creation confirms.
+
+### Wallet VAULT_RECOVERY_TIMELOCK
+
+The vault is in a recovery flow and the recovery timelock is active. You may be able to claw back the recovery or, after the timelock has passed, complete recovery; see **Recovery TIMELOCK** under [Vault recovery states](#vault-recovery-states).
+
+### Wallet VAULT_RECOVERY_TIMELOCK_COMPLETE
+
+The vault’s recovery timelock has completed on chain. You can claw back the recovery attempt or finish recovery. **Action:** Follow in-app steps; see **Recovery TIMELOCK_COMPLETE** under [Vault recovery states](#vault-recovery-states).