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

package/testing/types.d.ts

@@ -0,0 +1,156 @@
+import { Address } from "../packages/common/src/address.js";
+import { Transaction } from "../packages/transact/src/transactions/transaction.js";
+import { MultisigAccount } from "../packages/transact/src/multisig.js";
+import { LogicSigAccount } from "../packages/transact/src/logicsig.js";
+import { AddressWithSigners, AddressWithTransactionSigner } from "../packages/transact/src/signer.js";
+import { AlgodClient } from "../packages/algod_client/src/client.js";
+import { AlgoAmount } from "../amount.js";
+import { TransactionResponse } from "../packages/indexer_client/src/models/transaction-response.js";
+import { IndexerClient } from "../packages/indexer_client/src/client.js";
+import { KmdClient } from "../packages/kmd_client/src/client.js";
+import { AlgoConfig } from "../network-client.js";
+import { AlgorandClient } from "../algorand-client.js";
+import { TestLogger } from "./test-logger.js";
+import { TransactionLogger } from "./transaction-logger.js";
+
+//#region src/testing/types.d.ts
+/**
+ * Test automation context.
+ */
+interface AlgorandTestAutomationContext {
+  /** An AlgorandClient instance loaded with the current context, including testAccount and any generated accounts loaded as signers */
+  algorand: AlgorandClient;
+  /** Algod client instance that will log transactions in `transactionLogger` */
+  algod: AlgodClient;
+  /** Indexer client instance */
+  indexer: IndexerClient;
+  /** KMD client instance */
+  kmd: KmdClient;
+  /** Transaction logger that will log transaction IDs for all transactions issued by `algod` */
+  transactionLogger: TransactionLogger;
+  /** Default, funded test account that is ephemerally created */
+  testAccount: Address & AddressWithSigners;
+  /** Generate and fund an additional ephemerally created account */
+  generateAccount: (params: GetTestAccountParams) => Promise<Address & AddressWithSigners>;
+  /** Wait for the indexer to catch up with all transactions logged by `transactionLogger` */
+  waitForIndexer: () => Promise<void>;
+  /** Wait for the indexer to catch up with the given transaction ID */
+  waitForIndexerTransaction: (transactionId: string) => Promise<TransactionResponse>;
+}
+/**
+ * Parameters for the `getTestAccount` function.
+ */
+interface GetTestAccountParams {
+  /** Initial funds to ensure the account has */
+  initialFunds: AlgoAmount;
+  /** Whether to suppress the log (which includes a mnemonic) or not (default: do not suppress the log) */
+  suppressLog?: boolean;
+  /** Optional override for how to get a test account; this allows you to retrieve accounts from a known or cached list of accounts. */
+  accountGetter?: (algorand: AlgorandClient) => Promise<Address & AddressWithSigners>;
+}
+/** Configuration for creating an Algorand testing fixture. */
+interface AlgorandFixtureConfig extends Partial<AlgoConfig> {
+  /** An optional algod client, if not specified then it will create one against `algodConfig` (if present) then environment variables defined network (if present) or default LocalNet. */
+  algod?: AlgodClient;
+  /** An optional indexer client, if not specified then it will create one against `indexerConfig` (if present) then environment variables defined network (if present) or default LocalNet. */
+  indexer?: IndexerClient;
+  /** An optional kmd client, if not specified then it will create one against `kmdConfig` (if present) then environment variables defined network (if present) or default LocalNet. */
+  kmd?: KmdClient;
+  /** The amount of funds to allocate to the default testing account, if not specified then it will get 10 ALGO. */
+  testAccountFunding?: AlgoAmount;
+  /** Optional override for how to get an account; this allows you to retrieve accounts from a known or cached list of accounts. */
+  accountGetter?: (algorand: AlgorandClient) => Promise<Address & AddressWithSigners>;
+}
+/** An Algorand automated testing fixture */
+interface AlgorandFixture {
+  /**
+   * Retrieve the current context.
+   * Useful with destructuring.
+   *
+   * If you haven't called `newScope` then this will throw an error.
+   * @example
+   * ```typescript
+   * test('My test', () => {
+   *     const {algod, indexer, testAccount, ...} = fixture.context
+   * })
+   * ```
+   */
+  get context(): AlgorandTestAutomationContext;
+  /**
+   * Retrieve an `AlgorandClient` loaded with the current context, including testAccount and any generated accounts loaded as signers.
+   */
+  get algorand(): AlgorandClient;
+  /**
+   * @deprecated Use newScope instead.
+   * Testing framework agnostic handler method to run before each test to prepare the `context` for that test with per test isolation.
+   */
+  beforeEach: () => Promise<void>;
+  /**
+   * Creates a new isolated fixture scope (clean transaction logger, AlgorandClient, testAccount, etc.).
+   *
+   * You can call this from any testing framework specific hook method to control when you want a new scope.
+   *
+   * @example Jest / vitest - per test isolation (beforeEach)
+   * ```typescript
+   * describe('MY MODULE', () => {
+   *   const fixture = algorandFixture()
+   *   beforeEach(fixture.newScope)
+   *
+   *   test('MY TEST', async () => {
+   *     const { algorand, testAccount } = fixture.context
+   *
+   *     // Test stuff!
+   *   })
+   * })
+   * ```
+   *
+   * @example Jest / vitest - test suite isolation (beforeAll)
+   * ```typescript
+   * describe('MY MODULE', () => {
+   *   const fixture = algorandFixture()
+   *   beforeAll(fixture.newScope)
+   *
+   *   test('test1', async () => {
+   *     const { algorand, testAccount } = fixture.context
+   *
+   *     // Test stuff!
+   *   })
+   *   test('test2', async () => {
+   *     const { algorand, testAccount } = fixture.context
+   *     // algorand and testAccount are the same as in test1
+   *   })
+   * })
+   * ```
+   *
+   */
+  newScope: () => Promise<void>;
+}
+/** Configuration for preparing a captured log snapshot.
+ * This helps ensure that the provided configuration items won't appear
+ *  with random values in the log snapshot, but rather will get substituted with predictable ids.
+ */
+interface LogSnapshotConfig {
+  /** Any transaction IDs or transactions to replace the ID for predictably */
+  transactions?: (string | Transaction)[];
+  /** Any accounts/addresses to replace the address for predictably */
+  accounts?: (string | Address | LogicSigAccount | MultisigAccount | AddressWithTransactionSigner)[];
+  /** Any app IDs to replace predictably */
+  apps?: (string | number | bigint)[];
+  /** Optional filter predicate to filter out logs */
+  filterPredicate?: (log: string) => boolean;
+}
+interface AlgoKitLogCaptureFixture {
+  /** The test logger instance for the current test */
+  get testLogger(): TestLogger;
+  /**
+   * Testing framework agnostic handler method to run before each test to prepare the `testLogger` for that test.
+   */
+  beforeEach: () => void;
+  /**
+   * Testing framework agnostic handler method to run after each test to reset the logger.
+   */
+  afterEach: () => void;
+}
+//#endregion
+export { AlgoKitLogCaptureFixture, AlgorandFixture, AlgorandFixtureConfig, AlgorandTestAutomationContext, GetTestAccountParams, LogSnapshotConfig };
+//# sourceMappingURL=types.d.ts.map

package/transact/index.d.ts

@@ -1,17 +1,18 @@
-import { AccessReference, AppCallTransactionFields, BoxReference, HoldingReference, LocalsReference, OnApplicationComplete, StateSchema, validateAppCallTransaction } from "../packages/transact/src/transactions/app-call.js";
-import { AssetConfigTransactionFields, validateAssetConfigTransaction } from "../packages/transact/src/transactions/asset-config.js";
-import { AssetFreezeTransactionFields, validateAssetFreezeTransaction } from "../packages/transact/src/transactions/asset-freeze.js";
-import { AssetTransferTransactionFields, validateAssetTransferTransaction } from "../packages/transact/src/transactions/asset-transfer.js";
+import { AppCallTransactionFields, BoxReference, HoldingReference, LocalsReference, OnApplicationComplete, ResourceReference, StateSchema } from "../packages/transact/src/transactions/app-call.js";
+import { AssetConfigTransactionFields } from "../packages/transact/src/transactions/asset-config.js";
+import { AssetFreezeTransactionFields } from "../packages/transact/src/transactions/asset-freeze.js";
+import { AssetTransferTransactionFields } from "../packages/transact/src/transactions/asset-transfer.js";
 import { HeartbeatProof, HeartbeatTransactionFields } from "../packages/transact/src/transactions/heartbeat.js";
-import { KeyRegistrationTransactionFields, validateKeyRegistrationTransaction } from "../packages/transact/src/transactions/key-registration.js";
+import { KeyRegistrationTransactionFields } from "../packages/transact/src/transactions/key-registration.js";
 import { PaymentTransactionFields } from "../packages/transact/src/transactions/payment.js";
 import { FalconSignatureStruct, FalconVerifier, HashFactory, MerkleArrayProof, MerkleSignatureVerifier, Participant, Reveal, SigslotCommit, StateProof, StateProofMessage, StateProofTransactionFields } from "../packages/transact/src/transactions/state-proof.js";
 import { TransactionType } from "../packages/transact/src/transactions/transaction-type.js";
-import { Transaction, TransactionParams, assignFee, calculateFee, decodeTransaction, decodeTransactions, encodeTransaction, encodeTransactionRaw, encodeTransactions, estimateTransactionSize, getEncodedTransactionType, groupTransactions, transactionCodec } from "../packages/transact/src/transactions/transaction.js";
-import { LogicSignature, MultisigSignature, MultisigSubsignature, SignedTransaction, decodeSignedTransaction, decodeSignedTransactions, encodeSignedTransaction, encodeSignedTransactions } from "../packages/transact/src/transactions/signed-transaction.js";
+import { Transaction, TransactionParams, assignFee, calculateFee, decodeTransaction, decodeTransactions, encodeTransaction, encodeTransactionRaw, encodeTransactions, estimateTransactionSize, getEncodedTransactionType, groupTransactions, transactionCodec, validateTransaction } from "../packages/transact/src/transactions/transaction.js";
+import { LogicSigSignature, MultisigSignature, MultisigSubsignature, SignedTransaction, decodeSignedTransaction, decodeSignedTransactions, encodeSignedTransaction, encodeSignedTransactionToJson, encodeSignedTransactions, validateSignedTransaction } from "../packages/transact/src/transactions/signed-transaction.js";
+import { BoxReferenceMeta, HoldingReferenceMeta, LocalsReferenceMeta } from "../packages/transact/src/transactions/reference-types-meta.js";
 import { SignedTransactionMeta } from "../packages/transact/src/transactions/signed-transaction-meta.js";
 import { TransactionParamsMeta, transactionParamsCodec } from "../packages/transact/src/transactions/transaction-meta.js";
-import { MULTISIG_MERGE_LESSTHANTWO_ERROR_MSG, MULTISIG_MERGE_MISMATCH_AUTH_ADDR_MSG, MULTISIG_MERGE_MISMATCH_ERROR_MSG, MULTISIG_MERGE_SIG_MISMATCH_ERROR_MSG, MULTISIG_MERGE_WRONG_PREIMAGE_ERROR_MSG, MULTISIG_NO_MUTATE_ERROR_MSG, MULTISIG_SIGNATURE_LENGTH_ERROR_MSG, MULTISIG_USE_PARTIAL_SIGN_ERROR_MSG, MultisigAccount, MultisigMetadata, addressFromMultisigPreImg, addressFromMultisigPreImgAddrs, addressFromMultisigSignature, appendSignRawMultisigSignature, applyMultisigSubsignature, createMultisigTransaction, decodeMultiSignature, mergeMultisigTransactions, mergeMultisignatures, multisigAddress, newMultisigSignature, participantsFromMultisigSignature } from "../packages/transact/src/multisig.js";
-import { DelegatedLsigSigner, LogicSigAccount, ProgramDataSigner, decodeLogicSignature, sanityCheckProgram } from "../packages/transact/src/logicsig.js";
-import { AddressWithDelegatedLsigSigner, AddressWithMxBytesSigner, AddressWithProgramDataSigner, AddressWithSigners, AddressWithTransactionSigner, MxBytesSigner, SendingAddress, TransactionSigner, generateAddressWithSigners, makeEmptyTransactionSigner } from "../packages/transact/src/signer.js";
-export { AccessReference, AddressWithDelegatedLsigSigner, AddressWithMxBytesSigner, AddressWithProgramDataSigner, AddressWithSigners, AddressWithTransactionSigner, AppCallTransactionFields, AssetConfigTransactionFields, AssetFreezeTransactionFields, AssetTransferTransactionFields, BoxReference, DelegatedLsigSigner, FalconSignatureStruct, FalconVerifier, HashFactory, HeartbeatProof, HeartbeatTransactionFields, HoldingReference, KeyRegistrationTransactionFields, LocalsReference, LogicSigAccount, LogicSignature, MULTISIG_MERGE_LESSTHANTWO_ERROR_MSG, MULTISIG_MERGE_MISMATCH_AUTH_ADDR_MSG, MULTISIG_MERGE_MISMATCH_ERROR_MSG, MULTISIG_MERGE_SIG_MISMATCH_ERROR_MSG, MULTISIG_MERGE_WRONG_PREIMAGE_ERROR_MSG, MULTISIG_NO_MUTATE_ERROR_MSG, MULTISIG_SIGNATURE_LENGTH_ERROR_MSG, MULTISIG_USE_PARTIAL_SIGN_ERROR_MSG, MerkleArrayProof, MerkleSignatureVerifier, MultisigAccount, MultisigMetadata, MultisigSignature, MultisigSubsignature, MxBytesSigner, OnApplicationComplete, Participant, PaymentTransactionFields, ProgramDataSigner, Reveal, SendingAddress, SignedTransaction, SignedTransactionMeta, SigslotCommit, StateProof, StateProofMessage, StateProofTransactionFields, StateSchema, Transaction, TransactionParams, TransactionParamsMeta, TransactionSigner, TransactionType, addressFromMultisigPreImg, addressFromMultisigPreImgAddrs, addressFromMultisigSignature, appendSignRawMultisigSignature, applyMultisigSubsignature, assignFee, calculateFee, createMultisigTransaction, decodeLogicSignature, decodeMultiSignature, decodeSignedTransaction, decodeSignedTransactions, decodeTransaction, decodeTransactions, encodeSignedTransaction, encodeSignedTransactions, encodeTransaction, encodeTransactionRaw, encodeTransactions, estimateTransactionSize, generateAddressWithSigners, getEncodedTransactionType, groupTransactions, makeEmptyTransactionSigner, mergeMultisigTransactions, mergeMultisignatures, multisigAddress, newMultisigSignature, participantsFromMultisigSignature, sanityCheckProgram, transactionCodec, transactionParamsCodec, validateAppCallTransaction, validateAssetConfigTransaction, validateAssetFreezeTransaction, validateAssetTransferTransaction, validateKeyRegistrationTransaction };
+import { MultisigAccount, MultisigMetadata } from "../packages/transact/src/multisig.js";
+import { DelegatedLsigSigner, LogicSig, LogicSigAccount, ProgramDataSigner } from "../packages/transact/src/logicsig.js";
+import { AddressWithDelegatedLsigSigner, AddressWithMxBytesSigner, AddressWithProgramDataSigner, AddressWithSigners, AddressWithTransactionSigner, MxBytesSigner, SendingAddress, TransactionSigner, bytesForSigning, generateAddressWithSigners, makeEmptyTransactionSigner } from "../packages/transact/src/signer.js";
+export { AddressWithDelegatedLsigSigner, AddressWithMxBytesSigner, AddressWithProgramDataSigner, AddressWithSigners, AddressWithTransactionSigner, AppCallTransactionFields, AssetConfigTransactionFields, AssetFreezeTransactionFields, AssetTransferTransactionFields, BoxReference, BoxReferenceMeta, DelegatedLsigSigner, FalconSignatureStruct, FalconVerifier, HashFactory, HeartbeatProof, HeartbeatTransactionFields, HoldingReference, HoldingReferenceMeta, KeyRegistrationTransactionFields, LocalsReference, LocalsReferenceMeta, LogicSig, LogicSigAccount, LogicSigSignature, MerkleArrayProof, MerkleSignatureVerifier, MultisigAccount, MultisigMetadata, MultisigSignature, MultisigSubsignature, MxBytesSigner, OnApplicationComplete, Participant, PaymentTransactionFields, ProgramDataSigner, ResourceReference, Reveal, SendingAddress, SignedTransaction, SignedTransactionMeta, SigslotCommit, StateProof, StateProofMessage, StateProofTransactionFields, StateSchema, Transaction, TransactionParams, TransactionParamsMeta, TransactionSigner, TransactionType, assignFee, bytesForSigning, calculateFee, decodeSignedTransaction, decodeSignedTransactions, decodeTransaction, decodeTransactions, encodeSignedTransaction, encodeSignedTransactionToJson, encodeSignedTransactions, encodeTransaction, encodeTransactionRaw, encodeTransactions, estimateTransactionSize, generateAddressWithSigners, getEncodedTransactionType, groupTransactions, makeEmptyTransactionSigner, transactionCodec, transactionParamsCodec, validateSignedTransaction, validateTransaction };

package/transact/index.js

@@ -1,47 +1,35 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_app_call = require('../packages/transact/src/transactions/app-call.js');
-const require_asset_config = require('../packages/transact/src/transactions/asset-config.js');
-const require_asset_freeze = require('../packages/transact/src/transactions/asset-freeze.js');
-const require_asset_transfer = require('../packages/transact/src/transactions/asset-transfer.js');
-const require_key_registration = require('../packages/transact/src/transactions/key-registration.js');
 const require_transaction_type = require('../packages/transact/src/transactions/transaction-type.js');
 const require_transaction_meta = require('../packages/transact/src/transactions/transaction-meta.js');
 const require_transaction = require('../packages/transact/src/transactions/transaction.js');
 const require_signed_transaction_meta = require('../packages/transact/src/transactions/signed-transaction-meta.js');
 const require_signed_transaction = require('../packages/transact/src/transactions/signed-transaction.js');
+const require_reference_types_meta = require('../packages/transact/src/transactions/reference-types-meta.js');
 const require_signer = require('../packages/transact/src/signer.js');
 const require_multisig = require('../packages/transact/src/multisig.js');
 const require_logicsig = require('../packages/transact/src/logicsig.js');
 
+exports.BoxReferenceMeta = require_reference_types_meta.BoxReferenceMeta;
+exports.HoldingReferenceMeta = require_reference_types_meta.HoldingReferenceMeta;
+exports.LocalsReferenceMeta = require_reference_types_meta.LocalsReferenceMeta;
+exports.LogicSig = require_logicsig.LogicSig;
 exports.LogicSigAccount = require_logicsig.LogicSigAccount;
-exports.MULTISIG_MERGE_LESSTHANTWO_ERROR_MSG = require_multisig.MULTISIG_MERGE_LESSTHANTWO_ERROR_MSG;
-exports.MULTISIG_MERGE_MISMATCH_AUTH_ADDR_MSG = require_multisig.MULTISIG_MERGE_MISMATCH_AUTH_ADDR_MSG;
-exports.MULTISIG_MERGE_MISMATCH_ERROR_MSG = require_multisig.MULTISIG_MERGE_MISMATCH_ERROR_MSG;
-exports.MULTISIG_MERGE_SIG_MISMATCH_ERROR_MSG = require_multisig.MULTISIG_MERGE_SIG_MISMATCH_ERROR_MSG;
-exports.MULTISIG_MERGE_WRONG_PREIMAGE_ERROR_MSG = require_multisig.MULTISIG_MERGE_WRONG_PREIMAGE_ERROR_MSG;
-exports.MULTISIG_NO_MUTATE_ERROR_MSG = require_multisig.MULTISIG_NO_MUTATE_ERROR_MSG;
-exports.MULTISIG_SIGNATURE_LENGTH_ERROR_MSG = require_multisig.MULTISIG_SIGNATURE_LENGTH_ERROR_MSG;
-exports.MULTISIG_USE_PARTIAL_SIGN_ERROR_MSG = require_multisig.MULTISIG_USE_PARTIAL_SIGN_ERROR_MSG;
 exports.MultisigAccount = require_multisig.MultisigAccount;
 exports.OnApplicationComplete = require_app_call.OnApplicationComplete;
 exports.SignedTransactionMeta = require_signed_transaction_meta.SignedTransactionMeta;
 exports.Transaction = require_transaction.Transaction;
 exports.TransactionParamsMeta = require_transaction_meta.TransactionParamsMeta;
 exports.TransactionType = require_transaction_type.TransactionType;
-exports.addressFromMultisigPreImg = require_multisig.addressFromMultisigPreImg;
-exports.addressFromMultisigPreImgAddrs = require_multisig.addressFromMultisigPreImgAddrs;
-exports.addressFromMultisigSignature = require_multisig.addressFromMultisigSignature;
-exports.appendSignRawMultisigSignature = require_multisig.appendSignRawMultisigSignature;
-exports.applyMultisigSubsignature = require_multisig.applyMultisigSubsignature;
 exports.assignFee = require_transaction.assignFee;
+exports.bytesForSigning = require_signer.bytesForSigning;
 exports.calculateFee = require_transaction.calculateFee;
-exports.createMultisigTransaction = require_multisig.createMultisigTransaction;
-exports.decodeLogicSignature = require_logicsig.decodeLogicSignature;
-exports.decodeMultiSignature = require_multisig.decodeMultiSignature;
 exports.decodeSignedTransaction = require_signed_transaction.decodeSignedTransaction;
 exports.decodeSignedTransactions = require_signed_transaction.decodeSignedTransactions;
 exports.decodeTransaction = require_transaction.decodeTransaction;
 exports.decodeTransactions = require_transaction.decodeTransactions;
 exports.encodeSignedTransaction = require_signed_transaction.encodeSignedTransaction;
+exports.encodeSignedTransactionToJson = require_signed_transaction.encodeSignedTransactionToJson;
 exports.encodeSignedTransactions = require_signed_transaction.encodeSignedTransactions;
 exports.encodeTransaction = require_transaction.encodeTransaction;
 exports.encodeTransactionRaw = require_transaction.encodeTransactionRaw;
@@ -51,16 +39,7 @@ exports.generateAddressWithSigners = require_signer.generateAddressWithSigners;
 exports.getEncodedTransactionType = require_transaction.getEncodedTransactionType;
 exports.groupTransactions = require_transaction.groupTransactions;
 exports.makeEmptyTransactionSigner = require_signer.makeEmptyTransactionSigner;
-exports.mergeMultisigTransactions = require_multisig.mergeMultisigTransactions;
-exports.mergeMultisignatures = require_multisig.mergeMultisignatures;
-exports.multisigAddress = require_multisig.multisigAddress;
-exports.newMultisigSignature = require_multisig.newMultisigSignature;
-exports.participantsFromMultisigSignature = require_multisig.participantsFromMultisigSignature;
-exports.sanityCheckProgram = require_logicsig.sanityCheckProgram;
 exports.transactionCodec = require_transaction.transactionCodec;
 exports.transactionParamsCodec = require_transaction_meta.transactionParamsCodec;
-exports.validateAppCallTransaction = require_app_call.validateAppCallTransaction;
-exports.validateAssetConfigTransaction = require_asset_config.validateAssetConfigTransaction;
-exports.validateAssetFreezeTransaction = require_asset_freeze.validateAssetFreezeTransaction;
-exports.validateAssetTransferTransaction = require_asset_transfer.validateAssetTransferTransaction;
-exports.validateKeyRegistrationTransaction = require_key_registration.validateKeyRegistrationTransaction;
+exports.validateSignedTransaction = require_signed_transaction.validateSignedTransaction;
+exports.validateTransaction = require_transaction.validateTransaction;

package/transact/index.mjs

@@ -1,15 +1,12 @@
-import { OnApplicationComplete, validateAppCallTransaction } from "../packages/transact/src/transactions/app-call.mjs";
-import { validateAssetConfigTransaction } from "../packages/transact/src/transactions/asset-config.mjs";
-import { validateAssetFreezeTransaction } from "../packages/transact/src/transactions/asset-freeze.mjs";
-import { validateAssetTransferTransaction } from "../packages/transact/src/transactions/asset-transfer.mjs";
-import { validateKeyRegistrationTransaction } from "../packages/transact/src/transactions/key-registration.mjs";
+import { OnApplicationComplete } from "../packages/transact/src/transactions/app-call.mjs";
 import { TransactionType } from "../packages/transact/src/transactions/transaction-type.mjs";
 import { TransactionParamsMeta, transactionParamsCodec } from "../packages/transact/src/transactions/transaction-meta.mjs";
-import { Transaction, assignFee, calculateFee, decodeTransaction, decodeTransactions, encodeTransaction, encodeTransactionRaw, encodeTransactions, estimateTransactionSize, getEncodedTransactionType, groupTransactions, transactionCodec } from "../packages/transact/src/transactions/transaction.mjs";
+import { Transaction, assignFee, calculateFee, decodeTransaction, decodeTransactions, encodeTransaction, encodeTransactionRaw, encodeTransactions, estimateTransactionSize, getEncodedTransactionType, groupTransactions, transactionCodec, validateTransaction } from "../packages/transact/src/transactions/transaction.mjs";
 import { SignedTransactionMeta } from "../packages/transact/src/transactions/signed-transaction-meta.mjs";
-import { decodeSignedTransaction, decodeSignedTransactions, encodeSignedTransaction, encodeSignedTransactions } from "../packages/transact/src/transactions/signed-transaction.mjs";
-import { generateAddressWithSigners, makeEmptyTransactionSigner } from "../packages/transact/src/signer.mjs";
-import { MULTISIG_MERGE_LESSTHANTWO_ERROR_MSG, MULTISIG_MERGE_MISMATCH_AUTH_ADDR_MSG, MULTISIG_MERGE_MISMATCH_ERROR_MSG, MULTISIG_MERGE_SIG_MISMATCH_ERROR_MSG, MULTISIG_MERGE_WRONG_PREIMAGE_ERROR_MSG, MULTISIG_NO_MUTATE_ERROR_MSG, MULTISIG_SIGNATURE_LENGTH_ERROR_MSG, MULTISIG_USE_PARTIAL_SIGN_ERROR_MSG, MultisigAccount, addressFromMultisigPreImg, addressFromMultisigPreImgAddrs, addressFromMultisigSignature, appendSignRawMultisigSignature, applyMultisigSubsignature, createMultisigTransaction, decodeMultiSignature, mergeMultisigTransactions, mergeMultisignatures, multisigAddress, newMultisigSignature, participantsFromMultisigSignature } from "../packages/transact/src/multisig.mjs";
-import { LogicSigAccount, decodeLogicSignature, sanityCheckProgram } from "../packages/transact/src/logicsig.mjs";
+import { decodeSignedTransaction, decodeSignedTransactions, encodeSignedTransaction, encodeSignedTransactionToJson, encodeSignedTransactions, validateSignedTransaction } from "../packages/transact/src/transactions/signed-transaction.mjs";
+import { BoxReferenceMeta, HoldingReferenceMeta, LocalsReferenceMeta } from "../packages/transact/src/transactions/reference-types-meta.mjs";
+import { bytesForSigning, generateAddressWithSigners, makeEmptyTransactionSigner } from "../packages/transact/src/signer.mjs";
+import { MultisigAccount } from "../packages/transact/src/multisig.mjs";
+import { LogicSig, LogicSigAccount } from "../packages/transact/src/logicsig.mjs";
 
-export { LogicSigAccount, MULTISIG_MERGE_LESSTHANTWO_ERROR_MSG, MULTISIG_MERGE_MISMATCH_AUTH_ADDR_MSG, MULTISIG_MERGE_MISMATCH_ERROR_MSG, MULTISIG_MERGE_SIG_MISMATCH_ERROR_MSG, MULTISIG_MERGE_WRONG_PREIMAGE_ERROR_MSG, MULTISIG_NO_MUTATE_ERROR_MSG, MULTISIG_SIGNATURE_LENGTH_ERROR_MSG, MULTISIG_USE_PARTIAL_SIGN_ERROR_MSG, MultisigAccount, OnApplicationComplete, SignedTransactionMeta, Transaction, TransactionParamsMeta, TransactionType, addressFromMultisigPreImg, addressFromMultisigPreImgAddrs, addressFromMultisigSignature, appendSignRawMultisigSignature, applyMultisigSubsignature, assignFee, calculateFee, createMultisigTransaction, decodeLogicSignature, decodeMultiSignature, decodeSignedTransaction, decodeSignedTransactions, decodeTransaction, decodeTransactions, encodeSignedTransaction, encodeSignedTransactions, encodeTransaction, encodeTransactionRaw, encodeTransactions, estimateTransactionSize, generateAddressWithSigners, getEncodedTransactionType, groupTransactions, makeEmptyTransactionSigner, mergeMultisigTransactions, mergeMultisignatures, multisigAddress, newMultisigSignature, participantsFromMultisigSignature, sanityCheckProgram, transactionCodec, transactionParamsCodec, validateAppCallTransaction, validateAssetConfigTransaction, validateAssetFreezeTransaction, validateAssetTransferTransaction, validateKeyRegistrationTransaction };
+export { BoxReferenceMeta, HoldingReferenceMeta, LocalsReferenceMeta, LogicSig, LogicSigAccount, MultisigAccount, OnApplicationComplete, SignedTransactionMeta, Transaction, TransactionParamsMeta, TransactionType, assignFee, bytesForSigning, calculateFee, decodeSignedTransaction, decodeSignedTransactions, decodeTransaction, decodeTransactions, encodeSignedTransaction, encodeSignedTransactionToJson, encodeSignedTransactions, encodeTransaction, encodeTransactionRaw, encodeTransactions, estimateTransactionSize, generateAddressWithSigners, getEncodedTransactionType, groupTransactions, makeEmptyTransactionSigner, transactionCodec, transactionParamsCodec, validateSignedTransaction, validateTransaction };

package/transaction/index.d.ts

@@ -0,0 +1,4 @@
+import { performTransactionComposerSimulate } from "./perform-transaction-composer-simulate.js";
+import { AdditionalTransactionComposerContext, Arc2TransactionNote, ConfirmedTransactionResult, ConfirmedTransactionResults, SendParams, SendSingleTransactionResult, SendTransactionComposerResults, SendTransactionFrom, SendTransactionParams, SendTransactionResult, SendTransactionResults, TransactionComposerToSend, TransactionGroupToSend, TransactionNote, TransactionNoteData, TransactionToSign } from "./types.js";
+import { TransactionWithSigner, encodeLease, populateAppCallResources, prepareGroupForSending, sendTransactionComposer, waitForConfirmation } from "./transaction.js";
+export { AdditionalTransactionComposerContext, Arc2TransactionNote, ConfirmedTransactionResult, ConfirmedTransactionResults, SendParams, SendSingleTransactionResult, SendTransactionComposerResults, SendTransactionFrom, SendTransactionParams, SendTransactionResult, SendTransactionResults, TransactionComposerToSend, TransactionGroupToSend, TransactionNote, TransactionNoteData, TransactionToSign, TransactionWithSigner, encodeLease, performTransactionComposerSimulate, populateAppCallResources, prepareGroupForSending, sendTransactionComposer, waitForConfirmation };

package/transaction/index.js

@@ -0,0 +1,10 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_perform_transaction_composer_simulate = require('./perform-transaction-composer-simulate.js');
+const require_transaction = require('./transaction.js');
+
+exports.encodeLease = require_transaction.encodeLease;
+exports.performTransactionComposerSimulate = require_perform_transaction_composer_simulate.performTransactionComposerSimulate;
+exports.populateAppCallResources = require_transaction.populateAppCallResources;
+exports.prepareGroupForSending = require_transaction.prepareGroupForSending;
+exports.sendTransactionComposer = require_transaction.sendTransactionComposer;
+exports.waitForConfirmation = require_transaction.waitForConfirmation;

package/transaction/index.mjs

@@ -0,0 +1,4 @@
+import { performTransactionComposerSimulate } from "./perform-transaction-composer-simulate.mjs";
+import { encodeLease, populateAppCallResources, prepareGroupForSending, sendTransactionComposer, waitForConfirmation } from "./transaction.mjs";
+
+export { encodeLease, performTransactionComposerSimulate, populateAppCallResources, prepareGroupForSending, sendTransactionComposer, waitForConfirmation };

package/transaction/perform-transaction-composer-simulate.d.ts

@@ -1,5 +1,5 @@
 import { SimulateResponse } from "../packages/algod_client/src/models/simulate-response.js";
-import { RawSimulateOptions, TransactionComposer } from "../types/composer.js";
+import { RawSimulateOptions, TransactionComposer } from "../composer.js";
 
 //#region src/transaction/perform-transaction-composer-simulate.d.ts
 

package/transaction/perform-transaction-composer-simulate.js.map

@@ -1 +1 @@
-{"version":3,"file":"perform-transaction-composer-simulate.js","names":[],"sources":["../../src/transaction/perform-transaction-composer-simulate.ts"],"sourcesContent":["import { RawSimulateOptions, SimulateOptions, TransactionComposer } from '../types/composer'\n\n/**\n * @deprecated Use `composer.simulate` with\n *  - `allowEmptySignatures` flag set to true\n *  - `resultOnFailure` flag set to true\n *\n * Performs a simulation of the transactions loaded into the given TransactionComposer.\n * Uses empty transaction signers for all transactions.\n *\n * @param composer The TransactionComposer with transaction(s) loaded.\n * @returns The simulation result, which includes various details about how the transactions would be processed.\n */\nexport async function performTransactionComposerSimulate(composer: TransactionComposer, options?: RawSimulateOptions) {\n  const simulateOptions = {\n    ...(options ?? {\n      skipSignatures: true,\n      allowEmptySignatures: true,\n      fixSigners: true,\n      allowMoreLogging: true,\n      execTraceConfig: {\n        enable: true,\n        scratchChange: true,\n        stackChange: true,\n        stateChange: true,\n      },\n      resultOnFailure: true,\n    }),\n  } satisfies SimulateOptions\n\n  const simulateResult = await composer.simulate(simulateOptions)\n  return simulateResult.simulateResponse\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,eAAsB,mCAAmC,UAA+B,SAA8B;CACpH,MAAM,kBAAkB,EACtB,GAAI,WAAW;EACb,gBAAgB;EAChB,sBAAsB;EACtB,YAAY;EACZ,kBAAkB;EAClB,iBAAiB;GACf,QAAQ;GACR,eAAe;GACf,aAAa;GACb,aAAa;GACd;EACD,iBAAiB;EAClB,EACF;AAGD,SADuB,MAAM,SAAS,SAAS,gBAAgB,EACzC"}
+{"version":3,"file":"perform-transaction-composer-simulate.js","names":[],"sources":["../../src/transaction/perform-transaction-composer-simulate.ts"],"sourcesContent":["import { RawSimulateOptions, SimulateOptions, TransactionComposer } from '../composer'\n\n/**\n * @deprecated Use `composer.simulate` with\n *  - `allowEmptySignatures` flag set to true\n *  - `resultOnFailure` flag set to true\n *\n * Performs a simulation of the transactions loaded into the given TransactionComposer.\n * Uses empty transaction signers for all transactions.\n *\n * @param composer The TransactionComposer with transaction(s) loaded.\n * @returns The simulation result, which includes various details about how the transactions would be processed.\n */\nexport async function performTransactionComposerSimulate(composer: TransactionComposer, options?: RawSimulateOptions) {\n  const simulateOptions = {\n    ...(options ?? {\n      skipSignatures: true,\n      allowEmptySignatures: true,\n      fixSigners: true,\n      allowMoreLogging: true,\n      execTraceConfig: {\n        enable: true,\n        scratchChange: true,\n        stackChange: true,\n        stateChange: true,\n      },\n      resultOnFailure: true,\n    }),\n  } satisfies SimulateOptions\n\n  const simulateResult = await composer.simulate(simulateOptions)\n  return simulateResult.simulateResponse\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,eAAsB,mCAAmC,UAA+B,SAA8B;CACpH,MAAM,kBAAkB,EACtB,GAAI,WAAW;EACb,gBAAgB;EAChB,sBAAsB;EACtB,YAAY;EACZ,kBAAkB;EAClB,iBAAiB;GACf,QAAQ;GACR,eAAe;GACf,aAAa;GACb,aAAa;GACd;EACD,iBAAiB;EAClB,EACF;AAGD,SADuB,MAAM,SAAS,SAAS,gBAAgB,EACzC"}

package/transaction/perform-transaction-composer-simulate.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"perform-transaction-composer-simulate.mjs","names":[],"sources":["../../src/transaction/perform-transaction-composer-simulate.ts"],"sourcesContent":["import { RawSimulateOptions, SimulateOptions, TransactionComposer } from '../types/composer'\n\n/**\n * @deprecated Use `composer.simulate` with\n *  - `allowEmptySignatures` flag set to true\n *  - `resultOnFailure` flag set to true\n *\n * Performs a simulation of the transactions loaded into the given TransactionComposer.\n * Uses empty transaction signers for all transactions.\n *\n * @param composer The TransactionComposer with transaction(s) loaded.\n * @returns The simulation result, which includes various details about how the transactions would be processed.\n */\nexport async function performTransactionComposerSimulate(composer: TransactionComposer, options?: RawSimulateOptions) {\n  const simulateOptions = {\n    ...(options ?? {\n      skipSignatures: true,\n      allowEmptySignatures: true,\n      fixSigners: true,\n      allowMoreLogging: true,\n      execTraceConfig: {\n        enable: true,\n        scratchChange: true,\n        stackChange: true,\n        stateChange: true,\n      },\n      resultOnFailure: true,\n    }),\n  } satisfies SimulateOptions\n\n  const simulateResult = await composer.simulate(simulateOptions)\n  return simulateResult.simulateResponse\n}\n"],"mappings":";;;;;;;;;;;;AAaA,eAAsB,mCAAmC,UAA+B,SAA8B;CACpH,MAAM,kBAAkB,EACtB,GAAI,WAAW;EACb,gBAAgB;EAChB,sBAAsB;EACtB,YAAY;EACZ,kBAAkB;EAClB,iBAAiB;GACf,QAAQ;GACR,eAAe;GACf,aAAa;GACb,aAAa;GACd;EACD,iBAAiB;EAClB,EACF;AAGD,SADuB,MAAM,SAAS,SAAS,gBAAgB,EACzC"}
+{"version":3,"file":"perform-transaction-composer-simulate.mjs","names":[],"sources":["../../src/transaction/perform-transaction-composer-simulate.ts"],"sourcesContent":["import { RawSimulateOptions, SimulateOptions, TransactionComposer } from '../composer'\n\n/**\n * @deprecated Use `composer.simulate` with\n *  - `allowEmptySignatures` flag set to true\n *  - `resultOnFailure` flag set to true\n *\n * Performs a simulation of the transactions loaded into the given TransactionComposer.\n * Uses empty transaction signers for all transactions.\n *\n * @param composer The TransactionComposer with transaction(s) loaded.\n * @returns The simulation result, which includes various details about how the transactions would be processed.\n */\nexport async function performTransactionComposerSimulate(composer: TransactionComposer, options?: RawSimulateOptions) {\n  const simulateOptions = {\n    ...(options ?? {\n      skipSignatures: true,\n      allowEmptySignatures: true,\n      fixSigners: true,\n      allowMoreLogging: true,\n      execTraceConfig: {\n        enable: true,\n        scratchChange: true,\n        stackChange: true,\n        stateChange: true,\n      },\n      resultOnFailure: true,\n    }),\n  } satisfies SimulateOptions\n\n  const simulateResult = await composer.simulate(simulateOptions)\n  return simulateResult.simulateResponse\n}\n"],"mappings":";;;;;;;;;;;;AAaA,eAAsB,mCAAmC,UAA+B,SAA8B;CACpH,MAAM,kBAAkB,EACtB,GAAI,WAAW;EACb,gBAAgB;EAChB,sBAAsB;EACtB,YAAY;EACZ,kBAAkB;EAClB,iBAAiB;GACf,QAAQ;GACR,eAAe;GACf,aAAa;GACb,aAAa;GACd;EACD,iBAAiB;EAClB,EACF;AAGD,SADuB,MAAM,SAAS,SAAS,gBAAgB,EACzC"}

package/transaction/transaction.d.ts

@@ -2,8 +2,8 @@ import { Transaction } from "../packages/transact/src/transactions/transaction.j
 import { TransactionSigner } from "../packages/transact/src/signer.js";
 import { PendingTransactionResponse } from "../packages/algod_client/src/models/pending-transaction-response.js";
 import { AlgodClient } from "../packages/algod_client/src/client.js";
-import { AdditionalTransactionComposerContext, SendParams, SendTransactionComposerResults, TransactionComposerToSend } from "../types/transaction.js";
-import { TransactionComposer } from "../types/composer.js";
+import { AdditionalTransactionComposerContext, SendParams, SendTransactionComposerResults, TransactionComposerToSend } from "./types.js";
+import { TransactionComposer } from "../composer.js";
 
 //#region src/transaction/transaction.d.ts
 /** Represents an unsigned transactions and a signer that can authorize that transaction. */
@@ -27,7 +27,6 @@ declare function encodeLease(lease?: string | Uint8Array): Uint8Array | undefine
  * Take an existing Transaction Composer and return a new one with the required
  * app call resources populated into it
  *
- * @param algod The algod client to use for the simulation
  * @param composer The composer containing the txn group
  * @returns A new composer with the resources populated into the transactions
  *
@@ -62,7 +61,6 @@ declare function prepareGroupForSending(composer: TransactionComposer, sendParam
  * @deprecated Use `composer.send()` directly
  * Signs and sends transactions that have been collected by an `TransactionComposer`.
  * @param atcSend The parameters controlling the send, including `atc` The `TransactionComposer` and params to control send behaviour
- * @param algod An algod client
  * @returns An object with transaction IDs, transactions, group transaction ID (`groupTransactionId`) if more than 1 transaction sent, and (if `skipWaiting` is `false` or unset) confirmation (`confirmation`)
  */
 declare const sendTransactionComposer: (atcSend: TransactionComposerToSend) => Promise<SendTransactionComposerResults>;

package/transaction/transaction.js

@@ -30,7 +30,6 @@ function encodeLease(lease) {
 * Take an existing Transaction Composer and return a new one with the required
 * app call resources populated into it
 *
-* @param algod The algod client to use for the simulation
 * @param composer The composer containing the txn group
 * @returns A new composer with the resources populated into the transactions
 *
@@ -76,11 +75,10 @@ async function prepareGroupForSending(composer, sendParams, additionalContext) {
 * @deprecated Use `composer.send()` directly
 * Signs and sends transactions that have been collected by an `TransactionComposer`.
 * @param atcSend The parameters controlling the send, including `atc` The `TransactionComposer` and params to control send behaviour
-* @param algod An algod client
 * @returns An object with transaction IDs, transactions, group transaction ID (`groupTransactionId`) if more than 1 transaction sent, and (if `skipWaiting` is `false` or unset) confirmation (`confirmation`)
 */
 const sendTransactionComposer = async function(atcSend) {
-	const { transactionComposer: givenComposer,...executeParams } = atcSend;
+	const { transactionComposer: givenComposer, ...executeParams } = atcSend;
 	return atcSend.transactionComposer.send({ ...executeParams });
 };
 /**
@@ -96,7 +94,7 @@ const sendTransactionComposer = async function(atcSend) {
 */
 const waitForConfirmation = async function(transactionId, maxRoundsToWait, algod) {
 	if (maxRoundsToWait < 0) throw new Error(`Invalid timeout, received ${maxRoundsToWait}, expected > 0`);
-	const status = await algod.getStatus();
+	const status = await algod.status();
 	if (status === void 0) throw new Error("Unable to get node status");
 	const startRound = BigInt(status.lastRound) + 1n;
 	let currentRound = startRound;

package/transaction/transaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.js","names":["e: any","toNumber"],"sources":["../../src/transaction/transaction.ts"],"sourcesContent":["import { AlgodClient, PendingTransactionResponse } from '@algorandfoundation/algokit-algod-client'\nimport { Transaction, TransactionSigner } from '@algorandfoundation/algokit-transact'\nimport { TransactionComposer } from '../types/composer'\nimport {\n  AdditionalTransactionComposerContext,\n  SendParams,\n  SendTransactionComposerResults,\n  TransactionComposerToSend,\n} from '../types/transaction'\nimport { toNumber } from '../util'\n\n/** Represents an unsigned transactions and a signer that can authorize that transaction. */\nexport interface TransactionWithSigner {\n  /** An unsigned transaction */\n  txn: Transaction\n  /** A transaction signer that can authorize txn */\n  signer: TransactionSigner\n}\n\n/** Encodes a transaction lease into a 32-byte array ready to be included in an Algorand transaction.\n *\n * @param lease The transaction lease as a string or binary array or null/undefined if there is no lease\n * @returns the transaction lease ready for inclusion in a transaction or `undefined` if there is no lease\n * @throws if the length of the data is > 32 bytes or empty\n * @example algokit.encodeLease('UNIQUE_ID')\n * @example algokit.encodeLease(new Uint8Array([1, 2, 3]))\n */\nexport function encodeLease(lease?: string | Uint8Array): Uint8Array | undefined {\n  if (lease === null || typeof lease === 'undefined') {\n    return undefined\n  } else if (typeof lease === 'object' && lease.constructor === Uint8Array) {\n    if (lease.length === 0 || lease.length > 32) {\n      throw new Error(\n        `Received invalid lease; expected something with length between 1 and 32, but received bytes with length ${lease.length}`,\n      )\n    }\n    if (lease.length === 32) return lease\n    const lease32 = new Uint8Array(32)\n    lease32.set(lease, 0)\n    return lease32\n  } else if (typeof lease === 'string') {\n    if (lease.length === 0 || lease.length > 32) {\n      throw new Error(\n        `Received invalid lease; expected something with length between 1 and 32, but received '${lease}' with length ${lease.length}`,\n      )\n    }\n    const encoder = new TextEncoder()\n    const lease32 = new Uint8Array(32)\n    lease32.set(encoder.encode(lease), 0)\n    return lease32\n  } else {\n    throw new Error(`Unknown lease type received of ${typeof lease}`)\n  }\n}\n\n/**\n * @deprecated Use `composer.build()` directly\n * Take an existing Transaction Composer and return a new one with the required\n * app call resources populated into it\n *\n * @param algod The algod client to use for the simulation\n * @param composer The composer containing the txn group\n * @returns A new composer with the resources populated into the transactions\n *\n * @privateRemarks\n *\n * This entire function will eventually be implemented in simulate upstream in algod. The simulate endpoint will return\n * an array of refference arrays for each transaction, so this eventually will eventually just call simulate and set the\n * reference arrays in the transactions to the reference arrays returned by simulate.\n *\n * See https://github.com/algorand/go-algorand/pull/5684\n *\n */\nexport async function populateAppCallResources(composer: TransactionComposer) {\n  await composer.build()\n  return composer\n}\n\n/**\n * @deprecated Use `composer.setMaxFees()` instead if you need to set max fees for transactions.\n * Use `composer.build()` instead if you need to build transactions with resource population.\n *\n * Take an existing Transaction Composer and return a new one with changes applied to the transactions\n * based on the supplied sendParams to prepare it for sending.\n *\n * @param composer The Transaction Composer containing the txn group\n * @param sendParams The send params for the transaction group\n * @param additionalContext Additional context used to determine how best to change the transactions in the group\n * @returns A new Transaction Composer with the changes applied\n *\n * @privateRemarks\n * Parts of this function will eventually be implemented in algod. Namely:\n * - Simulate will return information on how to populate reference arrays, see https://github.com/algorand/go-algorand/pull/6015\n */\nexport async function prepareGroupForSending(\n  composer: TransactionComposer,\n  sendParams: SendParams,\n  additionalContext?: AdditionalTransactionComposerContext,\n) {\n  const newComposer = composer.clone({\n    coverAppCallInnerTransactionFees: sendParams.coverAppCallInnerTransactionFees ?? false,\n    populateAppCallResources: sendParams.populateAppCallResources ?? true,\n  })\n\n  if (additionalContext?.maxFees) {\n    newComposer.setMaxFees(additionalContext?.maxFees)\n  }\n\n  await newComposer.build()\n\n  return newComposer\n}\n\n/**\n * @deprecated Use `composer.send()` directly\n * Signs and sends transactions that have been collected by an `TransactionComposer`.\n * @param atcSend The parameters controlling the send, including `atc` The `TransactionComposer` and params to control send behaviour\n * @param algod An algod client\n * @returns An object with transaction IDs, transactions, group transaction ID (`groupTransactionId`) if more than 1 transaction sent, and (if `skipWaiting` is `false` or unset) confirmation (`confirmation`)\n */\nexport const sendTransactionComposer = async function (atcSend: TransactionComposerToSend): Promise<SendTransactionComposerResults> {\n  const { transactionComposer: givenComposer, ...executeParams } = atcSend\n\n  return atcSend.transactionComposer.send({\n    ...executeParams,\n  })\n}\n\n/**\n * Wait until the transaction is confirmed or rejected, or until `timeout`\n * number of rounds have passed.\n *\n * @param algod An algod client\n * @param transactionId The transaction ID to wait for\n * @param maxRoundsToWait Maximum number of rounds to wait\n *\n * @return Pending transaction information\n * @throws Throws an error if the transaction is not confirmed or rejected in the next `timeout` rounds\n */\nexport const waitForConfirmation = async function (\n  transactionId: string,\n  maxRoundsToWait: number | bigint,\n  algod: AlgodClient,\n): Promise<PendingTransactionResponse> {\n  if (maxRoundsToWait < 0) {\n    throw new Error(`Invalid timeout, received ${maxRoundsToWait}, expected > 0`)\n  }\n\n  // Get current round\n  const status = await algod.getStatus()\n  if (status === undefined) {\n    throw new Error('Unable to get node status')\n  }\n\n  // Loop for up to `timeout` rounds looking for a confirmed transaction\n  const startRound = BigInt(status.lastRound) + 1n\n  let currentRound = startRound\n  while (currentRound < startRound + BigInt(maxRoundsToWait)) {\n    try {\n      const pendingInfo = await algod.pendingTransactionInformation(transactionId)\n\n      if (pendingInfo !== undefined) {\n        const confirmedRound = pendingInfo.confirmedRound\n        if (confirmedRound && confirmedRound > 0) {\n          return pendingInfo\n        } else {\n          const poolError = pendingInfo.poolError\n          if (poolError != null && poolError.length > 0) {\n            // If there was a pool error, then the transaction has been rejected!\n            throw new Error(`Transaction ${transactionId} was rejected; pool error: ${poolError}`)\n          }\n        }\n      }\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } catch (e: any) {\n      if ('status' in e && e.status === 404) {\n        currentRound++\n        continue\n      }\n    }\n\n    await algod.statusAfterBlock(toNumber(currentRound))\n    currentRound++\n  }\n\n  throw new Error(`Transaction ${transactionId} not confirmed after ${maxRoundsToWait} rounds`)\n}\n"],"mappings":";;;;;;;;;;;AA2BA,SAAgB,YAAY,OAAqD;AAC/E,KAAI,UAAU,QAAQ,OAAO,UAAU,YACrC;UACS,OAAO,UAAU,YAAY,MAAM,gBAAgB,YAAY;AACxE,MAAI,MAAM,WAAW,KAAK,MAAM,SAAS,GACvC,OAAM,IAAI,MACR,2GAA2G,MAAM,SAClH;AAEH,MAAI,MAAM,WAAW,GAAI,QAAO;EAChC,MAAM,UAAU,IAAI,WAAW,GAAG;AAClC,UAAQ,IAAI,OAAO,EAAE;AACrB,SAAO;YACE,OAAO,UAAU,UAAU;AACpC,MAAI,MAAM,WAAW,KAAK,MAAM,SAAS,GACvC,OAAM,IAAI,MACR,0FAA0F,MAAM,gBAAgB,MAAM,SACvH;EAEH,MAAM,UAAU,IAAI,aAAa;EACjC,MAAM,UAAU,IAAI,WAAW,GAAG;AAClC,UAAQ,IAAI,QAAQ,OAAO,MAAM,EAAE,EAAE;AACrC,SAAO;OAEP,OAAM,IAAI,MAAM,kCAAkC,OAAO,QAAQ;;;;;;;;;;;;;;;;;;;;AAsBrE,eAAsB,yBAAyB,UAA+B;AAC5E,OAAM,SAAS,OAAO;AACtB,QAAO;;;;;;;;;;;;;;;;;;AAmBT,eAAsB,uBACpB,UACA,YACA,mBACA;CACA,MAAM,cAAc,SAAS,MAAM;EACjC,kCAAkC,WAAW,oCAAoC;EACjF,0BAA0B,WAAW,4BAA4B;EAClE,CAAC;AAEF,KAAI,mBAAmB,QACrB,aAAY,WAAW,mBAAmB,QAAQ;AAGpD,OAAM,YAAY,OAAO;AAEzB,QAAO;;;;;;;;;AAUT,MAAa,0BAA0B,eAAgB,SAA6E;CAClI,MAAM,EAAE,qBAAqB,cAAe,GAAG,kBAAkB;AAEjE,QAAO,QAAQ,oBAAoB,KAAK,EACtC,GAAG,eACJ,CAAC;;;;;;;;;;;;;AAcJ,MAAa,sBAAsB,eACjC,eACA,iBACA,OACqC;AACrC,KAAI,kBAAkB,EACpB,OAAM,IAAI,MAAM,6BAA6B,gBAAgB,gBAAgB;CAI/E,MAAM,SAAS,MAAM,MAAM,WAAW;AACtC,KAAI,WAAW,OACb,OAAM,IAAI,MAAM,4BAA4B;CAI9C,MAAM,aAAa,OAAO,OAAO,UAAU,GAAG;CAC9C,IAAI,eAAe;AACnB,QAAO,eAAe,aAAa,OAAO,gBAAgB,EAAE;AAC1D,MAAI;GACF,MAAM,cAAc,MAAM,MAAM,8BAA8B,cAAc;AAE5E,OAAI,gBAAgB,QAAW;IAC7B,MAAM,iBAAiB,YAAY;AACnC,QAAI,kBAAkB,iBAAiB,EACrC,QAAO;SACF;KACL,MAAM,YAAY,YAAY;AAC9B,SAAI,aAAa,QAAQ,UAAU,SAAS,EAE1C,OAAM,IAAI,MAAM,eAAe,cAAc,6BAA6B,YAAY;;;WAKrFA,GAAQ;AACf,OAAI,YAAY,KAAK,EAAE,WAAW,KAAK;AACrC;AACA;;;AAIJ,QAAM,MAAM,iBAAiBC,sBAAS,aAAa,CAAC;AACpD;;AAGF,OAAM,IAAI,MAAM,eAAe,cAAc,uBAAuB,gBAAgB,SAAS"}
+{"version":3,"file":"transaction.js","names":["toNumber"],"sources":["../../src/transaction/transaction.ts"],"sourcesContent":["import { AlgodClient, PendingTransactionResponse } from '@algorandfoundation/algokit-algod-client'\nimport { Transaction, TransactionSigner } from '@algorandfoundation/algokit-transact'\nimport { TransactionComposer } from '../composer'\nimport { toNumber } from '../util'\nimport { AdditionalTransactionComposerContext, SendParams, SendTransactionComposerResults, TransactionComposerToSend } from './types'\n\n/** Represents an unsigned transactions and a signer that can authorize that transaction. */\nexport interface TransactionWithSigner {\n  /** An unsigned transaction */\n  txn: Transaction\n  /** A transaction signer that can authorize txn */\n  signer: TransactionSigner\n}\n\n/** Encodes a transaction lease into a 32-byte array ready to be included in an Algorand transaction.\n *\n * @param lease The transaction lease as a string or binary array or null/undefined if there is no lease\n * @returns the transaction lease ready for inclusion in a transaction or `undefined` if there is no lease\n * @throws if the length of the data is > 32 bytes or empty\n * @example algokit.encodeLease('UNIQUE_ID')\n * @example algokit.encodeLease(new Uint8Array([1, 2, 3]))\n */\nexport function encodeLease(lease?: string | Uint8Array): Uint8Array | undefined {\n  if (lease === null || typeof lease === 'undefined') {\n    return undefined\n  } else if (typeof lease === 'object' && lease.constructor === Uint8Array) {\n    if (lease.length === 0 || lease.length > 32) {\n      throw new Error(\n        `Received invalid lease; expected something with length between 1 and 32, but received bytes with length ${lease.length}`,\n      )\n    }\n    if (lease.length === 32) return lease\n    const lease32 = new Uint8Array(32)\n    lease32.set(lease, 0)\n    return lease32\n  } else if (typeof lease === 'string') {\n    if (lease.length === 0 || lease.length > 32) {\n      throw new Error(\n        `Received invalid lease; expected something with length between 1 and 32, but received '${lease}' with length ${lease.length}`,\n      )\n    }\n    const encoder = new TextEncoder()\n    const lease32 = new Uint8Array(32)\n    lease32.set(encoder.encode(lease), 0)\n    return lease32\n  } else {\n    throw new Error(`Unknown lease type received of ${typeof lease}`)\n  }\n}\n\n/**\n * @deprecated Use `composer.build()` directly\n * Take an existing Transaction Composer and return a new one with the required\n * app call resources populated into it\n *\n * @param composer The composer containing the txn group\n * @returns A new composer with the resources populated into the transactions\n *\n * @privateRemarks\n *\n * This entire function will eventually be implemented in simulate upstream in algod. The simulate endpoint will return\n * an array of refference arrays for each transaction, so this eventually will eventually just call simulate and set the\n * reference arrays in the transactions to the reference arrays returned by simulate.\n *\n * See https://github.com/algorand/go-algorand/pull/5684\n *\n */\nexport async function populateAppCallResources(composer: TransactionComposer) {\n  await composer.build()\n  return composer\n}\n\n/**\n * @deprecated Use `composer.setMaxFees()` instead if you need to set max fees for transactions.\n * Use `composer.build()` instead if you need to build transactions with resource population.\n *\n * Take an existing Transaction Composer and return a new one with changes applied to the transactions\n * based on the supplied sendParams to prepare it for sending.\n *\n * @param composer The Transaction Composer containing the txn group\n * @param sendParams The send params for the transaction group\n * @param additionalContext Additional context used to determine how best to change the transactions in the group\n * @returns A new Transaction Composer with the changes applied\n *\n * @privateRemarks\n * Parts of this function will eventually be implemented in algod. Namely:\n * - Simulate will return information on how to populate reference arrays, see https://github.com/algorand/go-algorand/pull/6015\n */\nexport async function prepareGroupForSending(\n  composer: TransactionComposer,\n  sendParams: SendParams,\n  additionalContext?: AdditionalTransactionComposerContext,\n) {\n  const newComposer = composer.clone({\n    coverAppCallInnerTransactionFees: sendParams.coverAppCallInnerTransactionFees ?? false,\n    populateAppCallResources: sendParams.populateAppCallResources ?? true,\n  })\n\n  if (additionalContext?.maxFees) {\n    newComposer.setMaxFees(additionalContext?.maxFees)\n  }\n\n  await newComposer.build()\n\n  return newComposer\n}\n\n/**\n * @deprecated Use `composer.send()` directly\n * Signs and sends transactions that have been collected by an `TransactionComposer`.\n * @param atcSend The parameters controlling the send, including `atc` The `TransactionComposer` and params to control send behaviour\n * @returns An object with transaction IDs, transactions, group transaction ID (`groupTransactionId`) if more than 1 transaction sent, and (if `skipWaiting` is `false` or unset) confirmation (`confirmation`)\n */\nexport const sendTransactionComposer = async function (atcSend: TransactionComposerToSend): Promise<SendTransactionComposerResults> {\n  const { transactionComposer: givenComposer, ...executeParams } = atcSend\n\n  return atcSend.transactionComposer.send({\n    ...executeParams,\n  })\n}\n\n/**\n * Wait until the transaction is confirmed or rejected, or until `timeout`\n * number of rounds have passed.\n *\n * @param algod An algod client\n * @param transactionId The transaction ID to wait for\n * @param maxRoundsToWait Maximum number of rounds to wait\n *\n * @return Pending transaction information\n * @throws Throws an error if the transaction is not confirmed or rejected in the next `timeout` rounds\n */\nexport const waitForConfirmation = async function (\n  transactionId: string,\n  maxRoundsToWait: number | bigint,\n  algod: AlgodClient,\n): Promise<PendingTransactionResponse> {\n  if (maxRoundsToWait < 0) {\n    throw new Error(`Invalid timeout, received ${maxRoundsToWait}, expected > 0`)\n  }\n\n  // Get current round\n  const status = await algod.status()\n  if (status === undefined) {\n    throw new Error('Unable to get node status')\n  }\n\n  // Loop for up to `timeout` rounds looking for a confirmed transaction\n  const startRound = BigInt(status.lastRound) + 1n\n  let currentRound = startRound\n  while (currentRound < startRound + BigInt(maxRoundsToWait)) {\n    try {\n      const pendingInfo = await algod.pendingTransactionInformation(transactionId)\n\n      if (pendingInfo !== undefined) {\n        const confirmedRound = pendingInfo.confirmedRound\n        if (confirmedRound && confirmedRound > 0) {\n          return pendingInfo\n        } else {\n          const poolError = pendingInfo.poolError\n          if (poolError != null && poolError.length > 0) {\n            // If there was a pool error, then the transaction has been rejected!\n            throw new Error(`Transaction ${transactionId} was rejected; pool error: ${poolError}`)\n          }\n        }\n      }\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } catch (e: any) {\n      if ('status' in e && e.status === 404) {\n        currentRound++\n        continue\n      }\n    }\n\n    await algod.statusAfterBlock(toNumber(currentRound))\n    currentRound++\n  }\n\n  throw new Error(`Transaction ${transactionId} not confirmed after ${maxRoundsToWait} rounds`)\n}\n"],"mappings":";;;;;;;;;;;AAsBA,SAAgB,YAAY,OAAqD;AAC/E,KAAI,UAAU,QAAQ,OAAO,UAAU,YACrC;UACS,OAAO,UAAU,YAAY,MAAM,gBAAgB,YAAY;AACxE,MAAI,MAAM,WAAW,KAAK,MAAM,SAAS,GACvC,OAAM,IAAI,MACR,2GAA2G,MAAM,SAClH;AAEH,MAAI,MAAM,WAAW,GAAI,QAAO;EAChC,MAAM,UAAU,IAAI,WAAW,GAAG;AAClC,UAAQ,IAAI,OAAO,EAAE;AACrB,SAAO;YACE,OAAO,UAAU,UAAU;AACpC,MAAI,MAAM,WAAW,KAAK,MAAM,SAAS,GACvC,OAAM,IAAI,MACR,0FAA0F,MAAM,gBAAgB,MAAM,SACvH;EAEH,MAAM,UAAU,IAAI,aAAa;EACjC,MAAM,UAAU,IAAI,WAAW,GAAG;AAClC,UAAQ,IAAI,QAAQ,OAAO,MAAM,EAAE,EAAE;AACrC,SAAO;OAEP,OAAM,IAAI,MAAM,kCAAkC,OAAO,QAAQ;;;;;;;;;;;;;;;;;;;AAqBrE,eAAsB,yBAAyB,UAA+B;AAC5E,OAAM,SAAS,OAAO;AACtB,QAAO;;;;;;;;;;;;;;;;;;AAmBT,eAAsB,uBACpB,UACA,YACA,mBACA;CACA,MAAM,cAAc,SAAS,MAAM;EACjC,kCAAkC,WAAW,oCAAoC;EACjF,0BAA0B,WAAW,4BAA4B;EAClE,CAAC;AAEF,KAAI,mBAAmB,QACrB,aAAY,WAAW,mBAAmB,QAAQ;AAGpD,OAAM,YAAY,OAAO;AAEzB,QAAO;;;;;;;;AAST,MAAa,0BAA0B,eAAgB,SAA6E;CAClI,MAAM,EAAE,qBAAqB,eAAe,GAAG,kBAAkB;AAEjE,QAAO,QAAQ,oBAAoB,KAAK,EACtC,GAAG,eACJ,CAAC;;;;;;;;;;;;;AAcJ,MAAa,sBAAsB,eACjC,eACA,iBACA,OACqC;AACrC,KAAI,kBAAkB,EACpB,OAAM,IAAI,MAAM,6BAA6B,gBAAgB,gBAAgB;CAI/E,MAAM,SAAS,MAAM,MAAM,QAAQ;AACnC,KAAI,WAAW,OACb,OAAM,IAAI,MAAM,4BAA4B;CAI9C,MAAM,aAAa,OAAO,OAAO,UAAU,GAAG;CAC9C,IAAI,eAAe;AACnB,QAAO,eAAe,aAAa,OAAO,gBAAgB,EAAE;AAC1D,MAAI;GACF,MAAM,cAAc,MAAM,MAAM,8BAA8B,cAAc;AAE5E,OAAI,gBAAgB,QAAW;IAC7B,MAAM,iBAAiB,YAAY;AACnC,QAAI,kBAAkB,iBAAiB,EACrC,QAAO;SACF;KACL,MAAM,YAAY,YAAY;AAC9B,SAAI,aAAa,QAAQ,UAAU,SAAS,EAE1C,OAAM,IAAI,MAAM,eAAe,cAAc,6BAA6B,YAAY;;;WAKrF,GAAQ;AACf,OAAI,YAAY,KAAK,EAAE,WAAW,KAAK;AACrC;AACA;;;AAIJ,QAAM,MAAM,iBAAiBA,sBAAS,aAAa,CAAC;AACpD;;AAGF,OAAM,IAAI,MAAM,eAAe,cAAc,uBAAuB,gBAAgB,SAAS"}

package/transaction/transaction.mjs

@@ -30,7 +30,6 @@ function encodeLease(lease) {
 * Take an existing Transaction Composer and return a new one with the required
 * app call resources populated into it
 *
-* @param algod The algod client to use for the simulation
 * @param composer The composer containing the txn group
 * @returns A new composer with the resources populated into the transactions
 *
@@ -76,11 +75,10 @@ async function prepareGroupForSending(composer, sendParams, additionalContext) {
 * @deprecated Use `composer.send()` directly
 * Signs and sends transactions that have been collected by an `TransactionComposer`.
 * @param atcSend The parameters controlling the send, including `atc` The `TransactionComposer` and params to control send behaviour
-* @param algod An algod client
 * @returns An object with transaction IDs, transactions, group transaction ID (`groupTransactionId`) if more than 1 transaction sent, and (if `skipWaiting` is `false` or unset) confirmation (`confirmation`)
 */
 const sendTransactionComposer = async function(atcSend) {
-	const { transactionComposer: givenComposer,...executeParams } = atcSend;
+	const { transactionComposer: givenComposer, ...executeParams } = atcSend;
 	return atcSend.transactionComposer.send({ ...executeParams });
 };
 /**
@@ -96,7 +94,7 @@ const sendTransactionComposer = async function(atcSend) {
 */
 const waitForConfirmation = async function(transactionId, maxRoundsToWait, algod) {
 	if (maxRoundsToWait < 0) throw new Error(`Invalid timeout, received ${maxRoundsToWait}, expected > 0`);
-	const status = await algod.getStatus();
+	const status = await algod.status();
 	if (status === void 0) throw new Error("Unable to get node status");
 	const startRound = BigInt(status.lastRound) + 1n;
 	let currentRound = startRound;

package/transaction/transaction.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.mjs","names":["e: any"],"sources":["../../src/transaction/transaction.ts"],"sourcesContent":["import { AlgodClient, PendingTransactionResponse } from '@algorandfoundation/algokit-algod-client'\nimport { Transaction, TransactionSigner } from '@algorandfoundation/algokit-transact'\nimport { TransactionComposer } from '../types/composer'\nimport {\n  AdditionalTransactionComposerContext,\n  SendParams,\n  SendTransactionComposerResults,\n  TransactionComposerToSend,\n} from '../types/transaction'\nimport { toNumber } from '../util'\n\n/** Represents an unsigned transactions and a signer that can authorize that transaction. */\nexport interface TransactionWithSigner {\n  /** An unsigned transaction */\n  txn: Transaction\n  /** A transaction signer that can authorize txn */\n  signer: TransactionSigner\n}\n\n/** Encodes a transaction lease into a 32-byte array ready to be included in an Algorand transaction.\n *\n * @param lease The transaction lease as a string or binary array or null/undefined if there is no lease\n * @returns the transaction lease ready for inclusion in a transaction or `undefined` if there is no lease\n * @throws if the length of the data is > 32 bytes or empty\n * @example algokit.encodeLease('UNIQUE_ID')\n * @example algokit.encodeLease(new Uint8Array([1, 2, 3]))\n */\nexport function encodeLease(lease?: string | Uint8Array): Uint8Array | undefined {\n  if (lease === null || typeof lease === 'undefined') {\n    return undefined\n  } else if (typeof lease === 'object' && lease.constructor === Uint8Array) {\n    if (lease.length === 0 || lease.length > 32) {\n      throw new Error(\n        `Received invalid lease; expected something with length between 1 and 32, but received bytes with length ${lease.length}`,\n      )\n    }\n    if (lease.length === 32) return lease\n    const lease32 = new Uint8Array(32)\n    lease32.set(lease, 0)\n    return lease32\n  } else if (typeof lease === 'string') {\n    if (lease.length === 0 || lease.length > 32) {\n      throw new Error(\n        `Received invalid lease; expected something with length between 1 and 32, but received '${lease}' with length ${lease.length}`,\n      )\n    }\n    const encoder = new TextEncoder()\n    const lease32 = new Uint8Array(32)\n    lease32.set(encoder.encode(lease), 0)\n    return lease32\n  } else {\n    throw new Error(`Unknown lease type received of ${typeof lease}`)\n  }\n}\n\n/**\n * @deprecated Use `composer.build()` directly\n * Take an existing Transaction Composer and return a new one with the required\n * app call resources populated into it\n *\n * @param algod The algod client to use for the simulation\n * @param composer The composer containing the txn group\n * @returns A new composer with the resources populated into the transactions\n *\n * @privateRemarks\n *\n * This entire function will eventually be implemented in simulate upstream in algod. The simulate endpoint will return\n * an array of refference arrays for each transaction, so this eventually will eventually just call simulate and set the\n * reference arrays in the transactions to the reference arrays returned by simulate.\n *\n * See https://github.com/algorand/go-algorand/pull/5684\n *\n */\nexport async function populateAppCallResources(composer: TransactionComposer) {\n  await composer.build()\n  return composer\n}\n\n/**\n * @deprecated Use `composer.setMaxFees()` instead if you need to set max fees for transactions.\n * Use `composer.build()` instead if you need to build transactions with resource population.\n *\n * Take an existing Transaction Composer and return a new one with changes applied to the transactions\n * based on the supplied sendParams to prepare it for sending.\n *\n * @param composer The Transaction Composer containing the txn group\n * @param sendParams The send params for the transaction group\n * @param additionalContext Additional context used to determine how best to change the transactions in the group\n * @returns A new Transaction Composer with the changes applied\n *\n * @privateRemarks\n * Parts of this function will eventually be implemented in algod. Namely:\n * - Simulate will return information on how to populate reference arrays, see https://github.com/algorand/go-algorand/pull/6015\n */\nexport async function prepareGroupForSending(\n  composer: TransactionComposer,\n  sendParams: SendParams,\n  additionalContext?: AdditionalTransactionComposerContext,\n) {\n  const newComposer = composer.clone({\n    coverAppCallInnerTransactionFees: sendParams.coverAppCallInnerTransactionFees ?? false,\n    populateAppCallResources: sendParams.populateAppCallResources ?? true,\n  })\n\n  if (additionalContext?.maxFees) {\n    newComposer.setMaxFees(additionalContext?.maxFees)\n  }\n\n  await newComposer.build()\n\n  return newComposer\n}\n\n/**\n * @deprecated Use `composer.send()` directly\n * Signs and sends transactions that have been collected by an `TransactionComposer`.\n * @param atcSend The parameters controlling the send, including `atc` The `TransactionComposer` and params to control send behaviour\n * @param algod An algod client\n * @returns An object with transaction IDs, transactions, group transaction ID (`groupTransactionId`) if more than 1 transaction sent, and (if `skipWaiting` is `false` or unset) confirmation (`confirmation`)\n */\nexport const sendTransactionComposer = async function (atcSend: TransactionComposerToSend): Promise<SendTransactionComposerResults> {\n  const { transactionComposer: givenComposer, ...executeParams } = atcSend\n\n  return atcSend.transactionComposer.send({\n    ...executeParams,\n  })\n}\n\n/**\n * Wait until the transaction is confirmed or rejected, or until `timeout`\n * number of rounds have passed.\n *\n * @param algod An algod client\n * @param transactionId The transaction ID to wait for\n * @param maxRoundsToWait Maximum number of rounds to wait\n *\n * @return Pending transaction information\n * @throws Throws an error if the transaction is not confirmed or rejected in the next `timeout` rounds\n */\nexport const waitForConfirmation = async function (\n  transactionId: string,\n  maxRoundsToWait: number | bigint,\n  algod: AlgodClient,\n): Promise<PendingTransactionResponse> {\n  if (maxRoundsToWait < 0) {\n    throw new Error(`Invalid timeout, received ${maxRoundsToWait}, expected > 0`)\n  }\n\n  // Get current round\n  const status = await algod.getStatus()\n  if (status === undefined) {\n    throw new Error('Unable to get node status')\n  }\n\n  // Loop for up to `timeout` rounds looking for a confirmed transaction\n  const startRound = BigInt(status.lastRound) + 1n\n  let currentRound = startRound\n  while (currentRound < startRound + BigInt(maxRoundsToWait)) {\n    try {\n      const pendingInfo = await algod.pendingTransactionInformation(transactionId)\n\n      if (pendingInfo !== undefined) {\n        const confirmedRound = pendingInfo.confirmedRound\n        if (confirmedRound && confirmedRound > 0) {\n          return pendingInfo\n        } else {\n          const poolError = pendingInfo.poolError\n          if (poolError != null && poolError.length > 0) {\n            // If there was a pool error, then the transaction has been rejected!\n            throw new Error(`Transaction ${transactionId} was rejected; pool error: ${poolError}`)\n          }\n        }\n      }\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } catch (e: any) {\n      if ('status' in e && e.status === 404) {\n        currentRound++\n        continue\n      }\n    }\n\n    await algod.statusAfterBlock(toNumber(currentRound))\n    currentRound++\n  }\n\n  throw new Error(`Transaction ${transactionId} not confirmed after ${maxRoundsToWait} rounds`)\n}\n"],"mappings":";;;;;;;;;;;AA2BA,SAAgB,YAAY,OAAqD;AAC/E,KAAI,UAAU,QAAQ,OAAO,UAAU,YACrC;UACS,OAAO,UAAU,YAAY,MAAM,gBAAgB,YAAY;AACxE,MAAI,MAAM,WAAW,KAAK,MAAM,SAAS,GACvC,OAAM,IAAI,MACR,2GAA2G,MAAM,SAClH;AAEH,MAAI,MAAM,WAAW,GAAI,QAAO;EAChC,MAAM,UAAU,IAAI,WAAW,GAAG;AAClC,UAAQ,IAAI,OAAO,EAAE;AACrB,SAAO;YACE,OAAO,UAAU,UAAU;AACpC,MAAI,MAAM,WAAW,KAAK,MAAM,SAAS,GACvC,OAAM,IAAI,MACR,0FAA0F,MAAM,gBAAgB,MAAM,SACvH;EAEH,MAAM,UAAU,IAAI,aAAa;EACjC,MAAM,UAAU,IAAI,WAAW,GAAG;AAClC,UAAQ,IAAI,QAAQ,OAAO,MAAM,EAAE,EAAE;AACrC,SAAO;OAEP,OAAM,IAAI,MAAM,kCAAkC,OAAO,QAAQ;;;;;;;;;;;;;;;;;;;;AAsBrE,eAAsB,yBAAyB,UAA+B;AAC5E,OAAM,SAAS,OAAO;AACtB,QAAO;;;;;;;;;;;;;;;;;;AAmBT,eAAsB,uBACpB,UACA,YACA,mBACA;CACA,MAAM,cAAc,SAAS,MAAM;EACjC,kCAAkC,WAAW,oCAAoC;EACjF,0BAA0B,WAAW,4BAA4B;EAClE,CAAC;AAEF,KAAI,mBAAmB,QACrB,aAAY,WAAW,mBAAmB,QAAQ;AAGpD,OAAM,YAAY,OAAO;AAEzB,QAAO;;;;;;;;;AAUT,MAAa,0BAA0B,eAAgB,SAA6E;CAClI,MAAM,EAAE,qBAAqB,cAAe,GAAG,kBAAkB;AAEjE,QAAO,QAAQ,oBAAoB,KAAK,EACtC,GAAG,eACJ,CAAC;;;;;;;;;;;;;AAcJ,MAAa,sBAAsB,eACjC,eACA,iBACA,OACqC;AACrC,KAAI,kBAAkB,EACpB,OAAM,IAAI,MAAM,6BAA6B,gBAAgB,gBAAgB;CAI/E,MAAM,SAAS,MAAM,MAAM,WAAW;AACtC,KAAI,WAAW,OACb,OAAM,IAAI,MAAM,4BAA4B;CAI9C,MAAM,aAAa,OAAO,OAAO,UAAU,GAAG;CAC9C,IAAI,eAAe;AACnB,QAAO,eAAe,aAAa,OAAO,gBAAgB,EAAE;AAC1D,MAAI;GACF,MAAM,cAAc,MAAM,MAAM,8BAA8B,cAAc;AAE5E,OAAI,gBAAgB,QAAW;IAC7B,MAAM,iBAAiB,YAAY;AACnC,QAAI,kBAAkB,iBAAiB,EACrC,QAAO;SACF;KACL,MAAM,YAAY,YAAY;AAC9B,SAAI,aAAa,QAAQ,UAAU,SAAS,EAE1C,OAAM,IAAI,MAAM,eAAe,cAAc,6BAA6B,YAAY;;;WAKrFA,GAAQ;AACf,OAAI,YAAY,KAAK,EAAE,WAAW,KAAK;AACrC;AACA;;;AAIJ,QAAM,MAAM,iBAAiB,SAAS,aAAa,CAAC;AACpD;;AAGF,OAAM,IAAI,MAAM,eAAe,cAAc,uBAAuB,gBAAgB,SAAS"}
+{"version":3,"file":"transaction.mjs","names":[],"sources":["../../src/transaction/transaction.ts"],"sourcesContent":["import { AlgodClient, PendingTransactionResponse } from '@algorandfoundation/algokit-algod-client'\nimport { Transaction, TransactionSigner } from '@algorandfoundation/algokit-transact'\nimport { TransactionComposer } from '../composer'\nimport { toNumber } from '../util'\nimport { AdditionalTransactionComposerContext, SendParams, SendTransactionComposerResults, TransactionComposerToSend } from './types'\n\n/** Represents an unsigned transactions and a signer that can authorize that transaction. */\nexport interface TransactionWithSigner {\n  /** An unsigned transaction */\n  txn: Transaction\n  /** A transaction signer that can authorize txn */\n  signer: TransactionSigner\n}\n\n/** Encodes a transaction lease into a 32-byte array ready to be included in an Algorand transaction.\n *\n * @param lease The transaction lease as a string or binary array or null/undefined if there is no lease\n * @returns the transaction lease ready for inclusion in a transaction or `undefined` if there is no lease\n * @throws if the length of the data is > 32 bytes or empty\n * @example algokit.encodeLease('UNIQUE_ID')\n * @example algokit.encodeLease(new Uint8Array([1, 2, 3]))\n */\nexport function encodeLease(lease?: string | Uint8Array): Uint8Array | undefined {\n  if (lease === null || typeof lease === 'undefined') {\n    return undefined\n  } else if (typeof lease === 'object' && lease.constructor === Uint8Array) {\n    if (lease.length === 0 || lease.length > 32) {\n      throw new Error(\n        `Received invalid lease; expected something with length between 1 and 32, but received bytes with length ${lease.length}`,\n      )\n    }\n    if (lease.length === 32) return lease\n    const lease32 = new Uint8Array(32)\n    lease32.set(lease, 0)\n    return lease32\n  } else if (typeof lease === 'string') {\n    if (lease.length === 0 || lease.length > 32) {\n      throw new Error(\n        `Received invalid lease; expected something with length between 1 and 32, but received '${lease}' with length ${lease.length}`,\n      )\n    }\n    const encoder = new TextEncoder()\n    const lease32 = new Uint8Array(32)\n    lease32.set(encoder.encode(lease), 0)\n    return lease32\n  } else {\n    throw new Error(`Unknown lease type received of ${typeof lease}`)\n  }\n}\n\n/**\n * @deprecated Use `composer.build()` directly\n * Take an existing Transaction Composer and return a new one with the required\n * app call resources populated into it\n *\n * @param composer The composer containing the txn group\n * @returns A new composer with the resources populated into the transactions\n *\n * @privateRemarks\n *\n * This entire function will eventually be implemented in simulate upstream in algod. The simulate endpoint will return\n * an array of refference arrays for each transaction, so this eventually will eventually just call simulate and set the\n * reference arrays in the transactions to the reference arrays returned by simulate.\n *\n * See https://github.com/algorand/go-algorand/pull/5684\n *\n */\nexport async function populateAppCallResources(composer: TransactionComposer) {\n  await composer.build()\n  return composer\n}\n\n/**\n * @deprecated Use `composer.setMaxFees()` instead if you need to set max fees for transactions.\n * Use `composer.build()` instead if you need to build transactions with resource population.\n *\n * Take an existing Transaction Composer and return a new one with changes applied to the transactions\n * based on the supplied sendParams to prepare it for sending.\n *\n * @param composer The Transaction Composer containing the txn group\n * @param sendParams The send params for the transaction group\n * @param additionalContext Additional context used to determine how best to change the transactions in the group\n * @returns A new Transaction Composer with the changes applied\n *\n * @privateRemarks\n * Parts of this function will eventually be implemented in algod. Namely:\n * - Simulate will return information on how to populate reference arrays, see https://github.com/algorand/go-algorand/pull/6015\n */\nexport async function prepareGroupForSending(\n  composer: TransactionComposer,\n  sendParams: SendParams,\n  additionalContext?: AdditionalTransactionComposerContext,\n) {\n  const newComposer = composer.clone({\n    coverAppCallInnerTransactionFees: sendParams.coverAppCallInnerTransactionFees ?? false,\n    populateAppCallResources: sendParams.populateAppCallResources ?? true,\n  })\n\n  if (additionalContext?.maxFees) {\n    newComposer.setMaxFees(additionalContext?.maxFees)\n  }\n\n  await newComposer.build()\n\n  return newComposer\n}\n\n/**\n * @deprecated Use `composer.send()` directly\n * Signs and sends transactions that have been collected by an `TransactionComposer`.\n * @param atcSend The parameters controlling the send, including `atc` The `TransactionComposer` and params to control send behaviour\n * @returns An object with transaction IDs, transactions, group transaction ID (`groupTransactionId`) if more than 1 transaction sent, and (if `skipWaiting` is `false` or unset) confirmation (`confirmation`)\n */\nexport const sendTransactionComposer = async function (atcSend: TransactionComposerToSend): Promise<SendTransactionComposerResults> {\n  const { transactionComposer: givenComposer, ...executeParams } = atcSend\n\n  return atcSend.transactionComposer.send({\n    ...executeParams,\n  })\n}\n\n/**\n * Wait until the transaction is confirmed or rejected, or until `timeout`\n * number of rounds have passed.\n *\n * @param algod An algod client\n * @param transactionId The transaction ID to wait for\n * @param maxRoundsToWait Maximum number of rounds to wait\n *\n * @return Pending transaction information\n * @throws Throws an error if the transaction is not confirmed or rejected in the next `timeout` rounds\n */\nexport const waitForConfirmation = async function (\n  transactionId: string,\n  maxRoundsToWait: number | bigint,\n  algod: AlgodClient,\n): Promise<PendingTransactionResponse> {\n  if (maxRoundsToWait < 0) {\n    throw new Error(`Invalid timeout, received ${maxRoundsToWait}, expected > 0`)\n  }\n\n  // Get current round\n  const status = await algod.status()\n  if (status === undefined) {\n    throw new Error('Unable to get node status')\n  }\n\n  // Loop for up to `timeout` rounds looking for a confirmed transaction\n  const startRound = BigInt(status.lastRound) + 1n\n  let currentRound = startRound\n  while (currentRound < startRound + BigInt(maxRoundsToWait)) {\n    try {\n      const pendingInfo = await algod.pendingTransactionInformation(transactionId)\n\n      if (pendingInfo !== undefined) {\n        const confirmedRound = pendingInfo.confirmedRound\n        if (confirmedRound && confirmedRound > 0) {\n          return pendingInfo\n        } else {\n          const poolError = pendingInfo.poolError\n          if (poolError != null && poolError.length > 0) {\n            // If there was a pool error, then the transaction has been rejected!\n            throw new Error(`Transaction ${transactionId} was rejected; pool error: ${poolError}`)\n          }\n        }\n      }\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } catch (e: any) {\n      if ('status' in e && e.status === 404) {\n        currentRound++\n        continue\n      }\n    }\n\n    await algod.statusAfterBlock(toNumber(currentRound))\n    currentRound++\n  }\n\n  throw new Error(`Transaction ${transactionId} not confirmed after ${maxRoundsToWait} rounds`)\n}\n"],"mappings":";;;;;;;;;;;AAsBA,SAAgB,YAAY,OAAqD;AAC/E,KAAI,UAAU,QAAQ,OAAO,UAAU,YACrC;UACS,OAAO,UAAU,YAAY,MAAM,gBAAgB,YAAY;AACxE,MAAI,MAAM,WAAW,KAAK,MAAM,SAAS,GACvC,OAAM,IAAI,MACR,2GAA2G,MAAM,SAClH;AAEH,MAAI,MAAM,WAAW,GAAI,QAAO;EAChC,MAAM,UAAU,IAAI,WAAW,GAAG;AAClC,UAAQ,IAAI,OAAO,EAAE;AACrB,SAAO;YACE,OAAO,UAAU,UAAU;AACpC,MAAI,MAAM,WAAW,KAAK,MAAM,SAAS,GACvC,OAAM,IAAI,MACR,0FAA0F,MAAM,gBAAgB,MAAM,SACvH;EAEH,MAAM,UAAU,IAAI,aAAa;EACjC,MAAM,UAAU,IAAI,WAAW,GAAG;AAClC,UAAQ,IAAI,QAAQ,OAAO,MAAM,EAAE,EAAE;AACrC,SAAO;OAEP,OAAM,IAAI,MAAM,kCAAkC,OAAO,QAAQ;;;;;;;;;;;;;;;;;;;AAqBrE,eAAsB,yBAAyB,UAA+B;AAC5E,OAAM,SAAS,OAAO;AACtB,QAAO;;;;;;;;;;;;;;;;;;AAmBT,eAAsB,uBACpB,UACA,YACA,mBACA;CACA,MAAM,cAAc,SAAS,MAAM;EACjC,kCAAkC,WAAW,oCAAoC;EACjF,0BAA0B,WAAW,4BAA4B;EAClE,CAAC;AAEF,KAAI,mBAAmB,QACrB,aAAY,WAAW,mBAAmB,QAAQ;AAGpD,OAAM,YAAY,OAAO;AAEzB,QAAO;;;;;;;;AAST,MAAa,0BAA0B,eAAgB,SAA6E;CAClI,MAAM,EAAE,qBAAqB,eAAe,GAAG,kBAAkB;AAEjE,QAAO,QAAQ,oBAAoB,KAAK,EACtC,GAAG,eACJ,CAAC;;;;;;;;;;;;;AAcJ,MAAa,sBAAsB,eACjC,eACA,iBACA,OACqC;AACrC,KAAI,kBAAkB,EACpB,OAAM,IAAI,MAAM,6BAA6B,gBAAgB,gBAAgB;CAI/E,MAAM,SAAS,MAAM,MAAM,QAAQ;AACnC,KAAI,WAAW,OACb,OAAM,IAAI,MAAM,4BAA4B;CAI9C,MAAM,aAAa,OAAO,OAAO,UAAU,GAAG;CAC9C,IAAI,eAAe;AACnB,QAAO,eAAe,aAAa,OAAO,gBAAgB,EAAE;AAC1D,MAAI;GACF,MAAM,cAAc,MAAM,MAAM,8BAA8B,cAAc;AAE5E,OAAI,gBAAgB,QAAW;IAC7B,MAAM,iBAAiB,YAAY;AACnC,QAAI,kBAAkB,iBAAiB,EACrC,QAAO;SACF;KACL,MAAM,YAAY,YAAY;AAC9B,SAAI,aAAa,QAAQ,UAAU,SAAS,EAE1C,OAAM,IAAI,MAAM,eAAe,cAAc,6BAA6B,YAAY;;;WAKrF,GAAQ;AACf,OAAI,YAAY,KAAK,EAAE,WAAW,KAAK;AACrC;AACA;;;AAIJ,QAAM,MAAM,iBAAiB,SAAS,aAAa,CAAC;AACpD;;AAGF,OAAM,IAAI,MAAM,eAAe,cAAc,uBAAuB,gBAAgB,SAAS"}