@algorandfoundation/algokit-utils 10.0.0-alpha.8 → 10.0.0-beta.1

package/algorand-client-transaction-sender.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"algorand-client-transaction-sender.mjs","names":[],"sources":["../src/algorand-client-transaction-sender.ts"],"sourcesContent":["import { ABIMethod } from '@algorandfoundation/algokit-abi'\nimport { ReadableAddress, getAddress, getApplicationAddress } from '@algorandfoundation/algokit-common'\nimport { Transaction } from '@algorandfoundation/algokit-transact'\nimport { Buffer } from 'buffer'\nimport { SendAppCreateTransactionResult, SendAppTransactionResult, SendAppUpdateTransactionResult } from './app'\nimport { AppManager } from './app-manager'\nimport { AssetManager } from './asset-manager'\nimport {\n  AppCallMethodCall,\n  AppCallParams,\n  AppCreateMethodCall,\n  AppCreateParams,\n  AppDeleteMethodCall,\n  AppDeleteParams,\n  AppUpdateMethodCall,\n  AppUpdateParams,\n  AssetCreateParams,\n  AssetOptOutParams,\n  TransactionComposer,\n  TransactionComposerConfig,\n} from './composer'\nimport { Config } from './config'\nimport { SendParams, SendSingleTransactionResult } from './transaction/types'\nimport { asJson, defaultJsonValueReplacer } from './util'\n\nconst getMethodCallForLog = ({ method, args }: { method: ABIMethod; args?: unknown[] }) => {\n  return `${method.name}(${(args ?? []).map((a) =>\n    typeof a === 'object'\n      ? asJson(a, (k, v) => {\n          const newV = defaultJsonValueReplacer(k, v)\n          return newV instanceof Uint8Array ? Buffer.from(newV).toString('base64') : newV\n        })\n      : a,\n  )})`\n}\n\n/** Orchestrates sending transactions for `AlgorandClient`. */\nexport class AlgorandClientTransactionSender {\n  private _newGroup: () => TransactionComposer\n  private _assetManager: AssetManager\n  private _appManager: AppManager\n\n  /**\n   * Creates a new `AlgorandClientSender`\n   * @param newGroup A lambda that starts a new `TransactionComposer` transaction group\n   * @param assetManager An `AssetManager` instance\n   * @param appManager An `AppManager` instance\n   * @example\n   * ```typescript\n   * const transactionSender = new AlgorandClientTransactionSender(() => new TransactionComposer(), assetManager, appManager)\n   * ```\n   */\n  constructor(newGroup: (config?: TransactionComposerConfig) => TransactionComposer, assetManager: AssetManager, appManager: AppManager) {\n    this._newGroup = newGroup\n    this._assetManager = assetManager\n    this._appManager = appManager\n  }\n\n  /**\n   * Start a new `TransactionComposer` transaction group\n   * @returns A new instance of `TransactionComposer`.\n   * @example\n   * const composer = AlgorandClient.mainNet().send.newGroup();\n   * const result = await composer.addTransaction(payment).send()\n   */\n  newGroup() {\n    return this._newGroup()\n  }\n\n  private _send<T>(\n    c: (c: TransactionComposer) => (params: T) => TransactionComposer,\n    log?: {\n      preLog?: (params: T, transaction: Transaction) => string\n      postLog?: (params: T, result: SendSingleTransactionResult) => string\n    },\n  ): (params: T & SendParams) => Promise<SendSingleTransactionResult> {\n    return async (params) => {\n      const composer = this._newGroup()\n\n      // Ensure `this` is properly populated\n      c(composer).apply(composer, [params])\n\n      if (log?.preLog) {\n        const transaction = (await composer.build()).transactions.at(-1)!.txn\n        Config.getLogger(params?.suppressLog).debug(log.preLog(params, transaction))\n      }\n\n      const rawResult = await composer.send(params)\n      const result = {\n        // Last item covers when a group is created by an app call with ABI transaction parameters\n        transaction: rawResult.transactions.at(-1)!,\n        confirmation: rawResult.confirmations.at(-1)!,\n        txId: rawResult.txIds.at(-1)!,\n        ...rawResult,\n      }\n\n      if (log?.postLog) {\n        Config.getLogger(params?.suppressLog).debug(log.postLog(params, result))\n      }\n\n      return result\n    }\n  }\n\n  private _sendAppCall<\n    T extends\n      | AppCreateParams\n      | AppUpdateParams\n      | AppCallParams\n      | AppDeleteParams\n      | AppCreateMethodCall\n      | AppUpdateMethodCall\n      | AppCallMethodCall\n      | AppDeleteMethodCall,\n  >(\n    c: (c: TransactionComposer) => (params: T) => TransactionComposer,\n    log?: {\n      preLog?: (params: T, transaction: Transaction) => string\n      postLog?: (params: T, result: SendSingleTransactionResult) => string\n    },\n  ): (params: T & SendParams) => Promise<SendAppTransactionResult> {\n    return async (params) => {\n      const result = await this._send(c, log)(params)\n\n      return { ...result, return: AppManager.getABIReturn(result.confirmation, 'method' in params ? params.method : undefined) }\n    }\n  }\n\n  private _sendAppUpdateCall<T extends AppCreateParams | AppUpdateParams | AppCreateMethodCall | AppUpdateMethodCall>(\n    c: (c: TransactionComposer) => (params: T) => TransactionComposer,\n    log?: {\n      preLog?: (params: T, transaction: Transaction) => string\n      postLog?: (params: T, result: SendSingleTransactionResult) => string\n    },\n  ): (params: T & SendParams) => Promise<SendAppUpdateTransactionResult> {\n    return async (params) => {\n      const result = await this._sendAppCall(c, log)(params)\n\n      const compiledApproval =\n        typeof params.approvalProgram === 'string' ? this._appManager.getCompilationResult(params.approvalProgram) : undefined\n      const compiledClear =\n        typeof params.clearStateProgram === 'string' ? this._appManager.getCompilationResult(params.clearStateProgram) : undefined\n\n      return { ...result, compiledApproval, compiledClear }\n    }\n  }\n\n  private _sendAppCreateCall<T extends AppCreateParams | AppCreateMethodCall>(\n    c: (c: TransactionComposer) => (params: T) => TransactionComposer,\n    log?: {\n      preLog?: (params: T, transaction: Transaction) => string\n      postLog?: (params: T, result: SendSingleTransactionResult) => string\n    },\n  ): (params: T & SendParams) => Promise<SendAppCreateTransactionResult> {\n    return async (params) => {\n      const result = await this._sendAppUpdateCall(c, log)(params)\n\n      return {\n        ...result,\n        appId: BigInt(result.confirmation.appId!),\n        appAddress: getApplicationAddress(result.confirmation.appId!),\n      }\n    }\n  }\n\n  /**\n   * Send a payment transaction to transfer Algo between accounts.\n   * @param params The parameters for the payment transaction\n   * @example Basic example\n   * {@includeCode ./algorand-client.spec.ts#example-send-payment}\n   * @example Advanced example\n   * ```typescript\n   * const result = await algorand.send.payment({\n   *   amount: (4).algo(),\n   *   receiver: 'RECEIVERADDRESS',\n   *   sender: 'SENDERADDRESS',\n   *   closeRemainderTo: 'CLOSEREMAINDERTOADDRESS',\n   *   lease: 'lease',\n   *   note: 'note',\n   *   // Use this with caution, it's generally better to use algorand.account.rekeyAccount\n   *   rekeyTo: 'REKEYTOADDRESS',\n   *   // You wouldn't normally set this field\n   *   firstValidRound: 1000n,\n   *   validityWindow: 10,\n   *   extraFee: (1000).microAlgo(),\n   *   staticFee: (1000).microAlgo(),\n   *   // Max fee doesn't make sense with extraFee AND staticFee\n   *   //  already specified, but here for completeness\n   *   maxFee: (3000).microAlgo(),\n   *   // Signer only needed if you want to provide one,\n   *   //  generally you'd register it with AlgorandClient\n   *   //  against the sender and not need to pass it in\n   *   signer: transactionSigner,\n   *   maxRoundsToWaitForConfirmation: 5,\n   *   suppressLog: true,\n   * })\n   * ```\n   * @see [Full working example](https://github.com/algorandfoundation/algokit-utils-ts/blob/main/src/algorand-client.spec.ts)\n   * @returns The result of the payment transaction and the transaction that was sent\n   */\n  payment = this._send((c) => c.addPayment, {\n    preLog: (params, transaction) =>\n      `Sending ${params.amount.microAlgo} µALGO from ${getAddress(params.sender)} to ${getAddress(params.receiver)} via transaction ${transaction.txId()}`,\n  })\n  /**\n   * Create a new Algorand Standard Asset.\n   *\n   * The account that sends this transaction will automatically be\n   * opted in to the asset and will hold all units after creation.\n   *\n   * @param params The parameters for the asset creation transaction\n   *\n   * @example Basic example\n   * {@includeCode ./algorand-client.spec.ts#example-send-asset-create}\n   * @example Advanced example\n   * ```typescript\n   * await algorand.send.assetCreate({\n   *   sender: 'CREATORADDRESS',\n   *   total: 100n,\n   *   decimals: 2,\n   *   assetName: 'asset',\n   *   unitName: 'unit',\n   *   url: 'url',\n   *   metadataHash: 'metadataHash',\n   *   defaultFrozen: false,\n   *   manager: 'MANAGERADDRESS',\n   *   reserve: 'RESERVEADDRESS',\n   *   freeze: 'FREEZEADDRESS',\n   *   clawback: 'CLAWBACKADDRESS',\n   *   lease: 'lease',\n   *   note: 'note',\n   *   // You wouldn't normally set this field\n   *   firstValidRound: 1000n,\n   *   validityWindow: 10,\n   *   extraFee: (1000).microAlgo(),\n   *   staticFee: (1000).microAlgo(),\n   *   // Max fee doesn't make sense with extraFee AND staticFee\n   *   //  already specified, but here for completeness\n   *   maxFee: (3000).microAlgo(),\n   *   // Signer only needed if you want to provide one,\n   *   //  generally you'd register it with AlgorandClient\n   *   //  against the sender and not need to pass it in\n   *   signer: transactionSigner,\n   *   maxRoundsToWaitForConfirmation: 5,\n   *   suppressLog: true,\n   * })\n   * ```\n   * @see [Full working example](https://github.com/algorandfoundation/algokit-utils-ts/blob/main/src/algorand-client.spec.ts)\n   * @returns The result of the asset create transaction and the transaction that was sent\n   */\n  assetCreate = async (params: AssetCreateParams & SendParams) => {\n    const result = await this._send((c) => c.addAssetCreate, {\n      postLog: (params, result) =>\n        `Created asset${params.assetName ? ` ${params.assetName}` : ''}${params.unitName ? ` (${params.unitName})` : ''} with ${params.total} units and ${params.decimals ?? 0} decimals created by ${getAddress(params.sender)} with ID ${result.confirmation.assetId} via transaction ${result.txIds.at(-1)}`,\n    })(params)\n    return { ...result, assetId: BigInt(result.confirmation.assetId ?? 0) }\n  }\n  /**\n   * Configure an existing Algorand Standard Asset.\n   *\n   * **Note:** The manager, reserve, freeze, and clawback addresses\n   * are immutably empty if they are not set. If manager is not set then\n   * all fields are immutable from that point forward.\n   *\n   * @param params The parameters for the asset config transaction\n   *\n   * @example Basic example\n   * ```typescript\n   * await algorand.send.assetConfig({ sender: \"MANAGERADDRESS\", assetId: 123456n, manager: \"MANAGERADDRESS\" })\n   * ```\n   * @example Advanced example\n   * ```typescript\n   * await algorand.send.assetConfig({\n   *   sender: 'MANAGERADDRESS',\n   *   assetId: 123456n,\n   *   manager: 'MANAGERADDRESS',\n   *   reserve: 'RESERVEADDRESS',\n   *   freeze: 'FREEZEADDRESS',\n   *   clawback: 'CLAWBACKADDRESS',\n   *   lease: 'lease',\n   *   note: 'note',\n   *   // You wouldn't normally set this field\n   *   firstValidRound: 1000n,\n   *   validityWindow: 10,\n   *   extraFee: (1000).microAlgo(),\n   *   staticFee: (1000).microAlgo(),\n   *   // Max fee doesn't make sense with extraFee AND staticFee\n   *   //  already specified, but here for completeness\n   *   maxFee: (3000).microAlgo(),\n   *   // Signer only needed if you want to provide one,\n   *   //  generally you'd register it with AlgorandClient\n   *   //  against the sender and not need to pass it in\n   *   signer: transactionSigner,\n   *   maxRoundsToWaitForConfirmation: 5,\n   *   suppressLog: true,\n   * })\n   * ```\n   * @returns The result of the asset config transaction and the transaction that was sent\n   */\n  assetConfig = this._send((c) => c.addAssetConfig, {\n    preLog: (params, transaction) => `Configuring asset with ID ${params.assetId} via transaction ${transaction.txId()}`,\n  })\n  /**\n   * Freeze or unfreeze an Algorand Standard Asset for an account.\n   *\n   * @param params The parameters for the asset freeze transaction\n   *\n   * @example Basic example\n   * ```typescript\n   * await algorand.send.assetFreeze({ sender: \"MANAGERADDRESS\", assetId: 123456n, account: \"ACCOUNTADDRESS\", frozen: true })\n   * ```\n   * @example Advanced example\n   * ```typescript\n   * await algorand.send.assetFreeze({\n   *   sender: 'MANAGERADDRESS',\n   *   assetId: 123456n,\n   *   account: 'ACCOUNTADDRESS',\n   *   frozen: true,\n   *   lease: 'lease',\n   *   note: 'note',\n   *   // You wouldn't normally set this field\n   *   firstValidRound: 1000n,\n   *   validityWindow: 10,\n   *   extraFee: (1000).microAlgo(),\n   *   staticFee: (1000).microAlgo(),\n   *   // Max fee doesn't make sense with extraFee AND staticFee\n   *   //  already specified, but here for completeness\n   *   maxFee: (3000).microAlgo(),\n   *   // Signer only needed if you want to provide one,\n   *   //  generally you'd register it with AlgorandClient\n   *   //  against the sender and not need to pass it in\n   *   signer: transactionSigner,\n   *   maxRoundsToWaitForConfirmation: 5,\n   *   suppressLog: true,\n   * })\n   * ```\n   * @returns The result of the asset freeze transaction and the transaction that was sent\n   */\n  assetFreeze = this._send((c) => c.addAssetFreeze, {\n    preLog: (params, transaction) => `Freezing asset with ID ${params.assetId} via transaction ${transaction.txId()}`,\n  })\n  /**\n   * Destroys an Algorand Standard Asset.\n   *\n   * Created assets can be destroyed only by the asset manager account.\n   * All of the assets must be owned by the creator of the asset before\n   * the asset can be deleted.\n   *\n   * @param params The parameters for the asset destroy transaction\n   *\n   * @example Basic example\n   * ```typescript\n   * await algorand.send.assetDestroy({ sender: \"MANAGERADDRESS\", assetId: 123456n })\n   * ```\n   * @example Advanced example\n   * ```typescript\n   * await algorand.send.assetDestroy({\n   *   sender: 'MANAGERADDRESS',\n   *   assetId: 123456n,\n   *   lease: 'lease',\n   *   note: 'note',\n   *   // You wouldn't normally set this field\n   *   firstValidRound: 1000n,\n   *   validityWindow: 10,\n   *   extraFee: (1000).microAlgo(),\n   *   staticFee: (1000).microAlgo(),\n   *   // Max fee doesn't make sense with extraFee AND staticFee\n   *   //  already specified, but here for completeness\n   *   maxFee: (3000).microAlgo(),\n   *   // Signer only needed if you want to provide one,\n   *   //  generally you'd register it with AlgorandClient\n   *   //  against the sender and not need to pass it in\n   *   signer: transactionSigner,\n   *   maxRoundsToWaitForConfirmation: 5,\n   *   suppressLog: true,\n   * })\n   * ```\n   * @returns The result of the asset destroy transaction and the transaction that was sent\n   */\n  assetDestroy = this._send((c) => c.addAssetDestroy, {\n    preLog: (params, transaction) => `Destroying asset with ID ${params.assetId} via transaction ${transaction.txId()}`,\n  })\n  /**\n   * Transfer an Algorand Standard Asset.\n   *\n   * @param params The parameters for the asset transfer transaction\n   *\n   * @example Basic example\n   * ```typescript\n   * await algorand.send.assetTransfer({ sender: \"HOLDERADDRESS\", assetId: 123456n, amount: 1n, receiver: \"RECEIVERADDRESS\" })\n   * ```\n   * @example Advanced example (with clawback)\n   * ```typescript\n   * await algorand.send.assetTransfer({\n   *   sender: 'CLAWBACKADDRESS',\n   *   assetId: 123456n,\n   *   amount: 1n,\n   *   receiver: 'RECEIVERADDRESS',\n   *   clawbackTarget: 'HOLDERADDRESS',\n   *   // This field needs to be used with caution\n   *   closeAssetTo: 'ADDRESSTOCLOSETO'\n   *   lease: 'lease',\n   *   note: 'note',\n   *   // You wouldn't normally set this field\n   *   firstValidRound: 1000n,\n   *   validityWindow: 10,\n   *   extraFee: (1000).microAlgo(),\n   *   staticFee: (1000).microAlgo(),\n   *   // Max fee doesn't make sense with extraFee AND staticFee\n   *   //  already specified, but here for completeness\n   *   maxFee: (3000).microAlgo(),\n   *   // Signer only needed if you want to provide one,\n   *   //  generally you'd register it with AlgorandClient\n   *   //  against the sender and not need to pass it in\n   *   signer: transactionSigner,\n   *   maxRoundsToWaitForConfirmation: 5,\n   *   suppressLog: true,\n   * })\n   * ```\n   * @returns The result of the asset transfer transaction and the transaction that was sent\n   */\n  assetTransfer = this._send((c) => c.addAssetTransfer, {\n    preLog: (params, transaction) =>\n      `Transferring ${params.amount} units of asset with ID ${params.assetId} from ${getAddress(params.sender)} to ${getAddress(params.receiver)} via transaction ${transaction.txId()}`,\n  })\n  /**\n   * Opt an account into an Algorand Standard Asset.\n   *\n   * @param params The parameters for the asset opt-in transaction\n   *\n   * @example Basic example\n   * ```typescript\n   * await algorand.send.assetOptIn({ sender: \"SENDERADDRESS\", assetId: 123456n })\n   * ```\n   * @example Advanced example\n   * ```typescript\n   * await algorand.send.assetOptIn({\n   *   sender: 'SENDERADDRESS',\n   *   assetId: 123456n,\n   *   lease: 'lease',\n   *   note: 'note',\n   *   // You wouldn't normally set this field\n   *   firstValidRound: 1000n,\n   *   validityWindow: 10,\n   *   extraFee: (1000).microAlgo(),\n   *   staticFee: (1000).microAlgo(),\n   *   // Max fee doesn't make sense with extraFee AND staticFee\n   *   //  already specified, but here for completeness\n   *   maxFee: (3000).microAlgo(),\n   *   // Signer only needed if you want to provide one,\n   *   //  generally you'd register it with AlgorandClient\n   *   //  against the sender and not need to pass it in\n   *   signer: transactionSigner,\n   *   maxRoundsToWaitForConfirmation: 5,\n   *   suppressLog: true,\n   * })\n   * ```\n   * @returns The result of the asset opt-in transaction and the transaction that was sent\n   */\n  assetOptIn = this._send((c) => c.addAssetOptIn, {\n    preLog: (params, transaction) =>\n      `Opting in ${getAddress(params.sender)} to asset with ID ${params.assetId} via transaction ${transaction.txId()}`,\n  })\n  /**\n   * Opt an account out of an Algorand Standard Asset.\n   *\n   * *Note:* If the account has a balance of the asset,\n   * it will not be able to opt-out unless `ensureZeroBalance`\n   * is set to `false` (but then the account will lose the assets).\n   *\n   * @param params The parameters for the asset opt-out transaction\n   *\n   * @example Basic example (without creator, will be retrieved from algod)\n   * ```typescript\n   * await algorand.send.assetOptOut({ sender: \"SENDERADDRESS\", assetId: 123456n, ensureZeroBalance: true })\n   * ```\n   * @example Basic example (with creator)\n   * ```typescript\n   * await algorand.send.assetOptOut({ sender: \"SENDERADDRESS\", creator: \"CREATORADDRESS\", assetId: 123456n, ensureZeroBalance: true })\n   * ```\n   * @example Advanced example\n   * ```typescript\n   * await algorand.send.assetOptOut({\n   *   sender: 'SENDERADDRESS',\n   *   assetId: 123456n,\n   *   creator: 'CREATORADDRESS',\n   *   ensureZeroBalance: true,\n   *   lease: 'lease',\n   *   note: 'note',\n   *   // You wouldn't normally set this field\n   *   firstValidRound: 1000n,\n   *   validityWindow: 10,\n   *   extraFee: (1000).microAlgo(),\n   *   staticFee: (1000).microAlgo(),\n   *   // Max fee doesn't make sense with extraFee AND staticFee\n   *   //  already specified, but here for completeness\n   *   maxFee: (3000).microAlgo(),\n   *   // Signer only needed if you want to provide one,\n   *   //  generally you'd register it with AlgorandClient\n   *   //  against the sender and not need to pass it in\n   *   signer: transactionSigner,\n   *   maxRoundsToWaitForConfirmation: 5,\n   *   suppressLog: true,\n   * })\n   * ```\n   * @returns The result of the asset opt-out transaction and the transaction that was sent\n   */\n  assetOptOut = async (\n    params: Omit<AssetOptOutParams, 'creator'> & {\n      /** Optional asset creator account address; if not specified it will be retrieved from algod */\n      creator?: ReadableAddress\n      /** Whether or not to check if the account has a zero balance first or not.\n       *\n       * If this is set to `true` and the account has an asset balance it will throw an error.\n       *\n       * If this is set to `false` and the account has an asset balance it will lose those assets to the asset creator.\n       */\n      ensureZeroBalance: boolean\n    } & SendParams,\n  ) => {\n    if (params.ensureZeroBalance) {\n      let balance = 0n\n      try {\n        const accountAssetInfo = await this._assetManager.getAccountInformation(getAddress(params.sender), params.assetId)\n        balance = accountAssetInfo.balance\n      } catch {\n        throw new Error(`Account ${getAddress(params.sender)} is not opted-in to Asset ${params.assetId}; can't opt-out.`)\n      }\n      if (balance !== 0n) {\n        throw new Error(`Account ${getAddress(params.sender)} does not have a zero balance for Asset ${params.assetId}; can't opt-out.`)\n      }\n    }\n\n    params.creator = params.creator ?? (await this._assetManager.getById(params.assetId)).creator\n\n    return await this._send((c) => c.addAssetOptOut, {\n      preLog: (params, transaction) =>\n        `Opting ${getAddress(params.sender)} out of asset with ID ${params.assetId} to creator ${getAddress(params.creator)} via transaction ${transaction.txId()}`,\n    })(params as AssetOptOutParams & SendParams)\n  }\n  /**\n   * Create a smart contract.\n   *\n   * Note: you may prefer to use `algorand.client` to get an app client for more advanced functionality.\n   *\n   * @param params The parameters for the app creation transaction\n   * @example Basic example\n   * ```typescript\n   * const result = await algorand.send.appCreate({ sender: 'CREATORADDRESS', approvalProgram: 'TEALCODE', clearStateProgram: 'TEALCODE' })\n   * const createdAppId = result.appId\n   * ```\n   * @example Advanced example\n   * ```typescript\n   * await algorand.send.appCreate({\n   *  sender: 'CREATORADDRESS',\n   *  approvalProgram: \"TEALCODE\",\n   *  clearStateProgram: \"TEALCODE\",\n   *  schema: {\n   *    globalInts: 1,\n   *    globalByteSlices: 2,\n   *    localInts: 3,\n   *    localByteSlices: 4\n   *  },\n   *  extraProgramPages: 1,\n   *  onComplete: OnApplicationComplete.OptIn,\n   *  args: [new Uint8Array(1, 2, 3, 4)]\n   *  accountReferences: [\"ACCOUNT_1\"]\n   *  appReferences: [123n, 1234n]\n   *  assetReferences: [12345n]\n   *  boxReferences: [\"box1\", {appId: 1234n, name: \"box2\"}]\n   *  accessReferences: [{ appId: 1234n }]\n   *  lease: 'lease',\n   *  note: 'note',\n   *  // You wouldn't normally set this field\n   *  firstValidRound: 1000n,\n   *  validityWindow: 10,\n   *  extraFee: (1000).microAlgo(),\n   *  staticFee: (1000).microAlgo(),\n   *  // Max fee doesn't make sense with extraFee AND staticFee\n   *  //  already specified, but here for completeness\n   *  maxFee: (3000).microAlgo(),\n   *  rejectVersion: 1,\n   *  // Signer only needed if you want to provide one,\n   *  //  generally you'd register it with AlgorandClient\n   *  //  against the sender and not need to pass it in\n   *  signer: transactionSigner,\n   *  maxRoundsToWaitForConfirmation: 5,\n   *  suppressLog: true,\n   *})\n   * ```\n   * @returns The result of the app create transaction and the transaction that was sent\n   */\n  appCreate = this._sendAppCreateCall((c) => c.addAppCreate, {\n    postLog: (params, result) =>\n      `App created by ${getAddress(params.sender)} with ID ${result.confirmation.appId} via transaction ${result.txIds.at(-1)}`,\n  })\n\n  /**\n   * Update a smart contract.\n   *\n   * Note: you may prefer to use `algorand.client` to get an app client for more advanced functionality.\n   *\n   * @param params The parameters for the app update transaction\n   * @example Basic example\n   * ```typescript\n   * await algorand.send.appUpdate({ sender: 'CREATORADDRESS', approvalProgram: 'TEALCODE', clearStateProgram: 'TEALCODE' })\n   * ```\n   * @example Advanced example\n   * ```typescript\n   * await algorand.send.appUpdate({\n   *  sender: 'CREATORADDRESS',\n   *  approvalProgram: \"TEALCODE\",\n   *  clearStateProgram: \"TEALCODE\",\n   *  onComplete: OnApplicationComplete.UpdateApplication,\n   *  args: [new Uint8Array(1, 2, 3, 4)]\n   *  accountReferences: [\"ACCOUNT_1\"]\n   *  appReferences: [123n, 1234n]\n   *  assetReferences: [12345n]\n   *  boxReferences: [\"box1\", {appId: 1234n, name: \"box2\"}]\n   *  accessReferences: [{ appId: 1234n }]\n   *  lease: 'lease',\n   *  note: 'note',\n   *  // You wouldn't normally set this field\n   *  firstValidRound: 1000n,\n   *  validityWindow: 10,\n   *  extraFee: (1000).microAlgo(),\n   *  staticFee: (1000).microAlgo(),\n   *  // Max fee doesn't make sense with extraFee AND staticFee\n   *  //  already specified, but here for completeness\n   *  maxFee: (3000).microAlgo(),\n   *  rejectVersion: 1,\n   *  // Signer only needed if you want to provide one,\n   *  //  generally you'd register it with AlgorandClient\n   *  //  against the sender and not need to pass it in\n   *  signer: transactionSigner,\n   *  maxRoundsToWaitForConfirmation: 5,\n   *  suppressLog: true,\n   *})\n   * ```\n   * @returns The result of the app update transaction and the transaction that was sent\n   */\n  appUpdate = this._sendAppUpdateCall((c) => c.addAppUpdate, {\n    postLog: (params, result) =>\n      `App ${params.appId} updated ${params.args ? ` with ${params.args.map((a) => Buffer.from(a).toString('base64'))}` : ''} by ${getAddress(params.sender)} via transaction ${result.txIds.at(-1)}`,\n  })\n\n  /**\n   * Delete a smart contract.\n   *\n   * Note: you may prefer to use `algorand.client` to get an app client for more advanced functionality.\n   *\n   * @param params The parameters for the app deletion transaction\n   * @example Basic example\n   * ```typescript\n   * await algorand.send.appDelete({ sender: 'CREATORADDRESS' })\n   * ```\n   * @example Advanced example\n   * ```typescript\n   * await algorand.send.appDelete({\n   *  sender: 'CREATORADDRESS',\n   *  onComplete: OnApplicationComplete.DeleteApplication,\n   *  args: [new Uint8Array(1, 2, 3, 4)]\n   *  accountReferences: [\"ACCOUNT_1\"]\n   *  appReferences: [123n, 1234n]\n   *  assetReferences: [12345n]\n   *  boxReferences: [\"box1\", {appId: 1234n, name: \"box2\"}]\n   *  accessReferences: [{ appId: 1234n }]\n   *  lease: 'lease',\n   *  note: 'note',\n   *  // You wouldn't normally set this field\n   *  firstValidRound: 1000n,\n   *  validityWindow: 10,\n   *  extraFee: (1000).microAlgo(),\n   *  staticFee: (1000).microAlgo(),\n   *  // Max fee doesn't make sense with extraFee AND staticFee\n   *  //  already specified, but here for completeness\n   *  maxFee: (3000).microAlgo(),\n   *  rejectVersion: 1,\n   *  // Signer only needed if you want to provide one,\n   *  //  generally you'd register it with AlgorandClient\n   *  //  against the sender and not need to pass it in\n   *  signer: transactionSigner,\n   *  maxRoundsToWaitForConfirmation: 5,\n   *  suppressLog: true,\n   *})\n   * ```\n   * @returns The result of the app delete transaction and the transaction that was sent\n   */\n  appDelete = this._sendAppCall((c) => c.addAppDelete, {\n    postLog: (params, result) =>\n      `App ${params.appId} deleted ${params.args ? ` with ${params.args.map((a) => Buffer.from(a).toString('base64'))}` : ''} by ${getAddress(params.sender)} via transaction ${result.txIds.at(-1)}`,\n  })\n\n  /**\n   * Call a smart contract.\n   *\n   * Note: you may prefer to use `algorand.client` to get an app client for more advanced functionality.\n   *\n   * @param params The parameters for the app call transaction\n   * @example Basic example\n   * ```typescript\n   * await algorand.send.appCall({ sender: 'CREATORADDRESS' })\n   * ```\n   * @example Advanced example\n   * ```typescript\n   * await algorand.send.appCall({\n   *  sender: 'CREATORADDRESS',\n   *  onComplete: OnApplicationComplete.OptIn,\n   *  args: [new Uint8Array(1, 2, 3, 4)]\n   *  accountReferences: [\"ACCOUNT_1\"]\n   *  appReferences: [123n, 1234n]\n   *  assetReferences: [12345n]\n   *  boxReferences: [\"box1\", {appId: 1234n, name: \"box2\"}]\n   *  accessReferences: [{ appId: 1234n }]\n   *  lease: 'lease',\n   *  note: 'note',\n   *  // You wouldn't normally set this field\n   *  firstValidRound: 1000n,\n   *  validityWindow: 10,\n   *  extraFee: (1000).microAlgo(),\n   *  staticFee: (1000).microAlgo(),\n   *  // Max fee doesn't make sense with extraFee AND staticFee\n   *  //  already specified, but here for completeness\n   *  maxFee: (3000).microAlgo(),\n   *  rejectVersion: 1,\n   *  // Signer only needed if you want to provide one,\n   *  //  generally you'd register it with AlgorandClient\n   *  //  against the sender and not need to pass it in\n   *  signer: transactionSigner,\n   *  maxRoundsToWaitForConfirmation: 5,\n   *  suppressLog: true,\n   *})\n   * ```\n   * @returns The result of the app call transaction and the transaction that was sent\n   */\n  appCall = this._sendAppCall((c) => c.addAppCall, {\n    postLog: (params, result) =>\n      `App ${params.appId} called ${params.args ? ` with ${params.args.map((a) => Buffer.from(a).toString('base64'))}` : ''} by ${getAddress(params.sender)} via transaction ${result.txIds.at(-1)}`,\n  })\n\n  /**\n   * Create a smart contract via an ABI method.\n   *\n   * Note: you may prefer to use `algorand.client` to get an app client for more advanced functionality.\n   *\n   * @param params The parameters for the app creation transaction\n   * @example Basic example\n   * ```typescript\n   * const method = new ABIMethod({\n   *   name: 'method',\n   *   args: [{ name: 'arg1', type: 'string' }],\n   *   returns: { type: 'string' },\n   * })\n   * const result = await algorand.send.appCreateMethodCall({ sender: 'CREATORADDRESS', approvalProgram: 'TEALCODE', clearStateProgram: 'TEALCODE', method: method, args: [\"arg1_value\"] })\n   * const createdAppId = result.appId\n   * ```\n   * @example Advanced example\n   * ```typescript\n   * const method = new ABIMethod({\n   *   name: 'method',\n   *   args: [{ name: 'arg1', type: 'string' }],\n   *   returns: { type: 'string' },\n   * })\n   * await algorand.send.appCreateMethodCall({\n   *  sender: 'CREATORADDRESS',\n   *  method: method,\n   *  args: [\"arg1_value\"],\n   *  approvalProgram: \"TEALCODE\",\n   *  clearStateProgram: \"TEALCODE\",\n   *  schema: {\n   *    globalInts: 1,\n   *    globalByteSlices: 2,\n   *    localInts: 3,\n   *    localByteSlices: 4\n   *  },\n   *  extraProgramPages: 1,\n   *  onComplete: OnApplicationComplete.OptIn,\n   *  args: [new Uint8Array(1, 2, 3, 4)]\n   *  accountReferences: [\"ACCOUNT_1\"]\n   *  appReferences: [123n, 1234n]\n   *  assetReferences: [12345n]\n   *  boxReferences: [\"box1\", {appId: 1234n, name: \"box2\"}]\n   *  accessReferences: [{ appId: 1234n }]\n   *  lease: 'lease',\n   *  note: 'note',\n   *  // You wouldn't normally set this field\n   *  firstValidRound: 1000n,\n   *  validityWindow: 10,\n   *  extraFee: (1000).microAlgo(),\n   *  staticFee: (1000).microAlgo(),\n   *  // Max fee doesn't make sense with extraFee AND staticFee\n   *  //  already specified, but here for completeness\n   *  maxFee: (3000).microAlgo(),\n   *  rejectVersion: 1,\n   *  // Signer only needed if you want to provide one,\n   *  //  generally you'd register it with AlgorandClient\n   *  //  against the sender and not need to pass it in\n   *  signer: transactionSigner,\n   *  maxRoundsToWaitForConfirmation: 5,\n   *  suppressLog: true,\n   *})\n   * ```\n   * @returns The result of the application ABI method create transaction and the transaction that was sent\n   */\n  appCreateMethodCall = this._sendAppCreateCall((c) => c.addAppCreateMethodCall, {\n    postLog: (params, result) =>\n      `App created by ${getAddress(params.sender)} with ID ${result.confirmation.appId} via transaction ${result.txIds.at(-1)}`,\n  })\n\n  /**\n   * Update a smart contract via an ABI method.\n   *\n   * Note: you may prefer to use `algorand.client` to get an app client for more advanced functionality.\n   *\n   * @param params The parameters for the app update transaction\n   * @example Basic example\n   * ```typescript\n   * const method = new ABIMethod({\n   *   name: 'method',\n   *   args: [{ name: 'arg1', type: 'string' }],\n   *   returns: { type: 'string' },\n   * })\n   * await algorand.send.appUpdateMethodCall({ sender: 'CREATORADDRESS', approvalProgram: 'TEALCODE', clearStateProgram: 'TEALCODE', method: method, args: [\"arg1_value\"] })\n   * ```\n   * @example Advanced example\n   * ```typescript\n   * const method = new ABIMethod({\n   *   name: 'method',\n   *   args: [{ name: 'arg1', type: 'string' }],\n   *   returns: { type: 'string' },\n   * })\n   * await algorand.send.appUpdateMethodCall({\n   *  sender: 'CREATORADDRESS',\n   *  method: method,\n   *  args: [\"arg1_value\"],\n   *  approvalProgram: \"TEALCODE\",\n   *  clearStateProgram: \"TEALCODE\",\n   *  onComplete: OnApplicationComplete.UpdateApplication,\n   *  args: [new Uint8Array(1, 2, 3, 4)]\n   *  accountReferences: [\"ACCOUNT_1\"]\n   *  appReferences: [123n, 1234n]\n   *  assetReferences: [12345n]\n   *  boxReferences: [\"box1\", {appId: 1234n, name: \"box2\"}]\n   *  accessReferences: [{ appId: 1234n }]\n   *  lease: 'lease',\n   *  note: 'note',\n   *  // You wouldn't normally set this field\n   *  firstValidRound: 1000n,\n   *  validityWindow: 10,\n   *  extraFee: (1000).microAlgo(),\n   *  staticFee: (1000).microAlgo(),\n   *  // Max fee doesn't make sense with extraFee AND staticFee\n   *  //  already specified, but here for completeness\n   *  maxFee: (3000).microAlgo(),\n   *  rejectVersion: 1,\n   *  // Signer only needed if you want to provide one,\n   *  //  generally you'd register it with AlgorandClient\n   *  //  against the sender and not need to pass it in\n   *  signer: transactionSigner,\n   *  maxRoundsToWaitForConfirmation: 5,\n   *  suppressLog: true,\n   *})\n   * ```\n   * @returns The result of the application ABI method update transaction and the transaction that was sent\n   */\n  appUpdateMethodCall = this._sendAppUpdateCall((c) => c.addAppUpdateMethodCall, {\n    postLog: (params, result) =>\n      `App ${params.appId} updated with ${getMethodCallForLog(params)} by ${getAddress(params.sender)} via transaction ${result.txIds.at(-1)}`,\n  })\n\n  /**\n   * Delete a smart contract via an ABI method.\n   *\n   * Note: you may prefer to use `algorand.client` to get an app client for more advanced functionality.\n   *\n   * @param params The parameters for the app deletion transaction\n   * @example Basic example\n   * ```typescript\n   * const method = new ABIMethod({\n   *   name: 'method',\n   *   args: [{ name: 'arg1', type: 'string' }],\n   *   returns: { type: 'string' },\n   * })\n   * await algorand.send.appDeleteMethodCall({ sender: 'CREATORADDRESS', method: method, args: [\"arg1_value\"] })\n   * ```\n   * @example Advanced example\n   * ```typescript\n   * const method = new ABIMethod({\n   *   name: 'method',\n   *   args: [{ name: 'arg1', type: 'string' }],\n   *   returns: { type: 'string' },\n   * })\n   * await algorand.send.appDeleteMethodCall({\n   *  sender: 'CREATORADDRESS',\n   *  method: method,\n   *  args: [\"arg1_value\"],\n   *  onComplete: OnApplicationComplete.DeleteApplication,\n   *  args: [new Uint8Array(1, 2, 3, 4)]\n   *  accountReferences: [\"ACCOUNT_1\"]\n   *  appReferences: [123n, 1234n]\n   *  assetReferences: [12345n]\n   *  boxReferences: [\"box1\", {appId: 1234n, name: \"box2\"}]\n   *  accessReferences: [{ appId: 1234n }]\n   *  lease: 'lease',\n   *  note: 'note',\n   *  // You wouldn't normally set this field\n   *  firstValidRound: 1000n,\n   *  validityWindow: 10,\n   *  extraFee: (1000).microAlgo(),\n   *  staticFee: (1000).microAlgo(),\n   *  // Max fee doesn't make sense with extraFee AND staticFee\n   *  //  already specified, but here for completeness\n   *  maxFee: (3000).microAlgo(),\n   *  rejectVersion: 1,\n   *  // Signer only needed if you want to provide one,\n   *  //  generally you'd register it with AlgorandClient\n   *  //  against the sender and not need to pass it in\n   *  signer: transactionSigner,\n   *  maxRoundsToWaitForConfirmation: 5,\n   *  suppressLog: true,\n   *})\n   * ```\n   * @returns The result of the application ABI method delete transaction and the transaction that was sent\n   */\n  appDeleteMethodCall = this._sendAppCall((c) => c.addAppDeleteMethodCall, {\n    postLog: (params, result) =>\n      `App ${params.appId} deleted with ${getMethodCallForLog(params)} by ${getAddress(params.sender)} via transaction ${result.txIds.at(-1)}`,\n  })\n\n  /**\n   * Call a smart contract via an ABI method.\n   *\n   * Note: you may prefer to use `algorand.client` to get an app client for more advanced functionality.\n   *\n   * @param params The parameters for the app call transaction\n   * @example Basic example\n   * ```typescript\n   * const method = new ABIMethod({\n   *   name: 'method',\n   *   args: [{ name: 'arg1', type: 'string' }],\n   *   returns: { type: 'string' },\n   * })\n   * await algorand.send.appCallMethodCall({ sender: 'CREATORADDRESS', method: method, args: [\"arg1_value\"] })\n   * ```\n   * @example Advanced example\n   * ```typescript\n   * const method = new ABIMethod({\n   *   name: 'method',\n   *   args: [{ name: 'arg1', type: 'string' }],\n   *   returns: { type: 'string' },\n   * })\n   * await algorand.send.appCallMethodCall({\n   *  sender: 'CREATORADDRESS',\n   *  method: method,\n   *  args: [\"arg1_value\"],\n   *  onComplete: OnApplicationComplete.OptIn,\n   *  args: [new Uint8Array(1, 2, 3, 4)]\n   *  accountReferences: [\"ACCOUNT_1\"]\n   *  appReferences: [123n, 1234n]\n   *  assetReferences: [12345n]\n   *  boxReferences: [\"box1\", {appId: 1234n, name: \"box2\"}]\n   *  accessReferences: [{ appId: 1234n }]\n   *  lease: 'lease',\n   *  note: 'note',\n   *  // You wouldn't normally set this field\n   *  firstValidRound: 1000n,\n   *  validityWindow: 10,\n   *  extraFee: (1000).microAlgo(),\n   *  staticFee: (1000).microAlgo(),\n   *  // Max fee doesn't make sense with extraFee AND staticFee\n   *  //  already specified, but here for completeness\n   *  maxFee: (3000).microAlgo(),\n   *  rejectVersion: 1,\n   *  // Signer only needed if you want to provide one,\n   *  //  generally you'd register it with AlgorandClient\n   *  //  against the sender and not need to pass it in\n   *  signer: transactionSigner,\n   *  maxRoundsToWaitForConfirmation: 5,\n   *  suppressLog: true,\n   *})\n   * ```\n   * @returns The result of the application ABI method call transaction and the transaction that was sent\n   */\n  appCallMethodCall = this._sendAppCall((c) => c.addAppCallMethodCall, {\n    postLog: (params, result) =>\n      `App ${params.appId} called with ${getMethodCallForLog(params)} by ${getAddress(params.sender)} via transaction ${result.txIds.at(-1)}`,\n  })\n\n  /**\n   * Register an online key.\n   * @param params The parameters for the key registration transaction\n   * @example Basic example\n   * ```typescript\n   * const result = await algorand.send.onlineKeyRegistration({\n   *   sender: 'SENDERADDRESS',\n   *   voteKey: Uint8Array.from(Buffer.from(\"voteKeyBase64\", 'base64')),\n   *   selectionKey: Uint8Array.from(Buffer.from(\"selectionKeyBase64\", 'base64')),\n   *   stateProofKey: Uint8Array.from(Buffer.from(\"stateProofKeyBase64\", 'base64')),\n   *   voteFirst: 1n,\n   *   voteLast: 1000n,\n   *   voteKeyDilution: 1n,\n   * })\n   * ```\n   * @example Advanced example\n   * ```typescript\n   * const result = await algorand.send.onlineKeyRegistration({\n   *   sender: 'SENDERADDRESS',\n   *   voteKey: Uint8Array.from(Buffer.from(\"voteKeyBase64\", 'base64')),\n   *   selectionKey: Uint8Array.from(Buffer.from(\"selectionKeyBase64\", 'base64')),\n   *   stateProofKey: Uint8Array.from(Buffer.from(\"stateProofKeyBase64\", 'base64')),\n   *   voteFirst: 1n,\n   *   voteLast: 1000n,\n   *   voteKeyDilution: 1n,\n   *   lease: 'lease',\n   *   note: 'note',\n   *   // Use this with caution, it's generally better to use algorand.account.rekeyAccount\n   *   rekeyTo: 'REKEYTOADDRESS',\n   *   // You wouldn't normally set this field\n   *   firstValidRound: 1000n,\n   *   validityWindow: 10,\n   *   extraFee: (1000).microAlgo(),\n   *   staticFee: (1000).microAlgo(),\n   *   // Max fee doesn't make sense with extraFee AND staticFee\n   *   //  already specified, but here for completeness\n   *   maxFee: (3000).microAlgo(),\n   * })\n   * ```\n   * @returns The result of the online key registration transaction and the transaction that was sent\n   */\n  onlineKeyRegistration = this._send((c) => c.addOnlineKeyRegistration, {\n    preLog: (params, transaction) => `Registering online key for ${getAddress(params.sender)} via transaction ${transaction.txId()}`,\n  })\n\n  /**\n   * Register an offline key.\n   * @param params The parameters for the key registration transaction\n   * @example Basic example\n   * ```typescript\n   * const result = await algorand.send.offlineKeyRegistration({\n   *   sender: 'SENDERADDRESS',\n   * })\n   * ```\n   * @example Advanced example\n   * ```typescript\n   * const result = await algorand.send.offlineKeyRegistration({\n   *   sender: 'SENDERADDRESS',\n   *   lease: 'lease',\n   *   note: 'note',\n   *   // Use this with caution, it's generally better to use algorand.account.rekeyAccount\n   *   rekeyTo: 'REKEYTOADDRESS',\n   *   // You wouldn't normally set this field\n   *   firstValidRound: 1000n,\n   *   validityWindow: 10,\n   *   extraFee: (1000).microAlgo(),\n   *   staticFee: (1000).microAlgo(),\n   *   // Max fee doesn't make sense with extraFee AND staticFee\n   *   //  already specified, but here for completeness\n   *   maxFee: (3000).microAlgo(),\n   * })\n   * ```\n   * @returns The result of the offline key registration transaction and the transaction that was sent\n   */\n  offlineKeyRegistration = this._send((c) => c.addOfflineKeyRegistration, {\n    preLog: (params, transaction) => `Registering offline key for ${getAddress(params.sender)} via transaction ${transaction.txId()}`,\n  })\n}\n"],"mappings":"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"}

package/algorand-client.d.ts

@@ -0,0 +1,266 @@
+import { Address } from "./packages/common/src/address.js";
+import { MultisigAccount } from "./packages/transact/src/multisig.js";
+import { LogicSigAccount } from "./packages/transact/src/logicsig.js";
+import { AddressWithTransactionSigner, TransactionSigner } from "./packages/transact/src/signer.js";
+import { SuggestedParams } from "./packages/algod_client/src/models/suggested-params.js";
+import { AppManager } from "./app-manager.js";
+import { ErrorTransformer, TransactionComposer, TransactionComposerConfig } from "./composer.js";
+import { AlgorandClientTransactionCreator } from "./algorand-client-transaction-creator.js";
+import { AssetManager } from "./asset-manager.js";
+import { AlgorandClientTransactionSender } from "./algorand-client-transaction-sender.js";
+import { AppDeployer } from "./app-deployer.js";
+import { AlgoConfig } from "./network-client.js";
+import { NetworkManager } from "./network-manager.js";
+import { AlgoSdkClients, ClientManager } from "./client-manager.js";
+import { AccountManager } from "./account-manager.js";
+
+//#region src/algorand-client.d.ts
+/**
+ * A client that brokers easy access to Algorand functionality.
+ */
+declare class AlgorandClient {
+  private _clientManager;
+  private _accountManager;
+  private _appManager;
+  private _appDeployer;
+  private _assetManager;
+  private _networkManager;
+  private _transactionSender;
+  private _transactionCreator;
+  private _cachedSuggestedParams?;
+  private _cachedSuggestedParamsExpiry?;
+  private _cachedSuggestedParamsTimeout;
+  private _defaultValidityWindow;
+  /**
+   * A set of error transformers to use when an error is caught in simulate or execute
+   * `registerErrorTransformer` and `unregisterErrorTransformer` can be used to add and remove
+   * error transformers from the set.
+   */
+  private _errorTransformers;
+  private constructor();
+  /**
+   * Sets the default validity window for transactions.
+   * @param validityWindow The number of rounds between the first and last valid rounds
+   * @returns The `AlgorandClient` so method calls can be chained
+   * @example
+   * ```typescript
+   * const algorand = AlgorandClient.mainNet().setDefaultValidityWindow(1000);
+   * ```
+   */
+  setDefaultValidityWindow(validityWindow: number | bigint): this;
+  /**
+   * Sets the default signer to use if no other signer is specified.
+   * @param signer The signer to use, either a `TransactionSigner` or a `AddressWithSigner`
+   * @returns The `AlgorandClient` so method calls can be chained
+   * @example
+   * ```typescript
+   * const signer = new SigningAccount(account, account.addr)
+   * const algorand = AlgorandClient.mainNet().setDefaultSigner(signer)
+   * ```
+   */
+  setDefaultSigner(signer: TransactionSigner | AddressWithTransactionSigner): AlgorandClient;
+  /**
+   * Tracks the given account (object that encapsulates an address and a signer) for later signing.
+   * @param account The account to register, which can be a `AddressWithSigner` or
+   *  a `algosdk.Account`, `algosdk.LogicSigAccount`, `SigningAccount` or `MultisigAccount`
+   * @example
+   * ```typescript
+   * const accountManager = AlgorandClient.mainNet()
+   *  .setSignerFromAccount(algosdk.generateAccount())
+   *  .setSignerFromAccount(new algosdk.LogicSigAccount(program, args))
+   *  .setSignerFromAccount(new SigningAccount(account, sender))
+   *  .setSignerFromAccount(new MultisigAccount({version: 1, threshold: 1, addrs: ["ADDRESS1...", "ADDRESS2..."]}, [account1, account2]))
+   *  .setSignerFromAccount({addr: "SENDERADDRESS", signer: transactionSigner})
+   * ```
+   * @returns The `AlgorandClient` so method calls can be chained
+   */
+  setSignerFromAccount(account: AddressWithTransactionSigner | LogicSigAccount | MultisigAccount): this;
+  /**
+   * Tracks the given signer against the given sender for later signing.
+   * @param sender The sender address to use this signer for
+   * @param signer The signer to sign transactions with for the given sender
+   * @returns The `AlgorandClient` so method calls can be chained
+   * @example
+   * ```typescript
+   * const signer = new SigningAccount(account, account.addr)
+   * const algorand = AlgorandClient.mainNet().setSigner(signer.addr, signer.signer)
+   * ```
+   */
+  setSigner(sender: string | Address, signer: TransactionSigner): this;
+  /**
+   * Sets a cache value to use for suggested transaction params.
+   * @param suggestedParams The suggested params to use
+   * @param until A date until which to cache, or if not specified then the timeout is used
+   * @returns The `AlgorandClient` so method calls can be chained
+   * @example
+   * ```typescript
+   * const algorand = AlgorandClient.mainNet().setSuggestedParamsCache(suggestedParams, new Date(+new Date() + 3_600_000))
+   * ```
+   */
+  setSuggestedParamsCache(suggestedParams: SuggestedParams, until?: Date): this;
+  /**
+   * Sets the timeout for caching suggested params.
+   * @param timeout The timeout in milliseconds
+   * @returns The `AlgorandClient` so method calls can be chained
+   * @example
+   * ```typescript
+   * const algorand = AlgorandClient.mainNet().setSuggestedParamsCacheTimeout(10_000)
+   * ```
+   */
+  setSuggestedParamsCacheTimeout(timeout: number): this;
+  /**
+   * Get suggested params for a transaction (either cached or from algod if the cache is stale or empty)
+   * @returns The suggested transaction parameters.
+   * @example
+   * const params = await AlgorandClient.mainNet().getSuggestedParams();
+   */
+  getSuggestedParams(): Promise<SuggestedParams>;
+  /**
+   * Get clients, including algosdk clients and app clients.
+   * @returns The `ClientManager` instance.
+   * @example
+   * const clientManager = AlgorandClient.mainNet().client;
+   */
+  get client(): ClientManager;
+  /**
+   * Get or create accounts that can sign transactions.
+   * @returns The `AccountManager` instance.
+   * @example
+   * const accountManager = AlgorandClient.mainNet().account;
+   */
+  get account(): AccountManager;
+  /**
+   * Methods for interacting with assets.
+   * @returns The `AssetManager` instance.
+   * @example
+   * const assetManager = AlgorandClient.mainNet().asset;
+   */
+  get asset(): AssetManager;
+  /**
+   * Methods for interacting with apps.
+   * @returns The `AppManager` instance.
+   * @example
+   * const appManager = AlgorandClient.mainNet().app;
+   */
+  get app(): AppManager;
+  /**
+   * Methods for deploying apps and managing app deployment metadata.
+   * @returns The `AppDeployer` instance.
+   * @example
+   * const deployer = AlgorandClient.mainNet().appDeployer;
+   */
+  get appDeployer(): AppDeployer;
+  /**
+   * Methods for interacting with the network.
+   * Provides utilities for querying blockchain state and waiting for specific conditions.
+   * @returns The `NetworkManager` instance.
+   * @example
+   * ```typescript
+   * // Get last round
+   * const lastRound = await algorand.network.getLastRound()
+   *
+   * // Wait for a specific round
+   * await algorand.network.waitUntilRound(1000n)
+   *
+   * // LocalNet-specific: block warp
+   * await algorand.network.localNet.blockWarp(100n)
+   * ```
+   */
+  get network(): NetworkManager;
+  /**
+   * Register a function that will be used to transform an error caught when simulating or executing
+   * composed transaction groups made from `newGroup`
+   */
+  registerErrorTransformer(transformer: ErrorTransformer): void;
+  unregisterErrorTransformer(transformer: ErrorTransformer): void;
+  /** Start a new `TransactionComposer` transaction group
+   * @returns A new instance of `TransactionComposer`.
+   * @example
+   * {@includeCode ./algorand-client.spec.ts#example-newGroup}
+   * @see [Full working example](https://github.com/algorandfoundation/algokit-utils-ts/blob/main/src/algorand-client.spec.ts)
+   */
+  newGroup(composerConfig?: TransactionComposerConfig): TransactionComposer;
+  /**
+   * Methods for sending a transaction.
+   * @returns The `AlgorandClientTransactionSender` instance.
+   * @example
+   * const result = await AlgorandClient.mainNet().send.payment({
+   *  sender: "SENDERADDRESS",
+   *  receiver: "RECEIVERADDRESS",
+   *  amount: algo(1)
+   * })
+   */
+  get send(): AlgorandClientTransactionSender;
+  /**
+   * Methods for creating a transaction.
+   * @returns The `AlgorandClientTransactionCreator` instance.
+   * @example
+   * const payment = await AlgorandClient.mainNet().createTransaction.payment({
+   *  sender: "SENDERADDRESS",
+   *  receiver: "RECEIVERADDRESS",
+   *  amount: algo(1)
+   * })
+   */
+  get createTransaction(): AlgorandClientTransactionCreator;
+  /**
+   * Creates an `AlgorandClient` pointing at default LocalNet ports and API token.
+   * @returns An instance of the `AlgorandClient`.
+   * @example
+   * {@includeCode ./algorand-client.spec.ts#example-defaultLocalNet}
+   * @see [Full working example](https://github.com/algorandfoundation/algokit-utils-ts/blob/main/src/algorand-client.spec.ts)
+   */
+  static defaultLocalNet(): AlgorandClient;
+  /**
+   * Creates an `AlgorandClient` pointing at TestNet using AlgoNode.
+   * @returns An instance of the `AlgorandClient`.
+   * @example
+   * const algorand = AlgorandClient.testNet();
+   */
+  static testNet(): AlgorandClient;
+  /**
+   * Creates an `AlgorandClient` pointing at MainNet using AlgoNode.
+   * @returns An instance of the `AlgorandClient`.
+   * @example
+   * const algorand = AlgorandClient.mainNet();
+   */
+  static mainNet(): AlgorandClient;
+  /**
+   * Creates an `AlgorandClient` pointing to the given client(s).
+   * @param clients The clients to use.
+   * @returns An instance of the `AlgorandClient`.
+   * @example
+   * const algorand = AlgorandClient.fromClients({ algod, indexer, kmd });
+   */
+  static fromClients(clients: AlgoSdkClients): AlgorandClient;
+  /**
+   * Creates an `AlgorandClient` loading the configuration from environment variables.
+   *
+   * Retrieve configurations from environment variables when defined or get default LocalNet configuration if they aren't defined.
+   *
+   * Expects to be called from a Node.js environment.
+   *
+   * If `process.env.ALGOD_SERVER` is defined it will use that along with optional `process.env.ALGOD_PORT` and `process.env.ALGOD_TOKEN`.
+   *
+   * If `process.env.INDEXER_SERVER` is defined it will use that along with optional `process.env.INDEXER_PORT` and `process.env.INDEXER_TOKEN`.
+   *
+   * If either aren't defined it will use the default LocalNet config.
+   *
+   * It will return a KMD configuration that uses `process.env.KMD_PORT` (or port 4002) if `process.env.ALGOD_SERVER` is defined,
+   * otherwise it will use the default LocalNet config unless it detects testnet or mainnet.
+   * @returns An instance of the `AlgorandClient`.
+   * @example
+   * const client = AlgorandClient.fromEnvironment();
+   */
+  static fromEnvironment(): AlgorandClient;
+  /**
+   * Creates  an `AlgorandClient` from the given config.
+   * @param config The config to use.
+   * @returns An instance of the `AlgorandClient`.
+   * @example
+   * const client = AlgorandClient.fromConfig({ algodConfig, indexerConfig, kmdConfig });
+   */
+  static fromConfig(config: AlgoConfig): AlgorandClient;
+}
+//#endregion
+export { AlgorandClient };
+//# sourceMappingURL=algorand-client.d.ts.map