@vultisig/core-chain 2.28.0 → 2.29.1

package/dist/chains/cosmos/terraClassicTax.js

@@ -25,6 +25,7 @@
  * `getTerraClassicTaxCaps(denom)` calls are safe to memoize — the rate
  * does not change mid-tx.
  */
+import { attempt } from '@vultisig/lib-utils/attempt';
 import { Chain } from '../../Chain.js';
 import { cosmosRpcUrl } from './cosmosRpcUrl.js';
 // ---------------------------------------------------------------------------
@@ -39,6 +40,23 @@ import { cosmosRpcUrl } from './cosmosRpcUrl.js';
  * Reference: terra-money/classic-core, x/treasury REST routes.
  */
 export const getTerraClassicTaxRateUrl = () => `${cosmosRpcUrl[Chain.TerraClassic]}/terra/treasury/v1beta1/tax_rate`;
+/**
+ * The `x/tax` module params, which carry `burn_tax_rate` — a DIFFERENT tax
+ * from the `x/treasury` `tax_rate` above, and the one that is actually live.
+ *
+ * | module       | field           | live value | exempts uluna? |
+ * |--------------|-----------------|------------|----------------|
+ * | `x/treasury` | `tax_rate`      | 0          | yes            |
+ * | `x/tax`      | `burn_tax_rate` | 0.005      | NO             |
+ *
+ * The treasury stability tax has been paused by governance since the UST
+ * collapse; the burn tax replaced it and applies to `uluna` transfers too —
+ * burning LUNC is its entire purpose. Reading the treasury endpoint for a
+ * LUNC send therefore always yields 0 and undercharges the fee.
+ *
+ * Same endpoint iOS (`CosmosAPI.terraClassicTaxParams`) and Android read.
+ */
+export const getTerraClassicBurnTaxParamsUrl = () => `${cosmosRpcUrl[Chain.TerraClassic]}/terra/tax/v1beta1/params`;
 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
@@ -55,6 +73,24 @@ export const getTerraClassicTaxCapsUrl = (denom) =>
  * tax in base units of the same denom.
  */
 export const TERRA_CLASSIC_TAX_DEC_SCALE = 10n ** 18n;
+/**
+ * Conservative fallback burn-tax rate (0.5%) used when the live `x/tax`
+ * params can't be fetched or parsed. Failing CLOSED (taxing) rather than open
+ * (0%) avoids signing a tx the chain then rejects at broadcast — an overpaid
+ * fee is recoverable, a rejected transfer wastes the gas and moves nothing.
+ *
+ * Mirrors iOS / Android `TerraClassicTax.fallbackBurnTaxRate`.
+ */
+export const TERRA_CLASSIC_FALLBACK_BURN_TAX_RATE = 5000000000000000n; // 0.005
+/**
+ * Sanity ceiling (10%) for a parsed burn-tax rate. The rate is
+ * governance-controlled and has historically been ≤ 1.2%, so anything above
+ * this is treated as garbage — a malformed `"5"` meaning 500% would otherwise
+ * be applied literally and drain the account into the fee. Keeps the fail-safe
+ * symmetric with the lower bound, so a bad endpoint can neither under- nor
+ * massively over-charge. Mirrors iOS / Android `maxBurnTaxRate`.
+ */
+export const TERRA_CLASSIC_MAX_BURN_TAX_RATE = 100000000000000000n; // 0.1
 async function lcdGetJson(url, opts) {
     const f = opts.fetchImpl ?? fetch;
     const res = await f(url, { signal: opts.signal });
@@ -116,6 +152,55 @@ export async function getTerraClassicTaxRate(opts = {}) {
     }
     return parseDecToFixed18(raw.tax_rate);
 }
+/**
+ * Parses an `x/tax` `burn_tax_rate` Dec string into an 18-decimal fixed-point
+ * bigint, falling back to {@link TERRA_CLASSIC_FALLBACK_BURN_TAX_RATE} on a
+ * missing, malformed, negative, or implausibly large value.
+ *
+ * Never throws. Unlike the treasury `tax_rate` — where a missing field means
+ * "the LCD is broken, refuse to guess" — a missing burn rate has a known-safe
+ * answer (the current governance rate), and the initiator is the only device
+ * that computes this. Mirrors iOS / Android `TerraClassicTax.parseRate`.
+ */
+export const parseTerraClassicBurnTaxRate = (raw) => {
+    if (raw === null || raw === undefined)
+        return TERRA_CLASSIC_FALLBACK_BURN_TAX_RATE;
+    const parsed = attempt(() => parseDecToFixed18(raw));
+    if ('error' in parsed)
+        return TERRA_CLASSIC_FALLBACK_BURN_TAX_RATE;
+    return parsed.data > TERRA_CLASSIC_MAX_BURN_TAX_RATE ? TERRA_CLASSIC_FALLBACK_BURN_TAX_RATE : parsed.data;
+};
+/**
+ * Fetches the live `x/tax` burn-tax rate as an 18-decimal fixed-point bigint
+ * (`5_000_000_000_000_000n` for the current 0.5%).
+ *
+ * Fails closed to {@link TERRA_CLASSIC_FALLBACK_BURN_TAX_RATE} on any LCD
+ * error, so a network blip produces a slightly overpaid fee rather than a tx
+ * the ante handler rejects.
+ */
+export async function getTerraClassicBurnTaxRate(opts = {}) {
+    const result = await attempt(() => lcdGetJson(getTerraClassicBurnTaxParamsUrl(), opts));
+    if ('error' in result)
+        return TERRA_CLASSIC_FALLBACK_BURN_TAX_RATE;
+    return parseTerraClassicBurnTaxRate(result.data.params?.burn_tax_rate);
+}
+/**
+ * Burn tax on a `amount` of the send denom, at an 18-decimal fixed-point
+ * `rate`, rounded UP so the signed fee never lands a base unit below the
+ * chain's check.
+ *
+ * Deliberately NOT {@link applyTerraClassicTax}: that models the treasury
+ * stability tax, which exempts `uluna` and applies per-denom caps. The burn
+ * tax exempts nothing and is uncapped — feeding a LUNC send through the
+ * treasury helper silently returns `0n`.
+ *
+ * Mirrors iOS / Android `TerraClassicTax.burnTax` (both round up).
+ */
+export const applyTerraClassicBurnTax = (amount, rate) => {
+    if (amount <= 0n || rate <= 0n)
+        return 0n;
+    return (amount * rate + TERRA_CLASSIC_TAX_DEC_SCALE - 1n) / TERRA_CLASSIC_TAX_DEC_SCALE;
+};
 /**
  * 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

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

@@ -1 +1 @@
-{"version":3,"file":"terraClassicTax.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/cosmos/terraClassicTax.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAW,EAAE,CACpD,GAAG,YAAY,CAAC,KAAK,CAAC,YAAY,CAAC,kCAAkC,CAAA;AAEvE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,KAAa,EAAU,EAAE;AACjE,2EAA2E;AAC3E,0EAA0E;AAC1E,oEAAoE;AACpE,YAAY;AACZ,GAAG,YAAY,CAAC,KAAK,CAAC,YAAY,CAAC,oCAAoC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAA;AAEpG,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,IAAI,GAAG,CAAA;AAQrD,KAAK,UAAU,UAAU,CAAI,GAAW,EAAE,IAAe;IACvD,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAA;IACjC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;IACjD,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC,CAAA;IACzD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAA;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG,CAAC,CAAS,EAAU,EAAE;IAC9C,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,sCAAsC,OAAO,CAAC,EAAE,CAAC,CAAA;IACnE,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;IACxB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;IAEvE,qEAAqE;IACrE,yDAAyD;IACzD,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;IACxC,IAAI,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,OAAO,GAAG,CAAC,CAAA;IAE7E,gEAAgE;IAChE,mEAAmE;IACnE,mEAAmE;IACnE,sEAAsE;IACtE,oBAAoB;IACpB,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,uDAAuD,CAAC,CAAA;IAC7G,CAAC;IACD,MAAM,CAAC,OAAO,EAAE,QAAQ,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACnD,uEAAuE;IACvE,kEAAkE;IAClE,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,2BAA2B,GAAG,MAAM,CAAC,UAAU,CAAC,CAAA;IAChF,qEAAqE;IACrE,sEAAsE;IACtE,8CAA8C;IAC9C,IAAI,KAAK,GAAG,2BAA2B,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,uCAAuC,OAAO,GAAG,CAAC,CAAA;IACpE,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,OAAkB,EAAE;IAE/D,MAAM,GAAG,GAAG,MAAM,UAAU,CAAM,yBAAyB,EAAE,EAAE,IAAI,CAAC,CAAA;IACpE,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAA;IAC5D,CAAC;IACD,OAAO,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;AACxC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAAa,EAAE,OAAkB,EAAE;IAE7E,IAAI,GAAQ,CAAA;IACZ,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,UAAU,CAAM,yBAAyB,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAA;IACrE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,2DAA2D;QAC3D,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,IAAI,CAAA;QACtE,MAAM,CAAC,CAAA;IACT,CAAC;IACD,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,6CAA6C,KAAK,yCAAyC,CAAC,CAAA;IAC9G,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,CAAC,OAAO,GAAG,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;AAC5B,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,MAAc,EACd,KAAa,EACb,IAAY,EACZ,IAA+C,EACvC,EAAE;IACV,IAAI,MAAM,GAAG,EAAE,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACtE,CAAC;IACD,IAAI,IAAI,GAAG,EAAE,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;IACpE,CAAC;IACD,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,EAAE,CAAA;IAChC,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,EAAE,CAAA;IAE1B,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,2BAA2B,CAAA;IACzD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;IACvB,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,GAAG,CAAA;IACjD,IAAI,GAAG,GAAG,EAAE,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,0CAA0C,KAAK,EAAE,CAAC,CAAA;IACpE,CAAC;IACD,OAAO,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;AAC9B,CAAC,CAAA"}
+{"version":3,"file":"terraClassicTax.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/cosmos/terraClassicTax.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAA;AAErD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAW,EAAE,CACpD,GAAG,YAAY,CAAC,KAAK,CAAC,YAAY,CAAC,kCAAkC,CAAA;AAEvE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAW,EAAE,CAC1D,GAAG,YAAY,CAAC,KAAK,CAAC,YAAY,CAAC,2BAA2B,CAAA;AAEhE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,KAAa,EAAU,EAAE;AACjE,2EAA2E;AAC3E,0EAA0E;AAC1E,oEAAoE;AACpE,YAAY;AACZ,GAAG,YAAY,CAAC,KAAK,CAAC,YAAY,CAAC,oCAAoC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAA;AAEpG,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,IAAI,GAAG,CAAA;AAErD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,iBAAsB,CAAA,CAAC,QAAQ;AAEnF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,mBAAwB,CAAA,CAAC,MAAM;AAQ9E,KAAK,UAAU,UAAU,CAAI,GAAW,EAAE,IAAe;IACvD,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAA;IACjC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;IACjD,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC,CAAA;IACzD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAA;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG,CAAC,CAAS,EAAU,EAAE;IAC9C,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,sCAAsC,OAAO,CAAC,EAAE,CAAC,CAAA;IACnE,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;IACxB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;IAEvE,qEAAqE;IACrE,yDAAyD;IACzD,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;IACxC,IAAI,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,OAAO,GAAG,CAAC,CAAA;IAE7E,gEAAgE;IAChE,mEAAmE;IACnE,mEAAmE;IACnE,sEAAsE;IACtE,oBAAoB;IACpB,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,uDAAuD,CAAC,CAAA;IAC7G,CAAC;IACD,MAAM,CAAC,OAAO,EAAE,QAAQ,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACnD,uEAAuE;IACvE,kEAAkE;IAClE,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,2BAA2B,GAAG,MAAM,CAAC,UAAU,CAAC,CAAA;IAChF,qEAAqE;IACrE,sEAAsE;IACtE,8CAA8C;IAC9C,IAAI,KAAK,GAAG,2BAA2B,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,uCAAuC,OAAO,GAAG,CAAC,CAAA;IACpE,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,OAAkB,EAAE;IAE/D,MAAM,GAAG,GAAG,MAAM,UAAU,CAAM,yBAAyB,EAAE,EAAE,IAAI,CAAC,CAAA;IACpE,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAA;IAC5D,CAAC;IACD,OAAO,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;AACxC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,GAA8B,EAAU,EAAE;IACrF,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,oCAAoC,CAAA;IAElF,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAA;IACpD,IAAI,OAAO,IAAI,MAAM;QAAE,OAAO,oCAAoC,CAAA;IAElE,OAAO,MAAM,CAAC,IAAI,GAAG,+BAA+B,CAAC,CAAC,CAAC,oCAAoC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAA;AAC3G,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,OAAkB,EAAE;IAGnE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,CAAM,+BAA+B,EAAE,EAAE,IAAI,CAAC,CAAC,CAAA;IAC5F,IAAI,OAAO,IAAI,MAAM;QAAE,OAAO,oCAAoC,CAAA;IAElE,OAAO,4BAA4B,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;AACxE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,MAAc,EAAE,IAAY,EAAU,EAAE;IAC/E,IAAI,MAAM,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE;QAAE,OAAO,EAAE,CAAA;IAEzC,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,2BAA2B,GAAG,EAAE,CAAC,GAAG,2BAA2B,CAAA;AACzF,CAAC,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAAa,EAAE,OAAkB,EAAE;IAE7E,IAAI,GAAQ,CAAA;IACZ,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,UAAU,CAAM,yBAAyB,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAA;IACrE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,2DAA2D;QAC3D,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,IAAI,CAAA;QACtE,MAAM,CAAC,CAAA;IACT,CAAC;IACD,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,6CAA6C,KAAK,yCAAyC,CAAC,CAAA;IAC9G,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,CAAC,OAAO,GAAG,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;AAC5B,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,MAAc,EACd,KAAa,EACb,IAAY,EACZ,IAA+C,EACvC,EAAE;IACV,IAAI,MAAM,GAAG,EAAE,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACtE,CAAC;IACD,IAAI,IAAI,GAAG,EAAE,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;IACpE,CAAC;IACD,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,EAAE,CAAA;IAChC,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,EAAE,CAAA;IAE1B,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,2BAA2B,CAAA;IACzD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;IACvB,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,GAAG,CAAA;IACjD,IAAI,GAAG,GAAG,EAAE,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,0CAA0C,KAAK,EAAE,CAAC,CAAA;IACpE,CAAC;IACD,OAAO,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;AAC9B,CAAC,CAAA"}

package/dist/chains/sui/client.d.ts

@@ -1,3 +1,12 @@
-import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
-export declare const getSuiClient: () => SuiJsonRpcClient;
+import { SuiGrpcClient } from '@mysten/sui/grpc';
+/**
+ * The Sui client every callsite programs against.
+ *
+ * `SuiGrpcClient` and `SuiGraphQLClient` both implement
+ * `SuiClientTypes.TransportMethods`, so the React Native override
+ * (`platforms/react-native/overrides/suiClient.ts`) can swap in the GraphQL
+ * client without touching a single caller.
+ */
+export type SuiClient = SuiGrpcClient;
+export declare const getSuiClient: () => SuiClient;
 //# sourceMappingURL=client.d.ts.map

package/dist/chains/sui/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/sui/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAGtD,eAAO,MAAM,YAAY,wBAMxB,CAAA"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/sui/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAKhD;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,CAAA;AAErC,eAAO,MAAM,YAAY,QACnB,SAKL,CAAA"}

package/dist/chains/sui/client.js

@@ -1,7 +1,8 @@
-import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
+import { SuiGrpcClient } from '@mysten/sui/grpc';
 import { memoize } from '@vultisig/lib-utils/memoize';
-export const getSuiClient = memoize(() => new SuiJsonRpcClient({
-    url: 'https://sui-rpc.publicnode.com',
-    network: 'mainnet',
+import { suiGrpcUrl, suiNetwork } from './config.js';
+export const getSuiClient = memoize(() => new SuiGrpcClient({
+    network: suiNetwork,
+    baseUrl: suiGrpcUrl,
 }));
 //# sourceMappingURL=client.js.map

package/dist/chains/sui/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/sui/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAA;AAErD,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CACjC,GAAG,EAAE,CACH,IAAI,gBAAgB,CAAC;IACnB,GAAG,EAAE,gCAAgC;IACrC,OAAO,EAAE,SAAS;CACnB,CAAC,CACL,CAAA"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/sui/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAA;AAErD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAYjD,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CACjC,GAAc,EAAE,CACd,IAAI,aAAa,CAAC;IAChB,OAAO,EAAE,UAAU;IACnB,OAAO,EAAE,UAAU;CACpB,CAAC,CACL,CAAA"}

package/dist/chains/sui/config.d.ts

@@ -1,3 +1,31 @@
+import type { SuiClientTypes } from '@mysten/sui/client';
 export declare const suiGasBudget = 3000000n;
 export declare const suiMinGasBudget = 2000n;
+export declare const suiNetwork: SuiClientTypes.Network;
+/**
+ * Sui full node gRPC endpoint (grpc-web over HTTPS).
+ *
+ * Sui is retiring JSON-RPC: shutdown on Foundation mainnet full nodes began the
+ * week of 2026-07-27 and full decommission (code removal) lands mid-October
+ * 2026, after which no provider can serve it. gRPC and GraphQL RPC are the
+ * supported replacements, so every Sui read/simulate/execute in this repo goes
+ * through one of them. (JSON-RPC still answered on 2026-07-27 — this is a
+ * migration ahead of the deadline, not a response to a live outage.)
+ *
+ * The previously-used `sui-rpc.publicnode.com` is JSON-RPC only — it answers
+ * nothing over gRPC — so the endpoint moves to the Foundation full node.
+ */
+export declare const suiGrpcUrl = "https://fullnode.mainnet.sui.io:443";
+/**
+ * Sui GraphQL RPC endpoint.
+ *
+ * Used on React Native: `@mysten/sui`'s gRPC client speaks grpc-web through
+ * `GrpcWebFetchTransport`, which reads `Response.body` as a `ReadableStream`.
+ * Hermes' XHR-backed `fetch` exposes no `Response.body`, so grpc-web throws
+ * "missing response body" there. GraphQL RPC is a plain JSON POST and exposes
+ * the exact same unified client surface (`SuiClientTypes.TransportMethods`),
+ * so RN keeps identical call sites. See
+ * `packages/sdk/src/platforms/react-native/overrides/suiClient.ts`.
+ */
+export declare const suiGraphqlUrl = "https://graphql.mainnet.sui.io/graphql";
 //# sourceMappingURL=config.d.ts.map

package/dist/chains/sui/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/sui/config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,WAAY,CAAA;AACrC,eAAO,MAAM,eAAe,QAAQ,CAAA"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/sui/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAExD,eAAO,MAAM,YAAY,WAAY,CAAA;AACrC,eAAO,MAAM,eAAe,QAAQ,CAAA;AAEpC,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,OAAmB,CAAA;AAE3D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,wCAAwC,CAAA;AAE/D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,2CAA2C,CAAA"}

package/dist/chains/sui/config.js

@@ -1,3 +1,30 @@
 export const suiGasBudget = 3000000n;
 export const suiMinGasBudget = 2000n;
+export const suiNetwork = 'mainnet';
+/**
+ * Sui full node gRPC endpoint (grpc-web over HTTPS).
+ *
+ * Sui is retiring JSON-RPC: shutdown on Foundation mainnet full nodes began the
+ * week of 2026-07-27 and full decommission (code removal) lands mid-October
+ * 2026, after which no provider can serve it. gRPC and GraphQL RPC are the
+ * supported replacements, so every Sui read/simulate/execute in this repo goes
+ * through one of them. (JSON-RPC still answered on 2026-07-27 — this is a
+ * migration ahead of the deadline, not a response to a live outage.)
+ *
+ * The previously-used `sui-rpc.publicnode.com` is JSON-RPC only — it answers
+ * nothing over gRPC — so the endpoint moves to the Foundation full node.
+ */
+export const suiGrpcUrl = 'https://fullnode.mainnet.sui.io:443';
+/**
+ * Sui GraphQL RPC endpoint.
+ *
+ * Used on React Native: `@mysten/sui`'s gRPC client speaks grpc-web through
+ * `GrpcWebFetchTransport`, which reads `Response.body` as a `ReadableStream`.
+ * Hermes' XHR-backed `fetch` exposes no `Response.body`, so grpc-web throws
+ * "missing response body" there. GraphQL RPC is a plain JSON POST and exposes
+ * the exact same unified client surface (`SuiClientTypes.TransportMethods`),
+ * so RN keeps identical call sites. See
+ * `packages/sdk/src/platforms/react-native/overrides/suiClient.ts`.
+ */
+export const suiGraphqlUrl = 'https://graphql.mainnet.sui.io/graphql';
 //# sourceMappingURL=config.js.map

package/dist/chains/sui/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/sui/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,QAAS,CAAA;AACrC,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAA"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/sui/config.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAG,QAAS,CAAA;AACrC,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAA;AAEpC,MAAM,CAAC,MAAM,UAAU,GAA2B,SAAS,CAAA;AAE3D;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,qCAAqC,CAAA;AAE/D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,wCAAwC,CAAA"}

package/dist/chains/sui/listAllCoins.d.ts

@@ -0,0 +1,44 @@
+import type { SuiClient } from './client.js';
+/**
+ * A coin object flattened into the shape the keysign payload stores.
+ *
+ * The unified client returns coin objects whose `type` is the full wrapper
+ * (`0x2::coin::Coin<0x2::sui::SUI>`) and whose id field is `objectId`; the
+ * retired JSON-RPC `CoinStruct` exposed the inner `coinType` and
+ * `coinObjectId` directly. Normalizing here keeps coin selection, the
+ * `SuiCoin` protobuf and every downstream comparison unchanged.
+ */
+export type SuiCoinObject = {
+    coinType: string;
+    coinObjectId: string;
+    version: string;
+    digest: string;
+    balance: string;
+};
+/**
+ * A misbehaving endpoint that keeps returning `hasNextPage: true` with a
+ * non-advancing cursor would otherwise spin forever. 200 pages is far beyond
+ * any real wallet, so hitting the cap means the cursor is stuck: fail CLOSED
+ * rather than hang or silently truncate the coin set and under-fund a send.
+ */
+export declare const maxSuiCoinPages = 200;
+/** `0x2::coin::Coin<0x2::sui::SUI>` -> `0x2::sui::SUI`. */
+export declare const unwrapSuiCoinType: (objectType: string | undefined, fallback: string) => string;
+type ListAllSuiCoinsInput = {
+    client: Pick<SuiClient, 'listCoins'>;
+    owner: string;
+    coinType: string;
+};
+/**
+ * Every coin object of one coin type owned by `owner`.
+ *
+ * `listCoins` is paginated (~50 objects/page). Sui's object-per-coin model
+ * makes >50 coin objects realistic for an active wallet (dust, partial fills,
+ * repeated small transfers, staking rewards), so reading only the first page
+ * silently truncates the coin set and produces a broken send ("insufficient
+ * balance" despite adequate holdings) even though the balance-based display
+ * path shows the correct aggregate total. Follow the cursor to completion.
+ */
+export declare const listAllSuiCoins: ({ client, owner, coinType }: ListAllSuiCoinsInput) => Promise<SuiCoinObject[]>;
+export {};
+//# sourceMappingURL=listAllCoins.d.ts.map

package/dist/chains/sui/listAllCoins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listAllCoins.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/sui/listAllCoins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzC;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,MAAM,CAAA;AAIlC,2DAA2D;AAC3D,eAAO,MAAM,iBAAiB,GAAI,YAAY,MAAM,GAAG,SAAS,EAAE,UAAU,MAAM,KAAG,MAChC,CAAA;AAErD,KAAK,oBAAoB,GAAG;IAC1B,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAAU,6BAA6B,oBAAoB,KAAG,OAAO,CAAC,aAAa,EAAE,CA4BhH,CAAA"}

package/dist/chains/sui/listAllCoins.js

@@ -0,0 +1,43 @@
+/**
+ * A misbehaving endpoint that keeps returning `hasNextPage: true` with a
+ * non-advancing cursor would otherwise spin forever. 200 pages is far beyond
+ * any real wallet, so hitting the cap means the cursor is stuck: fail CLOSED
+ * rather than hang or silently truncate the coin set and under-fund a send.
+ */
+export const maxSuiCoinPages = 200;
+const coinWrapperType = /::coin::Coin<(.+)>$/;
+/** `0x2::coin::Coin<0x2::sui::SUI>` -> `0x2::sui::SUI`. */
+export const unwrapSuiCoinType = (objectType, fallback) => objectType?.match(coinWrapperType)?.[1] ?? fallback;
+/**
+ * Every coin object of one coin type owned by `owner`.
+ *
+ * `listCoins` is paginated (~50 objects/page). Sui's object-per-coin model
+ * makes >50 coin objects realistic for an active wallet (dust, partial fills,
+ * repeated small transfers, staking rewards), so reading only the first page
+ * silently truncates the coin set and produces a broken send ("insufficient
+ * balance" despite adequate holdings) even though the balance-based display
+ * path shows the correct aggregate total. Follow the cursor to completion.
+ */
+export const listAllSuiCoins = async ({ client, owner, coinType }) => {
+    const coins = [];
+    let cursor = undefined;
+    let pages = 0;
+    do {
+        const page = await client.listCoins({ owner, coinType, cursor });
+        for (const object of page.objects) {
+            coins.push({
+                coinType: unwrapSuiCoinType(object.type, coinType),
+                coinObjectId: object.objectId,
+                version: object.version,
+                digest: object.digest,
+                balance: object.balance,
+            });
+        }
+        cursor = page.hasNextPage ? page.cursor : null;
+        if (++pages >= maxSuiCoinPages && cursor) {
+            throw new Error(`listAllSuiCoins: exceeded ${maxSuiCoinPages} pages for ${owner} (${coinType}) — refusing to build a send from a possibly-truncated or looping coin set`);
+        }
+    } while (cursor);
+    return coins;
+};
+//# sourceMappingURL=listAllCoins.js.map

package/dist/chains/sui/listAllCoins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listAllCoins.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/sui/listAllCoins.ts"],"names":[],"mappings":"AAmBA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAA;AAElC,MAAM,eAAe,GAAG,qBAAqB,CAAA;AAE7C,2DAA2D;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,UAA8B,EAAE,QAAgB,EAAU,EAAE,CAC5F,UAAU,EAAE,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAA;AAQrD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAwB,EAA4B,EAAE;IACnH,MAAM,KAAK,GAAoB,EAAE,CAAA;IACjC,IAAI,MAAM,GAA8B,SAAS,CAAA;IACjD,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,GAAG,CAAC;QACF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAA;QAEhE,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC;gBACT,QAAQ,EAAE,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC;gBAClD,YAAY,EAAE,MAAM,CAAC,QAAQ;gBAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC,CAAA;QACJ,CAAC;QAED,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;QAE9C,IAAI,EAAE,KAAK,IAAI,eAAe,IAAI,MAAM,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CACb,6BAA6B,eAAe,cAAc,KAAK,KAAK,QAAQ,4EAA4E,CACzJ,CAAA;QACH,CAAC;IACH,CAAC,QAAQ,MAAM,EAAC;IAEhB,OAAO,KAAK,CAAA;AACd,CAAC,CAAA"}

package/dist/chains/sui/transactionResult.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Shared readers for the unified Sui client's transaction result shape.
+ *
+ * Sui's gRPC / GraphQL clients return a discriminated union rather than the
+ * JSON-RPC `{ effects: { status: { status: 'success' | 'failure' } } }` object:
+ *
+ *   { $kind: 'Transaction',       Transaction:       { status, effects, ... } }
+ *   { $kind: 'FailedTransaction', FailedTransaction: { status, effects, ... } }
+ *
+ * and execution status is `{ success: true, error: null }` /
+ * `{ success: false, error: { message, ... } }`.
+ *
+ * The types below are structural on purpose: `SuiGrpcClient` and
+ * `SuiGraphQLClient` produce the same shape but through different generic
+ * instantiations, and every resolver here only ever reads status + effects.
+ */
+export type SuiExecutionStatusLike = {
+    success?: boolean;
+    error?: {
+        message?: string;
+    } | null;
+};
+export type SuiGasCostSummaryLike = {
+    computationCost?: string;
+    storageCost?: string;
+    storageRebate?: string;
+};
+export type SuiTransactionEffectsLike = {
+    transactionDigest?: string;
+    gasUsed?: SuiGasCostSummaryLike;
+};
+export type SuiTransactionLike = {
+    digest?: string;
+    status?: SuiExecutionStatusLike;
+    effects?: SuiTransactionEffectsLike;
+};
+export type SuiTransactionResultLike = {
+    $kind?: 'Transaction' | 'FailedTransaction';
+    Transaction?: SuiTransactionLike;
+    FailedTransaction?: SuiTransactionLike;
+};
+/**
+ * The transaction payload of a result, regardless of which arm of the union it
+ * arrived on. A failed transaction still carries effects (gas used, digest),
+ * which broadcast verification and gas refinement both need.
+ */
+export declare const getSuiResultTransaction: (result: SuiTransactionResultLike | null | undefined) => SuiTransactionLike | undefined;
+/**
+ * Execution success — NOT transport success.
+ *
+ * Fails closed: only an explicit `$kind: 'Transaction'` carrying
+ * `status.success === true` counts. A `FailedTransaction`, a `success: false`
+ * status, or a result with no status at all (malformed / unexpected response)
+ * is not proven success and must not be treated as one (sdk#1398).
+ */
+export declare const isSuiExecutionSuccess: (result: SuiTransactionResultLike | null | undefined) => boolean;
+/** Human-readable reason a transaction did not execute successfully. */
+export declare const describeSuiExecutionFailure: (result: SuiTransactionResultLike | null | undefined) => string;
+//# sourceMappingURL=transactionResult.d.ts.map

package/dist/chains/sui/transactionResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionResult.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/sui/transactionResult.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CACpC,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,OAAO,CAAC,EAAE,qBAAqB,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,sBAAsB,CAAA;IAC/B,OAAO,CAAC,EAAE,yBAAyB,CAAA;CACpC,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,CAAC,EAAE,aAAa,GAAG,mBAAmB,CAAA;IAC3C,WAAW,CAAC,EAAE,kBAAkB,CAAA;IAChC,iBAAiB,CAAC,EAAE,kBAAkB,CAAA;CACvC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,QAAQ,wBAAwB,GAAG,IAAI,GAAG,SAAS,KAClD,kBAAkB,GAAG,SAA6D,CAAA;AAErF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,wBAAwB,GAAG,IAAI,GAAG,SAAS,KAAG,OACE,CAAA;AAE9F,wEAAwE;AACxE,eAAO,MAAM,2BAA2B,GAAI,QAAQ,wBAAwB,GAAG,IAAI,GAAG,SAAS,KAAG,MAQjG,CAAA"}

package/dist/chains/sui/transactionResult.js

@@ -0,0 +1,43 @@
+/**
+ * Shared readers for the unified Sui client's transaction result shape.
+ *
+ * Sui's gRPC / GraphQL clients return a discriminated union rather than the
+ * JSON-RPC `{ effects: { status: { status: 'success' | 'failure' } } }` object:
+ *
+ *   { $kind: 'Transaction',       Transaction:       { status, effects, ... } }
+ *   { $kind: 'FailedTransaction', FailedTransaction: { status, effects, ... } }
+ *
+ * and execution status is `{ success: true, error: null }` /
+ * `{ success: false, error: { message, ... } }`.
+ *
+ * The types below are structural on purpose: `SuiGrpcClient` and
+ * `SuiGraphQLClient` produce the same shape but through different generic
+ * instantiations, and every resolver here only ever reads status + effects.
+ */
+/**
+ * The transaction payload of a result, regardless of which arm of the union it
+ * arrived on. A failed transaction still carries effects (gas used, digest),
+ * which broadcast verification and gas refinement both need.
+ */
+export const getSuiResultTransaction = (result) => result?.Transaction ?? result?.FailedTransaction;
+/**
+ * Execution success — NOT transport success.
+ *
+ * Fails closed: only an explicit `$kind: 'Transaction'` carrying
+ * `status.success === true` counts. A `FailedTransaction`, a `success: false`
+ * status, or a result with no status at all (malformed / unexpected response)
+ * is not proven success and must not be treated as one (sdk#1398).
+ */
+export const isSuiExecutionSuccess = (result) => result?.$kind === 'Transaction' && getSuiResultTransaction(result)?.status?.success === true;
+/** Human-readable reason a transaction did not execute successfully. */
+export const describeSuiExecutionFailure = (result) => {
+    const status = getSuiResultTransaction(result)?.status;
+    if (status?.error?.message)
+        return status.error.message;
+    if (status?.success === false)
+        return 'execution failed';
+    if (result?.$kind === 'FailedTransaction')
+        return 'transaction did not execute';
+    return 'no execution status returned';
+};
+//# sourceMappingURL=transactionResult.js.map

package/dist/chains/sui/transactionResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionResult.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/sui/transactionResult.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA8BH;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,MAAmD,EACnB,EAAE,CAAC,MAAM,EAAE,WAAW,IAAI,MAAM,EAAE,iBAAiB,CAAA;AAErF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAmD,EAAW,EAAE,CACpG,MAAM,EAAE,KAAK,KAAK,aAAa,IAAI,uBAAuB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;AAE9F,wEAAwE;AACxE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,MAAmD,EAAU,EAAE;IACzG,MAAM,MAAM,GAAG,uBAAuB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IAEtD,IAAI,MAAM,EAAE,KAAK,EAAE,OAAO;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAA;IACvD,IAAI,MAAM,EAAE,OAAO,KAAK,KAAK;QAAE,OAAO,kBAAkB,CAAA;IACxD,IAAI,MAAM,EAAE,KAAK,KAAK,mBAAmB;QAAE,OAAO,6BAA6B,CAAA;IAE/E,OAAO,8BAA8B,CAAA;AACvC,CAAC,CAAA"}

package/dist/coin/balance/resolvers/sui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sui.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/coin/balance/resolvers/sui.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEjD,eAAO,MAAM,iBAAiB,EAAE,mBAS/B,CAAA"}
+{"version":3,"file":"sui.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/coin/balance/resolvers/sui.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEjD,eAAO,MAAM,iBAAiB,EAAE,mBAY/B,CAAA"}

package/dist/coin/balance/resolvers/sui.js

@@ -1,10 +1,13 @@
 import { getSuiClient } from '@vultisig/core-chain/chains/sui/client';
 export const getSuiCoinBalance = async (input) => {
-    const rpcClient = getSuiClient();
-    const { totalBalance } = await rpcClient.getBalance({
+    const client = getSuiClient();
+    // The unified client nests the balance: `{ balance: { balance, coinType, ... } }`.
+    // `balance.balance` is the total (the retired JSON-RPC `totalBalance`), NOT
+    // the `coinBalance` / `addressBalance` split.
+    const { balance } = await client.getBalance({
         owner: input.address,
         ...(input.id ? { coinType: input.id } : {}),
     });
-    return BigInt(totalBalance);
+    return BigInt(balance.balance);
 };
 //# sourceMappingURL=sui.js.map

package/dist/coin/balance/resolvers/sui.js.map

@@ -1 +1 @@
-{"version":3,"file":"sui.js","sourceRoot":"","sources":["../../../../../../../packages/core/chain/coin/balance/resolvers/sui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AAIrE,MAAM,CAAC,MAAM,iBAAiB,GAAwB,KAAK,EAAC,KAAK,EAAC,EAAE;IAClE,MAAM,SAAS,GAAG,YAAY,EAAE,CAAA;IAEhC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC;QAClD,KAAK,EAAE,KAAK,CAAC,OAAO;QACpB,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5C,CAAC,CAAA;IAEF,OAAO,MAAM,CAAC,YAAY,CAAC,CAAA;AAC7B,CAAC,CAAA"}
+{"version":3,"file":"sui.js","sourceRoot":"","sources":["../../../../../../../packages/core/chain/coin/balance/resolvers/sui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AAIrE,MAAM,CAAC,MAAM,iBAAiB,GAAwB,KAAK,EAAC,KAAK,EAAC,EAAE;IAClE,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;IAE7B,mFAAmF;IACnF,4EAA4E;IAC5E,8CAA8C;IAC9C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC;QAC1C,KAAK,EAAE,KAAK,CAAC,OAAO;QACpB,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5C,CAAC,CAAA;IAEF,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;AAChC,CAAC,CAAA"}

package/dist/coin/token/metadata/chains.d.ts

@@ -1,6 +1,6 @@
 import { DeriveChainKind } from '@vultisig/core-chain/ChainKind';
 import { OtherChain } from '../../../Chain.js';
-export declare const chainsWithTokenMetadataDiscovery: readonly ("Arbitrum" | "Base" | "Blast" | "Optimism" | "Zksync" | "Mantle" | "Avalanche" | "CronosChain" | "BSC" | "Ethereum" | "Polygon" | "Hyperliquid" | "Sei" | "Cosmos" | "Osmosis" | "Dydx" | "Kujira" | "Terra" | "TerraClassic" | "Noble" | "Akash" | "THORChain" | "MayaChain" | OtherChain.Sui | OtherChain.Solana | OtherChain.Ton | OtherChain.Tron | OtherChain.Cardano)[];
+export declare const chainsWithTokenMetadataDiscovery: readonly ("Arbitrum" | "Base" | "Blast" | "Optimism" | "Zksync" | "Mantle" | "Avalanche" | "CronosChain" | "BSC" | "Ethereum" | "Polygon" | "Hyperliquid" | "Sei" | "Cosmos" | "Osmosis" | "Dydx" | "Kujira" | "Terra" | "TerraClassic" | "Noble" | "Akash" | "THORChain" | "MayaChain" | OtherChain.Sui | OtherChain.Solana | OtherChain.Ton | OtherChain.Ripple | OtherChain.Tron | OtherChain.Cardano)[];
 export type ChainWithTokenMetadataDiscovery = (typeof chainsWithTokenMetadataDiscovery)[number];
 export type ChainKindWithTokenMetadataDiscovery = DeriveChainKind<ChainWithTokenMetadataDiscovery>;
 //# sourceMappingURL=chains.d.ts.map

package/dist/coin/token/metadata/chains.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/coin/token/metadata/chains.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAEhE,OAAO,EAAyB,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAElE,eAAO,MAAM,gCAAgC,yXAQnC,CAAA;AAEV,MAAM,MAAM,+BAA+B,GAAG,CAAC,OAAO,gCAAgC,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/F,MAAM,MAAM,mCAAmC,GAAG,eAAe,CAAC,+BAA+B,CAAC,CAAA"}
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/coin/token/metadata/chains.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAEhE,OAAO,EAAyB,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAElE,eAAO,MAAM,gCAAgC,6YASnC,CAAA;AAEV,MAAM,MAAM,+BAA+B,GAAG,CAAC,OAAO,gCAAgC,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/F,MAAM,MAAM,mCAAmC,GAAG,eAAe,CAAC,+BAA+B,CAAC,CAAA"}

package/dist/coin/token/metadata/chains.js

@@ -6,6 +6,7 @@ export const chainsWithTokenMetadataDiscovery = [
     OtherChain.Tron,
     OtherChain.Cardano,
     OtherChain.Sui,
+    OtherChain.Ripple,
     ...Object.values(CosmosChain),
 ];
 //# sourceMappingURL=chains.js.map

package/dist/coin/token/metadata/chains.js.map

@@ -1 +1 @@
-{"version":3,"file":"chains.js","sourceRoot":"","sources":["../../../../../../../packages/core/chain/coin/token/metadata/chains.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAElE,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC1B,UAAU,CAAC,MAAM;IACjB,UAAU,CAAC,GAAG;IACd,UAAU,CAAC,IAAI;IACf,UAAU,CAAC,OAAO;IAClB,UAAU,CAAC,GAAG;IACd,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;CACrB,CAAA"}
+{"version":3,"file":"chains.js","sourceRoot":"","sources":["../../../../../../../packages/core/chain/coin/token/metadata/chains.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAElE,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC1B,UAAU,CAAC,MAAM;IACjB,UAAU,CAAC,GAAG;IACd,UAAU,CAAC,IAAI;IACf,UAAU,CAAC,OAAO;IAClB,UAAU,CAAC,GAAG;IACd,UAAU,CAAC,MAAM;IACjB,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;CACrB,CAAA"}

package/dist/coin/token/metadata/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/coin/token/metadata/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAmBlD,eAAO,MAAM,gBAAgB,EAAE,qBAM9B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/coin/token/metadata/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAqBlD,eAAO,MAAM,gBAAgB,EAAE,qBAM9B,CAAA"}

package/dist/coin/token/metadata/index.js

@@ -2,6 +2,7 @@ import { getChainKind } from '@vultisig/core-chain/ChainKind';
 import { getCardanoTokenMetadata } from './resolvers/cardano.js';
 import { getCosmosTokenMetadata } from './resolvers/cosmos.js';
 import { getEvmTokenMetadata } from './resolvers/evm.js';
+import { getRippleTokenMetadata } from './resolvers/ripple.js';
 import { getSolanaTokenMetadata } from './resolvers/solana.js';
 import { getSuiTokenMetadata } from './resolvers/sui.js';
 import { getTonTokenMetadata } from './resolvers/ton.js';
@@ -14,6 +15,7 @@ const resolvers = {
     tron: getTronTokenMetadata,
     cardano: getCardanoTokenMetadata,
     sui: getSuiTokenMetadata,
+    ripple: getRippleTokenMetadata,
 };
 export const getTokenMetadata = async (input) => {
     const chainKind = getChainKind(input.chain);

package/dist/coin/token/metadata/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/core/chain/coin/token/metadata/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAI7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAEvD,MAAM,SAAS,GAA4E;IACzF,GAAG,EAAE,mBAAmB;IACxB,MAAM,EAAE,sBAAsB;IAC9B,MAAM,EAAE,sBAAsB;IAC9B,GAAG,EAAE,mBAAmB;IACxB,IAAI,EAAE,oBAAoB;IAC1B,OAAO,EAAE,uBAAuB;IAChC,GAAG,EAAE,mBAAmB;CACzB,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAA0B,KAAK,EAAC,KAAK,EAAC,EAAE;IACnE,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAE3C,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,CAAA;IAErC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAA;AACxB,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/core/chain/coin/token/metadata/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAI7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAEvD,MAAM,SAAS,GAA4E;IACzF,GAAG,EAAE,mBAAmB;IACxB,MAAM,EAAE,sBAAsB;IAC9B,MAAM,EAAE,sBAAsB;IAC9B,GAAG,EAAE,mBAAmB;IACxB,IAAI,EAAE,oBAAoB;IAC1B,OAAO,EAAE,uBAAuB;IAChC,GAAG,EAAE,mBAAmB;IACxB,MAAM,EAAE,sBAAsB;CAC/B,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAA0B,KAAK,EAAC,KAAK,EAAC,EAAE;IACnE,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAE3C,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,CAAA;IAErC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAA;AACxB,CAAC,CAAA"}

package/dist/coin/token/metadata/resolvers/ripple.d.ts

@@ -0,0 +1,17 @@
+import { OtherChain } from '@vultisig/core-chain/Chain';
+import { TokenMetadataResolver } from '../resolver.js';
+/**
+ * Metadata for a custom XRPL issued currency identified by a `currency.issuer`
+ * token id.
+ *
+ * Unlike EVM/Tron tokens, XRPL issued currencies expose no on-ledger metadata
+ * call: issued amounts carry no fixed on-chain decimal count (we model them at
+ * {@link rippleIssuedCurrencyDecimals}) and the ticker is derived from the
+ * currency code itself, so nothing is fetched. When the token is one we curate,
+ * its logo and price provider are merged in; an arbitrary token gets neither, so
+ * it renders with a generic icon and no price rather than borrowing a known
+ * token's identity — two different issuers can share a ticker on XRPL, so the
+ * issuer (encoded in the id) is what actually distinguishes them.
+ */
+export declare const getRippleTokenMetadata: TokenMetadataResolver<OtherChain.Ripple>;
+//# sourceMappingURL=ripple.d.ts.map

package/dist/coin/token/metadata/resolvers/ripple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ripple.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/coin/token/metadata/resolvers/ripple.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AASvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAiBnD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB,EAAE,qBAAqB,CAAC,UAAU,CAAC,MAAM,CAqB3E,CAAA"}

package/dist/coin/token/metadata/resolvers/ripple.js

@@ -0,0 +1,44 @@
+import { parseRippleTokenId, rippleIssuedCurrencyDecimals, rippleKnownIssuedTokens, rippleTokenId, } from '@vultisig/core-chain/chains/ripple/issuedCurrency';
+import { areEqualCoins } from '@vultisig/core-chain/coin/Coin';
+/**
+ * Human-readable ticker for an XRPL issued currency. Standard 3-character codes
+ * (`USD`) are already tickers; the 160-bit hex form encodes ASCII right-padded
+ * with zeros, so decoding it recovers the ticker a user recognises (e.g. `RLUSD`).
+ */
+const toIssuedCurrencyTicker = (currency) => {
+    if (currency.length !== 40) {
+        return currency;
+    }
+    const ascii = Buffer.from(currency, 'hex').toString('ascii').replace(/\0+$/, '');
+    return /^[\x20-\x7e]+$/.test(ascii) ? ascii : currency;
+};
+/**
+ * Metadata for a custom XRPL issued currency identified by a `currency.issuer`
+ * token id.
+ *
+ * Unlike EVM/Tron tokens, XRPL issued currencies expose no on-ledger metadata
+ * call: issued amounts carry no fixed on-chain decimal count (we model them at
+ * {@link rippleIssuedCurrencyDecimals}) and the ticker is derived from the
+ * currency code itself, so nothing is fetched. When the token is one we curate,
+ * its logo and price provider are merged in; an arbitrary token gets neither, so
+ * it renders with a generic icon and no price rather than borrowing a known
+ * token's identity — two different issuers can share a ticker on XRPL, so the
+ * issuer (encoded in the id) is what actually distinguishes them.
+ */
+export const getRippleTokenMetadata = async ({ id, chain }) => {
+    const { currency, issuer } = parseRippleTokenId(id);
+    const metadata = {
+        ticker: toIssuedCurrencyTicker(currency),
+        decimals: rippleIssuedCurrencyDecimals,
+    };
+    const knownToken = rippleKnownIssuedTokens.find(token => areEqualCoins(token, { chain, id: rippleTokenId({ currency, issuer }) }));
+    if (!knownToken) {
+        return metadata;
+    }
+    return {
+        ...metadata,
+        logo: knownToken.logo,
+        priceProviderId: knownToken.priceProviderId,
+    };
+};
+//# sourceMappingURL=ripple.js.map