@algorandfoundation/algokit-utils 9.2.0 → 10.0.0-alpha.10

package/packages/sdk/src/types/transactions/encoded.js

@@ -0,0 +1,64 @@
+const require_utils = require('../../utils/utils.js');
+const require_uint64 = require('../../encoding/schema/uint64.js');
+const require_bytearray = require('../../encoding/schema/bytearray.js');
+const require_array = require('../../encoding/schema/array.js');
+const require_map = require('../../encoding/schema/map.js');
+const require_optional = require('../../encoding/schema/optional.js');
+
+//#region packages/sdk/src/types/transactions/encoded.ts
+const ENCODED_SUBSIG_SCHEMA = new require_map.NamedMapSchema(require_map.allOmitEmpty([{
+	key: "pk",
+	valueSchema: new require_bytearray.FixedLengthByteArraySchema(32)
+}, {
+	key: "s",
+	valueSchema: new require_optional.OptionalSchema(new require_bytearray.FixedLengthByteArraySchema(64))
+}]));
+function encodedSubsigFromEncodingData(data) {
+	if (!(data instanceof Map)) throw new Error(`Invalid decoded EncodedSubsig: ${data}`);
+	const subsig = { pk: data.get("pk") };
+	if (data.get("s")) subsig.s = data.get("s");
+	return subsig;
+}
+function encodedSubsigToEncodingData(subsig) {
+	const data = new Map([["pk", subsig.pk]]);
+	if (subsig.s) data.set("s", subsig.s);
+	return data;
+}
+const ENCODED_MULTISIG_SCHEMA = new require_map.NamedMapSchema(require_map.allOmitEmpty([
+	{
+		key: "v",
+		valueSchema: new require_uint64.Uint64Schema()
+	},
+	{
+		key: "thr",
+		valueSchema: new require_uint64.Uint64Schema()
+	},
+	{
+		key: "subsig",
+		valueSchema: new require_array.ArraySchema(ENCODED_SUBSIG_SCHEMA)
+	}
+]));
+function encodedMultiSigFromEncodingData(data) {
+	if (!(data instanceof Map)) throw new Error(`Invalid decoded EncodedMultiSig: ${data}`);
+	return {
+		v: require_utils.ensureSafeUnsignedInteger(data.get("v")),
+		thr: require_utils.ensureSafeUnsignedInteger(data.get("thr")),
+		subsig: data.get("subsig").map(encodedSubsigFromEncodingData)
+	};
+}
+function encodedMultiSigToEncodingData(msig) {
+	return new Map([
+		["v", msig.v],
+		["thr", msig.thr],
+		["subsig", msig.subsig.map(encodedSubsigToEncodingData)]
+	]);
+}
+
+//#endregion
+exports.ENCODED_MULTISIG_SCHEMA = ENCODED_MULTISIG_SCHEMA;
+exports.ENCODED_SUBSIG_SCHEMA = ENCODED_SUBSIG_SCHEMA;
+exports.encodedMultiSigFromEncodingData = encodedMultiSigFromEncodingData;
+exports.encodedMultiSigToEncodingData = encodedMultiSigToEncodingData;
+exports.encodedSubsigFromEncodingData = encodedSubsigFromEncodingData;
+exports.encodedSubsigToEncodingData = encodedSubsigToEncodingData;
+//# sourceMappingURL=encoded.js.map

package/packages/sdk/src/types/transactions/encoded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoded.js","names":["NamedMapSchema","allOmitEmpty","FixedLengthByteArraySchema","OptionalSchema","subsig: EncodedSubsig","Uint64Schema","ArraySchema","ensureSafeUnsignedInteger"],"sources":["../../../../../../packages/sdk/src/types/transactions/encoded.ts"],"sourcesContent":["import {\n  NamedMapSchema,\n  FixedLengthByteArraySchema,\n  Uint64Schema,\n  ArraySchema,\n  OptionalSchema,\n  allOmitEmpty,\n} from '../../encoding/schema/index.js'\nimport { ensureSafeUnsignedInteger } from '../../utils/utils.js'\n\nexport interface EncodedSubsig {\n  /**\n   *  The public key\n   */\n  pk: Uint8Array\n\n  /**\n   * The signature provided by the public key, if any\n   */\n  s?: Uint8Array\n}\n\nexport const ENCODED_SUBSIG_SCHEMA = new NamedMapSchema(\n  allOmitEmpty([\n    {\n      key: 'pk',\n      valueSchema: new FixedLengthByteArraySchema(32),\n    },\n    {\n      key: 's',\n      valueSchema: new OptionalSchema(new FixedLengthByteArraySchema(64)),\n    },\n  ]),\n)\n\nexport function encodedSubsigFromEncodingData(data: unknown): EncodedSubsig {\n  if (!(data instanceof Map)) {\n    throw new Error(`Invalid decoded EncodedSubsig: ${data}`)\n  }\n  const subsig: EncodedSubsig = {\n    pk: data.get('pk'),\n  }\n  if (data.get('s')) {\n    subsig.s = data.get('s')\n  }\n  return subsig\n}\n\nexport function encodedSubsigToEncodingData(subsig: EncodedSubsig): Map<string, unknown> {\n  const data = new Map<string, unknown>([['pk', subsig.pk]])\n  if (subsig.s) {\n    data.set('s', subsig.s)\n  }\n  return data\n}\n\n/**\n * A rough structure for the encoded multi signature transaction object.\n * Every property is labelled with its associated `MultisigMetadata` type property\n */\nexport interface EncodedMultisig {\n  /**\n   * version\n   */\n  v: number\n\n  /**\n   * threshold\n   */\n  thr: number\n\n  /**\n   * Subset of signatures. A threshold of `thr` signors is required.\n   */\n  subsig: EncodedSubsig[]\n}\n\nexport const ENCODED_MULTISIG_SCHEMA = new NamedMapSchema(\n  allOmitEmpty([\n    {\n      key: 'v',\n      valueSchema: new Uint64Schema(),\n    },\n    {\n      key: 'thr',\n      valueSchema: new Uint64Schema(),\n    },\n    {\n      key: 'subsig',\n      valueSchema: new ArraySchema(ENCODED_SUBSIG_SCHEMA),\n    },\n  ]),\n)\n\nexport function encodedMultiSigFromEncodingData(data: unknown): EncodedMultisig {\n  if (!(data instanceof Map)) {\n    throw new Error(`Invalid decoded EncodedMultiSig: ${data}`)\n  }\n  return {\n    v: ensureSafeUnsignedInteger(data.get('v')),\n    thr: ensureSafeUnsignedInteger(data.get('thr')),\n    subsig: data.get('subsig').map(encodedSubsigFromEncodingData),\n  }\n}\n\nexport function encodedMultiSigToEncodingData(msig: EncodedMultisig): Map<string, unknown> {\n  return new Map<string, unknown>([\n    ['v', msig.v],\n    ['thr', msig.thr],\n    ['subsig', msig.subsig.map(encodedSubsigToEncodingData)],\n  ])\n}\n"],"mappings":";;;;;;;;AAsBA,MAAa,wBAAwB,IAAIA,2BACvCC,yBAAa,CACX;CACE,KAAK;CACL,aAAa,IAAIC,6CAA2B,GAAG;CAChD,EACD;CACE,KAAK;CACL,aAAa,IAAIC,gCAAe,IAAID,6CAA2B,GAAG,CAAC;CACpE,CACF,CAAC,CACH;AAED,SAAgB,8BAA8B,MAA8B;AAC1E,KAAI,EAAE,gBAAgB,KACpB,OAAM,IAAI,MAAM,kCAAkC,OAAO;CAE3D,MAAME,SAAwB,EAC5B,IAAI,KAAK,IAAI,KAAK,EACnB;AACD,KAAI,KAAK,IAAI,IAAI,CACf,QAAO,IAAI,KAAK,IAAI,IAAI;AAE1B,QAAO;;AAGT,SAAgB,4BAA4B,QAA6C;CACvF,MAAM,OAAO,IAAI,IAAqB,CAAC,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC;AAC1D,KAAI,OAAO,EACT,MAAK,IAAI,KAAK,OAAO,EAAE;AAEzB,QAAO;;AAwBT,MAAa,0BAA0B,IAAIJ,2BACzCC,yBAAa;CACX;EACE,KAAK;EACL,aAAa,IAAII,6BAAc;EAChC;CACD;EACE,KAAK;EACL,aAAa,IAAIA,6BAAc;EAChC;CACD;EACE,KAAK;EACL,aAAa,IAAIC,0BAAY,sBAAsB;EACpD;CACF,CAAC,CACH;AAED,SAAgB,gCAAgC,MAAgC;AAC9E,KAAI,EAAE,gBAAgB,KACpB,OAAM,IAAI,MAAM,oCAAoC,OAAO;AAE7D,QAAO;EACL,GAAGC,wCAA0B,KAAK,IAAI,IAAI,CAAC;EAC3C,KAAKA,wCAA0B,KAAK,IAAI,MAAM,CAAC;EAC/C,QAAQ,KAAK,IAAI,SAAS,CAAC,IAAI,8BAA8B;EAC9D;;AAGH,SAAgB,8BAA8B,MAA6C;AACzF,QAAO,IAAI,IAAqB;EAC9B,CAAC,KAAK,KAAK,EAAE;EACb,CAAC,OAAO,KAAK,IAAI;EACjB,CAAC,UAAU,KAAK,OAAO,IAAI,4BAA4B,CAAC;EACzD,CAAC"}

package/packages/sdk/src/types/transactions/encoded.mjs

@@ -0,0 +1,59 @@
+import { ensureSafeUnsignedInteger } from "../../utils/utils.mjs";
+import { Uint64Schema } from "../../encoding/schema/uint64.mjs";
+import { FixedLengthByteArraySchema } from "../../encoding/schema/bytearray.mjs";
+import { ArraySchema } from "../../encoding/schema/array.mjs";
+import { NamedMapSchema, allOmitEmpty } from "../../encoding/schema/map.mjs";
+import { OptionalSchema } from "../../encoding/schema/optional.mjs";
+
+//#region packages/sdk/src/types/transactions/encoded.ts
+const ENCODED_SUBSIG_SCHEMA = new NamedMapSchema(allOmitEmpty([{
+	key: "pk",
+	valueSchema: new FixedLengthByteArraySchema(32)
+}, {
+	key: "s",
+	valueSchema: new OptionalSchema(new FixedLengthByteArraySchema(64))
+}]));
+function encodedSubsigFromEncodingData(data) {
+	if (!(data instanceof Map)) throw new Error(`Invalid decoded EncodedSubsig: ${data}`);
+	const subsig = { pk: data.get("pk") };
+	if (data.get("s")) subsig.s = data.get("s");
+	return subsig;
+}
+function encodedSubsigToEncodingData(subsig) {
+	const data = new Map([["pk", subsig.pk]]);
+	if (subsig.s) data.set("s", subsig.s);
+	return data;
+}
+const ENCODED_MULTISIG_SCHEMA = new NamedMapSchema(allOmitEmpty([
+	{
+		key: "v",
+		valueSchema: new Uint64Schema()
+	},
+	{
+		key: "thr",
+		valueSchema: new Uint64Schema()
+	},
+	{
+		key: "subsig",
+		valueSchema: new ArraySchema(ENCODED_SUBSIG_SCHEMA)
+	}
+]));
+function encodedMultiSigFromEncodingData(data) {
+	if (!(data instanceof Map)) throw new Error(`Invalid decoded EncodedMultiSig: ${data}`);
+	return {
+		v: ensureSafeUnsignedInteger(data.get("v")),
+		thr: ensureSafeUnsignedInteger(data.get("thr")),
+		subsig: data.get("subsig").map(encodedSubsigFromEncodingData)
+	};
+}
+function encodedMultiSigToEncodingData(msig) {
+	return new Map([
+		["v", msig.v],
+		["thr", msig.thr],
+		["subsig", msig.subsig.map(encodedSubsigToEncodingData)]
+	]);
+}
+
+//#endregion
+export { ENCODED_MULTISIG_SCHEMA, ENCODED_SUBSIG_SCHEMA, encodedMultiSigFromEncodingData, encodedMultiSigToEncodingData, encodedSubsigFromEncodingData, encodedSubsigToEncodingData };
+//# sourceMappingURL=encoded.mjs.map

package/packages/sdk/src/types/transactions/encoded.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoded.mjs","names":["subsig: EncodedSubsig"],"sources":["../../../../../../packages/sdk/src/types/transactions/encoded.ts"],"sourcesContent":["import {\n  NamedMapSchema,\n  FixedLengthByteArraySchema,\n  Uint64Schema,\n  ArraySchema,\n  OptionalSchema,\n  allOmitEmpty,\n} from '../../encoding/schema/index.js'\nimport { ensureSafeUnsignedInteger } from '../../utils/utils.js'\n\nexport interface EncodedSubsig {\n  /**\n   *  The public key\n   */\n  pk: Uint8Array\n\n  /**\n   * The signature provided by the public key, if any\n   */\n  s?: Uint8Array\n}\n\nexport const ENCODED_SUBSIG_SCHEMA = new NamedMapSchema(\n  allOmitEmpty([\n    {\n      key: 'pk',\n      valueSchema: new FixedLengthByteArraySchema(32),\n    },\n    {\n      key: 's',\n      valueSchema: new OptionalSchema(new FixedLengthByteArraySchema(64)),\n    },\n  ]),\n)\n\nexport function encodedSubsigFromEncodingData(data: unknown): EncodedSubsig {\n  if (!(data instanceof Map)) {\n    throw new Error(`Invalid decoded EncodedSubsig: ${data}`)\n  }\n  const subsig: EncodedSubsig = {\n    pk: data.get('pk'),\n  }\n  if (data.get('s')) {\n    subsig.s = data.get('s')\n  }\n  return subsig\n}\n\nexport function encodedSubsigToEncodingData(subsig: EncodedSubsig): Map<string, unknown> {\n  const data = new Map<string, unknown>([['pk', subsig.pk]])\n  if (subsig.s) {\n    data.set('s', subsig.s)\n  }\n  return data\n}\n\n/**\n * A rough structure for the encoded multi signature transaction object.\n * Every property is labelled with its associated `MultisigMetadata` type property\n */\nexport interface EncodedMultisig {\n  /**\n   * version\n   */\n  v: number\n\n  /**\n   * threshold\n   */\n  thr: number\n\n  /**\n   * Subset of signatures. A threshold of `thr` signors is required.\n   */\n  subsig: EncodedSubsig[]\n}\n\nexport const ENCODED_MULTISIG_SCHEMA = new NamedMapSchema(\n  allOmitEmpty([\n    {\n      key: 'v',\n      valueSchema: new Uint64Schema(),\n    },\n    {\n      key: 'thr',\n      valueSchema: new Uint64Schema(),\n    },\n    {\n      key: 'subsig',\n      valueSchema: new ArraySchema(ENCODED_SUBSIG_SCHEMA),\n    },\n  ]),\n)\n\nexport function encodedMultiSigFromEncodingData(data: unknown): EncodedMultisig {\n  if (!(data instanceof Map)) {\n    throw new Error(`Invalid decoded EncodedMultiSig: ${data}`)\n  }\n  return {\n    v: ensureSafeUnsignedInteger(data.get('v')),\n    thr: ensureSafeUnsignedInteger(data.get('thr')),\n    subsig: data.get('subsig').map(encodedSubsigFromEncodingData),\n  }\n}\n\nexport function encodedMultiSigToEncodingData(msig: EncodedMultisig): Map<string, unknown> {\n  return new Map<string, unknown>([\n    ['v', msig.v],\n    ['thr', msig.thr],\n    ['subsig', msig.subsig.map(encodedSubsigToEncodingData)],\n  ])\n}\n"],"mappings":";;;;;;;;AAsBA,MAAa,wBAAwB,IAAI,eACvC,aAAa,CACX;CACE,KAAK;CACL,aAAa,IAAI,2BAA2B,GAAG;CAChD,EACD;CACE,KAAK;CACL,aAAa,IAAI,eAAe,IAAI,2BAA2B,GAAG,CAAC;CACpE,CACF,CAAC,CACH;AAED,SAAgB,8BAA8B,MAA8B;AAC1E,KAAI,EAAE,gBAAgB,KACpB,OAAM,IAAI,MAAM,kCAAkC,OAAO;CAE3D,MAAMA,SAAwB,EAC5B,IAAI,KAAK,IAAI,KAAK,EACnB;AACD,KAAI,KAAK,IAAI,IAAI,CACf,QAAO,IAAI,KAAK,IAAI,IAAI;AAE1B,QAAO;;AAGT,SAAgB,4BAA4B,QAA6C;CACvF,MAAM,OAAO,IAAI,IAAqB,CAAC,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC;AAC1D,KAAI,OAAO,EACT,MAAK,IAAI,KAAK,OAAO,EAAE;AAEzB,QAAO;;AAwBT,MAAa,0BAA0B,IAAI,eACzC,aAAa;CACX;EACE,KAAK;EACL,aAAa,IAAI,cAAc;EAChC;CACD;EACE,KAAK;EACL,aAAa,IAAI,cAAc;EAChC;CACD;EACE,KAAK;EACL,aAAa,IAAI,YAAY,sBAAsB;EACpD;CACF,CAAC,CACH;AAED,SAAgB,gCAAgC,MAAgC;AAC9E,KAAI,EAAE,gBAAgB,KACpB,OAAM,IAAI,MAAM,oCAAoC,OAAO;AAE7D,QAAO;EACL,GAAG,0BAA0B,KAAK,IAAI,IAAI,CAAC;EAC3C,KAAK,0BAA0B,KAAK,IAAI,MAAM,CAAC;EAC/C,QAAQ,KAAK,IAAI,SAAS,CAAC,IAAI,8BAA8B;EAC9D;;AAGH,SAAgB,8BAA8B,MAA6C;AACzF,QAAO,IAAI,IAAqB;EAC9B,CAAC,KAAK,KAAK,EAAE;EACb,CAAC,OAAO,KAAK,IAAI;EACjB,CAAC,UAAU,KAAK,OAAO,IAAI,4BAA4B,CAAC;EACzD,CAAC"}

package/packages/sdk/src/utils/utils.d.ts

@@ -0,0 +1,64 @@
+import { IntDecoding } from "../types/intDecoding.js";
+
+//#region packages/sdk/src/utils/utils.d.ts
+interface ParseJSONOptions {
+  intDecoding: IntDecoding;
+}
+/**
+ * Parse JSON with additional options.
+ * @param str - The JSON string to parse.
+ * @param options - Configures how integers in this JSON string will be decoded. See the
+ *   `IntDecoding` enum for more details.
+ */
+declare function parseJSON(str: string, {
+  intDecoding
+}: ParseJSONOptions): any;
+/**
+ * Converts a JavaScript value to a JavaScript Object Notation (JSON) string.
+ *
+ * This functions differs from the built-in JSON.stringify in that it supports serializing BigInts.
+ *
+ * This function takes the same arguments as the built-in JSON.stringify function.
+ *
+ * @param value - A JavaScript value, usually an object or array, to be converted.
+ * @param replacer - A function that transforms the results.
+ * @param space - Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.
+ */
+declare function stringifyJSON(value: any, replacer?: (this: any, key: string, value: any) => any, space?: string | number): string;
+/**
+ * ArrayEqual takes two arrays and return true if equal, false otherwise
+ */
+declare function arrayEqual<T>(a: ArrayLike<T>, b: ArrayLike<T>): boolean;
+/**
+ * ConcatArrays takes n number arrays and returns a joint Uint8Array
+ * @param arrs - An arbitrary number of n array-like number list arguments
+ * @returns [a,b]
+ */
+declare function concatArrays(...arrs: ArrayLike<number>[]): Uint8Array;
+/**
+ * Remove undefined properties from an object
+ * @param obj - An object, preferably one with some undefined properties
+ * @returns A copy of the object with undefined properties removed
+ */
+declare function removeUndefinedProperties(obj: Record<string | number | symbol, any>): {
+  [x: string]: any;
+  [x: number]: any;
+  [x: symbol]: any;
+};
+/**
+ * Check whether the environment is Node.js (as opposed to the browser)
+ * @returns True if Node.js environment, false otherwise
+ */
+declare function isNode(): boolean;
+/**
+ * Check whether the environment is ReactNative
+ * @returns True if ReactNative, false otherwise
+ */
+declare function isReactNative(): boolean;
+declare function ensureSafeInteger(value: unknown): number;
+declare function ensureSafeUnsignedInteger(value: unknown): number;
+declare function ensureBigInt(value: unknown): bigint;
+declare function ensureUint64(value: unknown): bigint;
+//#endregion
+export { ParseJSONOptions, arrayEqual, concatArrays, ensureBigInt, ensureSafeInteger, ensureSafeUnsignedInteger, ensureUint64, isNode, isReactNative, parseJSON, removeUndefinedProperties, stringifyJSON };
+//# sourceMappingURL=utils.d.ts.map

package/packages/sdk/src/utils/utils.js

@@ -0,0 +1,140 @@
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.js');
+const require_intDecoding = require('../types/intDecoding.js');
+let json_bigint = require("json-bigint");
+json_bigint = require_rolldown_runtime.__toESM(json_bigint);
+
+//#region packages/sdk/src/utils/utils.ts
+const JSONbig = (0, json_bigint.default)({
+	useNativeBigInt: true,
+	strict: true
+});
+/**
+* Parse JSON with additional options.
+* @param str - The JSON string to parse.
+* @param options - Configures how integers in this JSON string will be decoded. See the
+*   `IntDecoding` enum for more details.
+*/
+function parseJSON(str, { intDecoding }) {
+	if (intDecoding !== require_intDecoding.default.SAFE && intDecoding !== require_intDecoding.default.UNSAFE && intDecoding !== require_intDecoding.default.BIGINT && intDecoding !== require_intDecoding.default.MIXED) throw new Error(`Invalid intDecoding option: ${intDecoding}`);
+	return JSONbig.parse(str, (_, value) => {
+		if (value != null && typeof value === "object" && Object.getPrototypeOf(value) == null) Object.setPrototypeOf(value, Object.prototype);
+		if (typeof value === "bigint") {
+			if (intDecoding === require_intDecoding.default.SAFE && value > Number.MAX_SAFE_INTEGER) throw new Error(`Integer exceeds maximum safe integer: ${value.toString()}. Try parsing with a different intDecoding option.`);
+			if (intDecoding === require_intDecoding.default.BIGINT || intDecoding === require_intDecoding.default.MIXED && value > Number.MAX_SAFE_INTEGER) return value;
+			return Number(value);
+		}
+		if (typeof value === "number") {
+			if (intDecoding === require_intDecoding.default.BIGINT && Number.isInteger(value)) return BigInt(value);
+		}
+		return value;
+	});
+}
+/**
+* Converts a JavaScript value to a JavaScript Object Notation (JSON) string.
+*
+* This functions differs from the built-in JSON.stringify in that it supports serializing BigInts.
+*
+* This function takes the same arguments as the built-in JSON.stringify function.
+*
+* @param value - A JavaScript value, usually an object or array, to be converted.
+* @param replacer - A function that transforms the results.
+* @param space - Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.
+*/
+function stringifyJSON(value, replacer, space) {
+	return JSONbig.stringify(value, replacer, space);
+}
+/**
+* ArrayEqual takes two arrays and return true if equal, false otherwise
+*/
+function arrayEqual(a, b) {
+	if (a.length !== b.length) return false;
+	return Array.from(a).every((val, i) => val === b[i]);
+}
+/**
+* ConcatArrays takes n number arrays and returns a joint Uint8Array
+* @param arrs - An arbitrary number of n array-like number list arguments
+* @returns [a,b]
+*/
+function concatArrays(...arrs) {
+	const size = arrs.reduce((sum, arr) => sum + arr.length, 0);
+	const c = new Uint8Array(size);
+	let offset = 0;
+	for (let i = 0; i < arrs.length; i++) {
+		c.set(arrs[i], offset);
+		offset += arrs[i].length;
+	}
+	return c;
+}
+/**
+* Remove undefined properties from an object
+* @param obj - An object, preferably one with some undefined properties
+* @returns A copy of the object with undefined properties removed
+*/
+function removeUndefinedProperties(obj) {
+	const mutableCopy = { ...obj };
+	Object.keys(mutableCopy).forEach((key) => {
+		if (typeof mutableCopy[key] === "undefined") delete mutableCopy[key];
+	});
+	return mutableCopy;
+}
+/**
+* Check whether the environment is Node.js (as opposed to the browser)
+* @returns True if Node.js environment, false otherwise
+*/
+function isNode() {
+	return typeof process === "object" && typeof process.versions === "object" && typeof process.versions.node !== "undefined";
+}
+/**
+* Check whether the environment is ReactNative
+* @returns True if ReactNative, false otherwise
+*/
+function isReactNative() {
+	const { navigator } = globalThis;
+	if (typeof navigator === "object" && navigator.product === "ReactNative") return true;
+	return false;
+}
+function ensureSafeInteger(value) {
+	if (typeof value === "undefined") throw new Error("Value is undefined");
+	if (typeof value === "bigint") {
+		if (value > BigInt(Number.MAX_SAFE_INTEGER) || value < BigInt(Number.MIN_SAFE_INTEGER)) throw new Error(`BigInt value ${value} is not a safe integer`);
+		return Number(value);
+	}
+	if (typeof value === "number") {
+		if (Number.isSafeInteger(value)) return value;
+		throw new Error(`Value ${value} is not a safe integer`);
+	}
+	throw new Error(`Unexpected type ${typeof value}, ${value}`);
+}
+function ensureSafeUnsignedInteger(value) {
+	const intValue = ensureSafeInteger(value);
+	if (intValue < 0) throw new Error(`Value ${intValue} is negative`);
+	return intValue;
+}
+function ensureBigInt(value) {
+	if (typeof value === "undefined") throw new Error("Value is undefined");
+	if (typeof value === "bigint") return value;
+	if (typeof value === "number") {
+		if (!Number.isSafeInteger(value)) throw new Error(`Value ${value} is not a safe integer`);
+		return BigInt(value);
+	}
+	throw new Error(`Unexpected type ${typeof value}, ${value}`);
+}
+function ensureUint64(value) {
+	const bigIntValue = ensureBigInt(value);
+	if (bigIntValue < 0 || bigIntValue > BigInt("0xffffffffffffffff")) throw new Error(`Value ${bigIntValue} is not a uint64`);
+	return bigIntValue;
+}
+
+//#endregion
+exports.arrayEqual = arrayEqual;
+exports.concatArrays = concatArrays;
+exports.ensureBigInt = ensureBigInt;
+exports.ensureSafeInteger = ensureSafeInteger;
+exports.ensureSafeUnsignedInteger = ensureSafeUnsignedInteger;
+exports.ensureUint64 = ensureUint64;
+exports.isNode = isNode;
+exports.isReactNative = isReactNative;
+exports.parseJSON = parseJSON;
+exports.removeUndefinedProperties = removeUndefinedProperties;
+exports.stringifyJSON = stringifyJSON;
+//# sourceMappingURL=utils.js.map

package/packages/sdk/src/utils/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":["IntDecoding"],"sources":["../../../../../packages/sdk/src/utils/utils.ts"],"sourcesContent":["import JSONbigWithoutConfig from 'json-bigint'\nimport IntDecoding from '../types/intDecoding.js'\n\nconst JSONbig = JSONbigWithoutConfig({\n  useNativeBigInt: true,\n  strict: true,\n})\n\nexport interface ParseJSONOptions {\n  intDecoding: IntDecoding\n}\n\n/**\n * Parse JSON with additional options.\n * @param str - The JSON string to parse.\n * @param options - Configures how integers in this JSON string will be decoded. See the\n *   `IntDecoding` enum for more details.\n */\nexport function parseJSON(str: string, { intDecoding }: ParseJSONOptions) {\n  if (\n    intDecoding !== IntDecoding.SAFE &&\n    intDecoding !== IntDecoding.UNSAFE &&\n    intDecoding !== IntDecoding.BIGINT &&\n    intDecoding !== IntDecoding.MIXED\n  ) {\n    throw new Error(`Invalid intDecoding option: ${intDecoding}`)\n  }\n  return JSONbig.parse(str, (_: string, value: any): any => {\n    if (value != null && typeof value === 'object' && Object.getPrototypeOf(value) == null) {\n      // JSONbig.parse objects are created with Object.create(null) and thus have a null prototype\n      // let us remedy that\n      Object.setPrototypeOf(value, Object.prototype)\n    }\n\n    if (typeof value === 'bigint') {\n      if (intDecoding === IntDecoding.SAFE && value > Number.MAX_SAFE_INTEGER) {\n        throw new Error(`Integer exceeds maximum safe integer: ${value.toString()}. Try parsing with a different intDecoding option.`)\n      }\n      if (intDecoding === IntDecoding.BIGINT || (intDecoding === IntDecoding.MIXED && value > Number.MAX_SAFE_INTEGER)) {\n        return value\n      }\n      // JSONbig.parse converts number to BigInts if they are >= 10**15. This is smaller than\n      // Number.MAX_SAFE_INTEGER, so we can convert some BigInts back to normal numbers.\n      return Number(value)\n    }\n\n    if (typeof value === 'number') {\n      if (intDecoding === IntDecoding.BIGINT && Number.isInteger(value)) {\n        return BigInt(value)\n      }\n    }\n\n    return value\n  })\n}\n\n/**\n * Converts a JavaScript value to a JavaScript Object Notation (JSON) string.\n *\n * This functions differs from the built-in JSON.stringify in that it supports serializing BigInts.\n *\n * This function takes the same arguments as the built-in JSON.stringify function.\n *\n * @param value - A JavaScript value, usually an object or array, to be converted.\n * @param replacer - A function that transforms the results.\n * @param space - Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.\n */\nexport function stringifyJSON(value: any, replacer?: (this: any, key: string, value: any) => any, space?: string | number): string {\n  return JSONbig.stringify(value, replacer, space)\n}\n\n/**\n * ArrayEqual takes two arrays and return true if equal, false otherwise\n */\nexport function arrayEqual<T>(a: ArrayLike<T>, b: ArrayLike<T>): boolean {\n  if (a.length !== b.length) {\n    return false\n  }\n  return Array.from(a).every((val, i) => val === b[i])\n}\n\n/**\n * ConcatArrays takes n number arrays and returns a joint Uint8Array\n * @param arrs - An arbitrary number of n array-like number list arguments\n * @returns [a,b]\n */\nexport function concatArrays(...arrs: ArrayLike<number>[]) {\n  const size = arrs.reduce((sum, arr) => sum + arr.length, 0)\n  const c = new Uint8Array(size)\n\n  let offset = 0\n  for (let i = 0; i < arrs.length; i++) {\n    c.set(arrs[i], offset)\n    offset += arrs[i].length\n  }\n\n  return c\n}\n\n/**\n * Remove undefined properties from an object\n * @param obj - An object, preferably one with some undefined properties\n * @returns A copy of the object with undefined properties removed\n */\nexport function removeUndefinedProperties(obj: Record<string | number | symbol, any>) {\n  const mutableCopy = { ...obj }\n  Object.keys(mutableCopy).forEach((key) => {\n    if (typeof mutableCopy[key] === 'undefined') delete mutableCopy[key]\n  })\n  return mutableCopy\n}\n\n/**\n * Check whether the environment is Node.js (as opposed to the browser)\n * @returns True if Node.js environment, false otherwise\n */\nexport function isNode() {\n  return (\n    // @ts-ignore\n    typeof process === 'object' &&\n    // @ts-ignore\n    typeof process.versions === 'object' &&\n    // @ts-ignore\n    typeof process.versions.node !== 'undefined'\n  )\n}\n\n/**\n * Check whether the environment is ReactNative\n * @returns True if ReactNative, false otherwise\n */\nexport function isReactNative() {\n  const { navigator } = globalThis as { navigator?: { product?: string } }\n  if (typeof navigator === 'object' && navigator.product === 'ReactNative') {\n    return true\n  }\n  return false\n}\n\nexport function ensureSafeInteger(value: unknown): number {\n  if (typeof value === 'undefined') {\n    throw new Error('Value is undefined')\n  }\n  if (typeof value === 'bigint') {\n    if (value > BigInt(Number.MAX_SAFE_INTEGER) || value < BigInt(Number.MIN_SAFE_INTEGER)) {\n      throw new Error(`BigInt value ${value} is not a safe integer`)\n    }\n    return Number(value)\n  }\n  if (typeof value === 'number') {\n    if (Number.isSafeInteger(value)) {\n      return value\n    }\n    throw new Error(`Value ${value} is not a safe integer`)\n  }\n  throw new Error(`Unexpected type ${typeof value}, ${value}`)\n}\n\nexport function ensureSafeUnsignedInteger(value: unknown): number {\n  const intValue = ensureSafeInteger(value)\n  if (intValue < 0) {\n    throw new Error(`Value ${intValue} is negative`)\n  }\n  return intValue\n}\n\nexport function ensureBigInt(value: unknown): bigint {\n  if (typeof value === 'undefined') {\n    throw new Error('Value is undefined')\n  }\n  if (typeof value === 'bigint') {\n    return value\n  }\n  if (typeof value === 'number') {\n    if (!Number.isSafeInteger(value)) {\n      throw new Error(`Value ${value} is not a safe integer`)\n    }\n    return BigInt(value)\n  }\n  throw new Error(`Unexpected type ${typeof value}, ${value}`)\n}\n\nexport function ensureUint64(value: unknown): bigint {\n  const bigIntValue = ensureBigInt(value)\n  if (bigIntValue < 0 || bigIntValue > BigInt('0xffffffffffffffff')) {\n    throw new Error(`Value ${bigIntValue} is not a uint64`)\n  }\n  return bigIntValue\n}\n"],"mappings":"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"}

package/packages/sdk/src/utils/utils.mjs

@@ -0,0 +1,128 @@
+import intDecoding_default from "../types/intDecoding.mjs";
+import JSONbigFactory from "json-bigint";
+
+//#region packages/sdk/src/utils/utils.ts
+const JSONbig = JSONbigFactory({
+	useNativeBigInt: true,
+	strict: true
+});
+/**
+* Parse JSON with additional options.
+* @param str - The JSON string to parse.
+* @param options - Configures how integers in this JSON string will be decoded. See the
+*   `IntDecoding` enum for more details.
+*/
+function parseJSON(str, { intDecoding }) {
+	if (intDecoding !== intDecoding_default.SAFE && intDecoding !== intDecoding_default.UNSAFE && intDecoding !== intDecoding_default.BIGINT && intDecoding !== intDecoding_default.MIXED) throw new Error(`Invalid intDecoding option: ${intDecoding}`);
+	return JSONbig.parse(str, (_, value) => {
+		if (value != null && typeof value === "object" && Object.getPrototypeOf(value) == null) Object.setPrototypeOf(value, Object.prototype);
+		if (typeof value === "bigint") {
+			if (intDecoding === intDecoding_default.SAFE && value > Number.MAX_SAFE_INTEGER) throw new Error(`Integer exceeds maximum safe integer: ${value.toString()}. Try parsing with a different intDecoding option.`);
+			if (intDecoding === intDecoding_default.BIGINT || intDecoding === intDecoding_default.MIXED && value > Number.MAX_SAFE_INTEGER) return value;
+			return Number(value);
+		}
+		if (typeof value === "number") {
+			if (intDecoding === intDecoding_default.BIGINT && Number.isInteger(value)) return BigInt(value);
+		}
+		return value;
+	});
+}
+/**
+* Converts a JavaScript value to a JavaScript Object Notation (JSON) string.
+*
+* This functions differs from the built-in JSON.stringify in that it supports serializing BigInts.
+*
+* This function takes the same arguments as the built-in JSON.stringify function.
+*
+* @param value - A JavaScript value, usually an object or array, to be converted.
+* @param replacer - A function that transforms the results.
+* @param space - Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.
+*/
+function stringifyJSON(value, replacer, space) {
+	return JSONbig.stringify(value, replacer, space);
+}
+/**
+* ArrayEqual takes two arrays and return true if equal, false otherwise
+*/
+function arrayEqual(a, b) {
+	if (a.length !== b.length) return false;
+	return Array.from(a).every((val, i) => val === b[i]);
+}
+/**
+* ConcatArrays takes n number arrays and returns a joint Uint8Array
+* @param arrs - An arbitrary number of n array-like number list arguments
+* @returns [a,b]
+*/
+function concatArrays(...arrs) {
+	const size = arrs.reduce((sum, arr) => sum + arr.length, 0);
+	const c = new Uint8Array(size);
+	let offset = 0;
+	for (let i = 0; i < arrs.length; i++) {
+		c.set(arrs[i], offset);
+		offset += arrs[i].length;
+	}
+	return c;
+}
+/**
+* Remove undefined properties from an object
+* @param obj - An object, preferably one with some undefined properties
+* @returns A copy of the object with undefined properties removed
+*/
+function removeUndefinedProperties(obj) {
+	const mutableCopy = { ...obj };
+	Object.keys(mutableCopy).forEach((key) => {
+		if (typeof mutableCopy[key] === "undefined") delete mutableCopy[key];
+	});
+	return mutableCopy;
+}
+/**
+* Check whether the environment is Node.js (as opposed to the browser)
+* @returns True if Node.js environment, false otherwise
+*/
+function isNode() {
+	return typeof process === "object" && typeof process.versions === "object" && typeof process.versions.node !== "undefined";
+}
+/**
+* Check whether the environment is ReactNative
+* @returns True if ReactNative, false otherwise
+*/
+function isReactNative() {
+	const { navigator } = globalThis;
+	if (typeof navigator === "object" && navigator.product === "ReactNative") return true;
+	return false;
+}
+function ensureSafeInteger(value) {
+	if (typeof value === "undefined") throw new Error("Value is undefined");
+	if (typeof value === "bigint") {
+		if (value > BigInt(Number.MAX_SAFE_INTEGER) || value < BigInt(Number.MIN_SAFE_INTEGER)) throw new Error(`BigInt value ${value} is not a safe integer`);
+		return Number(value);
+	}
+	if (typeof value === "number") {
+		if (Number.isSafeInteger(value)) return value;
+		throw new Error(`Value ${value} is not a safe integer`);
+	}
+	throw new Error(`Unexpected type ${typeof value}, ${value}`);
+}
+function ensureSafeUnsignedInteger(value) {
+	const intValue = ensureSafeInteger(value);
+	if (intValue < 0) throw new Error(`Value ${intValue} is negative`);
+	return intValue;
+}
+function ensureBigInt(value) {
+	if (typeof value === "undefined") throw new Error("Value is undefined");
+	if (typeof value === "bigint") return value;
+	if (typeof value === "number") {
+		if (!Number.isSafeInteger(value)) throw new Error(`Value ${value} is not a safe integer`);
+		return BigInt(value);
+	}
+	throw new Error(`Unexpected type ${typeof value}, ${value}`);
+}
+function ensureUint64(value) {
+	const bigIntValue = ensureBigInt(value);
+	if (bigIntValue < 0 || bigIntValue > BigInt("0xffffffffffffffff")) throw new Error(`Value ${bigIntValue} is not a uint64`);
+	return bigIntValue;
+}
+
+//#endregion
+export { arrayEqual, concatArrays, ensureBigInt, ensureSafeInteger, ensureSafeUnsignedInteger, ensureUint64, isNode, isReactNative, parseJSON, removeUndefinedProperties, stringifyJSON };
+//# sourceMappingURL=utils.mjs.map

package/packages/sdk/src/utils/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.mjs","names":["JSONbigWithoutConfig","IntDecoding"],"sources":["../../../../../packages/sdk/src/utils/utils.ts"],"sourcesContent":["import JSONbigWithoutConfig from 'json-bigint'\nimport IntDecoding from '../types/intDecoding.js'\n\nconst JSONbig = JSONbigWithoutConfig({\n  useNativeBigInt: true,\n  strict: true,\n})\n\nexport interface ParseJSONOptions {\n  intDecoding: IntDecoding\n}\n\n/**\n * Parse JSON with additional options.\n * @param str - The JSON string to parse.\n * @param options - Configures how integers in this JSON string will be decoded. See the\n *   `IntDecoding` enum for more details.\n */\nexport function parseJSON(str: string, { intDecoding }: ParseJSONOptions) {\n  if (\n    intDecoding !== IntDecoding.SAFE &&\n    intDecoding !== IntDecoding.UNSAFE &&\n    intDecoding !== IntDecoding.BIGINT &&\n    intDecoding !== IntDecoding.MIXED\n  ) {\n    throw new Error(`Invalid intDecoding option: ${intDecoding}`)\n  }\n  return JSONbig.parse(str, (_: string, value: any): any => {\n    if (value != null && typeof value === 'object' && Object.getPrototypeOf(value) == null) {\n      // JSONbig.parse objects are created with Object.create(null) and thus have a null prototype\n      // let us remedy that\n      Object.setPrototypeOf(value, Object.prototype)\n    }\n\n    if (typeof value === 'bigint') {\n      if (intDecoding === IntDecoding.SAFE && value > Number.MAX_SAFE_INTEGER) {\n        throw new Error(`Integer exceeds maximum safe integer: ${value.toString()}. Try parsing with a different intDecoding option.`)\n      }\n      if (intDecoding === IntDecoding.BIGINT || (intDecoding === IntDecoding.MIXED && value > Number.MAX_SAFE_INTEGER)) {\n        return value\n      }\n      // JSONbig.parse converts number to BigInts if they are >= 10**15. This is smaller than\n      // Number.MAX_SAFE_INTEGER, so we can convert some BigInts back to normal numbers.\n      return Number(value)\n    }\n\n    if (typeof value === 'number') {\n      if (intDecoding === IntDecoding.BIGINT && Number.isInteger(value)) {\n        return BigInt(value)\n      }\n    }\n\n    return value\n  })\n}\n\n/**\n * Converts a JavaScript value to a JavaScript Object Notation (JSON) string.\n *\n * This functions differs from the built-in JSON.stringify in that it supports serializing BigInts.\n *\n * This function takes the same arguments as the built-in JSON.stringify function.\n *\n * @param value - A JavaScript value, usually an object or array, to be converted.\n * @param replacer - A function that transforms the results.\n * @param space - Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.\n */\nexport function stringifyJSON(value: any, replacer?: (this: any, key: string, value: any) => any, space?: string | number): string {\n  return JSONbig.stringify(value, replacer, space)\n}\n\n/**\n * ArrayEqual takes two arrays and return true if equal, false otherwise\n */\nexport function arrayEqual<T>(a: ArrayLike<T>, b: ArrayLike<T>): boolean {\n  if (a.length !== b.length) {\n    return false\n  }\n  return Array.from(a).every((val, i) => val === b[i])\n}\n\n/**\n * ConcatArrays takes n number arrays and returns a joint Uint8Array\n * @param arrs - An arbitrary number of n array-like number list arguments\n * @returns [a,b]\n */\nexport function concatArrays(...arrs: ArrayLike<number>[]) {\n  const size = arrs.reduce((sum, arr) => sum + arr.length, 0)\n  const c = new Uint8Array(size)\n\n  let offset = 0\n  for (let i = 0; i < arrs.length; i++) {\n    c.set(arrs[i], offset)\n    offset += arrs[i].length\n  }\n\n  return c\n}\n\n/**\n * Remove undefined properties from an object\n * @param obj - An object, preferably one with some undefined properties\n * @returns A copy of the object with undefined properties removed\n */\nexport function removeUndefinedProperties(obj: Record<string | number | symbol, any>) {\n  const mutableCopy = { ...obj }\n  Object.keys(mutableCopy).forEach((key) => {\n    if (typeof mutableCopy[key] === 'undefined') delete mutableCopy[key]\n  })\n  return mutableCopy\n}\n\n/**\n * Check whether the environment is Node.js (as opposed to the browser)\n * @returns True if Node.js environment, false otherwise\n */\nexport function isNode() {\n  return (\n    // @ts-ignore\n    typeof process === 'object' &&\n    // @ts-ignore\n    typeof process.versions === 'object' &&\n    // @ts-ignore\n    typeof process.versions.node !== 'undefined'\n  )\n}\n\n/**\n * Check whether the environment is ReactNative\n * @returns True if ReactNative, false otherwise\n */\nexport function isReactNative() {\n  const { navigator } = globalThis as { navigator?: { product?: string } }\n  if (typeof navigator === 'object' && navigator.product === 'ReactNative') {\n    return true\n  }\n  return false\n}\n\nexport function ensureSafeInteger(value: unknown): number {\n  if (typeof value === 'undefined') {\n    throw new Error('Value is undefined')\n  }\n  if (typeof value === 'bigint') {\n    if (value > BigInt(Number.MAX_SAFE_INTEGER) || value < BigInt(Number.MIN_SAFE_INTEGER)) {\n      throw new Error(`BigInt value ${value} is not a safe integer`)\n    }\n    return Number(value)\n  }\n  if (typeof value === 'number') {\n    if (Number.isSafeInteger(value)) {\n      return value\n    }\n    throw new Error(`Value ${value} is not a safe integer`)\n  }\n  throw new Error(`Unexpected type ${typeof value}, ${value}`)\n}\n\nexport function ensureSafeUnsignedInteger(value: unknown): number {\n  const intValue = ensureSafeInteger(value)\n  if (intValue < 0) {\n    throw new Error(`Value ${intValue} is negative`)\n  }\n  return intValue\n}\n\nexport function ensureBigInt(value: unknown): bigint {\n  if (typeof value === 'undefined') {\n    throw new Error('Value is undefined')\n  }\n  if (typeof value === 'bigint') {\n    return value\n  }\n  if (typeof value === 'number') {\n    if (!Number.isSafeInteger(value)) {\n      throw new Error(`Value ${value} is not a safe integer`)\n    }\n    return BigInt(value)\n  }\n  throw new Error(`Unexpected type ${typeof value}, ${value}`)\n}\n\nexport function ensureUint64(value: unknown): bigint {\n  const bigIntValue = ensureBigInt(value)\n  if (bigIntValue < 0 || bigIntValue > BigInt('0xffffffffffffffff')) {\n    throw new Error(`Value ${bigIntValue} is not a uint64`)\n  }\n  return bigIntValue\n}\n"],"mappings":"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"}

package/packages/transact/src/logicsig.d.ts

@@ -0,0 +1,35 @@
+import { Address } from "../../common/src/address.js";
+import { LogicSignature, MultisigSignature } from "./transactions/signed-transaction.js";
+import { MultisigAccount } from "./multisig.js";
+import { TransactionSigner } from "./signer.js";
+
+//#region packages/transact/src/logicsig.d.ts
+/** Function for signing logic signatures for delegation */
+type DelegatedLsigSigner = (lsig: LogicSigAccount, msig?: MultisigAccount) => Promise<Uint8Array>;
+/** Function for signing program data for a logic signature */
+type ProgramDataSigner = (data: Uint8Array, lsig: LogicSigAccount) => Promise<Uint8Array>;
+declare class LogicSigAccount {
+  logic: Uint8Array;
+  args: Uint8Array[];
+  sig?: Uint8Array;
+  msig?: MultisigSignature;
+  lmsig?: MultisigSignature;
+  static fromSignature(signature: LogicSignature): LogicSigAccount;
+  static fromBytes(encodedLsig: Uint8Array): LogicSigAccount;
+  constructor(program: Uint8Array, programArgs?: Array<Uint8Array> | null);
+  get signer(): TransactionSigner;
+  get addr(): Address;
+  /**
+   * Compute hash of the logic sig program (that is the same as escrow account address) as string address
+   * @returns String representation of the address
+   */
+  address(): Address;
+  delegate(signer: DelegatedLsigSigner): Promise<void>;
+  delegateMultisig(msig: MultisigAccount): Promise<void>;
+  bytesToSignForDelegation(msig?: MultisigAccount): Uint8Array;
+  signProgramData(data: Uint8Array, signer: ProgramDataSigner): Promise<Uint8Array>;
+  programDataToSign(data: Uint8Array): Uint8Array;
+}
+//#endregion
+export { DelegatedLsigSigner, LogicSigAccount, ProgramDataSigner };
+//# sourceMappingURL=logicsig.d.ts.map

package/packages/transact/src/logicsig.js

@@ -0,0 +1,98 @@
+const require_array = require('../../common/src/array.js');
+const require_address = require('../../common/src/address.js');
+const require_crypto = require('../../common/src/crypto.js');
+const require_msgpack = require('../../common/src/msgpack.js');
+const require_signed_transaction_meta = require('./transactions/signed-transaction-meta.js');
+const require_signed_transaction = require('./transactions/signed-transaction.js');
+
+//#region packages/transact/src/logicsig.ts
+const PROGRAM_TAG = new TextEncoder().encode("Program");
+const MSIG_PROGRAM_TAG = new TextEncoder().encode("MsigProgram");
+const SIGN_PROGRAM_DATA_PREFIX = new TextEncoder().encode("ProgData");
+var LogicSigAccount = class LogicSigAccount {
+	logic;
+	args;
+	sig;
+	msig;
+	lmsig;
+	static fromSignature(signature) {
+		const lsigAccount = new LogicSigAccount(signature.logic, signature.args || []);
+		lsigAccount.sig = signature.sig;
+		lsigAccount.msig = signature.msig;
+		lsigAccount.lmsig = signature.lmsig;
+		return lsigAccount;
+	}
+	static fromBytes(encodedLsig) {
+		const decoded = require_msgpack.decodeMsgpack(encodedLsig);
+		const lsigSignature = require_signed_transaction_meta.logicSignatureCodec.decode(decoded, "msgpack");
+		return LogicSigAccount.fromSignature(lsigSignature);
+	}
+	constructor(program, programArgs) {
+		if (programArgs && (!Array.isArray(programArgs) || !programArgs.every((arg) => arg.constructor === Uint8Array))) throw new TypeError("Invalid arguments");
+		let args = [];
+		if (programArgs != null) args = programArgs.map((arg) => new Uint8Array(arg));
+		this.logic = program;
+		this.args = args;
+	}
+	get signer() {
+		return async (txns, indexes) => {
+			const signedTxns = [];
+			for (const index of indexes) {
+				const stxn = {
+					txn: txns[index],
+					lsig: {
+						logic: this.logic,
+						args: this.args,
+						msig: this.msig,
+						lmsig: this.lmsig,
+						sig: this.sig
+					}
+				};
+				signedTxns.push(require_signed_transaction.encodeSignedTransaction(stxn));
+			}
+			return signedTxns;
+		};
+	}
+	get addr() {
+		return this.address();
+	}
+	/**
+	* Compute hash of the logic sig program (that is the same as escrow account address) as string address
+	* @returns String representation of the address
+	*/
+	address() {
+		return new require_address.Address(require_crypto.hash(require_array.concatArrays(PROGRAM_TAG, this.logic)));
+	}
+	async delegate(signer) {
+		this.sig = await signer(this);
+	}
+	async delegateMultisig(msig) {
+		if (this.lmsig == void 0) this.lmsig = {
+			subsigs: [],
+			version: msig.params.version,
+			threshold: msig.params.threshold
+		};
+		for (const addrWithSigner of msig.subSigners) {
+			const { lsigSigner, addr } = addrWithSigner;
+			const signature = await lsigSigner(this, msig);
+			this.lmsig.subsigs.push({
+				publicKey: addr.publicKey,
+				sig: signature
+			});
+		}
+	}
+	bytesToSignForDelegation(msig) {
+		if (msig) return require_array.concatArrays(MSIG_PROGRAM_TAG, msig.addr.publicKey, this.logic);
+		else return require_array.concatArrays(PROGRAM_TAG, this.logic);
+	}
+	signProgramData(data, signer) {
+		return signer(data, this);
+	}
+	programDataToSign(data) {
+		return require_array.concatArrays(SIGN_PROGRAM_DATA_PREFIX, this.address().publicKey, data);
+	}
+};
+
+//#endregion
+exports.LogicSigAccount = LogicSigAccount;
+//# sourceMappingURL=logicsig.js.map