logiqical 0.3.0 → 0.4.0

package/dist/index.d.mts

@@ -385,6 +385,34 @@ declare class PerpsModule {
     getTradeExecutions(): Promise<any>;
     getPositions(wallet: string): Promise<any>;
     getOpenOrders(wallet: string): Promise<any>;
+    /** Check USDC balance on Arbitrum */
+    getArbitrumUSDCBalance(wallet: string): Promise<string>;
+    /** Check ETH balance on Arbitrum (needed for gas) */
+    getArbitrumETHBalance(wallet: string): Promise<string>;
+    /**
+     * Build a USDC deposit transaction for Hyperliquid on Arbitrum.
+     * Returns an unsigned tx — use with agent.execute() after switching to Arbitrum network.
+     *
+     * Flow: agent.switchNetwork("arbitrum") → agent.execute(agent.perps.buildDepositUSDC(...))
+     */
+    buildDepositUSDC(amount: string): {
+        transaction: {
+            to: string;
+            data: string;
+            value: string;
+            chainId: number;
+            description: string;
+        };
+    };
+    /** Get deposit info (addresses + chain details) */
+    getDepositInfo(): {
+        chain: string;
+        chainId: number;
+        usdcAddress: string;
+        depositAddress: string;
+        decimals: number;
+        tip: string;
+    };
 }
 
 interface BridgeQuoteResponse {
@@ -519,10 +547,44 @@ declare class TicketsModule {
     private ticketsToFractional;
 }
 
+interface AgentRegistration {
+    agentId: string;
+    apiKey: string;
+    verificationCode: string;
+    id: string;
+    handle: string;
+    userName: string;
+    address: string;
+    createdOn: string;
+}
 declare class SocialModule {
     private arenaApiKey?;
     constructor(arenaApiKey?: string | undefined);
     setArenaApiKey(key: string): void;
+    /**
+     * Register a new AI agent on Arena. Returns API key (shown once — save immediately).
+     * After registration, owner must claim by posting: "I'm claiming my AI Agent \"<name>\"\nVerification Code: <code>"
+     */
+    static registerAgent(opts: {
+        name: string;
+        handle: string;
+        address: string;
+        bio?: string;
+        profilePictureUrl?: string;
+        bannerUrl?: string;
+    }): Promise<AgentRegistration>;
+    /** Post a formatted trade update to the Arena feed */
+    postTradeUpdate(trade: {
+        action: "buy" | "sell" | "swap" | "bridge" | "stake" | "long" | "short" | "close";
+        token?: string;
+        amount?: string;
+        price?: string;
+        fromToken?: string;
+        toToken?: string;
+        pnl?: string;
+        hash?: string;
+        extra?: string;
+    }): Promise<any>;
     private request;
     searchUsers(q: string, page?: number, pageSize?: number): Promise<any>;
     getUserByHandle(handle: string): Promise<any>;
@@ -763,6 +825,61 @@ declare class DefiModule {
     }>;
 }
 
+interface Position {
+    coin: string;
+    szi: string;
+    entryPx: string;
+    positionValue: string;
+    unrealizedPnl: string;
+    leverage: {
+        type: string;
+        value: number;
+    };
+}
+interface CopyOrder {
+    symbol: string;
+    direction: "long" | "short";
+    size: number;
+    action: "open" | "close";
+    reason: string;
+}
+declare class CopyTradingModule {
+    private perps;
+    constructor(perps: PerpsModule);
+    /** Fetch all open positions for a Hyperliquid wallet */
+    getTargetPositions(targetWallet: string): Promise<Position[]>;
+    /** Fetch your agent's current positions */
+    getAgentPositions(agentWallet: string): Promise<Position[]>;
+    /**
+     * Compare target wallet positions with agent positions and return orders needed to mirror.
+     * Uses proportional sizing based on the scale factor.
+     *
+     * @param targetWallet - Wallet to copy from
+     * @param agentWallet - Your agent's wallet
+     * @param scaleFactor - Position scale (0.1 = 10% of target size, 1.0 = same size)
+     */
+    calculateMirrorOrders(targetWallet: string, agentWallet: string, scaleFactor?: number): Promise<{
+        orders: CopyOrder[];
+        targetPositions: Position[];
+        agentPositions: Position[];
+    }>;
+    /**
+     * Execute mirror orders via the perps module (Arena API).
+     * Returns results for each order.
+     */
+    executeMirrorOrders(orders: CopyOrder[], currentPrices: Record<string, number>): Promise<any[]>;
+    /**
+     * One-shot copy: calculate + execute mirror orders in one call.
+     * Fetches current prices from Hyperliquid for execution.
+     */
+    copyOnce(targetWallet: string, agentWallet: string, scaleFactor?: number): Promise<{
+        orders: CopyOrder[];
+        results: any[];
+    }>;
+    /** Fetch mid-market prices from Hyperliquid for given symbols */
+    private fetchMidPrices;
+}
+
 interface LogiqicalConfig {
     /** Private key — creates a local wallet for signing (0x-prefixed hex) */
     privateKey?: string;
@@ -820,6 +937,8 @@ declare class Logiqical {
     readonly market: MarketModule;
     /** DeFi — sAVAX liquid staking + ERC-4626 vaults */
     readonly defi: DefiModule;
+    /** Copy trading — mirror Hyperliquid wallet positions */
+    readonly copyTrading: CopyTradingModule;
     /** The agent's wallet address */
     readonly address: string;
     /** The local wallet (null if read-only mode) */
@@ -915,4 +1034,4 @@ declare class LogiqicalError extends Error {
     static from(e: unknown, code?: LogiqicalErrorCode): LogiqicalError;
 }
 
-export { AgentWallet, type AgentWalletConfig, BridgeModule, CHAINS, type CallIntent, type ChainConfig, DefiModule, DexModule, LaunchpadModule, Logiqical, LogiqicalClient, type LogiqicalConfig, LogiqicalError, type LogiqicalErrorCode, MarketModule, type MarketSignal, PerpsModule, PolicyEngine, PolicyError, type PolicyErrorCode, type SignalSummary, SignalsModule, SocialModule, type SpendingPolicy, StakingModule, SwapModule, type TechnicalSignal, type TicketBalanceResponse, type TicketFeesResponse, type TicketPriceResponse, type TicketSupplyResponse, TicketsModule, type TransactionResult, type UnsignedTx };
+export { type AgentRegistration, AgentWallet, type AgentWalletConfig, BridgeModule, CHAINS, type CallIntent, type ChainConfig, type CopyOrder, CopyTradingModule, DefiModule, DexModule, LaunchpadModule, Logiqical, LogiqicalClient, type LogiqicalConfig, LogiqicalError, type LogiqicalErrorCode, MarketModule, type MarketSignal, PerpsModule, PolicyEngine, PolicyError, type PolicyErrorCode, type Position, type SignalSummary, SignalsModule, SocialModule, type SpendingPolicy, StakingModule, SwapModule, type TechnicalSignal, type TicketBalanceResponse, type TicketFeesResponse, type TicketPriceResponse, type TicketSupplyResponse, TicketsModule, type TransactionResult, type UnsignedTx };

package/dist/index.d.ts

@@ -385,6 +385,34 @@ declare class PerpsModule {
     getTradeExecutions(): Promise<any>;
     getPositions(wallet: string): Promise<any>;
     getOpenOrders(wallet: string): Promise<any>;
+    /** Check USDC balance on Arbitrum */
+    getArbitrumUSDCBalance(wallet: string): Promise<string>;
+    /** Check ETH balance on Arbitrum (needed for gas) */
+    getArbitrumETHBalance(wallet: string): Promise<string>;
+    /**
+     * Build a USDC deposit transaction for Hyperliquid on Arbitrum.
+     * Returns an unsigned tx — use with agent.execute() after switching to Arbitrum network.
+     *
+     * Flow: agent.switchNetwork("arbitrum") → agent.execute(agent.perps.buildDepositUSDC(...))
+     */
+    buildDepositUSDC(amount: string): {
+        transaction: {
+            to: string;
+            data: string;
+            value: string;
+            chainId: number;
+            description: string;
+        };
+    };
+    /** Get deposit info (addresses + chain details) */
+    getDepositInfo(): {
+        chain: string;
+        chainId: number;
+        usdcAddress: string;
+        depositAddress: string;
+        decimals: number;
+        tip: string;
+    };
 }
 
 interface BridgeQuoteResponse {
@@ -519,10 +547,44 @@ declare class TicketsModule {
     private ticketsToFractional;
 }
 
+interface AgentRegistration {
+    agentId: string;
+    apiKey: string;
+    verificationCode: string;
+    id: string;
+    handle: string;
+    userName: string;
+    address: string;
+    createdOn: string;
+}
 declare class SocialModule {
     private arenaApiKey?;
     constructor(arenaApiKey?: string | undefined);
     setArenaApiKey(key: string): void;
+    /**
+     * Register a new AI agent on Arena. Returns API key (shown once — save immediately).
+     * After registration, owner must claim by posting: "I'm claiming my AI Agent \"<name>\"\nVerification Code: <code>"
+     */
+    static registerAgent(opts: {
+        name: string;
+        handle: string;
+        address: string;
+        bio?: string;
+        profilePictureUrl?: string;
+        bannerUrl?: string;
+    }): Promise<AgentRegistration>;
+    /** Post a formatted trade update to the Arena feed */
+    postTradeUpdate(trade: {
+        action: "buy" | "sell" | "swap" | "bridge" | "stake" | "long" | "short" | "close";
+        token?: string;
+        amount?: string;
+        price?: string;
+        fromToken?: string;
+        toToken?: string;
+        pnl?: string;
+        hash?: string;
+        extra?: string;
+    }): Promise<any>;
     private request;
     searchUsers(q: string, page?: number, pageSize?: number): Promise<any>;
     getUserByHandle(handle: string): Promise<any>;
@@ -763,6 +825,61 @@ declare class DefiModule {
     }>;
 }
 
+interface Position {
+    coin: string;
+    szi: string;
+    entryPx: string;
+    positionValue: string;
+    unrealizedPnl: string;
+    leverage: {
+        type: string;
+        value: number;
+    };
+}
+interface CopyOrder {
+    symbol: string;
+    direction: "long" | "short";
+    size: number;
+    action: "open" | "close";
+    reason: string;
+}
+declare class CopyTradingModule {
+    private perps;
+    constructor(perps: PerpsModule);
+    /** Fetch all open positions for a Hyperliquid wallet */
+    getTargetPositions(targetWallet: string): Promise<Position[]>;
+    /** Fetch your agent's current positions */
+    getAgentPositions(agentWallet: string): Promise<Position[]>;
+    /**
+     * Compare target wallet positions with agent positions and return orders needed to mirror.
+     * Uses proportional sizing based on the scale factor.
+     *
+     * @param targetWallet - Wallet to copy from
+     * @param agentWallet - Your agent's wallet
+     * @param scaleFactor - Position scale (0.1 = 10% of target size, 1.0 = same size)
+     */
+    calculateMirrorOrders(targetWallet: string, agentWallet: string, scaleFactor?: number): Promise<{
+        orders: CopyOrder[];
+        targetPositions: Position[];
+        agentPositions: Position[];
+    }>;
+    /**
+     * Execute mirror orders via the perps module (Arena API).
+     * Returns results for each order.
+     */
+    executeMirrorOrders(orders: CopyOrder[], currentPrices: Record<string, number>): Promise<any[]>;
+    /**
+     * One-shot copy: calculate + execute mirror orders in one call.
+     * Fetches current prices from Hyperliquid for execution.
+     */
+    copyOnce(targetWallet: string, agentWallet: string, scaleFactor?: number): Promise<{
+        orders: CopyOrder[];
+        results: any[];
+    }>;
+    /** Fetch mid-market prices from Hyperliquid for given symbols */
+    private fetchMidPrices;
+}
+
 interface LogiqicalConfig {
     /** Private key — creates a local wallet for signing (0x-prefixed hex) */
     privateKey?: string;
@@ -820,6 +937,8 @@ declare class Logiqical {
     readonly market: MarketModule;
     /** DeFi — sAVAX liquid staking + ERC-4626 vaults */
     readonly defi: DefiModule;
+    /** Copy trading — mirror Hyperliquid wallet positions */
+    readonly copyTrading: CopyTradingModule;
     /** The agent's wallet address */
     readonly address: string;
     /** The local wallet (null if read-only mode) */
@@ -915,4 +1034,4 @@ declare class LogiqicalError extends Error {
     static from(e: unknown, code?: LogiqicalErrorCode): LogiqicalError;
 }
 
-export { AgentWallet, type AgentWalletConfig, BridgeModule, CHAINS, type CallIntent, type ChainConfig, DefiModule, DexModule, LaunchpadModule, Logiqical, LogiqicalClient, type LogiqicalConfig, LogiqicalError, type LogiqicalErrorCode, MarketModule, type MarketSignal, PerpsModule, PolicyEngine, PolicyError, type PolicyErrorCode, type SignalSummary, SignalsModule, SocialModule, type SpendingPolicy, StakingModule, SwapModule, type TechnicalSignal, type TicketBalanceResponse, type TicketFeesResponse, type TicketPriceResponse, type TicketSupplyResponse, TicketsModule, type TransactionResult, type UnsignedTx };
+export { type AgentRegistration, AgentWallet, type AgentWalletConfig, BridgeModule, CHAINS, type CallIntent, type ChainConfig, type CopyOrder, CopyTradingModule, DefiModule, DexModule, LaunchpadModule, Logiqical, LogiqicalClient, type LogiqicalConfig, LogiqicalError, type LogiqicalErrorCode, MarketModule, type MarketSignal, PerpsModule, PolicyEngine, PolicyError, type PolicyErrorCode, type Position, type SignalSummary, SignalsModule, SocialModule, type SpendingPolicy, StakingModule, SwapModule, type TechnicalSignal, type TicketBalanceResponse, type TicketFeesResponse, type TicketPriceResponse, type TicketSupplyResponse, TicketsModule, type TransactionResult, type UnsignedTx };