@vultisig/core-chain 1.1.0 → 1.2.0

package/dist/chains/cosmos/thor/lp/math.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Minimal pool state required for LP math. All values are base-unit
+ * strings at THORChain's fixed 1e8 precision — these are the shapes
+ * returned by thornode `/thorchain/pool/{asset}` (`balance_asset`,
+ * `balance_rune`, `pool_units`).
+ */
+export type PoolState = {
+    assetDepth: string;
+    runeDepth: string;
+    poolUnits: string;
+};
+/**
+ * Calculate the liquidity units earned for a deposit.
+ *
+ * Formula: `units = P * (R*a + r*A) / (2 * R * A)`
+ *
+ *   P = current pool units
+ *   r = RUNE deposited (base units)
+ *   a = asset deposited (base units)
+ *   R = current pool RUNE depth
+ *   A = current pool asset depth
+ *
+ * Source: docs.thorchain.org continuous-liquidity-pools.md and the
+ * THORChain dev handbook. Implemented from the canonical formula, not
+ * copied from any third-party codebase. The on-chain handler multiplies
+ * by a slip-adjustment term (`1 - |rA - aR| / (rA + aR)`) before minting
+ * the final units; this helper intentionally omits that adjustment so UIs
+ * can show a quick estimate. For asymmetric adds the simplified number
+ * can diverge a few percent from mainnet — note that in UX copy if you
+ * display it directly.
+ *
+ * For an asymmetric deposit either `r` or `a` is zero — the formula still
+ * holds (the internal 50/50 rebalancing happens on-chain and is reflected
+ * in the returned units via the pool's existing depth ratio).
+ *
+ * All inputs / outputs are in 1e8 base units. Returns a non-negative
+ * BigInt-safe integer string.
+ */
+export declare const getLiquidityUnits: ({ pool, assetAmountBaseUnit, runeAmountBaseUnit, }: {
+    pool: PoolState;
+    assetAmountBaseUnit: string;
+    runeAmountBaseUnit: string;
+}) => string;
+/**
+ * Calculate the user's fractional share of a pool AFTER a deposit settles.
+ *
+ * Returns only the decimal share (`units / (poolUnits + units)`). The
+ * rune/asset base-unit shares are NOT computed here because the correct
+ * values depend on the post-deposit pool depths, which this helper does
+ * not take as inputs. For those values, use `estimateLpAdd` which has
+ * the full pool state and deposit amounts.
+ *
+ * For display only — the on-chain accounting uses the units directly.
+ */
+export declare const getPoolShare: ({ pool, liquidityUnits, }: {
+    pool: PoolState;
+    liquidityUnits: string;
+}) => {
+    poolShareDecimal: string;
+};
+export type SlippageResult = {
+    /**
+     * Slippage as a decimal string, e.g. `"0.0032"` = 0.32%. Always
+     * non-negative. Zero for symmetric deposits (balanced r/a against R/A).
+     */
+    decimalPercent: string;
+    /**
+     * Slippage expressed in RUNE base units, for display. For asym-asset
+     * deposits this is the RUNE-equivalent of the lost value.
+     */
+    slippageInRuneBaseUnit: string;
+};
+/**
+ * Calculate slippage for an LP add.
+ *
+ * Formula: `slip = |R*a - A*r| / (A*r + R*A)`
+ *
+ * This is the asym-rebalancing slip cost: when only one side is deposited,
+ * THORChain internally performs a 50/50 swap to balance the pool, and
+ * that swap incurs a slip cost proportional to how imbalanced the input
+ * is against the existing depth.
+ *
+ * For symmetric deposits (r/a ratio matches R/A), the numerator is zero
+ * and the slippage is exactly zero.
+ *
+ * Source: derived from the THORChain asymmetric-deposit-as-swap
+ * documentation. Cross-checked against the formula used by multiple
+ * independent implementations (iOS / extension don't compute this in
+ * their UI — they leave it to the chain).
+ */
+export declare const getLpAddSlippage: ({ pool, assetAmountBaseUnit, runeAmountBaseUnit, }: {
+    pool: PoolState;
+    assetAmountBaseUnit: string;
+    runeAmountBaseUnit: string;
+}) => SlippageResult;
+export type EstimateLpAddResult = {
+    liquidityUnits: string;
+    poolShareDecimal: string;
+    /**
+     * Estimated rune-denominated value of the user's pool share, using
+     * post-deposit (pre-internal-swap) pool depths. This is the amount
+     * they could expect to reclaim on a full withdraw if nothing else
+     * changed.
+     */
+    runeShareBaseUnit: string;
+    /** Estimated asset-denominated value of the user's pool share. */
+    assetShareBaseUnit: string;
+    slippageDecimal: string;
+    slippageRuneBaseUnit: string;
+};
+/**
+ * One-shot estimator that chains pool-state fetch + the three math
+ * helpers. Returns everything a UI needs to surface a quote before the
+ * user signs.
+ *
+ * Fetches from thornode `/thorchain/pool/{asset}`. Injectable
+ * `fetchImpl` for tests.
+ */
+export declare const estimateLpAdd: ({ pool, assetAmountBaseUnit, runeAmountBaseUnit, thornodeBaseUrl, }: {
+    pool: string;
+    assetAmountBaseUnit: string;
+    runeAmountBaseUnit: string;
+    /**
+     * Override for the thornode base URL. Defaults to the shared
+     * `cosmosRpcUrl[Chain.THORChain]` used by the rest of the lp module.
+     */
+    thornodeBaseUrl?: string;
+}) => Promise<EstimateLpAddResult>;
+//# sourceMappingURL=math.d.ts.map

package/dist/chains/cosmos/thor/lp/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/math.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAyBD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,iBAAiB,GAAI,oDAI/B;IACD,IAAI,EAAE,SAAS,CAAA;IACf,mBAAmB,EAAE,MAAM,CAAA;IAC3B,kBAAkB,EAAE,MAAM,CAAA;CAC3B,KAAG,MAkBH,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,GAAI,2BAG1B;IACD,IAAI,EAAE,SAAS,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;CACvB,KAAG;IACF,gBAAgB,EAAE,MAAM,CAAA;CAsBzB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,sBAAsB,EAAE,MAAM,CAAA;CAC/B,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB,GAAI,oDAI9B;IACD,IAAI,EAAE,SAAS,CAAA;IACf,mBAAmB,EAAE,MAAM,CAAA;IAC3B,kBAAkB,EAAE,MAAM,CAAA;CAC3B,KAAG,cAqDH,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB;;;;;OAKG;IACH,iBAAiB,EAAE,MAAM,CAAA;IACzB,kEAAkE;IAClE,kBAAkB,EAAE,MAAM,CAAA;IAC1B,eAAe,EAAE,MAAM,CAAA;IACvB,oBAAoB,EAAE,MAAM,CAAA;CAC7B,CAAA;AASD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAU,qEAKjC;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,mBAAmB,EAAE,MAAM,CAAA;IAC3B,kBAAkB,EAAE,MAAM,CAAA;IAC1B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,KAAG,OAAO,CAAC,mBAAmB,CAyE9B,CAAA"}

package/dist/chains/cosmos/thor/lp/math.js

@@ -0,0 +1,227 @@
+import { Chain } from '@vultisig/core-chain/Chain';
+import { cosmosRpcUrl } from '@vultisig/core-chain/chains/cosmos/cosmosRpcUrl';
+import { queryUrl } from '@vultisig/lib-utils/query/queryUrl';
+import { assertValidPoolId } from './pools.js';
+/**
+ * Assert a numeric input is a non-negative base-unit integer string.
+ *
+ * Public math helpers consume untrusted strings (LLM tool args, API
+ * responses). Raw `BigInt('abc')` throws `SyntaxError: Cannot convert
+ * abc to a BigInt`, which is an unhelpful error for callers and hides
+ * the field name. This validator produces stable SDK-level errors
+ * instead.
+ */
+const assertBaseUnitString = (value, fieldName) => {
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new Error(`${fieldName} must be a non-empty base-unit string, got ${typeof value === 'string' ? JSON.stringify(value) : typeof value}`);
+    }
+    if (!/^\d+$/.test(value)) {
+        throw new Error(`${fieldName} must be a non-negative integer base-unit string, got ${JSON.stringify(value)}`);
+    }
+    return BigInt(value);
+};
+/**
+ * Calculate the liquidity units earned for a deposit.
+ *
+ * Formula: `units = P * (R*a + r*A) / (2 * R * A)`
+ *
+ *   P = current pool units
+ *   r = RUNE deposited (base units)
+ *   a = asset deposited (base units)
+ *   R = current pool RUNE depth
+ *   A = current pool asset depth
+ *
+ * Source: docs.thorchain.org continuous-liquidity-pools.md and the
+ * THORChain dev handbook. Implemented from the canonical formula, not
+ * copied from any third-party codebase. The on-chain handler multiplies
+ * by a slip-adjustment term (`1 - |rA - aR| / (rA + aR)`) before minting
+ * the final units; this helper intentionally omits that adjustment so UIs
+ * can show a quick estimate. For asymmetric adds the simplified number
+ * can diverge a few percent from mainnet — note that in UX copy if you
+ * display it directly.
+ *
+ * For an asymmetric deposit either `r` or `a` is zero — the formula still
+ * holds (the internal 50/50 rebalancing happens on-chain and is reflected
+ * in the returned units via the pool's existing depth ratio).
+ *
+ * All inputs / outputs are in 1e8 base units. Returns a non-negative
+ * BigInt-safe integer string.
+ */
+export const getLiquidityUnits = ({ pool, assetAmountBaseUnit, runeAmountBaseUnit, }) => {
+    const P = assertBaseUnitString(pool.poolUnits, 'pool.poolUnits');
+    const R = assertBaseUnitString(pool.runeDepth, 'pool.runeDepth');
+    const A = assertBaseUnitString(pool.assetDepth, 'pool.assetDepth');
+    const r = assertBaseUnitString(runeAmountBaseUnit, 'runeAmountBaseUnit');
+    const a = assertBaseUnitString(assetAmountBaseUnit, 'assetAmountBaseUnit');
+    if (R === 0n || A === 0n || P === 0n) {
+        // Empty / just-initialized pool — the first-deposit case is handled
+        // differently on-chain (the depositor mints the full initial unit
+        // supply). We can't model that here without knowing the genesis
+        // unit scale, so return 0 and let the caller decide what to do.
+        return '0';
+    }
+    const numerator = P * (R * a + r * A);
+    const denominator = 2n * R * A;
+    return (numerator / denominator).toString();
+};
+/**
+ * Calculate the user's fractional share of a pool AFTER a deposit settles.
+ *
+ * Returns only the decimal share (`units / (poolUnits + units)`). The
+ * rune/asset base-unit shares are NOT computed here because the correct
+ * values depend on the post-deposit pool depths, which this helper does
+ * not take as inputs. For those values, use `estimateLpAdd` which has
+ * the full pool state and deposit amounts.
+ *
+ * For display only — the on-chain accounting uses the units directly.
+ */
+export const getPoolShare = ({ pool, liquidityUnits, }) => {
+    const P = assertBaseUnitString(pool.poolUnits, 'pool.poolUnits');
+    const L = assertBaseUnitString(liquidityUnits, 'liquidityUnits');
+    if (P === 0n || L === 0n) {
+        return { poolShareDecimal: '0' };
+    }
+    const totalAfter = P + L;
+    // Decimal share with 18-digit precision as a string (no floats).
+    // We multiply by 1e18, divide, then format as "0.xxx".
+    const SCALE = 10n ** 18n;
+    const scaled = (L * SCALE) / totalAfter;
+    const decimal = scaled.toString().padStart(19, '0'); // at least 18 fractional digits
+    const intPart = decimal.slice(0, -18) || '0';
+    const fracPart = decimal.slice(-18).replace(/0+$/, '');
+    return {
+        poolShareDecimal: fracPart.length > 0 ? `${intPart}.${fracPart}` : intPart,
+    };
+};
+/**
+ * Calculate slippage for an LP add.
+ *
+ * Formula: `slip = |R*a - A*r| / (A*r + R*A)`
+ *
+ * This is the asym-rebalancing slip cost: when only one side is deposited,
+ * THORChain internally performs a 50/50 swap to balance the pool, and
+ * that swap incurs a slip cost proportional to how imbalanced the input
+ * is against the existing depth.
+ *
+ * For symmetric deposits (r/a ratio matches R/A), the numerator is zero
+ * and the slippage is exactly zero.
+ *
+ * Source: derived from the THORChain asymmetric-deposit-as-swap
+ * documentation. Cross-checked against the formula used by multiple
+ * independent implementations (iOS / extension don't compute this in
+ * their UI — they leave it to the chain).
+ */
+export const getLpAddSlippage = ({ pool, assetAmountBaseUnit, runeAmountBaseUnit, }) => {
+    const R = assertBaseUnitString(pool.runeDepth, 'pool.runeDepth');
+    const A = assertBaseUnitString(pool.assetDepth, 'pool.assetDepth');
+    const r = assertBaseUnitString(runeAmountBaseUnit, 'runeAmountBaseUnit');
+    const a = assertBaseUnitString(assetAmountBaseUnit, 'assetAmountBaseUnit');
+    if (R === 0n || A === 0n) {
+        return { decimalPercent: '0', slippageInRuneBaseUnit: '0' };
+    }
+    // |R*a - A*r| / (A*r + R*A)
+    const ra = R * a;
+    const ar = A * r;
+    const numerator = ra > ar ? ra - ar : ar - ra;
+    const denominator = A * r + R * A;
+    if (denominator === 0n) {
+        return { decimalPercent: '0', slippageInRuneBaseUnit: '0' };
+    }
+    // Express as decimal with 18-digit precision
+    const SCALE = 10n ** 18n;
+    const scaled = (numerator * SCALE) / denominator;
+    const decimal = scaled.toString().padStart(19, '0');
+    const intPart = decimal.slice(0, -18) || '0';
+    const fracPart = decimal.slice(-18).replace(/0+$/, '');
+    const decimalPercent = fracPart.length > 0 ? `${intPart}.${fracPart}` : intPart;
+    // Convert to rune-equivalent for display. The slip applies only to the
+    // imbalanced portion of the deposit — the part that has to be swapped
+    // internally to balance the pool. We compute the imbalance in rune
+    // terms: |R*a - A*r| / (2*A), then apply the slip fraction to it.
+    //
+    // For pure asym RUNE (a=0): imbalance = R*0 - A*r divided by 2*A, abs
+    //   → r/2 (half the deposit gets swapped) → slippageInRune ≈ (r/2) * slip
+    // For pure asym asset (r=0): imbalance = (R*a) / (2*A), the rune-value
+    //   of half the deposit → slippageInRune ≈ (a*R / (2*A)) * slip
+    // For balanced deposit: imbalance = 0 → slippageInRune = 0
+    //
+    // This is a heuristic display value, not an exact chain computation.
+    // It under/overstates real on-chain slip by a constant factor in some
+    // regimes but is directionally correct and never overstates by orders
+    // of magnitude the way "slip * total deposit value" did.
+    const imbalanceNumerator = ra > ar ? ra - ar : ar - ra;
+    const imbalanceInRune = A === 0n ? 0n : imbalanceNumerator / (2n * A);
+    const slippageInRune = (imbalanceInRune * scaled) / SCALE;
+    return {
+        decimalPercent,
+        slippageInRuneBaseUnit: slippageInRune.toString(),
+    };
+};
+/**
+ * One-shot estimator that chains pool-state fetch + the three math
+ * helpers. Returns everything a UI needs to surface a quote before the
+ * user signs.
+ *
+ * Fetches from thornode `/thorchain/pool/{asset}`. Injectable
+ * `fetchImpl` for tests.
+ */
+export const estimateLpAdd = async ({ pool, assetAmountBaseUnit, runeAmountBaseUnit, thornodeBaseUrl, }) => {
+    assertValidPoolId(pool);
+    const base = thornodeBaseUrl ?? cosmosRpcUrl[Chain.THORChain];
+    const url = `${base}/thorchain/pool/${encodeURIComponent(pool)}`;
+    const raw = await queryUrl(url);
+    if (!raw ||
+        typeof raw !== 'object' ||
+        typeof raw.balance_asset !== 'string' ||
+        typeof raw.balance_rune !== 'string') {
+        throw new Error(`estimateLpAdd: pool ${pool} response from ${url} missing balance fields`);
+    }
+    const poolUnitsRaw = raw.pool_units ?? raw.LP_units;
+    if (typeof poolUnitsRaw !== 'string' || poolUnitsRaw.length === 0) {
+        throw new Error(`estimateLpAdd: pool ${pool} response from ${url} missing pool_units / LP_units`);
+    }
+    const poolState = {
+        assetDepth: raw.balance_asset,
+        runeDepth: raw.balance_rune,
+        poolUnits: poolUnitsRaw,
+    };
+    const liquidityUnits = getLiquidityUnits({
+        pool: poolState,
+        assetAmountBaseUnit,
+        runeAmountBaseUnit,
+    });
+    const share = getPoolShare({
+        pool: poolState,
+        liquidityUnits,
+    });
+    const slip = getLpAddSlippage({
+        pool: poolState,
+        assetAmountBaseUnit,
+        runeAmountBaseUnit,
+    });
+    // Compute post-deposit base-unit shares from the caller's deposit
+    // amounts. This is the correct frame for display ("you'll own X RUNE +
+    // Y asset's worth"). Uses post-deposit depths R+r and A+a, which is
+    // the pre-internal-swap state — close enough for display purposes and
+    // doesn't require simulating the chain's internal rebalancing swap.
+    const R = BigInt(poolState.runeDepth);
+    const A = BigInt(poolState.assetDepth);
+    const P = BigInt(poolState.poolUnits);
+    const r = BigInt(runeAmountBaseUnit);
+    const a = BigInt(assetAmountBaseUnit);
+    const L = BigInt(liquidityUnits);
+    const totalAfter = P + L;
+    const runeDepthAfter = R + r;
+    const assetDepthAfter = A + a;
+    const runeShareBaseUnit = totalAfter === 0n ? '0' : ((runeDepthAfter * L) / totalAfter).toString();
+    const assetShareBaseUnit = totalAfter === 0n ? '0' : ((assetDepthAfter * L) / totalAfter).toString();
+    return {
+        liquidityUnits,
+        poolShareDecimal: share.poolShareDecimal,
+        runeShareBaseUnit,
+        assetShareBaseUnit,
+        slippageDecimal: slip.decimalPercent,
+        slippageRuneBaseUnit: slip.slippageInRuneBaseUnit,
+    };
+};
+//# sourceMappingURL=math.js.map

package/dist/chains/cosmos/thor/lp/math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/math.ts"],"names":[],"mappings":"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"}

package/dist/chains/cosmos/thor/lp/memberPool.d.ts

@@ -0,0 +1,4 @@
+import type { RawMemberPool, ThorchainLpPosition } from './types.js';
+export declare const isNonZeroBaseUnit: (value: string | undefined) => boolean;
+export declare const normalizeMemberPool: (raw: RawMemberPool) => ThorchainLpPosition;
+//# sourceMappingURL=memberPool.d.ts.map

package/dist/chains/cosmos/thor/lp/memberPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memberPool.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/memberPool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAEjE,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,GAAG,SAAS,KAAG,OAO7D,CAAA;AAED,eAAO,MAAM,mBAAmB,GAC9B,KAAK,aAAa,KACjB,mBAaD,CAAA"}

package/dist/chains/cosmos/thor/lp/memberPool.js

@@ -0,0 +1,24 @@
+export const isNonZeroBaseUnit = (value) => {
+    if (!value)
+        return false;
+    try {
+        return BigInt(value) > 0n;
+    }
+    catch {
+        return false;
+    }
+};
+export const normalizeMemberPool = (raw) => ({
+    pool: raw.pool ?? '',
+    liquidityUnits: raw.liquidityUnits ?? '0',
+    runeAdded: raw.runeAdded ?? '0',
+    assetAdded: raw.assetAdded ?? '0',
+    runePending: raw.runePending ?? '0',
+    assetPending: raw.assetPending ?? '0',
+    runeAddress: raw.runeAddress ?? '',
+    assetAddress: raw.assetAddress ?? '',
+    dateLastAdded: raw.dateLastAdded ?? '0',
+    lastAddHeight: '',
+    isPending: isNonZeroBaseUnit(raw.runePending) || isNonZeroBaseUnit(raw.assetPending),
+});
+//# sourceMappingURL=memberPool.js.map

package/dist/chains/cosmos/thor/lp/memberPool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memberPool.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/memberPool.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAyB,EAAW,EAAE;IACtE,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IACxB,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,GAAkB,EACG,EAAE,CAAC,CAAC;IACzB,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE;IACpB,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,GAAG;IACzC,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,GAAG;IAC/B,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,GAAG;IACjC,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,GAAG;IACnC,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,GAAG;IACrC,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE;IAClC,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,EAAE;IACpC,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,GAAG;IACvC,aAAa,EAAE,EAAE;IACjB,SAAS,EACP,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,iBAAiB,CAAC,GAAG,CAAC,YAAY,CAAC;CAC5E,CAAC,CAAA"}

package/dist/chains/cosmos/thor/lp/memo.d.ts

@@ -2,40 +2,61 @@ export type AddLpMemoInput = {
     /** Canonical pool id, e.g. `BTC.BTC` or `ETH.USDC-0X...`. */
     pool: string;
     /**
-     * Paired L1 address. Omit for asymmetric adds (the v1 path). When set,
-     * THORChain will hold the deposit pending and pair it with a matching
-     * deposit from the other side, producing a symmetric position.
+     * Paired L1 address. When set, THORChain registers the deposit with a
+     * counterpart address on the other side of the pool. The paired address
+     * is the vault's address on the OTHER chain relative to the side being
+     * deposited:
+     *
+     *   - For a RUNE-side add (depositing RUNE on THORChain), this is the
+     *     vault's L1 address on the pool's asset chain (e.g., BTC.BTC → the
+     *     vault's BTC address).
+     *   - For an asset-side add (depositing L1 asset), this is the vault's
+     *     THORChain address (`thor1...`).
+     *
+     * Matches the default behavior of vultisig-ios and vultisig-windows
+     * (the extension), which always auto-populate the paired address from
+     * the vault. Leave omitted for a pure asymmetric deposit with no
+     * paired-address registration.
      */
     pairedAddress?: string;
-    /** Affiliate THORName. Defaults to `VULTISIG_AFFILIATE_NAME`. */
-    affiliate?: string;
-    /** Affiliate fee in basis points. Defaults to `VULTISIG_AFFILIATE_LP_BPS`. */
-    affiliateBps?: number;
 };
 /**
  * Build a THORChain liquidity-pool add memo.
  *
- * Format: `+:POOL:PAIRED_ADDR:AFFILIATE:BPS`
+ * Format: `+:POOL` (pure asym, no paired address) or
+ *         `+:POOL:PAIRED_ADDR` (when paired address is provided)
  *
- * For an asymmetric RUNE-side add with the default Vultisig affiliate at
- * 0 bps the memo looks like `+:BTC.BTC::vi:0`. The empty paired-address slot
- * is intentional — that is what tells THORChain to register the position as
- * asymmetric.
+ * Matches vultisig-ios `AddLPMemoData.memo` and
+ * vultisig-windows `memoGenerator` `add_thor_lp` output exactly — no
+ * affiliate suffix. The THORChain memo spec allows an affiliate via
+ * `+:POOL::AFFILIATE:BPS` but neither Vultisig native client ships it;
+ * we match the native behavior for wire-level consistency.
  */
-export declare const addLpMemo: (input: AddLpMemoInput) => string;
+export declare const addLpMemo: ({ pool, pairedAddress, }: AddLpMemoInput) => string;
 export type RemoveLpMemoInput = {
     pool: string;
     /** Withdraw fraction in basis points: 1..10000 (10000 = 100%). */
     basisPoints: number;
+    /**
+     * Optional asymmetric-withdraw target. When set, THORChain sends the
+     * withdrawn value out to this side only (e.g., `withdrawToAsset: "BTC"`
+     * forces all output to BTC). When omitted, the protocol returns both
+     * sides proportionally for symmetric positions, or to the same side for
+     * asymmetric positions.
+     *
+     * Only the short asset ticker is used on the wire (e.g., `BTC`, not
+     * `BTC.BTC`). Pass the pool's ASSET section, not the full pool id.
+     */
+    withdrawToAsset?: string;
 };
 /**
  * Build a THORChain liquidity-pool remove memo.
  *
- * Format: `-:POOL:BPS`
+ * Format: `-:POOL:BPS` or `-:POOL:BPS:ASSET` when asym-withdraw target set.
  *
  * Withdraws do not include an affiliate suffix per the THORChain memo spec.
- * THORChain enforces a 1-hour lockup after the most recent add — broadcasting
- * a withdraw inside that window will fail at the chain level.
+ * THORChain enforces a ~1 hour window (`LIQUIDITYLOCKUPBLOCKS`, currently
+ * 600 on mainnet) after the most recent add before broadcasts process cleanly.
  */
-export declare const removeLpMemo: ({ pool, basisPoints, }: RemoveLpMemoInput) => string;
+export declare const removeLpMemo: ({ pool, basisPoints, withdrawToAsset, }: RemoveLpMemoInput) => string;
 //# sourceMappingURL=memo.d.ts.map

package/dist/chains/cosmos/thor/lp/memo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memo.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/memo.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,cAAc,GAAG;IAC3B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,cAAc,KAAG,MAMjD,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GAAI,wBAG1B,iBAAiB,KAAG,MAYtB,CAAA"}
+{"version":3,"file":"memo.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/memo.ts"],"names":[],"mappings":"AA4BA,MAAM,MAAM,cAAc,GAAG;IAC3B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;;;;;;;;;;;;OAgBG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,SAAS,GAAI,0BAGvB,cAAc,KAAG,MAOnB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAA;IACnB;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GAAI,yCAI1B,iBAAiB,KAAG,MAgBtB,CAAA"}

package/dist/chains/cosmos/thor/lp/memo.js

@@ -1,38 +1,62 @@
-import { VULTISIG_AFFILIATE_LP_BPS, VULTISIG_AFFILIATE_NAME, } from './affiliate.js';
 import { assertValidPoolId } from './pools.js';
+/**
+ * Reject memo-segment values that would smuggle additional `:`-separated
+ * fields into the memo (e.g. a pairedAddress like `bc1q:ss:60` that tries
+ * to inject an affiliate). Also rejects whitespace since THORChain memos
+ * are tokenized on `:` and trimmed/rejected when they contain internal
+ * whitespace.
+ */
+const assertMemoSegmentSafe = (value, fieldName) => {
+    if (typeof value !== 'string') {
+        throw new Error(`${fieldName} must be a string, got ${typeof value}`);
+    }
+    if (value.includes(':')) {
+        throw new Error(`${fieldName} must not contain \`:\` (would inject extra memo segments), got ${JSON.stringify(value)}`);
+    }
+    if (/\s/.test(value)) {
+        throw new Error(`${fieldName} must not contain whitespace, got ${JSON.stringify(value)}`);
+    }
+};
 /**
  * Build a THORChain liquidity-pool add memo.
  *
- * Format: `+:POOL:PAIRED_ADDR:AFFILIATE:BPS`
+ * Format: `+:POOL` (pure asym, no paired address) or
+ *         `+:POOL:PAIRED_ADDR` (when paired address is provided)
  *
- * For an asymmetric RUNE-side add with the default Vultisig affiliate at
- * 0 bps the memo looks like `+:BTC.BTC::vi:0`. The empty paired-address slot
- * is intentional — that is what tells THORChain to register the position as
- * asymmetric.
+ * Matches vultisig-ios `AddLPMemoData.memo` and
+ * vultisig-windows `memoGenerator` `add_thor_lp` output exactly — no
+ * affiliate suffix. The THORChain memo spec allows an affiliate via
+ * `+:POOL::AFFILIATE:BPS` but neither Vultisig native client ships it;
+ * we match the native behavior for wire-level consistency.
  */
-export const addLpMemo = (input) => {
-    assertValidPoolId(input.pool);
-    const affiliate = input.affiliate ?? VULTISIG_AFFILIATE_NAME;
-    const bps = input.affiliateBps ?? VULTISIG_AFFILIATE_LP_BPS;
-    const paired = input.pairedAddress ?? '';
-    return `+:${input.pool}:${paired}:${affiliate}:${bps}`;
+export const addLpMemo = ({ pool, pairedAddress, }) => {
+    assertValidPoolId(pool);
+    if (pairedAddress && pairedAddress.length > 0) {
+        assertMemoSegmentSafe(pairedAddress, 'pairedAddress');
+        return `+:${pool}:${pairedAddress}`;
+    }
+    return `+:${pool}`;
 };
 /**
  * Build a THORChain liquidity-pool remove memo.
  *
- * Format: `-:POOL:BPS`
+ * Format: `-:POOL:BPS` or `-:POOL:BPS:ASSET` when asym-withdraw target set.
  *
  * Withdraws do not include an affiliate suffix per the THORChain memo spec.
- * THORChain enforces a 1-hour lockup after the most recent add — broadcasting
- * a withdraw inside that window will fail at the chain level.
+ * THORChain enforces a ~1 hour window (`LIQUIDITYLOCKUPBLOCKS`, currently
+ * 600 on mainnet) after the most recent add before broadcasts process cleanly.
  */
-export const removeLpMemo = ({ pool, basisPoints, }) => {
+export const removeLpMemo = ({ pool, basisPoints, withdrawToAsset, }) => {
     assertValidPoolId(pool);
     if (!Number.isInteger(basisPoints) ||
         basisPoints < 1 ||
         basisPoints > 10000) {
         throw new Error(`removeLpMemo: basisPoints must be an integer in [1, 10000], got ${basisPoints}`);
     }
+    if (withdrawToAsset && withdrawToAsset.length > 0) {
+        assertMemoSegmentSafe(withdrawToAsset, 'withdrawToAsset');
+        return `-:${pool}:${basisPoints}:${withdrawToAsset}`;
+    }
     return `-:${pool}:${basisPoints}`;
 };
 //# sourceMappingURL=memo.js.map

package/dist/chains/cosmos/thor/lp/memo.js.map

@@ -1 +1 @@
-{"version":3,"file":"memo.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/memo.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAiB3C;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAqB,EAAU,EAAE;IACzD,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC7B,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,uBAAuB,CAAA;IAC5D,MAAM,GAAG,GAAG,KAAK,CAAC,YAAY,IAAI,yBAAyB,CAAA;IAC3D,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,IAAI,EAAE,CAAA;IACxC,OAAO,KAAK,KAAK,CAAC,IAAI,IAAI,MAAM,IAAI,SAAS,IAAI,GAAG,EAAE,CAAA;AACxD,CAAC,CAAA;AAQD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAC3B,IAAI,EACJ,WAAW,GACO,EAAU,EAAE;IAC9B,iBAAiB,CAAC,IAAI,CAAC,CAAA;IACvB,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC;QAC9B,WAAW,GAAG,CAAC;QACf,WAAW,GAAG,KAAK,EACnB,CAAC;QACD,MAAM,IAAI,KAAK,CACb,mEAAmE,WAAW,EAAE,CACjF,CAAA;IACH,CAAC;IACD,OAAO,KAAK,IAAI,IAAI,WAAW,EAAE,CAAA;AACnC,CAAC,CAAA"}
+{"version":3,"file":"memo.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/memo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAE3C;;;;;;GAMG;AACH,MAAM,qBAAqB,GAAG,CAC5B,KAAa,EACb,SAAiB,EACX,EAAE;IACR,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,0BAA0B,OAAO,KAAK,EAAE,CAAC,CAAA;IACvE,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,GAAG,SAAS,mEAAmE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CACvG,CAAA;IACH,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,GAAG,SAAS,qCAAqC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CACzE,CAAA;IACH,CAAC;AACH,CAAC,CAAA;AAyBD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EACxB,IAAI,EACJ,aAAa,GACE,EAAU,EAAE;IAC3B,iBAAiB,CAAC,IAAI,CAAC,CAAA;IACvB,IAAI,aAAa,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,qBAAqB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAA;QACrD,OAAO,KAAK,IAAI,IAAI,aAAa,EAAE,CAAA;IACrC,CAAC;IACD,OAAO,KAAK,IAAI,EAAE,CAAA;AACpB,CAAC,CAAA;AAmBD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAC3B,IAAI,EACJ,WAAW,EACX,eAAe,GACG,EAAU,EAAE;IAC9B,iBAAiB,CAAC,IAAI,CAAC,CAAA;IACvB,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC;QAC9B,WAAW,GAAG,CAAC;QACf,WAAW,GAAG,KAAK,EACnB,CAAC;QACD,MAAM,IAAI,KAAK,CACb,mEAAmE,WAAW,EAAE,CACjF,CAAA;IACH,CAAC;IACD,IAAI,eAAe,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,qBAAqB,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAA;QACzD,OAAO,KAAK,IAAI,IAAI,WAAW,IAAI,eAAe,EAAE,CAAA;IACtD,CAAC;IACD,OAAO,KAAK,IAAI,IAAI,WAAW,EAAE,CAAA;AACnC,CAAC,CAAA"}

package/dist/chains/cosmos/thor/lp/pairing.d.ts

@@ -0,0 +1,30 @@
+import { Chain } from '@vultisig/core-chain/Chain';
+export type VaultAddressMap = Partial<Record<Chain, string>>;
+export type LpSide = 'rune' | 'asset';
+/**
+ * Resolve the paired-address for an LP add based on which side of the
+ * pool the caller is depositing.
+ *
+ * - `side: 'rune'` (depositing RUNE on THORChain): returns the vault's L1
+ *   address on the pool's ASSET chain. E.g. `BTC.BTC` → vault's BTC
+ *   address.
+ * - `side: 'asset'` (depositing L1 asset): returns the vault's THORChain
+ *   address (`thor1...`).
+ *
+ * Matches vultisig-ios `FunctionCallAddThorLP.prefillPairedAddressForPool`
+ * and vultisig-windows (the extension) `ThorLpSpecific.tsx`
+ * behavior exactly — both always auto-populate the paired address when the
+ * vault has the required address, producing a symmetric-pending memo.
+ *
+ * Returns `undefined` when the vault map does not contain the required
+ * address. The caller decides whether to:
+ *   - fall back to a pure asymmetric deposit (`+:POOL` with no paired
+ *     address), or
+ *   - surface an error ("add the other chain to your vault first").
+ */
+export declare const resolvePairedAddressForLpAdd: ({ pool, side, vaultAddresses, }: {
+    pool: string;
+    side: LpSide;
+    vaultAddresses: VaultAddressMap;
+}) => string | undefined;
+//# sourceMappingURL=pairing.d.ts.map

package/dist/chains/cosmos/thor/lp/pairing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/pairing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAA;AAKlD,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;AAE5D,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAErC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,4BAA4B,GAAI,iCAI1C;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,cAAc,EAAE,eAAe,CAAA;CAChC,KAAG,MAAM,GAAG,SAmBZ,CAAA"}