@vultisig/core-chain 1.0.0 → 1.2.0

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

@@ -0,0 +1,62 @@
+export type AddLpMemoInput = {
+    /** Canonical pool id, e.g. `BTC.BTC` or `ETH.USDC-0X...`. */
+    pool: string;
+    /**
+     * 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;
+};
+/**
+ * Build a THORChain liquidity-pool add memo.
+ *
+ * Format: `+:POOL` (pure asym, no paired address) or
+ *         `+:POOL:PAIRED_ADDR` (when paired address is provided)
+ *
+ * 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: ({ 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` 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 window (`LIQUIDITYLOCKUPBLOCKS`, currently
+ * 600 on mainnet) after the most recent add before broadcasts process cleanly.
+ */
+export declare const removeLpMemo: ({ pool, basisPoints, withdrawToAsset, }: RemoveLpMemoInput) => string;
+//# sourceMappingURL=memo.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,62 @@
+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` (pure asym, no paired address) or
+ *         `+:POOL:PAIRED_ADDR` (when paired address is provided)
+ *
+ * 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 = ({ 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` 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 window (`LIQUIDITYLOCKUPBLOCKS`, currently
+ * 600 on mainnet) after the most recent add before broadcasts process cleanly.
+ */
+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

@@ -0,0 +1 @@
+{"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"}

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

@@ -0,0 +1,44 @@
+import { Chain } from '@vultisig/core-chain/Chain';
+import { chainPrefixToChain } from './lpChainMap.js';
+import { assertValidPoolId } from './pools.js';
+/**
+ * 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 const resolvePairedAddressForLpAdd = ({ pool, side, vaultAddresses, }) => {
+    assertValidPoolId(pool);
+    // Guard against unknown pool prefixes on BOTH sides — the pool id regex
+    // accepts `ZZZ.ABC` but `chainPrefixToChain` is the source of truth for
+    // THORChain-supported chains. If we can't resolve the prefix we refuse
+    // to auto-pair either way; the caller can still fall back to a pure
+    // asym memo if they want.
+    const [chainPrefix] = pool.split('.');
+    if (!chainPrefix)
+        return undefined;
+    const assetChain = chainPrefixToChain(chainPrefix);
+    if (!assetChain)
+        return undefined;
+    if (side === 'asset') {
+        return vaultAddresses[Chain.THORChain];
+    }
+    // side === 'rune' — need the vault's address on the pool's asset chain
+    return vaultAddresses[assetChain];
+};
+//# sourceMappingURL=pairing.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pairing.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/pairing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAA;AAElD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAM3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,EAC3C,IAAI,EACJ,IAAI,EACJ,cAAc,GAKf,EAAsB,EAAE;IACvB,iBAAiB,CAAC,IAAI,CAAC,CAAA;IAEvB,wEAAwE;IACxE,wEAAwE;IACxE,uEAAuE;IACvE,oEAAoE;IACpE,0BAA0B;IAC1B,MAAM,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACrC,IAAI,CAAC,WAAW;QAAE,OAAO,SAAS,CAAA;IAClC,MAAM,UAAU,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAA;IAClD,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAA;IAEjC,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,OAAO,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IACxC,CAAC;IAED,uEAAuE;IACvE,OAAO,cAAc,CAAC,UAAU,CAAC,CAAA;AACnC,CAAC,CAAA"}

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

@@ -0,0 +1,66 @@
+/**
+ * Flat unsigned-transaction payload for an asymmetric RUNE-side LP add.
+ *
+ * Shape stays single-nesting-level on purpose: this object flows through
+ * the agent backend's SSE `tx_ready` event, and the 2026-04-09 audit
+ * flagged tool result flattening as a known wire-level hazard for nested
+ * fields. Every consumer (MCP tool result, backend SSE emit, app
+ * `parseServerTx`) reads the same flat keys.
+ *
+ * v2 wire format drops the `affiliate` / `affiliateBps` fields. Matches
+ * vultisig-ios and vultisig-windows (the extension) — neither ships an
+ * affiliate on LP memos.
+ */
+export type ThorchainLpAddPayload = {
+    kind: 'thorchain_lp_add';
+    chain: 'THORChain';
+    denom: 'rune';
+    /** RUNE base units; 1 RUNE = 100000000 (8 decimals). */
+    amount: string;
+    /** Pre-built memo via `addLpMemo`. */
+    memo: string;
+    /** Canonical pool id, denormalized for display. */
+    pool: string;
+    /**
+     * Paired L1 address embedded in the memo, if any. Denormalized for
+     * display so consumers don't have to re-parse the memo.
+     */
+    pairedAddress?: string;
+};
+export type ThorchainLpRemovePayload = {
+    kind: 'thorchain_lp_remove';
+    chain: 'THORChain';
+    denom: 'rune';
+    /** Dust amount in RUNE base units. The withdraw fraction lives in the memo. */
+    amount: string;
+    /** Pre-built memo via `removeLpMemo`. */
+    memo: string;
+    pool: string;
+    basisPoints: number;
+    /**
+     * Asym-withdraw target asset, if any. Denormalized for display.
+     */
+    withdrawToAsset?: string;
+};
+export type BuildThorchainLpAddPayloadInput = {
+    pool: string;
+    amountRuneBaseUnits: string;
+    /**
+     * Optional paired address. When provided, embedded in the memo (matching
+     * iOS / Windows-extension auto-pair behavior) and denormalized on the
+     * payload for display.
+     */
+    pairedAddress?: string;
+};
+export declare const buildThorchainLpAddPayload: ({ pool, amountRuneBaseUnits, pairedAddress, }: BuildThorchainLpAddPayloadInput) => ThorchainLpAddPayload;
+export type BuildThorchainLpRemovePayloadInput = {
+    pool: string;
+    basisPoints: number;
+    /**
+     * Optional asym-withdraw target. Pass the short asset ticker (e.g. `BTC`),
+     * not the full pool id.
+     */
+    withdrawToAsset?: string;
+};
+export declare const buildThorchainLpRemovePayload: ({ pool, basisPoints, withdrawToAsset, }: BuildThorchainLpRemovePayloadInput) => ThorchainLpRemovePayload;
+//# sourceMappingURL=payload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/payload.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,kBAAkB,CAAA;IACxB,KAAK,EAAE,WAAW,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,qBAAqB,CAAA;IAC3B,KAAK,EAAE,WAAW,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAA;IACd,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAgBD,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,MAAM,CAAA;IACZ,mBAAmB,EAAE,MAAM,CAAA;IAC3B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,0BAA0B,GAAI,+CAIxC,+BAA+B,KAAG,qBAgBpC,CAAA;AAED,MAAM,MAAM,kCAAkC,GAAG;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,eAAO,MAAM,6BAA6B,GAAI,yCAI3C,kCAAkC,KAAG,wBAwBvC,CAAA"}

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

@@ -0,0 +1,49 @@
+import { addLpMemo, removeLpMemo } from './memo.js';
+/**
+ * Dust amount used for LP removes.
+ *
+ * Reference: vultisig-windows (the extension)
+ * `core/ui/vault/deposit/keysignPayload/build.ts` uses 0.02 RUNE as the
+ * dust amount on LP remove transactions — the on-chain amount is just
+ * dust to make the cosmos message valid; the actual withdraw fraction
+ * lives inside the memo (`-:POOL:BPS`).
+ */
+const LP_REMOVE_DUST_RUNE_BASE_UNITS = '2000000';
+const isPositiveBaseUnitString = (value) => /^\d+$/.test(value) && BigInt(value) > 0n;
+export const buildThorchainLpAddPayload = ({ pool, amountRuneBaseUnits, pairedAddress, }) => {
+    if (!isPositiveBaseUnitString(amountRuneBaseUnits)) {
+        throw new Error(`buildThorchainLpAddPayload: amountRuneBaseUnits must be a positive integer string, got ${amountRuneBaseUnits}`);
+    }
+    const memo = addLpMemo({ pool, pairedAddress });
+    return {
+        kind: 'thorchain_lp_add',
+        chain: 'THORChain',
+        denom: 'rune',
+        amount: amountRuneBaseUnits,
+        memo,
+        pool,
+        ...(pairedAddress ? { pairedAddress } : {}),
+    };
+};
+export const buildThorchainLpRemovePayload = ({ pool, basisPoints, withdrawToAsset, }) => {
+    // removeLpMemo validates this too, but fail fast at the payload
+    // boundary so callers see a consistent error shape with the add
+    // builder (which validates amountRuneBaseUnits up-front).
+    if (!Number.isInteger(basisPoints) ||
+        basisPoints < 1 ||
+        basisPoints > 10000) {
+        throw new Error(`buildThorchainLpRemovePayload: basisPoints must be an integer in [1, 10000], got ${basisPoints}`);
+    }
+    const memo = removeLpMemo({ pool, basisPoints, withdrawToAsset });
+    return {
+        kind: 'thorchain_lp_remove',
+        chain: 'THORChain',
+        denom: 'rune',
+        amount: LP_REMOVE_DUST_RUNE_BASE_UNITS,
+        memo,
+        pool,
+        basisPoints,
+        ...(withdrawToAsset ? { withdrawToAsset } : {}),
+    };
+};
+//# sourceMappingURL=payload.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/payload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAgDhD;;;;;;;;GAQG;AACH,MAAM,8BAA8B,GAAG,SAAS,CAAA;AAEhD,MAAM,wBAAwB,GAAG,CAAC,KAAa,EAAW,EAAE,CAC1D,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;AAa3C,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,EACzC,IAAI,EACJ,mBAAmB,EACnB,aAAa,GACmB,EAAyB,EAAE;IAC3D,IAAI,CAAC,wBAAwB,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CACb,0FAA0F,mBAAmB,EAAE,CAChH,CAAA;IACH,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAA;IAC/C,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,WAAW;QAClB,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,mBAAmB;QAC3B,IAAI;QACJ,IAAI;QACJ,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5C,CAAA;AACH,CAAC,CAAA;AAYD,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,EAC5C,IAAI,EACJ,WAAW,EACX,eAAe,GACoB,EAA4B,EAAE;IACjE,gEAAgE;IAChE,gEAAgE;IAChE,0DAA0D;IAC1D,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC;QAC9B,WAAW,GAAG,CAAC;QACf,WAAW,GAAG,KAAK,EACnB,CAAC;QACD,MAAM,IAAI,KAAK,CACb,oFAAoF,WAAW,EAAE,CAClG,CAAA;IACH,CAAC;IACD,MAAM,IAAI,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC,CAAA;IACjE,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,WAAW;QAClB,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,8BAA8B;QACtC,IAAI;QACJ,IAAI;QACJ,WAAW;QACX,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAA;AACH,CAAC,CAAA"}