@algorandfoundation/algokit-utils 0.1.0 → 1.0.0-beta.2

package/dist/network-client.js

@@ -0,0 +1,182 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLocalNet = exports.getAlgoKmdClient = exports.getAlgoIndexerClient = exports.getAlgoClient = exports.getDefaultLocalNetConfig = exports.getAlgoNodeConfig = exports.getIndexerConfigFromEnvironment = exports.getAlgodConfigFromEnvironment = void 0;
+const algosdk_1 = __importStar(require("algosdk"));
+const algo_http_client_with_retry_1 = require("./algo-http-client-with-retry");
+/** Retrieve the algod configuration from environment variables (expects to be called from a Node.js environment not algod-side) */
+function getAlgodConfigFromEnvironment() {
+    if (!process || !process.env) {
+        throw new Error('Attempt to get default algod configuration from a non Node.js context; supply the config instead');
+    }
+    if (!process.env.ALGOD_SERVER) {
+        throw new Error('Attempt to get default algod configuration without specifying ALGOD_SERVER in the environment variables');
+    }
+    return {
+        server: process.env.ALGOD_SERVER,
+        port: process.env.ALGOD_PORT,
+        token: process.env.ALGOD_TOKEN,
+    };
+}
+exports.getAlgodConfigFromEnvironment = getAlgodConfigFromEnvironment;
+/** Retrieve the indexer configuration from environment variables (expects to be called from a Node.js environment not algod-side) */
+function getIndexerConfigFromEnvironment() {
+    if (!process || !process.env) {
+        throw new Error('Attempt to get default indexer configuration from a non Node.js context; supply the config instead');
+    }
+    if (!process.env.INDEXER_SERVER) {
+        throw new Error('Attempt to get default indexer configuration without specifying INDEXER_SERVER in the environment variables');
+    }
+    return {
+        server: process.env.INDEXER_SERVER,
+        port: process.env.INDEXER_PORT,
+        token: process.env.INDEXER_TOKEN,
+    };
+}
+exports.getIndexerConfigFromEnvironment = getIndexerConfigFromEnvironment;
+/** Returns the Algorand configuration to point to the AlgoNode service
+ *
+ * @param network Which network to connect to - TestNet or MainNet
+ * @param config Which algod config to return - Algod or Indexer
+ */
+function getAlgoNodeConfig(network, config) {
+    return {
+        server: `https://${network}-${config === 'algod' ? 'api' : 'idx'}.algonode.cloud/`,
+        port: 443,
+    };
+}
+exports.getAlgoNodeConfig = getAlgoNodeConfig;
+/** Returns the Algorand configuration to point to the default LocalNet
+ *
+ * @param configOrPort Which algod config to return - algod, kmd, or indexer OR a port number
+ */
+function getDefaultLocalNetConfig(configOrPort) {
+    return {
+        server: `http://localhost`,
+        port: configOrPort === 'algod' ? 4001 : configOrPort === 'indexer' ? 8980 : configOrPort === 'kmd' ? 4002 : configOrPort,
+        token: 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',
+    };
+}
+exports.getDefaultLocalNetConfig = getDefaultLocalNetConfig;
+function getAlgoTokenHeader(server, token, defaultHeader) {
+    // Purestake uses a slightly different API key header than the default
+    if (server.includes('purestake.io') && typeof token === 'string')
+        return { 'X-API-Key': token };
+    // Because we override the default HTTP Client construction (to get retries) we need to put a string token into the standard header ourselves
+    return typeof token === 'string' ? { [defaultHeader ?? 'X-Algo-API-Token']: token } : token ?? {};
+}
+/** Returns an algod SDK client that automatically retries on idempotent calls
+ *
+ * @param config The config if you want to override the default (getting config from process.env)
+ * @example Default (load from environment variables)
+ *
+ *  ```
+ *  // Uses process.env.ALGOD_SERVER, process.env.ALGOD_PORT and process.env.ALGOD_TOKEN
+ *  // Automatically detects if you are using PureStake to switch in the right header name for ALGOD_TOKEN
+ *  const algod = getAlgoClient()
+ *  await algod.healthCheck().do()
+ *  ```
+ * @example AlgoNode (testnet)
+ * ```
+ *  const algod = getAlgoClient(getAlgoNodeConfig('testnet', 'algod'))
+ *  await algod.healthCheck().do()
+ * ```
+ * @example AlgoNode (mainnet)
+ * ```
+ *  const algod = getAlgoClient(getAlgoNodeConfig('mainnet', 'algod'))
+ *  await algod.healthCheck().do()
+ * ```
+ * @example Custom (e.g. default local sandbox, although we recommend loading this into a .env and using the Default option instead)
+ * ```
+ *  const algod = getAlgoClient({server: 'http://localhost', port: '4001', token: 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'})
+ *  await algod.healthCheck().do()
+ * ```
+ */
+function getAlgoClient(config) {
+    const { token, server, port } = config ?? getAlgodConfigFromEnvironment();
+    const httpClientWithRetry = new algo_http_client_with_retry_1.AlgoHttpClientWithRetry(getAlgoTokenHeader(server, token), server, port);
+    return new algosdk_1.default.Algodv2(httpClientWithRetry, server);
+}
+exports.getAlgoClient = getAlgoClient;
+/** Returns an indexer SDK client that automatically retries on idempotent calls
+ *
+ * @param config The config if you want to override the default (getting config from process.env)
+ * @example Default (load from environment variables)
+ *
+ *  ```
+ *  // Uses process.env.INDEXER_SERVER, process.env.INDEXER_PORT and process.env.INDEXER_TOKEN
+ *  // Automatically detects if you are using PureStake to switch in the right header name for INDEXER_TOKEN
+ *  const indexer = getAlgoIndexerClient()
+ *  await indexer.makeHealthCheck().do()
+ *  ```
+ * @example AlgoNode (testnet)
+ * ```
+ *  const indexer = getAlgoIndexerClient(getAlgoNodeConfig('testnet', 'indexer'))
+ *  await indexer.makeHealthCheck().do()
+ * ```
+ * @example AlgoNode (mainnet)
+ * ```
+ *  const indexer = getAlgoIndexerClient(getAlgoNodeConfig('mainnet', 'indexer'))
+ *  await indexer.makeHealthCheck().do()
+ * ```
+ * @example Custom (e.g. default local sandbox, although we recommend loading this into a .env and using the Default option instead)
+ * ```
+ *  const indexer = getAlgoIndexerClient({server: 'http://localhost', port: '8980', token: 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'})
+ *  await indexer.makeHealthCheck().do()
+ * ```
+ */
+function getAlgoIndexerClient(config) {
+    const { token, server, port } = config ?? getIndexerConfigFromEnvironment();
+    const httpClientWithRetry = new algo_http_client_with_retry_1.AlgoHttpClientWithRetry(getAlgoTokenHeader(server, token, 'X-Indexer-API-Token'), server, port);
+    return new algosdk_1.Indexer(httpClientWithRetry);
+}
+exports.getAlgoIndexerClient = getAlgoIndexerClient;
+/**
+ * Returns a KMD SDK client that automatically retries on idempotent calls
+ *
+ * KMD client allows you to export private keys, which is useful to get the default account in a sandbox network.
+ *
+ * @param config The config if you want to override the default (getting config from process.env)
+ * @example Default (load from environment variables)
+ *
+ *  ```
+ *  // Uses process.env.ALGOD_SERVER, process.env.KMD_PORT (or if not specified: port 4002) and process.env.ALGOD_TOKEN
+ *  const kmd = getAlgoKmdClient()
+ *  ```
+ * @example Custom (e.g. default local sandbox, although we recommend loading this into a .env and using the Default option instead)
+ * ```
+ *  const kmd = getAlgoKmdClient({server: 'http://localhost', port: '4002', token: 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'})
+ * ```
+ */
+function getAlgoKmdClient(config) {
+    const { token, server } = config ?? getAlgodConfigFromEnvironment();
+    // We can only use Kmd on the Sandbox otherwise it's not exposed so this makes some assumptions
+    // (e.g. same token and server as algod and port 4002 by default)
+    return new algosdk_1.Kmd(token, server, process?.env?.KMD_PORT ?? '4002');
+}
+exports.getAlgoKmdClient = getAlgoKmdClient;
+var localnet_1 = require("./localnet");
+Object.defineProperty(exports, "isLocalNet", { enumerable: true, get: function () { return localnet_1.isLocalNet; } });
+//# sourceMappingURL=network-client.js.map

package/dist/network-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-client.js","sourceRoot":"","sources":["../src/network-client.ts"],"names":[],"mappings":"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"}

package/dist/package.json

@@ -0,0 +1,20 @@
+{
+  "main": "index.js",
+  "types": "index.d.ts",
+  "name": "@algorandfoundation/algokit-utils",
+  "version": "0.1.0",
+  "private": false,
+  "description": "A set of core Algorand utilities written in TypeScript and released via npm that make it easier to build solutions on Algorand.",
+  "author": "Algorand Foundation",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.0"
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "dependencies": {
+    "algosdk": "^2.1.0",
+    "buffer": "^6.0.3"
+  }
+}

package/dist/transaction.d.ts

@@ -0,0 +1,147 @@
+import algosdk, { Account, Algodv2, LogicSigAccount, MultisigMetadata, SuggestedParams, Transaction } from 'algosdk';
+import { AlgoAmount } from './algo-amount';
+import { PendingTransactionResponse } from './algod-type';
+/** Account wrapper that supports partial or full multisig signing */
+export declare class MultisigAccount {
+    _params: algosdk.MultisigMetadata;
+    _signingAccounts: (algosdk.Account | SigningAccount)[];
+    _addr: string;
+    get params(): Readonly<algosdk.MultisigMetadata>;
+    get signingAccounts(): Readonly<(algosdk.Account | SigningAccount)[]>;
+    get addr(): Readonly<string>;
+    constructor(multisigParams: MultisigMetadata, signingAccounts: (Account | SigningAccount)[]);
+    sign(transaction: Transaction | Uint8Array): Uint8Array;
+}
+/** Account wrapper that supports a rekeyed account */
+export declare class SigningAccount implements Account {
+    private _account;
+    private _sender;
+    /**
+     * Algorand address of the sender
+     */
+    get addr(): Readonly<string>;
+    /**
+     * Secret key belonging to the signer
+     */
+    get sk(): Readonly<Uint8Array>;
+    /**
+     * Algorand account of the underlying signing account
+     */
+    get signer(): Account;
+    /**
+     * Algorand account of the sender address and signer private key
+     */
+    get sender(): Account;
+    constructor(account: Account, sender: string | undefined);
+}
+export type TransactionNote = Uint8Array | TransactionNoteData | Arc2TransactionNote;
+export type TransactionNoteData = string | null | undefined | number | any[] | Record<string, any>;
+/** ARC-0002 compatible transaction note components, @see https://github.com/algorandfoundation/ARCs/blob/main/ARCs/arc-0002.md */
+export type Arc2TransactionNote = {
+    dAppName: string;
+    format: 'm' | 'j' | 'b' | 'u';
+    data: string;
+};
+/** Encodes a transaction note into a byte array ready to be included in an Algorand transaction.
+ *
+ * @param note The transaction note
+ * @returns the transaction note ready for inclusion in a transaction
+ *
+ *  Case on the value of `data` this either either be:
+ *   * `null` | `undefined`: `undefined`
+ *   * `string`: The string value
+ *   * Uint8Array: passthrough
+ *   * Arc2TransactionNote object: ARC-0002 compatible transaction note
+ *   * Else: The object/value converted into a JSON string representation
+ */
+export declare function encodeTransactionNote(note?: TransactionNote): Uint8Array | undefined;
+/** The sending configuration for a transaction */
+export interface SendTransactionParams {
+    /** Whether to skip signing and sending the transaction to the chain (default: transaction signed and sent to chain)
+     *   (and instead just return the raw transaction, e.g. so you can add it to a group of transactions) */
+    skipSending?: boolean;
+    /** Whether to skip waiting for the submitted transaction (only relevant if `skipSending` is `false` or unset) */
+    skipWaiting?: boolean;
+    /** Whether to suppress log messages from transaction send, default: do not suppress */
+    suppressLog?: boolean;
+    /** The maximum fee that you are happy to pay (default: unbounded) - if this is set it's possible the transaction could get rejected during network congestion */
+    maxFee?: AlgoAmount;
+    /** The maximum number of rounds to wait for confirmation, only applies if `skipWaiting` is `undefined` or `false`, default: wait up to 5 rounds */
+    maxRoundsToWaitForConfirmation?: number;
+}
+/** The result of sending a transaction */
+export interface SendTransactionResult {
+    /** The transaction */
+    transaction: Transaction;
+    /** The response if the transaction was sent and waited for */
+    confirmation?: PendingTransactionResponse;
+}
+export type SendTransactionFrom = Account | SigningAccount | LogicSigAccount | MultisigAccount;
+/**
+ * Returns the public address of the given transaction sender.
+ * @param sender A transaction sender
+ * @returns The public address
+ */
+export declare const getSenderAddress: (sender: SendTransactionFrom) => string;
+/** Signs and sends the given transaction to the chain
+ *
+ * @param algod An algod client
+ * @param transaction The unsigned transaction
+ * @param from The account to sign the transaction with: either an account with private key loaded or a logic signature account
+ * @param config The sending configuration for this transaction
+ *
+ * @returns An object with transaction (`transaction`) and (if `skipWaiting` is `false` or unset) confirmation (`confirmation`)
+ */
+export declare const sendTransaction: (algod: Algodv2, transaction: Transaction, from: SendTransactionFrom, sendParams?: SendTransactionParams) => Promise<SendTransactionResult>;
+/** Defines an unsigned transaction that will appear in a group of transactions along with its signing information */
+export interface TransactionToSign {
+    /** The unsigned transaction to sign and send */
+    transaction: Transaction;
+    /** The account to use to sign the transaction, either an account (with private key loaded) or a logic signature account */
+    signer: SendTransactionFrom;
+}
+/**
+ * Signs and sends a group of [up to 16](https://developer.algorand.org/docs/get-details/atomic_transfers/#create-transactions) transactions to the chain
+ *
+ * @param groupSend The group details to send, with:
+ *   * `transactions`: The array of transactions to send along with their signing account
+ *   * `sendParams`: The parameters to dictate how the group is sent
+ * @param algod An algod client
+ * @returns An object with group transaction ID (`groupTransactionId`) and (if `skipWaiting` is `false` or unset) confirmation (`confirmation`)
+ */
+export declare const sendGroupOfTransactions: (groupSend: {
+    transactions: TransactionToSign[];
+    sendParams?: Omit<Omit<SendTransactionParams, 'maxFee'>, 'skipSending'>;
+}, algod: Algodv2) => Promise<{
+    groupId: string;
+    confirmations: PendingTransactionResponse[] | undefined;
+    txIds: string[];
+}>;
+/**
+ * Wait until the transaction is confirmed or rejected, or until `timeout`
+ * number of rounds have passed.
+ *
+ * @param algod An algod client
+ * @param transactionId The transaction ID to wait for
+ * @param timeout Maximum number of rounds to wait
+ *
+ * @return Pending transaction information
+ * @throws Throws an error if the transaction is not confirmed or rejected in the next `timeout` rounds
+ */
+export declare const waitForConfirmation: (algod: Algodv2, transactionId: string, timeout: number) => Promise<PendingTransactionResponse>;
+/**
+ * Limit the acceptable fee to a defined amount of µALGOs.
+ * This also sets the transaction to be flatFee to ensure the transaction only succeeds at
+ * the estimated rate.
+ * @param transaction The transaction to cap
+ * @param maxAcceptableFee The maximum acceptable fee to pay
+ */
+export declare function capTransactionFee(transaction: algosdk.Transaction, maxAcceptableFee: AlgoAmount): void;
+/**
+ * Returns suggested transaction parameters from algod unless some are already provided.
+ * @param params Optionally provide parameters to use
+ * @param algod Algod algod
+ * @returns The suggested transaction parameters
+ */
+export declare function getTransactionParams(params: SuggestedParams | undefined, algod: Algodv2): Promise<algosdk.SuggestedParams>;
+//# sourceMappingURL=transaction.d.ts.map

package/dist/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../src/transaction.ts"],"names":[],"mappings":"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"}

package/dist/transaction.js

@@ -0,0 +1,274 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTransactionParams = exports.capTransactionFee = exports.waitForConfirmation = exports.sendGroupOfTransactions = exports.sendTransaction = exports.getSenderAddress = exports.encodeTransactionNote = exports.SigningAccount = exports.MultisigAccount = void 0;
+const algosdk_1 = __importDefault(require("algosdk"));
+const buffer_1 = require("buffer");
+const config_1 = require("./config");
+/** Account wrapper that supports partial or full multisig signing */
+class MultisigAccount {
+    get params() {
+        return this._params;
+    }
+    get signingAccounts() {
+        return this._signingAccounts;
+    }
+    get addr() {
+        return this._addr;
+    }
+    constructor(multisigParams, signingAccounts) {
+        this._params = multisigParams;
+        this._signingAccounts = signingAccounts;
+        this._addr = algosdk_1.default.multisigAddress(multisigParams);
+    }
+    sign(transaction) {
+        let signedTxn = 'from' in transaction ? undefined : transaction;
+        for (const signer of this._signingAccounts) {
+            if (signedTxn) {
+                signedTxn = algosdk_1.default.appendSignMultisigTransaction(signedTxn, this._params, signer.sk).blob;
+            }
+            else {
+                signedTxn = algosdk_1.default.signMultisigTransaction(transaction, this._params, signer.sk).blob;
+            }
+        }
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        return signedTxn;
+    }
+}
+exports.MultisigAccount = MultisigAccount;
+/** Account wrapper that supports a rekeyed account */
+class SigningAccount {
+    /**
+     * Algorand address of the sender
+     */
+    get addr() {
+        return this._sender;
+    }
+    /**
+     * Secret key belonging to the signer
+     */
+    get sk() {
+        return this._account.sk;
+    }
+    /**
+     * Algorand account of the underlying signing account
+     */
+    get signer() {
+        return this._account;
+    }
+    /**
+     * Algorand account of the sender address and signer private key
+     */
+    get sender() {
+        return {
+            addr: this._sender,
+            sk: this._account.sk,
+        };
+    }
+    constructor(account, sender) {
+        this._account = account;
+        this._sender = sender ?? account.addr;
+    }
+}
+exports.SigningAccount = SigningAccount;
+/** Encodes a transaction note into a byte array ready to be included in an Algorand transaction.
+ *
+ * @param note The transaction note
+ * @returns the transaction note ready for inclusion in a transaction
+ *
+ *  Case on the value of `data` this either either be:
+ *   * `null` | `undefined`: `undefined`
+ *   * `string`: The string value
+ *   * Uint8Array: passthrough
+ *   * Arc2TransactionNote object: ARC-0002 compatible transaction note
+ *   * Else: The object/value converted into a JSON string representation
+ */
+function encodeTransactionNote(note) {
+    if (note == null || typeof note === 'undefined') {
+        return undefined;
+    }
+    else if (typeof note === 'object' && note.constructor === Uint8Array) {
+        return note;
+    }
+    else if (typeof note === 'object' && 'dAppName' in note) {
+        const arc2Payload = `${note.dAppName}:${note.format}${note.data}`;
+        const encoder = new TextEncoder();
+        return encoder.encode(arc2Payload);
+    }
+    else {
+        const n = typeof note === 'string' ? note : JSON.stringify(note);
+        const encoder = new TextEncoder();
+        return encoder.encode(n);
+    }
+}
+exports.encodeTransactionNote = encodeTransactionNote;
+/**
+ * Returns the public address of the given transaction sender.
+ * @param sender A transaction sender
+ * @returns The public address
+ */
+const getSenderAddress = function (sender) {
+    return 'addr' in sender ? sender.addr : sender.address();
+};
+exports.getSenderAddress = getSenderAddress;
+/** Signs and sends the given transaction to the chain
+ *
+ * @param algod An algod client
+ * @param transaction The unsigned transaction
+ * @param from The account to sign the transaction with: either an account with private key loaded or a logic signature account
+ * @param config The sending configuration for this transaction
+ *
+ * @returns An object with transaction (`transaction`) and (if `skipWaiting` is `false` or unset) confirmation (`confirmation`)
+ */
+const sendTransaction = async function (algod, transaction, from, sendParams) {
+    const { skipSending, skipWaiting, maxFee, suppressLog, maxRoundsToWaitForConfirmation } = sendParams ?? {};
+    if (maxFee !== undefined) {
+        capTransactionFee(transaction, maxFee);
+    }
+    if (skipSending) {
+        return { transaction };
+    }
+    const signedTransaction = 'sk' in from
+        ? transaction.signTxn(from.sk)
+        : 'lsig' in from
+            ? algosdk_1.default.signLogicSigTransactionObject(transaction, from).blob
+            : from.sign(transaction);
+    await algod.sendRawTransaction(signedTransaction).do();
+    if (!suppressLog) {
+        config_1.AlgoKitConfig.logger.info(`Sent transaction ID ${transaction.txID()} ${transaction.type} from ${(0, exports.getSenderAddress)(from)}`);
+    }
+    let confirmation = undefined;
+    if (!skipWaiting) {
+        confirmation = await (0, exports.waitForConfirmation)(algod, transaction.txID(), maxRoundsToWaitForConfirmation ?? 5);
+    }
+    return { transaction, confirmation };
+};
+exports.sendTransaction = sendTransaction;
+/**
+ * Signs and sends a group of [up to 16](https://developer.algorand.org/docs/get-details/atomic_transfers/#create-transactions) transactions to the chain
+ *
+ * @param groupSend The group details to send, with:
+ *   * `transactions`: The array of transactions to send along with their signing account
+ *   * `sendParams`: The parameters to dictate how the group is sent
+ * @param algod An algod client
+ * @returns An object with group transaction ID (`groupTransactionId`) and (if `skipWaiting` is `false` or unset) confirmation (`confirmation`)
+ */
+const sendGroupOfTransactions = async function (groupSend, algod) {
+    const { transactions, sendParams } = groupSend;
+    const transactionsToSend = transactions.map((t) => {
+        return t.transaction;
+    });
+    const group = algosdk_1.default.assignGroupID(transactionsToSend);
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    const groupId = buffer_1.Buffer.from(group[0].group).toString('base64');
+    if (!sendParams?.suppressLog) {
+        config_1.AlgoKitConfig.logger.info(`Sending group of transactions (${groupId})`, { transactionsToSend });
+    }
+    const signedTransactions = group.map((groupedTransaction, index) => {
+        const signer = transactions[index].signer;
+        return 'sk' in signer
+            ? groupedTransaction.signTxn(signer.sk)
+            : 'lsig' in signer
+                ? algosdk_1.default.signLogicSigTransactionObject(groupedTransaction, signer).blob
+                : signer.sign(groupedTransaction);
+    });
+    if (!sendParams?.suppressLog) {
+        config_1.AlgoKitConfig.logger.debug(`Signer IDs (${groupId})`, transactions.map((t) => (0, exports.getSenderAddress)(t.signer)));
+        config_1.AlgoKitConfig.logger.debug(`Transaction IDs (${groupId})`, transactionsToSend.map((t) => t.txID()));
+    }
+    // https://developer.algorand.org/docs/rest-apis/algod/v2/#post-v2transactions
+    const result = await algod.sendRawTransaction(signedTransactions).do();
+    if (!sendParams?.suppressLog) {
+        config_1.AlgoKitConfig.logger.info(`Group transaction (${groupId}) sent with ${transactionsToSend.length} transactions`);
+    }
+    let confirmations = undefined;
+    if (!sendParams?.skipWaiting) {
+        confirmations = await Promise.all(transactionsToSend.map(async (t) => await (0, exports.waitForConfirmation)(algod, t.txID(), sendParams?.maxRoundsToWaitForConfirmation ?? 5)));
+    }
+    return {
+        groupId,
+        confirmations,
+        txIds: transactionsToSend.map((t) => t.txID()),
+    };
+};
+exports.sendGroupOfTransactions = sendGroupOfTransactions;
+/**
+ * Wait until the transaction is confirmed or rejected, or until `timeout`
+ * number of rounds have passed.
+ *
+ * @param algod An algod client
+ * @param transactionId The transaction ID to wait for
+ * @param timeout Maximum number of rounds to wait
+ *
+ * @return Pending transaction information
+ * @throws Throws an error if the transaction is not confirmed or rejected in the next `timeout` rounds
+ */
+const waitForConfirmation = async function (algod, transactionId, timeout) {
+    if (timeout < 0) {
+        throw new Error(`Invalid timeout, received ${timeout}, expected > 0`);
+    }
+    // Get current round
+    const status = await algod.status().do();
+    if (status === undefined) {
+        throw new Error('Unable to get node status');
+    }
+    // Loop for up to `timeout` rounds looking for a confirmed transaction
+    const startRound = status['last-round'] + 1;
+    let currentRound = startRound;
+    while (currentRound < startRound + timeout) {
+        const pendingInfo = (await algod.pendingTransactionInformation(transactionId).do());
+        if (pendingInfo !== undefined) {
+            const confirmedRound = pendingInfo['confirmed-round'];
+            if (confirmedRound && confirmedRound > 0) {
+                return pendingInfo;
+            }
+            else {
+                const poolError = pendingInfo['pool-error'];
+                if (poolError != null && poolError.length > 0) {
+                    // If there was a pool error, then the transaction has been rejected!
+                    throw new Error(`Transaction ${transactionId} was rejected; pool error: ${poolError}`);
+                }
+            }
+        }
+        await algod.statusAfterBlock(currentRound).do();
+        currentRound++;
+    }
+    throw new Error(`Transaction ${transactionId} not confirmed after ${timeout} rounds`);
+};
+exports.waitForConfirmation = waitForConfirmation;
+/**
+ * Limit the acceptable fee to a defined amount of µALGOs.
+ * This also sets the transaction to be flatFee to ensure the transaction only succeeds at
+ * the estimated rate.
+ * @param transaction The transaction to cap
+ * @param maxAcceptableFee The maximum acceptable fee to pay
+ */
+function capTransactionFee(transaction, maxAcceptableFee) {
+    // If a flat fee hasn't already been defined
+    if (!transaction.flatFee) {
+        // Once a transaction has been constructed by algosdk, transaction.fee indicates what the total transaction fee
+        // Will be based on the current suggested fee-per-byte value.
+        if (transaction.fee > maxAcceptableFee.microAlgos) {
+            throw new Error(`Cancelled transaction due to high network congestion fees. Algorand suggested fees would cause this transaction to cost ${transaction.fee} µALGOs. Cap for this transaction is ${maxAcceptableFee.microAlgos} µALGOs.`);
+        }
+        else if (transaction.fee > algosdk_1.default.ALGORAND_MIN_TX_FEE) {
+            config_1.AlgoKitConfig.logger.warn(`Algorand network congestion fees are in effect. This transaction will incur a fee of ${transaction.fee} µALGOs.`);
+        }
+        // Now set the flat on the transaction. Otherwise the network may increase the fee above our cap and perform the transaction.
+        transaction.flatFee = true;
+    }
+}
+exports.capTransactionFee = capTransactionFee;
+/**
+ * Returns suggested transaction parameters from algod unless some are already provided.
+ * @param params Optionally provide parameters to use
+ * @param algod Algod algod
+ * @returns The suggested transaction parameters
+ */
+async function getTransactionParams(params, algod) {
+    return params ?? (await algod.getTransactionParams().do());
+}
+exports.getTransactionParams = getTransactionParams;
+//# sourceMappingURL=transaction.js.map

package/dist/transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../src/transaction.ts"],"names":[],"mappings":"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"}