@hfunlabs/hypurr-connect 0.1.14 → 0.1.15

package/README.md

@@ -286,6 +286,7 @@ const {
   selectWallet,
   createWallet,
   deleteWallet,
+  renewAgentWallet,
   refreshWallets,
 } = useHypurrConnect();
 
@@ -305,6 +306,15 @@ const newWallet = await createWallet("Trading");
 
 // Delete a wallet (auto-selects another if the deleted one was active)
 await deleteWallet(walletId);
+
+// Renew an expiring agent wallet after connecting the owner EOA wallet
+await renewAgentWallet({
+  walletId,
+  ownerAddress: address,
+  signTypedDataAsync,
+  chainId,
+  approvalDurationMs: 7 * 24 * 60 * 60 * 1000,
+});
 ```
 
 #### Wallet Packs & Labels
@@ -389,6 +399,7 @@ Returns the full auth and exchange state. Throws if used outside `HypurrConnectP
 | `selectWallet`       | `(walletId: number) => void`                                              | Switch the active wallet                                                                   |
 | `createWallet`       | `(name: string) => Promise<HyperliquidWallet>`                            | Create a new wallet (Telegram only)                                                        |
 | `deleteWallet`       | `(walletId: number) => Promise<void>`                                     | Delete a wallet (Telegram only)                                                            |
+| `renewAgentWallet`   | `(params: RenewAgentWalletParams) => Promise<void>`                       | Renew a Telegram agent wallet by approving the existing agent address with an owner EOA    |
 | `refreshWallets`     | `() => void`                                                              | Re-fetch wallets and packs from the server                                                 |
 | `packs`              | `TelegramChatWalletPack[]`                                                | Wallet packs for the Telegram user                                                         |
 | `createWalletPack`   | `(name: string) => Promise<number>`                                       | Create a wallet pack; returns the new pack ID                                              |
@@ -467,6 +478,7 @@ interface HyperliquidWallet {
   name: string;
   ethereumAddress: string;
   isAgent: boolean;
+  agentExpiresAt?: Timestamp;
   isReadOnly: boolean;
   // ... plus balances, movements, sessions
 }

package/dist/index.d.ts

@@ -105,6 +105,17 @@ interface EoaSignerOptions {
     signTransaction?: EoaSignTransactionFn;
     request?: EvmRequestFn;
 }
+interface RenewAgentWalletParams {
+    walletId: number;
+    /** Connected owner wallet address that will sign the approveAgent transaction. */
+    ownerAddress: Hex;
+    signTypedDataAsync: SignTypedDataFn;
+    chainId: number;
+    /** Approval length used when `agentName` is omitted. Defaults to 1 day. */
+    approvalDurationMs?: number;
+    /** Hyperliquid agent name to approve. Defaults to the Telegram agent-wallet valid_until name. */
+    agentName?: string;
+}
 /**
  * Create an {@link EoaSigner} from any EIP-712 signing function.
  *
@@ -147,6 +158,7 @@ interface HypurrConnectState {
     createWallet: (name: string) => Promise<HyperliquidWallet>;
     deleteWallet: (walletId: number) => Promise<void>;
     renameWallet: (walletId: number, name: string) => Promise<void>;
+    renewAgentWallet: (params: RenewAgentWalletParams) => Promise<void>;
     refreshWallets: () => void;
     packs: TelegramChatWalletPack[];
     createWalletPack: (name: string) => Promise<number>;
@@ -201,6 +213,59 @@ interface LoginModalProps {
 }
 declare function LoginModal({ onConnectWallet, walletIcon, backgroundColor, }: LoginModalProps): react_jsx_runtime.JSX.Element;
 
+interface AgentApprovalDurationOption {
+    label: string;
+    durationMs: number;
+}
+declare const DEFAULT_AGENT_APPROVAL_DURATION_MS: number;
+declare const AGENT_APPROVAL_DURATION_OPTIONS: AgentApprovalDurationOption[];
+declare function createTelegramAgentApprovalName(durationMs?: number): string;
+
+interface AddWalletModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    ownerAddress?: string | null;
+    isWalletConnected?: boolean;
+    chainId?: number;
+    signTypedDataAsync?: SignTypedDataFn;
+    onConnectWallet?: () => void;
+    onDisconnectWallet?: () => void;
+    onWalletAdded?: (wallet?: HyperliquidWallet) => void | Promise<void>;
+    onAddReadOnlyWallet?: (address: string) => void | Promise<void>;
+    onNotify?: (n: {
+        type: "success" | "error";
+        message: string;
+    }) => void;
+    hyperliquidChain?: "Mainnet" | "Testnet" | string;
+    /** Expiration choices for owner-approved agent wallets. Defaults to 1/7/30/90 days. */
+    agentApprovalDurationOptions?: AgentApprovalDurationOption[];
+    /** Initial owner approval duration. Defaults to 1 day. */
+    defaultAgentApprovalDurationMs?: number;
+}
+declare function AddWalletModal({ isOpen, onClose, ownerAddress, isWalletConnected, chainId, signTypedDataAsync, onConnectWallet, onDisconnectWallet, onWalletAdded, onAddReadOnlyWallet, onNotify, hyperliquidChain, agentApprovalDurationOptions, defaultAgentApprovalDurationMs, }: AddWalletModalProps): ReactNode;
+
+interface RenewAgentModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    wallet: HyperliquidWallet | null;
+    ownerAddress?: string | null;
+    isWalletConnected?: boolean;
+    chainId?: number;
+    signTypedDataAsync?: SignTypedDataFn;
+    onConnectWallet?: () => void;
+    onDisconnectWallet?: () => void;
+    onRenewed?: (wallet: HyperliquidWallet) => void | Promise<void>;
+    onNotify?: (n: {
+        type: "success" | "error";
+        message: string;
+    }) => void;
+    /** Expiration choices for the renewed owner approval. Defaults to 1/7/30/90 days. */
+    approvalDurationOptions?: AgentApprovalDurationOption[];
+    /** Initial renewal approval duration. Defaults to 1 day. */
+    defaultApprovalDurationMs?: number;
+}
+declare function RenewAgentModal({ isOpen, onClose, wallet, ownerAddress, isWalletConnected, chainId, signTypedDataAsync, onConnectWallet, onDisconnectWallet, onRenewed, onNotify, approvalDurationOptions, defaultApprovalDurationMs, }: RenewAgentModalProps): ReactNode;
+
 interface PrincipalColors {
     accent: string;
     accentText: string;
@@ -243,6 +308,8 @@ interface UserProfileModalProps {
      * portfolio UI in response.
      */
     onShowPortfolio?: (wallet: HyperliquidWallet) => void;
+    /** Called when the user clicks an agent wallet renew action. Host should connect the owner wallet and call `renewAgentWallet`. */
+    onRenewAgentWallet?: (wallet: HyperliquidWallet) => void;
     /** Optional toast callback. SDK fires success on rename/delete; errors stay inline in sub-modals. */
     onNotify?: (n: {
         type: "success" | "error";
@@ -253,7 +320,7 @@ interface UserProfileModalProps {
     /** Principal accent colors used for switches, action text, and wallet icon surfaces. */
     principalColors?: PrincipalColorOverrides;
 }
-declare function UserProfileModal({ isOpen, onClose, animationsEnabled, onToggleAnimations, defaultSlippage, onSlippageChange, slippageOptions, onWalletDeleted, onWalletRenamed, onShowPortfolio, onNotify, accentColor, principalColors, }: UserProfileModalProps): ReactNode;
+declare function UserProfileModal({ isOpen, onClose, animationsEnabled, onToggleAnimations, defaultSlippage, onSlippageChange, slippageOptions, onWalletDeleted, onWalletRenamed, onShowPortfolio, onRenewAgentWallet, onNotify, accentColor, principalColors, }: UserProfileModalProps): ReactNode;
 
 interface WalletSelectorDropdownProps {
     isOpen: boolean;
@@ -262,6 +329,8 @@ interface WalletSelectorDropdownProps {
     onAddWallet?: () => void;
     /** Called when the user clicks the portfolio icon on a wallet row. */
     onShowPortfolio?: (wallet: HyperliquidWallet) => void;
+    /** Called when the user clicks an agent wallet renew action. Host should connect the owner wallet and call `renewAgentWallet`. */
+    onRenewAgentWallet?: (wallet: HyperliquidWallet) => void;
     /**
      * Called before the SDK's `logout()` runs. Host can do extra cleanup
      * (e.g. wagmi `disconnect()`).
@@ -294,8 +363,22 @@ interface WalletSelectorDropdownProps {
     principalColors?: PrincipalColorOverrides;
     /** CSS color used as the dropdown panel background. Defaults to `rgba(20,20,20,0.95)`. */
     backgroundColor?: string;
+    /** Extra footer rows rendered between "Profile & Settings" and "Logout". */
+    extraFooterItems?: ExtraFooterItem[];
+}
+interface ExtraFooterItem {
+    /** Stable key for React reconciliation. */
+    key: string;
+    /** Leading icon (e.g. an icon from `./icons/lucide`). */
+    icon: ReactNode;
+    /** Row label. */
+    label: string;
+    /** Click handler. The dropdown is NOT auto-closed — call `onClose` yourself if desired. */
+    onClick: () => void;
+    /** Optional hover text color (matches the "Logout" red-on-hover pattern). */
+    hoverColor?: string;
 }
-declare function WalletSelectorDropdown({ isOpen, onClose, onAddWallet, onShowPortfolio, onLogout, onNotify, vipThreshold, animationsEnabled, onToggleAnimations, defaultSlippage, onSlippageChange, slippageOptions, onWalletDeleted, onWalletRenamed, accentColor, principalColors, backgroundColor, }: WalletSelectorDropdownProps): ReactNode;
+declare function WalletSelectorDropdown({ isOpen, onClose, onAddWallet, onShowPortfolio, onRenewAgentWallet, onLogout, onNotify, vipThreshold, animationsEnabled, onToggleAnimations, defaultSlippage, onSlippageChange, slippageOptions, onWalletDeleted, onWalletRenamed, accentColor, principalColors, backgroundColor, extraFooterItems, }: WalletSelectorDropdownProps): ReactNode;
 
 interface DeleteWalletModalProps {
     isOpen: boolean;
@@ -367,4 +450,4 @@ declare class PrivateKeySigner implements AbstractViemLocalAccount {
     signTypedData(params: SignTypedDataParams): Promise<Hex>;
 }
 
-export { type AuthMethod, DeleteWalletModal, type DeleteWalletModalProps, type EoaSignTransactionFn, type EoaSigner, type EoaSignerOptions, type EvmRequestFn, type EvmTransactionRequest, GrpcExchangeTransport, type GrpcExchangeTransportConfig, type Hex, type HypurrConnectConfig, HypurrConnectProvider, type HypurrConnectState, type HypurrUser, LoginModal, type LoginModalProps, type PrincipalColorOverrides, type PrincipalColors, PrivateKeySigner, RenameWalletModal, type RenameWalletModalProps, type ScaleCreateParams, type SignEvmTransactionFn, type SignTypedDataFn, type SlippageOption, type StoredAgent, type TelegramLoginData, type TwapCreateParams, type TwapModifyParams, UserProfileModal, type UserProfileModalProps, WalletSelectorDropdown, type WalletSelectorDropdownProps, createEoaSigner, createStaticClient, createTelegramClient, useHypurrConnect };
+export { AGENT_APPROVAL_DURATION_OPTIONS, AddWalletModal, type AddWalletModalProps, type AgentApprovalDurationOption, type AuthMethod, DEFAULT_AGENT_APPROVAL_DURATION_MS, DeleteWalletModal, type DeleteWalletModalProps, type EoaSignTransactionFn, type EoaSigner, type EoaSignerOptions, type EvmRequestFn, type EvmTransactionRequest, type ExtraFooterItem, GrpcExchangeTransport, type GrpcExchangeTransportConfig, type Hex, type HypurrConnectConfig, HypurrConnectProvider, type HypurrConnectState, type HypurrUser, LoginModal, type LoginModalProps, type PrincipalColorOverrides, type PrincipalColors, PrivateKeySigner, RenameWalletModal, type RenameWalletModalProps, RenewAgentModal, type RenewAgentModalProps, type RenewAgentWalletParams, type ScaleCreateParams, type SignEvmTransactionFn, type SignTypedDataFn, type SlippageOption, type StoredAgent, type TelegramLoginData, type TwapCreateParams, type TwapModifyParams, UserProfileModal, type UserProfileModalProps, WalletSelectorDropdown, type WalletSelectorDropdownProps, createEoaSigner, createStaticClient, createTelegramAgentApprovalName, createTelegramClient, useHypurrConnect };