Skip to content
Torus Docs

Create Wallet Permission

In this guide, we’ll walk through how to create wallet permissions in the Torus Portal. Wallet permissions enable cold-hot wallet behavior, allowing you to delegate staking operations to more accessible accounts while keeping your primary keys securely stored offline.

Why Create Wallet Permission?

You want to maintain high security for your primary wallet while still being able to manage staking operations efficiently. Wallet permissions let you delegate staking management to hot wallets without exposing your principal funds to transfer risks.

What we will accomplish

Prerequisites

Wallet with Stake

You must have an account with existing stake that you want to delegate management for. Follow the staking guide to understand staking basics.

Hot Wallet Account

Know the address of the hot wallet account that will manage your staking operations.

Torus Balance

Ensure you have enough TORUS to cover permission creation transaction fees.

Create Wallet Permission

  1. Visit the Wallet Permissions Tab in the Torus Portal
    Click the Wallet Permission tab under Permissions in the Torus Portal.

  2. Connect your Cold Wallet
    Ensure you’re connected with the wallet account that holds the stakes you want to delegate management for.

  3. Fill the form

    # Recipient Address
    Search agents by name or address that will receive the staking permission.
    If your target is not an agent, you can enter the wallet address directly.
    

    # Stake Permissions
    - **Exclusive Delegation**: Grant exclusive access to stake operations
    (prevents delegator from using stake directly)
    - **Allow Stake Movement**: Delegate permission to unstake,
    exclusively granting it to the recipient
    

    # Duration
    - **Indefinite**: Permission remains valid indefinitely
    - **Until Block**: Permission expires at a specific block
    

    # Revocation Terms
    - **Irrevocable**: Cannot be revoked
    - **Revocable by Delegator**: Only you can revoke this permission
    - **Revocable After**: Can be revoked after a specific condition is met

  4. Submit and Sign Transaction

    Click Create Wallet Permission.
    Open SubWallet and sign the transaction.

  5. All Done
    You’ve successfully created the wallet permission.

    The receiving account can now manage your staking operations within the limits you’ve set.

What’s Next?

Now that you’ve created wallet permission, you might want to:

Connect with the community:

  • Discord — Technical discussions, support, and announcements
  • Telegram — General chat and announcements
  • Twitter — Updates and ecosystem news