@vultisig/core-chain 1.0.0 → 1.2.0

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

@@ -0,0 +1,56 @@
+export type LpHaltStatus = {
+    chain: string;
+    depositable: boolean;
+    withdrawable: boolean;
+    /** Human-readable reasons, empty when both flags are `true`. */
+    reasons: string[];
+    /** Raw flags from thornode for downstream consumers that want detail. */
+    raw: {
+        halted: boolean;
+        chain_trading_paused: boolean;
+        chain_lp_actions_paused: boolean;
+        global_trading_paused: boolean;
+    };
+};
+/**
+ * Look up the LP halt / pause status for every THORChain-supported chain
+ * in a single thornode round-trip.
+ *
+ * Returns one `LpHaltStatus` per chain in `/thorchain/inbound_addresses`.
+ * Useful for "which pools can I actually add to right now?" queries.
+ */
+export declare const getThorchainLpHaltStatusAll: () => Promise<LpHaltStatus[]>;
+/**
+ * Look up the LP halt / pause status for a specific chain by its
+ * THORChain-pool-prefix (e.g. `BTC`, `ETH`, `DOGE`).
+ *
+ * Throws when the chain is not in the inbound_addresses response. Prefer
+ * `getThorchainLpHaltStatusAll` + filter if you want a nullable result.
+ */
+export declare const getThorchainLpHaltStatus: (chain: string) => Promise<LpHaltStatus>;
+/**
+ * Look up the per-pool LP deposit pause status from mimir.
+ *
+ * THORChain can pause LP deposits for a SPECIFIC pool via the mimir flag
+ * `PAUSELPDEPOSIT-{chain}-{asset}` independently of the chain-level
+ * `chain_lp_actions_paused` flag in `inbound_addresses`. When that flag
+ * is set, `/thorchain/pool/{asset}.status` still reports `Available` and
+ * new LP add transactions are silently accepted into the mempool — but
+ * the THORChain handler rejects them at execution time with an internal
+ * error, wasting the user's native fee.
+ *
+ * Use this helper (or `assertPoolDepositable` which already calls it) as
+ * a pre-flight gate before building an LP add payload to catch that case.
+ *
+ * Returns `{ paused: false }` when the mimir flag is unset or zero.
+ * Returns `{ paused: true, mimirKey, mimirValue }` when paused. Does NOT
+ * throw — the caller decides whether to block, warn, or continue.
+ */
+export declare const getThorchainLpPoolPauseStatus: (pool: string) => Promise<{
+    paused: false;
+} | {
+    paused: true;
+    mimirKey: string;
+    mimirValue: number;
+}>;
+//# sourceMappingURL=halts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"halts.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/halts.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,OAAO,CAAA;IACpB,YAAY,EAAE,OAAO,CAAA;IACrB,gEAAgE;IAChE,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,yEAAyE;IACzE,GAAG,EAAE;QACH,MAAM,EAAE,OAAO,CAAA;QACf,oBAAoB,EAAE,OAAO,CAAA;QAC7B,uBAAuB,EAAE,OAAO,CAAA;QAChC,qBAAqB,EAAE,OAAO,CAAA;KAC/B,CAAA;CACF,CAAA;AA2CD;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,QAAa,OAAO,CAC1D,YAAY,EAAE,CAYf,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GACnC,OAAO,MAAM,KACZ,OAAO,CAAC,YAAY,CAUtB,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,6BAA6B,GACxC,MAAM,MAAM,KACX,OAAO,CACN;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GACjB;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CASzD,CAAA"}

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

@@ -0,0 +1,95 @@
+import { getThorchainInboundAddress } from '../getThorchainInboundAddress.js';
+import { getThorchainMimir, poolPauseMimirKey } from './validation.js';
+const buildStatus = (raw) => {
+    const reasons = [];
+    if (raw.halted)
+        reasons.push(`${raw.chain} chain is halted`);
+    if (raw.global_trading_paused)
+        reasons.push('global trading paused');
+    if (raw.chain_trading_paused)
+        reasons.push(`${raw.chain} chain trading paused`);
+    if (raw.chain_lp_actions_paused)
+        reasons.push(`${raw.chain} LP actions paused`);
+    // Deposit gate: any of these block new LP adds
+    const depositable = !raw.halted &&
+        !raw.chain_lp_actions_paused &&
+        !raw.chain_trading_paused &&
+        !raw.global_trading_paused;
+    // Withdraw gate: halt + lp_actions_paused block withdraws.
+    // global_trading_paused may delay but does not block withdraws at the
+    // protocol level (the message is accepted; the outbound is queued).
+    const withdrawable = !raw.halted && !raw.chain_lp_actions_paused;
+    return {
+        chain: raw.chain,
+        depositable,
+        withdrawable,
+        reasons,
+        raw: {
+            halted: raw.halted,
+            chain_trading_paused: raw.chain_trading_paused,
+            chain_lp_actions_paused: raw.chain_lp_actions_paused,
+            global_trading_paused: raw.global_trading_paused,
+        },
+    };
+};
+/**
+ * Look up the LP halt / pause status for every THORChain-supported chain
+ * in a single thornode round-trip.
+ *
+ * Returns one `LpHaltStatus` per chain in `/thorchain/inbound_addresses`.
+ * Useful for "which pools can I actually add to right now?" queries.
+ */
+export const getThorchainLpHaltStatusAll = async () => {
+    const addresses = await getThorchainInboundAddress();
+    return addresses.map(a => buildStatus({
+        chain: a.chain,
+        halted: a.halted,
+        chain_trading_paused: a.chain_trading_paused,
+        chain_lp_actions_paused: a.chain_lp_actions_paused,
+        global_trading_paused: a.global_trading_paused,
+    }));
+};
+/**
+ * Look up the LP halt / pause status for a specific chain by its
+ * THORChain-pool-prefix (e.g. `BTC`, `ETH`, `DOGE`).
+ *
+ * Throws when the chain is not in the inbound_addresses response. Prefer
+ * `getThorchainLpHaltStatusAll` + filter if you want a nullable result.
+ */
+export const getThorchainLpHaltStatus = async (chain) => {
+    const all = await getThorchainLpHaltStatusAll();
+    const upper = chain.toUpperCase();
+    const match = all.find(s => s.chain.toUpperCase() === upper);
+    if (!match) {
+        throw new Error(`getThorchainLpHaltStatus: chain ${chain} not found in inbound_addresses`);
+    }
+    return match;
+};
+/**
+ * Look up the per-pool LP deposit pause status from mimir.
+ *
+ * THORChain can pause LP deposits for a SPECIFIC pool via the mimir flag
+ * `PAUSELPDEPOSIT-{chain}-{asset}` independently of the chain-level
+ * `chain_lp_actions_paused` flag in `inbound_addresses`. When that flag
+ * is set, `/thorchain/pool/{asset}.status` still reports `Available` and
+ * new LP add transactions are silently accepted into the mempool — but
+ * the THORChain handler rejects them at execution time with an internal
+ * error, wasting the user's native fee.
+ *
+ * Use this helper (or `assertPoolDepositable` which already calls it) as
+ * a pre-flight gate before building an LP add payload to catch that case.
+ *
+ * Returns `{ paused: false }` when the mimir flag is unset or zero.
+ * Returns `{ paused: true, mimirKey, mimirValue }` when paused. Does NOT
+ * throw — the caller decides whether to block, warn, or continue.
+ */
+export const getThorchainLpPoolPauseStatus = async (pool) => {
+    const mimir = await getThorchainMimir();
+    const mimirKey = poolPauseMimirKey(pool);
+    const mimirValue = mimir[mimirKey];
+    if (typeof mimirValue === 'number' && mimirValue > 0) {
+        return { paused: true, mimirKey, mimirValue };
+    }
+    return { paused: false };
+};
+//# sourceMappingURL=halts.js.map

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

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

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

@@ -0,0 +1,45 @@
+/**
+ * THORChain liquidity-pool primitives.
+ *
+ * Pure-function memo + payload builders, chain-prefix mapping, paired-
+ * address resolution, pool-math (slippage/units/share), and thin
+ * Midgard / thornode fetchers. Used by `vultisig-mcp-ts` (MCP tools) and
+ * by `vultiagent-poc` (hand-rolled signing until VA-133 lands).
+ *
+ * v2 surface (current):
+ *   - asym RUNE-side add + remove with optional auto-pair (matches iOS /
+ *     vultisig-windows extension behavior)
+ *   - asset-side add with inbound / router / approval detection
+ *   - LP math: liquidity units, pool share, slippage, one-shot estimator
+ *   - position read-back: single pool + multi-pool
+ *   - lockup awareness (mimir-driven)
+ *   - halt / pause status per chain
+ *
+ * Deliberately excluded:
+ *   - savers (deprecated on-chain 2025-01-04)
+ *   - RUNEPool (separate product)
+ *   - secured assets (handled by `@vultisig/rujira`)
+ *   - affiliate on LP memos (matches iOS / extension native behavior)
+ */
+export type { AddLpMemoInput, RemoveLpMemoInput } from './memo.js';
+export { addLpMemo, removeLpMemo } from './memo.js';
+export type { BuildThorchainLpAddPayloadInput, BuildThorchainLpRemovePayloadInput, ThorchainLpAddPayload, ThorchainLpRemovePayload, } from './payload.js';
+export { buildThorchainLpAddPayload, buildThorchainLpRemovePayload, } from './payload.js';
+export type { GetThorchainPoolsOptions, ThorchainPoolSummary, } from './pools.js';
+export { assertValidPoolId, getThorchainPools, isValidPoolId, thorchainMidgardBaseUrl, } from './pools.js';
+export type { GetThorchainLpPositionInput } from './position.js';
+export type { ThorchainLpPosition } from './types.js';
+export { getThorchainLpPosition, getThorchainLpPositionFromThornode, } from './position.js';
+export { assertPoolDepositable, getThorchainMimir, poolPauseMimirKey, } from './validation.js';
+export type { VaultAddressMap } from './pairing.js';
+export { resolvePairedAddressForLpAdd, } from './pairing.js';
+export type { LpSide } from './pairing.js';
+export { lpChainMap, chainPrefixToChain, chainToLpPrefix } from './lpChainMap.js';
+export type { PoolState, SlippageResult, EstimateLpAddResult } from './math.js';
+export { getLiquidityUnits, getPoolShare, getLpAddSlippage, estimateLpAdd, } from './math.js';
+export { getThorchainLpPositions } from './positions.js';
+export type { LpWithdrawReadiness, } from './lockup.js';
+export { getThorchainLpLockupSeconds, getLpWithdrawReadiness, THORCHAIN_BLOCK_TIME_SECONDS, } from './lockup.js';
+export type { LpHaltStatus } from './halts.js';
+export { getThorchainLpHaltStatus, getThorchainLpHaltStatusAll, getThorchainLpPoolPauseStatus, } from './halts.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AAC/D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAChD,YAAY,EACV,+BAA+B,EAC/B,kCAAkC,EAClC,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,WAAW,CAAA;AAClB,YAAY,EACV,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,uBAAuB,GACxB,MAAM,SAAS,CAAA;AAChB,YAAY,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAA;AAC7D,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EACL,sBAAsB,EACtB,kCAAkC,GACnC,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,cAAc,CAAA;AAGrB,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,EACL,4BAA4B,GAC7B,MAAM,WAAW,CAAA;AAClB,YAAY,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9E,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAA;AAC5E,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,aAAa,GACd,MAAM,QAAQ,CAAA;AACf,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACrD,YAAY,EACV,mBAAmB,GACpB,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,UAAU,CAAA;AACjB,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,SAAS,CAAA"}

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

@@ -0,0 +1,12 @@
+export { addLpMemo, removeLpMemo } from './memo.js';
+export { buildThorchainLpAddPayload, buildThorchainLpRemovePayload, } from './payload.js';
+export { assertValidPoolId, getThorchainPools, isValidPoolId, thorchainMidgardBaseUrl, } from './pools.js';
+export { getThorchainLpPosition, getThorchainLpPositionFromThornode, } from './position.js';
+export { assertPoolDepositable, getThorchainMimir, poolPauseMimirKey, } from './validation.js';
+export { resolvePairedAddressForLpAdd, } from './pairing.js';
+export { lpChainMap, chainPrefixToChain, chainToLpPrefix } from './lpChainMap.js';
+export { getLiquidityUnits, getPoolShare, getLpAddSlippage, estimateLpAdd, } from './math.js';
+export { getThorchainLpPositions } from './positions.js';
+export { getThorchainLpLockupSeconds, getLpWithdrawReadiness, THORCHAIN_BLOCK_TIME_SECONDS, } from './lockup.js';
+export { getThorchainLpHaltStatus, getThorchainLpHaltStatusAll, getThorchainLpPoolPauseStatus, } from './halts.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/index.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAOhD,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,WAAW,CAAA;AAKlB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,uBAAuB,GACxB,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,sBAAsB,EACtB,kCAAkC,GACnC,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,cAAc,CAAA;AAIrB,OAAO,EACL,4BAA4B,GAC7B,MAAM,WAAW,CAAA;AAElB,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9E,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,aAAa,GACd,MAAM,QAAQ,CAAA;AACf,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAIrD,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,SAAS,CAAA"}

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

@@ -0,0 +1,47 @@
+import type { ThorchainLpPosition } from './types.js';
+/**
+ * THORChain target block time in seconds. The chain runs on CometBFT /
+ * Tendermint with a 6-second block target. Mainnet averages are stable
+ * enough that we treat this as a constant — for lockup countdown UIs
+ * that's plenty of precision.
+ */
+export declare const THORCHAIN_BLOCK_TIME_SECONDS = 6;
+/**
+ * Read the current `LIQUIDITYLOCKUPBLOCKS` mimir value from thornode and
+ * convert to seconds.
+ *
+ * Mainnet value as of 2025-04: 600 blocks = 3600 seconds = 1 hour.
+ *
+ * Note: per the THORChain FAQ ("no lockup period") the mimir value exists
+ * but the protocol does not operationally restrict users from withdrawing.
+ * Treat this as a UX hint, not a correctness requirement. The broadcast-
+ * time error is the real backstop if a withdraw hits too early.
+ */
+export declare const getThorchainLpLockupSeconds: () => Promise<number>;
+export type LpWithdrawReadiness = {
+    isWithdrawable: boolean;
+    /**
+     * Unix seconds (UTC) at which the withdraw window opens. Equal to
+     * `dateLastAdded + lockupSeconds`. In the past when `isWithdrawable`.
+     */
+    unlockAtUnix: number;
+    /**
+     * Seconds remaining until `unlockAtUnix`. Zero when already withdrawable.
+     */
+    remainingSeconds: number;
+};
+/**
+ * Compute whether a position is currently past its lockup window.
+ *
+ * `position.dateLastAdded` is a unix-seconds timestamp string from
+ * Midgard. `lockupSeconds` is the current mimir-driven window from
+ * `getThorchainLpLockupSeconds()` — the caller can pass it in if they
+ * already have it (to avoid an extra mimir round-trip) or omit it and
+ * let this helper fetch it.
+ */
+export declare const getLpWithdrawReadiness: ({ position, lockupSeconds: providedLockupSeconds, nowUnix, }: {
+    position: Pick<ThorchainLpPosition, "dateLastAdded">;
+    lockupSeconds?: number;
+    nowUnix?: number;
+}) => Promise<LpWithdrawReadiness>;
+//# sourceMappingURL=lockup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lockup.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/lockup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAGlD;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,IAAI,CAAA;AAE7C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2BAA2B,QAAa,OAAO,CAAC,MAAM,CASlE,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,cAAc,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,GAAU,8DAI1C;IACD,QAAQ,EAAE,IAAI,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAA;IACpD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,KAAG,OAAO,CAAC,mBAAmB,CAmB9B,CAAA"}

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

@@ -0,0 +1,56 @@
+import { getThorchainMimir } from './validation.js';
+/**
+ * THORChain target block time in seconds. The chain runs on CometBFT /
+ * Tendermint with a 6-second block target. Mainnet averages are stable
+ * enough that we treat this as a constant — for lockup countdown UIs
+ * that's plenty of precision.
+ */
+export const THORCHAIN_BLOCK_TIME_SECONDS = 6;
+/**
+ * Read the current `LIQUIDITYLOCKUPBLOCKS` mimir value from thornode and
+ * convert to seconds.
+ *
+ * Mainnet value as of 2025-04: 600 blocks = 3600 seconds = 1 hour.
+ *
+ * Note: per the THORChain FAQ ("no lockup period") the mimir value exists
+ * but the protocol does not operationally restrict users from withdrawing.
+ * Treat this as a UX hint, not a correctness requirement. The broadcast-
+ * time error is the real backstop if a withdraw hits too early.
+ */
+export const getThorchainLpLockupSeconds = async () => {
+    const mimir = await getThorchainMimir();
+    const blocks = mimir['LIQUIDITYLOCKUPBLOCKS'];
+    if (typeof blocks !== 'number' || !Number.isFinite(blocks) || blocks < 0) {
+        throw new Error(`getThorchainLpLockupSeconds: mimir did not include a valid LIQUIDITYLOCKUPBLOCKS value`);
+    }
+    return blocks * THORCHAIN_BLOCK_TIME_SECONDS;
+};
+/**
+ * Compute whether a position is currently past its lockup window.
+ *
+ * `position.dateLastAdded` is a unix-seconds timestamp string from
+ * Midgard. `lockupSeconds` is the current mimir-driven window from
+ * `getThorchainLpLockupSeconds()` — the caller can pass it in if they
+ * already have it (to avoid an extra mimir round-trip) or omit it and
+ * let this helper fetch it.
+ */
+export const getLpWithdrawReadiness = async ({ position, lockupSeconds: providedLockupSeconds, nowUnix = Math.floor(Date.now() / 1000), }) => {
+    const lockupSeconds = providedLockupSeconds ?? (await getThorchainLpLockupSeconds());
+    const lastAdded = Number(position.dateLastAdded);
+    if (!Number.isFinite(lastAdded) || lastAdded <= 0) {
+        // No valid last-add timestamp — assume withdrawable (fresh / unknown).
+        return {
+            isWithdrawable: true,
+            unlockAtUnix: 0,
+            remainingSeconds: 0,
+        };
+    }
+    const unlockAtUnix = lastAdded + lockupSeconds;
+    const remainingSeconds = Math.max(unlockAtUnix - nowUnix, 0);
+    return {
+        isWithdrawable: remainingSeconds === 0,
+        unlockAtUnix,
+        remainingSeconds,
+    };
+};
+//# sourceMappingURL=lockup.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lockup.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/lockup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAEhD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAA;AAE7C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,KAAK,IAAqB,EAAE;IACrE,MAAM,KAAK,GAAG,MAAM,iBAAiB,EAAE,CAAA;IACvC,MAAM,MAAM,GAAG,KAAK,CAAC,uBAAuB,CAAC,CAAA;IAC7C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CACb,wFAAwF,CACzF,CAAA;IACH,CAAC;IACD,OAAO,MAAM,GAAG,4BAA4B,CAAA;AAC9C,CAAC,CAAA;AAeD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,EAAE,EAC3C,QAAQ,EACR,aAAa,EAAE,qBAAqB,EACpC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAKxC,EAAgC,EAAE;IACjC,MAAM,aAAa,GACjB,qBAAqB,IAAI,CAAC,MAAM,2BAA2B,EAAE,CAAC,CAAA;IAChE,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAA;IAChD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QAClD,uEAAuE;QACvE,OAAO;YACL,cAAc,EAAE,IAAI;YACpB,YAAY,EAAE,CAAC;YACf,gBAAgB,EAAE,CAAC;SACpB,CAAA;IACH,CAAC;IACD,MAAM,YAAY,GAAG,SAAS,GAAG,aAAa,CAAA;IAC9C,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,OAAO,EAAE,CAAC,CAAC,CAAA;IAC5D,OAAO;QACL,cAAc,EAAE,gBAAgB,KAAK,CAAC;QACtC,YAAY;QACZ,gBAAgB;KACjB,CAAA;AACH,CAAC,CAAA"}

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

@@ -0,0 +1,25 @@
+import { Chain } from '@vultisig/core-chain/Chain';
+/**
+ * Mapping from THORChain pool-id chain prefix to the SDK's `Chain` enum.
+ *
+ * This is the reverse of `thorchainLpChainCode` in the sibling
+ * `thorchainLp.ts` module (which maps `Chain` → prefix string). We derive
+ * it here instead of hand-rolling to keep the two directions in lockstep
+ * automatically.
+ *
+ * Reference: vultisig-windows (the extension)
+ * `core/ui/storage/defiPositions.tsx` uses the same map.
+ */
+export declare const lpChainMap: Readonly<Record<string, Chain>>;
+/**
+ * Resolve a THORChain pool-id chain prefix (e.g. `BTC`, `ETH`, `GAIA`) to
+ * the SDK's `Chain` enum. Returns `undefined` for unknown prefixes.
+ */
+export declare const chainPrefixToChain: (prefix: string) => Chain | undefined;
+/**
+ * Resolve a `Chain` enum value to the THORChain pool-id prefix (e.g.
+ * `Chain.Bitcoin` → `BTC`). Returns `undefined` for chains THORChain does
+ * not support in pools.
+ */
+export declare const chainToLpPrefix: (chain: Chain) => string | undefined;
+//# sourceMappingURL=lpChainMap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lpChainMap.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/lpChainMap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAA;AAIlD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAUtD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,MAAM,KAAG,KAAK,GAAG,SAC1B,CAAA;AAElC;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,KAAK,KAAG,MAAM,GAAG,SAC3B,CAAA"}

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

@@ -0,0 +1,30 @@
+import { thorchainLpChainCode } from '../thorchainLp.js';
+/**
+ * Mapping from THORChain pool-id chain prefix to the SDK's `Chain` enum.
+ *
+ * This is the reverse of `thorchainLpChainCode` in the sibling
+ * `thorchainLp.ts` module (which maps `Chain` → prefix string). We derive
+ * it here instead of hand-rolling to keep the two directions in lockstep
+ * automatically.
+ *
+ * Reference: vultisig-windows (the extension)
+ * `core/ui/storage/defiPositions.tsx` uses the same map.
+ */
+export const lpChainMap = Object.freeze(Object.entries(thorchainLpChainCode).reduce((acc, [chainKey, prefix]) => {
+    if (prefix) {
+        acc[prefix] = chainKey;
+    }
+    return acc;
+}, {}));
+/**
+ * Resolve a THORChain pool-id chain prefix (e.g. `BTC`, `ETH`, `GAIA`) to
+ * the SDK's `Chain` enum. Returns `undefined` for unknown prefixes.
+ */
+export const chainPrefixToChain = (prefix) => lpChainMap[prefix.toUpperCase()];
+/**
+ * Resolve a `Chain` enum value to the THORChain pool-id prefix (e.g.
+ * `Chain.Bitcoin` → `BTC`). Returns `undefined` for chains THORChain does
+ * not support in pools.
+ */
+export const chainToLpPrefix = (chain) => thorchainLpChainCode[chain];
+//# sourceMappingURL=lpChainMap.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lpChainMap.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/lpChainMap.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAErD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAoC,MAAM,CAAC,MAAM,CACtE,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,MAAM,CACzC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE;IAC1B,IAAI,MAAM,EAAE,CAAC;QACX,GAAG,CAAC,MAAM,CAAC,GAAG,QAAiB,CAAA;IACjC,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC,EACD,EAAE,CACH,CACF,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAc,EAAqB,EAAE,CACtE,UAAU,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAA;AAElC;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAY,EAAsB,EAAE,CAClE,oBAAoB,CAAC,KAAK,CAAC,CAAA"}

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"}