@vultisig/core-chain 1.4.2 → 1.4.3

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @vultisig/core-chain
 
+## 1.4.3
+
+### Patch Changes
+
+- [#360](https://github.com/vultisig/vultisig-sdk/pull/360) [`e52914b`](https://github.com/vultisig/vultisig-sdk/commit/e52914ba87f2d740847fc0de3a49827b0da3e0ba) Thanks [@NeOMakinG](https://github.com/NeOMakinG)! - `@vultisig/core-chain`: lift the qbtc protobuf wire-format helpers to a shared `chains/cosmos/protoEncoding` module (extending it with lower-level `varintBig` / `protoField` primitives that don't apply proto3 default-elision, alongside the existing default-eliding `protoVarint` / `protoBytes` / `protoString`), and add `chains/cosmos/terraClassicTax` with LCD fetchers (`getTerraClassicTaxRate`, `getTerraClassicTaxCap`) plus the pure `applyTerraClassicTax` helper for the cosmos-sdk Dec-fixed-point math. Tax rate is `0` on the live chain today (governance-paused) but the helpers are ready for callers that need to be correct when it reactivates. The previous `qbtc/protoEncoding` package export is replaced by `cosmos/protoEncoding`; the qbtc consumers were updated in lockstep, no behavior change.
+
 ## 1.4.2
 
 ### Patch Changes

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

@@ -0,0 +1,68 @@
+/**
+ * Manual protobuf wire-format encoding for cosmos-sdk transactions.
+ *
+ * Required because WalletCore cannot handle every proto message we need to
+ * sign — MLDSA-keyed QBTC, and React-Native paths that intentionally avoid
+ * the WalletCore IBC-transfer encoder so they can run without the native
+ * dependency.
+ *
+ * Two layers:
+ *
+ *  Lower-level (`varintBig`, `protoField`) — primitives that do NOT apply
+ *    proto3 default-elision. Callers handle the "skip on zero / empty string"
+ *    contract themselves at message-build time. Useful when the caller already
+ *    knows which fields are present (e.g. cosmjs-types-style encoders, IBC
+ *    `MsgTransfer` where `timeout_height` is always emitted even when zeroed).
+ *
+ *  Higher-level (`protoVarint`, `protoBytes`, `protoString`) — apply proto3
+ *    default-elision automatically (skip 0n / empty bytes / empty string).
+ *    Used by QBTC's claim message builder where the call sites are exhaustive
+ *    and shorter to write without per-field guards.
+ *
+ *  Both layers share `concatBytes`.
+ */
+/**
+ * Protobuf wire-type tags. We only encode wire types 0 (varint) and 2
+ * (length-delimited) — every cosmos-sdk + IBC message we sign is composed of
+ * these two. Wire types 1/5 (fixed64/fixed32) and 3/4 (deprecated groups) are
+ * not used.
+ *
+ * @see https://protobuf.dev/programming-guides/encoding/#structure
+ */
+export declare const WireType: {
+    readonly Varint: 0;
+    readonly LengthDelimited: 2;
+};
+export type WireType = (typeof WireType)[keyof typeof WireType];
+/**
+ * Encodes a UInt64 as a protobuf base-128 varint.
+ *
+ * Bigint-only: callers like IBC `MsgTransfer.timeout_timestamp` carry UNIX
+ * nanoseconds, which crossed 2^53 in 2022 — a JS `number` shift-based varint
+ * silently corrupts those values. The full 64-bit unsigned range
+ * (`0n .. 2^64 - 1`) is supported and validated.
+ */
+export declare const varintBig: (value: bigint) => Uint8Array;
+/**
+ * Lower-level field encoder. Emits a tag followed by the field payload — the
+ * payload is treated as opaque bytes (you must already have encoded it
+ * correctly for the wire type). Does NOT apply proto3 default-elision.
+ *
+ * For varint fields (wireType 0), pass `varintBig(value)` as the data. For
+ * length-delimited fields (wireType 2), the caller is responsible for the
+ * length prefix only when payload is provided pre-length-prefixed; this
+ * function adds the length prefix automatically for wire type 2.
+ *
+ * Used by IBC-transfer encoders (`MsgTransfer`, the inner `Height` submessage)
+ * where some fields must be emitted even at the proto3 default value.
+ */
+export declare const protoField: (fieldNumber: number, wireType: WireType, data: Uint8Array) => Uint8Array;
+/** Appends a varint field (wire type 0). Skips if value is 0 (proto3 default). */
+export declare const protoVarint: (fieldNumber: number, value: bigint) => Uint8Array;
+/** Appends a length-delimited field (wire type 2) for raw bytes. */
+export declare const protoBytes: (fieldNumber: number, data: Uint8Array) => Uint8Array;
+/** Appends a length-delimited field (wire type 2) for a UTF-8 string. */
+export declare const protoString: (fieldNumber: number, value: string) => Uint8Array;
+/** Concatenates multiple Uint8Arrays. */
+export declare const concatBytes: (...arrays: Uint8Array[]) => Uint8Array;
+//# sourceMappingURL=protoEncoding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protoEncoding.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/chains/cosmos/protoEncoding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ;;;CAGX,CAAA;AAEV,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAA;AAM/D;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,KAAG,UAazC,CAAA;AA2BD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,GACrB,aAAa,MAAM,EACnB,UAAU,QAAQ,EAClB,MAAM,UAAU,KACf,UAQF,CAAA;AAMD,kFAAkF;AAClF,eAAO,MAAM,WAAW,GAAI,aAAa,MAAM,EAAE,OAAO,MAAM,KAAG,UAGhE,CAAA;AAED,oEAAoE;AACpE,eAAO,MAAM,UAAU,GACrB,aAAa,MAAM,EACnB,MAAM,UAAU,KACf,UAGF,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,WAAW,GAAI,aAAa,MAAM,EAAE,OAAO,MAAM,KAAG,UAGhE,CAAA;AAMD,yCAAyC;AACzC,eAAO,MAAM,WAAW,GAAI,GAAG,QAAQ,UAAU,EAAE,KAAG,UASrD,CAAA"}

package/dist/chains/cosmos/protoEncoding.js

@@ -0,0 +1,140 @@
+/**
+ * Manual protobuf wire-format encoding for cosmos-sdk transactions.
+ *
+ * Required because WalletCore cannot handle every proto message we need to
+ * sign — MLDSA-keyed QBTC, and React-Native paths that intentionally avoid
+ * the WalletCore IBC-transfer encoder so they can run without the native
+ * dependency.
+ *
+ * Two layers:
+ *
+ *  Lower-level (`varintBig`, `protoField`) — primitives that do NOT apply
+ *    proto3 default-elision. Callers handle the "skip on zero / empty string"
+ *    contract themselves at message-build time. Useful when the caller already
+ *    knows which fields are present (e.g. cosmjs-types-style encoders, IBC
+ *    `MsgTransfer` where `timeout_height` is always emitted even when zeroed).
+ *
+ *  Higher-level (`protoVarint`, `protoBytes`, `protoString`) — apply proto3
+ *    default-elision automatically (skip 0n / empty bytes / empty string).
+ *    Used by QBTC's claim message builder where the call sites are exhaustive
+ *    and shorter to write without per-field guards.
+ *
+ *  Both layers share `concatBytes`.
+ */
+// ---------------------------------------------------------------------------
+// Wire type constants
+// ---------------------------------------------------------------------------
+/**
+ * Protobuf wire-type tags. We only encode wire types 0 (varint) and 2
+ * (length-delimited) — every cosmos-sdk + IBC message we sign is composed of
+ * these two. Wire types 1/5 (fixed64/fixed32) and 3/4 (deprecated groups) are
+ * not used.
+ *
+ * @see https://protobuf.dev/programming-guides/encoding/#structure
+ */
+export const WireType = {
+    Varint: 0,
+    LengthDelimited: 2,
+};
+// ---------------------------------------------------------------------------
+// Primitive encoders
+// ---------------------------------------------------------------------------
+/**
+ * Encodes a UInt64 as a protobuf base-128 varint.
+ *
+ * Bigint-only: callers like IBC `MsgTransfer.timeout_timestamp` carry UNIX
+ * nanoseconds, which crossed 2^53 in 2022 — a JS `number` shift-based varint
+ * silently corrupts those values. The full 64-bit unsigned range
+ * (`0n .. 2^64 - 1`) is supported and validated.
+ */
+export const varintBig = (value) => {
+    if (value < 0n || value > 0xffffffffffffffffn) {
+        throw new RangeError('varintBig expects an unsigned 64-bit integer');
+    }
+    const bytes = [];
+    let v = value;
+    while (v > 0x7fn) {
+        bytes.push(Number(v & 0x7fn) | 0x80);
+        v >>= 7n;
+    }
+    bytes.push(Number(v));
+    return new Uint8Array(bytes);
+};
+/**
+ * Encodes a (fieldNumber, wireType) pair as a single varint tag.
+ *
+ * Tag layout: `(fieldNumber << 3) | wireType`. `fieldNumber` must fit in
+ * 29 bits (proto spec MAX_FIELD_NUMBER = 2^29 - 1).
+ */
+const encodeFieldTag = (fieldNumber, wireType) => {
+    // The legal proto field-number range is [1, 2^29 - 1]. JS bitwise ops
+    // operate on signed 32-bit integers, so `fieldNumber << 3` overflows
+    // the signed lane once fieldNumber >= 2^28 — the resulting tag would
+    // be wrong (or negative) for the upper half of the legal range.
+    // Compute in bigint space to keep the full range correct, even though
+    // the only current call sites use low field numbers.
+    if (!Number.isInteger(fieldNumber) ||
+        fieldNumber < 1 ||
+        fieldNumber >= 2 ** 29) {
+        throw new RangeError(`encodeFieldTag: fieldNumber must be in [1, 2^29 - 1], got ${fieldNumber}`);
+    }
+    return varintBig((BigInt(fieldNumber) << 3n) | BigInt(wireType));
+};
+/**
+ * Lower-level field encoder. Emits a tag followed by the field payload — the
+ * payload is treated as opaque bytes (you must already have encoded it
+ * correctly for the wire type). Does NOT apply proto3 default-elision.
+ *
+ * For varint fields (wireType 0), pass `varintBig(value)` as the data. For
+ * length-delimited fields (wireType 2), the caller is responsible for the
+ * length prefix only when payload is provided pre-length-prefixed; this
+ * function adds the length prefix automatically for wire type 2.
+ *
+ * Used by IBC-transfer encoders (`MsgTransfer`, the inner `Height` submessage)
+ * where some fields must be emitted even at the proto3 default value.
+ */
+export const protoField = (fieldNumber, wireType, data) => {
+    const tag = encodeFieldTag(fieldNumber, wireType);
+    if (wireType === WireType.LengthDelimited) {
+        const length = varintBig(BigInt(data.length));
+        return concatBytes(tag, length, data);
+    }
+    // Varint: data is already the encoded varint bytes.
+    return concatBytes(tag, data);
+};
+// ---------------------------------------------------------------------------
+// Default-eliding higher-level encoders
+// ---------------------------------------------------------------------------
+/** Appends a varint field (wire type 0). Skips if value is 0 (proto3 default). */
+export const protoVarint = (fieldNumber, value) => {
+    if (value === 0n)
+        return new Uint8Array(0);
+    return protoField(fieldNumber, WireType.Varint, varintBig(value));
+};
+/** Appends a length-delimited field (wire type 2) for raw bytes. */
+export const protoBytes = (fieldNumber, data) => {
+    if (data.length === 0)
+        return new Uint8Array(0);
+    return protoField(fieldNumber, WireType.LengthDelimited, data);
+};
+/** Appends a length-delimited field (wire type 2) for a UTF-8 string. */
+export const protoString = (fieldNumber, value) => {
+    if (value.length === 0)
+        return new Uint8Array(0);
+    return protoBytes(fieldNumber, new TextEncoder().encode(value));
+};
+// ---------------------------------------------------------------------------
+// Utilities
+// ---------------------------------------------------------------------------
+/** Concatenates multiple Uint8Arrays. */
+export const concatBytes = (...arrays) => {
+    const totalLength = arrays.reduce((sum, arr) => sum + arr.length, 0);
+    const result = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const arr of arrays) {
+        result.set(arr, offset);
+        offset += arr.length;
+    }
+    return result;
+};
+//# sourceMappingURL=protoEncoding.js.map

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

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

package/dist/chains/cosmos/qbtc/claim/buildClaimTx.js

@@ -1,4 +1,4 @@
-import { concatBytes, protoBytes, protoString, protoVarint, } from '@vultisig/core-chain/chains/cosmos/qbtc/protoEncoding';
+import { concatBytes, protoBytes, protoString, protoVarint, } from '@vultisig/core-chain/chains/cosmos/protoEncoding';
 const msgClaimWithProofTypeURL = '/qbtc.qbtc.v1.MsgClaimWithProof';
 const isHex = (value) => /^[0-9a-f]+$/i.test(value);
 const assertHex = (value, name, expectedLength) => {

package/dist/chains/cosmos/qbtc/claim/buildClaimTx.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildClaimTx.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/claim/buildClaimTx.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,UAAU,EACV,WAAW,EACX,WAAW,GACZ,MAAM,uDAAuD,CAAA;AAE9D,MAAM,wBAAwB,GAAG,iCAAiC,CAAA;AAsBlE,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AAE3D,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,IAAY,EAAE,cAAsB,EAAE,EAAE;IACxE,IAAI,KAAK,CAAC,MAAM,KAAK,cAAc,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,YAAY,cAAc,mBAAmB,KAAK,CAAC,MAAM,EAAE,CACnE,CAAA;IACH,CAAC;AACH,CAAC,CAAA;AAED,6EAA6E;AAC7E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAkC,EAAE,EAAE;IACvE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,GAAG,KAAK,CAAA;IAEzE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,iCAAiC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;IAClE,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,MAAM,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;QAC5E,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,oDAAoD,IAAI,EAAE,CAAC,CAAA;QAC7E,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAA;QAC7B,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAA;QACrD,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACf,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAA;IACrF,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,OAAO,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;IACnE,CAAC;IACD,SAAS,CAAC,WAAW,EAAE,cAAc,EAAE,EAAE,CAAC,CAAA;IAC1C,SAAS,CAAC,WAAW,EAAE,cAAc,EAAE,EAAE,CAAC,CAAA;IAC1C,SAAS,CAAC,eAAe,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAA;AACrD,CAAC,CAAA;AAED,4CAA4C;AAC5C,MAAM,aAAa,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAW,EAAc,EAAE,CAC5D,WAAW,CAAC,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AAEjE,mDAAmD;AACnD,MAAM,sBAAsB,GAAG,CAC7B,KAAkC,EACtB,EAAE;IACd,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAE7E,OAAO,WAAW,CAChB,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,EAC7B,GAAG,SAAS,EACZ,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,EAC3B,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,EACjC,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,EACjC,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,CACtC,CAAA;AACH,CAAC,CAAA;AAED,uDAAuD;AACvD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,KAAkC,EACtB,EAAE;IACd,kBAAkB,CAAC,KAAK,CAAC,CAAA;IACzB,MAAM,GAAG,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAA;IACzC,OAAO,WAAW,CAChB,WAAW,CAAC,CAAC,EAAE,wBAAwB,CAAC,EACxC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CACnB,CAAA;AACH,CAAC,CAAA;AAED,+DAA+D;AAC/D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,KAAkC,EACtB,EAAE;IACd,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAA;IAC5C,OAAO,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;AAC9B,CAAC,CAAA"}
+{"version":3,"file":"buildClaimTx.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/cosmos/qbtc/claim/buildClaimTx.ts"],"names":[],"mappings":"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"}

package/dist/chains/cosmos/qbtc/protoEncoding.d.ts

@@ -1,13 +1,14 @@
 /**
- * Manual protobuf wire-format encoding for QBTC transactions.
- * Required because WalletCore cannot handle MLDSA keys.
+ * @deprecated Import from `@vultisig/core-chain/chains/cosmos/protoEncoding`.
+ *
+ * This subpath used to host the QBTC-specific manual protobuf encoders. The
+ * helpers were lifted to the shared `cosmos/protoEncoding` module so non-QBTC
+ * cosmos message builders (e.g. IBC `MsgTransfer` in vultiagent-app#303) can
+ * consume the same canonical primitives. This shim preserves the old import
+ * path so external consumers don't break — the wire bytes are unchanged.
+ *
+ * Removing this shim would be a breaking package-export change and must wait
+ * until a major version bump.
  */
-/** Appends a varint field (wire type 0). Skips if value is 0 (proto3 default). */
-export declare const protoVarint: (fieldNumber: number, value: bigint) => Uint8Array;
-/** Appends a length-delimited field (wire type 2) for raw bytes. */
-export declare const protoBytes: (fieldNumber: number, data: Uint8Array) => Uint8Array;
-/** Appends a length-delimited field (wire type 2) for a UTF-8 string. */
-export declare const protoString: (fieldNumber: number, value: string) => Uint8Array;
-/** Concatenates multiple Uint8Arrays. */
-export declare const concatBytes: (...arrays: Uint8Array[]) => Uint8Array;
+export { concatBytes, protoBytes, protoString, protoVarint, } from '../protoEncoding.js';
 //# sourceMappingURL=protoEncoding.d.ts.map

package/dist/chains/cosmos/qbtc/protoEncoding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protoEncoding.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/chains/cosmos/qbtc/protoEncoding.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,kFAAkF;AAClF,eAAO,MAAM,WAAW,GAAI,aAAa,MAAM,EAAE,OAAO,MAAM,KAAG,UAKhE,CAAA;AAED,oEAAoE;AACpE,eAAO,MAAM,UAAU,GACrB,aAAa,MAAM,EACnB,MAAM,UAAU,KACf,UAKF,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,WAAW,GAAI,aAAa,MAAM,EAAE,OAAO,MAAM,KAAG,UAGhE,CAAA;AAED,yCAAyC;AACzC,eAAO,MAAM,WAAW,GAAI,GAAG,QAAQ,UAAU,EAAE,KAAG,UASrD,CAAA"}
+{"version":3,"file":"protoEncoding.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/chains/cosmos/qbtc/protoEncoding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EACL,WAAW,EACX,UAAU,EACV,WAAW,EACX,WAAW,GACZ,MAAM,kBAAkB,CAAA"}

package/dist/chains/cosmos/qbtc/protoEncoding.js

@@ -1,52 +1,14 @@
 /**
- * Manual protobuf wire-format encoding for QBTC transactions.
- * Required because WalletCore cannot handle MLDSA keys.
+ * @deprecated Import from `@vultisig/core-chain/chains/cosmos/protoEncoding`.
+ *
+ * This subpath used to host the QBTC-specific manual protobuf encoders. The
+ * helpers were lifted to the shared `cosmos/protoEncoding` module so non-QBTC
+ * cosmos message builders (e.g. IBC `MsgTransfer` in vultiagent-app#303) can
+ * consume the same canonical primitives. This shim preserves the old import
+ * path so external consumers don't break — the wire bytes are unchanged.
+ *
+ * Removing this shim would be a breaking package-export change and must wait
+ * until a major version bump.
  */
-/** Encodes a UInt64 as a protobuf base-128 varint. */
-const encodeVarint = (value) => {
-    if (value < 0n || value > 0xffffffffffffffffn) {
-        throw new RangeError('encodeVarint expects an unsigned 64-bit integer');
-    }
-    const bytes = [];
-    let v = value;
-    while (v > 0x7fn) {
-        bytes.push(Number(v & 0x7fn) | 0x80);
-        v >>= 7n;
-    }
-    bytes.push(Number(v));
-    return new Uint8Array(bytes);
-};
-/** Appends a varint field (wire type 0). Skips if value is 0 (proto3 default). */
-export const protoVarint = (fieldNumber, value) => {
-    if (value === 0n)
-        return new Uint8Array(0);
-    const tag = encodeVarint(BigInt((fieldNumber << 3) | 0));
-    const data = encodeVarint(value);
-    return concatBytes(tag, data);
-};
-/** Appends a length-delimited field (wire type 2) for raw bytes. */
-export const protoBytes = (fieldNumber, data) => {
-    if (data.length === 0)
-        return new Uint8Array(0);
-    const tag = encodeVarint(BigInt((fieldNumber << 3) | 2));
-    const length = encodeVarint(BigInt(data.length));
-    return concatBytes(tag, length, data);
-};
-/** Appends a length-delimited field (wire type 2) for a UTF-8 string. */
-export const protoString = (fieldNumber, value) => {
-    if (value.length === 0)
-        return new Uint8Array(0);
-    return protoBytes(fieldNumber, new TextEncoder().encode(value));
-};
-/** Concatenates multiple Uint8Arrays. */
-export const concatBytes = (...arrays) => {
-    const totalLength = arrays.reduce((sum, arr) => sum + arr.length, 0);
-    const result = new Uint8Array(totalLength);
-    let offset = 0;
-    for (const arr of arrays) {
-        result.set(arr, offset);
-        offset += arr.length;
-    }
-    return result;
-};
+export { concatBytes, protoBytes, protoString, protoVarint, } from '../protoEncoding.js';
 //# sourceMappingURL=protoEncoding.js.map

package/dist/chains/cosmos/qbtc/protoEncoding.js.map

@@ -1 +1 @@
-{"version":3,"file":"protoEncoding.js","sourceRoot":"","sources":["../../../../../../../packages/core/chain/chains/cosmos/qbtc/protoEncoding.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sDAAsD;AACtD,MAAM,YAAY,GAAG,CAAC,KAAa,EAAc,EAAE;IACjD,IAAI,KAAK,GAAG,EAAE,IAAI,KAAK,GAAG,mBAAsB,EAAE,CAAC;QACjD,MAAM,IAAI,UAAU,CAAC,iDAAiD,CAAC,CAAA;IACzE,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,CAAC,GAAG,KAAK,CAAA;IACb,OAAO,CAAC,GAAG,KAAK,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,CAAA;QACpC,CAAC,KAAK,EAAE,CAAA;IACV,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IACrB,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAA;AAC9B,CAAC,CAAA;AAED,kFAAkF;AAClF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,WAAmB,EAAE,KAAa,EAAc,EAAE;IAC5E,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAA;IAC1C,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACxD,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IAChC,OAAO,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;AAC/B,CAAC,CAAA;AAED,oEAAoE;AACpE,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,WAAmB,EACnB,IAAgB,EACJ,EAAE;IACd,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAA;IAC/C,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACxD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;IAChD,OAAO,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,CAAA;AACvC,CAAC,CAAA;AAED,yEAAyE;AACzE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,WAAmB,EAAE,KAAa,EAAc,EAAE;IAC5E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAA;IAChD,OAAO,UAAU,CAAC,WAAW,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;AACjE,CAAC,CAAA;AAED,yCAAyC;AACzC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAG,MAAoB,EAAc,EAAE;IACjE,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IACpE,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAA;IAC1C,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QACvB,MAAM,IAAI,GAAG,CAAC,MAAM,CAAA;IACtB,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}
+{"version":3,"file":"protoEncoding.js","sourceRoot":"","sources":["../../../../../../../packages/core/chain/chains/cosmos/qbtc/protoEncoding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EACL,WAAW,EACX,UAAU,EACV,WAAW,EACX,WAAW,GACZ,MAAM,kBAAkB,CAAA"}

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

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

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

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

package/dist/chains/cosmos/terraClassicTax.js

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

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vultisig/core-chain",
-  "version": "1.4.2",
+  "version": "1.4.3",
   "description": "Blockchain chain logic shared across Vultisig clients",
   "license": "MIT",
   "repository": {
@@ -224,6 +224,11 @@
       "import": "./dist/chains/cosmos/gas.js",
       "default": "./dist/chains/cosmos/gas.js"
     },
+    "./chains/cosmos/protoEncoding": {
+      "types": "./dist/chains/cosmos/protoEncoding.d.ts",
+      "import": "./dist/chains/cosmos/protoEncoding.js",
+      "default": "./dist/chains/cosmos/protoEncoding.js"
+    },
     "./chains/cosmos/qbtc/claim/broadcastClaimTx": {
       "types": "./dist/chains/cosmos/qbtc/claim/broadcastClaimTx.d.ts",
       "import": "./dist/chains/cosmos/qbtc/claim/broadcastClaimTx.js",
@@ -299,6 +304,11 @@
       "import": "./dist/chains/cosmos/tendermintRpcUrl.js",
       "default": "./dist/chains/cosmos/tendermintRpcUrl.js"
     },
+    "./chains/cosmos/terraClassicTax": {
+      "types": "./dist/chains/cosmos/terraClassicTax.d.ts",
+      "import": "./dist/chains/cosmos/terraClassicTax.js",
+      "default": "./dist/chains/cosmos/terraClassicTax.js"
+    },
     "./chains/cosmos/thor/getThorchainInboundAddress": {
       "types": "./dist/chains/cosmos/thor/getThorchainInboundAddress.d.ts",
       "import": "./dist/chains/cosmos/thor/getThorchainInboundAddress.js",