@vultisig/core-chain 2.3.0 → 2.3.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @vultisig/core-chain
 
+## 2.3.1
+
+### Patch Changes
+
+- [#579](https://github.com/vultisig/vultisig-sdk/pull/579) [`c3881e5`](https://github.com/vultisig/vultisig-sdk/commit/c3881e549e5678e8806eba5defb2d2d6eefc2cc5) Thanks [@gomesalexandre](https://github.com/gomesalexandre)! - ## Fixed
+  - Cosmos account info LCD fallback for extended account types that StargateClient cannot decode (vesting wrappers, module accounts) — prevents doomed txs with `sequence:0` that fail at broadcast with `account sequence mismatch, expected N, got 0` ([#579](https://github.com/vultisig/vultisig-sdk/issues/579))
+  - Cosmos coin balance LCD fallback when StargateClient returns `amount:"0"` on a funded address — fixes a packaging-level discrepancy in cosmjs's HTTP layer under Hermes/React Native that silently surfaced as "you have 0" on funded Terra/TerraClassic wallets ([#579](https://github.com/vultisig/vultisig-sdk/issues/579))
+
 ## 2.3.0
 
 ### Minor Changes

package/dist/chains/cosmos/account/getCosmosAccountInfo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getCosmosAccountInfo.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/chains/cosmos/account/getCosmosAccountInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAGhE,eAAO,MAAM,oBAAoB,GAAU,oBAAoB,YAAY,CAAC,WAAW,CAAC;;;;;;EAiBvF,CAAA"}
+{"version":3,"file":"getCosmosAccountInfo.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/chains/cosmos/account/getCosmosAccountInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAsEhE,eAAO,MAAM,oBAAoB,GAAU,oBAAoB,YAAY,CAAC,WAAW,CAAC;;;;;;EAgCvF,CAAA"}

package/dist/chains/cosmos/account/getCosmosAccountInfo.js

@@ -1,8 +1,57 @@
 import { getCosmosClient } from '@vultisig/core-chain/chains/cosmos/client';
+import { cosmosRpcUrl } from '@vultisig/core-chain/chains/cosmos/cosmosRpcUrl';
+import { queryUrl } from '@vultisig/lib-utils/query/queryUrl';
+const parseLcdAccount = (resp) => {
+    const acc = resp.account;
+    if (!acc)
+        return null;
+    const base = acc.base_vesting_account?.base_account ?? acc.base_account ?? acc;
+    const accountNumber = Number(base.account_number ?? '0');
+    const sequence = Number(base.sequence ?? '0');
+    if (!Number.isFinite(accountNumber) || !Number.isFinite(sequence))
+        return null;
+    return { accountNumber, sequence };
+};
+// LCD fallback for Tendermint-RPC account lookups that return null.
+// Native @cosmjs/stargate.getAccount() returns null in TWO indistinguishable
+// cases: (1) account genuinely doesn't exist on-chain, (2) the RPC response
+// couldn't be decoded (custom account type, transient infra, etc.). For a
+// send tx, the sender account MUST exist by definition — falling through
+// to sequence:0 ships a tx guaranteed to fail at broadcast with
+// "account sequence mismatch, expected N, got 0".
+//
+// LCD uses a different infra path (REST vs Tendermint RPC), supports
+// extended account types (vesting, module wrappers) via JSON shape parsing,
+// and gives us a second chance before we ship a doomed tx.
+const fetchAccountViaLcd = async (chain, address) => {
+    const base = cosmosRpcUrl[chain];
+    if (!base)
+        return null;
+    try {
+        const resp = await queryUrl(`${base}/cosmos/auth/v1beta1/accounts/${address}`);
+        return parseLcdAccount(resp);
+    }
+    catch {
+        // 404 (account not found) or transient LCD error — caller decides.
+        return null;
+    }
+};
 export const getCosmosAccountInfo = async ({ chain, address }) => {
     const client = await getCosmosClient(chain);
-    const accountInfo = await client.getAccount(address);
-    const block = await client.getBlock();
+    const [accountInfo, block] = await Promise.all([client.getAccount(address), client.getBlock()]);
+    let accountNumber = accountInfo?.accountNumber;
+    let sequence = accountInfo?.sequence;
+    // RPC returned null. Try the LCD shape parser before falling back to
+    // sequence:0 — that fallback is correct only for accounts that have
+    // genuinely never been funded, but ships a doomed tx for the much more
+    // common case where RPC just couldn't decode an extended account type.
+    if (accountInfo === null) {
+        const lcd = await fetchAccountViaLcd(chain, address);
+        if (lcd) {
+            accountNumber = lcd.accountNumber;
+            sequence = lcd.sequence;
+        }
+    }
     const blockTimestampStr = block.header.time;
     const blockTimestampNs = BigInt(new Date(blockTimestampStr).getTime()) * 1000000n;
     const timeoutNs = blockTimestampNs + 600000000000n; // +10 minutes
@@ -10,8 +59,8 @@ export const getCosmosAccountInfo = async ({ chain, address }) => {
     return {
         address,
         pubkey: accountInfo?.pubkey ?? null,
-        accountNumber: accountInfo?.accountNumber ?? 0,
-        sequence: accountInfo?.sequence ?? 0,
+        accountNumber: accountNumber ?? 0,
+        sequence: sequence ?? 0,
         latestBlock,
     };
 };

package/dist/chains/cosmos/account/getCosmosAccountInfo.js.map

@@ -1 +1 @@
-{"version":3,"file":"getCosmosAccountInfo.js","sourceRoot":"","sources":["../../../../../../../packages/core/chain/chains/cosmos/account/getCosmosAccountInfo.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAA;AAE3E,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAA6B,EAAE,EAAE;IAC1F,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,CAAA;IAC3C,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;IACpD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAA;IACrC,MAAM,iBAAiB,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAA;IAC3C,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,IAAI,CAAC,iBAAiB,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,QAAU,CAAA;IAEnF,MAAM,SAAS,GAAG,gBAAgB,GAAG,aAAgB,CAAA,CAAC,cAAc;IACpE,MAAM,WAAW,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,SAAS,EAAE,CAAA;IAEzD,OAAO;QACL,OAAO;QACP,MAAM,EAAE,WAAW,EAAE,MAAM,IAAI,IAAI;QACnC,aAAa,EAAE,WAAW,EAAE,aAAa,IAAI,CAAC;QAC9C,QAAQ,EAAE,WAAW,EAAE,QAAQ,IAAI,CAAC;QACpC,WAAW;KACZ,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"getCosmosAccountInfo.js","sourceRoot":"","sources":["../../../../../../../packages/core/chain/chains/cosmos/account/getCosmosAccountInfo.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"cosmos.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/coin/balance/resolvers/cosmos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAMxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEjD,eAAO,MAAM,oBAAoB,EAAE,mBAAmB,CAAC,WAAW,CAcjE,CAAA"}
+{"version":3,"file":"cosmos.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/coin/balance/resolvers/cosmos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAUxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAuCjD,eAAO,MAAM,oBAAoB,EAAE,mBAAmB,CAAC,WAAW,CAyBjE,CAAA"}

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

@@ -1,7 +1,38 @@
 import { getCosmosClient } from '@vultisig/core-chain/chains/cosmos/client';
-import { getCosmosWasmTokenBalanceUrl, isCosmosWasmTokenId } from '@vultisig/core-chain/chains/cosmos/cosmosRpcUrl';
+import { cosmosRpcUrl, getCosmosWasmTokenBalanceUrl, isCosmosWasmTokenId, } from '@vultisig/core-chain/chains/cosmos/cosmosRpcUrl';
 import { getDenom } from '@vultisig/core-chain/coin/utils/getDenom';
 import { queryUrl } from '@vultisig/lib-utils/query/queryUrl';
+// LCD fallback for Tendermint-RPC bank lookups that return 0n. Native
+// @cosmjs/stargate.getBalance() can return `{denom, amount: "0"}` in two
+// indistinguishable cases: (1) the account genuinely holds none of the
+// queried denom, (2) the StargateClient ABCI query path failed to decode
+// the response (Hermes/React-Native packaging discrepancies with cosmjs's
+// internal HTTP layer have produced false-zero returns in production,
+// see Terra/TerraClassic balance discrepancy on iOS sim 2026-05-27 where
+// LCD returned 4_800_000_000 uluna while StargateClient returned 0n for
+// the same address+denom).
+//
+// LCD uses a different infra path (REST vs Tendermint RPC) and gives us
+// a second chance before we ship a "you have 0" UX that contradicts the
+// on-chain reality.
+const fetchBalanceViaLcd = async (chain, address, denom) => {
+    const base = cosmosRpcUrl[chain];
+    if (!base)
+        return null;
+    try {
+        const resp = await queryUrl(`${base}/cosmos/bank/v1beta1/balances/${address}/by_denom?denom=${encodeURIComponent(denom)}`);
+        const amount = resp.balance?.amount;
+        if (!amount)
+            return null;
+        const parsed = BigInt(amount);
+        if (parsed < 0n)
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+};
 export const getCosmosCoinBalance = async (input) => {
     if (isCosmosWasmTokenId(input.id)) {
         const url = getCosmosWasmTokenBalanceUrl(input);
@@ -11,6 +42,16 @@ export const getCosmosCoinBalance = async (input) => {
     const client = await getCosmosClient(input.chain);
     const denom = getDenom(input);
     const balance = await client.getBalance(input.address, denom);
-    return BigInt(balance.amount);
+    const rpcAmount = BigInt(balance.amount);
+    // RPC returned 0 — could be a genuinely empty wallet OR a silent decode
+    // failure (cosmjs in Hermes has bitten us here). Confirm via LCD before
+    // trusting the zero. If LCD also returns 0 / null, fall through.
+    if (rpcAmount === 0n) {
+        const lcdAmount = await fetchBalanceViaLcd(input.chain, input.address, denom);
+        if (lcdAmount !== null && lcdAmount > 0n) {
+            return lcdAmount;
+        }
+    }
+    return rpcAmount;
 };
 //# sourceMappingURL=cosmos.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"cosmos.js","sourceRoot":"","sources":["../../../../../../../packages/core/chain/coin/balance/resolvers/cosmos.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAA;AAC3E,OAAO,EAAE,4BAA4B,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAA;AACnH,OAAO,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAA;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAA;AAI7D,MAAM,CAAC,MAAM,oBAAoB,GAAqC,KAAK,EAAC,KAAK,EAAC,EAAE;IAClF,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAA;QAC/C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,QAAQ,CAAoB,GAAG,CAAC,CAAA;QACvD,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,CAAA;IAClC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAEjD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAE7B,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAE7D,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;AAC/B,CAAC,CAAA"}
+{"version":3,"file":"cosmos.js","sourceRoot":"","sources":["../../../../../../../packages/core/chain/coin/balance/resolvers/cosmos.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAA;AAC3E,OAAO,EACL,YAAY,EACZ,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,iDAAiD,CAAA;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAA;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAA;AAW7D,sEAAsE;AACtE,yEAAyE;AACzE,uEAAuE;AACvE,yEAAyE;AACzE,0EAA0E;AAC1E,sEAAsE;AACtE,yEAAyE;AACzE,wEAAwE;AACxE,2BAA2B;AAC3B,EAAE;AACF,wEAAwE;AACxE,wEAAwE;AACxE,oBAAoB;AACpB,MAAM,kBAAkB,GAAG,KAAK,EAAE,KAAkB,EAAE,OAAe,EAAE,KAAa,EAA0B,EAAE;IAC9G,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IAChC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IACtB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CACzB,GAAG,IAAI,iCAAiC,OAAO,mBAAmB,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAC9F,CAAA;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAA;QACnC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAA;QACxB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;QAC7B,IAAI,MAAM,GAAG,EAAE;YAAE,OAAO,IAAI,CAAA;QAC5B,OAAO,MAAM,CAAA;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAqC,KAAK,EAAC,KAAK,EAAC,EAAE;IAClF,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAA;QAC/C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,QAAQ,CAAoB,GAAG,CAAC,CAAA;QACvD,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,CAAA;IAClC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAEjD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAE7B,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAC7D,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAExC,wEAAwE;IACxE,wEAAwE;IACxE,iEAAiE;IACjE,IAAI,SAAS,KAAK,EAAE,EAAE,CAAC;QACrB,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAC7E,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,GAAG,EAAE,EAAE,CAAC;YACzC,OAAO,SAAS,CAAA;QAClB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vultisig/core-chain",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "Blockchain chain logic shared across Vultisig clients",
   "license": "MIT",
   "repository": {