algosdk 3.5.2 → 3.7.0-beta.1

package/src/client/v2/algod/accountAssetsInformation.ts

@@ -0,0 +1,33 @@
+import JSONRequest from '../jsonrequest.js';
+import { HTTPClient, HTTPClientResponse } from '../../client.js';
+import { decodeJSON } from '../../../encoding/encoding.js';
+import { AccountAssetsInformationResponse } from './models/types.js';
+import { Address } from '../../../encoding/address.js';
+
+export default class AccountAssetsInformation extends JSONRequest<AccountAssetsInformationResponse> {
+  private account: string;
+
+  constructor(c: HTTPClient, account: string | Address) {
+    super(c);
+    this.account = account.toString();
+  }
+
+  path() {
+    return `/v2/accounts/${this.account}/assets`;
+  }
+
+  limit(limit: number) {
+    this.query.limit = limit;
+    return this;
+  }
+
+  next(next: string) {
+    this.query.next = next;
+    return this;
+  }
+
+  // eslint-disable-next-line class-methods-use-this
+  prepare(response: HTTPClientResponse): AccountAssetsInformationResponse {
+    return decodeJSON(response.getJSONText(), AccountAssetsInformationResponse);
+  }
+}

package/src/client/v2/algod/algod.ts

@@ -2,10 +2,11 @@ import ServiceClient from '../serviceClient.js';
 import * as modelsv2 from './models/types.js';
 import AccountInformation from './accountInformation.js';
 import AccountAssetInformation from './accountAssetInformation.js';
+import AccountAssetsInformation from './accountAssetsInformation.js';
+import AccountApplicationsInformation from './accountApplicationsInformation.js';
 import AccountApplicationInformation from './accountApplicationInformation.js';
 import Block from './block.js';
 import Compile from './compile.js';
-import Dryrun from './dryrun.js';
 import Genesis from './genesis.js';
 import GetAssetByID from './getAssetByID.js';
 import GetApplicationByID from './getApplicationByID.js';
@@ -177,6 +178,26 @@ export class AlgodClient extends ServiceClient {
     return new AccountAssetInformation(this.c, account, index);
   }
 
+  /**
+   * Returns the given account's asset holdings, paginated.
+   *
+   * @param account - The address of the account to look up.
+   * @category GET
+   */
+  accountAssetsInformation(account: string | Address) {
+    return new AccountAssetsInformation(this.c, account);
+  }
+
+  /**
+   * Returns the given account's application holdings, paginated.
+   *
+   * @param account - The address of the account to look up.
+   * @category GET
+   */
+  accountApplicationsInformation(account: string | Address) {
+    return new AccountApplicationsInformation(this.c, account);
+  }
+
   /**
    * Returns the given account's application information for a specific application.
    *
@@ -438,24 +459,6 @@ export class AlgodClient extends ServiceClient {
     return new Disassemble(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/#post-v2tealdryrun)
-   * @param dr
-   * @category POST
-   */
-  dryrun(dr: modelsv2.DryrunRequest) {
-    return new Dryrun(this.c, dr);
-  }
-
   /**
    * Given an asset ID, return asset information including creator, name, total supply and
    * special addresses.
@@ -512,7 +515,7 @@ export class AlgodClient extends ServiceClient {
   }
 
   /**
-   * Given an application ID, return all the box names associated with the app.
+   * Given an application ID, return all the boxes associated with the app.
    *
    * #### Example
    * ```typescript
@@ -520,6 +523,8 @@ export class AlgodClient extends ServiceClient {
    * const boxesResponse = await algodClient.getApplicationBoxes(index).max(3).do();
    * const boxNames = boxesResponse.boxes.map(box => box.name);
    * ```
+   * With the `.include("values")` parameter, returns values in addition to names. Pagination is supported with `limit`. If using pagination,
+   * it is recommended to use the `.round()` parameter to ensure each page is for the same round.
    *
    * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-v2applicationsapplication-idboxes)
    * @param index - The application ID to look up.

package/src/client/v2/algod/getApplicationBoxes.ts

@@ -1,10 +1,14 @@
 import JSONRequest from '../jsonrequest.js';
 import { HTTPClient, HTTPClientResponse } from '../../client.js';
 import { decodeJSON } from '../../../encoding/encoding.js';
+import { bytesToBase64 } from '../../../encoding/binarydata.js';
+import { ensureSafeInteger } from '../../../utils/utils.js';
 import { BoxesResponse } from './models/types.js';
 
+export type BoxInclude = 'values';
+
 /**
- * Given an application ID, return all the box names associated with the app.
+ * Given an application ID, return all the boxes associated with the app.
  *
  * #### Example
  * ```typescript
@@ -13,6 +17,9 @@ import { BoxesResponse } from './models/types.js';
  * const boxNames = boxesResponse.boxes.map(box => box.name);
  * ```
  *
+ * With the `.include("values")` parameter, returns values in addition to names. Pagination is supported with `limit`. If using pagination,
+ * it is recommended to use the `.round()` parameter to ensure each page is for the same round.
+ *
  * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-v2applicationsapplication-idboxes)
  * @param index - The application ID to look up.
  * @category GET
@@ -34,18 +41,20 @@ export default class GetApplicationBoxes extends JSONRequest<BoxesResponse> {
   }
 
   /**
-   * Limit results for pagination.
+   * @deprecated - Use `limit` instead for proper pagination with a limit.
+   *
+   * Set the max amount of boxes to return. Returns HTTP 400 if max is exceeded.
    *
    * #### Example
    * ```typescript
    * const maxResults = 20;
    * const boxesResult = await algodClient
-   *        .GetApplicationBoxes(1234)
-   *        .limit(maxResults)
+   *        .getApplicationBoxes(1234)
+   *        .max(maxResults)
    *        .do();
    * ```
    *
-   * @param limit - maximum number of results to return.
+   * @param max - maximum number of results to return.
    * @category query
    */
   max(max: number) {
@@ -53,6 +62,115 @@ export default class GetApplicationBoxes extends JSONRequest<BoxesResponse> {
     return this;
   }
 
+  /**
+   * Pagination token returned by the previous call.
+   *
+   * This is the value returned by a previous call to this endpoint in the
+   * `next-token` response field. Provide this token to get the next page of
+   * results. The token is the box name to use as the pagination cursor,
+   * encoded in the goal app call arg form.
+   *
+   * #### Example
+   * ```typescript
+   * const boxesResponse = await algodClient
+   *        .getApplicationBoxes(1234)
+   *        .limit(20)
+   *        .next("b64:AAECAw==")
+   *        .do();
+   * ```
+   *
+   * @param nextToken - The next token to use for pagination.
+   * @category query
+   */
+  next(nextToken: string | undefined) {
+    this.query.next = nextToken;
+    return this;
+  }
+
+  /**
+   * Filter box names by a prefix.
+   *
+   * #### Example
+   * ```typescript
+   * const boxesResponse = await algodClient
+   *        .getApplicationBoxes(1234)
+   *        .prefix(myAddr.publicKey)
+   *        .do();
+   * ```
+   *
+   * @param prefix - The prefix to filter box names by
+   * @category query
+   */
+  prefix(prefix: Uint8Array) {
+    this.query.prefix = `b64:${bytesToBase64(prefix)}`;
+    return this;
+  }
+
+  /**
+   * Include additional items in the response.
+   *
+   * Use `values` to include box values.
+   *
+   * #### Example
+   * ```typescript
+   * const boxesResponse = await algodClient
+   *        .getApplicationBoxes(1234)
+   *        .prefix(myAddr.publicKey)
+   *        .include("values")
+   *        .do();
+   * ```
+   *
+   * @param include - The additional items to include in the response.
+   * @category query
+   */
+  include(...include: BoxInclude[]) {
+    this.query.include = include.join(',');
+    return this;
+  }
+
+  /**
+   * Limits results per page when using pagination.
+   *
+   * #### Example
+   * ```typescript
+   * const maxResults = 20;
+   * const boxesResult = await algodClient
+   *        .getApplicationBoxes(1234)
+   *        .limit(maxResults)
+   *        .do();
+   * const { nextToken } = boxesResult
+   * ```
+   *
+   * @param limit - maximum number of results to return per page.
+   * @category query
+   */
+  limit(limit: number) {
+    this.query.limit = limit;
+    return this;
+  }
+
+  /**
+   * Return results for the specified round.
+   *
+   * If not provided, results will be from the latest round. This parameter
+   * can be used to pin all pages of a paginated query to a consistent round.
+   *
+   * #### Example
+   * ```typescript
+   * const boxesResponse = await algodClient
+   *        .getApplicationBoxes(1234)
+   *        .round(12345678)
+   *        .do();
+   * ```
+   *
+   * @param roundNumber - The round to query.
+   * @category query
+   */
+  round(roundNumber: number | bigint) {
+    this.query.round = ensureSafeInteger(roundNumber);
+    return this;
+  }
+
   // eslint-disable-next-line class-methods-use-this
   prepare(response: HTTPClientResponse): BoxesResponse {
     return decodeJSON(response.getJSONText(), BoxesResponse);