@algorandfoundation/algokit-utils 10.0.0-alpha.1 → 10.0.0-alpha.11

package/types/kmd-account-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"kmd-account-manager.js","names":["ClientManager","nacl","generateAddressWithSigners","getOptionalAddress","TransactionComposer","AlgoAmount"],"sources":["../../src/types/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 { Config } from '../config'\nimport { AlgoAmount } from './amount'\nimport { ClientManager } from './client-manager'\nimport { TransactionComposer } from './composer'\nimport { AddressWithTransactionSigner, generateAddressWithSigners } from '@algorandfoundation/algokit-transact'\nimport nacl from 'tweetnacl'\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    const kmd = await this.kmd()\n\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\n    const walletId = wallet[0].id\n\n    const walletHandle = (await kmd.initWalletHandle({ walletId, walletPassword: '' })).walletHandleToken\n    const addresses = (await kmd.listKeysInWallet({ walletHandleToken: walletHandle })).addresses\n\n    let i = 0\n    if (predicate) {\n      for (i = 0; i < addresses.length; i++) {\n        const address = addresses[i]\n        const account = await this._clientManager.algod.accountInformation(address)\n        if (predicate(account)) {\n          break\n        }\n      }\n    }\n\n    if (i >= addresses.length) {\n      return undefined\n    }\n\n    const accountKey = (\n      await kmd.exportKey({\n        walletHandleToken: walletHandle,\n        address: addresses[i],\n      })\n    ).privateKey\n\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({\n        amount: fundWith ?? AlgoAmount.Algo(1000),\n        receiver: account.addr,\n        sender: dispenser.addr,\n      })\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\n    const dispenser = await this.getWalletAccount('unencrypted-default-wallet', (a) => a.status !== 'Offline' && a.amount > 1_000_000_000)\n    if (!dispenser) {\n      throw new Error(\"Error retrieving LocalNet dispenser account; couldn't find the default account in KMD\")\n    }\n\n    return dispenser\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"kmd-account-manager.js","names":["ClientManager","matchedAddress: Address | undefined","Address","nacl","generateAddressWithSigners","getOptionalAddress","TransactionComposer","AlgoAmount"],"sources":["../../src/types/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 { Config } from '../config'\nimport { AlgoAmount } from './amount'\nimport { ClientManager } from './client-manager'\nimport { TransactionComposer } from './composer'\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/types/kmd-account-manager.mjs

@@ -1,4 +1,4 @@
-import { getOptionalAddress } from "../packages/common/src/address.mjs";
+import { Address, getOptionalAddress } from "../packages/common/src/address.mjs";
 import { generateAddressWithSigners } from "../packages/transact/src/signer.mjs";
 import { AlgoAmount } from "./amount.mjs";
 import { Config } from "../config.mjs";
@@ -55,6 +55,9 @@ var KmdAccountManager = class {
 	* @returns The signing account (with private key loaded) or undefined if no matching wallet or account was found
 	*/
 	async getWalletAccount(walletName, predicate, sender) {
+		return this.findWalletAccount(walletName, predicate, sender);
+	}
+	async findWalletAccount(walletName, predicateOrAddress, sender) {
 		const kmd = await this.kmd();
 		const wallet = (await kmd.listWallets()).wallets.filter((w) => w.name === walletName);
 		if (wallet.length === 0) return;
@@ -62,16 +65,21 @@ var KmdAccountManager = class {
 			walletId: wallet[0].id,
 			walletPassword: ""
 		})).walletHandleToken;
-		const addresses = (await kmd.listKeysInWallet({ walletHandleToken: walletHandle })).addresses;
-		let i = 0;
-		if (predicate) for (i = 0; i < addresses.length; i++) {
-			const address = addresses[i];
-			if (predicate(await this._clientManager.algod.accountInformation(address))) break;
+		let matchedAddress = void 0;
+		if (predicateOrAddress && typeof predicateOrAddress === "string") matchedAddress = Address.fromString(predicateOrAddress);
+		else {
+			const addresses = (await kmd.listKeysInWallet({ walletHandleToken: walletHandle })).addresses;
+			if (addresses.length > 0) if (predicateOrAddress && typeof predicateOrAddress === "function") {
+				for (let i = 0; i < addresses.length; i++) if (predicateOrAddress(await this._clientManager.algod.accountInformation(addresses[i]))) {
+					matchedAddress = addresses[i];
+					break;
+				}
+			} else matchedAddress = addresses[0];
 		}
-		if (i >= addresses.length) return;
+		if (!matchedAddress) return;
 		const accountKey = (await kmd.exportKey({
 			walletHandleToken: walletHandle,
-			address: addresses[i]
+			address: matchedAddress
 		})).privateKey;
 		const keys = nacl.sign.keyPair.fromSecretKey(accountKey);
 		const rawSigner = async (bytesToSign) => {
@@ -143,9 +151,12 @@ var KmdAccountManager = class {
 	*/
 	async getLocalNetDispenserAccount() {
 		if (!await this._clientManager.isLocalNet()) throw new Error("Can't get LocalNet dispenser account from non LocalNet network");
-		const dispenser = await this.getWalletAccount("unencrypted-default-wallet", (a) => a.status !== "Offline" && a.amount > 1e9);
-		if (!dispenser) throw new Error("Error retrieving LocalNet dispenser account; couldn't find the default account in KMD");
-		return dispenser;
+		const dispenserAddresses = (await this._clientManager.algod.genesis()).alloc.filter((a) => a.comment === "Wallet1").map((a) => a.addr);
+		if (dispenserAddresses.length > 0) {
+			const dispenser = await this.findWalletAccount("unencrypted-default-wallet", dispenserAddresses[0]);
+			if (dispenser) return dispenser;
+		}
+		throw new Error("Error retrieving LocalNet dispenser account; couldn't find the default account in KMD");
 	}
 };
 

package/types/kmd-account-manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"kmd-account-manager.mjs","names":[],"sources":["../../src/types/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 { Config } from '../config'\nimport { AlgoAmount } from './amount'\nimport { ClientManager } from './client-manager'\nimport { TransactionComposer } from './composer'\nimport { AddressWithTransactionSigner, generateAddressWithSigners } from '@algorandfoundation/algokit-transact'\nimport nacl from 'tweetnacl'\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    const kmd = await this.kmd()\n\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\n    const walletId = wallet[0].id\n\n    const walletHandle = (await kmd.initWalletHandle({ walletId, walletPassword: '' })).walletHandleToken\n    const addresses = (await kmd.listKeysInWallet({ walletHandleToken: walletHandle })).addresses\n\n    let i = 0\n    if (predicate) {\n      for (i = 0; i < addresses.length; i++) {\n        const address = addresses[i]\n        const account = await this._clientManager.algod.accountInformation(address)\n        if (predicate(account)) {\n          break\n        }\n      }\n    }\n\n    if (i >= addresses.length) {\n      return undefined\n    }\n\n    const accountKey = (\n      await kmd.exportKey({\n        walletHandleToken: walletHandle,\n        address: addresses[i],\n      })\n    ).privateKey\n\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({\n        amount: fundWith ?? AlgoAmount.Algo(1000),\n        receiver: account.addr,\n        sender: dispenser.addr,\n      })\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\n    const dispenser = await this.getWalletAccount('unencrypted-default-wallet', (a) => a.status !== 'Offline' && a.amount > 1_000_000_000)\n    if (!dispenser) {\n      throw new Error(\"Error retrieving LocalNet dispenser account; couldn't find the default account in KMD\")\n    }\n\n    return dispenser\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"kmd-account-manager.mjs","names":["matchedAddress: Address | undefined"],"sources":["../../src/types/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 { Config } from '../config'\nimport { AlgoAmount } from './amount'\nimport { ClientManager } from './client-manager'\nimport { TransactionComposer } from './composer'\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/types/testing.d.ts

@@ -94,7 +94,7 @@ interface AlgorandFixture {
    * ```typescript
    * describe('MY MODULE', () => {
    *   const fixture = algorandFixture()
-   *   beforeEach(fixture.newScope, 10_000) // Add a 10s timeout to cater for occasionally slow LocalNet calls
+   *   beforeEach(fixture.newScope)
    *
    *   test('MY TEST', async () => {
    *     const { algorand, testAccount } = fixture.context
@@ -108,7 +108,7 @@ interface AlgorandFixture {
    * ```typescript
    * describe('MY MODULE', () => {
    *   const fixture = algorandFixture()
-   *   beforeAll(fixture.newScope, 10_000) // Add a 10s timeout to cater for occasionally slow LocalNet calls
+   *   beforeAll(fixture.newScope)
    *
    *   test('test1', async () => {
    *     const { algorand, testAccount } = fixture.context

package/packages/algod_client/src/models/application-local-reference.d.ts

@@ -1,20 +0,0 @@
-import { Address } from "../../../common/src/address.js";
-
-//#region packages/algod_client/src/models/application-local-reference.d.ts
-
-/**
- * References an account's local state for an application.
- */
-type ApplicationLocalReference = {
-  /**
-   * Address of the account with the local state.
-   */
-  account: Address;
-  /**
-   * Application ID of the local state application.
-   */
-  app: bigint;
-};
-//#endregion
-export { ApplicationLocalReference };
-//# sourceMappingURL=application-local-reference.d.ts.map

package/packages/algod_client/src/models/application-local-reference.js

@@ -1,23 +0,0 @@
-const require_address = require('../../../common/src/codecs/primitives/address.js');
-const require_bigint = require('../../../common/src/codecs/primitives/bigint.js');
-
-//#region packages/algod_client/src/models/application-local-reference.ts
-const ApplicationLocalReferenceMeta = {
-	name: "ApplicationLocalReference",
-	kind: "object",
-	fields: [{
-		name: "account",
-		wireKey: "account",
-		optional: false,
-		codec: require_address.addressCodec
-	}, {
-		name: "app",
-		wireKey: "app",
-		optional: false,
-		codec: require_bigint.bigIntCodec
-	}]
-};
-
-//#endregion
-exports.ApplicationLocalReferenceMeta = ApplicationLocalReferenceMeta;
-//# sourceMappingURL=application-local-reference.js.map

package/packages/algod_client/src/models/application-local-reference.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"application-local-reference.js","names":["ApplicationLocalReferenceMeta: ObjectModelMetadata<ApplicationLocalReference>","addressCodec","bigIntCodec"],"sources":["../../../../../packages/algod_client/src/models/application-local-reference.ts"],"sourcesContent":["import type { Address, ObjectModelMetadata } from '@algorandfoundation/algokit-common'\nimport { bigIntCodec, addressCodec } from '@algorandfoundation/algokit-common'\n\n/**\n * References an account's local state for an application.\n */\nexport type ApplicationLocalReference = {\n  /**\n   * Address of the account with the local state.\n   */\n  account: Address\n\n  /**\n   * Application ID of the local state application.\n   */\n  app: bigint\n}\n\nexport const ApplicationLocalReferenceMeta: ObjectModelMetadata<ApplicationLocalReference> = {\n  name: 'ApplicationLocalReference',\n  kind: 'object',\n  fields: [\n    {\n      name: 'account',\n      wireKey: 'account',\n      optional: false,\n      codec: addressCodec,\n    },\n    {\n      name: 'app',\n      wireKey: 'app',\n      optional: false,\n      codec: bigIntCodec,\n    },\n  ],\n}\n"],"mappings":";;;;AAkBA,MAAaA,gCAAgF;CAC3F,MAAM;CACN,MAAM;CACN,QAAQ,CACN;EACE,MAAM;EACN,SAAS;EACT,UAAU;EACV,OAAOC;EACR,EACD;EACE,MAAM;EACN,SAAS;EACT,UAAU;EACV,OAAOC;EACR,CACF;CACF"}

package/packages/algod_client/src/models/application-local-reference.mjs

@@ -1,23 +0,0 @@
-import { addressCodec } from "../../../common/src/codecs/primitives/address.mjs";
-import { bigIntCodec } from "../../../common/src/codecs/primitives/bigint.mjs";
-
-//#region packages/algod_client/src/models/application-local-reference.ts
-const ApplicationLocalReferenceMeta = {
-	name: "ApplicationLocalReference",
-	kind: "object",
-	fields: [{
-		name: "account",
-		wireKey: "account",
-		optional: false,
-		codec: addressCodec
-	}, {
-		name: "app",
-		wireKey: "app",
-		optional: false,
-		codec: bigIntCodec
-	}]
-};
-
-//#endregion
-export { ApplicationLocalReferenceMeta };
-//# sourceMappingURL=application-local-reference.mjs.map

package/packages/algod_client/src/models/application-local-reference.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"application-local-reference.mjs","names":["ApplicationLocalReferenceMeta: ObjectModelMetadata<ApplicationLocalReference>"],"sources":["../../../../../packages/algod_client/src/models/application-local-reference.ts"],"sourcesContent":["import type { Address, ObjectModelMetadata } from '@algorandfoundation/algokit-common'\nimport { bigIntCodec, addressCodec } from '@algorandfoundation/algokit-common'\n\n/**\n * References an account's local state for an application.\n */\nexport type ApplicationLocalReference = {\n  /**\n   * Address of the account with the local state.\n   */\n  account: Address\n\n  /**\n   * Application ID of the local state application.\n   */\n  app: bigint\n}\n\nexport const ApplicationLocalReferenceMeta: ObjectModelMetadata<ApplicationLocalReference> = {\n  name: 'ApplicationLocalReference',\n  kind: 'object',\n  fields: [\n    {\n      name: 'account',\n      wireKey: 'account',\n      optional: false,\n      codec: addressCodec,\n    },\n    {\n      name: 'app',\n      wireKey: 'app',\n      optional: false,\n      codec: bigIntCodec,\n    },\n  ],\n}\n"],"mappings":";;;;AAkBA,MAAaA,gCAAgF;CAC3F,MAAM;CACN,MAAM;CACN,QAAQ,CACN;EACE,MAAM;EACN,SAAS;EACT,UAAU;EACV,OAAO;EACR,EACD;EACE,MAAM;EACN,SAAS;EACT,UAAU;EACV,OAAO;EACR,CACF;CACF"}

package/packages/algod_client/src/models/asset-holding-reference.d.ts

@@ -1,20 +0,0 @@
-import { Address } from "../../../common/src/address.js";
-
-//#region packages/algod_client/src/models/asset-holding-reference.d.ts
-
-/**
- * References an asset held by an account.
- */
-type AssetHoldingReference = {
-  /**
-   * Address of the account holding the asset.
-   */
-  account: Address;
-  /**
-   * Asset ID of the holding.
-   */
-  asset: bigint;
-};
-//#endregion
-export { AssetHoldingReference };
-//# sourceMappingURL=asset-holding-reference.d.ts.map

package/packages/algod_client/src/models/asset-holding-reference.js

@@ -1,23 +0,0 @@
-const require_address = require('../../../common/src/codecs/primitives/address.js');
-const require_bigint = require('../../../common/src/codecs/primitives/bigint.js');
-
-//#region packages/algod_client/src/models/asset-holding-reference.ts
-const AssetHoldingReferenceMeta = {
-	name: "AssetHoldingReference",
-	kind: "object",
-	fields: [{
-		name: "account",
-		wireKey: "account",
-		optional: false,
-		codec: require_address.addressCodec
-	}, {
-		name: "asset",
-		wireKey: "asset",
-		optional: false,
-		codec: require_bigint.bigIntCodec
-	}]
-};
-
-//#endregion
-exports.AssetHoldingReferenceMeta = AssetHoldingReferenceMeta;
-//# sourceMappingURL=asset-holding-reference.js.map

package/packages/algod_client/src/models/asset-holding-reference.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"asset-holding-reference.js","names":["AssetHoldingReferenceMeta: ObjectModelMetadata<AssetHoldingReference>","addressCodec","bigIntCodec"],"sources":["../../../../../packages/algod_client/src/models/asset-holding-reference.ts"],"sourcesContent":["import type { Address, ObjectModelMetadata } from '@algorandfoundation/algokit-common'\nimport { bigIntCodec, addressCodec } from '@algorandfoundation/algokit-common'\n\n/**\n * References an asset held by an account.\n */\nexport type AssetHoldingReference = {\n  /**\n   * Address of the account holding the asset.\n   */\n  account: Address\n\n  /**\n   * Asset ID of the holding.\n   */\n  asset: bigint\n}\n\nexport const AssetHoldingReferenceMeta: ObjectModelMetadata<AssetHoldingReference> = {\n  name: 'AssetHoldingReference',\n  kind: 'object',\n  fields: [\n    {\n      name: 'account',\n      wireKey: 'account',\n      optional: false,\n      codec: addressCodec,\n    },\n    {\n      name: 'asset',\n      wireKey: 'asset',\n      optional: false,\n      codec: bigIntCodec,\n    },\n  ],\n}\n"],"mappings":";;;;AAkBA,MAAaA,4BAAwE;CACnF,MAAM;CACN,MAAM;CACN,QAAQ,CACN;EACE,MAAM;EACN,SAAS;EACT,UAAU;EACV,OAAOC;EACR,EACD;EACE,MAAM;EACN,SAAS;EACT,UAAU;EACV,OAAOC;EACR,CACF;CACF"}

package/packages/algod_client/src/models/asset-holding-reference.mjs

@@ -1,23 +0,0 @@
-import { addressCodec } from "../../../common/src/codecs/primitives/address.mjs";
-import { bigIntCodec } from "../../../common/src/codecs/primitives/bigint.mjs";
-
-//#region packages/algod_client/src/models/asset-holding-reference.ts
-const AssetHoldingReferenceMeta = {
-	name: "AssetHoldingReference",
-	kind: "object",
-	fields: [{
-		name: "account",
-		wireKey: "account",
-		optional: false,
-		codec: addressCodec
-	}, {
-		name: "asset",
-		wireKey: "asset",
-		optional: false,
-		codec: bigIntCodec
-	}]
-};
-
-//#endregion
-export { AssetHoldingReferenceMeta };
-//# sourceMappingURL=asset-holding-reference.mjs.map

package/packages/algod_client/src/models/asset-holding-reference.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"asset-holding-reference.mjs","names":["AssetHoldingReferenceMeta: ObjectModelMetadata<AssetHoldingReference>"],"sources":["../../../../../packages/algod_client/src/models/asset-holding-reference.ts"],"sourcesContent":["import type { Address, ObjectModelMetadata } from '@algorandfoundation/algokit-common'\nimport { bigIntCodec, addressCodec } from '@algorandfoundation/algokit-common'\n\n/**\n * References an asset held by an account.\n */\nexport type AssetHoldingReference = {\n  /**\n   * Address of the account holding the asset.\n   */\n  account: Address\n\n  /**\n   * Asset ID of the holding.\n   */\n  asset: bigint\n}\n\nexport const AssetHoldingReferenceMeta: ObjectModelMetadata<AssetHoldingReference> = {\n  name: 'AssetHoldingReference',\n  kind: 'object',\n  fields: [\n    {\n      name: 'account',\n      wireKey: 'account',\n      optional: false,\n      codec: addressCodec,\n    },\n    {\n      name: 'asset',\n      wireKey: 'asset',\n      optional: false,\n      codec: bigIntCodec,\n    },\n  ],\n}\n"],"mappings":";;;;AAkBA,MAAaA,4BAAwE;CACnF,MAAM;CACN,MAAM;CACN,QAAQ,CACN;EACE,MAAM;EACN,SAAS;EACT,UAAU;EACV,OAAO;EACR,EACD;EACE,MAAM;EACN,SAAS;EACT,UAAU;EACV,OAAO;EACR,CACF;CACF"}

package/packages/algod_client/src/models/box-reference.d.ts

@@ -1,17 +0,0 @@
-//#region packages/algod_client/src/models/box-reference.d.ts
-/**
- * References a box of an application.
- */
-type BoxReference = {
-  /**
-   * Application ID which this box belongs to
-   */
-  app: bigint;
-  /**
-   * Base64 encoded box name
-   */
-  name: Uint8Array;
-};
-//#endregion
-export { BoxReference };
-//# sourceMappingURL=box-reference.d.ts.map

package/packages/algod_client/src/models/box-reference.js

@@ -1,23 +0,0 @@
-const require_bigint = require('../../../common/src/codecs/primitives/bigint.js');
-const require_bytes = require('../../../common/src/codecs/primitives/bytes.js');
-
-//#region packages/algod_client/src/models/box-reference.ts
-const BoxReferenceMeta = {
-	name: "BoxReference",
-	kind: "object",
-	fields: [{
-		name: "app",
-		wireKey: "app",
-		optional: false,
-		codec: require_bigint.bigIntCodec
-	}, {
-		name: "name",
-		wireKey: "name",
-		optional: false,
-		codec: require_bytes.bytesCodec
-	}]
-};
-
-//#endregion
-exports.BoxReferenceMeta = BoxReferenceMeta;
-//# sourceMappingURL=box-reference.js.map

package/packages/algod_client/src/models/box-reference.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"box-reference.js","names":["BoxReferenceMeta: ObjectModelMetadata<BoxReference>","bigIntCodec","bytesCodec"],"sources":["../../../../../packages/algod_client/src/models/box-reference.ts"],"sourcesContent":["import type { ObjectModelMetadata } from '@algorandfoundation/algokit-common'\nimport { bigIntCodec, bytesCodec } from '@algorandfoundation/algokit-common'\n\n/**\n * References a box of an application.\n */\nexport type BoxReference = {\n  /**\n   * Application ID which this box belongs to\n   */\n  app: bigint\n\n  /**\n   * Base64 encoded box name\n   */\n  name: Uint8Array\n}\n\nexport const BoxReferenceMeta: ObjectModelMetadata<BoxReference> = {\n  name: 'BoxReference',\n  kind: 'object',\n  fields: [\n    {\n      name: 'app',\n      wireKey: 'app',\n      optional: false,\n      codec: bigIntCodec,\n    },\n    {\n      name: 'name',\n      wireKey: 'name',\n      optional: false,\n      codec: bytesCodec,\n    },\n  ],\n}\n"],"mappings":";;;;AAkBA,MAAaA,mBAAsD;CACjE,MAAM;CACN,MAAM;CACN,QAAQ,CACN;EACE,MAAM;EACN,SAAS;EACT,UAAU;EACV,OAAOC;EACR,EACD;EACE,MAAM;EACN,SAAS;EACT,UAAU;EACV,OAAOC;EACR,CACF;CACF"}

package/packages/algod_client/src/models/box-reference.mjs

@@ -1,23 +0,0 @@
-import { bigIntCodec } from "../../../common/src/codecs/primitives/bigint.mjs";
-import { bytesCodec } from "../../../common/src/codecs/primitives/bytes.mjs";
-
-//#region packages/algod_client/src/models/box-reference.ts
-const BoxReferenceMeta = {
-	name: "BoxReference",
-	kind: "object",
-	fields: [{
-		name: "app",
-		wireKey: "app",
-		optional: false,
-		codec: bigIntCodec
-	}, {
-		name: "name",
-		wireKey: "name",
-		optional: false,
-		codec: bytesCodec
-	}]
-};
-
-//#endregion
-export { BoxReferenceMeta };
-//# sourceMappingURL=box-reference.mjs.map

package/packages/algod_client/src/models/box-reference.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"box-reference.mjs","names":["BoxReferenceMeta: ObjectModelMetadata<BoxReference>"],"sources":["../../../../../packages/algod_client/src/models/box-reference.ts"],"sourcesContent":["import type { ObjectModelMetadata } from '@algorandfoundation/algokit-common'\nimport { bigIntCodec, bytesCodec } from '@algorandfoundation/algokit-common'\n\n/**\n * References a box of an application.\n */\nexport type BoxReference = {\n  /**\n   * Application ID which this box belongs to\n   */\n  app: bigint\n\n  /**\n   * Base64 encoded box name\n   */\n  name: Uint8Array\n}\n\nexport const BoxReferenceMeta: ObjectModelMetadata<BoxReference> = {\n  name: 'BoxReference',\n  kind: 'object',\n  fields: [\n    {\n      name: 'app',\n      wireKey: 'app',\n      optional: false,\n      codec: bigIntCodec,\n    },\n    {\n      name: 'name',\n      wireKey: 'name',\n      optional: false,\n      codec: bytesCodec,\n    },\n  ],\n}\n"],"mappings":";;;;AAkBA,MAAaA,mBAAsD;CACjE,MAAM;CACN,MAAM;CACN,QAAQ,CACN;EACE,MAAM;EACN,SAAS;EACT,UAAU;EACV,OAAO;EACR,EACD;EACE,MAAM;EACN,SAAS;EACT,UAAU;EACV,OAAO;EACR,CACF;CACF"}