This API is a request to create a new v2 deposit wallet or withdrawal wallet for your organisation. A v2 wallet supports Liminal Firewall, making it ideal for a new organisations. You can also create multiple hot wallets (one wallet per API call) for EVM and UTXO chains. See Liminal supported chains for more information.
Important
- Ensure to either provide the key pair
"walletVersion":"2"in the API request body or don't provide this key pair at all, to create a v2 wallet.- If you are a new organisation looking to create a v2 wallet, contact Liminal support at support@lmnl.app for assistance.
- If you are an existing organisation with v1 wallets that were created on or before July 4, 2024, and wish to create v2 wallets, make sure to inform Liminal first. Additionally, existing organisations will require to update Liminal Express and use the latest Docker image.
To learn more about v1 and v2 wallets as well as which chains are supported by v2 wallets, see Wallet v1 and v2. To learn more about Liminal Firewall, see Liminal Firewall.
Note
- Liminal automatically generates the exact list of addresses for all EVM chain deposit wallets (like Avalanche, Polygon). These addresses are derived from the Ethereum wallet seed phrase, using a derivation path. For example, if your first Ethereum wallet has addresses—
- Address 1:
0xf0748C52EDC23135d9845CDFB91279Cf61ee14b4,- Address 2:
0x1860F505E73c1d3C36685AfB1a1F986591d7aB9d,
then the exact Address 1 and Address 2 are also generated for other EVM wallets you create afterward. This way, you can assign a single deposit address to each customer across all EVM wallets.If you want certain EVM chain wallets to have the same set of addresses as your first Ethereum wallet, ensure to create those wallets before creating the second Ethereum wallet. Otherwise, the addresses of the second Ethereum wallet will be replicated in the EVM chain wallets. To learn about derivation paths, see Derivation path strategy .