@algorandfoundation/algokit-utils 10.0.0-alpha.4 → 10.0.0-alpha.41

package/kmd-client/index.d.ts

@@ -2,7 +2,6 @@ import { ClientConfig } from "../packages/kmd_client/src/core/client-config.js";
 import { ApiRequestOptions, BaseHttpRequest, inputValueAsString } from "../packages/kmd_client/src/core/base-http-request.js";
 import { FetchHttpRequest } from "../packages/kmd_client/src/core/fetch-http-request.js";
 import { ApiError } from "../packages/kmd_client/src/core/api-error.js";
-import { decodeJson, decodeMsgpack, encodeJson, encodeMsgpack } from "../packages/kmd_client/src/core/model-runtime.js";
 import { TxType } from "../packages/kmd_client/src/models/tx-type.js";
 import { Wallet } from "../packages/kmd_client/src/models/wallet.js";
 import { ListWalletsResponse } from "../packages/kmd_client/src/models/list-wallets-response.js";
@@ -51,4 +50,4 @@ import { SignMultisigRequest } from "../packages/kmd_client/src/models/sign-mult
 import { SignTransactionRequest } from "../packages/kmd_client/src/models/sign-transaction-request.js";
 import { KmdApi } from "../packages/kmd_client/src/apis/api-service.js";
 import { KmdClient } from "../packages/kmd_client/src/client.js";
-export { ApiError, ApiRequestOptions, BaseHttpRequest, ClientConfig, CreateWalletRequest, CreateWalletResponse, DeleteKeyRequest, DeleteMultisigRequest, ExportKeyRequest, ExportKeyResponse, ExportMasterKeyRequest, ExportMasterKeyResponse, ExportMultisigRequest, ExportMultisigResponse, FetchHttpRequest, GenerateKeyRequest, GenerateKeyResponse, ImportKeyRequest, ImportKeyResponse, ImportMultisigRequest, ImportMultisigResponse, InitWalletHandleTokenRequest, InitWalletHandleTokenResponse, KmdApi, KmdClient, ListKeysRequest, ListKeysResponse, ListMultisigRequest, ListMultisigResponse, ListWalletsResponse, MultisigSig, MultisigSubsig, ReleaseWalletHandleTokenRequest, RenameWalletRequest, RenameWalletResponse, RenewWalletHandleTokenRequest, RenewWalletHandleTokenResponse, SignMultisigRequest, SignMultisigResponse, SignMultisigTxnRequest, SignProgramMultisigRequest, SignProgramMultisigResponse, SignProgramRequest, SignProgramResponse, SignTransactionRequest, SignTransactionResponse, SignTxnRequest, TxType, VersionsResponse, Wallet, WalletHandle, WalletInfoRequest, WalletInfoResponse, decodeJson, decodeMsgpack, encodeJson, encodeMsgpack, inputValueAsString };
+export { ApiError, ApiRequestOptions, BaseHttpRequest, ClientConfig, CreateWalletRequest, CreateWalletResponse, DeleteKeyRequest, DeleteMultisigRequest, ExportKeyRequest, ExportKeyResponse, ExportMasterKeyRequest, ExportMasterKeyResponse, ExportMultisigRequest, ExportMultisigResponse, FetchHttpRequest, GenerateKeyRequest, GenerateKeyResponse, ImportKeyRequest, ImportKeyResponse, ImportMultisigRequest, ImportMultisigResponse, InitWalletHandleTokenRequest, InitWalletHandleTokenResponse, KmdApi, KmdClient, ListKeysRequest, ListKeysResponse, ListMultisigRequest, ListMultisigResponse, ListWalletsResponse, MultisigSig, MultisigSubsig, ReleaseWalletHandleTokenRequest, RenameWalletRequest, RenameWalletResponse, RenewWalletHandleTokenRequest, RenewWalletHandleTokenResponse, SignMultisigRequest, SignMultisigResponse, SignMultisigTxnRequest, SignProgramMultisigRequest, SignProgramMultisigResponse, SignProgramRequest, SignProgramResponse, SignTransactionRequest, SignTransactionResponse, SignTxnRequest, TxType, VersionsResponse, Wallet, WalletHandle, WalletInfoRequest, WalletInfoResponse, inputValueAsString };

package/kmd-client/index.js

@@ -1,7 +1,7 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_base_http_request = require('../packages/kmd_client/src/core/base-http-request.js');
 const require_api_error = require('../packages/kmd_client/src/core/api-error.js');
 const require_fetch_http_request = require('../packages/kmd_client/src/core/fetch-http-request.js');
-const require_model_runtime = require('../packages/kmd_client/src/core/model-runtime.js');
 const require_api_service = require('../packages/kmd_client/src/apis/api-service.js');
 const require_client = require('../packages/kmd_client/src/client.js');
 
@@ -10,8 +10,4 @@ exports.BaseHttpRequest = require_base_http_request.BaseHttpRequest;
 exports.FetchHttpRequest = require_fetch_http_request.FetchHttpRequest;
 exports.KmdApi = require_api_service.KmdApi;
 exports.KmdClient = require_client.KmdClient;
-exports.decodeJson = require_model_runtime.decodeJson;
-exports.decodeMsgpack = require_model_runtime.decodeMsgpack;
-exports.encodeJson = require_model_runtime.encodeJson;
-exports.encodeMsgpack = require_model_runtime.encodeMsgpack;
 exports.inputValueAsString = require_base_http_request.inputValueAsString;

package/kmd-client/index.mjs

@@ -1,8 +1,7 @@
 import { BaseHttpRequest, inputValueAsString } from "../packages/kmd_client/src/core/base-http-request.mjs";
 import { ApiError } from "../packages/kmd_client/src/core/api-error.mjs";
 import { FetchHttpRequest } from "../packages/kmd_client/src/core/fetch-http-request.mjs";
-import { decodeJson, decodeMsgpack, encodeJson, encodeMsgpack } from "../packages/kmd_client/src/core/model-runtime.mjs";
 import { KmdApi } from "../packages/kmd_client/src/apis/api-service.mjs";
 import { KmdClient } from "../packages/kmd_client/src/client.mjs";
 
-export { ApiError, BaseHttpRequest, FetchHttpRequest, KmdApi, KmdClient, decodeJson, decodeMsgpack, encodeJson, encodeMsgpack, inputValueAsString };
+export { ApiError, BaseHttpRequest, FetchHttpRequest, KmdApi, KmdClient, inputValueAsString };

package/lifecycle-events.d.ts

@@ -0,0 +1,14 @@
+import { AVMTracesEventData, TealSourcesDebugEventData } from "./debugging.js";
+
+//#region src/lifecycle-events.d.ts
+declare enum EventType {
+  TxnGroupSimulated = "TxnGroupSimulated",
+  AppCompiled = "AppCompiled",
+}
+type EventDataMap = {
+  [EventType.TxnGroupSimulated]: AVMTracesEventData;
+  [EventType.AppCompiled]: TealSourcesDebugEventData;
+};
+//#endregion
+export { EventDataMap, EventType };
+//# sourceMappingURL=lifecycle-events.d.ts.map

package/lifecycle-events.js

@@ -0,0 +1,12 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/lifecycle-events.ts
+let EventType = /* @__PURE__ */ function(EventType) {
+	EventType["TxnGroupSimulated"] = "TxnGroupSimulated";
+	EventType["AppCompiled"] = "AppCompiled";
+	return EventType;
+}({});
+
+//#endregion
+exports.EventType = EventType;
+//# sourceMappingURL=lifecycle-events.js.map

package/lifecycle-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-events.js","names":[],"sources":["../src/lifecycle-events.ts"],"sourcesContent":["import { AVMTracesEventData, TealSourcesDebugEventData } from './debugging'\n\nexport enum EventType {\n  TxnGroupSimulated = 'TxnGroupSimulated',\n  AppCompiled = 'AppCompiled',\n}\n\nexport type EventDataMap = {\n  [EventType.TxnGroupSimulated]: AVMTracesEventData\n  [EventType.AppCompiled]: TealSourcesDebugEventData\n}\n"],"mappings":";;;AAEA,IAAY,gDAAL;AACL;AACA"}

package/lifecycle-events.mjs

@@ -0,0 +1,10 @@
+//#region src/lifecycle-events.ts
+let EventType = /* @__PURE__ */ function(EventType) {
+	EventType["TxnGroupSimulated"] = "TxnGroupSimulated";
+	EventType["AppCompiled"] = "AppCompiled";
+	return EventType;
+}({});
+
+//#endregion
+export { EventType };
+//# sourceMappingURL=lifecycle-events.mjs.map

package/lifecycle-events.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-events.mjs","names":[],"sources":["../src/lifecycle-events.ts"],"sourcesContent":["import { AVMTracesEventData, TealSourcesDebugEventData } from './debugging'\n\nexport enum EventType {\n  TxnGroupSimulated = 'TxnGroupSimulated',\n  AppCompiled = 'AppCompiled',\n}\n\nexport type EventDataMap = {\n  [EventType.TxnGroupSimulated]: AVMTracesEventData\n  [EventType.AppCompiled]: TealSourcesDebugEventData\n}\n"],"mappings":";AAEA,IAAY,gDAAL;AACL;AACA"}

package/logging.d.ts

@@ -0,0 +1,13 @@
+import { Logger } from "./packages/common/src/logger.js";
+
+//#region src/logging.d.ts
+/** A logger implementation that writes to console */
+declare const consoleLogger: Logger;
+declare const infoConsoleLogger: Logger;
+declare const verboseConsoleLogger: Logger;
+declare const warningConsoleLogger: Logger;
+/** A logger implementation that does nothing */
+declare const nullLogger: Logger;
+//#endregion
+export { type Logger, consoleLogger, infoConsoleLogger, nullLogger, verboseConsoleLogger, warningConsoleLogger };
+//# sourceMappingURL=logging.d.ts.map

package/logging.js

@@ -0,0 +1,48 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/logging.ts
+/** A logger implementation that writes to console */
+const consoleLogger = {
+	error: console.error,
+	warn: console.warn,
+	info: console.info,
+	verbose: () => {},
+	debug: console.debug
+};
+const infoConsoleLogger = {
+	error: console.error,
+	warn: console.warn,
+	info: console.info,
+	verbose: () => {},
+	debug: () => {}
+};
+const verboseConsoleLogger = {
+	error: console.error,
+	warn: console.warn,
+	info: console.info,
+	verbose: console.trace,
+	debug: console.debug
+};
+const warningConsoleLogger = {
+	error: console.error,
+	warn: console.warn,
+	info: () => {},
+	verbose: () => {},
+	debug: () => {}
+};
+/** A logger implementation that does nothing */
+const nullLogger = {
+	error: function(message, ...optionalParams) {},
+	warn: function(message, ...optionalParams) {},
+	info: function(message, ...optionalParams) {},
+	verbose: function(message, ...optionalParams) {},
+	debug: function(message, ...optionalParams) {}
+};
+
+//#endregion
+exports.consoleLogger = consoleLogger;
+exports.infoConsoleLogger = infoConsoleLogger;
+exports.nullLogger = nullLogger;
+exports.verboseConsoleLogger = verboseConsoleLogger;
+exports.warningConsoleLogger = warningConsoleLogger;
+//# sourceMappingURL=logging.js.map

package/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","names":[],"sources":["../src/logging.ts"],"sourcesContent":["/* eslint-disable unused-imports/no-unused-vars */\n/* eslint-disable no-console */\n\nimport type { Logger } from '@algorandfoundation/algokit-common'\nexport type { Logger } from '@algorandfoundation/algokit-common'\n\n/** A logger implementation that writes to console */\nexport const consoleLogger: Logger = {\n  error: console.error,\n  warn: console.warn,\n  info: console.info,\n  verbose: () => {},\n  debug: console.debug,\n}\n\nexport const infoConsoleLogger: Logger = {\n  error: console.error,\n  warn: console.warn,\n  info: console.info,\n  verbose: () => {},\n  debug: () => {},\n}\n\nexport const verboseConsoleLogger: Logger = {\n  error: console.error,\n  warn: console.warn,\n  info: console.info,\n  verbose: console.trace,\n  debug: console.debug,\n}\n\nexport const warningConsoleLogger: Logger = {\n  error: console.error,\n  warn: console.warn,\n  info: () => {},\n  verbose: () => {},\n  debug: () => {},\n}\n\n/** A logger implementation that does nothing */\nexport const nullLogger: Logger = {\n  error: function (message: string, ...optionalParams: unknown[]): void {},\n  warn: function (message: string, ...optionalParams: unknown[]): void {},\n  info: function (message: string, ...optionalParams: unknown[]): void {},\n  verbose: function (message: string, ...optionalParams: unknown[]): void {},\n  debug: function (message: string, ...optionalParams: unknown[]): void {},\n}\n"],"mappings":";;;;AAOA,MAAa,gBAAwB;CACnC,OAAO,QAAQ;CACf,MAAM,QAAQ;CACd,MAAM,QAAQ;CACd,eAAe;CACf,OAAO,QAAQ;CAChB;AAED,MAAa,oBAA4B;CACvC,OAAO,QAAQ;CACf,MAAM,QAAQ;CACd,MAAM,QAAQ;CACd,eAAe;CACf,aAAa;CACd;AAED,MAAa,uBAA+B;CAC1C,OAAO,QAAQ;CACf,MAAM,QAAQ;CACd,MAAM,QAAQ;CACd,SAAS,QAAQ;CACjB,OAAO,QAAQ;CAChB;AAED,MAAa,uBAA+B;CAC1C,OAAO,QAAQ;CACf,MAAM,QAAQ;CACd,YAAY;CACZ,eAAe;CACf,aAAa;CACd;;AAGD,MAAa,aAAqB;CAChC,OAAO,SAAU,SAAiB,GAAG,gBAAiC;CACtE,MAAM,SAAU,SAAiB,GAAG,gBAAiC;CACrE,MAAM,SAAU,SAAiB,GAAG,gBAAiC;CACrE,SAAS,SAAU,SAAiB,GAAG,gBAAiC;CACxE,OAAO,SAAU,SAAiB,GAAG,gBAAiC;CACvE"}

package/logging.mjs

@@ -0,0 +1,42 @@
+//#region src/logging.ts
+/** A logger implementation that writes to console */
+const consoleLogger = {
+	error: console.error,
+	warn: console.warn,
+	info: console.info,
+	verbose: () => {},
+	debug: console.debug
+};
+const infoConsoleLogger = {
+	error: console.error,
+	warn: console.warn,
+	info: console.info,
+	verbose: () => {},
+	debug: () => {}
+};
+const verboseConsoleLogger = {
+	error: console.error,
+	warn: console.warn,
+	info: console.info,
+	verbose: console.trace,
+	debug: console.debug
+};
+const warningConsoleLogger = {
+	error: console.error,
+	warn: console.warn,
+	info: () => {},
+	verbose: () => {},
+	debug: () => {}
+};
+/** A logger implementation that does nothing */
+const nullLogger = {
+	error: function(message, ...optionalParams) {},
+	warn: function(message, ...optionalParams) {},
+	info: function(message, ...optionalParams) {},
+	verbose: function(message, ...optionalParams) {},
+	debug: function(message, ...optionalParams) {}
+};
+
+//#endregion
+export { consoleLogger, infoConsoleLogger, nullLogger, verboseConsoleLogger, warningConsoleLogger };
+//# sourceMappingURL=logging.mjs.map

package/logging.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.mjs","names":[],"sources":["../src/logging.ts"],"sourcesContent":["/* eslint-disable unused-imports/no-unused-vars */\n/* eslint-disable no-console */\n\nimport type { Logger } from '@algorandfoundation/algokit-common'\nexport type { Logger } from '@algorandfoundation/algokit-common'\n\n/** A logger implementation that writes to console */\nexport const consoleLogger: Logger = {\n  error: console.error,\n  warn: console.warn,\n  info: console.info,\n  verbose: () => {},\n  debug: console.debug,\n}\n\nexport const infoConsoleLogger: Logger = {\n  error: console.error,\n  warn: console.warn,\n  info: console.info,\n  verbose: () => {},\n  debug: () => {},\n}\n\nexport const verboseConsoleLogger: Logger = {\n  error: console.error,\n  warn: console.warn,\n  info: console.info,\n  verbose: console.trace,\n  debug: console.debug,\n}\n\nexport const warningConsoleLogger: Logger = {\n  error: console.error,\n  warn: console.warn,\n  info: () => {},\n  verbose: () => {},\n  debug: () => {},\n}\n\n/** A logger implementation that does nothing */\nexport const nullLogger: Logger = {\n  error: function (message: string, ...optionalParams: unknown[]): void {},\n  warn: function (message: string, ...optionalParams: unknown[]): void {},\n  info: function (message: string, ...optionalParams: unknown[]): void {},\n  verbose: function (message: string, ...optionalParams: unknown[]): void {},\n  debug: function (message: string, ...optionalParams: unknown[]): void {},\n}\n"],"mappings":";;AAOA,MAAa,gBAAwB;CACnC,OAAO,QAAQ;CACf,MAAM,QAAQ;CACd,MAAM,QAAQ;CACd,eAAe;CACf,OAAO,QAAQ;CAChB;AAED,MAAa,oBAA4B;CACvC,OAAO,QAAQ;CACf,MAAM,QAAQ;CACd,MAAM,QAAQ;CACd,eAAe;CACf,aAAa;CACd;AAED,MAAa,uBAA+B;CAC1C,OAAO,QAAQ;CACf,MAAM,QAAQ;CACd,MAAM,QAAQ;CACd,SAAS,QAAQ;CACjB,OAAO,QAAQ;CAChB;AAED,MAAa,uBAA+B;CAC1C,OAAO,QAAQ;CACf,MAAM,QAAQ;CACd,YAAY;CACZ,eAAe;CACf,aAAa;CACd;;AAGD,MAAa,aAAqB;CAChC,OAAO,SAAU,SAAiB,GAAG,gBAAiC;CACtE,MAAM,SAAU,SAAiB,GAAG,gBAAiC;CACrE,MAAM,SAAU,SAAiB,GAAG,gBAAiC;CACrE,SAAS,SAAU,SAAiB,GAAG,gBAAiC;CACxE,OAAO,SAAU,SAAiB,GAAG,gBAAiC;CACvE"}

package/logic-error.d.ts

@@ -0,0 +1,39 @@
+//#region src/logic-error.d.ts
+/**
+ * Details about a smart contract logic error
+ */
+interface LogicErrorDetails {
+  /** The ID of the transaction with the logic error */
+  txId: string;
+  /** The program counter where the error was */
+  pc: number;
+  /** The error message */
+  msg: string;
+  /** The full error description */
+  desc: string;
+  /** Any trace information included in the error */
+  traces: Record<string, unknown>[];
+}
+/** Wraps key functionality around processing logic errors */
+declare class LogicError extends Error {
+  /** Takes an error message and parses out the details of any logic errors in there.
+   * @param error The error message to parse
+   * @returns The logic error details if any, or undefined
+   */
+  static parseLogicError(error: any): LogicErrorDetails | undefined;
+  led: LogicErrorDetails;
+  program: string[];
+  lines: number;
+  teal_line: number;
+  stack?: string;
+  /**
+   * Create a new logic error object.
+   * @param errorDetails The details of the logic error
+   * @param program The TEAL source code, split by line
+   * @param getLineForPc The source map of the TEAL source code
+   */
+  constructor(errorDetails: LogicErrorDetails, program: string[], getLineForPc: (pc: number) => number | undefined);
+}
+//#endregion
+export { LogicError, LogicErrorDetails };
+//# sourceMappingURL=logic-error.d.ts.map

package/logic-error.js

@@ -0,0 +1,55 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/logic-error.ts
+const LOGIC_ERROR = /transaction ([A-Z0-9]+): logic eval error: (.*). Details: .*pc=([0-9]+).*/;
+const INNER_LOGIC_ERROR = /inner tx (\d+) failed:.*?pc=([0-9]+)/;
+/** Wraps key functionality around processing logic errors */
+var LogicError = class extends Error {
+	/** Takes an error message and parses out the details of any logic errors in there.
+	* @param error The error message to parse
+	* @returns The logic error details if any, or undefined
+	*/
+	static parseLogicError(error) {
+		const errorMessage = error.message;
+		const res = LOGIC_ERROR.exec(errorMessage);
+		const innerRes = INNER_LOGIC_ERROR.exec(errorMessage);
+		if (res === null || res.length <= 3) return void 0;
+		return {
+			txId: res[1],
+			msg: res[2],
+			desc: errorMessage,
+			pc: parseInt(innerRes?.[2] ?? res[3] ?? "0"),
+			traces: error.traces
+		};
+	}
+	led;
+	program;
+	lines = 5;
+	teal_line = 0;
+	stack;
+	/**
+	* Create a new logic error object.
+	* @param errorDetails The details of the logic error
+	* @param program The TEAL source code, split by line
+	* @param getLineForPc The source map of the TEAL source code
+	*/
+	constructor(errorDetails, program, getLineForPc) {
+		super();
+		this.led = errorDetails;
+		this.program = program;
+		const line = getLineForPc(errorDetails.pc);
+		this.teal_line = line === void 0 ? 0 : line;
+		this.message = `${this.led.msg}. at:${line}. ${this.led.desc}`;
+		if (this.teal_line > 0) {
+			const start = this.teal_line > this.lines ? this.teal_line - this.lines : 0;
+			const stop = program.length > this.teal_line + this.lines ? this.teal_line + this.lines : program.length;
+			const stack_lines = program.slice(start, stop);
+			stack_lines[stack_lines.length / 2] += " <--- Error";
+			this.stack = stack_lines.join("\n");
+		}
+	}
+};
+
+//#endregion
+exports.LogicError = LogicError;
+//# sourceMappingURL=logic-error.js.map

package/logic-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logic-error.js","names":[],"sources":["../src/logic-error.ts"],"sourcesContent":["const LOGIC_ERROR = /transaction ([A-Z0-9]+): logic eval error: (.*). Details: .*pc=([0-9]+).*/\n// inner tx 0 failed: logic eval error: err opcode executed. Details: app=6248, pc=29, opcodes=tx\nconst INNER_LOGIC_ERROR = /inner tx (\\d+) failed:.*?pc=([0-9]+)/\n\n/**\n * Details about a smart contract logic error\n */\nexport interface LogicErrorDetails {\n  /** The ID of the transaction with the logic error */\n  txId: string\n  /** The program counter where the error was */\n  pc: number\n  /** The error message */\n  msg: string\n  /** The full error description */\n  desc: string\n  /** Any trace information included in the error */\n  traces: Record<string, unknown>[]\n}\n\n/** Wraps key functionality around processing logic errors */\nexport class LogicError extends Error {\n  /** Takes an error message and parses out the details of any logic errors in there.\n   * @param error The error message to parse\n   * @returns The logic error details if any, or undefined\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  static parseLogicError(error: any): LogicErrorDetails | undefined {\n    const errorMessage = error.message\n    const res = LOGIC_ERROR.exec(errorMessage)\n    const innerRes = INNER_LOGIC_ERROR.exec(errorMessage)\n\n    if (res === null || res.length <= 3) return undefined\n\n    return {\n      txId: res[1],\n      msg: res[2],\n      desc: errorMessage,\n      pc: parseInt(innerRes?.[2] ?? res[3] ?? '0'),\n      traces: error.traces,\n    } as LogicErrorDetails\n  }\n\n  public led: LogicErrorDetails\n  public program: string[]\n  public lines = 5\n  public teal_line = 0\n  override stack?: string\n\n  /**\n   * Create a new logic error object.\n   * @param errorDetails The details of the logic error\n   * @param program The TEAL source code, split by line\n   * @param getLineForPc The source map of the TEAL source code\n   */\n  constructor(errorDetails: LogicErrorDetails, program: string[], getLineForPc: (pc: number) => number | undefined) {\n    super()\n    this.led = errorDetails\n    this.program = program\n\n    const line = getLineForPc(errorDetails.pc)\n    this.teal_line = line === undefined ? 0 : line\n\n    this.message = `${this.led.msg}. at:${line}. ${this.led.desc}`\n\n    if (this.teal_line > 0) {\n      const start = this.teal_line > this.lines ? this.teal_line - this.lines : 0\n      const stop = program.length > this.teal_line + this.lines ? this.teal_line + this.lines : program.length\n\n      const stack_lines = program.slice(start, stop)\n\n      stack_lines[stack_lines.length / 2] += ' <--- Error'\n\n      this.stack = stack_lines.join('\\n')\n    }\n  }\n}\n"],"mappings":";;;AAAA,MAAM,cAAc;AAEpB,MAAM,oBAAoB;;AAmB1B,IAAa,aAAb,cAAgC,MAAM;;;;;CAMpC,OAAO,gBAAgB,OAA2C;EAChE,MAAM,eAAe,MAAM;EAC3B,MAAM,MAAM,YAAY,KAAK,aAAa;EAC1C,MAAM,WAAW,kBAAkB,KAAK,aAAa;AAErD,MAAI,QAAQ,QAAQ,IAAI,UAAU,EAAG,QAAO;AAE5C,SAAO;GACL,MAAM,IAAI;GACV,KAAK,IAAI;GACT,MAAM;GACN,IAAI,SAAS,WAAW,MAAM,IAAI,MAAM,IAAI;GAC5C,QAAQ,MAAM;GACf;;CAGH,AAAO;CACP,AAAO;CACP,AAAO,QAAQ;CACf,AAAO,YAAY;CACnB,AAAS;;;;;;;CAQT,YAAY,cAAiC,SAAmB,cAAkD;AAChH,SAAO;AACP,OAAK,MAAM;AACX,OAAK,UAAU;EAEf,MAAM,OAAO,aAAa,aAAa,GAAG;AAC1C,OAAK,YAAY,SAAS,SAAY,IAAI;AAE1C,OAAK,UAAU,GAAG,KAAK,IAAI,IAAI,OAAO,KAAK,IAAI,KAAK,IAAI;AAExD,MAAI,KAAK,YAAY,GAAG;GACtB,MAAM,QAAQ,KAAK,YAAY,KAAK,QAAQ,KAAK,YAAY,KAAK,QAAQ;GAC1E,MAAM,OAAO,QAAQ,SAAS,KAAK,YAAY,KAAK,QAAQ,KAAK,YAAY,KAAK,QAAQ,QAAQ;GAElG,MAAM,cAAc,QAAQ,MAAM,OAAO,KAAK;AAE9C,eAAY,YAAY,SAAS,MAAM;AAEvC,QAAK,QAAQ,YAAY,KAAK,KAAK"}

package/logic-error.mjs

@@ -0,0 +1,53 @@
+//#region src/logic-error.ts
+const LOGIC_ERROR = /transaction ([A-Z0-9]+): logic eval error: (.*). Details: .*pc=([0-9]+).*/;
+const INNER_LOGIC_ERROR = /inner tx (\d+) failed:.*?pc=([0-9]+)/;
+/** Wraps key functionality around processing logic errors */
+var LogicError = class extends Error {
+	/** Takes an error message and parses out the details of any logic errors in there.
+	* @param error The error message to parse
+	* @returns The logic error details if any, or undefined
+	*/
+	static parseLogicError(error) {
+		const errorMessage = error.message;
+		const res = LOGIC_ERROR.exec(errorMessage);
+		const innerRes = INNER_LOGIC_ERROR.exec(errorMessage);
+		if (res === null || res.length <= 3) return void 0;
+		return {
+			txId: res[1],
+			msg: res[2],
+			desc: errorMessage,
+			pc: parseInt(innerRes?.[2] ?? res[3] ?? "0"),
+			traces: error.traces
+		};
+	}
+	led;
+	program;
+	lines = 5;
+	teal_line = 0;
+	stack;
+	/**
+	* Create a new logic error object.
+	* @param errorDetails The details of the logic error
+	* @param program The TEAL source code, split by line
+	* @param getLineForPc The source map of the TEAL source code
+	*/
+	constructor(errorDetails, program, getLineForPc) {
+		super();
+		this.led = errorDetails;
+		this.program = program;
+		const line = getLineForPc(errorDetails.pc);
+		this.teal_line = line === void 0 ? 0 : line;
+		this.message = `${this.led.msg}. at:${line}. ${this.led.desc}`;
+		if (this.teal_line > 0) {
+			const start = this.teal_line > this.lines ? this.teal_line - this.lines : 0;
+			const stop = program.length > this.teal_line + this.lines ? this.teal_line + this.lines : program.length;
+			const stack_lines = program.slice(start, stop);
+			stack_lines[stack_lines.length / 2] += " <--- Error";
+			this.stack = stack_lines.join("\n");
+		}
+	}
+};
+
+//#endregion
+export { LogicError };
+//# sourceMappingURL=logic-error.mjs.map

package/logic-error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logic-error.mjs","names":[],"sources":["../src/logic-error.ts"],"sourcesContent":["const LOGIC_ERROR = /transaction ([A-Z0-9]+): logic eval error: (.*). Details: .*pc=([0-9]+).*/\n// inner tx 0 failed: logic eval error: err opcode executed. Details: app=6248, pc=29, opcodes=tx\nconst INNER_LOGIC_ERROR = /inner tx (\\d+) failed:.*?pc=([0-9]+)/\n\n/**\n * Details about a smart contract logic error\n */\nexport interface LogicErrorDetails {\n  /** The ID of the transaction with the logic error */\n  txId: string\n  /** The program counter where the error was */\n  pc: number\n  /** The error message */\n  msg: string\n  /** The full error description */\n  desc: string\n  /** Any trace information included in the error */\n  traces: Record<string, unknown>[]\n}\n\n/** Wraps key functionality around processing logic errors */\nexport class LogicError extends Error {\n  /** Takes an error message and parses out the details of any logic errors in there.\n   * @param error The error message to parse\n   * @returns The logic error details if any, or undefined\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  static parseLogicError(error: any): LogicErrorDetails | undefined {\n    const errorMessage = error.message\n    const res = LOGIC_ERROR.exec(errorMessage)\n    const innerRes = INNER_LOGIC_ERROR.exec(errorMessage)\n\n    if (res === null || res.length <= 3) return undefined\n\n    return {\n      txId: res[1],\n      msg: res[2],\n      desc: errorMessage,\n      pc: parseInt(innerRes?.[2] ?? res[3] ?? '0'),\n      traces: error.traces,\n    } as LogicErrorDetails\n  }\n\n  public led: LogicErrorDetails\n  public program: string[]\n  public lines = 5\n  public teal_line = 0\n  override stack?: string\n\n  /**\n   * Create a new logic error object.\n   * @param errorDetails The details of the logic error\n   * @param program The TEAL source code, split by line\n   * @param getLineForPc The source map of the TEAL source code\n   */\n  constructor(errorDetails: LogicErrorDetails, program: string[], getLineForPc: (pc: number) => number | undefined) {\n    super()\n    this.led = errorDetails\n    this.program = program\n\n    const line = getLineForPc(errorDetails.pc)\n    this.teal_line = line === undefined ? 0 : line\n\n    this.message = `${this.led.msg}. at:${line}. ${this.led.desc}`\n\n    if (this.teal_line > 0) {\n      const start = this.teal_line > this.lines ? this.teal_line - this.lines : 0\n      const stop = program.length > this.teal_line + this.lines ? this.teal_line + this.lines : program.length\n\n      const stack_lines = program.slice(start, stop)\n\n      stack_lines[stack_lines.length / 2] += ' <--- Error'\n\n      this.stack = stack_lines.join('\\n')\n    }\n  }\n}\n"],"mappings":";AAAA,MAAM,cAAc;AAEpB,MAAM,oBAAoB;;AAmB1B,IAAa,aAAb,cAAgC,MAAM;;;;;CAMpC,OAAO,gBAAgB,OAA2C;EAChE,MAAM,eAAe,MAAM;EAC3B,MAAM,MAAM,YAAY,KAAK,aAAa;EAC1C,MAAM,WAAW,kBAAkB,KAAK,aAAa;AAErD,MAAI,QAAQ,QAAQ,IAAI,UAAU,EAAG,QAAO;AAE5C,SAAO;GACL,MAAM,IAAI;GACV,KAAK,IAAI;GACT,MAAM;GACN,IAAI,SAAS,WAAW,MAAM,IAAI,MAAM,IAAI;GAC5C,QAAQ,MAAM;GACf;;CAGH,AAAO;CACP,AAAO;CACP,AAAO,QAAQ;CACf,AAAO,YAAY;CACnB,AAAS;;;;;;;CAQT,YAAY,cAAiC,SAAmB,cAAkD;AAChH,SAAO;AACP,OAAK,MAAM;AACX,OAAK,UAAU;EAEf,MAAM,OAAO,aAAa,aAAa,GAAG;AAC1C,OAAK,YAAY,SAAS,SAAY,IAAI;AAE1C,OAAK,UAAU,GAAG,KAAK,IAAI,IAAI,OAAO,KAAK,IAAI,KAAK,IAAI;AAExD,MAAI,KAAK,YAAY,GAAG;GACtB,MAAM,QAAQ,KAAK,YAAY,KAAK,QAAQ,KAAK,YAAY,KAAK,QAAQ;GAC1E,MAAM,OAAO,QAAQ,SAAS,KAAK,YAAY,KAAK,QAAQ,KAAK,YAAY,KAAK,QAAQ,QAAQ;GAElG,MAAM,cAAc,QAAQ,MAAM,OAAO,KAAK;AAE9C,eAAY,YAAY,SAAS,MAAM;AAEvC,QAAK,QAAQ,YAAY,KAAK,KAAK"}

package/network-client.d.ts

@@ -0,0 +1,43 @@
+//#region src/network-client.d.ts
+/** Config for an Algorand SDK client. */
+interface AlgoClientConfig {
+  /** Base URL of the server e.g. http://localhost, https://testnet-api.algonode.cloud/, etc. */
+  server: string;
+  /** The port to use e.g. 4001, 443, etc. */
+  port?: string | number;
+  /** The token to use for API authentication (or undefined if none needed) - can be a string, or an object with the header key => value */
+  token?: string | {
+    [name: string]: string;
+  };
+}
+/** Configuration for algod, indexer and kmd clients. */
+interface AlgoConfig {
+  /** Algod client configuration */
+  algodConfig: AlgoClientConfig;
+  /** Indexer client configuration */
+  indexerConfig?: AlgoClientConfig;
+  /** Kmd configuration */
+  kmdConfig?: AlgoClientConfig;
+}
+/** Details of the current network. */
+interface NetworkDetails {
+  /** Whether or not the network is TestNet. */
+  isTestNet: boolean;
+  /** Whether or not the network is MainNet. */
+  isMainNet: boolean;
+  /** Whether or not the network is LocalNet. */
+  isLocalNet: boolean;
+  /** The genesis ID of the current network. */
+  genesisId: string;
+  /** The base64 genesis hash of the current network. */
+  genesisHash: string;
+}
+/**
+ * Returns true if the given network genesisId is associated with a LocalNet network.
+ * @param genesisId The network genesis ID
+ * @returns Whether the given genesis ID is associated with a LocalNet network
+ */
+declare function genesisIdIsLocalNet(genesisId: string): genesisId is "devnet-v1" | "sandnet-v1" | "dockernet-v1";
+//#endregion
+export { AlgoClientConfig, AlgoConfig, NetworkDetails, genesisIdIsLocalNet };
+//# sourceMappingURL=network-client.d.ts.map

package/network-client.js

@@ -0,0 +1,15 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/network-client.ts
+/**
+* Returns true if the given network genesisId is associated with a LocalNet network.
+* @param genesisId The network genesis ID
+* @returns Whether the given genesis ID is associated with a LocalNet network
+*/
+function genesisIdIsLocalNet(genesisId) {
+	return genesisId === "devnet-v1" || genesisId === "sandnet-v1" || genesisId === "dockernet-v1";
+}
+
+//#endregion
+exports.genesisIdIsLocalNet = genesisIdIsLocalNet;
+//# sourceMappingURL=network-client.js.map

package/network-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-client.js","names":[],"sources":["../src/network-client.ts"],"sourcesContent":["/** Config for an Algorand SDK client. */\nexport interface AlgoClientConfig {\n  /** Base URL of the server e.g. http://localhost, https://testnet-api.algonode.cloud/, etc. */\n  server: string\n  /** The port to use e.g. 4001, 443, etc. */\n  port?: string | number\n  /** The token to use for API authentication (or undefined if none needed) - can be a string, or an object with the header key => value */\n  token?: string | { [name: string]: string }\n}\n\n/** Configuration for algod, indexer and kmd clients. */\nexport interface AlgoConfig {\n  /** Algod client configuration */\n  algodConfig: AlgoClientConfig\n  /** Indexer client configuration */\n  indexerConfig?: AlgoClientConfig\n  /** Kmd configuration */\n  kmdConfig?: AlgoClientConfig\n}\n\n/** Details of the current network. */\nexport interface NetworkDetails {\n  /** Whether or not the network is TestNet. */\n  isTestNet: boolean\n  /** Whether or not the network is MainNet. */\n  isMainNet: boolean\n  /** Whether or not the network is LocalNet. */\n  isLocalNet: boolean\n  /** The genesis ID of the current network. */\n  genesisId: string\n  /** The base64 genesis hash of the current network. */\n  genesisHash: string\n}\n\n/**\n * Returns true if the given network genesisId is associated with a LocalNet network.\n * @param genesisId The network genesis ID\n * @returns Whether the given genesis ID is associated with a LocalNet network\n */\nexport function genesisIdIsLocalNet(genesisId: string) {\n  return genesisId === 'devnet-v1' || genesisId === 'sandnet-v1' || genesisId === 'dockernet-v1'\n}\n"],"mappings":";;;;;;;;AAuCA,SAAgB,oBAAoB,WAAmB;AACrD,QAAO,cAAc,eAAe,cAAc,gBAAgB,cAAc"}

package/network-client.mjs

@@ -0,0 +1,13 @@
+//#region src/network-client.ts
+/**
+* Returns true if the given network genesisId is associated with a LocalNet network.
+* @param genesisId The network genesis ID
+* @returns Whether the given genesis ID is associated with a LocalNet network
+*/
+function genesisIdIsLocalNet(genesisId) {
+	return genesisId === "devnet-v1" || genesisId === "sandnet-v1" || genesisId === "dockernet-v1";
+}
+
+//#endregion
+export { genesisIdIsLocalNet };
+//# sourceMappingURL=network-client.mjs.map

package/network-client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-client.mjs","names":[],"sources":["../src/network-client.ts"],"sourcesContent":["/** Config for an Algorand SDK client. */\nexport interface AlgoClientConfig {\n  /** Base URL of the server e.g. http://localhost, https://testnet-api.algonode.cloud/, etc. */\n  server: string\n  /** The port to use e.g. 4001, 443, etc. */\n  port?: string | number\n  /** The token to use for API authentication (or undefined if none needed) - can be a string, or an object with the header key => value */\n  token?: string | { [name: string]: string }\n}\n\n/** Configuration for algod, indexer and kmd clients. */\nexport interface AlgoConfig {\n  /** Algod client configuration */\n  algodConfig: AlgoClientConfig\n  /** Indexer client configuration */\n  indexerConfig?: AlgoClientConfig\n  /** Kmd configuration */\n  kmdConfig?: AlgoClientConfig\n}\n\n/** Details of the current network. */\nexport interface NetworkDetails {\n  /** Whether or not the network is TestNet. */\n  isTestNet: boolean\n  /** Whether or not the network is MainNet. */\n  isMainNet: boolean\n  /** Whether or not the network is LocalNet. */\n  isLocalNet: boolean\n  /** The genesis ID of the current network. */\n  genesisId: string\n  /** The base64 genesis hash of the current network. */\n  genesisHash: string\n}\n\n/**\n * Returns true if the given network genesisId is associated with a LocalNet network.\n * @param genesisId The network genesis ID\n * @returns Whether the given genesis ID is associated with a LocalNet network\n */\nexport function genesisIdIsLocalNet(genesisId: string) {\n  return genesisId === 'devnet-v1' || genesisId === 'sandnet-v1' || genesisId === 'dockernet-v1'\n}\n"],"mappings":";;;;;;AAuCA,SAAgB,oBAAoB,WAAmB;AACrD,QAAO,cAAc,eAAe,cAAc,gBAAgB,cAAc"}

package/network-manager.d.ts

@@ -0,0 +1,143 @@
+import { AlgodClient } from "./packages/algod_client/src/client.js";
+import { AlgorandClient } from "./algorand-client.js";
+
+//#region src/network-manager.d.ts
+/** Options for waiting until a specific timestamp is reached on the blockchain. */
+interface WaitUntilTimestampOptions {
+  /** Estimated block time in seconds, used to calculate rounds to wait. Should be slightly lower than average to undershoot. Defaults to 2.7. */
+  blockTimeSeconds?: number;
+  /** Polling interval in milliseconds when close to target. Defaults to 1000. */
+  pollingIntervalMs?: number;
+  /** Timeout in milliseconds for the polling loop. Defaults to 5000. */
+  pollingTimeoutMs?: number;
+}
+/**
+ * Manager for LocalNet-specific network operations.
+ * These methods only work on LocalNet and will throw an error if called on other networks.
+ */
+declare class LocalNetManager {
+  private _algod;
+  private _networkManager;
+  private _algorand;
+  /** @param algod The algod client to use for LocalNet operations */
+  constructor(algod: AlgodClient, networkManager: NetworkManager, algorand: AlgorandClient);
+  private _ensureLocalNet;
+  /**
+   * Generates a single block by sending a zero-amount payment transaction from the dispenser to itself.
+   * This triggers block creation in LocalNet dev mode.
+   */
+  private _generateBlock;
+  /**
+   * Advances the blockchain by generating blocks until the target round is reached.
+   * @param targetRound The round number to advance to
+   * @throws Error if not connected to LocalNet
+   * @example
+   * ```typescript
+   * // Advance LocalNet to round 100
+   * await algorand.network.localNet.blockWarp(100n)
+   * ```
+   */
+  blockWarp(targetRound: bigint): Promise<void>;
+  /**
+   * Advances the blockchain timestamp to a target Unix timestamp.
+   * @param targetTimestamp The target Unix timestamp in seconds
+   * @throws Error if not connected to LocalNet
+   * @example
+   * ```typescript
+   * // Advance LocalNet time by 1 hour
+   * const oneHourFromNow = BigInt(Math.floor(Date.now() / 1000)) + 3600n
+   * await algorand.network.localNet.timeWarp(oneHourFromNow)
+   * ```
+   */
+  timeWarp(targetTimestamp: bigint): Promise<void>;
+}
+/**
+ * Manager for network-related operations.
+ * Provides utilities for querying blockchain state and waiting for specific conditions.
+ */
+declare class NetworkManager {
+  private _algod;
+  private _algorand;
+  private _localNet;
+  /**
+   * Create a new NetworkManager instance.
+   * @param algod The algod client to use for network operations
+   * @param algorand The AlgorandClient instance (for LocalNet operations)
+   */
+  constructor(algod: AlgodClient, algorand: AlgorandClient);
+  /**
+   * Get the last committed round number.
+   * @returns The last round number
+   * @example
+   * ```typescript
+   * const lastRound = await algorand.network.getLastRound()
+   * console.log(`Current round: ${lastRound}`)
+   * ```
+   */
+  getLastRound(): Promise<bigint>;
+  /**
+   * Get the Unix timestamp of the latest block.
+   *
+   * Note: This method makes two sequential API calls (status then block fetch).
+   * The round may advance between these calls, so the returned timestamp may not
+   * be from the actual latest timestamp.
+   *
+   * @returns The UNIX timestamp of the last round
+   * @example
+   * ```typescript
+   * const timestamp = await algorand.network.getLatestTimestamp()
+   * console.log(`Latest block time: ${new Date(Number(timestamp) * 1000)}`)
+   * ```
+   */
+  getLatestTimestamp(): Promise<bigint>;
+  /**
+   * Wait until a specific round is reached.
+   *
+   * @param targetRound The round number to wait for
+   * @throws Error if timeout is reached before the target round
+   * @example
+   * ```typescript
+   * // Wait for round 1000
+   * await algorand.network.waitUntilRound(1000n)
+   *
+   * // Wait with a 30 second timeout
+   * await algorand.network.waitUntilRound(1000n, 30000)
+   * ```
+   */
+  waitUntilRound(targetRound: bigint): Promise<void>;
+  /**
+   * Wait until a specific Unix timestamp is reached on the blockchain.
+   *
+   * @param targetTimestamp The target Unix timestamp in seconds
+   * @param options Optional parameters for waiting
+   * @example
+   * ```typescript
+   * // Wait until a specific time
+   * const futureTime = BigInt(Math.floor(Date.now() / 1000)) + 60n // 1 minute from now
+   * await algorand.network.waitUntilTimestamp(futureTime)
+   *
+   * // Wait with custom timing parameters
+   * await algorand.network.waitUntilTimestamp(futureTime, { blockTimeSeconds: 3.0, pollingIntervalMs: 500 })
+   * ```
+   */
+  waitUntilTimestamp(targetTimestamp: bigint, options?: WaitUntilTimestampOptions): Promise<void>;
+  /**
+   * Get LocalNet-specific network utilities.
+   * These methods only work when connected to a LocalNet network and will throw
+   * an error if called on other networks.
+   *
+   * @returns The LocalNetManager instance
+   * @example
+   * ```typescript
+   * // Block warp on LocalNet
+   * await algorand.network.localNet.blockWarp(100n)
+   *
+   * // Time warp on LocalNet
+   * await algorand.network.localNet.timeWarp(BigInt(Date.now() / 1000) + 3600n)
+   * ```
+   */
+  get localNet(): LocalNetManager;
+}
+//#endregion
+export { LocalNetManager, NetworkManager, WaitUntilTimestampOptions };
+//# sourceMappingURL=network-manager.d.ts.map