Server Wallets Overview

Spin up millions of secure, server-controlled wallets with battle-tested MPC infrastructure. Built for onchain automation, Dynamic Server Wallets let you trigger transactions, interact with contracts, and run complex flows—all without user involvement, and fully owned by your backend.

Find pricing for server wallets here.

Setup

Node.js

Reference example: GitHub example

1. Enable multiple embedded wallets per chain

   Navigate to the Dynamic Dashboard and enable multiple embedded wallets per chain.

2. Retrieve your auth token

   Navigate to the Dynamic Dashboard and create a new API token.

3. Install desired Node SDKs

   npm i @dynamic-labs-wallet/node-evm
   npm i @dynamic-labs-wallet/node-svm
   

4. Create client with authenticateApiToken

   Separate clients are needed for each chain.

   import { DynamicEvmWalletClient } from "@dynamic-labs-wallet/node-evm";
   
   export const authenticatedEvmClient = async ({
     authToken,
     environmentId,
   }: {
     authToken: string;
     environmentId: string;
   }) => {
     const client = new DynamicEvmWalletClient({
       environmentId,
       enableMPCAccelerator: true, // Optional: enables the MPC accelerator for faster MPC operations
     });
   
     await client.authenticateApiToken(authToken);
     return client;
   };
   

5. Access MPC functionality by creating a new wallet account

   import { ThresholdSignatureScheme } from '@dynamic-labs-wallet/node';
   import { authenticatedEvmClient } from '<path-to-dynamic-authenticated-client>';
   
   const AUTH_TOKEN = "your-auth-token";
   const ENVIRONMENT_ID = "your-environment-id";
   
   const evmClient = await authenticatedEvmClient({
     authToken: AUTH_TOKEN,
     environmentId: ENVIRONMENT_ID,
   });
   
   const thresholdSignatureScheme = ThresholdSignatureScheme.TWO_OF_TWO; // or TWO_OF_THREE or THREE_OF_FIVE
   const password = "your-optional-password";
   const onError = (error: Error) => {
     // handle error
     console.error(error);
   };
   
   const {
     accountAddress,
     rawPublicKey,
     publicKeyHex,
     externalServerKeyShares,
     walletId,
   } = await evmClient.createWalletAccount({
     thresholdSignatureScheme,
     password,
     onError,
     backUpToClientShareService: true, // Optional: backs up key shares to Dynamic's service (important-comment)
   });
   

   You can now use the accountAddress to sign messages, create transactions, and more. The walletId can be used to retrieve the wallet later. You can also back up your externalServerKeyShares to a secure location.

6. Example: Sign a message with the MPC wallet account

   import { authenticatedEvmClient } from '<path-to-dynamic-authenticated-client>';
   
   const AUTH_TOKEN = 'your-auth-token';
   const ENVIRONMENT_ID = 'your-environment-id';
   
   const evmClient = await authenticatedEvmClient({
     authToken: AUTH_TOKEN,
     environmentId: ENVIRONMENT_ID,
   });
   
   const message = 'Hello, world!';
   const accountAddress = '0x1234567890123456789012345678901234567890';
   const password = 'your-optional-password';
   
   const serializedSignature = await evmClient.signMessage({
     message,
     accountAddress,
     password,
   });
   

Next Steps

You can find the full SDK reference for server wallets for each chain below:

EVM

EVM Guides

SVM

SVM Guides