liquid-sdk 1.7.3 → 1.7.4

package/dist/index.d.ts

@@ -471,6 +471,9 @@ declare const ADDRESSES: {
 declare const EXTERNAL: {
     readonly POOL_MANAGER: Address;
     readonly WETH: Address;
+    /** DIEM — Liquid's intelligence-economy token. Also a pair token for
+     *  agent-token launches (see `createLiquidPositionsUSD`). */
+    readonly DIEM: Address;
     readonly UNIVERSAL_ROUTER: Address;
     readonly PERMIT2: Address;
 };
@@ -621,31 +624,7 @@ declare const DEFAULT_CHAIN: {
     formatters: {
         readonly block: {
             exclude: [] | undefined;
-            format: (args: viem_chains.OpStackRpcBlock, action
-            /**
-             * Pre-built position configurations.
-             *
-             * - **Standard**: Single position covering full range (~$20K → $1.5B).
-             *   Default starting tick -230400 (≈10 ETH market cap).
-             *
-             * - **Liquid**: 3-tranche default for Liquid Protocol.
-             *   Hardcoded for ≈10 ETH start at ~$2070/ETH.
-             *   For dynamic market cap targets, use `createPositionsUSD()` instead.
-             *
-             * Note: positionBps must sum to 10,000 (100%).
-             */
-            ? /**
-             * Pre-built position configurations.
-             *
-             * - **Standard**: Single position covering full range (~$20K → $1.5B).
-             *   Default starting tick -230400 (≈10 ETH market cap).
-             *
-             * - **Liquid**: 3-tranche default for Liquid Protocol.
-             *   Hardcoded for ≈10 ETH start at ~$2070/ETH.
-             *   For dynamic market cap targets, use `createPositionsUSD()` instead.
-             *
-             * Note: positionBps must sum to 10,000 (100%).
-             */: string | undefined) => {
+            format: (args: viem_chains.OpStackRpcBlock, action?: string | undefined) => {
                 baseFeePerGas: bigint | null;
                 blobGasUsed: bigint;
                 difficulty: bigint;
@@ -2323,6 +2302,7 @@ declare function getTickFromMarketCapStable(marketCap: number, stableDecimals: n
  * market cap milestones. Percentages represent share of the *pool supply*
  * (i.e. after dev buy, airdrop, and vault allocations are deducted).
  */
+
 interface MarketCapTranche {
     /** Upper bound market cap in ETH for this tranche */
     upperMarketCapETH: number;
@@ -2418,6 +2398,55 @@ declare function createPositionsUSD(startingMarketCapUSD: number, ethPriceUSD: n
 declare function createDefaultPositions(startingMarketCapUSD: number, ethPriceUSD: number, tickSpacing?: number): PositionArrays & {
     tickIfToken0IsLiquid: number;
 };
+/**
+ * Shift every tick in a position layout by a fixed amount, preserving the
+ * positionBps splits. The primitive behind `createLiquidPositionsUSD` — it
+ * re-anchors a fixed-shape layout (e.g. `POOL_POSITIONS.Liquid`) to a
+ * different starting tick.
+ *
+ * `shiftBy` should be a multiple of the pool's tick spacing so the shifted
+ * ticks stay aligned. A difference of two aligned ticks is always aligned,
+ * so deriving it as `targetTick - sourceBottomTick` is safe.
+ *
+ * @param positions - Source positions (e.g. `POOL_POSITIONS.Liquid`)
+ * @param shiftBy - Ticks to add to every tickLower/tickUpper (may be negative)
+ * @returns A fresh array — the source is not mutated
+ */
+declare function shiftPositions(positions: readonly PoolPosition[], shiftBy: number): PoolPosition[];
+/**
+ * Build the canonical 5-position "Liquid" layout (10/50/15/20/5) re-anchored
+ * to a starting market cap, denominated in the *paired token's* USD price.
+ *
+ * Works for any pair token — pass the price of whatever the pool is paired
+ * against:
+ *   - WETH-paired: `createLiquidPositionsUSD(20_000, ethPriceUSD)`
+ *   - DIEM-paired: `createLiquidPositionsUSD(20_000, diemPriceUSD)`
+ *
+ * Unlike `createDefaultPositions` (a 3-tranche layout), this preserves the
+ * exact shape of `POOL_POSITIONS.Liquid` — the same curve `deployToken()`
+ * uses by default — just shifted so its bottom sits at the requested start.
+ *
+ * @param startingMarketCapUSD - Initial market cap in USD
+ * @param pairedTokenPriceUSD - USD price of the token the pool is paired against
+ * @param tickSpacing - Tick spacing (default 200)
+ * @returns Position arrays + `tickIfToken0IsLiquid`, ready to spread into `deployToken()`
+ *
+ * @example
+ * ```ts
+ * import { LiquidSDK, EXTERNAL, createLiquidPositionsUSD } from "liquid-sdk";
+ *
+ * const positions = createLiquidPositionsUSD(20_000, diemPriceUSD);
+ * await sdk.deployToken({
+ *   name: "Agent Token",
+ *   symbol: "AGENT",
+ *   pairedToken: EXTERNAL.DIEM,
+ *   ...positions,
+ * });
+ * ```
+ */
+declare function createLiquidPositionsUSD(startingMarketCapUSD: number, pairedTokenPriceUSD: number, tickSpacing?: number): PositionArrays & {
+    tickIfToken0IsLiquid: number;
+};
 /**
  * Describe positions as human-readable market cap ranges.
  * Useful for displaying position info in UIs.
@@ -2595,4 +2624,4 @@ declare function parseContext(contextString: string): LiquidContext | null;
  */
 declare function parseMetadata(metadataString: string): LiquidMetadata | null;
 
-export { ADDRESSES, type AirdropExtensionParams, type AirdropInfo, type BidInAuctionParams, type BidInAuctionResult, DEFAULTS, DEFAULT_CHAIN, DEFAULT_CHAIN_ID, DEFAULT_RPC_URL, DEFAULT_TRANCHES_USD, type DeployTokenParams, type DeployTokenResult, type DeploymentConfig, type DeploymentInfo, type DevBuyParams, type DynamicFeeConfig, ERC20Abi, EXTERNAL, type ExtensionConfig, FEE, FeePreference, type GetTokensOptions, LiquidAirdropV2Abi, type LiquidContext, LiquidFactoryAbi, LiquidFeeLockerAbi, LiquidHookDynamicFeeV2Abi, LiquidLpLockerAbi, type LiquidMetadata, LiquidMevBlockDelayAbi, LiquidMevDescendingFeesAbi, LiquidPoolExtensionAllowlistAbi, LiquidSDK, type LiquidSDKConfig, LiquidSniperAuctionV2Abi, LiquidSniperUtilV2Abi, LiquidTokenAbi, LiquidUniv4EthDevBuyAbi, LiquidVaultAbi, type LockerConfig, type MarketCapTranche, type MarketCapTrancheUSD, type MevModuleConfig, POOL_POSITIONS, type PoolConfig, type PoolDynamicConfigVars, type PoolDynamicFeeVars, type PoolKey, type PoolPosition, type PositionArrays, type PositionConfig, type SniperAuctionConfig, type SniperAuctionFeeConfig, type SniperAuctionState, type SocialMediaUrl, TOKEN, type TokenConfig, type TokenCreatedEvent, type TokenRewardInfo, type VaultAllocation, type VaultExtensionParams, buildContext, buildMetadata, createDefaultPositions, createPositions, createPositionsUSD, describePositions, encodeDynamicFeePoolData, encodeFeeConversionLockerData, encodeSniperAuctionData, encodeStaticFeePoolData, getTickFromMarketCapETH, getTickFromMarketCapStable, getTickFromMarketCapUSD, marketCapFromTickETH, marketCapFromTickUSD, parseContext, parseMetadata };
+export { ADDRESSES, type AirdropExtensionParams, type AirdropInfo, type BidInAuctionParams, type BidInAuctionResult, DEFAULTS, DEFAULT_CHAIN, DEFAULT_CHAIN_ID, DEFAULT_RPC_URL, DEFAULT_TRANCHES_USD, type DeployTokenParams, type DeployTokenResult, type DeploymentConfig, type DeploymentInfo, type DevBuyParams, type DynamicFeeConfig, ERC20Abi, EXTERNAL, type ExtensionConfig, FEE, FeePreference, type GetTokensOptions, LiquidAirdropV2Abi, type LiquidContext, LiquidFactoryAbi, LiquidFeeLockerAbi, LiquidHookDynamicFeeV2Abi, LiquidLpLockerAbi, type LiquidMetadata, LiquidMevBlockDelayAbi, LiquidMevDescendingFeesAbi, LiquidPoolExtensionAllowlistAbi, LiquidSDK, type LiquidSDKConfig, LiquidSniperAuctionV2Abi, LiquidSniperUtilV2Abi, LiquidTokenAbi, LiquidUniv4EthDevBuyAbi, LiquidVaultAbi, type LockerConfig, type MarketCapTranche, type MarketCapTrancheUSD, type MevModuleConfig, POOL_POSITIONS, type PoolConfig, type PoolDynamicConfigVars, type PoolDynamicFeeVars, type PoolKey, type PoolPosition, type PositionArrays, type PositionConfig, type SniperAuctionConfig, type SniperAuctionFeeConfig, type SniperAuctionState, type SocialMediaUrl, TOKEN, type TokenConfig, type TokenCreatedEvent, type TokenRewardInfo, type VaultAllocation, type VaultExtensionParams, buildContext, buildMetadata, createDefaultPositions, createLiquidPositionsUSD, createPositions, createPositionsUSD, describePositions, encodeDynamicFeePoolData, encodeFeeConversionLockerData, encodeSniperAuctionData, encodeStaticFeePoolData, getTickFromMarketCapETH, getTickFromMarketCapStable, getTickFromMarketCapUSD, marketCapFromTickETH, marketCapFromTickUSD, parseContext, parseMetadata, shiftPositions };

package/dist/index.js

@@ -49,6 +49,7 @@ __export(index_exports, {
   buildContext: () => buildContext,
   buildMetadata: () => buildMetadata,
   createDefaultPositions: () => createDefaultPositions,
+  createLiquidPositionsUSD: () => createLiquidPositionsUSD,
   createPositions: () => createPositions,
   createPositionsUSD: () => createPositionsUSD,
   describePositions: () => describePositions,
@@ -62,7 +63,8 @@ __export(index_exports, {
   marketCapFromTickETH: () => marketCapFromTickETH,
   marketCapFromTickUSD: () => marketCapFromTickUSD,
   parseContext: () => parseContext,
-  parseMetadata: () => parseMetadata
+  parseMetadata: () => parseMetadata,
+  shiftPositions: () => shiftPositions
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -92,6 +94,9 @@ var ADDRESSES = {
 var EXTERNAL = {
   POOL_MANAGER: "0x498581fF718922c3f8e6A244956aF099B2652b2b",
   WETH: "0x4200000000000000000000000000000000000006",
+  /** DIEM — Liquid's intelligence-economy token. Also a pair token for
+   *  agent-token launches (see `createLiquidPositionsUSD`). */
+  DIEM: "0xF4d97F2da56e8c3098f3a8D538DB630A2606a024",
   UNIVERSAL_ROUTER: "0x6fF5693b99212Da76ad316178A184AB56D299b43",
   PERMIT2: "0x000000000022D473030F116dDEE9F6B43aC78BA3"
 };
@@ -1443,7 +1448,16 @@ var LiquidSDK = class {
         account: this.walletClient.account
       });
       gas = estimated * 120n / 100n;
-    } catch {
+    } catch (err) {
+      const e = err;
+      const looksLikeRevert = e?.name === "ContractFunctionExecutionError" || e?.name === "CallExecutionError" || typeof e?.shortMessage === "string" && /reverted|revert reason|execution reverted/i.test(e.shortMessage);
+      if (looksLikeRevert) throw err;
+      if (typeof console !== "undefined" && console.warn) {
+        console.warn(
+          "[liquid-sdk] deployToken gas estimation failed; falling back to 6M gas limit:",
+          e?.shortMessage ?? err
+        );
+      }
       gas = 6000000n;
     }
     const txHash = await this.walletClient.writeContract({
@@ -2437,6 +2451,33 @@ function createDefaultPositions(startingMarketCapUSD, ethPriceUSD, tickSpacing =
     tickIfToken0IsLiquid: positions.tickLower[0]
   };
 }
+function shiftPositions(positions, shiftBy) {
+  return positions.map((p) => ({
+    tickLower: p.tickLower + shiftBy,
+    tickUpper: p.tickUpper + shiftBy,
+    positionBps: p.positionBps
+  }));
+}
+function createLiquidPositionsUSD(startingMarketCapUSD, pairedTokenPriceUSD, tickSpacing = 200) {
+  if (pairedTokenPriceUSD <= 0) {
+    throw new Error("pairedTokenPriceUSD must be positive");
+  }
+  const startingTick = getTickFromMarketCapUSD(
+    startingMarketCapUSD,
+    pairedTokenPriceUSD,
+    tickSpacing
+  );
+  const shifted = shiftPositions(
+    POOL_POSITIONS.Liquid,
+    startingTick - DEFAULTS.TICK_IF_TOKEN0_IS_LIQUID
+  );
+  return {
+    tickLower: shifted.map((p) => p.tickLower),
+    tickUpper: shifted.map((p) => p.tickUpper),
+    positionBps: shifted.map((p) => p.positionBps),
+    tickIfToken0IsLiquid: startingTick
+  };
+}
 function describePositions(positions, ethPriceUSD) {
   return positions.tickLower.map((_, i) => {
     const lowerETH = Math.pow(1.0001, positions.tickLower[i]) * 1e11;
@@ -2486,6 +2527,7 @@ function describePositions(positions, ethPriceUSD) {
   buildContext,
   buildMetadata,
   createDefaultPositions,
+  createLiquidPositionsUSD,
   createPositions,
   createPositionsUSD,
   describePositions,
@@ -2499,6 +2541,7 @@ function describePositions(positions, ethPriceUSD) {
   marketCapFromTickETH,
   marketCapFromTickUSD,
   parseContext,
-  parseMetadata
+  parseMetadata,
+  shiftPositions
 });
 //# sourceMappingURL=index.js.map