Added staking and cross-chain account docs.

DA0-DA0 · Jan 16, 2024 · 0663495 · 0663495
1 parent d7d7b87
commit 0663495
Show file tree

Hide file tree

Showing 12 changed files with 114 additions and 0 deletions.
diff --git a/docs/how-to/how-to-manage-cross-chain-tokens.md b/docs/how-to/how-to-manage-cross-chain-tokens.md
@@ -0,0 +1,71 @@
+---
+sidebar_position: 5
+---
+
+# How to manage cross-chain tokens
+
+By default, you can manage tokens on the DAO's home chain. In some cases, you
+may want to hold, spend, and stake tokens on other chains.
+
+The first step is to set up a cross-chain account on each chain you want to
+manage tokens on.
+
+## Setup
+
+[Create a proposal](/how-to/how-to-create-a-proposal) and add the `Create
+Cross-Chain Account` action from the `DAO Treasury` category.
+
+![Create proposal form](/img/features/proposals/single-choice-proposal.png)
+
+![DAO Governance category in Add an action
+modal](/img/how-to/add-action-modal-dao-governance-category.png)
+
+![Create Cross-Chain Account action in DAO Governance
+category](/img/how-to/cross-chain-action-dao-governance-category.png)
+
+![Create Cross-Chain Account
+action](/img/how-to/create-cross-chain-account-action.png)
+
+Simply select which chain you want to create an account on. You can even add
+multiple chains at once using the plus button on the right.
+
+![Multiple chains](/img/how-to/create-cross-chain-account-action-multiple.png)
+
+Once this proposal is passed and executed, the cross-chain accounts will be
+created. This may take a few minutes as chain relayers have to detect and relay
+the actions to the other chains.
+
+## Sending tokens to a cross-chain account
+
+Once you have created cross-chain accounts, they will appear in the `Treasury &
+NFTs` tab of the DAO's page.
+
+![Treasury & NFTs tab](/img/how-to/treasury-nfts-tab.png)
+
+Click on the address to the right of the chain you want to send tokens to in
+order to copy it. Just send tokens from your wallet to the corresponding address
+on the desired chain, and your DAO will receive them.
+
+## Spending cross-chain tokens
+
+Spending cross-chain tokens is as easy as spending on the DAO's home chain.
+
+Check out the [How to send tokens](/how-to/how-to-send-tokens) guide to get
+started.
+
+When you select the token you want to send, you will see a list of all tokens on
+all chains the DAO has an account on.
+
+![Spend token modal](/img/how-to/spend-tokens-modal.png)
+
+## Staking cross-chain tokens and earning rewards
+
+Earning cross-chain staking rewards is as easy as staking on the DAO's home
+chain.
+
+Check out the [How to stake tokens](/how-to/how-to-stake-tokens) guide to get
+started.
+
+You can change the token you're going to stake in the action.
+
+![Staking token picker](/img/how-to/staking-token-picker.png)
diff --git a/docs/how-to/how-to-stake-tokens.md b/docs/how-to/how-to-stake-tokens.md
@@ -0,0 +1,43 @@
+---
+sidebar_position: 4
+---
+
+# How to stake tokens
+
+You can stake tokens on the DAO's home chain and any chain that the DAO has
+created a [cross-chain account](/how-to/how-to-manage-cross-chain-tokens) on.
+
+## Steps
+
+[Create a proposal](/how-to/how-to-create-a-proposal) and add the `Manage
+Staking` action from the `DAO Treasury` category.
+
+![Create proposal form](/img/features/proposals/single-choice-proposal.png)
+
+![DAO Treasury category in Add an action
+modal](/img/how-to/add-action-modal-dao-treasury-category.png)
+
+![Manage Staking action in DAO Treasury
+category](/img/how-to/manage-staking-action-dao-treasury-category.png)
+
+![Manage Staking action](/img/how-to/manage-staking-action.png)
+
+You can choose any token native to the chains the DAO has accounts on. If you
+want to stake tokens on a chain that the DAO does not have an account on, you
+have to [create a cross-chain account](/how-to/how-to-manage-cross-chain-tokens)
+on that chain first.
+
+Once this proposal is passed and executed, the tokens will be staked.
+
+## Other staking options
+
+Aside from staking, you can also unstake, restake, claim rewards, and change the
+rewards withdrawal address.
+
+![Staking options](/img/how-to/staking-options.png)
+
+### Changing the rewards withdrawal address
+
+You can change the rewards withdrawal address to a wallet or DAO other than the
+DAO itself. This may be useful if you have a SubDAO that you want to receive
+staking rewards instead.
diff --git a/static/img/how-to/add-action-modal-dao-governance-category.png b/static/img/how-to/add-action-modal-dao-governance-category.png
diff --git a/static/img/how-to/create-cross-chain-account-action-multiple.png b/static/img/how-to/create-cross-chain-account-action-multiple.png
diff --git a/static/img/how-to/create-cross-chain-account-action.png b/static/img/how-to/create-cross-chain-account-action.png
diff --git a/static/img/how-to/cross-chain-action-dao-governance-category.png b/static/img/how-to/cross-chain-action-dao-governance-category.png
diff --git a/static/img/how-to/manage-staking-action-dao-treasury-category.png b/static/img/how-to/manage-staking-action-dao-treasury-category.png
diff --git a/static/img/how-to/manage-staking-action.png b/static/img/how-to/manage-staking-action.png
diff --git a/static/img/how-to/spend-tokens-modal.png b/static/img/how-to/spend-tokens-modal.png
diff --git a/static/img/how-to/staking-options.png b/static/img/how-to/staking-options.png
diff --git a/static/img/how-to/staking-token-picker.png b/static/img/how-to/staking-token-picker.png
diff --git a/static/img/how-to/treasury-nfts-tab.png b/static/img/how-to/treasury-nfts-tab.png