Create Wallet Set

A Wallet Set is a logical container for grouping wallets within your organization. This guide explains what they represent and how to create them for both Trustless and Standard MPC security models.

What is a Wallet Set?

In the Planbok MPC ecosystem, a Wallet Set serves as a high-level grouping mechanism. For organizations managing multiple projects, departments, or end-users, Wallet Sets provide a clean way to segregate assets.

Technical Representation

Technically, each Wallet Set maps to a unique account index in the BIP-44 Hierarchical Deterministic (HD) derivation path:

m/44'/coin_type'/wallet_set_index'/0/address_index

• Wallet Set Index: Automatically incremented for each new set created in your organization.
• Address Index: Incremented for each individual wallet (e.g., Ethereum, Solana, NEAR) derived within that set.

By creating a new Wallet Set, you are essentially opening a new "account" from which an infinite number of multi-chain addresses can be derived.

Quickstart: Creating a Wallet Set

1. Standard MPC Flow

In Standard MPC, your organization's entropy is already partially managed by the nodes. You do not need to provide an encrypted secret for this operation.

Endpoint: POST /v2/wallet-sets
Headers:

• PLANBOK-X-API-KEY: <your_api_key>

Request Body:

Code
{
  "idempotencyKey": "<unique_uuid_v4>",
  "name": "Project Alpha Wallets"
}

2. Trustless MPC Flow

In Trustless MPC, the nodes require your real-time entropy to perform the derivation math. You must provide an encryptedOrganizationSecret with the sign context.

Step 1: Generate the Encrypted Secret Use the encryption script with the sign context:

Code
node generate-encrypted-organization-secret.js sign

Step 2: Create the Wallet Set Endpoint: POST /v2/wallet-sets
Headers:

• PLANBOK-X-API-KEY: <your_api_key>

Request Body:

Code
{
  "idempotencyKey": "<unique_uuid_v4>",
  "name": "Project Beta Wallets",
  "encryptedOrganizationSecret": "BASE64_ENCRYPTED_DATA_HERE"
}

Why Use Multiple Wallet Sets?

• Departmental Isolation: Separate "Marketing" wallets from "Operations" wallets.
• Client Custody: If you are building a B2B2C app, you can create a unique Wallet Set for each of your corporate clients.
• Security Scoping: Limit API key permissions to specific Wallet Sets (coming soon).

Next Steps

Once your Wallet Set is created, you can begin deriving individual wallets for any of our supported blockchains.