@algorandfoundation/algokit-utils 6.0.5 → 6.1.0-beta.2

package/types/client-manager.mjs

@@ -1,20 +1,40 @@
-import { getTestNetDispenserApiClient } from '../dispenser-client.mjs';
-import { getAlgoClient, getAlgoIndexerClient, getAlgoKmdClient } from '../network-client.mjs';
+import algosdk from 'algosdk';
+import { AlgoHttpClientWithRetry } from './algo-http-client-with-retry.mjs';
 import { ApplicationClient } from './app-client.mjs';
+import { TestNetDispenserApiClient } from './dispenser-client.mjs';
 
+var Kmd = algosdk.Kmd;
+var Indexer = algosdk.Indexer;
+var IntDecoding = algosdk.IntDecoding;
 /** Exposes access to various API clients. */
 class ClientManager {
     /**
      * algosdk clients or config for interacting with the official Algorand APIs.
      * @param clientsOrConfig The clients or config to use
+     * @example Algod client only
+     * ```typescript
+     * const clientManager = new ClientManager({ algod: algodClient })
+     * ```
+     * @example All clients
+     * ```typescript
+     * const clientManager = new ClientManager({ algod: algodClient, indexer: indexerClient, kmd: kmdClient })
+     * ```
+     * @example Algod config only
+     * ```typescript
+     * const clientManager = new ClientManager({ algodConfig })
+     * ```
+     * @example All client configs
+     * ```typescript
+     * const clientManager = new ClientManager({ algodConfig, indexerConfig, kmdConfig })
+     * ```
      */
     constructor(clientsOrConfig) {
         const _clients = 'algod' in clientsOrConfig
             ? clientsOrConfig
             : {
-                algod: getAlgoClient(clientsOrConfig.algodConfig),
-                indexer: clientsOrConfig.indexerConfig ? getAlgoIndexerClient(clientsOrConfig.indexerConfig) : undefined,
-                kmd: clientsOrConfig.kmdConfig ? getAlgoKmdClient(clientsOrConfig.kmdConfig) : undefined,
+                algod: ClientManager.getAlgodClient(clientsOrConfig.algodConfig),
+                indexer: clientsOrConfig.indexerConfig ? ClientManager.getIndexerClient(clientsOrConfig.indexerConfig) : undefined,
+                kmd: clientsOrConfig.kmdConfig ? ClientManager.getKmdClient(clientsOrConfig.kmdConfig) : undefined,
             };
         this._algod = _clients.algod;
         this._indexer = _clients.indexer;
@@ -36,6 +56,49 @@ class ClientManager {
             throw new Error('Attempt to use Kmd client in AlgoKit instance with no Kmd configured');
         return this._kmd;
     }
+    /**
+     * Get details about the current network.
+     * @example Getting genesis ID
+     * ```typescript
+     * const network = await networkClient.network()
+     * const genesisId = network.genesisId
+     * ```
+     * @returns The current network details
+     */
+    async network() {
+        if (!this._getNetworkPromise) {
+            this._getNetworkPromise = this._algod.getTransactionParams().do();
+        }
+        const params = await this._getNetworkPromise;
+        return {
+            isTestNet: ['testnet-v1.0', 'testnet-v1', 'testnet'].includes(params.genesisID),
+            isMainNet: ['mainnet-v1.0', 'mainnet-v1', 'mainnet'].includes(params.genesisID),
+            isLocalNet: params.genesisID === 'devnet-v1' || params.genesisID === 'sandnet-v1' || params.genesisID === 'dockernet-v1',
+            genesisId: params.genesisID,
+            genesisHash: params.genesisHash,
+        };
+    }
+    /**
+     * Returns true if the current network is LocalNet.
+     * @returns True if the current network is LocalNet.
+     */
+    async isLocalNet() {
+        return (await this.network()).isLocalNet;
+    }
+    /**
+     * Returns true if the current network is TestNet.
+     * @returns True if the current network is TestNet.
+     */
+    async isTestNet() {
+        return (await this.network()).isTestNet;
+    }
+    /**
+     * Returns true if the current network is MainNet.
+     * @returns True if the current network is MainNet.
+     */
+    async isMainNet() {
+        return (await this.network()).isMainNet;
+    }
     /**
      * Returns a TestNet Dispenser API client.
      * Refer to [docs](https://github.com/algorandfoundation/algokit/blob/main/docs/testnet_api.md) on guidance to obtain an access token.
@@ -43,7 +106,7 @@ class ClientManager {
      * @param params An object containing parameters for the TestNetDispenserApiClient class.
      *  Or null if you want the client to load the access token from the environment variable `ALGOKIT_DISPENSER_ACCESS_TOKEN`.
      * @example
-     * const client = algokit.getTestNetDispenserApiClient(
+     * const client = clientManager.getTestNetDispenser(
      *     {
      *       authToken: 'your_auth_token',
      *       requestTimeout: 15,
@@ -53,7 +116,7 @@ class ClientManager {
      * @returns An instance of the TestNetDispenserApiClient class.
      */
     getTestNetDispenser(params = null) {
-        return getTestNetDispenserApiClient(params);
+        return new TestNetDispenserApiClient(params);
     }
     /**
      * Returns a new `ApplicationClient` client, resolving the app by creator address and name.
@@ -91,6 +154,220 @@ class ClientManager {
     getTypedAppClientById(typedClient, details) {
         return new typedClient({ ...details, resolveBy: 'id' }, this._algod);
     }
+    /**
+     * Retrieve client configurations from environment variables when defined or get defaults (expects to be called from a Node.js environment)
+     *
+     * If `process.env.ALGOD_SERVER` is defined it will use that along with optional `process.env.ALGOD_PORT` and `process.env.ALGOD_TOKEN`.
+     *
+     * If `process.env.INDEXER_SERVER` is defined it will use that along with optional `process.env.INDEXER_PORT` and `process.env.INDEXER_TOKEN`.
+     *
+     * If either aren't defined it will use the default LocalNet config, noting if `process.env.ALGOD_SERVER` is specified, but
+     * `process.env.INDEXER_SERVER` isn't then it will leave indexer as `undefined`.
+     *
+     * It will return a KMD configuration that uses `process.env.KMD_PORT` (or port 4002) if `process.env.ALGOD_SERVER` is defined,
+     * otherwise it will use the default LocalNet config unless it detects testnet or mainnet.
+     * @example
+     * ```typescript
+     * const config = ClientManager.getConfigFromEnvironmentOrLocalNet()
+     * ```
+     * @returns The config for algod, indexer and kmd
+     */
+    static getConfigFromEnvironmentOrLocalNet() {
+        if (!process || !process.env) {
+            throw new Error('Attempt to get default client configuration from a non Node.js context; supply the config instead');
+        }
+        const algodConfig = !process.env.ALGOD_SERVER
+            ? ClientManager.getDefaultLocalNetConfig('algod')
+            : ClientManager.getAlgodConfigFromEnvironment();
+        const indexerConfig = !process.env.INDEXER_SERVER
+            ? ClientManager.getDefaultLocalNetConfig('indexer')
+            : !process.env.ALGOD_SERVER
+                ? ClientManager.getIndexerConfigFromEnvironment()
+                : undefined;
+        return {
+            algodConfig,
+            indexerConfig,
+            kmdConfig: process.env.ALGOD_SERVER
+                ? process.env.ALGOD_SERVER.includes('mainnet') || process.env.ALGOD_SERVER.includes('testnet')
+                    ? undefined
+                    : { ...algodConfig, port: process?.env?.KMD_PORT ?? '4002' }
+                : ClientManager.getDefaultLocalNetConfig('kmd'),
+        };
+    }
+    /** Retrieve the algod configuration from environment variables (expects to be called from a Node.js environment)
+     *
+     * Expects `process.env.ALGOD_SERVER` to be defined, and you can also specify `process.env.ALGOD_PORT` and `process.env.ALGOD_TOKEN`.
+     */
+    static 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,
+        };
+    }
+    /**
+     * Retrieve the indexer configuration from environment variables (expects to be called from a Node.js environment).
+     *
+     * Expects `process.env.INDEXER_SERVER` to be defined, and you can also specify `process.env.INDEXER_PORT` and `process.env.INDEXER_TOKEN`.
+     */
+    static 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,
+        };
+    }
+    /** Returns the Algorand configuration to point to the free tier of the AlgoNode service.
+     *
+     * @param network Which network to connect to - TestNet or MainNet
+     * @param config Which algod config to return - Algod or Indexer
+     */
+    static getAlgoNodeConfig(network, config) {
+        return {
+            server: `https://${network}-${config === 'algod' ? 'api' : 'idx'}.algonode.cloud/`,
+            port: 443,
+        };
+    }
+    /** 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
+     */
+    static getDefaultLocalNetConfig(configOrPort) {
+        return {
+            server: `http://localhost`,
+            port: configOrPort === 'algod' ? 4001 : configOrPort === 'indexer' ? 8980 : configOrPort === 'kmd' ? 4002 : configOrPort,
+            token: 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',
+        };
+    }
+    /**
+     * Returns an algod SDK client that automatically retries on idempotent calls.
+     *
+     * @param config The config of the client
+     * @example AlgoNode (testnet)
+     * ```typescript
+     *  const algod = ClientManager.getAlgodClient(ClientManager.getAlgoNodeConfig('testnet', 'algod'))
+     *  await algod.healthCheck().do()
+     * ```
+     * @example AlgoNode (mainnet)
+     * ```typescript
+     *  const algod = ClientManager.getAlgodClient(ClientManager.getAlgoNodeConfig('mainnet', 'algod'))
+     *  await algod.healthCheck().do()
+     * ```
+     * @example Custom (e.g. default LocalNet)
+     * ```typescript
+     *  const algod = ClientManager.getAlgodClient({server: 'http://localhost', port: '4001', token: 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'})
+     *  await algod.healthCheck().do()
+     * ```
+     */
+    static getAlgodClient(config) {
+        const { token, server, port } = config;
+        const tokenHeader = typeof token === 'string' ? { 'X-Algo-API-Token': token } : token ?? {};
+        const httpClientWithRetry = new AlgoHttpClientWithRetry(tokenHeader, server, port);
+        return new algosdk.Algodv2(httpClientWithRetry, server);
+    }
+    /**
+     * Returns an algod SDK client that automatically retries on idempotent calls loaded from environment variables (expects to be called from a Node.js environment).
+     *
+     * @example
+     *  ```typescript
+     *  // Uses process.env.ALGOD_SERVER, process.env.ALGOD_PORT and process.env.ALGOD_TOKEN
+     *  const algod = ClientManager.getAlgodClientFromEnvironment()
+     *  await algod.healthCheck().do()
+     *  ```
+     */
+    static getAlgodClientFromEnvironment() {
+        return ClientManager.getAlgodClient(ClientManager.getAlgodConfigFromEnvironment());
+    }
+    /**
+     * Returns an indexer SDK client that automatically retries on idempotent calls
+     *
+     * @param config The config of the client
+     * @param overrideIntDecoding Override the default int decoding for responses, uses MIXED by default to avoid lost precision for big integers
+     * @example AlgoNode (testnet)
+     * ```typescript
+     *  const indexer = ClientManager.getIndexerClient(ClientManager.getAlgoNodeConfig('testnet', 'indexer'))
+     *  await indexer.makeHealthCheck().do()
+     * ```
+     * @example AlgoNode (mainnet)
+     * ```typescript
+     *  const indexer = ClientManager.getIndexerClient(ClientManager.getAlgoNodeConfig('mainnet', 'indexer'))
+     *  await indexer.makeHealthCheck().do()
+     * ```
+     * @example Custom (e.g. default LocalNet, although we recommend loading this into a .env and using the Default option instead)
+     * ```typescript
+     *  const indexer = ClientManager.getIndexerClient({server: 'http://localhost', port: '8980', token: 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'})
+     *  await indexer.makeHealthCheck().do()
+     * ```
+     * @example Override int decoding for responses
+     * ```typescript
+     *  const indexer = ClientManager.getIndexerClient(config, IntDecoding.BIGINT)
+     * ```
+     */
+    static getIndexerClient(config, overrideIntDecoding) {
+        const { token, server, port } = config;
+        const tokenHeader = typeof token === 'string' ? { 'X-Indexer-API-Token': token } : token ?? {};
+        const httpClientWithRetry = new AlgoHttpClientWithRetry(tokenHeader, server, port);
+        const indexer = new Indexer(httpClientWithRetry);
+        // Use mixed int decoding by default so bigints don't have lost precision
+        indexer.setIntEncoding(overrideIntDecoding ?? IntDecoding.MIXED);
+        return indexer;
+    }
+    /**
+     * Returns an indexer SDK client that automatically retries on idempotent calls loaded from environment variables (expects to be called from a Node.js environment).
+     *
+     * @param overrideIntDecoding Override the default int decoding for responses, uses MIXED by default to avoid lost precision for big integers
+     * @example
+     *
+     *  ```typescript
+     *  // Uses process.env.INDEXER_SERVER, process.env.INDEXER_PORT and process.env.INDEXER_TOKEN
+     *  const indexer = ClientManager.getIndexerClientFromEnvironment()
+     *  await indexer.makeHealthCheck().do()
+     *  ```
+     */
+    static getIndexerClientFromEnvironment(overrideIntDecoding) {
+        return ClientManager.getIndexerClient(ClientManager.getIndexerConfigFromEnvironment(), overrideIntDecoding);
+    }
+    /**
+     * Returns a KMD SDK client.
+     *
+     * KMD client allows you to export private keys, which is useful to (for instance) get the default account in a LocalNet network.
+     *
+     * @param config The config for the client
+     * @example Custom (e.g. default LocalNet, although we recommend loading this into a .env and using the Default option instead)
+     * ```typescript
+     *  const kmd = ClientManager.getKmdClient({server: 'http://localhost', port: '4002', token: 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'})
+     * ```
+     */
+    static getKmdClient(config) {
+        const { token, server, port } = config;
+        return new Kmd(token, server, port);
+    }
+    /**
+     * Returns a KMD SDK client that automatically retries on idempotent calls loaded from environment variables (expects to be called from a Node.js environment).
+     *
+     * @example
+     *  ```typescript
+     *  // Uses process.env.ALGOD_SERVER, process.env.KMD_PORT (or if not specified: port 4002) and process.env.ALGOD_TOKEN
+     *  const kmd = ClientManager.getKmdClientFromEnvironment()
+     *  ```
+     */
+    static getKmdClientFromEnvironment() {
+        // We can only use Kmd on the LocalNet otherwise it's not exposed so this makes some assumptions
+        // (e.g. same token and server as algod and port 4002 by default)
+        return ClientManager.getKmdClient({ ...ClientManager.getAlgodConfigFromEnvironment(), port: process?.env?.KMD_PORT ?? '4002' });
+    }
 }
 
 export { ClientManager };

package/types/client-manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"client-manager.mjs","sources":["../../src/types/client-manager.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAyBA;MACa,aAAa,CAAA;AAKxB;;;AAGG;AACH,IAAA,WAAA,CAAY,eAA4C,EAAA;AACtD,QAAA,MAAM,QAAQ,GACZ,OAAO,IAAI,eAAe;AACxB,cAAE,eAAe;AACjB,cAAE;AACE,gBAAA,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,WAAW,CAAC;AACjD,gBAAA,OAAO,EAAE,eAAe,CAAC,aAAa,GAAG,oBAAoB,CAAC,eAAe,CAAC,aAAa,CAAC,GAAG,SAAS;AACxG,gBAAA,GAAG,EAAE,eAAe,CAAC,SAAS,GAAG,gBAAgB,CAAC,eAAe,CAAC,SAAS,CAAC,GAAG,SAAS;aACzF,CAAA;AACP,QAAA,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAA;AAC5B,QAAA,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAA;AAChC,QAAA,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAA;KACzB;;AAGD,IAAA,IAAW,KAAK,GAAA;QACd,OAAO,IAAI,CAAC,MAAM,CAAA;KACnB;;AAGD,IAAA,IAAW,OAAO,GAAA;QAChB,IAAI,CAAC,IAAI,CAAC,QAAQ;AAAE,YAAA,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAA;QACnH,OAAO,IAAI,CAAC,QAAQ,CAAA;KACrB;;AAGD,IAAA,IAAW,GAAG,GAAA;QACZ,IAAI,CAAC,IAAI,CAAC,IAAI;AAAE,YAAA,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAA;QACvG,OAAO,IAAI,CAAC,IAAI,CAAA;KACjB;AAED;;;;;;;;;;;;;;;AAeG;IACI,mBAAmB,CAAC,SAAiD,IAAI,EAAA;AAC9E,QAAA,OAAO,4BAA4B,CAAC,MAAM,CAAC,CAAA;KAC5C;AAED;;;;;AAKG;IACI,4BAA4B,CAAC,OAAyC,EAAE,eAA2B,EAAA;QACxG,OAAO,IAAI,iBAAiB,CAC1B,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,EAC/F,IAAI,CAAC,MAAM,CACZ,CAAA;KACF;AAED;;;;AAIG;AACI,IAAA,gBAAgB,CAAC,OAA6B,EAAA;AACnD,QAAA,OAAO,IAAI,iBAAiB,CAAC,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;KAC3E;AAED;;;;;;AAMG;AACI,IAAA,iCAAiC,CACtC,WAAoC,EACpC,OAA8C,EAC9C,eAA2B,EAAA;QAE3B,OAAO,IAAI,WAAW,CAAC,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;KACrI;AAED;;;;;AAKG;IACI,qBAAqB,CAAU,WAAoC,EAAE,OAAkC,EAAA;AAC5G,QAAA,OAAO,IAAI,WAAW,CAAC,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;KACrE;AACF;;;;"}
+{"version":3,"file":"client-manager.mjs","sources":["../../src/types/client-manager.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/types/kmd-account-manager.d.ts

@@ -0,0 +1,70 @@
+import { SigningAccount, TransactionSignerAccount } from './account';
+import { AlgoAmount } from './amount';
+import { ClientManager } from './client-manager';
+/** Provides abstractions over a [KMD](https://github.com/algorand/go-algorand/blob/master/daemon/kmd/README.md) instance
+ * that makes it easier to get and manage accounts using KMD. */
+export declare class KmdAccountManager {
+    private _clientManager;
+    /**
+     * Create a new KMD manager.
+     * @param clientManager A ClientManager client to use for algod and kmd clients
+     */
+    constructor(clientManager: ClientManager);
+    /**
+     * Returns an Algorand signing account with private key loaded from the given KMD wallet (identified by name).
+     *
+     * @param walletName The name of the wallet to retrieve an account from
+     * @param predicate An optional filter to use to find the account (otherwise it will return a random account from the wallet)
+     * @param sender The optional sender address to use this signer for (aka a rekeyed account)
+     * @example Get default funded account in a LocalNet
+     *
+     * ```typescript
+     * const defaultDispenserAccount = await kmdAccountManager.getWalletAccount(
+     *   'unencrypted-default-wallet',
+     *   a => a.status !== 'Offline' && a.amount > 1_000_000_000
+     * )
+     * ```
+     * @returns The signing account (with private key loaded) or undefined if no matching wallet or account was found
+     */
+    getWalletAccount(walletName: string, predicate?: (account: Record<string, any>) => boolean, sender?: string): Promise<(TransactionSignerAccount & {
+        account: SigningAccount;
+    }) | undefined>;
+    /**
+     * Gets an account with private key loaded from a KMD wallet of the given name, or alternatively creates one with funds in it via a KMD wallet of the given name.
+     *
+     * This is useful to get idempotent accounts from LocalNet without having to specify the private key (which will change when resetting the LocalNet).
+     *
+     * This significantly speeds up local dev time and improves experience since you can write code that *just works* first go without manual config in a fresh LocalNet.
+     *
+     * If this is used via `mnemonicAccountFromEnvironment`, then you can even use the same code that runs on production without changes for local development!
+     *
+     * @param name The name of the wallet to retrieve / create
+     * @param fundWith The number of Algos to fund the account with when it gets created, if not specified then 1000 Algos will be funded from the dispenser account
+     *
+     * @example
+     * ```typescript
+     * // Idempotently get (if exists) or crate (if it doesn't exist yet) an account by name using KMD
+     * // if creating it then fund it with 2 Algos from the default dispenser account
+     * const newAccount = await kmdAccountManager.getOrCreateWalletAccount('account1', (2).algos())
+     * // This will return the same account as above since the name matches
+     * const existingAccount = await kmdAccountManager.getOrCreateWalletAccount('account1')
+     * ```
+     *
+     * @returns An Algorand account with private key loaded - either one that already existed in the given KMD wallet, or a new one that is funded for you
+     */
+    getOrCreateWalletAccount(name: string, fundWith?: AlgoAmount): Promise<TransactionSignerAccount & {
+        account: SigningAccount;
+    }>;
+    /**
+     * Returns an Algorand account with private key loaded for the default LocalNet dispenser account (that can be used to fund other accounts).
+     * @example
+     * ```typescript
+     * const dispenser = await kmdAccountManager.getLocalNetDispenserAccount()
+     * ```
+     * @returns The default LocalNet dispenser account
+     */
+    getLocalNetDispenserAccount(): Promise<TransactionSignerAccount & {
+        account: SigningAccount;
+    }>;
+}
+//# sourceMappingURL=kmd-account-manager.d.ts.map

package/types/kmd-account-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kmd-account-manager.d.ts","sourceRoot":"","sources":["../../src/types/kmd-account-manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAA;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGhD;gEACgE;AAChE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,cAAc,CAAe;IAErC;;;OAGG;gBACS,aAAa,EAAE,aAAa;IAIxC;;;;;;;;;;;;;;;OAeG;IACU,gBAAgB,CAC3B,UAAU,EAAE,MAAM,EAElB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,EACrD,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,wBAAwB,GAAG;QAAE,OAAO,EAAE,cAAc,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;IA2ChF;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACU,wBAAwB,CACnC,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,UAAU,GACpB,OAAO,CAAC,wBAAwB,GAAG;QAAE,OAAO,EAAE,cAAc,CAAA;KAAE,CAAC;IAuClE;;;;;;;OAOG;IACU,2BAA2B;;;CAazC"}

package/types/kmd-account-manager.js

@@ -0,0 +1,144 @@
+'use strict';
+
+var algosdk = require('algosdk');
+var config = require('../config.js');
+var types_account = require('./account.js');
+var types_amount = require('./amount.js');
+var types_composer = require('./composer.js');
+
+/** Provides abstractions over a [KMD](https://github.com/algorand/go-algorand/blob/master/daemon/kmd/README.md) instance
+ * that makes it easier to get and manage accounts using KMD. */
+class KmdAccountManager {
+    /**
+     * Create a new KMD manager.
+     * @param clientManager A ClientManager client to use for algod and kmd clients
+     */
+    constructor(clientManager) {
+        this._clientManager = clientManager;
+    }
+    /**
+     * Returns an Algorand signing account with private key loaded from the given KMD wallet (identified by name).
+     *
+     * @param walletName The name of the wallet to retrieve an account from
+     * @param predicate An optional filter to use to find the account (otherwise it will return a random account from the wallet)
+     * @param sender The optional sender address to use this signer for (aka a rekeyed account)
+     * @example Get default funded account in a LocalNet
+     *
+     * ```typescript
+     * const defaultDispenserAccount = await kmdAccountManager.getWalletAccount(
+     *   'unencrypted-default-wallet',
+     *   a => a.status !== 'Offline' && a.amount > 1_000_000_000
+     * )
+     * ```
+     * @returns The signing account (with private key loaded) or undefined if no matching wallet or account was found
+     */
+    async getWalletAccount(walletName, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    predicate, sender) {
+        const walletsResponse = await this._clientManager.kmd.listWallets();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const wallet = walletsResponse.wallets.filter((w) => w.name === walletName);
+        if (wallet.length === 0) {
+            return undefined;
+        }
+        const walletId = wallet[0].id;
+        const walletHandle = (await this._clientManager.kmd.initWalletHandle(walletId, '')).wallet_handle_token;
+        const addresses = (await this._clientManager.kmd.listKeys(walletHandle)).addresses;
+        let i = 0;
+        if (predicate) {
+            for (i = 0; i < addresses.length; i++) {
+                const address = addresses[i];
+                const account = await this._clientManager.algod.accountInformation(address).do();
+                if (predicate(account)) {
+                    break;
+                }
+            }
+        }
+        if (i >= addresses.length) {
+            return undefined;
+        }
+        const accountKey = (await this._clientManager.kmd.exportKey(walletHandle, '', addresses[i])).private_key;
+        const accountMnemonic = algosdk.secretKeyToMnemonic(accountKey);
+        const account = algosdk.mnemonicToSecretKey(accountMnemonic);
+        const signingAccount = new types_account.SigningAccount(account, sender);
+        return {
+            account: signingAccount,
+            addr: signingAccount.addr,
+            signer: signingAccount.signer,
+        };
+    }
+    /**
+     * Gets an account with private key loaded from a KMD wallet of the given name, or alternatively creates one with funds in it via a KMD wallet of the given name.
+     *
+     * This is useful to get idempotent accounts from LocalNet without having to specify the private key (which will change when resetting the LocalNet).
+     *
+     * This significantly speeds up local dev time and improves experience since you can write code that *just works* first go without manual config in a fresh LocalNet.
+     *
+     * If this is used via `mnemonicAccountFromEnvironment`, then you can even use the same code that runs on production without changes for local development!
+     *
+     * @param name The name of the wallet to retrieve / create
+     * @param fundWith The number of Algos to fund the account with when it gets created, if not specified then 1000 Algos will be funded from the dispenser account
+     *
+     * @example
+     * ```typescript
+     * // Idempotently get (if exists) or crate (if it doesn't exist yet) an account by name using KMD
+     * // if creating it then fund it with 2 Algos from the default dispenser account
+     * const newAccount = await kmdAccountManager.getOrCreateWalletAccount('account1', (2).algos())
+     * // This will return the same account as above since the name matches
+     * const existingAccount = await kmdAccountManager.getOrCreateWalletAccount('account1')
+     * ```
+     *
+     * @returns An Algorand account with private key loaded - either one that already existed in the given KMD wallet, or a new one that is funded for you
+     */
+    async getOrCreateWalletAccount(name, fundWith) {
+        // Get an existing account from the KMD wallet
+        const existing = await this.getWalletAccount(name);
+        if (existing) {
+            return existing;
+        }
+        // None existed: create the KMD wallet instead
+        const walletId = (await this._clientManager.kmd.createWallet(name, '')).wallet.id;
+        const walletHandle = (await this._clientManager.kmd.initWalletHandle(walletId, '')).wallet_handle_token;
+        await this._clientManager.kmd.generateKey(walletHandle);
+        // Get the account from the new KMD wallet
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        const account = (await this.getWalletAccount(name));
+        config.Config.logger.info(`LocalNet account '${name}' doesn't yet exist; created account ${account.addr} with keys stored in KMD and funding with ${fundWith?.algos ?? 1000} ALGOs`);
+        // Fund the account from the dispenser
+        const dispenser = await this.getLocalNetDispenserAccount();
+        await new types_composer({
+            algod: this._clientManager.algod,
+            getSigner: () => dispenser.signer,
+            getSuggestedParams: () => this._clientManager.algod.getTransactionParams().do(),
+        })
+            .addPayment({
+            amount: fundWith ?? types_amount.AlgoAmount.Algos(1000),
+            receiver: account.addr,
+            sender: dispenser.addr,
+        })
+            .execute();
+        return account;
+    }
+    /**
+     * Returns an Algorand account with private key loaded for the default LocalNet dispenser account (that can be used to fund other accounts).
+     * @example
+     * ```typescript
+     * const dispenser = await kmdAccountManager.getLocalNetDispenserAccount()
+     * ```
+     * @returns The default LocalNet dispenser account
+     */
+    async getLocalNetDispenserAccount() {
+        if (!(await this._clientManager.isLocalNet())) {
+            throw new Error("Can't get LocalNet dispenser account from non LocalNet network");
+        }
+        const dispenser = await this.getWalletAccount('unencrypted-default-wallet', (a) => a.status !== 'Offline' && a.amount > 1000000000);
+        if (!dispenser) {
+            throw new Error("Error retrieving LocalNet dispenser account; couldn't find the default account in KMD");
+        }
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        return dispenser;
+    }
+}
+
+exports.KmdAccountManager = KmdAccountManager;
+//# sourceMappingURL=kmd-account-manager.js.map

package/types/kmd-account-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kmd-account-manager.js","sources":["../../src/types/kmd-account-manager.ts"],"sourcesContent":[null],"names":["SigningAccount","Config","AlgokitComposer","AlgoAmount"],"mappings":"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"}