@algorandfoundation/algokit-utils 7.0.0-beta.1 → 7.0.0-beta.11

package/types/composer.js

@@ -3,11 +3,17 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var algosdk = require('algosdk');
+var config = require('../config.js');
 var transaction = require('../transaction/transaction.js');
+var types_app = require('./app.js');
+var types_appManager = require('./app-manager.js');
+var types_asyncEventEmitter = require('./async-event-emitter.js');
 var types_networkClient = require('./network-client.js');
 
+var AtomicTransactionComposer = algosdk.AtomicTransactionComposer;
 var isTransactionWithSigner = algosdk.isTransactionWithSigner;
 var encodeAddress = algosdk.encodeAddress;
+var modelsv2 = algosdk.modelsv2;
 const MAX_TRANSACTION_GROUP_SIZE = 16;
 /** AlgoKit Composer helps you compose and execute transactions as a transaction group. */
 class AlgoKitComposer {
@@ -32,6 +38,21 @@ class AlgoKitComposer {
         this.getSigner = params.getSigner;
         this.defaultValidityWindow = params.defaultValidityWindow ?? this.defaultValidityWindow;
         this.defaultValidityWindowIsExplicit = params.defaultValidityWindow !== undefined;
+        this.appManager = params.appManager ?? new types_appManager.AppManager(params.algod);
+    }
+    /**
+     * Add a pre-built transaction to the transaction group.
+     * @param transaction The pre-built transaction
+     * @param signer Optional signer override for the transaction
+     * @returns The composer so you can chain method calls
+     */
+    addTransaction(transaction, signer) {
+        this.txns.push({
+            txn: transaction,
+            signer: signer ?? this.getSigner(algosdk.encodeAddress(transaction.from.publicKey)),
+            type: 'txnWithSigner',
+        });
+        return this;
     }
     /**
      * Add a payment transaction to the transaction group.
@@ -105,9 +126,44 @@ class AlgoKitComposer {
         this.txns.push({ ...params, type: 'assetOptOut' });
         return this;
     }
+    /**
+     * Add an application create transaction to the transaction group.
+     *
+     * Note: we recommend using app clients to make it easier to make app calls.
+     * @param params The application create transaction parameters
+     * @returns The composer so you can chain method calls
+     */
+    addAppCreate(params) {
+        this.txns.push({ ...params, type: 'appCall' });
+        return this;
+    }
+    /**
+     * Add an application update transaction to the transaction group.
+     *
+     * Note: we recommend using app clients to make it easier to make app calls.
+     * @param params The application update transaction parameters
+     * @returns The composer so you can chain method calls
+     */
+    addAppUpdate(params) {
+        this.txns.push({ ...params, type: 'appCall', onComplete: algosdk.OnApplicationComplete.UpdateApplicationOC });
+        return this;
+    }
+    /**
+     * Add an application delete transaction to the transaction group.
+     *
+     * Note: we recommend using app clients to make it easier to make app calls.
+     * @param params The application delete transaction parameters
+     * @returns The composer so you can chain method calls
+     */
+    addAppDelete(params) {
+        this.txns.push({ ...params, type: 'appCall', onComplete: algosdk.OnApplicationComplete.DeleteApplicationOC });
+        return this;
+    }
     /**
      * Add an application call transaction to the transaction group.
      *
+     * If you want to create or update an app use `addAppCreate` or `addAppUpdate`.
+     *
      * Note: we recommend using app clients to make it easier to make app calls.
      * @param params The application call transaction parameters
      * @returns The composer so you can chain method calls
@@ -117,13 +173,46 @@ class AlgoKitComposer {
         return this;
     }
     /**
-     * Add an ABI method application call transaction to the transaction group.
+     * Add an ABI method create application call transaction to the transaction group.
+     *
+     * Note: we recommend using app clients to make it easier to make app calls.
+     * @param params The ABI create method application call transaction parameters
+     * @returns The composer so you can chain method calls
+     */
+    addAppCreateMethodCall(params) {
+        this.txns.push({ ...params, type: 'methodCall' });
+        return this;
+    }
+    /**
+     * Add an ABI method update application call transaction to the transaction group.
+     *
+     * Note: we recommend using app clients to make it easier to make app calls.
+     * @param params The ABI update method application call transaction parameters
+     * @returns The composer so you can chain method calls
+     */
+    addAppUpdateMethodCall(params) {
+        this.txns.push({ ...params, type: 'methodCall', onComplete: algosdk.OnApplicationComplete.UpdateApplicationOC });
+        return this;
+    }
+    /**
+     * Add an ABI method delete application call transaction to the transaction group.
+     *
+     * Note: we recommend using app clients to make it easier to make app calls.
+     * @param params The ABI delete method application call transaction parameters
+     * @returns The composer so you can chain method calls
+     */
+    addAppDeleteMethodCall(params) {
+        this.txns.push({ ...params, type: 'methodCall', onComplete: algosdk.OnApplicationComplete.DeleteApplicationOC });
+        return this;
+    }
+    /**
+     * Add a non-create/non-update ABI method application call transaction to the transaction group.
      *
      * Note: we recommend using app clients to make it easier to make app calls.
      * @param params The ABI method application call transaction parameters
      * @returns The composer so you can chain method calls
      */
-    addMethodCall(params) {
+    addAppCallMethodCall(params) {
         this.txns.push({ ...params, type: 'methodCall' });
         return this;
     }
@@ -145,15 +234,20 @@ class AlgoKitComposer {
         this.txns.push({ atc, type: 'atc' });
         return this;
     }
-    buildAtc(atc) {
+    /** Build an ATC and return transactions ready to be incorporated into a broader set of transactions this composer is composing */
+    buildAtc(atc, processTransaction) {
         const group = atc.buildGroup();
-        const txnWithSigners = group.map((ts) => {
+        const txnWithSigners = group.map((ts, idx) => {
+            // Remove underlying group ID from the transaction since it will be re-grouped when this AlgoKitComposer is built
             ts.txn.group = undefined;
+            // Process transaction if a function is provided
+            ts.txn = processTransaction?.(ts.txn, idx) ?? ts.txn;
+            // If this was a method call stash the ABIMethod for later
+            if (atc['methodCalls'].get(idx)) {
+                this.txnMethodMap.set(ts.txn.txID(), atc['methodCalls'].get(idx));
+            }
             return ts;
         });
-        const method = atc['methodCalls'].get(group.length - 1);
-        if (method)
-            this.txnMethodMap.set(txnWithSigners.at(-1).txn.txID(), method);
         return txnWithSigners;
     }
     commonTxnBuildStep(params, txn, suggestedParams) {
@@ -161,8 +255,9 @@ class AlgoKitComposer {
             txn.addLease(transaction.encodeLease(params.lease));
         if (params.rekeyTo)
             txn.addRekey(params.rekeyTo);
+        const encoder = new TextEncoder();
         if (params.note)
-            txn.note = transaction.encodeTransactionNote(params.note);
+            txn.note = typeof params.note === 'string' ? encoder.encode(params.note) : params.note;
         if (params.firstValidRound) {
             txn.firstRound = Number(params.firstValidRound);
         }
@@ -180,27 +275,36 @@ class AlgoKitComposer {
             throw Error('Cannot set both staticFee and extraFee');
         }
         if (params.staticFee !== undefined) {
-            txn.fee = params.staticFee.microAlgo;
+            txn.fee = Number(params.staticFee.microAlgo);
         }
         else {
             txn.fee = txn.estimateSize() * suggestedParams.fee || algosdk.ALGORAND_MIN_TX_FEE;
             if (params.extraFee)
-                txn.fee += params.extraFee.microAlgo;
+                txn.fee += Number(params.extraFee.microAlgo);
         }
         txn.flatFee = true;
         if (params.maxFee !== undefined && txn.fee > params.maxFee.microAlgo) {
-            throw Error(`Transaction fee ${txn.fee} is greater than maxFee ${params.maxFee}`);
+            throw Error(`Transaction fee ${txn.fee} µALGO is greater than maxFee ${params.maxFee}`);
         }
         return txn;
     }
+    /**
+     * Builds an ABI method call transaction and any other associated transactions represented in the ABI args.
+     * @param includeSigner Whether to include the actual signer for the transactions.
+     *  If you are just building transactions without signers yet then set this to `false`.
+     */
     async buildMethodCall(params, suggestedParams, includeSigner) {
         const methodArgs = [];
         const isAbiValue = (x) => {
             if (Array.isArray(x))
                 return x.length == 0 || x.every(isAbiValue);
-            return ['boolean', 'number', 'bigint', 'string', 'Uint8Array'].includes(typeof x);
+            return typeof x === 'bigint' || typeof x === 'boolean' || typeof x === 'number' || typeof x === 'string' || x instanceof Uint8Array;
         };
-        for (const arg of params.args ?? []) {
+        for (let i = 0; i < (params.args ?? []).length; i++) {
+            const arg = params.args[i];
+            if (arg === undefined) {
+                throw Error(`No value provided for argument ${i + 1} within call to ${params.method.name}`);
+            }
             if (isAbiValue(arg)) {
                 methodArgs.push(arg);
                 continue;
@@ -223,39 +327,60 @@ class AlgoKitComposer {
                             ? params.signer.signer
                             : params.signer
                         : this.getSigner(encodeAddress(txn.from.publicKey))
-                    : algosdk.makeEmptyTransactionSigner(),
+                    : AlgoKitComposer.NULL_SIGNER,
             });
         }
         const methodAtc = new algosdk.AtomicTransactionComposer();
-        const appID = Number(params.appId || 0);
+        const appId = Number('appId' in params ? params.appId : 0n);
+        const approvalProgram = 'approvalProgram' in params
+            ? typeof params.approvalProgram === 'string'
+                ? (await this.appManager.compileTeal(params.approvalProgram)).compiledBase64ToBytes
+                : params.approvalProgram
+            : undefined;
+        const clearStateProgram = 'clearStateProgram' in params
+            ? typeof params.clearStateProgram === 'string'
+                ? (await this.appManager.compileTeal(params.clearStateProgram)).compiledBase64ToBytes
+                : params.clearStateProgram
+            : undefined;
         methodAtc.addMethodCall({
-            appID,
+            appID: appId,
             sender: params.sender,
             suggestedParams,
-            onComplete: params.onComplete,
+            onComplete: params.onComplete ?? algosdk.OnApplicationComplete.NoOpOC,
             appAccounts: params.accountReferences,
             appForeignApps: params.appReferences?.map((x) => Number(x)),
             appForeignAssets: params.assetReferences?.map((x) => Number(x)),
-            approvalProgram: params.approvalProgram,
-            clearProgram: params.clearProgram,
-            extraPages: params.extraPages,
-            numLocalInts: params.schema?.localUints || (appID === 0 ? 0 : undefined),
-            numLocalByteSlices: params.schema?.localByteSlices || (appID === 0 ? 0 : undefined),
-            numGlobalInts: params.schema?.globalUints || (appID === 0 ? 0 : undefined),
-            numGlobalByteSlices: params.schema?.globalByteSlices || (appID === 0 ? 0 : undefined),
+            boxes: params.boxReferences?.map(types_appManager.AppManager.getBoxReference),
+            approvalProgram,
+            clearProgram: clearStateProgram,
+            extraPages: appId === 0
+                ? 'extraProgramPages' in params && params.extraProgramPages !== undefined
+                    ? params.extraProgramPages
+                    : approvalProgram
+                        ? Math.floor((approvalProgram.length + (clearStateProgram?.length ?? 0)) / types_app.APP_PAGE_MAX_SIZE)
+                        : 0
+                : undefined,
+            numLocalInts: appId === 0 ? ('schema' in params ? params.schema?.localInts ?? 0 : 0) : undefined,
+            numLocalByteSlices: appId === 0 ? ('schema' in params ? params.schema?.localByteSlices ?? 0 : 0) : undefined,
+            numGlobalInts: appId === 0 ? ('schema' in params ? params.schema?.globalInts ?? 0 : 0) : undefined,
+            numGlobalByteSlices: appId === 0 ? ('schema' in params ? params.schema?.globalByteSlices ?? 0 : 0) : undefined,
             method: params.method,
-            signer: params.signer ? ('signer' in params.signer ? params.signer.signer : params.signer) : this.getSigner(params.sender),
+            signer: includeSigner
+                ? params.signer
+                    ? 'signer' in params.signer
+                        ? params.signer.signer
+                        : params.signer
+                    : this.getSigner(params.sender)
+                : AlgoKitComposer.NULL_SIGNER,
             methodArgs: methodArgs,
             // note, lease, and rekeyTo are set in the common build step
             note: undefined,
             lease: undefined,
             rekeyTo: undefined,
         });
-        // Run the actual method call txn through the common build step to set fees and validity rounds
-        const group = methodAtc.buildGroup();
-        const methodIdx = group.length - 1;
-        group[methodIdx].txn = this.commonTxnBuildStep(params, group[methodIdx].txn, suggestedParams);
-        return this.buildAtc(methodAtc);
+        // Process the ATC to get a set of transactions ready for broader grouping
+        //  and with the common build step to set fees and validity rounds
+        return this.buildAtc(methodAtc, (txn, idx) => idx === methodAtc.count() - 1 ? this.commonTxnBuildStep(params, txn, suggestedParams) : txn);
     }
     buildPayment(params, suggestedParams) {
         const txn = algosdk.makePaymentTxnWithSuggestedParamsFromObject({
@@ -328,57 +453,66 @@ class AlgoKitComposer {
         });
         return this.commonTxnBuildStep(params, txn, suggestedParams);
     }
-    buildAppCall(params, suggestedParams) {
+    async buildAppCall(params, suggestedParams) {
+        const appId = Number('appId' in params ? params.appId : 0n);
+        const approvalProgram = 'approvalProgram' in params
+            ? typeof params.approvalProgram === 'string'
+                ? (await this.appManager.compileTeal(params.approvalProgram)).compiledBase64ToBytes
+                : params.approvalProgram
+            : undefined;
+        const clearStateProgram = 'clearStateProgram' in params
+            ? typeof params.clearStateProgram === 'string'
+                ? (await this.appManager.compileTeal(params.clearStateProgram)).compiledBase64ToBytes
+                : params.clearStateProgram
+            : undefined;
         const sdkParams = {
             from: params.sender,
             suggestedParams,
-            onComplete: params.onComplete,
-            approvalProgram: params.approvalProgram,
-            clearProgram: params.clearProgram,
             appArgs: params.args,
+            onComplete: params.onComplete ?? algosdk.OnApplicationComplete.NoOpOC,
             accounts: params.accountReferences,
             foreignApps: params.appReferences?.map((x) => Number(x)),
             foreignAssets: params.assetReferences?.map((x) => Number(x)),
-            extraPages: params.extraPages,
-            numLocalInts: params.schema?.localUints || 0,
-            numLocalByteSlices: params.schema?.localByteSlices || 0,
-            numGlobalInts: params.schema?.globalUints || 0,
-            numGlobalByteSlices: params.schema?.globalByteSlices || 0,
+            boxes: params.boxReferences?.map(types_appManager.AppManager.getBoxReference),
+            approvalProgram,
+            clearProgram: clearStateProgram,
         };
         let txn;
-        const onComplete = params.onComplete || algosdk.OnApplicationComplete.NoOpOC;
-        if (!params.appId) {
-            if (params.approvalProgram === undefined || params.clearProgram === undefined) {
-                throw new Error('approvalProgram and clearProgram are required for application creation');
+        if (appId === 0) {
+            if (sdkParams.approvalProgram === undefined || sdkParams.clearProgram === undefined) {
+                throw new Error('approvalProgram and clearStateProgram are required for application creation');
             }
             txn = algosdk.makeApplicationCreateTxnFromObject({
                 ...sdkParams,
-                onComplete,
-                approvalProgram: params.approvalProgram,
-                clearProgram: params.clearProgram,
+                extraPages: 'extraProgramPages' in params
+                    ? params.extraProgramPages ?? Math.floor((approvalProgram.length + clearStateProgram.length) / types_app.APP_PAGE_MAX_SIZE)
+                    : 0,
+                numLocalInts: 'schema' in params ? params.schema?.localInts ?? 0 : 0,
+                numLocalByteSlices: 'schema' in params ? params.schema?.localByteSlices ?? 0 : 0,
+                numGlobalInts: 'schema' in params ? params.schema?.globalInts ?? 0 : 0,
+                numGlobalByteSlices: 'schema' in params ? params.schema?.globalByteSlices ?? 0 : 0,
+                approvalProgram: approvalProgram,
+                clearProgram: clearStateProgram,
             });
         }
-        txn = algosdk.makeApplicationCallTxnFromObject({ ...sdkParams, onComplete, appIndex: Number(params.appId || 0) });
+        else {
+            txn = algosdk.makeApplicationCallTxnFromObject({ ...sdkParams, appIndex: appId });
+        }
         return this.commonTxnBuildStep(params, txn, suggestedParams);
     }
     buildKeyReg(params, suggestedParams) {
         const txn = algosdk.makeKeyRegistrationTxnWithSuggestedParams(params.sender, undefined, params.voteKey, params.selectionKey, Number(params.voteFirst), Number(params.voteLast), Number(params.voteKeyDilution), suggestedParams, undefined, false, params.stateProofKey);
         return this.commonTxnBuildStep(params, txn, suggestedParams);
     }
+    /** Builds all transaction types apart from `txnWithSigner`, `atc` and `methodCall` since those ones can have custom signers that need to be retrieved. */
     async buildTxn(txn, suggestedParams) {
         switch (txn.type) {
-            case 'txnWithSigner':
-                return [txn.txn];
-            case 'atc':
-                return txn.atc.buildGroup().map((ts) => ts.txn);
-            case 'methodCall':
-                return (await this.buildMethodCall(txn, suggestedParams, false)).map((ts) => ts.txn);
             case 'pay':
                 return [this.buildPayment(txn, suggestedParams)];
             case 'assetCreate':
                 return [this.buildAssetCreate(txn, suggestedParams)];
             case 'appCall':
-                return [this.buildAppCall(txn, suggestedParams)];
+                return [await this.buildAppCall(txn, suggestedParams)];
             case 'assetConfig':
                 return [this.buildAssetConfig(txn, suggestedParams)];
             case 'assetDestroy':
@@ -411,43 +545,77 @@ class AlgoKitComposer {
         return (await this.buildTxn(txn, suggestedParams)).map((txn) => ({ txn, signer }));
     }
     /**
-     * Compose all of the transactions without signers and return the transaction objects directly.
+     * Compose all of the transactions without signers and return the transaction objects directly along with any ABI method calls.
      *
-     * @returns The array of built transactions
+     * @returns The array of built transactions and any corresponding method calls
      */
     async buildTransactions() {
         const suggestedParams = await this.getSuggestedParams();
         const transactions = [];
+        const methodCalls = new Map();
+        const signers = new Map();
         for (const txn of this.txns) {
-            transactions.push(...(await this.buildTxn(txn, suggestedParams)));
+            if (!['txnWithSigner', 'atc', 'methodCall'].includes(txn.type)) {
+                transactions.push(...(await this.buildTxn(txn, suggestedParams)));
+            }
+            else {
+                const transactionsWithSigner = txn.type === 'txnWithSigner'
+                    ? [txn]
+                    : txn.type === 'atc'
+                        ? this.buildAtc(txn.atc)
+                        : txn.type === 'methodCall'
+                            ? await this.buildMethodCall(txn, suggestedParams, false)
+                            : [];
+                transactions.push(...transactionsWithSigner.map((ts) => ts.txn));
+                transactionsWithSigner.forEach((ts, idx) => {
+                    if (ts.signer && ts.signer !== AlgoKitComposer.NULL_SIGNER) {
+                        signers.set(idx, ts.signer);
+                    }
+                });
+            }
         }
-        return transactions;
+        for (let i = 0; i < transactions.length; i++) {
+            const method = this.txnMethodMap.get(transactions[i].txID());
+            if (method)
+                methodCalls.set(i, method);
+        }
+        return { transactions, methodCalls, signers };
+    }
+    /**
+     * Get the number of transactions currently added to this composer.
+     */
+    async count() {
+        return (await this.buildTransactions()).transactions.length;
     }
     /**
      * Compose all of the transactions in a single atomic transaction group and an atomic transaction composer.
      *
      * You can then use the transactions standalone, or use the composer to execute or simulate the transactions.
+     *
+     * Once this method is called, no further transactions will be able to be added.
+     * You can safely call this method multiple times to get the same result.
      * @returns The built atomic transaction composer and the transactions
      */
     async build() {
         if (this.atc.getStatus() === algosdk.AtomicTransactionComposerStatus.BUILDING) {
             const suggestedParams = await this.getSuggestedParams();
+            // Build all of the transactions
             const txnWithSigners = [];
             for (const txn of this.txns) {
                 txnWithSigners.push(...(await this.buildTxnWithSigner(txn, suggestedParams)));
             }
-            txnWithSigners.forEach((ts) => {
-                this.atc.addTransaction(ts);
-            });
+            // Add all of the transactions to the underlying ATC
             const methodCalls = new Map();
             txnWithSigners.forEach((ts, idx) => {
+                this.atc.addTransaction(ts);
+                // Populate consolidated set of all ABI method calls
                 const method = this.txnMethodMap.get(ts.txn.txID());
                 if (method)
                     methodCalls.set(idx, method);
             });
             this.atc['methodCalls'] = methodCalls;
         }
-        return { atc: this.atc, transactions: this.atc.buildGroup() };
+        return { atc: this.atc, transactions: this.atc.buildGroup(), methodCalls: this.atc['methodCalls'] };
     }
     /**
      * Rebuild the group, discarding any previously built transactions.
@@ -459,11 +627,11 @@ class AlgoKitComposer {
         return await this.build();
     }
     /**
-     * Compose the atomic transaction group and send it to the network
+     * Compose the atomic transaction group and send it to the network.
      * @param params The parameters to control execution with
      * @returns The execution result
      */
-    async execute(params) {
+    async send(params) {
         const group = (await this.build()).transactions;
         let waitRounds = params?.maxRoundsToWaitForConfirmation;
         if (waitRounds === undefined) {
@@ -473,10 +641,97 @@ class AlgoKitComposer {
         }
         return await transaction.sendAtomicTransactionComposer({
             atc: this.atc,
-            sendParams: { suppressLog: params?.suppressLog, maxRoundsToWaitForConfirmation: waitRounds },
+            suppressLog: params?.suppressLog,
+            maxRoundsToWaitForConfirmation: waitRounds,
+            populateAppCallResources: params?.populateAppCallResources,
         }, this.algod);
     }
+    /**
+     * @deprecated Use `send` instead.
+     *
+     * Compose the atomic transaction group and send it to the network
+     *
+     * An alias for `composer.send(params)`.
+     * @param params The parameters to control execution with
+     * @returns The execution result
+     */
+    async execute(params) {
+        return this.send(params);
+    }
+    /**
+     * Compose the atomic transaction group and simulate sending it to the network
+     * @returns The simulation result
+     */
+    async simulate(options) {
+        const atc = options?.skipSignatures ? new AtomicTransactionComposer() : this.atc;
+        // Build the transactions
+        if (options?.skipSignatures) {
+            options.allowEmptySignatures = true;
+            // Build transactions uses empty signers
+            const transactions = await this.buildTransactions();
+            for (const txn of transactions.transactions) {
+                atc.addTransaction({ txn, signer: AlgoKitComposer.NULL_SIGNER });
+            }
+            atc['methodCalls'] = transactions.methodCalls;
+        }
+        else {
+            // Build creates real signatures
+            await this.build();
+        }
+        const { methodResults, simulateResponse } = await atc.simulate(this.algod, new modelsv2.SimulateRequest({
+            txnGroups: [],
+            ...options,
+            ...(config.Config.debug
+                ? {
+                    allowEmptySignatures: true,
+                    allowMoreLogging: true,
+                    execTraceConfig: new modelsv2.SimulateTraceConfig({
+                        enable: true,
+                        scratchChange: true,
+                        stackChange: true,
+                        stateChange: true,
+                    }),
+                }
+                : undefined),
+        }));
+        const failedGroup = simulateResponse?.txnGroups[0];
+        if (failedGroup?.failureMessage) {
+            const errorMessage = `Transaction failed at transaction(s) ${failedGroup.failedAt?.join(', ') || 'unknown'} in the group. ${failedGroup.failureMessage}`;
+            const error = new Error(errorMessage);
+            if (config.Config.debug) {
+                await config.Config.events.emitAsync(types_asyncEventEmitter.EventType.TxnGroupSimulated, { simulateResponse });
+            }
+            error.simulateResponse = simulateResponse;
+            throw error;
+        }
+        if (config.Config.debug && config.Config.traceAll) {
+            await config.Config.events.emitAsync(types_asyncEventEmitter.EventType.TxnGroupSimulated, { simulateResponse });
+        }
+        const transactions = atc.buildGroup().map((t) => t.txn);
+        return {
+            confirmations: simulateResponse.txnGroups[0].txnResults.map((t) => t.txnResult),
+            transactions: transactions,
+            txIds: transactions.map((t) => t.txID()),
+            groupId: Buffer.from(transactions[0].group ?? new Uint8Array()).toString('base64'),
+            simulateResponse,
+            returns: methodResults.map(transaction.getABIReturnValue),
+        };
+    }
+    /**
+     * Create an encoded transaction note that follows the ARC-2 spec.
+     *
+     * https://github.com/algorandfoundation/ARCs/blob/main/ARCs/arc-0002.md
+     * @param note The ARC-2 transaction note data
+     * @returns The binary encoded transaction note
+     */
+    static arc2Note(note) {
+        const arc2Payload = `${note.dAppName}:${note.format}${typeof note.data === 'string' ? note.data : JSON.stringify(note.data)}`;
+        const encoder = new TextEncoder();
+        return encoder.encode(arc2Payload);
+    }
 }
+/** Signer used to represent a lack of signer */
+AlgoKitComposer.NULL_SIGNER = algosdk.makeEmptyTransactionSigner();
 
 exports.MAX_TRANSACTION_GROUP_SIZE = MAX_TRANSACTION_GROUP_SIZE;
 exports.default = AlgoKitComposer;