@thru/wallet 0.2.22

package/src/index.ts

@@ -0,0 +1,27 @@
+// Main exports
+export {
+  BrowserSDK,
+  type BrowserSDKConfig, type ConnectOptions, type EventCallback, type SDKEvent
+} from './BrowserSDK';
+
+export type {
+  ConnectedApp, ConnectResult, IThruChain, SignMessageParams,
+  SignMessageResult, ThruSigningContext, ThruTransactionIntent, WalletAccount
+} from './interfaces';
+export {
+  AddressType,
+  normalizeActiveWalletAccounts,
+  normalizeWalletAccountResult,
+  resolveSelectedWalletAccount,
+  resolveWalletAccountByAddress,
+  ThruTransactionEncoding,
+} from './interfaces';
+export type {
+  ActiveWalletAccounts,
+  WalletAccountResult,
+} from './interfaces';
+
+export {
+  ErrorCode,
+} from './protocol';
+export * from './protocol';

package/src/interfaces/IThruChain.ts

@@ -0,0 +1,37 @@
+import type { ThruSigningContext, ThruTransactionIntent } from "./types";
+
+/**
+ * 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 {
+  /** 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 wallet-managed transaction intent and return canonical raw
+   * transaction bytes encoded as base64. The wallet owns fee payer choice,
+   * account ordering, headers, nonces, and final wire layout.
+   */
+  signTransaction(transaction: ThruTransactionIntent): Promise<string>;
+}

package/src/interfaces/accounts.ts

@@ -0,0 +1,61 @@
+import type { WalletAccount } from "./types";
+
+export interface ActiveWalletAccounts {
+  accounts: WalletAccount[];
+  selectedAccount: WalletAccount | null;
+}
+
+export type WalletAccountResult<T> = Omit<T, "accounts" | "selectedAccount"> & {
+  accounts: WalletAccount[];
+  selectedAccount: WalletAccount | null;
+};
+
+export function resolveSelectedWalletAccount(
+  accounts: WalletAccount[],
+  selectedAccount?: WalletAccount | null,
+): WalletAccount | null {
+  if (selectedAccount) {
+    return (
+      accounts.find((account) => account.address === selectedAccount.address) ??
+      selectedAccount
+    );
+  }
+
+  return accounts[0] ?? null;
+}
+
+export function resolveWalletAccountByAddress(
+  accounts: WalletAccount[],
+  address?: string | null,
+): WalletAccount | null {
+  if (!address) return null;
+  return accounts.find((account) => account.address === address) ?? null;
+}
+
+export function normalizeActiveWalletAccounts(
+  accounts: WalletAccount[],
+  selectedAccount?: WalletAccount | null,
+): ActiveWalletAccounts {
+  const activeAccount = resolveSelectedWalletAccount(accounts, selectedAccount);
+  return {
+    accounts: activeAccount ? [activeAccount] : [],
+    selectedAccount: activeAccount,
+  };
+}
+
+export function normalizeWalletAccountResult<
+  T extends { accounts: WalletAccount[]; selectedAccount?: WalletAccount | null },
+>(
+  result: T,
+  selectedAccount?: WalletAccount | null,
+): WalletAccountResult<T> {
+  const active = normalizeActiveWalletAccounts(
+    result.accounts,
+    selectedAccount ?? result.selectedAccount ?? null,
+  );
+  return {
+    ...result,
+    accounts: active.accounts,
+    selectedAccount: active.selectedAccount,
+  };
+}

package/src/interfaces/index.ts

@@ -0,0 +1,9 @@
+export type { IThruChain } from './IThruChain';
+export {
+  normalizeActiveWalletAccounts,
+  normalizeWalletAccountResult,
+  resolveSelectedWalletAccount,
+  resolveWalletAccountByAddress,
+} from './accounts';
+export type { ActiveWalletAccounts, WalletAccountResult } from './accounts';
+export * from './types';

package/src/interfaces/types.ts

@@ -0,0 +1,95 @@
+export const AddressType = {
+  THRU: "thru",
+} as const;
+
+export type AddressType = (typeof AddressType)[keyof typeof AddressType];
+
+export interface WalletAccount {
+  accountType: AddressType;
+  address: string;
+  label: string;
+}
+
+export interface AppMetadata {
+  appId: string;
+  appName: string;
+  appUrl: string;
+  imageUrl?: string;
+}
+
+export interface ConnectResult {
+  walletId?: string;
+  accounts: WalletAccount[];
+  selectedAccount?: WalletAccount | null;
+  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 ThruTransactionReviewSimulation {
+  before?: string;
+  after?: string;
+}
+
+export interface ThruTransactionReviewAbiReflection {
+  label?: string;
+  kind?: string | null;
+  typeName?: string;
+  value?: unknown;
+  rawHex?: string;
+  source?: string;
+  error?: string;
+}
+
+export interface ThruTransactionReviewPayload {
+  appName?: string;
+  programAddress?: string;
+  abiName?: string;
+  instruction?: string;
+  simulation?: ThruTransactionReviewSimulation;
+  abiReflection?: ThruTransactionReviewAbiReflection;
+}
+
+export interface ThruTransactionIntent {
+  walletAddress?: string;
+  programAddress: string;
+  instructionData: string;
+  readWriteAddresses?: string[];
+  readOnlyAddresses?: string[];
+  review?: ThruTransactionReviewPayload;
+}
+
+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;
+}