algosdk 1.13.0-beta.2 → 1.13.0

package/dist/cjs/src/client/v2/indexer/lookupAssetBalances.js

@@ -5,6 +5,18 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const jsonrequest_1 = __importDefault(require("../jsonrequest"));
 class LookupAssetBalances extends jsonrequest_1.default {
+    /**
+     * Returns the list of accounts which hold the given asset and their balance.
+     *
+     * #### Example
+     * ```typescript
+     * const assetId = 163650;
+     * const assetBalances = await indexerClient.lookupAssetBalances(assetId).do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/indexer/#get-v2assetsasset-idbalances)
+     * @param index - The asset ID to look up.
+     */
     constructor(c, intDecoding, index) {
         super(c, intDecoding);
         this.index = index;
@@ -13,32 +25,112 @@ class LookupAssetBalances extends jsonrequest_1.default {
     path() {
         return `/v2/assets/${this.index}/balances`;
     }
-    // limit for filter, as int
+    /**
+     * Add a limit for filter.
+     *
+     * #### Example
+     * ```typescript
+     * const assetId = 163650;
+     * const maxResults = 20;
+     * const assetBalances = await indexerClient
+     *        .lookupAssetBalances(assetId)
+     *        .limit(maxResults)
+     *        .do();
+     * ```
+     *
+     * @param limit - maximum number of results to return.
+     */
     limit(limit) {
         this.query.limit = limit;
         return this;
     }
-    // round to filter with, as int
+    /**
+     * Specify round to filter with.
+     *
+     * #### Example
+     * ```typescript
+     * const assetId = 163650;
+     * const targetBlock = 18309917;
+     * const assetBalances = await indexerClient
+     *        .lookupAssetBalances(assetId)
+     *        .round(targetBlock)
+     *        .do();
+     * ```
+     * @param round
+     */
     round(round) {
         this.query.round = round;
         return this;
     }
-    // filtered results should have an amount greater than this value, as int, with units representing the asset
+    /**
+     * Filtered results should have an asset balance greater than this value.
+     *
+     * #### Example
+     * ```typescript
+     * const assetId = 163650;
+     * const minBalance = 1000000;
+     * const assetBalances = await indexerClient
+     *        .lookupAssetBalances(assetId)
+     *        .currencyGreaterThan(minBalance)
+     *        .do();
+     * ```
+     * @param greater
+     */
     currencyGreaterThan(greater) {
         this.query['currency-greater-than'] = greater;
         return this;
     }
-    // filtered results should have an amount less than this value, as int, with units representing the asset units
+    /**
+     * Filtered results should have an asset balance less than this value.
+     *
+     * #### Example
+     * ```typescript
+     * const assetId = 163650;
+     * const maxBalance = 2000000;
+     * const assetBalances = await indexerClient
+     *        .lookupAssetBalances(assetId)
+     *        .currencyLessThan(maxBalance)
+     *        .do();
+     * ```
+     * @param lesser
+     */
     currencyLessThan(lesser) {
         this.query['currency-less-than'] = lesser;
         return this;
     }
-    // used for pagination
+    /**
+     * Specify the next page of results.
+     *
+     * #### Example
+     * ```typescript
+     * const assetId = 163650;
+     * const maxResults = 20;
+     * const nextToken = "APA6C7C3NCANRPIBUWQOF7WSKLJMK6RPQUVFLLDV4U5WCQE4DEF26D4E3E";
+     * const assetBalances = await indexerClient
+     *        .lookupAssetBalances(assetId)
+     *        .limit(maxResults)
+     *        .next(nextToken)
+     *        .do();
+     * ```
+     * @param nextToken - provided by the previous results.
+     */
     nextToken(nextToken) {
         this.query.next = nextToken;
         return this;
     }
-    // include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates
+    /**
+     * Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates
+     *
+     * #### Example
+     * ```typescript
+     * const assetId = 163650;
+     * const assetBalances = await indexerClient
+     *        .lookupAssetBalances(assetId)
+     *        .includeAll(false)
+     *        .do();
+     * ```
+     * @param value
+     */
     includeAll(value = true) {
         this.query['include-all'] = value;
         return this;

package/dist/cjs/src/client/v2/indexer/lookupAssetBalances.js.map

@@ -1 +1 @@
-{"version":3,"file":"lookupAssetBalances.js","sourceRoot":"","sources":["../../../../../../src/client/v2/indexer/lookupAssetBalances.ts"],"names":[],"mappings":";;;;;AAAA,iEAAyC;AAIzC,MAAqB,mBAAoB,SAAQ,qBAAW;IAC1D,YAAY,CAAa,EAAE,WAAwB,EAAU,KAAa;QACxE,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QADqC,UAAK,GAAL,KAAK,CAAQ;QAExE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,IAAI;QACF,OAAO,cAAc,IAAI,CAAC,KAAK,WAAW,CAAC;IAC7C,CAAC;IAED,2BAA2B;IAC3B,KAAK,CAAC,KAAa;QACjB,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+BAA+B;IAC/B,KAAK,CAAC,KAAa;QACjB,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4GAA4G;IAC5G,mBAAmB,CAAC,OAAe;QACjC,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+GAA+G;IAC/G,gBAAgB,CAAC,MAAc;QAC7B,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,GAAG,MAAM,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sBAAsB;IACtB,SAAS,CAAC,SAAiB;QACzB,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wJAAwJ;IACxJ,UAAU,CAAC,KAAK,GAAG,IAAI;QACrB,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AA7CD,sCA6CC"}
+{"version":3,"file":"lookupAssetBalances.js","sourceRoot":"","sources":["../../../../../../src/client/v2/indexer/lookupAssetBalances.ts"],"names":[],"mappings":";;;;;AAAA,iEAAyC;AAIzC,MAAqB,mBAAoB,SAAQ,qBAAW;IAC1D;;;;;;;;;;;OAWG;IACH,YAAY,CAAa,EAAE,WAAwB,EAAU,KAAa;QACxE,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QADqC,UAAK,GAAL,KAAK,CAAQ;QAExE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,IAAI;QACF,OAAO,cAAc,IAAI,CAAC,KAAK,WAAW,CAAC;IAC7C,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,KAAa;QACjB,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,KAAa;QACjB,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,mBAAmB,CAAC,OAAe;QACjC,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CAAC,MAAc;QAC7B,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,GAAG,MAAM,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,SAAiB;QACzB,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,KAAK,GAAG,IAAI;QACrB,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAzID,sCAyIC"}

package/dist/cjs/src/client/v2/serviceClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"serviceClient.js","sourceRoot":"","sources":["../../../../../src/client/v2/serviceClient.ts"],"names":[],"mappings":";;;;;AAAA,uDAAmC;AACnC,0EAAkD;AAUlD;;;;GAIG;AACH,SAAS,+BAA+B,CACtC,QAAgB,EAAE,EAClB,gBAAuC;IAEvC,MAAM,WAAW,GAAG,EAAE,CAAC;IACvB,WAAW,CAAC,gBAAgB,CAAC,GAAG,KAAK,CAAC;IACtC,OAAO,WAA0B,CAAC;AACpC,CAAC;AAED,SAAS,gBAAgB,CACvB,GAA0C;IAE1C,OAAO,OAAQ,GAAsB,CAAC,GAAG,KAAK,UAAU,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAA8B,aAAa;IAIzC,YACE,qBAA4C,EAC5C,4BAAmE,EACnE,UAAkB,EAClB,IAAsB,EACtB,iBAAsC,EAAE;QAExC,IAAI,gBAAgB,CAAC,4BAA4B,CAAC,EAAE;YAClD,6BAA6B;YAC7B,IAAI,CAAC,CAAC,GAAG,IAAI,gBAAU,CAAC,4BAA4B,CAAC,CAAC;SACvD;aAAM;YACL,0CAA0C;YAC1C,qEAAqE;YACrE,IAAI,WAAwB,CAAC;YAC7B,IAAI,OAAO,4BAA4B,KAAK,QAAQ,EAAE;gBACpD,WAAW,GAAG,+BAA+B,CAC3C,4BAA4B,EAC5B,qBAAqB,CACtB,CAAC;aACH;iBAAM;gBACL,WAAW,GAAG,4BAA4B,CAAC;aAC5C;YAED,IAAI,CAAC,CAAC,GAAG,IAAI,gBAAU,CAAC,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;SACxE;QAED,IAAI,CAAC,WAAW,GAAG,qBAAW,CAAC,OAAO,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,MAAmB;QAChC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;CACF;AAjDD,gCAiDC"}
+{"version":3,"file":"serviceClient.js","sourceRoot":"","sources":["../../../../../src/client/v2/serviceClient.ts"],"names":[],"mappings":";;;;;AAAA,uDAAmC;AACnC,0EAAkD;AAUlD;;;;GAIG;AACH,SAAS,+BAA+B,CACtC,QAAgB,EAAE,EAClB,gBAAuC;IAEvC,MAAM,WAAW,GAAG,EAAE,CAAC;IACvB,WAAW,CAAC,gBAAgB,CAAC,GAAG,KAAK,CAAC;IACtC,OAAO,WAA0B,CAAC;AACpC,CAAC;AAED,SAAS,gBAAgB,CACvB,GAA0C;IAE1C,OAAO,OAAQ,GAAsB,CAAC,GAAG,KAAK,UAAU,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAA8B,aAAa;IAMzC,YACE,qBAA4C,EAC5C,4BAAmE,EACnE,UAAkB,EAClB,IAAsB,EACtB,iBAAsC,EAAE;QAExC,IAAI,gBAAgB,CAAC,4BAA4B,CAAC,EAAE;YAClD,6BAA6B;YAC7B,IAAI,CAAC,CAAC,GAAG,IAAI,gBAAU,CAAC,4BAA4B,CAAC,CAAC;SACvD;aAAM;YACL,0CAA0C;YAC1C,qEAAqE;YACrE,IAAI,WAAwB,CAAC;YAC7B,IAAI,OAAO,4BAA4B,KAAK,QAAQ,EAAE;gBACpD,WAAW,GAAG,+BAA+B,CAC3C,4BAA4B,EAC5B,qBAAqB,CACtB,CAAC;aACH;iBAAM;gBACL,WAAW,GAAG,4BAA4B,CAAC;aAC5C;YAED,IAAI,CAAC,CAAC,GAAG,IAAI,gBAAU,CAAC,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;SACxE;QAED,IAAI,CAAC,WAAW,GAAG,qBAAW,CAAC,OAAO,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,MAAmB;QAChC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;CACF;AAnDD,gCAmDC"}

package/dist/cjs/src/dryrun.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDryrun = void 0;
+const types_1 = require("./client/v2/algod/models/types");
+const transactions_1 = require("./types/transactions");
+const address_1 = require("./encoding/address");
+const defaultAppId = 1380011588;
+function decodePrograms(ap) {
+    // eslint-disable-next-line no-param-reassign
+    ap.params['approval-program'] = Buffer.from(ap.params['approval-program'].toString(), 'base64');
+    // eslint-disable-next-line no-param-reassign
+    ap.params['clear-state-program'] = Buffer.from(ap.params['clear-state-program'].toString(), 'base64');
+    return ap;
+}
+/**
+ * createDryrun takes an Algod Client (from algod.AlgodV2Client) and an array of Signed Transactions
+ * from (transaction.SignedTransaction) and creates a DryrunRequest object with relevant balances
+ * @param client - the AlgodClient to make requests against
+ * @param txns - the array of SignedTransaction to use for generating the DryrunRequest object
+ * @param protocolVersion - the string representing the protocol version to use
+ * @param latestTimestamp - the timestamp
+ * @returns the DryrunRequest object constructed from the SignedTransactions passed
+ */
+async function createDryrun({ client, txns, protocolVersion, latestTimestamp, round, sources, }) {
+    const appInfos = [];
+    const acctInfos = [];
+    const apps = [];
+    const assets = [];
+    const accts = [];
+    for (const t of txns) {
+        if (t.txn.type === transactions_1.TransactionType.appl) {
+            accts.push(address_1.encodeAddress(t.txn.from.publicKey));
+            if (t.txn.appAccounts)
+                accts.push(...t.txn.appAccounts.map((a) => address_1.encodeAddress(a.publicKey)));
+            if (t.txn.appForeignApps)
+                apps.push(...t.txn.appForeignApps);
+            if (t.txn.appForeignAssets)
+                assets.push(...t.txn.appForeignAssets);
+            // Create application,
+            if (t.txn.appIndex === 0) {
+                appInfos.push(new types_1.Application(defaultAppId, new types_1.ApplicationParams({
+                    creator: address_1.encodeAddress(t.txn.from.publicKey),
+                    approvalProgram: t.txn.appApprovalProgram,
+                    clearStateProgram: t.txn.appClearProgram,
+                    localStateSchema: new types_1.ApplicationStateSchema(t.txn.appLocalInts, t.txn.appLocalByteSlices),
+                    globalStateSchema: new types_1.ApplicationStateSchema(t.txn.appGlobalInts, t.txn.appGlobalByteSlices),
+                })));
+            }
+            else {
+                apps.push(t.txn.appIndex);
+                accts.push(address_1.getApplicationAddress(t.txn.appIndex));
+            }
+        }
+    }
+    // Dedupe and add creator to accts array
+    const assetPromises = [];
+    for (const assetId of [...new Set(assets)]) {
+        assetPromises.push(client
+            .getAssetByID(assetId)
+            .do()
+            .then((assetInfo) => {
+            accts.push(assetInfo.params.creator);
+        }));
+    }
+    // Wait for assets to finish since we append to accts array
+    await Promise.all(assetPromises);
+    // Dedupe and get app info for all apps
+    const appPromises = [];
+    for (const appId of [...new Set(apps)]) {
+        appPromises.push(client
+            .getApplicationByID(appId)
+            .do()
+            .then((appInfo) => {
+            const ai = decodePrograms(appInfo);
+            appInfos.push(ai);
+        }));
+    }
+    const acctPromises = [];
+    for (const acct of [...new Set(accts)]) {
+        acctPromises.push(client
+            .accountInformation(acct)
+            .do()
+            .then((acctInfo) => {
+            if ('created-apps' in acctInfo) {
+                // eslint-disable-next-line no-param-reassign
+                acctInfo['created-apps'] = acctInfo['created-apps'].map((app) => decodePrograms(app));
+            }
+            acctInfos.push(acctInfo);
+        }));
+    }
+    await Promise.all([...appPromises, ...acctPromises]);
+    return new types_1.DryrunRequest({
+        txns: txns.map((st) => ({ ...st, txn: st.txn.get_obj_for_encoding() })),
+        accounts: acctInfos,
+        apps: appInfos,
+        latestTimestamp,
+        round,
+        protocolVersion,
+        sources,
+    });
+}
+exports.createDryrun = createDryrun;
+//# sourceMappingURL=dryrun.js.map

package/dist/cjs/src/dryrun.js.map

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

package/dist/cjs/src/main.js

@@ -176,6 +176,7 @@ Object.defineProperty(exports, "mergeMultisigTransactions", { enumerable: true,
 Object.defineProperty(exports, "appendSignMultisigTransaction", { enumerable: true, get: function () { return multisig_1.appendSignMultisigTransaction; } });
 Object.defineProperty(exports, "multisigAddress", { enumerable: true, get: function () { return multisig_1.multisigAddress; } });
 exports.LogicTemplates = LogicTemplatesCommonJSExport.default;
+__exportStar(require("./dryrun"), exports);
 __exportStar(require("./makeTxn"), exports);
 __exportStar(require("./transaction"), exports);
 __exportStar(require("./signer"), exports);

package/dist/cjs/src/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/main.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/main.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,0DAA4C;AAC5C,4DAA8C;AAC9C,8DAAgD;AAChD,0DAA4C;AAC5C,+EAAiE;AACjE,gDAAwC;AACxC,mDAAqC;AACrC,qDAAuC;AAEvC,MAAM,iBAAiB,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO;AAExD,SAAS;AACI,QAAA,6BAA6B,GACxC,oEAAoE,CAAC;AAEvE;;;;;;;;;;;;;;GAcG;AACH,SAAgB,eAAe,CAC7B,GAA+B,EAC/B,EAAc;IAEd,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE;QACnC,wCAAwC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;QAC1C,6CAA6C;QAC7C,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;KACjD;IACD,MAAM,OAAO,GAAG,UAAU,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAEvD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;QAC/B,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;KAC1B,CAAC;AACJ,CAAC;AAhBD,0CAgBC;AAED;;;;;;GAMG;AACH,SAAgB,OAAO,CAAC,GAAe,EAAE,EAAc;IACrD,MAAM,SAAS,GAAG,IAAI,aAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC/B,CAAC;AAHD,0BAGC;AAED;;;;;;GAMG;AACH,SAAgB,SAAS,CAAC,KAAiB,EAAE,EAAc;IACzD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC,CAAC;IAC7E,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACtC,OAAO,GAAG,CAAC;AACb,CAAC;AAJD,8BAIC;AAED;;;;;;;GAOG;AACH,SAAgB,WAAW,CACzB,KAAiB,EACjB,SAAqB,EACrB,IAAY;IAEZ,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAC9B,KAAK,CAAC,YAAY,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAC7C,CAAC;IACF,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC;IACjD,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;AAClD,CAAC;AAVD,kCAUC;AAED;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,CAAwC;IAChE,OAAO,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5C,CAAC;AAFD,8BAEC;AAED;;;;GAIG;AACH,SAAgB,SAAS,CAAC,CAAoB;IAC5C,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC;AAFD,8BAEC;AAEY,QAAA,yBAAyB,GAAG,IAAI,KAAK,CAChD,qCAA6B,CAC9B,CAAC;AACW,QAAA,wBAAwB,GAAG,IAAI,KAAK,CAC/C,OAAO,CAAC,4BAA4B,CACrC,CAAC;AAEF,iDAA+B;AAC/B,iDAA6D;AAApD,iHAAA,OAAO,OAAW;AAC3B,oCAA8C;AAArC,2GAAA,OAAO,OAAO;AACvB,mDAA6D;AAApD,2HAAA,OAAO,OAAe;AAE/B,uDAAiE;AAAxD,mHAAA,OAAO,OAAW;AAM3B,+BAA6C;AAApC,2GAAA,mBAAmB,OAAA;AAC5B,8CAK4B;AAJ1B,yGAAA,cAAc,OAAA;AACd,wGAAA,aAAa,OAAA;AACb,wGAAA,aAAa,OAAA;AACb,gHAAA,qBAAqB,OAAA;AAEvB,4CAA+D;AAAtD,sGAAA,YAAY,OAAA;AAAE,sGAAA,YAAY,OAAA;AACnC,qCAAuD;AAA9C,2HAAA,OAAO,OAAmB;AACnC,2EAA2D;AAC3D,gDAO6B;AAN3B,yHAAA,6BAA6B,OAAA;AAC7B,yHAAA,6BAA6B,OAAA;AAC7B,+GAAA,mBAAmB,OAAA;AACnB,+GAAA,mBAAmB,OAAA;AACnB,4GAAA,gBAAgB,OAAA;AAChB,4GAAA,gBAAgB,OAAA;AAElB,qCAImB;AAHjB,4GAAA,iBAAiB,OAAA;AACjB,4GAAA,iBAAiB,OAAA;AACjB,uHAAA,4BAA4B,OAAA;AAE9B,iCAAwD;AAA/C,uGAAA,cAAc,OAAA;AAAE,sGAAA,aAAa,OAAA;AACtC,uCAQoB;AAPlB,2GAAA,eAAe,OAAA;AACf,wGAAA,YAAY,OAAA;AACZ,mHAAA,uBAAuB,OAAA;AACvB,yHAAA,6BAA6B,OAAA;AAC7B,4GAAA,gBAAgB,OAAA;AAChB,oGAAA,QAAQ,OAAA;AACR,+GAAA,mBAAmB,OAAA;AAErB,uCAKoB;AAJlB,mHAAA,uBAAuB,OAAA;AACvB,qHAAA,yBAAyB,OAAA;AACzB,yHAAA,6BAA6B,OAAA;AAC7B,2GAAA,eAAe,OAAA;AAEJ,QAAA,cAAc,GAAG,4BAA4B,CAAC,OAAO,CAAC;AAEnE,2CAAyB;AACzB,4CAA0B;AAC1B,gDAA8B;AAC9B,2CAAyB;AACzB,6CAA2B;AAC3B,0CAAwB;AACxB,wCAAsB"}

package/dist/esm/src/client/v2/algod/algod.js

@@ -17,115 +17,363 @@ import Supply from './supply';
 import Versions from './versions';
 import Genesis from './genesis';
 import Proof from './proof';
+/**
+ * Algod client connects an application to the Algorand blockchain. The algod client requires a valid algod REST endpoint IP address and algod token from an Algorand node that is connected to the network you plan to interact with.
+ *
+ * Algod is the main Algorand process for handling the blockchain. Messages between nodes are processed, the protocol steps are executed, and the blocks are written to disk. The algod process also exposes a REST API server that developers can use to communicate with the node and the network. Algod uses the data directory for storage and configuration information.
+ *
+ * #### Relevant Information
+ * [How do I obtain an algod address and token?](https://developer.algorand.org/docs/archive/build-apps/setup/?from_query=algod#how-do-i-obtain-an-algod-address-and-token)
+ *
+ * [Run Algod in Postman OAS3](https://developer.algorand.org/docs/rest-apis/restendpoints/?from_query=algod#algod-indexer-and-kmd-rest-endpoints)
+ */
 export default class AlgodClient extends ServiceClient {
     /**
      * Create an AlgodClient from
      * * either a token, baseServer, port, and optional headers
      * * or a base client server for interoperability with external dApp wallets
+     *
+     * #### Example
+     * ```typescript
+     * const token  = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
+     * const server = "http://localhost";
+     * const port   = 4001;
+     * const algodClient = new algosdk.Algodv2(token, server, port);
+     * ```
+     * @remarks
+     * The above configuration is for a sandbox private network.
+     * For applications on production, you are encouraged to run your own node, or use an Algorand REST API provider with a dedicated API key.
+     *
+     * @param tokenOrBaseClient - The algod token from the Algorand node you are interacting with
+     * @param baseServer - REST endpoint
+     * @param port - Port number if specifically configured by the server
+     * @param headers - Optional headers
      */
     constructor(tokenOrBaseClient, baseServer = 'http://r2.algorand.network', port = 4180, headers = {}) {
         super('X-Algo-API-Token', tokenOrBaseClient, baseServer, port, headers);
     }
+    /**
+     * Returns OK if healthy.
+     *
+     * #### Example
+     * ```typescript
+     * const health = await algodClient.healthCheck().do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-health)
+     * @category GET
+     */
     healthCheck() {
         return new HealthCheck(this.c);
     }
+    /**
+     * Retrieves the supported API versions, binary build versions, and genesis information.
+     *
+     * #### Example
+     * ```typescript
+     * const versionsDetails = await algodClient.versionsCheck().do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-versions)
+     * @category GET
+     */
     versionsCheck() {
         return new Versions(this.c);
     }
+    /**
+     * Broadcasts a raw transaction to the network.
+     *
+     * #### Example
+     * ```typescript
+     * const { txId } = await algodClient.sendRawTransaction(signedTxns).do();
+     * const result = await waitForConfirmation(algodClient, txid, 3);
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#post-v2transactions)
+     *
+     * @remarks
+     * Often used with {@linkcode waitForConfirmation}
+     * @param stxOrStxs - Signed transactions
+     * @category POST
+     */
     sendRawTransaction(stxOrStxs) {
         return new SendRawTransaction(this.c, stxOrStxs);
     }
     /**
-     * Returns the given account's information.
+     * Returns the given account's status, balance and spendable amounts.
+     *
+     * #### Example
+     * ```typescript
+     * const address = "XBYLS2E6YI6XXL5BWCAMOA4GTWHXWENZMX5UHXMRNWWUQ7BXCY5WC5TEPA";
+     * const accountInfo = await algodClient.accountInformation(address).do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2accountsaddress)
      * @param account - The address of the account to look up.
+     * @category GET
      */
     accountInformation(account) {
         return new AccountInformation(this.c, this.intDecoding, account);
     }
     /**
      * Gets the block info for the given round.
+     *
+     * #### Example
+     * ```typescript
+     * const roundNumber = 18038133;
+     * const block = await algodClient.block(roundNumber).do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2blocksround)
      * @param roundNumber - The round number of the block to get.
+     * @category GET
      */
     block(roundNumber) {
         return new Block(this.c, roundNumber);
     }
     /**
      * Returns the transaction information for a specific pending transaction.
+     *
+     * #### Example
+     * ```typescript
+     * const txId = "DRJS6R745A7GFVMXEXWP4TGVDGKW7VILFTA7HC2BR2GRLHNY5CTA";
+     * const pending = await algodClient.pendingTransactionInformation(txId).do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2transactionspendingtxid)
+     *
+     * @remarks
+     * <br><br>
+     * There are several cases when this might succeed:
+     * - transaction committed (committed round > 0)
+     * - transaction still in the pool (committed round = 0, pool error = "")
+     * - transaction removed from pool due to error (committed round = 0, pool error != "")
+     *
+     * Or the transaction may have happened sufficiently long ago that the node no longer remembers it, and this will return an error.
+     *
      * @param txid - The TxID string of the pending transaction to look up.
+     * @category GET
      */
     pendingTransactionInformation(txid) {
         return new PendingTransactionInformation(this.c, txid);
     }
     /**
-     * Returns transactions that are pending in the pool.
+     * Returns the list of pending transactions in the pool, sorted by priority, in decreasing order, truncated at the end at MAX.
+     * If MAX = 0, returns all pending transactions.
+     *
+     * #### Example 1
+     * ```typescript
+     * const pendingTxns = await algodClient.pendingTransactionsInformation().do();
+     * ```
+     *
+     * #### Example 2
+     * ```typescript
+     * const maxTxns = 5;
+     * const pendingTxns = await algodClient
+     *     .pendingTransactionsInformation()
+     *     .max(maxTxns)
+     *     .do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2transactionspending)
+     * @category GET
      */
     pendingTransactionsInformation() {
         return new PendingTransactions(this.c);
     }
     /**
-     * Returns transactions that are pending in the pool sent by a specific sender.
+     * Returns the list of pending transactions sent by the address, sorted by priority, in decreasing order, truncated at the end at MAX.
+     * If MAX = 0, returns all pending transactions.
+     *
+     * #### Example 1
+     * ```typescript
+     * const address = "XBYLS2E6YI6XXL5BWCAMOA4GTWHXWENZMX5UHXMRNWWUQ7BXCY5WC5TEPA";
+     * const pendingTxnsByAddr = await algodClient.pendingTransactionByAddress(address).do();
+     * ```
+     *
+     * #### Example 2
+     * ```typescript
+     * const maxTxns = 5;
+     * const address = "XBYLS2E6YI6XXL5BWCAMOA4GTWHXWENZMX5UHXMRNWWUQ7BXCY5WC5TEPA";
+     * const pendingTxns = await algodClient
+     *     .pendingTransactionByAddress(address)
+     *     .max(maxTxns)
+     *     .do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2accountsaddresstransactionspending)
      * @param address - The address of the sender.
+     * @category GET
      */
     pendingTransactionByAddress(address) {
         return new PendingTransactionsByAddress(this.c, address);
     }
     /**
      * Retrieves the StatusResponse from the running node.
+     *
+     * #### Example
+     * ```typescript
+     * const status = await algodClient.status().do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2status)
+     * @category GET
      */
     status() {
         return new Status(this.c, this.intDecoding);
     }
     /**
-     * Waits for a specific round to occur then returns the StatusResponse for that round.
+     * Waits for a specific round to occur then returns the `StatusResponse` for that round.
+     *
+     * #### Example
+     * ```typescript
+     * const round = 18038133;
+     * const statusAfterBlock = await algodClient.statusAfterBlock(round).do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2statuswait-for-block-afterround)
      * @param round - The number of the round to wait for.
+     * @category GET
      */
     statusAfterBlock(round) {
         return new StatusAfterBlock(this.c, this.intDecoding, round);
     }
     /**
      * Returns the common needed parameters for a new transaction.
+     *
+     * #### Example
+     * ```typescript
+     * const suggestedParams = await algodClient.getTransactionParams().do();
+     * const amountInMicroAlgos = algosdk.algosToMicroalgos(2); // 2 Algos
+     * const unsignedTxn = algosdk.makePaymentTxnWithSuggestedParamsFromObject({
+     *   from: senderAddress,
+     *   to: receiverAddress,
+     *   amount: amountInMicroAlgos,
+     *   suggestedParams: suggestedParams,
+     * });
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2transactionsparams)
+     *
+     * @remarks
+     * Often used with
+     * {@linkcode makePaymentTxnWithSuggestedParamsFromObject}, {@linkcode algosToMicroalgos}
+     * @category GET
      */
     getTransactionParams() {
         return new SuggestedParams(this.c);
     }
     /**
-     * Gets the supply details for the specified node's ledger.
+     * Returns the supply details for the specified node's ledger.
+     *
+     * #### Example
+     * ```typescript
+     * const supplyDetails = await algodClient.supply().do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2ledgersupply)
+     * @category GET
      */
     supply() {
         return new Supply(this.c, this.intDecoding);
     }
+    /**
+     * Compiles TEAL source code to binary, returns base64 encoded program bytes and base32 SHA512_256 hash of program bytes (Address style).
+     *
+     * #### Example
+     * ```typescript
+     * const source = "TEAL SOURCE CODE";
+     * const compiledSmartContract = await algodClient.compile(source).do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#post-v2tealcompile)
+     * @remarks
+     * This endpoint is only enabled when a node's configuration file sets `EnableDeveloperAPI` to true.
+     * @param source
+     * @category POST
+     */
     compile(source) {
         return new Compile(this.c, source);
     }
+    /**
+     * Provides debugging information for a transaction (or group).
+     *
+     * Executes TEAL program(s) in context and returns debugging information about the execution. This endpoint is only enabled when a node's configureation file sets `EnableDeveloperAPI` to true.
+     *
+     * #### Example
+     * ```typescript
+     * const dryRunResult = await algodClient.dryrun(dr).do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#post-v2tealdryrun)
+     * @param dr
+     * @category POST
+     */
     dryrun(dr) {
         return new Dryrun(this.c, dr);
     }
     /**
      * Given an asset ID, return asset information including creator, name, total supply and
      * special addresses.
+     *
+     * #### Example
+     * ```typescript
+     * const asset_id = 163650;
+     * const asset = await algodClient.getAssetByID(asset_id).do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2assetsasset-id)
      * @param index - The asset ID to look up.
+     * @category GET
      */
     getAssetByID(index) {
         return new GetAssetByID(this.c, this.intDecoding, index);
     }
     /**
-     * Given an application ID, it returns application information including creator, approval
+     * Given an application ID, return the application information including creator, approval
      * and clear programs, global and local schemas, and global state.
+     *
+     * #### Example
+     * ```typescript
+     * const index = 60553466;
+     * const app = await algodClient.getApplicationByID(index).do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2applicationsapplication-id)
      * @param index - The application ID to look up.
+     * @category GET
      */
     getApplicationByID(index) {
         return new GetApplicationByID(this.c, this.intDecoding, index);
     }
     /**
      * Returns the entire genesis file.
+     *
+     * #### Example
+     * ```typescript
+     * const genesis = await algodClient.genesis().do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-genesis)
+     * @category GET
      */
     genesis() {
         return new Genesis(this.c, this.intDecoding);
     }
     /**
-     * Get the proof for a given transaction in a round.
+     * Returns a Merkle proof for a given transaction in a block.
+     *
+     * #### Example
+     * ```typescript
+     * const round = 18038133;
+     * const txId = "MEUOC4RQJB23CQZRFRKYEI6WBO73VTTPST5A7B3S5OKBUY6LFUDA";
+     * const proof = await algodClient.getProof(round, txId).do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2blocksroundtransactionstxidproof)
      * @param round - The round in which the transaction appears.
      * @param txID - The transaction ID for which to generate a proof.
+     * @category GET
      */
     getProof(round, txID) {
         return new Proof(this.c, this.intDecoding, round, txID);