post https://api-sdk.lmnl.dev/api/onboarding/create-wallet
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 [email protected] 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 same set of addresses for all EVM chain deposit wallets that you create after creating your first Ethereum wallet. For example, if your first Ethereum wallet has addresses—
0xf0748C52EDC23135d9845CDFB91279Cf61ee14b4
,0x1860F505E73c1d3C36685AfB1a1F986591d7aB9d
,0x6C093E736EB2F96669C720051f3d86cF2fF1B2aD
,
then the same set of deposit wallet addresses are generated for other EVM chains you create next, like Avalanche, Fantom, Polygon, etc. Liminal uses its address path derivation to automatically generate addresses in the same format. If you want certain EVM chain wallets to have the same set of addresses as Ethereum wallet 1, ensure to create those wallets before creating Ethereum wallet 2. Otherwise, those EVM wallets will follow the format of the Ethereum wallet 2 addresses.- The address derivation path strategy in Liminal has undergone changes for deposit hot wallets. To learn more, see Derivation path strategy .