logiqical 0.1.0 → 0.1.2

package/dist/index.d.ts

@@ -195,6 +195,32 @@ interface LaunchpadSellResponse {
     summary?: string;
     note?: string;
 }
+interface ArenaCommunity {
+    id: string;
+    signer: string;
+    isTemporary: boolean;
+    name: string;
+    tokenName: string;
+    ticker: string;
+    photoURL: string;
+    paymentToken: string;
+    contractAddress: string | null;
+    createdOn: string;
+}
+interface LaunchTokenResponse {
+    community: ArenaCommunity;
+    imageUrl: string;
+    transaction: UnsignedTx;
+    nextTokenId: string;
+    instructions: string[];
+}
+interface UploadImageResponse {
+    imageUrl: string;
+}
+interface BuildCreateResponse {
+    transaction: UnsignedTx;
+    nextTokenId: string;
+}
 interface DexTokenEntry {
     symbol: string;
     address: string;
@@ -230,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;
@@ -407,6 +542,36 @@ declare class LaunchpadModule {
      * @param offset - Pagination offset
      */
     getTrades(count?: number, offset?: number): Promise<GlobalTradesResponse>;
+    /**
+     * Launch a new token on Arena — uploads image, creates community, and returns the unsigned createToken transaction.
+     *
+     * @param wallet - Creator wallet address
+     * @param name - Token name (also used as community name)
+     * @param symbol - Token ticker symbol
+     * @param imageBase64 - Token image as base64 string (optional)
+     * @param paymentToken - "avax" or "arena" (default: "arena")
+     * @param initialBuyAvax - AVAX amount for initial buy at creation (default: "0")
+     */
+    launch(wallet: string, name: string, symbol: string, imageBase64?: string, paymentToken?: "avax" | "arena", initialBuyAvax?: string): Promise<LaunchTokenResponse>;
+    /**
+     * Upload a token image to Arena's CDN and get the hosted URL.
+     * Use this before launch() if you want to preview the image URL first.
+     *
+     * @param imageBase64 - Image as base64 string
+     * @param fileType - MIME type (default: "image/jpeg")
+     */
+    uploadImage(imageBase64: string, fileType?: string): Promise<UploadImageResponse>;
+    /**
+     * Build only the createToken transaction (no image or community creation).
+     * Useful if you want to handle image upload and community creation separately.
+     *
+     * @param wallet - Creator wallet address
+     * @param name - Token name
+     * @param symbol - Token ticker symbol
+     * @param paymentToken - "avax" or "arena" (default: "arena")
+     * @param initialBuyAvax - AVAX for initial buy (default: "0")
+     */
+    buildCreate(wallet: string, name: string, symbol: string, paymentToken?: "avax" | "arena", initialBuyAvax?: string): Promise<BuildCreateResponse>;
     /**
      * Build unsigned transaction to buy a launchpad token with AVAX.
      *
@@ -476,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;
@@ -507,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;
@@ -549,4 +863,4 @@ declare class LogiqicalAuthError extends LogiqicalError {
     constructor(endpoint: string);
 }
 
-export { type BalancesResponse, type BroadcastResponse, type BuyQuoteResponse, type DexBalanceResponse, DexModule, type DexQuoteResponse, type DexSwapResponse, type DexTokenEntry, type DexTokenInfoResponse, type DexTokensResponse, type GlobalTradeEntry, type GlobalTradesResponse, type HealthResponse, type HolderEntry, 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 };
+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 };