@meshconnect/uwc-wallet-connect-connector 0.4.17 → 0.5.0

package/dist/services/solana/solana-transaction-service.d.ts

@@ -13,5 +13,11 @@ export declare class SolanaTransactionService {
     private sendNativeTransaction;
     private sendSplTokenTransaction;
     private submitTransaction;
+    /**
+     * Sign Solana tx bytes over WalletConnect WITHOUT broadcasting (relay submits).
+     * Bytes in/out (legacy or v0); only deserializes if the wallet returns a bare
+     * signature instead of the full tx.
+     */
+    signTransactionBytes(client: SignClient, session: SessionTypes.Struct, serializedTx: Uint8Array, chainId: string, activeAddress: string): Promise<Uint8Array>;
 }
 //# sourceMappingURL=solana-transaction-service.d.ts.map

package/dist/services/solana/solana-transaction-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"solana-transaction-service.d.ts","sourceRoot":"","sources":["../../../src/services/solana/solana-transaction-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EAIb,wBAAwB,EACzB,MAAM,wBAAwB,CAAA;AAO/B,OAAO,KAAK,UAAU,MAAM,4BAA4B,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAOxD,qBAAa,wBAAwB;IAGvB,OAAO,CAAC,aAAa;IAFjC,OAAO,CAAC,OAAO,CAA0B;gBAErB,aAAa,GAAE,aAAkB;IAIrD;;OAEG;IACG,eAAe,CACnB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,YAAY,CAAC,MAAM,EAC5B,OAAO,EAAE,wBAAwB,EACjC,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC;YAsCJ,mCAAmC;YAuCnC,qBAAqB;YAsCrB,uBAAuB;YAuCvB,iBAAiB;CAqGhC"}
+{"version":3,"file":"solana-transaction-service.d.ts","sourceRoot":"","sources":["../../../src/services/solana/solana-transaction-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EAIb,wBAAwB,EACzB,MAAM,wBAAwB,CAAA;AAW/B,OAAO,KAAK,UAAU,MAAM,4BAA4B,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAOxD,qBAAa,wBAAwB;IAGvB,OAAO,CAAC,aAAa;IAFjC,OAAO,CAAC,OAAO,CAA0B;gBAErB,aAAa,GAAE,aAAkB;IAIrD;;OAEG;IACG,eAAe,CACnB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,YAAY,CAAC,MAAM,EAC5B,OAAO,EAAE,wBAAwB,EACjC,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC;YAsCJ,mCAAmC;YAuCnC,qBAAqB;YAsCrB,uBAAuB;YAuCvB,iBAAiB;IAsG/B;;;;OAIG;IACG,oBAAoB,CACxB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,YAAY,CAAC,MAAM,EAC5B,YAAY,EAAE,UAAU,EACxB,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,UAAU,CAAC;CAyDvB"}

package/dist/services/solana/solana-transaction-service.js

@@ -1,3 +1,4 @@
+import { assertSameMessage, isVersionedTransactionBytes } from '@meshconnect/uwc-types';
 import { VersionedTransaction, PublicKey, Connection, Transaction } from '@solana/web3.js';
 import { standardizeSignature } from '../../utils/encoding-utils';
 import { parseError } from '../../utils/error-utils';
@@ -174,5 +175,52 @@ export class SolanaTransactionService {
             throw signAndSendError;
         }
     }
+    /**
+     * Sign Solana tx bytes over WalletConnect WITHOUT broadcasting (relay submits).
+     * Bytes in/out (legacy or v0); only deserializes if the wallet returns a bare
+     * signature instead of the full tx.
+     */
+    async signTransactionBytes(client, session, serializedTx, chainId, activeAddress) {
+        try {
+            // WalletConnect spec: the transaction param is base64.
+            const serializedBase64 = Buffer.from(serializedTx).toString('base64');
+            const result = await client.request({
+                topic: session.topic,
+                chainId,
+                request: {
+                    method: 'solana_signTransaction',
+                    params: { transaction: serializedBase64 }
+                }
+            });
+            // Full signed tx back (Phantom/Solflare) — verify only a signature was added.
+            if ('transaction' in result) {
+                const returned = new Uint8Array(Buffer.from(result.transaction, 'base64'));
+                assertSameMessage(serializedTx, returned);
+                return returned;
+            }
+            // Bare signature back (legacy WC) — splice it into our original bytes.
+            if ('signature' in result) {
+                const signatureBytes = base58.decode(result.signature);
+                // ed25519 sigs are 64 bytes; reject early with a clear error.
+                if (signatureBytes.length !== 64) {
+                    throw new Error('WalletConnect returned a malformed Solana signature (expected 64 bytes)');
+                }
+                const userPubkey = new PublicKey(activeAddress);
+                if (isVersionedTransactionBytes(serializedTx)) {
+                    const tx = VersionedTransaction.deserialize(serializedTx);
+                    tx.addSignature(userPubkey, signatureBytes);
+                    return tx.serialize();
+                }
+                const tx = Transaction.from(serializedTx);
+                tx.addSignature(userPubkey, Buffer.from(signatureBytes));
+                // verifySignatures:false — the relay's fee-payer slot is still unsigned here.
+                return new Uint8Array(tx.serialize({ verifySignatures: false }));
+            }
+            throw new Error('WalletConnect returned an unexpected response shape for solana_signTransaction');
+        }
+        catch (error) {
+            throw parseError(error);
+        }
+    }
 }
 //# sourceMappingURL=solana-transaction-service.js.map

package/dist/services/solana/solana-transaction-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"solana-transaction-service.js","sourceRoot":"","sources":["../../../src/services/solana/solana-transaction-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"solana-transaction-service.js","sourceRoot":"","sources":["../../../src/services/solana/solana-transaction-service.ts"],"names":[],"mappings":"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"}

package/dist/services/transaction-service.d.ts

@@ -14,5 +14,11 @@ export declare class TransactionService {
      * Send a transaction with the connected wallet
      */
     sendTransaction(request: TransactionRequest): Promise<TransactionResult>;
+    /**
+     * Sign-only path for Solana transactions over WalletConnect.
+     * Mirrors the validation done in sendTransaction but routes to the sign-only Solana flow
+     * instead of signAndSend. Used by fee-payer relay flows where the relay server broadcasts.
+     */
+    signSolanaTransactionBytes(serializedTx: Uint8Array): Promise<Uint8Array>;
 }
 //# sourceMappingURL=transaction-service.d.ts.map

package/dist/services/transaction-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction-service.d.ts","sourceRoot":"","sources":["../../src/services/transaction-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EAGjB,aAAa,EACd,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAIxD;;GAEG;AACH,qBAAa,kBAAkB;IAK3B,OAAO,CAAC,mBAAmB;IAC3B,OAAO,CAAC,iBAAiB;IAL3B,OAAO,CAAC,eAAe,CAA4B;IACnD,OAAO,CAAC,aAAa,CAA0B;gBAGrC,mBAAmB,EAAE,mBAAmB,EACxC,iBAAiB,EAAE,iBAAiB,EAC5C,aAAa,GAAE,aAAkB;IAMnC;;OAEG;IACG,eAAe,CACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;CAyC9B"}
+{"version":3,"file":"transaction-service.d.ts","sourceRoot":"","sources":["../../src/services/transaction-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EAGjB,aAAa,EACd,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAIxD;;GAEG;AACH,qBAAa,kBAAkB;IAK3B,OAAO,CAAC,mBAAmB;IAC3B,OAAO,CAAC,iBAAiB;IAL3B,OAAO,CAAC,eAAe,CAA4B;IACnD,OAAO,CAAC,aAAa,CAA0B;gBAGrC,mBAAmB,EAAE,mBAAmB,EACxC,iBAAiB,EAAE,iBAAiB,EAC5C,aAAa,GAAE,aAAkB;IAMnC;;OAEG;IACG,eAAe,CACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;IA0C7B;;;;OAIG;IACG,0BAA0B,CAC9B,YAAY,EAAE,UAAU,GACvB,OAAO,CAAC,UAAU,CAAC;CAiCvB"}

package/dist/services/transaction-service.js

@@ -45,5 +45,30 @@ export class TransactionService {
             throw new Error(`Unsupported namespace: ${namespace}`);
         }
     }
+    /**
+     * Sign-only path for Solana transactions over WalletConnect.
+     * Mirrors the validation done in sendTransaction but routes to the sign-only Solana flow
+     * instead of signAndSend. Used by fee-payer relay flows where the relay server broadcasts.
+     */
+    async signSolanaTransactionBytes(serializedTx) {
+        const session = this.connectionService.getSession();
+        if (!session) {
+            throw new Error('No active session. Please connect first.');
+        }
+        const activeNetwork = this.connectionService.getActiveNetwork();
+        const activeAddress = this.connectionService.getActiveAddress();
+        if (!activeNetwork) {
+            throw new Error('No active network. Please connect first.');
+        }
+        if (!activeAddress) {
+            throw new Error('No active address. Please connect first.');
+        }
+        const namespace = activeNetwork.id.split(':')[0];
+        if (namespace !== 'solana') {
+            throw new Error(`signSolanaTransactionBytes requires a Solana network (got namespace "${namespace}")`);
+        }
+        const client = await this.walletConnectClient.getClient();
+        return this.solanaService.signTransactionBytes(client, session, serializedTx, activeNetwork.id, activeAddress);
+    }
 }
 //# sourceMappingURL=transaction-service.js.map

package/dist/services/transaction-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"transaction-service.js","sourceRoot":"","sources":["../../src/services/transaction-service.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAA;AACpF,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAA;AAE9E;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAKnB;IACA;IALF,eAAe,CAA4B;IAC3C,aAAa,CAA0B;IAE/C,YACU,mBAAwC,EACxC,iBAAoC,EAC5C,gBAA+B,EAAE;QAFzB,wBAAmB,GAAnB,mBAAmB,CAAqB;QACxC,sBAAiB,GAAjB,iBAAiB,CAAmB;QAG5C,IAAI,CAAC,eAAe,GAAG,IAAI,0BAA0B,EAAE,CAAA;QACvD,IAAI,CAAC,aAAa,GAAG,IAAI,wBAAwB,CAAC,aAAa,CAAC,CAAA;IAClE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CACnB,OAA2B;QAE3B,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,CAAA;QACnD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;QAC7D,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,EAAE,CAAA;QAC/D,MAAM,aAAa,GAAG,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,EAAE,CAAA;QAE/D,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;QAC7D,CAAC;QAED,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;QAC7D,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,CAAA;QAEzD,sCAAsC;QACtC,MAAM,SAAS,GAAG,aAAa,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QAEhD,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,eAAe,CAAC,eAAe,CACzC,MAAM,EACN,OAAO,EACP,OAAqC,EACrC,aAAa,CAAC,EAAE,CACjB,CAAA;QACH,CAAC;aAAM,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,aAAa,CAAC,eAAe,CACvC,MAAM,EACN,OAAO,EACP,OAAmC,EACnC,aAAa,CAAC,EAAE,EAChB,aAAa,CACd,CAAA;QACH,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,0BAA0B,SAAS,EAAE,CAAC,CAAA;QACxD,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"transaction-service.js","sourceRoot":"","sources":["../../src/services/transaction-service.ts"],"names":[],"mappings":"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"}

package/dist/wallet-connect-connector.d.ts

@@ -13,5 +13,13 @@ export declare class WalletConnectConnector implements Connector {
     switchNetwork(network: Network): Promise<SwitchNetworkResult>;
     signMessage(message: string): Promise<SignatureType>;
     sendTransaction(request: TransactionRequest): Promise<TransactionResult>;
+    /**
+     * Sign a Solana transaction over WalletConnect without broadcasting.
+     * Mirrors InjectedConnector.signSolanaTransactionBytes so the core router can branch on
+     * connection mode without the call sites caring which connector backs the active wallet.
+     *
+     * Used by fee-payer relay flows (Mesh BE owns broadcast); never broadcasts via the wallet.
+     */
+    signSolanaTransactionBytes(serializedTx: Uint8Array): Promise<Uint8Array>;
 }
 //# sourceMappingURL=wallet-connect-connector.d.ts.map

package/dist/wallet-connect-connector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wallet-connect-connector.d.ts","sourceRoot":"","sources":["../src/wallet-connect-connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACd,MAAM,wBAAwB,CAAA;AAO/B,qBAAa,sBAAuB,YAAW,SAAS;IACtD,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,iBAAiB,CAAmB;IAC5C,OAAO,CAAC,oBAAoB,CAAsB;IAClD,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,kBAAkB,CAAoB;IAC9C,OAAO,CAAC,aAAa,CAAe;gBAExB,MAAM,EAAE,mBAAmB,EAAE,aAAa,GAAE,aAAkB;IAmBpE,OAAO,CACX,OAAO,EAAE,OAAO,EAChB,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,OAAO,CAAC,eAAe,CAAC;IAU3B,gBAAgB,IAAI,MAAM;IAQpB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI7D,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIpD,eAAe,CACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;CAG9B"}
+{"version":3,"file":"wallet-connect-connector.d.ts","sourceRoot":"","sources":["../src/wallet-connect-connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACd,MAAM,wBAAwB,CAAA;AAO/B,qBAAa,sBAAuB,YAAW,SAAS;IACtD,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,iBAAiB,CAAmB;IAC5C,OAAO,CAAC,oBAAoB,CAAsB;IAClD,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,kBAAkB,CAAoB;IAC9C,OAAO,CAAC,aAAa,CAAe;gBAExB,MAAM,EAAE,mBAAmB,EAAE,aAAa,GAAE,aAAkB;IAmBpE,OAAO,CACX,OAAO,EAAE,OAAO,EAChB,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,OAAO,CAAC,eAAe,CAAC;IAU3B,gBAAgB,IAAI,MAAM;IAQpB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI7D,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIpD,eAAe,CACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;IAI7B;;;;;;OAMG;IACG,0BAA0B,CAC9B,YAAY,EAAE,UAAU,GACvB,OAAO,CAAC,UAAU,CAAC;CAGvB"}

package/dist/wallet-connect-connector.js

@@ -43,5 +43,15 @@ export class WalletConnectConnector {
     async sendTransaction(request) {
         return this.transactionService.sendTransaction(request);
     }
+    /**
+     * Sign a Solana transaction over WalletConnect without broadcasting.
+     * Mirrors InjectedConnector.signSolanaTransactionBytes so the core router can branch on
+     * connection mode without the call sites caring which connector backs the active wallet.
+     *
+     * Used by fee-payer relay flows (Mesh BE owns broadcast); never broadcasts via the wallet.
+     */
+    async signSolanaTransactionBytes(serializedTx) {
+        return this.transactionService.signSolanaTransactionBytes(serializedTx);
+    }
 }
 //# sourceMappingURL=wallet-connect-connector.js.map

package/dist/wallet-connect-connector.js.map

@@ -1 +1 @@
-{"version":3,"file":"wallet-connect-connector.js","sourceRoot":"","sources":["../src/wallet-connect-connector.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAEnE,MAAM,OAAO,sBAAsB;IACzB,mBAAmB,CAAqB;IACxC,iBAAiB,CAAmB;IACpC,oBAAoB,CAAsB;IAC1C,gBAAgB,CAAkB;IAClC,kBAAkB,CAAoB;IACtC,aAAa,CAAe;IAEpC,YAAY,MAA2B,EAAE,gBAA+B,EAAE;QACxE,IAAI,CAAC,mBAAmB,GAAG,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAA;QAC1D,IAAI,CAAC,aAAa,GAAG,aAAa,CAAA;QAClC,IAAI,CAAC,iBAAiB,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;QACxE,IAAI,CAAC,oBAAoB,GAAG,IAAI,oBAAoB,CAClD,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,iBAAiB,CACvB,CAAA;QACD,IAAI,CAAC,gBAAgB,GAAG,IAAI,gBAAgB,CAC1C,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,iBAAiB,CACvB,CAAA;QACD,IAAI,CAAC,kBAAkB,GAAG,IAAI,kBAAkB,CAC9C,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,iBAAiB,EACtB,IAAI,CAAC,aAAa,CACnB,CAAA;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CACX,OAAgB,EAChB,QAAgC;QAEhC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAA;QACH,CAAC;QAED,OAAO,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAC1D,CAAC;IAED,gBAAgB;QACd,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,EAAE,CAAA;QACrD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAA;QACvE,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,CAAA;IAC5C,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAgB;QAClC,OAAO,IAAI,CAAC,oBAAoB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;IACzD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAe;QAC/B,OAAO,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;IACnD,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,OAA2B;QAE3B,OAAO,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;IACzD,CAAC;CACF"}
+{"version":3,"file":"wallet-connect-connector.js","sourceRoot":"","sources":["../src/wallet-connect-connector.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAEnE,MAAM,OAAO,sBAAsB;IACzB,mBAAmB,CAAqB;IACxC,iBAAiB,CAAmB;IACpC,oBAAoB,CAAsB;IAC1C,gBAAgB,CAAkB;IAClC,kBAAkB,CAAoB;IACtC,aAAa,CAAe;IAEpC,YAAY,MAA2B,EAAE,gBAA+B,EAAE;QACxE,IAAI,CAAC,mBAAmB,GAAG,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAA;QAC1D,IAAI,CAAC,aAAa,GAAG,aAAa,CAAA;QAClC,IAAI,CAAC,iBAAiB,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;QACxE,IAAI,CAAC,oBAAoB,GAAG,IAAI,oBAAoB,CAClD,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,iBAAiB,CACvB,CAAA;QACD,IAAI,CAAC,gBAAgB,GAAG,IAAI,gBAAgB,CAC1C,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,iBAAiB,CACvB,CAAA;QACD,IAAI,CAAC,kBAAkB,GAAG,IAAI,kBAAkB,CAC9C,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,iBAAiB,EACtB,IAAI,CAAC,aAAa,CACnB,CAAA;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CACX,OAAgB,EAChB,QAAgC;QAEhC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAA;QACH,CAAC;QAED,OAAO,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAC1D,CAAC;IAED,gBAAgB;QACd,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,EAAE,CAAA;QACrD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAA;QACvE,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,CAAA;IAC5C,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAgB;QAClC,OAAO,IAAI,CAAC,oBAAoB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;IACzD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAe;QAC/B,OAAO,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;IACnD,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,OAA2B;QAE3B,OAAO,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;IACzD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,0BAA0B,CAC9B,YAAwB;QAExB,OAAO,IAAI,CAAC,kBAAkB,CAAC,0BAA0B,CAAC,YAAY,CAAC,CAAA;IACzE,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshconnect/uwc-wallet-connect-connector",
-  "version": "0.4.17",
+  "version": "0.5.0",
   "description": "WalletConnect connector for Universal Wallet Connector",
   "type": "module",
   "main": "dist/index.js",
@@ -24,7 +24,7 @@
     "bs58": "6.0.0",
     "buffer": "^6.0.3",
     "viem": "^2.44.4",
-    "@meshconnect/uwc-types": "0.13.0"
+    "@meshconnect/uwc-types": "0.14.0"
   },
   "devDependencies": {
     "typescript": "^5.9.3"

package/src/services/solana/solana-transaction-service.test.ts

@@ -0,0 +1,402 @@
+// @vitest-environment node
+// Reason: @solana/web3.js + @solana/buffer-layout fail `instanceof Uint8Array` checks under
+// jsdom because Buffer in the polyfilled env is not the same prototype the layout library
+// checks against. Running this file in node fixes the encoding pipeline without affecting
+// the rest of the suite (which stays on jsdom for DOM-dependent tests).
+import { describe, it, expect, vi, beforeEach } from 'vitest'
+import { SolanaTransactionService } from './solana-transaction-service'
+import {
+  Keypair,
+  PublicKey,
+  Transaction,
+  SystemProgram,
+  VersionedTransaction,
+  TransactionMessage
+} from '@solana/web3.js'
+import { Buffer } from 'buffer'
+import base58 from 'bs58'
+import type SignClient from '@walletconnect/sign-client'
+import type { SessionTypes } from '@walletconnect/types'
+
+const SOL_CHAIN_ID = 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp'
+const MOCK_TOPIC = 'mock-session-topic'
+
+// We sign with a real keypair so the test exercises the full bytes-in / bytes-out contract:
+// produce a signature locally, hand it to the service via the mocked WC response, and verify
+// the returned bytes deserialize cleanly.
+const userKeypair = Keypair.generate()
+const recipient = Keypair.generate().publicKey
+
+function buildLegacyTx(blockhash: string): Transaction {
+  const tx = new Transaction()
+  tx.recentBlockhash = blockhash
+  tx.feePayer = userKeypair.publicKey
+  tx.add(
+    SystemProgram.transfer({
+      fromPubkey: userKeypair.publicKey,
+      toPubkey: recipient,
+      lamports: 1
+    })
+  )
+  return tx
+}
+
+function buildVersionedTx(blockhash: string): VersionedTransaction {
+  const message = new TransactionMessage({
+    payerKey: userKeypair.publicKey,
+    recentBlockhash: blockhash,
+    instructions: [
+      SystemProgram.transfer({
+        fromPubkey: userKeypair.publicKey,
+        toPubkey: recipient,
+        lamports: 1
+      })
+    ]
+  }).compileToV0Message()
+  return new VersionedTransaction(message)
+}
+
+function makeMockSignClient(
+  response: { transaction: string } | { signature: string }
+): { request: ReturnType<typeof vi.fn>; client: SignClient } {
+  const request = vi.fn().mockResolvedValue(response)
+  return {
+    request,
+    client: { request } as unknown as SignClient
+  }
+}
+
+const mockSession = { topic: MOCK_TOPIC } as SessionTypes.Struct
+
+describe('SolanaTransactionService.signTransactionBytes', () => {
+  let service: SolanaTransactionService
+
+  beforeEach(() => {
+    service = new SolanaTransactionService()
+  })
+
+  it('decodes the {transaction} response shape directly without re-signing locally (V0)', async () => {
+    // Modern wallets (Phantom, Solflare) return the fully-signed tx as base64 — we should not
+    // touch web3.js at all in this branch. We simulate the wallet's signature by signing the
+    // V0 tx with the user keypair and base64-encoding the result.
+    const blockhash = '11111111111111111111111111111111'
+    const unsigned = buildVersionedTx(blockhash)
+    const signedLocally = buildVersionedTx(blockhash)
+    signedLocally.sign([userKeypair])
+    const fullySignedBase64 = Buffer.from(signedLocally.serialize()).toString(
+      'base64'
+    )
+
+    const { request, client } = makeMockSignClient({
+      transaction: fullySignedBase64
+    })
+
+    const result = await service.signTransactionBytes(
+      client,
+      mockSession,
+      unsigned.serialize(),
+      SOL_CHAIN_ID,
+      userKeypair.publicKey.toBase58()
+    )
+
+    expect(request).toHaveBeenCalledWith({
+      topic: MOCK_TOPIC,
+      chainId: SOL_CHAIN_ID,
+      request: {
+        method: 'solana_signTransaction',
+        params: { transaction: expect.any(String) }
+      }
+    })
+    // Bytes round-trip: result should deserialize as a signed VersionedTransaction.
+    const out = VersionedTransaction.deserialize(result)
+    expect(out.signatures.length).toBeGreaterThan(0)
+    // Signature must be from the user's keypair, not zero-bytes.
+    const isAllZero = out.signatures[0]?.every((b: number) => b === 0)
+    expect(isAllZero).toBe(false)
+  })
+
+  it('handles the {signature} response shape by splicing into a V0 tx', async () => {
+    // Older WC wallets return only the bare signature; the service must add it to the input.
+    const blockhash = '11111111111111111111111111111111'
+    const unsigned = buildVersionedTx(blockhash)
+    const signedLocally = buildVersionedTx(blockhash)
+    signedLocally.sign([userKeypair])
+    const wireSignature = base58.encode(signedLocally.signatures[0]!)
+
+    const { request, client } = makeMockSignClient({ signature: wireSignature })
+
+    const result = await service.signTransactionBytes(
+      client,
+      mockSession,
+      unsigned.serialize(),
+      SOL_CHAIN_ID,
+      userKeypair.publicKey.toBase58()
+    )
+
+    expect(request).toHaveBeenCalled()
+    const out = VersionedTransaction.deserialize(result)
+    // Must contain the signature we returned, attached to the user account.
+    expect(out.signatures[0]).toBeDefined()
+    expect(Array.from(out.signatures[0]!)).toEqual(
+      Array.from(signedLocally.signatures[0]!)
+    )
+  })
+
+  it('handles the {signature} response shape by splicing into a legacy tx', async () => {
+    const blockhash = '11111111111111111111111111111111'
+    const unsigned = buildLegacyTx(blockhash)
+    // Sign locally to produce the wire signature the wallet would have returned.
+    const signedLocally = buildLegacyTx(blockhash)
+    signedLocally.sign(userKeypair)
+    const userSig = signedLocally.signatures.find(s =>
+      s.publicKey.equals(userKeypair.publicKey)
+    )!.signature!
+    const wireSignature = base58.encode(userSig)
+
+    const { client } = makeMockSignClient({ signature: wireSignature })
+
+    const result = await service.signTransactionBytes(
+      client,
+      mockSession,
+      unsigned.serialize({ requireAllSignatures: false }),
+      SOL_CHAIN_ID,
+      userKeypair.publicKey.toBase58()
+    )
+
+    const out = Transaction.from(result)
+    const sigEntry = out.signatures.find(s =>
+      s.publicKey.equals(userKeypair.publicKey)
+    )
+    expect(sigEntry?.signature).not.toBeNull()
+    expect(Array.from(sigEntry!.signature!)).toEqual(Array.from(userSig))
+  })
+
+  it('never calls solana_signAndSendTransaction (sign-only contract)', async () => {
+    // Critical for fee-payer relay: if this path ever broadcasts, the relay server's signature
+    // never lands on-chain because the wallet's own RPC fronts the tx with insufficient fee
+    // payer balance. Lock this in.
+    const blockhash = '11111111111111111111111111111111'
+    const unsigned = buildVersionedTx(blockhash)
+    const signedLocally = buildVersionedTx(blockhash)
+    signedLocally.sign([userKeypair])
+
+    const { request, client } = makeMockSignClient({
+      transaction: Buffer.from(signedLocally.serialize()).toString('base64')
+    })
+
+    await service.signTransactionBytes(
+      client,
+      mockSession,
+      unsigned.serialize(),
+      SOL_CHAIN_ID,
+      userKeypair.publicKey.toBase58()
+    )
+
+    const calls = request.mock.calls.map(
+      c => (c[0] as { request: { method: string } }).request.method
+    )
+    expect(calls).toEqual(['solana_signTransaction'])
+    expect(calls).not.toContain('solana_signAndSendTransaction')
+  })
+
+  it('throws when the wallet returns an unexpected response shape', async () => {
+    const blockhash = '11111111111111111111111111111111'
+    const unsigned = buildVersionedTx(blockhash)
+    const { client } = makeMockSignClient(
+      // @ts-expect-error — intentionally malformed
+      { foo: 'bar' }
+    )
+
+    await expect(
+      service.signTransactionBytes(
+        client,
+        mockSession,
+        unsigned.serialize(),
+        SOL_CHAIN_ID,
+        userKeypair.publicKey.toBase58()
+      )
+    ).rejects.toThrow()
+  })
+
+  it('propagates wallet RPC errors via parseError', async () => {
+    const blockhash = '11111111111111111111111111111111'
+    const unsigned = buildVersionedTx(blockhash)
+    const request = vi.fn().mockRejectedValue(new Error('User rejected'))
+    const client = { request } as unknown as SignClient
+
+    await expect(
+      service.signTransactionBytes(
+        client,
+        mockSession,
+        unsigned.serialize(),
+        SOL_CHAIN_ID,
+        userKeypair.publicKey.toBase58()
+      )
+    ).rejects.toThrow(/User rejected/)
+  })
+
+  it('correctly routes V0 vs legacy through the {signature} branch', async () => {
+    // The version flag lives on the message byte, not the first tx byte (the first byte is
+    // the shortvec signature count). Both shapes must round-trip cleanly when the wallet
+    // returns only a bare signature — exercised by the two tests above.
+    // This test is a regression guard: build one of each, call the service, and assert
+    // each deserializes back to the matching type.
+    const blockhash = '11111111111111111111111111111111'
+
+    const v0Unsigned = buildVersionedTx(blockhash)
+    const v0Signed = buildVersionedTx(blockhash)
+    v0Signed.sign([userKeypair])
+    const v0Sig = base58.encode(v0Signed.signatures[0]!)
+    const v0Result = await new SolanaTransactionService().signTransactionBytes(
+      makeMockSignClient({ signature: v0Sig }).client,
+      mockSession,
+      v0Unsigned.serialize(),
+      SOL_CHAIN_ID,
+      userKeypair.publicKey.toBase58()
+    )
+    // Must deserialize as V0 — Transaction.from on V0 bytes throws.
+    expect(() => VersionedTransaction.deserialize(v0Result)).not.toThrow()
+
+    const legacyUnsigned = buildLegacyTx(blockhash)
+    const legacySigned = buildLegacyTx(blockhash)
+    legacySigned.sign(userKeypair)
+    const userSig = legacySigned.signatures.find(s =>
+      s.publicKey.equals(userKeypair.publicKey)
+    )!.signature!
+    const legacySigB58 = base58.encode(userSig)
+    const legacyResult =
+      await new SolanaTransactionService().signTransactionBytes(
+        makeMockSignClient({ signature: legacySigB58 }).client,
+        mockSession,
+        legacyUnsigned.serialize({ requireAllSignatures: false }),
+        SOL_CHAIN_ID,
+        userKeypair.publicKey.toBase58()
+      )
+    // Must deserialize as legacy.
+    expect(() => Transaction.from(legacyResult)).not.toThrow()
+  })
+
+  it('rejects a {transaction} whose message was altered by the wallet (tamper guard)', async () => {
+    // A wallet must only ADD the user's signature. If it returns a transaction
+    // that pays a different recipient, we refuse instead of handing tampered
+    // bytes to the relay for broadcast. (The happy path — same message, signature
+    // added — is covered by the {transaction} round-trip test above.)
+    const blockhash = '11111111111111111111111111111111'
+    const requested = buildVersionedTx(blockhash) // pays `recipient`
+
+    const attackerRecipient = Keypair.generate().publicKey
+    const tamperedMsg = new TransactionMessage({
+      payerKey: userKeypair.publicKey,
+      recentBlockhash: blockhash,
+      instructions: [
+        SystemProgram.transfer({
+          fromPubkey: userKeypair.publicKey,
+          toPubkey: attackerRecipient,
+          lamports: 1
+        })
+      ]
+    }).compileToV0Message()
+    const tampered = new VersionedTransaction(tamperedMsg)
+    tampered.sign([userKeypair])
+    const tamperedBase64 = Buffer.from(tampered.serialize()).toString('base64')
+
+    const { client } = makeMockSignClient({ transaction: tamperedBase64 })
+
+    await expect(
+      service.signTransactionBytes(
+        client,
+        mockSession,
+        requested.serialize(),
+        SOL_CHAIN_ID,
+        userKeypair.publicKey.toBase58()
+      )
+    ).rejects.toThrow('Signed transaction does not match the request')
+  })
+})
+
+describe('SolanaTransactionService — keys are not concatenated into params', () => {
+  it('encodes serializedTx as a single base64 string in params.transaction', async () => {
+    // Regression guard: the WC Solana spec puts the tx under params.transaction (not as a
+    // positional array). Wallets reject the request silently if we pass an array.
+    const blockhash = '11111111111111111111111111111111'
+    const unsigned = buildVersionedTx(blockhash)
+    const signedLocally = buildVersionedTx(blockhash)
+    signedLocally.sign([userKeypair])
+
+    const request = vi.fn().mockResolvedValue({
+      transaction: Buffer.from(signedLocally.serialize()).toString('base64')
+    })
+    const client = { request } as unknown as SignClient
+    const service = new SolanaTransactionService()
+
+    await service.signTransactionBytes(
+      client,
+      mockSession,
+      unsigned.serialize(),
+      SOL_CHAIN_ID,
+      userKeypair.publicKey.toBase58()
+    )
+
+    const params = request.mock.calls[0]![0]!.request.params
+    expect(typeof params.transaction).toBe('string')
+    expect(Array.isArray(params)).toBe(false)
+    // Must be valid base64.
+    expect(() => Buffer.from(params.transaction, 'base64')).not.toThrow()
+  })
+})
+
+describe('SolanaTransactionService — public method preserves PublicKey usage', () => {
+  it('attaches signature using the activeAddress, not feePayer from the message', async () => {
+    // The relay flow has two signers: relay (slot 0 = fee payer) and user (slot 1).
+    // We pass activeAddress = user, so the signature must land on the user slot.
+    const blockhash = '11111111111111111111111111111111'
+    const relayKeypair = Keypair.generate()
+
+    const message = new TransactionMessage({
+      payerKey: relayKeypair.publicKey,
+      recentBlockhash: blockhash,
+      instructions: [
+        SystemProgram.transfer({
+          fromPubkey: userKeypair.publicKey,
+          toPubkey: recipient,
+          lamports: 1
+        })
+      ]
+    }).compileToV0Message()
+    const unsigned = new VersionedTransaction(message)
+
+    // Local: sign with user keypair only (not relay) to simulate what the wallet would do.
+    const signedLocally = new VersionedTransaction(message)
+    signedLocally.sign([userKeypair])
+    const userSlotIndex = unsigned.message.staticAccountKeys.findIndex(k =>
+      k.equals(userKeypair.publicKey)
+    )
+    const userSignature = signedLocally.signatures[userSlotIndex]!
+    const wireSignature = base58.encode(userSignature)
+
+    const { client } = makeMockSignClient({ signature: wireSignature })
+    const service = new SolanaTransactionService()
+
+    const result = await service.signTransactionBytes(
+      client,
+      mockSession,
+      unsigned.serialize(),
+      SOL_CHAIN_ID,
+      userKeypair.publicKey.toBase58()
+    )
+
+    const out = VersionedTransaction.deserialize(result)
+    // Relay slot (0) still empty zeros; user slot (>=1) populated.
+    expect(Array.from(out.signatures[userSlotIndex]!)).toEqual(
+      Array.from(userSignature)
+    )
+    const relaySlot = out.message.staticAccountKeys.findIndex(k =>
+      k.equals(relayKeypair.publicKey)
+    )
+    expect(out.signatures[relaySlot]?.every(b => b === 0)).toBe(true)
+    // PublicKey.toBase58 should equal activeAddress to confirm we used it correctly.
+    expect(userKeypair.publicKey.toBase58()).toBe(
+      new PublicKey(userKeypair.publicKey.toBase58()).toBase58()
+    )
+  })
+})

package/src/services/solana/solana-transaction-service.ts

@@ -6,6 +6,10 @@ import type {
   SolanaTokenTransferRequest,
   SolanaTransactionRequest
 } from '@meshconnect/uwc-types'
+import {
+  assertSameMessage,
+  isVersionedTransactionBytes
+} from '@meshconnect/uwc-types'
 import {
   VersionedTransaction,
   PublicKey,
@@ -291,4 +295,73 @@ export class SolanaTransactionService {
       throw signAndSendError
     }
   }
+
+  /**
+   * Sign Solana tx bytes over WalletConnect WITHOUT broadcasting (relay submits).
+   * Bytes in/out (legacy or v0); only deserializes if the wallet returns a bare
+   * signature instead of the full tx.
+   */
+  async signTransactionBytes(
+    client: SignClient,
+    session: SessionTypes.Struct,
+    serializedTx: Uint8Array,
+    chainId: string,
+    activeAddress: string
+  ): Promise<Uint8Array> {
+    try {
+      // WalletConnect spec: the transaction param is base64.
+      const serializedBase64 = Buffer.from(serializedTx).toString('base64')
+
+      const result: { transaction: string } | { signature: string } =
+        await client.request({
+          topic: session.topic,
+          chainId,
+          request: {
+            method: 'solana_signTransaction',
+            params: { transaction: serializedBase64 }
+          }
+        })
+
+      // Full signed tx back (Phantom/Solflare) — verify only a signature was added.
+      if ('transaction' in result) {
+        const returned = new Uint8Array(
+          Buffer.from(result.transaction, 'base64')
+        )
+        assertSameMessage(serializedTx, returned)
+        return returned
+      }
+
+      // Bare signature back (legacy WC) — splice it into our original bytes.
+      if ('signature' in result) {
+        const signatureBytes = base58.decode(result.signature) as Uint8Array
+        // ed25519 sigs are 64 bytes; reject early with a clear error.
+        if (signatureBytes.length !== 64) {
+          throw new Error(
+            'WalletConnect returned a malformed Solana signature (expected 64 bytes)'
+          )
+        }
+        const userPubkey = new PublicKey(activeAddress)
+
+        if (isVersionedTransactionBytes(serializedTx)) {
+          const tx = VersionedTransaction.deserialize(serializedTx)
+          tx.addSignature(userPubkey, signatureBytes as Uint8Array & Buffer)
+          return tx.serialize()
+        }
+
+        const tx = Transaction.from(serializedTx)
+        tx.addSignature(
+          userPubkey,
+          Buffer.from(signatureBytes) as Buffer & Uint8Array
+        )
+        // verifySignatures:false — the relay's fee-payer slot is still unsigned here.
+        return new Uint8Array(tx.serialize({ verifySignatures: false }))
+      }
+
+      throw new Error(
+        'WalletConnect returned an unexpected response shape for solana_signTransaction'
+      )
+    } catch (error) {
+      throw parseError(error)
+    }
+  }
 }

package/src/services/transaction-service.ts

@@ -72,4 +72,45 @@ export class TransactionService {
       throw new Error(`Unsupported namespace: ${namespace}`)
     }
   }
+
+  /**
+   * Sign-only path for Solana transactions over WalletConnect.
+   * Mirrors the validation done in sendTransaction but routes to the sign-only Solana flow
+   * instead of signAndSend. Used by fee-payer relay flows where the relay server broadcasts.
+   */
+  async signSolanaTransactionBytes(
+    serializedTx: Uint8Array
+  ): Promise<Uint8Array> {
+    const session = this.connectionService.getSession()
+    if (!session) {
+      throw new Error('No active session. Please connect first.')
+    }
+
+    const activeNetwork = this.connectionService.getActiveNetwork()
+    const activeAddress = this.connectionService.getActiveAddress()
+
+    if (!activeNetwork) {
+      throw new Error('No active network. Please connect first.')
+    }
+    if (!activeAddress) {
+      throw new Error('No active address. Please connect first.')
+    }
+
+    const namespace = activeNetwork.id.split(':')[0]
+    if (namespace !== 'solana') {
+      throw new Error(
+        `signSolanaTransactionBytes requires a Solana network (got namespace "${namespace}")`
+      )
+    }
+
+    const client = await this.walletConnectClient.getClient()
+
+    return this.solanaService.signTransactionBytes(
+      client,
+      session,
+      serializedTx,
+      activeNetwork.id,
+      activeAddress
+    )
+  }
 }

package/src/wallet-connect-connector.ts

@@ -81,4 +81,17 @@ export class WalletConnectConnector implements Connector {
   ): Promise<TransactionResult> {
     return this.transactionService.sendTransaction(request)
   }
+
+  /**
+   * Sign a Solana transaction over WalletConnect without broadcasting.
+   * Mirrors InjectedConnector.signSolanaTransactionBytes so the core router can branch on
+   * connection mode without the call sites caring which connector backs the active wallet.
+   *
+   * Used by fee-payer relay flows (Mesh BE owns broadcast); never broadcasts via the wallet.
+   */
+  async signSolanaTransactionBytes(
+    serializedTx: Uint8Array
+  ): Promise<Uint8Array> {
+    return this.transactionService.signSolanaTransactionBytes(serializedTx)
+  }
 }