@portal-hq/provider 4.3.1 → 4.5.1

package/lib/commonjs/providers/index.js

@@ -44,7 +44,7 @@ class Provider {
     // Required
     apiKey, keychain, gatewayConfig, 
     // Optional
-    autoApprove = false, apiHost, mpcHost, enclaveMPCHost, version = 'v6', chainId = utils_1.DEFAULT_CHAIN_ID_CAIP2, featureFlags = {}, }) {
+    autoApprove = false, apiHost, mpcHost, enclaveMPCHost, version = 'v6', chainId = utils_1.DEFAULT_CHAIN_ID_CAIP2, featureFlags = {}, presignatureSource, }) {
         const finalApiHost = apiHost !== null && apiHost !== void 0 ? apiHost : utils_1.DEFAULT_HOSTS.API;
         const finalMpcHost = mpcHost !== null && mpcHost !== void 0 ? mpcHost : utils_1.DEFAULT_HOSTS.MPC;
         const finalEnclaveMPCHost = enclaveMPCHost !== null && enclaveMPCHost !== void 0 ? enclaveMPCHost : utils_1.DEFAULT_HOSTS.ENCLAVE_MPC;
@@ -81,6 +81,10 @@ class Provider {
                 version,
                 portalApi: this.portalApi,
                 featureFlags,
+                // Only pass presignatureSource when usePresignatures is enabled (same as MpcSigner).
+                presignatureSource: featureFlags.usePresignatures === true
+                    ? presignatureSource
+                    : undefined,
             });
         }
         else {
@@ -90,6 +94,10 @@ class Provider {
                 version,
                 portalApi: this.portalApi,
                 featureFlags,
+                // Only pass presignatureSource when usePresignatures is enabled; otherwise signer always uses normal sign().
+                presignatureSource: featureFlags.usePresignatures === true
+                    ? presignatureSource
+                    : undefined,
             });
         }
     }
@@ -203,7 +211,7 @@ class Provider {
      * @param args The arguments of the request being made
      * @returns Promise<any>
      */
-    request({ method, params, chainId, connect, }) {
+    request({ method, params, chainId, connect, options, }) {
         return __awaiter(this, void 0, void 0, function* () {
             chainId = chainId !== null && chainId !== void 0 ? chainId : this.chainId;
             if (!chainId) {
@@ -254,6 +262,7 @@ class Provider {
                     params,
                     chainId,
                     connect,
+                    options,
                 });
                 if (transactionHash) {
                     try {
@@ -325,7 +334,7 @@ class Provider {
                 this.dispatchConnect(chainId);
             }
             else {
-                console.error(`[PortalProvider] Invalid chainId format. Must be 'namespace:reference', but got ${chainId}`);
+                utils_1.sdkLogger.error(`[PortalProvider] Invalid chainId format. Must be 'namespace:reference', but got ${chainId}`);
             }
             return new Promise((resolve) => resolve(this));
         });
@@ -422,8 +431,8 @@ class Provider {
      * @param args The arguments of the request being made
      * @returns Promise<any>
      */
-    handleSigningRequests({ method, params, chainId, connect, }) {
-        var _a, _b;
+    handleSigningRequests({ method, params, chainId, connect, options, }) {
+        var _a, _b, _c;
         return __awaiter(this, void 0, void 0, function* () {
             const isApproved = passiveSignerMethods.includes(method)
                 ? true
@@ -432,6 +441,7 @@ class Provider {
                 this.log.info(`[PortalProvider] Request for signing method '${method}' could not be completed because it was not approved by the user.`);
                 return;
             }
+            const traceId = (_a = options === null || options === void 0 ? void 0 : options.traceId) !== null && _a !== void 0 ? _a : (0, utils_1.generateTraceId)();
             let namespace = utils_1.CHAIN_NAMESPACES.EIP155;
             let reference = chainId;
             if (typeof chainId == 'string' && chainId.includes(':')) {
@@ -458,22 +468,28 @@ class Provider {
                 case 'sol_signAndSendTransaction':
                 case 'sol_signMessage':
                 case 'sol_signTransaction': {
-                    const result = yield ((_a = this.signer) === null || _a === void 0 ? void 0 : _a.sign({
+                    const result = yield ((_b = this.signer) === null || _b === void 0 ? void 0 : _b.sign({
                         chainId: `${namespace}:${reference}`,
                         method,
                         params,
                         curve,
                         isRaw: false,
+                        sponsorGas: options === null || options === void 0 ? void 0 : options.sponsorGas,
+                        signatureApprovalMemo: options === null || options === void 0 ? void 0 : options.signatureApprovalMemo,
+                        traceId,
                     }, this));
                     return result;
                 }
                 case 'raw_sign': {
-                    const result = yield ((_b = this.signer) === null || _b === void 0 ? void 0 : _b.sign({
-                        chainId: '',
-                        method: '',
+                    const result = yield ((_c = this.signer) === null || _c === void 0 ? void 0 : _c.sign({
+                        chainId: chainId !== null && chainId !== void 0 ? chainId : '',
+                        method: 'raw_sign',
                         params,
                         curve,
                         isRaw: true,
+                        sponsorGas: options === null || options === void 0 ? void 0 : options.sponsorGas,
+                        signatureApprovalMemo: options === null || options === void 0 ? void 0 : options.signatureApprovalMemo,
+                        traceId,
                     }, this));
                     return result;
                 }

package/lib/commonjs/signers/enclave.js

@@ -8,20 +8,16 @@ 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_uuid_1 = __importDefault(require("react-native-uuid"));
 var Operation;
 (function (Operation) {
     Operation["SIGN"] = "sign";
     Operation["RAW_SIGN"] = "raw_sign";
 })(Operation || (Operation = {}));
 class EnclaveSigner {
-    constructor({ keychain, enclaveMPCHost, version = 'v6', portalApi, featureFlags = {}, }) {
+    constructor({ keychain, enclaveMPCHost, version = 'v6', portalApi, featureFlags = {}, presignatureSource, }) {
         this.version = 'v6';
         this.buildParams = (method, txParams) => {
             let params = txParams;
@@ -52,19 +48,21 @@ class EnclaveSigner {
         this.enclaveMPCHost = enclaveMPCHost !== null && enclaveMPCHost !== void 0 ? enclaveMPCHost : utils_1.DEFAULT_HOSTS.ENCLAVE_MPC;
         this.version = version;
         this.portalApi = portalApi;
+        this.presignatureSource = presignatureSource;
         this.requests = new utils_1.HttpRequester({
             baseUrl: `https://${this.enclaveMPCHost}`,
         });
     }
     sign(message, provider) {
+        var _a;
         return __awaiter(this, void 0, void 0, function* () {
             // 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-member-access, @typescript-eslint/no-unsafe-call
-            const traceId = react_native_uuid_1.default.v4();
+            // Use traceId from message if available (e.g. options.traceId), otherwise generate a new UUID
+            const traceId = (_a = message.traceId) !== null && _a !== void 0 ? _a : (0, utils_1.generateTraceId)();
+            utils_1.sdkLogger.info(`[Portal MPC] enclave sign started | method=${message.method} | traceId=${traceId} | chainId=${message.chainId} | curve=${message.curve}`);
             const metrics = {
                 hasError: false,
                 operation: Operation.SIGN,
@@ -119,6 +117,21 @@ class EnclaveSigner {
                     reqId: traceId,
                     connectionTracingEnabled: shouldSendMetrics,
                 };
+                // Presignature path (SECP256K1 only): try consume before building params; fallback to normal sign.
+                if (curve === core_1.PortalCurve.SECP256K1 &&
+                    this.featureFlags.usePresignatures === true &&
+                    this.presignatureSource) {
+                    const presignature = yield this.presignatureSource.consumePresignature(core_1.PortalCurve.SECP256K1);
+                    if (presignature === null || presignature === void 0 ? void 0 : presignature.data) {
+                        utils_1.sdkLogger.debug('[Portal] Signing with presignature (EnclaveSigner)', { method: message.method, chainId: message.chainId });
+                        try {
+                            return yield this.signWithPresignature(Object.assign(Object.assign({}, message), { presignatureData: presignature.data, traceId }), provider);
+                        }
+                        catch (presignError) {
+                            utils_1.sdkLogger.warn('[Portal.Provider.EnclaveSigner] signWithPresignature failed, falling back to normal sign:', presignError);
+                        }
+                    }
+                }
                 // Build params
                 // Avoid double JSON encoding: if params is already a string (e.g. a hex message), pass it directly; otherwise stringify objects/arrays.
                 const params = this.buildParams(method, message.params);
@@ -172,7 +185,7 @@ class EnclaveSigner {
                 // Make API request and process response
                 let result;
                 try {
-                    const response = yield this.makeEnclaveRequest(endpoint, apiKey, requestBody);
+                    const response = yield this.makeEnclaveRequest(endpoint, apiKey, requestBody, traceId);
                     result = this.processEnclaveResponse(response);
                 }
                 catch (error) {
@@ -223,7 +236,7 @@ class EnclaveSigner {
                     try {
                         yield this.sendMetrics(metrics, apiKey);
                     }
-                    catch (_a) {
+                    catch (_b) {
                         // No-op
                     }
                 }
@@ -268,15 +281,12 @@ class EnclaveSigner {
      * Make HTTP request to Enclave API
      * Returns raw response without processing
      */
-    makeEnclaveRequest(endpoint, apiKey, body) {
+    makeEnclaveRequest(endpoint, apiKey, body, traceId) {
         return __awaiter(this, void 0, void 0, function* () {
-            return yield this.requests.post(endpoint, {
-                headers: {
+            return yield this.requests.post(endpoint, Object.assign({ headers: {
                     Authorization: `Bearer ${apiKey}`,
                     'Content-Type': 'application/json',
-                },
-                body,
-            });
+                }, body }, (traceId ? { traceId } : {})));
         });
     }
     /**
@@ -374,5 +384,127 @@ class EnclaveSigner {
             }
         });
     }
+    /**
+     * Sign using a pre-generated presignature via the Enclave REST API.
+     * Uses the same endpoints as normal signing (/v1/sign, /v1/raw/sign/:curve)
+     * but includes the optional `presignature` field in the request body.
+     * NOTE: Only supports SECP256K1 curve.
+     */
+    signWithPresignature(message, provider) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const { method, chainId, isRaw = false, curve, presignatureData } = message;
+            const targetCurve = curve || core_1.PortalCurve.SECP256K1;
+            if (targetCurve !== core_1.PortalCurve.SECP256K1) {
+                throw new Error('[Portal.Provider.EnclaveSigner] Presignatures are only supported for SECP256K1 curve');
+            }
+            const shouldSendMetrics = this.featureFlags.enableSdkPerformanceMetrics;
+            const traceId = (_a = message.traceId) !== null && _a !== void 0 ? _a : (0, utils_1.generateTraceId)();
+            const metrics = {
+                hasError: false,
+                operation: 'signWithPresignature',
+                signingMethod: method,
+                traceId,
+            };
+            if (chainId) {
+                metrics.chainId = chainId;
+            }
+            const requestStartTime = performance.now();
+            try {
+                const preOperationStartTime = performance.now();
+                const apiKey = provider.apiKey;
+                if (!apiKey) {
+                    throw new Error('[Portal.Provider.EnclaveSigner] The API key is missing.');
+                }
+                const shares = yield this.keychain.getShares();
+                const signingShare = shares.secp256k1.share;
+                if (!signingShare) {
+                    throw new Error('[Portal.Provider.EnclaveSigner] The SECP256K1 share is missing from the keychain.');
+                }
+                const metadata = {
+                    clientPlatform: 'REACT_NATIVE',
+                    clientPlatformVersion: (0, utils_1.getClientPlatformVersion)(),
+                    isMultiBackupEnabled: this.featureFlags.isMultiBackupEnabled,
+                    mpcServerVersion: this.version,
+                    optimized: true,
+                    curve: core_1.PortalCurve.SECP256K1,
+                    chainId,
+                    isRaw,
+                    reqId: traceId,
+                    connectionTracingEnabled: shouldSendMetrics,
+                };
+                let endpoint;
+                let requestBody;
+                if (isRaw) {
+                    const params = this.buildParams(method, message.params);
+                    if (typeof params !== 'string') {
+                        throw new Error('[Portal.Provider.EnclaveSigner] For raw signing with presignature, params must be a string (e.g., a hex-encoded message).');
+                    }
+                    endpoint = `/v1/raw/sign/${targetCurve}`;
+                    requestBody = {
+                        params,
+                        share: JSON.stringify(signingShare),
+                        presignature: presignatureData,
+                    };
+                    metrics.operation = 'raw_signWithPresignature';
+                }
+                else {
+                    const params = this.buildParams(method, message.params);
+                    const formattedParams = typeof params === 'string' ? params : JSON.stringify(params);
+                    const rpcUrl = provider.getGatewayUrl(chainId);
+                    endpoint = '/v1/sign';
+                    requestBody = {
+                        method: message.method,
+                        params: formattedParams,
+                        share: JSON.stringify(signingShare),
+                        chainId: chainId || '',
+                        rpcUrl,
+                        metadataStr: JSON.stringify(metadata),
+                        clientPlatform: 'REACT_NATIVE',
+                        clientPlatformVersion: (0, utils_1.getClientPlatformVersion)(),
+                        presignature: presignatureData,
+                    };
+                }
+                metrics.sdkPreOperationMs = performance.now() - preOperationStartTime;
+                const enclaveSignStartTime = performance.now();
+                let result;
+                try {
+                    const response = yield this.makeEnclaveRequest(endpoint, apiKey, requestBody, traceId);
+                    result = this.processEnclaveResponse(response);
+                }
+                catch (error) {
+                    this.handleEnclaveError(error);
+                }
+                const postOperationStartTime = performance.now();
+                metrics.enclaveHttpCallMs = performance.now() - enclaveSignStartTime;
+                metrics.sdkPostOperationMs = performance.now() - postOperationStartTime;
+                metrics.sdkOperationMs = performance.now() - requestStartTime;
+                if (shouldSendMetrics && this.portalApi) {
+                    try {
+                        yield this.sendMetrics(metrics, apiKey);
+                    }
+                    catch (error) {
+                        // No-op
+                    }
+                }
+                return result;
+            }
+            catch (error) {
+                utils_1.sdkLogger.error('[Portal.Provider.EnclaveSigner] signWithPresignature error:', error);
+                metrics.sdkOperationMs = performance.now() - requestStartTime;
+                metrics.hasError = true;
+                if (shouldSendMetrics && this.portalApi) {
+                    const apiKey = provider.apiKey;
+                    try {
+                        yield this.sendMetrics(metrics, apiKey);
+                    }
+                    catch (metricsError) {
+                        // No-op
+                    }
+                }
+                throw error;
+            }
+        });
+    }
 }
 exports.default = EnclaveSigner;

package/lib/commonjs/signers/mpc.js

@@ -8,21 +8,17 @@ 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 = utils_1.DEFAULT_HOSTS.MPC, version = 'v6', portalApi, featureFlags = {}, }) {
+    constructor({ keychain, mpcHost = utils_1.DEFAULT_HOSTS.MPC, version = 'v6', portalApi, featureFlags = {}, presignatureSource, }) {
         this.version = 'v6';
         this.buildParams = (method, txParams) => {
             let params = txParams;
@@ -54,19 +50,21 @@ class MpcSigner {
         this.mpcHost = mpcHost;
         this.version = version;
         this.portalApi = portalApi;
+        this.presignatureSource = presignatureSource;
         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) {
+        var _a;
         return __awaiter(this, void 0, void 0, function* () {
             // 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();
+            // Use traceId from message if available (e.g. options.traceId), otherwise generate a new UUID
+            const traceId = (_a = message.traceId) !== null && _a !== void 0 ? _a : (0, utils_1.generateTraceId)();
+            utils_1.sdkLogger.info(`[Portal MPC] sign started | method=${message.method} | traceId=${traceId} | chainId=${message.chainId} | curve=${message.curve}`);
             const metrics = {
                 hasError: false,
                 operation: Operation.SIGN,
@@ -126,6 +124,22 @@ class MpcSigner {
                 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}`);
                 }
+                // Internal presignature handling (gated by feature flag): when usePresignatures is true and a
+                // presignature is available for SECP256K1, use signWithPresignature; otherwise normal sign().
+                if (curve === core_1.PortalCurve.SECP256K1 &&
+                    this.featureFlags.usePresignatures === true &&
+                    this.presignatureSource) {
+                    const presignature = yield this.presignatureSource.consumePresignature(core_1.PortalCurve.SECP256K1);
+                    if (presignature === null || presignature === void 0 ? void 0 : presignature.data) {
+                        utils_1.sdkLogger.debug('[Portal] Signing with presignature (portal.request/sendAsset path)', { method: message.method, chainId: message.chainId });
+                        try {
+                            return yield this.signWithPresignature(Object.assign(Object.assign({}, message), { presignatureData: presignature.data, traceId }), provider);
+                        }
+                        catch (presignError) {
+                            utils_1.sdkLogger.warn('[Portal.Provider.MpcSigner] signWithPresignature failed, falling back to normal sign:', presignError);
+                        }
+                    }
+                }
                 // Record pre-operation time
                 metrics.sdkPreOperationMs = performance.now() - preOperationStartTime;
                 // Measure MPC signing operation time
@@ -188,7 +202,7 @@ class MpcSigner {
                     try {
                         yield this.sendMetrics(metrics, apiKey);
                     }
-                    catch (_a) {
+                    catch (_b) {
                         // No-op
                     }
                 }
@@ -215,5 +229,133 @@ class MpcSigner {
             }
         });
     }
+    /**
+     * Sign a transaction using a pre-generated presignature
+     * NOTE: Only supports SECP256K1 curve
+     *
+     * @param message - Signing request with presignatureData
+     * @param provider - Portal provider instance
+     * @returns Signed transaction hash
+     */
+    signWithPresignature(message, provider) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const { method, chainId, isRaw = false, curve, sponsorGas, signatureApprovalMemo, presignatureData, } = message;
+            const targetCurve = curve || core_1.PortalCurve.SECP256K1;
+            if (targetCurve !== core_1.PortalCurve.SECP256K1) {
+                throw new Error('[Portal.Provider.MpcSigner] Presignatures are only supported for SECP256K1 curve');
+            }
+            const shouldSendMetrics = this.featureFlags.enableSdkPerformanceMetrics;
+            const traceId = (_a = message.traceId) !== null && _a !== void 0 ? _a : (0, utils_1.generateTraceId)();
+            const metrics = {
+                hasError: false,
+                operation: 'signWithPresignature',
+                signingMethod: method,
+                traceId,
+            };
+            if (chainId) {
+                metrics.chainId = chainId;
+            }
+            const requestStartTime = performance.now();
+            try {
+                const preOperationStartTime = performance.now();
+                const apiKey = provider.apiKey;
+                if (!apiKey) {
+                    throw new Error('[Portal.Provider.MpcSigner] The API key is missing.');
+                }
+                const shares = yield this.keychain.getShares();
+                const signingShare = shares.secp256k1.share;
+                if (!signingShare) {
+                    throw new Error('[Portal.Provider.MpcSigner] The SECP256K1 share is missing from the keychain.');
+                }
+                const metadata = {
+                    clientPlatform: 'REACT_NATIVE',
+                    clientPlatformVersion: (0, utils_1.getClientPlatformVersion)(),
+                    isMultiBackupEnabled: this.featureFlags.isMultiBackupEnabled,
+                    mpcServerVersion: this.version,
+                    optimized: true,
+                    curve: core_1.PortalCurve.SECP256K1,
+                    chainId,
+                    isRaw,
+                    reqId: traceId,
+                    connectionTracingEnabled: shouldSendMetrics,
+                    sponsorGas,
+                    signatureApprovalMemo,
+                };
+                const stringifiedMetadata = JSON.stringify(metadata);
+                let formattedParams;
+                let rpcUrl;
+                if (isRaw) {
+                    formattedParams = this.buildParams(method, message.params);
+                    rpcUrl = '';
+                    metrics.operation = 'raw_signWithPresignature';
+                }
+                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}`);
+                }
+                metrics.sdkPreOperationMs = performance.now() - preOperationStartTime;
+                const mpcSignStartTime = performance.now();
+                const result = yield this.mpc.signWithPresignature(apiKey, this.mpcHost, JSON.stringify(signingShare), presignatureData, method, formattedParams, rpcUrl, chainId, stringifiedMetadata);
+                const postOperationStartTime = performance.now();
+                metrics.mpcNativeCallMs = performance.now() - mpcSignStartTime;
+                const parsedResponse = JSON.parse(String(result));
+                const { data, error, meta } = parsedResponse;
+                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.id) {
+                    throw new utils_1.PortalMpcError(error);
+                }
+                metrics.sdkPostOperationMs = performance.now() - postOperationStartTime;
+                metrics.sdkOperationMs = performance.now() - requestStartTime;
+                if (shouldSendMetrics && this.portalApi) {
+                    try {
+                        yield this.sendMetrics(metrics, apiKey);
+                    }
+                    catch (error) {
+                        // No-op
+                    }
+                }
+                return data;
+            }
+            catch (error) {
+                utils_1.sdkLogger.error('[Portal.Provider.MpcSigner] signWithPresignature error:', error);
+                metrics.sdkOperationMs = performance.now() - requestStartTime;
+                metrics.hasError = true;
+                if (shouldSendMetrics && this.portalApi) {
+                    const apiKey = provider.apiKey;
+                    try {
+                        yield this.sendMetrics(metrics, apiKey);
+                    }
+                    catch (metricsError) {
+                        // No-op
+                    }
+                }
+                throw error;
+            }
+        });
+    }
 }
 exports.default = MpcSigner;

package/lib/esm/providers/index.js

@@ -8,7 +8,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { PortalCurve } from '@portal-hq/core';
-import { Events, HttpRequester, InvalidApiKeyError, InvalidGatewayConfigError, PortalRequests, ProviderRpcError, RpcErrorCodes, DEFAULT_CHAIN_ID_CAIP2, CHAIN_NAMESPACES, DEFAULT_HOSTS, } from '@portal-hq/utils';
+import { Events, HttpRequester, InvalidApiKeyError, InvalidGatewayConfigError, PortalRequests, ProviderRpcError, RpcErrorCodes, DEFAULT_CHAIN_ID_CAIP2, CHAIN_NAMESPACES, DEFAULT_HOSTS, generateTraceId, sdkLogger, } from '@portal-hq/utils';
 import { MpcSigner, EnclaveSigner } from '../signers';
 const passiveSignerMethods = [
     'eth_accounts',
@@ -42,7 +42,7 @@ class Provider {
     // Required
     apiKey, keychain, gatewayConfig, 
     // Optional
-    autoApprove = false, apiHost, mpcHost, enclaveMPCHost, version = 'v6', chainId = DEFAULT_CHAIN_ID_CAIP2, featureFlags = {}, }) {
+    autoApprove = false, apiHost, mpcHost, enclaveMPCHost, version = 'v6', chainId = DEFAULT_CHAIN_ID_CAIP2, featureFlags = {}, presignatureSource, }) {
         const finalApiHost = apiHost !== null && apiHost !== void 0 ? apiHost : DEFAULT_HOSTS.API;
         const finalMpcHost = mpcHost !== null && mpcHost !== void 0 ? mpcHost : DEFAULT_HOSTS.MPC;
         const finalEnclaveMPCHost = enclaveMPCHost !== null && enclaveMPCHost !== void 0 ? enclaveMPCHost : DEFAULT_HOSTS.ENCLAVE_MPC;
@@ -79,6 +79,10 @@ class Provider {
                 version,
                 portalApi: this.portalApi,
                 featureFlags,
+                // Only pass presignatureSource when usePresignatures is enabled (same as MpcSigner).
+                presignatureSource: featureFlags.usePresignatures === true
+                    ? presignatureSource
+                    : undefined,
             });
         }
         else {
@@ -88,6 +92,10 @@ class Provider {
                 version,
                 portalApi: this.portalApi,
                 featureFlags,
+                // Only pass presignatureSource when usePresignatures is enabled; otherwise signer always uses normal sign().
+                presignatureSource: featureFlags.usePresignatures === true
+                    ? presignatureSource
+                    : undefined,
             });
         }
     }
@@ -201,7 +209,7 @@ class Provider {
      * @param args The arguments of the request being made
      * @returns Promise<any>
      */
-    request({ method, params, chainId, connect, }) {
+    request({ method, params, chainId, connect, options, }) {
         return __awaiter(this, void 0, void 0, function* () {
             chainId = chainId !== null && chainId !== void 0 ? chainId : this.chainId;
             if (!chainId) {
@@ -252,6 +260,7 @@ class Provider {
                     params,
                     chainId,
                     connect,
+                    options,
                 });
                 if (transactionHash) {
                     try {
@@ -323,7 +332,7 @@ class Provider {
                 this.dispatchConnect(chainId);
             }
             else {
-                console.error(`[PortalProvider] Invalid chainId format. Must be 'namespace:reference', but got ${chainId}`);
+                sdkLogger.error(`[PortalProvider] Invalid chainId format. Must be 'namespace:reference', but got ${chainId}`);
             }
             return new Promise((resolve) => resolve(this));
         });
@@ -420,8 +429,8 @@ class Provider {
      * @param args The arguments of the request being made
      * @returns Promise<any>
      */
-    handleSigningRequests({ method, params, chainId, connect, }) {
-        var _a, _b;
+    handleSigningRequests({ method, params, chainId, connect, options, }) {
+        var _a, _b, _c;
         return __awaiter(this, void 0, void 0, function* () {
             const isApproved = passiveSignerMethods.includes(method)
                 ? true
@@ -430,6 +439,7 @@ class Provider {
                 this.log.info(`[PortalProvider] Request for signing method '${method}' could not be completed because it was not approved by the user.`);
                 return;
             }
+            const traceId = (_a = options === null || options === void 0 ? void 0 : options.traceId) !== null && _a !== void 0 ? _a : generateTraceId();
             let namespace = CHAIN_NAMESPACES.EIP155;
             let reference = chainId;
             if (typeof chainId == 'string' && chainId.includes(':')) {
@@ -456,22 +466,28 @@ class Provider {
                 case 'sol_signAndSendTransaction':
                 case 'sol_signMessage':
                 case 'sol_signTransaction': {
-                    const result = yield ((_a = this.signer) === null || _a === void 0 ? void 0 : _a.sign({
+                    const result = yield ((_b = this.signer) === null || _b === void 0 ? void 0 : _b.sign({
                         chainId: `${namespace}:${reference}`,
                         method,
                         params,
                         curve,
                         isRaw: false,
+                        sponsorGas: options === null || options === void 0 ? void 0 : options.sponsorGas,
+                        signatureApprovalMemo: options === null || options === void 0 ? void 0 : options.signatureApprovalMemo,
+                        traceId,
                     }, this));
                     return result;
                 }
                 case 'raw_sign': {
-                    const result = yield ((_b = this.signer) === null || _b === void 0 ? void 0 : _b.sign({
-                        chainId: '',
-                        method: '',
+                    const result = yield ((_c = this.signer) === null || _c === void 0 ? void 0 : _c.sign({
+                        chainId: chainId !== null && chainId !== void 0 ? chainId : '',
+                        method: 'raw_sign',
                         params,
                         curve,
                         isRaw: true,
+                        sponsorGas: options === null || options === void 0 ? void 0 : options.sponsorGas,
+                        signatureApprovalMemo: options === null || options === void 0 ? void 0 : options.signatureApprovalMemo,
+                        traceId,
                     }, this));
                     return result;
                 }