algosdk 1.14.0 → 1.16.0

package/dist/types/src/client/v2/indexer/lookupAssetBalances.d.ts

@@ -16,9 +16,12 @@ export default class LookupAssetBalances extends JSONRequest {
      * @param index - The asset ID to look up.
      */
     constructor(c: HTTPClient, intDecoding: IntDecoding, index: number);
+    /**
+     * @returns `/v2/assets/${index}/balances`
+     */
     path(): string;
     /**
-     * Add a limit for filter.
+     * Limit results for pagination.
      *
      * #### Example
      * ```typescript
@@ -31,23 +34,9 @@ export default class LookupAssetBalances extends JSONRequest {
      * ```
      *
      * @param limit - maximum number of results to return.
+     * @category query
      */
     limit(limit: number): this;
-    /**
-     * 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: number): this;
     /**
      * Filtered results should have an asset balance greater than this value.
      *
@@ -61,6 +50,7 @@ export default class LookupAssetBalances extends JSONRequest {
      *        .do();
      * ```
      * @param greater
+     * @category query
      */
     currencyGreaterThan(greater: number): this;
     /**
@@ -76,6 +66,7 @@ export default class LookupAssetBalances extends JSONRequest {
      *        .do();
      * ```
      * @param lesser
+     * @category query
      */
     currencyLessThan(lesser: number): this;
     /**
@@ -85,20 +76,26 @@ export default class LookupAssetBalances extends JSONRequest {
      * ```typescript
      * const assetId = 163650;
      * const maxResults = 20;
-     * const nextToken = "APA6C7C3NCANRPIBUWQOF7WSKLJMK6RPQUVFLLDV4U5WCQE4DEF26D4E3E";
-     * const assetBalances = await indexerClient
+     *
+     * const assetBalancesPage1 = await indexerClient
      *        .lookupAssetBalances(assetId)
      *        .limit(maxResults)
-     *        .next(nextToken)
+     *        .do();
+     *
+     * const assetBalancesPage2 = await indexerClient
+     *        .lookupAssetBalances(assetId)
+     *        .limit(maxResults)
+     *        .nextToken(assetBalancesPage1["next-token"])
      *        .do();
      * ```
      * @param nextToken - provided by the previous results.
+     * @category query
      */
     nextToken(nextToken: string): 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
+     * #### Example 1
      * ```typescript
      * const assetId = 163650;
      * const assetBalances = await indexerClient
@@ -106,7 +103,18 @@ export default class LookupAssetBalances extends JSONRequest {
      *        .includeAll(false)
      *        .do();
      * ```
+     *
+     * #### Example 2
+     * ```typescript
+     * const assetId = 163650;
+     * const assetBalances = await indexerClient
+     *        .lookupAssetBalances(assetId)
+     *        .includeAll()
+     *        .do();
+     * ```
+     *
      * @param value
+     * @category query
      */
     includeAll(value?: boolean): this;
 }

package/dist/types/src/client/v2/indexer/lookupAssetByID.d.ts

@@ -25,6 +25,7 @@ export default class LookupAssetByID extends JSONRequest {
      *
      * #### Example 1
      * ```typescript
+     * const assetId = 163650;
      * const assetInfo = await indexerClient
      *        .lookupAssetByID(assetId)
      *        .includeAll(false)
@@ -33,6 +34,7 @@ export default class LookupAssetByID extends JSONRequest {
      *
      * #### Example 2
      * ```typescript
+     * const assetId = 163650;
      * const assetInfo = await indexerClient
      *        .lookupAssetByID(assetId)
      *        .includeAll()

package/dist/types/src/client/v2/indexer/lookupAssetTransactions.d.ts

@@ -3,28 +3,325 @@ import HTTPClient from '../../client';
 import IntDecoding from '../../../types/intDecoding';
 export default class LookupAssetTransactions extends JSONRequest {
     private index;
+    /**
+     * Returns transactions relating to the given asset.
+     *
+     * #### Example
+     * ```typescript
+     * const assetId = 163650;
+     * const assetTxns = await indexerClient.lookupAssetTransactions(assetId).do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/indexer/#get-v2assetsasset-idtransactions)
+     * @param index - The asset ID to look up.
+     */
     constructor(c: HTTPClient, intDecoding: IntDecoding, index: number);
+    /**
+     * @returns `/v2/assets/${index}/transactions`
+     */
     path(): string;
     /**
-     * notePrefix to filter with
+     * Specifies a prefix which must be contained in the note field.
+     *
+     * #### Example
+     * ```typescript
+     * const notePrefixBase64Encoded = "Y3JlYXRl";
+     * const assetId = 163650;
+     * const assetTxns = await indexerClient
+     *        .lookupAssetTransactions(assetId)
+     *        .notePrefix(notePrefixBase64Encoded)
+     *        .do();
+     * ```
+     *
      * @param prefix - base64 string or uint8array
+     * @category query
      */
     notePrefix(prefix: Uint8Array | string): this;
+    /**
+     * Type of transaction to filter with.
+     *
+     * #### Example
+     * ```typescript
+     * const assetId = 163650;
+     * const assetTxns = await indexerClient
+     *        .lookupAssetTransactions(assetId)
+     *        .txType("axfer")
+     *        .do();
+     * ```
+     *
+     * @param type - one of `pay`, `keyreg`, `acfg`, `axfer`, `afrz`, `appl`
+     * @category query
+     */
     txType(type: string): this;
+    /**
+     * Type of signature to filter with.
+     * - sig: Standard
+     * - msig: MultiSig
+     * - lsig: LogicSig
+     *
+     * #### Example
+     * ```typescript
+     * const assetId = 163650;
+     * const assetTxns = await indexerClient
+     *        .lookupAssetTransactions(assetId)
+     *        .sigType("lsig")
+     *        .do();
+     * ```
+     *
+     * @param type - one of `sig`, `msig`, `lsig`
+     * @category query
+     */
     sigType(type: string): this;
+    /**
+     * Lookup the specific transaction by ID.
+     *
+     * #### Example
+     * ```typescript
+     * const txId = "MEUOC4RQJB23CQZRFRKYEI6WBO73VTTPST5A7B3S5OKBUY6LFUDA";
+     * const assetId = 163650;
+     * const assetTxns = await indexerClient
+     *        .lookupAssetTransactions(assetId)
+     *        .txid(txId)
+     *        .do();
+     * ```
+     *
+     * @param txid
+     * @category query
+     */
     txid(txid: string): this;
+    /**
+     * Include results for the specified round.
+     *
+     * #### Example
+     * ```typescript
+     * const targetBlock = 18309917;
+     * const assetId = 163650;
+     * const assetTxns = await indexerClient
+     *        .lookupAssetTransactions(assetId)
+     *        .round(targetBlock)
+     *        .do();
+     * ```
+     *
+     * @param round
+     * @category query
+     */
     round(round: number): this;
+    /**
+     * Include results at or after the specified min-round.
+     *
+     * #### Example
+     * ```typescript
+     * const minRound = 18309917;
+     * const assetId = 163650;
+     * const assetTxns = await indexerClient
+     *        .lookupAssetTransactions(assetId)
+     *        .minRound(minRound)
+     *        .do();
+     * ```
+     *
+     * @param round
+     * @category query
+     */
     minRound(round: number): this;
+    /**
+     * Include results at or before the specified max-round.
+     *
+     * #### Example
+     * ```typescript
+     * const maxRound = 18309917;
+     * const assetId = 163650;
+     * const assetTxns = await indexerClient
+     *        .lookupAssetTransactions(assetId)
+     *        .maxRound(maxRound)
+     *        .do();
+     * ```
+     *
+     * @param round
+     * @category query
+     */
     maxRound(round: number): this;
+    /**
+     * @deprecated Redundant query parameter. Asset ID is already passed into the method.
+     */
     assetID(id: number): this;
+    /**
+     * Maximum number of results to return.
+     *
+     * #### Example
+     * ```typescript
+     * const maxResults = 25;
+     * const assetId = 163650;
+     * const assetTxns = await indexerClient
+     *        .lookupAssetTransactions(assetId)
+     *        .limit(maxResults)
+     *        .do();
+     * ```
+     *
+     * @param limit
+     * @category query
+     */
     limit(limit: number): this;
+    /**
+     * Include results before the given time.
+     *
+     * #### Example
+     * ```typescript
+     * const beforeTime = "2022-02-02T20:20:22.02Z";
+     * const assetId = 163650;
+     * const assetTxns = await indexerClient
+     *        .lookupAssetTransactions(assetId)
+     *        .beforeTime(beforeTime)
+     *        .do();
+     * ```
+     *
+     * @param before - rfc3339 string
+     * @category query
+     */
     beforeTime(before: string): this;
+    /**
+     * Include results after the given time.
+     *
+     * #### Example
+     * ```typescript
+     * const afterTime = "2022-10-21T00:00:11.55Z";
+     * const assetId = 163650;
+     * const assetTxns = await indexerClient
+     *        .lookupAssetTransactions(assetId)
+     *        .afterTime(afterTime)
+     *        .do();
+     * ```
+     *
+     * @param after - rfc3339 string
+     * @category query
+     */
     afterTime(after: string): this;
+    /**
+     * Filtered results should have an amount greater than this value, as int, representing asset units.
+     *
+     * #### Example
+     * ```typescript
+     * const minBalance = 300000;
+     * const assetId = 163650;
+     * const assetTxns = await indexerClient
+     *        .lookupAssetTransactions(assetId)
+     *        .currencyGreaterThan(minBalance - 1)
+     *        .do();
+     * ```
+     *
+     * @remarks
+     * If you are looking for transactions with the currency amount greater than 0, simply construct the query without `currencyGreaterThan` because it doesn't accept `-1`, and passing the `0` `currency-greater-than` value would exclude transactions with a 0 amount.
+     *
+     * @param greater
+     * @category query
+     */
     currencyGreaterThan(greater: number): this;
+    /**
+     * Filtered results should have an amount less than this value, as int, representing asset units.
+     *
+     * #### Example
+     * ```typescript
+     * const maxBalance = 500000;
+     * const assetId = 163650;
+     * const assetTxns = await indexerClient
+     *        .lookupAssetTransactions(assetId)
+     *        .currencyLessThan(maxBalance + 1)
+     *        .do();
+     * ```
+     *
+     * @param lesser
+     * @category query
+     */
     currencyLessThan(lesser: number): this;
+    /**
+     * Combined with address, defines what address to filter on, as string.
+     *
+     * #### Example
+     * ```typescript
+     * const assetId = 163650;
+     * const address = "XBYLS2E6YI6XXL5BWCAMOA4GTWHXWENZMX5UHXMRNWWUQ7BXCY5WC5TEPA";
+     * const role = "sender";
+     * const assetTxns = await indexerClient
+     *        .lookupAssetTransactions(assetId)
+     *        .address(address)
+     *        .addressRole(role)
+     *        .do();
+     * ```
+     *
+     * @param role - one of `sender`, `receiver`, `freeze-target`
+     * @category query
+     */
     addressRole(role: string): this;
+    /**
+     * Only include transactions with this address in one of the transaction fields.
+     *
+     * #### Example
+     * ```typescript
+     * const assetId = 163650;
+     * const address = "XBYLS2E6YI6XXL5BWCAMOA4GTWHXWENZMX5UHXMRNWWUQ7BXCY5WC5TEPA";
+     * const assetTxns = await indexerClient
+     *        .lookupAssetTransactions(assetId)
+     *        .address(address)
+     *        .do();
+     * ```
+     *
+     * @param address
+     * @category query
+     */
     address(address: string): this;
+    /**
+     * Whether or not to consider the `close-to` field as a receiver when filtering transactions, as bool. Set to `true` to ignore `close-to`.
+     *
+     * #### Example
+     * ```typescript
+     * const assetId = 163650;
+     * const assetTxns = await indexerClient
+     *        .lookupAssetTransactions(assetId)
+     *        .excludeCloseTo(true)
+     *        .do();
+     * ```
+     *
+     * @param exclude
+     * @category query
+     */
     excludeCloseTo(exclude: boolean): this;
+    /**
+     * The next page of results.
+     *
+     * #### Example
+     * ```typescript
+     * const maxResults = 25;
+     * const assetId = 163650;
+     *
+     * const assetTxnsPage1 = await indexerClient
+     *        .lookupAssetTransactions(assetId)
+     *        .limit(maxResults)
+     *        .do();
+     *
+     * const assetTxnsPage2 = await indexerClient
+     *        .lookupAssetTransactions(assetId)
+     *        .limit(maxResults)
+     *        .nextToken(assetTxnsPage1["next-token"])
+     *        .do();
+     * ```
+     *
+     * @param nextToken - provided by the previous results.
+     * @category query
+     */
     nextToken(nextToken: string): this;
+    /**
+     * Whether or not to include rekeying transactions.
+     *
+     * #### Example
+     * ```typescript
+     * const assetId = 163650;
+     * const assetTxns = await indexerClient
+     *        .lookupAssetTransactions(assetId)
+     *        .rekeyTo(false)
+     *        .do();
+     * ```
+     *
+     * @param rekeyTo
+     * @category query
+     */
     rekeyTo(rekeyTo: boolean): this;
 }

package/dist/types/src/client/v2/indexer/lookupBlock.d.ts

@@ -3,6 +3,22 @@ import HTTPClient from '../../client';
 import IntDecoding from '../../../types/intDecoding';
 export default class LookupBlock extends JSONRequest {
     private round;
+    /**
+     * Returns the block for the passed round.
+     *
+     * #### Example
+     * ```typescript
+     * const targetBlock = 18309917;
+     * const blockInfo = await indexerClient.lookupBlock(targetBlock).do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/indexer/#get-v2blocksround-number)
+     * @param round - The number of the round to look up.
+     * @category GET
+     */
     constructor(c: HTTPClient, intDecoding: IntDecoding, round: number);
+    /**
+     * @returns `/v2/blocks/${round}`
+     */
     path(): string;
 }

package/dist/types/src/client/v2/indexer/lookupTransactionByID.d.ts

@@ -3,6 +3,22 @@ import HTTPClient from '../../client';
 import IntDecoding from '../../../types/intDecoding';
 export default class LookupTransactionByID extends JSONRequest {
     private txID;
+    /**
+     * Returns information about the given transaction.
+     *
+     * #### Example
+     * ```typescript
+     * const txnId = "MEUOC4RQJB23CQZRFRKYEI6WBO73VTTPST5A7B3S5OKBUY6LFUDA";
+     * const txnInfo = await indexerClient.lookupTransactionByID(txnId).do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/indexer/#get-v2transactionstxid)
+     * @param txID - The ID of the transaction to look up.
+     * @category GET
+     */
     constructor(c: HTTPClient, intDecoding: IntDecoding, txID: string);
+    /**
+     * @returns `/v2/transactions/${txID}`
+     */
     path(): string;
 }

package/dist/types/src/client/v2/indexer/makeHealthCheck.d.ts

@@ -1,4 +1,19 @@
 import JSONRequest from '../jsonrequest';
+/**
+ * Returns the health object for the service.
+ * Returns 200 if healthy.
+ *
+ * #### Example
+ * ```typescript
+ * const health = await indexerClient.makeHealthCheck().do();
+ * ```
+ *
+ * [Response data schema details](https://developer.algorand.org/docs/rest-apis/indexer/#get-health)
+ * @category GET
+ */
 export default class MakeHealthCheck extends JSONRequest {
+    /**
+     * @returns `/health`
+     */
     path(): string;
 }