Create Vaults

Wallets within a Fordefi workspace are termed Vaults. A vault in Fordefi has a type that corresponds to a specific chain technology (EVM, Solana/SVM, Cosmos, and others).

Each vault operates on a single chain type—an EVM vault only works with EVM chains, a Solana vault only works with Solana and SVM chains, and so on. However, within that chain type, the vault works across all compatible networks. An EVM vault can transact on Ethereum, Polygon, Arbitrum, Optimism, and any other EVM chain, while a Solana vault works on Solana mainnet and other SVM chains.

When you create a vault, you choose the chain type based on which blockchain networks you need to use. That vault will then support all chains of that type, both existing ones and new ones that get added later.

For most vault types, a vault will have a single address. The exceptions are:

• A Bitcoin vault can have multiple addresses, as is typical for Bitcoin HD wallets.
• A Cosmos vault has a unique address for each Cosmos app chain. Those addresses are all backed by the same public/private key.
• The address of A TON vault has multiple formats: Bounceable, Non-bounceable, and raw hexadecimal. Consult the TON documentation to learn more about their differences.

To create a vault, use the Create Vault API endpoint. Set the desired type and the name for the new vault. An example request:

{
    "name": "My New EVM Vault",
    "type": "evm"
}

To create a vault and add it into a vault group at creation time, pass the ID of the desired vault group. For example:

{
    "name": "My New EVM Vault",
    "type": "evm"
    "vault_group_id": "5657cc3b-14c1-43a0-967c-1d22b49d8584"
}