@thru/chain-interfaces 0.2.9 → 0.2.11

package/dist/index.d.ts

@@ -1,32 +1,7 @@
-/**
- * Minimal Thru chain interface exposed to SDK consumers.
- * The concrete implementation will evolve as the Thru transaction
- * flow is fleshed out, but maintaining a dedicated contract now
- * keeps the Surface area aligned with other chain adapters.
- */
-interface IThruChain {
-    /** Indicates whether the wallet has approved a Thru connection. */
-    readonly connected: boolean;
-    /**
-     * Initiate a Thru connection flow. Resolves with the connected address once
-     * the user has approved the request.
-     */
-    connect(): Promise<{
-        publicKey: string;
-    }>;
-    /** Disconnect the currently connected Thru account. */
-    disconnect(): Promise<void>;
-    /**
-     * Sign a serialized Thru transaction payload (base64 string) and return the
-     * signed payload encoded as base64.
-     */
-    signTransaction(serializedTransaction: string): Promise<string>;
-}
-
 declare const AddressType: {
     readonly THRU: "thru";
 };
-type AddressType = typeof AddressType[keyof typeof AddressType];
+type AddressType = (typeof AddressType)[keyof typeof AddressType];
 interface WalletAccount {
     accountType: AddressType;
     address: string;
@@ -41,9 +16,22 @@ interface AppMetadata {
 interface ConnectResult {
     walletId?: string;
     accounts: WalletAccount[];
-    status?: 'pending' | 'completed';
+    status?: "pending" | "completed";
     metadata?: AppMetadata;
 }
+declare const ThruTransactionEncoding: {
+    readonly SIGNING_PAYLOAD_BASE64: "signing_payload_base64";
+    readonly RAW_TRANSACTION_BASE64: "raw_transaction_base64";
+};
+type ThruTransactionEncoding = (typeof ThruTransactionEncoding)[keyof typeof ThruTransactionEncoding];
+interface ThruSigningContext {
+    mode: "managed_fee_payer";
+    selectedAccountPublicKey: string | null;
+    feePayerPublicKey: string;
+    signerPublicKey: string;
+    acceptedInputEncodings: ThruTransactionEncoding[];
+    outputEncoding: typeof ThruTransactionEncoding.RAW_TRANSACTION_BASE64;
+}
 interface ConnectedApp {
     accountId: number;
     appId: string;
@@ -61,4 +49,44 @@ interface SignMessageResult {
     publicKey: string;
 }
 
-export { AddressType, type AppMetadata, type ConnectResult, type ConnectedApp, type IThruChain, type SignMessageParams, type SignMessageResult, type WalletAccount };
+/**
+ * Minimal Thru chain interface exposed to SDK consumers.
+ * The concrete implementation will evolve as the Thru transaction
+ * flow is fleshed out, but maintaining a dedicated contract now
+ * keeps the Surface area aligned with other chain adapters.
+ */
+interface IThruChain {
+    /** Indicates whether the wallet has approved a Thru connection. */
+    readonly connected: boolean;
+    /**
+     * Initiate a Thru connection flow. Resolves with the connected address once
+     * the user has approved the request.
+     */
+    connect(): Promise<{
+        publicKey: string;
+    }>;
+    /** Disconnect the currently connected Thru account. */
+    disconnect(): Promise<void>;
+    /**
+     * Return the current embedded signing contract for Thru transactions.
+     *
+     * The selected account is the managed wallet account shown to the user.
+     * The fee payer / signer can differ when the wallet routes transactions
+     * through an embedded manager profile.
+     */
+    getSigningContext(): Promise<ThruSigningContext>;
+    /**
+     * Sign a serialized Thru transaction (base64 string) and return canonical
+     * raw transaction bytes encoded as base64.
+     *
+     * Implementations may accept either:
+     * - signing payload bytes produced by `Transaction.toWireForSigning()`
+     * - raw transaction bytes produced by `Transaction.toWire()`
+     *
+     * The returned bytes are always safe for direct submission via the supported
+     * RPC path without any app-side wire reordering.
+     */
+    signTransaction(serializedTransaction: string): Promise<string>;
+}
+
+export { AddressType, type AppMetadata, type ConnectResult, type ConnectedApp, type IThruChain, type SignMessageParams, type SignMessageResult, type ThruSigningContext, ThruTransactionEncoding, type WalletAccount };

package/dist/index.js

@@ -2,7 +2,11 @@
 var AddressType = {
   THRU: "thru"
 };
+var ThruTransactionEncoding = {
+  SIGNING_PAYLOAD_BASE64: "signing_payload_base64",
+  RAW_TRANSACTION_BASE64: "raw_transaction_base64"
+};
 
-export { AddressType };
+export { AddressType, ThruTransactionEncoding };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts"],"names":[],"mappings":";AAAO,IAAM,WAAA,GAAc;AAAA,EACzB,IAAA,EAAM;AACR","file":"index.js","sourcesContent":["export const AddressType = {\n  THRU: 'thru',\n} as const;\n\nexport type AddressType = typeof AddressType[keyof typeof AddressType];\n\nexport interface WalletAccount {\n  accountType: AddressType;\n  address: string;\n  label: string;\n}\n\nexport interface AppMetadata {\n  appId: string;\n  appName: string;\n  appUrl: string;\n  imageUrl?: string;\n}\n\nexport interface ConnectResult {\n  walletId?: string;\n  accounts: WalletAccount[];\n  status?: 'pending' | 'completed';\n  metadata?: AppMetadata;\n}\n\nexport interface ConnectedApp {\n  accountId: number;\n  appId: string;\n  origin: string;\n  metadata: AppMetadata;\n  connectedAt: number;\n  updatedAt: number;\n}\n\nexport interface SignMessageParams {\n  message: string | Uint8Array;\n  networkId: string;\n}\n\nexport interface SignMessageResult {\n  signature: Uint8Array;\n  publicKey: string;\n}\n"]}
+{"version":3,"sources":["../src/types.ts"],"names":[],"mappings":";AAAO,IAAM,WAAA,GAAc;AAAA,EACzB,IAAA,EAAM;AACR;AAwBO,IAAM,uBAAA,GAA0B;AAAA,EACrC,sBAAA,EAAwB,wBAAA;AAAA,EACxB,sBAAA,EAAwB;AAC1B","file":"index.js","sourcesContent":["export const AddressType = {\n  THRU: \"thru\",\n} as const;\n\nexport type AddressType = (typeof AddressType)[keyof typeof AddressType];\n\nexport interface WalletAccount {\n  accountType: AddressType;\n  address: string;\n  label: string;\n}\n\nexport interface AppMetadata {\n  appId: string;\n  appName: string;\n  appUrl: string;\n  imageUrl?: string;\n}\n\nexport interface ConnectResult {\n  walletId?: string;\n  accounts: WalletAccount[];\n  status?: \"pending\" | \"completed\";\n  metadata?: AppMetadata;\n}\n\nexport const ThruTransactionEncoding = {\n  SIGNING_PAYLOAD_BASE64: \"signing_payload_base64\",\n  RAW_TRANSACTION_BASE64: \"raw_transaction_base64\",\n} as const;\n\nexport type ThruTransactionEncoding =\n  (typeof ThruTransactionEncoding)[keyof typeof ThruTransactionEncoding];\n\nexport interface ThruSigningContext {\n  mode: \"managed_fee_payer\";\n  selectedAccountPublicKey: string | null;\n  feePayerPublicKey: string;\n  signerPublicKey: string;\n  acceptedInputEncodings: ThruTransactionEncoding[];\n  outputEncoding: typeof ThruTransactionEncoding.RAW_TRANSACTION_BASE64;\n}\n\nexport interface ConnectedApp {\n  accountId: number;\n  appId: string;\n  origin: string;\n  metadata: AppMetadata;\n  connectedAt: number;\n  updatedAt: number;\n}\n\nexport interface SignMessageParams {\n  message: string | Uint8Array;\n  networkId: string;\n}\n\nexport interface SignMessageResult {\n  signature: Uint8Array;\n  publicKey: string;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thru/chain-interfaces",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/IThruChain.ts

@@ -1,3 +1,5 @@
+import type { ThruSigningContext } from "./types";
+
 /**
  * Minimal Thru chain interface exposed to SDK consumers.
  * The concrete implementation will evolve as the Thru transaction
@@ -18,8 +20,24 @@ export interface IThruChain {
   disconnect(): Promise<void>;
 
   /**
-   * Sign a serialized Thru transaction payload (base64 string) and return the
-   * signed payload encoded as base64.
+   * Return the current embedded signing contract for Thru transactions.
+   *
+   * The selected account is the managed wallet account shown to the user.
+   * The fee payer / signer can differ when the wallet routes transactions
+   * through an embedded manager profile.
+   */
+  getSigningContext(): Promise<ThruSigningContext>;
+
+  /**
+   * Sign a serialized Thru transaction (base64 string) and return canonical
+   * raw transaction bytes encoded as base64.
+   *
+   * Implementations may accept either:
+   * - signing payload bytes produced by `Transaction.toWireForSigning()`
+   * - raw transaction bytes produced by `Transaction.toWire()`
+   *
+   * The returned bytes are always safe for direct submission via the supported
+   * RPC path without any app-side wire reordering.
    */
   signTransaction(serializedTransaction: string): Promise<string>;
 }

package/src/types.ts

@@ -1,8 +1,8 @@
 export const AddressType = {
-  THRU: 'thru',
+  THRU: "thru",
 } as const;
 
-export type AddressType = typeof AddressType[keyof typeof AddressType];
+export type AddressType = (typeof AddressType)[keyof typeof AddressType];
 
 export interface WalletAccount {
   accountType: AddressType;
@@ -20,10 +20,27 @@ export interface AppMetadata {
 export interface ConnectResult {
   walletId?: string;
   accounts: WalletAccount[];
-  status?: 'pending' | 'completed';
+  status?: "pending" | "completed";
   metadata?: AppMetadata;
 }
 
+export const ThruTransactionEncoding = {
+  SIGNING_PAYLOAD_BASE64: "signing_payload_base64",
+  RAW_TRANSACTION_BASE64: "raw_transaction_base64",
+} as const;
+
+export type ThruTransactionEncoding =
+  (typeof ThruTransactionEncoding)[keyof typeof ThruTransactionEncoding];
+
+export interface ThruSigningContext {
+  mode: "managed_fee_payer";
+  selectedAccountPublicKey: string | null;
+  feePayerPublicKey: string;
+  signerPublicKey: string;
+  acceptedInputEncodings: ThruTransactionEncoding[];
+  outputEncoding: typeof ThruTransactionEncoding.RAW_TRANSACTION_BASE64;
+}
+
 export interface ConnectedApp {
   accountId: number;
   appId: string;