@silencelaboratories/walletprovider-sdk 1.3.0 → 1.4.0

package/dist/utils/encoder.d.ts

@@ -0,0 +1,7 @@
+export declare const arrayBufferToBase64Url: (a: ArrayBuffer) => string;
+/**
+ *
+ * @param serialized MUST be in canonicalized JSON format
+ * @returns
+ */
+export declare const calculateFinalChallenge: (serialized: string) => string;

package/dist/utils/validator.d.ts

@@ -0,0 +1,7 @@
+import { EphKeySignAlgorithm } from '../auth/ephemeralAuthentication';
+import { MPCSignAlgorithm } from '../client/networkSigner';
+export declare const throwIfInvalidString: (key: string, value: string) => void;
+export declare const throwIfInvalidEphPK: (ephKey: Uint8Array, signAlg: EphKeySignAlgorithm) => void;
+export declare const throwIfInvalidEphSK: (ephKey: Uint8Array, signAlg: EphKeySignAlgorithm) => void;
+export declare const throwIfInvalidMPCSignAlg: (signAlg: MPCSignAlgorithm) => void;
+export declare const throwIf: (condition: boolean, message: string) => void;

package/dist/viemSigner.d.ts

@@ -1,15 +1,24 @@
 import { LocalAccount } from 'viem/accounts';
-import { NetworkSigner } from './networkSigner';
+import { MPCSignAlgorithm, NetworkSigner } from './client/networkSigner';
 import { Address } from 'viem';
+/**
+ * Options for creating a distributed signing request for signing transactions using Silent Network.
+ * @public
+ */
+export interface DSGOpts {
+    threshold: number;
+    keyId: string;
+    signAlg: MPCSignAlgorithm;
+}
 /**
  * Create a new viem custom account for signing transactions using
  * the MPC network.
- * @param clusterConfig The network cluster configuration.
+ * @param networkSigner API to communicate with the Silent MPC Network.
  * @param keyId The selected Key ID.
  * @param publicKey Associated public key of the selected Key ID.
- * @param threshold The threshold.
+ * @param signAlg The signature algorithm for signing (default: secp256k1).
  */
-export declare function createViemAccount(networkSigner: NetworkSigner, keyId: string, publicKey: string): LocalAccount;
+export declare function createViemAccount(networkSigner: NetworkSigner, publicKey: string, dsgOpts: DSGOpts): LocalAccount;
 /** Computes ETH address from ECDSA `publicKey` returned by Silent Network
  * @public
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@silencelaboratories/walletprovider-sdk",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "author": "Silence Laboratories",
   "description": "Frontend SDK for Wallet Providers",
   "main": "./dist/index.cjs.js",
@@ -16,12 +16,13 @@
   "files": [
     "dist"
   ],
+  "type": "module",
   "scripts": {
     "format": "prettier --write --cache .",
     "formatcheck": "prettier --check --cache .",
     "lint": "eslint --cache ./src/**/*.ts",
     "typecheck": "tsc -p . --noEmit",
-    "test": "vitest",
+    "test": "vitest run",
     "build": "node build.js && npm run build:declaration",
     "build:declaration": "tsc -p . --emitDeclarationOnly",
     "clean": "rimraf dist",
@@ -29,6 +30,7 @@
     "docs": "npm run build:declaration && api-extractor run --local --verbose && api-documenter  markdown -i ./temp -o ./docs"
   },
   "devDependencies": {
+    "@commitlint/config-conventional": "^12.1.1",
     "@eslint/js": "9.14.0",
     "@microsoft/api-documenter": "^7.25.2",
     "@microsoft/api-extractor": "^7.46.2",
@@ -43,11 +45,12 @@
     "rimraf": "^6.0.1",
     "typescript": "5.6.3",
     "typescript-eslint": "8.13.0",
-    "vitest": "^2.1.5"
+    "vitest": "^2.1.8"
   },
   "dependencies": {
     "@noble/curves": "^1.6.0",
     "js-base64": "^3.7.7",
+    "json-canonicalize": "^1.0.6",
     "viem": "2.21.54"
   }
 }

package/dist/encoding.d.ts

@@ -1,4 +0,0 @@
-export declare const decodeBase64: (b64: string) => Uint8Array;
-export declare const encodeBase64: (b: Uint8Array) => string;
-export declare const arrayBufferToBase64Url: (a: ArrayBuffer) => string;
-export declare const calculateFinalChallenge: (setupOpts: string) => string;

package/dist/ephemeralAuthentication.d.ts

@@ -1,44 +0,0 @@
-import { UserAuthentication } from './authentication';
-import { SignSetupOpts } from './setupMessage';
-/**
- * Supported signature algorithms for ephemeral key
- * @alpha
- */
-export type SignAlgorithm = 'ed25519' | 'secp256k1';
-/** The `EphKeyClaim` object represents the public claim of the ephemeral key.
- * @alpha
- */
-export declare class EphKeyClaim {
-    ephId: string;
-    ephPK: string;
-    signAlg: SignAlgorithm;
-    expiry: number;
-    /**
-     *
-     * @param ephId - Ephemeral key ID
-     * @param ephPK - Ephemeral public key
-     * @param signAlg - Signature algorithm.
-     * @param lifetime - Lifetime of the ephemeral key. Default is 1 hour
-     */
-    constructor(ephId: string, ephPK: Uint8Array, signAlg: SignAlgorithm, lifetime?: number);
-    private validateInputs;
-    toJSON(): string;
-}
-/** Locally sign the signature requests to network without asking the user, the ephSK is registered during keygen.
- * The signature is the authorization for signgen operation
- */
-export declare function authenticateUsingEphKey({ setup, challenge, ephSK, ephClaim, }: {
-    setup: SignSetupOpts;
-    challenge: string;
-    ephSK: Uint8Array;
-    ephClaim: EphKeyClaim;
-}): Promise<UserAuthentication>;
-export declare function genHexSignature(msg: Uint8Array, ephSK: Uint8Array, signAlg: SignAlgorithm): Promise<string>;
-/** Generate Ephemeral `privateKey`
- * @public
- */
-export declare function generateEphPrivateKey(algSign: SignAlgorithm): Uint8Array;
-/** Derive Ephemeral `publicKey` from `privateKey` returned from `generateEphPrivateKey`
- * @public
- */
-export declare function getEphPublicKey(ephSK: Uint8Array, algSign: SignAlgorithm): Uint8Array;

package/dist/validator.d.ts

@@ -1,6 +0,0 @@
-import { SignAlgorithm } from './ephemeralAuthentication';
-export declare const throwIfInvalidString: (key: string, value: string) => void;
-export declare const throwIfInvalidEphPK: (ephKey: Uint8Array, signAlg: SignAlgorithm) => void;
-export declare const throwIfInvalidEphSK: (ephKey: Uint8Array, signAlg: SignAlgorithm) => void;
-export declare const throwIfInvalidSignAlg: (signAlg: SignAlgorithm) => void;
-export declare const throwIf: (condition: boolean, message: string) => void;

package/dist/walletProviderServiceClient.d.ts

@@ -1,43 +0,0 @@
-import { AuthModule, DkgAuthModule } from './authentication';
-import { type KeygenResponse, type SignResponse, type OperationStatusResponse, type RegisterPasskeyResponse } from './networkSigner';
-import { MetadataSetupOpts, KeygenSetupOpts, SignSetupOpts } from './setupMessage';
-import { ApiVersion, type ClientConfig, IWalletProviderServiceClient, QueryPath } from './walletProviderServiceClientInterface';
-/**
- * The Websocket client to the Wallet Provider backend service.
- * All requests are relayed by this entity to the MPC network.
- * @alpha
- */
-export declare class WalletProviderServiceClient implements IWalletProviderServiceClient {
-    walletProviderId: string;
-    walletProviderUrl: string;
-    apiVersion: ApiVersion;
-    /**
-     * Create new client that connects to the backend service
-     * @param config - config containing information about backend service
-     */
-    constructor(config: ClientConfig);
-    getVersion(): ApiVersion;
-    getWalletId(): string;
-    startKeygen({ setup, authModule, }: {
-        setup: KeygenSetupOpts;
-        authModule: DkgAuthModule;
-    }): Promise<KeygenResponse>;
-    startSigngen({ setup, authModule }: {
-        setup: SignSetupOpts;
-        authModule: AuthModule;
-    }): Promise<SignResponse>;
-    addEphemeralKey({ setup, authModule, }: {
-        setup: MetadataSetupOpts;
-        authModule: DkgAuthModule;
-    }): Promise<OperationStatusResponse>;
-    revokeEphemeralKey({ setup, authModule, }: {
-        setup: MetadataSetupOpts;
-        authModule: AuthModule;
-    }): Promise<OperationStatusResponse>;
-    registerPasskey({ setup, authModule, }: {
-        setup: MetadataSetupOpts;
-        authModule: AuthModule;
-    }): Promise<RegisterPasskeyResponse>;
-    connect(path: QueryPath, setupOpts: KeygenSetupOpts | SignSetupOpts | MetadataSetupOpts, authModule: AuthModule): Promise<string>;
-    connectV2(path: QueryPath, setupOpts: KeygenSetupOpts | SignSetupOpts | MetadataSetupOpts, authModule: AuthModule): Promise<string>;
-}

package/dist/walletProviderServiceClientInterface.d.ts

@@ -1,59 +0,0 @@
-import { AuthModule, UserAuthentication } from './authentication';
-import { KeygenResponse, SignResponse, OperationStatusResponse, RegisterPasskeyResponse } from './networkSigner';
-import { MetadataSetupOpts, KeygenSetupOpts, SignSetupOpts } from './setupMessage';
-/**
- * The config used to create Wallet Provider Service backend client.
- * Please refer to {@link https://shipyard.rs/silencelaboratories/crates/wallet-provider-service | example backend service}
- * implementation for requirements that the backend service must fulfill.
- * @alpha
- */
-export type ClientConfig = {
-    /**
-     * The version of the API used to connect to the service
-     */
-    apiVersion: ApiVersion;
-    /**
-     * The id of the Wallet Provider Service
-     * @alpha
-     */
-    walletProviderId: string;
-    /**
-     * The URL used to connect to the service
-     * @alpha
-     */
-    walletProviderUrl: string;
-};
-/**
- * The API version of the Wallet Provider Service
- * @public
- */
-export type ApiVersion = 'v1' | 'v2';
-export type Signer = (challenge: string) => Promise<UserAuthentication>;
-/** Interface for client of  Wallet Provider Service
- * @alpha
- */
-export interface IWalletProviderServiceClient {
-    getWalletId(): string;
-    getVersion(): ApiVersion;
-    startKeygen({ setup, authModule }: {
-        setup: KeygenSetupOpts;
-        authModule: AuthModule;
-    }): Promise<KeygenResponse>;
-    startSigngen({ setup, authModule }: {
-        setup: SignSetupOpts;
-        authModule: AuthModule;
-    }): Promise<SignResponse>;
-    addEphemeralKey({ setup, authModule, }: {
-        setup: MetadataSetupOpts;
-        authModule: AuthModule;
-    }): Promise<OperationStatusResponse>;
-    revokeEphemeralKey({ setup, authModule, }: {
-        setup: MetadataSetupOpts;
-        authModule: AuthModule;
-    }): Promise<OperationStatusResponse>;
-    registerPasskey({ setup, authModule, }: {
-        setup: MetadataSetupOpts;
-        authModule: AuthModule;
-    }): Promise<RegisterPasskeyResponse>;
-}
-export type QueryPath = 'signgen' | 'keygen' | 'addEphemeralKey' | 'revokeEphemeralKey' | 'registerPasskey';