@thru/chain-interfaces 0.0.4

package/dist/index.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 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 {
+    /** The active Thru address, if connected. */
+    readonly publicKey: string | null;
+    /** 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];
+interface WalletAddress {
+    addressType: AddressType;
+    address: string;
+}
+interface AppMetadata {
+    appId: string;
+    appName: string;
+    appUrl: string;
+    imageUrl?: string;
+}
+interface ConnectResult {
+    walletId?: string;
+    addresses: WalletAddress[];
+    status?: 'pending' | 'completed';
+    metadata?: AppMetadata;
+}
+interface ConnectedApp {
+    accountId: number;
+    appId: string;
+    origin: string;
+    metadata: AppMetadata;
+    connectedAt: number;
+    updatedAt: number;
+}
+interface SignMessageParams {
+    message: string | Uint8Array;
+    networkId: string;
+}
+interface SignMessageResult {
+    signature: Uint8Array;
+    publicKey: string;
+}
+
+export { AddressType, type AppMetadata, type ConnectResult, type ConnectedApp, type IThruChain, type SignMessageParams, type SignMessageResult, type WalletAddress };

package/dist/index.js

@@ -0,0 +1,8 @@
+// src/types.ts
+var AddressType = {
+  THRU: "thru"
+};
+
+export { AddressType };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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 WalletAddress {\n  addressType: AddressType;\n  address: 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  addresses: WalletAddress[];\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"]}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@thru/chain-interfaces",
+  "version": "0.0.4",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {},
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "clean": "rm -rf dist"
+  }
+}

package/src/IThruChain.ts

@@ -0,0 +1,27 @@
+/**
+ * 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.
+ */
+export interface IThruChain {
+  /** The active Thru address, if connected. */
+  readonly publicKey: string | null;
+  /** 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>;
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export type { IThruChain } from './IThruChain';
+export * from './types';

package/src/types.ts

@@ -0,0 +1,43 @@
+export const AddressType = {
+  THRU: 'thru',
+} as const;
+
+export type AddressType = typeof AddressType[keyof typeof AddressType];
+
+export interface WalletAddress {
+  addressType: AddressType;
+  address: string;
+}
+
+export interface AppMetadata {
+  appId: string;
+  appName: string;
+  appUrl: string;
+  imageUrl?: string;
+}
+
+export interface ConnectResult {
+  walletId?: string;
+  addresses: WalletAddress[];
+  status?: 'pending' | 'completed';
+  metadata?: AppMetadata;
+}
+
+export interface ConnectedApp {
+  accountId: number;
+  appId: string;
+  origin: string;
+  metadata: AppMetadata;
+  connectedAt: number;
+  updatedAt: number;
+}
+
+export interface SignMessageParams {
+  message: string | Uint8Array;
+  networkId: string;
+}
+
+export interface SignMessageResult {
+  signature: Uint8Array;
+  publicKey: string;
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsup.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm'],
+  dts: true,
+  sourcemap: true,
+  clean: true,
+  treeshake: true,
+});