@basedone/core 0.3.0 → 0.3.1

package/dist/{chunk-VBC6EQ7Q.mjs → chunk-OZPAOG43.mjs}

@@ -181,7 +181,10 @@ var InstrumentClient = class {
           type: "futures",
           isDelisted: info.isDelisted,
           dex: AssetIdUtils.extractDexName(info.name),
-          collateralTokenIndex: perpMeta.collateralToken
+          collateralTokenIndex: perpMeta.collateralToken,
+          category: info.category,
+          displayName: info.displayName,
+          keywords: info.keywords
         };
         this.addInstrument(instrument);
       }

package/dist/{client-BQzYwHDY.d.mts → client-1sWFpTpK.d.mts}

@@ -1,5 +1,12 @@
 import { MarginTables, PerpDex as PerpDex$1, PerpsAssetCtx, InfoClient, SpotMeta, SpotToken } from '@nktkas/hyperliquid';
 
+/** Payload entries from Hyperliquid `info` → `{ type: "perpConciseAnnotations" }`. */
+interface PerpConciseAnnotationMeta {
+    category?: string;
+    displayName?: string;
+    keywords?: string[];
+}
+type PerpConciseAnnotations = [string, PerpConciseAnnotationMeta][];
 interface PerpsMeta {
     collateralToken: number;
     /** Trading universes available for perpetual trading. */
@@ -32,11 +39,20 @@ interface PerpsUniverse {
     growthMode?: "enabled";
     /** Margin mode for the universe. */
     marginMode?: "strictIsolated" | "noCross";
+    /** From `perpConciseAnnotations` when present (search/display). */
+    category?: string;
+    displayName?: string;
+    keywords?: string[];
 }
 interface PerpDex extends PerpDex$1 {
     deployerFeeScale: string;
 }
 type AllPerpsMeta = PerpsMeta[];
+declare function getPerpConciseAnnotations(infoClient: InfoClient): Promise<PerpConciseAnnotations>;
+/**
+ * Merges `perpConciseAnnotations` into each universe row by matching `name`.
+ */
+declare function enrichAllPerpsMetaWithAnnotations(metas: AllPerpsMeta, annotations: PerpConciseAnnotations): AllPerpsMeta;
 declare function getAllPerpsMeta(infoClient: InfoClient): Promise<AllPerpsMeta>;
 
 interface BaseInstrument {
@@ -53,6 +69,10 @@ interface PerpsInstrument extends BaseInstrument {
     collateralTokenSymbol: string;
     dex?: string;
     collateralTokenIndex?: number;
+    /** From merged `perpConciseAnnotations` (display/search). */
+    category?: string;
+    displayName?: string;
+    keywords?: string[];
 }
 interface SpotInstrument extends BaseInstrument {
     type: "spot";
@@ -179,4 +199,4 @@ declare class InstrumentClient {
     private extractDexNameFromMeta;
 }
 
-export { type AllPerpsMeta as A, type BaseInstrument as B, InstrumentClient as I, type MarketInstrument as M, type PerpDex as P, type SpotInstrument as S, AssetIdUtils as a, type PerpsInstrument as b, type PerpsMeta as c, type PerpsMetaAndAssetCtxs as d, type PerpsUniverse as e, getAllPerpsMeta as g };
+export { type AllPerpsMeta as A, type BaseInstrument as B, InstrumentClient as I, type MarketInstrument as M, type PerpConciseAnnotationMeta as P, type SpotInstrument as S, AssetIdUtils as a, type PerpConciseAnnotations as b, type PerpDex as c, type PerpsInstrument as d, type PerpsMeta as e, type PerpsMetaAndAssetCtxs as f, type PerpsUniverse as g, enrichAllPerpsMetaWithAnnotations as h, getAllPerpsMeta as i, getPerpConciseAnnotations as j };

package/dist/{client-BQzYwHDY.d.ts → client-1sWFpTpK.d.ts}

@@ -1,5 +1,12 @@
 import { MarginTables, PerpDex as PerpDex$1, PerpsAssetCtx, InfoClient, SpotMeta, SpotToken } from '@nktkas/hyperliquid';
 
+/** Payload entries from Hyperliquid `info` → `{ type: "perpConciseAnnotations" }`. */
+interface PerpConciseAnnotationMeta {
+    category?: string;
+    displayName?: string;
+    keywords?: string[];
+}
+type PerpConciseAnnotations = [string, PerpConciseAnnotationMeta][];
 interface PerpsMeta {
     collateralToken: number;
     /** Trading universes available for perpetual trading. */
@@ -32,11 +39,20 @@ interface PerpsUniverse {
     growthMode?: "enabled";
     /** Margin mode for the universe. */
     marginMode?: "strictIsolated" | "noCross";
+    /** From `perpConciseAnnotations` when present (search/display). */
+    category?: string;
+    displayName?: string;
+    keywords?: string[];
 }
 interface PerpDex extends PerpDex$1 {
     deployerFeeScale: string;
 }
 type AllPerpsMeta = PerpsMeta[];
+declare function getPerpConciseAnnotations(infoClient: InfoClient): Promise<PerpConciseAnnotations>;
+/**
+ * Merges `perpConciseAnnotations` into each universe row by matching `name`.
+ */
+declare function enrichAllPerpsMetaWithAnnotations(metas: AllPerpsMeta, annotations: PerpConciseAnnotations): AllPerpsMeta;
 declare function getAllPerpsMeta(infoClient: InfoClient): Promise<AllPerpsMeta>;
 
 interface BaseInstrument {
@@ -53,6 +69,10 @@ interface PerpsInstrument extends BaseInstrument {
     collateralTokenSymbol: string;
     dex?: string;
     collateralTokenIndex?: number;
+    /** From merged `perpConciseAnnotations` (display/search). */
+    category?: string;
+    displayName?: string;
+    keywords?: string[];
 }
 interface SpotInstrument extends BaseInstrument {
     type: "spot";
@@ -179,4 +199,4 @@ declare class InstrumentClient {
     private extractDexNameFromMeta;
 }
 
-export { type AllPerpsMeta as A, type BaseInstrument as B, InstrumentClient as I, type MarketInstrument as M, type PerpDex as P, type SpotInstrument as S, AssetIdUtils as a, type PerpsInstrument as b, type PerpsMeta as c, type PerpsMetaAndAssetCtxs as d, type PerpsUniverse as e, getAllPerpsMeta as g };
+export { type AllPerpsMeta as A, type BaseInstrument as B, InstrumentClient as I, type MarketInstrument as M, type PerpConciseAnnotationMeta as P, type SpotInstrument as S, AssetIdUtils as a, type PerpConciseAnnotations as b, type PerpDex as c, type PerpsInstrument as d, type PerpsMeta as e, type PerpsMetaAndAssetCtxs as f, type PerpsUniverse as g, enrichAllPerpsMetaWithAnnotations as h, getAllPerpsMeta as i, getPerpConciseAnnotations as j };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { SpotToken, MarginTables, PerpsAssetCtx, ExchangeClient, SuccessResponse, InfoClient } from '@nktkas/hyperliquid';
-export { A as AllPerpsMeta, a as AssetIdUtils, B as BaseInstrument, I as InstrumentClient, M as MarketInstrument, P as PerpDex, b as PerpsInstrument, c as PerpsMeta, d as PerpsMetaAndAssetCtxs, e as PerpsUniverse, S as SpotInstrument, g as getAllPerpsMeta } from './client-BQzYwHDY.mjs';
+export { A as AllPerpsMeta, a as AssetIdUtils, B as BaseInstrument, I as InstrumentClient, M as MarketInstrument, P as PerpConciseAnnotationMeta, b as PerpConciseAnnotations, c as PerpDex, d as PerpsInstrument, e as PerpsMeta, f as PerpsMetaAndAssetCtxs, g as PerpsUniverse, S as SpotInstrument, h as enrichAllPerpsMetaWithAnnotations, i as getAllPerpsMeta, j as getPerpConciseAnnotations } from './client-1sWFpTpK.mjs';
 export { ActiveFlashSalesResponse, AnalyticsOverview, ApiResponse, AppliedDiscount, Banner, BannerResponse, BannerType, BaseEcommerceClient, BaseEntity, BrowsingLocation, CalculateCartDiscountsRequest, CalculateCartDiscountsResponse, CalculateShippingRequest, CalculateShippingResponse, CalculateTaxRequest, CalculateTaxResponse, CartItem, CashAccountBalanceResponse, ConfirmEscrowDepositResponse, Coupon, CouponResponse, CouponUsage, CreateBannerRequest, CreateCouponRequest, CreateFlashSaleRequest, CreateOrderEventRequest, CreateOrderEventResponse, CreateOrderRequest, CreateOrderResponse, CreateProductRequest, CreateProductVariantRequest, CreateReviewRequest, CreateShippingMethodRequest, CreateShippingRateRequest, CreateShippingZoneRequest, CreateTaxNexusRequest, CreateTaxRuleRequest, CustomerEcommerceClient, CustomerMessagesResponse, CustomerNotification, CustomerNotificationsResponse, CustomerSummary, DeleteBrowsingLocationResponse, DeliveryAddressResponse, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, EcommerceClientConfig, ExpiringGemBatch, FlashSale, FlashSaleAllowanceInfo, FlashSaleItem, FlashSaleItemInput, FollowActionResponse, FollowStatusResponse, FollowedMerchantSummary, GemHistoryItem, GemHistoryType, GemHistoryTypeFilter, GemSource, GenerateTaxReportRequest, GetAnalyticsParams, GetAnalyticsResponse, GetBrowsingLocationResponse, GetCouponResponse, GetExpiringGemsParams, GetExpiringGemsResponse, GetFlashSaleAllowanceParams, GetFlashSaleAllowanceResponse, GetGemBalanceResponse, GetGemHistoryParams, GetGemHistoryResponse, GetOrderResponse, GetPaymentMethodsResponse, GetProductMetricsResponse, GetProductResponse, GetTaxReportResponse, InventoryAuditAction, InventoryAuditEntry, ListActiveBannersParams, ListActiveFlashSalesParams, ListBannersResponse, ListCouponsResponse, ListCustomersParams, ListCustomersResponse, ListFollowingParams, ListFollowingResponse, ListInventoryAuditResponse, ListMediaAssetsResponse, ListMerchantProductsParams, ListMessagesResponse, ListOrdersParams, ListOrdersResponse, ListProductVariantsResponse, ListProductsParams, ListProductsResponse, ListReturnsResponse, ListReviewsParams, ListReviewsResponse, ListShipmentsResponse, ListShippingAddressesResponse, ListShippingMethodsResponse, ListShippingRatesResponse, ListShippingZonesResponse, ListTaxNexusResponse, ListTaxReportsParams, ListTaxReportsResponse, ListTaxRulesResponse, MarkNotificationsReadResponse, MediaAsset, MediaAssetResponse, Merchant, MerchantBusinessType, MerchantEcommerceClient, MerchantProductsResponse, MerchantProfileRequest, MerchantProfileResponse, MerchantReturnPolicyType, MerchantShippingSettings, MerchantSocialLinks, MerchantStatus, Message, MessageResponse, MessageStatsResponse, ORDER_STATUS_TRANSITIONS, Order, OrderEvent, OrderItem, OrderReceiptResponse, OrderStatus, OrdersByStatus, PaginatedResponse, PaginationParams, Payment, PaymentMethod, PaymentMethodInfo, PaymentStatus, ProcessPaymentRequest, ProcessPaymentResponse, Product, ProductDimensions, ProductDiscountsResponse, ProductMetrics, ProductResponse, ProductReview, ProductSortBy, ProductVariant, ProductVariantResponse, PublicMerchantProfile, PublicMerchantProfileResponse, RecentOrderSummary, RespondToReviewRequest, Return, ReturnItem, ReturnResponse, ReturnStatus, RevenueByDay, ReviewResponse, ReviewSortBy, ReviewStatus, SaveBrowsingLocationRequest, SaveBrowsingLocationResponse, SendMessageRequest, Settlement, Shipment, ShipmentResponse, ShipmentStatus, ShippingAddress, ShippingAddressRequest, ShippingAddressResponse, ShippingMethod, ShippingMethodResponse, ShippingOption, ShippingRate, ShippingRateResponse, ShippingSettingsResponse, ShippingZone, ShippingZoneResponse, SortOrder, SuccessResponse, TaxBehavior, TaxBreakdownItem, TaxNexus, TaxNexusResponse, TaxReport, TaxReportDetails, TaxReportPeriodType, TaxReportResponse, TaxReportStatus, TaxRule, TaxRuleResponse, TaxSettings, TaxSettingsResponse, TaxType, TopProduct, TrackBannerRequest, UpdateBannerRequest, UpdateCouponRequest, UpdateFlashSaleRequest, UpdateOrderResponse, UpdateOrderStatusRequest, UpdateProductRequest, UpdateProductVariantRequest, UpdateShipmentRequest, UpdateShippingMethodRequest, UpdateShippingRateRequest, UpdateShippingSettingsRequest, UpdateShippingZoneRequest, UpdateTaxNexusRequest, UpdateTaxReportStatusRequest, UpdateTaxRuleRequest, UpdateTaxSettingsRequest, UserShippingAddress, ValidateDiscountRequest, ValidateDiscountResponse, buildQueryString, calculateDiscountAmount, calculateFinalPrice, canCancelOrder, formatPrice, getBackoffDelay, getNextStatuses, getStatusColor, getStatusLabel, getStatusProgress, isPickupOrder, isRetryableError, isValidAddress, isValidEmail, parseError, requiresTrackingInfo, retryWithBackoff, shouldNotifyCustomer, sleep, truncateAddress, validateStatusTransition } from './ecommerce.mjs';
 import 'axios';
 
@@ -241,7 +241,9 @@ declare function getNextTierInfo(pupTokenAmount: number, normalizedAirDropAmount
 declare const USDC_SPOT_TOKEN: SpotToken;
 declare const TESTNET_USDC_SPOT_TOKEN: SpotToken;
 
+declare const SUPER_ADMINS: string[];
 declare const ADMINS: string[];
+declare const ALL_ADMINS: string[];
 declare const ADMIN_WALLETS: string[];
 
 interface PerpsMeta {
@@ -270,6 +272,10 @@ interface PerpsUniverse {
     growthMode?: "enabled";
     /** Margin mode for the universe. */
     marginMode?: "strictIsolated" | "noCross";
+    /** From Hyperliquid `perpConciseAnnotations` when merged into meta. */
+    category?: string;
+    displayName?: string;
+    keywords?: string[];
 }
 
 /**
@@ -606,4 +612,4 @@ interface LeadingVault {
     name: string;
 }
 
-export { ABSTRACTION_MODE_TO_AGENT_CODE, ADMINS, ADMIN_WALLETS, AGENT_CODE_TO_ABSTRACTION_MODE, type AgentAbstractionCode, type AirdropAllocationData, CloidClientCode, type CloidClientCodeId, CloidClientCodeNameById, type CloidData, DayOfWeek, type DexInfo, type ExtendedPerpsMeta, type LeadingVault, type MarketInfo, type MultiverseMeta, PUP_TOKEN_ADDRESS, PUP_TOKEN_THRESHOLDS, type PerpDexAssetPosition, type PerpDexClearinghouseState, type PerpDexState, type PupEligibilityResult, ROOT_DEX, type SettableAbstractionMode, type SpotBalance, TARGET_APPROVED_MAX_BUILDER_FEE, TARGET_APPROVED_MAX_BUILDER_FEE_PERCENT, TESTNET_USDC_SPOT_TOKEN, type TokenInfo, USDC_SPOT_TOKEN, type UpheavalApiResponse, type UpheavalPosition, type UpheavalSnapshot, type UserAbstractionMode, UserDexAbstractionTypes, UserSetAbstractionTypes, type V3LPTokenInfo, type WeekInfo, WidgetType, WidgetTypeById, type WidgetTypeId, type WsWebData3, XP_BOOST_PERCENTAGES, agentSetAbstraction, buildCloid, calculateBoostPercentage, calculateTotalPupAmount, computeUnifiedAccountRatio, decodeSlug, enableHip3DexAbstractionWithAgent, encodeSlug, floorUtcDay, floorUtcHour, floorUtcMinutes, floorUtcWeek, formatPriceAndSize, formatPriceForDisplay, formatPriceForOrder, formatSizeForDisplay, formatSizeForOrder, getApprovalAmount, getClientCodeNameById, getCloid, getDexFromCollateralTokenSymbol, getDisplayMarketSymbol, getHip3Dex, getHip3DexAbstraction, getLatestCompletedWeek, getNextTierInfo, getPriceDecimals, getStaticCollateralTokenByDex, getStaticCollateralTokenSymbol, getUserAbstraction, getWeekInfoFromNumber, getWidgetTypeById, isBasedCloid, isClientCode, isHip3Symbol, isMiniAppCloid, isMiniAppTriggeredCloid, isSpotSymbol, isStableQuoteToken, isTenantCloid, isTrackingIdCloid, isWidgetType, makeUtcRounder, normaliseSlug, normaliseTrackingId, normalizeAirdropAmount, parseCloid, setHip3DexAbstraction, setUserAbstraction, stableQuoteTokens };
+export { ABSTRACTION_MODE_TO_AGENT_CODE, ADMINS, ADMIN_WALLETS, AGENT_CODE_TO_ABSTRACTION_MODE, ALL_ADMINS, type AgentAbstractionCode, type AirdropAllocationData, CloidClientCode, type CloidClientCodeId, CloidClientCodeNameById, type CloidData, DayOfWeek, type DexInfo, type ExtendedPerpsMeta, type LeadingVault, type MarketInfo, type MultiverseMeta, PUP_TOKEN_ADDRESS, PUP_TOKEN_THRESHOLDS, type PerpDexAssetPosition, type PerpDexClearinghouseState, type PerpDexState, type PupEligibilityResult, ROOT_DEX, SUPER_ADMINS, type SettableAbstractionMode, type SpotBalance, TARGET_APPROVED_MAX_BUILDER_FEE, TARGET_APPROVED_MAX_BUILDER_FEE_PERCENT, TESTNET_USDC_SPOT_TOKEN, type TokenInfo, USDC_SPOT_TOKEN, type UpheavalApiResponse, type UpheavalPosition, type UpheavalSnapshot, type UserAbstractionMode, UserDexAbstractionTypes, UserSetAbstractionTypes, type V3LPTokenInfo, type WeekInfo, WidgetType, WidgetTypeById, type WidgetTypeId, type WsWebData3, XP_BOOST_PERCENTAGES, agentSetAbstraction, buildCloid, calculateBoostPercentage, calculateTotalPupAmount, computeUnifiedAccountRatio, decodeSlug, enableHip3DexAbstractionWithAgent, encodeSlug, floorUtcDay, floorUtcHour, floorUtcMinutes, floorUtcWeek, formatPriceAndSize, formatPriceForDisplay, formatPriceForOrder, formatSizeForDisplay, formatSizeForOrder, getApprovalAmount, getClientCodeNameById, getCloid, getDexFromCollateralTokenSymbol, getDisplayMarketSymbol, getHip3Dex, getHip3DexAbstraction, getLatestCompletedWeek, getNextTierInfo, getPriceDecimals, getStaticCollateralTokenByDex, getStaticCollateralTokenSymbol, getUserAbstraction, getWeekInfoFromNumber, getWidgetTypeById, isBasedCloid, isClientCode, isHip3Symbol, isMiniAppCloid, isMiniAppTriggeredCloid, isSpotSymbol, isStableQuoteToken, isTenantCloid, isTrackingIdCloid, isWidgetType, makeUtcRounder, normaliseSlug, normaliseTrackingId, normalizeAirdropAmount, parseCloid, setHip3DexAbstraction, setUserAbstraction, stableQuoteTokens };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { SpotToken, MarginTables, PerpsAssetCtx, ExchangeClient, SuccessResponse, InfoClient } from '@nktkas/hyperliquid';
-export { A as AllPerpsMeta, a as AssetIdUtils, B as BaseInstrument, I as InstrumentClient, M as MarketInstrument, P as PerpDex, b as PerpsInstrument, c as PerpsMeta, d as PerpsMetaAndAssetCtxs, e as PerpsUniverse, S as SpotInstrument, g as getAllPerpsMeta } from './client-BQzYwHDY.js';
+export { A as AllPerpsMeta, a as AssetIdUtils, B as BaseInstrument, I as InstrumentClient, M as MarketInstrument, P as PerpConciseAnnotationMeta, b as PerpConciseAnnotations, c as PerpDex, d as PerpsInstrument, e as PerpsMeta, f as PerpsMetaAndAssetCtxs, g as PerpsUniverse, S as SpotInstrument, h as enrichAllPerpsMetaWithAnnotations, i as getAllPerpsMeta, j as getPerpConciseAnnotations } from './client-1sWFpTpK.js';
 export { ActiveFlashSalesResponse, AnalyticsOverview, ApiResponse, AppliedDiscount, Banner, BannerResponse, BannerType, BaseEcommerceClient, BaseEntity, BrowsingLocation, CalculateCartDiscountsRequest, CalculateCartDiscountsResponse, CalculateShippingRequest, CalculateShippingResponse, CalculateTaxRequest, CalculateTaxResponse, CartItem, CashAccountBalanceResponse, ConfirmEscrowDepositResponse, Coupon, CouponResponse, CouponUsage, CreateBannerRequest, CreateCouponRequest, CreateFlashSaleRequest, CreateOrderEventRequest, CreateOrderEventResponse, CreateOrderRequest, CreateOrderResponse, CreateProductRequest, CreateProductVariantRequest, CreateReviewRequest, CreateShippingMethodRequest, CreateShippingRateRequest, CreateShippingZoneRequest, CreateTaxNexusRequest, CreateTaxRuleRequest, CustomerEcommerceClient, CustomerMessagesResponse, CustomerNotification, CustomerNotificationsResponse, CustomerSummary, DeleteBrowsingLocationResponse, DeliveryAddressResponse, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, EcommerceClientConfig, ExpiringGemBatch, FlashSale, FlashSaleAllowanceInfo, FlashSaleItem, FlashSaleItemInput, FollowActionResponse, FollowStatusResponse, FollowedMerchantSummary, GemHistoryItem, GemHistoryType, GemHistoryTypeFilter, GemSource, GenerateTaxReportRequest, GetAnalyticsParams, GetAnalyticsResponse, GetBrowsingLocationResponse, GetCouponResponse, GetExpiringGemsParams, GetExpiringGemsResponse, GetFlashSaleAllowanceParams, GetFlashSaleAllowanceResponse, GetGemBalanceResponse, GetGemHistoryParams, GetGemHistoryResponse, GetOrderResponse, GetPaymentMethodsResponse, GetProductMetricsResponse, GetProductResponse, GetTaxReportResponse, InventoryAuditAction, InventoryAuditEntry, ListActiveBannersParams, ListActiveFlashSalesParams, ListBannersResponse, ListCouponsResponse, ListCustomersParams, ListCustomersResponse, ListFollowingParams, ListFollowingResponse, ListInventoryAuditResponse, ListMediaAssetsResponse, ListMerchantProductsParams, ListMessagesResponse, ListOrdersParams, ListOrdersResponse, ListProductVariantsResponse, ListProductsParams, ListProductsResponse, ListReturnsResponse, ListReviewsParams, ListReviewsResponse, ListShipmentsResponse, ListShippingAddressesResponse, ListShippingMethodsResponse, ListShippingRatesResponse, ListShippingZonesResponse, ListTaxNexusResponse, ListTaxReportsParams, ListTaxReportsResponse, ListTaxRulesResponse, MarkNotificationsReadResponse, MediaAsset, MediaAssetResponse, Merchant, MerchantBusinessType, MerchantEcommerceClient, MerchantProductsResponse, MerchantProfileRequest, MerchantProfileResponse, MerchantReturnPolicyType, MerchantShippingSettings, MerchantSocialLinks, MerchantStatus, Message, MessageResponse, MessageStatsResponse, ORDER_STATUS_TRANSITIONS, Order, OrderEvent, OrderItem, OrderReceiptResponse, OrderStatus, OrdersByStatus, PaginatedResponse, PaginationParams, Payment, PaymentMethod, PaymentMethodInfo, PaymentStatus, ProcessPaymentRequest, ProcessPaymentResponse, Product, ProductDimensions, ProductDiscountsResponse, ProductMetrics, ProductResponse, ProductReview, ProductSortBy, ProductVariant, ProductVariantResponse, PublicMerchantProfile, PublicMerchantProfileResponse, RecentOrderSummary, RespondToReviewRequest, Return, ReturnItem, ReturnResponse, ReturnStatus, RevenueByDay, ReviewResponse, ReviewSortBy, ReviewStatus, SaveBrowsingLocationRequest, SaveBrowsingLocationResponse, SendMessageRequest, Settlement, Shipment, ShipmentResponse, ShipmentStatus, ShippingAddress, ShippingAddressRequest, ShippingAddressResponse, ShippingMethod, ShippingMethodResponse, ShippingOption, ShippingRate, ShippingRateResponse, ShippingSettingsResponse, ShippingZone, ShippingZoneResponse, SortOrder, SuccessResponse, TaxBehavior, TaxBreakdownItem, TaxNexus, TaxNexusResponse, TaxReport, TaxReportDetails, TaxReportPeriodType, TaxReportResponse, TaxReportStatus, TaxRule, TaxRuleResponse, TaxSettings, TaxSettingsResponse, TaxType, TopProduct, TrackBannerRequest, UpdateBannerRequest, UpdateCouponRequest, UpdateFlashSaleRequest, UpdateOrderResponse, UpdateOrderStatusRequest, UpdateProductRequest, UpdateProductVariantRequest, UpdateShipmentRequest, UpdateShippingMethodRequest, UpdateShippingRateRequest, UpdateShippingSettingsRequest, UpdateShippingZoneRequest, UpdateTaxNexusRequest, UpdateTaxReportStatusRequest, UpdateTaxRuleRequest, UpdateTaxSettingsRequest, UserShippingAddress, ValidateDiscountRequest, ValidateDiscountResponse, buildQueryString, calculateDiscountAmount, calculateFinalPrice, canCancelOrder, formatPrice, getBackoffDelay, getNextStatuses, getStatusColor, getStatusLabel, getStatusProgress, isPickupOrder, isRetryableError, isValidAddress, isValidEmail, parseError, requiresTrackingInfo, retryWithBackoff, shouldNotifyCustomer, sleep, truncateAddress, validateStatusTransition } from './ecommerce.js';
 import 'axios';
 
@@ -241,7 +241,9 @@ declare function getNextTierInfo(pupTokenAmount: number, normalizedAirDropAmount
 declare const USDC_SPOT_TOKEN: SpotToken;
 declare const TESTNET_USDC_SPOT_TOKEN: SpotToken;
 
+declare const SUPER_ADMINS: string[];
 declare const ADMINS: string[];
+declare const ALL_ADMINS: string[];
 declare const ADMIN_WALLETS: string[];
 
 interface PerpsMeta {
@@ -270,6 +272,10 @@ interface PerpsUniverse {
     growthMode?: "enabled";
     /** Margin mode for the universe. */
     marginMode?: "strictIsolated" | "noCross";
+    /** From Hyperliquid `perpConciseAnnotations` when merged into meta. */
+    category?: string;
+    displayName?: string;
+    keywords?: string[];
 }
 
 /**
@@ -606,4 +612,4 @@ interface LeadingVault {
     name: string;
 }
 
-export { ABSTRACTION_MODE_TO_AGENT_CODE, ADMINS, ADMIN_WALLETS, AGENT_CODE_TO_ABSTRACTION_MODE, type AgentAbstractionCode, type AirdropAllocationData, CloidClientCode, type CloidClientCodeId, CloidClientCodeNameById, type CloidData, DayOfWeek, type DexInfo, type ExtendedPerpsMeta, type LeadingVault, type MarketInfo, type MultiverseMeta, PUP_TOKEN_ADDRESS, PUP_TOKEN_THRESHOLDS, type PerpDexAssetPosition, type PerpDexClearinghouseState, type PerpDexState, type PupEligibilityResult, ROOT_DEX, type SettableAbstractionMode, type SpotBalance, TARGET_APPROVED_MAX_BUILDER_FEE, TARGET_APPROVED_MAX_BUILDER_FEE_PERCENT, TESTNET_USDC_SPOT_TOKEN, type TokenInfo, USDC_SPOT_TOKEN, type UpheavalApiResponse, type UpheavalPosition, type UpheavalSnapshot, type UserAbstractionMode, UserDexAbstractionTypes, UserSetAbstractionTypes, type V3LPTokenInfo, type WeekInfo, WidgetType, WidgetTypeById, type WidgetTypeId, type WsWebData3, XP_BOOST_PERCENTAGES, agentSetAbstraction, buildCloid, calculateBoostPercentage, calculateTotalPupAmount, computeUnifiedAccountRatio, decodeSlug, enableHip3DexAbstractionWithAgent, encodeSlug, floorUtcDay, floorUtcHour, floorUtcMinutes, floorUtcWeek, formatPriceAndSize, formatPriceForDisplay, formatPriceForOrder, formatSizeForDisplay, formatSizeForOrder, getApprovalAmount, getClientCodeNameById, getCloid, getDexFromCollateralTokenSymbol, getDisplayMarketSymbol, getHip3Dex, getHip3DexAbstraction, getLatestCompletedWeek, getNextTierInfo, getPriceDecimals, getStaticCollateralTokenByDex, getStaticCollateralTokenSymbol, getUserAbstraction, getWeekInfoFromNumber, getWidgetTypeById, isBasedCloid, isClientCode, isHip3Symbol, isMiniAppCloid, isMiniAppTriggeredCloid, isSpotSymbol, isStableQuoteToken, isTenantCloid, isTrackingIdCloid, isWidgetType, makeUtcRounder, normaliseSlug, normaliseTrackingId, normalizeAirdropAmount, parseCloid, setHip3DexAbstraction, setUserAbstraction, stableQuoteTokens };
+export { ABSTRACTION_MODE_TO_AGENT_CODE, ADMINS, ADMIN_WALLETS, AGENT_CODE_TO_ABSTRACTION_MODE, ALL_ADMINS, type AgentAbstractionCode, type AirdropAllocationData, CloidClientCode, type CloidClientCodeId, CloidClientCodeNameById, type CloidData, DayOfWeek, type DexInfo, type ExtendedPerpsMeta, type LeadingVault, type MarketInfo, type MultiverseMeta, PUP_TOKEN_ADDRESS, PUP_TOKEN_THRESHOLDS, type PerpDexAssetPosition, type PerpDexClearinghouseState, type PerpDexState, type PupEligibilityResult, ROOT_DEX, SUPER_ADMINS, type SettableAbstractionMode, type SpotBalance, TARGET_APPROVED_MAX_BUILDER_FEE, TARGET_APPROVED_MAX_BUILDER_FEE_PERCENT, TESTNET_USDC_SPOT_TOKEN, type TokenInfo, USDC_SPOT_TOKEN, type UpheavalApiResponse, type UpheavalPosition, type UpheavalSnapshot, type UserAbstractionMode, UserDexAbstractionTypes, UserSetAbstractionTypes, type V3LPTokenInfo, type WeekInfo, WidgetType, WidgetTypeById, type WidgetTypeId, type WsWebData3, XP_BOOST_PERCENTAGES, agentSetAbstraction, buildCloid, calculateBoostPercentage, calculateTotalPupAmount, computeUnifiedAccountRatio, decodeSlug, enableHip3DexAbstractionWithAgent, encodeSlug, floorUtcDay, floorUtcHour, floorUtcMinutes, floorUtcWeek, formatPriceAndSize, formatPriceForDisplay, formatPriceForOrder, formatSizeForDisplay, formatSizeForOrder, getApprovalAmount, getClientCodeNameById, getCloid, getDexFromCollateralTokenSymbol, getDisplayMarketSymbol, getHip3Dex, getHip3DexAbstraction, getLatestCompletedWeek, getNextTierInfo, getPriceDecimals, getStaticCollateralTokenByDex, getStaticCollateralTokenSymbol, getUserAbstraction, getWeekInfoFromNumber, getWidgetTypeById, isBasedCloid, isClientCode, isHip3Symbol, isMiniAppCloid, isMiniAppTriggeredCloid, isSpotSymbol, isStableQuoteToken, isTenantCloid, isTrackingIdCloid, isWidgetType, makeUtcRounder, normaliseSlug, normaliseTrackingId, normalizeAirdropAmount, parseCloid, setHip3DexAbstraction, setUserAbstraction, stableQuoteTokens };

package/dist/index.js

@@ -551,31 +551,40 @@ var TESTNET_USDC_SPOT_TOKEN = {
 };
 
 // lib/constants/admin.ts
-var ADMINS = [
+var SUPER_ADMINS = [
   "did:privy:cmc3hycnb00pljs0m1z010geq",
   "did:privy:cmc8w2ddl01rdju0nylb6rp1v",
   "did:privy:cmc3oftiz005fjx0msox3xgey",
   "did:privy:cmcbx7i4400q8l90mawdymaag",
   "did:privy:cmctbwphs00vzjz0m3la3zm4c",
   "did:privy:cmcblrplb009ol70mia13winn",
-  "did:privy:cmcmizpxm02xfju0oc81alfy0",
   "did:privy:cmcd2bvft00w3l90ljeyb4wn6",
   "did:privy:cmc4y13ka0119kv0nckvgla1u",
   "did:privy:cmc8qc36g00c1l70nnutuscue",
   "did:privy:cmc8f1tf9019zlh0myjpi420p",
   "did:privy:cmc6bturg002ql80mhzqr1d76",
   "did:privy:cmc8uyr4t01kljo0mk3unzjl3",
-  "did:privy:cmcke9v7h00yijy0o2a41nhms",
+  "did:privy:cmcke9v7h00yijy0o2a41nhms"
+];
+var ADMINS = [
   "did:privy:cmgfcjt2y0024kz0cpymoqbmp",
+  // aayush
   "did:privy:cmeqj8tsi01k6la0c3s7gsl6w",
   // elroy
   "did:privy:cmiwrno1i00cdl70c5ro13eyp",
   // adele
   "did:privy:cmkc0jyy200abji0d42a0syil",
   // matthew
-  "did:privy:cmlgc2zjk005vjo0cct10trdl"
-  // adele
+  "did:privy:cmlgc2zjk005vjo0cct10trdl",
+  // marketing
+  "did:privy:cme2d56i90091i90bdhuyaj7e",
+  // jun
+  "did:privy:cmm4av80f00140cldz3uv7io2",
+  // shubit
+  "did:privy:cmcbndjjm02fvjr0mrs42yahs"
+  // zlace
 ];
+var ALL_ADMINS = [...SUPER_ADMINS, ...ADMINS];
 var ADMIN_WALLETS = [
   "0x0c7582A67B8B6AD04Ea404A6C2A06aAc9E0d4e7c",
   "0xDec587aDD20A6447fF0b29D70E95b10b197b1283",
@@ -819,11 +828,41 @@ function getDexFromCollateralTokenSymbol(collateralTokenSymbol) {
 }
 
 // lib/hip3/market-info.ts
-async function getAllPerpsMeta(infoClient) {
+async function getPerpConciseAnnotations(infoClient) {
   return infoClient.transport.request("info", {
-    type: "allPerpMetas"
+    type: "perpConciseAnnotations"
   });
 }
+function enrichAllPerpsMetaWithAnnotations(metas, annotations) {
+  const map = new Map(annotations);
+  return metas.map((meta) => ({
+    ...meta,
+    universe: meta.universe.map((u) => {
+      const ann = map.get(u.name);
+      if (!ann) return u;
+      return {
+        ...u,
+        ...ann.category != null && ann.category !== "" ? { category: ann.category } : {},
+        ...ann.displayName != null && ann.displayName !== "" ? { displayName: ann.displayName } : {},
+        ...ann.keywords != null && ann.keywords.length > 0 ? { keywords: ann.keywords } : {}
+      };
+    })
+  }));
+}
+async function getAllPerpsMeta(infoClient) {
+  const [metas, annotations] = await Promise.all([
+    infoClient.transport.request("info", {
+      type: "allPerpMetas"
+    }),
+    getPerpConciseAnnotations(infoClient).catch(() => {
+      return [];
+    })
+  ]);
+  if (!annotations.length) {
+    return metas;
+  }
+  return enrichAllPerpsMetaWithAnnotations(metas, annotations);
+}
 
 // lib/abstraction/types.ts
 var ABSTRACTION_MODE_TO_AGENT_CODE = {
@@ -1107,7 +1146,10 @@ var InstrumentClient = class {
           type: "futures",
           isDelisted: info.isDelisted,
           dex: AssetIdUtils.extractDexName(info.name),
-          collateralTokenIndex: perpMeta.collateralToken
+          collateralTokenIndex: perpMeta.collateralToken,
+          category: info.category,
+          displayName: info.displayName,
+          keywords: info.keywords
         };
         this.addInstrument(instrument);
       }
@@ -4221,6 +4263,7 @@ exports.ABSTRACTION_MODE_TO_AGENT_CODE = ABSTRACTION_MODE_TO_AGENT_CODE;
 exports.ADMINS = ADMINS;
 exports.ADMIN_WALLETS = ADMIN_WALLETS;
 exports.AGENT_CODE_TO_ABSTRACTION_MODE = AGENT_CODE_TO_ABSTRACTION_MODE;
+exports.ALL_ADMINS = ALL_ADMINS;
 exports.AssetIdUtils = AssetIdUtils;
 exports.BannerType = BannerType;
 exports.BaseEcommerceClient = BaseEcommerceClient;
@@ -4249,6 +4292,7 @@ exports.ROOT_DEX = ROOT_DEX;
 exports.ReturnStatus = ReturnStatus;
 exports.ReviewSortBy = ReviewSortBy;
 exports.ReviewStatus = ReviewStatus;
+exports.SUPER_ADMINS = SUPER_ADMINS;
 exports.ShipmentStatus = ShipmentStatus;
 exports.SortOrder = SortOrder;
 exports.TARGET_APPROVED_MAX_BUILDER_FEE = TARGET_APPROVED_MAX_BUILDER_FEE;
@@ -4276,6 +4320,7 @@ exports.computeUnifiedAccountRatio = computeUnifiedAccountRatio;
 exports.decodeSlug = decodeSlug;
 exports.enableHip3DexAbstractionWithAgent = enableHip3DexAbstractionWithAgent;
 exports.encodeSlug = encodeSlug;
+exports.enrichAllPerpsMetaWithAnnotations = enrichAllPerpsMetaWithAnnotations;
 exports.floorUtcDay = floorUtcDay;
 exports.floorUtcHour = floorUtcHour;
 exports.floorUtcMinutes = floorUtcMinutes;
@@ -4298,6 +4343,7 @@ exports.getHip3DexAbstraction = getHip3DexAbstraction;
 exports.getLatestCompletedWeek = getLatestCompletedWeek;
 exports.getNextStatuses = getNextStatuses;
 exports.getNextTierInfo = getNextTierInfo;
+exports.getPerpConciseAnnotations = getPerpConciseAnnotations;
 exports.getPriceDecimals = getPriceDecimals;
 exports.getStaticCollateralTokenByDex = getStaticCollateralTokenByDex;
 exports.getStaticCollateralTokenSymbol = getStaticCollateralTokenSymbol;

package/dist/index.mjs

@@ -1,5 +1,5 @@
 export { BannerType, BaseEcommerceClient, CustomerEcommerceClient, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, InventoryAuditAction, MerchantBusinessType, MerchantEcommerceClient, MerchantReturnPolicyType, MerchantStatus, ORDER_STATUS_TRANSITIONS, OrderStatus, PaymentMethod, PaymentStatus, ProductSortBy, ReturnStatus, ReviewSortBy, ReviewStatus, ShipmentStatus, SortOrder, TaxBehavior, TaxReportPeriodType, TaxReportStatus, TaxType, buildQueryString, calculateDiscountAmount, calculateFinalPrice, canCancelOrder, formatPrice, getBackoffDelay, getNextStatuses, getStatusColor, getStatusLabel, getStatusProgress, isPickupOrder, isRetryableError, isValidAddress, isValidEmail, parseError, requiresTrackingInfo, retryWithBackoff, shouldNotifyCustomer, sleep, truncateAddress, validateStatusTransition } from './chunk-35WGIB5F.mjs';
-export { AssetIdUtils, InstrumentClient } from './chunk-VBC6EQ7Q.mjs';
+export { AssetIdUtils, InstrumentClient } from './chunk-OZPAOG43.mjs';
 import Decimal, { Decimal as Decimal$1 } from 'decimal.js';
 import { signL1Action, signUserSignedAction } from '@nktkas/hyperliquid/signing';
 
@@ -545,31 +545,40 @@ var TESTNET_USDC_SPOT_TOKEN = {
 };
 
 // lib/constants/admin.ts
-var ADMINS = [
+var SUPER_ADMINS = [
   "did:privy:cmc3hycnb00pljs0m1z010geq",
   "did:privy:cmc8w2ddl01rdju0nylb6rp1v",
   "did:privy:cmc3oftiz005fjx0msox3xgey",
   "did:privy:cmcbx7i4400q8l90mawdymaag",
   "did:privy:cmctbwphs00vzjz0m3la3zm4c",
   "did:privy:cmcblrplb009ol70mia13winn",
-  "did:privy:cmcmizpxm02xfju0oc81alfy0",
   "did:privy:cmcd2bvft00w3l90ljeyb4wn6",
   "did:privy:cmc4y13ka0119kv0nckvgla1u",
   "did:privy:cmc8qc36g00c1l70nnutuscue",
   "did:privy:cmc8f1tf9019zlh0myjpi420p",
   "did:privy:cmc6bturg002ql80mhzqr1d76",
   "did:privy:cmc8uyr4t01kljo0mk3unzjl3",
-  "did:privy:cmcke9v7h00yijy0o2a41nhms",
+  "did:privy:cmcke9v7h00yijy0o2a41nhms"
+];
+var ADMINS = [
   "did:privy:cmgfcjt2y0024kz0cpymoqbmp",
+  // aayush
   "did:privy:cmeqj8tsi01k6la0c3s7gsl6w",
   // elroy
   "did:privy:cmiwrno1i00cdl70c5ro13eyp",
   // adele
   "did:privy:cmkc0jyy200abji0d42a0syil",
   // matthew
-  "did:privy:cmlgc2zjk005vjo0cct10trdl"
-  // adele
+  "did:privy:cmlgc2zjk005vjo0cct10trdl",
+  // marketing
+  "did:privy:cme2d56i90091i90bdhuyaj7e",
+  // jun
+  "did:privy:cmm4av80f00140cldz3uv7io2",
+  // shubit
+  "did:privy:cmcbndjjm02fvjr0mrs42yahs"
+  // zlace
 ];
+var ALL_ADMINS = [...SUPER_ADMINS, ...ADMINS];
 var ADMIN_WALLETS = [
   "0x0c7582A67B8B6AD04Ea404A6C2A06aAc9E0d4e7c",
   "0xDec587aDD20A6447fF0b29D70E95b10b197b1283",
@@ -813,11 +822,41 @@ function getDexFromCollateralTokenSymbol(collateralTokenSymbol) {
 }
 
 // lib/hip3/market-info.ts
-async function getAllPerpsMeta(infoClient) {
+async function getPerpConciseAnnotations(infoClient) {
   return infoClient.transport.request("info", {
-    type: "allPerpMetas"
+    type: "perpConciseAnnotations"
   });
 }
+function enrichAllPerpsMetaWithAnnotations(metas, annotations) {
+  const map = new Map(annotations);
+  return metas.map((meta) => ({
+    ...meta,
+    universe: meta.universe.map((u) => {
+      const ann = map.get(u.name);
+      if (!ann) return u;
+      return {
+        ...u,
+        ...ann.category != null && ann.category !== "" ? { category: ann.category } : {},
+        ...ann.displayName != null && ann.displayName !== "" ? { displayName: ann.displayName } : {},
+        ...ann.keywords != null && ann.keywords.length > 0 ? { keywords: ann.keywords } : {}
+      };
+    })
+  }));
+}
+async function getAllPerpsMeta(infoClient) {
+  const [metas, annotations] = await Promise.all([
+    infoClient.transport.request("info", {
+      type: "allPerpMetas"
+    }),
+    getPerpConciseAnnotations(infoClient).catch(() => {
+      return [];
+    })
+  ]);
+  if (!annotations.length) {
+    return metas;
+  }
+  return enrichAllPerpsMetaWithAnnotations(metas, annotations);
+}
 
 // lib/abstraction/types.ts
 var ABSTRACTION_MODE_TO_AGENT_CODE = {
@@ -918,4 +957,4 @@ function computeUnifiedAccountRatio(multiverse, perpDexStates, spotBalances) {
   return maxRatio;
 }
 
-export { ABSTRACTION_MODE_TO_AGENT_CODE, ADMINS, ADMIN_WALLETS, AGENT_CODE_TO_ABSTRACTION_MODE, CloidClientCode, CloidClientCodeNameById, DayOfWeek, PUP_TOKEN_ADDRESS, PUP_TOKEN_THRESHOLDS, ROOT_DEX, TARGET_APPROVED_MAX_BUILDER_FEE, TARGET_APPROVED_MAX_BUILDER_FEE_PERCENT, TESTNET_USDC_SPOT_TOKEN, USDC_SPOT_TOKEN, UserDexAbstractionTypes, UserSetAbstractionTypes, WidgetType, WidgetTypeById, XP_BOOST_PERCENTAGES, agentSetAbstraction, buildCloid, calculateBoostPercentage, calculateTotalPupAmount, computeUnifiedAccountRatio, decodeSlug, enableHip3DexAbstractionWithAgent, encodeSlug, floorUtcDay, floorUtcHour, floorUtcMinutes, floorUtcWeek, formatPriceAndSize, formatPriceForDisplay, formatPriceForOrder, formatSizeForDisplay, formatSizeForOrder, getAllPerpsMeta, getApprovalAmount, getClientCodeNameById, getCloid, getDexFromCollateralTokenSymbol, getDisplayMarketSymbol, getHip3Dex, getHip3DexAbstraction, getLatestCompletedWeek, getNextTierInfo, getPriceDecimals, getStaticCollateralTokenByDex, getStaticCollateralTokenSymbol, getUserAbstraction, getWeekInfoFromNumber, getWidgetTypeById, isBasedCloid, isClientCode, isHip3Symbol, isMiniAppCloid, isMiniAppTriggeredCloid, isSpotSymbol, isStableQuoteToken, isTenantCloid, isTrackingIdCloid, isWidgetType, makeUtcRounder, normaliseSlug, normaliseTrackingId, normalizeAirdropAmount, parseCloid, setHip3DexAbstraction, setUserAbstraction, stableQuoteTokens };
+export { ABSTRACTION_MODE_TO_AGENT_CODE, ADMINS, ADMIN_WALLETS, AGENT_CODE_TO_ABSTRACTION_MODE, ALL_ADMINS, CloidClientCode, CloidClientCodeNameById, DayOfWeek, PUP_TOKEN_ADDRESS, PUP_TOKEN_THRESHOLDS, ROOT_DEX, SUPER_ADMINS, TARGET_APPROVED_MAX_BUILDER_FEE, TARGET_APPROVED_MAX_BUILDER_FEE_PERCENT, TESTNET_USDC_SPOT_TOKEN, USDC_SPOT_TOKEN, UserDexAbstractionTypes, UserSetAbstractionTypes, WidgetType, WidgetTypeById, XP_BOOST_PERCENTAGES, agentSetAbstraction, buildCloid, calculateBoostPercentage, calculateTotalPupAmount, computeUnifiedAccountRatio, decodeSlug, enableHip3DexAbstractionWithAgent, encodeSlug, enrichAllPerpsMetaWithAnnotations, floorUtcDay, floorUtcHour, floorUtcMinutes, floorUtcWeek, formatPriceAndSize, formatPriceForDisplay, formatPriceForOrder, formatSizeForDisplay, formatSizeForOrder, getAllPerpsMeta, getApprovalAmount, getClientCodeNameById, getCloid, getDexFromCollateralTokenSymbol, getDisplayMarketSymbol, getHip3Dex, getHip3DexAbstraction, getLatestCompletedWeek, getNextTierInfo, getPerpConciseAnnotations, getPriceDecimals, getStaticCollateralTokenByDex, getStaticCollateralTokenSymbol, getUserAbstraction, getWeekInfoFromNumber, getWidgetTypeById, isBasedCloid, isClientCode, isHip3Symbol, isMiniAppCloid, isMiniAppTriggeredCloid, isSpotSymbol, isStableQuoteToken, isTenantCloid, isTrackingIdCloid, isWidgetType, makeUtcRounder, normaliseSlug, normaliseTrackingId, normalizeAirdropAmount, parseCloid, setHip3DexAbstraction, setUserAbstraction, stableQuoteTokens };

package/dist/react.d.mts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 import { SpotMeta } from '@nktkas/hyperliquid';
-import { A as AllPerpsMeta, I as InstrumentClient } from './client-BQzYwHDY.mjs';
+import { A as AllPerpsMeta, I as InstrumentClient } from './client-1sWFpTpK.mjs';
 
 interface InstrumentsProviderProps {
     spotMeta: SpotMeta;

package/dist/react.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 import { SpotMeta } from '@nktkas/hyperliquid';
-import { A as AllPerpsMeta, I as InstrumentClient } from './client-BQzYwHDY.js';
+import { A as AllPerpsMeta, I as InstrumentClient } from './client-1sWFpTpK.js';
 
 interface InstrumentsProviderProps {
     spotMeta: SpotMeta;

package/dist/react.js

@@ -188,7 +188,10 @@ var InstrumentClient = class {
           type: "futures",
           isDelisted: info.isDelisted,
           dex: AssetIdUtils.extractDexName(info.name),
-          collateralTokenIndex: perpMeta.collateralToken
+          collateralTokenIndex: perpMeta.collateralToken,
+          category: info.category,
+          displayName: info.displayName,
+          keywords: info.keywords
         };
         this.addInstrument(instrument);
       }

package/dist/react.mjs

@@ -1,4 +1,4 @@
-import { InstrumentClient } from './chunk-VBC6EQ7Q.mjs';
+import { InstrumentClient } from './chunk-OZPAOG43.mjs';
 import { createContext, useMemo, useContext } from 'react';
 import { jsx } from 'react/jsx-runtime';
 

package/lib/constants/admin.ts

@@ -1,12 +1,11 @@
-// Super admin Privy user IDs — single source of truth for all apps
-export const ADMINS = [
+// Super admin Privy user IDs — full unrestricted access
+export const SUPER_ADMINS = [
   "did:privy:cmc3hycnb00pljs0m1z010geq",
   "did:privy:cmc8w2ddl01rdju0nylb6rp1v",
   "did:privy:cmc3oftiz005fjx0msox3xgey",
   "did:privy:cmcbx7i4400q8l90mawdymaag",
   "did:privy:cmctbwphs00vzjz0m3la3zm4c",
   "did:privy:cmcblrplb009ol70mia13winn",
-  "did:privy:cmcmizpxm02xfju0oc81alfy0",
   "did:privy:cmcd2bvft00w3l90ljeyb4wn6",
   "did:privy:cmc4y13ka0119kv0nckvgla1u",
   "did:privy:cmc8qc36g00c1l70nnutuscue",
@@ -14,13 +13,23 @@ export const ADMINS = [
   "did:privy:cmc6bturg002ql80mhzqr1d76",
   "did:privy:cmc8uyr4t01kljo0mk3unzjl3",
   "did:privy:cmcke9v7h00yijy0o2a41nhms",
-  "did:privy:cmgfcjt2y0024kz0cpymoqbmp",
+];
+
+// Regular admin Privy user IDs — restricted access (no payouts/airdrops/launchpads/API keys/cache)
+export const ADMINS = [
+  "did:privy:cmgfcjt2y0024kz0cpymoqbmp", // aayush
   "did:privy:cmeqj8tsi01k6la0c3s7gsl6w", // elroy
   "did:privy:cmiwrno1i00cdl70c5ro13eyp", // adele
   "did:privy:cmkc0jyy200abji0d42a0syil", // matthew
-  "did:privy:cmlgc2zjk005vjo0cct10trdl", // adele
+  "did:privy:cmlgc2zjk005vjo0cct10trdl", // marketing
+  "did:privy:cme2d56i90091i90bdhuyaj7e", // jun
+  "did:privy:cmm4av80f00140cldz3uv7io2", // shubit
+  "did:privy:cmcbndjjm02fvjr0mrs42yahs", // zlace
 ];
 
+// All admin IDs combined — use for "is this user any kind of admin?" checks
+export const ALL_ADMINS = [...SUPER_ADMINS, ...ADMINS];
+
 // Global admin wallet addresses
 export const ADMIN_WALLETS: string[] = [
   "0x0c7582A67B8B6AD04Ea404A6C2A06aAc9E0d4e7c",

package/lib/hip3/market-info.ts

@@ -1,5 +1,14 @@
 import { InfoClient, PerpsAssetCtx, MarginTables, PerpDex as LegacyPerpDex } from "@nktkas/hyperliquid";
 
+/** Payload entries from Hyperliquid `info` → `{ type: "perpConciseAnnotations" }`. */
+export interface PerpConciseAnnotationMeta {
+  category?: string;
+  displayName?: string;
+  keywords?: string[];
+}
+
+export type PerpConciseAnnotations = [string, PerpConciseAnnotationMeta][];
+
 export interface PerpsMeta {
   collateralToken: number;
   /** Trading universes available for perpetual trading. */
@@ -32,6 +41,10 @@ export interface PerpsUniverse {
   growthMode?: "enabled";
   /** Margin mode for the universe. */
   marginMode?: "strictIsolated" | "noCross";
+  /** From `perpConciseAnnotations` when present (search/display). */
+  category?: string;
+  displayName?: string;
+  keywords?: string[];
 }
 
 export interface PerpDex extends LegacyPerpDex {
@@ -40,10 +53,60 @@ export interface PerpDex extends LegacyPerpDex {
 
 export type AllPerpsMeta = PerpsMeta[];
 
+export async function getPerpConciseAnnotations(
+  infoClient: InfoClient,
+): Promise<PerpConciseAnnotations> {
+  return infoClient.transport.request<PerpConciseAnnotations>("info", {
+    type: "perpConciseAnnotations",
+  });
+}
+
+/**
+ * Merges `perpConciseAnnotations` into each universe row by matching `name`.
+ */
+export function enrichAllPerpsMetaWithAnnotations(
+  metas: AllPerpsMeta,
+  annotations: PerpConciseAnnotations,
+): AllPerpsMeta {
+  const map = new Map<string, PerpConciseAnnotationMeta>(annotations);
+
+  return metas.map((meta) => ({
+    ...meta,
+    universe: meta.universe.map((u) => {
+      const ann = map.get(u.name);
+      if (!ann) return u;
+
+      return {
+        ...u,
+        ...(ann.category != null && ann.category !== ""
+          ? { category: ann.category }
+          : {}),
+        ...(ann.displayName != null && ann.displayName !== ""
+          ? { displayName: ann.displayName }
+          : {}),
+        ...(ann.keywords != null && ann.keywords.length > 0
+          ? { keywords: ann.keywords }
+          : {}),
+      };
+    }),
+  }));
+}
+
 export async function getAllPerpsMeta(
   infoClient: InfoClient,
 ): Promise<AllPerpsMeta> {
-  return infoClient.transport.request<AllPerpsMeta>("info", {
-    type: "allPerpMetas",
-  });
+  const [metas, annotations] = await Promise.all([
+    infoClient.transport.request<AllPerpsMeta>("info", {
+      type: "allPerpMetas",
+    }),
+    getPerpConciseAnnotations(infoClient).catch((): PerpConciseAnnotations => {
+      return [];
+    }),
+  ]);
+
+  if (!annotations.length) {
+    return metas;
+  }
+
+  return enrichAllPerpsMetaWithAnnotations(metas, annotations);
 }

package/lib/instrument/client.ts

@@ -17,6 +17,10 @@ export interface PerpsInstrument extends BaseInstrument {
   collateralTokenSymbol: string;
   dex?: string; // HIP3 dex name (e.g., "xyz" for "xyz:MSTR")
   collateralTokenIndex?: number;
+  /** From merged `perpConciseAnnotations` (display/search). */
+  category?: string;
+  displayName?: string;
+  keywords?: string[];
 }
 
 // Spot-specific types (metadata only - no asset context data)
@@ -280,6 +284,9 @@ export class InstrumentClient {
           isDelisted: info.isDelisted,
           dex: AssetIdUtils.extractDexName(info.name),
           collateralTokenIndex: perpMeta.collateralToken,
+          category: info.category,
+          displayName: info.displayName,
+          keywords: info.keywords,
         };
 
         this.addInstrument(instrument);

package/lib/meta/types.ts

@@ -33,4 +33,8 @@ export interface PerpsUniverse {
   growthMode?: "enabled";
   /** Margin mode for the universe. */
   marginMode?: "strictIsolated" | "noCross";
+  /** From Hyperliquid `perpConciseAnnotations` when merged into meta. */
+  category?: string;
+  displayName?: string;
+  keywords?: string[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@basedone/core",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Core utilities for Based One",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -63,4 +63,4 @@
       "optional": true
     }
   }
-}
+}