@meshconnect/uwc-types 0.12.1 → 0.13.0-snapshot.3776809

package/dist/UWC-state.d.ts

@@ -85,16 +85,10 @@ export interface WalletConnectProvider {
 export interface TonConnectWalletProvider {
     supportedNetworkIds: NetworkId[];
     /**
-     * Override for the app_name used to look up this wallet in the TonConnect
-     * wallets-v2.json list. The SDK resolves bridgeUrl + universalLink from
-     * this key at connect time.
-     *
-     * Defaults to jsBridgeKey (from extensionInjectedProvider.namespaceMetaData.tvm)
-     * which works for most wallets (e.g. Tonkeeper: jsBridgeKey = app_name = 'tonkeeper').
-     *
-     * Only needed when the wallet list app_name differs from jsBridgeKey.
-     * Example: OKX has jsBridgeKey 'okxTonWallet' (shared by both apps) but
-     * two wallet list entries — 'okxWallet' (standalone) vs 'okxTonWallet' (trading app).
+     * app_name used to look up this wallet in the TonConnect wallets-v2.json list
+     * (the SDK resolves bridgeUrl + universalLink from it). Defaults to jsBridgeKey,
+     * which is correct for most wallets; set it only when the list's app_name
+     * differs — e.g. OKX (jsBridgeKey 'okxTonWallet', wallet-list entry 'okxWallet').
      */
     walletListAppName?: string;
 }
@@ -102,6 +96,13 @@ export interface TonConnectWalletProvider {
 export interface TonConnectConfig {
     manifestUrl: string | (() => string);
     walletsListSource?: string;
+    /**
+     * Fired once, synchronously, when a session is resumed from storage instead of
+     * a fresh handshake (just before connect() resolves its ConnectorResult).
+     * Intended for a single telemetry tag (e.g. restored: true). Optional —
+     * omitting it keeps restoration working, only the signal is dropped.
+     */
+    onSessionRestored?: () => void;
 }
 export interface WalletMetadata<T = Record<string, any>> {
     id: string;

package/dist/UWC-state.d.ts.map

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

package/dist/connector.d.ts

@@ -76,5 +76,11 @@ export interface Connector {
      */
     sendTransaction?(request: TransactionRequest, provider?: ExtensionInjectedProvider | IntegratedBrowserInjectedProvider | WalletConnectProvider | TonConnectWalletProvider): Promise<TransactionResult>;
     getWalletCapabilities?(from: string, networks: Network[]): Promise<Record<string, EVMCapabilities>>;
+    /**
+     * Sign a Solana tx without broadcasting — raw bytes in/out (no @solana/web3.js
+     * for callers). Fee-payer relay flows: the wallet adds only the user's
+     * signature, the relay broadcasts. Optional; not all connectors support it.
+     */
+    signSolanaTransactionBytes?(serializedTx: Uint8Array): Promise<Uint8Array>;
 }
 //# sourceMappingURL=connector.d.ts.map

package/dist/connector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../src/connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACjD,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,iCAAiC,EACjC,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,EACf,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,kBAAkB,EAAE,gBAAgB,EAAE,CAAA;IACtC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,kBAAkB,CAAC,EAAE,gBAAgB,EAAE,CAAA;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;OAKG;IAEH,OAAO,CACL,OAAO,EAAE,OAAO,EAChB,QAAQ,CAAC,EACL,yBAAyB,GACzB,iCAAiC,GACjC,qBAAqB,GACrB,wBAAwB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAAA;IAE3B;;;;;;;OAOG;IACH,gBAAgB,CAAC,IAAI,MAAM,CAAA;IAE3B;;;;OAIG;IACH,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAE5B;;;;;OAKG;IAEH,aAAa,CACX,OAAO,EAAE,OAAO,EAChB,QAAQ,CAAC,EACL,yBAAyB,GACzB,iCAAiC,GACjC,qBAAqB,GACrB,wBAAwB,GAC3B,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAE/B;;;;;;OAMG;IACH,mBAAmB,CAAC,CAClB,SAAS,EAAE,SAAS,EACpB,eAAe,CAAC,EAAE,cAAc,EAAE,GACjC,OAAO,CACN,yBAAyB,EAAE,GAC3B,wBAAwB,EAAE,GAC1B,sBAAsB,EAAE,GACxB,qBAAqB,EAAE,CAC1B,CAAA;IAED;;;;;OAKG;IACH,WAAW,CAAC,CACV,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EACL,yBAAyB,GACzB,iCAAiC,GACjC,qBAAqB,GACrB,wBAAwB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAAA;IAEzB;;;;;OAKG;IACH,eAAe,CAAC,CACd,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,CAAC,EACL,yBAAyB,GACzB,iCAAiC,GACjC,qBAAqB,GACrB,wBAAwB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAE7B,qBAAqB,CAAC,CACpB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,EAAE,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAA;CAC5C"}
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../src/connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACjD,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,iCAAiC,EACjC,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,EACf,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,kBAAkB,EAAE,gBAAgB,EAAE,CAAA;IACtC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,kBAAkB,CAAC,EAAE,gBAAgB,EAAE,CAAA;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;OAKG;IAEH,OAAO,CACL,OAAO,EAAE,OAAO,EAChB,QAAQ,CAAC,EACL,yBAAyB,GACzB,iCAAiC,GACjC,qBAAqB,GACrB,wBAAwB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAAA;IAE3B;;;;;;;OAOG;IACH,gBAAgB,CAAC,IAAI,MAAM,CAAA;IAE3B;;;;OAIG;IACH,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAE5B;;;;;OAKG;IAEH,aAAa,CACX,OAAO,EAAE,OAAO,EAChB,QAAQ,CAAC,EACL,yBAAyB,GACzB,iCAAiC,GACjC,qBAAqB,GACrB,wBAAwB,GAC3B,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAE/B;;;;;;OAMG;IACH,mBAAmB,CAAC,CAClB,SAAS,EAAE,SAAS,EACpB,eAAe,CAAC,EAAE,cAAc,EAAE,GACjC,OAAO,CACN,yBAAyB,EAAE,GAC3B,wBAAwB,EAAE,GAC1B,sBAAsB,EAAE,GACxB,qBAAqB,EAAE,CAC1B,CAAA;IAED;;;;;OAKG;IACH,WAAW,CAAC,CACV,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EACL,yBAAyB,GACzB,iCAAiC,GACjC,qBAAqB,GACrB,wBAAwB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAAA;IAEzB;;;;;OAKG;IACH,eAAe,CAAC,CACd,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,CAAC,EACL,yBAAyB,GACzB,iCAAiC,GACjC,qBAAqB,GACrB,wBAAwB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAE7B,qBAAqB,CAAC,CACpB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,EAAE,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAA;IAE3C;;;;OAIG;IACH,0BAA0B,CAAC,CAAC,YAAY,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;CAC3E"}

package/dist/index.d.ts

@@ -10,4 +10,5 @@ export * from './react-hooks';
 export * from './signature';
 export * from './transactions';
 export * from './errors';
+export * from './solana-message';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,kBAAkB,CAAA"}

package/dist/index.js

@@ -10,4 +10,5 @@ export * from './react-hooks';
 export * from './signature';
 export * from './transactions';
 export * from './errors';
+export * from './solana-message';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,kBAAkB,CAAA"}

package/dist/react-hooks.d.ts

@@ -230,6 +230,18 @@ export interface UseSignMessageReturn {
      */
     error: WalletError | undefined;
 }
+/**
+ * Return type for useSignSolanaTransaction — sign-only Solana signing (bytes in,
+ * bytes out) for fee-payer relay flows where the relay, not the wallet, broadcasts.
+ * @example
+ * const signed = await signSolanaTransaction(unsignedBytes)
+ */
+export interface UseSignSolanaTransactionReturn {
+    /** Sign serialized tx bytes without broadcasting. Throws if no wallet / signing fails. */
+    signSolanaTransaction: (serializedTx: Uint8Array) => Promise<Uint8Array>;
+    isLoading: boolean;
+    error: WalletError | undefined;
+}
 /**
  * Return type for the useTransaction hook
  * Provides transaction sending functionality with loading state and result

package/dist/react-hooks.d.ts.map

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

package/dist/solana-message.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Solana tx wire-format helpers (pure byte ops, no @solana/web3.js).
+ * Wire format: [shortvec sigCount] [sigCount × 64-byte sigs] [message bytes].
+ * Used to confirm a wallet only ADDED a signature and didn't change the message.
+ */
+/** Offset where the message begins, or -1 if the tx bytes are malformed. */
+export declare function solanaMessageOffset(serializedTx: Uint8Array): number;
+/** V0 messages set the high bit (0x80) on the first message byte; legacy don't. */
+export declare function isVersionedTransactionBytes(serializedTx: Uint8Array): boolean;
+/**
+ * Throw unless `returned` keeps the byte-identical message of `sent` — signing
+ * may only add a signature. Compares the message region only (sigs differ).
+ */
+export declare function assertSameMessage(sent: Uint8Array, returned: Uint8Array): void;
+//# sourceMappingURL=solana-message.d.ts.map

package/dist/solana-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solana-message.d.ts","sourceRoot":"","sources":["../src/solana-message.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,UAAU,GAAG,MAAM,CAoBpE;AAED,mFAAmF;AACnF,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,UAAU,GAAG,OAAO,CAI7E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,UAAU,GACnB,IAAI,CAuBN"}

package/dist/solana-message.js

@@ -0,0 +1,60 @@
+/**
+ * Solana tx wire-format helpers (pure byte ops, no @solana/web3.js).
+ * Wire format: [shortvec sigCount] [sigCount × 64-byte sigs] [message bytes].
+ * Used to confirm a wallet only ADDED a signature and didn't change the message.
+ */
+/** Offset where the message begins, or -1 if the tx bytes are malformed. */
+export function solanaMessageOffset(serializedTx) {
+    let offset = 0;
+    let sigCount = 0;
+    let shift = 0;
+    let terminated = false;
+    // shortvec: little-endian base-128, continuation bit 0x80.
+    while (offset < serializedTx.length) {
+        const byte = serializedTx[offset];
+        sigCount |= (byte & 0x7f) << shift;
+        offset++;
+        if ((byte & 0x80) === 0) {
+            terminated = true;
+            break;
+        }
+        shift += 7;
+        if (shift >= 32)
+            return -1;
+    }
+    if (!terminated)
+        return -1;
+    const messageStart = offset + sigCount * 64;
+    return messageStart >= serializedTx.length ? -1 : messageStart;
+}
+/** V0 messages set the high bit (0x80) on the first message byte; legacy don't. */
+export function isVersionedTransactionBytes(serializedTx) {
+    const messageStart = solanaMessageOffset(serializedTx);
+    if (messageStart < 0)
+        return false;
+    return (serializedTx[messageStart] & 0x80) !== 0;
+}
+/**
+ * Throw unless `returned` keeps the byte-identical message of `sent` — signing
+ * may only add a signature. Compares the message region only (sigs differ).
+ */
+export function assertSameMessage(sent, returned) {
+    const sentStart = solanaMessageOffset(sent);
+    const returnedStart = solanaMessageOffset(returned);
+    if (sentStart < 0 || returnedStart < 0) {
+        throw new Error('Malformed Solana transaction: cannot locate message bytes');
+    }
+    // Signing fills a pre-allocated slot, so the sig count (hence the offset)
+    // can't change. A different offset = added/dropped signer → reject.
+    if (sentStart !== returnedStart) {
+        throw new Error('Signed transaction does not match the request — signature layout changed');
+    }
+    const sentMsg = sent.subarray(sentStart);
+    const returnedMsg = returned.subarray(returnedStart);
+    const tampered = sentMsg.length !== returnedMsg.length ||
+        sentMsg.some((byte, i) => byte !== returnedMsg[i]);
+    if (tampered) {
+        throw new Error('Signed transaction does not match the request — wallet returned a different transaction');
+    }
+}
+//# sourceMappingURL=solana-message.js.map

package/dist/solana-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solana-message.js","sourceRoot":"","sources":["../src/solana-message.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4EAA4E;AAC5E,MAAM,UAAU,mBAAmB,CAAC,YAAwB;IAC1D,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,IAAI,QAAQ,GAAG,CAAC,CAAA;IAChB,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,UAAU,GAAG,KAAK,CAAA;IACtB,2DAA2D;IAC3D,OAAO,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAE,CAAA;QAClC,QAAQ,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,CAAA;QAClC,MAAM,EAAE,CAAA;QACR,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,UAAU,GAAG,IAAI,CAAA;YACjB,MAAK;QACP,CAAC;QACD,KAAK,IAAI,CAAC,CAAA;QACV,IAAI,KAAK,IAAI,EAAE;YAAE,OAAO,CAAC,CAAC,CAAA;IAC5B,CAAC;IACD,IAAI,CAAC,UAAU;QAAE,OAAO,CAAC,CAAC,CAAA;IAC1B,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,EAAE,CAAA;IAC3C,OAAO,YAAY,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAA;AAChE,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,2BAA2B,CAAC,YAAwB;IAClE,MAAM,YAAY,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAA;IACtD,IAAI,YAAY,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA;IAClC,OAAO,CAAC,YAAY,CAAC,YAAY,CAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAgB,EAChB,QAAoB;IAEpB,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAA;IAC3C,MAAM,aAAa,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAA;IACnD,IAAI,SAAS,GAAG,CAAC,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;IAC9E,CAAC;IACD,0EAA0E;IAC1E,oEAAoE;IACpE,IAAI,SAAS,KAAK,aAAa,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,0EAA0E,CAC3E,CAAA;IACH,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;IACxC,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAA;IACpD,MAAM,QAAQ,GACZ,OAAO,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;IACpD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,yFAAyF,CAC1F,CAAA;IACH,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshconnect/uwc-types",
-  "version": "0.12.1",
+  "version": "0.13.0-snapshot.3776809",
   "description": "TypeScript types for Universal Wallet Connector",
   "type": "module",
   "main": "dist/index.js",

package/src/UWC-state.ts

@@ -103,16 +103,10 @@ export interface WalletConnectProvider {
 export interface TonConnectWalletProvider {
   supportedNetworkIds: NetworkId[]
   /**
-   * Override for the app_name used to look up this wallet in the TonConnect
-   * wallets-v2.json list. The SDK resolves bridgeUrl + universalLink from
-   * this key at connect time.
-   *
-   * Defaults to jsBridgeKey (from extensionInjectedProvider.namespaceMetaData.tvm)
-   * which works for most wallets (e.g. Tonkeeper: jsBridgeKey = app_name = 'tonkeeper').
-   *
-   * Only needed when the wallet list app_name differs from jsBridgeKey.
-   * Example: OKX has jsBridgeKey 'okxTonWallet' (shared by both apps) but
-   * two wallet list entries — 'okxWallet' (standalone) vs 'okxTonWallet' (trading app).
+   * app_name used to look up this wallet in the TonConnect wallets-v2.json list
+   * (the SDK resolves bridgeUrl + universalLink from it). Defaults to jsBridgeKey,
+   * which is correct for most wallets; set it only when the list's app_name
+   * differs — e.g. OKX (jsBridgeKey 'okxTonWallet', wallet-list entry 'okxWallet').
    */
   walletListAppName?: string
 }
@@ -121,6 +115,13 @@ export interface TonConnectWalletProvider {
 export interface TonConnectConfig {
   manifestUrl: string | (() => string)
   walletsListSource?: string
+  /**
+   * Fired once, synchronously, when a session is resumed from storage instead of
+   * a fresh handshake (just before connect() resolves its ConnectorResult).
+   * Intended for a single telemetry tag (e.g. restored: true). Optional —
+   * omitting it keeps restoration working, only the signal is dropped.
+   */
+  onSessionRestored?: () => void
 }
 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any

package/src/connector.ts

@@ -141,4 +141,11 @@ export interface Connector {
     from: string,
     networks: Network[]
   ): Promise<Record<string, EVMCapabilities>>
+
+  /**
+   * Sign a Solana tx without broadcasting — raw bytes in/out (no @solana/web3.js
+   * for callers). Fee-payer relay flows: the wallet adds only the user's
+   * signature, the relay broadcasts. Optional; not all connectors support it.
+   */
+  signSolanaTransactionBytes?(serializedTx: Uint8Array): Promise<Uint8Array>
 }

package/src/index.ts

@@ -10,3 +10,4 @@ export * from './react-hooks'
 export * from './signature'
 export * from './transactions'
 export * from './errors'
+export * from './solana-message'

package/src/react-hooks.ts

@@ -258,6 +258,21 @@ export interface UseSignMessageReturn {
   error: WalletError | undefined
 }
 
+// useSignSolanaTransaction hook types
+
+/**
+ * Return type for useSignSolanaTransaction — sign-only Solana signing (bytes in,
+ * bytes out) for fee-payer relay flows where the relay, not the wallet, broadcasts.
+ * @example
+ * const signed = await signSolanaTransaction(unsignedBytes)
+ */
+export interface UseSignSolanaTransactionReturn {
+  /** Sign serialized tx bytes without broadcasting. Throws if no wallet / signing fails. */
+  signSolanaTransaction: (serializedTx: Uint8Array) => Promise<Uint8Array>
+  isLoading: boolean
+  error: WalletError | undefined
+}
+
 // useTransaction hook types
 
 /**

package/src/solana-message.test.ts

@@ -0,0 +1,111 @@
+import { describe, it, expect } from 'vitest'
+import {
+  solanaMessageOffset,
+  isVersionedTransactionBytes,
+  assertSameMessage
+} from './solana-message'
+
+/**
+ * Build a fake serialized tx: [sigCount (single shortvec byte, <128)]
+ * + sigCount × 64 signature bytes + message bytes.
+ */
+function makeTx(
+  sigCount: number,
+  message: number[],
+  sigFill: (slot: number) => number[] = () => new Array(64).fill(0)
+): Uint8Array {
+  const sigs: number[] = []
+  for (let s = 0; s < sigCount; s++) sigs.push(...sigFill(s))
+  return Uint8Array.from([sigCount, ...sigs, ...message])
+}
+
+describe('solanaMessageOffset', () => {
+  it('points just past the signature array', () => {
+    expect(solanaMessageOffset(makeTx(1, [0x01, 0x02]))).toBe(1 + 64)
+    expect(solanaMessageOffset(makeTx(2, [0x01]))).toBe(1 + 128)
+  })
+
+  it('returns -1 when the shortvec never terminates', () => {
+    expect(solanaMessageOffset(Uint8Array.from([0x80, 0x80, 0x80]))).toBe(-1)
+  })
+
+  it('returns -1 when the signatures overrun the buffer', () => {
+    // Claims 2 sigs (128 bytes) but only 10 bytes follow.
+    expect(
+      solanaMessageOffset(Uint8Array.from([0x02, ...new Array(10).fill(0)]))
+    ).toBe(-1)
+  })
+
+  it('returns -1 when there is no message after the signatures', () => {
+    // 1 sig (64 bytes), nothing after → offset lands exactly at the end.
+    expect(
+      solanaMessageOffset(Uint8Array.from([0x01, ...new Array(64).fill(0)]))
+    ).toBe(-1)
+  })
+})
+
+describe('isVersionedTransactionBytes', () => {
+  it('true when the first message byte sets the version high bit', () => {
+    expect(isVersionedTransactionBytes(makeTx(1, [0x80, 0x00]))).toBe(true)
+  })
+
+  it('false for a legacy message', () => {
+    expect(isVersionedTransactionBytes(makeTx(1, [0x01, 0x00]))).toBe(false)
+  })
+
+  it('false for malformed bytes', () => {
+    expect(isVersionedTransactionBytes(Uint8Array.from([0x80, 0x80]))).toBe(
+      false
+    )
+  })
+})
+
+describe('assertSameMessage', () => {
+  const message = [0x09, 0x08, 0x07, 0x06]
+
+  it('passes when only the signature differs (freshly signed tx)', () => {
+    // Relay fee-payer in slot 0 (unchanged), user signs slot 1.
+    const sent = makeTx(2, message, () => new Array(64).fill(0))
+    const signed = makeTx(2, message, slot =>
+      new Array(64).fill(slot === 1 ? 0xff : 0)
+    )
+    expect(() => assertSameMessage(sent, signed)).not.toThrow()
+  })
+
+  it('throws when the signature count changes, even if message bytes match', () => {
+    // returned drops a signature slot (2 → 1) but keeps the same message bytes;
+    // the offset shifts, so a naive message-only compare would wrongly pass.
+    const sent = makeTx(2, message)
+    const returnedFewerSlots = makeTx(1, message)
+    expect(() => assertSameMessage(sent, returnedFewerSlots)).toThrow(
+      'signature layout changed'
+    )
+  })
+
+  it('throws when message bytes change (tampered recipient/amount)', () => {
+    const sent = makeTx(1, message)
+    const tampered = makeTx(1, [0x09, 0x08, 0x07, 0x05]) // last byte flipped
+    expect(() => assertSameMessage(sent, tampered)).toThrow(
+      'Signed transaction does not match the request'
+    )
+  })
+
+  it('throws when the message length changes', () => {
+    const sent = makeTx(1, message)
+    const longer = makeTx(1, [...message, 0x00])
+    expect(() => assertSameMessage(sent, longer)).toThrow(
+      'Signed transaction does not match the request'
+    )
+  })
+
+  it('throws on malformed input (cannot locate message)', () => {
+    const sent = makeTx(1, message)
+    const malformed = Uint8Array.from([0x80, 0x80])
+    expect(() => assertSameMessage(sent, malformed)).toThrow(
+      'Malformed Solana transaction'
+    )
+    expect(() => assertSameMessage(malformed, sent)).toThrow(
+      'Malformed Solana transaction'
+    )
+  })
+})

package/src/solana-message.ts

@@ -0,0 +1,67 @@
+/**
+ * Solana tx wire-format helpers (pure byte ops, no @solana/web3.js).
+ * Wire format: [shortvec sigCount] [sigCount × 64-byte sigs] [message bytes].
+ * Used to confirm a wallet only ADDED a signature and didn't change the message.
+ */
+
+/** Offset where the message begins, or -1 if the tx bytes are malformed. */
+export function solanaMessageOffset(serializedTx: Uint8Array): number {
+  let offset = 0
+  let sigCount = 0
+  let shift = 0
+  let terminated = false
+  // shortvec: little-endian base-128, continuation bit 0x80.
+  while (offset < serializedTx.length) {
+    const byte = serializedTx[offset]!
+    sigCount |= (byte & 0x7f) << shift
+    offset++
+    if ((byte & 0x80) === 0) {
+      terminated = true
+      break
+    }
+    shift += 7
+    if (shift >= 32) return -1
+  }
+  if (!terminated) return -1
+  const messageStart = offset + sigCount * 64
+  return messageStart >= serializedTx.length ? -1 : messageStart
+}
+
+/** V0 messages set the high bit (0x80) on the first message byte; legacy don't. */
+export function isVersionedTransactionBytes(serializedTx: Uint8Array): boolean {
+  const messageStart = solanaMessageOffset(serializedTx)
+  if (messageStart < 0) return false
+  return (serializedTx[messageStart]! & 0x80) !== 0
+}
+
+/**
+ * Throw unless `returned` keeps the byte-identical message of `sent` — signing
+ * may only add a signature. Compares the message region only (sigs differ).
+ */
+export function assertSameMessage(
+  sent: Uint8Array,
+  returned: Uint8Array
+): void {
+  const sentStart = solanaMessageOffset(sent)
+  const returnedStart = solanaMessageOffset(returned)
+  if (sentStart < 0 || returnedStart < 0) {
+    throw new Error('Malformed Solana transaction: cannot locate message bytes')
+  }
+  // Signing fills a pre-allocated slot, so the sig count (hence the offset)
+  // can't change. A different offset = added/dropped signer → reject.
+  if (sentStart !== returnedStart) {
+    throw new Error(
+      'Signed transaction does not match the request — signature layout changed'
+    )
+  }
+  const sentMsg = sent.subarray(sentStart)
+  const returnedMsg = returned.subarray(returnedStart)
+  const tampered =
+    sentMsg.length !== returnedMsg.length ||
+    sentMsg.some((byte, i) => byte !== returnedMsg[i])
+  if (tampered) {
+    throw new Error(
+      'Signed transaction does not match the request — wallet returned a different transaction'
+    )
+  }
+}