algosdk 2.1.0 → 2.3.0

package/dist/types/client/v2/algod/algod.d.ts

@@ -27,7 +27,14 @@ import { BaseHTTPClient } from '../../baseHTTPClient';
 import { AlgodTokenHeader, CustomTokenHeader } from '../../urlTokenBaseHTTPClient';
 import LightBlockHeaderProof from './lightBlockHeaderProof';
 import StateProof from './stateproof';
+import SetSyncRound from './setSyncRound';
+import GetSyncRound from './getSyncRound';
+import SetBlockOffsetTimestamp from './setBlockOffsetTimestamp';
+import GetBlockOffsetTimestamp from './getBlockOffsetTimestamp';
 import Disassemble from './disassemble';
+import SimulateRawTransactions from './simulateTransaction';
+import Ready from './ready';
+import UnsetSyncRound from './unsetSyncRound';
 /**
  * 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.
  *
@@ -69,7 +76,7 @@ export default class AlgodClient extends ServiceClient {
      * const health = await algodClient.healthCheck().do();
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-health)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-health)
      * @category GET
      */
     healthCheck(): HealthCheck;
@@ -81,7 +88,7 @@ export default class AlgodClient extends ServiceClient {
      * const versionsDetails = await algodClient.versionsCheck().do();
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-versions)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-versions)
      * @category GET
      */
     versionsCheck(): Versions;
@@ -94,7 +101,7 @@ export default class AlgodClient extends ServiceClient {
      * const result = await waitForConfirmation(algodClient, txid, 3);
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#post-v2transactions)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#post-v2transactions)
      *
      * @remarks
      * Often used with {@linkcode waitForConfirmation}
@@ -111,7 +118,7 @@ export default class AlgodClient extends ServiceClient {
      * const accountInfo = await algodClient.accountInformation(address).do();
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2accountsaddress)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-v2accountsaddress)
      * @param account - The address of the account to look up.
      * @category GET
      */
@@ -126,7 +133,7 @@ export default class AlgodClient extends ServiceClient {
      * const accountAssetInfo = await algodClient.accountAssetInformation(address, index).do();
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2accountsaddress)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-v2accountsaddress)
      * @param account - The address of the account to look up.
      * @param index - The asset ID to look up.
      * @category GET
@@ -142,7 +149,7 @@ export default class AlgodClient extends ServiceClient {
      * const accountInfo = await algodClient.accountApplicationInformation(address, index).do();
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2accountsaddress)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-v2accountsaddress)
      * @param account - The address of the account to look up.
      * @param index - The application ID to look up.
      * @category GET
@@ -157,7 +164,7 @@ export default class AlgodClient extends ServiceClient {
      * const block = await algodClient.block(roundNumber).do();
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2blocksround)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-v2blocksround)
      * @param roundNumber - The round number of the block to get.
      * @category GET
      */
@@ -171,7 +178,7 @@ export default class AlgodClient extends ServiceClient {
      * const block = await algodClient.getBlockHash(roundNumber).do();
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2blocksroundhash)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-v2blocksroundhash)
      * @param roundNumber - The round number of the block to get.
      * @category GET
      */
@@ -185,7 +192,7 @@ export default class AlgodClient extends ServiceClient {
      * const pending = await algodClient.pendingTransactionInformation(txId).do();
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2transactionspendingtxid)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-v2transactionspendingtxid)
      *
      * @remarks
      * <br><br>
@@ -218,7 +225,7 @@ export default class AlgodClient extends ServiceClient {
      *     .do();
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2transactionspending)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-v2transactionspending)
      * @category GET
      */
     pendingTransactionsInformation(): PendingTransactions;
@@ -242,7 +249,7 @@ export default class AlgodClient extends ServiceClient {
      *     .do();
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2accountsaddresstransactionspending)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-v2accountsaddresstransactionspending)
      * @param address - The address of the sender.
      * @category GET
      */
@@ -255,7 +262,7 @@ export default class AlgodClient extends ServiceClient {
      * const status = await algodClient.status().do();
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2status)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-v2status)
      * @category GET
      */
     status(): Status;
@@ -268,7 +275,7 @@ export default class AlgodClient extends ServiceClient {
      * 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)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-v2statuswait-for-block-afterround)
      * @param round - The number of the round to wait for.
      * @category GET
      */
@@ -288,7 +295,7 @@ export default class AlgodClient extends ServiceClient {
      * });
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2transactionsparams)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-v2transactionsparams)
      *
      * @remarks
      * Often used with
@@ -304,7 +311,7 @@ export default class AlgodClient extends ServiceClient {
      * const supplyDetails = await algodClient.supply().do();
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2ledgersupply)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-v2ledgersupply)
      * @category GET
      */
     supply(): Supply;
@@ -317,7 +324,7 @@ export default class AlgodClient extends ServiceClient {
      * const compiledSmartContract = await algodClient.compile(source).do();
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#post-v2tealcompile)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#post-v2tealcompile)
      * @remarks
      * This endpoint is only enabled when a node's configuration file sets `EnableDeveloperAPI` to true.
      * @param source
@@ -347,7 +354,7 @@ export default class AlgodClient extends ServiceClient {
      * const dryRunResult = await algodClient.dryrun(dr).do();
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#post-v2tealdryrun)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#post-v2tealdryrun)
      * @param dr
      * @category POST
      */
@@ -362,7 +369,7 @@ export default class AlgodClient extends ServiceClient {
      * const asset = await algodClient.getAssetByID(asset_id).do();
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2assetsasset-id)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-v2assetsasset-id)
      * @param index - The asset ID to look up.
      * @category GET
      */
@@ -377,7 +384,7 @@ export default class AlgodClient extends ServiceClient {
      * const app = await algodClient.getApplicationByID(index).do();
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2applicationsapplication-id)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-v2applicationsapplication-id)
      * @param index - The application ID to look up.
      * @category GET
      */
@@ -393,7 +400,7 @@ export default class AlgodClient extends ServiceClient {
      * const boxValue = boxResponse.value;
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2applicationsapplication-idbox)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-v2applicationsapplication-idbox)
      * @param index - The application ID to look up.
      * @category GET
      */
@@ -408,7 +415,7 @@ export default class AlgodClient extends ServiceClient {
      * const boxNames = boxesResponse.boxes.map(box => box.name);
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2applicationsapplication-idboxes)
+     * [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
      */
@@ -421,7 +428,7 @@ export default class AlgodClient extends ServiceClient {
      * const genesis = await algodClient.genesis().do();
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-genesis)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-genesis)
      * @category GET
      */
     genesis(): Genesis;
@@ -435,7 +442,7 @@ export default class AlgodClient extends ServiceClient {
      * const proof = await algodClient.getTransactionProof(round, txId).do();
      * ```
      *
-     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2blocksroundtransactionstxidproof)
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-v2blocksroundtransactionstxidproof)
      * @param round - The round in which the transaction appears.
      * @param txID - The transaction ID for which to generate a proof.
      * @category GET
@@ -467,4 +474,132 @@ export default class AlgodClient extends ServiceClient {
      * @param round
      */
     getStateProof(round: number): StateProof;
+    /**
+     * Simulate a list of a signed transaction objects being sent to the network.
+     *
+     * #### Example
+     * ```typescript
+     * const txn1 = algosdk.makePaymentTxnWithSuggestedParamsFromObject(txn1Params);
+     * const txn2 = algosdk.makePaymentTxnWithSuggestedParamsFromObject(txn2Params);
+     * const txgroup = algosdk.assignGroupID([txn1, txn2]);
+     *
+     * // Actually sign the first transaction
+     * const signedTxn1 = txgroup[0].signTxn(senderSk).blob;
+     * // Simulate does not require signed transactions -- use this method to encode an unsigned transaction
+     * const signedTxn2 = algosdk.encodeUnsignedSimulateTransaction(txgroup[1]);
+     *
+     * const resp = await client.simulateRawTransactions([signedTxn1, signedTxn2]).do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#post-v2transactionssimulate)
+     * @param stxOrStxs
+     * @category POST
+     */
+    simulateRawTransactions(stxOrStxs: Uint8Array | Uint8Array[]): SimulateRawTransactions;
+    /**
+     * Simulate transactions being sent to the network.
+     *
+     * #### Example
+     * ```typescript
+     * const txn1 = algosdk.makePaymentTxnWithSuggestedParamsFromObject(txn1Params);
+     * const txn2 = algosdk.makePaymentTxnWithSuggestedParamsFromObject(txn2Params);
+     * const txgroup = algosdk.assignGroupID([txn1, txn2]);
+     *
+     * // Actually sign the first transaction
+     * const signedTxn1 = txgroup[0].signTxn(senderSk).blob;
+     * // Simulate does not require signed transactions -- use this method to encode an unsigned transaction
+     * const signedTxn2 = algosdk.encodeUnsignedSimulateTransaction(txgroup[1]);
+     *
+     * const request = new modelsv2.SimulateRequest({
+     *  txnGroups: [
+     *    new modelsv2.SimulateRequestTransactionGroup({
+     *       // Must decode the signed txn bytes into an object
+     *       txns: [algosdk.decodeObj(signedTxn1), algosdk.decodeObj(signedTxn2)]
+     *     }),
+     *   ],
+     * });
+     * const resp = await client.simulateRawTransactions(request).do();
+     * ```
+     *
+     * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#post-v2transactionssimulate)
+     * @param request
+     * @category POST
+     */
+    simulateTransactions(request: modelsv2.SimulateRequest): SimulateRawTransactions;
+    /**
+     * Set the offset (in seconds) applied to the block timestamp when creating new blocks in devmode.
+     *
+     *  #### Example
+     *  ```typesecript
+     *  const offset = 60
+     *  await client.setBlockOffsetTimestamp(offset).do();
+     *  ```
+     *
+     [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#post-v2devmodeblocksoffsetoffset)
+     * @param offset
+     * @category POST
+     */
+    setBlockOffsetTimestamp(offset: number): SetBlockOffsetTimestamp;
+    /**
+     * Get the offset (in seconds) applied to the block timestamp when creating new blocks in devmode.
+     *
+     *  #### Example
+     *  ```typesecript
+     *  const currentOffset = await client.getBlockOffsetTimestamp().do();
+     *  ```
+     *
+     [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-v2devmodeblocksoffset)
+     * @category GET
+     */
+    getBlockOffsetTimestamp(): GetBlockOffsetTimestamp;
+    /**
+     * Set the sync round on the ledger (algod must have EnableFollowMode: true), restricting catchup.
+     *
+     *  #### Example
+     *  ```typesecript
+     *  const round = 10000
+     *  await client.setSyncRound(round).do();
+     *  ```
+     *
+     [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#post-v2ledgersyncround)
+     * @param round
+     * @category POST
+     */
+    setSyncRound(round: number): SetSyncRound;
+    /**
+     * Un-Set the sync round on the ledger (algod must have EnableFollowMode: true), removing the restriction on catchup.
+     *
+     *  #### Example
+     *  ```typesecript
+     *  await client.unsetSyncRound().do();
+     *  ```
+     *
+     [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#delete-v2ledgersync)
+     * @category DELETE
+     */
+    unsetSyncRound(): UnsetSyncRound;
+    /**
+     * Get the current sync round on the ledger (algod must have EnableFollowMode: true).
+     *
+     *  #### Example
+     *  ```typesecript
+     *  const currentSyncRound = await client.getSyncRound().do();
+     *  ```
+     *
+     [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-v2ledgersync)
+     * @category GET
+     */
+    getSyncRound(): GetSyncRound;
+    /**
+     * Ready check which returns 200 OK if algod is healthy and caught up
+     *
+     *  #### Example
+     *  ```typesecript
+     *  await client.ready().do();
+     *  ```
+     *
+     [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-ready)
+     * @category GET
+     */
+    ready(): Ready;
 }

package/dist/types/client/v2/algod/getApplicationBoxByName.d.ts

@@ -13,7 +13,7 @@ import { Box } from './models/types';
  * const boxValue = boxResponse.value;
  * ```
  *
- * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2applicationsapplication-idbox)
+ * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/#get-v2applicationsapplication-idbox)
  * @param index - The application ID to look up.
  * @category GET
  */

package/dist/types/client/v2/algod/getApplicationBoxes.d.ts

@@ -12,7 +12,7 @@ import { BoxesResponse } from './models/types';
  * const boxNames = boxesResponse.boxes.map(box => box.name);
  * ```
  *
- * [Response data schema details](https://developer.algorand.org/docs/rest-apis/algod/v2/#get-v2applicationsapplication-idboxes)
+ * [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
  */

package/dist/types/client/v2/algod/getBlockOffsetTimestamp.d.ts

@@ -0,0 +1,6 @@
+import JSONRequest from '../jsonrequest';
+import { GetBlockTimeStampOffsetResponse } from './models/types';
+export default class GetBlockOffsetTimestamp extends JSONRequest<GetBlockTimeStampOffsetResponse, Record<string, any>> {
+    path(): string;
+    prepare(body: Record<string, any>): GetBlockTimeStampOffsetResponse;
+}

package/dist/types/client/v2/algod/getSyncRound.d.ts

@@ -0,0 +1,6 @@
+import JSONRequest from '../jsonrequest';
+import { GetSyncRoundResponse } from './models/types';
+export default class GetSyncRound extends JSONRequest<GetSyncRoundResponse, Record<string, any>> {
+    path(): string;
+    prepare(body: Record<string, any>): GetSyncRoundResponse;
+}