Skip to content

Commit 9ad795c

Browse files
authored
fix(docs): clarify Core Vault management and ownership structure (#788)
1 parent 61ea08c commit 9ad795c

File tree

2 files changed

+53
-2
lines changed

2 files changed

+53
-2
lines changed

docs/fassets/1-overview.mdx

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -105,14 +105,25 @@ If an agent is found in violation, they enter **full liquidation**, permanently
105105
## Core Vault
106106

107107
The **Core Vault (CV)** is a specialized FAsset system component that enhances capital efficiency by allowing agents to store underlying assets without requiring additional collateral.
108-
Each asset type has its own dedicated Core Vault, which is managed by a multisig contract under formal governance oversight.
108+
Each asset type has its own dedicated Core Vault, which is managed by a multisig account on the underlying network under formal governance oversight.
109109

110110
### Key Features
111111

112112
- **Collateral Efficiency:** Agents transferring assets to the CV free up collateral, allowing them to mint additional FAssets or withdraw funds.
113113
- **Redemption Support:** The CV ensures that underlying assets are available for redemptions, reducing reliance on individual agents.
114114
- **Security & Governance:** A multisig setup controls the vault, and governance can pause in case of security concerns.
115115

116+
### Core Vault Implementation
117+
118+
On networks without smart contracts (e.g., XRP Ledger), the Core Vault is a **multisig account** managed by signers authorized by Flare governance.
119+
Movements of funds require multiple signatures and follow formal agreements, not individual agent control.
120+
121+
### Agent vs. Core Vault Ownership
122+
123+
- **Agents:** Hold and control their own underlying assets in wallets as part of collateral.
124+
- **Core Vault:** Holds pooled assets that no single agent owns; agents can request assets but cannot directly control the vault.
125+
This improves capital efficiency and liquidity for the system.
126+
116127
:::tip[What's next]
117128

118129
Learn more about the different components and processes involved in FAssets - [collateral](/fassets/collateral), [minting](/fassets/minting), [redemptions](/fassets/redemption), [liquidations](/fassets/liquidation) and [Core Vault](/fassets/core-vault).

docs/fassets/6-core-vault.mdx

Lines changed: 41 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,13 +45,53 @@ This ensures redemption liquidity and protects the system from agent insolvency.
4545

4646
### Security Design
4747

48-
Each asset type has a dedicated Core Vault, which is managed by a multisig contract under a formal agreement with Flare.
48+
Each asset type has a dedicated Core Vault, which is managed by a multisig account on the underlying network under a formal agreement with Flare.
4949
The assets stored in the CV do not belong to any specific agent and can be requested to return to the agent's collateralized security.
5050
To ensure security, governance has the authority to pause deposits and withdrawals if necessary, such as in the event of a system compromise.
5151

5252
The Core Vault operates through a predefined address on the underlying chain and is managed via a multisig setup with smart contract oversight under formal Flare contracts.
5353
Governance has the authority to pause operations in the event of a security issue.
5454

55+
## Core Vault Implementation
56+
57+
### Fund Movement on Underlying Networks
58+
59+
The Core Vault operates differently depending on the underlying network:
60+
61+
**For XRP Ledger (XRP CV):**
62+
63+
- The CV is implemented as a **multisig account** on the XRP Ledger.
64+
- Only the designated **multisig signers** can move XRP from the vault.
65+
- These signers are authorized by Flare governance and operate under formal agreements.
66+
- All outgoing transactions require multiple signatures from the authorized signers.
67+
68+
### Agent Ownership Clarification
69+
70+
There's an important distinction between agent ownership and CV ownership:
71+
72+
### Agent Ownership (Standard FAssets)
73+
74+
- Agents hold underlying assets in their own wallets.
75+
- These assets belong to the specific agent and are part of their collateral.
76+
- Agents have direct control over these assets.
77+
78+
### Core Vault Ownership
79+
80+
- Assets transferred to the CV become part of a shared pool.
81+
- These assets **do not belong to any specific agent** once in the CV.
82+
- The CV is a system-level reserve that any agent can request assets from.
83+
- This allows for better capital efficiency and system-wide liquidity.
84+
85+
### Agent Collateral Requirements
86+
87+
Agents are required to provide collateral in the form of:
88+
89+
- **Flare's native token (FLR or SGB)**
90+
- **USDC/USDT (stablecoins)**
91+
92+
When agents transfer underlying assets to the CV, they can reduce their collateral requirements while maintaining their minting capacity.
93+
The CV acts as a shared reserve that backs the system, allowing agents to operate more efficiently.
94+
5595
## Operational Workflow
5696

5797
### Transferring to Core Vault

0 commit comments

Comments
 (0)