Platform

Session creation

High level flow of the SDK

• Set up the WebSocket client to connect and communicate with the cloud node.
• Optional: set up a storage provider for keyshare persistence and sync. The SDK provides a default store; see Custom Storage Client to plug in your own.
• Optional: create a message signer to authenticate messages between the mobile app and the cloud node. See Message Signer.
• Start a new MPC session.
• Perform MPC actions.

The example uses the minimal setup. A custom storage provider and message signer are optional; the SDK falls back to sensible defaults, and the linked guides show how to plug in your own.

Create a new React Native project

---

Skip this section if you already have a React Native project.

Terminal

npx @react-native-community/cli@latest init SilentMPC

After the project is created, install @silencelaboratories/silent-shard-sdk using the instructions from the Installation Guide

Start a new session

---

ECDSA

App.tsx

import { CloudWebSocketClient } from '@silencelaboratories/silent-shard-sdk';
import { createEcdsaDuoSession } from '@silencelaboratories/silent-shard-sdk/ecdsa';

const CLOUD_NODE_URI = 'localhost:8080';
const cloudVerifyingKey = 'SERVER_PUBLIC_KEY_HEX';
const cloudClient = new CloudWebSocketClient(CLOUD_NODE_URI, false);

export const initSession = async () => {
  const session = await createEcdsaDuoSession({
    client: cloudClient,
    cloudVerifyingKey: cloudVerifyingKey,
  });
  console.log('Session created successfully');
  return session;
};

EdDSA

App.tsx

import { CloudWebSocketClient } from '@silencelaboratories/silent-shard-sdk';
import { createEddsaDuoSession } from '@silencelaboratories/silent-shard-sdk/eddsa';

const CLOUD_NODE_URI = 'localhost:8080';
const cloudVerifyingKey = 'SERVER_PUBLIC_KEY_HEX';
const cloudClient = new CloudWebSocketClient(CLOUD_NODE_URI, false);

export const initSession = async () => {
  const session = await createEddsaDuoSession({
    client: cloudClient,
    cloudVerifyingKey: cloudVerifyingKey,
  });
  console.log('Session created successfully');
  return session;
};

MLDSA

App.tsx

import { CloudWebSocketClient } from '@silencelaboratories/silent-shard-sdk';
import { createMldsaDuoSession } from '@silencelaboratories/silent-shard-sdk/mldsa';

const CLOUD_NODE_URI = 'localhost:8080';
const cloudVerifyingKey = 'SERVER_PUBLIC_KEY_HEX';
const cloudClient = new CloudWebSocketClient(CLOUD_NODE_URI, false);

export const initSession = async () => {
  const session = await createMldsaDuoSession({
    client: cloudClient,
    cloudVerifyingKey: cloudVerifyingKey,
  });
  console.log('Session created successfully');
  return session;
};```

• CloudWebSocketClient: is a class that handles the WebSocket communication with the cloud node.

• IStorageProvider: is a class manager for storing and retrieving MPC keyshares through a standardized interface.

• MessageSigner: is a class that handles the signing of messages for secure communication between mobile and cloud node.

• EcdsaSession: is the class that facilitates all actions for ECDSA wallets.

• SessionConfig: is a configuration object that contains the necessary information for the session.

• CLOUD_NODE_URI is the URI of the cloud node.

• cloudVerifyingKey is the Hex encoded cloud verifying key (Ed25519 public key).

  • This public key is used to verify the server's signature on each message
  • See example here

The session is now ready to run MPC operations such as keygen and sign.