@portal-hq/web 3.11.0 → 3.12.0

package/lib/commonjs/index.js

@@ -46,6 +46,7 @@ const delegations_1 = __importDefault(require("./integrations/delegations"));
 const passkeys_1 = __importDefault(require("./passkeys"));
 const evmAccountType_1 = require("./namespaces/evmAccountType");
 const logger_1 = require("./logger");
+const trace_1 = require("./shared/trace");
 class Portal {
     get ready() {
         return this.mpc.ready;
@@ -472,16 +473,18 @@ class Portal {
         });
     }
     sendAsset(chain, params) {
-        var _a;
+        var _a, _b;
         return __awaiter(this, void 0, void 0, function* () {
+            const traceId = (_a = params.traceId) !== null && _a !== void 0 ? _a : (0, trace_1.generateTraceId)();
+            logger_1.sdkLogger.debug('[Portal] sendAsset started (single traceId for build + sign)', { traceId });
             try {
                 // Convert the chain to a chain ID
                 const chainId = this.convertChainToChainId(chain);
-                // Build the transaction
-                const buildTxResponse = yield this.buildTransaction(chainId, params.to, params.token, params.amount);
+                // Build the transaction (same traceId for correlation with backend)
+                const buildTxResponse = yield this.buildTransaction(chainId, params.to, params.token, params.amount, traceId);
                 // Get the chain namespace
-                const chainNamespace = (_a = chainId.split(':')[0]) !== null && _a !== void 0 ? _a : '';
-                // Send the transaction based on chain namespace
+                const chainNamespace = (_b = chainId.split(':')[0]) !== null && _b !== void 0 ? _b : '';
+                // Send the transaction based on chain namespace (same traceId on request)
                 let response;
                 switch (chainNamespace) {
                     case 'eip155': {
@@ -491,6 +494,7 @@ class Portal {
                             params: [buildTxResponse.transaction],
                             sponsorGas: params.sponsorGas,
                             signatureApprovalMemo: params.signatureApprovalMemo,
+                            traceId,
                         });
                         break;
                     }
@@ -501,6 +505,7 @@ class Portal {
                             params: [buildTxResponse.transaction],
                             sponsorGas: params.sponsorGas,
                             signatureApprovalMemo: params.signatureApprovalMemo,
+                            traceId,
                         });
                         break;
                     }
@@ -828,10 +833,10 @@ class Portal {
             return (_a = this.mpc) === null || _a === void 0 ? void 0 : _a.getNFTAssets(chainId);
         });
     }
-    buildTransaction(chainId, to, token, amount) {
+    buildTransaction(chainId, to, token, amount, traceId) {
         var _a;
         return __awaiter(this, void 0, void 0, function* () {
-            return (_a = this.mpc) === null || _a === void 0 ? void 0 : _a.buildTransaction(chainId, to, token, amount);
+            return (_a = this.mpc) === null || _a === void 0 ? void 0 : _a.buildTransaction(chainId, to, token, amount, traceId);
         });
     }
     /*******************************

package/lib/commonjs/index.test.js

@@ -663,7 +663,7 @@ describe('Portal', () => {
         it('should correctly call mpc.buildTransaction', () => __awaiter(void 0, void 0, void 0, function* () {
             yield portal.buildTransaction('eip155:1', constants_1.mockAddress, 'USDC', '1');
             expect(portal.mpc.buildTransaction).toHaveBeenCalledTimes(1);
-            expect(portal.mpc.buildTransaction).toHaveBeenCalledWith('eip155:1', constants_1.mockAddress, 'USDC', '1');
+            expect(portal.mpc.buildTransaction).toHaveBeenCalledWith('eip155:1', constants_1.mockAddress, 'USDC', '1', undefined);
         }));
     });
     describe('getNFTAssets', () => {

package/lib/commonjs/mpc/index.js

@@ -11,8 +11,10 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MpcErrorCodes = exports.MpcError = void 0;
 const errors_1 = require("./errors");
+const logger_1 = require("../logger");
 const index_1 = require("../index");
-const WEB_SDK_VERSION = '3.11.0';
+const trace_1 = require("../shared/trace");
+const WEB_SDK_VERSION = '3.12.0';
 class Mpc {
     get ready() {
         return this._ready;
@@ -22,6 +24,7 @@ class Mpc {
     }
     constructor({ portal }) {
         this._ready = false;
+        this.presignatureLogHandler = null;
         this.configureIframe = () => {
             const config = {
                 apiKey: this.portal.apiKey,
@@ -34,12 +37,14 @@ class Mpc {
                 mpcHost: this.portal.mpcHost,
                 mpcVersion: this.portal.mpcVersion,
                 featureFlags: this.portal.featureFlags,
+                logLevel: this.portal.getLogLevel(),
             };
             const message = {
                 type: 'portal:configure',
                 data: config,
             };
             this.postMessage(message);
+            this.setupPresignatureLogForwarding();
             this.waitForReadyMessage();
         };
         this.portal = portal;
@@ -53,10 +58,12 @@ class Mpc {
      *******************************/
     backup(data, progress = () => {
         // Noop
-    }) {
+    }, traceId) {
         return __awaiter(this, void 0, void 0, function* () {
             // validates password config for password backup
             this.validateBackupConfig(data);
+            const resolvedTraceId = traceId !== null && traceId !== void 0 ? traceId : (0, trace_1.generateTraceId)();
+            logger_1.sdkLogger.info(`[Portal MPC] backup started | backupMethod=${data.backupMethod} | traceId=${resolvedTraceId}`);
             return this.handleRequestToIframeAndPost({
                 methodMessage: 'portal:wasm:backup',
                 errorMessage: 'portal:wasm:backupError',
@@ -64,6 +71,7 @@ class Mpc {
                 data,
                 progressMessage: 'portal:wasm:backupProgress',
                 progressCallback: progress,
+                traceId: resolvedTraceId,
                 mapReturnValue: (result) => {
                     const resultData = result;
                     const backupIds = Array.isArray(resultData.backupIds)
@@ -90,12 +98,17 @@ class Mpc {
             resultMessage: 'portal:destroyResult',
             data: {},
             mapReturnValue: () => true,
+        }).then((result) => {
+            this.teardownPresignatureLogForwarding();
+            return result;
         });
     }
     generate(data, progress = () => {
         // Noop
-    }) {
+    }, traceId) {
         return __awaiter(this, void 0, void 0, function* () {
+            const resolvedTraceId = traceId !== null && traceId !== void 0 ? traceId : (0, trace_1.generateTraceId)();
+            logger_1.sdkLogger.info(`[Portal MPC] generate started | traceId=${resolvedTraceId}`);
             return this.handleRequestToIframeAndPost({
                 methodMessage: 'portal:wasm:generate',
                 errorMessage: 'portal:wasm:generateError',
@@ -103,6 +116,7 @@ class Mpc {
                 data,
                 progressMessage: 'portal:wasm:generateProgress',
                 progressCallback: progress,
+                traceId: resolvedTraceId,
             });
         });
     }
@@ -118,8 +132,10 @@ class Mpc {
     }
     recover(data, progress = () => {
         // Noop
-    }) {
+    }, traceId) {
         return __awaiter(this, void 0, void 0, function* () {
+            const resolvedTraceId = traceId !== null && traceId !== void 0 ? traceId : (0, trace_1.generateTraceId)();
+            logger_1.sdkLogger.info(`[Portal MPC] recover started | backupMethod=${data.backupMethod} | traceId=${resolvedTraceId}`);
             return this.handleRequestToIframeAndPost({
                 methodMessage: 'portal:wasm:recover',
                 errorMessage: 'portal:wasm:recoverError',
@@ -127,26 +143,29 @@ class Mpc {
                 data,
                 progressMessage: 'portal:wasm:recoverProgress',
                 progressCallback: progress,
+                traceId: resolvedTraceId,
             });
         });
     }
-    eject(data) {
+    eject(data, traceId) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.handleRequestToIframeAndPost({
                 methodMessage: 'portal:wasm:eject',
                 errorMessage: 'portal:wasm:ejectError',
                 resultMessage: 'portal:wasm:ejectResult',
                 data,
+                traceId,
             });
         });
     }
-    ejectPrivateKeys(data) {
+    ejectPrivateKeys(data, traceId) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.handleRequestToIframeAndPost({
                 methodMessage: 'portal:wasm:ejectPrivateKeys',
                 errorMessage: 'portal:wasm:ejectPrivateKeysError',
                 resultMessage: 'portal:wasm:ejectPrivateKeysResult',
                 data,
+                traceId,
             });
         });
     }
@@ -166,14 +185,18 @@ class Mpc {
     sign(data, progress = () => {
         // Noop
     }) {
+        var _a;
         return __awaiter(this, void 0, void 0, function* () {
+            const resolvedTraceId = (_a = data.traceId) !== null && _a !== void 0 ? _a : (0, trace_1.generateTraceId)();
+            logger_1.sdkLogger.info(`[Portal MPC] sign started | method=${data.method} | traceId=${resolvedTraceId} | chainId=${data.chainId}`);
             return this.handleRequestToIframeAndPost({
                 methodMessage: 'portal:wasm:sign',
                 errorMessage: 'portal:wasm:signError',
                 resultMessage: 'portal:wasm:signResult',
-                data,
+                data: Object.assign(Object.assign({}, data), { traceId: resolvedTraceId }),
                 progressMessage: 'portal:wasm:signProgress',
                 progressCallback: progress,
+                traceId: resolvedTraceId,
             });
         });
     }
@@ -250,13 +273,14 @@ class Mpc {
             });
         });
     }
-    buildTransaction(chainId, to, token, amount) {
+    buildTransaction(chainId, to, token, amount, traceId) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.handleRequestToIframeAndPost({
                 methodMessage: 'portal:buildTransaction',
                 errorMessage: 'portal:buildTransactionError',
                 resultMessage: 'portal:buildTransactionResult',
                 data: { chainId, to, token, amount },
+                traceId,
             });
         });
     }
@@ -710,8 +734,11 @@ class Mpc {
      * This method is not part of the stable public surface area and may change in
      * future releases without notice.
      */
-    handleRequestToIframeAndPost({ methodMessage, errorMessage, resultMessage, data, progressMessage, progressCallback, mapReturnValue, }) {
+    handleRequestToIframeAndPost({ methodMessage, errorMessage, resultMessage, data, progressMessage, progressCallback, mapReturnValue, traceId: providedTraceId, }) {
         return __awaiter(this, void 0, void 0, function* () {
+            // Single traceId per operation: use provided or generate. Propagates to iframe and all internal REST/MPC calls.
+            const traceId = providedTraceId !== null && providedTraceId !== void 0 ? providedTraceId : (0, trace_1.generateTraceId)();
+            logger_1.sdkLogger.debug('[Portal] request traceId:', traceId, 'method:', methodMessage);
             return new Promise((resolve, reject) => {
                 const handleRequest = (event) => {
                     const { type, data: result } = event.data;
@@ -738,10 +765,11 @@ class Mpc {
                 };
                 // Bind the function to the message event
                 window.addEventListener('message', handleRequest);
-                // Send the request to the iframe
+                // Send the request to the iframe (traceId at top-level so data shape stays unchanged)
                 this.postMessage({
                     type: methodMessage,
                     data,
+                    traceId,
                 });
             });
         });
@@ -763,6 +791,26 @@ class Mpc {
         document.body.appendChild(iframe);
         this.iframe = iframe;
     }
+    setupPresignatureLogForwarding() {
+        if (this.presignatureLogHandler)
+            return;
+        const handler = (event) => {
+            if (event.origin !== this.getOrigin())
+                return;
+            const { type, data } = event.data || {};
+            if (type === 'portal:presignature:log' && (data === null || data === void 0 ? void 0 : data.message)) {
+                logger_1.sdkLogger.warn(data.message);
+            }
+        };
+        this.presignatureLogHandler = handler;
+        window.addEventListener('message', handler);
+    }
+    teardownPresignatureLogForwarding() {
+        if (!this.presignatureLogHandler)
+            return;
+        window.removeEventListener('message', this.presignatureLogHandler);
+        this.presignatureLogHandler = null;
+    }
     getOrigin() {
         const host = this.portal.host;
         const origin = host.startsWith('localhost:')