logiqical 0.0.11 → 0.1.1

package/dist/index.d.mts

@@ -256,6 +256,115 @@ interface DexSwapResponse {
     transactions: UnsignedTx[];
     summary: string;
 }
+interface PerpsSetupResponse {
+    success: boolean;
+    message: string;
+}
+interface PerpsTradingPair {
+    provider: string;
+    dex: string;
+    name: string;
+    symbol: string;
+    icon: string;
+    baseAssetId: number;
+    baseAsset: string;
+    quoteAsset: string;
+    sizePrecision: number;
+    pricePrecision: number;
+    maxLeverage: number;
+    isDelisted: boolean;
+    isOnlyIsolated: boolean;
+    marginMode: string;
+}
+interface PerpsTradingPairsResponse {
+    pairs: PerpsTradingPair[];
+    cachedAt: string;
+    count: number;
+}
+interface PerpsOrderResponse {
+    [key: string]: any;
+}
+interface PerpsPositionsResponse {
+    assetPositions?: any[];
+    marginSummary?: {
+        accountValue: string;
+        totalMarginUsed: string;
+        totalNtlPos: string;
+        totalRawUsd: string;
+    };
+    [key: string]: any;
+}
+interface BridgeTransaction {
+    to: string;
+    data: string;
+    value: string;
+    gasLimit?: string;
+    chainId: number;
+}
+interface BridgeQuoteResponse {
+    id: string;
+    fromChainId: number;
+    toChainId: number;
+    fromToken: string;
+    toToken: string;
+    fromAmount: string;
+    toAmount: string;
+    estimatedGas: string;
+    estimatedTime: number;
+    tool: string;
+    transaction?: BridgeTransaction;
+}
+interface BridgeRoutesResponse {
+    routes: BridgeQuoteResponse[];
+    count: number;
+}
+interface BridgeStatusResponse {
+    status: "NOT_FOUND" | "PENDING" | "DONE" | "FAILED";
+    substatus?: string;
+    receiving?: {
+        txHash: string;
+        amount: string;
+        token: string;
+        chainId: number;
+    };
+}
+interface BridgeLiFiToken {
+    address: string;
+    symbol: string;
+    decimals: number;
+    name: string;
+    priceUSD?: string;
+    chainId: number;
+}
+interface BridgeLiFiChain {
+    id: number;
+    key: string;
+    name: string;
+    chainType: string;
+    nativeToken?: {
+        symbol: string;
+        decimals: number;
+        address: string;
+    };
+}
+interface BridgeTokensResponse {
+    tokens: Record<string, BridgeLiFiToken[]>;
+}
+interface BridgeTokenResponse extends BridgeLiFiToken {
+}
+interface BridgeChainsResponse {
+    chains: BridgeLiFiChain[];
+    count: number;
+}
+interface BridgeConnectionsResponse {
+    connections: any[];
+}
+interface BridgeInfoResponse {
+    chains: Record<string, number>;
+    usdc: Record<string, string>;
+    nativeToken: string;
+    tip: string;
+}
 interface RegisterResponse {
     apiKey: string;
     wallet: string;
@@ -532,6 +641,151 @@ declare class DexModule {
     buildSwap(wallet: string, from: string, to: string, amount: string, slippage?: number): Promise<DexSwapResponse>;
 }
 
+declare class PerpsModule {
+    private http;
+    private auth;
+    constructor(http: HttpClient, auth: () => Promise<void>);
+    /**
+     * Link your Arena API key to enable perps trading.
+     * One-time setup — after this, all /perp endpoints work automatically.
+     * @param arenaApiKey - Your Arena API key (from arena.social)
+     */
+    setup(arenaApiKey: string): Promise<PerpsSetupResponse>;
+    /** Register for perps trading on Hyperliquid */
+    register(): Promise<any>;
+    /** Check perps registration status */
+    getRegistrationStatus(): Promise<any>;
+    /** Get your Hyperliquid API wallet address */
+    getWalletAddress(): Promise<any>;
+    /** Check which auth steps are completed */
+    getAuthStatus(): Promise<any>;
+    /**
+     * Get EIP-712 payload for an auth step.
+     * @param step - Auth step: "accept-terms", "approve-agent", "set-referrer", "approve-builder-fee"
+     * @param body - Optional body (accept-terms requires mainWalletAddress)
+     */
+    getAuthPayload(step: string, body?: any): Promise<any>;
+    /**
+     * Submit signed EIP-712 payload for an auth step.
+     * @param step - Auth step
+     * @param body - Signed payload with signature and metadata
+     */
+    submitAuthSignature(step: string, body: any): Promise<any>;
+    /** Enable HIP-3 abstraction (automated, no signature needed) */
+    enableHip3(): Promise<any>;
+    /** Get all available perpetual trading pairs (250+ markets) */
+    getTradingPairs(): Promise<PerpsTradingPairsResponse>;
+    /**
+     * Update leverage for a market. Must be called before first order.
+     * @param symbol - Market symbol (e.g. "BTC", "ETH")
+     * @param leverage - Leverage multiplier (1-50 depending on market)
+     * @param leverageType - "cross" or "isolated"
+     */
+    updateLeverage(symbol: string, leverage: number, leverageType?: "cross" | "isolated"): Promise<any>;
+    /**
+     * Place one or more perpetual orders.
+     * @param orders - Array of order objects (see docs for BaseOrderParams)
+     */
+    placeOrder(orders: any[]): Promise<PerpsOrderResponse>;
+    /**
+     * Cancel one or more open orders.
+     * @param cancels - Array of { assetIndex, oid }
+     */
+    cancelOrders(cancels: {
+        assetIndex: number;
+        oid: number;
+    }[]): Promise<any>;
+    /**
+     * Modify an existing order.
+     * @param oid - Order ID to modify
+     * @param order - New order parameters
+     */
+    modifyOrder(oid: number, order: any): Promise<any>;
+    /**
+     * Close a position (convenience — creates reduce-only IOC with 10% slippage).
+     * @param symbol - Market symbol
+     * @param positionSide - "long" or "short"
+     * @param size - Position size to close
+     * @param currentPrice - Current market price
+     * @param closePercent - Percentage to close (default: 100)
+     */
+    closePosition(symbol: string, positionSide: "long" | "short", size: number, currentPrice: number, closePercent?: number): Promise<any>;
+    /** Get open orders */
+    getOrders(): Promise<any>;
+    /** Get trade execution history */
+    getTradeExecutions(): Promise<any>;
+    /**
+     * Get positions and margin summary (queries Hyperliquid directly).
+     * @param wallet - Your Hyperliquid wallet address (from getWalletAddress)
+     */
+    getPositions(wallet: string): Promise<PerpsPositionsResponse>;
+    /**
+     * Get open orders from Hyperliquid directly.
+     * @param wallet - Your Hyperliquid wallet address
+     */
+    getOpenOrders(wallet: string): Promise<any>;
+}
+
+declare class BridgeModule {
+    private http;
+    private auth;
+    constructor(http: HttpClient, auth: () => Promise<void>);
+    /**
+     * Get all supported chains for cross-chain bridging.
+     */
+    getChains(): Promise<BridgeChainsResponse>;
+    /**
+     * Get tokens available on specified chains.
+     * @param chains - Comma-separated chain IDs (e.g. "43114,42161")
+     */
+    getTokens(chains: string): Promise<BridgeTokensResponse>;
+    /**
+     * Get info for a specific token on a chain.
+     * @param chainId - Chain ID
+     * @param address - Token contract address
+     */
+    getToken(chainId: number, address: string): Promise<BridgeTokenResponse>;
+    /**
+     * Get available bridge connections between two chains.
+     * @param fromChainId - Source chain ID
+     * @param toChainId - Destination chain ID
+     * @param fromToken - Optional source token address
+     * @param toToken - Optional destination token address
+     */
+    getConnections(fromChainId: number, toChainId: number, fromToken?: string, toToken?: string): Promise<BridgeConnectionsResponse>;
+    /**
+     * Get a bridge quote with unsigned transaction data.
+     * The agent signs the returned tx on the source chain.
+     *
+     * @param fromChainId - Source chain ID
+     * @param toChainId - Destination chain ID
+     * @param fromToken - Source token address (use 0x0000...0000 for native tokens)
+     * @param toToken - Destination token address
+     * @param fromAmount - Human-readable amount (e.g. "0.1")
+     * @param fromAddress - Sender wallet address
+     * @param toAddress - Optional receiver address (defaults to fromAddress)
+     * @param slippage - Slippage tolerance as decimal (default 0.03 = 3%)
+     * @param fromDecimals - Token decimals (default 18)
+     */
+    getQuote(fromChainId: number, toChainId: number, fromToken: string, toToken: string, fromAmount: string, fromAddress: string, toAddress?: string, slippage?: number, fromDecimals?: number): Promise<BridgeQuoteResponse>;
+    /**
+     * Get multiple bridge route options.
+     */
+    getRoutes(fromChainId: number, toChainId: number, fromToken: string, toToken: string, fromAmount: string, fromAddress: string, toAddress?: string, slippage?: number, fromDecimals?: number): Promise<BridgeRoutesResponse>;
+    /**
+     * Check bridge transfer status.
+     * @param txHash - Source chain transaction hash
+     * @param fromChainId - Source chain ID
+     * @param toChainId - Destination chain ID
+     * @param bridge - Optional bridge tool name
+     */
+    getStatus(txHash: string, fromChainId: number, toChainId: number, bridge?: string): Promise<BridgeStatusResponse>;
+    /**
+     * Get reference info — common chain IDs, USDC addresses, native token constant.
+     */
+    getInfo(): Promise<BridgeInfoResponse>;
+}
+
 interface LogiqicalConfig {
     /** Your wallet address — used for auto-registration */
     wallet: string;
@@ -563,8 +817,12 @@ declare class LogiqicalClient {
     readonly staking: StakingModule;
     /** Discover, research, and trade launchpad tokens on bonding curves */
     readonly launchpad: LaunchpadModule;
-    /** Swap any Avalanche token via LFJ + Pharaoh DEX */
+    /** Swap any Avalanche token via LFJ + Arena DEX */
     readonly dex: DexModule;
+    /** Trade perpetual futures on Hyperliquid via Arena */
+    readonly perps: PerpsModule;
+    /** Cross-chain token bridging via Li.Fi — any token, any chain */
+    readonly bridge: BridgeModule;
     private http;
     private wallet;
     private agentName;
@@ -605,4 +863,4 @@ declare class LogiqicalAuthError extends LogiqicalError {
     constructor(endpoint: string);
 }
 
-export { type ArenaCommunity, type BalancesResponse, type BroadcastResponse, type BuildCreateResponse, type BuyQuoteResponse, type DexBalanceResponse, DexModule, type DexQuoteResponse, type DexSwapResponse, type DexTokenEntry, type DexTokenInfoResponse, type DexTokensResponse, type GlobalTradeEntry, type GlobalTradesResponse, type HealthResponse, type HolderEntry, type LaunchTokenResponse, type LaunchpadBuyResponse, type LaunchpadListResponse, LaunchpadModule, type LaunchpadQuoteResponse, type LaunchpadSellResponse, type LaunchpadToken, LogiqicalAuthError, LogiqicalClient, type LogiqicalConfig, LogiqicalError, type RegisterResponse, type SellQuoteResponse, type StakeBuildResponse, type StakeInfoResponse, StakingModule, type SwapBuyResponse, SwapModule, type SwapSellResponse, type TokenActivityResponse, type TokenCreator, type TokenDetailResponse, type TokenHoldersResponse, type TokenStatsTimeframes, type TradeEntry, type UnsignedTx, type UploadImageResponse };
+export { type ArenaCommunity, type BalancesResponse, type BridgeChainsResponse, type BridgeConnectionsResponse, type BridgeInfoResponse, type BridgeLiFiChain, type BridgeLiFiToken, BridgeModule, type BridgeQuoteResponse, type BridgeRoutesResponse, type BridgeStatusResponse, type BridgeTokenResponse, type BridgeTokensResponse, type BridgeTransaction, type BroadcastResponse, type BuildCreateResponse, type BuyQuoteResponse, type DexBalanceResponse, DexModule, type DexQuoteResponse, type DexSwapResponse, type DexTokenEntry, type DexTokenInfoResponse, type DexTokensResponse, type GlobalTradeEntry, type GlobalTradesResponse, type HealthResponse, type HolderEntry, type LaunchTokenResponse, type LaunchpadBuyResponse, type LaunchpadListResponse, LaunchpadModule, type LaunchpadQuoteResponse, type LaunchpadSellResponse, type LaunchpadToken, LogiqicalAuthError, LogiqicalClient, type LogiqicalConfig, LogiqicalError, PerpsModule, type PerpsOrderResponse, type PerpsPositionsResponse, type PerpsSetupResponse, type PerpsTradingPair, type PerpsTradingPairsResponse, type RegisterResponse, type SellQuoteResponse, type StakeBuildResponse, type StakeInfoResponse, StakingModule, type SwapBuyResponse, SwapModule, type SwapSellResponse, type TokenActivityResponse, type TokenCreator, type TokenDetailResponse, type TokenHoldersResponse, type TokenStatsTimeframes, type TradeEntry, type UnsignedTx, type UploadImageResponse };

package/dist/index.d.ts

@@ -256,6 +256,115 @@ interface DexSwapResponse {
     transactions: UnsignedTx[];
     summary: string;
 }
+interface PerpsSetupResponse {
+    success: boolean;
+    message: string;
+}
+interface PerpsTradingPair {
+    provider: string;
+    dex: string;
+    name: string;
+    symbol: string;
+    icon: string;
+    baseAssetId: number;
+    baseAsset: string;
+    quoteAsset: string;
+    sizePrecision: number;
+    pricePrecision: number;
+    maxLeverage: number;
+    isDelisted: boolean;
+    isOnlyIsolated: boolean;
+    marginMode: string;
+}
+interface PerpsTradingPairsResponse {
+    pairs: PerpsTradingPair[];
+    cachedAt: string;
+    count: number;
+}
+interface PerpsOrderResponse {
+    [key: string]: any;
+}
+interface PerpsPositionsResponse {
+    assetPositions?: any[];
+    marginSummary?: {
+        accountValue: string;
+        totalMarginUsed: string;
+        totalNtlPos: string;
+        totalRawUsd: string;
+    };
+    [key: string]: any;
+}
+interface BridgeTransaction {
+    to: string;
+    data: string;
+    value: string;
+    gasLimit?: string;
+    chainId: number;
+}
+interface BridgeQuoteResponse {
+    id: string;
+    fromChainId: number;
+    toChainId: number;
+    fromToken: string;
+    toToken: string;
+    fromAmount: string;
+    toAmount: string;
+    estimatedGas: string;
+    estimatedTime: number;
+    tool: string;
+    transaction?: BridgeTransaction;
+}
+interface BridgeRoutesResponse {
+    routes: BridgeQuoteResponse[];
+    count: number;
+}
+interface BridgeStatusResponse {
+    status: "NOT_FOUND" | "PENDING" | "DONE" | "FAILED";
+    substatus?: string;
+    receiving?: {
+        txHash: string;
+        amount: string;
+        token: string;
+        chainId: number;
+    };
+}
+interface BridgeLiFiToken {
+    address: string;
+    symbol: string;
+    decimals: number;
+    name: string;
+    priceUSD?: string;
+    chainId: number;
+}
+interface BridgeLiFiChain {
+    id: number;
+    key: string;
+    name: string;
+    chainType: string;
+    nativeToken?: {
+        symbol: string;
+        decimals: number;
+        address: string;
+    };
+}
+interface BridgeTokensResponse {
+    tokens: Record<string, BridgeLiFiToken[]>;
+}
+interface BridgeTokenResponse extends BridgeLiFiToken {
+}
+interface BridgeChainsResponse {
+    chains: BridgeLiFiChain[];
+    count: number;
+}
+interface BridgeConnectionsResponse {
+    connections: any[];
+}
+interface BridgeInfoResponse {
+    chains: Record<string, number>;
+    usdc: Record<string, string>;
+    nativeToken: string;
+    tip: string;
+}
 interface RegisterResponse {
     apiKey: string;
     wallet: string;
@@ -532,6 +641,151 @@ declare class DexModule {
     buildSwap(wallet: string, from: string, to: string, amount: string, slippage?: number): Promise<DexSwapResponse>;
 }
 
+declare class PerpsModule {
+    private http;
+    private auth;
+    constructor(http: HttpClient, auth: () => Promise<void>);
+    /**
+     * Link your Arena API key to enable perps trading.
+     * One-time setup — after this, all /perp endpoints work automatically.
+     * @param arenaApiKey - Your Arena API key (from arena.social)
+     */
+    setup(arenaApiKey: string): Promise<PerpsSetupResponse>;
+    /** Register for perps trading on Hyperliquid */
+    register(): Promise<any>;
+    /** Check perps registration status */
+    getRegistrationStatus(): Promise<any>;
+    /** Get your Hyperliquid API wallet address */
+    getWalletAddress(): Promise<any>;
+    /** Check which auth steps are completed */
+    getAuthStatus(): Promise<any>;
+    /**
+     * Get EIP-712 payload for an auth step.
+     * @param step - Auth step: "accept-terms", "approve-agent", "set-referrer", "approve-builder-fee"
+     * @param body - Optional body (accept-terms requires mainWalletAddress)
+     */
+    getAuthPayload(step: string, body?: any): Promise<any>;
+    /**
+     * Submit signed EIP-712 payload for an auth step.
+     * @param step - Auth step
+     * @param body - Signed payload with signature and metadata
+     */
+    submitAuthSignature(step: string, body: any): Promise<any>;
+    /** Enable HIP-3 abstraction (automated, no signature needed) */
+    enableHip3(): Promise<any>;
+    /** Get all available perpetual trading pairs (250+ markets) */
+    getTradingPairs(): Promise<PerpsTradingPairsResponse>;
+    /**
+     * Update leverage for a market. Must be called before first order.
+     * @param symbol - Market symbol (e.g. "BTC", "ETH")
+     * @param leverage - Leverage multiplier (1-50 depending on market)
+     * @param leverageType - "cross" or "isolated"
+     */
+    updateLeverage(symbol: string, leverage: number, leverageType?: "cross" | "isolated"): Promise<any>;
+    /**
+     * Place one or more perpetual orders.
+     * @param orders - Array of order objects (see docs for BaseOrderParams)
+     */
+    placeOrder(orders: any[]): Promise<PerpsOrderResponse>;
+    /**
+     * Cancel one or more open orders.
+     * @param cancels - Array of { assetIndex, oid }
+     */
+    cancelOrders(cancels: {
+        assetIndex: number;
+        oid: number;
+    }[]): Promise<any>;
+    /**
+     * Modify an existing order.
+     * @param oid - Order ID to modify
+     * @param order - New order parameters
+     */
+    modifyOrder(oid: number, order: any): Promise<any>;
+    /**
+     * Close a position (convenience — creates reduce-only IOC with 10% slippage).
+     * @param symbol - Market symbol
+     * @param positionSide - "long" or "short"
+     * @param size - Position size to close
+     * @param currentPrice - Current market price
+     * @param closePercent - Percentage to close (default: 100)
+     */
+    closePosition(symbol: string, positionSide: "long" | "short", size: number, currentPrice: number, closePercent?: number): Promise<any>;
+    /** Get open orders */
+    getOrders(): Promise<any>;
+    /** Get trade execution history */
+    getTradeExecutions(): Promise<any>;
+    /**
+     * Get positions and margin summary (queries Hyperliquid directly).
+     * @param wallet - Your Hyperliquid wallet address (from getWalletAddress)
+     */
+    getPositions(wallet: string): Promise<PerpsPositionsResponse>;
+    /**
+     * Get open orders from Hyperliquid directly.
+     * @param wallet - Your Hyperliquid wallet address
+     */
+    getOpenOrders(wallet: string): Promise<any>;
+}
+
+declare class BridgeModule {
+    private http;
+    private auth;
+    constructor(http: HttpClient, auth: () => Promise<void>);
+    /**
+     * Get all supported chains for cross-chain bridging.
+     */
+    getChains(): Promise<BridgeChainsResponse>;
+    /**
+     * Get tokens available on specified chains.
+     * @param chains - Comma-separated chain IDs (e.g. "43114,42161")
+     */
+    getTokens(chains: string): Promise<BridgeTokensResponse>;
+    /**
+     * Get info for a specific token on a chain.
+     * @param chainId - Chain ID
+     * @param address - Token contract address
+     */
+    getToken(chainId: number, address: string): Promise<BridgeTokenResponse>;
+    /**
+     * Get available bridge connections between two chains.
+     * @param fromChainId - Source chain ID
+     * @param toChainId - Destination chain ID
+     * @param fromToken - Optional source token address
+     * @param toToken - Optional destination token address
+     */
+    getConnections(fromChainId: number, toChainId: number, fromToken?: string, toToken?: string): Promise<BridgeConnectionsResponse>;
+    /**
+     * Get a bridge quote with unsigned transaction data.
+     * The agent signs the returned tx on the source chain.
+     *
+     * @param fromChainId - Source chain ID
+     * @param toChainId - Destination chain ID
+     * @param fromToken - Source token address (use 0x0000...0000 for native tokens)
+     * @param toToken - Destination token address
+     * @param fromAmount - Human-readable amount (e.g. "0.1")
+     * @param fromAddress - Sender wallet address
+     * @param toAddress - Optional receiver address (defaults to fromAddress)
+     * @param slippage - Slippage tolerance as decimal (default 0.03 = 3%)
+     * @param fromDecimals - Token decimals (default 18)
+     */
+    getQuote(fromChainId: number, toChainId: number, fromToken: string, toToken: string, fromAmount: string, fromAddress: string, toAddress?: string, slippage?: number, fromDecimals?: number): Promise<BridgeQuoteResponse>;
+    /**
+     * Get multiple bridge route options.
+     */
+    getRoutes(fromChainId: number, toChainId: number, fromToken: string, toToken: string, fromAmount: string, fromAddress: string, toAddress?: string, slippage?: number, fromDecimals?: number): Promise<BridgeRoutesResponse>;
+    /**
+     * Check bridge transfer status.
+     * @param txHash - Source chain transaction hash
+     * @param fromChainId - Source chain ID
+     * @param toChainId - Destination chain ID
+     * @param bridge - Optional bridge tool name
+     */
+    getStatus(txHash: string, fromChainId: number, toChainId: number, bridge?: string): Promise<BridgeStatusResponse>;
+    /**
+     * Get reference info — common chain IDs, USDC addresses, native token constant.
+     */
+    getInfo(): Promise<BridgeInfoResponse>;
+}
+
 interface LogiqicalConfig {
     /** Your wallet address — used for auto-registration */
     wallet: string;
@@ -563,8 +817,12 @@ declare class LogiqicalClient {
     readonly staking: StakingModule;
     /** Discover, research, and trade launchpad tokens on bonding curves */
     readonly launchpad: LaunchpadModule;
-    /** Swap any Avalanche token via LFJ + Pharaoh DEX */
+    /** Swap any Avalanche token via LFJ + Arena DEX */
     readonly dex: DexModule;
+    /** Trade perpetual futures on Hyperliquid via Arena */
+    readonly perps: PerpsModule;
+    /** Cross-chain token bridging via Li.Fi — any token, any chain */
+    readonly bridge: BridgeModule;
     private http;
     private wallet;
     private agentName;
@@ -605,4 +863,4 @@ declare class LogiqicalAuthError extends LogiqicalError {
     constructor(endpoint: string);
 }
 
-export { type ArenaCommunity, type BalancesResponse, type BroadcastResponse, type BuildCreateResponse, type BuyQuoteResponse, type DexBalanceResponse, DexModule, type DexQuoteResponse, type DexSwapResponse, type DexTokenEntry, type DexTokenInfoResponse, type DexTokensResponse, type GlobalTradeEntry, type GlobalTradesResponse, type HealthResponse, type HolderEntry, type LaunchTokenResponse, type LaunchpadBuyResponse, type LaunchpadListResponse, LaunchpadModule, type LaunchpadQuoteResponse, type LaunchpadSellResponse, type LaunchpadToken, LogiqicalAuthError, LogiqicalClient, type LogiqicalConfig, LogiqicalError, type RegisterResponse, type SellQuoteResponse, type StakeBuildResponse, type StakeInfoResponse, StakingModule, type SwapBuyResponse, SwapModule, type SwapSellResponse, type TokenActivityResponse, type TokenCreator, type TokenDetailResponse, type TokenHoldersResponse, type TokenStatsTimeframes, type TradeEntry, type UnsignedTx, type UploadImageResponse };
+export { type ArenaCommunity, type BalancesResponse, type BridgeChainsResponse, type BridgeConnectionsResponse, type BridgeInfoResponse, type BridgeLiFiChain, type BridgeLiFiToken, BridgeModule, type BridgeQuoteResponse, type BridgeRoutesResponse, type BridgeStatusResponse, type BridgeTokenResponse, type BridgeTokensResponse, type BridgeTransaction, type BroadcastResponse, type BuildCreateResponse, type BuyQuoteResponse, type DexBalanceResponse, DexModule, type DexQuoteResponse, type DexSwapResponse, type DexTokenEntry, type DexTokenInfoResponse, type DexTokensResponse, type GlobalTradeEntry, type GlobalTradesResponse, type HealthResponse, type HolderEntry, type LaunchTokenResponse, type LaunchpadBuyResponse, type LaunchpadListResponse, LaunchpadModule, type LaunchpadQuoteResponse, type LaunchpadSellResponse, type LaunchpadToken, LogiqicalAuthError, LogiqicalClient, type LogiqicalConfig, LogiqicalError, PerpsModule, type PerpsOrderResponse, type PerpsPositionsResponse, type PerpsSetupResponse, type PerpsTradingPair, type PerpsTradingPairsResponse, type RegisterResponse, type SellQuoteResponse, type StakeBuildResponse, type StakeInfoResponse, StakingModule, type SwapBuyResponse, SwapModule, type SwapSellResponse, type TokenActivityResponse, type TokenCreator, type TokenDetailResponse, type TokenHoldersResponse, type TokenStatsTimeframes, type TradeEntry, type UnsignedTx, type UploadImageResponse };

package/dist/index.js

@@ -20,11 +20,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  BridgeModule: () => BridgeModule,
   DexModule: () => DexModule,
   LaunchpadModule: () => LaunchpadModule,
   LogiqicalAuthError: () => LogiqicalAuthError,
   LogiqicalClient: () => LogiqicalClient,
   LogiqicalError: () => LogiqicalError,
+  PerpsModule: () => PerpsModule,
   StakingModule: () => StakingModule,
   SwapModule: () => SwapModule
 });
@@ -467,6 +469,256 @@ var DexModule = class {
   }
 };
 
+// src/modules/perps.ts
+var PerpsModule = class {
+  constructor(http, auth) {
+    this.http = http;
+    this.auth = auth;
+  }
+  // ── Setup ──
+  /**
+   * Link your Arena API key to enable perps trading.
+   * One-time setup — after this, all /perp endpoints work automatically.
+   * @param arenaApiKey - Your Arena API key (from arena.social)
+   */
+  async setup(arenaApiKey) {
+    await this.auth();
+    return this.http.post("/perp/setup", { arenaApiKey });
+  }
+  // ── Registration ──
+  /** Register for perps trading on Hyperliquid */
+  async register() {
+    await this.auth();
+    return this.http.post("/perp/register", {});
+  }
+  /** Check perps registration status */
+  async getRegistrationStatus() {
+    await this.auth();
+    return this.http.get("/perp/registration-status");
+  }
+  /** Get your Hyperliquid API wallet address */
+  async getWalletAddress() {
+    await this.auth();
+    return this.http.get("/perp/wallet-address");
+  }
+  // ── Auth Flow ──
+  /** Check which auth steps are completed */
+  async getAuthStatus() {
+    await this.auth();
+    return this.http.post("/perp/auth/status", {});
+  }
+  /**
+   * Get EIP-712 payload for an auth step.
+   * @param step - Auth step: "accept-terms", "approve-agent", "set-referrer", "approve-builder-fee"
+   * @param body - Optional body (accept-terms requires mainWalletAddress)
+   */
+  async getAuthPayload(step, body) {
+    await this.auth();
+    return this.http.post(`/perp/auth/${step}/payload`, body || {});
+  }
+  /**
+   * Submit signed EIP-712 payload for an auth step.
+   * @param step - Auth step
+   * @param body - Signed payload with signature and metadata
+   */
+  async submitAuthSignature(step, body) {
+    await this.auth();
+    return this.http.post(`/perp/auth/${step}/submit`, body);
+  }
+  /** Enable HIP-3 abstraction (automated, no signature needed) */
+  async enableHip3() {
+    await this.auth();
+    return this.http.post("/perp/auth/enable-hip3", {});
+  }
+  // ── Market Data ──
+  /** Get all available perpetual trading pairs (250+ markets) */
+  async getTradingPairs() {
+    await this.auth();
+    return this.http.get("/perp/trading-pairs");
+  }
+  // ── Leverage ──
+  /**
+   * Update leverage for a market. Must be called before first order.
+   * @param symbol - Market symbol (e.g. "BTC", "ETH")
+   * @param leverage - Leverage multiplier (1-50 depending on market)
+   * @param leverageType - "cross" or "isolated"
+   */
+  async updateLeverage(symbol, leverage, leverageType = "cross") {
+    await this.auth();
+    return this.http.post("/perp/leverage/update", { symbol, leverage, leverageType });
+  }
+  // ── Trading ──
+  /**
+   * Place one or more perpetual orders.
+   * @param orders - Array of order objects (see docs for BaseOrderParams)
+   */
+  async placeOrder(orders) {
+    await this.auth();
+    return this.http.post("/perp/orders/place", { orders });
+  }
+  /**
+   * Cancel one or more open orders.
+   * @param cancels - Array of { assetIndex, oid }
+   */
+  async cancelOrders(cancels) {
+    await this.auth();
+    return this.http.post("/perp/orders/cancel", { cancels });
+  }
+  /**
+   * Modify an existing order.
+   * @param oid - Order ID to modify
+   * @param order - New order parameters
+   */
+  async modifyOrder(oid, order) {
+    await this.auth();
+    return this.http.post("/perp/orders/modify", { oid, order });
+  }
+  /**
+   * Close a position (convenience — creates reduce-only IOC with 10% slippage).
+   * @param symbol - Market symbol
+   * @param positionSide - "long" or "short"
+   * @param size - Position size to close
+   * @param currentPrice - Current market price
+   * @param closePercent - Percentage to close (default: 100)
+   */
+  async closePosition(symbol, positionSide, size, currentPrice, closePercent = 100) {
+    await this.auth();
+    return this.http.post("/perp/orders/close-position", {
+      symbol,
+      positionSide,
+      size,
+      currentPrice,
+      closePercent
+    });
+  }
+  // ── Account Data ──
+  /** Get open orders */
+  async getOrders() {
+    await this.auth();
+    return this.http.get("/perp/orders");
+  }
+  /** Get trade execution history */
+  async getTradeExecutions() {
+    await this.auth();
+    return this.http.get("/perp/trade-executions");
+  }
+  /**
+   * Get positions and margin summary (queries Hyperliquid directly).
+   * @param wallet - Your Hyperliquid wallet address (from getWalletAddress)
+   */
+  async getPositions(wallet) {
+    await this.auth();
+    return this.http.get("/perp/positions", { wallet });
+  }
+  /**
+   * Get open orders from Hyperliquid directly.
+   * @param wallet - Your Hyperliquid wallet address
+   */
+  async getOpenOrders(wallet) {
+    await this.auth();
+    return this.http.get("/perp/open-orders", { wallet });
+  }
+};
+
+// src/modules/bridge.ts
+var BridgeModule = class {
+  constructor(http, auth) {
+    this.http = http;
+    this.auth = auth;
+  }
+  /**
+   * Get all supported chains for cross-chain bridging.
+   */
+  async getChains() {
+    await this.auth();
+    return this.http.get("/bridge/chains");
+  }
+  /**
+   * Get tokens available on specified chains.
+   * @param chains - Comma-separated chain IDs (e.g. "43114,42161")
+   */
+  async getTokens(chains) {
+    await this.auth();
+    return this.http.get("/bridge/tokens", { chains });
+  }
+  /**
+   * Get info for a specific token on a chain.
+   * @param chainId - Chain ID
+   * @param address - Token contract address
+   */
+  async getToken(chainId, address) {
+    await this.auth();
+    return this.http.get("/bridge/token", { chainId, address });
+  }
+  /**
+   * Get available bridge connections between two chains.
+   * @param fromChainId - Source chain ID
+   * @param toChainId - Destination chain ID
+   * @param fromToken - Optional source token address
+   * @param toToken - Optional destination token address
+   */
+  async getConnections(fromChainId, toChainId, fromToken, toToken) {
+    await this.auth();
+    const params = { fromChainId, toChainId };
+    if (fromToken) params.fromToken = fromToken;
+    if (toToken) params.toToken = toToken;
+    return this.http.get("/bridge/connections", params);
+  }
+  /**
+   * Get a bridge quote with unsigned transaction data.
+   * The agent signs the returned tx on the source chain.
+   *
+   * @param fromChainId - Source chain ID
+   * @param toChainId - Destination chain ID
+   * @param fromToken - Source token address (use 0x0000...0000 for native tokens)
+   * @param toToken - Destination token address
+   * @param fromAmount - Human-readable amount (e.g. "0.1")
+   * @param fromAddress - Sender wallet address
+   * @param toAddress - Optional receiver address (defaults to fromAddress)
+   * @param slippage - Slippage tolerance as decimal (default 0.03 = 3%)
+   * @param fromDecimals - Token decimals (default 18)
+   */
+  async getQuote(fromChainId, toChainId, fromToken, toToken, fromAmount, fromAddress, toAddress, slippage, fromDecimals) {
+    await this.auth();
+    const params = { fromChainId, toChainId, fromToken, toToken, fromAmount, fromAddress };
+    if (toAddress) params.toAddress = toAddress;
+    if (slippage !== void 0) params.slippage = slippage;
+    if (fromDecimals !== void 0) params.fromDecimals = fromDecimals;
+    return this.http.get("/bridge/quote", params);
+  }
+  /**
+   * Get multiple bridge route options.
+   */
+  async getRoutes(fromChainId, toChainId, fromToken, toToken, fromAmount, fromAddress, toAddress, slippage, fromDecimals) {
+    await this.auth();
+    const params = { fromChainId, toChainId, fromToken, toToken, fromAmount, fromAddress };
+    if (toAddress) params.toAddress = toAddress;
+    if (slippage !== void 0) params.slippage = slippage;
+    if (fromDecimals !== void 0) params.fromDecimals = fromDecimals;
+    return this.http.get("/bridge/routes", params);
+  }
+  /**
+   * Check bridge transfer status.
+   * @param txHash - Source chain transaction hash
+   * @param fromChainId - Source chain ID
+   * @param toChainId - Destination chain ID
+   * @param bridge - Optional bridge tool name
+   */
+  async getStatus(txHash, fromChainId, toChainId, bridge) {
+    await this.auth();
+    const params = { txHash, fromChainId, toChainId };
+    if (bridge) params.bridge = bridge;
+    return this.http.get("/bridge/status", params);
+  }
+  /**
+   * Get reference info — common chain IDs, USDC addresses, native token constant.
+   */
+  async getInfo() {
+    await this.auth();
+    return this.http.get("/bridge/info");
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://brave-alignment-production-1706.up.railway.app";
 var LogiqicalClient = class {
@@ -476,8 +728,12 @@ var LogiqicalClient = class {
   staking;
   /** Discover, research, and trade launchpad tokens on bonding curves */
   launchpad;
-  /** Swap any Avalanche token via LFJ + Pharaoh DEX */
+  /** Swap any Avalanche token via LFJ + Arena DEX */
   dex;
+  /** Trade perpetual futures on Hyperliquid via Arena */
+  perps;
+  /** Cross-chain token bridging via Li.Fi — any token, any chain */
+  bridge;
   http;
   wallet;
   agentName;
@@ -491,6 +747,8 @@ var LogiqicalClient = class {
     this.staking = new StakingModule(this.http, auth);
     this.launchpad = new LaunchpadModule(this.http, auth);
     this.dex = new DexModule(this.http, auth);
+    this.perps = new PerpsModule(this.http, auth);
+    this.bridge = new BridgeModule(this.http, auth);
   }
   /** The API key (available after first call or if provided in config) */
   get apiKey() {
@@ -545,11 +803,13 @@ var LogiqicalClient = class {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BridgeModule,
   DexModule,
   LaunchpadModule,
   LogiqicalAuthError,
   LogiqicalClient,
   LogiqicalError,
+  PerpsModule,
   StakingModule,
   SwapModule
 });

package/dist/index.mjs

@@ -435,6 +435,256 @@ var DexModule = class {
   }
 };
 
+// src/modules/perps.ts
+var PerpsModule = class {
+  constructor(http, auth) {
+    this.http = http;
+    this.auth = auth;
+  }
+  // ── Setup ──
+  /**
+   * Link your Arena API key to enable perps trading.
+   * One-time setup — after this, all /perp endpoints work automatically.
+   * @param arenaApiKey - Your Arena API key (from arena.social)
+   */
+  async setup(arenaApiKey) {
+    await this.auth();
+    return this.http.post("/perp/setup", { arenaApiKey });
+  }
+  // ── Registration ──
+  /** Register for perps trading on Hyperliquid */
+  async register() {
+    await this.auth();
+    return this.http.post("/perp/register", {});
+  }
+  /** Check perps registration status */
+  async getRegistrationStatus() {
+    await this.auth();
+    return this.http.get("/perp/registration-status");
+  }
+  /** Get your Hyperliquid API wallet address */
+  async getWalletAddress() {
+    await this.auth();
+    return this.http.get("/perp/wallet-address");
+  }
+  // ── Auth Flow ──
+  /** Check which auth steps are completed */
+  async getAuthStatus() {
+    await this.auth();
+    return this.http.post("/perp/auth/status", {});
+  }
+  /**
+   * Get EIP-712 payload for an auth step.
+   * @param step - Auth step: "accept-terms", "approve-agent", "set-referrer", "approve-builder-fee"
+   * @param body - Optional body (accept-terms requires mainWalletAddress)
+   */
+  async getAuthPayload(step, body) {
+    await this.auth();
+    return this.http.post(`/perp/auth/${step}/payload`, body || {});
+  }
+  /**
+   * Submit signed EIP-712 payload for an auth step.
+   * @param step - Auth step
+   * @param body - Signed payload with signature and metadata
+   */
+  async submitAuthSignature(step, body) {
+    await this.auth();
+    return this.http.post(`/perp/auth/${step}/submit`, body);
+  }
+  /** Enable HIP-3 abstraction (automated, no signature needed) */
+  async enableHip3() {
+    await this.auth();
+    return this.http.post("/perp/auth/enable-hip3", {});
+  }
+  // ── Market Data ──
+  /** Get all available perpetual trading pairs (250+ markets) */
+  async getTradingPairs() {
+    await this.auth();
+    return this.http.get("/perp/trading-pairs");
+  }
+  // ── Leverage ──
+  /**
+   * Update leverage for a market. Must be called before first order.
+   * @param symbol - Market symbol (e.g. "BTC", "ETH")
+   * @param leverage - Leverage multiplier (1-50 depending on market)
+   * @param leverageType - "cross" or "isolated"
+   */
+  async updateLeverage(symbol, leverage, leverageType = "cross") {
+    await this.auth();
+    return this.http.post("/perp/leverage/update", { symbol, leverage, leverageType });
+  }
+  // ── Trading ──
+  /**
+   * Place one or more perpetual orders.
+   * @param orders - Array of order objects (see docs for BaseOrderParams)
+   */
+  async placeOrder(orders) {
+    await this.auth();
+    return this.http.post("/perp/orders/place", { orders });
+  }
+  /**
+   * Cancel one or more open orders.
+   * @param cancels - Array of { assetIndex, oid }
+   */
+  async cancelOrders(cancels) {
+    await this.auth();
+    return this.http.post("/perp/orders/cancel", { cancels });
+  }
+  /**
+   * Modify an existing order.
+   * @param oid - Order ID to modify
+   * @param order - New order parameters
+   */
+  async modifyOrder(oid, order) {
+    await this.auth();
+    return this.http.post("/perp/orders/modify", { oid, order });
+  }
+  /**
+   * Close a position (convenience — creates reduce-only IOC with 10% slippage).
+   * @param symbol - Market symbol
+   * @param positionSide - "long" or "short"
+   * @param size - Position size to close
+   * @param currentPrice - Current market price
+   * @param closePercent - Percentage to close (default: 100)
+   */
+  async closePosition(symbol, positionSide, size, currentPrice, closePercent = 100) {
+    await this.auth();
+    return this.http.post("/perp/orders/close-position", {
+      symbol,
+      positionSide,
+      size,
+      currentPrice,
+      closePercent
+    });
+  }
+  // ── Account Data ──
+  /** Get open orders */
+  async getOrders() {
+    await this.auth();
+    return this.http.get("/perp/orders");
+  }
+  /** Get trade execution history */
+  async getTradeExecutions() {
+    await this.auth();
+    return this.http.get("/perp/trade-executions");
+  }
+  /**
+   * Get positions and margin summary (queries Hyperliquid directly).
+   * @param wallet - Your Hyperliquid wallet address (from getWalletAddress)
+   */
+  async getPositions(wallet) {
+    await this.auth();
+    return this.http.get("/perp/positions", { wallet });
+  }
+  /**
+   * Get open orders from Hyperliquid directly.
+   * @param wallet - Your Hyperliquid wallet address
+   */
+  async getOpenOrders(wallet) {
+    await this.auth();
+    return this.http.get("/perp/open-orders", { wallet });
+  }
+};
+
+// src/modules/bridge.ts
+var BridgeModule = class {
+  constructor(http, auth) {
+    this.http = http;
+    this.auth = auth;
+  }
+  /**
+   * Get all supported chains for cross-chain bridging.
+   */
+  async getChains() {
+    await this.auth();
+    return this.http.get("/bridge/chains");
+  }
+  /**
+   * Get tokens available on specified chains.
+   * @param chains - Comma-separated chain IDs (e.g. "43114,42161")
+   */
+  async getTokens(chains) {
+    await this.auth();
+    return this.http.get("/bridge/tokens", { chains });
+  }
+  /**
+   * Get info for a specific token on a chain.
+   * @param chainId - Chain ID
+   * @param address - Token contract address
+   */
+  async getToken(chainId, address) {
+    await this.auth();
+    return this.http.get("/bridge/token", { chainId, address });
+  }
+  /**
+   * Get available bridge connections between two chains.
+   * @param fromChainId - Source chain ID
+   * @param toChainId - Destination chain ID
+   * @param fromToken - Optional source token address
+   * @param toToken - Optional destination token address
+   */
+  async getConnections(fromChainId, toChainId, fromToken, toToken) {
+    await this.auth();
+    const params = { fromChainId, toChainId };
+    if (fromToken) params.fromToken = fromToken;
+    if (toToken) params.toToken = toToken;
+    return this.http.get("/bridge/connections", params);
+  }
+  /**
+   * Get a bridge quote with unsigned transaction data.
+   * The agent signs the returned tx on the source chain.
+   *
+   * @param fromChainId - Source chain ID
+   * @param toChainId - Destination chain ID
+   * @param fromToken - Source token address (use 0x0000...0000 for native tokens)
+   * @param toToken - Destination token address
+   * @param fromAmount - Human-readable amount (e.g. "0.1")
+   * @param fromAddress - Sender wallet address
+   * @param toAddress - Optional receiver address (defaults to fromAddress)
+   * @param slippage - Slippage tolerance as decimal (default 0.03 = 3%)
+   * @param fromDecimals - Token decimals (default 18)
+   */
+  async getQuote(fromChainId, toChainId, fromToken, toToken, fromAmount, fromAddress, toAddress, slippage, fromDecimals) {
+    await this.auth();
+    const params = { fromChainId, toChainId, fromToken, toToken, fromAmount, fromAddress };
+    if (toAddress) params.toAddress = toAddress;
+    if (slippage !== void 0) params.slippage = slippage;
+    if (fromDecimals !== void 0) params.fromDecimals = fromDecimals;
+    return this.http.get("/bridge/quote", params);
+  }
+  /**
+   * Get multiple bridge route options.
+   */
+  async getRoutes(fromChainId, toChainId, fromToken, toToken, fromAmount, fromAddress, toAddress, slippage, fromDecimals) {
+    await this.auth();
+    const params = { fromChainId, toChainId, fromToken, toToken, fromAmount, fromAddress };
+    if (toAddress) params.toAddress = toAddress;
+    if (slippage !== void 0) params.slippage = slippage;
+    if (fromDecimals !== void 0) params.fromDecimals = fromDecimals;
+    return this.http.get("/bridge/routes", params);
+  }
+  /**
+   * Check bridge transfer status.
+   * @param txHash - Source chain transaction hash
+   * @param fromChainId - Source chain ID
+   * @param toChainId - Destination chain ID
+   * @param bridge - Optional bridge tool name
+   */
+  async getStatus(txHash, fromChainId, toChainId, bridge) {
+    await this.auth();
+    const params = { txHash, fromChainId, toChainId };
+    if (bridge) params.bridge = bridge;
+    return this.http.get("/bridge/status", params);
+  }
+  /**
+   * Get reference info — common chain IDs, USDC addresses, native token constant.
+   */
+  async getInfo() {
+    await this.auth();
+    return this.http.get("/bridge/info");
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://brave-alignment-production-1706.up.railway.app";
 var LogiqicalClient = class {
@@ -444,8 +694,12 @@ var LogiqicalClient = class {
   staking;
   /** Discover, research, and trade launchpad tokens on bonding curves */
   launchpad;
-  /** Swap any Avalanche token via LFJ + Pharaoh DEX */
+  /** Swap any Avalanche token via LFJ + Arena DEX */
   dex;
+  /** Trade perpetual futures on Hyperliquid via Arena */
+  perps;
+  /** Cross-chain token bridging via Li.Fi — any token, any chain */
+  bridge;
   http;
   wallet;
   agentName;
@@ -459,6 +713,8 @@ var LogiqicalClient = class {
     this.staking = new StakingModule(this.http, auth);
     this.launchpad = new LaunchpadModule(this.http, auth);
     this.dex = new DexModule(this.http, auth);
+    this.perps = new PerpsModule(this.http, auth);
+    this.bridge = new BridgeModule(this.http, auth);
   }
   /** The API key (available after first call or if provided in config) */
   get apiKey() {
@@ -512,11 +768,13 @@ var LogiqicalClient = class {
   }
 };
 export {
+  BridgeModule,
   DexModule,
   LaunchpadModule,
   LogiqicalAuthError,
   LogiqicalClient,
   LogiqicalError,
+  PerpsModule,
   StakingModule,
   SwapModule
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "logiqical",
-  "version": "0.0.11",
+  "version": "0.1.1",
   "description": "TypeScript SDK for AI agents to trade on Avalanche — swaps, staking, launchpad, DEX",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -12,13 +12,23 @@
       "import": "./dist/index.mjs"
     }
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsup src/index.ts --format cjs,esm --dts",
     "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
     "prepublishOnly": "npm run build"
   },
-  "keywords": ["avalanche", "arena", "defi", "sdk", "ai-agent", "trading", "logiqical"],
+  "keywords": [
+    "avalanche",
+    "arena",
+    "defi",
+    "sdk",
+    "ai-agent",
+    "trading",
+    "logiqical"
+  ],
   "license": "MIT",
   "repository": {
     "type": "git",