@vultisig/core-chain 2.17.11 → 2.19.0

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # @vultisig/core-chain
 
+## 2.19.0
+
+### Minor Changes
+
+- [#894](https://github.com/vultisig/vultisig-sdk/pull/894) [`605fbba`](https://github.com/vultisig/vultisig-sdk/commit/605fbbaf107c553898f11f4f7eb6b56a59c01b9e) Thanks [@Ehsan-saradar](https://github.com/Ehsan-saradar)! - feat(swap): add Jupiter as a Solana same-chain swap provider with a VULT-scaled affiliate fee
+
+  `findSwapQuote` now offers Jupiter for on-Solana token pairs (SOL↔SPL, SPL↔SPL),
+  preferred over SwapKit/LiFi on a near-tie. Jupiter is Solana-only and same-chain
+  — it is never offered for any cross-chain route, and native SOL cross-chain swaps
+  stay on THORChain.
+
+  The Jupiter quote sends `platformFeeBps` = `max(0, 50 − vultTierDiscountBps)`
+  (the existing `getSwapAffiliateBps` value, shared with every other provider), and
+  the swap request sends `feeAccount` = the Associated Token Account of
+  `(owner = Vultisig fee wallet, mint = output mint)`. An idempotent
+  `createAssociatedTokenAccount` instruction for that fee ATA is prepended to the
+  returned transaction (Jupiter does not auto-create it). When the affiliate bps
+  floors to 0 (Ultimate-tier VULT holder), no platform fee or fee account is used.
+
+  New public surface: `swap/general/jupiter/*` (`getJupiterSwapQuote`,
+  `configureJupiter`, `jupiterSwapEnabledChains`) and `jupiter` added to
+  `generalSwapProviders` and the swap explorer providers.
+
+- [#893](https://github.com/vultisig/vultisig-sdk/pull/893) [`552064c`](https://github.com/vultisig/vultisig-sdk/commit/552064cbfb7307867f9897734c010e856f8a08f9) Thanks [@Ehsan-saradar](https://github.com/Ehsan-saradar)! - Add TON nominator-pool staking support. `@vultisig/core-chain` gains a tonapi staking client (`chains/ton/staking`) — pool list, computed pool info, and account nominator positions — plus per-implementation deposit/withdraw comment resolution (`whales` → `Deposit`/`Withdraw`, `tf` → `d`/`w`), pool eligibility/capacity filters, and a `tonAddressToBounceable` helper that normalizes raw `0:` pool addresses to the bounceable `EQ…` form. `@vultisig/core-mpc` now forces TON transfers bounceable for any staking comment (via `isTonStakingComment`), so a rejected pool deposit/withdraw bounces back instead of being absorbed.
+
+### Patch Changes
+
+- [#886](https://github.com/vultisig/vultisig-sdk/pull/886) [`baedd96`](https://github.com/vultisig/vultisig-sdk/commit/baedd96e9d75a9d73880a59503f95b527d692428) Thanks [@rcoderdev](https://github.com/rcoderdev)! - Add an EVM chain balance batching helper backed by Multicall3.
+
+## 2.18.0
+
+### Minor Changes
+
+- [#888](https://github.com/vultisig/vultisig-sdk/pull/888) [`b61410e`](https://github.com/vultisig/vultisig-sdk/commit/b61410ef8b1d0b1baa7d249440176df23bfa471c) Thanks [@Ehsan-saradar](https://github.com/Ehsan-saradar)! - Add QBTC governance support under `chains/cosmos/qbtc/governance/`: REST clients for the Cosmos `x/gov v1` proposals, tally, votes and params endpoints, plus the domain types and wire parsers. Mirrors the existing `qbtc/claim` split and is consumed by the wallet's QBTC governance UI.
+
 ## 2.17.11
 
 ### Patch Changes

package/dist/chains/cosmos/qbtc/governance/getQbtcGovParams.d.ts

@@ -0,0 +1,8 @@
+import { QbtcGovParams } from './proposal.js';
+/**
+ * Governance params used for the detail screen's quorum hint and as a fallback
+ * voting-window length. Voting and tallying params live at different endpoints
+ * across SDK versions, so both are fetched and merged; failures are tolerated.
+ */
+export declare const getQbtcGovParams: () => Promise<QbtcGovParams>;
+//# sourceMappingURL=getQbtcGovParams.d.ts.map

package/dist/chains/cosmos/qbtc/governance/getQbtcGovParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getQbtcGovParams.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/governance/getQbtcGovParams.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAwB1C;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,QAAa,OAAO,CAAC,aAAa,CAkB9D,CAAA"}

package/dist/chains/cosmos/qbtc/governance/getQbtcGovParams.js

@@ -0,0 +1,31 @@
+import { attempt } from '@vultisig/lib-utils/attempt';
+import { queryUrl } from '@vultisig/lib-utils/query/queryUrl';
+import { govToFraction, qbtcGovBase } from './parseGov.js';
+const parseVotingPeriodSeconds = (raw) => {
+    if (typeof raw !== 'string')
+        return undefined;
+    // Cosmos durations arrive as e.g. `"172800s"`.
+    const seconds = Number(raw.replace(/s$/, ''));
+    return Number.isFinite(seconds) ? seconds : undefined;
+};
+/**
+ * Governance params used for the detail screen's quorum hint and as a fallback
+ * voting-window length. Voting and tallying params live at different endpoints
+ * across SDK versions, so both are fetched and merged; failures are tolerated.
+ */
+export const getQbtcGovParams = async () => {
+    const [votingResult, tallyingResult] = await Promise.all([
+        attempt(() => queryUrl(`${qbtcGovBase}/params/voting`)),
+        attempt(() => queryUrl(`${qbtcGovBase}/params/tallying`)),
+    ]);
+    const voting = 'data' in votingResult ? votingResult.data : undefined;
+    const tallying = 'data' in tallyingResult ? tallyingResult.data : undefined;
+    const tallyParams = tallying?.tally_params ?? tallying?.params ?? voting?.params;
+    return {
+        votingPeriodSeconds: parseVotingPeriodSeconds(voting?.voting_params?.voting_period ?? voting?.params?.voting_period),
+        quorum: govToFraction(tallyParams?.quorum),
+        threshold: govToFraction(tallyParams?.threshold),
+        vetoThreshold: govToFraction(tallyParams?.veto_threshold),
+    };
+};
+//# sourceMappingURL=getQbtcGovParams.js.map

package/dist/chains/cosmos/qbtc/governance/getQbtcGovParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getQbtcGovParams.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/governance/getQbtcGovParams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAA;AAE7D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAkBvD,MAAM,wBAAwB,GAAG,CAAC,GAAY,EAAsB,EAAE;IACpE,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC7C,+CAA+C;IAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAA;IAC7C,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;AACvD,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,IAA4B,EAAE;IACjE,MAAM,CAAC,YAAY,EAAE,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACvD,OAAO,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAiB,GAAG,WAAW,gBAAgB,CAAC,CAAC;QACvE,OAAO,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAiB,GAAG,WAAW,kBAAkB,CAAC,CAAC;KAC1E,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,MAAM,IAAI,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;IACrE,MAAM,QAAQ,GAAG,MAAM,IAAI,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;IAE3E,MAAM,WAAW,GAAG,QAAQ,EAAE,YAAY,IAAI,QAAQ,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,CAAA;IAChF,OAAO;QACL,mBAAmB,EAAE,wBAAwB,CAC3C,MAAM,EAAE,aAAa,EAAE,aAAa,IAAI,MAAM,EAAE,MAAM,EAAE,aAAa,CACtE;QACD,MAAM,EAAE,aAAa,CAAC,WAAW,EAAE,MAAM,CAAC;QAC1C,SAAS,EAAE,aAAa,CAAC,WAAW,EAAE,SAAS,CAAC;QAChD,aAAa,EAAE,aAAa,CAAC,WAAW,EAAE,cAAc,CAAC;KAC1D,CAAA;AACH,CAAC,CAAA"}

package/dist/chains/cosmos/qbtc/governance/getQbtcMyVote.d.ts

@@ -0,0 +1,12 @@
+import { QbtcGovVote } from './proposal.js';
+type GetQbtcMyVoteInput = {
+    proposalId: string;
+    voter: string;
+};
+/**
+ * The voter's recorded vote on a proposal. A 404 means "no vote yet" and
+ * resolves to `null` rather than throwing.
+ */
+export declare const getQbtcMyVote: ({ proposalId, voter }: GetQbtcMyVoteInput) => Promise<QbtcGovVote | null>;
+export {};
+//# sourceMappingURL=getQbtcMyVote.d.ts.map

package/dist/chains/cosmos/qbtc/governance/getQbtcMyVote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getQbtcMyVote.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/governance/getQbtcMyVote.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAcxC,KAAK,kBAAkB,GAAG;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAU,uBAAuB,kBAAkB,KAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAsBzG,CAAA"}

package/dist/chains/cosmos/qbtc/governance/getQbtcMyVote.js

@@ -0,0 +1,32 @@
+import { qbtcGovBase } from './parseGov.js';
+import { parseQbtcVoteOption } from './voteOption.js';
+/**
+ * The voter's recorded vote on a proposal. A 404 means "no vote yet" and
+ * resolves to `null` rather than throwing.
+ */
+export const getQbtcMyVote = async ({ proposalId, voter }) => {
+    const response = await fetch(`${qbtcGovBase}/proposals/${proposalId}/votes/${voter}`);
+    if (response.status === 404)
+        return null;
+    if (!response.ok) {
+        throw new Error(`Failed to fetch QBTC vote (${response.status}): ${response.statusText}`);
+    }
+    const data = await response.json();
+    const options = (data.vote?.options ?? [])
+        .map(({ option, weight }) => {
+        const parsed = parseQbtcVoteOption(option ?? '');
+        if (!parsed)
+            return undefined;
+        // Drop entries whose weight isn't a valid 0..1 fraction rather than
+        // coercing to 0, which would make a malformed LCD payload look like a
+        // valid vote.
+        const weightFraction = Number(weight);
+        if (!Number.isFinite(weightFraction) || weightFraction < 0 || weightFraction > 1) {
+            return undefined;
+        }
+        return { option: parsed, weight: weightFraction };
+    })
+        .filter((entry) => entry !== undefined);
+    return { options };
+};
+//# sourceMappingURL=getQbtcMyVote.js.map

package/dist/chains/cosmos/qbtc/governance/getQbtcMyVote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getQbtcMyVote.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/governance/getQbtcMyVote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC,OAAO,EAAE,mBAAmB,EAAqB,MAAM,cAAc,CAAA;AAkBrE;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,EAAsB,EAA+B,EAAE;IAC5G,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,WAAW,cAAc,UAAU,UAAU,KAAK,EAAE,CAAC,CAAA;IACrF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAA;IACxC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,CAAC,MAAM,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;IAC3F,CAAC;IACD,MAAM,IAAI,GAAiB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAChD,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC;SACvC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;QAC1B,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,IAAI,EAAE,CAAC,CAAA;QAChD,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAA;QAC7B,oEAAoE;QACpE,sEAAsE;QACtE,cAAc;QACd,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;QACrC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,cAAc,GAAG,CAAC,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;YACjF,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;IACnD,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,KAAK,EAA0D,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAA;IACjG,OAAO,EAAE,OAAO,EAAE,CAAA;AACpB,CAAC,CAAA"}

package/dist/chains/cosmos/qbtc/governance/getQbtcProposalTally.d.ts

@@ -0,0 +1,4 @@
+import { QbtcGovTally } from './proposal.js';
+/** Live tally for an in-voting proposal. */
+export declare const getQbtcProposalTally: (proposalId: string) => Promise<QbtcGovTally>;
+//# sourceMappingURL=getQbtcProposalTally.d.ts.map

package/dist/chains/cosmos/qbtc/governance/getQbtcProposalTally.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getQbtcProposalTally.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/governance/getQbtcProposalTally.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAMzC,4CAA4C;AAC5C,eAAO,MAAM,oBAAoB,GAAU,YAAY,MAAM,KAAG,OAAO,CAAC,YAAY,CAGnF,CAAA"}

package/dist/chains/cosmos/qbtc/governance/getQbtcProposalTally.js

@@ -0,0 +1,8 @@
+import { queryUrl } from '@vultisig/lib-utils/query/queryUrl';
+import { parseQbtcGovTally, qbtcGovBase } from './parseGov.js';
+/** Live tally for an in-voting proposal. */
+export const getQbtcProposalTally = async (proposalId) => {
+    const data = await queryUrl(`${qbtcGovBase}/proposals/${proposalId}/tally`);
+    return parseQbtcGovTally(data.tally);
+};
+//# sourceMappingURL=getQbtcProposalTally.js.map

package/dist/chains/cosmos/qbtc/governance/getQbtcProposalTally.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getQbtcProposalTally.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/governance/getQbtcProposalTally.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAA;AAE7D,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAY,MAAM,YAAY,CAAA;AAOrE,4CAA4C;AAC5C,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EAAE,UAAkB,EAAyB,EAAE;IACtF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAgB,GAAG,WAAW,cAAc,UAAU,QAAQ,CAAC,CAAA;IAC1F,OAAO,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AACtC,CAAC,CAAA"}

package/dist/chains/cosmos/qbtc/governance/getQbtcProposals.d.ts

@@ -0,0 +1,7 @@
+import { QbtcGovProposal } from './proposal.js';
+/**
+ * Fetches QBTC governance proposals (newest first). A single page of 100 covers
+ * the active set plus recent history without pagination, matching iOS.
+ */
+export declare const getQbtcProposals: () => Promise<QbtcGovProposal[]>;
+//# sourceMappingURL=getQbtcProposals.d.ts.map

package/dist/chains/cosmos/qbtc/governance/getQbtcProposals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getQbtcProposals.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/governance/getQbtcProposals.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAM5C;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAAa,OAAO,CAAC,eAAe,EAAE,CAOlE,CAAA"}

package/dist/chains/cosmos/qbtc/governance/getQbtcProposals.js

@@ -0,0 +1,13 @@
+import { queryUrl } from '@vultisig/lib-utils/query/queryUrl';
+import { parseQbtcGovProposal, qbtcGovBase } from './parseGov.js';
+/**
+ * Fetches QBTC governance proposals (newest first). A single page of 100 covers
+ * the active set plus recent history without pagination, matching iOS.
+ */
+export const getQbtcProposals = async () => {
+    const data = await queryUrl(`${qbtcGovBase}/proposals?pagination.limit=100&pagination.reverse=true`);
+    return (data.proposals ?? [])
+        .map(parseQbtcGovProposal)
+        .filter((proposal) => proposal !== undefined);
+};
+//# sourceMappingURL=getQbtcProposals.js.map

package/dist/chains/cosmos/qbtc/governance/getQbtcProposals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getQbtcProposals.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/governance/getQbtcProposals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAA;AAE7D,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAe,MAAM,YAAY,CAAA;AAO3E;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,IAAgC,EAAE;IACrE,MAAM,IAAI,GAAG,MAAM,QAAQ,CACzB,GAAG,WAAW,yDAAyD,CACxE,CAAA;IACD,OAAO,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;SAC1B,GAAG,CAAC,oBAAoB,CAAC;SACzB,MAAM,CAAC,CAAC,QAAQ,EAA+B,EAAE,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAA;AAC9E,CAAC,CAAA"}

package/dist/chains/cosmos/qbtc/governance/parseGov.d.ts

@@ -0,0 +1,26 @@
+import { QbtcGovProposal, QbtcGovTally } from './proposal.js';
+/** Base path for the Cosmos `x/gov v1` REST endpoints on the QBTC node. */
+export declare const qbtcGovBase = "https://api.vultisig.com/qbtc-rpc/cosmos/gov/v1";
+export declare const govToBigInt: (value: unknown) => bigint;
+export declare const govToFraction: (value: unknown) => number | undefined;
+export type RawTally = {
+    yes_count?: string;
+    abstain_count?: string;
+    no_count?: string;
+    no_with_veto_count?: string;
+};
+export declare const parseQbtcGovTally: (raw: RawTally | undefined) => QbtcGovTally;
+export type RawProposal = {
+    id?: string;
+    title?: string;
+    summary?: string;
+    status?: string;
+    final_tally_result?: RawTally;
+    voting_start_time?: string;
+    voting_end_time?: string;
+    messages?: {
+        '@type'?: string;
+    }[];
+};
+export declare const parseQbtcGovProposal: (raw: RawProposal) => QbtcGovProposal | undefined;
+//# sourceMappingURL=parseGov.d.ts.map

package/dist/chains/cosmos/qbtc/governance/parseGov.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseGov.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/governance/parseGov.ts"],"names":[],"mappings":"AAGA,OAAO,EAA8C,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEtG,2EAA2E;AAC3E,eAAO,MAAM,WAAW,oDAAiC,CAAA;AAEzD,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,MAK5C,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAIvD,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,KAAK,QAAQ,GAAG,SAAS,KAAG,YAQ7D,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kBAAkB,CAAC,EAAE,QAAQ,CAAA;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAClC,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,KAAK,WAAW,KAAG,eAAe,GAAG,SAczE,CAAA"}

package/dist/chains/cosmos/qbtc/governance/parseGov.js

@@ -0,0 +1,46 @@
+import { qbtcRestUrl } from '@vultisig/core-chain/chains/cosmos/qbtc/tendermintRpcUrl';
+import { attempt } from '@vultisig/lib-utils/attempt';
+import { emptyQbtcGovTally, parseQbtcProposalStatus } from './proposal.js';
+/** Base path for the Cosmos `x/gov v1` REST endpoints on the QBTC node. */
+export const qbtcGovBase = `${qbtcRestUrl}/cosmos/gov/v1`;
+export const govToBigInt = (value) => {
+    if (typeof value !== 'string' || value.length === 0)
+        return 0n;
+    const parsed = attempt(() => BigInt(value));
+    if ('error' in parsed)
+        return 0n;
+    return parsed.data >= 0n ? parsed.data : 0n;
+};
+export const govToFraction = (value) => {
+    if (typeof value !== 'string' || value.length === 0)
+        return undefined;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+};
+export const parseQbtcGovTally = (raw) => {
+    if (!raw)
+        return emptyQbtcGovTally;
+    return {
+        yes: govToBigInt(raw.yes_count),
+        abstain: govToBigInt(raw.abstain_count),
+        no: govToBigInt(raw.no_count),
+        noWithVeto: govToBigInt(raw.no_with_veto_count),
+    };
+};
+export const parseQbtcGovProposal = (raw) => {
+    if (typeof raw.id !== 'string' || raw.id.length === 0)
+        return undefined;
+    return {
+        id: raw.id,
+        title: raw.title ?? '',
+        summary: raw.summary ?? '',
+        status: parseQbtcProposalStatus(raw.status ?? ''),
+        finalTally: parseQbtcGovTally(raw.final_tally_result),
+        votingStartTime: raw.voting_start_time,
+        votingEndTime: raw.voting_end_time,
+        messageTypes: (raw.messages ?? [])
+            .map(message => message['@type'])
+            .filter((type) => typeof type === 'string'),
+    };
+};
+//# sourceMappingURL=parseGov.js.map

package/dist/chains/cosmos/qbtc/governance/parseGov.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseGov.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/governance/parseGov.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0DAA0D,CAAA;AACtF,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAA;AAErD,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAiC,MAAM,YAAY,CAAA;AAEtG,2EAA2E;AAC3E,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,WAAW,gBAAgB,CAAA;AAEzD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAc,EAAU,EAAE;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IAC3C,IAAI,OAAO,IAAI,MAAM;QAAE,OAAO,EAAE,CAAA;IAChC,OAAO,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA;AAC7C,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAsB,EAAE;IAClE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACrE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC5B,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;AACrD,CAAC,CAAA;AASD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAAyB,EAAgB,EAAE;IAC3E,IAAI,CAAC,GAAG;QAAE,OAAO,iBAAiB,CAAA;IAClC,OAAO;QACL,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC;QAC/B,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC;QACvC,EAAE,EAAE,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC7B,UAAU,EAAE,WAAW,CAAC,GAAG,CAAC,kBAAkB,CAAC;KAChD,CAAA;AACH,CAAC,CAAA;AAaD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,GAAgB,EAA+B,EAAE;IACpF,IAAI,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,IAAI,GAAG,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACvE,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE;QACtB,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE;QAC1B,MAAM,EAAE,uBAAuB,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;QACjD,UAAU,EAAE,iBAAiB,CAAC,GAAG,CAAC,kBAAkB,CAAC;QACrD,eAAe,EAAE,GAAG,CAAC,iBAAiB;QACtC,aAAa,EAAE,GAAG,CAAC,eAAe;QAClC,YAAY,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;aAC/B,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;aAChC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;KAC9D,CAAA;AACH,CAAC,CAAA"}

package/dist/chains/cosmos/qbtc/governance/proposal.d.ts

@@ -0,0 +1,64 @@
+import { QbtcVoteOptionKey } from './voteOption.js';
+/**
+ * Subset of Cosmos `x/gov` proposal statuses surfaced by the QBTC governance
+ * UI. `votingPeriod` is the only votable state.
+ */
+export declare const qbtcProposalStatuses: readonly ["depositPeriod", "votingPeriod", "passed", "rejected", "failed", "unspecified"];
+export type QbtcProposalStatus = (typeof qbtcProposalStatuses)[number];
+/** Maps the LCD wire status (`PROPOSAL_STATUS_*`) onto our union. */
+export declare const parseQbtcProposalStatus: (wire: string) => QbtcProposalStatus;
+/** A proposal is votable only while in its voting period. */
+export declare const isActiveQbtcProposal: (status: QbtcProposalStatus) => boolean;
+/**
+ * Tally counts in the staking base unit, keyed by option. Stored as `bigint`
+ * because validator-weighted totals routinely exceed `Number.MAX_SAFE_INTEGER`;
+ * the UI only ever needs their ratios.
+ */
+export type QbtcGovTally = Record<QbtcVoteOptionKey, bigint>;
+export declare const emptyQbtcGovTally: QbtcGovTally;
+export declare const qbtcGovTallyTotal: (tally: QbtcGovTally) => bigint;
+export type QbtcGovProposal = {
+    id: string;
+    title: string;
+    summary: string;
+    status: QbtcProposalStatus;
+    /** Embedded tally — all-zero for active proposals until the live `/tally`
+     * endpoint is queried. */
+    finalTally: QbtcGovTally;
+    /** RFC3339 timestamps as returned by the chain; `undefined` if absent. */
+    votingStartTime?: string;
+    votingEndTime?: string;
+    /** Wrapped message type URLs (e.g. `/cosmos.gov.v1.MsgExecLegacyContent`). */
+    messageTypes: string[];
+};
+/** A weighted option from the voter's recorded vote (`weight` as a fraction). */
+export type QbtcGovVoteOption = {
+    option: QbtcVoteOptionKey;
+    weight: number;
+};
+/** The voter's recorded vote on a proposal, or `null` if they haven't voted. */
+export type QbtcGovVote = {
+    options: QbtcGovVoteOption[];
+};
+export type QbtcGovParams = {
+    votingPeriodSeconds?: number;
+    quorum?: number;
+    threshold?: number;
+    vetoThreshold?: number;
+};
+/**
+ * A user's pending vote selection, threaded through navigation to the verify
+ * screen. `weightPercent` is an integer 0–100; it is normalised to an
+ * 18-decimal `cosmos.Dec` string only when the `MsgVoteWeighted` is built.
+ */
+export type QbtcVoteSelection = {
+    kind: 'single';
+    option: QbtcVoteOptionKey;
+} | {
+    kind: 'weighted';
+    options: {
+        option: QbtcVoteOptionKey;
+        weightPercent: number;
+    }[];
+};
+//# sourceMappingURL=proposal.d.ts.map

package/dist/chains/cosmos/qbtc/governance/proposal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposal.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/governance/proposal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAEhD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,2FAOvB,CAAA;AAEV,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEtE,qEAAqE;AACrE,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,KAAG,kBAetD,CAAA;AAED,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB,GAAI,QAAQ,kBAAkB,KAAG,OAAoC,CAAA;AAEtG;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAA;AAE5D,eAAO,MAAM,iBAAiB,EAAE,YAK/B,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,OAAO,YAAY,KAAG,MACC,CAAA;AAEzD,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,kBAAkB,CAAA;IAC1B;8BAC0B;IAC1B,UAAU,EAAE,YAAY,CAAA;IACxB,0EAA0E;IAC1E,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,8EAA8E;IAC9E,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB,CAAA;AAED,iFAAiF;AACjF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,iBAAiB,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,gFAAgF;AAChF,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,iBAAiB,EAAE,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,GAC7C;IACE,IAAI,EAAE,UAAU,CAAA;IAChB,OAAO,EAAE;QAAE,MAAM,EAAE,iBAAiB,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAChE,CAAA"}

package/dist/chains/cosmos/qbtc/governance/proposal.js

@@ -0,0 +1,39 @@
+/**
+ * Subset of Cosmos `x/gov` proposal statuses surfaced by the QBTC governance
+ * UI. `votingPeriod` is the only votable state.
+ */
+export const qbtcProposalStatuses = [
+    'depositPeriod',
+    'votingPeriod',
+    'passed',
+    'rejected',
+    'failed',
+    'unspecified',
+];
+/** Maps the LCD wire status (`PROPOSAL_STATUS_*`) onto our union. */
+export const parseQbtcProposalStatus = (wire) => {
+    switch (wire) {
+        case 'PROPOSAL_STATUS_DEPOSIT_PERIOD':
+            return 'depositPeriod';
+        case 'PROPOSAL_STATUS_VOTING_PERIOD':
+            return 'votingPeriod';
+        case 'PROPOSAL_STATUS_PASSED':
+            return 'passed';
+        case 'PROPOSAL_STATUS_REJECTED':
+            return 'rejected';
+        case 'PROPOSAL_STATUS_FAILED':
+            return 'failed';
+        default:
+            return 'unspecified';
+    }
+};
+/** A proposal is votable only while in its voting period. */
+export const isActiveQbtcProposal = (status) => status === 'votingPeriod';
+export const emptyQbtcGovTally = {
+    yes: 0n,
+    abstain: 0n,
+    no: 0n,
+    noWithVeto: 0n,
+};
+export const qbtcGovTallyTotal = (tally) => tally.yes + tally.abstain + tally.no + tally.noWithVeto;
+//# sourceMappingURL=proposal.js.map

package/dist/chains/cosmos/qbtc/governance/proposal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposal.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/governance/proposal.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,eAAe;IACf,cAAc;IACd,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,aAAa;CACL,CAAA;AAIV,qEAAqE;AACrE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,IAAY,EAAsB,EAAE;IAC1E,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,gCAAgC;YACnC,OAAO,eAAe,CAAA;QACxB,KAAK,+BAA+B;YAClC,OAAO,cAAc,CAAA;QACvB,KAAK,wBAAwB;YAC3B,OAAO,QAAQ,CAAA;QACjB,KAAK,0BAA0B;YAC7B,OAAO,UAAU,CAAA;QACnB,KAAK,wBAAwB;YAC3B,OAAO,QAAQ,CAAA;QACjB;YACE,OAAO,aAAa,CAAA;IACxB,CAAC;AACH,CAAC,CAAA;AAED,6DAA6D;AAC7D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAA0B,EAAW,EAAE,CAAC,MAAM,KAAK,cAAc,CAAA;AAStG,MAAM,CAAC,MAAM,iBAAiB,GAAiB;IAC7C,GAAG,EAAE,EAAE;IACP,OAAO,EAAE,EAAE;IACX,EAAE,EAAE,EAAE;IACN,UAAU,EAAE,EAAE;CACf,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAmB,EAAU,EAAE,CAC/D,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,UAAU,CAAA"}

package/dist/chains/cosmos/qbtc/governance/voteOption.d.ts

@@ -0,0 +1,17 @@
+/**
+ * QBTC governance vote options, in canonical Cosmos `x/gov` order. The QBTC
+ * chain reuses the standard Cosmos `VoteOption` enum, so these map 1:1 onto the
+ * proto values (1=YES … 4=NO_WITH_VETO) used when building `MsgVote` /
+ * `MsgVoteWeighted`.
+ */
+export declare const qbtcVoteOptionKeys: readonly ["yes", "abstain", "no", "noWithVeto"];
+export type QbtcVoteOptionKey = (typeof qbtcVoteOptionKeys)[number];
+/** Cosmos `VoteOption` proto enum value for each option. */
+export declare const qbtcVoteOptionProtoValue: Record<QbtcVoteOptionKey, number>;
+/**
+ * Decodes the option field returned by the gov LCD (`/votes/{voter}`), which
+ * may be the proto enum name (`VOTE_OPTION_YES`) or its numeric string (`"1"`).
+ * Returns `undefined` for unknown/unspecified values so callers can skip them.
+ */
+export declare const parseQbtcVoteOption: (wire: string) => QbtcVoteOptionKey | undefined;
+//# sourceMappingURL=voteOption.d.ts.map

package/dist/chains/cosmos/qbtc/governance/voteOption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voteOption.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/governance/voteOption.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,iDAAkD,CAAA;AAEjF,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnE,4DAA4D;AAC5D,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAKtE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,KAAG,iBAAiB,GAAG,SAiBtE,CAAA"}

package/dist/chains/cosmos/qbtc/governance/voteOption.js

@@ -0,0 +1,38 @@
+/**
+ * QBTC governance vote options, in canonical Cosmos `x/gov` order. The QBTC
+ * chain reuses the standard Cosmos `VoteOption` enum, so these map 1:1 onto the
+ * proto values (1=YES … 4=NO_WITH_VETO) used when building `MsgVote` /
+ * `MsgVoteWeighted`.
+ */
+export const qbtcVoteOptionKeys = ['yes', 'abstain', 'no', 'noWithVeto'];
+/** Cosmos `VoteOption` proto enum value for each option. */
+export const qbtcVoteOptionProtoValue = {
+    yes: 1,
+    abstain: 2,
+    no: 3,
+    noWithVeto: 4,
+};
+/**
+ * Decodes the option field returned by the gov LCD (`/votes/{voter}`), which
+ * may be the proto enum name (`VOTE_OPTION_YES`) or its numeric string (`"1"`).
+ * Returns `undefined` for unknown/unspecified values so callers can skip them.
+ */
+export const parseQbtcVoteOption = (wire) => {
+    switch (wire) {
+        case 'VOTE_OPTION_YES':
+        case '1':
+            return 'yes';
+        case 'VOTE_OPTION_ABSTAIN':
+        case '2':
+            return 'abstain';
+        case 'VOTE_OPTION_NO':
+        case '3':
+            return 'no';
+        case 'VOTE_OPTION_NO_WITH_VETO':
+        case '4':
+            return 'noWithVeto';
+        default:
+            return undefined;
+    }
+};
+//# sourceMappingURL=voteOption.js.map

package/dist/chains/cosmos/qbtc/governance/voteOption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voteOption.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/governance/voteOption.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,CAAU,CAAA;AAIjF,4DAA4D;AAC5D,MAAM,CAAC,MAAM,wBAAwB,GAAsC;IACzE,GAAG,EAAE,CAAC;IACN,OAAO,EAAE,CAAC;IACV,EAAE,EAAE,CAAC;IACL,UAAU,EAAE,CAAC;CACd,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAY,EAAiC,EAAE;IACjF,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,iBAAiB,CAAC;QACvB,KAAK,GAAG;YACN,OAAO,KAAK,CAAA;QACd,KAAK,qBAAqB,CAAC;QAC3B,KAAK,GAAG;YACN,OAAO,SAAS,CAAA;QAClB,KAAK,gBAAgB,CAAC;QACtB,KAAK,GAAG;YACN,OAAO,IAAI,CAAA;QACb,KAAK,0BAA0B,CAAC;QAChC,KAAK,GAAG;YACN,OAAO,YAAY,CAAA;QACrB;YACE,OAAO,SAAS,CAAA;IACpB,CAAC;AACH,CAAC,CAAA"}

package/dist/chains/ton/address.d.ts

@@ -3,4 +3,13 @@
  * The toncenter v3 API requires raw addresses.
  */
 export declare const tonAddressToRaw: (userFriendlyAddress: string) => string;
+/**
+ * Converts a raw TON address (`workchain:hex`) to the bounceable user-friendly
+ * form (`EQ…`). Staking-API pool addresses arrive in raw `0:` form, which the
+ * signer treats as non-bounceable — sending a deposit non-bounceable risks the
+ * pool absorbing (losing) a rejected transfer instead of bouncing it back, so
+ * pool destinations MUST be normalized to the bounceable form first. Inputs
+ * already in user-friendly form are returned re-encoded as bounceable.
+ */
+export declare const tonAddressToBounceable: (address: string) => string;
 //# sourceMappingURL=address.d.ts.map

package/dist/chains/ton/address.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/ton/address.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,qBAAqB,MAAM,KAAG,MAM7D,CAAA"}
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/ton/address.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,qBAAqB,MAAM,KAAG,MAM7D,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,MAAM,KAAG,MAIxD,CAAA"}

package/dist/chains/ton/address.js

@@ -1,3 +1,4 @@
+import { Address } from '@ton/core';
 import { fromBase64 } from '@vultisig/lib-utils/fromBase64';
 /** Converts base64url encoding to standard base64 so `Buffer.from` can decode it. */
 const fromBase64Url = (value) => {
@@ -14,4 +15,16 @@ export const tonAddressToRaw = (userFriendlyAddress) => {
     const hash = decoded.subarray(2, 34).toString('hex');
     return `${workchain}:${hash}`;
 };
+/**
+ * Converts a raw TON address (`workchain:hex`) to the bounceable user-friendly
+ * form (`EQ…`). Staking-API pool addresses arrive in raw `0:` form, which the
+ * signer treats as non-bounceable — sending a deposit non-bounceable risks the
+ * pool absorbing (losing) a rejected transfer instead of bouncing it back, so
+ * pool destinations MUST be normalized to the bounceable form first. Inputs
+ * already in user-friendly form are returned re-encoded as bounceable.
+ */
+export const tonAddressToBounceable = (address) => {
+    const parsed = address.includes(':') ? Address.parseRaw(address) : Address.parse(address);
+    return parsed.toString({ bounceable: true, testOnly: false, urlSafe: true });
+};
 //# sourceMappingURL=address.js.map

package/dist/chains/ton/address.js.map

@@ -1 +1 @@
-{"version":3,"file":"address.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/ton/address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAE3D,qFAAqF;AACrF,MAAM,aAAa,GAAG,CAAC,KAAa,EAAU,EAAE;IAC9C,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAClE,OAAO,UAAU,CAAC,cAAc,CAAC,CAAA;AACnC,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,mBAA2B,EAAU,EAAE;IACrE,MAAM,OAAO,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAA;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACnE,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAEpD,OAAO,GAAG,SAAS,IAAI,IAAI,EAAE,CAAA;AAC/B,CAAC,CAAA"}
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/ton/address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAE3D,qFAAqF;AACrF,MAAM,aAAa,GAAG,CAAC,KAAa,EAAU,EAAE;IAC9C,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAClE,OAAO,UAAU,CAAC,cAAc,CAAC,CAAA;AACnC,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,mBAA2B,EAAU,EAAE;IACrE,MAAM,OAAO,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAA;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACnE,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAEpD,OAAO,GAAG,SAAS,IAAI,IAAI,EAAE,CAAA;AAC/B,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,OAAe,EAAU,EAAE;IAChE,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAEzF,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;AAC9E,CAAC,CAAA"}

package/dist/chains/ton/staking.d.ts

@@ -0,0 +1,104 @@
+/**
+ * tonapi `implementation` values that are genuine **nominator pools** — the
+ * only ones the text-comment deposit/withdraw mechanism can stake into.
+ * `liquidTF` (Tonstakers) mints a jetton instead and is excluded; unknown
+ * implementations are treated as non-nominator (excluded).
+ */
+export declare const tonNominatorImplementations: readonly ["whales", "tf"];
+export type TonNominatorImplementation = (typeof tonNominatorImplementations)[number];
+export declare const isTonNominatorImplementation: (implementation: string | undefined) => implementation is TonNominatorImplementation;
+/** Deposit comment for a pool implementation, or `undefined` if unsupported (block the action). */
+export declare const tonStakingDepositComment: (implementation: string | undefined) => string | undefined;
+/** Withdraw comment for a pool implementation, or `undefined` if unsupported (block the action). */
+export declare const tonStakingWithdrawComment: (implementation: string | undefined) => string | undefined;
+/**
+ * Whether a memo is a nominator-pool deposit/withdraw comment (`d`/`w`/`Deposit`
+ * /`Withdraw`). The signer uses this to force the transfer bounceable: a pool
+ * deposit/withdraw sent non-bounceable can be absorbed (lost) by the pool
+ * instead of bounced back if rejected.
+ */
+export declare const isTonStakingComment: (memo: string | undefined) => boolean;
+/**
+ * Processing-commission buffer (nanotons) added on top of a pool's `min_stake`
+ * for the minimum acceptable deposit. Depositing exactly the minimum is
+ * rejected; the pool needs ~1 TON headroom for its processing commission.
+ */
+export declare const tonStakingDepositBuffer = 1000000000n;
+/**
+ * Amount (nanotons) accompanying a withdraw message — the pool's 0.2 TON
+ * withdraw fee. The pool returns the full staked balance separately; sending
+ * more (e.g. 1 TON) fails.
+ */
+export declare const tonStakingWithdrawFee = 200000000n;
+/**
+ * Conservative network-fee reserve (nanotons ≈ 0.05 TON) held back from the
+ * spendable balance when sizing a stake deposit or checking the unstake fee is
+ * affordable. Larger than the bare base fee because the text-comment cell adds
+ * compute; matches the iOS reserve.
+ */
+export declare const tonStakingFeeReserve = 50000000n;
+/**
+ * A staking-pool list entry. `address` is the bounceable user-friendly (`EQ…`)
+ * pool contract address (normalized from the raw `0:` API form), `apy` is a
+ * percentage (e.g. `13.27` = 13.27%), and `minStake` is in nanotons.
+ */
+export type TonStakingPool = {
+    address: string;
+    name: string;
+    apy: number;
+    minStake: bigint;
+    verified: boolean;
+    currentNominators?: number;
+    maxNominators?: number;
+    implementation?: string;
+    cycleEnd?: number;
+};
+/** Whether a pool has room for another nominator (pools at capacity reject new stakes). */
+export declare const tonPoolHasCapacity: (pool: TonStakingPool) => boolean;
+/**
+ * Whether a pool is a verified nominator pool with capacity — i.e. one the
+ * picker should surface and a stake can succeed into.
+ */
+export declare const isStakeableTonPool: (pool: TonStakingPool) => boolean;
+/**
+ * Fetches all verified TON staking pools from tonapi (`/v2/staking/pools`).
+ * Includes every implementation; callers filter to stakeable nominator pools
+ * via `isStakeableTonPool`.
+ */
+export declare const getTonStakingPools: () => Promise<TonStakingPool[]>;
+/**
+ * Computed info for a single pool (`/v2/staking/pool/{address}`). All fields
+ * are optional so a partial/changed response degrades gracefully. `apy` is a
+ * percentage; `cycleEnd` is the Unix second the current validation cycle ends.
+ */
+export type TonStakingPoolInfo = {
+    address?: string;
+    name?: string;
+    apy?: number;
+    minStake?: bigint;
+    implementation?: string;
+    cycleEnd?: number;
+};
+/** Fetches computed pool metadata (name, APY, implementation, cycle end). */
+export declare const getTonStakingPoolInfo: (poolAddress: string) => Promise<TonStakingPoolInfo | undefined>;
+/**
+ * An account's position in a nominator pool. All amounts are nanotons. `amount`
+ * is the active stake; `pendingDeposit` is a just-placed stake awaiting the
+ * next validation cycle; `pendingWithdraw`/`readyWithdraw` indicate an
+ * in-progress withdrawal (funds locked until the cycle ends). `pool` is the
+ * bounceable user-friendly (`EQ…`) pool address (normalized from raw `0:`).
+ */
+export type TonNominatorPosition = {
+    pool: string;
+    amount: bigint;
+    pendingDeposit: bigint;
+    pendingWithdraw: bigint;
+    readyWithdraw: bigint;
+};
+/**
+ * Fetches an account's nominator-pool positions
+ * (`/v2/staking/nominator/{accountId}/pools`) — the authoritative source for
+ * staked positions. `accountId` accepts the user-friendly wallet address.
+ */
+export declare const getTonNominatorPools: (accountId: string) => Promise<TonNominatorPosition[]>;
+//# sourceMappingURL=staking.d.ts.map