Wallet Management
Last updated
Last updated
The new Vult Wallet UI introduces enhanced wallet management, split key functionality, and improved user control over wallet sharing and security.
This documentation provides a detailed overview of the new wallet UI, including Vault integration, split keys, sharing options, and permission management.
Vault is a Key Management Service that securely manages private keys by utilizing a split-key mechanism. It enhances security and enables safe key sharing.
Split-Key Storage: One key is stored in Vault, the other remains on the user's device.
Transaction Signing: Transactions require both split 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:
Open your Personal Wallet and click on Store Wallet in Vault.
Once stored, you will see the Vault section activated, allowing you to create and manage split keys.
Split 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:
Click on New Split Key by clicking on New Split Key in wallet interface.
The split key is generated and appears under the "Other Split Keys" section. Each split key has a public key that can be copied or shared.
Each split key offers the following actions:
Copy Public Key: Retrieve the public key for the split key.
Activate: Set the selected split key as the primary active key.
Manage: Modify restrictions and permissions for the key.
Share: Share the split key with another user.
To manage Split Key Permissions:
Click Manage on a split key.
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.
Property
Description
Allow All
Grants unrestricted access to the wallet and its operations.
Token Transfers
Enables or restricts the ability to perform token transfer operations.
Allocation File Operations
Allows or disables file-related actions such as uploading, downloading, and deleting files within an allocation.
Allocation Storage Operations
Permits management of storage-related actions like increasing or extending storage allocations.
Allocation Token Operations
Enables the use of tokens for allocation-related tasks, such as payments for storage or upgrades.
Storage Rewards
Controls access to managing rewards for storage providers or blobbers.
Storage Operations
Enables general operations related to storage, such as viewing or modifying storage configurations.
Storage Management
Allows administrative tasks related to storage, including managing providers, locations, and settings.
Miner Operations
Grants access to operational actions for miners within the network, such as updating configurations.
Miner Management Operations
Allows users to manage miner-specific tasks, including assigning roles, monitoring performance, or managing settings.
Miner Financial Operations
Enables financial activities for miners, such as handling fees, rewards, or other monetary-related tasks.
Token Bridging
Allows or restricts the ability to bridge tokens across different blockchain networks.
Authorizer Management Operations
Enables management tasks for authorizers, such as adding, removing, or updating authorizer roles.
Authorizer Operations
Grants access to general operations involving authorizers, such as handling authentication or verification tasks.
The new UI allows controlled sharing of split keys with other users by defining permissions before granting access. Here is how you can share a split key:
Select the split key you want to share and click Share.
Choose restrictions to apply and enter the username of the recipient and click Share.
If you want to revoke access, you must delete the shared split key and create a new one with updated restrictions.
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.
This key now becomes the Primary Split Key, and previous split keys will be deactivated.
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:
Navigating to their active wallet view. Switching to the "Shared Keys" tab. Here, each entry represents a wallet that has been shared.
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:
Open the wallet dashboard in their account. Scroll down to the "Shared Wallets" section.
Identify the shared wallet by matching the wallet address or public key (as provided by User A).
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.
