@meshconnect/uwc-types 0.13.0 → 0.14.0-snapshot.2c887a2

package/dist/connector.d.ts

@@ -2,7 +2,7 @@ import type { Network, NetworkId, Namespace } from './networks';
 import type { AvailableAddress } from './session';
 import type { DetectedEIP6963WalletInfo, DetectedSolanaWalletInfo, DetectedTronWalletInfo, DetectedTonWalletInfo, ExtensionInjectedProvider, IntegratedBrowserInjectedProvider, WalletConnectProvider, TonConnectWalletProvider, WalletMetadata } from './UWC-state';
 import type { EVMCapabilities, TransactionRequest, TransactionResult } from './transactions';
-import type { SignatureType } from './signature';
+import type { SignatureType, EIP712TypedData } from './signature';
 /**
  * Result interface for connect operations
  */
@@ -68,6 +68,13 @@ export interface Connector {
      * @returns A promise that resolves to the signature
      */
     signMessage?(message: string, provider?: ExtensionInjectedProvider | IntegratedBrowserInjectedProvider | WalletConnectProvider | TonConnectWalletProvider): Promise<SignatureType>;
+    /**
+     * Sign EIP-712 typed structured data (eth_signTypedData_v4).
+     * Required for ERC-3009 (Transfer With Authorization) and EIP-2612 (Permit) relay flows.
+     * EVM-only (eip155); connectors that don't support it leave this undefined.
+     * @returns A promise that resolves to the 65-byte hex signature (0x-prefixed)
+     */
+    signTypedData?(typedData: EIP712TypedData, provider?: ExtensionInjectedProvider | IntegratedBrowserInjectedProvider | WalletConnectProvider): Promise<string>;
     /**
      * Send a transaction with the connected wallet
      * @param request The transaction request parameters
@@ -76,5 +83,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,eAAe,EAAE,MAAM,aAAa,CAAA;AAEjE;;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,aAAa,CAAC,CACZ,SAAS,EAAE,eAAe,EAC1B,QAAQ,CAAC,EACL,yBAAyB,GACzB,iCAAiC,GACjC,qBAAqB,GACxB,OAAO,CAAC,MAAM,CAAC,CAAA;IAElB;;;;;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

@@ -1,4 +1,4 @@
-import type { NetworkId, Network, ConnectionMode, Session, AvailableAddress, TransactionRequest, TransactionResult, WalletError, EVMCapabilities, SignatureType, WalletMetadata } from './index';
+import type { NetworkId, Network, ConnectionMode, Session, AvailableAddress, TransactionRequest, TransactionResult, WalletError, EVMCapabilities, SignatureType, EIP712TypedData, WalletMetadata } from './index';
 /**
  * WalletConnect connection interface for the useConnection hook
  */
@@ -230,6 +230,44 @@ export interface UseSignMessageReturn {
      */
     error: WalletError | undefined;
 }
+/**
+ * Return type for the useSignTypedData hook.
+ * Provides EIP-712 typed data signing (eth_signTypedData_v4) for EVM wallets.
+ * Used by ERC-3009 (Transfer With Authorization) and EIP-2612 (Permit) relay flows.
+ */
+export interface UseSignTypedDataReturn {
+    /**
+     * Signs EIP-712 typed data with the connected EVM wallet
+     * @param typedData - The EIP-712 typed data to sign
+     * @returns Promise that resolves to the 65-byte hex signature (0x-prefixed)
+     * @throws Error if no wallet is connected, the wallet is non-EVM, or signing fails
+     */
+    signTypedData: (typedData: EIP712TypedData) => Promise<string>;
+    /**
+     * Indicates if a typed-data signing operation is currently in progress
+     */
+    isLoading: boolean;
+    /**
+     * The raw hex signature from the last successful sign, undefined if not yet signed
+     */
+    signature: string | undefined;
+    /**
+     * Error from the last signing attempt, undefined if no error occurred
+     */
+    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/signature.d.ts

@@ -1,4 +1,39 @@
 import type { ExtensionInjectedProvider, IntegratedBrowserInjectedProvider } from './UWC-state';
+/**
+ * EIP-712 typed structured data for eth_signTypedData_v4.
+ * Used by ERC-3009 (Transfer With Authorization), EIP-2612 (Permit), and similar standards.
+ */
+export interface EIP712TypedData {
+    domain: {
+        name?: string;
+        version?: string;
+        chainId?: number;
+        verifyingContract?: string;
+        salt?: string;
+    };
+    types: Record<string, Array<{
+        name: string;
+        type: string;
+    }>>;
+    primaryType: string;
+    message: Record<string, unknown>;
+}
+/**
+ * Ensures the EIP712Domain type entry is present in `types`, derived from the
+ * fields actually set on `domain`, in EIP-712's canonical order.
+ *
+ * Why: some wallets (notably Trust Wallet and several mobile wallets over
+ * WalletConnect) parse the `types` object strictly and reject an
+ * eth_signTypedData_v4 request that omits EIP712Domain. Desktop MetaMask derives
+ * it implicitly, so callers tend to leave it out — this normalizes both.
+ *
+ * If the caller already supplied EIP712Domain, theirs is authoritative and the
+ * input is returned untouched. Otherwise a new object is returned (input is not
+ * mutated) with EIP712Domain inserted first.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator
+ */
+export declare function withEIP712Domain(typedData: EIP712TypedData): EIP712TypedData;
 /**
  * Standard signature format for most blockchains (EVM, Solana, etc.)
  */

package/dist/signature.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signature.d.ts","sourceRoot":"","sources":["../src/signature.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,iCAAiC,EAClC,MAAM,aAAa,CAAA;AAEpB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAErC;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,KAAK,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,kBAAkB,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,aAAa,GAAG,YAAY,CAAA;AAE5E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,aAAa,CAAA;IACxB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,WAAW,CACT,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,yBAAyB,GAAG,iCAAiC,GACtE,OAAO,CAAC,eAAe,CAAC,CAAA;CAC5B"}
+{"version":3,"file":"signature.d.ts","sourceRoot":"","sources":["../src/signature.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,iCAAiC,EAClC,MAAM,aAAa,CAAA;AAEpB;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,iBAAiB,CAAC,EAAE,MAAM,CAAA;QAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;IACD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;IAC5D,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,eAAe,GAAG,eAAe,CAyB5E;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAErC;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,KAAK,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,kBAAkB,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,aAAa,GAAG,YAAY,CAAA;AAE5E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,aAAa,CAAA;IACxB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,WAAW,CACT,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,yBAAyB,GAAG,iCAAiC,GACtE,OAAO,CAAC,eAAe,CAAC,CAAA;CAC5B"}

package/dist/signature.js

@@ -1,2 +1,40 @@
-export {};
+/**
+ * Ensures the EIP712Domain type entry is present in `types`, derived from the
+ * fields actually set on `domain`, in EIP-712's canonical order.
+ *
+ * Why: some wallets (notably Trust Wallet and several mobile wallets over
+ * WalletConnect) parse the `types` object strictly and reject an
+ * eth_signTypedData_v4 request that omits EIP712Domain. Desktop MetaMask derives
+ * it implicitly, so callers tend to leave it out — this normalizes both.
+ *
+ * If the caller already supplied EIP712Domain, theirs is authoritative and the
+ * input is returned untouched. Otherwise a new object is returned (input is not
+ * mutated) with EIP712Domain inserted first.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator
+ */
+export function withEIP712Domain(typedData) {
+    if (Object.hasOwn(typedData.types, 'EIP712Domain'))
+        return typedData;
+    const { domain } = typedData;
+    const domainFields = [];
+    // Canonical field order — the on-chain domainSeparator hash depends on it.
+    if (domain.name !== undefined)
+        domainFields.push({ name: 'name', type: 'string' });
+    if (domain.version !== undefined)
+        domainFields.push({ name: 'version', type: 'string' });
+    if (domain.chainId !== undefined)
+        domainFields.push({ name: 'chainId', type: 'uint256' });
+    if (domain.verifyingContract !== undefined)
+        domainFields.push({ name: 'verifyingContract', type: 'address' });
+    if (domain.salt !== undefined)
+        domainFields.push({ name: 'salt', type: 'bytes32' });
+    return {
+        ...typedData,
+        types: {
+            EIP712Domain: domainFields,
+            ...typedData.types
+        }
+    };
+}
 //# sourceMappingURL=signature.js.map

package/dist/signature.js.map

@@ -1 +1 @@
-{"version":3,"file":"signature.js","sourceRoot":"","sources":["../src/signature.ts"],"names":[],"mappings":""}
+{"version":3,"file":"signature.js","sourceRoot":"","sources":["../src/signature.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAA0B;IACzD,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,cAAc,CAAC;QAAE,OAAO,SAAS,CAAA;IAEpE,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC5B,MAAM,YAAY,GAA0C,EAAE,CAAA;IAE9D,2EAA2E;IAC3E,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAC3B,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;IACrD,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;QAC9B,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;IACxD,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;QAC9B,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;IACzD,IAAI,MAAM,CAAC,iBAAiB,KAAK,SAAS;QACxC,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;IACnE,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAC3B,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;IAEtD,OAAO;QACL,GAAG,SAAS;QACZ,KAAK,EAAE;YACL,YAAY,EAAE,YAAY;YAC1B,GAAG,SAAS,CAAC,KAAK;SACnB;KACF,CAAA;AACH,CAAC"}

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.13.0",
+  "version": "0.14.0-snapshot.2c887a2",
   "description": "TypeScript types for Universal Wallet Connector",
   "type": "module",
   "main": "dist/index.js",

package/src/connector.ts

@@ -16,7 +16,7 @@ import type {
   TransactionRequest,
   TransactionResult
 } from './transactions'
-import type { SignatureType } from './signature'
+import type { SignatureType, EIP712TypedData } from './signature'
 
 /**
  * Result interface for connect operations
@@ -122,6 +122,20 @@ export interface Connector {
       | TonConnectWalletProvider
   ): Promise<SignatureType>
 
+  /**
+   * Sign EIP-712 typed structured data (eth_signTypedData_v4).
+   * Required for ERC-3009 (Transfer With Authorization) and EIP-2612 (Permit) relay flows.
+   * EVM-only (eip155); connectors that don't support it leave this undefined.
+   * @returns A promise that resolves to the 65-byte hex signature (0x-prefixed)
+   */
+  signTypedData?(
+    typedData: EIP712TypedData,
+    provider?:
+      | ExtensionInjectedProvider
+      | IntegratedBrowserInjectedProvider
+      | WalletConnectProvider
+  ): Promise<string>
+
   /**
    * Send a transaction with the connected wallet
    * @param request The transaction request parameters
@@ -141,4 +155,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

@@ -9,6 +9,7 @@ import type {
   WalletError,
   EVMCapabilities,
   SignatureType,
+  EIP712TypedData,
   WalletMetadata
 } from './index'
 
@@ -258,6 +259,50 @@ export interface UseSignMessageReturn {
   error: WalletError | undefined
 }
 
+// useSignTypedData hook types
+
+/**
+ * Return type for the useSignTypedData hook.
+ * Provides EIP-712 typed data signing (eth_signTypedData_v4) for EVM wallets.
+ * Used by ERC-3009 (Transfer With Authorization) and EIP-2612 (Permit) relay flows.
+ */
+export interface UseSignTypedDataReturn {
+  /**
+   * Signs EIP-712 typed data with the connected EVM wallet
+   * @param typedData - The EIP-712 typed data to sign
+   * @returns Promise that resolves to the 65-byte hex signature (0x-prefixed)
+   * @throws Error if no wallet is connected, the wallet is non-EVM, or signing fails
+   */
+  signTypedData: (typedData: EIP712TypedData) => Promise<string>
+  /**
+   * Indicates if a typed-data signing operation is currently in progress
+   */
+  isLoading: boolean
+  /**
+   * The raw hex signature from the last successful sign, undefined if not yet signed
+   */
+  signature: string | undefined
+  /**
+   * Error from the last signing attempt, undefined if no error occurred
+   */
+  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/signature.test.ts

@@ -0,0 +1,197 @@
+import { describe, it, expect } from 'vitest'
+import { withEIP712Domain } from './signature'
+import type { EIP712TypedData } from './signature'
+
+const baseTypes = {
+  TransferWithAuthorization: [
+    { name: 'from', type: 'address' },
+    { name: 'to', type: 'address' },
+    { name: 'value', type: 'uint256' },
+    { name: 'validAfter', type: 'uint256' },
+    { name: 'validBefore', type: 'uint256' },
+    { name: 'nonce', type: 'bytes32' }
+  ]
+}
+
+const baseMessage = {
+  from: '0xabc',
+  to: '0xdef',
+  value: '1000000',
+  validAfter: 0,
+  validBefore: 9999999999,
+  nonce: '0xdeadbeef'
+}
+
+describe('withEIP712Domain', () => {
+  it('injects EIP712Domain with all four standard fields when all are present in domain', () => {
+    const input: EIP712TypedData = {
+      domain: {
+        name: 'USD Coin',
+        version: '2',
+        chainId: 1,
+        verifyingContract: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48'
+      },
+      types: baseTypes,
+      primaryType: 'TransferWithAuthorization',
+      message: baseMessage
+    }
+
+    const result = withEIP712Domain(input)
+
+    expect(result.types.EIP712Domain).toEqual([
+      { name: 'name', type: 'string' },
+      { name: 'version', type: 'string' },
+      { name: 'chainId', type: 'uint256' },
+      { name: 'verifyingContract', type: 'address' }
+    ])
+    // Existing types are preserved
+    expect(result.types.TransferWithAuthorization).toEqual(
+      baseTypes.TransferWithAuthorization
+    )
+    // Other fields are unchanged
+    expect(result.domain).toBe(input.domain)
+    expect(result.primaryType).toBe(input.primaryType)
+    expect(result.message).toBe(input.message)
+  })
+
+  it('omits version from EIP712Domain when domain has no version (UNI-style)', () => {
+    const input: EIP712TypedData = {
+      domain: { name: 'Uniswap V2', chainId: 1, verifyingContract: '0x...' },
+      types: { Permit: [{ name: 'owner', type: 'address' }] },
+      primaryType: 'Permit',
+      message: {}
+    }
+
+    const result = withEIP712Domain(input)
+
+    expect(result.types.EIP712Domain).toEqual([
+      { name: 'name', type: 'string' },
+      { name: 'chainId', type: 'uint256' },
+      { name: 'verifyingContract', type: 'address' }
+    ])
+  })
+
+  it('includes salt when present in domain', () => {
+    const input: EIP712TypedData = {
+      domain: {
+        name: 'MyToken',
+        chainId: 137,
+        salt: '0xdeadbeef00000000000000000000000000000000000000000000000000000000'
+      },
+      types: baseTypes,
+      primaryType: 'TransferWithAuthorization',
+      message: baseMessage
+    }
+
+    const result = withEIP712Domain(input)
+
+    expect(result.types.EIP712Domain).toEqual([
+      { name: 'name', type: 'string' },
+      { name: 'chainId', type: 'uint256' },
+      { name: 'salt', type: 'bytes32' }
+    ])
+  })
+
+  it('preserves canonical field order: name, version, chainId, verifyingContract, salt', () => {
+    const input: EIP712TypedData = {
+      domain: {
+        salt: '0x00000000000000000000000000000000000000000000000000000000000000ab',
+        verifyingContract: '0x123',
+        name: 'Token',
+        chainId: 1,
+        version: '1'
+      },
+      types: baseTypes,
+      primaryType: 'TransferWithAuthorization',
+      message: baseMessage
+    }
+
+    const result = withEIP712Domain(input)
+    const names = result.types.EIP712Domain.map(f => f.name)
+
+    expect(names).toEqual([
+      'name',
+      'version',
+      'chainId',
+      'verifyingContract',
+      'salt'
+    ])
+  })
+
+  it('does not modify input when EIP712Domain is already present', () => {
+    const existingEIP712Domain = [
+      { name: 'name', type: 'string' },
+      { name: 'chainId', type: 'uint256' }
+    ]
+    const input: EIP712TypedData = {
+      domain: {
+        name: 'USD Coin',
+        version: '2',
+        chainId: 1,
+        verifyingContract: '0xabc'
+      },
+      types: { EIP712Domain: existingEIP712Domain, ...baseTypes },
+      primaryType: 'TransferWithAuthorization',
+      message: baseMessage
+    }
+
+    const result = withEIP712Domain(input)
+
+    // Returns input unchanged — caller's EIP712Domain is authoritative
+    expect(result).toBe(input)
+    expect(result.types.EIP712Domain).toBe(existingEIP712Domain)
+  })
+
+  it('returns a new object (does not mutate input) when injecting EIP712Domain', () => {
+    const input: EIP712TypedData = {
+      domain: {
+        name: 'USD Coin',
+        version: '2',
+        chainId: 1,
+        verifyingContract: '0xabc'
+      },
+      types: { ...baseTypes },
+      primaryType: 'TransferWithAuthorization',
+      message: baseMessage
+    }
+
+    const result = withEIP712Domain(input)
+
+    expect(result).not.toBe(input)
+    expect(result.types).not.toBe(input.types)
+    // Original is untouched
+    expect(input.types.EIP712Domain).toBeUndefined()
+  })
+
+  it('handles a domain with only chainId (minimal domain)', () => {
+    const input: EIP712TypedData = {
+      domain: { chainId: 8453 },
+      types: baseTypes,
+      primaryType: 'TransferWithAuthorization',
+      message: baseMessage
+    }
+
+    const result = withEIP712Domain(input)
+
+    expect(result.types.EIP712Domain).toEqual([
+      { name: 'chainId', type: 'uint256' }
+    ])
+  })
+
+  it('places EIP712Domain before other types in the types object', () => {
+    const input: EIP712TypedData = {
+      domain: {
+        name: 'USD Coin',
+        version: '2',
+        chainId: 1,
+        verifyingContract: '0xabc'
+      },
+      types: baseTypes,
+      primaryType: 'TransferWithAuthorization',
+      message: baseMessage
+    }
+
+    const keys = Object.keys(withEIP712Domain(input).types)
+    expect(keys[0]).toBe('EIP712Domain')
+  })
+})

package/src/signature.ts

@@ -3,6 +3,65 @@ import type {
   IntegratedBrowserInjectedProvider
 } from './UWC-state'
 
+/**
+ * EIP-712 typed structured data for eth_signTypedData_v4.
+ * Used by ERC-3009 (Transfer With Authorization), EIP-2612 (Permit), and similar standards.
+ */
+export interface EIP712TypedData {
+  domain: {
+    name?: string
+    version?: string
+    chainId?: number
+    verifyingContract?: string
+    salt?: string
+  }
+  types: Record<string, Array<{ name: string; type: string }>>
+  primaryType: string
+  message: Record<string, unknown>
+}
+
+/**
+ * Ensures the EIP712Domain type entry is present in `types`, derived from the
+ * fields actually set on `domain`, in EIP-712's canonical order.
+ *
+ * Why: some wallets (notably Trust Wallet and several mobile wallets over
+ * WalletConnect) parse the `types` object strictly and reject an
+ * eth_signTypedData_v4 request that omits EIP712Domain. Desktop MetaMask derives
+ * it implicitly, so callers tend to leave it out — this normalizes both.
+ *
+ * If the caller already supplied EIP712Domain, theirs is authoritative and the
+ * input is returned untouched. Otherwise a new object is returned (input is not
+ * mutated) with EIP712Domain inserted first.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator
+ */
+export function withEIP712Domain(typedData: EIP712TypedData): EIP712TypedData {
+  if (Object.hasOwn(typedData.types, 'EIP712Domain')) return typedData
+
+  const { domain } = typedData
+  const domainFields: Array<{ name: string; type: string }> = []
+
+  // Canonical field order — the on-chain domainSeparator hash depends on it.
+  if (domain.name !== undefined)
+    domainFields.push({ name: 'name', type: 'string' })
+  if (domain.version !== undefined)
+    domainFields.push({ name: 'version', type: 'string' })
+  if (domain.chainId !== undefined)
+    domainFields.push({ name: 'chainId', type: 'uint256' })
+  if (domain.verifyingContract !== undefined)
+    domainFields.push({ name: 'verifyingContract', type: 'address' })
+  if (domain.salt !== undefined)
+    domainFields.push({ name: 'salt', type: 'bytes32' })
+
+  return {
+    ...typedData,
+    types: {
+      EIP712Domain: domainFields,
+      ...typedData.types
+    }
+  }
+}
+
 /**
  * Standard signature format for most blockchains (EVM, Solana, etc.)
  */

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'
+    )
+  }
+}