Skip to main content

Session creation

High level flow of the TrioSession

  • Configure transport layer (WebSocket Client)
  • Create TrioSession
  • Perform MPC actions

TrioSession is the main object which will be used to perform all of the MPC operations supported. To create TrioSession please follow the steps below.

Step 1 : Add library to your Project​

Step 2 : Create new session​

  • Setup websocket client by using any of the below options :
    1. Providing WebsocketConfig object to use default WebsocketClient.
    2. Providing custom WebsocketClient overriding(extending) SilentShardWebsocketClient to override existing connect, read or write, etc. methods to add your own logic/configuration or additional process.
    3. Providing custom WebsocketClient (Your Custom WebsocketClient Implementation) by extending WebsocketClient
  • Create TrioSession by calling SilentShard.ECDSA.createTrioSession or SilentShard.EdDSA.createTrioSession (whichever applies).

Example​

MainActivity.kt
import com.silencelaboratories.silentshard.trio.SilentShard
import com.silencelaboratories.silentshard.trio.TrioSession
import com.silencelaboratories.silentshard.remote.websocket.WebsocketConfig

object Constants {
    const val CLOUD_NODE_URI = "192.168.1.16"
    const val PORT = "8080"
}

//Other party verifying-key/public-key
val cloudPublicKey = "---------Hex---------"

//Create websocketConfig to let SilentShard use default WebsocketClient.
val websocketConfig = SilentShard.buildWebsocketConfig {
    withBaseUrl(CLOUD_NODE_URI)
    usingPort(PORT)
    isSecureProtocol(false)
    //if applies
    withAuthenticationToken("")
}

//Create trioSession

/*Option: 1 : Using Default WebsocketClient.
We only have to pass websocketConfig which contains the server config and 
communication will be handled by internal websocketClient*/
val trioSession: TrioSession = SilentShard.ECDSA.createTrioSession(
    cloudPublicKey, websocketConfig
)

/*Option: 2 : Using Customised SilentShardWebsocketClient.
ExtendedSilentShardWebsocketClient(example name and You implement) extends SilentShardWebsocketClient(Internally extends WebsocketClient)
from SilentShard. You can 
override connect, read, write, etc. according to your configuration.*/
val trioSession: TrioSession = SilentShard.ECDSA.createTrioSession(
    cloudPublicKey, ExtendedSilentShardWebsocketClient()
)

/*Option: 3 : Using Custom (Your Implementation) WebsocketClient.
CustomWebsocketClient(example name) extends WebsocketClient from SilentShard.
It will have your own httpClient and other customization. In other words, If you wish to write 
your own websocket client from scratch.*/
val trioSession: TrioSession = SilentShard.ECDSA.createTrioSession(
    cloudPublicKey, CustomWebsocketClient()
)
  • CLOUD_NODE_URI is the URI of the cloud node.
  • cloudPublicKey is the cloud verifying key (Ed25519 public key).
    • This public key is used to verify the server's signature on each message
    • This key is logged on the server on startup. See example here
  • [SilentShard] : Provides API for creating MPC TrioSession (Three-Party) using ECDSA or EdDSA algorithms.
  • [ECDSA] : Provides factory methods for creating MPC session using ECDSA algorithm.
  • [EdDSA] : Provides factory methods for creating MPC session using EdDSA algorithm.
  • [TrioSession] : Represents a three-party computation session that lets you perform MPC operations using SilentShard protocol.

You have now successfully set up the session and are ready to start performing MPC actions! 🎉