@algorandfoundation/algokit-utils 6.0.0-beta.3 → 6.0.0-beta.5

package/types/algorand-client.js

@@ -0,0 +1,296 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var config = require('../config.js');
+var networkClient = require('../network-client.js');
+var types_accountManager = require('./account-manager.js');
+var types_clientManager = require('./client-manager.js');
+var types_composer = require('./composer.js');
+
+/** A client that brokers easy access to Algorand functionality.
+ *
+ * Note: this class is a new Beta feature and may be subject to change.
+ *
+ * @beta
+ */
+class AlgorandClient {
+    constructor(config) {
+        this._cachedSuggestedParamsTimeout = 3000; // three seconds
+        this._defaultValidityWindow = 10;
+        /**
+         * Methods for sending a single transaction.
+         */
+        this.send = {
+            /**
+             * Send a payment transaction.
+             */
+            payment: this._send((c) => c.addPayment, {
+                preLog: (params, transaction) => `Sending ${params.amount.microAlgos} µALGOs from ${params.sender} to ${params.receiver} via transaction ${transaction.txID()}`,
+            }),
+            /**
+             * Create an asset.
+             */
+            assetCreate: this._send((c) => c.addAssetCreate, {
+                postLog: (params, result) => `Created asset${params.assetName ? ` ${params.assetName} ` : ''}${params.unitName ? ` (${params.unitName}) ` : ''} with ${params.total} units and ${params.decimals ?? 0} decimals created by ${params.sender} with ID ${result.confirmation.assetIndex} via transaction ${result.txIds.at(-1)}`,
+            }),
+            /**
+             * Configure an existing asset.
+             */
+            assetConfig: this._send((c) => c.addAssetConfig, {
+                preLog: (params, transaction) => `Configuring asset with ID ${params.assetId} via transaction ${transaction.txID()}`,
+            }),
+            /**
+             * Freeze or unfreeze an asset.
+             */
+            assetFreeze: this._send((c) => c.addAssetFreeze, {
+                preLog: (params, transaction) => `Freezing asset with ID ${params.assetId} via transaction ${transaction.txID()}`,
+            }),
+            /**
+             * Destroy an asset.
+             */
+            assetDestroy: this._send((c) => c.addAssetDestroy, {
+                preLog: (params, transaction) => `Destroying asset with ID ${params.assetId} via transaction ${transaction.txID()}`,
+            }),
+            /**
+             * Transfer an asset.
+             */
+            assetTransfer: this._send((c) => c.addAssetTransfer, {
+                preLog: (params, transaction) => `Transferring ${params.amount} units of asset with ID ${params.assetId} from ${params.sender} to ${params.receiver} via transaction ${transaction.txID()}`,
+            }),
+            /**
+             * Opt an account into an asset.
+             */
+            assetOptIn: this._send((c) => c.addAssetOptIn, {
+                preLog: (params, transaction) => `Opting in ${params.sender} to asset with ID ${params.assetId} via transaction ${transaction.txID()}`,
+            }),
+            /**
+             * Call a smart contract.
+             *
+             * Note: you may prefer to use `algorandClient.client` to get an app client for more advanced functionality.
+             */
+            appCall: this._send((c) => c.addAppCall),
+            /**
+             * Call a smart contract ABI method.
+             *
+             * Note: you may prefer to use `algorandClient.client` to get an app client for more advanced functionality.
+             */
+            methodCall: this._send((c) => c.addMethodCall),
+            /** Register an online key. */
+            onlineKeyRegistration: this._send((c) => c.addOnlineKeyRegistration, {
+                preLog: (params, transaction) => `Registering online key for ${params.sender} via transaction ${transaction.txID()}`,
+            }),
+        };
+        /**
+         * Methods for building transactions
+         */
+        this.transactions = {
+            /** Create a payment transaction. */
+            payment: this._transaction((c) => c.addPayment),
+            /** Create an asset creation transaction. */
+            assetCreate: this._transaction((c) => c.addAssetCreate),
+            /** Create an asset config transaction. */
+            assetConfig: this._transaction((c) => c.addAssetConfig),
+            /** Create an asset freeze transaction. */
+            assetFreeze: this._transaction((c) => c.addAssetFreeze),
+            /** Create an asset destroy transaction. */
+            assetDestroy: this._transaction((c) => c.addAssetDestroy),
+            /** Create an asset transfer transaction. */
+            assetTransfer: this._transaction((c) => c.addAssetTransfer),
+            /** Create an asset opt-in transaction. */
+            assetOptIn: this._transaction((c) => c.addAssetOptIn),
+            /** Create an application call transaction. */
+            appCall: this._transaction((c) => c.addAppCall),
+            /** Create an application call with ABI method call transaction. */
+            methodCall: async (params) => {
+                return (await this.newGroup().addMethodCall(params).build()).transactions.map((ts) => ts.txn);
+            },
+            /** Create an online key registration transaction. */
+            onlineKeyRegistration: this._transaction((c) => c.addOnlineKeyRegistration),
+        };
+        this._clientManager = new types_clientManager.ClientManager(config);
+        this._accountManager = new types_accountManager.AccountManager(this._clientManager);
+    }
+    /**
+     * Sets the default validity window for transactions.
+     * @param validityWindow The number of rounds between the first and last valid rounds
+     * @returns The `AlgorandClient` so method calls can be chained
+     */
+    setDefaultValidityWindow(validityWindow) {
+        this._defaultValidityWindow = validityWindow;
+        return this;
+    }
+    /**
+     * Sets the default signer to use if no other signer is specified.
+     * @param signer The signer to use, either a `TransactionSigner` or a `TransactionSignerAccount`
+     * @returns The `AlgorandClient` so method calls can be chained
+     */
+    setDefaultSigner(signer) {
+        this._accountManager.setDefaultSigner(signer);
+        return this;
+    }
+    /**
+     * Tracks the given account for later signing.
+     * @param account The account to register
+     * @returns The `AlgorandClient` so method calls can be chained
+     */
+    setSignerFromAccount(account) {
+        this._accountManager.setSignerFromAccount(account);
+        return this;
+    }
+    /**
+     * Tracks the given account for later signing.
+     * @param sender The sender address to use this signer for
+     * @param signer The signer to sign transactions with for the given sender
+     * @returns The `AlgorandClient` so method calls can be chained
+     */
+    setSigner(sender, signer) {
+        this._accountManager.setSigner(sender, signer);
+        return this;
+    }
+    /**
+     * Sets a cache value to use for suggested params.
+     * @param suggestedParams The suggested params to use
+     * @param until A date until which to cache, or if not specified then the timeout is used
+     * @returns The `AlgorandClient` so method calls can be chained
+     */
+    setSuggestedParams(suggestedParams, until) {
+        this._cachedSuggestedParams = suggestedParams;
+        this._cachedSuggestedParamsExpiry = until ?? new Date(+new Date() + this._cachedSuggestedParamsTimeout);
+        return this;
+    }
+    /**
+     * Sets the timeout for caching suggested params.
+     * @param timeout The timeout in milliseconds
+     * @returns The `AlgorandClient` so method calls can be chained
+     */
+    setSuggestedParamsTimeout(timeout) {
+        this._cachedSuggestedParamsTimeout = timeout;
+        return this;
+    }
+    /** Get suggested params for a transaction (either cached or from algod if the cache is stale or empty) */
+    async getSuggestedParams() {
+        if (this._cachedSuggestedParams && (!this._cachedSuggestedParamsExpiry || this._cachedSuggestedParamsExpiry > new Date())) {
+            return {
+                ...this._cachedSuggestedParams,
+            };
+        }
+        this._cachedSuggestedParams = await this._clientManager.algod.getTransactionParams().do();
+        this._cachedSuggestedParamsExpiry = new Date(new Date().getTime() + this._cachedSuggestedParamsTimeout);
+        return {
+            ...this._cachedSuggestedParams,
+        };
+    }
+    /** Get clients, including algosdk clients and app clients. */
+    get client() {
+        return this._clientManager;
+    }
+    /** Get or create accounts that can sign transactions. */
+    get account() {
+        return this._accountManager;
+    }
+    /** Start a new `AlgokitComposer` transaction group */
+    newGroup() {
+        return new types_composer({
+            algod: this.client.algod,
+            getSigner: (addr) => this.account.getSigner(addr),
+            getSuggestedParams: () => this.getSuggestedParams(),
+            defaultValidityWindow: this._defaultValidityWindow,
+        });
+    }
+    _send(c, log) {
+        return async (params, config$1) => {
+            const composer = this.newGroup();
+            // Ensure `this` is properly populated
+            c(composer).apply(composer, [params]);
+            if (log?.preLog) {
+                const transaction = (await composer.build()).transactions.at(-1).txn;
+                config.Config.getLogger(config$1?.suppressLog).debug(log.preLog(params, transaction));
+            }
+            const rawResult = await composer.execute(config$1);
+            const result = {
+                // Last item covers when a group is created by an app call with ABI transaction parameters
+                transaction: rawResult.transactions[rawResult.transactions.length - 1],
+                confirmation: rawResult.confirmations[rawResult.confirmations.length - 1],
+                txId: rawResult.txIds[0],
+                ...rawResult,
+            };
+            if (log?.postLog) {
+                config.Config.getLogger(config$1?.suppressLog).debug(log.postLog(params, result));
+            }
+            return result;
+        };
+    }
+    _transaction(c) {
+        return async (params) => {
+            const composer = this.newGroup();
+            const result = await c(composer).apply(composer, [params]).build();
+            return result.transactions.map((ts) => ts.txn)[0];
+        };
+    }
+    // Static methods to create an `AlgorandClient`
+    /**
+     * Returns an `AlgorandClient` pointing at default LocalNet ports and API token.
+     * @returns The `AlgorandClient`
+     */
+    static defaultLocalNet() {
+        return new AlgorandClient({
+            algodConfig: networkClient.getDefaultLocalNetConfig('algod'),
+            indexerConfig: networkClient.getDefaultLocalNetConfig('indexer'),
+            kmdConfig: networkClient.getDefaultLocalNetConfig('kmd'),
+        });
+    }
+    /**
+     * Returns an `AlgorandClient` pointing at TestNet using AlgoNode.
+     * @returns The `AlgorandClient`
+     */
+    static testNet() {
+        return new AlgorandClient({
+            algodConfig: networkClient.getAlgoNodeConfig('testnet', 'algod'),
+            indexerConfig: networkClient.getAlgoNodeConfig('testnet', 'indexer'),
+            kmdConfig: undefined,
+        });
+    }
+    /**
+     * Returns an `AlgorandClient` pointing at MainNet using AlgoNode.
+     * @returns The `AlgorandClient`
+     */
+    static mainNet() {
+        return new AlgorandClient({
+            algodConfig: networkClient.getAlgoNodeConfig('mainnet', 'algod'),
+            indexerConfig: networkClient.getAlgoNodeConfig('mainnet', 'indexer'),
+            kmdConfig: undefined,
+        });
+    }
+    /**
+     * Returns an `AlgorandClient` pointing to the given client(s).
+     * @param clients The clients to use
+     * @returns The `AlgorandClient`
+     */
+    static fromClients(clients) {
+        return new AlgorandClient(clients);
+    }
+    /**
+     * Returns an `AlgorandClient` loading the configuration from environment variables.
+     *
+     * Retrieve configurations from environment variables when defined or get defaults.
+     *
+     * Expects to be called from a Node.js environment.
+     * @returns The `AlgorandClient`
+     */
+    static fromEnvironment() {
+        return new AlgorandClient(networkClient.getConfigFromEnvOrDefaults());
+    }
+    /**
+     * Returns an `AlgorandClient` from the given config.
+     * @param config The config to use
+     * @returns The `AlgorandClient`
+     */
+    static fromConfig(config) {
+        return new AlgorandClient(config);
+    }
+}
+
+exports.AlgorandClient = AlgorandClient;
+exports.default = AlgorandClient;
+//# sourceMappingURL=algorand-client.js.map

package/types/algorand-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"algorand-client.js","sources":["../../src/types/algorand-client.ts"],"sourcesContent":[null],"names":["ClientManager","AccountManager","AlgokitComposer","config","Config","getDefaultLocalNetConfig","getAlgoNodeConfig","getConfigFromEnvOrDefaults"],"mappings":";;;;;;;;;;AAcA;;;;;AAKG;MACU,cAAc,CAAA;AAUzB,IAAA,WAAA,CAAoB,MAAmC,EAAA;AAJ/C,QAAA,IAAA,CAAA,6BAA6B,GAAW,IAAK,CAAA;QAE7C,IAAsB,CAAA,sBAAA,GAAW,EAAE,CAAA;AA6I3C;;AAEG;AACH,QAAA,IAAA,CAAA,IAAI,GAAG;AACL;;AAEG;AACH,YAAA,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE;gBACvC,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,KAC1B,CAAA,QAAA,EAAW,MAAM,CAAC,MAAM,CAAC,UAAU,CAAA,aAAA,EAAgB,MAAM,CAAC,MAAM,CAAA,IAAA,EAAO,MAAM,CAAC,QAAQ,CAAA,iBAAA,EAAoB,WAAW,CAAC,IAAI,EAAE,CAAE,CAAA;aACjI,CAAC;AACF;;AAEG;AACH,YAAA,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,cAAc,EAAE;AAC/C,gBAAA,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KACtB,CAAA,aAAA,EAAgB,MAAM,CAAC,SAAS,GAAG,CAAA,CAAA,EAAI,MAAM,CAAC,SAAS,CAAA,CAAA,CAAG,GAAG,EAAE,CAAA,EAAG,MAAM,CAAC,QAAQ,GAAG,CAAA,EAAA,EAAK,MAAM,CAAC,QAAQ,CAAI,EAAA,CAAA,GAAG,EAAE,CAAA,MAAA,EAAS,MAAM,CAAC,KAAK,CAAc,WAAA,EAAA,MAAM,CAAC,QAAQ,IAAI,CAAC,wBAAwB,MAAM,CAAC,MAAM,CAAA,SAAA,EAAY,MAAM,CAAC,YAAY,CAAC,UAAU,CAAoB,iBAAA,EAAA,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAA;aACnS,CAAC;AACF;;AAEG;AACH,YAAA,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,cAAc,EAAE;AAC/C,gBAAA,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,CAA6B,0BAAA,EAAA,MAAM,CAAC,OAAO,CAAA,iBAAA,EAAoB,WAAW,CAAC,IAAI,EAAE,CAAE,CAAA;aACrH,CAAC;AACF;;AAEG;AACH,YAAA,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,cAAc,EAAE;AAC/C,gBAAA,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,CAA0B,uBAAA,EAAA,MAAM,CAAC,OAAO,CAAA,iBAAA,EAAoB,WAAW,CAAC,IAAI,EAAE,CAAE,CAAA;aAClH,CAAC;AACF;;AAEG;AACH,YAAA,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,eAAe,EAAE;AACjD,gBAAA,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,CAA4B,yBAAA,EAAA,MAAM,CAAC,OAAO,CAAA,iBAAA,EAAoB,WAAW,CAAC,IAAI,EAAE,CAAE,CAAA;aACpH,CAAC;AACF;;AAEG;AACH,YAAA,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,gBAAgB,EAAE;AACnD,gBAAA,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,KAC1B,CAAgB,aAAA,EAAA,MAAM,CAAC,MAAM,CAA2B,wBAAA,EAAA,MAAM,CAAC,OAAO,CAAS,MAAA,EAAA,MAAM,CAAC,MAAM,CAAO,IAAA,EAAA,MAAM,CAAC,QAAQ,CAAoB,iBAAA,EAAA,WAAW,CAAC,IAAI,EAAE,CAAE,CAAA;aAC7J,CAAC;AACF;;AAEG;AACH,YAAA,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE;gBAC7C,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,KAC1B,CAAa,UAAA,EAAA,MAAM,CAAC,MAAM,CAAA,kBAAA,EAAqB,MAAM,CAAC,OAAO,oBAAoB,WAAW,CAAC,IAAI,EAAE,CAAE,CAAA;aACxG,CAAC;AACF;;;;AAIG;AACH,YAAA,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC;AACxC;;;;AAIG;AACH,YAAA,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC;;AAE9C,YAAA,qBAAqB,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,wBAAwB,EAAE;AACnE,gBAAA,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,CAA8B,2BAAA,EAAA,MAAM,CAAC,MAAM,CAAA,iBAAA,EAAoB,WAAW,CAAC,IAAI,EAAE,CAAE,CAAA;aACrH,CAAC;SACH,CAAA;AAUD;;AAEG;AACH,QAAA,IAAA,CAAA,YAAY,GAAG;;AAEb,YAAA,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC;;AAE/C,YAAA,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC;;AAEvD,YAAA,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC;;AAEvD,YAAA,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC;;AAEvD,YAAA,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC;;AAEzD,YAAA,aAAa,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,gBAAgB,CAAC;;AAE3D,YAAA,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC;;AAErD,YAAA,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC;;AAE/C,YAAA,UAAU,EAAE,OAAO,MAAwB,KAAI;AAC7C,gBAAA,OAAO,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAA;aAC9F;;AAED,YAAA,qBAAqB,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,wBAAwB,CAAC;SAC5E,CAAA;QAhPC,IAAI,CAAC,cAAc,GAAG,IAAIA,iCAAa,CAAC,MAAM,CAAC,CAAA;QAC/C,IAAI,CAAC,eAAe,GAAG,IAAIC,mCAAc,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;KAC/D;AAED;;;;AAIG;AACI,IAAA,wBAAwB,CAAC,cAAsB,EAAA;AACpD,QAAA,IAAI,CAAC,sBAAsB,GAAG,cAAc,CAAA;AAC5C,QAAA,OAAO,IAAI,CAAA;KACZ;AAED;;;;AAIG;AACI,IAAA,gBAAgB,CAAC,MAA4D,EAAA;AAClF,QAAA,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAA;AAC7C,QAAA,OAAO,IAAI,CAAA;KACZ;AAED;;;;AAIG;AACI,IAAA,oBAAoB,CAAC,OAAuD,EAAA;AACjF,QAAA,IAAI,CAAC,eAAe,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAA;AAClD,QAAA,OAAO,IAAI,CAAA;KACZ;AAED;;;;;AAKG;IACI,SAAS,CAAC,MAAc,EAAE,MAAiC,EAAA;QAChE,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAC9C,QAAA,OAAO,IAAI,CAAA;KACZ;AAED;;;;;AAKG;IACI,kBAAkB,CAAC,eAAwC,EAAE,KAAY,EAAA;AAC9E,QAAA,IAAI,CAAC,sBAAsB,GAAG,eAAe,CAAA;AAC7C,QAAA,IAAI,CAAC,4BAA4B,GAAG,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,GAAG,IAAI,CAAC,6BAA6B,CAAC,CAAA;AACvG,QAAA,OAAO,IAAI,CAAA;KACZ;AAED;;;;AAIG;AACI,IAAA,yBAAyB,CAAC,OAAe,EAAA;AAC9C,QAAA,IAAI,CAAC,6BAA6B,GAAG,OAAO,CAAA;AAC5C,QAAA,OAAO,IAAI,CAAA;KACZ;;AAGD,IAAA,MAAM,kBAAkB,GAAA;AACtB,QAAA,IAAI,IAAI,CAAC,sBAAsB,KAAK,CAAC,IAAI,CAAC,4BAA4B,IAAI,IAAI,CAAC,4BAA4B,GAAG,IAAI,IAAI,EAAE,CAAC,EAAE;YACzH,OAAO;gBACL,GAAG,IAAI,CAAC,sBAAsB;aAC/B,CAAA;SACF;AAED,QAAA,IAAI,CAAC,sBAAsB,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC,EAAE,EAAE,CAAA;AACzF,QAAA,IAAI,CAAC,4BAA4B,GAAG,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,6BAA6B,CAAC,CAAA;QAEvG,OAAO;YACL,GAAG,IAAI,CAAC,sBAAsB;SAC/B,CAAA;KACF;;AAGD,IAAA,IAAW,MAAM,GAAA;QACf,OAAO,IAAI,CAAC,cAAc,CAAA;KAC3B;;AAGD,IAAA,IAAW,OAAO,GAAA;QAChB,OAAO,IAAI,CAAC,eAAe,CAAA;KAC5B;;IAGD,QAAQ,GAAA;QACN,OAAO,IAAIC,cAAe,CAAC;AACzB,YAAA,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;AACxB,YAAA,SAAS,EAAE,CAAC,IAAY,KAAK,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC;AACzD,YAAA,kBAAkB,EAAE,MAAM,IAAI,CAAC,kBAAkB,EAAE;YACnD,qBAAqB,EAAE,IAAI,CAAC,sBAAsB;AACnD,SAAA,CAAC,CAAA;KACH;IAEO,KAAK,CACX,CAAyD,EACzD,GAGC,EAAA;AAED,QAAA,OAAO,OAAO,MAAM,EAAEC,QAAM,KAAI;AAC9B,YAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;;AAGhC,YAAA,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;AAErC,YAAA,IAAI,GAAG,EAAE,MAAM,EAAE;AACf,gBAAA,MAAM,WAAW,GAAG,CAAC,MAAM,QAAQ,CAAC,KAAK,EAAE,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,GAAG,CAAA;AACrE,gBAAAC,aAAM,CAAC,SAAS,CAACD,QAAM,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAA;aAC7E;YAED,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,OAAO,CAACA,QAAM,CAAC,CAAA;AAChD,YAAA,MAAM,MAAM,GAAG;;AAEb,gBAAA,WAAW,EAAE,SAAS,CAAC,YAAY,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;AACtE,gBAAA,YAAY,EAAE,SAAS,CAAC,aAAc,CAAC,SAAS,CAAC,aAAc,CAAC,MAAM,GAAG,CAAC,CAAC;AAC3E,gBAAA,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AACxB,gBAAA,GAAG,SAAS;aACb,CAAA;AAED,YAAA,IAAI,GAAG,EAAE,OAAO,EAAE;AAChB,gBAAAC,aAAM,CAAC,SAAS,CAACD,QAAM,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;aACzE;AAED,YAAA,OAAO,MAAM,CAAA;AACf,SAAC,CAAA;KACF;AAsEO,IAAA,YAAY,CAAI,CAAyD,EAAA;AAC/E,QAAA,OAAO,OAAO,MAAS,KAAI;AACzB,YAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;AAChC,YAAA,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAA;AAClE,YAAA,OAAO,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;AACnD,SAAC,CAAA;KACF;;AAgCD;;;AAGG;AACI,IAAA,OAAO,eAAe,GAAA;QAC3B,OAAO,IAAI,cAAc,CAAC;AACxB,YAAA,WAAW,EAAEE,sCAAwB,CAAC,OAAO,CAAC;AAC9C,YAAA,aAAa,EAAEA,sCAAwB,CAAC,SAAS,CAAC;AAClD,YAAA,SAAS,EAAEA,sCAAwB,CAAC,KAAK,CAAC;AAC3C,SAAA,CAAC,CAAA;KACH;AAED;;;AAGG;AACI,IAAA,OAAO,OAAO,GAAA;QACnB,OAAO,IAAI,cAAc,CAAC;AACxB,YAAA,WAAW,EAAEC,+BAAiB,CAAC,SAAS,EAAE,OAAO,CAAC;AAClD,YAAA,aAAa,EAAEA,+BAAiB,CAAC,SAAS,EAAE,SAAS,CAAC;AACtD,YAAA,SAAS,EAAE,SAAS;AACrB,SAAA,CAAC,CAAA;KACH;AAED;;;AAGG;AACI,IAAA,OAAO,OAAO,GAAA;QACnB,OAAO,IAAI,cAAc,CAAC;AACxB,YAAA,WAAW,EAAEA,+BAAiB,CAAC,SAAS,EAAE,OAAO,CAAC;AAClD,YAAA,aAAa,EAAEA,+BAAiB,CAAC,SAAS,EAAE,SAAS,CAAC;AACtD,YAAA,SAAS,EAAE,SAAS;AACrB,SAAA,CAAC,CAAA;KACH;AAED;;;;AAIG;IACI,OAAO,WAAW,CAAC,OAAuB,EAAA;AAC/C,QAAA,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,CAAA;KACnC;AAED;;;;;;;AAOG;AACI,IAAA,OAAO,eAAe,GAAA;AAC3B,QAAA,OAAO,IAAI,cAAc,CAACC,wCAA0B,EAAE,CAAC,CAAA;KACxD;AAED;;;;AAIG;IACI,OAAO,UAAU,CAAC,MAAkB,EAAA;AACzC,QAAA,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAA;KAClC;AACF;;;;;"}

package/types/algorand-client.mjs

@@ -0,0 +1,291 @@
+import { Config } from '../config.mjs';
+import { getDefaultLocalNetConfig, getAlgoNodeConfig, getConfigFromEnvOrDefaults } from '../network-client.mjs';
+import { AccountManager } from './account-manager.mjs';
+import { ClientManager } from './client-manager.mjs';
+import AlgokitComposer from './composer.mjs';
+
+/** A client that brokers easy access to Algorand functionality.
+ *
+ * Note: this class is a new Beta feature and may be subject to change.
+ *
+ * @beta
+ */
+class AlgorandClient {
+    constructor(config) {
+        this._cachedSuggestedParamsTimeout = 3000; // three seconds
+        this._defaultValidityWindow = 10;
+        /**
+         * Methods for sending a single transaction.
+         */
+        this.send = {
+            /**
+             * Send a payment transaction.
+             */
+            payment: this._send((c) => c.addPayment, {
+                preLog: (params, transaction) => `Sending ${params.amount.microAlgos} µALGOs from ${params.sender} to ${params.receiver} via transaction ${transaction.txID()}`,
+            }),
+            /**
+             * Create an asset.
+             */
+            assetCreate: this._send((c) => c.addAssetCreate, {
+                postLog: (params, result) => `Created asset${params.assetName ? ` ${params.assetName} ` : ''}${params.unitName ? ` (${params.unitName}) ` : ''} with ${params.total} units and ${params.decimals ?? 0} decimals created by ${params.sender} with ID ${result.confirmation.assetIndex} via transaction ${result.txIds.at(-1)}`,
+            }),
+            /**
+             * Configure an existing asset.
+             */
+            assetConfig: this._send((c) => c.addAssetConfig, {
+                preLog: (params, transaction) => `Configuring asset with ID ${params.assetId} via transaction ${transaction.txID()}`,
+            }),
+            /**
+             * Freeze or unfreeze an asset.
+             */
+            assetFreeze: this._send((c) => c.addAssetFreeze, {
+                preLog: (params, transaction) => `Freezing asset with ID ${params.assetId} via transaction ${transaction.txID()}`,
+            }),
+            /**
+             * Destroy an asset.
+             */
+            assetDestroy: this._send((c) => c.addAssetDestroy, {
+                preLog: (params, transaction) => `Destroying asset with ID ${params.assetId} via transaction ${transaction.txID()}`,
+            }),
+            /**
+             * Transfer an asset.
+             */
+            assetTransfer: this._send((c) => c.addAssetTransfer, {
+                preLog: (params, transaction) => `Transferring ${params.amount} units of asset with ID ${params.assetId} from ${params.sender} to ${params.receiver} via transaction ${transaction.txID()}`,
+            }),
+            /**
+             * Opt an account into an asset.
+             */
+            assetOptIn: this._send((c) => c.addAssetOptIn, {
+                preLog: (params, transaction) => `Opting in ${params.sender} to asset with ID ${params.assetId} via transaction ${transaction.txID()}`,
+            }),
+            /**
+             * Call a smart contract.
+             *
+             * Note: you may prefer to use `algorandClient.client` to get an app client for more advanced functionality.
+             */
+            appCall: this._send((c) => c.addAppCall),
+            /**
+             * Call a smart contract ABI method.
+             *
+             * Note: you may prefer to use `algorandClient.client` to get an app client for more advanced functionality.
+             */
+            methodCall: this._send((c) => c.addMethodCall),
+            /** Register an online key. */
+            onlineKeyRegistration: this._send((c) => c.addOnlineKeyRegistration, {
+                preLog: (params, transaction) => `Registering online key for ${params.sender} via transaction ${transaction.txID()}`,
+            }),
+        };
+        /**
+         * Methods for building transactions
+         */
+        this.transactions = {
+            /** Create a payment transaction. */
+            payment: this._transaction((c) => c.addPayment),
+            /** Create an asset creation transaction. */
+            assetCreate: this._transaction((c) => c.addAssetCreate),
+            /** Create an asset config transaction. */
+            assetConfig: this._transaction((c) => c.addAssetConfig),
+            /** Create an asset freeze transaction. */
+            assetFreeze: this._transaction((c) => c.addAssetFreeze),
+            /** Create an asset destroy transaction. */
+            assetDestroy: this._transaction((c) => c.addAssetDestroy),
+            /** Create an asset transfer transaction. */
+            assetTransfer: this._transaction((c) => c.addAssetTransfer),
+            /** Create an asset opt-in transaction. */
+            assetOptIn: this._transaction((c) => c.addAssetOptIn),
+            /** Create an application call transaction. */
+            appCall: this._transaction((c) => c.addAppCall),
+            /** Create an application call with ABI method call transaction. */
+            methodCall: async (params) => {
+                return (await this.newGroup().addMethodCall(params).build()).transactions.map((ts) => ts.txn);
+            },
+            /** Create an online key registration transaction. */
+            onlineKeyRegistration: this._transaction((c) => c.addOnlineKeyRegistration),
+        };
+        this._clientManager = new ClientManager(config);
+        this._accountManager = new AccountManager(this._clientManager);
+    }
+    /**
+     * Sets the default validity window for transactions.
+     * @param validityWindow The number of rounds between the first and last valid rounds
+     * @returns The `AlgorandClient` so method calls can be chained
+     */
+    setDefaultValidityWindow(validityWindow) {
+        this._defaultValidityWindow = validityWindow;
+        return this;
+    }
+    /**
+     * Sets the default signer to use if no other signer is specified.
+     * @param signer The signer to use, either a `TransactionSigner` or a `TransactionSignerAccount`
+     * @returns The `AlgorandClient` so method calls can be chained
+     */
+    setDefaultSigner(signer) {
+        this._accountManager.setDefaultSigner(signer);
+        return this;
+    }
+    /**
+     * Tracks the given account for later signing.
+     * @param account The account to register
+     * @returns The `AlgorandClient` so method calls can be chained
+     */
+    setSignerFromAccount(account) {
+        this._accountManager.setSignerFromAccount(account);
+        return this;
+    }
+    /**
+     * Tracks the given account for later signing.
+     * @param sender The sender address to use this signer for
+     * @param signer The signer to sign transactions with for the given sender
+     * @returns The `AlgorandClient` so method calls can be chained
+     */
+    setSigner(sender, signer) {
+        this._accountManager.setSigner(sender, signer);
+        return this;
+    }
+    /**
+     * Sets a cache value to use for suggested params.
+     * @param suggestedParams The suggested params to use
+     * @param until A date until which to cache, or if not specified then the timeout is used
+     * @returns The `AlgorandClient` so method calls can be chained
+     */
+    setSuggestedParams(suggestedParams, until) {
+        this._cachedSuggestedParams = suggestedParams;
+        this._cachedSuggestedParamsExpiry = until ?? new Date(+new Date() + this._cachedSuggestedParamsTimeout);
+        return this;
+    }
+    /**
+     * Sets the timeout for caching suggested params.
+     * @param timeout The timeout in milliseconds
+     * @returns The `AlgorandClient` so method calls can be chained
+     */
+    setSuggestedParamsTimeout(timeout) {
+        this._cachedSuggestedParamsTimeout = timeout;
+        return this;
+    }
+    /** Get suggested params for a transaction (either cached or from algod if the cache is stale or empty) */
+    async getSuggestedParams() {
+        if (this._cachedSuggestedParams && (!this._cachedSuggestedParamsExpiry || this._cachedSuggestedParamsExpiry > new Date())) {
+            return {
+                ...this._cachedSuggestedParams,
+            };
+        }
+        this._cachedSuggestedParams = await this._clientManager.algod.getTransactionParams().do();
+        this._cachedSuggestedParamsExpiry = new Date(new Date().getTime() + this._cachedSuggestedParamsTimeout);
+        return {
+            ...this._cachedSuggestedParams,
+        };
+    }
+    /** Get clients, including algosdk clients and app clients. */
+    get client() {
+        return this._clientManager;
+    }
+    /** Get or create accounts that can sign transactions. */
+    get account() {
+        return this._accountManager;
+    }
+    /** Start a new `AlgokitComposer` transaction group */
+    newGroup() {
+        return new AlgokitComposer({
+            algod: this.client.algod,
+            getSigner: (addr) => this.account.getSigner(addr),
+            getSuggestedParams: () => this.getSuggestedParams(),
+            defaultValidityWindow: this._defaultValidityWindow,
+        });
+    }
+    _send(c, log) {
+        return async (params, config) => {
+            const composer = this.newGroup();
+            // Ensure `this` is properly populated
+            c(composer).apply(composer, [params]);
+            if (log?.preLog) {
+                const transaction = (await composer.build()).transactions.at(-1).txn;
+                Config.getLogger(config?.suppressLog).debug(log.preLog(params, transaction));
+            }
+            const rawResult = await composer.execute(config);
+            const result = {
+                // Last item covers when a group is created by an app call with ABI transaction parameters
+                transaction: rawResult.transactions[rawResult.transactions.length - 1],
+                confirmation: rawResult.confirmations[rawResult.confirmations.length - 1],
+                txId: rawResult.txIds[0],
+                ...rawResult,
+            };
+            if (log?.postLog) {
+                Config.getLogger(config?.suppressLog).debug(log.postLog(params, result));
+            }
+            return result;
+        };
+    }
+    _transaction(c) {
+        return async (params) => {
+            const composer = this.newGroup();
+            const result = await c(composer).apply(composer, [params]).build();
+            return result.transactions.map((ts) => ts.txn)[0];
+        };
+    }
+    // Static methods to create an `AlgorandClient`
+    /**
+     * Returns an `AlgorandClient` pointing at default LocalNet ports and API token.
+     * @returns The `AlgorandClient`
+     */
+    static defaultLocalNet() {
+        return new AlgorandClient({
+            algodConfig: getDefaultLocalNetConfig('algod'),
+            indexerConfig: getDefaultLocalNetConfig('indexer'),
+            kmdConfig: getDefaultLocalNetConfig('kmd'),
+        });
+    }
+    /**
+     * Returns an `AlgorandClient` pointing at TestNet using AlgoNode.
+     * @returns The `AlgorandClient`
+     */
+    static testNet() {
+        return new AlgorandClient({
+            algodConfig: getAlgoNodeConfig('testnet', 'algod'),
+            indexerConfig: getAlgoNodeConfig('testnet', 'indexer'),
+            kmdConfig: undefined,
+        });
+    }
+    /**
+     * Returns an `AlgorandClient` pointing at MainNet using AlgoNode.
+     * @returns The `AlgorandClient`
+     */
+    static mainNet() {
+        return new AlgorandClient({
+            algodConfig: getAlgoNodeConfig('mainnet', 'algod'),
+            indexerConfig: getAlgoNodeConfig('mainnet', 'indexer'),
+            kmdConfig: undefined,
+        });
+    }
+    /**
+     * Returns an `AlgorandClient` pointing to the given client(s).
+     * @param clients The clients to use
+     * @returns The `AlgorandClient`
+     */
+    static fromClients(clients) {
+        return new AlgorandClient(clients);
+    }
+    /**
+     * Returns an `AlgorandClient` loading the configuration from environment variables.
+     *
+     * Retrieve configurations from environment variables when defined or get defaults.
+     *
+     * Expects to be called from a Node.js environment.
+     * @returns The `AlgorandClient`
+     */
+    static fromEnvironment() {
+        return new AlgorandClient(getConfigFromEnvOrDefaults());
+    }
+    /**
+     * Returns an `AlgorandClient` from the given config.
+     * @param config The config to use
+     * @returns The `AlgorandClient`
+     */
+    static fromConfig(config) {
+        return new AlgorandClient(config);
+    }
+}
+
+export { AlgorandClient, AlgorandClient as default };
+//# sourceMappingURL=algorand-client.mjs.map

package/types/algorand-client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"algorand-client.mjs","sources":["../../src/types/algorand-client.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}