Conversion to a multi-sig user
To convert an account into a multi-sig user, the user sends a ConvertToMultiSigUser action that includes:
- The authorized users.
- The minimum number of authorized users required to sign an action, commonly called the threshold.
Required signatures and the MultiSig action
A normal action can be wrapped in a MultiSig action. The MultiSig action includes:
- The target multi-sig user.
- The authorized user who will ultimately submit the action to the blockchain.
- A list of signatures from authorized users.
Leader and nonce rules
The authorized user who submits the final MultiSig action is called the leader, or transaction lead address.
Key leader rules:
- The leader must be an authorized user, not the multi-sig account itself.
- When the multi-sig action is sent, only the leader's nonce set is validated and updated.
- The leader can be an API wallet belonging to an authorized user.
- If the leader is an API wallet, the API wallet's nonce is checked and updated.
Updating authorized users or the threshold
A multi-sig user can update its authorized users and/or threshold by sending a MultiSig action that wraps a ConvertToMultiSigUser action describing the new state.
Reverting to a normal user
A multi-sig user can be converted back to a normal user by sending a ConvertToMultiSigUser action through multi-sig. For this conversion, the set of authorized users can be set to empty.
Like what you're reading? Try it yourself — this link supports ChartedTrader at no cost to you.
Create a Hyperliquid account with a 4% fee discount on the first $25M of volume (Vaults and sub-accounts excluded). →Authorized-user limits and overlaps
The maximum allowed number of authorized users for a given multi-sig user is 10.
A user can also have overlapping roles:
- A user can be a multi-sig user and an authorized user for another multi-sig user at the same time.
- A user may be an authorized user for multiple multi-sig users.
HyperEVM and CoreWriter limitation
Converting a user to multi-sig does not remove control of the associated HyperEVM user from the original wallet. CoreWriter does not work for multi-sig users. According to the documentation, multi-sig users should not interact with HyperEVM before or after conversion.
Source
Create a Hyperliquid account with a 4% fee discount on the first $25M of volume (Vaults and sub-accounts excluded).Continue with Hyperliquid
Browse the Hyperliquid guide hub for the complete user journey.
Related: Hyperliquid API Asset IDs: Spot, Builder Perps, and Token ID Mapping