@algorandfoundation/algokit-utils 10.0.0-alpha.45 → 10.0.0-alpha.47

package/kmd-account-manager.mjs

@@ -5,7 +5,6 @@ import { Config } from "./config.mjs";
 import { TransactionComposer } from "./composer.mjs";
 import { ClientManager } from "./client-manager.mjs";
 import nacl from "tweetnacl";
-
 //#region src/kmd-account-manager.ts
 /** Provides abstractions over a [KMD](https://github.com/algorand/go-algorand/blob/master/daemon/kmd/README.md) instance
 * that makes it easier to get and manage accounts using KMD. */
@@ -159,7 +158,7 @@ var KmdAccountManager = class {
 		throw new Error("Error retrieving LocalNet dispenser account; couldn't find the default account in KMD");
 	}
 };
-
 //#endregion
 export { KmdAccountManager };
+
 //# sourceMappingURL=kmd-account-manager.mjs.map

package/kmd-account-manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"kmd-account-manager.mjs","names":[],"sources":["../src/kmd-account-manager.ts"],"sourcesContent":["import { Account } from '@algorandfoundation/algokit-algod-client'\nimport { Address, getOptionalAddress } from '@algorandfoundation/algokit-common'\nimport { KmdClient } from '@algorandfoundation/algokit-kmd-client'\nimport { AddressWithTransactionSigner, generateAddressWithSigners } from '@algorandfoundation/algokit-transact'\nimport nacl from 'tweetnacl'\nimport { AlgoAmount } from './amount'\nimport { ClientManager } from './client-manager'\nimport { TransactionComposer } from './composer'\nimport { Config } from './config'\n\n/** Provides abstractions over a [KMD](https://github.com/algorand/go-algorand/blob/master/daemon/kmd/README.md) instance\n * that makes it easier to get and manage accounts using KMD. */\nexport class KmdAccountManager {\n  private _clientManager: Omit<ClientManager, 'kmd'>\n  private _kmd?: KmdClient | null\n\n  /**\n   * Create a new KMD manager.\n   * @param clientManager A ClientManager client to use for algod and kmd clients\n   */\n  constructor(clientManager: ClientManager) {\n    this._clientManager = clientManager\n    try {\n      this._kmd = clientManager.kmd\n    } catch {\n      this._kmd = undefined\n    }\n  }\n\n  async kmd(): Promise<KmdClient> {\n    if (this._kmd === undefined) {\n      if (await this._clientManager.isLocalNet()) {\n        const { kmdConfig } = ClientManager.getConfigFromEnvironmentOrLocalNet()\n        if (kmdConfig) {\n          this._kmd = ClientManager.getKmdClient(kmdConfig)\n          return this._kmd\n        }\n      }\n      this._kmd = null\n    }\n\n    if (!this._kmd) {\n      throw new Error('Attempt to use Kmd client in AlgoKit instance with no Kmd configured')\n    }\n\n    return this._kmd\n  }\n\n  /**\n   * Returns an Algorand signing account with private key loaded from the given KMD wallet (identified by name).\n   *\n   * @param walletName The name of the wallet to retrieve an account from\n   * @param predicate An optional filter to use to find the account (otherwise it will return a random account from the wallet)\n   * @param sender The optional sender address to use this signer for (aka a rekeyed account)\n   * @example Get default funded account in a LocalNet\n   *\n   * ```typescript\n   * const defaultDispenserAccount = await kmdAccountManager.getWalletAccount(\n   *   'unencrypted-default-wallet',\n   *   a => a.status !== 'Offline' && a.amount > 1_000_000_000\n   * )\n   * ```\n   * @returns The signing account (with private key loaded) or undefined if no matching wallet or account was found\n   */\n  public async getWalletAccount(\n    walletName: string,\n    predicate?: (account: Account) => boolean,\n    sender?: string | Address,\n  ): Promise<AddressWithTransactionSigner | undefined> {\n    return this.findWalletAccount(walletName, predicate, sender)\n  }\n\n  private async findWalletAccount(\n    walletName: string,\n    predicateOrAddress?: ((account: Account) => boolean) | string,\n    sender?: string | Address,\n  ): Promise<AddressWithTransactionSigner | undefined> {\n    const kmd = await this.kmd()\n    const walletsResponse = await kmd.listWallets()\n    const wallet = walletsResponse.wallets.filter((w) => w.name === walletName)\n    if (wallet.length === 0) {\n      return undefined\n    }\n    const walletId = wallet[0].id\n    const walletHandle = (await kmd.initWalletHandle({ walletId, walletPassword: '' })).walletHandleToken\n\n    let matchedAddress: Address | undefined = undefined\n    if (predicateOrAddress && typeof predicateOrAddress === 'string') {\n      matchedAddress = Address.fromString(predicateOrAddress)\n    } else {\n      const addresses = (await kmd.listKeysInWallet({ walletHandleToken: walletHandle })).addresses\n      if (addresses.length > 0) {\n        if (predicateOrAddress && typeof predicateOrAddress === 'function') {\n          for (let i = 0; i < addresses.length; i++) {\n            const account = await this._clientManager.algod.accountInformation(addresses[i])\n            if (predicateOrAddress(account)) {\n              matchedAddress = addresses[i]\n              break\n            }\n          }\n        } else {\n          matchedAddress = addresses[0]\n        }\n      }\n    }\n\n    if (!matchedAddress) {\n      return undefined\n    }\n\n    const accountKey = (await kmd.exportKey({ walletHandleToken: walletHandle, address: matchedAddress })).privateKey\n    const keys = nacl.sign.keyPair.fromSecretKey(accountKey)\n    const rawSigner = async (bytesToSign: Uint8Array): Promise<Uint8Array> => {\n      return nacl.sign.detached(bytesToSign, keys.secretKey)\n    }\n\n    return generateAddressWithSigners({\n      ed25519Pubkey: keys.publicKey,\n      sendingAddress: getOptionalAddress(sender),\n      rawEd25519Signer: rawSigner,\n    })\n  }\n\n  /**\n   * Gets an account with private key loaded from a KMD wallet of the given name, or alternatively creates one with funds in it via a KMD wallet of the given name.\n   *\n   * This is useful to get idempotent accounts from LocalNet without having to specify the private key (which will change when resetting the LocalNet).\n   *\n   * This significantly speeds up local dev time and improves experience since you can write code that *just works* first go without manual config in a fresh LocalNet.\n   *\n   * If this is used via `mnemonicAccountFromEnvironment`, then you can even use the same code that runs on production without changes for local development!\n   *\n   * @param name The name of the wallet to retrieve / create\n   * @param fundWith The number of Algo to fund the account with when it gets created, if not specified then 1000 ALGO will be funded from the dispenser account\n   *\n   * @example\n   * ```typescript\n   * // Idempotently get (if exists) or create (if it doesn't exist yet) an account by name using KMD\n   * // if creating it then fund it with 2 ALGO from the default dispenser account\n   * const newAccount = await kmdAccountManager.getOrCreateWalletAccount('account1', (2).algo())\n   * // This will return the same account as above since the name matches\n   * const existingAccount = await kmdAccountManager.getOrCreateWalletAccount('account1')\n   * ```\n   *\n   * @returns An Algorand account with private key loaded - either one that already existed in the given KMD wallet, or a new one that is funded for you\n   */\n  public async getOrCreateWalletAccount(name: string, fundWith?: AlgoAmount): Promise<AddressWithTransactionSigner> {\n    // Get an existing account from the KMD wallet\n    const existing = await this.getWalletAccount(name)\n    if (existing) {\n      return existing\n    }\n\n    const kmd = await this.kmd()\n\n    // None existed: create the KMD wallet instead\n    const walletId = (await kmd.createWallet({ walletName: name, walletPassword: '' })).wallet.id\n    const walletHandle = (await kmd.initWalletHandle({ walletId, walletPassword: '' })).walletHandleToken\n    await kmd.generateKey({ walletHandleToken: walletHandle })\n\n    // Get the account from the new KMD wallet\n    const account = (await this.getWalletAccount(name))!\n\n    Config.logger.info(\n      `LocalNet account '${name}' doesn't yet exist; created account ${account.addr} with keys stored in KMD and funding with ${\n        fundWith?.algo ?? 1000\n      } ALGO`,\n    )\n\n    // Fund the account from the dispenser\n    const dispenser = await this.getLocalNetDispenserAccount()\n    await new TransactionComposer({\n      algod: this._clientManager.algod,\n      getSigner: () => dispenser.signer,\n      getSuggestedParams: () => this._clientManager.algod.suggestedParams(),\n    })\n      .addPayment({ amount: fundWith ?? AlgoAmount.Algo(1000), receiver: account.addr, sender: dispenser.addr })\n      .send()\n\n    return account\n  }\n\n  /**\n   * Returns an Algorand account with private key loaded for the default LocalNet dispenser account (that can be used to fund other accounts).\n   * @example\n   * ```typescript\n   * const dispenser = await kmdAccountManager.getLocalNetDispenserAccount()\n   * ```\n   * @returns The default LocalNet dispenser account\n   */\n  public async getLocalNetDispenserAccount() {\n    if (!(await this._clientManager.isLocalNet())) {\n      throw new Error(\"Can't get LocalNet dispenser account from non LocalNet network\")\n    }\n    const genesisResponse = await this._clientManager.algod.genesis()\n    const dispenserAddresses = genesisResponse.alloc.filter((a) => a.comment === 'Wallet1').map((a) => a.addr)\n    if (dispenserAddresses.length > 0) {\n      const dispenser = await this.findWalletAccount('unencrypted-default-wallet', dispenserAddresses[0])\n      if (dispenser) {\n        return dispenser\n      }\n    }\n\n    throw new Error(\"Error retrieving LocalNet dispenser account; couldn't find the default account in KMD\")\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"kmd-account-manager.mjs","names":[],"sources":["../src/kmd-account-manager.ts"],"sourcesContent":["import { Account } from '@algorandfoundation/algokit-algod-client'\nimport { Address, getOptionalAddress } from '@algorandfoundation/algokit-common'\nimport { KmdClient } from '@algorandfoundation/algokit-kmd-client'\nimport { AddressWithTransactionSigner, generateAddressWithSigners } from '@algorandfoundation/algokit-transact'\nimport nacl from 'tweetnacl'\nimport { AlgoAmount } from './amount'\nimport { ClientManager } from './client-manager'\nimport { TransactionComposer } from './composer'\nimport { Config } from './config'\n\n/** Provides abstractions over a [KMD](https://github.com/algorand/go-algorand/blob/master/daemon/kmd/README.md) instance\n * that makes it easier to get and manage accounts using KMD. */\nexport class KmdAccountManager {\n  private _clientManager: Omit<ClientManager, 'kmd'>\n  private _kmd?: KmdClient | null\n\n  /**\n   * Create a new KMD manager.\n   * @param clientManager A ClientManager client to use for algod and kmd clients\n   */\n  constructor(clientManager: ClientManager) {\n    this._clientManager = clientManager\n    try {\n      this._kmd = clientManager.kmd\n    } catch {\n      this._kmd = undefined\n    }\n  }\n\n  async kmd(): Promise<KmdClient> {\n    if (this._kmd === undefined) {\n      if (await this._clientManager.isLocalNet()) {\n        const { kmdConfig } = ClientManager.getConfigFromEnvironmentOrLocalNet()\n        if (kmdConfig) {\n          this._kmd = ClientManager.getKmdClient(kmdConfig)\n          return this._kmd\n        }\n      }\n      this._kmd = null\n    }\n\n    if (!this._kmd) {\n      throw new Error('Attempt to use Kmd client in AlgoKit instance with no Kmd configured')\n    }\n\n    return this._kmd\n  }\n\n  /**\n   * Returns an Algorand signing account with private key loaded from the given KMD wallet (identified by name).\n   *\n   * @param walletName The name of the wallet to retrieve an account from\n   * @param predicate An optional filter to use to find the account (otherwise it will return a random account from the wallet)\n   * @param sender The optional sender address to use this signer for (aka a rekeyed account)\n   * @example Get default funded account in a LocalNet\n   *\n   * ```typescript\n   * const defaultDispenserAccount = await kmdAccountManager.getWalletAccount(\n   *   'unencrypted-default-wallet',\n   *   a => a.status !== 'Offline' && a.amount > 1_000_000_000\n   * )\n   * ```\n   * @returns The signing account (with private key loaded) or undefined if no matching wallet or account was found\n   */\n  public async getWalletAccount(\n    walletName: string,\n    predicate?: (account: Account) => boolean,\n    sender?: string | Address,\n  ): Promise<AddressWithTransactionSigner | undefined> {\n    return this.findWalletAccount(walletName, predicate, sender)\n  }\n\n  private async findWalletAccount(\n    walletName: string,\n    predicateOrAddress?: ((account: Account) => boolean) | string,\n    sender?: string | Address,\n  ): Promise<AddressWithTransactionSigner | undefined> {\n    const kmd = await this.kmd()\n    const walletsResponse = await kmd.listWallets()\n    const wallet = walletsResponse.wallets.filter((w) => w.name === walletName)\n    if (wallet.length === 0) {\n      return undefined\n    }\n    const walletId = wallet[0].id\n    const walletHandle = (await kmd.initWalletHandle({ walletId, walletPassword: '' })).walletHandleToken\n\n    let matchedAddress: Address | undefined = undefined\n    if (predicateOrAddress && typeof predicateOrAddress === 'string') {\n      matchedAddress = Address.fromString(predicateOrAddress)\n    } else {\n      const addresses = (await kmd.listKeysInWallet({ walletHandleToken: walletHandle })).addresses\n      if (addresses.length > 0) {\n        if (predicateOrAddress && typeof predicateOrAddress === 'function') {\n          for (let i = 0; i < addresses.length; i++) {\n            const account = await this._clientManager.algod.accountInformation(addresses[i])\n            if (predicateOrAddress(account)) {\n              matchedAddress = addresses[i]\n              break\n            }\n          }\n        } else {\n          matchedAddress = addresses[0]\n        }\n      }\n    }\n\n    if (!matchedAddress) {\n      return undefined\n    }\n\n    const accountKey = (await kmd.exportKey({ walletHandleToken: walletHandle, address: matchedAddress })).privateKey\n    const keys = nacl.sign.keyPair.fromSecretKey(accountKey)\n    const rawSigner = async (bytesToSign: Uint8Array): Promise<Uint8Array> => {\n      return nacl.sign.detached(bytesToSign, keys.secretKey)\n    }\n\n    return generateAddressWithSigners({\n      ed25519Pubkey: keys.publicKey,\n      sendingAddress: getOptionalAddress(sender),\n      rawEd25519Signer: rawSigner,\n    })\n  }\n\n  /**\n   * Gets an account with private key loaded from a KMD wallet of the given name, or alternatively creates one with funds in it via a KMD wallet of the given name.\n   *\n   * This is useful to get idempotent accounts from LocalNet without having to specify the private key (which will change when resetting the LocalNet).\n   *\n   * This significantly speeds up local dev time and improves experience since you can write code that *just works* first go without manual config in a fresh LocalNet.\n   *\n   * If this is used via `mnemonicAccountFromEnvironment`, then you can even use the same code that runs on production without changes for local development!\n   *\n   * @param name The name of the wallet to retrieve / create\n   * @param fundWith The number of Algo to fund the account with when it gets created, if not specified then 1000 ALGO will be funded from the dispenser account\n   *\n   * @example\n   * ```typescript\n   * // Idempotently get (if exists) or create (if it doesn't exist yet) an account by name using KMD\n   * // if creating it then fund it with 2 ALGO from the default dispenser account\n   * const newAccount = await kmdAccountManager.getOrCreateWalletAccount('account1', (2).algo())\n   * // This will return the same account as above since the name matches\n   * const existingAccount = await kmdAccountManager.getOrCreateWalletAccount('account1')\n   * ```\n   *\n   * @returns An Algorand account with private key loaded - either one that already existed in the given KMD wallet, or a new one that is funded for you\n   */\n  public async getOrCreateWalletAccount(name: string, fundWith?: AlgoAmount): Promise<AddressWithTransactionSigner> {\n    // Get an existing account from the KMD wallet\n    const existing = await this.getWalletAccount(name)\n    if (existing) {\n      return existing\n    }\n\n    const kmd = await this.kmd()\n\n    // None existed: create the KMD wallet instead\n    const walletId = (await kmd.createWallet({ walletName: name, walletPassword: '' })).wallet.id\n    const walletHandle = (await kmd.initWalletHandle({ walletId, walletPassword: '' })).walletHandleToken\n    await kmd.generateKey({ walletHandleToken: walletHandle })\n\n    // Get the account from the new KMD wallet\n    const account = (await this.getWalletAccount(name))!\n\n    Config.logger.info(\n      `LocalNet account '${name}' doesn't yet exist; created account ${account.addr} with keys stored in KMD and funding with ${\n        fundWith?.algo ?? 1000\n      } ALGO`,\n    )\n\n    // Fund the account from the dispenser\n    const dispenser = await this.getLocalNetDispenserAccount()\n    await new TransactionComposer({\n      algod: this._clientManager.algod,\n      getSigner: () => dispenser.signer,\n      getSuggestedParams: () => this._clientManager.algod.suggestedParams(),\n    })\n      .addPayment({ amount: fundWith ?? AlgoAmount.Algo(1000), receiver: account.addr, sender: dispenser.addr })\n      .send()\n\n    return account\n  }\n\n  /**\n   * Returns an Algorand account with private key loaded for the default LocalNet dispenser account (that can be used to fund other accounts).\n   * @example\n   * ```typescript\n   * const dispenser = await kmdAccountManager.getLocalNetDispenserAccount()\n   * ```\n   * @returns The default LocalNet dispenser account\n   */\n  public async getLocalNetDispenserAccount() {\n    if (!(await this._clientManager.isLocalNet())) {\n      throw new Error(\"Can't get LocalNet dispenser account from non LocalNet network\")\n    }\n    const genesisResponse = await this._clientManager.algod.genesis()\n    const dispenserAddresses = genesisResponse.alloc.filter((a) => a.comment === 'Wallet1').map((a) => a.addr)\n    if (dispenserAddresses.length > 0) {\n      const dispenser = await this.findWalletAccount('unencrypted-default-wallet', dispenserAddresses[0])\n      if (dispenser) {\n        return dispenser\n      }\n    }\n\n    throw new Error(\"Error retrieving LocalNet dispenser account; couldn't find the default account in KMD\")\n  }\n}\n"],"mappings":"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"}

package/kmd-client/index.js

@@ -1,13 +1,12 @@
-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_api_service = require('../packages/kmd_client/src/apis/api-service.js');
-const require_client = require('../packages/kmd_client/src/client.js');
-
+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_api_service = require("../packages/kmd_client/src/apis/api-service.js");
+const require_client = require("../packages/kmd_client/src/client.js");
 exports.ApiError = require_api_error.ApiError;
 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.inputValueAsString = require_base_http_request.inputValueAsString;
+exports.inputValueAsString = require_base_http_request.inputValueAsString;

package/kmd-client/index.mjs

@@ -3,5 +3,4 @@ import { ApiError } from "../packages/kmd_client/src/core/api-error.mjs";
 import { FetchHttpRequest } from "../packages/kmd_client/src/core/fetch-http-request.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, inputValueAsString };
+export { ApiError, BaseHttpRequest, FetchHttpRequest, KmdApi, KmdClient, inputValueAsString };

package/lifecycle-events.d.ts

@@ -3,7 +3,7 @@ import { AVMTracesEventData, TealSourcesDebugEventData } from "./debugging.js";
 //#region src/lifecycle-events.d.ts
 declare enum EventType {
   TxnGroupSimulated = "TxnGroupSimulated",
-  AppCompiled = "AppCompiled",
+  AppCompiled = "AppCompiled"
 }
 type EventDataMap = {
   [EventType.TxnGroupSimulated]: AVMTracesEventData;

package/lifecycle-events.js

@@ -1,12 +1,11 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
+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

@@ -1 +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"}
+{"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,YAAL,yBAAA,WAAA;AACL,WAAA,uBAAA;AACA,WAAA,iBAAA;;KACD"}

package/lifecycle-events.mjs

@@ -4,7 +4,7 @@ let EventType = /* @__PURE__ */ function(EventType) {
 	EventType["AppCompiled"] = "AppCompiled";
 	return EventType;
 }({});
-
 //#endregion
 export { EventType };
+
 //# sourceMappingURL=lifecycle-events.mjs.map

package/lifecycle-events.mjs.map

@@ -1 +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"}
+{"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,YAAL,yBAAA,WAAA;AACL,WAAA,uBAAA;AACA,WAAA,iBAAA;;KACD"}

package/logging.js

@@ -1,5 +1,4 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/logging.ts
 /** A logger implementation that writes to console */
 const consoleLogger = {
@@ -38,11 +37,11 @@ const nullLogger = {
 	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

@@ -1 +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"}
+{"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

@@ -36,7 +36,7 @@ const nullLogger = {
 	verbose: function(message, ...optionalParams) {},
 	debug: function(message, ...optionalParams) {}
 };
-
 //#endregion
 export { consoleLogger, infoConsoleLogger, nullLogger, verboseConsoleLogger, warningConsoleLogger };
+
 //# sourceMappingURL=logging.mjs.map

package/logic-error.js

@@ -1,5 +1,4 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
+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]+)/;
@@ -49,7 +48,7 @@ var LogicError = class extends Error {
 		}
 	}
 };
-
 //#endregion
 exports.LogicError = LogicError;
+
 //# sourceMappingURL=logic-error.js.map

package/logic-error.js.map

@@ -1 +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"}
+{"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,KAAA;AAE5C,SAAO;GACL,MAAM,IAAI;GACV,KAAK,IAAI;GACT,MAAM;GACN,IAAI,SAAS,WAAW,MAAM,IAAI,MAAM,IAAI;GAC5C,QAAQ,MAAM;GACf;;CAGH;CACA;CACA,QAAe;CACf,YAAmB;CACnB;;;;;;;CAQA,YAAY,cAAiC,SAAmB,cAAkD;AAChH,SAAO;AACP,OAAK,MAAM;AACX,OAAK,UAAU;EAEf,MAAM,OAAO,aAAa,aAAa,GAAG;AAC1C,OAAK,YAAY,SAAS,KAAA,IAAY,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

@@ -47,7 +47,7 @@ var LogicError = class extends Error {
 		}
 	}
 };
-
 //#endregion
 export { LogicError };
+
 //# sourceMappingURL=logic-error.mjs.map

package/logic-error.mjs.map

@@ -1 +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"}
+{"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,KAAA;AAE5C,SAAO;GACL,MAAM,IAAI;GACV,KAAK,IAAI;GACT,MAAM;GACN,IAAI,SAAS,WAAW,MAAM,IAAI,MAAM,IAAI;GAC5C,QAAQ,MAAM;GACf;;CAGH;CACA;CACA,QAAe;CACf,YAAmB;CACnB;;;;;;;CAQA,YAAY,cAAiC,SAAmB,cAAkD;AAChH,SAAO;AACP,OAAK,MAAM;AACX,OAAK,UAAU;EAEf,MAAM,OAAO,aAAa,aAAa,GAAG;AAC1C,OAAK,YAAY,SAAS,KAAA,IAAY,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.js

@@ -1,5 +1,4 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
+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.
@@ -9,7 +8,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 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

@@ -1 +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"}
+{"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

@@ -7,7 +7,7 @@
 function genesisIdIsLocalNet(genesisId) {
 	return genesisId === "devnet-v1" || genesisId === "sandnet-v1" || genesisId === "dockernet-v1";
 }
-
 //#endregion
 export { genesisIdIsLocalNet };
+
 //# sourceMappingURL=network-client.mjs.map

package/network-manager.js

@@ -1,5 +1,4 @@
-const require_amount = require('./amount.js');
-
+const require_amount = require("./amount.js");
 //#region src/network-manager.ts
 /**
 * Manager for LocalNet-specific network operations.
@@ -184,8 +183,8 @@ var NetworkManager = class {
 		return this._localNet;
 	}
 };
-
 //#endregion
 exports.LocalNetManager = LocalNetManager;
 exports.NetworkManager = NetworkManager;
+
 //# sourceMappingURL=network-manager.js.map

package/network-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"network-manager.js","names":["AlgoAmount"],"sources":["../src/network-manager.ts"],"sourcesContent":["import { AlgodClient } from '@algorandfoundation/algokit-algod-client'\nimport type { AlgorandClient } from './algorand-client'\nimport { AlgoAmount } from './amount'\n\n/** Options for waiting until a specific timestamp is reached on the blockchain. */\nexport interface WaitUntilTimestampOptions {\n  /** Estimated block time in seconds, used to calculate rounds to wait. Should be slightly lower than average to undershoot. Defaults to 2.7. */\n  blockTimeSeconds?: number\n  /** Polling interval in milliseconds when close to target. Defaults to 1000. */\n  pollingIntervalMs?: number\n  /** Timeout in milliseconds for the polling loop. Defaults to 5000. */\n  pollingTimeoutMs?: number\n}\n\n/**\n * Manager for LocalNet-specific network operations.\n * These methods only work on LocalNet and will throw an error if called on other networks.\n */\nexport class LocalNetManager {\n  private _algod: AlgodClient\n  private _networkManager: NetworkManager\n  private _algorand: AlgorandClient\n\n  /** @param algod The algod client to use for LocalNet operations */\n  constructor(algod: AlgodClient, networkManager: NetworkManager, algorand: AlgorandClient) {\n    this._algod = algod\n    this._networkManager = networkManager\n    this._algorand = algorand\n  }\n\n  private async _ensureLocalNet(): Promise<void> {\n    if (!(await this._algorand.client.isLocalNet())) {\n      throw new Error('LocalNet methods are only available when connected to a LocalNet network')\n    }\n  }\n\n  /**\n   * Generates a single block by sending a zero-amount payment transaction from the dispenser to itself.\n   * This triggers block creation in LocalNet dev mode.\n   */\n  private async _generateBlock(): Promise<void> {\n    const algorand = this._algorand\n    const dispenser = await algorand.account.localNetDispenser()\n    await algorand.send.payment({\n      sender: dispenser,\n      receiver: dispenser,\n      amount: AlgoAmount.MicroAlgo(0),\n      note: 'algokit-utils:block-generation',\n    })\n  }\n\n  /**\n   * Advances the blockchain by generating blocks until the target round is reached.\n   * @param targetRound The round number to advance to\n   * @throws Error if not connected to LocalNet\n   * @example\n   * ```typescript\n   * // Advance LocalNet to round 100\n   * await algorand.network.localNet.blockWarp(100n)\n   * ```\n   */\n  async blockWarp(targetRound: bigint): Promise<void> {\n    await this._ensureLocalNet()\n\n    // Generate blocks until we reach the target round\n    while ((await this._networkManager.getLastRound()) < targetRound) {\n      await this._generateBlock()\n    }\n  }\n\n  /**\n   * Advances the blockchain timestamp to a target Unix timestamp.\n   * @param targetTimestamp The target Unix timestamp in seconds\n   * @throws Error if not connected to LocalNet\n   * @example\n   * ```typescript\n   * // Advance LocalNet time by 1 hour\n   * const oneHourFromNow = BigInt(Math.floor(Date.now() / 1000)) + 3600n\n   * await algorand.network.localNet.timeWarp(oneHourFromNow)\n   * ```\n   */\n  async timeWarp(targetTimestamp: bigint): Promise<void> {\n    await this._ensureLocalNet()\n\n    const currentTimestamp = await this._networkManager.getLatestTimestamp()\n    const offsetSeconds = Number(targetTimestamp - currentTimestamp)\n\n    // Set the timestamp offset so the next block will have the target timestamp\n    await this._algod.setBlockTimeStampOffset(offsetSeconds)\n    // Generate a block with the new timestamp\n    await this._generateBlock()\n    // Reset the offset to use real clock for subsequent blocks\n    await this._algod.setBlockTimeStampOffset(0)\n  }\n}\n\n/**\n * Manager for network-related operations.\n * Provides utilities for querying blockchain state and waiting for specific conditions.\n */\nexport class NetworkManager {\n  private _algod: AlgodClient\n  private _algorand: AlgorandClient\n  private _localNet: LocalNetManager | undefined\n\n  /**\n   * Create a new NetworkManager instance.\n   * @param algod The algod client to use for network operations\n   * @param algorand The AlgorandClient instance (for LocalNet operations)\n   */\n  constructor(algod: AlgodClient, algorand: AlgorandClient) {\n    this._algod = algod\n    this._algorand = algorand\n  }\n\n  /**\n   * Get the last committed round number.\n   * @returns The last round number\n   * @example\n   * ```typescript\n   * const lastRound = await algorand.network.getLastRound()\n   * console.log(`Current round: ${lastRound}`)\n   * ```\n   */\n  async getLastRound(): Promise<bigint> {\n    const status = await this._algod.status()\n    return status.lastRound\n  }\n\n  /**\n   * Get the Unix timestamp of the latest block.\n   *\n   * Note: This method makes two sequential API calls (status then block fetch).\n   * The round may advance between these calls, so the returned timestamp may not\n   * be from the actual latest timestamp.\n   *\n   * @returns The UNIX timestamp of the last round\n   * @example\n   * ```typescript\n   * const timestamp = await algorand.network.getLatestTimestamp()\n   * console.log(`Latest block time: ${new Date(Number(timestamp) * 1000)}`)\n   * ```\n   */\n  async getLatestTimestamp(): Promise<bigint> {\n    const status = await this._algod.status()\n    const block = await this._algod.block(status.lastRound)\n    return block.block.header.timestamp\n  }\n\n  /**\n   * Wait until a specific round is reached.\n   *\n   * @param targetRound The round number to wait for\n   * @throws Error if timeout is reached before the target round\n   * @example\n   * ```typescript\n   * // Wait for round 1000\n   * await algorand.network.waitUntilRound(1000n)\n   *\n   * // Wait with a 30 second timeout\n   * await algorand.network.waitUntilRound(1000n, 30000)\n   * ```\n   */\n  async waitUntilRound(targetRound: bigint): Promise<void> {\n    let status = await this._algod.status()\n\n    // statusAfterBlock has 1 min timeout, loop if target not reached\n    while (status.lastRound < targetRound) {\n      status = await this._algod.statusAfterBlock(status.lastRound)\n    }\n  }\n\n  /**\n   * Wait until a specific Unix timestamp is reached on the blockchain.\n   *\n   * @param targetTimestamp The target Unix timestamp in seconds\n   * @param options Optional parameters for waiting\n   * @example\n   * ```typescript\n   * // Wait until a specific time\n   * const futureTime = BigInt(Math.floor(Date.now() / 1000)) + 60n // 1 minute from now\n   * await algorand.network.waitUntilTimestamp(futureTime)\n   *\n   * // Wait with custom timing parameters\n   * await algorand.network.waitUntilTimestamp(futureTime, { blockTimeSeconds: 3.0, pollingIntervalMs: 500 })\n   * ```\n   */\n  async waitUntilTimestamp(targetTimestamp: bigint, options?: WaitUntilTimestampOptions): Promise<void> {\n    // Note: this method reduces the number of calls to algod\n    //  by estimating the number of rounds to wait first\n    //  then wait for the target round to be committed\n    //  then poll every second for the right timestamp\n\n    // blockTimeSeconds should be slightly lower than the average block time so that it will undershoot\n    const blockTimeSeconds = options?.blockTimeSeconds ?? 2.7\n    const pollingIntervalMs = options?.pollingIntervalMs ?? 1000\n    const pollingTimeoutMs = options?.pollingTimeoutMs ?? 5000\n\n    const currentStatus = await this._algod.status()\n    const currentRound = currentStatus.lastRound\n    const currentBlock = await this._algod.block(currentRound)\n    const currentBlockTimestamp = currentBlock.block.header.timestamp\n\n    if (currentBlockTimestamp >= targetTimestamp) return\n\n    const secondsToWait = Number(targetTimestamp - currentBlockTimestamp)\n    const roundsToWait = Math.floor(secondsToWait / blockTimeSeconds)\n\n    // Wait for estimated round\n    if (roundsToWait > 1) {\n      await this.waitUntilRound(currentRound + BigInt(roundsToWait))\n    }\n\n    const pollingStartTime = Date.now()\n    while (true) {\n      const latestTimeStamp = await this.getLatestTimestamp()\n      if (latestTimeStamp > targetTimestamp) {\n        return\n      }\n\n      if (Date.now() - pollingStartTime >= pollingTimeoutMs) {\n        throw new Error(`Timeout waiting for timestamp ${targetTimestamp} (current: ${latestTimeStamp})`)\n      }\n\n      await new Promise((resolve) => setTimeout(resolve, pollingIntervalMs))\n    }\n  }\n\n  /**\n   * Get LocalNet-specific network utilities.\n   * These methods only work when connected to a LocalNet network and will throw\n   * an error if called on other networks.\n   *\n   * @returns The LocalNetManager instance\n   * @example\n   * ```typescript\n   * // Block warp on LocalNet\n   * await algorand.network.localNet.blockWarp(100n)\n   *\n   * // Time warp on LocalNet\n   * await algorand.network.localNet.timeWarp(BigInt(Date.now() / 1000) + 3600n)\n   * ```\n   */\n  get localNet(): LocalNetManager {\n    if (!this._localNet) {\n      this._localNet = new LocalNetManager(this._algod, this, this._algorand)\n    }\n    return this._localNet\n  }\n}\n"],"mappings":";;;;;;;AAkBA,IAAa,kBAAb,MAA6B;CAC3B,AAAQ;CACR,AAAQ;CACR,AAAQ;;CAGR,YAAY,OAAoB,gBAAgC,UAA0B;AACxF,OAAK,SAAS;AACd,OAAK,kBAAkB;AACvB,OAAK,YAAY;;CAGnB,MAAc,kBAAiC;AAC7C,MAAI,CAAE,MAAM,KAAK,UAAU,OAAO,YAAY,CAC5C,OAAM,IAAI,MAAM,2EAA2E;;;;;;CAQ/F,MAAc,iBAAgC;EAC5C,MAAM,WAAW,KAAK;EACtB,MAAM,YAAY,MAAM,SAAS,QAAQ,mBAAmB;AAC5D,QAAM,SAAS,KAAK,QAAQ;GAC1B,QAAQ;GACR,UAAU;GACV,QAAQA,0BAAW,UAAU,EAAE;GAC/B,MAAM;GACP,CAAC;;;;;;;;;;;;CAaJ,MAAM,UAAU,aAAoC;AAClD,QAAM,KAAK,iBAAiB;AAG5B,SAAQ,MAAM,KAAK,gBAAgB,cAAc,GAAI,YACnD,OAAM,KAAK,gBAAgB;;;;;;;;;;;;;CAe/B,MAAM,SAAS,iBAAwC;AACrD,QAAM,KAAK,iBAAiB;EAE5B,MAAM,mBAAmB,MAAM,KAAK,gBAAgB,oBAAoB;EACxE,MAAM,gBAAgB,OAAO,kBAAkB,iBAAiB;AAGhE,QAAM,KAAK,OAAO,wBAAwB,cAAc;AAExD,QAAM,KAAK,gBAAgB;AAE3B,QAAM,KAAK,OAAO,wBAAwB,EAAE;;;;;;;AAQhD,IAAa,iBAAb,MAA4B;CAC1B,AAAQ;CACR,AAAQ;CACR,AAAQ;;;;;;CAOR,YAAY,OAAoB,UAA0B;AACxD,OAAK,SAAS;AACd,OAAK,YAAY;;;;;;;;;;;CAYnB,MAAM,eAAgC;AAEpC,UADe,MAAM,KAAK,OAAO,QAAQ,EAC3B;;;;;;;;;;;;;;;;CAiBhB,MAAM,qBAAsC;EAC1C,MAAM,SAAS,MAAM,KAAK,OAAO,QAAQ;AAEzC,UADc,MAAM,KAAK,OAAO,MAAM,OAAO,UAAU,EAC1C,MAAM,OAAO;;;;;;;;;;;;;;;;CAiB5B,MAAM,eAAe,aAAoC;EACvD,IAAI,SAAS,MAAM,KAAK,OAAO,QAAQ;AAGvC,SAAO,OAAO,YAAY,YACxB,UAAS,MAAM,KAAK,OAAO,iBAAiB,OAAO,UAAU;;;;;;;;;;;;;;;;;CAmBjE,MAAM,mBAAmB,iBAAyB,SAAoD;EAOpG,MAAM,mBAAmB,SAAS,oBAAoB;EACtD,MAAM,oBAAoB,SAAS,qBAAqB;EACxD,MAAM,mBAAmB,SAAS,oBAAoB;EAGtD,MAAM,gBADgB,MAAM,KAAK,OAAO,QAAQ,EACb;EAEnC,MAAM,yBADe,MAAM,KAAK,OAAO,MAAM,aAAa,EACf,MAAM,OAAO;AAExD,MAAI,yBAAyB,gBAAiB;EAE9C,MAAM,gBAAgB,OAAO,kBAAkB,sBAAsB;EACrE,MAAM,eAAe,KAAK,MAAM,gBAAgB,iBAAiB;AAGjE,MAAI,eAAe,EACjB,OAAM,KAAK,eAAe,eAAe,OAAO,aAAa,CAAC;EAGhE,MAAM,mBAAmB,KAAK,KAAK;AACnC,SAAO,MAAM;GACX,MAAM,kBAAkB,MAAM,KAAK,oBAAoB;AACvD,OAAI,kBAAkB,gBACpB;AAGF,OAAI,KAAK,KAAK,GAAG,oBAAoB,iBACnC,OAAM,IAAI,MAAM,iCAAiC,gBAAgB,aAAa,gBAAgB,GAAG;AAGnG,SAAM,IAAI,SAAS,YAAY,WAAW,SAAS,kBAAkB,CAAC;;;;;;;;;;;;;;;;;;CAmB1E,IAAI,WAA4B;AAC9B,MAAI,CAAC,KAAK,UACR,MAAK,YAAY,IAAI,gBAAgB,KAAK,QAAQ,MAAM,KAAK,UAAU;AAEzE,SAAO,KAAK"}
+{"version":3,"file":"network-manager.js","names":["AlgoAmount"],"sources":["../src/network-manager.ts"],"sourcesContent":["import { AlgodClient } from '@algorandfoundation/algokit-algod-client'\nimport type { AlgorandClient } from './algorand-client'\nimport { AlgoAmount } from './amount'\n\n/** Options for waiting until a specific timestamp is reached on the blockchain. */\nexport interface WaitUntilTimestampOptions {\n  /** Estimated block time in seconds, used to calculate rounds to wait. Should be slightly lower than average to undershoot. Defaults to 2.7. */\n  blockTimeSeconds?: number\n  /** Polling interval in milliseconds when close to target. Defaults to 1000. */\n  pollingIntervalMs?: number\n  /** Timeout in milliseconds for the polling loop. Defaults to 5000. */\n  pollingTimeoutMs?: number\n}\n\n/**\n * Manager for LocalNet-specific network operations.\n * These methods only work on LocalNet and will throw an error if called on other networks.\n */\nexport class LocalNetManager {\n  private _algod: AlgodClient\n  private _networkManager: NetworkManager\n  private _algorand: AlgorandClient\n\n  /** @param algod The algod client to use for LocalNet operations */\n  constructor(algod: AlgodClient, networkManager: NetworkManager, algorand: AlgorandClient) {\n    this._algod = algod\n    this._networkManager = networkManager\n    this._algorand = algorand\n  }\n\n  private async _ensureLocalNet(): Promise<void> {\n    if (!(await this._algorand.client.isLocalNet())) {\n      throw new Error('LocalNet methods are only available when connected to a LocalNet network')\n    }\n  }\n\n  /**\n   * Generates a single block by sending a zero-amount payment transaction from the dispenser to itself.\n   * This triggers block creation in LocalNet dev mode.\n   */\n  private async _generateBlock(): Promise<void> {\n    const algorand = this._algorand\n    const dispenser = await algorand.account.localNetDispenser()\n    await algorand.send.payment({\n      sender: dispenser,\n      receiver: dispenser,\n      amount: AlgoAmount.MicroAlgo(0),\n      note: 'algokit-utils:block-generation',\n    })\n  }\n\n  /**\n   * Advances the blockchain by generating blocks until the target round is reached.\n   * @param targetRound The round number to advance to\n   * @throws Error if not connected to LocalNet\n   * @example\n   * ```typescript\n   * // Advance LocalNet to round 100\n   * await algorand.network.localNet.blockWarp(100n)\n   * ```\n   */\n  async blockWarp(targetRound: bigint): Promise<void> {\n    await this._ensureLocalNet()\n\n    // Generate blocks until we reach the target round\n    while ((await this._networkManager.getLastRound()) < targetRound) {\n      await this._generateBlock()\n    }\n  }\n\n  /**\n   * Advances the blockchain timestamp to a target Unix timestamp.\n   * @param targetTimestamp The target Unix timestamp in seconds\n   * @throws Error if not connected to LocalNet\n   * @example\n   * ```typescript\n   * // Advance LocalNet time by 1 hour\n   * const oneHourFromNow = BigInt(Math.floor(Date.now() / 1000)) + 3600n\n   * await algorand.network.localNet.timeWarp(oneHourFromNow)\n   * ```\n   */\n  async timeWarp(targetTimestamp: bigint): Promise<void> {\n    await this._ensureLocalNet()\n\n    const currentTimestamp = await this._networkManager.getLatestTimestamp()\n    const offsetSeconds = Number(targetTimestamp - currentTimestamp)\n\n    // Set the timestamp offset so the next block will have the target timestamp\n    await this._algod.setBlockTimeStampOffset(offsetSeconds)\n    // Generate a block with the new timestamp\n    await this._generateBlock()\n    // Reset the offset to use real clock for subsequent blocks\n    await this._algod.setBlockTimeStampOffset(0)\n  }\n}\n\n/**\n * Manager for network-related operations.\n * Provides utilities for querying blockchain state and waiting for specific conditions.\n */\nexport class NetworkManager {\n  private _algod: AlgodClient\n  private _algorand: AlgorandClient\n  private _localNet: LocalNetManager | undefined\n\n  /**\n   * Create a new NetworkManager instance.\n   * @param algod The algod client to use for network operations\n   * @param algorand The AlgorandClient instance (for LocalNet operations)\n   */\n  constructor(algod: AlgodClient, algorand: AlgorandClient) {\n    this._algod = algod\n    this._algorand = algorand\n  }\n\n  /**\n   * Get the last committed round number.\n   * @returns The last round number\n   * @example\n   * ```typescript\n   * const lastRound = await algorand.network.getLastRound()\n   * console.log(`Current round: ${lastRound}`)\n   * ```\n   */\n  async getLastRound(): Promise<bigint> {\n    const status = await this._algod.status()\n    return status.lastRound\n  }\n\n  /**\n   * Get the Unix timestamp of the latest block.\n   *\n   * Note: This method makes two sequential API calls (status then block fetch).\n   * The round may advance between these calls, so the returned timestamp may not\n   * be from the actual latest timestamp.\n   *\n   * @returns The UNIX timestamp of the last round\n   * @example\n   * ```typescript\n   * const timestamp = await algorand.network.getLatestTimestamp()\n   * console.log(`Latest block time: ${new Date(Number(timestamp) * 1000)}`)\n   * ```\n   */\n  async getLatestTimestamp(): Promise<bigint> {\n    const status = await this._algod.status()\n    const block = await this._algod.block(status.lastRound)\n    return block.block.header.timestamp\n  }\n\n  /**\n   * Wait until a specific round is reached.\n   *\n   * @param targetRound The round number to wait for\n   * @throws Error if timeout is reached before the target round\n   * @example\n   * ```typescript\n   * // Wait for round 1000\n   * await algorand.network.waitUntilRound(1000n)\n   *\n   * // Wait with a 30 second timeout\n   * await algorand.network.waitUntilRound(1000n, 30000)\n   * ```\n   */\n  async waitUntilRound(targetRound: bigint): Promise<void> {\n    let status = await this._algod.status()\n\n    // statusAfterBlock has 1 min timeout, loop if target not reached\n    while (status.lastRound < targetRound) {\n      status = await this._algod.statusAfterBlock(status.lastRound)\n    }\n  }\n\n  /**\n   * Wait until a specific Unix timestamp is reached on the blockchain.\n   *\n   * @param targetTimestamp The target Unix timestamp in seconds\n   * @param options Optional parameters for waiting\n   * @example\n   * ```typescript\n   * // Wait until a specific time\n   * const futureTime = BigInt(Math.floor(Date.now() / 1000)) + 60n // 1 minute from now\n   * await algorand.network.waitUntilTimestamp(futureTime)\n   *\n   * // Wait with custom timing parameters\n   * await algorand.network.waitUntilTimestamp(futureTime, { blockTimeSeconds: 3.0, pollingIntervalMs: 500 })\n   * ```\n   */\n  async waitUntilTimestamp(targetTimestamp: bigint, options?: WaitUntilTimestampOptions): Promise<void> {\n    // Note: this method reduces the number of calls to algod\n    //  by estimating the number of rounds to wait first\n    //  then wait for the target round to be committed\n    //  then poll every second for the right timestamp\n\n    // blockTimeSeconds should be slightly lower than the average block time so that it will undershoot\n    const blockTimeSeconds = options?.blockTimeSeconds ?? 2.7\n    const pollingIntervalMs = options?.pollingIntervalMs ?? 1000\n    const pollingTimeoutMs = options?.pollingTimeoutMs ?? 5000\n\n    const currentStatus = await this._algod.status()\n    const currentRound = currentStatus.lastRound\n    const currentBlock = await this._algod.block(currentRound)\n    const currentBlockTimestamp = currentBlock.block.header.timestamp\n\n    if (currentBlockTimestamp >= targetTimestamp) return\n\n    const secondsToWait = Number(targetTimestamp - currentBlockTimestamp)\n    const roundsToWait = Math.floor(secondsToWait / blockTimeSeconds)\n\n    // Wait for estimated round\n    if (roundsToWait > 1) {\n      await this.waitUntilRound(currentRound + BigInt(roundsToWait))\n    }\n\n    const pollingStartTime = Date.now()\n    while (true) {\n      const latestTimeStamp = await this.getLatestTimestamp()\n      if (latestTimeStamp > targetTimestamp) {\n        return\n      }\n\n      if (Date.now() - pollingStartTime >= pollingTimeoutMs) {\n        throw new Error(`Timeout waiting for timestamp ${targetTimestamp} (current: ${latestTimeStamp})`)\n      }\n\n      await new Promise((resolve) => setTimeout(resolve, pollingIntervalMs))\n    }\n  }\n\n  /**\n   * Get LocalNet-specific network utilities.\n   * These methods only work when connected to a LocalNet network and will throw\n   * an error if called on other networks.\n   *\n   * @returns The LocalNetManager instance\n   * @example\n   * ```typescript\n   * // Block warp on LocalNet\n   * await algorand.network.localNet.blockWarp(100n)\n   *\n   * // Time warp on LocalNet\n   * await algorand.network.localNet.timeWarp(BigInt(Date.now() / 1000) + 3600n)\n   * ```\n   */\n  get localNet(): LocalNetManager {\n    if (!this._localNet) {\n      this._localNet = new LocalNetManager(this._algod, this, this._algorand)\n    }\n    return this._localNet\n  }\n}\n"],"mappings":";;;;;;AAkBA,IAAa,kBAAb,MAA6B;CAC3B;CACA;CACA;;CAGA,YAAY,OAAoB,gBAAgC,UAA0B;AACxF,OAAK,SAAS;AACd,OAAK,kBAAkB;AACvB,OAAK,YAAY;;CAGnB,MAAc,kBAAiC;AAC7C,MAAI,CAAE,MAAM,KAAK,UAAU,OAAO,YAAY,CAC5C,OAAM,IAAI,MAAM,2EAA2E;;;;;;CAQ/F,MAAc,iBAAgC;EAC5C,MAAM,WAAW,KAAK;EACtB,MAAM,YAAY,MAAM,SAAS,QAAQ,mBAAmB;AAC5D,QAAM,SAAS,KAAK,QAAQ;GAC1B,QAAQ;GACR,UAAU;GACV,QAAQA,eAAAA,WAAW,UAAU,EAAE;GAC/B,MAAM;GACP,CAAC;;;;;;;;;;;;CAaJ,MAAM,UAAU,aAAoC;AAClD,QAAM,KAAK,iBAAiB;AAG5B,SAAQ,MAAM,KAAK,gBAAgB,cAAc,GAAI,YACnD,OAAM,KAAK,gBAAgB;;;;;;;;;;;;;CAe/B,MAAM,SAAS,iBAAwC;AACrD,QAAM,KAAK,iBAAiB;EAE5B,MAAM,mBAAmB,MAAM,KAAK,gBAAgB,oBAAoB;EACxE,MAAM,gBAAgB,OAAO,kBAAkB,iBAAiB;AAGhE,QAAM,KAAK,OAAO,wBAAwB,cAAc;AAExD,QAAM,KAAK,gBAAgB;AAE3B,QAAM,KAAK,OAAO,wBAAwB,EAAE;;;;;;;AAQhD,IAAa,iBAAb,MAA4B;CAC1B;CACA;CACA;;;;;;CAOA,YAAY,OAAoB,UAA0B;AACxD,OAAK,SAAS;AACd,OAAK,YAAY;;;;;;;;;;;CAYnB,MAAM,eAAgC;AAEpC,UADe,MAAM,KAAK,OAAO,QAAQ,EAC3B;;;;;;;;;;;;;;;;CAiBhB,MAAM,qBAAsC;EAC1C,MAAM,SAAS,MAAM,KAAK,OAAO,QAAQ;AAEzC,UADc,MAAM,KAAK,OAAO,MAAM,OAAO,UAAU,EAC1C,MAAM,OAAO;;;;;;;;;;;;;;;;CAiB5B,MAAM,eAAe,aAAoC;EACvD,IAAI,SAAS,MAAM,KAAK,OAAO,QAAQ;AAGvC,SAAO,OAAO,YAAY,YACxB,UAAS,MAAM,KAAK,OAAO,iBAAiB,OAAO,UAAU;;;;;;;;;;;;;;;;;CAmBjE,MAAM,mBAAmB,iBAAyB,SAAoD;EAOpG,MAAM,mBAAmB,SAAS,oBAAoB;EACtD,MAAM,oBAAoB,SAAS,qBAAqB;EACxD,MAAM,mBAAmB,SAAS,oBAAoB;EAGtD,MAAM,gBADgB,MAAM,KAAK,OAAO,QAAQ,EACb;EAEnC,MAAM,yBADe,MAAM,KAAK,OAAO,MAAM,aAAa,EACf,MAAM,OAAO;AAExD,MAAI,yBAAyB,gBAAiB;EAE9C,MAAM,gBAAgB,OAAO,kBAAkB,sBAAsB;EACrE,MAAM,eAAe,KAAK,MAAM,gBAAgB,iBAAiB;AAGjE,MAAI,eAAe,EACjB,OAAM,KAAK,eAAe,eAAe,OAAO,aAAa,CAAC;EAGhE,MAAM,mBAAmB,KAAK,KAAK;AACnC,SAAO,MAAM;GACX,MAAM,kBAAkB,MAAM,KAAK,oBAAoB;AACvD,OAAI,kBAAkB,gBACpB;AAGF,OAAI,KAAK,KAAK,GAAG,oBAAoB,iBACnC,OAAM,IAAI,MAAM,iCAAiC,gBAAgB,aAAa,gBAAgB,GAAG;AAGnG,SAAM,IAAI,SAAS,YAAY,WAAW,SAAS,kBAAkB,CAAC;;;;;;;;;;;;;;;;;;CAmB1E,IAAI,WAA4B;AAC9B,MAAI,CAAC,KAAK,UACR,MAAK,YAAY,IAAI,gBAAgB,KAAK,QAAQ,MAAM,KAAK,UAAU;AAEzE,SAAO,KAAK"}

package/network-manager.mjs

@@ -1,5 +1,4 @@
 import { AlgoAmount } from "./amount.mjs";
-
 //#region src/network-manager.ts
 /**
 * Manager for LocalNet-specific network operations.
@@ -184,7 +183,7 @@ var NetworkManager = class {
 		return this._localNet;
 	}
 };
-
 //#endregion
 export { LocalNetManager, NetworkManager };
+
 //# sourceMappingURL=network-manager.mjs.map

package/network-manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"network-manager.mjs","names":[],"sources":["../src/network-manager.ts"],"sourcesContent":["import { AlgodClient } from '@algorandfoundation/algokit-algod-client'\nimport type { AlgorandClient } from './algorand-client'\nimport { AlgoAmount } from './amount'\n\n/** Options for waiting until a specific timestamp is reached on the blockchain. */\nexport interface WaitUntilTimestampOptions {\n  /** Estimated block time in seconds, used to calculate rounds to wait. Should be slightly lower than average to undershoot. Defaults to 2.7. */\n  blockTimeSeconds?: number\n  /** Polling interval in milliseconds when close to target. Defaults to 1000. */\n  pollingIntervalMs?: number\n  /** Timeout in milliseconds for the polling loop. Defaults to 5000. */\n  pollingTimeoutMs?: number\n}\n\n/**\n * Manager for LocalNet-specific network operations.\n * These methods only work on LocalNet and will throw an error if called on other networks.\n */\nexport class LocalNetManager {\n  private _algod: AlgodClient\n  private _networkManager: NetworkManager\n  private _algorand: AlgorandClient\n\n  /** @param algod The algod client to use for LocalNet operations */\n  constructor(algod: AlgodClient, networkManager: NetworkManager, algorand: AlgorandClient) {\n    this._algod = algod\n    this._networkManager = networkManager\n    this._algorand = algorand\n  }\n\n  private async _ensureLocalNet(): Promise<void> {\n    if (!(await this._algorand.client.isLocalNet())) {\n      throw new Error('LocalNet methods are only available when connected to a LocalNet network')\n    }\n  }\n\n  /**\n   * Generates a single block by sending a zero-amount payment transaction from the dispenser to itself.\n   * This triggers block creation in LocalNet dev mode.\n   */\n  private async _generateBlock(): Promise<void> {\n    const algorand = this._algorand\n    const dispenser = await algorand.account.localNetDispenser()\n    await algorand.send.payment({\n      sender: dispenser,\n      receiver: dispenser,\n      amount: AlgoAmount.MicroAlgo(0),\n      note: 'algokit-utils:block-generation',\n    })\n  }\n\n  /**\n   * Advances the blockchain by generating blocks until the target round is reached.\n   * @param targetRound The round number to advance to\n   * @throws Error if not connected to LocalNet\n   * @example\n   * ```typescript\n   * // Advance LocalNet to round 100\n   * await algorand.network.localNet.blockWarp(100n)\n   * ```\n   */\n  async blockWarp(targetRound: bigint): Promise<void> {\n    await this._ensureLocalNet()\n\n    // Generate blocks until we reach the target round\n    while ((await this._networkManager.getLastRound()) < targetRound) {\n      await this._generateBlock()\n    }\n  }\n\n  /**\n   * Advances the blockchain timestamp to a target Unix timestamp.\n   * @param targetTimestamp The target Unix timestamp in seconds\n   * @throws Error if not connected to LocalNet\n   * @example\n   * ```typescript\n   * // Advance LocalNet time by 1 hour\n   * const oneHourFromNow = BigInt(Math.floor(Date.now() / 1000)) + 3600n\n   * await algorand.network.localNet.timeWarp(oneHourFromNow)\n   * ```\n   */\n  async timeWarp(targetTimestamp: bigint): Promise<void> {\n    await this._ensureLocalNet()\n\n    const currentTimestamp = await this._networkManager.getLatestTimestamp()\n    const offsetSeconds = Number(targetTimestamp - currentTimestamp)\n\n    // Set the timestamp offset so the next block will have the target timestamp\n    await this._algod.setBlockTimeStampOffset(offsetSeconds)\n    // Generate a block with the new timestamp\n    await this._generateBlock()\n    // Reset the offset to use real clock for subsequent blocks\n    await this._algod.setBlockTimeStampOffset(0)\n  }\n}\n\n/**\n * Manager for network-related operations.\n * Provides utilities for querying blockchain state and waiting for specific conditions.\n */\nexport class NetworkManager {\n  private _algod: AlgodClient\n  private _algorand: AlgorandClient\n  private _localNet: LocalNetManager | undefined\n\n  /**\n   * Create a new NetworkManager instance.\n   * @param algod The algod client to use for network operations\n   * @param algorand The AlgorandClient instance (for LocalNet operations)\n   */\n  constructor(algod: AlgodClient, algorand: AlgorandClient) {\n    this._algod = algod\n    this._algorand = algorand\n  }\n\n  /**\n   * Get the last committed round number.\n   * @returns The last round number\n   * @example\n   * ```typescript\n   * const lastRound = await algorand.network.getLastRound()\n   * console.log(`Current round: ${lastRound}`)\n   * ```\n   */\n  async getLastRound(): Promise<bigint> {\n    const status = await this._algod.status()\n    return status.lastRound\n  }\n\n  /**\n   * Get the Unix timestamp of the latest block.\n   *\n   * Note: This method makes two sequential API calls (status then block fetch).\n   * The round may advance between these calls, so the returned timestamp may not\n   * be from the actual latest timestamp.\n   *\n   * @returns The UNIX timestamp of the last round\n   * @example\n   * ```typescript\n   * const timestamp = await algorand.network.getLatestTimestamp()\n   * console.log(`Latest block time: ${new Date(Number(timestamp) * 1000)}`)\n   * ```\n   */\n  async getLatestTimestamp(): Promise<bigint> {\n    const status = await this._algod.status()\n    const block = await this._algod.block(status.lastRound)\n    return block.block.header.timestamp\n  }\n\n  /**\n   * Wait until a specific round is reached.\n   *\n   * @param targetRound The round number to wait for\n   * @throws Error if timeout is reached before the target round\n   * @example\n   * ```typescript\n   * // Wait for round 1000\n   * await algorand.network.waitUntilRound(1000n)\n   *\n   * // Wait with a 30 second timeout\n   * await algorand.network.waitUntilRound(1000n, 30000)\n   * ```\n   */\n  async waitUntilRound(targetRound: bigint): Promise<void> {\n    let status = await this._algod.status()\n\n    // statusAfterBlock has 1 min timeout, loop if target not reached\n    while (status.lastRound < targetRound) {\n      status = await this._algod.statusAfterBlock(status.lastRound)\n    }\n  }\n\n  /**\n   * Wait until a specific Unix timestamp is reached on the blockchain.\n   *\n   * @param targetTimestamp The target Unix timestamp in seconds\n   * @param options Optional parameters for waiting\n   * @example\n   * ```typescript\n   * // Wait until a specific time\n   * const futureTime = BigInt(Math.floor(Date.now() / 1000)) + 60n // 1 minute from now\n   * await algorand.network.waitUntilTimestamp(futureTime)\n   *\n   * // Wait with custom timing parameters\n   * await algorand.network.waitUntilTimestamp(futureTime, { blockTimeSeconds: 3.0, pollingIntervalMs: 500 })\n   * ```\n   */\n  async waitUntilTimestamp(targetTimestamp: bigint, options?: WaitUntilTimestampOptions): Promise<void> {\n    // Note: this method reduces the number of calls to algod\n    //  by estimating the number of rounds to wait first\n    //  then wait for the target round to be committed\n    //  then poll every second for the right timestamp\n\n    // blockTimeSeconds should be slightly lower than the average block time so that it will undershoot\n    const blockTimeSeconds = options?.blockTimeSeconds ?? 2.7\n    const pollingIntervalMs = options?.pollingIntervalMs ?? 1000\n    const pollingTimeoutMs = options?.pollingTimeoutMs ?? 5000\n\n    const currentStatus = await this._algod.status()\n    const currentRound = currentStatus.lastRound\n    const currentBlock = await this._algod.block(currentRound)\n    const currentBlockTimestamp = currentBlock.block.header.timestamp\n\n    if (currentBlockTimestamp >= targetTimestamp) return\n\n    const secondsToWait = Number(targetTimestamp - currentBlockTimestamp)\n    const roundsToWait = Math.floor(secondsToWait / blockTimeSeconds)\n\n    // Wait for estimated round\n    if (roundsToWait > 1) {\n      await this.waitUntilRound(currentRound + BigInt(roundsToWait))\n    }\n\n    const pollingStartTime = Date.now()\n    while (true) {\n      const latestTimeStamp = await this.getLatestTimestamp()\n      if (latestTimeStamp > targetTimestamp) {\n        return\n      }\n\n      if (Date.now() - pollingStartTime >= pollingTimeoutMs) {\n        throw new Error(`Timeout waiting for timestamp ${targetTimestamp} (current: ${latestTimeStamp})`)\n      }\n\n      await new Promise((resolve) => setTimeout(resolve, pollingIntervalMs))\n    }\n  }\n\n  /**\n   * Get LocalNet-specific network utilities.\n   * These methods only work when connected to a LocalNet network and will throw\n   * an error if called on other networks.\n   *\n   * @returns The LocalNetManager instance\n   * @example\n   * ```typescript\n   * // Block warp on LocalNet\n   * await algorand.network.localNet.blockWarp(100n)\n   *\n   * // Time warp on LocalNet\n   * await algorand.network.localNet.timeWarp(BigInt(Date.now() / 1000) + 3600n)\n   * ```\n   */\n  get localNet(): LocalNetManager {\n    if (!this._localNet) {\n      this._localNet = new LocalNetManager(this._algod, this, this._algorand)\n    }\n    return this._localNet\n  }\n}\n"],"mappings":";;;;;;;AAkBA,IAAa,kBAAb,MAA6B;CAC3B,AAAQ;CACR,AAAQ;CACR,AAAQ;;CAGR,YAAY,OAAoB,gBAAgC,UAA0B;AACxF,OAAK,SAAS;AACd,OAAK,kBAAkB;AACvB,OAAK,YAAY;;CAGnB,MAAc,kBAAiC;AAC7C,MAAI,CAAE,MAAM,KAAK,UAAU,OAAO,YAAY,CAC5C,OAAM,IAAI,MAAM,2EAA2E;;;;;;CAQ/F,MAAc,iBAAgC;EAC5C,MAAM,WAAW,KAAK;EACtB,MAAM,YAAY,MAAM,SAAS,QAAQ,mBAAmB;AAC5D,QAAM,SAAS,KAAK,QAAQ;GAC1B,QAAQ;GACR,UAAU;GACV,QAAQ,WAAW,UAAU,EAAE;GAC/B,MAAM;GACP,CAAC;;;;;;;;;;;;CAaJ,MAAM,UAAU,aAAoC;AAClD,QAAM,KAAK,iBAAiB;AAG5B,SAAQ,MAAM,KAAK,gBAAgB,cAAc,GAAI,YACnD,OAAM,KAAK,gBAAgB;;;;;;;;;;;;;CAe/B,MAAM,SAAS,iBAAwC;AACrD,QAAM,KAAK,iBAAiB;EAE5B,MAAM,mBAAmB,MAAM,KAAK,gBAAgB,oBAAoB;EACxE,MAAM,gBAAgB,OAAO,kBAAkB,iBAAiB;AAGhE,QAAM,KAAK,OAAO,wBAAwB,cAAc;AAExD,QAAM,KAAK,gBAAgB;AAE3B,QAAM,KAAK,OAAO,wBAAwB,EAAE;;;;;;;AAQhD,IAAa,iBAAb,MAA4B;CAC1B,AAAQ;CACR,AAAQ;CACR,AAAQ;;;;;;CAOR,YAAY,OAAoB,UAA0B;AACxD,OAAK,SAAS;AACd,OAAK,YAAY;;;;;;;;;;;CAYnB,MAAM,eAAgC;AAEpC,UADe,MAAM,KAAK,OAAO,QAAQ,EAC3B;;;;;;;;;;;;;;;;CAiBhB,MAAM,qBAAsC;EAC1C,MAAM,SAAS,MAAM,KAAK,OAAO,QAAQ;AAEzC,UADc,MAAM,KAAK,OAAO,MAAM,OAAO,UAAU,EAC1C,MAAM,OAAO;;;;;;;;;;;;;;;;CAiB5B,MAAM,eAAe,aAAoC;EACvD,IAAI,SAAS,MAAM,KAAK,OAAO,QAAQ;AAGvC,SAAO,OAAO,YAAY,YACxB,UAAS,MAAM,KAAK,OAAO,iBAAiB,OAAO,UAAU;;;;;;;;;;;;;;;;;CAmBjE,MAAM,mBAAmB,iBAAyB,SAAoD;EAOpG,MAAM,mBAAmB,SAAS,oBAAoB;EACtD,MAAM,oBAAoB,SAAS,qBAAqB;EACxD,MAAM,mBAAmB,SAAS,oBAAoB;EAGtD,MAAM,gBADgB,MAAM,KAAK,OAAO,QAAQ,EACb;EAEnC,MAAM,yBADe,MAAM,KAAK,OAAO,MAAM,aAAa,EACf,MAAM,OAAO;AAExD,MAAI,yBAAyB,gBAAiB;EAE9C,MAAM,gBAAgB,OAAO,kBAAkB,sBAAsB;EACrE,MAAM,eAAe,KAAK,MAAM,gBAAgB,iBAAiB;AAGjE,MAAI,eAAe,EACjB,OAAM,KAAK,eAAe,eAAe,OAAO,aAAa,CAAC;EAGhE,MAAM,mBAAmB,KAAK,KAAK;AACnC,SAAO,MAAM;GACX,MAAM,kBAAkB,MAAM,KAAK,oBAAoB;AACvD,OAAI,kBAAkB,gBACpB;AAGF,OAAI,KAAK,KAAK,GAAG,oBAAoB,iBACnC,OAAM,IAAI,MAAM,iCAAiC,gBAAgB,aAAa,gBAAgB,GAAG;AAGnG,SAAM,IAAI,SAAS,YAAY,WAAW,SAAS,kBAAkB,CAAC;;;;;;;;;;;;;;;;;;CAmB1E,IAAI,WAA4B;AAC9B,MAAI,CAAC,KAAK,UACR,MAAK,YAAY,IAAI,gBAAgB,KAAK,QAAQ,MAAM,KAAK,UAAU;AAEzE,SAAO,KAAK"}
+{"version":3,"file":"network-manager.mjs","names":[],"sources":["../src/network-manager.ts"],"sourcesContent":["import { AlgodClient } from '@algorandfoundation/algokit-algod-client'\nimport type { AlgorandClient } from './algorand-client'\nimport { AlgoAmount } from './amount'\n\n/** Options for waiting until a specific timestamp is reached on the blockchain. */\nexport interface WaitUntilTimestampOptions {\n  /** Estimated block time in seconds, used to calculate rounds to wait. Should be slightly lower than average to undershoot. Defaults to 2.7. */\n  blockTimeSeconds?: number\n  /** Polling interval in milliseconds when close to target. Defaults to 1000. */\n  pollingIntervalMs?: number\n  /** Timeout in milliseconds for the polling loop. Defaults to 5000. */\n  pollingTimeoutMs?: number\n}\n\n/**\n * Manager for LocalNet-specific network operations.\n * These methods only work on LocalNet and will throw an error if called on other networks.\n */\nexport class LocalNetManager {\n  private _algod: AlgodClient\n  private _networkManager: NetworkManager\n  private _algorand: AlgorandClient\n\n  /** @param algod The algod client to use for LocalNet operations */\n  constructor(algod: AlgodClient, networkManager: NetworkManager, algorand: AlgorandClient) {\n    this._algod = algod\n    this._networkManager = networkManager\n    this._algorand = algorand\n  }\n\n  private async _ensureLocalNet(): Promise<void> {\n    if (!(await this._algorand.client.isLocalNet())) {\n      throw new Error('LocalNet methods are only available when connected to a LocalNet network')\n    }\n  }\n\n  /**\n   * Generates a single block by sending a zero-amount payment transaction from the dispenser to itself.\n   * This triggers block creation in LocalNet dev mode.\n   */\n  private async _generateBlock(): Promise<void> {\n    const algorand = this._algorand\n    const dispenser = await algorand.account.localNetDispenser()\n    await algorand.send.payment({\n      sender: dispenser,\n      receiver: dispenser,\n      amount: AlgoAmount.MicroAlgo(0),\n      note: 'algokit-utils:block-generation',\n    })\n  }\n\n  /**\n   * Advances the blockchain by generating blocks until the target round is reached.\n   * @param targetRound The round number to advance to\n   * @throws Error if not connected to LocalNet\n   * @example\n   * ```typescript\n   * // Advance LocalNet to round 100\n   * await algorand.network.localNet.blockWarp(100n)\n   * ```\n   */\n  async blockWarp(targetRound: bigint): Promise<void> {\n    await this._ensureLocalNet()\n\n    // Generate blocks until we reach the target round\n    while ((await this._networkManager.getLastRound()) < targetRound) {\n      await this._generateBlock()\n    }\n  }\n\n  /**\n   * Advances the blockchain timestamp to a target Unix timestamp.\n   * @param targetTimestamp The target Unix timestamp in seconds\n   * @throws Error if not connected to LocalNet\n   * @example\n   * ```typescript\n   * // Advance LocalNet time by 1 hour\n   * const oneHourFromNow = BigInt(Math.floor(Date.now() / 1000)) + 3600n\n   * await algorand.network.localNet.timeWarp(oneHourFromNow)\n   * ```\n   */\n  async timeWarp(targetTimestamp: bigint): Promise<void> {\n    await this._ensureLocalNet()\n\n    const currentTimestamp = await this._networkManager.getLatestTimestamp()\n    const offsetSeconds = Number(targetTimestamp - currentTimestamp)\n\n    // Set the timestamp offset so the next block will have the target timestamp\n    await this._algod.setBlockTimeStampOffset(offsetSeconds)\n    // Generate a block with the new timestamp\n    await this._generateBlock()\n    // Reset the offset to use real clock for subsequent blocks\n    await this._algod.setBlockTimeStampOffset(0)\n  }\n}\n\n/**\n * Manager for network-related operations.\n * Provides utilities for querying blockchain state and waiting for specific conditions.\n */\nexport class NetworkManager {\n  private _algod: AlgodClient\n  private _algorand: AlgorandClient\n  private _localNet: LocalNetManager | undefined\n\n  /**\n   * Create a new NetworkManager instance.\n   * @param algod The algod client to use for network operations\n   * @param algorand The AlgorandClient instance (for LocalNet operations)\n   */\n  constructor(algod: AlgodClient, algorand: AlgorandClient) {\n    this._algod = algod\n    this._algorand = algorand\n  }\n\n  /**\n   * Get the last committed round number.\n   * @returns The last round number\n   * @example\n   * ```typescript\n   * const lastRound = await algorand.network.getLastRound()\n   * console.log(`Current round: ${lastRound}`)\n   * ```\n   */\n  async getLastRound(): Promise<bigint> {\n    const status = await this._algod.status()\n    return status.lastRound\n  }\n\n  /**\n   * Get the Unix timestamp of the latest block.\n   *\n   * Note: This method makes two sequential API calls (status then block fetch).\n   * The round may advance between these calls, so the returned timestamp may not\n   * be from the actual latest timestamp.\n   *\n   * @returns The UNIX timestamp of the last round\n   * @example\n   * ```typescript\n   * const timestamp = await algorand.network.getLatestTimestamp()\n   * console.log(`Latest block time: ${new Date(Number(timestamp) * 1000)}`)\n   * ```\n   */\n  async getLatestTimestamp(): Promise<bigint> {\n    const status = await this._algod.status()\n    const block = await this._algod.block(status.lastRound)\n    return block.block.header.timestamp\n  }\n\n  /**\n   * Wait until a specific round is reached.\n   *\n   * @param targetRound The round number to wait for\n   * @throws Error if timeout is reached before the target round\n   * @example\n   * ```typescript\n   * // Wait for round 1000\n   * await algorand.network.waitUntilRound(1000n)\n   *\n   * // Wait with a 30 second timeout\n   * await algorand.network.waitUntilRound(1000n, 30000)\n   * ```\n   */\n  async waitUntilRound(targetRound: bigint): Promise<void> {\n    let status = await this._algod.status()\n\n    // statusAfterBlock has 1 min timeout, loop if target not reached\n    while (status.lastRound < targetRound) {\n      status = await this._algod.statusAfterBlock(status.lastRound)\n    }\n  }\n\n  /**\n   * Wait until a specific Unix timestamp is reached on the blockchain.\n   *\n   * @param targetTimestamp The target Unix timestamp in seconds\n   * @param options Optional parameters for waiting\n   * @example\n   * ```typescript\n   * // Wait until a specific time\n   * const futureTime = BigInt(Math.floor(Date.now() / 1000)) + 60n // 1 minute from now\n   * await algorand.network.waitUntilTimestamp(futureTime)\n   *\n   * // Wait with custom timing parameters\n   * await algorand.network.waitUntilTimestamp(futureTime, { blockTimeSeconds: 3.0, pollingIntervalMs: 500 })\n   * ```\n   */\n  async waitUntilTimestamp(targetTimestamp: bigint, options?: WaitUntilTimestampOptions): Promise<void> {\n    // Note: this method reduces the number of calls to algod\n    //  by estimating the number of rounds to wait first\n    //  then wait for the target round to be committed\n    //  then poll every second for the right timestamp\n\n    // blockTimeSeconds should be slightly lower than the average block time so that it will undershoot\n    const blockTimeSeconds = options?.blockTimeSeconds ?? 2.7\n    const pollingIntervalMs = options?.pollingIntervalMs ?? 1000\n    const pollingTimeoutMs = options?.pollingTimeoutMs ?? 5000\n\n    const currentStatus = await this._algod.status()\n    const currentRound = currentStatus.lastRound\n    const currentBlock = await this._algod.block(currentRound)\n    const currentBlockTimestamp = currentBlock.block.header.timestamp\n\n    if (currentBlockTimestamp >= targetTimestamp) return\n\n    const secondsToWait = Number(targetTimestamp - currentBlockTimestamp)\n    const roundsToWait = Math.floor(secondsToWait / blockTimeSeconds)\n\n    // Wait for estimated round\n    if (roundsToWait > 1) {\n      await this.waitUntilRound(currentRound + BigInt(roundsToWait))\n    }\n\n    const pollingStartTime = Date.now()\n    while (true) {\n      const latestTimeStamp = await this.getLatestTimestamp()\n      if (latestTimeStamp > targetTimestamp) {\n        return\n      }\n\n      if (Date.now() - pollingStartTime >= pollingTimeoutMs) {\n        throw new Error(`Timeout waiting for timestamp ${targetTimestamp} (current: ${latestTimeStamp})`)\n      }\n\n      await new Promise((resolve) => setTimeout(resolve, pollingIntervalMs))\n    }\n  }\n\n  /**\n   * Get LocalNet-specific network utilities.\n   * These methods only work when connected to a LocalNet network and will throw\n   * an error if called on other networks.\n   *\n   * @returns The LocalNetManager instance\n   * @example\n   * ```typescript\n   * // Block warp on LocalNet\n   * await algorand.network.localNet.blockWarp(100n)\n   *\n   * // Time warp on LocalNet\n   * await algorand.network.localNet.timeWarp(BigInt(Date.now() / 1000) + 3600n)\n   * ```\n   */\n  get localNet(): LocalNetManager {\n    if (!this._localNet) {\n      this._localNet = new LocalNetManager(this._algod, this, this._algorand)\n    }\n    return this._localNet\n  }\n}\n"],"mappings":";;;;;;AAkBA,IAAa,kBAAb,MAA6B;CAC3B;CACA;CACA;;CAGA,YAAY,OAAoB,gBAAgC,UAA0B;AACxF,OAAK,SAAS;AACd,OAAK,kBAAkB;AACvB,OAAK,YAAY;;CAGnB,MAAc,kBAAiC;AAC7C,MAAI,CAAE,MAAM,KAAK,UAAU,OAAO,YAAY,CAC5C,OAAM,IAAI,MAAM,2EAA2E;;;;;;CAQ/F,MAAc,iBAAgC;EAC5C,MAAM,WAAW,KAAK;EACtB,MAAM,YAAY,MAAM,SAAS,QAAQ,mBAAmB;AAC5D,QAAM,SAAS,KAAK,QAAQ;GAC1B,QAAQ;GACR,UAAU;GACV,QAAQ,WAAW,UAAU,EAAE;GAC/B,MAAM;GACP,CAAC;;;;;;;;;;;;CAaJ,MAAM,UAAU,aAAoC;AAClD,QAAM,KAAK,iBAAiB;AAG5B,SAAQ,MAAM,KAAK,gBAAgB,cAAc,GAAI,YACnD,OAAM,KAAK,gBAAgB;;;;;;;;;;;;;CAe/B,MAAM,SAAS,iBAAwC;AACrD,QAAM,KAAK,iBAAiB;EAE5B,MAAM,mBAAmB,MAAM,KAAK,gBAAgB,oBAAoB;EACxE,MAAM,gBAAgB,OAAO,kBAAkB,iBAAiB;AAGhE,QAAM,KAAK,OAAO,wBAAwB,cAAc;AAExD,QAAM,KAAK,gBAAgB;AAE3B,QAAM,KAAK,OAAO,wBAAwB,EAAE;;;;;;;AAQhD,IAAa,iBAAb,MAA4B;CAC1B;CACA;CACA;;;;;;CAOA,YAAY,OAAoB,UAA0B;AACxD,OAAK,SAAS;AACd,OAAK,YAAY;;;;;;;;;;;CAYnB,MAAM,eAAgC;AAEpC,UADe,MAAM,KAAK,OAAO,QAAQ,EAC3B;;;;;;;;;;;;;;;;CAiBhB,MAAM,qBAAsC;EAC1C,MAAM,SAAS,MAAM,KAAK,OAAO,QAAQ;AAEzC,UADc,MAAM,KAAK,OAAO,MAAM,OAAO,UAAU,EAC1C,MAAM,OAAO;;;;;;;;;;;;;;;;CAiB5B,MAAM,eAAe,aAAoC;EACvD,IAAI,SAAS,MAAM,KAAK,OAAO,QAAQ;AAGvC,SAAO,OAAO,YAAY,YACxB,UAAS,MAAM,KAAK,OAAO,iBAAiB,OAAO,UAAU;;;;;;;;;;;;;;;;;CAmBjE,MAAM,mBAAmB,iBAAyB,SAAoD;EAOpG,MAAM,mBAAmB,SAAS,oBAAoB;EACtD,MAAM,oBAAoB,SAAS,qBAAqB;EACxD,MAAM,mBAAmB,SAAS,oBAAoB;EAGtD,MAAM,gBADgB,MAAM,KAAK,OAAO,QAAQ,EACb;EAEnC,MAAM,yBADe,MAAM,KAAK,OAAO,MAAM,aAAa,EACf,MAAM,OAAO;AAExD,MAAI,yBAAyB,gBAAiB;EAE9C,MAAM,gBAAgB,OAAO,kBAAkB,sBAAsB;EACrE,MAAM,eAAe,KAAK,MAAM,gBAAgB,iBAAiB;AAGjE,MAAI,eAAe,EACjB,OAAM,KAAK,eAAe,eAAe,OAAO,aAAa,CAAC;EAGhE,MAAM,mBAAmB,KAAK,KAAK;AACnC,SAAO,MAAM;GACX,MAAM,kBAAkB,MAAM,KAAK,oBAAoB;AACvD,OAAI,kBAAkB,gBACpB;AAGF,OAAI,KAAK,KAAK,GAAG,oBAAoB,iBACnC,OAAM,IAAI,MAAM,iCAAiC,gBAAgB,aAAa,gBAAgB,GAAG;AAGnG,SAAM,IAAI,SAAS,YAAY,WAAW,SAAS,kBAAkB,CAAC;;;;;;;;;;;;;;;;;;CAmB1E,IAAI,WAA4B;AAC9B,MAAI,CAAC,KAAK,UACR,MAAK,YAAY,IAAI,gBAAgB,KAAK,QAAQ,MAAM,KAAK,UAAU;AAEzE,SAAO,KAAK"}

package/package.json

@@ -6,7 +6,7 @@
     "**"
   ],
   "name": "@algorandfoundation/algokit-utils",
-  "version": "10.0.0-alpha.45",
+  "version": "10.0.0-alpha.47",
   "private": false,
   "description": "A set of core Algorand utilities written in TypeScript and released via npm that make it easier to build solutions on Algorand.",
   "author": "Algorand Foundation",
@@ -16,7 +16,7 @@
     "url": "https://github.com/algorandfoundation/algokit-utils-ts.git"
   },
   "engines": {
-    "node": ">=20.0"
+    "node": ">=24.0"
   },
   "type": "commonjs",
   "module": "index.mjs",
@@ -90,7 +90,10 @@
     "./package.json": "./package.json"
   },
   "overrides": {
-    "esbuild": "0.25.0"
+    "esbuild": "0.25.0",
+    "cross-spawn": ">=7.0.5",
+    "brace-expansion": ">=2.0.1",
+    "picomatch": ">=4.0.2"
   },
   "dependencies": {
     "@algorandfoundation/xhd-wallet-api": "2.0.0-canary.1",

package/packages/abi/src/abi-method.d.ts

@@ -11,12 +11,12 @@ declare enum ABITransactionType {
   AssetConfig = "acfg",
   AssetTransfer = "axfer",
   AssetFreeze = "afrz",
-  AppCall = "appl",
+  AppCall = "appl"
 }
 declare enum ABIReferenceType {
   Account = "account",
   Application = "application",
-  Asset = "asset",
+  Asset = "asset"
 }
 type ABIMethodArgType = ABIType | ABITransactionType | ABIReferenceType;
 type ABIMethodReturnType = ABIType | 'void';
@@ -31,11 +31,8 @@ type ABIMethodReturn = {
   description?: string;
 };
 type ABIDefaultValue = {
-  /** Base64 encoded bytes, base64 ARC4 encoded uint64, or UTF-8 method selector */
-  data: string;
-  /** Where the default value is coming from */
-  source: DefaultValueSource;
-  /** How the data is encoded. This is the encoding for the data provided here, not the arg type */
+  /** Base64 encoded bytes, base64 ARC4 encoded uint64, or UTF-8 method selector */data: string; /** Where the default value is coming from */
+  source: DefaultValueSource; /** How the data is encoded. This is the encoding for the data provided here, not the arg type */
   type?: ABIType | AVMType;
 };
 declare enum DefaultValueSource {
@@ -43,18 +40,16 @@ declare enum DefaultValueSource {
   Global = "global",
   Local = "local",
   Literal = "literal",
-  Method = "method",
+  Method = "method"
 }
 /** Represents an ABI method return value with parsed data. */
 type ABIReturn = {
-  /** The method that was called. */
-  method: ABIMethod;
+  /** The method that was called. */method: ABIMethod;
   /** The raw return value as bytes.
    *
    * This is the value from the last app call log with the first 4 bytes (the ABI return prefix) omitted.
    */
-  rawReturnValue: Uint8Array;
-  /** The parsed ABI return value. */
+  rawReturnValue: Uint8Array; /** The parsed ABI return value. */
   returnValue: ABIValue;
   decodeError: undefined;
 } | {

package/packages/abi/src/abi-method.js

@@ -1,7 +1,6 @@
-const require_runtime = require('../../../_virtual/_rolldown/runtime.js');
-const require_abi_type = require('./abi-type.js');
+require("../../../_virtual/_rolldown/runtime.js");
+const require_abi_type = require("./abi-type.js");
 let _noble_hashes_sha2_js = require("@noble/hashes/sha2.js");
-
 //#region packages/abi/src/abi-method.ts
 let ABITransactionType = /* @__PURE__ */ function(ABITransactionType) {
 	ABITransactionType["Txn"] = "txn";
@@ -191,7 +190,6 @@ function getABIDecodedValue(type, bytes) {
 function getABIEncodedValue(type, value) {
 	return isAVMType(type) ? encodeAVMValue(type, value) : type.encode(value);
 }
-
 //#endregion
 exports.ABIMethod = ABIMethod;
 exports.ABIReferenceType = ABIReferenceType;
@@ -205,4 +203,5 @@ exports.getABIDecodedValue = getABIDecodedValue;
 exports.getABIEncodedValue = getABIEncodedValue;
 exports.getABIMethod = getABIMethod;
 exports.isAVMType = isAVMType;
+
 //# sourceMappingURL=abi-method.js.map