@portal-hq/provider 4.1.1 → 4.1.3

package/lib/commonjs/providers/index.js

@@ -74,6 +74,7 @@ class Provider {
             mpcHost,
             keychain,
             version,
+            portalApi: this.portalApi,
             featureFlags,
         });
     }
@@ -187,8 +188,8 @@ class Provider {
      * @param args The arguments of the request being made
      * @returns Promise<any>
      */
-    request(_a) {
-        return __awaiter(this, arguments, void 0, function* ({ method, params, chainId, connect, }) {
+    request({ method, params, chainId, connect, }) {
+        return __awaiter(this, void 0, void 0, function* () {
             chainId = chainId !== null && chainId !== void 0 ? chainId : this.chainId;
             if (!chainId) {
                 throw new Error('[PortalProvider] No chainId provided');
@@ -320,8 +321,8 @@ class Provider {
      *
      * @param args The arguments of the request being made
      */
-    getApproval(_a) {
-        return __awaiter(this, arguments, void 0, function* ({ method, params, chainId, connect, }) {
+    getApproval({ method, params, chainId, connect, }) {
+        return __awaiter(this, void 0, void 0, function* () {
             // If autoApprove is enabled, just resolve to true
             if (this.autoApprove) {
                 return true;
@@ -386,8 +387,8 @@ class Provider {
      * @param args The arguments of the request being made
      * @returns Promise<any>
      */
-    handleGatewayRequests(_a) {
-        return __awaiter(this, arguments, void 0, function* ({ method, params, chainId, }) {
+    handleGatewayRequests({ method, params, chainId, }) {
+        return __awaiter(this, void 0, void 0, function* () {
             const gatewayUrl = this.getGatewayUrl(chainId);
             // Pass request off to the gateway
             // eslint-disable-next-line @typescript-eslint/no-unsafe-return
@@ -407,9 +408,9 @@ class Provider {
      * @param args The arguments of the request being made
      * @returns Promise<any>
      */
-    handleSigningRequests(_a) {
-        return __awaiter(this, arguments, void 0, function* ({ method, params, chainId, connect, }) {
-            var _b, _c;
+    handleSigningRequests({ method, params, chainId, connect, }) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
             const isApproved = passiveSignerMethods.includes(method)
                 ? true
                 : yield this.getApproval({ method, params, chainId, connect });
@@ -440,7 +441,7 @@ class Provider {
                 case 'sol_signAndSendTransaction':
                 case 'sol_signMessage':
                 case 'sol_signTransaction': {
-                    const result = yield ((_b = this.signer) === null || _b === void 0 ? void 0 : _b.sign({
+                    const result = yield ((_a = this.signer) === null || _a === void 0 ? void 0 : _a.sign({
                         chainId: `${namespace}:${reference}`,
                         method,
                         params,
@@ -450,7 +451,7 @@ class Provider {
                     return result;
                 }
                 case 'raw_sign': {
-                    const result = yield ((_c = this.signer) === null || _c === void 0 ? void 0 : _c.sign({
+                    const result = yield ((_b = this.signer) === null || _b === void 0 ? void 0 : _b.sign({
                         chainId: '',
                         method: '',
                         params,

package/lib/commonjs/signers/mpc.js

@@ -8,12 +8,21 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@portal-hq/core");
 const utils_1 = require("@portal-hq/utils");
 const react_native_1 = require("react-native");
+const react_native_uuid_1 = __importDefault(require("react-native-uuid"));
+var Operation;
+(function (Operation) {
+    Operation["SIGN"] = "sign";
+    Operation["RAW_SIGN"] = "raw_sign";
+})(Operation || (Operation = {}));
 class MpcSigner {
-    constructor({ keychain, mpcHost = 'mpc.portalhq.io', version = 'v6', featureFlags = {}, }) {
+    constructor({ keychain, mpcHost = 'mpc.portalhq.io', version = 'v6', portalApi, featureFlags = {}, }) {
         this.version = 'v6';
         this.buildParams = (method, txParams) => {
             let params = txParams;
@@ -44,61 +53,164 @@ class MpcSigner {
         this.mpc = react_native_1.NativeModules.PortalMobileMpc;
         this.mpcHost = mpcHost;
         this.version = version;
+        this.portalApi = portalApi;
         if (!this.mpc) {
             throw new Error(`[Portal.Provider.MpcSigner] The MPC module could not be found by the signer. This is usually an issue with React Native linking. Please verify that the 'PortalReactNative' module is properly linked to this project.`);
         }
     }
     sign(message, provider) {
         return __awaiter(this, void 0, void 0, function* () {
-            const eip155Address = yield this.keychain.getEip155Address();
-            const apiKey = provider.apiKey;
-            const { method, chainId, curve, isRaw } = message;
-            switch (method) {
-                case 'eth_requestAccounts':
-                    return [eip155Address];
-                case 'eth_accounts':
-                    return [eip155Address];
-                default:
-                    break;
-            }
-            const shares = yield this.keychain.getShares();
-            let signingShare = shares.secp256k1.share;
-            if (curve === core_1.PortalCurve.ED25519) {
-                if (!shares.ed25519) {
-                    throw new Error('[Portal.Provider.MpcSigner] The ED25519 share is missing from the keychain.');
-                }
-                signingShare = shares.ed25519.share;
-            }
-            const metadata = {
-                clientPlatform: 'REACT_NATIVE',
-                clientPlatformVersion: (0, utils_1.getClientPlatformVersion)(),
-                isMultiBackupEnabled: this.featureFlags.isMultiBackupEnabled,
-                mpcServerVersion: this.version,
-                optimized: true,
-                curve,
-                chainId,
-                isRaw,
+            // Always track metrics, but only send if feature flag is enabled
+            const shouldSendMetrics = this.featureFlags.enableSdkPerformanceMetrics === true;
+            const signStartTime = performance.now();
+            const preOperationStartTime = performance.now();
+            // Generate a traceId for this operation
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+            const traceId = react_native_uuid_1.default.v4();
+            const metrics = {
+                hasError: false,
+                operation: Operation.SIGN,
+                signingMethod: message.method,
+                traceId,
             };
-            const stringifiedMetadata = JSON.stringify(metadata);
-            let formattedParams;
-            let rpcUrl;
-            if (isRaw) {
-                formattedParams = this.buildParams(method, message.params);
-                rpcUrl = '';
+            try {
+                const eip155Address = yield this.keychain.getEip155Address();
+                const apiKey = provider.apiKey;
+                const { method, chainId, curve, isRaw } = message;
+                // Add chainId to metrics
+                if (chainId) {
+                    metrics.chainId = chainId;
+                }
+                switch (method) {
+                    case 'eth_requestAccounts':
+                        return [eip155Address];
+                    case 'eth_accounts':
+                        return [eip155Address];
+                    default:
+                        break;
+                }
+                const shares = yield this.keychain.getShares();
+                let signingShare = shares.secp256k1.share;
+                if (curve === core_1.PortalCurve.ED25519) {
+                    if (!shares.ed25519) {
+                        throw new Error('[Portal.Provider.MpcSigner] The ED25519 share is missing from the keychain.');
+                    }
+                    signingShare = shares.ed25519.share;
+                }
+                const metadata = {
+                    clientPlatform: 'REACT_NATIVE',
+                    clientPlatformVersion: (0, utils_1.getClientPlatformVersion)(),
+                    isMultiBackupEnabled: this.featureFlags.isMultiBackupEnabled,
+                    mpcServerVersion: this.version,
+                    optimized: true,
+                    curve,
+                    chainId,
+                    isRaw,
+                    reqId: traceId,
+                    connectionTracingEnabled: shouldSendMetrics,
+                };
+                const stringifiedMetadata = JSON.stringify(metadata);
+                let formattedParams;
+                let rpcUrl;
+                if (isRaw) {
+                    formattedParams = this.buildParams(method, message.params);
+                    rpcUrl = '';
+                    metrics.operation = Operation.RAW_SIGN;
+                }
+                else {
+                    formattedParams = JSON.stringify(this.buildParams(method, message.params));
+                    rpcUrl = provider.getGatewayUrl(chainId);
+                }
+                if (typeof formattedParams !== 'string') {
+                    throw new Error(`[Portal.Provider.MpcSigner] The formatted params for the signing request could not be converted to a string. The params were: ${formattedParams}`);
+                }
+                // Record pre-operation time
+                metrics.sdkPreOperationMs = performance.now() - preOperationStartTime;
+                // Measure MPC signing operation time
+                const mpcSignStartTime = performance.now();
+                const result = yield this.mpc.sign(apiKey, this.mpcHost, JSON.stringify(signingShare), message.method, formattedParams, rpcUrl, chainId, stringifiedMetadata);
+                // Post-operation processing time starts
+                const postOperationStartTime = performance.now();
+                // Record native call time
+                metrics.mpcNativeCallMs = performance.now() - mpcSignStartTime;
+                // Parse result and extract binary metrics if available
+                const parsedResponse = JSON.parse(String(result));
+                const { data, error, meta } = parsedResponse;
+                // Add binary metrics to our metrics object
+                if (meta === null || meta === void 0 ? void 0 : meta.metrics) {
+                    const binaryMetrics = meta.metrics;
+                    if (binaryMetrics.wsConnectDurationMs) {
+                        metrics.sdkBinaryWSConnectMs = binaryMetrics.wsConnectDurationMs;
+                    }
+                    if (binaryMetrics.operationDurationMs) {
+                        metrics.sdkBinaryOperationMs = binaryMetrics.operationDurationMs;
+                    }
+                    if (binaryMetrics.tlsHandshakeMs) {
+                        metrics.sdkBinaryTlsHandshakeMs = binaryMetrics.tlsHandshakeMs;
+                    }
+                    if (binaryMetrics.firstResponseMs) {
+                        metrics.sdkBinaryFirstResponseMs = binaryMetrics.firstResponseMs;
+                    }
+                    if (binaryMetrics.dnsLookupMs) {
+                        metrics.sdkBinaryDnsLookupMs = binaryMetrics.dnsLookupMs;
+                    }
+                    if (binaryMetrics.connectMs) {
+                        metrics.sdkBinaryConnectMs = binaryMetrics.connectMs;
+                    }
+                }
+                if ((error === null || error === void 0 ? void 0 : error.code) > 0) {
+                    throw new utils_1.PortalMpcError(error);
+                }
+                // Record post-operation time
+                metrics.sdkPostOperationMs = performance.now() - postOperationStartTime;
+                // Calculate total SDK signing time
+                metrics.sdkOperationMs = performance.now() - signStartTime;
+                // Only send metrics if the feature flag is enabled
+                if (shouldSendMetrics && this.portalApi) {
+                    try {
+                        yield this.sendMetrics(metrics, apiKey);
+                    }
+                    catch (err) {
+                        // No-op
+                    }
+                }
+                return data;
             }
-            else {
-                formattedParams = JSON.stringify(this.buildParams(method, message.params));
-                rpcUrl = provider.getGatewayUrl(chainId);
+            catch (error) {
+                // Calculate total time even in error case
+                metrics.sdkOperationMs = performance.now() - signStartTime;
+                // Only send metrics if the feature flag is enabled
+                if (shouldSendMetrics) {
+                    const apiKey = provider.apiKey;
+                    metrics.hasError = true;
+                    try {
+                        yield this.sendMetrics(metrics, apiKey);
+                    }
+                    catch (_a) {
+                        // No-op
+                    }
+                }
+                throw error;
             }
-            if (typeof formattedParams !== 'string') {
-                throw new Error(`[Portal.Provider.MpcSigner] The formatted params for the signing request could not be converted to a string. The params were: ${formattedParams}`);
+        });
+    }
+    // Add debug logs to sendMetrics method too
+    sendMetrics(metrics, apiKey) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                if (this.portalApi) {
+                    yield this.portalApi.post('/api/v3/clients/me/sdk/metrics', {
+                        headers: {
+                            Authorization: `Bearer ${apiKey}`,
+                            'Content-Type': 'application/json',
+                        },
+                        body: metrics,
+                    });
+                }
             }
-            const result = yield this.mpc.sign(apiKey, this.mpcHost, JSON.stringify(signingShare), message.method, formattedParams, rpcUrl, chainId, stringifiedMetadata);
-            const { data, error } = JSON.parse(String(result));
-            if (error && error.code > 0) {
-                throw new utils_1.PortalMpcError(error);
+            catch (_a) {
+                // No-op
             }
-            return data;
         });
     }
 }

package/lib/esm/providers/index.js

@@ -72,6 +72,7 @@ class Provider {
             mpcHost,
             keychain,
             version,
+            portalApi: this.portalApi,
             featureFlags,
         });
     }
@@ -185,8 +186,8 @@ class Provider {
      * @param args The arguments of the request being made
      * @returns Promise<any>
      */
-    request(_a) {
-        return __awaiter(this, arguments, void 0, function* ({ method, params, chainId, connect, }) {
+    request({ method, params, chainId, connect, }) {
+        return __awaiter(this, void 0, void 0, function* () {
             chainId = chainId !== null && chainId !== void 0 ? chainId : this.chainId;
             if (!chainId) {
                 throw new Error('[PortalProvider] No chainId provided');
@@ -318,8 +319,8 @@ class Provider {
      *
      * @param args The arguments of the request being made
      */
-    getApproval(_a) {
-        return __awaiter(this, arguments, void 0, function* ({ method, params, chainId, connect, }) {
+    getApproval({ method, params, chainId, connect, }) {
+        return __awaiter(this, void 0, void 0, function* () {
             // If autoApprove is enabled, just resolve to true
             if (this.autoApprove) {
                 return true;
@@ -384,8 +385,8 @@ class Provider {
      * @param args The arguments of the request being made
      * @returns Promise<any>
      */
-    handleGatewayRequests(_a) {
-        return __awaiter(this, arguments, void 0, function* ({ method, params, chainId, }) {
+    handleGatewayRequests({ method, params, chainId, }) {
+        return __awaiter(this, void 0, void 0, function* () {
             const gatewayUrl = this.getGatewayUrl(chainId);
             // Pass request off to the gateway
             // eslint-disable-next-line @typescript-eslint/no-unsafe-return
@@ -405,9 +406,9 @@ class Provider {
      * @param args The arguments of the request being made
      * @returns Promise<any>
      */
-    handleSigningRequests(_a) {
-        return __awaiter(this, arguments, void 0, function* ({ method, params, chainId, connect, }) {
-            var _b, _c;
+    handleSigningRequests({ method, params, chainId, connect, }) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
             const isApproved = passiveSignerMethods.includes(method)
                 ? true
                 : yield this.getApproval({ method, params, chainId, connect });
@@ -438,7 +439,7 @@ class Provider {
                 case 'sol_signAndSendTransaction':
                 case 'sol_signMessage':
                 case 'sol_signTransaction': {
-                    const result = yield ((_b = this.signer) === null || _b === void 0 ? void 0 : _b.sign({
+                    const result = yield ((_a = this.signer) === null || _a === void 0 ? void 0 : _a.sign({
                         chainId: `${namespace}:${reference}`,
                         method,
                         params,
@@ -448,7 +449,7 @@ class Provider {
                     return result;
                 }
                 case 'raw_sign': {
-                    const result = yield ((_c = this.signer) === null || _c === void 0 ? void 0 : _c.sign({
+                    const result = yield ((_b = this.signer) === null || _b === void 0 ? void 0 : _b.sign({
                         chainId: '',
                         method: '',
                         params,

package/lib/esm/signers/mpc.js

@@ -10,8 +10,14 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { PortalCurve } from '@portal-hq/core';
 import { PortalMpcError, getClientPlatformVersion, } from '@portal-hq/utils';
 import { NativeModules } from 'react-native';
+import UUID from 'react-native-uuid';
+var Operation;
+(function (Operation) {
+    Operation["SIGN"] = "sign";
+    Operation["RAW_SIGN"] = "raw_sign";
+})(Operation || (Operation = {}));
 class MpcSigner {
-    constructor({ keychain, mpcHost = 'mpc.portalhq.io', version = 'v6', featureFlags = {}, }) {
+    constructor({ keychain, mpcHost = 'mpc.portalhq.io', version = 'v6', portalApi, featureFlags = {}, }) {
         this.version = 'v6';
         this.buildParams = (method, txParams) => {
             let params = txParams;
@@ -42,61 +48,164 @@ class MpcSigner {
         this.mpc = NativeModules.PortalMobileMpc;
         this.mpcHost = mpcHost;
         this.version = version;
+        this.portalApi = portalApi;
         if (!this.mpc) {
             throw new Error(`[Portal.Provider.MpcSigner] The MPC module could not be found by the signer. This is usually an issue with React Native linking. Please verify that the 'PortalReactNative' module is properly linked to this project.`);
         }
     }
     sign(message, provider) {
         return __awaiter(this, void 0, void 0, function* () {
-            const eip155Address = yield this.keychain.getEip155Address();
-            const apiKey = provider.apiKey;
-            const { method, chainId, curve, isRaw } = message;
-            switch (method) {
-                case 'eth_requestAccounts':
-                    return [eip155Address];
-                case 'eth_accounts':
-                    return [eip155Address];
-                default:
-                    break;
-            }
-            const shares = yield this.keychain.getShares();
-            let signingShare = shares.secp256k1.share;
-            if (curve === PortalCurve.ED25519) {
-                if (!shares.ed25519) {
-                    throw new Error('[Portal.Provider.MpcSigner] The ED25519 share is missing from the keychain.');
-                }
-                signingShare = shares.ed25519.share;
-            }
-            const metadata = {
-                clientPlatform: 'REACT_NATIVE',
-                clientPlatformVersion: getClientPlatformVersion(),
-                isMultiBackupEnabled: this.featureFlags.isMultiBackupEnabled,
-                mpcServerVersion: this.version,
-                optimized: true,
-                curve,
-                chainId,
-                isRaw,
+            // Always track metrics, but only send if feature flag is enabled
+            const shouldSendMetrics = this.featureFlags.enableSdkPerformanceMetrics === true;
+            const signStartTime = performance.now();
+            const preOperationStartTime = performance.now();
+            // Generate a traceId for this operation
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+            const traceId = UUID.v4();
+            const metrics = {
+                hasError: false,
+                operation: Operation.SIGN,
+                signingMethod: message.method,
+                traceId,
             };
-            const stringifiedMetadata = JSON.stringify(metadata);
-            let formattedParams;
-            let rpcUrl;
-            if (isRaw) {
-                formattedParams = this.buildParams(method, message.params);
-                rpcUrl = '';
+            try {
+                const eip155Address = yield this.keychain.getEip155Address();
+                const apiKey = provider.apiKey;
+                const { method, chainId, curve, isRaw } = message;
+                // Add chainId to metrics
+                if (chainId) {
+                    metrics.chainId = chainId;
+                }
+                switch (method) {
+                    case 'eth_requestAccounts':
+                        return [eip155Address];
+                    case 'eth_accounts':
+                        return [eip155Address];
+                    default:
+                        break;
+                }
+                const shares = yield this.keychain.getShares();
+                let signingShare = shares.secp256k1.share;
+                if (curve === PortalCurve.ED25519) {
+                    if (!shares.ed25519) {
+                        throw new Error('[Portal.Provider.MpcSigner] The ED25519 share is missing from the keychain.');
+                    }
+                    signingShare = shares.ed25519.share;
+                }
+                const metadata = {
+                    clientPlatform: 'REACT_NATIVE',
+                    clientPlatformVersion: getClientPlatformVersion(),
+                    isMultiBackupEnabled: this.featureFlags.isMultiBackupEnabled,
+                    mpcServerVersion: this.version,
+                    optimized: true,
+                    curve,
+                    chainId,
+                    isRaw,
+                    reqId: traceId,
+                    connectionTracingEnabled: shouldSendMetrics,
+                };
+                const stringifiedMetadata = JSON.stringify(metadata);
+                let formattedParams;
+                let rpcUrl;
+                if (isRaw) {
+                    formattedParams = this.buildParams(method, message.params);
+                    rpcUrl = '';
+                    metrics.operation = Operation.RAW_SIGN;
+                }
+                else {
+                    formattedParams = JSON.stringify(this.buildParams(method, message.params));
+                    rpcUrl = provider.getGatewayUrl(chainId);
+                }
+                if (typeof formattedParams !== 'string') {
+                    throw new Error(`[Portal.Provider.MpcSigner] The formatted params for the signing request could not be converted to a string. The params were: ${formattedParams}`);
+                }
+                // Record pre-operation time
+                metrics.sdkPreOperationMs = performance.now() - preOperationStartTime;
+                // Measure MPC signing operation time
+                const mpcSignStartTime = performance.now();
+                const result = yield this.mpc.sign(apiKey, this.mpcHost, JSON.stringify(signingShare), message.method, formattedParams, rpcUrl, chainId, stringifiedMetadata);
+                // Post-operation processing time starts
+                const postOperationStartTime = performance.now();
+                // Record native call time
+                metrics.mpcNativeCallMs = performance.now() - mpcSignStartTime;
+                // Parse result and extract binary metrics if available
+                const parsedResponse = JSON.parse(String(result));
+                const { data, error, meta } = parsedResponse;
+                // Add binary metrics to our metrics object
+                if (meta === null || meta === void 0 ? void 0 : meta.metrics) {
+                    const binaryMetrics = meta.metrics;
+                    if (binaryMetrics.wsConnectDurationMs) {
+                        metrics.sdkBinaryWSConnectMs = binaryMetrics.wsConnectDurationMs;
+                    }
+                    if (binaryMetrics.operationDurationMs) {
+                        metrics.sdkBinaryOperationMs = binaryMetrics.operationDurationMs;
+                    }
+                    if (binaryMetrics.tlsHandshakeMs) {
+                        metrics.sdkBinaryTlsHandshakeMs = binaryMetrics.tlsHandshakeMs;
+                    }
+                    if (binaryMetrics.firstResponseMs) {
+                        metrics.sdkBinaryFirstResponseMs = binaryMetrics.firstResponseMs;
+                    }
+                    if (binaryMetrics.dnsLookupMs) {
+                        metrics.sdkBinaryDnsLookupMs = binaryMetrics.dnsLookupMs;
+                    }
+                    if (binaryMetrics.connectMs) {
+                        metrics.sdkBinaryConnectMs = binaryMetrics.connectMs;
+                    }
+                }
+                if ((error === null || error === void 0 ? void 0 : error.code) > 0) {
+                    throw new PortalMpcError(error);
+                }
+                // Record post-operation time
+                metrics.sdkPostOperationMs = performance.now() - postOperationStartTime;
+                // Calculate total SDK signing time
+                metrics.sdkOperationMs = performance.now() - signStartTime;
+                // Only send metrics if the feature flag is enabled
+                if (shouldSendMetrics && this.portalApi) {
+                    try {
+                        yield this.sendMetrics(metrics, apiKey);
+                    }
+                    catch (err) {
+                        // No-op
+                    }
+                }
+                return data;
             }
-            else {
-                formattedParams = JSON.stringify(this.buildParams(method, message.params));
-                rpcUrl = provider.getGatewayUrl(chainId);
+            catch (error) {
+                // Calculate total time even in error case
+                metrics.sdkOperationMs = performance.now() - signStartTime;
+                // Only send metrics if the feature flag is enabled
+                if (shouldSendMetrics) {
+                    const apiKey = provider.apiKey;
+                    metrics.hasError = true;
+                    try {
+                        yield this.sendMetrics(metrics, apiKey);
+                    }
+                    catch (_a) {
+                        // No-op
+                    }
+                }
+                throw error;
             }
-            if (typeof formattedParams !== 'string') {
-                throw new Error(`[Portal.Provider.MpcSigner] The formatted params for the signing request could not be converted to a string. The params were: ${formattedParams}`);
+        });
+    }
+    // Add debug logs to sendMetrics method too
+    sendMetrics(metrics, apiKey) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                if (this.portalApi) {
+                    yield this.portalApi.post('/api/v3/clients/me/sdk/metrics', {
+                        headers: {
+                            Authorization: `Bearer ${apiKey}`,
+                            'Content-Type': 'application/json',
+                        },
+                        body: metrics,
+                    });
+                }
             }
-            const result = yield this.mpc.sign(apiKey, this.mpcHost, JSON.stringify(signingShare), message.method, formattedParams, rpcUrl, chainId, stringifiedMetadata);
-            const { data, error } = JSON.parse(String(result));
-            if (error && error.code > 0) {
-                throw new PortalMpcError(error);
+            catch (_a) {
+                // No-op
             }
-            return data;
         });
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@portal-hq/provider",
-  "version": "4.1.1",
+  "version": "4.1.3",
   "license": "MIT",
   "main": "lib/commonjs/index",
   "module": "lib/esm/index",
@@ -19,8 +19,10 @@
     "test": "jest"
   },
   "dependencies": {
-    "@portal-hq/connect": "^4.1.1",
-    "@portal-hq/utils": "^4.1.1"
+    "@portal-hq/connect": "^4.1.3",
+    "@portal-hq/utils": "^4.1.3",
+    "@types/react-native-uuid": "^2.0.0",
+    "react-native-uuid": "^2.0.3"
   },
   "devDependencies": {
     "@babel/preset-typescript": "^7.18.6",
@@ -30,5 +32,5 @@
     "ts-jest": "^29.0.3",
     "typescript": "^4.8.4"
   },
-  "gitHead": "3c03bd4a6573b23865f655856cd0161706f3f30d"
+  "gitHead": "912b03f1152f4dbb7e017919c63bdc950ca867cf"
 }

package/src/providers/index.ts

@@ -115,6 +115,7 @@ class Provider implements IPortalProvider {
       mpcHost,
       keychain,
       version,
+      portalApi: this.portalApi,
       featureFlags,
     })
   }

package/src/signers/mpc.ts

@@ -1,6 +1,7 @@
 import { PortalCurve } from '@portal-hq/core'
 import { FeatureFlags } from '@portal-hq/core/types'
 import {
+  HttpRequester,
   IPortalProvider,
   KeychainAdapter,
   PortalMpcError,
@@ -8,6 +9,7 @@ import {
   getClientPlatformVersion,
 } from '@portal-hq/utils'
 import { NativeModules } from 'react-native'
+import UUID from 'react-native-uuid'
 
 import {
   type MpcSignerOptions,
@@ -17,17 +19,24 @@ import {
 } from '../../types'
 import Signer from './abstract'
 
+enum Operation {
+  SIGN = 'sign',
+  RAW_SIGN = 'raw_sign',
+}
+
 class MpcSigner implements Signer {
   private featureFlags: FeatureFlags
   private keychain: KeychainAdapter
   private mpc: PortalMobileMpc
-  private mpcHost: string // should we add a default here mpc.portalhq.io
+  private mpcHost: string
   private version = 'v6'
+  private portalApi?: HttpRequester
 
   constructor({
     keychain,
     mpcHost = 'mpc.portalhq.io',
     version = 'v6',
+    portalApi,
     featureFlags = {},
   }: MpcSignerOptions) {
     this.featureFlags = featureFlags
@@ -35,6 +44,7 @@ class MpcSigner implements Signer {
     this.mpc = NativeModules.PortalMobileMpc
     this.mpcHost = mpcHost
     this.version = version
+    this.portalApi = portalApi
 
     if (!this.mpc) {
       throw new Error(
@@ -47,82 +57,195 @@ class MpcSigner implements Signer {
     message: SigningRequestArguments,
     provider: IPortalProvider,
   ): Promise<any> {
-    const eip155Address = await this.keychain.getEip155Address()
+    // Always track metrics, but only send if feature flag is enabled
+    const shouldSendMetrics =
+      this.featureFlags.enableSdkPerformanceMetrics === true
+    const signStartTime = performance.now()
+    const preOperationStartTime = performance.now()
+    // Generate a traceId for this operation
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+    const traceId = (UUID as any).v4() as string
+    const metrics: Record<string, number | string | boolean> = {
+      hasError: false,
+      operation: Operation.SIGN,
+      signingMethod: message.method,
+      traceId,
+    }
+    try {
+      const eip155Address = await this.keychain.getEip155Address()
 
-    const apiKey = provider.apiKey
+      const apiKey = provider.apiKey
 
-    const { method, chainId, curve, isRaw } = message
+      const { method, chainId, curve, isRaw } = message
+      // Add chainId to metrics
+      if (chainId) {
+        metrics.chainId = chainId
+      }
 
-    switch (method) {
-      case 'eth_requestAccounts':
-        return [eip155Address]
-      case 'eth_accounts':
-        return [eip155Address]
-      default:
-        break
-    }
+      switch (method) {
+        case 'eth_requestAccounts':
+          return [eip155Address]
+        case 'eth_accounts':
+          return [eip155Address]
+        default:
+          break
+      }
+
+      const shares = await this.keychain.getShares()
 
-    const shares = await this.keychain.getShares()
+      let signingShare = shares.secp256k1.share
 
-    let signingShare = shares.secp256k1.share
+      if (curve === PortalCurve.ED25519) {
+        if (!shares.ed25519) {
+          throw new Error(
+            '[Portal.Provider.MpcSigner] The ED25519 share is missing from the keychain.',
+          )
+        }
+        signingShare = shares.ed25519.share
+      }
 
-    if (curve === PortalCurve.ED25519) {
-      if (!shares.ed25519) {
+      const metadata: PortalMobileMpcMetadata = {
+        clientPlatform: 'REACT_NATIVE',
+        clientPlatformVersion: getClientPlatformVersion(),
+        isMultiBackupEnabled: this.featureFlags.isMultiBackupEnabled,
+        mpcServerVersion: this.version,
+        optimized: true,
+        curve,
+        chainId,
+        isRaw,
+        reqId: traceId,
+        connectionTracingEnabled: shouldSendMetrics,
+      }
+
+      const stringifiedMetadata = JSON.stringify(metadata)
+
+      let formattedParams: string
+      let rpcUrl: string
+
+      if (isRaw) {
+        formattedParams = this.buildParams(method, message.params)
+        rpcUrl = ''
+        metrics.operation = Operation.RAW_SIGN
+      } else {
+        formattedParams = JSON.stringify(
+          this.buildParams(method, message.params),
+        )
+        rpcUrl = provider.getGatewayUrl(chainId)
+      }
+
+      if (typeof formattedParams !== 'string') {
         throw new Error(
-          '[Portal.Provider.MpcSigner] The ED25519 share is missing from the keychain.',
+          `[Portal.Provider.MpcSigner] The formatted params for the signing request could not be converted to a string. The params were: ${formattedParams}`,
         )
       }
-      signingShare = shares.ed25519.share
-    }
 
-    const metadata: PortalMobileMpcMetadata = {
-      clientPlatform: 'REACT_NATIVE',
-      clientPlatformVersion: getClientPlatformVersion(),
-      isMultiBackupEnabled: this.featureFlags.isMultiBackupEnabled,
-      mpcServerVersion: this.version,
-      optimized: true,
-      curve,
-      chainId,
-      isRaw,
-    }
+      // Record pre-operation time
+      metrics.sdkPreOperationMs = performance.now() - preOperationStartTime
 
-    const stringifiedMetadata = JSON.stringify(metadata)
+      // Measure MPC signing operation time
+      const mpcSignStartTime = performance.now()
 
-    let formattedParams: string
-    let rpcUrl: string
+      const result = await this.mpc.sign(
+        apiKey,
+        this.mpcHost,
+        JSON.stringify(signingShare),
+        message.method,
+        formattedParams,
+        rpcUrl,
+        chainId,
+        stringifiedMetadata,
+      )
 
-    if (isRaw) {
-      formattedParams = this.buildParams(method, message.params)
-      rpcUrl = ''
-    } else {
-      formattedParams = JSON.stringify(this.buildParams(method, message.params))
-      rpcUrl = provider.getGatewayUrl(chainId)
-    }
+      // Post-operation processing time starts
+      const postOperationStartTime = performance.now()
 
-    if (typeof formattedParams !== 'string') {
-      throw new Error(
-        `[Portal.Provider.MpcSigner] The formatted params for the signing request could not be converted to a string. The params were: ${formattedParams}`,
-      )
-    }
+      // Record native call time
+      metrics.mpcNativeCallMs = performance.now() - mpcSignStartTime
+
+      // Parse result and extract binary metrics if available
+      const parsedResponse = JSON.parse(String(result)) as SigningResponse
+      const { data, error, meta } = parsedResponse
+
+      // Add binary metrics to our metrics object
+      if (meta?.metrics) {
+        const binaryMetrics = meta.metrics
+        if (binaryMetrics.wsConnectDurationMs) {
+          metrics.sdkBinaryWSConnectMs = binaryMetrics.wsConnectDurationMs
+        }
+        if (binaryMetrics.operationDurationMs) {
+          metrics.sdkBinaryOperationMs = binaryMetrics.operationDurationMs
+        }
+        if (binaryMetrics.tlsHandshakeMs) {
+          metrics.sdkBinaryTlsHandshakeMs = binaryMetrics.tlsHandshakeMs
+        }
+        if (binaryMetrics.firstResponseMs) {
+          metrics.sdkBinaryFirstResponseMs = binaryMetrics.firstResponseMs
+        }
+        if (binaryMetrics.dnsLookupMs) {
+          metrics.sdkBinaryDnsLookupMs = binaryMetrics.dnsLookupMs
+        }
+        if (binaryMetrics.connectMs) {
+          metrics.sdkBinaryConnectMs = binaryMetrics.connectMs
+        }
+      }
+
+      if (error?.code > 0) {
+        throw new PortalMpcError(error)
+      }
 
-    const result = await this.mpc.sign(
-      apiKey,
-      this.mpcHost,
-      JSON.stringify(signingShare),
-      message.method,
-      formattedParams,
-      rpcUrl,
-      chainId,
-      stringifiedMetadata,
-    )
-
-    const { data, error } = JSON.parse(String(result)) as SigningResponse
-
-    if (error && error.code > 0) {
-      throw new PortalMpcError(error)
+      // Record post-operation time
+      metrics.sdkPostOperationMs = performance.now() - postOperationStartTime
+
+      // Calculate total SDK signing time
+      metrics.sdkOperationMs = performance.now() - signStartTime
+
+      // Only send metrics if the feature flag is enabled
+      if (shouldSendMetrics && this.portalApi) {
+        try {
+          await this.sendMetrics(metrics, apiKey)
+        } catch (err) {
+          // No-op
+        }
+      }
+
+      return data
+    } catch (error) {
+      // Calculate total time even in error case
+      metrics.sdkOperationMs = performance.now() - signStartTime
+
+      // Only send metrics if the feature flag is enabled
+      if (shouldSendMetrics) {
+        const apiKey = provider.apiKey
+        metrics.hasError = true
+        try {
+          await this.sendMetrics(metrics, apiKey)
+        } catch {
+          // No-op
+        }
+      }
+
+      throw error
     }
+  }
 
-    return data
+  // Add debug logs to sendMetrics method too
+  private async sendMetrics(
+    metrics: Record<string, number | string | boolean>,
+    apiKey: string,
+  ): Promise<void> {
+    try {
+      if (this.portalApi) {
+        await this.portalApi.post('/api/v3/clients/me/sdk/metrics', {
+          headers: {
+            Authorization: `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+          },
+          body: metrics,
+        })
+      }
+    } catch {
+      // No-op
+    }
   }
 
   private buildParams = (method: string, txParams: any) => {

package/types.d.ts

@@ -1,7 +1,10 @@
 // Types
 import PortalConnect from '@portal-hq/connect'
-import { BackupMethods } from '@portal-hq/core'
-import { KeychainAdapter, type PortalError } from '@portal-hq/utils'
+import {
+  KeychainAdapter,
+  type PortalError,
+  HttpRequester,
+} from '@portal-hq/utils'
 
 export type EventHandler = (data: any) => void
 
@@ -21,6 +24,7 @@ export interface MpcSignerOptions extends SignerOptions {
   // Optional
   isSimulator?: boolean
   mpcHost?: string
+  portalApi?: HttpRequester
   version?: string
   featureFlags?: FeatureFlags
 }
@@ -41,6 +45,8 @@ export interface PortalMobileMpcMetadata {
   mpcServerVersion: string
   optimized: true
   isRaw?: boolean
+  reqId?: string
+  connectionTracingEnabled?: boolean
 }
 
 export interface PortalMobileMpc {
@@ -120,6 +126,16 @@ export type SigningRequestParams = Eip1559 | LegacyTx
 export interface SigningResponse {
   data: string
   error: PortalError
+  meta?: {
+    metrics?: {
+      wsConnectDurationMs?: number
+      operationDurationMs?: number
+      tlsHandshakeMs?: number
+      firstResponseMs?: number
+      dnsLookupMs?: number
+      connectMs?: number
+    }
+  }
 }
 
 export interface SwitchEthereumChainParameter {