@vultisig/core-chain 4.1.1 → 5.1.0

package/dist/chains/ripple/issuedCurrency.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"issuedCurrency.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/ripple/issuedCurrency.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,UAAU,CAAA;AAqB9C;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAU,MAAM,KAAG,MAYrD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,UAAU,MAAM,KAAG,OAEyB,CAAA;AAIpF,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,sBAAsB,oBAAoB,KAAG,MACZ,CAAA;AAE/D,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,GAAI,IAAI,MAAM,KAAG,oBAU/C,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GAAI,QAAQ,MAAM,EAAE,UAAU,MAAM,KAAG,MAU5E,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,4BAA4B,KAAK,CAAA;AAE9C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,MAAM,KAAG,MAiBxD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,EAY9C,CAAA"}
+{"version":3,"file":"issuedCurrency.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/ripple/issuedCurrency.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAG1D;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,UAAU,CAAA;AA2C9C;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAU,MAAM,KAAG,MAYrD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,UAAU,MAAM,KAAG,OAEyB,CAAA;AAIpF,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,sBAAsB,oBAAoB,KAAG,MACZ,CAAA;AAE/D,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,GAAI,IAAI,MAAM,KAAG,oBAU/C,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAAI,QAAQ,MAAM,EAAE,UAAU,MAAM,KAAG,MAU5E,CAAA;AAED,+FAA+F;AAC/F,eAAO,MAAM,+BAA+B,GAAI,yCAK7C,oBAAoB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;;;;CAqC7D,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,4BAA4B,KAAK,CAAA;AAE9C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,MAAM,KAAG,MAiBxD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,EAY9C,CAAA"}

package/dist/chains/ripple/issuedCurrency.js

@@ -1,4 +1,5 @@
 import { Chain } from '@vultisig/core-chain/Chain';
+import { isValidClassicAddress } from 'ripple-address-codec';
 /**
  * Owner-reserve locked by each XRP Ledger object a wallet owns, including every
  * trust line. Opening a trust line raises the account's required reserve by this
@@ -11,13 +12,32 @@ const standardCurrencyCodeLength = 3;
 /** Non-standard XRPL currency codes are a 160-bit value, i.e. 40 hex chars. */
 const hexCurrencyCodeLength = 40;
 const hexCurrencyCodeRegex = /^[0-9a-fA-F]{40}$/;
+/**
+ * Characters XRPL permits inside a 3-character standard currency code. Both
+ * letter cases are legal on the ledger, so `usd` is a distinct currency from
+ * `USD` rather than a malformed code.
+ * @see https://xrpl.org/docs/references/protocol/data-types/currency-formats
+ */
+const standardCurrencyCharacters = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789<>(){}[]|?!@#$%^&*';
+/**
+ * Codes the ledger reserves for native XRP. Compared case-insensitively so a
+ * lookalike such as `xrp` cannot be signed as though it were a token.
+ */
+const nativeCurrencyCodes = ['XRP', '0'.repeat(40), '0000000000000000000000005852500000000000'];
 const asciiToHexCurrencyCode = (currency) => {
-    const bytes = Buffer.from(currency, 'ascii');
+    const bytes = [...currency].map(character => {
+        const code = character.charCodeAt(0);
+        if (code > 127) {
+            throw new Error('Unsupported XRP issued-currency code: expected ASCII or a 160-bit hex code');
+        }
+        return code;
+    });
     if (bytes.length > 20) {
         throw new Error(`XRPL currency code too long: "${currency}" (max 20 bytes)`);
     }
-    return Buffer.concat([bytes, Buffer.alloc(20 - bytes.length)])
-        .toString('hex')
+    return [...bytes, ...Array(20 - bytes.length).fill(0)]
+        .map(byte => byte.toString(16).padStart(2, '0'))
+        .join('')
         .toUpperCase();
 };
 /**
@@ -68,7 +88,8 @@ export const parseRippleTokenId = (id) => {
 /**
  * Formats an issued-currency base-unit amount as an XRPL value string: a plain
  * decimal (never scientific notation) with trailing-zero fractional digits
- * trimmed. XRPL issued amounts allow up to 15 significant digits.
+ * trimmed. This formats values for display; use getSignableIssuedCurrencyAmount
+ * when the value must be exactly representable on the ledger.
  */
 export const formatIssuedCurrencyValue = (amount, decimals) => {
     const negative = amount < 0n;
@@ -78,9 +99,47 @@ export const formatIssuedCurrencyValue = (amount, decimals) => {
     const magnitude = fracPart ? `${intPart}.${fracPart}` : intPart;
     return negative && magnitude !== '0' ? `-${magnitude}` : magnitude;
 };
+/** Construct an issued amount without letting a signer change its asset or round its value. */
+export const getSignableIssuedCurrencyAmount = ({ currency, issuer, amount, decimals, }) => {
+    if ([...currency].some(character => character.charCodeAt(0) > 127)) {
+        throw new Error('Unsupported XRP issued-currency code: expected ASCII or a 160-bit hex code');
+    }
+    const code = toXrplCurrencyCode(currency);
+    const standardCode = code.length === standardCurrencyCodeLength &&
+        [...code].every(character => standardCurrencyCharacters.includes(character));
+    if ((!standardCode && !hexCurrencyCodeRegex.test(code)) || nativeCurrencyCodes.includes(code.toUpperCase())) {
+        throw new Error('Unsupported XRP issued-currency code: signing must preserve its exact identity');
+    }
+    if (!isValidClassicAddress(issuer)) {
+        throw new Error('Invalid XRP issued-currency issuer address');
+    }
+    if (!Number.isInteger(decimals) || decimals < 0 || decimals > 96 || amount < 0n) {
+        throw new Error('Invalid XRP issued-currency amount or decimal scale');
+    }
+    // XRPL uses a 16-digit mantissa and exponent [-96, 80]. Reject rather than
+    // silently truncating a quantity that the user already reviewed.
+    const digits = amount.toString();
+    const significantDigits = digits.replace(/0+$/, '').length;
+    const magnitude = digits.length - decimals - 1;
+    if (amount !== 0n && (significantDigits > 16 || magnitude < -81 || magnitude > 95)) {
+        throw new Error('XRP issued-currency amount is not exactly representable (maximum 16 significant digits)');
+    }
+    // WalletCore checks the exponent after trimming trailing zeroes, before
+    // padding the mantissa to 16 digits. Keep all signers within that supported
+    // subset and reject unsupported values before review, not during signing.
+    const trimmedExponent = digits.length - significantDigits - decimals;
+    if (amount !== 0n && trimmedExponent > 80) {
+        throw new Error('XRP issued-currency amount exceeds the supported signer exponent');
+    }
+    return {
+        currency: code,
+        issuer,
+        value: formatIssuedCurrencyValue(amount, decimals),
+    };
+};
 /**
- * XRPL issued currencies carry up to 15 significant decimal digits rather than a
- * fixed on-chain decimal count. We model them internally with this many decimals.
+ * XRPL issued currencies carry up to 16 significant decimal digits rather than a
+ * fixed on-chain decimal count. Our fixed-point balance model uses 15 decimals.
  */
 export const rippleIssuedCurrencyDecimals = 15;
 /**

package/dist/chains/ripple/issuedCurrency.js.map

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

package/dist/chains/ripple/trustLine.d.ts

@@ -0,0 +1,22 @@
+/** The `account_lines` fields that say which asset a trust line is for. */
+export type RippleTrustLineAsset = {
+    /** The line's counterparty — the issuer, from the holder's perspective. */
+    account: string;
+    currency: string;
+};
+type FindRippleTrustLineInput<T extends RippleTrustLineAsset> = {
+    lines: T[];
+    currency: string;
+    issuer: string;
+};
+/**
+ * The trust line among `lines` that holds `(currency, issuer)`, or `undefined`
+ * when the account has none.
+ *
+ * Currency codes are compared normalised, so a node spelling a non-standard code
+ * in lowercase hex still matches a token id that holds it uppercased. Issuer
+ * addresses are base58 and compared case-SENSITIVELY.
+ */
+export declare const findRippleTrustLine: <T extends RippleTrustLineAsset>({ lines, currency, issuer, }: FindRippleTrustLineInput<T>) => T | undefined;
+export {};
+//# sourceMappingURL=trustLine.d.ts.map

package/dist/chains/ripple/trustLine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trustLine.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/ripple/trustLine.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,MAAM,MAAM,oBAAoB,GAAG;IACjC,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,KAAK,wBAAwB,CAAC,CAAC,SAAS,oBAAoB,IAAI;IAC9D,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,oBAAoB,EAAE,8BAIjE,wBAAwB,CAAC,CAAC,CAAC,KAAG,CAAC,GAAG,SAIpC,CAAA"}

package/dist/chains/ripple/trustLine.js

@@ -0,0 +1,14 @@
+import { toXrplCurrencyCode } from '@vultisig/core-chain/chains/ripple/issuedCurrency';
+/**
+ * The trust line among `lines` that holds `(currency, issuer)`, or `undefined`
+ * when the account has none.
+ *
+ * Currency codes are compared normalised, so a node spelling a non-standard code
+ * in lowercase hex still matches a token id that holds it uppercased. Issuer
+ * addresses are base58 and compared case-SENSITIVELY.
+ */
+export const findRippleTrustLine = ({ lines, currency, issuer, }) => {
+    const code = toXrplCurrencyCode(currency);
+    return lines.find(line => line.account === issuer && toXrplCurrencyCode(line.currency) === code);
+};
+//# sourceMappingURL=trustLine.js.map

package/dist/chains/ripple/trustLine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trustLine.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/ripple/trustLine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAA;AAetF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAiC,EAClE,KAAK,EACL,QAAQ,EACR,MAAM,GACsB,EAAiB,EAAE;IAC/C,MAAM,IAAI,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAA;IAEzC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAA;AAClG,CAAC,CAAA"}

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

@@ -12,4 +12,36 @@ export declare const tonAddressToRaw: (userFriendlyAddress: string) => string;
  * already in user-friendly form are returned re-encoded as bounceable.
  */
 export declare const tonAddressToBounceable: (address: string) => string;
+/**
+ * What a TON destination address declares about bouncing. `unspecified` covers the
+ * raw `0:hex` spelling and anything unparseable — those carry no tag byte at all,
+ * which is exactly the case a leading-character check cannot express.
+ */
+export type TonAddressBounceability = 'bounceable' | 'nonBounceable' | 'unspecified';
+/**
+ * Reads the bounce tag out of a user-friendly TON address instead of inferring it
+ * from the leading `E`/`U`. The tag lives in the first byte of the base64 payload
+ * (`0x11` bounceable / `0x51` not, `| 0x80` on testnet) and is checksum-protected,
+ * so a raw or corrupted address reports `unspecified` rather than a flag it never
+ * declared — leaving the caller to pick the safe default for its own context.
+ */
+export declare const getTonAddressBounceability: (address: string) => TonAddressBounceability;
+/**
+ * Whether two TON addresses name the same account.
+ *
+ * One account has several textual spellings — raw `workchain:hex`, bounceable
+ * `EQ…`, non-bounceable `UQ…`, and the base64 / base64url variants of both —
+ * and only the flag byte and checksum differ between `EQ` and `UQ`. String
+ * equality therefore reports differences that do not exist, which matters
+ * wherever two independently sourced addresses are cross-checked before money
+ * moves. Input that does not parse as a TON address falls back to exact
+ * comparison rather than being reported as a match.
+ */
+export declare const areEqualTonAddresses: (left: string, right: string) => boolean;
+/**
+ * Lower-cased raw (`workchain:hex`) form of a raw or user-friendly TON address.
+ * Toncenter answers in upper-case hex and ton-assets lists lower-case hex, so
+ * every lookup keyed by a jetton master address must go through this first.
+ */
+export declare const tonAddressToRawKey: (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":"AASA;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,qBAAqB,MAAM,KAAG,MAM7D,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,MAAM,KAAG,MAIxD,CAAA"}
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/ton/address.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,qBAAqB,MAAM,KAAG,MAM7D,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,MAAM,KAAG,MAIxD,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,YAAY,GAAG,eAAe,GAAG,aAAa,CAAA;AAEpF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GAAI,SAAS,MAAM,KAAG,uBAQ5D,CAAA;AAUD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,KAAG,OAKlE,CAAA;AACD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,MAAM,KAAG,MACuB,CAAA"}

package/dist/chains/ton/address.js

@@ -1,4 +1,5 @@
 import { Address } from '@ton/core';
+import { attempt } from '@vultisig/lib-utils/attempt';
 import { fromBase64 } from '@vultisig/lib-utils/fromBase64';
 /** Converts base64url encoding to standard base64 so `Buffer.from` can decode it. */
 const fromBase64Url = (value) => {
@@ -27,4 +28,48 @@ export const tonAddressToBounceable = (address) => {
     const parsed = address.includes(':') ? Address.parseRaw(address) : Address.parse(address);
     return parsed.toString({ bounceable: true, testOnly: false, urlSafe: true });
 };
+/**
+ * Reads the bounce tag out of a user-friendly TON address instead of inferring it
+ * from the leading `E`/`U`. The tag lives in the first byte of the base64 payload
+ * (`0x11` bounceable / `0x51` not, `| 0x80` on testnet) and is checksum-protected,
+ * so a raw or corrupted address reports `unspecified` rather than a flag it never
+ * declared — leaving the caller to pick the safe default for its own context.
+ */
+export const getTonAddressBounceability = (address) => {
+    const parsed = attempt(() => Address.parseFriendly(address));
+    if ('error' in parsed) {
+        return 'unspecified';
+    }
+    return parsed.data.isBounceable ? 'bounceable' : 'nonBounceable';
+};
+const parseTonAddress = (address) => {
+    try {
+        return Address.parse(address.trim());
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * Whether two TON addresses name the same account.
+ *
+ * One account has several textual spellings — raw `workchain:hex`, bounceable
+ * `EQ…`, non-bounceable `UQ…`, and the base64 / base64url variants of both —
+ * and only the flag byte and checksum differ between `EQ` and `UQ`. String
+ * equality therefore reports differences that do not exist, which matters
+ * wherever two independently sourced addresses are cross-checked before money
+ * moves. Input that does not parse as a TON address falls back to exact
+ * comparison rather than being reported as a match.
+ */
+export const areEqualTonAddresses = (left, right) => {
+    const parsedLeft = parseTonAddress(left);
+    const parsedRight = parseTonAddress(right);
+    return parsedLeft && parsedRight ? parsedLeft.equals(parsedRight) : left.trim() === right.trim();
+};
+/**
+ * Lower-cased raw (`workchain:hex`) form of a raw or user-friendly TON address.
+ * Toncenter answers in upper-case hex and ton-assets lists lower-case hex, so
+ * every lookup keyed by a jetton master address must go through this first.
+ */
+export const tonAddressToRawKey = (address) => (address.includes(':') ? address : tonAddressToRaw(address)).toLowerCase();
 //# 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,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"}
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/ton/address.ts"],"names":[],"mappings":"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"}

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

@@ -7,6 +7,20 @@ export declare const getJettonWalletAddress: (input: GetJettonWalletInput) => Pr
 /** Fetches the balance of a specific jetton for a given owner address. */
 export declare const getJettonBalance: (input: GetJettonWalletInput) => Promise<bigint>;
 export declare const getTonWalletState: (address: string) => Promise<string>;
+/**
+ * Display metadata Toncenter holds for a jetton master, without any of the
+ * fields being guaranteed: an unindexed or broken jetton can lack all of them.
+ */
+export type JettonMasterMetadata = {
+    /** Raw `workchain:hex` address, lower-cased (see `tonAddressToRawKey`). */
+    address: string;
+    symbol?: string;
+    name?: string;
+    decimals?: number;
+    logo?: string;
+    /** `true` when Toncenter's indexer has flagged the jetton as a scam. */
+    isFlaggedScam?: boolean;
+};
 export type JettonMasterInfo = {
     ticker: string;
     decimals: number;
@@ -16,7 +30,42 @@ export type JettonMasterInfo = {
  * Fetches jetton master metadata (ticker, decimals, logo) from toncenter v3.
  * Prefers Toncenter's validated indexer entry (`token_info` with `valid: true`),
  * falling back to the on-chain TEP-64 `jetton_content` stored in the master.
+ * Throws when the jetton is unknown or has no symbol; decimals default to 9.
  */
 export declare const getJettonMasterInfo: (jettonMasterAddress: string) => Promise<JettonMasterInfo>;
+/**
+ * Fetches metadata for many jetton masters at once, keyed by lower-cased raw
+ * address. Masters Toncenter does not know are simply absent from the result;
+ * nothing throws for a missing symbol, unlike `getJettonMasterInfo`.
+ */
+export declare const getJettonMastersMetadata: (jettonMasterAddresses: string[]) => Promise<Record<string, JettonMasterMetadata>>;
+export type OwnerJettonWallet = {
+    /** Jetton master address as a lower-cased raw key. */
+    jettonMasterAddress: string;
+    balance: bigint;
+};
+export type OwnerJettonWallets = {
+    /** One entry per jetton held, deduplicated by master — see `getOwnerJettonWallets`. */
+    wallets: OwnerJettonWallet[];
+    /** Indexer metadata for the masters behind `wallets`, keyed like `jettonMasterAddress`. */
+    masters: Record<string, JettonMasterMetadata>;
+    /** User-friendly spellings Toncenter returned for master addresses, keyed like `jettonMasterAddress`. */
+    userFriendlyAddresses: Record<string, string>;
+};
+/**
+ * Lists every jetton the owner holds a non-zero balance of, with the master
+ * metadata Toncenter embeds in the same response, so discovery needs no
+ * follow-up call per jetton. Pages through the proxy and keeps only wallets
+ * whose `owner` is the requested address (the proxy has been seen to return
+ * unfiltered lists).
+ *
+ * Each jetton appears once. An owner holds exactly one wallet per master, so a
+ * master seen twice is the same holding served again — which is what a proxy
+ * that ignores `offset` does, replaying page one until the page cap and turning
+ * one balance into twenty. Paging stops as soon as a page adds nothing new,
+ * because a page of holdings already recorded is the end of the list however the
+ * proxy chose to express it.
+ */
+export declare const getOwnerJettonWallets: (ownerAddress: string) => Promise<OwnerJettonWallets>;
 export {};
 //# sourceMappingURL=api.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/ton/api.ts"],"names":[],"mappings":"AAwBA,KAAK,oBAAoB,GAAG;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,mBAAmB,EAAE,MAAM,CAAA;CAC5B,CAAA;AAiCD,4FAA4F;AAC5F,eAAO,MAAM,sBAAsB,GAAU,OAAO,oBAAoB,KAAG,OAAO,CAAC,MAAM,CAOxF,CAAA;AAED,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,GAAU,OAAO,oBAAoB,KAAG,OAAO,CAAC,MAAM,CAIlF,CAAA;AAOD,eAAO,MAAM,iBAAiB,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,MAAM,CAKvE,CAAA;AA4CD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAU,qBAAqB,MAAM,KAAG,OAAO,CAAC,gBAAgB,CAsC/F,CAAA"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/ton/api.ts"],"names":[],"mappings":"AAqDA,KAAK,oBAAoB,GAAG;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,mBAAmB,EAAE,MAAM,CAAA;CAC5B,CAAA;AAiCD,4FAA4F;AAC5F,eAAO,MAAM,sBAAsB,GAAU,OAAO,oBAAoB,KAAG,OAAO,CAAC,MAAM,CAOxF,CAAA;AAED,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,GAAU,OAAO,oBAAoB,KAAG,OAAO,CAAC,MAAM,CAIlF,CAAA;AAOD,eAAO,MAAM,iBAAiB,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,MAAM,CAKvE,CAAA;AAuBD;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wEAAwE;IACxE,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB,CAAA;AA6DD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAU,qBAAqB,MAAM,KAAG,OAAO,CAAC,gBAAgB,CAoB/F,CAAA;AAMD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GACnC,uBAAuB,MAAM,EAAE,KAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAmB9C,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,sDAAsD;IACtD,mBAAmB,EAAE,MAAM,CAAA;IAC3B,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,uFAAuF;IACvF,OAAO,EAAE,iBAAiB,EAAE,CAAA;IAC5B,2FAA2F;IAC3F,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;IAC7C,yGAAyG;IACzG,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9C,CAAA;AASD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,GAAU,cAAc,MAAM,KAAG,OAAO,CAAC,kBAAkB,CAwC5F,CAAA"}

package/dist/chains/ton/api.js

@@ -1,6 +1,7 @@
 import { rootApiUrl } from '@vultisig/core-config';
+import { toBatches } from '@vultisig/lib-utils/array/toBatches';
 import { queryUrl } from '@vultisig/lib-utils/query/queryUrl';
-import { tonAddressToRaw } from './address.js';
+import { tonAddressToRawKey } from './address.js';
 const tonApiUrl = `${rootApiUrl}/ton`;
 const matchesRawAddress = (value, expected) => value.toLowerCase() === expected.toLowerCase();
 /**
@@ -13,8 +14,8 @@ const matchesRawAddress = (value, expected) => value.toLowerCase() === expected.
  * stranger's balance (e.g. a whale's 200M USDT instead of the user's 0).
  */
 const queryOwnerJettonWallet = async ({ ownerAddress, jettonMasterAddress, }) => {
-    const rawOwner = tonAddressToRaw(ownerAddress);
-    const rawMaster = tonAddressToRaw(jettonMasterAddress);
+    const rawOwner = tonAddressToRawKey(ownerAddress);
+    const rawMaster = tonAddressToRawKey(jettonMasterAddress);
     const url = `${tonApiUrl}/v3/jetton/wallets?owner_address=${rawOwner}&jetton_address=${rawMaster}`;
     const response = await queryUrl(url);
     const wallet = response.jetton_wallets.find(({ owner, jetton }) => matchesRawAddress(owner, rawOwner) && matchesRawAddress(jetton, rawMaster));
@@ -38,10 +39,50 @@ export const getTonWalletState = async (address) => {
     const response = await queryUrl(url);
     return response.status;
 };
+const nonEmpty = (value) => {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed : undefined;
+};
+const parseDecimals = (value) => {
+    if (value === undefined)
+        return undefined;
+    const parsed = parseInt(value, 10);
+    return Number.isFinite(parsed) ? parsed : undefined;
+};
+/**
+ * Picks the indexer's validated `jetton_masters` entry for an address, if the
+ * response carries one. Wallet listings also embed entries of type
+ * `jetton_wallets` under the wallet addresses, which are not what we want.
+ */
+const getIndexedMasterInfo = (metadata, address) => metadata?.[address]?.token_info?.find(entry => entry.valid === true && (entry.type === undefined || entry.type === 'jetton_masters'));
+/**
+ * Merges Toncenter's validated indexer entry with the on-chain TEP-64 content,
+ * preferring the indexer. Prefers Toncenter's imgproxy URLs for the logo: the
+ * original `image` URL often serves with `Cross-Origin-Resource-Policy:
+ * same-origin`, which browsers refuse to embed cross-origin, while the
+ * `_image_*` variants are normalized PNGs that load reliably in extension and
+ * desktop pages.
+ */
+const parseJettonMasterMetadata = ({ address, indexed, content, }) => {
+    const logo = nonEmpty(indexed?.extra?._image_medium) ??
+        nonEmpty(indexed?.extra?._image_small) ??
+        nonEmpty(indexed?.extra?._image_big) ??
+        nonEmpty(indexed?.image) ??
+        nonEmpty(content?.image);
+    return {
+        address: tonAddressToRawKey(address),
+        symbol: nonEmpty(indexed?.symbol) ?? nonEmpty(content?.symbol),
+        name: nonEmpty(indexed?.name) ?? nonEmpty(content?.name),
+        decimals: parseDecimals(indexed?.extra?.decimals ?? content?.decimals),
+        logo,
+        ...(indexed?.is_scam === undefined ? {} : { isFlaggedScam: indexed.is_scam }),
+    };
+};
 /**
  * Fetches jetton master metadata (ticker, decimals, logo) from toncenter v3.
  * Prefers Toncenter's validated indexer entry (`token_info` with `valid: true`),
  * falling back to the on-chain TEP-64 `jetton_content` stored in the master.
+ * Throws when the jetton is unknown or has no symbol; decimals default to 9.
  */
 export const getJettonMasterInfo = async (jettonMasterAddress) => {
     const url = `${tonApiUrl}/v3/jetton/masters?address=${encodeURIComponent(jettonMasterAddress)}&limit=1`;
@@ -50,28 +91,94 @@ export const getJettonMasterInfo = async (jettonMasterAddress) => {
     if (!master) {
         throw new Error(`No jetton master found for ${jettonMasterAddress}`);
     }
-    const nonEmpty = (value) => {
-        const trimmed = value?.trim();
-        return trimmed ? trimmed : undefined;
-    };
-    const indexed = response.metadata?.[master.address]?.token_info?.find(entry => entry.valid === true);
-    const content = master.jetton_content;
-    const ticker = nonEmpty(indexed?.symbol) ?? nonEmpty(content?.symbol);
-    if (!ticker) {
+    const { symbol, decimals, logo } = parseJettonMasterMetadata({
+        address: master.address,
+        indexed: getIndexedMasterInfo(response.metadata, master.address),
+        content: master.jetton_content,
+    });
+    if (!symbol) {
         throw new Error(`Jetton master ${jettonMasterAddress} has no symbol`);
     }
-    const decimalsRaw = indexed?.extra?.decimals ?? content?.decimals;
-    const parsedDecimals = decimalsRaw !== undefined ? parseInt(decimalsRaw, 10) : NaN;
-    const decimals = Number.isFinite(parsedDecimals) ? parsedDecimals : 9;
-    // Prefer Toncenter's imgproxy URLs: the original `image` URL often serves
-    // with `Cross-Origin-Resource-Policy: same-origin`, which browsers refuse
-    // to embed cross-origin. The `_image_*` variants are normalized PNGs from
-    // `imgproxy.toncenter.com` and load reliably in extension/desktop pages.
-    const logo = nonEmpty(indexed?.extra?._image_medium) ??
-        nonEmpty(indexed?.extra?._image_small) ??
-        nonEmpty(indexed?.extra?._image_big) ??
-        nonEmpty(indexed?.image) ??
-        nonEmpty(content?.image);
-    return { ticker, decimals, logo };
+    return { ticker: symbol, decimals: decimals ?? 9, logo };
+};
+// Toncenter accepts a comma-separated address list; each raw address is ~67
+// chars, so 50 keeps the query string comfortably under gateway URI limits.
+const jettonMastersPerRequest = 50;
+/**
+ * Fetches metadata for many jetton masters at once, keyed by lower-cased raw
+ * address. Masters Toncenter does not know are simply absent from the result;
+ * nothing throws for a missing symbol, unlike `getJettonMasterInfo`.
+ */
+export const getJettonMastersMetadata = async (jettonMasterAddresses) => {
+    const rawAddresses = [...new Set(jettonMasterAddresses.map(tonAddressToRawKey))];
+    const result = {};
+    for (const batch of toBatches(rawAddresses, jettonMastersPerRequest)) {
+        const url = `${tonApiUrl}/v3/jetton/masters?address=${batch.join(',')}&limit=${batch.length}`;
+        const response = await queryUrl(url);
+        for (const master of response.jetton_masters) {
+            const metadata = parseJettonMasterMetadata({
+                address: master.address,
+                indexed: getIndexedMasterInfo(response.metadata, master.address),
+                content: master.jetton_content,
+            });
+            result[metadata.address] = metadata;
+        }
+    }
+    return result;
+};
+const ownerJettonWalletsPageSize = 100;
+// 2000 distinct jettons is far beyond any real wallet. The cap is the last resort
+// for a proxy that keeps serving pages forever; the duplicate check below normally
+// stops long before it.
+const ownerJettonWalletsMaxPages = 20;
+/**
+ * Lists every jetton the owner holds a non-zero balance of, with the master
+ * metadata Toncenter embeds in the same response, so discovery needs no
+ * follow-up call per jetton. Pages through the proxy and keeps only wallets
+ * whose `owner` is the requested address (the proxy has been seen to return
+ * unfiltered lists).
+ *
+ * Each jetton appears once. An owner holds exactly one wallet per master, so a
+ * master seen twice is the same holding served again — which is what a proxy
+ * that ignores `offset` does, replaying page one until the page cap and turning
+ * one balance into twenty. Paging stops as soon as a page adds nothing new,
+ * because a page of holdings already recorded is the end of the list however the
+ * proxy chose to express it.
+ */
+export const getOwnerJettonWallets = async (ownerAddress) => {
+    // Accept the owner in either spelling: `tonAddressToRaw` alone would base64-decode
+    // a raw `0:hex` address into garbage and the proxy would answer with no wallets.
+    const rawOwner = tonAddressToRawKey(ownerAddress);
+    const wallets = [];
+    const seenMasters = new Set();
+    const masters = {};
+    const userFriendlyAddresses = {};
+    for (let page = 0; page < ownerJettonWalletsMaxPages; page++) {
+        const offset = page * ownerJettonWalletsPageSize;
+        const url = `${tonApiUrl}/v3/jetton/wallets?owner_address=${rawOwner}&exclude_zero_balance=true&limit=${ownerJettonWalletsPageSize}&offset=${offset}`;
+        const response = await queryUrl(url);
+        const walletsBeforePage = seenMasters.size;
+        for (const wallet of response.jetton_wallets) {
+            if (!matchesRawAddress(wallet.owner, rawOwner))
+                continue;
+            const jettonMasterAddress = tonAddressToRawKey(wallet.jetton);
+            if (seenMasters.has(jettonMasterAddress))
+                continue;
+            seenMasters.add(jettonMasterAddress);
+            wallets.push({ jettonMasterAddress, balance: BigInt(wallet.balance || '0') });
+            const indexed = getIndexedMasterInfo(response.metadata, wallet.jetton);
+            if (indexed) {
+                masters[jettonMasterAddress] = parseJettonMasterMetadata({ address: wallet.jetton, indexed });
+            }
+            const userFriendly = response.address_book?.[wallet.jetton]?.user_friendly;
+            if (userFriendly) {
+                userFriendlyAddresses[jettonMasterAddress] = userFriendly;
+            }
+        }
+        const isLastPage = response.jetton_wallets.length < ownerJettonWalletsPageSize;
+        if (isLastPage || seenMasters.size === walletsBeforePage)
+            break;
+    }
+    return { wallets, masters, userFriendlyAddresses };
 };
 //# sourceMappingURL=api.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/ton/api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/ton/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAA;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAA;AAE7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAE9C,MAAM,SAAS,GAAG,GAAG,UAAU,MAAM,CAAA;AAoDrC,MAAM,iBAAiB,GAAG,CAAC,KAAa,EAAE,QAAgB,EAAW,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,WAAW,EAAE,CAAA;AAEtH;;;;;;;;GAQG;AACH,MAAM,sBAAsB,GAAG,KAAK,EAAE,EACpC,YAAY,EACZ,mBAAmB,GACE,EAGpB,EAAE;IACH,MAAM,QAAQ,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAA;IACjD,MAAM,SAAS,GAAG,kBAAkB,CAAC,mBAAmB,CAAC,CAAA;IAEzD,MAAM,GAAG,GAAG,GAAG,SAAS,oCAAoC,QAAQ,mBAAmB,SAAS,EAAE,CAAA;IAClG,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAuB,GAAG,CAAC,CAAA;IAE1D,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,CAAC,IAAI,CACzC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,CAClG,CAAA;IAED,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,YAAY,EAAE,CAAA;AACvD,CAAC,CAAA;AAED,4FAA4F;AAC5F,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,EAAE,KAA2B,EAAmB,EAAE;IAC3F,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,sBAAsB,CAAC,KAAK,CAAC,CAAA;IACnE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IAC3C,CAAC;IAED,OAAO,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,IAAI,MAAM,CAAC,OAAO,CAAA;AACrE,CAAC,CAAA;AAED,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,KAA2B,EAAmB,EAAE;IACrF,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,sBAAsB,CAAC,KAAK,CAAC,CAAA;IAEtD,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,IAAI,GAAG,CAAC,CAAA;AACvC,CAAC,CAAA;AAOD,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EAAE,OAAe,EAAmB,EAAE;IAC1E,MAAM,GAAG,GAAG,GAAG,SAAS,kCAAkC,OAAO,eAAe,CAAA;IAChF,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAA6B,GAAG,CAAC,CAAA;IAEhE,OAAO,QAAQ,CAAC,MAAM,CAAA;AACxB,CAAC,CAAA;AAsCD,MAAM,QAAQ,GAAG,CAAC,KAAyB,EAAsB,EAAE;IACjE,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAA;IAC7B,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;AACtC,CAAC,CAAA;AAED,MAAM,aAAa,GAAG,CAAC,KAAyB,EAAsB,EAAE;IACtE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAEzC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IAElC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;AACrD,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,oBAAoB,GAAG,CAAC,QAAqC,EAAE,OAAe,EAA+B,EAAE,CACnH,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,IAAI,CACnC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAC/F,CAAA;AAQH;;;;;;;GAOG;AACH,MAAM,yBAAyB,GAAG,CAAC,EACjC,OAAO,EACP,OAAO,EACP,OAAO,GACwB,EAAwB,EAAE;IACzD,MAAM,IAAI,GACR,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC;QACvC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC;QACtC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC;QACpC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;QACxB,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAE1B,OAAO;QACL,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC;QACpC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAC9D,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;QACxD,QAAQ,EAAE,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,IAAI,OAAO,EAAE,QAAQ,CAAC;QACtE,IAAI;QACJ,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;KAC9E,CAAA;AACH,CAAC,CAAA;AAQD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EAAE,mBAA2B,EAA6B,EAAE;IAClG,MAAM,GAAG,GAAG,GAAG,SAAS,8BAA8B,kBAAkB,CAAC,mBAAmB,CAAC,UAAU,CAAA;IACvG,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAwB,GAAG,CAAC,CAAA;IAE3D,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAA;IACzC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,8BAA8B,mBAAmB,EAAE,CAAC,CAAA;IACtE,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,yBAAyB,CAAC;QAC3D,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC;QAChE,OAAO,EAAE,MAAM,CAAC,cAAc;KAC/B,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,iBAAiB,mBAAmB,gBAAgB,CAAC,CAAA;IACvE,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,IAAI,CAAC,EAAE,IAAI,EAAE,CAAA;AAC1D,CAAC,CAAA;AAED,4EAA4E;AAC5E,4EAA4E;AAC5E,MAAM,uBAAuB,GAAG,EAAE,CAAA;AAElC;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,EAC3C,qBAA+B,EACgB,EAAE;IACjD,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,qBAAqB,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAA;IAChF,MAAM,MAAM,GAAyC,EAAE,CAAA;IAEvD,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,YAAY,EAAE,uBAAuB,CAAC,EAAE,CAAC;QACrE,MAAM,GAAG,GAAG,GAAG,SAAS,8BAA8B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,MAAM,EAAE,CAAA;QAC7F,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAwB,GAAG,CAAC,CAAA;QAE3D,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;YAC7C,MAAM,QAAQ,GAAG,yBAAyB,CAAC;gBACzC,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,OAAO,EAAE,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC;gBAChE,OAAO,EAAE,MAAM,CAAC,cAAc;aAC/B,CAAC,CAAA;YACF,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAA;QACrC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAiBD,MAAM,0BAA0B,GAAG,GAAG,CAAA;AAEtC,kFAAkF;AAClF,mFAAmF;AACnF,wBAAwB;AACxB,MAAM,0BAA0B,GAAG,EAAE,CAAA;AAErC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EAAE,YAAoB,EAA+B,EAAE;IAC/F,mFAAmF;IACnF,iFAAiF;IACjF,MAAM,QAAQ,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAA;IACjD,MAAM,OAAO,GAAwB,EAAE,CAAA;IACvC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAA;IACrC,MAAM,OAAO,GAAyC,EAAE,CAAA;IACxD,MAAM,qBAAqB,GAA2B,EAAE,CAAA;IAExD,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,0BAA0B,EAAE,IAAI,EAAE,EAAE,CAAC;QAC7D,MAAM,MAAM,GAAG,IAAI,GAAG,0BAA0B,CAAA;QAChD,MAAM,GAAG,GAAG,GAAG,SAAS,oCAAoC,QAAQ,oCAAoC,0BAA0B,WAAW,MAAM,EAAE,CAAA;QACrJ,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAuB,GAAG,CAAC,CAAA;QAC1D,MAAM,iBAAiB,GAAG,WAAW,CAAC,IAAI,CAAA;QAE1C,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;YAC7C,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC;gBAAE,SAAQ;YAExD,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YAC7D,IAAI,WAAW,CAAC,GAAG,CAAC,mBAAmB,CAAC;gBAAE,SAAQ;YAElD,WAAW,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAA;YACpC,OAAO,CAAC,IAAI,CAAC,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,IAAI,GAAG,CAAC,EAAE,CAAC,CAAA;YAE7E,MAAM,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;YACtE,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,mBAAmB,CAAC,GAAG,yBAAyB,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;YAC/F,CAAC;YAED,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,aAAa,CAAA;YAC1E,IAAI,YAAY,EAAE,CAAC;gBACjB,qBAAqB,CAAC,mBAAmB,CAAC,GAAG,YAAY,CAAA;YAC3D,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAG,QAAQ,CAAC,cAAc,CAAC,MAAM,GAAG,0BAA0B,CAAA;QAC9E,IAAI,UAAU,IAAI,WAAW,CAAC,IAAI,KAAK,iBAAiB;YAAE,MAAK;IACjE,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAA;AACpD,CAAC,CAAA"}

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

@@ -0,0 +1,51 @@
+/**
+ * The longest UTF-8 comment a native TON transfer can carry.
+ *
+ * The comment is the message body's own cell, so everything after the opcode is
+ * available: (1023 - 32) / 8.
+ */
+export declare const tonNativeCommentMaxBytes: number;
+export type TonJettonCommentContext = {
+    /** Jetton amount in minimal units — the same value the transfer sends. */
+    amount: bigint;
+    /** Whether the recipient is initialized; decides the forward amount (1 vs 0). */
+    isActiveDestination: boolean;
+};
+/**
+ * The longest UTF-8 comment a jetton transfer can carry *for this amount*.
+ *
+ * A jetton comment is not a body of its own: it rides inline in the transfer
+ * body's `forward_payload`, sharing one 1023-bit cell with the opcode, query id,
+ * amount, both addresses and the forward amount. WalletCore emits only that
+ * inline form — it never spills the payload into a referenced cell — so the cap
+ * is whatever those fields leave behind, roughly 34–39 bytes. It SHRINKS as the
+ * amount grows, because `VarUInteger 16` widens a byte at a time. A fixed byte
+ * count is therefore always wrong for jettons.
+ *
+ * The amount-dependent widths are measured by encoding them rather than
+ * predicted, so the answer cannot drift from the encoder it describes.
+ */
+export declare const getTonJettonCommentMaxBytes: ({ amount, isActiveDestination }: TonJettonCommentContext) => number;
+export type TonCommentInput = {
+    memo: string;
+    /** Jetton transfer context. Omit for a native TON transfer. */
+    jetton?: TonJettonCommentContext;
+};
+/**
+ * The longest UTF-8 comment this transfer can carry, in bytes — a native cell's
+ * 123, or the amount-dependent inline capacity of a jetton transfer.
+ *
+ * Exposed so a send form can cap or count down against the real limit instead
+ * of discovering it at keysign.
+ */
+export declare const getTonCommentMaxBytes: ({ jetton }: Pick<TonCommentInput, "jetton">) => number;
+/**
+ * Rejects a TON comment that will not fit the cell it is destined for.
+ *
+ * Memos are load-bearing on TON — an exchange deposit without the right one
+ * loses the funds — so this is the single place that decides whether a comment
+ * is sendable. Run it before the user commits, not at keysign, where an
+ * oversized jetton comment surfaces as a bare WalletCore "Internal error".
+ */
+export declare const validateTonComment: ({ memo, jetton }: TonCommentInput) => void;
+//# sourceMappingURL=comment.d.ts.map