using kread [wip]

docs/general.md

@@ -13,12 +13,70 @@ KREAd dynamic NFTs provide new ways of showcasing and interacting with digital a
 | Item      	| a collectable digital asset that can be equipped to a Character's inventory                      	| a wearable asset from the SAGES universe 	| buy on KREAd's marketplace                                	|
 
 # Using KREAd
-// TODO: write me
 
-##### Set up an Agoric wallet
-##### Connect to KREAd
+The following section contains instructions for setting up an Agoric address and using the basic features of KREAd.
+
+##### Set up Agoric wallet
+
+In order to use KREAd, you must have a working wallet in order to sign transactions on the Agoric chain. Any [Cosmos](https://cosmos.network/) wallet will work, the following section explains how to create a Keplr wallet:
+
+1. Navigate to the Keplr Wallet extension in the browser of your choosing  and follow the on-screen prompts to add the extension to your web browser.
+
+2. Open the browser extension and select Create new account.
+
+3. Copy your mnemonic seed phrase and store it somewhere safe
+
+>💡 Ensure that you store your mnemonic seed phrase somewhere safe where it cannot be lost or compromised. Your mnemonic seed phrase is the master key to your wallet; loss or compromise of your mnemonic seed phrase may result in permanent loss of your ATOM.
+
+4. Establish an account name and password, then select Next.
+
+5. Confirm your mnemonic seed phrase and select Register.
+
+##### Add Agoric network to Keplr
+Cosmos wallets are designed to sign transactions on any Cosmos network, so in order to access your Agoric account you must first select the network on the wallet interface:
+
+1. Open your Keplr wallet extension
+2. In the drop down network menu in the center, select “Agoric.”
+3. In your Agoric account, you’ll see a long string beginning with ‘agoric,’ which is your wallet address. (i.e. agoric132…f3fd)
+4. Click on the wallet address to copy it
+
+##### Provision smart wallet account
+Once you have access to your Agoric address using a wallet, you are ready to provision an Agoric smart wallet. This step is necessary in order to enable the full functionality of the Agoric smart contract platform.
+
+1. Obtain 10BLD (this provision fee is meant to mitigate potential Denial-of-Service attacks). Checkout [this section](https://docs.inter.trade/user-how-to/wallet-usage/acquiring-bld-tokens) from [Inter Protocol](https://inter.trade/)'s documentation for more information on how to obtain BLD.
+   >💡 The KREAd website can be used to get BLD using [Kado](https://www.kado.money/)'s fiat on-ramp, navigate to https://kread.app/connect-wallet and click "Buy IST/BLD" to try it
+   ![kado-on-ramp](./assets/kado-on-ramp.jpg)
+
+2. Navigate to https://kread.app/connect-wallet
+3. Hit 'Create' 
+   ![activate-wallet](./assets/provision-wallet.jpg)
+4. Approve transaction in your Keplr wallet (or your Ledger)
+5. Once your smart wallet provisions you will should see your IST balance go up to 0.25, which can be used to pay for transaction fees. The page will automatically redirect to https://kread.app/character and you will be ready to use KREAd or any other Agoric dapp.
+
 ##### Mint a Character
-##### Buy an Item
+Anyone with an Agoric address and 5IST can mint a Character by clicking the "Mint new" button from https://kread.app/character. If you don't have any characters yet the button should be visible in the center of the page, if you already have some you can get to it by clicking "My characters" in the top right of the interface, then scrolling to the bottom of the sidebar on the right:
+
+![create-new-character](./assets/mint-new.jpg)
+
+That will take you to the mint character form, follow the prompts to mint a randomly generated KREAd Character. To learn more about the mint process check out [TODO: link to mint from glossary].
+
+> 💡 Although there is no mint item functionality, when a Character is minted, 3 randomly selected items will be minted and equipped to the Character before it gets sent to your wallet.
+
+##### Buy an Item (or Character)
+Besides the mint flow, there is one other way to obtain a Character: the KREAd Marketplace. It functions as a simple p2p marketplace for KREAd Characters and Items, allowing anyone to list their asset for sale at a price of their choosing. Unlike minting, when using the marketplace you are free to browse through the available entries and decide which asset to get based on its properties and price (remember: minting gets you a random Character).
+
+1. Navigate to https://kread.app/shop/items
+   ![kread-marketplace](./assets/kread-marketplace.jpg)
+2. Browse the entries and find an Item you would like to buy (click on the item for a detailed view)
+3. Then click "Buy" from the Item card or the detailed view
+4. This will take you to the buy form where you can review the sale price and details before triggering the transaction to buy
+   ![kread-buy-form](./assets/buy-form.jpg)
+5. Once reviewed, click confirm in order to send the transaction to Keplr for signing
+6. Approve the transaction on Keplr
+7. Await confirmation
+
+Check out (TODO: link to marketplace section of glossary) for more details on KREAd's marketplace feature.
+
 ##### Equip an Item
 ##### Sell your Character