@hfunlabs/hypurr-connect 0.1.1 → 0.1.2

package/src/agent.ts

@@ -1,5 +1,7 @@
 import type { StoredAgent } from "./types";
 
+export const AGENT_NAME = "hypurr-connect";
+
 const AGENT_STORAGE_PREFIX = "hypurr-connect-agent";
 
 function storageKey(masterAddress: string): string {
@@ -41,3 +43,81 @@ export async function generateAgentKey(): Promise<{
   const signer = new PrivateKeySigner(privateKey);
   return { privateKey, address: signer.address };
 }
+
+interface ExtraAgent {
+  address: string;
+  name: string;
+  validUntil: number;
+}
+
+/**
+ * Query the Hyperliquid info API for the named agents registered to a user.
+ * Returns the matching entry for AGENT_NAME if it exists and is still valid.
+ */
+export async function fetchActiveAgent(
+  userAddress: string,
+  isTestnet: boolean,
+): Promise<ExtraAgent | null> {
+  const url = isTestnet
+    ? "https://api.hyperliquid-testnet.xyz/info"
+    : "https://api.hyperliquid.xyz/info";
+
+  const res = await fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ type: "extraAgents", user: userAddress }),
+  });
+
+  if (!res.ok) return null;
+
+  const agents: unknown = await res.json();
+  if (!Array.isArray(agents)) return null;
+
+  const nowMs = Date.now();
+  const match = (agents as ExtraAgent[]).find(
+    (a) => a.name === AGENT_NAME && a.validUntil * 1000 > nowMs,
+  );
+  if (!match) return null;
+  return { ...match, validUntil: match.validUntil * 1000 };
+}
+
+/**
+ * Checks whether a stored agent is still valid: the address must appear in the
+ * on-chain `extraAgents` list and not be expired.
+ */
+export async function isAgentValid(
+  stored: StoredAgent,
+  userAddress: string,
+  isTestnet: boolean,
+): Promise<boolean> {
+  if (stored.validUntil <= Date.now()) return false;
+
+  const remote = await fetchActiveAgent(userAddress, isTestnet);
+  if (!remote) return false;
+
+  return (
+    remote.address.toLowerCase() === stored.address.toLowerCase() &&
+    remote.validUntil > Date.now()
+  );
+}
+
+const DEAD_AGENT_PATTERNS = [
+  /agent address .+ is not valid/i,
+  /unknown signer/i,
+  /not authorized/i,
+  /not an agent/i,
+];
+
+/**
+ * Returns true if the error indicates the agent has been pruned, expired,
+ * or is otherwise no longer registered on-chain.
+ */
+export function isDeadAgentError(err: unknown): boolean {
+  const msg =
+    err instanceof Error
+      ? err.message
+      : typeof err === "object" && err !== null && "message" in err
+        ? String((err as { message: unknown }).message)
+        : String(err);
+  return DEAD_AGENT_PATTERNS.some((p) => p.test(msg));
+}

package/src/index.ts

@@ -16,3 +16,7 @@ export type {
   StoredAgent,
   TelegramLoginData,
 } from "./types";
+
+// Re-export wallet types from hypurr-grpc so consumers don't need the dependency
+export type { HyperliquidWallet } from "hypurr-grpc/ts/hypurr/wallet";
+export type { TelegramChatWalletPack } from "hypurr-grpc/ts/hypurr/user";

package/src/types.ts

@@ -1,6 +1,8 @@
 import type { ExchangeClient } from "@hfunlabs/hyperliquid";
 import type { StaticClient } from "hypurr-grpc/ts/hypurr/static/static_service.client";
 import type { TelegramClient } from "hypurr-grpc/ts/hypurr/telegram/telegram_service.client";
+import type { HyperliquidWallet } from "hypurr-grpc/ts/hypurr/wallet";
+import type { TelegramChatWalletPack } from "hypurr-grpc/ts/hypurr/user";
 
 // ─── Config ──────────────────────────────────────────────────────
 
@@ -36,6 +38,8 @@ export interface HypurrUser {
   photoUrl?: string;
   authMethod: AuthMethod;
   telegramId?: string;
+  hfunScore?: number;
+  reputationScore?: number;
 }
 
 // ─── Agent (EOA flow) ────────────────────────────────────────────
@@ -44,6 +48,8 @@ export interface StoredAgent {
   privateKey: `0x${string}`;
   address: `0x${string}`;
   approvedAt: number;
+  /** Epoch ms from the `extraAgents` response; agent is invalid after this time. */
+  validUntil: number;
 }
 
 export type SignTypedDataFn = (params: {
@@ -69,10 +75,33 @@ export interface HypurrConnectState {
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   exchange: ExchangeClient<any> | null;
 
-  // USDC balance from Hyperliquid perps clearinghouse
-  usdcBalance: string | null;
-  usdcBalanceLoading: boolean;
-  refreshBalance: () => void;
+  // Multi-wallet (Telegram only — EOA has a single wallet)
+  wallets: HyperliquidWallet[];
+  selectedWalletId: number;
+  selectWallet: (walletId: number) => void;
+
+  // Wallet management (Telegram only)
+  createWallet: (name: string) => Promise<HyperliquidWallet>;
+  deleteWallet: (walletId: number) => Promise<void>;
+  refreshWallets: () => void;
+
+  // Wallet packs & labels (Telegram only)
+  packs: TelegramChatWalletPack[];
+  createWalletPack: (name: string) => Promise<number>;
+  addPackLabel: (params: {
+    walletAddress: string;
+    walletLabel: string;
+    packId: number;
+  }) => Promise<void>;
+  modifyPackLabel: (params: {
+    walletLabelOld: string;
+    walletLabelNew: string;
+    packId: number;
+  }) => Promise<void>;
+  removePackLabel: (params: {
+    walletLabel: string;
+    packId: number;
+  }) => Promise<void>;
 
   // Login modal
   loginModalOpen: boolean;
@@ -80,14 +109,16 @@ export interface HypurrConnectState {
   closeLoginModal: () => void;
 
   // Auth actions
-  loginTelegram: (data: TelegramLoginData) => void;
-  loginEoa: (address: `0x${string}`) => void;
+  connectEoa: (address: `0x${string}`) => void;
+  approveAgent: (
+    signTypedDataAsync: SignTypedDataFn,
+    chainId: number,
+  ) => Promise<void>;
   logout: () => void;
 
   // EOA agent management
   agent: StoredAgent | null;
   agentReady: boolean;
-  approveAgent: (signTypedDataAsync: SignTypedDataFn) => Promise<void>;
   clearAgent: () => void;
 
   // Telegram config