@basedone/core 0.2.8 → 0.3.0

package/dist/index.js

@@ -550,6 +550,39 @@ var TESTNET_USDC_SPOT_TOKEN = {
   deployerTradingFeeShare: "0.0"
 };
 
+// lib/constants/admin.ts
+var 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:cmgfcjt2y0024kz0cpymoqbmp",
+  "did:privy:cmeqj8tsi01k6la0c3s7gsl6w",
+  // elroy
+  "did:privy:cmiwrno1i00cdl70c5ro13eyp",
+  // adele
+  "did:privy:cmkc0jyy200abji0d42a0syil",
+  // matthew
+  "did:privy:cmlgc2zjk005vjo0cct10trdl"
+  // adele
+];
+var ADMIN_WALLETS = [
+  "0x0c7582A67B8B6AD04Ea404A6C2A06aAc9E0d4e7c",
+  "0xDec587aDD20A6447fF0b29D70E95b10b197b1283",
+  "0x3e83987019c4CE29680401b72F8b18A2dE3f8fe6",
+  "0x5446A5Bc711170d5197DE33D8C193487794f30C0"
+];
+
 // lib/meta/metadata.ts
 var ROOT_DEX = "hyperliquid";
 var formatPriceAndSize = ({
@@ -792,6 +825,105 @@ async function getAllPerpsMeta(infoClient) {
   });
 }
 
+// lib/abstraction/types.ts
+var ABSTRACTION_MODE_TO_AGENT_CODE = {
+  disabled: "i",
+  unifiedAccount: "u",
+  portfolioMargin: "p"
+};
+var AGENT_CODE_TO_ABSTRACTION_MODE = {
+  i: "disabled",
+  u: "unifiedAccount",
+  p: "portfolioMargin"
+};
+var UserSetAbstractionTypes = {
+  "HyperliquidTransaction:UserSetAbstraction": [
+    { name: "hyperliquidChain", type: "string" },
+    { name: "user", type: "address" },
+    { name: "abstraction", type: "string" },
+    { name: "nonce", type: "uint64" }
+  ]
+};
+async function getUserAbstraction(client, user) {
+  return await client.transport.request("info", {
+    type: "userAbstraction",
+    user
+  });
+}
+async function setUserAbstraction(client, abstraction, user) {
+  const nonce = Date.now();
+  const isTestnet = client.isTestnet;
+  const action = {
+    type: "userSetAbstraction",
+    hyperliquidChain: isTestnet ? "Testnet" : "Mainnet",
+    signatureChainId: isTestnet ? "0x66eee" : "0xa4b1",
+    user,
+    abstraction,
+    nonce
+  };
+  const signature = await signing.signUserSignedAction({
+    wallet: client.wallet,
+    action,
+    types: UserSetAbstractionTypes
+  });
+  return await client.transport.request("exchange", {
+    action,
+    signature,
+    nonce: action.nonce
+  });
+}
+async function agentSetAbstraction(client, abstraction) {
+  const nonce = Date.now();
+  const code = ABSTRACTION_MODE_TO_AGENT_CODE[abstraction];
+  const action = {
+    type: "agentSetAbstraction",
+    abstraction: code
+  };
+  const signature = await signing.signL1Action({
+    wallet: client.wallet,
+    action,
+    isTestnet: client.isTestnet,
+    nonce
+  });
+  return await client.transport.request("exchange", {
+    action,
+    signature,
+    nonce
+  });
+}
+
+// lib/abstraction/ratio.ts
+function computeUnifiedAccountRatio(multiverse, perpDexStates, spotBalances) {
+  const indexToCollateralToken = {};
+  for (const meta of Object.values(multiverse)) {
+    indexToCollateralToken[meta.index] = meta.collateralToken;
+  }
+  const crossMarginByToken = {};
+  const isolatedMarginByToken = {};
+  for (let index = 0; index < perpDexStates.length; index++) {
+    const dex = perpDexStates[index];
+    const token = indexToCollateralToken[index];
+    if (dex === void 0 || token === void 0) continue;
+    crossMarginByToken[token] = (crossMarginByToken[token] ?? 0) + dex.clearinghouseState.crossMaintenanceMarginUsed;
+    for (const ap of dex.clearinghouseState.assetPositions) {
+      if (ap.position.leverage.type === "isolated") {
+        isolatedMarginByToken[token] = (isolatedMarginByToken[token] ?? 0) + ap.position.marginUsed;
+      }
+    }
+  }
+  let maxRatio = 0;
+  for (const [tokenStr, crossMargin] of Object.entries(crossMarginByToken)) {
+    const token = Number(tokenStr);
+    const spotTotal = spotBalances.find((b) => b.token === token)?.total ?? 0;
+    const isolatedMargin = isolatedMarginByToken[token] ?? 0;
+    const available = spotTotal - isolatedMargin;
+    if (available > 0) {
+      maxRatio = Math.max(maxRatio, crossMargin / available);
+    }
+  }
+  return maxRatio;
+}
+
 // lib/instrument/client.ts
 var AssetIdUtils = {
   /**
@@ -2248,6 +2380,38 @@ var CustomerEcommerceClient = class extends BaseEcommerceClient {
   async getDeliveryAddress() {
     return this.get("/api/basedpay/delivery-address");
   }
+  /**
+   * Get user's Hyperliquid USDC balance (perp withdrawable)
+   *
+   * Returns the USDC balance available for escrow deposits via usdSend.
+   *
+   * @returns Balance response with amount and currency
+   */
+  async getUsdcBalance() {
+    return this.get("/api/marketplace/usdc-balance");
+  }
+  // ============================================================================
+  // Notifications API
+  // ============================================================================
+  /**
+   * List notifications for the authenticated customer
+   *
+   * @param params - Query parameters for filtering and pagination
+   * @returns Paginated list of notifications with unread count
+   */
+  async listNotifications(params) {
+    const queryString = params ? buildQueryString(params) : "";
+    return this.get(`/api/marketplace/notifications${queryString}`);
+  }
+  /**
+   * Mark notifications as read
+   *
+   * @param ids - Specific notification IDs to mark as read. If omitted, marks all as read.
+   * @returns Count of updated notifications
+   */
+  async markNotificationsAsRead(ids) {
+    return this.patch("/api/marketplace/notifications/read", { ids });
+  }
 };
 
 // lib/ecommerce/client/merchant.ts
@@ -3793,6 +3957,7 @@ var OrderStatus = /* @__PURE__ */ ((OrderStatus2) => {
   OrderStatus2["SHIPPED"] = "SHIPPED";
   OrderStatus2["DELIVERED"] = "DELIVERED";
   OrderStatus2["CANCELLED"] = "CANCELLED";
+  OrderStatus2["SETTLED"] = "SETTLED";
   OrderStatus2["CONFIRMED"] = "CONFIRMED";
   OrderStatus2["COMPLETED"] = "COMPLETED";
   return OrderStatus2;
@@ -3926,6 +4091,7 @@ var ProductSortBy = /* @__PURE__ */ ((ProductSortBy2) => {
   ProductSortBy2["PRICE_ASC"] = "price_asc";
   ProductSortBy2["PRICE_DESC"] = "price_desc";
   ProductSortBy2["POPULAR"] = "popular";
+  ProductSortBy2["BEST_SELLING"] = "best_selling";
   ProductSortBy2["FEATURED"] = "featured";
   ProductSortBy2["NEARBY"] = "nearby";
   return ProductSortBy2;
@@ -3937,6 +4103,124 @@ var ReviewSortBy = /* @__PURE__ */ ((ReviewSortBy2) => {
   return ReviewSortBy2;
 })(ReviewSortBy || {});
 
+// lib/ecommerce/utils/orderStateMachine.ts
+function isPickupOrder(shippingMethod, shippingRateId) {
+  if (shippingRateId && shippingRateId.trim().toUpperCase() === "PICKUP") {
+    return true;
+  }
+  if (!shippingMethod) return false;
+  const normalized = shippingMethod.trim().toLowerCase().replace(/[\s-]+/g, " ");
+  return normalized === "pickup" || normalized === "on site collection" || normalized === "onsite collection";
+}
+var ORDER_STATUS_TRANSITIONS = {
+  ["CREATED" /* CREATED */]: [
+    "PAYMENT_RESERVED" /* PAYMENT_RESERVED */,
+    "MERCHANT_ACCEPTED" /* MERCHANT_ACCEPTED */,
+    "CANCELLED" /* CANCELLED */
+  ],
+  ["PAYMENT_RESERVED" /* PAYMENT_RESERVED */]: [
+    "MERCHANT_ACCEPTED" /* MERCHANT_ACCEPTED */,
+    "CANCELLED" /* CANCELLED */
+  ],
+  ["MERCHANT_ACCEPTED" /* MERCHANT_ACCEPTED */]: [
+    "SHIPPED" /* SHIPPED */,
+    "CANCELLED" /* CANCELLED */
+  ],
+  // Backward compat for existing SETTLED orders created before escrow change
+  // Note: CANCELLED removed — settled orders have funds paid out, no clawback mechanism
+  ["SETTLED" /* SETTLED */]: ["SHIPPED" /* SHIPPED */],
+  ["SHIPPED" /* SHIPPED */]: ["DELIVERED" /* DELIVERED */, "CANCELLED" /* CANCELLED */],
+  // Settlement triggered on delivery (buyer-protected escrow)
+  ["DELIVERED" /* DELIVERED */]: ["SETTLED" /* SETTLED */],
+  // Terminal states
+  ["CANCELLED" /* CANCELLED */]: []
+};
+function validateStatusTransition(currentStatus, newStatus, options) {
+  if (isPickupOrder(options?.shippingMethod, options?.shippingRateId) && (currentStatus === "MERCHANT_ACCEPTED" /* MERCHANT_ACCEPTED */ || currentStatus === "SETTLED" /* SETTLED */) && newStatus === "DELIVERED" /* DELIVERED */) {
+    return { valid: true };
+  }
+  const allowed = ORDER_STATUS_TRANSITIONS[currentStatus] ?? [];
+  if (!allowed.includes(newStatus)) {
+    if (allowed.length === 0) {
+      return {
+        valid: false,
+        error: `Cannot change status from ${currentStatus} \u2014 this is a final state`
+      };
+    }
+    return {
+      valid: false,
+      error: `Cannot transition from ${currentStatus} to ${newStatus}. Allowed: ${allowed.join(", ")}`
+    };
+  }
+  return { valid: true };
+}
+function getNextStatuses(currentStatus, options) {
+  const base = [
+    ...ORDER_STATUS_TRANSITIONS[currentStatus] ?? []
+  ];
+  if (isPickupOrder(options?.shippingMethod, options?.shippingRateId) && (currentStatus === "MERCHANT_ACCEPTED" /* MERCHANT_ACCEPTED */ || currentStatus === "SETTLED" /* SETTLED */) && !base.includes("DELIVERED" /* DELIVERED */)) {
+    base.push("DELIVERED" /* DELIVERED */);
+  }
+  return base;
+}
+function getStatusLabel(status) {
+  const labels = {
+    CREATED: "Created",
+    PAYMENT_RESERVED: "Payment Reserved",
+    MERCHANT_ACCEPTED: "Accepted",
+    SETTLED: "Completed (Paid)",
+    SHIPPED: "Shipped",
+    DELIVERED: "Delivered",
+    CANCELLED: "Cancelled"
+  };
+  return labels[status] || status;
+}
+function getStatusColor(status) {
+  const colors = {
+    CREATED: "gray",
+    PAYMENT_RESERVED: "blue",
+    MERCHANT_ACCEPTED: "purple",
+    SETTLED: "indigo",
+    SHIPPED: "yellow",
+    DELIVERED: "green",
+    CANCELLED: "red"
+  };
+  return colors[status] || "gray";
+}
+function canCancelOrder(currentStatus) {
+  return ORDER_STATUS_TRANSITIONS[currentStatus]?.includes(
+    "CANCELLED" /* CANCELLED */
+  ) ?? false;
+}
+function requiresTrackingInfo(newStatus, options) {
+  if (newStatus !== "SHIPPED" /* SHIPPED */) return false;
+  return !isPickupOrder(options?.shippingMethod, options?.shippingRateId);
+}
+function shouldNotifyCustomer(newStatus) {
+  return [
+    "MERCHANT_ACCEPTED" /* MERCHANT_ACCEPTED */,
+    "SHIPPED" /* SHIPPED */,
+    "DELIVERED" /* DELIVERED */,
+    "CANCELLED" /* CANCELLED */
+  ].includes(newStatus);
+}
+function getStatusProgress(status) {
+  const progressMap = {
+    CREATED: 10,
+    PAYMENT_RESERVED: 25,
+    MERCHANT_ACCEPTED: 40,
+    SETTLED: 50,
+    SHIPPED: 75,
+    DELIVERED: 100,
+    CANCELLED: 0
+  };
+  return progressMap[status] || 0;
+}
+
+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.AssetIdUtils = AssetIdUtils;
 exports.BannerType = BannerType;
 exports.BaseEcommerceClient = BaseEcommerceClient;
@@ -3954,6 +4238,7 @@ exports.MerchantBusinessType = MerchantBusinessType;
 exports.MerchantEcommerceClient = MerchantEcommerceClient;
 exports.MerchantReturnPolicyType = MerchantReturnPolicyType;
 exports.MerchantStatus = MerchantStatus;
+exports.ORDER_STATUS_TRANSITIONS = ORDER_STATUS_TRANSITIONS;
 exports.OrderStatus = OrderStatus;
 exports.PUP_TOKEN_ADDRESS = PUP_TOKEN_ADDRESS;
 exports.PUP_TOKEN_THRESHOLDS = PUP_TOKEN_THRESHOLDS;
@@ -3975,15 +4260,19 @@ exports.TaxReportStatus = TaxReportStatus;
 exports.TaxType = TaxType;
 exports.USDC_SPOT_TOKEN = USDC_SPOT_TOKEN;
 exports.UserDexAbstractionTypes = UserDexAbstractionTypes;
+exports.UserSetAbstractionTypes = UserSetAbstractionTypes;
 exports.WidgetType = WidgetType;
 exports.WidgetTypeById = WidgetTypeById;
 exports.XP_BOOST_PERCENTAGES = XP_BOOST_PERCENTAGES;
+exports.agentSetAbstraction = agentSetAbstraction;
 exports.buildCloid = buildCloid;
 exports.buildQueryString = buildQueryString;
 exports.calculateBoostPercentage = calculateBoostPercentage;
 exports.calculateDiscountAmount = calculateDiscountAmount;
 exports.calculateFinalPrice = calculateFinalPrice;
 exports.calculateTotalPupAmount = calculateTotalPupAmount;
+exports.canCancelOrder = canCancelOrder;
+exports.computeUnifiedAccountRatio = computeUnifiedAccountRatio;
 exports.decodeSlug = decodeSlug;
 exports.enableHip3DexAbstractionWithAgent = enableHip3DexAbstractionWithAgent;
 exports.encodeSlug = encodeSlug;
@@ -4007,10 +4296,15 @@ exports.getDisplayMarketSymbol = getDisplayMarketSymbol;
 exports.getHip3Dex = getHip3Dex;
 exports.getHip3DexAbstraction = getHip3DexAbstraction;
 exports.getLatestCompletedWeek = getLatestCompletedWeek;
+exports.getNextStatuses = getNextStatuses;
 exports.getNextTierInfo = getNextTierInfo;
 exports.getPriceDecimals = getPriceDecimals;
 exports.getStaticCollateralTokenByDex = getStaticCollateralTokenByDex;
 exports.getStaticCollateralTokenSymbol = getStaticCollateralTokenSymbol;
+exports.getStatusColor = getStatusColor;
+exports.getStatusLabel = getStatusLabel;
+exports.getStatusProgress = getStatusProgress;
+exports.getUserAbstraction = getUserAbstraction;
 exports.getWeekInfoFromNumber = getWeekInfoFromNumber;
 exports.getWidgetTypeById = getWidgetTypeById;
 exports.isBasedCloid = isBasedCloid;
@@ -4018,6 +4312,7 @@ exports.isClientCode = isClientCode;
 exports.isHip3Symbol = isHip3Symbol;
 exports.isMiniAppCloid = isMiniAppCloid;
 exports.isMiniAppTriggeredCloid = isMiniAppTriggeredCloid;
+exports.isPickupOrder = isPickupOrder;
 exports.isRetryableError = isRetryableError;
 exports.isSpotSymbol = isSpotSymbol;
 exports.isStableQuoteToken = isStableQuoteToken;
@@ -4032,8 +4327,12 @@ exports.normaliseTrackingId = normaliseTrackingId;
 exports.normalizeAirdropAmount = normalizeAirdropAmount;
 exports.parseCloid = parseCloid;
 exports.parseError = parseError;
+exports.requiresTrackingInfo = requiresTrackingInfo;
 exports.retryWithBackoff = retryWithBackoff;
 exports.setHip3DexAbstraction = setHip3DexAbstraction;
+exports.setUserAbstraction = setUserAbstraction;
+exports.shouldNotifyCustomer = shouldNotifyCustomer;
 exports.sleep = sleep;
 exports.stableQuoteTokens = stableQuoteTokens;
 exports.truncateAddress = truncateAddress;
+exports.validateStatusTransition = validateStatusTransition;

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { BannerType, BaseEcommerceClient, CustomerEcommerceClient, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, InventoryAuditAction, MerchantBusinessType, MerchantEcommerceClient, MerchantReturnPolicyType, MerchantStatus, OrderStatus, PaymentMethod, PaymentStatus, ProductSortBy, ReturnStatus, ReviewSortBy, ReviewStatus, ShipmentStatus, SortOrder, TaxBehavior, TaxReportPeriodType, TaxReportStatus, TaxType, buildQueryString, calculateDiscountAmount, calculateFinalPrice, formatPrice, getBackoffDelay, isRetryableError, isValidAddress, isValidEmail, parseError, retryWithBackoff, sleep, truncateAddress } from './chunk-NKSQEISP.mjs';
+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';
 import Decimal, { Decimal as Decimal$1 } from 'decimal.js';
 import { signL1Action, signUserSignedAction } from '@nktkas/hyperliquid/signing';
@@ -544,6 +544,39 @@ var TESTNET_USDC_SPOT_TOKEN = {
   deployerTradingFeeShare: "0.0"
 };
 
+// lib/constants/admin.ts
+var 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:cmgfcjt2y0024kz0cpymoqbmp",
+  "did:privy:cmeqj8tsi01k6la0c3s7gsl6w",
+  // elroy
+  "did:privy:cmiwrno1i00cdl70c5ro13eyp",
+  // adele
+  "did:privy:cmkc0jyy200abji0d42a0syil",
+  // matthew
+  "did:privy:cmlgc2zjk005vjo0cct10trdl"
+  // adele
+];
+var ADMIN_WALLETS = [
+  "0x0c7582A67B8B6AD04Ea404A6C2A06aAc9E0d4e7c",
+  "0xDec587aDD20A6447fF0b29D70E95b10b197b1283",
+  "0x3e83987019c4CE29680401b72F8b18A2dE3f8fe6",
+  "0x5446A5Bc711170d5197DE33D8C193487794f30C0"
+];
+
 // lib/meta/metadata.ts
 var ROOT_DEX = "hyperliquid";
 var formatPriceAndSize = ({
@@ -786,4 +819,103 @@ async function getAllPerpsMeta(infoClient) {
   });
 }
 
-export { 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, WidgetType, WidgetTypeById, XP_BOOST_PERCENTAGES, buildCloid, calculateBoostPercentage, calculateTotalPupAmount, 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, getWeekInfoFromNumber, getWidgetTypeById, isBasedCloid, isClientCode, isHip3Symbol, isMiniAppCloid, isMiniAppTriggeredCloid, isSpotSymbol, isStableQuoteToken, isTenantCloid, isTrackingIdCloid, isWidgetType, makeUtcRounder, normaliseSlug, normaliseTrackingId, normalizeAirdropAmount, parseCloid, setHip3DexAbstraction, stableQuoteTokens };
+// lib/abstraction/types.ts
+var ABSTRACTION_MODE_TO_AGENT_CODE = {
+  disabled: "i",
+  unifiedAccount: "u",
+  portfolioMargin: "p"
+};
+var AGENT_CODE_TO_ABSTRACTION_MODE = {
+  i: "disabled",
+  u: "unifiedAccount",
+  p: "portfolioMargin"
+};
+var UserSetAbstractionTypes = {
+  "HyperliquidTransaction:UserSetAbstraction": [
+    { name: "hyperliquidChain", type: "string" },
+    { name: "user", type: "address" },
+    { name: "abstraction", type: "string" },
+    { name: "nonce", type: "uint64" }
+  ]
+};
+async function getUserAbstraction(client, user) {
+  return await client.transport.request("info", {
+    type: "userAbstraction",
+    user
+  });
+}
+async function setUserAbstraction(client, abstraction, user) {
+  const nonce = Date.now();
+  const isTestnet = client.isTestnet;
+  const action = {
+    type: "userSetAbstraction",
+    hyperliquidChain: isTestnet ? "Testnet" : "Mainnet",
+    signatureChainId: isTestnet ? "0x66eee" : "0xa4b1",
+    user,
+    abstraction,
+    nonce
+  };
+  const signature = await signUserSignedAction({
+    wallet: client.wallet,
+    action,
+    types: UserSetAbstractionTypes
+  });
+  return await client.transport.request("exchange", {
+    action,
+    signature,
+    nonce: action.nonce
+  });
+}
+async function agentSetAbstraction(client, abstraction) {
+  const nonce = Date.now();
+  const code = ABSTRACTION_MODE_TO_AGENT_CODE[abstraction];
+  const action = {
+    type: "agentSetAbstraction",
+    abstraction: code
+  };
+  const signature = await signL1Action({
+    wallet: client.wallet,
+    action,
+    isTestnet: client.isTestnet,
+    nonce
+  });
+  return await client.transport.request("exchange", {
+    action,
+    signature,
+    nonce
+  });
+}
+
+// lib/abstraction/ratio.ts
+function computeUnifiedAccountRatio(multiverse, perpDexStates, spotBalances) {
+  const indexToCollateralToken = {};
+  for (const meta of Object.values(multiverse)) {
+    indexToCollateralToken[meta.index] = meta.collateralToken;
+  }
+  const crossMarginByToken = {};
+  const isolatedMarginByToken = {};
+  for (let index = 0; index < perpDexStates.length; index++) {
+    const dex = perpDexStates[index];
+    const token = indexToCollateralToken[index];
+    if (dex === void 0 || token === void 0) continue;
+    crossMarginByToken[token] = (crossMarginByToken[token] ?? 0) + dex.clearinghouseState.crossMaintenanceMarginUsed;
+    for (const ap of dex.clearinghouseState.assetPositions) {
+      if (ap.position.leverage.type === "isolated") {
+        isolatedMarginByToken[token] = (isolatedMarginByToken[token] ?? 0) + ap.position.marginUsed;
+      }
+    }
+  }
+  let maxRatio = 0;
+  for (const [tokenStr, crossMargin] of Object.entries(crossMarginByToken)) {
+    const token = Number(tokenStr);
+    const spotTotal = spotBalances.find((b) => b.token === token)?.total ?? 0;
+    const isolatedMargin = isolatedMarginByToken[token] ?? 0;
+    const available = spotTotal - isolatedMargin;
+    if (available > 0) {
+      maxRatio = Math.max(maxRatio, crossMargin / available);
+    }
+  }
+  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 };

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-DMVXX1Gw.mjs';
+import { A as AllPerpsMeta, I as InstrumentClient } from './client-BQzYwHDY.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-DMVXX1Gw.js';
+import { A as AllPerpsMeta, I as InstrumentClient } from './client-BQzYwHDY.js';
 
 interface InstrumentsProviderProps {
     spotMeta: SpotMeta;

package/index.ts

@@ -2,13 +2,16 @@ export * from "./lib/cloid/cloid";
 export * from "./lib/fee";
 export * from "./lib/pup";
 export * from "./lib/constants/tokens";
+export * from "./lib/constants/admin";
 export * from "./lib/meta/metadata";
 export * from "./lib/utils/formatter";
 export * from "./lib/utils/flooredDateTime";
 export * from "./lib/utils/time";
 export * from "./lib/hip3/utils";
 export * from "./lib/hip3/market-info";
+export * from "./lib/abstraction";
 export * from "./lib/instrument/client";
+export * from "./lib/types";
 
 // Ecommerce SDK
 export * from "./lib/ecommerce";

package/lib/abstraction/api.ts

@@ -0,0 +1,106 @@
+import {
+  ExchangeClient,
+  InfoClient,
+  SuccessResponse,
+} from "@nktkas/hyperliquid";
+import {
+  signL1Action,
+  signUserSignedAction,
+} from "@nktkas/hyperliquid/signing";
+import type {
+  UserAbstractionMode,
+  SettableAbstractionMode,
+  AgentAbstractionCode,
+} from "./types";
+import { ABSTRACTION_MODE_TO_AGENT_CODE } from "./types";
+
+export const UserSetAbstractionTypes = {
+  "HyperliquidTransaction:UserSetAbstraction": [
+    { name: "hyperliquidChain", type: "string" },
+    { name: "user", type: "address" },
+    { name: "abstraction", type: "string" },
+    { name: "nonce", type: "uint64" },
+  ],
+};
+
+/**
+ * Query a user's current account abstraction mode.
+ */
+export async function getUserAbstraction(
+  client: InfoClient,
+  user: string,
+): Promise<UserAbstractionMode> {
+  return await client.transport.request<UserAbstractionMode>("info", {
+    type: "userAbstraction",
+    user,
+  });
+}
+
+/**
+ * Set account abstraction mode using the owner wallet (user-signed action).
+ *
+ * Requires EIP-712 signature from the account owner.
+ */
+export async function setUserAbstraction(
+  client: ExchangeClient,
+  abstraction: SettableAbstractionMode,
+  user: string,
+): Promise<SuccessResponse> {
+  const nonce = Date.now();
+  const isTestnet = client.isTestnet;
+
+  const action = {
+    type: "userSetAbstraction" as const,
+    hyperliquidChain: isTestnet ? "Testnet" : ("Mainnet" as string),
+    signatureChainId: isTestnet
+      ? ("0x66eee" as `0x${string}`)
+      : ("0xa4b1" as `0x${string}`),
+    user,
+    abstraction,
+    nonce,
+  };
+
+  const signature = await signUserSignedAction({
+    wallet: client.wallet,
+    action,
+    types: UserSetAbstractionTypes,
+  });
+
+  return await client.transport.request<SuccessResponse>("exchange", {
+    action,
+    signature,
+    nonce: action.nonce,
+  });
+}
+
+/**
+ * Set account abstraction mode using an agent wallet.
+ *
+ * Uses shorthand codes: "i" (disabled), "u" (unifiedAccount), "p" (portfolioMargin).
+ */
+export async function agentSetAbstraction(
+  client: ExchangeClient,
+  abstraction: SettableAbstractionMode,
+): Promise<SuccessResponse> {
+  const nonce = Date.now();
+  const code: AgentAbstractionCode =
+    ABSTRACTION_MODE_TO_AGENT_CODE[abstraction];
+
+  const action = {
+    type: "agentSetAbstraction" as const,
+    abstraction: code,
+  };
+
+  const signature = await signL1Action({
+    wallet: client.wallet,
+    action,
+    isTestnet: client.isTestnet,
+    nonce,
+  });
+
+  return await client.transport.request<SuccessResponse>("exchange", {
+    action,
+    signature,
+    nonce,
+  });
+}

package/lib/abstraction/index.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./api";
+export * from "./ratio";