phantasma-sdk-ts 0.10.0 → 0.11.0

package/dist/cjs/link/v5/client.js

@@ -45,6 +45,15 @@ class PhantasmaLink5 {
             if (event === protocol_js_1.LinkEvent.SessionEstablished && isConnectResult(data)) {
                 this.adoptConnectResult(data);
             }
+            else if (event === protocol_js_1.LinkEvent.SessionDeleted || event === protocol_js_1.LinkEvent.SessionExpired) {
+                // The wallet tore this session down (user revoke / LRU evict / idle expiry) and notified us
+                // over the channel. Drop our session so a reload cannot resume a dead one: forgetSession
+                // clears lastConnect + the session id and fires onSessionChange(undefined), which also drops
+                // the persisted web-deeplink record. The deleted id rides the envelope `session` field, not
+                // `data` (the wallet sends data:{}), so no payload is needed - the frame already decrypted
+                // with this session's channel key, which authenticates it as ours.
+                this.forgetSession();
+            }
         });
     }
     /** Build a client over the desktop loopback transport (plaintext, trusted-local). */
@@ -142,11 +151,13 @@ class PhantasmaLink5 {
             topic: stored.topic,
             opener: hooks.opener,
             walletBase: options.walletBase,
+            log: options.log,
         }), {
             dapp: options.dapp,
             sessionKey,
             sessionId: stored.sessionId,
             requestTimeoutMs: options.requestTimeoutMs ?? deeplink_js_1.DEEPLINK_REQUEST_TIMEOUT_MS,
+            log: options.log,
             onSessionChange: (connect) => {
                 // Session layer only - the pairing material stays valid across disconnects.
                 stored.sessionId = connect?.session.id;

package/dist/cjs/link/v5/deeplink.js

@@ -84,6 +84,7 @@ class DeeplinkTransport {
         this.topic = options.topic;
         this.opener = options.opener;
         this.walletBase = options.walletBase ?? exports.WALLET_SCHEME_BASE;
+        this.log = options.log;
     }
     send(frame) {
         if (this.closed) {
@@ -106,9 +107,18 @@ class DeeplinkTransport {
             return false;
         }
         const parsed = parseResponseUrl(url);
-        if (!parsed || parsed.topic !== this.topic) {
+        if (!parsed) {
+            return false; // not a v5 response URL: a foreign navigation, not ours - stay silent
+        }
+        if (parsed.topic !== this.topic) {
+            // A v5 response for a DIFFERENT channel. The usual cause is a regenerated pairing (the page
+            // reloaded or opened in another tab with a fresh topic), so the wallet's answer can never
+            // match. Log it: this is the silent drop that makes a "nothing happened" deeplink return so
+            // hard to diagnose.
+            this.log?.('deliverUrl: v5 response for a different topic, ignored (pairing likely regenerated)');
             return false;
         }
+        this.log?.('deliverUrl: v5 response matched this channel, dispatching');
         this.messageHandler?.(parsed.frame);
         return true;
     }

package/dist/cjs/link/v5/transport.js

@@ -27,6 +27,7 @@ class LinkSessionClient {
         this.sessionId = options.sessionId;
         this.requestTimeoutMs = options.requestTimeoutMs ?? 60000;
         this.onUnmatchedResponse = options.onUnmatchedResponse;
+        this.log = options.log;
         transport.onMessage((frame) => this.handleFrame(frame));
         transport.onClose?.((reason) => this.handleClose(reason));
     }
@@ -129,7 +130,10 @@ class LinkSessionClient {
             message = this.decodeIncoming(frame);
         }
         catch {
-            // Drop undecodable/forged frames; a real authenticated peer never sends these.
+            // Drop undecodable/forged frames; a real authenticated peer never sends these. Log the drop
+            // (no payload) so a wrong-key channel - e.g. a deeplink return after the pairing was
+            // regenerated - is visible instead of silently vanishing.
+            this.log?.('frame dropped: undecodable or wrong session key');
             return;
         }
         if ((0, envelope_js_1.isLinkEvent)(message)) {
@@ -171,6 +175,7 @@ class LinkSessionClient {
         }
     }
     emitEvent(message) {
+        this.log?.(`event received: ${message.event}`);
         for (const handler of this.eventHandlers) {
             try {
                 handler(message.event, message.data, message.session);

package/dist/cjs/rpc/phantasma.js

@@ -131,11 +131,23 @@ class PhantasmaAPI {
         this.nextRpcRequestId += 1;
         return requestId;
     }
+    rpcHeaders() {
+        const headers = { 'Content-Type': 'application/json' };
+        if (this.apiKey) {
+            headers['X-Api-Key'] = this.apiKey;
+        }
+        return headers;
+    }
     pingAsync(host) {
         return new Promise((resolve, reject) => {
             const started = new Date().getTime();
             const http = new XMLHttpRequest();
             http.open('GET', host + '/rpc', true);
+            // Under keys-only mode the health-check ping must present the key too, otherwise it gets 401 and
+            // the host is wrongly dropped from availableHosts during auto-discovery.
+            if (this.apiKey) {
+                http.setRequestHeader('X-Api-Key', this.apiKey);
+            }
             http.timeout = 4500;
             http.onreadystatechange = function () {
                 if (http.readyState == 4 && http.status == 200) {
@@ -166,6 +178,7 @@ class PhantasmaAPI {
         this.host = defHost;
         this.availableHosts = [];
         this.maxRpcResponseBytes = normalizeMaxRpcResponseBytes(options.maxRpcResponseBytes);
+        this.apiKey = options.apiKey || undefined;
         if (peersUrlJson != undefined && peersUrlJson != null) {
             (0, cross_fetch_1.default)(peersUrlJson + '?_=' + new Date().getTime()).then(async (res) => {
                 const data = (await res.json());
@@ -201,7 +214,7 @@ class PhantasmaAPI {
                     params: params,
                     id: requestId,
                 }),
-                headers: { 'Content-Type': 'application/json' },
+                headers: this.rpcHeaders(),
             });
         }
         catch (error) {
@@ -246,7 +259,7 @@ class PhantasmaAPI {
                     params: params,
                     id: requestId,
                 }),
-                headers: { 'Content-Type': 'application/json' },
+                headers: this.rpcHeaders(),
             });
         }
         catch (error) {
@@ -279,6 +292,10 @@ class PhantasmaAPI {
         this.maxRpcResponseBytes = normalizeMaxRpcResponseBytes(maxBytes);
         return this;
     }
+    setApiKey(apiKey) {
+        this.apiKey = apiKey || undefined;
+        return this;
+    }
     setRpcHost(rpcHost) {
         this.host = rpcHost;
     }

package/dist/esm/link/v5/client.js

@@ -42,6 +42,15 @@ export class PhantasmaLink5 {
             if (event === LinkEvent.SessionEstablished && isConnectResult(data)) {
                 this.adoptConnectResult(data);
             }
+            else if (event === LinkEvent.SessionDeleted || event === LinkEvent.SessionExpired) {
+                // The wallet tore this session down (user revoke / LRU evict / idle expiry) and notified us
+                // over the channel. Drop our session so a reload cannot resume a dead one: forgetSession
+                // clears lastConnect + the session id and fires onSessionChange(undefined), which also drops
+                // the persisted web-deeplink record. The deleted id rides the envelope `session` field, not
+                // `data` (the wallet sends data:{}), so no payload is needed - the frame already decrypted
+                // with this session's channel key, which authenticates it as ours.
+                this.forgetSession();
+            }
         });
     }
     /** Build a client over the desktop loopback transport (plaintext, trusted-local). */
@@ -139,11 +148,13 @@ export class PhantasmaLink5 {
             topic: stored.topic,
             opener: hooks.opener,
             walletBase: options.walletBase,
+            log: options.log,
         }), {
             dapp: options.dapp,
             sessionKey,
             sessionId: stored.sessionId,
             requestTimeoutMs: options.requestTimeoutMs ?? DEEPLINK_REQUEST_TIMEOUT_MS,
+            log: options.log,
             onSessionChange: (connect) => {
                 // Session layer only - the pairing material stays valid across disconnects.
                 stored.sessionId = connect?.session.id;

package/dist/esm/link/v5/deeplink.js

@@ -77,6 +77,7 @@ export class DeeplinkTransport {
         this.topic = options.topic;
         this.opener = options.opener;
         this.walletBase = options.walletBase ?? WALLET_SCHEME_BASE;
+        this.log = options.log;
     }
     send(frame) {
         if (this.closed) {
@@ -99,9 +100,18 @@ export class DeeplinkTransport {
             return false;
         }
         const parsed = parseResponseUrl(url);
-        if (!parsed || parsed.topic !== this.topic) {
+        if (!parsed) {
+            return false; // not a v5 response URL: a foreign navigation, not ours - stay silent
+        }
+        if (parsed.topic !== this.topic) {
+            // A v5 response for a DIFFERENT channel. The usual cause is a regenerated pairing (the page
+            // reloaded or opened in another tab with a fresh topic), so the wallet's answer can never
+            // match. Log it: this is the silent drop that makes a "nothing happened" deeplink return so
+            // hard to diagnose.
+            this.log?.('deliverUrl: v5 response for a different topic, ignored (pairing likely regenerated)');
             return false;
         }
+        this.log?.('deliverUrl: v5 response matched this channel, dispatching');
         this.messageHandler?.(parsed.frame);
         return true;
     }

package/dist/esm/link/v5/transport.js

@@ -24,6 +24,7 @@ export class LinkSessionClient {
         this.sessionId = options.sessionId;
         this.requestTimeoutMs = options.requestTimeoutMs ?? 60000;
         this.onUnmatchedResponse = options.onUnmatchedResponse;
+        this.log = options.log;
         transport.onMessage((frame) => this.handleFrame(frame));
         transport.onClose?.((reason) => this.handleClose(reason));
     }
@@ -126,7 +127,10 @@ export class LinkSessionClient {
             message = this.decodeIncoming(frame);
         }
         catch {
-            // Drop undecodable/forged frames; a real authenticated peer never sends these.
+            // Drop undecodable/forged frames; a real authenticated peer never sends these. Log the drop
+            // (no payload) so a wrong-key channel - e.g. a deeplink return after the pairing was
+            // regenerated - is visible instead of silently vanishing.
+            this.log?.('frame dropped: undecodable or wrong session key');
             return;
         }
         if (isLinkEvent(message)) {
@@ -168,6 +172,7 @@ export class LinkSessionClient {
         }
     }
     emitEvent(message) {
+        this.log?.(`event received: ${message.event}`);
         for (const handler of this.eventHandlers) {
             try {
                 handler(message.event, message.data, message.session);

package/dist/esm/rpc/phantasma.js

@@ -125,11 +125,23 @@ export class PhantasmaAPI {
         this.nextRpcRequestId += 1;
         return requestId;
     }
+    rpcHeaders() {
+        const headers = { 'Content-Type': 'application/json' };
+        if (this.apiKey) {
+            headers['X-Api-Key'] = this.apiKey;
+        }
+        return headers;
+    }
     pingAsync(host) {
         return new Promise((resolve, reject) => {
             const started = new Date().getTime();
             const http = new XMLHttpRequest();
             http.open('GET', host + '/rpc', true);
+            // Under keys-only mode the health-check ping must present the key too, otherwise it gets 401 and
+            // the host is wrongly dropped from availableHosts during auto-discovery.
+            if (this.apiKey) {
+                http.setRequestHeader('X-Api-Key', this.apiKey);
+            }
             http.timeout = 4500;
             http.onreadystatechange = function () {
                 if (http.readyState == 4 && http.status == 200) {
@@ -160,6 +172,7 @@ export class PhantasmaAPI {
         this.host = defHost;
         this.availableHosts = [];
         this.maxRpcResponseBytes = normalizeMaxRpcResponseBytes(options.maxRpcResponseBytes);
+        this.apiKey = options.apiKey || undefined;
         if (peersUrlJson != undefined && peersUrlJson != null) {
             fetch(peersUrlJson + '?_=' + new Date().getTime()).then(async (res) => {
                 const data = (await res.json());
@@ -195,7 +208,7 @@ export class PhantasmaAPI {
                     params: params,
                     id: requestId,
                 }),
-                headers: { 'Content-Type': 'application/json' },
+                headers: this.rpcHeaders(),
             });
         }
         catch (error) {
@@ -240,7 +253,7 @@ export class PhantasmaAPI {
                     params: params,
                     id: requestId,
                 }),
-                headers: { 'Content-Type': 'application/json' },
+                headers: this.rpcHeaders(),
             });
         }
         catch (error) {
@@ -273,6 +286,10 @@ export class PhantasmaAPI {
         this.maxRpcResponseBytes = normalizeMaxRpcResponseBytes(maxBytes);
         return this;
     }
+    setApiKey(apiKey) {
+        this.apiKey = apiKey || undefined;
+        return this;
+    }
     setRpcHost(rpcHost) {
         this.host = rpcHost;
     }

package/dist/types/link/v5/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/link/v5/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/link/v5/client.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,aAAa,EAEb,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAqB,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EAEL,wBAAwB,EAEzB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAkB,qBAAqB,EAAqB,MAAM,sBAAsB,CAAC;AAIhG,OAAO,EACL,kBAAkB,EAMnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAIL,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAE7B,0CAA0C;AAC1C,MAAM,WAAW,qBAAsB,SAAQ,wBAAwB;IACrE,wFAAwF;IACxF,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB;;sFAEkF;IAClF,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,KAAK,IAAI,CAAC;CAChE;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAA+C;IAGhF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,WAAW,CAAC,CAAgB;IACpC,OAAO,CAAC,aAAa,CAAC,CAAoB;IAC1C,OAAO,CAAC,eAAe,CAAC,CAAS;gBAErB,SAAS,EAAE,aAAa,EAAE,OAAO,GAAE,qBAA0B;IAgCzE,qFAAqF;IACrF,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAE,wBAA6B,GAAG,cAAc;IAIvE;iGAC6F;IAC7F,MAAM,CAAC,QAAQ,CACb,OAAO,EAAE,wBAAwB,GAAG;QAAE,UAAU,EAAE,UAAU,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,GACxF,cAAc;IAcjB;;2CAEuC;IACvC,MAAM,CAAC,KAAK,CACV,OAAO,EAAE,qBAAqB,GAAG;QAAE,UAAU,EAAE,UAAU,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,GACrF,cAAc;IAcjB;;;;;;;OAOG;IACH,MAAM,CAAC,SAAS,CACd,OAAO,EAAE,IAAI,CAAC,qBAAqB,EAAE,OAAO,GAAG,aAAa,CAAC,GAAG;QAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,YAAY,CAAC;QACpB,OAAO,CAAC,EAAE,gBAAgB,CAAC;QAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GACA,cAAc;IAiCjB;;;;;;;;;;OAUG;WACU,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IAuE9E;;0DAEsD;IACtD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIhC;;;wFAGoF;IACpF,qBAAqB,IAAI,iBAAiB,GAAG,SAAS;IAMtD;+FAC2F;IAC3F,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED,oEAAoE;IACpE,IAAI,OAAO,IAAI,aAAa,GAAG,SAAS,CAEvC;IAED,+EAA+E;IAC/E,IAAI,YAAY,IAAI,kBAAkB,GAAG,SAAS,CAEjD;IAED;;6FAEyF;IACnF,OAAO,CACX,IAAI,CAAC,EAAE,YAAY,EACnB,KAAK,GAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAM,GACtC,OAAO,CAAC,aAAa,CAAC;IAmBzB;uFACmF;IACnF,OAAO,CAAC,kBAAkB;IAM1B,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAIzC,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;IAIrC,aAAa,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAI7C,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIlE,wFAAwF;IACxF,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI9E,sEAAsE;IACtE,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI9E,kDAAkD;IAClD,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI/D,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAU7C;;;mGAG+F;IAC/F,aAAa,IAAI,IAAI;IAMrB,yEAAyE;IACzE,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAI9C,wEAAwE;IACxE,KAAK,IAAI,IAAI;IAiBb,OAAO,CAAC,OAAO;CAMhB"}

package/dist/types/link/v5/deeplink.d.ts

@@ -25,6 +25,10 @@ export interface DeeplinkTransportOptions {
     opener: (url: string) => void;
     /** Wallet base; defaults to the custom scheme {@link WALLET_SCHEME_BASE}. */
     walletBase?: string;
+    /** Optional diagnostic sink for inbound response URLs: whether a delivered URL matched this
+     * channel's topic or was ignored (foreign topic / not a v5 response). METADATA ONLY - never the
+     * sealed `f` payload. Default: no-op. */
+    log?: (message: string) => void;
 }
 /**
  * {@link LinkTransport} over deeplink ping-pong. `send` opens a wallet URL carrying the frame;
@@ -35,6 +39,7 @@ export declare class DeeplinkTransport implements LinkTransport {
     private readonly topic;
     private readonly opener;
     private readonly walletBase;
+    private readonly log?;
     private messageHandler?;
     private closeHandler?;
     private closed;

package/dist/types/link/v5/deeplink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deeplink.d.ts","sourceRoot":"","sources":["../../../../src/link/v5/deeplink.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG/C,uEAAuE;AACvE,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAEjD;;2FAE2F;AAC3F,eAAO,MAAM,2BAA2B,SAAS,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;mFACmF;AACnF,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGxF;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAMhE;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIvF;AAED,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAMjE;AAmBD,MAAM,WAAW,wBAAwB;IACvC,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,6FAA6F;IAC7F,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,cAAc,CAAC,CAA0B;IACjD,OAAO,CAAC,YAAY,CAAC,CAA4B;IACjD,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,wBAAwB;IAS7C,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOzB,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIjD,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIjD;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAYhC,KAAK,IAAI,IAAI;CAOd"}
+{"version":3,"file":"deeplink.d.ts","sourceRoot":"","sources":["../../../../src/link/v5/deeplink.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG/C,uEAAuE;AACvE,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAEjD;;2FAE2F;AAC3F,eAAO,MAAM,2BAA2B,SAAS,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;mFACmF;AACnF,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGxF;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAMhE;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIvF;AAED,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAMjE;AAmBD,MAAM,WAAW,wBAAwB;IACvC,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,6FAA6F;IAC7F,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;6CAEyC;IACzC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAA4B;IACjD,OAAO,CAAC,cAAc,CAAC,CAA0B;IACjD,OAAO,CAAC,YAAY,CAAC,CAA4B;IACjD,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,wBAAwB;IAU7C,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOzB,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIjD,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIjD;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAuBhC,KAAK,IAAI,IAAI;CAOd"}

package/dist/types/link/v5/transport.d.ts

@@ -23,6 +23,11 @@ export interface LinkSessionClientOptions {
      * the wallet was open, discarding the original request promise). Without it such responses
      * are dropped. Never fires on same-page flows - those always have a pending entry. */
     onUnmatchedResponse?: (response: UnmatchedResponse) => void;
+    /** Optional diagnostic sink for the receive path: frames dropped (undecodable / wrong key) and
+     * events received. Mirrors the relay transport's `log` seam so a host can trace the otherwise
+     * silent deeplink/relay receive path. METADATA ONLY - never receives secrets or plaintext
+     * payloads. Default: no-op. */
+    log?: (message: string) => void;
 }
 /** A wallet response that arrived with no in-flight request to match it - the deeplink reload
  * case, where the page that issued the request was discarded before the answer came back.
@@ -47,6 +52,7 @@ export declare class LinkSessionClient {
     private sessionId?;
     private readonly requestTimeoutMs;
     private readonly onUnmatchedResponse?;
+    private readonly log?;
     private readonly pending;
     private readonly eventHandlers;
     private closed;

package/dist/types/link/v5/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../src/link/v5/transport.ts"],"names":[],"mappings":"AA0BA,kFAAkF;AAClF,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAClD,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IACnD,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAExF,MAAM,WAAW,wBAAwB;IACvC;;wBAEoB;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;qFAEiF;IACjF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;0FAEsF;IACtF,mBAAmB,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC7D;AAQD;;;sDAGsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IAC5C,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAwC;IAC7E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA+B;IAC7D,OAAO,CAAC,MAAM,CAAS;gBAEX,SAAS,EAAE,aAAa,EAAE,OAAO,GAAE,wBAA6B;IAW5E;qEACiE;IACjE,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAI1C,2DAA2D;IAC3D,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC;;kFAE8E;IAC9E,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAOpC,yEAAyE;IACzE,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAO9C,2EAA2E;IAC3E,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAwD3E,2DAA2D;IAC3D,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,WAAW;IAiDnB,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,SAAS;CASlB"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../src/link/v5/transport.ts"],"names":[],"mappings":"AA0BA,kFAAkF;AAClF,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAClD,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IACnD,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAExF,MAAM,WAAW,wBAAwB;IACvC;;wBAEoB;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;qFAEiF;IACjF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;0FAEsF;IACtF,mBAAmB,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC5D;;;mCAG+B;IAC/B,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAQD;;;sDAGsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IAC5C,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAwC;IAC7E,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAA4B;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA+B;IAC7D,OAAO,CAAC,MAAM,CAAS;gBAEX,SAAS,EAAE,aAAa,EAAE,OAAO,GAAE,wBAA6B;IAY5E;qEACiE;IACjE,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAI1C,2DAA2D;IAC3D,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC;;kFAE8E;IAC9E,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAOpC,yEAAyE;IACzE,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAO9C,2EAA2E;IAC3E,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAwD3E,2DAA2D;IAC3D,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,WAAW;IAoDnB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,SAAS;CASlB"}

package/dist/types/link/v5/web-deeplink.d.ts

@@ -35,6 +35,10 @@ export interface WebDeeplinkOptions {
     callback?: string;
     /** Per-request timeout; the web default is 5 minutes (an app switch + human consent). */
     requestTimeoutMs?: number;
+    /** Optional diagnostic sink for the deeplink lifecycle (return-URL matched / ignored, frame
+     * drops, events received). METADATA ONLY - never the symKey or sealed payload. Default: no-op.
+     * A host can wire this to surface why a deeplink return did or did not land. */
+    log?: (message: string) => void;
 }
 /** The persisted pairing/session state of one web dApp <-> wallet deeplink channel. */
 export interface WebDeeplinkRecord {

package/dist/types/link/v5/web-deeplink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-deeplink.d.ts","sourceRoot":"","sources":["../../../../src/link/v5/web-deeplink.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIhE,2FAA2F;AAC3F,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,uEAAuE;AACvE,eAAO,MAAM,wBAAwB,kCAAkC,CAAC;AAExE;yFACyF;AACzF,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,IAAI,EAAE,YAAY,CAAC;IACnB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC;IACvB;8FAC0F;IAC1F,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAClD;+FAC2F;IAC3F,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,2FAA2F;IAC3F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;iGAC6F;IAC7F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,uFAAuF;AACvF,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,CAAC,EAAE,CAAC,CAAC;IACL,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd;8DAC0D;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;gFAC4E;IAC5E,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B;AAED,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,OAAO,EAAE,MAAM,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAClD,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAYD;4FAC4F;AAC5F,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,GAAG,gBAAgB,CAmErF;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,yFAAyF;AACzF,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAO3E;AAED;wFACwF;AACxF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,kBAAkB,EAC3B,UAAU,EAAE,MAAM,GACjB,iBAAiB,GAAG,IAAI,CAwC1B;AAED,mEAAmE;AACnE,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,kBAAkB,EAC3B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,iBAAiB,GACxB,IAAI,CAEN"}
+{"version":3,"file":"web-deeplink.d.ts","sourceRoot":"","sources":["../../../../src/link/v5/web-deeplink.ts"],"names":[],"mappings":"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"}

package/dist/types/rpc/phantasma.d.ts

@@ -25,6 +25,8 @@ interface RpcPeer {
 }
 export interface PhantasmaAPIOptions {
     maxRpcResponseBytes?: number;
+    /** Optional API key sent in the X-Api-Key header on every RPC request. */
+    apiKey?: string;
 }
 export declare const DEFAULT_MAX_RPC_RESPONSE_BYTES: number;
 export declare class PhantasmaAPI {
@@ -34,12 +36,15 @@ export declare class PhantasmaAPI {
     availableHosts: RpcPeer[];
     maxRpcResponseBytes: number;
     private nextRpcRequestId;
+    private apiKey?;
     private nextJsonRpcRequestId;
+    private rpcHeaders;
     pingAsync(host: string): Promise<number>;
     constructor(defHost: string, peersUrlJson: string | undefined | null, nexus: string, options?: PhantasmaAPIOptions);
     JSONRPCResult<T = unknown>(method: string, params: JsonRpcParam[]): Promise<RpcResult<T>>;
     JSONRPC(method: string, params: JsonRpcParam[]): Promise<unknown>;
     setMaxRpcResponseBytes(maxBytes: number): this;
+    setApiKey(apiKey: string): this;
     setRpcHost(rpcHost: string): void;
     setRpcByName(rpcName: string): void;
     setNexus(nexus: string): void;

package/dist/types/rpc/phantasma.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"phantasma.d.ts","sourceRoot":"","sources":["../../../src/rpc/phantasma.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"phantasma.d.ts","sourceRoot":"","sources":["../../../src/rpc/phantasma.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phantasma-sdk-ts",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Typescript SDK for interacting with the Phantasma Chain",
   "author": "Phantasma Team",
   "main": "dist/cjs/index.js",

package/spec/phantasma-link-v5.md

@@ -7,11 +7,12 @@ This is an engineering specification and the source of truth for the dApp↔wall
 connection protocol.
 
 Design constraints:
+
 - Own relay (self-hosted), JSON envelope, keep loopback.
 - Deeplink ping-pong = primary path for the ~99% small requests AND relay-independent
   (a relay outage must not break normal signing). Relay = large payloads (~1% "fat" tx)
-  + cross-device. Universal-link domain = the dedicated subdomain `link.phantasma.info`
-  (not the main site; see §17).
+  - cross-device. Universal-link domain = the dedicated subdomain `link.phantasma.info`
+    (not the main site; see §17).
 - Budget from chain: 1 MiB metadata struct (~750 KB image) / 32 MiB max tx.
 
 ---
@@ -19,6 +20,7 @@ Design constraints:
 ## 1. Goals / non-goals
 
 Goals:
+
 1. **iOS support** via deeplink (the immediate driver). Works without a wallet-hosted
    local server (impossible on iOS).
 2. **Remove the artificial size cap.** Carry transactions up to the real chain
@@ -32,12 +34,14 @@ Goals:
    drift).
 
 Non-goals (v5):
+
 - Replacing on-chain data with hash-references; images stay on-chain, inside the tx.
 - Multi-wallet-aggregator UX, WalletConnect interop (this protocol runs its own relay;
   WC bridging could be a later additive capability).
 - Changing any chain/validator/RPC behavior. v5 is purely the transport+envelope.
 
 ## 2. Terminology
+
 - **dApp**: the requesting app (web page, native app, game). Holds NO keys.
 - **Wallet**: holds keys, shows approval UI, signs. (PoltergeistLite desktop, Ecto
   extension, ecto-mobile, future native apps.)
@@ -51,6 +55,7 @@ Non-goals (v5):
   dApp and a wallet that can't reach each other directly (§6.4).
 
 ## 3. Architecture at a glance
+
 ```
             ┌─────────────── ONE JSON envelope (§4) ───────────────┐
             │                                                        │
@@ -60,6 +65,7 @@ Non-goals (v5):
   selection: injected → loopback → deeplink(small) → relay(big/x-device)
   resilience: deeplink(small) works even if relay is down.
 ```
+
 The dApp calls high-level SDK methods (`signTransaction`, …). The SDK builds an
 envelope and picks a transport. The wallet implements ONE envelope handler regardless
 of transport. Wake/handoff on mobile is always via deeplink; data moves over the
@@ -71,28 +77,45 @@ All messages are UTF-8 JSON. Binary fields are **base64** (NOT hex - halves wire
 size vs the old protocol). One logical request = one envelope; correlation by `id`.
 
 Request:
+
 ```json
 {
   "plv": 5,
-  "id": "f1c2…",            // unique per request (uuid v4 or monotonic+session)
-  "session": "s_9a8b…",     // omitted only on the very first connect/pair
+  "id": "f1c2…", // unique per request (uuid v4 or monotonic+session)
+  "session": "s_9a8b…", // omitted only on the very first connect/pair
   "method": "pha_signTransaction",
-  "params": { /* method-specific, named fields */ }
+  "params": {
+    /* method-specific, named fields */
+  }
 }
 ```
+
 Success response:
+
 ```json
-{ "plv": 5, "id": "f1c2…", "result": { /* method-specific */ } }
+{
+  "plv": 5,
+  "id": "f1c2…",
+  "result": {
+    /* method-specific */
+  }
+}
 ```
+
 Error response:
+
 ```json
 { "plv": 5, "id": "f1c2…", "error": { "code": 4001, "message": "User rejected", "data": null } }
 ```
+
 Wallet→dApp events (no `id` reply expected):
+
 ```json
 { "plv": 5, "type": "event", "session": "s_9a8b…", "event": "pha_accountsChanged", "data": { … } }
 ```
+
 Rules:
+
 - `plv` MUST be 5. A peer that doesn't recognize it errors `-32600`.
 - Unknown `method` → `-32601`; bad params → `-32602`; malformed JSON → `-32700`.
 - No positional args, no `,`/`/` delimiters, no version-gated arg layouts. New fields
@@ -102,9 +125,11 @@ Rules:
   MUST correlate responses by `id` (no global single-in-flight flag like v1-v4).
 
 ## 5. Capability handshake (replaces the magic version int)
+
 At connect/pair, both sides exchange capabilities once; cached in the session.
 
 Wallet → dApp (in the `pha_connect` result):
+
 ```json
 {
   "wallet": { "name": "Poltergeist Lite", "version": "x.y.z", "icon": "https://…" },
@@ -118,6 +143,7 @@ Wallet → dApp (in the `pha_connect` result):
   "account": { "address": "P2K…", "name": "…", "balances": [ … ] }
 }
 ```
+
 dApp → wallet (in `pha_connect` params): dApp metadata `{ name, url, icon, description }`,
 requested `chains`, `methods`, desired `features`, and the dApp public key for E2E (§8).
 
@@ -130,6 +156,7 @@ features are additive capabilities; no new protocol version forks every implemen
 The SDK selects in this order; each is described below.
 
 ### 6.1 Injected (browser extension wallet - Ecto)
+
 - The extension injects a provider on the page. Envelopes pass page→content→background
   via the extension messaging bridge (as today, but carrying the v5 envelope).
 - Detection: provider object present on `window`.
@@ -137,6 +164,7 @@ The SDK selects in this order; each is described below.
 - Best UX on desktop when the extension is installed.
 
 ### 6.2 Loopback (desktop browser/app ↔ desktop wallet) - KEPT
+
 - The desktop wallet runs a **loopback-only** WebSocket server (rebuilt on a vetted
   library, bound to 127.0.0.1/localhost ONLY - fix the v1-v4 `IPAddress.Any`), path
   `/phantasma/v5`, carrying v5 envelopes (text frames; large messages allowed).
@@ -148,9 +176,11 @@ The SDK selects in this order; each is described below.
   available; loopback callers without a verifiable origin get a clearly-labeled prompt.
 
 ### 6.3 Deeplink ping-pong (mobile, small requests) - PRIMARY, RELAY-INDEPENDENT
+
 For the ~99% of requests that fit in a URL. No server, no relay.
 
 Flow (request):
+
 1. SDK serializes the envelope, seals it with the session key (§8, §18.2), base64url-encodes
    the sealed frame, and builds a link routed by the pairing topic:
    `https://link.phantasma.info/v5/req#t=<topic>&f=<b64url(sealed frame)>`
@@ -173,6 +203,7 @@ the SDK MUST fall back to the relay (§6.4). Small signs (authorize, signMessage
 tx) stay on deeplink even with the relay down - satisfying the resilience rule.
 
 dApp-type routing:
+
 - NATIVE-app dApp ↔ wallet app: clean deeplink ping-pong (return via the dApp's own
   scheme/universal link). Relay-independent.
 - WEB-page dApp on mobile: the return would reopen the browser tab (page reload). So
@@ -181,6 +212,7 @@ dApp-type routing:
   smooth normally, still works when the relay is down.
 
 Security notes:
+
 - Universal links are domain-verified (only the app the OS associated with
   link.phantasma.info can claim them) → resistant to the custom-scheme hijack where a
   malicious app registers `phantasma://`. Custom scheme is fallback only.
@@ -188,6 +220,7 @@ Security notes:
   fallback scheme can't read request/result contents.
 
 ### 6.4 Relay (large payloads + cross-device) - self-hosted, E2E-blind
+
 For "fat" transactions (image-bearing, up to chain limits) and desktop-dApp↔phone-wallet.
 
 Model: a self-hosted pub/sub server. Each session has a **topic**. Either side
@@ -205,6 +238,7 @@ useful elsewhere - Rust dApp tooling / any future chain-aware relay feature - bu
 core relay does not depend on it.)
 
 Flow (request, mobile):
+
 1. (Session already paired - see §7.) dApp encrypts the envelope, publishes to the topic.
 2. dApp opens a small deeplink to WAKE the wallet (no payload in the URL - just a nudge to
    foreground the wallet, which then drains its pairings' mailboxes): `https://link.phantasma.info/v5/wake`.
@@ -228,13 +262,14 @@ Relay outage degrades gracefully: big tx + cross-device unavailable; everyday si
 keeps working.
 
 ## 7. Pairing & sessions
+
 - **Pairing** (one-time) creates a Session. Two entry points:
   - Same-device mobile: dApp opens a `…/link/v5/pair?…` universal link; wallet prompts
     the user to approve, returns its capabilities + account + its E2E public key.
   - Cross-device: dApp shows a QR encoding the pairing URI; the phone wallet scans it.
 - **Session** (persistent on BOTH sides, surviving wallet restarts):
   `{ sessionId, dappMeta, account, chains, methods, features, sharedKey(material),
-  createdAt, expiresAt }`. The user picks the lifetime at approval (session / 1h / 1d /
+createdAt, expiresAt }`. The user picks the lifetime at approval (session / 1h / 1d /
   1mo / always). The wallet has a **revocation UI** listing active sessions.
 - Re-connect: `pha_connect` with an existing `sessionId` resumes without a new prompt
   (until expiry/revoke). Account/chain changes are pushed as events (§9).
@@ -261,6 +296,7 @@ keeps working.
     full history.
 
 ## 8. Encryption & keys
+
 - Every transport EXCEPT injected/loopback-with-trusted-origin carries E2E-encrypted
   payloads. Deeplink and relay payloads are ALWAYS encrypted (they traverse the OS / the
   relay).
@@ -299,7 +335,9 @@ keeps working.
 ## 9. Method catalog (v5)
 
 ### 9.1 Naming principles (durability)
+
 The v1-v4 names are NOT durable and are redesigned here. Rules:
+
 1. **No internal codenames in public names.** `signCarbonTxAndBroadcast` bakes the
    Gen3 codename "Carbon" into the API - it ages the moment the codename changes or a
    second format exists. Methods are named by WHAT they do; the tx format is advertised
@@ -315,12 +353,14 @@ The v1-v4 names are NOT durable and are redesigned here. Rules:
    This maximizes durability and external-dev familiarity (and any future WC bridge).
 5. Keep genuine Phantasma domain terms (e.g. `nexus`) as FIELDS, not as cryptic method
    names.
-Prefix: **`pha_`** (mirrors `eth_`).
+   Prefix: **`pha_`** (mirrors `eth_`).
 
 Names are namespaced `pha_*`. Params/results are JSON objects (named). Binary = base64.
 
 ### 9.2 Methods
+
 Connection / session:
+
 - `pha_connect` - pair or resume. Params: dappMeta, requested chains/methods/features,
   dApp pubkey. Result: capability handshake (§5) incl. account(s) + session.
 - `pha_disconnect` - end session.
@@ -331,6 +371,7 @@ Connection / session:
   `getWalletVersion` and `getPeer`).
 
 Signing / sending (the transaction FORMAT is an explicit param - see §9.4):
+
 - `pha_signMessage` - sign an arbitrary message (base64). Result: signature + the random
   the wallet prepended. Non-tx-forgeable (§8). (was `signData`)
 - `pha_signTransaction` - `{ format, tx }` → sign ONLY, return the assembled signed tx
@@ -342,6 +383,7 @@ Signing / sending (the transaction FORMAT is an explicit param - see §9.4):
   broadcast / `signCarbonTxAndBroadcast`)
 
 Read:
+
 - `pha_invokeScript` - read-only VM invoke (eth_call-like); Result: decoded results[].
   (was `invokeScript` / `invokeRawScript`)
 
@@ -354,21 +396,24 @@ Events (wallet→dApp): `pha_accountsChanged`, `pha_chainChanged`, `pha_sessionD
 unsolicited connect result pushed right after pairing approval; see §9.5).
 
 ### 9.3 Legacy → v5 name map (for migration + the compat shim)
-| v1-v4 | v5 |
-|---|---|
-| `authorize` | `pha_connect` |
-| `getAccount` | `pha_getAccounts` |
-| `getNexus` | `pha_getChains` (nexus as field) |
-| `getPeer` / `getWalletVersion` | `pha_getWalletInfo` |
-| `signData` | `pha_signMessage` |
+
+| v1-v4                                                                   | v5                                          |
+| ----------------------------------------------------------------------- | ------------------------------------------- |
+| `authorize`                                                             | `pha_connect`                               |
+| `getAccount`                                                            | `pha_getAccounts`                           |
+| `getNexus`                                                              | `pha_getChains` (nexus as field)            |
+| `getPeer` / `getWalletVersion`                                          | `pha_getWalletInfo`                         |
+| `signData`                                                              | `pha_signMessage`                           |
 | `signTx` (no broadcast) / `signTxSignature` / `signPrebuiltTransaction` | `pha_signTransaction` (sign-only, `format`) |
-| `signTx` (broadcast) / `signCarbonTxAndBroadcast` | `pha_sendTransaction` (`format`) |
-| `invokeScript` / `invokeRawScript` | `pha_invokeScript` |
-| `getN3Address`, `writeArchive`, `multiSig` | DROPPED in v5 |
+| `signTx` (broadcast) / `signCarbonTxAndBroadcast`                       | `pha_sendTransaction` (`format`)            |
+| `invokeScript` / `invokeRawScript`                                      | `pha_invokeScript`                          |
+| `getN3Address`, `writeArchive`, `multiSig`                              | DROPPED in v5                               |
 
 ### 9.4 Transaction formats (how the wallet picks the RPC endpoint)
+
 The chain accepts two DISTINCT signed-transaction formats, each via its OWN RPC
 submission endpoint:
+
 - **`script`** - the classic Phantasma `Transaction` (nexus/chain/script/payload/
   expiration/signatures) → RPC `SendRawTransaction` (`Transaction.Unserialize`,
   `network.SendRawPhantasmaTransaction`). Still used on Gen3 for VM/contract-lifecycle
@@ -387,11 +432,13 @@ format later = a new enum value + capability, never a new method. This is exactl
 keeps the signing surface durable while honoring the real two-endpoint RPC.
 
 ### 9.5 Method contracts
+
 Per-method params, results, and edge cases.
 
 **`pha_connect`** - params `{ dapp:{name,url,icon,description}, pubkey, chains[],
 methods[], features[] }`; result = capability handshake (§5) + the granted `account` +
 `session{ id, expiresAt }`.
+
 - The wallet returns the GRANTED capabilities, which MAY be a subset of what was
   requested (WC-style partial approval); the dApp inspects what it actually got.
 - Resume = `pha_connect` carrying an existing `session` id → no prompt unless
@@ -413,6 +460,7 @@ via the same node; no keys/approval involved.
 
 **`pha_signMessage`** - params `{ message:base64, display?:string }`; result
 `{ signature:base64, random:base64 }`. Construction + non-forgeability: §8.
+
 - `signature` is the RAW 64-byte Ed25519 DETACHED signature over
   `DOMAIN_TAG || random || message` (not a kind-prefixed envelope), signed by the
   account's Phantasma key - verifiable with any NaCl stack against the public key
@@ -421,6 +469,7 @@ via the same node; no keys/approval involved.
 **`pha_signTransaction`** - params `{ format:"script"|"carbon", tx:base64,
 signatureKind?, pow? }`; result `{ signedTx:base64 }` (does NOT broadcast - the dApp
 submits it). Covers the prebuilt-sign flow (e.g. token deployment).
+
 - `pow` (ProofOfWork enum: None/Minimal/Moderate/Hard/Heavy/Extreme) is meaningful ONLY
   for `format:"script"` (Phantasma-VM PoW); ignored for `carbon`.
 - For PREBUILT script transactions the wallet does NOT mine pow: mining would mutate the
@@ -444,6 +493,7 @@ equally call the node directly.
 **Events** (wallet→dApp): `pha_accountsChanged{accounts}`, `pha_chainChanged{chain}`,
 `pha_sessionDeleted{session}`, `pha_sessionExpired{session}`,
 `pha_sessionEstablished{<pha_connect result>}`.
+
 - Transport caveat: live events require a PERSISTENT transport (injected / loopback /
   relay subscription). A stateless deeplink-ping-pong session has no open channel, so it
   does NOT receive pushed events; such a dApp re-queries account/chain on its next
@@ -458,6 +508,7 @@ equally call the node directly.
   first connection is a single user gesture.
 
 ### 9.6 `format` values: `"script"` | `"carbon"`
+
 Classic `Transaction` is, in practice, the **script-carrying** tx (its only present-day
 use is a VM script), so `"script"` (not the ambiguous `"phantasma"`). Carbon stays
 `"carbon"` (the real system term: `SendCarbonTransaction`/`CarbonBlob`). Nuance kept
@@ -465,7 +516,9 @@ honest: a Carbon `TxMsgPhantasma` ALSO wraps a script, but it is still the `carb
 envelope - routing is by ENVELOPE/serialization, not by "contains a script".
 
 ### 9.7 Multi-platform signing
+
 `signatureKind` selects WHICH KEY signs a **Phantasma** transaction/message:
+
 - `Ed25519` → the Phantasma key; `ECDSA` → the secp256k1 key (used by ETH/BSC-interop
   accounts). Both sign the SAME Phantasma tx bytes (`transaction.ToByteArray(false)`) - a
   Phantasma tx can carry an ECDSA signature when the account is ETH-key-backed.
@@ -481,20 +534,23 @@ The value selects the key that signs the Phantasma payload. Native Ethereum/BSC
 signing and broadcast is NOT part of v5 (a possible future additive capability).
 
 ## 10. Error codes
+
 JSON-RPC reserved:
+
 - `-32700` parse error, `-32600` invalid request, `-32601` method not found,
   `-32602` invalid params, `-32603` internal error.
-App-level (EIP-1193-aligned where sensible):
+  App-level (EIP-1193-aligned where sensible):
 - `4001` user rejected, `4100` unauthorized / no valid session, `4900` wallet
   disconnected / locked, `4902` unsupported chain.
-Phantasma-specific:
+  Phantasma-specific:
 - `5001` payload too large (carries `maxPayloadBytes` in `data`), `5002` nexus/chain
   mismatch, `5003` unsupported signature kind, `5004` capability not supported,
   `5100` session expired, `5101` session revoked.
-Errors are STRUCTURED (`{code,message,data}`) - no more free-text string matching like
-v1-v4 (e.g. `startsWith('nexus mismatch')`).
+  Errors are STRUCTURED (`{code,message,data}`) - no more free-text string matching like
+  v1-v4 (e.g. `startsWith('nexus mismatch')`).
 
 ## 11. Sizes & budget
+
 - `maxPayloadBytes` advertised per transport in the handshake. Defaults: deeplink 8192
   (conservative URL budget), loopback/relay 32 MiB (chain max-tx).
 - An image-bearing token/NFT tx is bounded by the chain's 1 MiB metadata struct
@@ -507,6 +563,7 @@ v1-v4 (e.g. `startsWith('nexus mismatch')`).
   `{ msgId, seq, total, chunk }` frames defined in §16, reassembled before decryption.
 
 ## 12. Backward compatibility & migration
+
 - Wallets run BOTH dispatchers in parallel:
   - Legacy v1-v4 string protocol (`{id},authorize/…`) - unchanged, for existing dApps.
   - v5 envelope - detected by the structured `pha_connect` / `plv:5` handshake (and the
@@ -517,6 +574,7 @@ v1-v4 (e.g. `startsWith('nexus mismatch')`).
 - ecto-mobile MUST stop vendoring an old SDK copy and consume the canonical SDK.
 
 ## 13. Reference implementation & conformance
+
 - ONE reference implementation of the v5 envelope + transports in `phantasma-sdk-ts`
   (`src/link/v5/`; canonical per workspace rule; never reimplement VM/script/serialization - reuse the
   SDK). Wallets consume it: Ecto/ecto-mobile via the TS SDK; PoltergeistLite via the C#
@@ -526,6 +584,7 @@ v1-v4 (e.g. `startsWith('nexus mismatch')`).
   cases, handshake, encryption KATs). Parity is already a mandatory SDK rule.
 
 ## 14. Security considerations (summary)
+
 - E2E encryption on deeplink + relay; relay is blind; no secret in any URL (ECDH).
 - Universal links (domain-verified) primary; custom scheme fallback only;
   `link.phantasma.info` must serve `apple-app-site-association` + Android `assetlinks.json`.
@@ -538,6 +597,7 @@ v1-v4 (e.g. `startsWith('nexus mismatch')`).
 - Relay abuse controls (rate-limit, topic auth, message TTL) - design in the relay spec.
 
 ## 15. Pairing URI + handshake
+
 A pairing URI carries everything needed to bootstrap an encrypted session. It is shown as
 a QR (cross-device: desktop dApp → phone wallet) or opened as a deeplink (same-device).
 
@@ -547,18 +607,22 @@ key-establishment method (full crypto in §18). Everything sensitive sits in the
 logs never see it; the OS still hands the full URL (incl. fragment) to the app.
 
 PRIMARY - universal link or QR (channels a relay/other app cannot intercept):
+
 ```
 https://link.phantasma.info/v5/pair#v=5&t=<topic>&relay=<host>&sk=<symKey b64url>&meta=<dappMetaB64>
 ```
+
 - `sk` = a random 32-byte SESSION KEY (CSPRNG). Safe to place here because a universal link
   is domain-verified (only the link.phantasma.info-associated app receives it - no
   scheme-squatter) and a QR is optical/user-mediated. The relay NEVER sees `sk`. → no MITM.
 
 FALLBACK - custom scheme `phantasma://v5/pair#…` (last resort; a scheme-squatting app
 could read it), so NO secret goes in it:
+
 ```
 phantasma://v5/pair#v=5&t=<topic>&relay=<host>&pk=<dappX25519Pub b64url>
 ```
+
 - `pk` = the dApp's EPHEMERAL X25519 PUBLIC key; the session key is derived by ECDH (§18).
   No secret in the URL.
 
@@ -566,6 +630,7 @@ Common fields: `t` = topic (32 random bytes, b64url, the relay channel id); `rel
 (or omitted → default); `meta` (dApp name/url/icon) MAY instead be sent encrypted.
 
 Handshake:
+
 1. dApp creates the topic + the key material (a `symKey` for the primary channel, OR an
    ephemeral X25519 keypair for the custom-scheme fallback), builds the URI, subscribes to
    the topic on the relay, and shows the QR / opens the deeplink.
@@ -587,11 +652,13 @@ Handshake:
 Crypto construction, MITM analysis, nonces, and replay handling are specified in §18.
 
 ## 16. Relay protocol
+
 A dumb, E2E-blind pub/sub over WSS. Self-hosted with the explorer (§6.4).
 
 Frames (JSON): `{ op, topic, id?, payload? }`, `op ∈ { subscribe, unsubscribe, publish,
 deliver, ack, error }`. `payload` is OPAQUE ciphertext (NaCl box, §8) - the relay never
 decrypts.
+
 - **Routing**: by `topic` (the 32-byte pairing id). The relay forwards a `publish` on a
   topic to every other subscriber of that topic as `deliver`.
 - **Mailbox / TTL**: if no subscriber is currently connected (e.g. the wallet hasn't been
@@ -616,9 +683,11 @@ decrypts.
 - The relay needs NO Phantasma SDK and does NO chain logic.
 
 ## 17. Deeplinks & universal-link hosting
+
 Paths under `https://link.phantasma.info/v5/` (and mirrored `phantasma://v5/…`):
+
 - `/pair` - pairing (§15).
-- `/req`  - small same-device request: `#t=<topic>&f=<b64url(sealed frame)>`
+- `/req` - small same-device request: `#t=<topic>&f=<b64url(sealed frame)>`
   (sealed payload in the fragment, routed by the pairing topic; the session id is inside the
   envelope and the callback is the one fixed at pairing; size-gated per §6.3).
 - `/wake` - foreground the wallet so it reconnects to the relay and drains its pairings'
@@ -627,6 +696,7 @@ Paths under `https://link.phantasma.info/v5/` (and mirrored `phantasma://v5/…`
   link; web: an https URL) with `#plv=5&t=<topic>&f=<b64url(sealed frame)>`.
 
 Hosting - on a DEDICATED SUBDOMAIN `link.phantasma.info`, NOT the main website:
+
 - Why a subdomain: universal links / App Links are per-host; a subdomain is its own host
   for verification, so it works identically to a root domain. This keeps the whole feature
   off the main phantasma.info site. The ONLY change to existing infra is a DNS record.
@@ -647,12 +717,14 @@ Hosting - on a DEDICATED SUBDOMAIN `link.phantasma.info`, NOT the main website:
   only; universal/app links are primary (domain-verified, anti-hijack).
 
 ## 18. Cryptographic construction
+
 Primitive: NaCl **`secretbox` (XSalsa20-Poly1305)** for EVERY session message, under one
 32-byte session key. X25519 is used ONLY for the custom-scheme fallback's key
 establishment. Everything is standard NaCl, wire-interoperable across the §8 packages
 (`tweetnacl` / `crypto_box` / `NaCl.Net` / `x/crypto/nacl` / libsodium).
 
 ### 18.1 Session-key establishment (channel decides)
+
 Refinement of the earlier "no secret in URL" rule - the accurate rule is "no secret in a
 HIJACKABLE url". A symmetric key is the simplest STRONG design where the delivery channel
 is itself safe; ECDH is the fallback for the one hijackable channel:
@@ -665,7 +737,7 @@ is itself safe; ECDH is the fallback for the one hijackable channel:
   than ECDH on these paths.
 - **Custom scheme (FALLBACK, hijackable):** no `symKey` in the URL. X25519 ECDH instead -
   dApp ephemeral pub in the URL (public, useless to a squatter), wallet ephemeral pub
-  returned over the relay, both derive the key via `box.before`. 
+  returned over the relay, both derive the key via `box.before`.
   - MITM analysis: only PUBLIC keys travel; a passive relay/3rd party cannot derive the
     key. An ACTIVE compromised relay could swap the wallet's returned pubkey - but this is
     ONE-SIDED: the relay can spoof the wallet→dApp direction, yet it CANNOT derive the
@@ -680,6 +752,7 @@ is itself safe; ECDH is the fallback for the one hijackable channel:
 Either path yields one 32-byte session key; the channel is uniform `secretbox` thereafter.
 
 ### 18.2 Per-message
+
 - `nonce` = 24 CSPRNG bytes per message (XSalsa20's 192-bit nonce → random nonces are
   collision-safe; no cross-transport counter coordination needed).
 - `ct` = `secretbox(utf8(envelope_json), nonce, sessionKey)`.
@@ -689,6 +762,7 @@ Either path yields one 32-byte session key; the channel is uniform `secretbox` t
   `nonce`; the session binds a monotonic sequence.
 
 ### 18.3 Key hygiene
+
 - The session key and any X25519 ephemerals are EPHEMERAL per pairing, in-memory only,
   rotated on re-pair, destroyed on disconnect/expiry/revoke.
 - They are NEVER the account signing key: Ed25519/ECDSA are used strictly for signing