@hfunlabs/hypurr-connect 0.1.11 → 0.1.13

package/README.md

@@ -220,6 +220,24 @@ connectEoa(address); // no signer — only L1 actions after manual approval
 await approveAgent(signTypedDataAsync, chainId);
 ```
 
+### EVM Transaction Signing
+
+`signEvmTransaction(transaction)` signs a JSON-RPC-style EVM transaction and returns the raw serialized transaction. In Telegram mode it calls the `EVMSignTransaction` gRPC endpoint for the selected private-key wallet; in EOA mode it calls the `signTransaction` or EIP-1193 `request` function supplied to `connectEoa`.
+
+```tsx
+const { signEvmTransaction } = useHypurrConnect();
+
+const raw = await signEvmTransaction({
+  to: "0x0000000000000000000000000000000000000000",
+  data: "0x",
+  value: "0x0",
+  chainId: "0x66eee",
+  nonce: "0x1",
+  gas: "0x5208",
+  gasPrice: "0x3b9aca00",
+});
+```
+
 ### Using the Exchange Client
 
 Once authenticated, the `exchange` object from `useHypurrConnect()` is a fully functional `ExchangeClient` from `@hfunlabs/hyperliquid`. For EOA users with a signer, it handles **both** L1 and user-signed actions transparently:
@@ -381,12 +399,12 @@ Returns the full auth and exchange state. Throws if used outside `HypurrConnectP
 | `openLoginModal`     | `() => void`                                                              | Show the login modal                                                                       |
 | `closeLoginModal`    | `() => void`                                                              | Hide the login modal                                                                       |
 | `connectEoa`         | `(address: \`0x\${string}\`, signer?: EoaSigner) => void`                 | Connect EOA wallet (sync); pass signer to enable user-signed actions and auto-provisioning |
+| `signEvmTransaction` | `(transaction: EvmTransactionRequest) => Promise<\`0x\${string}\`>`       | Sign an EVM transaction through EOA wallet provider or Telegram RPC                        |
 | `approveAgent`       | `(signTypedDataAsync: SignTypedDataFn, chainId: number) => Promise<void>` | Approve a named agent key (async, triggers wallet prompt)                                  |
 | `logout`             | `() => void`                                                              | Clear all auth state and localStorage                                                      |
 | `agent`              | `StoredAgent \| null`                                                     | Current agent key (EOA flow only)                                                          |
 | `agentReady`         | `boolean`                                                                 | Whether the exchange client can sign (true for TG, or EOA+agent)                           |
 | `clearAgent`         | `() => void`                                                              | Remove the agent key from state and storage                                                |
-| `botId`              | `string`                                                                  | Deprecated legacy Telegram bot ID from config                                              |
 | `authDataMap`        | `Record<string, string>`                                                  | Deprecated; empty when using hub JWT auth                                                  |
 | `authToken`          | `string \| null`                                                          | JWT returned by the auth hub                                                               |
 | `telegramRpcOptions` | `RpcOptions \| undefined`                                                 | gRPC call options containing `Authorization: Bearer <jwt>` metadata                        |
@@ -473,11 +491,13 @@ Encapsulates the master wallet's EIP-712 signing function and chain ID. Pass to
 ```typescript
 interface EoaSigner {
   signTypedData: SignTypedDataFn;
+  signTransaction?: (transaction: EvmTransactionRequest) => Promise<unknown>;
+  request?: (args: { method: string; params?: unknown[] }) => Promise<unknown>;
   chainId: number;
 }
 ```
 
-#### `createEoaSigner(signTypedData, chainId): EoaSigner`
+#### `createEoaSigner(signTypedData, chainId, options?): EoaSigner`
 
 Helper to create an `EoaSigner` from wagmi's `signTypedDataAsync` (or any compatible function). Accepts either a direct function or a `{ current: Function }` ref to avoid stale closures with React hooks:
 
@@ -489,6 +509,11 @@ const signer = createEoaSigner(signerRef, chainId);
 
 // With a direct function (fine for stable references)
 const signer = createEoaSigner(signTypedDataAsync, chainId);
+
+// With an EIP-1193 provider for EVM transaction signing
+const signer = createEoaSigner(signTypedDataAsync, chainId, {
+  request: provider.request.bind(provider),
+});
 ```
 
 #### `SignTypedDataFn`

package/dist/index.d.ts

@@ -11,6 +11,7 @@ import { TelegramChatWalletPack } from 'hypurr-grpc/ts/hypurr/user';
 export { TelegramChatWalletPack } from 'hypurr-grpc/ts/hypurr/user';
 import { HyperliquidWallet } from 'hypurr-grpc/ts/hypurr/wallet';
 export { HyperliquidWallet } from 'hypurr-grpc/ts/hypurr/wallet';
+import { AbstractViemLocalAccount } from '@hfunlabs/hyperliquid/signing';
 
 interface HypurrConnectConfig {
     /** gRPC-web base URL. Defaults to https://grpc.hypurr.fun. */
@@ -21,19 +22,15 @@ interface HypurrConnectConfig {
     isTestnet?: boolean;
     /** Polling interval in ms for TWAP/Scale session updates. Default 5000. Set 0 to disable. */
     sessionPollInterval?: number;
-    telegram: {
-        /** Deprecated for the hub flow; retained for older consumers. */
-        botUsername?: string;
-        /** Deprecated for the hub flow; retained for older consumers. */
-        botId?: string;
-        /** Deprecated: Telegram login is now handled by the auth hub. */
-        useWidget?: boolean;
+    telegram?: {
         /** Auth hub login URL. Defaults to https://auth.hypurr.fun/login. */
         authHubUrl?: string;
         /** Optional callback URL. Defaults to the current page without auth query params. */
         returnTo?: string | (() => string);
         /** Requested hub scopes. Defaults to the scopes required by this SDK. */
         scope?: string | string[];
+        /** @deprecated Telegram login is handled by the auth hub; this option is ignored. */
+        useWidget?: boolean;
     };
 }
 /** @deprecated Telegram login is handled by the auth hub; raw Telegram data is no longer used by the provider. */
@@ -73,11 +70,41 @@ type SignTypedDataFn = (params: {
     primaryType: string;
     message: Record<string, unknown>;
 }) => Promise<`0x${string}`>;
+type Hex = `0x${string}`;
+interface EvmTransactionRequest {
+    from?: Hex;
+    to?: Hex;
+    gas?: Hex;
+    gasPrice?: Hex;
+    value?: Hex;
+    data?: Hex;
+    nonce?: Hex;
+    chainId?: Hex;
+    maxFeePerGas?: Hex;
+    maxPriorityFeePerGas?: Hex;
+    type?: Hex;
+    accessList?: unknown;
+    [key: string]: unknown;
+}
+type EvmRequestFn = (args: {
+    method: string;
+    params?: unknown[];
+}) => Promise<unknown>;
+type SignEvmTransactionFn = (transaction: EvmTransactionRequest) => Promise<Hex>;
+type EoaSignTransactionFn = (transaction: EvmTransactionRequest) => Promise<unknown>;
 /** Wallet signer provided at EOA connect time for user-signed actions. */
 interface EoaSigner {
     signTypedData: SignTypedDataFn;
+    /** Optional raw EVM transaction signer. Used by `signEvmTransaction()` in EOA mode. */
+    signTransaction?: EoaSignTransactionFn;
+    /** Optional EIP-1193 provider request function. Used as a fallback for `eth_signTransaction`. */
+    request?: EvmRequestFn;
     chainId: number;
 }
+interface EoaSignerOptions {
+    signTransaction?: EoaSignTransactionFn;
+    request?: EvmRequestFn;
+}
 /**
  * Create an {@link EoaSigner} from any EIP-712 signing function.
  *
@@ -103,7 +130,7 @@ interface EoaSigner {
  */
 declare function createEoaSigner(signTypedDataAsync: ((args: Record<string, unknown>) => Promise<`0x${string}`>) | {
     current: (args: Record<string, unknown>) => Promise<`0x${string}`>;
-}, chainId: number): EoaSigner;
+}, chainId: number, options?: EoaSignerOptions): EoaSigner;
 type TwapCreateParams = Omit<HyperliquidTwapCreateRequest, "authData" | "walletId">;
 type TwapModifyParams = Omit<HyperliquidTwapModifyRequest, "authData" | "walletId">;
 type ScaleCreateParams = Omit<HyperliquidScaleCreateRequest, "authData" | "walletId">;
@@ -119,6 +146,7 @@ interface HypurrConnectState {
     selectWallet: (walletId: number) => void;
     createWallet: (name: string) => Promise<HyperliquidWallet>;
     deleteWallet: (walletId: number) => Promise<void>;
+    renameWallet: (walletId: number, name: string) => Promise<void>;
     refreshWallets: () => void;
     packs: TelegramChatWalletPack[];
     createWalletPack: (name: string) => Promise<number>;
@@ -145,12 +173,12 @@ interface HypurrConnectState {
     openLoginModal: () => void;
     closeLoginModal: () => void;
     connectEoa: (address: `0x${string}`, signer?: EoaSigner) => void;
+    signEvmTransaction: SignEvmTransactionFn;
     approveAgent: (signTypedDataAsync: SignTypedDataFn, chainId: number) => Promise<void>;
     logout: () => void;
     agent: StoredAgent | null;
     agentReady: boolean;
     clearAgent: () => void;
-    botId: string;
     /** Deprecated: JWT auth leaves authData empty; use `telegramRpcOptions` for low-level calls. */
     authDataMap: Record<string, string>;
     authToken: string | null;
@@ -171,6 +199,129 @@ interface LoginModalProps {
 }
 declare function LoginModal({ onConnectWallet, walletIcon }: LoginModalProps): react_jsx_runtime.JSX.Element;
 
+interface PrincipalColors {
+    accent: string;
+    accentText: string;
+    accentBackground: string;
+    accentBorder: string;
+    accentHoverBackground: string;
+}
+type PrincipalColorOverrides = Partial<PrincipalColors>;
+
+interface SlippageOption {
+    label: string;
+    value: number;
+}
+interface UserProfileModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    /** Current value for the "Animations" toggle. */
+    animationsEnabled: boolean;
+    /** Called when the user flips the animations toggle. */
+    onToggleAnimations: () => void;
+    /** Current default slippage value (e.g. 0.01 = 1%). */
+    defaultSlippage: number;
+    /** Called when the user picks a slippage option. */
+    onSlippageChange: (value: number) => void;
+    /** Override the slippage choices. Defaults to 0.5/1/2/5/10%. */
+    slippageOptions?: SlippageOption[];
+    /**
+     * Fired after the SDK successfully deletes a wallet. Use this for extra
+     * side effects on the host (e.g. invalidating React Query caches).
+     */
+    onWalletDeleted?: (walletId: number) => void;
+    /**
+     * Fired after the SDK successfully renames a wallet. Use this for extra
+     * side effects on the host (e.g. invalidating React Query caches).
+     */
+    onWalletRenamed?: (walletId: number, name: string) => void;
+    /**
+     * If provided, each wallet row in the Wallets tab gets a "View portfolio"
+     * button that fires this callback. The host is expected to open its own
+     * portfolio UI in response.
+     */
+    onShowPortfolio?: (wallet: HyperliquidWallet) => void;
+    /** Optional toast callback. SDK fires success on rename/delete; errors stay inline in sub-modals. */
+    onNotify?: (n: {
+        type: "success" | "error";
+        message: string;
+    }) => void;
+    /** Shorthand for `principalColors.accent`. Defaults to `#a855f7`. */
+    accentColor?: string;
+    /** 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;
+
+interface WalletSelectorDropdownProps {
+    isOpen: boolean;
+    onClose: () => void;
+    /** Called when the user clicks "Add Wallet". Host renders the add-wallet UI. */
+    onAddWallet?: () => void;
+    /** Called when the user clicks the portfolio icon on a wallet row. */
+    onShowPortfolio?: (wallet: HyperliquidWallet) => void;
+    /**
+     * Called before the SDK's `logout()` runs. Host can do extra cleanup
+     * (e.g. wagmi `disconnect()`).
+     */
+    onLogout?: () => void;
+    /** Toast callback. Fires "Address copied" success on copy-address clicks. */
+    onNotify?: (n: {
+        type: "success" | "error";
+        message: string;
+    }) => void;
+    /** HFun score threshold for the VIP crown. Defaults to 10. */
+    vipThreshold?: number;
+    /** Current value for the "Animations" toggle. */
+    animationsEnabled: boolean;
+    /** Called when the user flips the animations toggle. */
+    onToggleAnimations: () => void;
+    /** Current default slippage value (e.g. 0.01 = 1%). */
+    defaultSlippage: number;
+    /** Called when the user picks a slippage option. */
+    onSlippageChange: (value: number) => void;
+    /** Override the slippage choices. Defaults to 0.5/1/2/5/10%. */
+    slippageOptions?: SlippageOption[];
+    /** Fired after the SDK successfully deletes a wallet. */
+    onWalletDeleted?: (walletId: number) => void;
+    /** Fired after the SDK successfully renames a wallet. */
+    onWalletRenamed?: (walletId: number, name: string) => void;
+    /** Shorthand for `principalColors.accent`. Defaults to `#a855f7`. */
+    accentColor?: string;
+    /** Principal accent colors used for add-wallet text, wallet icon surfaces, and the Profile & Settings modal. */
+    principalColors?: PrincipalColorOverrides;
+    /** CSS color used as the dropdown panel background. Defaults to `rgba(20,20,20,0.95)`. */
+    backgroundColor?: string;
+}
+declare function WalletSelectorDropdown({ isOpen, onClose, onAddWallet, onShowPortfolio, onLogout, onNotify, vipThreshold, animationsEnabled, onToggleAnimations, defaultSlippage, onSlippageChange, slippageOptions, onWalletDeleted, onWalletRenamed, accentColor, principalColors, backgroundColor, }: WalletSelectorDropdownProps): ReactNode;
+
+interface DeleteWalletModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    wallet: HyperliquidWallet | null;
+    onConfirm: (walletId: number) => Promise<void>;
+    /** Optional toast callback. Fires `{type:"success"}` on delete; errors are shown inline. */
+    onNotify?: (n: {
+        type: "success" | "error";
+        message: string;
+    }) => void;
+}
+declare function DeleteWalletModal({ isOpen, onClose, wallet, onConfirm, onNotify, }: DeleteWalletModalProps): ReactNode;
+
+interface RenameWalletModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    wallet: HyperliquidWallet | null;
+    onConfirm: (walletId: number, name: string) => Promise<void>;
+    onNotify?: (n: {
+        type: "success" | "error";
+        message: string;
+    }) => void;
+    /** Kept for compatibility. Profile modal actions now use the shared app raised button style. */
+    accentColor?: string;
+}
+declare function RenameWalletModal({ isOpen, onClose, wallet, onConfirm, onNotify, }: RenameWalletModalProps): ReactNode;
+
 interface GrpcExchangeTransportConfig {
     isTestnet?: boolean;
     telegramClient: TelegramClient;
@@ -201,4 +352,17 @@ declare class GrpcExchangeTransport implements IRequestTransport {
 declare function createTelegramClient(config: HypurrConnectConfig): TelegramClient;
 declare function createStaticClient(config: HypurrConnectConfig): StaticClient;
 
-export { type AuthMethod, type EoaSigner, GrpcExchangeTransport, type GrpcExchangeTransportConfig, type HypurrConnectConfig, HypurrConnectProvider, type HypurrConnectState, type HypurrUser, LoginModal, type LoginModalProps, type ScaleCreateParams, type SignTypedDataFn, type StoredAgent, type TelegramLoginData, type TwapCreateParams, type TwapModifyParams, createEoaSigner, createStaticClient, createTelegramClient, useHypurrConnect };
+type SignTypedDataParams = Parameters<AbstractViemLocalAccount["signTypedData"]>[0];
+/**
+ * Compatibility wrapper for SDK versions that removed PrivateKeySigner.
+ *
+ * It exposes the viem local-account shape accepted by the Hyperliquid SDK.
+ */
+declare class PrivateKeySigner implements AbstractViemLocalAccount {
+    #private;
+    readonly address: Hex;
+    constructor(privateKey: string);
+    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 };