@kynesyslabs/demosdk 2.11.6 → 2.12.0

package/build/denomination/constants.d.ts

@@ -0,0 +1,24 @@
+/**
+ * DEM/OS denomination constants.
+ *
+ * The Demos Network uses two denomination units:
+ * - DEM: human-readable, the "display" unit users think in.
+ * - OS:  the smallest indivisible unit, used internally and on the wire.
+ *
+ * Conversion: 1 DEM = 10^9 OS (1 000 000 000 OS).
+ *
+ * All on-chain math is performed in OS as `bigint` to avoid floating-point
+ * precision loss. Wire format is the OS amount serialized as a decimal string.
+ */
+/** Number of decimal places between DEM and OS. */
+export declare const OS_DECIMALS = 9;
+/**
+ * Number of OS in 1 DEM, as a `bigint`.
+ *
+ * @example OS_PER_DEM === 1_000_000_000n
+ */
+export declare const OS_PER_DEM: bigint;
+/** Minimum transferable amount: 1 OS. */
+export declare const MIN_AMOUNT_OS = 1n;
+/** Zero amount constant in OS. */
+export declare const ZERO_OS = 0n;

package/build/denomination/constants.js

@@ -0,0 +1,27 @@
+/**
+ * DEM/OS denomination constants.
+ *
+ * The Demos Network uses two denomination units:
+ * - DEM: human-readable, the "display" unit users think in.
+ * - OS:  the smallest indivisible unit, used internally and on the wire.
+ *
+ * Conversion: 1 DEM = 10^9 OS (1 000 000 000 OS).
+ *
+ * All on-chain math is performed in OS as `bigint` to avoid floating-point
+ * precision loss. Wire format is the OS amount serialized as a decimal string.
+ */
+// REVIEW: P0 foundation — denomination constants exported but not yet used by
+// any existing SDK code. Adoption happens in later phases.
+/** Number of decimal places between DEM and OS. */
+export const OS_DECIMALS = 9;
+/**
+ * Number of OS in 1 DEM, as a `bigint`.
+ *
+ * @example OS_PER_DEM === 1_000_000_000n
+ */
+export const OS_PER_DEM = BigInt(10 ** OS_DECIMALS); // 1_000_000_000n
+/** Minimum transferable amount: 1 OS. */
+export const MIN_AMOUNT_OS = 1n;
+/** Zero amount constant in OS. */
+export const ZERO_OS = 0n;
+//# sourceMappingURL=constants.js.map

package/build/denomination/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/denomination/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,8EAA8E;AAC9E,2DAA2D;AAE3D,mDAAmD;AACnD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAA;AAE5B;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,EAAE,IAAI,WAAW,CAAC,CAAA,CAAC,iBAAiB;AAErE,yCAAyC;AACzC,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAA;AAE/B,kCAAkC;AAClC,MAAM,CAAC,MAAM,OAAO,GAAG,EAAE,CAAA"}

package/build/denomination/conversion.d.ts

@@ -0,0 +1,78 @@
+/**
+ * DEM <-> OS conversion utilities.
+ *
+ * Internal representation: `bigint` (OS, smallest unit).
+ * Wire representation:     decimal `string` (OS).
+ * Display representation:  decimal `string` (DEM, human-readable).
+ *
+ * 1 DEM = 10^9 OS.
+ */
+/**
+ * Convert a DEM amount (human-readable) to an OS amount (smallest unit).
+ *
+ * Accepts `number` or `string` for ergonomics. The result is always a `bigint`.
+ * Strings are preferred for high-precision input because JavaScript `number`
+ * cannot represent every 9-decimal value exactly.
+ *
+ * Throws if:
+ * - The input has more than {@link OS_DECIMALS} fractional digits.
+ * - The resulting amount is negative.
+ *
+ * @example demToOs(1)            // => 1_000_000_000n
+ * @example demToOs("0.5")        // => 500_000_000n
+ * @example demToOs(100)          // => 100_000_000_000n
+ * @example demToOs("1.123456789")// => 1_123_456_789n
+ *
+ * @param dem - DEM amount as `number` or decimal `string`.
+ * @returns OS amount as `bigint`.
+ */
+export declare function demToOs(dem: number | string): bigint;
+/**
+ * Convert an OS amount (smallest unit) to a DEM string (human-readable).
+ *
+ * Always returns a `string` to preserve precision. The result has exactly one
+ * decimal point, with trailing fractional zeros trimmed (but at least one
+ * fractional digit retained).
+ *
+ * Negative inputs are supported and produce a leading `-`.
+ *
+ * @example osToDem(1_000_000_000n) // => "1.0"
+ * @example osToDem(500_000_000n)   // => "0.5"
+ * @example osToDem(1n)             // => "0.000000001"
+ * @example osToDem(0n)             // => "0.0"
+ *
+ * @param os - OS amount as `bigint`.
+ * @returns DEM amount as decimal `string`.
+ */
+export declare function osToDem(os: bigint): string;
+/**
+ * Parse a wire-format OS string into a `bigint`.
+ *
+ * The wire format is always the OS amount as a base-10 integer string.
+ *
+ * @example parseOsString("1000000000") // => 1_000_000_000n
+ *
+ * @param osString - OS amount as a decimal integer string.
+ * @returns OS amount as `bigint`.
+ */
+export declare function parseOsString(osString: string): bigint;
+/**
+ * Serialize a `bigint` OS amount to its wire-format string.
+ *
+ * @example toOsString(1_000_000_000n) // => "1000000000"
+ *
+ * @param os - OS amount as `bigint`.
+ * @returns OS amount as a decimal integer string.
+ */
+export declare function toOsString(os: bigint): string;
+/**
+ * Format an OS amount as a human-readable DEM string with a unit suffix.
+ *
+ * Useful for log lines, error messages, and UI display.
+ *
+ * @example formatDem(1_000_000_000n) // => "1.0 DEM"
+ *
+ * @param os - OS amount as `bigint`.
+ * @returns Human-readable DEM string with " DEM" suffix.
+ */
+export declare function formatDem(os: bigint): string;

package/build/denomination/conversion.js

@@ -0,0 +1,114 @@
+/**
+ * DEM <-> OS conversion utilities.
+ *
+ * Internal representation: `bigint` (OS, smallest unit).
+ * Wire representation:     decimal `string` (OS).
+ * Display representation:  decimal `string` (DEM, human-readable).
+ *
+ * 1 DEM = 10^9 OS.
+ */
+import { OS_DECIMALS, ZERO_OS } from "./constants.js";
+// REVIEW: P0 foundation — conversion utilities exported but not yet wired into
+// any existing SDK code path. They are dormant until later migration phases.
+/**
+ * Convert a DEM amount (human-readable) to an OS amount (smallest unit).
+ *
+ * Accepts `number` or `string` for ergonomics. The result is always a `bigint`.
+ * Strings are preferred for high-precision input because JavaScript `number`
+ * cannot represent every 9-decimal value exactly.
+ *
+ * Throws if:
+ * - The input has more than {@link OS_DECIMALS} fractional digits.
+ * - The resulting amount is negative.
+ *
+ * @example demToOs(1)            // => 1_000_000_000n
+ * @example demToOs("0.5")        // => 500_000_000n
+ * @example demToOs(100)          // => 100_000_000_000n
+ * @example demToOs("1.123456789")// => 1_123_456_789n
+ *
+ * @param dem - DEM amount as `number` or decimal `string`.
+ * @returns OS amount as `bigint`.
+ */
+export function demToOs(dem) {
+    const str = typeof dem === "number" ? dem.toString() : dem;
+    // Split on decimal point. Missing fractional part defaults to "".
+    const [whole, frac = ""] = str.split(".");
+    if (frac.length > OS_DECIMALS) {
+        throw new Error(`DEM amount "${str}" exceeds maximum ${OS_DECIMALS} decimal places`);
+    }
+    // Pad fractional part to exactly OS_DECIMALS digits, then concatenate.
+    const paddedFrac = frac.padEnd(OS_DECIMALS, "0");
+    const combined = `${whole}${paddedFrac}`;
+    const result = BigInt(combined);
+    if (result < ZERO_OS) {
+        throw new Error(`Negative amounts not allowed: ${str}`);
+    }
+    return result;
+}
+/**
+ * Convert an OS amount (smallest unit) to a DEM string (human-readable).
+ *
+ * Always returns a `string` to preserve precision. The result has exactly one
+ * decimal point, with trailing fractional zeros trimmed (but at least one
+ * fractional digit retained).
+ *
+ * Negative inputs are supported and produce a leading `-`.
+ *
+ * @example osToDem(1_000_000_000n) // => "1.0"
+ * @example osToDem(500_000_000n)   // => "0.5"
+ * @example osToDem(1n)             // => "0.000000001"
+ * @example osToDem(0n)             // => "0.0"
+ *
+ * @param os - OS amount as `bigint`.
+ * @returns DEM amount as decimal `string`.
+ */
+export function osToDem(os) {
+    const isNegative = os < ZERO_OS;
+    const abs = isNegative ? -os : os;
+    // Pad so we always have at least OS_DECIMALS+1 digits, ensuring the
+    // whole-number slice is non-empty for sub-1-DEM values.
+    const str = abs.toString().padStart(OS_DECIMALS + 1, "0");
+    const whole = str.slice(0, str.length - OS_DECIMALS);
+    const frac = str.slice(str.length - OS_DECIMALS);
+    // Trim trailing zeros from fractional part, but keep at least one digit.
+    const trimmedFrac = frac.replace(/0+$/, "") || "0";
+    return `${isNegative ? "-" : ""}${whole}.${trimmedFrac}`;
+}
+/**
+ * Parse a wire-format OS string into a `bigint`.
+ *
+ * The wire format is always the OS amount as a base-10 integer string.
+ *
+ * @example parseOsString("1000000000") // => 1_000_000_000n
+ *
+ * @param osString - OS amount as a decimal integer string.
+ * @returns OS amount as `bigint`.
+ */
+export function parseOsString(osString) {
+    return BigInt(osString);
+}
+/**
+ * Serialize a `bigint` OS amount to its wire-format string.
+ *
+ * @example toOsString(1_000_000_000n) // => "1000000000"
+ *
+ * @param os - OS amount as `bigint`.
+ * @returns OS amount as a decimal integer string.
+ */
+export function toOsString(os) {
+    return os.toString();
+}
+/**
+ * Format an OS amount as a human-readable DEM string with a unit suffix.
+ *
+ * Useful for log lines, error messages, and UI display.
+ *
+ * @example formatDem(1_000_000_000n) // => "1.0 DEM"
+ *
+ * @param os - OS amount as `bigint`.
+ * @returns Human-readable DEM string with " DEM" suffix.
+ */
+export function formatDem(os) {
+    return `${osToDem(os)} DEM`;
+}
+//# sourceMappingURL=conversion.js.map

package/build/denomination/conversion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversion.js","sourceRoot":"","sources":["../../../src/denomination/conversion.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAElD,+EAA+E;AAC/E,6EAA6E;AAE7E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,OAAO,CAAC,GAAoB;IACxC,MAAM,GAAG,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;IAE1D,kEAAkE;IAClE,MAAM,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAEzC,IAAI,IAAI,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACX,eAAe,GAAG,qBAAqB,WAAW,iBAAiB,CACtE,CAAA;IACL,CAAC;IAED,uEAAuE;IACvE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,CAAA;IAChD,MAAM,QAAQ,GAAG,GAAG,KAAK,GAAG,UAAU,EAAE,CAAA;IAExC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC/B,IAAI,MAAM,GAAG,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAA;IAC3D,CAAC;IACD,OAAO,MAAM,CAAA;AACjB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,OAAO,CAAC,EAAU;IAC9B,MAAM,UAAU,GAAG,EAAE,GAAG,OAAO,CAAA;IAC/B,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAEjC,oEAAoE;IACpE,wDAAwD;IACxD,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,WAAW,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;IAEzD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC,CAAA;IACpD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC,CAAA;IAEhD,yEAAyE;IACzE,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAA;IAElD,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,WAAW,EAAE,CAAA;AAC5D,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC1C,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAA;AAC3B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,EAAU;IACjC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAA;AACxB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,EAAU;IAChC,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC,MAAM,CAAA;AAC/B,CAAC"}

package/build/denomination/conversion.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/denomination/conversion.test.js

@@ -0,0 +1,60 @@
+import { describe, test, expect } from "bun:test";
+import { demToOs, osToDem, parseOsString, toOsString, formatDem, } from "./conversion.js";
+// REVIEW: P0 foundation — verbatim test suite from IDEA.md §0.5 plus three
+// edge-case tests called out in the P0 task brief.
+describe("demToOs", () => {
+    test("converts whole DEM to OS", () => {
+        expect(demToOs(1)).toBe(1000000000n);
+        expect(demToOs(100)).toBe(100000000000n);
+        expect(demToOs(0)).toBe(0n);
+    });
+    test("converts fractional DEM to OS", () => {
+        expect(demToOs("0.5")).toBe(500000000n);
+        expect(demToOs("0.000000001")).toBe(1n);
+        expect(demToOs("1.123456789")).toBe(1123456789n);
+    });
+    test("rejects too many decimals", () => {
+        expect(() => demToOs("0.0000000001")).toThrow("exceeds maximum 9 decimal places");
+    });
+    test("accepts string input", () => {
+        expect(demToOs("100")).toBe(100000000000n);
+    });
+    // Edge case: explicit zero string input.
+    test("converts the string \"0\" to 0n", () => {
+        expect(demToOs("0")).toBe(0n);
+    });
+    // Edge case: negative inputs are rejected with a clear message. The
+    // BigInt of "-1000000000" is < 0n, which trips the negativity guard.
+    test("rejects negative DEM input", () => {
+        expect(() => demToOs(-1)).toThrow("Negative amounts not allowed");
+    });
+});
+describe("osToDem", () => {
+    test("converts OS to DEM string", () => {
+        expect(osToDem(1000000000n)).toBe("1.0");
+        expect(osToDem(500000000n)).toBe("0.5");
+        expect(osToDem(1n)).toBe("0.000000001");
+        expect(osToDem(0n)).toBe("0.0");
+    });
+    test("handles large amounts", () => {
+        expect(osToDem(1000000000000000000n)).toBe("1000000000.0");
+    });
+    // Edge case: negative OS amounts produce a leading "-" and otherwise
+    // follow the same trimming rules as positive amounts.
+    test("handles negative OS amounts", () => {
+        expect(osToDem(-500000000n)).toBe("-0.5");
+    });
+});
+describe("wire format", () => {
+    test("round-trips through string serialization", () => {
+        const original = 123456789012n;
+        const wire = toOsString(original);
+        expect(parseOsString(wire)).toBe(original);
+    });
+});
+describe("formatDem", () => {
+    test("formats with unit", () => {
+        expect(formatDem(1000000000n)).toBe("1.0 DEM");
+    });
+});
+//# sourceMappingURL=conversion.test.js.map

package/build/denomination/conversion.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversion.test.js","sourceRoot":"","sources":["../../../src/denomination/conversion.test.ts"],"names":[],"mappings":"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"}

package/build/denomination/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * DEM/OS denomination utilities.
+ *
+ * Public surface for converting between human-readable DEM amounts and
+ * the internal/wire OS unit. See `./constants` and `./conversion` for details.
+ *
+ * 1 DEM = 10^9 OS.
+ */
+export { OS_DECIMALS, OS_PER_DEM, MIN_AMOUNT_OS, ZERO_OS, } from "./constants";
+export { demToOs, osToDem, parseOsString, toOsString, formatDem, } from "./conversion";

package/build/denomination/index.js

@@ -0,0 +1,12 @@
+/**
+ * DEM/OS denomination utilities.
+ *
+ * Public surface for converting between human-readable DEM amounts and
+ * the internal/wire OS unit. See `./constants` and `./conversion` for details.
+ *
+ * 1 DEM = 10^9 OS.
+ */
+// REVIEW: P0 foundation — barrel export for the new denomination module.
+export { OS_DECIMALS, OS_PER_DEM, MIN_AMOUNT_OS, ZERO_OS, } from "./constants.js";
+export { demToOs, osToDem, parseOsString, toOsString, formatDem, } from "./conversion.js";
+//# sourceMappingURL=index.js.map

package/build/denomination/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/denomination/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,yEAAyE;AAEzE,OAAO,EACH,WAAW,EACX,UAAU,EACV,aAAa,EACb,OAAO,GACV,MAAM,aAAa,CAAA;AAEpB,OAAO,EACH,OAAO,EACP,OAAO,EACP,aAAa,EACb,UAAU,EACV,SAAS,GACZ,MAAM,cAAc,CAAA"}

package/build/index.d.ts

@@ -1,6 +1,7 @@
 export * as types from "./types";
 export * as encryption from "./encryption";
 export * as utils from "./utils";
+export * as denomination from "./denomination";
 export * as xmlocalsdk from "./multichain/localsdk";
 export * as xmwebsdk from "./multichain/websdk";
 export * as xmcore from "./multichain/core";

package/build/index.js

@@ -3,6 +3,9 @@ export * as types from "./types/index.js";
 // Basic cryptographic and data manipulation functions
 export * as encryption from "./encryption/index.js";
 export * as utils from "./utils/index.js";
+// REVIEW: P0 foundation — DEM/OS denomination utilities. Dormant exports;
+// not yet consumed by any other SDK module.
+export * as denomination from "./denomination/index.js";
 //  Specific features of the SDK
 export * as xmlocalsdk from "./multichain/localsdk/index.js";
 export * as xmwebsdk from "./multichain/websdk/index.js";

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,OAAO,KAAK,KAAK,MAAM,SAAS,CAAA;AAChC,sDAAsD;AACtD,OAAO,KAAK,UAAU,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,KAAK,MAAM,SAAS,CAAA;AAEhC,gCAAgC;AAChC,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA;AAC/C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAA,CAAC,gCAAgC;AAE5E,OAAO,KAAK,MAAM,MAAM,UAAU,CAAA;AAClC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAA;AAExC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAA;AAE9B,OAAO,KAAK,MAAM,MAAM,UAAU,CAAA;AAClC,OAAO,KAAK,WAAW,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,IAAI,MAAM,oBAAoB,CAAA;AAE1C,qCAAqC;AACrC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAA;AAElC,OAAO,KAAK,gBAAgB,MAAM,qBAAqB,CAAA;AAEvD,OAAO,KAAK,OAAO,MAAM,WAAW,CAAA;AAEpC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAA;AAElC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAA;AAE9B,OAAO,KAAK,SAAS,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,OAAO,KAAK,KAAK,MAAM,SAAS,CAAA;AAChC,sDAAsD;AACtD,OAAO,KAAK,UAAU,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,KAAK,MAAM,SAAS,CAAA;AAEhC,0EAA0E;AAC1E,4CAA4C;AAC5C,OAAO,KAAK,YAAY,MAAM,gBAAgB,CAAA;AAE9C,gCAAgC;AAChC,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA;AAC/C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAA,CAAC,gCAAgC;AAE5E,OAAO,KAAK,MAAM,MAAM,UAAU,CAAA;AAClC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAA;AAExC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAA;AAE9B,OAAO,KAAK,MAAM,MAAM,UAAU,CAAA;AAClC,OAAO,KAAK,WAAW,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,IAAI,MAAM,oBAAoB,CAAA;AAE1C,qCAAqC;AACrC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAA;AAElC,OAAO,KAAK,gBAAgB,MAAM,qBAAqB,CAAA;AAEvD,OAAO,KAAK,OAAO,MAAM,WAAW,CAAA;AAEpC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAA;AAElC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAA;AAE9B,OAAO,KAAK,SAAS,MAAM,aAAa,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@kynesyslabs/demosdk",
-    "version": "2.11.6",
+    "version": "2.12.0",
     "type": "module",
     "description": "Demosdk is a JavaScript/TypeScript SDK that provides a unified interface for interacting with Demos network",
     "main": "build/index.js",