_Docs/
Get StartedModulesPlatformDeployCookbookChangelogReference
_Stack
_Modules
  • Ledger
  • Numscript
  • Connectivity
  • WalletsEE
    • Prerequisites
    • Basic wallet operations
    • Managing holds
    • Creating Wallets
    • Adding funds
    • Spending funds
    • Holding and confirm
  • FlowsEE
  • ReconciliationEE
  1. Modules
  2. Wallets
  3. Creating Wallets
Wallets

Creating Wallets

Create a wallet using the API. The response returns a blank wallet object you can store the reference of in your system.

fctl wallets create my-wallet
POST/api/wallets/wallets

Response:

JSON
{
  "id": "e21494fe-dbd1-4323-8f2c-28c3bafb96d1",
  "balances": {},
  "metadata": {}
}

At this point, the wallet will start to exist on the underlying ledger, but it will not have any balances.

Choosing a Wallet Strategy#

There are multiple strategies you can adopt when creating wallets: you can choose to create a wallet for a specific user, or you can create a wallet for a specific resource in your system.

Using metadata#

Wallets carry a metadata field that can be used to store any information you want to associate with the wallet. This is useful when you want to e.g. attach a reference to a resource in your system to the wallet.

fctl wallets create user-wallet
POST/api/wallets/wallets
Managing holdsAdding funds
On This Page
  • Choosing a Wallet Strategy
  • Using metadata