Update docs

[ethanfrey]

Closes #82

Let's make sure they all reflect the current implementation and design.

• Top level intro
• Use cases and diagrams
• Provider overview
• Vault
• Local Staking
• Consumer overview
• Converter + Price Oracle
• Virtual Staking + Go Module
• Review IBC (most recent, likely up to date)

Notes:

• Changed the concept of Creditor in the Vault doc, for that of Lien Holder. Though Creditor is technically correct, I found it really confusing. Lien Holder is clearer. It also better reflects the current implementation's naming and functions.

[alpe]

I have read most of this now. Provider + Vault missing.
Lot of good updates. I added some notes where more context would be helpful or some terms were not correct in context of IBC

[alpe]

IMHO max cap limits should be in place before the IBC connection. Technically not mandatory but it would be easy to miss when people see the IBC packets from the Converter

[maurolacy]

Max cap limits are in place before the IBC connection. Max cap is effectively zero until and unless governance increases it.

Update: AFAIK this is a custom query of type VirtualStakeQuery::BondStatus (See

mesh-security/packages/bindings/src/query.rs

Lines 51 to 54 in 230fe09

	pub fn bond_status(&self, contract: String) -> StdResult<BondStatusResponse> {
	let full_denom_query = VirtualStakeQuery::BondStatus { contract };
	self.querier.query(&full_denom_query.into())
	}

).
This behaviour (returning zero if no gov auth) must be properly enforced by the blockchain answering said query.