# Wallet Management

The **new Vult Wallet UI** introduces enhanced wallet management, split key functionality, and improved user control over wallet sharing and security.&#x20;

This documentation provides a detailed overview of the **new wallet UI**, including **Vault integration,  keys, sharing options, and permission management**.

### **1. Wallet Overview & Vault Integration**

**Vault** is a **Key Management Service** that securely manages private keys by utilizing a **key mechanism**. It enhances security and enables **safe key sharing**.

* **Key Storage**: One key is stored in **Vault**, the other remains on the user's device.
* **Transaction Signing**: Transactions require **both keys** for authorization.
* **Secure Sharing**: Users can create multiple split keys for flexible sharing, which can be revoked at any time.
* **Unlimited Split Keys**: The same wallet can have multiple split keys with different permissions.

By default, the system does **not store wallets in Vault**. To enable Vault-based key management, you must **store your wallet** in Vault. Here are the steps to store Wallet in Vault:

1. Open your Personal Wallet and click on **Store Room in Vault**.

<figure><img src="/files/XdFm4GblL9v3c0dh1zNX" alt="" width="375"><figcaption><p>Fig 1: Store Room in Vault</p></figcaption></figure>

2. Once stored, you will see the Room Keys activated, allowing you to create and manage split keys.

<figure><img src="/files/lLUpCPIzj6nnXDT9dhiY" alt="" width="375"><figcaption><p>Fig2: Room Keys Available</p></figcaption></figure>

{% hint style="info" %}
**Important:** If your wallet is not stored in Vault, you cannot create split keys.
{% endhint %}

### **2. Creating and Managing  Keys**

**Room Keys** are additional keys derived from the **same wallet** but with different access permissions. The new UI allows users to create and manage these keys directly. Here is how you can create a new split key:

1. Click on **New Split Key by clicking** on **New Key in** wallet interface.

<figure><img src="/files/laIQQS2LZDYOzsQtt37r" alt=""><figcaption></figcaption></figure>

2. The key is generated and appears under the **"Your Keys"** section. Each key has a **public key** that can be copied or shared.

<figure><img src="/files/HliUGHrnHhWaG2t3Xsia" alt="" width="375"><figcaption><p>Fig4: Other Split Keys</p></figcaption></figure>

Each split key offers the following actions:

* **Public Key (Copy)**: Retrieve the public key for the split key.
* **Share**: Share the split key with another user.
* **Activate**: Set the selected split key as the primary active key.
* **Manage**: Modify **restrictions and permissions** for the key.

{% hint style="info" %}
A primary split key is a split key that cannot be shared. If you need to share, you should create additional split keys.
{% endhint %}

### **3. Managing Split Key Permissions**

To manage Split Key Permissions:

1. Click **Manage** on a split key.

<figure><img src="/files/AhzPoRAy3kmywVdCgm96" alt="" width="375"><figcaption></figcaption></figure>

2. The split key details dialog opens, where you can **only revoke** the key. If you want to change permissions, you must **revoke the current split key** and **create a new one** with the desired permissions.

<figure><img src="/files/Zi9Rdthy94VvSIOjeSqW" alt="" width="375"><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="322"></th><th></th></tr></thead><tbody><tr><td><strong>Property</strong></td><td><strong>Description</strong></td></tr><tr><td><strong>Allow All</strong></td><td>Grants unrestricted access to the wallet and its operations.</td></tr><tr><td><strong>Token Transfers</strong></td><td>Enables or restricts the ability to perform token transfer operations.</td></tr><tr><td><strong>Allocation File Operations</strong></td><td>Allows or disables file-related actions such as uploading, downloading, and deleting files within an allocation.</td></tr><tr><td><strong>Allocation Storage Operations</strong></td><td>Permits management of storage-related actions like increasing or extending storage allocations.</td></tr><tr><td><strong>Allocation Token Operations</strong></td><td>Enables the use of tokens for allocation-related tasks, such as payments for storage or upgrades.</td></tr><tr><td><strong>Storage Rewards</strong></td><td>Controls access to managing rewards for storage providers or blobbers.</td></tr><tr><td><strong>Storage Operations</strong></td><td>Enables general operations related to storage, such as viewing or modifying storage configurations.</td></tr><tr><td><strong>Storage Management</strong></td><td>Allows administrative tasks related to storage, including managing providers, locations, and settings.</td></tr><tr><td><strong>Miner Operations</strong></td><td>Grants access to operational actions for miners within the network, such as updating configurations.</td></tr><tr><td><strong>Miner Management Operations</strong></td><td>Allows users to manage miner-specific tasks, including assigning roles, monitoring performance, or managing settings.</td></tr><tr><td><strong>Miner Financial Operations</strong></td><td>Enables financial activities for miners, such as handling fees, rewards, or other monetary-related tasks.</td></tr><tr><td><strong>Token Bridging</strong></td><td>Allows or restricts the ability to bridge tokens across different blockchain networks.</td></tr><tr><td><strong>Authorizer Management Operations</strong></td><td>Enables management tasks for authorizers, such as adding, removing, or updating authorizer roles.</td></tr><tr><td><strong>Authorizer Operations</strong></td><td>Grants access to general operations involving authorizers, such as handling authentication or verification tasks.</td></tr></tbody></table>

### **4. Sharing a Split Key**

The new UI allows **controlled sharing of keys** with other users by defining permissions before granting access. Here is how you can share a split key:

1. Select the **key** you want to share and click **Share**.

<figure><img src="/files/Sert8S1Pn7BFvqH5d8yZ" alt="" width="563"><figcaption></figcaption></figure>

2. Choose **restrictions** to apply and enter the **username** of the recipient and click **Share**.

<figure><img src="/files/YMEzj0c5Jg0R4M4hdCDv" alt="" width="563"><figcaption><p>Fig8: Manage Restrictions</p></figcaption></figure>

{% hint style="danger" %}
If you want to revoke access, you must delete the shared split key and create a **new one** with updated restrictions.
{% endhint %}

### **5. Wallet Structure & Activation**

Every account starts with a default personal wallet. Inside this wallet, a Primary Split Key is automatically created. Primary Split Keys cannot be shared, as they are tied to the active wallet.

If you create a new wallet, it becomes your active wallet. Each wallet has its own Primary Split Key. You can create additional split keys under each wallet for sharing with specific permissions.

#### To activate your split key, go to **Other Split Keys**. Click **Activate** on the desired split key.

<figure><img src="/files/tiaGhugwwqBZ9xkEcRFi" alt="" width="563"><figcaption></figcaption></figure>

This key now becomes the **Primary Split Key**, and previous split keys will be deactivated.

### 6. Accessing Shared Wallet

When **User A** shares a split key with **User B**, the shared wallet becomes visible in both users’ interfaces:

**For User A: Managing Shared Keys**

User A can view and manage all split keys they have shared by:

<figure><img src="/files/d8IReKnxZtnLDDNhHhFQ" alt="" width="375"><figcaption></figcaption></figure>

1. Navigating to their active wallet view. Switching to the **"Shared Keys"** tab. Here, each entry represents a wallet that has been shared.
2. For each shared key, User A can view:
   * The recipient’s wallet public key.
   * The shared key reference.
   * An option to **Manage** the key (e.g., revoke, update permissions).

This allows User A to monitor and control who has access to shared wallets at any time.

**For User B: Accessing the Shared Wallet**

Once the split key is received, User B can access the wallet as follows:

<figure><img src="/files/YIGM4CYQP1ucxPxuKyqd" alt="" width="563"><figcaption></figcaption></figure>

1. Open the **wallet dashboard** in their account. Scroll down to the **"Shared Room"** section.
2. Identify the shared wallet by matching the wallet address or public key (as provided by User A).
3. Click **“Make Active”** to activate the shared wallet.

Once activated, the shared wallet becomes the default active wallet for User B, enabling them to perform operations within the granted permissions.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zus.network/zus-docs/webapps/vult/wallet-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
