algosdk 2.8.0 → 3.0.0-beta.1

package/dist/esm/makeTxn.js

@@ -1,616 +1,417 @@
-import * as txnBuilder from './transaction';
-import { OnApplicationComplete } from './types/transactions/base';
-import { 
-// Utilities
-TransactionType, } from './types/transactions';
+import { Transaction } from './transaction.js';
+import { OnApplicationComplete, TransactionType, } from './types/transactions/base.js';
 /**
- * makePaymentTxnWithSuggestedParams takes payment arguments and returns a Transaction object
- * @param from - string representation of Algorand address of sender
- * @param to - string representation of Algorand address of recipient
- * @param amount - integer amount to send, in microAlgos
- * @param closeRemainderTo - optionally close out remaining account balance to this account, represented as string rep of Algorand address
- * @param note - uint8array of arbitrary data for sender to store
- * @param suggestedParams - a dict holding common-to-all-txns args:
- * fee - integer fee per byte, in microAlgos. for a flat fee, set flatFee to true
- * flatFee - bool optionally set this to true to specify fee as microalgos-per-txn
- *       If true, txn fee may fall below the ALGORAND_MIN_TX_FEE
- * firstRound - integer first protocol round on which this txn is valid
- * lastRound - integer last protocol round on which this txn is valid
- * genesisHash - string specifies hash genesis block of network in use
- * genesisID - string specifies genesis ID of network in use
- * @param rekeyTo - rekeyTo address, optional
+ * Create a new payment transaction
+ *
+ * @param options - Payment transaction parameters
  */
-export function makePaymentTxnWithSuggestedParams(from, to, amount, closeRemainderTo, note, suggestedParams, rekeyTo) {
-    const o = {
-        from,
-        to,
-        amount,
-        closeRemainderTo,
+export function makePaymentTxnWithSuggestedParamsFromObject({ sender, receiver, amount, closeRemainderTo, suggestedParams, note, lease, rekeyTo, }) {
+    return new Transaction({
+        type: TransactionType.pay,
+        sender,
         note,
+        lease,
+        rekeyTo,
         suggestedParams,
-        type: TransactionType.pay,
-        reKeyTo: rekeyTo,
-    };
-    return new txnBuilder.Transaction(o);
+        paymentParams: {
+            receiver,
+            amount,
+            closeRemainderTo,
+        },
+    });
 }
-// helper for above makePaymentTxnWithSuggestedParams, instead accepting an arguments object
-export function makePaymentTxnWithSuggestedParamsFromObject(o) {
-    return makePaymentTxnWithSuggestedParams(o.from, o.to, o.amount, o.closeRemainderTo, o.note, o.suggestedParams, o.rekeyTo);
-}
-export function makeKeyRegistrationTxnWithSuggestedParams(from, note, voteKey, selectionKey, voteFirst, voteLast, voteKeyDilution, suggestedParams, rekeyTo, nonParticipation = false, stateProofKey = undefined) {
-    const o = {
-        from,
+/**
+ * Create a new key registration transaction
+ *
+ * @param options - Key registration transaction parameters
+ */
+export function makeKeyRegistrationTxnWithSuggestedParamsFromObject({ sender, voteKey, selectionKey, stateProofKey, voteFirst, voteLast, voteKeyDilution, nonParticipation, suggestedParams, note, lease, rekeyTo, }) {
+    return new Transaction({
+        type: TransactionType.keyreg,
+        sender,
         note,
-        voteKey,
-        selectionKey,
-        voteFirst,
-        voteLast,
-        voteKeyDilution,
+        lease,
+        rekeyTo,
         suggestedParams,
-        type: TransactionType.keyreg,
-        reKeyTo: rekeyTo,
-        nonParticipation,
-        stateProofKey,
-    };
-    return new txnBuilder.Transaction(o);
+        keyregParams: {
+            voteKey,
+            selectionKey,
+            stateProofKey,
+            voteFirst,
+            voteLast,
+            voteKeyDilution,
+            nonParticipation,
+        },
+    });
 }
-export function makeKeyRegistrationTxnWithSuggestedParamsFromObject(o) {
-    return makeKeyRegistrationTxnWithSuggestedParams(o.from, o.note, o.voteKey, o.selectionKey, o.voteFirst, o.voteLast, o.voteKeyDilution, o.suggestedParams, o.rekeyTo, o.nonParticipation, o.stateProofKey);
-}
-/** makeAssetCreateTxnWithSuggestedParams takes asset creation arguments and returns a Transaction object
- * for creating that asset
+/**
+ * Base function for creating any type of asset config transaction.
  *
- * @param from - string representation of Algorand address of sender
- * @param note - uint8array of arbitrary data for sender to store
- * @param total - integer total supply of the asset
- * @param decimals - integer number of decimals for asset unit calculation
- * @param defaultFrozen - boolean whether asset accounts should default to being frozen
- * @param manager - string representation of Algorand address in charge of reserve, freeze, clawback, destruction, etc
- * @param reserve - string representation of Algorand address representing asset reserve
- * @param freeze - string representation of Algorand address with power to freeze/unfreeze asset holdings
- * @param clawback - string representation of Algorand address with power to revoke asset holdings
- * @param unitName - string units name for this asset
- * @param assetName - string name for this asset
- * @param assetURL - string URL relating to this asset
- * @param assetMetadataHash - Uint8Array or UTF-8 string representation of a hash commitment with respect to the asset. Must be exactly 32 bytes long.
- * @param suggestedParams - a dict holding common-to-all-txns args:
- * fee - integer fee per byte, in microAlgos. for a flat fee, set flatFee to true
- * flatFee - bool optionally set this to true to specify fee as microalgos-per-txn
- *       If true, txn fee may fall below the ALGORAND_MIN_TX_FEE
- * firstRound - integer first protocol round on which this txn is valid
- * lastRound - integer last protocol round on which this txn is valid
- * genesisHash - string specifies hash genesis block of network in use
- * genesisID - string specifies genesis ID of network in use
- * @param rekeyTo - rekeyTo address, optional
+ * @param options - Asset config transaction parameters
  */
-export function makeAssetCreateTxnWithSuggestedParams(from, note, total, decimals, defaultFrozen, manager, reserve, freeze, clawback, unitName, assetName, assetURL, assetMetadataHash, suggestedParams, rekeyTo) {
-    const o = {
-        from,
+export function makeBaseAssetConfigTxn({ sender, assetIndex, total, decimals, defaultFrozen, manager, reserve, freeze, clawback, unitName, assetName, assetURL, assetMetadataHash, note, lease, rekeyTo, suggestedParams, }) {
+    return new Transaction({
+        type: TransactionType.acfg,
+        sender,
         note,
+        lease,
+        rekeyTo,
         suggestedParams,
-        assetTotal: total,
-        assetDecimals: decimals,
-        assetDefaultFrozen: defaultFrozen,
-        assetUnitName: unitName,
+        assetConfigParams: {
+            assetIndex,
+            total,
+            decimals,
+            defaultFrozen,
+            manager,
+            reserve,
+            freeze,
+            clawback,
+            unitName,
+            assetName,
+            assetURL,
+            assetMetadataHash,
+        },
+    });
+}
+/**
+ * Create a new asset creation transaction
+ *
+ * @param options - Asset creation transaction parameters
+ */
+export function makeAssetCreateTxnWithSuggestedParamsFromObject({ sender, total, decimals, defaultFrozen, manager, reserve, freeze, clawback, unitName, assetName, assetURL, assetMetadataHash, note, lease, rekeyTo, suggestedParams, }) {
+    return makeBaseAssetConfigTxn({
+        sender,
+        total,
+        decimals,
+        defaultFrozen,
+        manager,
+        reserve,
+        freeze,
+        clawback,
+        unitName,
         assetName,
         assetURL,
         assetMetadataHash,
-        assetManager: manager,
-        assetReserve: reserve,
-        assetFreeze: freeze,
-        assetClawback: clawback,
-        type: TransactionType.acfg,
-        reKeyTo: rekeyTo,
-    };
-    return new txnBuilder.Transaction(o);
-}
-// helper for above makeAssetCreateTxnWithSuggestedParams, instead accepting an arguments object
-export function makeAssetCreateTxnWithSuggestedParamsFromObject(o) {
-    return makeAssetCreateTxnWithSuggestedParams(o.from, o.note, o.total, o.decimals, o.defaultFrozen, o.manager, o.reserve, o.freeze, o.clawback, o.unitName, o.assetName, o.assetURL, o.assetMetadataHash, o.suggestedParams, o.rekeyTo);
+        note,
+        lease,
+        rekeyTo,
+        suggestedParams,
+    });
 }
-/** makeAssetConfigTxnWithSuggestedParams can be issued by the asset manager to change the manager, reserve, freeze, or clawback
- * you must respecify existing addresses to keep them the same; leaving a field blank is the same as turning
- * that feature off for this asset
+/**
+ * Create a new asset config transaction. This transaction can be issued by the asset manager to
+ * change the manager, reserve, freeze, or clawback address.
+ *
+ * You must respecify existing addresses to keep them the same; leaving a field blank is the same as
+ * turning that feature off for this asset.
  *
- * @param from - string representation of Algorand address of sender
- * @param note - uint8array of arbitrary data for sender to store
- * @param assetIndex - int asset index uniquely specifying the asset
- * @param manager - string representation of new asset manager Algorand address
- * @param reserve - string representation of new reserve Algorand address
- * @param freeze - string representation of new freeze manager Algorand address
- * @param clawback - string representation of new revocation manager Algorand address
- * @param strictEmptyAddressChecking - boolean - throw an error if any of manager, reserve, freeze, or clawback are undefined. optional, defaults to true.
- * @param suggestedParams - a dict holding common-to-all-txns args:
- * fee - integer fee per byte, in microAlgos. for a flat fee, set flatFee to true
- * flatFee - bool optionally set this to true to specify fee as microalgos-per-txn
- *       If true, txn fee may fall below the ALGORAND_MIN_TX_FEE
- * firstRound - integer first protocol round on which this txn is valid
- * lastRound - integer last protocol round on which this txn is valid
- * genesisHash - string specifies hash genesis block of network in use
- * genesisID - string specifies genesis ID of network in use
- * @param rekeyTo - rekeyTo address, optional
+ * @param options - Asset modification transaction parameters
  */
-export function makeAssetConfigTxnWithSuggestedParams(from, note, assetIndex, manager, reserve, freeze, clawback, suggestedParams, strictEmptyAddressChecking = true, rekeyTo) {
-    if (strictEmptyAddressChecking &&
-        (manager === undefined ||
-            reserve === undefined ||
-            freeze === undefined ||
-            clawback === undefined)) {
-        throw Error('strict empty address checking was turned on, but at least one empty address was provided');
+export function makeAssetConfigTxnWithSuggestedParamsFromObject({ sender, assetIndex, manager, reserve, freeze, clawback, strictEmptyAddressChecking, note, lease, rekeyTo, suggestedParams, }) {
+    if (!assetIndex) {
+        throw Error('assetIndex must be provided');
     }
-    const o = {
-        from,
-        suggestedParams,
+    const strictChecking = strictEmptyAddressChecking ?? true;
+    if (strictChecking &&
+        (manager == null || reserve == null || freeze == null || clawback == null)) {
+        throw Error('strictEmptyAddressChecking is enabled, but an address is empty. If this is intentional, set strictEmptyAddressChecking to false.');
+    }
+    return makeBaseAssetConfigTxn({
+        sender,
         assetIndex,
-        assetManager: manager,
-        assetReserve: reserve,
-        assetFreeze: freeze,
-        assetClawback: clawback,
-        type: TransactionType.acfg,
+        manager,
+        reserve,
+        freeze,
+        clawback,
         note,
-        reKeyTo: rekeyTo,
-    };
-    return new txnBuilder.Transaction(o);
-}
-// helper for above makeAssetConfigTxnWithSuggestedParams, instead accepting an arguments object
-export function makeAssetConfigTxnWithSuggestedParamsFromObject(o) {
-    return makeAssetConfigTxnWithSuggestedParams(o.from, o.note, o.assetIndex, o.manager, o.reserve, o.freeze, o.clawback, o.suggestedParams, o.strictEmptyAddressChecking, o.rekeyTo);
+        lease,
+        rekeyTo,
+        suggestedParams,
+    });
 }
-/** makeAssetDestroyTxnWithSuggestedParams will allow the asset's manager to remove this asset from the ledger, so long
- * as all outstanding assets are held by the creator.
+/**
+ * Create a new asset destroy transaction. This will allow the asset's manager to remove this asset
+ * from the ledger, provided all outstanding assets are held by the creator.
  *
- * @param from - string representation of Algorand address of sender
- * @param note - uint8array of arbitrary data for sender to store
- * @param assetIndex - int asset index uniquely specifying the asset
- * @param suggestedParams - a dict holding common-to-all-txns args:
- * fee - integer fee per byte, in microAlgos. for a flat fee, set flatFee to true
- * flatFee - bool optionally set this to true to specify fee as microalgos-per-txn
- *       If true, txn fee may fall below the ALGORAND_MIN_TX_FEE
- * firstRound - integer first protocol round on which this txn is valid
- * lastRound - integer last protocol round on which this txn is valid
- * genesisHash - string specifies hash genesis block of network in use
- * genesisID - string specifies genesis ID of network in use
- * @param rekeyTo - rekeyTo address, optional
+ * @param options - Asset destroy transaction parameters
  */
-export function makeAssetDestroyTxnWithSuggestedParams(from, note, assetIndex, suggestedParams, rekeyTo) {
-    const o = {
-        from,
-        suggestedParams,
+export function makeAssetDestroyTxnWithSuggestedParamsFromObject({ sender, assetIndex, note, lease, rekeyTo, suggestedParams, }) {
+    if (!assetIndex) {
+        throw Error('assetIndex must be provided');
+    }
+    return makeBaseAssetConfigTxn({
+        sender,
         assetIndex,
-        type: TransactionType.acfg,
         note,
-        reKeyTo: rekeyTo,
-    };
-    return new txnBuilder.Transaction(o);
-}
-// helper for above makeAssetDestroyTxnWithSuggestedParams, instead accepting an arguments object
-export function makeAssetDestroyTxnWithSuggestedParamsFromObject(o) {
-    return makeAssetDestroyTxnWithSuggestedParams(o.from, o.note, o.assetIndex, o.suggestedParams, o.rekeyTo);
+        lease,
+        rekeyTo,
+        suggestedParams,
+    });
 }
-/** makeAssetFreezeTxnWithSuggestedParams will allow the asset's freeze manager to freeze or un-freeze an account,
- * blocking or allowing asset transfers to and from the targeted account.
+/**
+ * Create a new asset freeze transaction. This transaction allows the asset's freeze manager to
+ * freeze or un-freeze an account, blocking or allowing asset transfers to and from the targeted
+ * account.
  *
- * @param from - string representation of Algorand address of sender
- * @param note - uint8array of arbitrary data for sender to store
- * @param assetIndex - int asset index uniquely specifying the asset
- * @param freezeTarget - string representation of Algorand address being frozen or unfrozen
- * @param freezeState - true if freezeTarget should be frozen, false if freezeTarget should be allowed to transact
- * @param suggestedParams - a dict holding common-to-all-txns args:
- * fee - integer fee per byte, in microAlgos. for a flat fee, set flatFee to true
- * flatFee - bool optionally set this to true to specify fee as microalgos-per-txn
- *       If true, txn fee may fall below the ALGORAND_MIN_TX_FEE
- * firstRound - integer first protocol round on which this txn is valid
- * lastRound - integer last protocol round on which this txn is valid
- * genesisHash - string specifies hash genesis block of network in use
- * genesisID - string specifies genesis ID of network in use
- * @param rekeyTo - rekeyTo address, optional
+ * @param options - Asset freeze transaction parameters
  */
-export function makeAssetFreezeTxnWithSuggestedParams(from, note, assetIndex, freezeTarget, freezeState, suggestedParams, rekeyTo) {
-    const o = {
-        from,
+export function makeAssetFreezeTxnWithSuggestedParamsFromObject({ sender, assetIndex, freezeTarget, frozen, suggestedParams, note, lease, rekeyTo, }) {
+    return new Transaction({
         type: TransactionType.afrz,
-        freezeAccount: freezeTarget,
-        assetIndex,
-        freezeState,
+        sender,
         note,
+        lease,
+        rekeyTo,
         suggestedParams,
-        reKeyTo: rekeyTo,
-    };
-    return new txnBuilder.Transaction(o);
-}
-// helper for above makeAssetFreezeTxnWithSuggestedParams, instead accepting an arguments object
-export function makeAssetFreezeTxnWithSuggestedParamsFromObject(o) {
-    return makeAssetFreezeTxnWithSuggestedParams(o.from, o.note, o.assetIndex, o.freezeTarget, o.freezeState, o.suggestedParams, o.rekeyTo);
+        assetFreezeParams: {
+            assetIndex,
+            freezeTarget,
+            frozen,
+        },
+    });
 }
-/** makeAssetTransferTxnWithSuggestedParams allows for the creation of an asset transfer transaction.
- * Special case: to begin accepting assets, set amount=0 and from=to.
+/**
+ * Create a new asset transfer transaction.
+ *
+ * Special case: to opt into an assets, set amount=0 and sender=receiver.
  *
- * @param from - string representation of Algorand address of sender
- * @param to - string representation of Algorand address of asset recipient
- * @param closeRemainderTo - optional - string representation of Algorand address - if provided,
- * send all remaining assets after transfer to the "closeRemainderTo" address and close "from"'s asset holdings
- * @param revocationTarget - optional - string representation of Algorand address - if provided,
- * and if "from" is the asset's revocation manager, then deduct from "revocationTarget" rather than "from"
- * @param amount - integer amount of assets to send
- * @param note - uint8array of arbitrary data for sender to store
- * @param assetIndex - int asset index uniquely specifying the asset
- * @param suggestedParams - a dict holding common-to-all-txns args:
- * fee - integer fee per byte, in microAlgos. for a flat fee, set flatFee to true
- * flatFee - bool optionally set this to true to specify fee as microalgos-per-txn
- *       If true, txn fee may fall below the ALGORAND_MIN_TX_FEE
- * * flatFee - bool optionally set this to true to specify fee as microalgos-per-txn
- *       If true, txn fee may fall below the ALGORAND_MIN_TX_FEE
- * firstRound - integer first protocol round on which this txn is valid
- * lastRound - integer last protocol round on which this txn is valid
- * genesisHash - string specifies hash genesis block of network in use
- * genesisID - string specifies genesis ID of network in use
- * @param rekeyTo - rekeyTo address, optional
+ * @param options - Asset transfer transaction parameters
  */
-export function makeAssetTransferTxnWithSuggestedParams(from, to, closeRemainderTo, revocationTarget, amount, note, assetIndex, suggestedParams, rekeyTo) {
-    const o = {
+export function makeAssetTransferTxnWithSuggestedParamsFromObject({ sender, receiver, amount, closeRemainderTo, assetSender, note, assetIndex, suggestedParams, rekeyTo, lease, }) {
+    if (!assetIndex) {
+        throw Error('assetIndex must be provided');
+    }
+    return new Transaction({
         type: TransactionType.axfer,
-        from,
-        to,
-        amount,
-        suggestedParams,
-        assetIndex,
+        sender,
         note,
-        assetRevocationTarget: revocationTarget,
-        closeRemainderTo,
-        reKeyTo: rekeyTo,
-    };
-    return new txnBuilder.Transaction(o);
-}
-// helper for above makeAssetTransferTxnWithSuggestedParams, instead accepting an arguments object
-export function makeAssetTransferTxnWithSuggestedParamsFromObject(o) {
-    return makeAssetTransferTxnWithSuggestedParams(o.from, o.to, o.closeRemainderTo, o.revocationTarget, o.amount, o.note, o.assetIndex, o.suggestedParams, o.rekeyTo);
+        lease,
+        rekeyTo,
+        suggestedParams,
+        assetTransferParams: {
+            assetIndex,
+            receiver,
+            amount,
+            assetSender,
+            closeRemainderTo,
+        },
+    });
 }
 /**
- * Make a transaction that will create an application.
- * @param from - address of sender
- * @param suggestedParams - a dict holding common-to-all-txns args:
- * fee - integer fee per byte, in microAlgos. for a flat fee, set flatFee to true
- * flatFee - bool optionally set this to true to specify fee as microalgos-per-txn
- *       If true, txn fee may fall below the ALGORAND_MIN_TX_FEE
- * firstRound - integer first protocol round on which this txn is valid
- * lastRound - integer last protocol round on which this txn is valid
- * genesisHash - string specifies hash genesis block of network in use
- * genesisID - string specifies genesis ID of network in use
- * @param onComplete - algosdk.OnApplicationComplete, what application should do once the program is done being run
- * @param approvalProgram - Uint8Array, the compiled TEAL that approves a transaction
- * @param clearProgram - Uint8Array, the compiled TEAL that runs when clearing state
- * @param numLocalInts - restricts number of ints in per-user local state
- * @param numLocalByteSlices - restricts number of byte slices in per-user local state
- * @param numGlobalInts - restricts number of ints in global state
- * @param numGlobalByteSlices - restricts number of byte slices in global state
- * @param appArgs - Array of Uint8Array, any additional arguments to the application
- * @param accounts - Array of Address strings, any additional accounts to supply to the application
- * @param foreignApps - Array of int, any other apps used by the application, identified by index
- * @param foreignAssets - Array of int, any assets used by the application, identified by index
- * @param note - Arbitrary data for sender to store
- * @param lease - Lease a transaction
- * @param rekeyTo - String representation of the Algorand address that will be used to authorize all future transactions
- * @param extraPages - integer extra pages of memory to rent on creation of application
- * @param boxes - Array of BoxReference, app ID and name of box to be accessed
+ * Base function for creating any application call transaction.
+ *
+ * @param options - Application call transaction parameters
  */
-export function makeApplicationCreateTxn(from, suggestedParams, onComplete, approvalProgram, clearProgram, numLocalInts, numLocalByteSlices, numGlobalInts, numGlobalByteSlices, appArgs, accounts, foreignApps, foreignAssets, note, lease, rekeyTo, extraPages, boxes) {
-    const o = {
+export function makeApplicationCallTxnFromObject({ sender, appIndex, onComplete, appArgs, accounts, foreignApps, foreignAssets, boxes, approvalProgram, clearProgram, numLocalInts, numLocalByteSlices, numGlobalInts, numGlobalByteSlices, extraPages, note, lease, rekeyTo, suggestedParams, }) {
+    if (onComplete == null) {
+        throw Error('onComplete must be provided');
+    }
+    return new Transaction({
         type: TransactionType.appl,
-        from,
+        sender,
+        note,
+        lease,
+        rekeyTo,
         suggestedParams,
+        appCallParams: {
+            appIndex,
+            onComplete,
+            appArgs,
+            accounts,
+            foreignAssets,
+            foreignApps,
+            boxes,
+            approvalProgram,
+            clearProgram,
+            numLocalInts,
+            numLocalByteSlices,
+            numGlobalInts,
+            numGlobalByteSlices,
+            extraPages,
+        },
+    });
+}
+/**
+ * Make a transaction that will create an application.
+ *
+ * @param options - Application creation transaction parameters
+ */
+export function makeApplicationCreateTxnFromObject({ sender, onComplete, appArgs, accounts, foreignApps, foreignAssets, boxes, approvalProgram, clearProgram, numLocalInts, numLocalByteSlices, numGlobalInts, numGlobalByteSlices, extraPages, note, lease, rekeyTo, suggestedParams, }) {
+    if (!approvalProgram || !clearProgram) {
+        throw Error('approvalProgram and clearProgram must be provided');
+    }
+    if (onComplete == null) {
+        throw Error('onComplete must be provided');
+    }
+    return makeApplicationCallTxnFromObject({
+        sender,
         appIndex: 0,
-        appOnComplete: onComplete,
-        appLocalInts: numLocalInts,
-        appLocalByteSlices: numLocalByteSlices,
-        appGlobalInts: numGlobalInts,
-        appGlobalByteSlices: numGlobalByteSlices,
-        appApprovalProgram: approvalProgram,
-        appClearProgram: clearProgram,
+        onComplete,
         appArgs,
-        appAccounts: accounts,
-        appForeignApps: foreignApps,
-        appForeignAssets: foreignAssets,
+        accounts,
+        foreignApps,
+        foreignAssets,
         boxes,
+        approvalProgram,
+        clearProgram,
+        numLocalInts,
+        numLocalByteSlices,
+        numGlobalInts,
+        numGlobalByteSlices,
+        extraPages,
         note,
         lease,
-        reKeyTo: rekeyTo,
-        extraPages,
-    };
-    return new txnBuilder.Transaction(o);
-}
-// helper for above makeApplicationCreateTxn, instead accepting an arguments object
-export function makeApplicationCreateTxnFromObject(o) {
-    return makeApplicationCreateTxn(o.from, o.suggestedParams, o.onComplete, o.approvalProgram, o.clearProgram, o.numLocalInts, o.numLocalByteSlices, o.numGlobalInts, o.numGlobalByteSlices, o.appArgs, o.accounts, o.foreignApps, o.foreignAssets, o.note, o.lease, o.rekeyTo, o.extraPages, o.boxes);
+        rekeyTo,
+        suggestedParams,
+    });
 }
 /**
  * Make a transaction that changes an application's approval and clear programs
- * @param from - address of sender
- * @param suggestedParams - a dict holding common-to-all-txns args:
- * fee - integer fee per byte, in microAlgos. for a flat fee, set flatFee to true
- * flatFee - bool optionally set this to true to specify fee as microalgos-per-txn
- *       If true, txn fee may fall below the ALGORAND_MIN_TX_FEE
- * firstRound - integer first protocol round on which this txn is valid
- * lastRound - integer last protocol round on which this txn is valid
- * genesisHash - string specifies hash genesis block of network in use
- * genesisID - string specifies genesis ID of network in use
- * @param appIndex - the ID of the app to be updated
- * @param approvalProgram - Uint8Array, the compiled TEAL that approves a transaction
- * @param clearProgram - Uint8Array, the compiled TEAL that runs when clearing state
- * @param appArgs - Array of Uint8Array, any additional arguments to the application
- * @param accounts - Array of Address strings, any additional accounts to supply to the application
- * @param foreignApps - Array of int, any other apps used by the application, identified by index
- * @param foreignAssets - Array of int, any assets used by the application, identified by index
- * @param note - Arbitrary data for sender to store
- * @param lease - Lease a transaction
- * @param rekeyTo - String representation of the Algorand address that will be used to authorize all future transactions
- * @param boxes - Array of BoxReference, app ID and name of box to be accessed
+ *
+ * @param options - Application update transaction parameters
  */
-export function makeApplicationUpdateTxn(from, suggestedParams, appIndex, approvalProgram, clearProgram, appArgs, accounts, foreignApps, foreignAssets, note, lease, rekeyTo, boxes) {
-    const o = {
-        type: TransactionType.appl,
-        from,
-        suggestedParams,
+export function makeApplicationUpdateTxnFromObject({ sender, appIndex, appArgs, accounts, foreignApps, foreignAssets, boxes, approvalProgram, clearProgram, note, lease, rekeyTo, suggestedParams, }) {
+    if (!appIndex) {
+        throw Error('appIndex must be provided');
+    }
+    if (!approvalProgram || !clearProgram) {
+        throw Error('approvalProgram and clearProgram must be provided');
+    }
+    return makeApplicationCallTxnFromObject({
+        sender,
         appIndex,
-        appApprovalProgram: approvalProgram,
-        appOnComplete: OnApplicationComplete.UpdateApplicationOC,
-        appClearProgram: clearProgram,
+        onComplete: OnApplicationComplete.UpdateApplicationOC,
         appArgs,
-        appAccounts: accounts,
-        appForeignApps: foreignApps,
-        appForeignAssets: foreignAssets,
+        accounts,
+        foreignApps,
+        foreignAssets,
         boxes,
+        approvalProgram,
+        clearProgram,
         note,
         lease,
-        reKeyTo: rekeyTo,
-    };
-    return new txnBuilder.Transaction(o);
-}
-// helper for above makeApplicationUpdateTxn, instead accepting an arguments object
-export function makeApplicationUpdateTxnFromObject(o) {
-    return makeApplicationUpdateTxn(o.from, o.suggestedParams, o.appIndex, o.approvalProgram, o.clearProgram, o.appArgs, o.accounts, o.foreignApps, o.foreignAssets, o.note, o.lease, o.rekeyTo, o.boxes);
+        rekeyTo,
+        suggestedParams,
+    });
 }
 /**
  * Make a transaction that deletes an application
- * @param from - address of sender
- * @param suggestedParams - a dict holding common-to-all-txns args:
- * fee - integer fee per byte, in microAlgos. for a flat fee, set flatFee to true
- * flatFee - bool optionally set this to true to specify fee as microalgos-per-txn
- *       If true, txn fee may fall below the ALGORAND_MIN_TX_FEE
- * firstRound - integer first protocol round on which this txn is valid
- * lastRound - integer last protocol round on which this txn is valid
- * genesisHash - string specifies hash genesis block of network in use
- * genesisID - string specifies genesis ID of network in use
- * @param appIndex - the ID of the app to be deleted
- * @param appArgs - Array of Uint8Array, any additional arguments to the application
- * @param accounts - Array of Address strings, any additional accounts to supply to the application
- * @param foreignApps - Array of int, any other apps used by the application, identified by index
- * @param foreignAssets - Array of int, any assets used by the application, identified by index
- * @param note - Arbitrary data for sender to store
- * @param lease - Lease a transaction
- * @param rekeyTo - String representation of the Algorand address that will be used to authorize all future transactions
- * @param boxes - Array of BoxReference, app ID and name of box to be accessed
+ *
+ * @param options - Application deletion transaction parameters
  */
-export function makeApplicationDeleteTxn(from, suggestedParams, appIndex, appArgs, accounts, foreignApps, foreignAssets, note, lease, rekeyTo, boxes) {
-    const o = {
-        type: TransactionType.appl,
-        from,
-        suggestedParams,
+export function makeApplicationDeleteTxnFromObject({ sender, appIndex, appArgs, accounts, foreignApps, foreignAssets, boxes, note, lease, rekeyTo, suggestedParams, }) {
+    if (!appIndex) {
+        throw Error('appIndex must be provided');
+    }
+    return makeApplicationCallTxnFromObject({
+        sender,
         appIndex,
-        appOnComplete: OnApplicationComplete.DeleteApplicationOC,
+        onComplete: OnApplicationComplete.DeleteApplicationOC,
         appArgs,
-        appAccounts: accounts,
-        appForeignApps: foreignApps,
-        appForeignAssets: foreignAssets,
+        accounts,
+        foreignApps,
+        foreignAssets,
         boxes,
         note,
         lease,
-        reKeyTo: rekeyTo,
-    };
-    return new txnBuilder.Transaction(o);
-}
-// helper for above makeApplicationDeleteTxn, instead accepting an arguments object
-export function makeApplicationDeleteTxnFromObject(o) {
-    return makeApplicationDeleteTxn(o.from, o.suggestedParams, o.appIndex, o.appArgs, o.accounts, o.foreignApps, o.foreignAssets, o.note, o.lease, o.rekeyTo, o.boxes);
+        rekeyTo,
+        suggestedParams,
+    });
 }
 /**
  * Make a transaction that opts in to use an application
- * @param from - address of sender
- * @param suggestedParams - a dict holding common-to-all-txns args:
- * fee - integer fee per byte, in microAlgos. for a flat fee, set flatFee to true
- * flatFee - bool optionally set this to true to specify fee as microalgos-per-txn
- *       If true, txn fee may fall below the ALGORAND_MIN_TX_FEE
- * firstRound - integer first protocol round on which this txn is valid
- * lastRound - integer last protocol round on which this txn is valid
- * genesisHash - string specifies hash genesis block of network in use
- * genesisID - string specifies genesis ID of network in use
- * @param appIndex - the ID of the app to join
- * @param appArgs - Array of Uint8Array, any additional arguments to the application
- * @param accounts - Array of Address strings, any additional accounts to supply to the application
- * @param foreignApps - Array of int, any other apps used by the application, identified by index
- * @param foreignAssets - Array of int, any assets used by the application, identified by index
- * @param note - Arbitrary data for sender to store
- * @param lease - Lease a transaction
- * @param rekeyTo - String representation of the Algorand address that will be used to authorize all future transactions
- * @param boxes - Array of BoxReference, app ID and name of box to be accessed
+ *
+ * @param options - Application opt-in transaction parameters
  */
-export function makeApplicationOptInTxn(from, suggestedParams, appIndex, appArgs, accounts, foreignApps, foreignAssets, note, lease, rekeyTo, boxes) {
-    const o = {
-        type: TransactionType.appl,
-        from,
-        suggestedParams,
+export function makeApplicationOptInTxnFromObject({ sender, appIndex, appArgs, accounts, foreignApps, foreignAssets, boxes, note, lease, rekeyTo, suggestedParams, }) {
+    if (!appIndex) {
+        throw Error('appIndex must be provided');
+    }
+    return makeApplicationCallTxnFromObject({
+        sender,
         appIndex,
-        appOnComplete: OnApplicationComplete.OptInOC,
+        onComplete: OnApplicationComplete.OptInOC,
         appArgs,
-        appAccounts: accounts,
-        appForeignApps: foreignApps,
-        appForeignAssets: foreignAssets,
+        accounts,
+        foreignApps,
+        foreignAssets,
         boxes,
         note,
         lease,
-        reKeyTo: rekeyTo,
-    };
-    return new txnBuilder.Transaction(o);
-}
-// helper for above makeApplicationOptInTxn, instead accepting an argument object
-export function makeApplicationOptInTxnFromObject(o) {
-    return makeApplicationOptInTxn(o.from, o.suggestedParams, o.appIndex, o.appArgs, o.accounts, o.foreignApps, o.foreignAssets, o.note, o.lease, o.rekeyTo, o.boxes);
+        rekeyTo,
+        suggestedParams,
+    });
 }
 /**
  * Make a transaction that closes out a user's state in an application
- * @param from - address of sender
- * @param suggestedParams - a dict holding common-to-all-txns args:
- * fee - integer fee per byte, in microAlgos. for a flat fee, set flatFee to true
- * flatFee - bool optionally set this to true to specify fee as microalgos-per-txn
- *       If true, txn fee may fall below the ALGORAND_MIN_TX_FEE
- * firstRound - integer first protocol round on which this txn is valid
- * lastRound - integer last protocol round on which this txn is valid
- * genesisHash - string specifies hash genesis block of network in use
- * genesisID - string specifies genesis ID of network in use
- * @param appIndex - the ID of the app to use
- * @param appArgs - Array of Uint8Array, any additional arguments to the application
- * @param accounts - Array of Address strings, any additional accounts to supply to the application
- * @param foreignApps - Array of int, any other apps used by the application, identified by index
- * @param foreignAssets - Array of int, any assets used by the application, identified by index
- * @param note - Arbitrary data for sender to store
- * @param lease - Lease a transaction
- * @param rekeyTo - String representation of the Algorand address that will be used to authorize all future transactions
- * @param boxes - Array of BoxReference, app ID and name of box to be accessed
+ *
+ * @param options - Application close-out transaction parameters
  */
-export function makeApplicationCloseOutTxn(from, suggestedParams, appIndex, appArgs, accounts, foreignApps, foreignAssets, note, lease, rekeyTo, boxes) {
-    const o = {
-        type: TransactionType.appl,
-        from,
-        suggestedParams,
+export function makeApplicationCloseOutTxnFromObject({ sender, appIndex, appArgs, accounts, foreignApps, foreignAssets, boxes, note, lease, rekeyTo, suggestedParams, }) {
+    if (!appIndex) {
+        throw Error('appIndex must be provided');
+    }
+    return makeApplicationCallTxnFromObject({
+        sender,
         appIndex,
-        appOnComplete: OnApplicationComplete.CloseOutOC,
+        onComplete: OnApplicationComplete.CloseOutOC,
         appArgs,
-        appAccounts: accounts,
-        appForeignApps: foreignApps,
-        appForeignAssets: foreignAssets,
+        accounts,
+        foreignApps,
+        foreignAssets,
         boxes,
         note,
         lease,
-        reKeyTo: rekeyTo,
-    };
-    return new txnBuilder.Transaction(o);
-}
-// helper for above makeApplicationCloseOutTxn, instead accepting an argument object
-export function makeApplicationCloseOutTxnFromObject(o) {
-    return makeApplicationCloseOutTxn(o.from, o.suggestedParams, o.appIndex, o.appArgs, o.accounts, o.foreignApps, o.foreignAssets, o.note, o.lease, o.rekeyTo, o.boxes);
+        rekeyTo,
+        suggestedParams,
+    });
 }
 /**
  * Make a transaction that clears a user's state in an application
- * @param from - address of sender
- * @param suggestedParams - a dict holding common-to-all-txns args:
- * fee - integer fee per byte, in microAlgos. for a flat fee, set flatFee to true
- * flatFee - bool optionally set this to true to specify fee as microalgos-per-txn
- *       If true, txn fee may fall below the ALGORAND_MIN_TX_FEE
- * firstRound - integer first protocol round on which this txn is valid
- * lastRound - integer last protocol round on which this txn is valid
- * genesisHash - string specifies hash genesis block of network in use
- * genesisID - string specifies genesis ID of network in use
- * @param appIndex - the ID of the app to use
- * @param appArgs - Array of Uint8Array, any additional arguments to the application
- * @param accounts - Array of Address strings, any additional accounts to supply to the application
- * @param foreignApps - Array of int, any other apps used by the application, identified by index
- * @param foreignAssets - Array of int, any assets used by the application, identified by index
- * @param note - Arbitrary data for sender to store
- * @param lease - Lease a transaction
- * @param rekeyTo - String representation of the Algorand address that will be used to authorize all future transactions
- * @param boxes - Array of BoxReference, app ID and name of box to be accessed
+ *
+ * @param options - Application clear state transaction parameters
  */
-export function makeApplicationClearStateTxn(from, suggestedParams, appIndex, appArgs, accounts, foreignApps, foreignAssets, note, lease, rekeyTo, boxes) {
-    const o = {
-        type: TransactionType.appl,
-        from,
-        suggestedParams,
+export function makeApplicationClearStateTxnFromObject({ sender, appIndex, appArgs, accounts, foreignApps, foreignAssets, boxes, note, lease, rekeyTo, suggestedParams, }) {
+    if (!appIndex) {
+        throw Error('appIndex must be provided');
+    }
+    return makeApplicationCallTxnFromObject({
+        sender,
         appIndex,
-        appOnComplete: OnApplicationComplete.ClearStateOC,
+        onComplete: OnApplicationComplete.ClearStateOC,
         appArgs,
-        appAccounts: accounts,
-        appForeignApps: foreignApps,
-        appForeignAssets: foreignAssets,
+        accounts,
+        foreignApps,
+        foreignAssets,
         boxes,
         note,
         lease,
-        reKeyTo: rekeyTo,
-    };
-    return new txnBuilder.Transaction(o);
-}
-// helper for above makeApplicationClearStateTxn, instead accepting an argument object
-export function makeApplicationClearStateTxnFromObject(o) {
-    return makeApplicationClearStateTxn(o.from, o.suggestedParams, o.appIndex, o.appArgs, o.accounts, o.foreignApps, o.foreignAssets, o.note, o.lease, o.rekeyTo, o.boxes);
+        rekeyTo,
+        suggestedParams,
+    });
 }
 /**
  * Make a transaction that just calls an application, doing nothing on completion
- * @param from - address of sender
- * @param suggestedParams - a dict holding common-to-all-txns args:
- * fee - integer fee per byte, in microAlgos. for a flat fee, set flatFee to true
- * flatFee - bool optionally set this to true to specify fee as microalgos-per-txn
- *       If true, txn fee may fall below the ALGORAND_MIN_TX_FEE
- * firstRound - integer first protocol round on which this txn is valid
- * lastRound - integer last protocol round on which this txn is valid
- * genesisHash - string specifies hash genesis block of network in use
- * genesisID - string specifies genesis ID of network in use
- * @param appIndex - the ID of the app to use
- * @param appArgs - Array of Uint8Array, any additional arguments to the application
- * @param accounts - Array of Address strings, any additional accounts to supply to the application
- * @param foreignApps - Array of int, any other apps used by the application, identified by index
- * @param foreignAssets - Array of int, any assets used by the application, identified by index
- * @param note - Arbitrary data for sender to store
- * @param lease - Lease a transaction
- * @param rekeyTo - String representation of the Algorand address that will be used to authorize all future transactions
- * @param boxes - Array of BoxReference, app ID and name of box to be accessed
+ *
+ * @param options - Application no-op transaction parameters
  */
-export function makeApplicationNoOpTxn(from, suggestedParams, appIndex, appArgs, accounts, foreignApps, foreignAssets, note, lease, rekeyTo, boxes) {
-    const o = {
-        type: TransactionType.appl,
-        from,
-        suggestedParams,
+export function makeApplicationNoOpTxnFromObject({ sender, appIndex, appArgs, accounts, foreignApps, foreignAssets, boxes, note, lease, rekeyTo, suggestedParams, }) {
+    if (!appIndex) {
+        throw Error('appIndex must be provided');
+    }
+    return makeApplicationCallTxnFromObject({
+        sender,
         appIndex,
-        appOnComplete: OnApplicationComplete.NoOpOC,
+        onComplete: OnApplicationComplete.NoOpOC,
         appArgs,
-        appAccounts: accounts,
-        appForeignApps: foreignApps,
-        appForeignAssets: foreignAssets,
+        accounts,
+        foreignApps,
+        foreignAssets,
         boxes,
         note,
         lease,
-        reKeyTo: rekeyTo,
-    };
-    return new txnBuilder.Transaction(o);
-}
-// helper for above makeApplicationNoOpTxn, instead accepting an argument object
-export function makeApplicationNoOpTxnFromObject(o) {
-    return makeApplicationNoOpTxn(o.from, o.suggestedParams, o.appIndex, o.appArgs, o.accounts, o.foreignApps, o.foreignAssets, o.note, o.lease, o.rekeyTo, o.boxes);
-}
-export { OnApplicationComplete } from './types/transactions/base';
-/**
- * Generic function for creating any application call transaction.
- */
-export function makeApplicationCallTxnFromObject(options) {
-    const o = {
-        type: TransactionType.appl,
-        from: options.from,
-        suggestedParams: options.suggestedParams,
-        appIndex: options.appIndex,
-        appOnComplete: options.onComplete,
-        appLocalInts: options.numLocalInts,
-        appLocalByteSlices: options.numLocalByteSlices,
-        appGlobalInts: options.numGlobalInts,
-        appGlobalByteSlices: options.numGlobalByteSlices,
-        appApprovalProgram: options.approvalProgram,
-        appClearProgram: options.clearProgram,
-        appArgs: options.appArgs,
-        appAccounts: options.accounts,
-        appForeignApps: options.foreignApps,
-        appForeignAssets: options.foreignAssets,
-        boxes: options.boxes,
-        note: options.note,
-        lease: options.lease,
-        reKeyTo: options.rekeyTo,
-        extraPages: options.extraPages,
-    };
-    return new txnBuilder.Transaction(o);
+        rekeyTo,
+        suggestedParams,
+    });
 }
 //# sourceMappingURL=makeTxn.js.map