# 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="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2FgRaLTqWDwyI0P57kDLMW%2Fimage.png?alt=media&#x26;token=a913c09f-480e-4db2-aba0-5a893fba66b9" 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="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2FUwZL5Lvf5tEp34r58TDe%2Fimage.png?alt=media&#x26;token=b7794207-f41b-457e-b79a-825dd8af700b" 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="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2FhfiKOzn7TadmGGAC0YBI%2Fimage.png?alt=media&#x26;token=31df1598-d218-46e9-8b12-cf82acdd2bb5" 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="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2F0UXFjRXHV4xN6H6TtEE6%2Fimage.png?alt=media&#x26;token=9648aaf0-ef6d-4196-bb28-f955c25e69a9" 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="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2FsA1VvytpZCC6k0LpjqCU%2Fimage.png?alt=media&#x26;token=24d05589-5774-4086-ac00-a0e37a61967a" 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="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2FZs208Xo4glA43UVERv6E%2Fimage.png?alt=media&#x26;token=28ba3ed5-a767-4178-8250-06c725284c05" 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="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2F5Rxy1eAjkK9XAkzfsUfv%2Fimage.png?alt=media&#x26;token=29c53f5c-7df6-4f16-a7f9-f656d2959386" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2FX0puQ5J4fgWkZOdGeuYa%2Fimage.png?alt=media&#x26;token=8343617d-f1d5-40a2-9eb3-cb14b46f9806" 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="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2FFKtdtedLYdhatI8hzC8J%2Fimage.png?alt=media&#x26;token=e66226b7-ecd1-4a2d-8793-f0cdf71c5ae5" 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="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2FnUshSDfZeVxiYLH5gfpJ%2Fimage.png?alt=media&#x26;token=48d921dc-649b-4445-be3b-bb920e697504" 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="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2FWAjH4MWD2RpOwONusbCt%2Fimage.png?alt=media&#x26;token=fbcef45a-82cf-438a-bc93-37640e921cad" 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.
