@vultisig/core-chain 1.4.1 → 1.4.3

package/dist/chains/cosmos/staking/lcdQueries.js

@@ -0,0 +1,80 @@
+import { cosmosRpcUrl } from '../cosmosRpcUrl.js';
+export const getDelegationsUrl = (chain, delegatorAddress) => `${cosmosRpcUrl[chain]}/cosmos/staking/v1beta1/delegations/${delegatorAddress}`;
+export const getUnbondingDelegationsUrl = (chain, delegatorAddress) => `${cosmosRpcUrl[chain]}/cosmos/staking/v1beta1/delegators/${delegatorAddress}/unbonding_delegations`;
+export const getDelegatorRewardsUrl = (chain, delegatorAddress) => `${cosmosRpcUrl[chain]}/cosmos/distribution/v1beta1/delegators/${delegatorAddress}/rewards`;
+export const getAuthAccountUrl = (chain, address) => `${cosmosRpcUrl[chain]}/cosmos/auth/v1beta1/accounts/${address}`;
+async function lcdGet(url, opts = {}) {
+    const f = opts.fetchImpl ?? fetch;
+    const res = await f(url, { signal: opts.signal });
+    if (!res.ok) {
+        // 404 on `/auth/accounts/{addr}` for an unseen address is a legitimate
+        // response shape on some chains. Caller decides what to do with it; we
+        // surface the status so they can branch on `error.message.includes('404')`.
+        throw new Error(`LCD ${res.status}: ${url}`);
+    }
+    return (await res.json());
+}
+export async function getCosmosDelegations(chain, delegatorAddress, opts = {}) {
+    const raw = await lcdGet(getDelegationsUrl(chain, delegatorAddress), opts);
+    return raw.delegation_responses.map(d => ({
+        validatorAddress: d.delegation.validator_address,
+        balance: d.balance,
+        shares: d.delegation.shares,
+    }));
+}
+export async function getCosmosUnbondingDelegations(chain, delegatorAddress, opts = {}) {
+    const raw = await lcdGet(getUnbondingDelegationsUrl(chain, delegatorAddress), opts);
+    return raw.unbonding_responses.map(u => ({
+        validatorAddress: u.validator_address,
+        entries: u.entries.map(e => ({
+            creationHeight: e.creation_height,
+            completionTime: e.completion_time,
+            initialBalance: e.initial_balance,
+            balance: e.balance,
+        })),
+    }));
+}
+export async function getCosmosDelegatorRewards(chain, delegatorAddress, opts = {}) {
+    const raw = await lcdGet(getDelegatorRewardsUrl(chain, delegatorAddress), opts);
+    return {
+        // `?? []` on both fields: an address with zero unclaimed rewards (rare
+        // but valid - e.g. brand-new delegator who hasn't accrued anything yet,
+        // or one who claimed in the same block) returns a body where `rewards`
+        // (and sometimes `total`) is missing entirely on some chain firmwares.
+        // Without the fallback the .map call would throw on undefined.
+        rewards: (raw.rewards ?? []).map(r => ({ validatorAddress: r.validator_address, reward: r.reward })),
+        total: raw.total ?? [],
+    };
+}
+/**
+ * Returns the wrapped vesting account if the address is a vesting account,
+ * otherwise null. The auth endpoint always wraps in `BaseAccount` for
+ * non-vesting addresses, so we filter by `@type`.
+ *
+ * Used by callers that need to surface vesting state to the user (e.g.
+ * "X LUNA still locked, vesting until 2024-05-26"). NOT used by the staking
+ * msg builders — undelegate works on any delegated balance regardless of
+ * vesting state, the contract just controls when the unbonded coins become
+ * spendable post-21-day window.
+ */
+export async function getCosmosVestingAccount(chain, address, opts = {}) {
+    let raw;
+    try {
+        raw = await lcdGet(getAuthAccountUrl(chain, address), opts);
+    }
+    catch (e) {
+        // 404 on a brand-new (zero-tx) address is normal — return null so the
+        // caller doesn't have to differentiate "not found" from "not vesting".
+        if (e instanceof Error && e.message.startsWith('LCD 404'))
+            return null;
+        throw e;
+    }
+    const t = raw.account['@type'];
+    if (t === '/cosmos.vesting.v1beta1.PeriodicVestingAccount' ||
+        t === '/cosmos.vesting.v1beta1.ContinuousVestingAccount' ||
+        t === '/cosmos.vesting.v1beta1.DelayedVestingAccount') {
+        return raw.account;
+    }
+    return null;
+}
+//# sourceMappingURL=lcdQueries.js.map

package/dist/chains/cosmos/staking/lcdQueries.js.map

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

package/dist/chains/cosmos/terraClassicTax.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Terra Classic stability-tax queries + math.
+ *
+ * Background: Terra Classic (chain-id `columbus-5`) inherits the original
+ * Terra "treasury" module from cosmos-sdk Terra v1, which charges a
+ * stability tax on `MsgSend` / `MsgMultiSend` for every native denom
+ * EXCEPT `uluna` (LUNC itself is fee-exempt). The tax is a fraction of
+ * the transferred amount (governance-controlled, fixed-point 18-decimal),
+ * and is capped per-denom by a separate per-denom ceiling.
+ *
+ * As of this lift the live `tax_rate` is `0` (governance has effectively
+ * paused the tax post-UST-collapse), but the treasury module still exists
+ * and the rate is queryable — historically it was 1.2% with caps that
+ * mostly came into play for large `uusd` transfers. If governance ever
+ * re-enables the tax, signing paths that ignore it produce txs that get
+ * rejected by the chain's ante handler ("insufficient fee").
+ *
+ * Terra v2 (`phoenix-1`) does NOT have a treasury module — the same
+ * endpoints return HTTP 501 — so callers should only invoke these for
+ * `Chain.TerraClassic`.
+ *
+ * Consumers should query the rate AT SIGN-TIME (not cached across
+ * sessions), because governance rate changes propagate immediately.
+ * Within a single signing call, both `getTerraClassicTaxRate` and any
+ * `getTerraClassicTaxCaps(denom)` calls are safe to memoize — the rate
+ * does not change mid-tx.
+ */
+/**
+ * `cosmosRpcUrl` for Terra Classic actually points at the LCD root (despite
+ * the dict name) — the same convention as `staking/lcdQueries`. Keep both
+ * URL builders side-by-side here so it's obvious where the tax module
+ * lives.
+ *
+ * Reference: terra-money/classic-core, x/treasury REST routes.
+ */
+export declare const getTerraClassicTaxRateUrl: () => string;
+export declare const getTerraClassicTaxCapsUrl: (denom: string) => string;
+/**
+ * cosmos-sdk `Dec` is fixed-point with 18 decimals — the on-the-wire
+ * representation of `0.012` (1.2%) is the integer `12000000000000000`.
+ * Multiplying an amount by `rate` and dividing by `DEC_SCALE` gives the
+ * tax in base units of the same denom.
+ */
+export declare const TERRA_CLASSIC_TAX_DEC_SCALE: bigint;
+type FetchOpts = {
+    fetchImpl?: typeof fetch;
+    signal?: AbortSignal;
+};
+/**
+ * Fetches the current Terra Classic stability tax rate as an 18-decimal
+ * fixed-point bigint (e.g. `0n` if paused, `12_000_000_000_000_000n` if
+ * 1.2%). Throws when the LCD response is HTTP 200 but missing `tax_rate` —
+ * fail-closed, because silently treating "missing" as `0n` would
+ * undercalculate fees if a flaky LCD started returning `{}` after the chain
+ * un-pauses the tax (causing post-sign "insufficient fee" rejections).
+ */
+export declare function getTerraClassicTaxRate(opts?: FetchOpts): Promise<bigint>;
+/**
+ * Fetches the per-denom tax cap as a base-unit bigint (e.g.
+ * `60_000_000_000_000_000n` for `uluna`). The cap is the maximum tax that
+ * can be levied on a single transfer regardless of the rate-derived
+ * amount — when the chain re-enables the tax, large `uusd` transfers in
+ * particular hit the cap rather than the rate.
+ *
+ * Returns `null` ONLY for HTTP 404 ("no entry for this denom") — the
+ * caller treats `null` as "no per-denom cap" (the math helper interprets
+ * a missing cap as `+∞`).
+ *
+ * Fails closed (throws) on any other shape we don't recognize — including
+ * a `200` response with the `tax_cap` field missing or null. A flaky or
+ * tampered LCD that drops the field would otherwise turn a capped denom
+ * into an uncapped one and overcharge the user. Codex round-1 P1.
+ */
+export declare function getTerraClassicTaxCap(denom: string, opts?: FetchOpts): Promise<bigint | null>;
+/**
+ * Pure helper: given a transfer `amount`, its `denom`, the current 18-decimal
+ * `rate`, and a per-denom `caps` map, returns the stability tax in base
+ * units of `denom`.
+ *
+ * Rules (mirroring x/treasury's ante handler):
+ * - `denom === 'uluna'` is fee-exempt → returns `0n`.
+ * - `rate === 0n` → returns `0n` (the most common case today; lets callers
+ *   skip the cap fetch entirely and avoid spurious LCD load).
+ * - Otherwise, `tax = floor(amount * rate / 10^18)`, then clamp to
+ *   `caps[denom]` if present (cap of `null`/missing = uncapped).
+ *
+ * `floor` matches the cosmos-sdk Dec.MulInt rounding for positive values.
+ */
+export declare const applyTerraClassicTax: (amount: bigint, denom: string, rate: bigint, caps: Record<string, bigint | null | undefined>) => bigint;
+export {};
+//# sourceMappingURL=terraClassicTax.d.ts.map

package/dist/chains/cosmos/terraClassicTax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terraClassicTax.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/cosmos/terraClassicTax.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAUH;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,QAAO,MAC0B,CAAA;AAEvE,eAAO,MAAM,yBAAyB,GAAI,OAAO,MAAM,KAAG,MAK0C,CAAA;AAMpG;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,QAAa,CAAA;AAMrD,KAAK,SAAS,GAAG;IAAE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,CAAA;AAoDnE;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,GAAE,SAAc,GACnB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,SAAc,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmBxB;AAMD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,MAAM,MAAM,EACZ,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,KAC9C,MAiBF,CAAA"}

package/dist/chains/cosmos/terraClassicTax.js

@@ -0,0 +1,191 @@
+/**
+ * Terra Classic stability-tax queries + math.
+ *
+ * Background: Terra Classic (chain-id `columbus-5`) inherits the original
+ * Terra "treasury" module from cosmos-sdk Terra v1, which charges a
+ * stability tax on `MsgSend` / `MsgMultiSend` for every native denom
+ * EXCEPT `uluna` (LUNC itself is fee-exempt). The tax is a fraction of
+ * the transferred amount (governance-controlled, fixed-point 18-decimal),
+ * and is capped per-denom by a separate per-denom ceiling.
+ *
+ * As of this lift the live `tax_rate` is `0` (governance has effectively
+ * paused the tax post-UST-collapse), but the treasury module still exists
+ * and the rate is queryable — historically it was 1.2% with caps that
+ * mostly came into play for large `uusd` transfers. If governance ever
+ * re-enables the tax, signing paths that ignore it produce txs that get
+ * rejected by the chain's ante handler ("insufficient fee").
+ *
+ * Terra v2 (`phoenix-1`) does NOT have a treasury module — the same
+ * endpoints return HTTP 501 — so callers should only invoke these for
+ * `Chain.TerraClassic`.
+ *
+ * Consumers should query the rate AT SIGN-TIME (not cached across
+ * sessions), because governance rate changes propagate immediately.
+ * Within a single signing call, both `getTerraClassicTaxRate` and any
+ * `getTerraClassicTaxCaps(denom)` calls are safe to memoize — the rate
+ * does not change mid-tx.
+ */
+import { Chain } from '../../Chain.js';
+import { cosmosRpcUrl } from './cosmosRpcUrl.js';
+// ---------------------------------------------------------------------------
+// LCD endpoints
+// ---------------------------------------------------------------------------
+/**
+ * `cosmosRpcUrl` for Terra Classic actually points at the LCD root (despite
+ * the dict name) — the same convention as `staking/lcdQueries`. Keep both
+ * URL builders side-by-side here so it's obvious where the tax module
+ * lives.
+ *
+ * Reference: terra-money/classic-core, x/treasury REST routes.
+ */
+export const getTerraClassicTaxRateUrl = () => `${cosmosRpcUrl[Chain.TerraClassic]}/terra/treasury/v1beta1/tax_rate`;
+export const getTerraClassicTaxCapsUrl = (denom) => 
+// URL-encode the denom: `ibc/<HASH>` and `factory/<addr>/<subdenom>` carry
+// forward-slashes that would otherwise become extra path segments and the
+// LCD would 404 (silently undertaxing those denoms once the rate is
+// nonzero).
+`${cosmosRpcUrl[Chain.TerraClassic]}/terra/treasury/v1beta1/tax_caps/${encodeURIComponent(denom)}`;
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/**
+ * cosmos-sdk `Dec` is fixed-point with 18 decimals — the on-the-wire
+ * representation of `0.012` (1.2%) is the integer `12000000000000000`.
+ * Multiplying an amount by `rate` and dividing by `DEC_SCALE` gives the
+ * tax in base units of the same denom.
+ */
+export const TERRA_CLASSIC_TAX_DEC_SCALE = 10n ** 18n;
+async function lcdGetJson(url, opts) {
+    const f = opts.fetchImpl ?? fetch;
+    const res = await f(url, { signal: opts.signal });
+    if (!res.ok)
+        throw new Error(`LCD ${res.status}: ${url}`);
+    return (await res.json());
+}
+/**
+ * Parses a cosmos-sdk `Dec` string ("0.012000000000000000") into the
+ * 18-decimal fixed-point integer representation (`12000000000000000n`).
+ * Accepts the integer-string form too ("12000000000000000") for callers
+ * that already pre-multiplied. Throws on negative values or NaN.
+ */
+const parseDecToFixed18 = (s) => {
+    if (typeof s !== 'string') {
+        throw new Error(`tax_rate: expected string Dec, got ${typeof s}`);
+    }
+    const trimmed = s.trim();
+    if (trimmed.length === 0)
+        throw new Error('tax_rate: empty Dec string');
+    // Bigint-safe Dec parse: split on the decimal point if present, then
+    // pad/truncate the fractional part to exactly 18 digits.
+    const negative = trimmed.startsWith('-');
+    if (negative)
+        throw new Error(`tax_rate: negative Dec rejected (${trimmed})`);
+    // Validate strict Dec shape — single decimal point at most, and
+    // reject 19+ fractional digits outright. Truncating past 18 digits
+    // would let `1.0000000000000000001` (semantically > 100%) parse as
+    // exactly `10^18` and pass the cap guard below — fail-closed instead.
+    // Codex round-1 P1.
+    if (!/^[0-9]+(\.[0-9]{1,18})?$/.test(trimmed)) {
+        throw new Error(`tax_rate: malformed Dec "${trimmed}" (expected digits with at most 18 fractional digits)`);
+    }
+    const [intPart, fracPart = ''] = trimmed.split('.');
+    // intPart is guaranteed non-empty by the regex; fracPart is in [0, 18]
+    // digits so no truncation is needed (it's exactly representable).
+    const fracPadded = fracPart.padEnd(18, '0');
+    const value = BigInt(intPart) * TERRA_CLASSIC_TAX_DEC_SCALE + BigInt(fracPadded);
+    // Cap at 100% (Dec value `1.0` on the 18-decimal scale = `10^18`). A
+    // hostile or buggy LCD returning `tax_rate: '1000.0'` would otherwise
+    // drain the user — real Terra rates are < 5%.
+    if (value > TERRA_CLASSIC_TAX_DEC_SCALE) {
+        throw new Error(`tax_rate: rate above 100% rejected (${trimmed})`);
+    }
+    return value;
+};
+/**
+ * Fetches the current Terra Classic stability tax rate as an 18-decimal
+ * fixed-point bigint (e.g. `0n` if paused, `12_000_000_000_000_000n` if
+ * 1.2%). Throws when the LCD response is HTTP 200 but missing `tax_rate` —
+ * fail-closed, because silently treating "missing" as `0n` would
+ * undercalculate fees if a flaky LCD started returning `{}` after the chain
+ * un-pauses the tax (causing post-sign "insufficient fee" rejections).
+ */
+export async function getTerraClassicTaxRate(opts = {}) {
+    const raw = await lcdGetJson(getTerraClassicTaxRateUrl(), opts);
+    if (raw.tax_rate === undefined || raw.tax_rate === null) {
+        throw new Error('tax_rate: missing field on 200 response');
+    }
+    return parseDecToFixed18(raw.tax_rate);
+}
+/**
+ * Fetches the per-denom tax cap as a base-unit bigint (e.g.
+ * `60_000_000_000_000_000n` for `uluna`). The cap is the maximum tax that
+ * can be levied on a single transfer regardless of the rate-derived
+ * amount — when the chain re-enables the tax, large `uusd` transfers in
+ * particular hit the cap rather than the rate.
+ *
+ * Returns `null` ONLY for HTTP 404 ("no entry for this denom") — the
+ * caller treats `null` as "no per-denom cap" (the math helper interprets
+ * a missing cap as `+∞`).
+ *
+ * Fails closed (throws) on any other shape we don't recognize — including
+ * a `200` response with the `tax_cap` field missing or null. A flaky or
+ * tampered LCD that drops the field would otherwise turn a capped denom
+ * into an uncapped one and overcharge the user. Codex round-1 P1.
+ */
+export async function getTerraClassicTaxCap(denom, opts = {}) {
+    let raw;
+    try {
+        raw = await lcdGetJson(getTerraClassicTaxCapsUrl(denom), opts);
+    }
+    catch (e) {
+        // 404 ⇒ "no entry for this denom" (semantically uncapped).
+        if (e instanceof Error && e.message.startsWith('LCD 404'))
+            return null;
+        throw e;
+    }
+    if (raw.tax_cap === undefined || raw.tax_cap === null) {
+        throw new Error(`tax_cap: 200 response missing tax_cap for ${denom} — refusing to fail-open and overcharge`);
+    }
+    if (!/^[0-9]+$/.test(raw.tax_cap)) {
+        throw new Error(`tax_cap: malformed bigint "${raw.tax_cap}"`);
+    }
+    return BigInt(raw.tax_cap);
+}
+// ---------------------------------------------------------------------------
+// Pure math
+// ---------------------------------------------------------------------------
+/**
+ * Pure helper: given a transfer `amount`, its `denom`, the current 18-decimal
+ * `rate`, and a per-denom `caps` map, returns the stability tax in base
+ * units of `denom`.
+ *
+ * Rules (mirroring x/treasury's ante handler):
+ * - `denom === 'uluna'` is fee-exempt → returns `0n`.
+ * - `rate === 0n` → returns `0n` (the most common case today; lets callers
+ *   skip the cap fetch entirely and avoid spurious LCD load).
+ * - Otherwise, `tax = floor(amount * rate / 10^18)`, then clamp to
+ *   `caps[denom]` if present (cap of `null`/missing = uncapped).
+ *
+ * `floor` matches the cosmos-sdk Dec.MulInt rounding for positive values.
+ */
+export const applyTerraClassicTax = (amount, denom, rate, caps) => {
+    if (amount < 0n) {
+        throw new Error('applyTerraClassicTax: amount must be non-negative');
+    }
+    if (rate < 0n) {
+        throw new Error('applyTerraClassicTax: rate must be non-negative');
+    }
+    if (denom === 'uluna')
+        return 0n;
+    if (rate === 0n)
+        return 0n;
+    const raw = (amount * rate) / TERRA_CLASSIC_TAX_DEC_SCALE;
+    const cap = caps[denom];
+    if (cap === undefined || cap === null)
+        return raw;
+    if (cap < 0n) {
+        throw new Error(`applyTerraClassicTax: negative cap for ${denom}`);
+    }
+    return raw < cap ? raw : cap;
+};
+//# sourceMappingURL=terraClassicTax.js.map

package/dist/chains/cosmos/terraClassicTax.js.map

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

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

@@ -2,7 +2,7 @@
  * Midgard base URL used by every helper in this module. Matches what
  * vultisig-ios and the rujira package use as the default mainnet endpoint.
  */
-export declare const thorchainMidgardBaseUrl = "https://midgard.ninerealms.com";
+export declare const thorchainMidgardBaseUrl = "https://midgard.thorchain.network";
 /**
  * Validate a THORChain pool id is in the canonical format.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"pools.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/pools.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,uBAAuB,mCAAmC,CAAA;AA2BvE;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,IAahD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,OAG5C,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,oBAAoB,EAAE,MAAM,CAAA;CAC7B,CAAA;AAsBD,MAAM,MAAM,wBAAwB,GAAG;IACrC,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAS,wBAA6B,KACrC,OAAO,CAAC,oBAAoB,EAAE,CAahC,CAAA"}
+{"version":3,"file":"pools.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/pools.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,uBAAuB,sCAAsC,CAAA;AA2B1E;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,IAahD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,OAG5C,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,oBAAoB,EAAE,MAAM,CAAA;CAC7B,CAAA;AAsBD,MAAM,MAAM,wBAAwB,GAAG;IACrC,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAS,wBAA6B,KACrC,OAAO,CAAC,oBAAoB,EAAE,CAahC,CAAA"}

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

@@ -3,7 +3,7 @@ import { queryUrl } from '@vultisig/lib-utils/query/queryUrl';
  * Midgard base URL used by every helper in this module. Matches what
  * vultisig-ios and the rujira package use as the default mainnet endpoint.
  */
-export const thorchainMidgardBaseUrl = 'https://midgard.ninerealms.com';
+export const thorchainMidgardBaseUrl = 'https://midgard.thorchain.network';
 /**
  * Canonical THORChain pool-id format: `CHAIN.ASSET` for native assets
  * (e.g. `BTC.BTC`, `ETH.ETH`) or `CHAIN.ASSET-CONTRACT` for ERC-20-style

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

@@ -1 +1 @@
-{"version":3,"file":"pools.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/pools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAA;AAE7D;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,gCAAgC,CAAA;AAEvE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,GAAG,qCAAqC,CAAA;AAExD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAQ,EAAE;IACtD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,8DAA8D,OAAO,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACvG,CAAA;IACH,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,sBAAsB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,qCAAqC;YAC7E,0EAA0E;YAC1E,+DAA+D,CAClE,CAAA;IACH,CAAC;AACH,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAW,EAAE;IACrD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAC/D,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC,CAAA;AA2BD,MAAM,aAAa,GAAG,CAAC,GAAY,EAAwB,EAAE,CAAC,CAAC;IAC7D,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE;IACtB,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE;IACxB,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,GAAG;IACjC,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,GAAG;IAC/B,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,GAAG;IACzC,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,GAAG;IAC/B,oBAAoB,EAAE,GAAG,CAAC,oBAAoB,IAAI,GAAG;CACtD,CAAC,CAAA;AAOF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EACpC,UAAoC,EAAE,EACL,EAAE;IACnC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAA;IAC1E,MAAM,GAAG,GACP,MAAM,KAAK,IAAI;QACb,CAAC,CAAC,GAAG,uBAAuB,WAAW;QACvC,CAAC,CAAC,GAAG,uBAAuB,oBAAoB,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAA;IAChF,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAU,GAAG,CAAC,CAAA;IACxC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,6CAA6C,GAAG,SAAS,OAAO,GAAG,EAAE,CACtE,CAAA;IACH,CAAC;IACD,OAAQ,GAAiB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;AAC9C,CAAC,CAAA"}
+{"version":3,"file":"pools.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/thor/lp/pools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAA;AAE7D;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,mCAAmC,CAAA;AAE1E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,GAAG,qCAAqC,CAAA;AAExD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAQ,EAAE;IACtD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,8DAA8D,OAAO,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACvG,CAAA;IACH,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,sBAAsB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,qCAAqC;YAC7E,0EAA0E;YAC1E,+DAA+D,CAClE,CAAA;IACH,CAAC;AACH,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAW,EAAE;IACrD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAC/D,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC,CAAA;AA2BD,MAAM,aAAa,GAAG,CAAC,GAAY,EAAwB,EAAE,CAAC,CAAC;IAC7D,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE;IACtB,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE;IACxB,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,GAAG;IACjC,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,GAAG;IAC/B,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,GAAG;IACzC,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,GAAG;IAC/B,oBAAoB,EAAE,GAAG,CAAC,oBAAoB,IAAI,GAAG;CACtD,CAAC,CAAA;AAOF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EACpC,UAAoC,EAAE,EACL,EAAE;IACnC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAA;IAC1E,MAAM,GAAG,GACP,MAAM,KAAK,IAAI;QACb,CAAC,CAAC,GAAG,uBAAuB,WAAW;QACvC,CAAC,CAAC,GAAG,uBAAuB,oBAAoB,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAA;IAChF,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAU,GAAG,CAAC,CAAA;IACxC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,6CAA6C,GAAG,SAAS,OAAO,GAAG,EAAE,CACtE,CAAA;IACH,CAAC;IACD,OAAQ,GAAiB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;AAC9C,CAAC,CAAA"}

package/dist/chains/ton/messageBody/decode.d.ts

@@ -0,0 +1,42 @@
+import { TonMessageBodyIntent } from './types.js';
+export declare const tonPayloadToBase64: (payload?: string | null) => string | null;
+/**
+ * Input to {@link decodeTonMessageBody}. `outerDestination` is the `to` field
+ * of the outgoing TON message (`TonMessage.to` in the keysign payload). It is
+ * required to bind opcode-based swap classification to known router contracts.
+ */
+export type DecodeTonMessageBodyInput = {
+    payload: string | null | undefined;
+    outerDestination: string | null | undefined;
+};
+/**
+ * Decode the body BOC of a TON internal message into a structured intent.
+ *
+ * Accepts the base64 BOC carried in `TonMessage.payload` (Vultisig's keysign
+ * payload schema) along with the outer message destination. Returns `null`
+ * when the payload is empty, not a parseable BOC, has no opcode header, or
+ * carries an opcode this decoder doesn't yet handle — callers should fall
+ * back to displaying the raw TON transfer.
+ *
+ * **Router binding.** Opcodes are contract-local in TON, so an attacker can
+ * craft a body whose leading 32 bits collide with a known DEX swap opcode. To
+ * prevent the keysign UI from labeling such a body as a "swap":
+ *
+ * - `DEDUST_NATIVE_SWAP` is dispatched only when `outerDestination` is a
+ *   known DeDust **native vault** (NOT the factory — the factory only
+ *   receives `create_vault`/`create_pool` ops; `swap#ea06185d` lives on
+ *   the per-asset vault contracts per
+ *   https://docs.dedust.io/reference/tlb-schemes).
+ * - `PTON_TRANSFER` (STON.fi v2 TON-side swap) is dispatched only when
+ *   `outerDestination` is a known STON.fi v2 pTON wallet.
+ * - STON.fi v2 jetton-swap detection inside `JETTON_TRANSFER` is gated on
+ *   the inner `destination` field being a known STON.fi v2 router.
+ *
+ * DeDust jetton-swap detection is intentionally not provided — DeDust vaults
+ * are per-jetton and not statically enumerable.
+ *
+ * Note: dApps sometimes prefix a jetton transfer body with an empty 32-bit
+ * "text comment" header (op = 0). In that case, we look at the next 32 bits.
+ */
+export declare const decodeTonMessageBody: ({ payload: payloadBase64, outerDestination, }: DecodeTonMessageBodyInput) => TonMessageBodyIntent | null;
+//# sourceMappingURL=decode.d.ts.map

package/dist/chains/ton/messageBody/decode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/chains/ton/messageBody/decode.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,oBAAoB,EAAiB,MAAM,SAAS,CAAA;AA2B7D,eAAO,MAAM,kBAAkB,GAAI,UAAU,MAAM,GAAG,IAAI,KAAG,MAAM,GAAG,IAOrE,CAAA;AAqRD;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IAClC,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CAC5C,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,oBAAoB,GAAI,+CAGlC,yBAAyB,KAAG,oBAAoB,GAAG,IA0CrD,CAAA"}