Wallets

Wallets are secure containers for managing digital assets. Fystack offers different wallet types to suit your needs, including standard wallets and MPC (Multi-Party Computation) wallets.

Wallet types

Fystack supports two distinct wallet types, each designed for specific use cases and security requirements:

Standard Wallet

Standard wallets are derived using Hierarchical Deterministic (HD) key derivation per workspace. This approach provides:

• Efficient key management: Uses a single master seed to derive multiple wallet keys
• End-user focused: Ideal for generating individual wallets for your end users
• Quick creation: Instant wallet generation with immediate success status
• Deterministic: Wallets can be recreated from the same seed if needed
• Cost-effective: Lower computational overhead for high-volume wallet creation

Best for: Consumer applications, user wallets, high-volume wallet generation

MPC Wallet

MPC (Multi-Party Computation) wallets use advanced cryptographic techniques where the private key is split into multiple shares and distributed across different Mpcium nodes:

• Enhanced security: Private key never exists in its complete form on any single node
• Distributed trust: Key shares are distributed across multiple secure nodes
• Hot wallet protection: Provides institutional-grade security for active wallets
• Threshold signatures: Requires consensus from multiple nodes to sign transactions
• Longer creation time: Key generation process takes more time due to cryptographic complexity

Best for: Hot wallets, institutional custody, high-value asset storage, exchange wallets

Choosing the right wallet type

Choose Standard wallets when you need to quickly generate wallets for individual users. Choose MPC wallets when you need maximum security for operational wallets that hold significant value or require institutional-grade protection.

Create a wallet

import { FystackSDK, Environment } from "@fystack/sdk"
  
const apiCredentials = {
  apiKey: process.env.API_KEY,
  apiSecret: process.env.API_SECRET
}

const sdk = new FystackSDK({
  credentials: apiCredentials,
  environment: Environment.Sandbox,
  logger: true
})

// Create wallet with new sweep task
await sdk.createWallet({
    name: 'MPC wallet with sweep',
    walletType: WalletType.MPC,
    walletPurpose: WalletPurpose.User,
    sweepTaskParams: {
        minTriggerValueUsd: '100.00',
        destinationWalletId: '123e4567-e89b-12d3-a456-426614174001',
        destinationType: 'internal_wallet'
    }
})

// Or attach existing sweep task
await sdk.createWallet({
    name: 'Standard wallet',
    walletType: WalletType.Standard,
    sweepTaskId: '987f6543-e21c-43b2-a654-321098765432'
})

{
  "success": true,
  "message": "success",
  "code": 0,
  "data": {
    "wallet_id": "c2b71329-34c9-45aa-89d3-ddde8b15dec5",
    "status": "pending"
  }
}

Wallet creation status

curl -X GET https://api.fystack.io/api/v1/wallets/creation-status/c2b71329-34c9-45aa-89d3-ddde8b15dec5 \
  -H "ACCESS-API-KEY: your_api_key" \
  -H "ACCESS-TIMESTAMP: 1667836889" \
  -H "ACCESS-SIGN: YourBase64EncodedSignature=="

{
  "wallet_id": "c2b71329-34c9-45aa-89d3-ddde8b15dec5",
  "status": "pending"
}

List all wallets

curl -X GET https://api.fystack.io/api/v1/wallets \
  -H "ACCESS-API-KEY: your_api_key" \
  -H "ACCESS-TIMESTAMP: 1667836889" \
  -H "ACCESS-SIGN: YourBase64EncodedSignature==" \
  -G \
  -d workspace_id=123e4567-e89b-12d3-a456-426614174000

{
  "wallets": [
    {
      "id": "7f89a112-3b8f-4eeb-9e0f-124c76bfb2e0",
      "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "MPC wallet",
      "wallet_type": "mpc",
      "status": "success",
      "created_at": "2023-01-01T12:00:00Z"
    },
    {
      "id": "8a91b223-4c9f-5ffc-0f1g-235787cfc3f1",
      "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Standard wallet",
      "wallet_type": "standard",
      "status": "success",
      "created_at": "2023-01-02T14:30:00Z"
    }
  ],
  "pagination": {
    "total": 2,
    "limit": 10,
    "offset": 0
  }
}

Get deposit address

import { FystackSDK, Environment } from "@fystack/sdk"
  
const apiCredentials = {
  apiKey: process.env.API_KEY,
  apiSecret: process.env.API_SECRET
}

const sdk = new FystackSDK({
  credentials: apiCredentials,
  environment: Environment.Sandbox,
  logger: true
})

// Get EVM deposit address
const response = await sdk.getDepositAddress(
  "c2b71329-34c9-45aa-89d3-ddde8b15dec5",
  AddressType.Evm
)

// Get Solana deposit address
const response = await sdk.getDepositAddress(
  "c2b71329-34c9-45aa-89d3-ddde8b15dec5",
  AddressType.Solana
)