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

package/network-manager.js

@@ -0,0 +1,191 @@
+const require_amount = require('./amount.js');
+
+//#region src/network-manager.ts
+/**
+* Manager for LocalNet-specific network operations.
+* These methods only work on LocalNet and will throw an error if called on other networks.
+*/
+var LocalNetManager = class {
+	_algod;
+	_networkManager;
+	_algorand;
+	/** @param algod The algod client to use for LocalNet operations */
+	constructor(algod, networkManager, algorand) {
+		this._algod = algod;
+		this._networkManager = networkManager;
+		this._algorand = algorand;
+	}
+	async _ensureLocalNet() {
+		if (!await this._algorand.client.isLocalNet()) throw new Error("LocalNet methods are only available when connected to a LocalNet network");
+	}
+	/**
+	* Generates a single block by sending a zero-amount payment transaction from the dispenser to itself.
+	* This triggers block creation in LocalNet dev mode.
+	*/
+	async _generateBlock() {
+		const algorand = this._algorand;
+		const dispenser = await algorand.account.localNetDispenser();
+		await algorand.send.payment({
+			sender: dispenser,
+			receiver: dispenser,
+			amount: require_amount.AlgoAmount.MicroAlgo(0),
+			note: "algokit-utils:block-generation"
+		});
+	}
+	/**
+	* Advances the blockchain by generating blocks until the target round is reached.
+	* @param targetRound The round number to advance to
+	* @throws Error if not connected to LocalNet
+	* @example
+	* ```typescript
+	* // Advance LocalNet to round 100
+	* await algorand.network.localNet.blockWarp(100n)
+	* ```
+	*/
+	async blockWarp(targetRound) {
+		await this._ensureLocalNet();
+		while (await this._networkManager.getLastRound() < targetRound) await this._generateBlock();
+	}
+	/**
+	* Advances the blockchain timestamp to a target Unix timestamp.
+	* @param targetTimestamp The target Unix timestamp in seconds
+	* @throws Error if not connected to LocalNet
+	* @example
+	* ```typescript
+	* // Advance LocalNet time by 1 hour
+	* const oneHourFromNow = BigInt(Math.floor(Date.now() / 1000)) + 3600n
+	* await algorand.network.localNet.timeWarp(oneHourFromNow)
+	* ```
+	*/
+	async timeWarp(targetTimestamp) {
+		await this._ensureLocalNet();
+		const currentTimestamp = await this._networkManager.getLatestTimestamp();
+		const offsetSeconds = Number(targetTimestamp - currentTimestamp);
+		await this._algod.setBlockTimeStampOffset(offsetSeconds);
+		await this._generateBlock();
+		await this._algod.setBlockTimeStampOffset(0);
+	}
+};
+/**
+* Manager for network-related operations.
+* Provides utilities for querying blockchain state and waiting for specific conditions.
+*/
+var NetworkManager = class {
+	_algod;
+	_algorand;
+	_localNet;
+	/**
+	* Create a new NetworkManager instance.
+	* @param algod The algod client to use for network operations
+	* @param algorand The AlgorandClient instance (for LocalNet operations)
+	*/
+	constructor(algod, algorand) {
+		this._algod = algod;
+		this._algorand = algorand;
+	}
+	/**
+	* Get the last committed round number.
+	* @returns The last round number
+	* @example
+	* ```typescript
+	* const lastRound = await algorand.network.getLastRound()
+	* console.log(`Current round: ${lastRound}`)
+	* ```
+	*/
+	async getLastRound() {
+		return (await this._algod.status()).lastRound;
+	}
+	/**
+	* Get the Unix timestamp of the latest block.
+	*
+	* Note: This method makes two sequential API calls (status then block fetch).
+	* The round may advance between these calls, so the returned timestamp may not
+	* be from the actual latest timestamp.
+	*
+	* @returns The UNIX timestamp of the last round
+	* @example
+	* ```typescript
+	* const timestamp = await algorand.network.getLatestTimestamp()
+	* console.log(`Latest block time: ${new Date(Number(timestamp) * 1000)}`)
+	* ```
+	*/
+	async getLatestTimestamp() {
+		const status = await this._algod.status();
+		return (await this._algod.block(status.lastRound)).block.header.timestamp;
+	}
+	/**
+	* Wait until a specific round is reached.
+	*
+	* @param targetRound The round number to wait for
+	* @throws Error if timeout is reached before the target round
+	* @example
+	* ```typescript
+	* // Wait for round 1000
+	* await algorand.network.waitUntilRound(1000n)
+	*
+	* // Wait with a 30 second timeout
+	* await algorand.network.waitUntilRound(1000n, 30000)
+	* ```
+	*/
+	async waitUntilRound(targetRound) {
+		let status = await this._algod.status();
+		while (status.lastRound < targetRound) status = await this._algod.statusAfterBlock(status.lastRound);
+	}
+	/**
+	* Wait until a specific Unix timestamp is reached on the blockchain.
+	*
+	* @param targetTimestamp The target Unix timestamp in seconds
+	* @param options Optional parameters for waiting
+	* @example
+	* ```typescript
+	* // Wait until a specific time
+	* const futureTime = BigInt(Math.floor(Date.now() / 1000)) + 60n // 1 minute from now
+	* await algorand.network.waitUntilTimestamp(futureTime)
+	*
+	* // Wait with custom timing parameters
+	* await algorand.network.waitUntilTimestamp(futureTime, { blockTimeSeconds: 3.0, pollingIntervalMs: 500 })
+	* ```
+	*/
+	async waitUntilTimestamp(targetTimestamp, options) {
+		const blockTimeSeconds = options?.blockTimeSeconds ?? 2.7;
+		const pollingIntervalMs = options?.pollingIntervalMs ?? 1e3;
+		const pollingTimeoutMs = options?.pollingTimeoutMs ?? 5e3;
+		const currentRound = (await this._algod.status()).lastRound;
+		const currentBlockTimestamp = (await this._algod.block(currentRound)).block.header.timestamp;
+		if (currentBlockTimestamp >= targetTimestamp) return;
+		const secondsToWait = Number(targetTimestamp - currentBlockTimestamp);
+		const roundsToWait = Math.floor(secondsToWait / blockTimeSeconds);
+		if (roundsToWait > 1) await this.waitUntilRound(currentRound + BigInt(roundsToWait));
+		const pollingStartTime = Date.now();
+		while (true) {
+			const latestTimeStamp = await this.getLatestTimestamp();
+			if (latestTimeStamp > targetTimestamp) return;
+			if (Date.now() - pollingStartTime >= pollingTimeoutMs) throw new Error(`Timeout waiting for timestamp ${targetTimestamp} (current: ${latestTimeStamp})`);
+			await new Promise((resolve) => setTimeout(resolve, pollingIntervalMs));
+		}
+	}
+	/**
+	* Get LocalNet-specific network utilities.
+	* These methods only work when connected to a LocalNet network and will throw
+	* an error if called on other networks.
+	*
+	* @returns The LocalNetManager instance
+	* @example
+	* ```typescript
+	* // Block warp on LocalNet
+	* await algorand.network.localNet.blockWarp(100n)
+	*
+	* // Time warp on LocalNet
+	* await algorand.network.localNet.timeWarp(BigInt(Date.now() / 1000) + 3600n)
+	* ```
+	*/
+	get localNet() {
+		if (!this._localNet) this._localNet = new LocalNetManager(this._algod, this, this._algorand);
+		return this._localNet;
+	}
+};
+
+//#endregion
+exports.LocalNetManager = LocalNetManager;
+exports.NetworkManager = NetworkManager;
+//# sourceMappingURL=network-manager.js.map

package/network-manager.js.map

@@ -0,0 +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"}

package/network-manager.mjs

@@ -0,0 +1,190 @@
+import { AlgoAmount } from "./amount.mjs";
+
+//#region src/network-manager.ts
+/**
+* Manager for LocalNet-specific network operations.
+* These methods only work on LocalNet and will throw an error if called on other networks.
+*/
+var LocalNetManager = class {
+	_algod;
+	_networkManager;
+	_algorand;
+	/** @param algod The algod client to use for LocalNet operations */
+	constructor(algod, networkManager, algorand) {
+		this._algod = algod;
+		this._networkManager = networkManager;
+		this._algorand = algorand;
+	}
+	async _ensureLocalNet() {
+		if (!await this._algorand.client.isLocalNet()) throw new Error("LocalNet methods are only available when connected to a LocalNet network");
+	}
+	/**
+	* Generates a single block by sending a zero-amount payment transaction from the dispenser to itself.
+	* This triggers block creation in LocalNet dev mode.
+	*/
+	async _generateBlock() {
+		const algorand = this._algorand;
+		const dispenser = await algorand.account.localNetDispenser();
+		await algorand.send.payment({
+			sender: dispenser,
+			receiver: dispenser,
+			amount: AlgoAmount.MicroAlgo(0),
+			note: "algokit-utils:block-generation"
+		});
+	}
+	/**
+	* Advances the blockchain by generating blocks until the target round is reached.
+	* @param targetRound The round number to advance to
+	* @throws Error if not connected to LocalNet
+	* @example
+	* ```typescript
+	* // Advance LocalNet to round 100
+	* await algorand.network.localNet.blockWarp(100n)
+	* ```
+	*/
+	async blockWarp(targetRound) {
+		await this._ensureLocalNet();
+		while (await this._networkManager.getLastRound() < targetRound) await this._generateBlock();
+	}
+	/**
+	* Advances the blockchain timestamp to a target Unix timestamp.
+	* @param targetTimestamp The target Unix timestamp in seconds
+	* @throws Error if not connected to LocalNet
+	* @example
+	* ```typescript
+	* // Advance LocalNet time by 1 hour
+	* const oneHourFromNow = BigInt(Math.floor(Date.now() / 1000)) + 3600n
+	* await algorand.network.localNet.timeWarp(oneHourFromNow)
+	* ```
+	*/
+	async timeWarp(targetTimestamp) {
+		await this._ensureLocalNet();
+		const currentTimestamp = await this._networkManager.getLatestTimestamp();
+		const offsetSeconds = Number(targetTimestamp - currentTimestamp);
+		await this._algod.setBlockTimeStampOffset(offsetSeconds);
+		await this._generateBlock();
+		await this._algod.setBlockTimeStampOffset(0);
+	}
+};
+/**
+* Manager for network-related operations.
+* Provides utilities for querying blockchain state and waiting for specific conditions.
+*/
+var NetworkManager = class {
+	_algod;
+	_algorand;
+	_localNet;
+	/**
+	* Create a new NetworkManager instance.
+	* @param algod The algod client to use for network operations
+	* @param algorand The AlgorandClient instance (for LocalNet operations)
+	*/
+	constructor(algod, algorand) {
+		this._algod = algod;
+		this._algorand = algorand;
+	}
+	/**
+	* Get the last committed round number.
+	* @returns The last round number
+	* @example
+	* ```typescript
+	* const lastRound = await algorand.network.getLastRound()
+	* console.log(`Current round: ${lastRound}`)
+	* ```
+	*/
+	async getLastRound() {
+		return (await this._algod.status()).lastRound;
+	}
+	/**
+	* Get the Unix timestamp of the latest block.
+	*
+	* Note: This method makes two sequential API calls (status then block fetch).
+	* The round may advance between these calls, so the returned timestamp may not
+	* be from the actual latest timestamp.
+	*
+	* @returns The UNIX timestamp of the last round
+	* @example
+	* ```typescript
+	* const timestamp = await algorand.network.getLatestTimestamp()
+	* console.log(`Latest block time: ${new Date(Number(timestamp) * 1000)}`)
+	* ```
+	*/
+	async getLatestTimestamp() {
+		const status = await this._algod.status();
+		return (await this._algod.block(status.lastRound)).block.header.timestamp;
+	}
+	/**
+	* Wait until a specific round is reached.
+	*
+	* @param targetRound The round number to wait for
+	* @throws Error if timeout is reached before the target round
+	* @example
+	* ```typescript
+	* // Wait for round 1000
+	* await algorand.network.waitUntilRound(1000n)
+	*
+	* // Wait with a 30 second timeout
+	* await algorand.network.waitUntilRound(1000n, 30000)
+	* ```
+	*/
+	async waitUntilRound(targetRound) {
+		let status = await this._algod.status();
+		while (status.lastRound < targetRound) status = await this._algod.statusAfterBlock(status.lastRound);
+	}
+	/**
+	* Wait until a specific Unix timestamp is reached on the blockchain.
+	*
+	* @param targetTimestamp The target Unix timestamp in seconds
+	* @param options Optional parameters for waiting
+	* @example
+	* ```typescript
+	* // Wait until a specific time
+	* const futureTime = BigInt(Math.floor(Date.now() / 1000)) + 60n // 1 minute from now
+	* await algorand.network.waitUntilTimestamp(futureTime)
+	*
+	* // Wait with custom timing parameters
+	* await algorand.network.waitUntilTimestamp(futureTime, { blockTimeSeconds: 3.0, pollingIntervalMs: 500 })
+	* ```
+	*/
+	async waitUntilTimestamp(targetTimestamp, options) {
+		const blockTimeSeconds = options?.blockTimeSeconds ?? 2.7;
+		const pollingIntervalMs = options?.pollingIntervalMs ?? 1e3;
+		const pollingTimeoutMs = options?.pollingTimeoutMs ?? 5e3;
+		const currentRound = (await this._algod.status()).lastRound;
+		const currentBlockTimestamp = (await this._algod.block(currentRound)).block.header.timestamp;
+		if (currentBlockTimestamp >= targetTimestamp) return;
+		const secondsToWait = Number(targetTimestamp - currentBlockTimestamp);
+		const roundsToWait = Math.floor(secondsToWait / blockTimeSeconds);
+		if (roundsToWait > 1) await this.waitUntilRound(currentRound + BigInt(roundsToWait));
+		const pollingStartTime = Date.now();
+		while (true) {
+			const latestTimeStamp = await this.getLatestTimestamp();
+			if (latestTimeStamp > targetTimestamp) return;
+			if (Date.now() - pollingStartTime >= pollingTimeoutMs) throw new Error(`Timeout waiting for timestamp ${targetTimestamp} (current: ${latestTimeStamp})`);
+			await new Promise((resolve) => setTimeout(resolve, pollingIntervalMs));
+		}
+	}
+	/**
+	* Get LocalNet-specific network utilities.
+	* These methods only work when connected to a LocalNet network and will throw
+	* an error if called on other networks.
+	*
+	* @returns The LocalNetManager instance
+	* @example
+	* ```typescript
+	* // Block warp on LocalNet
+	* await algorand.network.localNet.blockWarp(100n)
+	*
+	* // Time warp on LocalNet
+	* await algorand.network.localNet.timeWarp(BigInt(Date.now() / 1000) + 3600n)
+	* ```
+	*/
+	get localNet() {
+		if (!this._localNet) this._localNet = new LocalNetManager(this._algod, this, this._algorand);
+		return this._localNet;
+	}
+};
+
+//#endregion
+export { LocalNetManager, NetworkManager };
+//# sourceMappingURL=network-manager.mjs.map

package/network-manager.mjs.map

@@ -0,0 +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"}

package/package.json

@@ -6,11 +6,15 @@
     "**"
   ],
   "name": "@algorandfoundation/algokit-utils",
-  "version": "10.0.0-alpha.4",
+  "version": "10.0.0-alpha.41",
   "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",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/algorandfoundation/algokit-utils-ts.git"
+  },
   "engines": {
     "node": ">=20.0"
   },
@@ -42,6 +46,11 @@
       "import": "./transact/index.mjs",
       "require": "./transact/index.js"
     },
+    "./transaction": {
+      "types": "./transaction/index.d.ts",
+      "import": "./transaction/index.mjs",
+      "require": "./transaction/index.js"
+    },
     "./algod-client": {
       "types": "./algod-client/index.d.ts",
       "import": "./algod-client/index.mjs",
@@ -62,10 +71,20 @@
       "import": "./algo25/index.mjs",
       "require": "./algo25/index.js"
     },
-    "./sdk": {
-      "types": "./sdk/index.d.ts",
-      "import": "./sdk/index.mjs",
-      "require": "./sdk/index.js"
+    "./crypto": {
+      "types": "./crypto/index.d.ts",
+      "import": "./crypto/index.mjs",
+      "require": "./crypto/index.js"
+    },
+    "./common": {
+      "types": "./common/index.d.ts",
+      "import": "./common/index.mjs",
+      "require": "./common/index.js"
+    },
+    "./*": {
+      "types": "./*.d.ts",
+      "import": "./*.mjs",
+      "require": "./*.js"
     },
     "./index.d.ts": "./index.d.ts",
     "./package.json": "./package.json"
@@ -74,10 +93,13 @@
     "esbuild": "0.25.0"
   },
   "dependencies": {
+    "@algorandfoundation/xhd-wallet-api": "2.0.0-canary.1",
+    "@noble/ed25519": "^3.0.0",
+    "@noble/hashes": "^2.0.1",
     "algorand-msgpack": "^1.1.0",
     "buffer": "^6.0.3",
+    "dotenv": "^16.4.5",
     "hi-base32": "^0.5.1",
-    "js-sha512": "^0.8.0",
     "json-bigint": "^1.0.0",
     "tweetnacl": "^1.0.3",
     "vlq": "^2.0.4"

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

@@ -1,24 +1,23 @@
-const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.js');
+const require_runtime = require('../../../_virtual/_rolldown/runtime.js');
 const require_abi_type = require('./abi-type.js');
-let js_sha512 = require("js-sha512");
-js_sha512 = require_rolldown_runtime.__toESM(js_sha512);
+let _noble_hashes_sha2_js = require("@noble/hashes/sha2.js");
 
 //#region packages/abi/src/abi-method.ts
-let ABITransactionType = /* @__PURE__ */ function(ABITransactionType$1) {
-	ABITransactionType$1["Txn"] = "txn";
-	ABITransactionType$1["Payment"] = "pay";
-	ABITransactionType$1["KeyRegistration"] = "keyreg";
-	ABITransactionType$1["AssetConfig"] = "acfg";
-	ABITransactionType$1["AssetTransfer"] = "axfer";
-	ABITransactionType$1["AssetFreeze"] = "afrz";
-	ABITransactionType$1["AppCall"] = "appl";
-	return ABITransactionType$1;
+let ABITransactionType = /* @__PURE__ */ function(ABITransactionType) {
+	ABITransactionType["Txn"] = "txn";
+	ABITransactionType["Payment"] = "pay";
+	ABITransactionType["KeyRegistration"] = "keyreg";
+	ABITransactionType["AssetConfig"] = "acfg";
+	ABITransactionType["AssetTransfer"] = "axfer";
+	ABITransactionType["AssetFreeze"] = "afrz";
+	ABITransactionType["AppCall"] = "appl";
+	return ABITransactionType;
 }({});
-let ABIReferenceType = /* @__PURE__ */ function(ABIReferenceType$1) {
-	ABIReferenceType$1["Account"] = "account";
-	ABIReferenceType$1["Application"] = "application";
-	ABIReferenceType$1["Asset"] = "asset";
-	return ABIReferenceType$1;
+let ABIReferenceType = /* @__PURE__ */ function(ABIReferenceType) {
+	ABIReferenceType["Account"] = "account";
+	ABIReferenceType["Application"] = "application";
+	ABIReferenceType["Asset"] = "asset";
+	return ABIReferenceType;
 }({});
 var ABIMethod = class ABIMethod {
 	name;
@@ -51,7 +50,7 @@ var ABIMethod = class ABIMethod {
 	* @returns The 4-byte method selector
 	*/
 	getSelector() {
-		const hash = js_sha512.default.sha512_256.array(this.getSignature());
+		const hash = (0, _noble_hashes_sha2_js.sha512_256)(new TextEncoder().encode(this.getSignature()));
 		return new Uint8Array(hash.slice(0, 4));
 	}
 	/**
@@ -139,7 +138,7 @@ function arc56MethodToABIMethod(method, appSpec) {
 	});
 	const returns = {
 		type: method.returns.type === "void" ? "void" : method.returns.struct ? require_abi_type.ABIStructType.fromStruct(method.returns.struct, appSpec.structs) : require_abi_type.ABIType.from(method.returns.type),
-		desc: method.returns.desc
+		description: method.returns.desc
 	};
 	return new ABIMethod({
 		name: method.name,

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

@@ -1 +1 @@
-{"version":3,"file":"abi-method.js","names":["sha512","parseTupleContent","ABIType","convertedDefaultValue: ABIDefaultValue | undefined","ABIStructType","ABIUintType","ABIAddressType"],"sources":["../../../../packages/abi/src/abi-method.ts"],"sourcesContent":["import sha512 from 'js-sha512'\nimport { ABIAddressType, ABIStructType, ABIType, ABIUintType, parseTupleContent } from './abi-type'\nimport { ABIValue } from './abi-value'\nimport { ARC28Event } from './arc28-event'\nimport { AVMType, Arc56Contract, Arc56Method } from './arc56-contract'\n\nexport enum ABITransactionType {\n  Txn = 'txn',\n  Payment = 'pay',\n  KeyRegistration = 'keyreg',\n  AssetConfig = 'acfg',\n  AssetTransfer = 'axfer',\n  AssetFreeze = 'afrz',\n  AppCall = 'appl',\n}\nexport enum ABIReferenceType {\n  Account = 'account',\n  Application = 'application',\n  Asset = 'asset',\n}\nexport type ABIMethodArgType = ABIType | ABITransactionType | ABIReferenceType\nexport type ABIMethodReturnType = ABIType | 'void'\n\nexport type ABIMethodArg = {\n  type: ABIMethodArgType\n  name?: string\n  description?: string\n  defaultValue?: ABIDefaultValue\n}\n\nexport type ABIMethodReturn = {\n  type: ABIMethodReturnType\n  description?: string\n}\n\nexport type ABIDefaultValue = {\n  /** Base64 encoded bytes, base64 ARC4 encoded uint64, or UTF-8 method selector */\n  data: string\n  /** Where the default value is coming from */\n  source: DefaultValueSource\n  /** How the data is encoded. This is the encoding for the data provided here, not the arg type */\n  type?: ABIType | AVMType\n}\n\nexport enum DefaultValueSource {\n  Box = 'box',\n  Global = 'global',\n  Local = 'local',\n  Literal = 'literal',\n  Method = 'method',\n}\n\n/** Represents an ABI method return value with parsed data. */\nexport type ABIReturn =\n  | {\n      /** The method that was called. */\n      method: ABIMethod\n      /** The raw return value as bytes.\n       *\n       * This is the value from the last app call log with the first 4 bytes (the ABI return prefix) omitted.\n       */\n      rawReturnValue: Uint8Array\n      /** The parsed ABI return value. */\n      returnValue: ABIValue\n      decodeError: undefined\n    }\n  | { rawReturnValue?: undefined; returnValue?: undefined; method: ABIMethod; decodeError?: Error }\n\n/** Decoded ARC-56 struct as a struct rather than a tuple. */\nexport type ABIStruct = {\n  [key: string]: ABIStruct | ABIValue\n}\n\nexport class ABIMethod {\n  readonly name: string\n  readonly description?: string\n  readonly args: ABIMethodArg[]\n  readonly returns: ABIMethodReturn\n  readonly events?: ARC28Event[]\n  readonly readonly?: boolean\n\n  constructor(params: {\n    name: string\n    description?: string\n    args: ABIMethodArg[]\n    returns: ABIMethodReturn\n    events?: ARC28Event[]\n    readonly?: boolean\n  }) {\n    this.name = params.name\n    this.description = params.description\n    this.args = params.args\n    this.returns = params.returns\n    this.events = params.events\n    this.readonly = params.readonly\n  }\n\n  /**\n   * Returns the signature of this ABI method.\n   * @returns The signature, e.g. `my_method(unit64,string)bytes`\n   */\n  getSignature(): string {\n    const args = this.args\n      .map((arg) => {\n        if (argTypeIsTransaction(arg.type) || argTypeIsReference(arg.type)) return arg.type\n        return arg.type.name\n      })\n      .join(',')\n    const returns = this.returns.type === 'void' ? 'void' : this.returns.type.name\n    return `${this.name}(${args})${returns}`\n  }\n\n  /**\n   * Returns the method selector of this ABI method.\n   * @returns The 4-byte method selector\n   */\n  getSelector(): Uint8Array {\n    const hash = sha512.sha512_256.array(this.getSignature())\n    return new Uint8Array(hash.slice(0, 4))\n  }\n\n  /**\n   * Returns the ABI method object for a given method signature.\n   * @param signature The method signature\n   * e.g. `my_method(unit64,string)bytes`\n   * @returns The `ABIMethod`\n   */\n  static fromSignature(signature: string): ABIMethod {\n    const argsStart = signature.indexOf('(')\n    if (argsStart === -1) {\n      throw new Error(`Invalid method signature: ${signature}`)\n    }\n\n    let argsEnd = -1\n    let depth = 0\n    for (let i = argsStart; i < signature.length; i++) {\n      const char = signature[i]\n\n      if (char === '(') {\n        depth += 1\n      } else if (char === ')') {\n        if (depth === 0) {\n          // unpaired parenthesis\n          break\n        }\n\n        depth -= 1\n        if (depth === 0) {\n          argsEnd = i\n          break\n        }\n      }\n    }\n\n    if (argsEnd === -1) {\n      throw new Error(`Invalid method signature: ${signature}`)\n    }\n\n    const name = signature.slice(0, argsStart)\n    const args = parseTupleContent(signature.slice(argsStart + 1, argsEnd)).map((n: string) => {\n      if (argTypeIsTransaction(n as ABIMethodArgType) || argTypeIsReference(n as ABIMethodArgType)) {\n        return { type: n as ABIMethodArgType } satisfies ABIMethodArg\n      }\n      return { type: ABIType.from(n) } satisfies ABIMethodArg\n    })\n    const returnType = signature.slice(argsEnd + 1)\n    const returns = { type: returnType === 'void' ? ('void' as const) : ABIType.from(returnType) } satisfies ABIMethodReturn\n\n    return new ABIMethod({\n      name,\n      args,\n      returns,\n    })\n  }\n}\n\n/**\n * Returns the ABI method object for a given method name or signature and ARC-56 app spec.\n * @param methodNameOrSignature The method name or method signature to call if an ABI call is being emitted.\n * e.g. `my_method` or `my_method(unit64,string)bytes`\n * @param appSpec The app spec for the app\n * @returns The `ABIMethod`\n */\nexport function getABIMethod(methodNameOrSignature: string, appSpec: Arc56Contract): ABIMethod {\n  if (!methodNameOrSignature.includes('(')) {\n    const methods = appSpec.methods.filter((m) => m.name === methodNameOrSignature)\n    if (methods.length === 0) throw new Error(`Unable to find method ${methodNameOrSignature} in ${appSpec.name} app.`)\n    if (methods.length > 1) {\n      throw new Error(\n        `Received a call to method ${methodNameOrSignature} in contract ${\n          appSpec.name\n        }, but this resolved to multiple methods; please pass in an ABI signature instead: ${appSpec.methods\n          .map((m) => getArc56MethodSignature(m))\n          .join(', ')}`,\n      )\n    }\n    return arc56MethodToABIMethod(methods[0], appSpec)\n  } else {\n    const method = appSpec.methods.find((m) => getArc56MethodSignature(m) === methodNameOrSignature)\n    if (!method) throw new Error(`Unable to find method ${methodNameOrSignature} in ${appSpec.name} app.`)\n    return arc56MethodToABIMethod(method, appSpec)\n  }\n}\n\nexport function arc56MethodToABIMethod(method: Arc56Method, appSpec: Arc56Contract): ABIMethod {\n  if (typeof method.name !== 'string' || typeof method.returns !== 'object' || !Array.isArray(method.args)) {\n    throw new Error('Invalid ABIMethod parameters')\n  }\n\n  const args = method.args.map(({ type, name, desc, struct, defaultValue }) => {\n    const convertedDefaultValue: ABIDefaultValue | undefined = defaultValue\n      ? {\n          data: defaultValue.data,\n          source: defaultValue.source as DefaultValueSource,\n          type: defaultValue.type ? (isAVMType(defaultValue.type) ? defaultValue.type : ABIType.from(defaultValue.type)) : undefined,\n        }\n      : undefined\n\n    if (argTypeIsTransaction(type as ABIMethodArgType) || argTypeIsReference(type as ABIMethodArgType)) {\n      return {\n        type: type as ABIMethodArgType,\n        name,\n        description: desc,\n        defaultValue: convertedDefaultValue,\n      } satisfies ABIMethodArg\n    }\n\n    if (struct) {\n      return {\n        type: ABIStructType.fromStruct(struct, appSpec.structs),\n        name,\n        description: desc,\n        defaultValue: convertedDefaultValue,\n      } satisfies ABIMethodArg\n    }\n\n    return {\n      type: ABIType.from(type),\n      name,\n      description: desc,\n      defaultValue: convertedDefaultValue,\n    } satisfies ABIMethodArg\n  })\n\n  const returns = {\n    type:\n      method.returns.type === ('void' as const)\n        ? ('void' as const)\n        : method.returns.struct\n          ? ABIStructType.fromStruct(method.returns.struct, appSpec.structs)\n          : ABIType.from(method.returns.type),\n    desc: method.returns.desc,\n  }\n\n  return new ABIMethod({\n    name: method.name,\n    description: method.desc,\n    args,\n    returns,\n    events: method.events,\n    readonly: method.readonly,\n  })\n}\n\nexport function argTypeIsTransaction(type: ABIMethodArgType): type is ABITransactionType {\n  return (\n    typeof type === 'string' &&\n    (type === ABITransactionType.Txn ||\n      type === ABITransactionType.Payment ||\n      type === ABITransactionType.KeyRegistration ||\n      type === ABITransactionType.AssetConfig ||\n      type === ABITransactionType.AssetTransfer ||\n      type === ABITransactionType.AssetFreeze ||\n      type === ABITransactionType.AppCall)\n  )\n}\n\nexport function argTypeIsReference(type: ABIMethodArgType): type is ABIReferenceType {\n  return (\n    typeof type === 'string' &&\n    (type === ABIReferenceType.Account || type === ABIReferenceType.Application || type === ABIReferenceType.Asset)\n  )\n}\n\nexport function argTypeIsAbiType(type: ABIMethodArgType): type is ABIType {\n  return !argTypeIsTransaction(type) && !argTypeIsReference(type)\n}\n\nfunction getArc56MethodSignature(method: Arc56Method): string {\n  const args = method.args.map((arg) => arg.type).join(',')\n  const returns = method.returns.type\n  return `${method.name}(${args})${returns}`\n}\n\nexport function decodeAVMValue(avmType: AVMType, bytes: Uint8Array): ABIValue {\n  switch (avmType) {\n    case 'AVMString':\n      return Buffer.from(bytes).toString('utf-8')\n    case 'AVMBytes':\n      return bytes\n    case 'AVMUint64':\n      return ABIType.from('uint64').decode(bytes)\n  }\n}\n\nexport function encodeAVMValue(avmType: AVMType, value: ABIValue): Uint8Array {\n  switch (avmType) {\n    case 'AVMString':\n      return ABIType.from('string').encode(value)\n    case 'AVMBytes':\n      if (typeof value === 'string') return Buffer.from(value, 'utf-8')\n      if (typeof value !== 'object' || !(value instanceof Uint8Array))\n        throw new Error(`Expected bytes value for AVMBytes, but got ${value}`)\n      return value\n    case 'AVMUint64':\n      return ABIType.from('uint64').encode(value)\n  }\n}\n\nexport function isAVMType(type: unknown): type is AVMType {\n  return typeof type === 'string' && (type === 'AVMString' || type === 'AVMBytes' || type === 'AVMUint64')\n}\n\nexport function getABIDecodedValue(type: AVMType | ABIType | ABIReferenceType, bytes: Uint8Array): ABIValue {\n  if (type === ABIReferenceType.Asset || type === ABIReferenceType.Application) {\n    return new ABIUintType(64).decode(bytes)\n  } else if (type === ABIReferenceType.Account) {\n    return new ABIAddressType().decode(bytes)\n  } else if (isAVMType(type)) {\n    return decodeAVMValue(type, bytes)\n  }\n  return type.decode(bytes)\n}\n\nexport function getABIEncodedValue(type: AVMType | ABIType, value: ABIValue): Uint8Array {\n  return isAVMType(type) ? encodeAVMValue(type, value) : type.encode(value)\n}\n"],"mappings":";;;;;;AAMA,IAAY,oEAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;;;AAEF,IAAY,gEAAL;AACL;AACA;AACA;;;AAuDF,IAAa,YAAb,MAAa,UAAU;CACrB,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAS;CAET,YAAY,QAOT;AACD,OAAK,OAAO,OAAO;AACnB,OAAK,cAAc,OAAO;AAC1B,OAAK,OAAO,OAAO;AACnB,OAAK,UAAU,OAAO;AACtB,OAAK,SAAS,OAAO;AACrB,OAAK,WAAW,OAAO;;;;;;CAOzB,eAAuB;EACrB,MAAM,OAAO,KAAK,KACf,KAAK,QAAQ;AACZ,OAAI,qBAAqB,IAAI,KAAK,IAAI,mBAAmB,IAAI,KAAK,CAAE,QAAO,IAAI;AAC/E,UAAO,IAAI,KAAK;IAChB,CACD,KAAK,IAAI;AAEZ,SAAO,GAAG,KAAK,KAAK,GAAG,KAAK,GADZ,KAAK,QAAQ,SAAS,SAAS,SAAS,KAAK,QAAQ,KAAK;;;;;;CAQ5E,cAA0B;EACxB,MAAM,OAAOA,kBAAO,WAAW,MAAM,KAAK,cAAc,CAAC;AACzD,SAAO,IAAI,WAAW,KAAK,MAAM,GAAG,EAAE,CAAC;;;;;;;;CASzC,OAAO,cAAc,WAA8B;EACjD,MAAM,YAAY,UAAU,QAAQ,IAAI;AACxC,MAAI,cAAc,GAChB,OAAM,IAAI,MAAM,6BAA6B,YAAY;EAG3D,IAAI,UAAU;EACd,IAAI,QAAQ;AACZ,OAAK,IAAI,IAAI,WAAW,IAAI,UAAU,QAAQ,KAAK;GACjD,MAAM,OAAO,UAAU;AAEvB,OAAI,SAAS,IACX,UAAS;YACA,SAAS,KAAK;AACvB,QAAI,UAAU,EAEZ;AAGF,aAAS;AACT,QAAI,UAAU,GAAG;AACf,eAAU;AACV;;;;AAKN,MAAI,YAAY,GACd,OAAM,IAAI,MAAM,6BAA6B,YAAY;EAG3D,MAAM,OAAO,UAAU,MAAM,GAAG,UAAU;EAC1C,MAAM,OAAOC,mCAAkB,UAAU,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,KAAK,MAAc;AACzF,OAAI,qBAAqB,EAAsB,IAAI,mBAAmB,EAAsB,CAC1F,QAAO,EAAE,MAAM,GAAuB;AAExC,UAAO,EAAE,MAAMC,yBAAQ,KAAK,EAAE,EAAE;IAChC;EACF,MAAM,aAAa,UAAU,MAAM,UAAU,EAAE;AAG/C,SAAO,IAAI,UAAU;GACnB;GACA;GACA,SALc,EAAE,MAAM,eAAe,SAAU,SAAmBA,yBAAQ,KAAK,WAAW,EAAE;GAM7F,CAAC;;;;;;;;;;AAWN,SAAgB,aAAa,uBAA+B,SAAmC;AAC7F,KAAI,CAAC,sBAAsB,SAAS,IAAI,EAAE;EACxC,MAAM,UAAU,QAAQ,QAAQ,QAAQ,MAAM,EAAE,SAAS,sBAAsB;AAC/E,MAAI,QAAQ,WAAW,EAAG,OAAM,IAAI,MAAM,yBAAyB,sBAAsB,MAAM,QAAQ,KAAK,OAAO;AACnH,MAAI,QAAQ,SAAS,EACnB,OAAM,IAAI,MACR,6BAA6B,sBAAsB,eACjD,QAAQ,KACT,oFAAoF,QAAQ,QAC1F,KAAK,MAAM,wBAAwB,EAAE,CAAC,CACtC,KAAK,KAAK,GACd;AAEH,SAAO,uBAAuB,QAAQ,IAAI,QAAQ;QAC7C;EACL,MAAM,SAAS,QAAQ,QAAQ,MAAM,MAAM,wBAAwB,EAAE,KAAK,sBAAsB;AAChG,MAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,yBAAyB,sBAAsB,MAAM,QAAQ,KAAK,OAAO;AACtG,SAAO,uBAAuB,QAAQ,QAAQ;;;AAIlD,SAAgB,uBAAuB,QAAqB,SAAmC;AAC7F,KAAI,OAAO,OAAO,SAAS,YAAY,OAAO,OAAO,YAAY,YAAY,CAAC,MAAM,QAAQ,OAAO,KAAK,CACtG,OAAM,IAAI,MAAM,+BAA+B;CAGjD,MAAM,OAAO,OAAO,KAAK,KAAK,EAAE,MAAM,MAAM,MAAM,QAAQ,mBAAmB;EAC3E,MAAMC,wBAAqD,eACvD;GACE,MAAM,aAAa;GACnB,QAAQ,aAAa;GACrB,MAAM,aAAa,OAAQ,UAAU,aAAa,KAAK,GAAG,aAAa,OAAOD,yBAAQ,KAAK,aAAa,KAAK,GAAI;GAClH,GACD;AAEJ,MAAI,qBAAqB,KAAyB,IAAI,mBAAmB,KAAyB,CAChG,QAAO;GACC;GACN;GACA,aAAa;GACb,cAAc;GACf;AAGH,MAAI,OACF,QAAO;GACL,MAAME,+BAAc,WAAW,QAAQ,QAAQ,QAAQ;GACvD;GACA,aAAa;GACb,cAAc;GACf;AAGH,SAAO;GACL,MAAMF,yBAAQ,KAAK,KAAK;GACxB;GACA,aAAa;GACb,cAAc;GACf;GACD;CAEF,MAAM,UAAU;EACd,MACE,OAAO,QAAQ,SAAU,SACpB,SACD,OAAO,QAAQ,SACbE,+BAAc,WAAW,OAAO,QAAQ,QAAQ,QAAQ,QAAQ,GAChEF,yBAAQ,KAAK,OAAO,QAAQ,KAAK;EACzC,MAAM,OAAO,QAAQ;EACtB;AAED,QAAO,IAAI,UAAU;EACnB,MAAM,OAAO;EACb,aAAa,OAAO;EACpB;EACA;EACA,QAAQ,OAAO;EACf,UAAU,OAAO;EAClB,CAAC;;AAGJ,SAAgB,qBAAqB,MAAoD;AACvF,QACE,OAAO,SAAS,aACf,SAAS,mBAAmB,OAC3B,SAAS,mBAAmB,WAC5B,SAAS,mBAAmB,mBAC5B,SAAS,mBAAmB,eAC5B,SAAS,mBAAmB,iBAC5B,SAAS,mBAAmB,eAC5B,SAAS,mBAAmB;;AAIlC,SAAgB,mBAAmB,MAAkD;AACnF,QACE,OAAO,SAAS,aACf,SAAS,iBAAiB,WAAW,SAAS,iBAAiB,eAAe,SAAS,iBAAiB;;AAI7G,SAAgB,iBAAiB,MAAyC;AACxE,QAAO,CAAC,qBAAqB,KAAK,IAAI,CAAC,mBAAmB,KAAK;;AAGjE,SAAS,wBAAwB,QAA6B;CAC5D,MAAM,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,IAAI;AAEzD,QAAO,GAAG,OAAO,KAAK,GAAG,KAAK,GADd,OAAO,QAAQ;;AAIjC,SAAgB,eAAe,SAAkB,OAA6B;AAC5E,SAAQ,SAAR;EACE,KAAK,YACH,QAAO,OAAO,KAAK,MAAM,CAAC,SAAS,QAAQ;EAC7C,KAAK,WACH,QAAO;EACT,KAAK,YACH,QAAOA,yBAAQ,KAAK,SAAS,CAAC,OAAO,MAAM;;;AAIjD,SAAgB,eAAe,SAAkB,OAA6B;AAC5E,SAAQ,SAAR;EACE,KAAK,YACH,QAAOA,yBAAQ,KAAK,SAAS,CAAC,OAAO,MAAM;EAC7C,KAAK;AACH,OAAI,OAAO,UAAU,SAAU,QAAO,OAAO,KAAK,OAAO,QAAQ;AACjE,OAAI,OAAO,UAAU,YAAY,EAAE,iBAAiB,YAClD,OAAM,IAAI,MAAM,8CAA8C,QAAQ;AACxE,UAAO;EACT,KAAK,YACH,QAAOA,yBAAQ,KAAK,SAAS,CAAC,OAAO,MAAM;;;AAIjD,SAAgB,UAAU,MAAgC;AACxD,QAAO,OAAO,SAAS,aAAa,SAAS,eAAe,SAAS,cAAc,SAAS;;AAG9F,SAAgB,mBAAmB,MAA4C,OAA6B;AAC1G,KAAI,SAAS,iBAAiB,SAAS,SAAS,iBAAiB,YAC/D,QAAO,IAAIG,6BAAY,GAAG,CAAC,OAAO,MAAM;UAC/B,SAAS,iBAAiB,QACnC,QAAO,IAAIC,iCAAgB,CAAC,OAAO,MAAM;UAChC,UAAU,KAAK,CACxB,QAAO,eAAe,MAAM,MAAM;AAEpC,QAAO,KAAK,OAAO,MAAM;;AAG3B,SAAgB,mBAAmB,MAAyB,OAA6B;AACvF,QAAO,UAAU,KAAK,GAAG,eAAe,MAAM,MAAM,GAAG,KAAK,OAAO,MAAM"}
+{"version":3,"file":"abi-method.js","names":["parseTupleContent","ABIType","ABIStructType","ABIUintType","ABIAddressType"],"sources":["../../../../packages/abi/src/abi-method.ts"],"sourcesContent":["import { sha512_256 } from '@noble/hashes/sha2.js'\nimport { ABIAddressType, ABIStructType, ABIType, ABIUintType, parseTupleContent } from './abi-type'\nimport { ABIValue } from './abi-value'\nimport { ARC28Event } from './arc28-event'\nimport { AVMType, Arc56Contract, Arc56Method } from './arc56-contract'\n\nexport enum ABITransactionType {\n  Txn = 'txn',\n  Payment = 'pay',\n  KeyRegistration = 'keyreg',\n  AssetConfig = 'acfg',\n  AssetTransfer = 'axfer',\n  AssetFreeze = 'afrz',\n  AppCall = 'appl',\n}\nexport enum ABIReferenceType {\n  Account = 'account',\n  Application = 'application',\n  Asset = 'asset',\n}\nexport type ABIMethodArgType = ABIType | ABITransactionType | ABIReferenceType\nexport type ABIMethodReturnType = ABIType | 'void'\n\nexport type ABIMethodArg = {\n  type: ABIMethodArgType\n  name?: string\n  description?: string\n  defaultValue?: ABIDefaultValue\n}\n\nexport type ABIMethodReturn = {\n  type: ABIMethodReturnType\n  description?: string\n}\n\nexport type ABIDefaultValue = {\n  /** Base64 encoded bytes, base64 ARC4 encoded uint64, or UTF-8 method selector */\n  data: string\n  /** Where the default value is coming from */\n  source: DefaultValueSource\n  /** How the data is encoded. This is the encoding for the data provided here, not the arg type */\n  type?: ABIType | AVMType\n}\n\nexport enum DefaultValueSource {\n  Box = 'box',\n  Global = 'global',\n  Local = 'local',\n  Literal = 'literal',\n  Method = 'method',\n}\n\n/** Represents an ABI method return value with parsed data. */\nexport type ABIReturn =\n  | {\n      /** The method that was called. */\n      method: ABIMethod\n      /** The raw return value as bytes.\n       *\n       * This is the value from the last app call log with the first 4 bytes (the ABI return prefix) omitted.\n       */\n      rawReturnValue: Uint8Array\n      /** The parsed ABI return value. */\n      returnValue: ABIValue\n      decodeError: undefined\n    }\n  | { rawReturnValue?: undefined; returnValue?: undefined; method: ABIMethod; decodeError?: Error }\n\n/** Decoded ARC-56 struct as a struct rather than a tuple. */\nexport type ABIStruct = {\n  [key: string]: ABIStruct | ABIValue\n}\n\nexport class ABIMethod {\n  readonly name: string\n  readonly description?: string\n  readonly args: ABIMethodArg[]\n  readonly returns: ABIMethodReturn\n  readonly events?: ARC28Event[]\n  readonly readonly?: boolean\n\n  constructor(params: {\n    name: string\n    description?: string\n    args: ABIMethodArg[]\n    returns: ABIMethodReturn\n    events?: ARC28Event[]\n    readonly?: boolean\n  }) {\n    this.name = params.name\n    this.description = params.description\n    this.args = params.args\n    this.returns = params.returns\n    this.events = params.events\n    this.readonly = params.readonly\n  }\n\n  /**\n   * Returns the signature of this ABI method.\n   * @returns The signature, e.g. `my_method(unit64,string)bytes`\n   */\n  getSignature(): string {\n    const args = this.args\n      .map((arg) => {\n        if (argTypeIsTransaction(arg.type) || argTypeIsReference(arg.type)) return arg.type\n        return arg.type.name\n      })\n      .join(',')\n    const returns = this.returns.type === 'void' ? 'void' : this.returns.type.name\n    return `${this.name}(${args})${returns}`\n  }\n\n  /**\n   * Returns the method selector of this ABI method.\n   * @returns The 4-byte method selector\n   */\n  getSelector(): Uint8Array {\n    const hash = sha512_256(new TextEncoder().encode(this.getSignature()))\n    return new Uint8Array(hash.slice(0, 4))\n  }\n\n  /**\n   * Returns the ABI method object for a given method signature.\n   * @param signature The method signature\n   * e.g. `my_method(unit64,string)bytes`\n   * @returns The `ABIMethod`\n   */\n  static fromSignature(signature: string): ABIMethod {\n    const argsStart = signature.indexOf('(')\n    if (argsStart === -1) {\n      throw new Error(`Invalid method signature: ${signature}`)\n    }\n\n    let argsEnd = -1\n    let depth = 0\n    for (let i = argsStart; i < signature.length; i++) {\n      const char = signature[i]\n\n      if (char === '(') {\n        depth += 1\n      } else if (char === ')') {\n        if (depth === 0) {\n          // unpaired parenthesis\n          break\n        }\n\n        depth -= 1\n        if (depth === 0) {\n          argsEnd = i\n          break\n        }\n      }\n    }\n\n    if (argsEnd === -1) {\n      throw new Error(`Invalid method signature: ${signature}`)\n    }\n\n    const name = signature.slice(0, argsStart)\n    const args = parseTupleContent(signature.slice(argsStart + 1, argsEnd)).map((n: string) => {\n      if (argTypeIsTransaction(n as ABIMethodArgType) || argTypeIsReference(n as ABIMethodArgType)) {\n        return { type: n as ABIMethodArgType } satisfies ABIMethodArg\n      }\n      return { type: ABIType.from(n) } satisfies ABIMethodArg\n    })\n    const returnType = signature.slice(argsEnd + 1)\n    const returns = { type: returnType === 'void' ? ('void' as const) : ABIType.from(returnType) } satisfies ABIMethodReturn\n\n    return new ABIMethod({\n      name,\n      args,\n      returns,\n    })\n  }\n}\n\n/**\n * Returns the ABI method object for a given method name or signature and ARC-56 app spec.\n * @param methodNameOrSignature The method name or method signature to call if an ABI call is being emitted.\n * e.g. `my_method` or `my_method(unit64,string)bytes`\n * @param appSpec The app spec for the app\n * @returns The `ABIMethod`\n */\nexport function getABIMethod(methodNameOrSignature: string, appSpec: Arc56Contract): ABIMethod {\n  if (!methodNameOrSignature.includes('(')) {\n    const methods = appSpec.methods.filter((m) => m.name === methodNameOrSignature)\n    if (methods.length === 0) throw new Error(`Unable to find method ${methodNameOrSignature} in ${appSpec.name} app.`)\n    if (methods.length > 1) {\n      throw new Error(\n        `Received a call to method ${methodNameOrSignature} in contract ${\n          appSpec.name\n        }, but this resolved to multiple methods; please pass in an ABI signature instead: ${appSpec.methods\n          .map((m) => getArc56MethodSignature(m))\n          .join(', ')}`,\n      )\n    }\n    return arc56MethodToABIMethod(methods[0], appSpec)\n  } else {\n    const method = appSpec.methods.find((m) => getArc56MethodSignature(m) === methodNameOrSignature)\n    if (!method) throw new Error(`Unable to find method ${methodNameOrSignature} in ${appSpec.name} app.`)\n    return arc56MethodToABIMethod(method, appSpec)\n  }\n}\n\nexport function arc56MethodToABIMethod(method: Arc56Method, appSpec: Arc56Contract): ABIMethod {\n  if (typeof method.name !== 'string' || typeof method.returns !== 'object' || !Array.isArray(method.args)) {\n    throw new Error('Invalid ABIMethod parameters')\n  }\n\n  const args = method.args.map(({ type, name, desc, struct, defaultValue }) => {\n    const convertedDefaultValue: ABIDefaultValue | undefined = defaultValue\n      ? {\n          data: defaultValue.data,\n          source: defaultValue.source as DefaultValueSource,\n          type: defaultValue.type ? (isAVMType(defaultValue.type) ? defaultValue.type : ABIType.from(defaultValue.type)) : undefined,\n        }\n      : undefined\n\n    if (argTypeIsTransaction(type as ABIMethodArgType) || argTypeIsReference(type as ABIMethodArgType)) {\n      return {\n        type: type as ABIMethodArgType,\n        name,\n        description: desc,\n        defaultValue: convertedDefaultValue,\n      } satisfies ABIMethodArg\n    }\n\n    if (struct) {\n      return {\n        type: ABIStructType.fromStruct(struct, appSpec.structs),\n        name,\n        description: desc,\n        defaultValue: convertedDefaultValue,\n      } satisfies ABIMethodArg\n    }\n\n    return {\n      type: ABIType.from(type),\n      name,\n      description: desc,\n      defaultValue: convertedDefaultValue,\n    } satisfies ABIMethodArg\n  })\n\n  const returns = {\n    type:\n      method.returns.type === ('void' as const)\n        ? ('void' as const)\n        : method.returns.struct\n          ? ABIStructType.fromStruct(method.returns.struct, appSpec.structs)\n          : ABIType.from(method.returns.type),\n    description: method.returns.desc,\n  } satisfies ABIMethodReturn\n\n  return new ABIMethod({\n    name: method.name,\n    description: method.desc,\n    args,\n    returns,\n    events: method.events,\n    readonly: method.readonly,\n  })\n}\n\nexport function argTypeIsTransaction(type: ABIMethodArgType): type is ABITransactionType {\n  return (\n    typeof type === 'string' &&\n    (type === ABITransactionType.Txn ||\n      type === ABITransactionType.Payment ||\n      type === ABITransactionType.KeyRegistration ||\n      type === ABITransactionType.AssetConfig ||\n      type === ABITransactionType.AssetTransfer ||\n      type === ABITransactionType.AssetFreeze ||\n      type === ABITransactionType.AppCall)\n  )\n}\n\nexport function argTypeIsReference(type: ABIMethodArgType): type is ABIReferenceType {\n  return (\n    typeof type === 'string' &&\n    (type === ABIReferenceType.Account || type === ABIReferenceType.Application || type === ABIReferenceType.Asset)\n  )\n}\n\nexport function argTypeIsAbiType(type: ABIMethodArgType): type is ABIType {\n  return !argTypeIsTransaction(type) && !argTypeIsReference(type)\n}\n\nfunction getArc56MethodSignature(method: Arc56Method): string {\n  const args = method.args.map((arg) => arg.type).join(',')\n  const returns = method.returns.type\n  return `${method.name}(${args})${returns}`\n}\n\nexport function decodeAVMValue(avmType: AVMType, bytes: Uint8Array): ABIValue {\n  switch (avmType) {\n    case 'AVMString':\n      return Buffer.from(bytes).toString('utf-8')\n    case 'AVMBytes':\n      return bytes\n    case 'AVMUint64':\n      return ABIType.from('uint64').decode(bytes)\n  }\n}\n\nexport function encodeAVMValue(avmType: AVMType, value: ABIValue): Uint8Array {\n  switch (avmType) {\n    case 'AVMString':\n      return ABIType.from('string').encode(value)\n    case 'AVMBytes':\n      if (typeof value === 'string') return Buffer.from(value, 'utf-8')\n      if (typeof value !== 'object' || !(value instanceof Uint8Array))\n        throw new Error(`Expected bytes value for AVMBytes, but got ${value}`)\n      return value\n    case 'AVMUint64':\n      return ABIType.from('uint64').encode(value)\n  }\n}\n\nexport function isAVMType(type: unknown): type is AVMType {\n  return typeof type === 'string' && (type === 'AVMString' || type === 'AVMBytes' || type === 'AVMUint64')\n}\n\nexport function getABIDecodedValue(type: AVMType | ABIType | ABIReferenceType, bytes: Uint8Array): ABIValue {\n  if (type === ABIReferenceType.Asset || type === ABIReferenceType.Application) {\n    return new ABIUintType(64).decode(bytes)\n  } else if (type === ABIReferenceType.Account) {\n    return new ABIAddressType().decode(bytes)\n  } else if (isAVMType(type)) {\n    return decodeAVMValue(type, bytes)\n  }\n  return type.decode(bytes)\n}\n\nexport function getABIEncodedValue(type: AVMType | ABIType, value: ABIValue): Uint8Array {\n  return isAVMType(type) ? encodeAVMValue(type, value) : type.encode(value)\n}\n"],"mappings":";;;;;AAMA,IAAY,kEAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;;;AAEF,IAAY,8DAAL;AACL;AACA;AACA;;;AAuDF,IAAa,YAAb,MAAa,UAAU;CACrB,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAS;CAET,YAAY,QAOT;AACD,OAAK,OAAO,OAAO;AACnB,OAAK,cAAc,OAAO;AAC1B,OAAK,OAAO,OAAO;AACnB,OAAK,UAAU,OAAO;AACtB,OAAK,SAAS,OAAO;AACrB,OAAK,WAAW,OAAO;;;;;;CAOzB,eAAuB;EACrB,MAAM,OAAO,KAAK,KACf,KAAK,QAAQ;AACZ,OAAI,qBAAqB,IAAI,KAAK,IAAI,mBAAmB,IAAI,KAAK,CAAE,QAAO,IAAI;AAC/E,UAAO,IAAI,KAAK;IAChB,CACD,KAAK,IAAI;AAEZ,SAAO,GAAG,KAAK,KAAK,GAAG,KAAK,GADZ,KAAK,QAAQ,SAAS,SAAS,SAAS,KAAK,QAAQ,KAAK;;;;;;CAQ5E,cAA0B;EACxB,MAAM,6CAAkB,IAAI,aAAa,CAAC,OAAO,KAAK,cAAc,CAAC,CAAC;AACtE,SAAO,IAAI,WAAW,KAAK,MAAM,GAAG,EAAE,CAAC;;;;;;;;CASzC,OAAO,cAAc,WAA8B;EACjD,MAAM,YAAY,UAAU,QAAQ,IAAI;AACxC,MAAI,cAAc,GAChB,OAAM,IAAI,MAAM,6BAA6B,YAAY;EAG3D,IAAI,UAAU;EACd,IAAI,QAAQ;AACZ,OAAK,IAAI,IAAI,WAAW,IAAI,UAAU,QAAQ,KAAK;GACjD,MAAM,OAAO,UAAU;AAEvB,OAAI,SAAS,IACX,UAAS;YACA,SAAS,KAAK;AACvB,QAAI,UAAU,EAEZ;AAGF,aAAS;AACT,QAAI,UAAU,GAAG;AACf,eAAU;AACV;;;;AAKN,MAAI,YAAY,GACd,OAAM,IAAI,MAAM,6BAA6B,YAAY;EAG3D,MAAM,OAAO,UAAU,MAAM,GAAG,UAAU;EAC1C,MAAM,OAAOA,mCAAkB,UAAU,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,KAAK,MAAc;AACzF,OAAI,qBAAqB,EAAsB,IAAI,mBAAmB,EAAsB,CAC1F,QAAO,EAAE,MAAM,GAAuB;AAExC,UAAO,EAAE,MAAMC,yBAAQ,KAAK,EAAE,EAAE;IAChC;EACF,MAAM,aAAa,UAAU,MAAM,UAAU,EAAE;AAG/C,SAAO,IAAI,UAAU;GACnB;GACA;GACA,SALc,EAAE,MAAM,eAAe,SAAU,SAAmBA,yBAAQ,KAAK,WAAW,EAAE;GAM7F,CAAC;;;;;;;;;;AAWN,SAAgB,aAAa,uBAA+B,SAAmC;AAC7F,KAAI,CAAC,sBAAsB,SAAS,IAAI,EAAE;EACxC,MAAM,UAAU,QAAQ,QAAQ,QAAQ,MAAM,EAAE,SAAS,sBAAsB;AAC/E,MAAI,QAAQ,WAAW,EAAG,OAAM,IAAI,MAAM,yBAAyB,sBAAsB,MAAM,QAAQ,KAAK,OAAO;AACnH,MAAI,QAAQ,SAAS,EACnB,OAAM,IAAI,MACR,6BAA6B,sBAAsB,eACjD,QAAQ,KACT,oFAAoF,QAAQ,QAC1F,KAAK,MAAM,wBAAwB,EAAE,CAAC,CACtC,KAAK,KAAK,GACd;AAEH,SAAO,uBAAuB,QAAQ,IAAI,QAAQ;QAC7C;EACL,MAAM,SAAS,QAAQ,QAAQ,MAAM,MAAM,wBAAwB,EAAE,KAAK,sBAAsB;AAChG,MAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,yBAAyB,sBAAsB,MAAM,QAAQ,KAAK,OAAO;AACtG,SAAO,uBAAuB,QAAQ,QAAQ;;;AAIlD,SAAgB,uBAAuB,QAAqB,SAAmC;AAC7F,KAAI,OAAO,OAAO,SAAS,YAAY,OAAO,OAAO,YAAY,YAAY,CAAC,MAAM,QAAQ,OAAO,KAAK,CACtG,OAAM,IAAI,MAAM,+BAA+B;CAGjD,MAAM,OAAO,OAAO,KAAK,KAAK,EAAE,MAAM,MAAM,MAAM,QAAQ,mBAAmB;EAC3E,MAAM,wBAAqD,eACvD;GACE,MAAM,aAAa;GACnB,QAAQ,aAAa;GACrB,MAAM,aAAa,OAAQ,UAAU,aAAa,KAAK,GAAG,aAAa,OAAOA,yBAAQ,KAAK,aAAa,KAAK,GAAI;GAClH,GACD;AAEJ,MAAI,qBAAqB,KAAyB,IAAI,mBAAmB,KAAyB,CAChG,QAAO;GACC;GACN;GACA,aAAa;GACb,cAAc;GACf;AAGH,MAAI,OACF,QAAO;GACL,MAAMC,+BAAc,WAAW,QAAQ,QAAQ,QAAQ;GACvD;GACA,aAAa;GACb,cAAc;GACf;AAGH,SAAO;GACL,MAAMD,yBAAQ,KAAK,KAAK;GACxB;GACA,aAAa;GACb,cAAc;GACf;GACD;CAEF,MAAM,UAAU;EACd,MACE,OAAO,QAAQ,SAAU,SACpB,SACD,OAAO,QAAQ,SACbC,+BAAc,WAAW,OAAO,QAAQ,QAAQ,QAAQ,QAAQ,GAChED,yBAAQ,KAAK,OAAO,QAAQ,KAAK;EACzC,aAAa,OAAO,QAAQ;EAC7B;AAED,QAAO,IAAI,UAAU;EACnB,MAAM,OAAO;EACb,aAAa,OAAO;EACpB;EACA;EACA,QAAQ,OAAO;EACf,UAAU,OAAO;EAClB,CAAC;;AAGJ,SAAgB,qBAAqB,MAAoD;AACvF,QACE,OAAO,SAAS,aACf,SAAS,mBAAmB,OAC3B,SAAS,mBAAmB,WAC5B,SAAS,mBAAmB,mBAC5B,SAAS,mBAAmB,eAC5B,SAAS,mBAAmB,iBAC5B,SAAS,mBAAmB,eAC5B,SAAS,mBAAmB;;AAIlC,SAAgB,mBAAmB,MAAkD;AACnF,QACE,OAAO,SAAS,aACf,SAAS,iBAAiB,WAAW,SAAS,iBAAiB,eAAe,SAAS,iBAAiB;;AAI7G,SAAgB,iBAAiB,MAAyC;AACxE,QAAO,CAAC,qBAAqB,KAAK,IAAI,CAAC,mBAAmB,KAAK;;AAGjE,SAAS,wBAAwB,QAA6B;CAC5D,MAAM,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,IAAI;AAEzD,QAAO,GAAG,OAAO,KAAK,GAAG,KAAK,GADd,OAAO,QAAQ;;AAIjC,SAAgB,eAAe,SAAkB,OAA6B;AAC5E,SAAQ,SAAR;EACE,KAAK,YACH,QAAO,OAAO,KAAK,MAAM,CAAC,SAAS,QAAQ;EAC7C,KAAK,WACH,QAAO;EACT,KAAK,YACH,QAAOA,yBAAQ,KAAK,SAAS,CAAC,OAAO,MAAM;;;AAIjD,SAAgB,eAAe,SAAkB,OAA6B;AAC5E,SAAQ,SAAR;EACE,KAAK,YACH,QAAOA,yBAAQ,KAAK,SAAS,CAAC,OAAO,MAAM;EAC7C,KAAK;AACH,OAAI,OAAO,UAAU,SAAU,QAAO,OAAO,KAAK,OAAO,QAAQ;AACjE,OAAI,OAAO,UAAU,YAAY,EAAE,iBAAiB,YAClD,OAAM,IAAI,MAAM,8CAA8C,QAAQ;AACxE,UAAO;EACT,KAAK,YACH,QAAOA,yBAAQ,KAAK,SAAS,CAAC,OAAO,MAAM;;;AAIjD,SAAgB,UAAU,MAAgC;AACxD,QAAO,OAAO,SAAS,aAAa,SAAS,eAAe,SAAS,cAAc,SAAS;;AAG9F,SAAgB,mBAAmB,MAA4C,OAA6B;AAC1G,KAAI,SAAS,iBAAiB,SAAS,SAAS,iBAAiB,YAC/D,QAAO,IAAIE,6BAAY,GAAG,CAAC,OAAO,MAAM;UAC/B,SAAS,iBAAiB,QACnC,QAAO,IAAIC,iCAAgB,CAAC,OAAO,MAAM;UAChC,UAAU,KAAK,CACxB,QAAO,eAAe,MAAM,MAAM;AAEpC,QAAO,KAAK,OAAO,MAAM;;AAG3B,SAAgB,mBAAmB,MAAyB,OAA6B;AACvF,QAAO,UAAU,KAAK,GAAG,eAAe,MAAM,MAAM,GAAG,KAAK,OAAO,MAAM"}