@digitalworld/digital-world-sdk 16.0.0

package/lib/axios/cjs/contract/sent_transaction.js

@@ -0,0 +1,144 @@
+'use strict';
+
+var api = require('../rpc/api.js');
+var server = require('../rpc/server.js');
+require('../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/int.js');
+require('../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/hyper.js');
+require('../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-int.js');
+require('../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-hyper.js');
+require('../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/xdr-type.js');
+require('buffer');
+require('../base/generated/curr_generated.js');
+require('@noble/hashes/sha2.js');
+require('../base/signing.js');
+require('../base/keypair.js');
+require('base32.js');
+require('../base/util/continued_fraction.js');
+require('../base/util/bignumber.js');
+require('../base/transaction_builder.js');
+require('../base/muxed_account.js');
+require('../base/scval.js');
+require('../base/numbers/uint128.js');
+require('../base/numbers/uint256.js');
+require('../base/numbers/int128.js');
+require('../base/numbers/int256.js');
+var utils = require('./utils.js');
+var types = require('./types.js');
+
+class SentTransaction {
+  constructor(assembled) {
+    this.assembled = assembled;
+    const { server: server$1, allowHttp, headers, rpcUrl } = this.assembled.options;
+    this.server = server$1 ?? new server.RpcServer(rpcUrl, { allowHttp, headers });
+  }
+  assembled;
+  server;
+  /**
+   * The result of calling `sendTransaction` to broadcast the transaction to the
+   * network.
+   */
+  sendTransactionResponse;
+  /**
+   * If `sendTransaction` completes successfully (which means it has `status: 'PENDING'`),
+   * then `getTransaction` will be called in a loop for
+   * {@link MethodOptions.timeoutInSeconds} seconds. This array contains all
+   * the results of those calls.
+   */
+  getTransactionResponseAll;
+  /**
+   * The most recent result of calling `getTransaction`, from the
+   * `getTransactionResponseAll` array.
+   */
+  getTransactionResponse;
+  static Errors = {
+    SendFailed: class SendFailedError extends Error {
+    },
+    SendResultOnly: class SendResultOnlyError extends Error {
+    },
+    TransactionStillPending: class TransactionStillPendingError extends Error {
+    }
+  };
+  /**
+   * Initialize a `SentTransaction` from {@link AssembledTransaction}
+   * `assembled`, passing an optional {@link Watcher} `watcher`. This will also
+   * send the transaction to the network.
+   */
+  static init = async (assembled, watcher) => {
+    const tx = new SentTransaction(assembled);
+    const sent = await tx.send(watcher);
+    return sent;
+  };
+  send = async (watcher) => {
+    this.sendTransactionResponse = await this.server.sendTransaction(
+      this.assembled.signed
+    );
+    if (this.sendTransactionResponse.status !== "PENDING") {
+      throw new SentTransaction.Errors.SendFailed(
+        `Sending the transaction to the network failed!
+${JSON.stringify(
+          this.sendTransactionResponse,
+          null,
+          2
+        )}`
+      );
+    }
+    if (watcher?.onSubmitted) watcher.onSubmitted(this.sendTransactionResponse);
+    const { hash } = this.sendTransactionResponse;
+    const timeoutInSeconds = this.assembled.options.timeoutInSeconds ?? types.DEFAULT_TIMEOUT;
+    this.getTransactionResponseAll = await utils.withExponentialBackoff(
+      async () => {
+        const tx = await this.server.getTransaction(hash);
+        if (watcher?.onProgress) watcher.onProgress(tx);
+        return tx;
+      },
+      (resp) => resp.status === api.Api.GetTransactionStatus.NOT_FOUND,
+      timeoutInSeconds
+    );
+    this.getTransactionResponse = this.getTransactionResponseAll[this.getTransactionResponseAll.length - 1];
+    if (this.getTransactionResponse.status === api.Api.GetTransactionStatus.NOT_FOUND) {
+      throw new SentTransaction.Errors.TransactionStillPending(
+        `Waited ${timeoutInSeconds} seconds for transaction to complete, but it did not. Returning anyway. Check the transaction status manually. Sent transaction: ${JSON.stringify(
+          this.sendTransactionResponse,
+          null,
+          2
+        )}
+All attempts to get the result: ${JSON.stringify(
+          this.getTransactionResponseAll,
+          null,
+          2
+        )}`
+      );
+    }
+    return this;
+  };
+  get result() {
+    if ("getTransactionResponse" in this && this.getTransactionResponse) {
+      if ("returnValue" in this.getTransactionResponse) {
+        return this.assembled.options.parseResultXdr(
+          this.getTransactionResponse.returnValue
+        );
+      }
+      throw new Error("Transaction failed! Cannot parse result.");
+    }
+    if (this.sendTransactionResponse) {
+      const errorResult = this.sendTransactionResponse.errorResult?.result();
+      if (errorResult) {
+        throw new SentTransaction.Errors.SendFailed(
+          `Transaction simulation looked correct, but attempting to send the transaction failed. Check \`simulation\` and \`sendTransactionResponseAll\` to troubleshoot. Decoded \`sendTransactionResponse.errorResultXdr\`: ${errorResult}`
+        );
+      }
+      throw new SentTransaction.Errors.SendResultOnly(
+        `Transaction was sent to the network, but not yet awaited. No result to show. Await transaction completion with \`getTransaction(sendTransactionResponse.hash)\``
+      );
+    }
+    throw new Error(
+      `Sending transaction failed: ${JSON.stringify(this.assembled.signed)}`
+    );
+  }
+}
+class Watcher {
+}
+
+exports.SentTransaction = SentTransaction;
+exports.Watcher = Watcher;
+//# sourceMappingURL=sent_transaction.js.map

package/lib/axios/cjs/contract/sent_transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sent_transaction.js","sources":["../../../../src/contract/sent_transaction.ts"],"sourcesContent":["/* disable max-classes rule, because extending error shouldn't count! */\n/* eslint max-classes-per-file: 0 */\nimport type { MethodOptions } from \"./types.js\";\nimport { Server } from \"../rpc/index.js\";\nimport { Api } from \"../rpc/api.js\";\nimport { withExponentialBackoff } from \"./utils.js\";\nimport { DEFAULT_TIMEOUT } from \"./types.js\";\nimport type { AssembledTransaction } from \"./assembled_transaction.js\";\n\n/**\n * A transaction that has been sent to the Soroban network. This happens in two steps:\n *\n * 1. `sendTransaction`: initial submission of the transaction to the network.\n *    If this step runs into problems, the attempt to sign and send will be\n *    aborted. You can see the result of this call in the\n *    `sendTransactionResponse` getter.\n * 2. `getTransaction`: once the transaction has been submitted to the network\n *    successfully, you need to wait for it to finalize to get the result of the\n *    transaction. This will be retried with exponential backoff for\n *    {@link MethodOptions.timeoutInSeconds} seconds. See all attempts in\n *    `getTransactionResponseAll` and the most recent attempt in\n *    `getTransactionResponse`.\n *\n *\n * @param signTransaction - More info in {@link MethodOptions}\n * @param assembled - {@link AssembledTransaction} from which this SentTransaction was initialized\n */\nexport class SentTransaction<T> {\n  public server: Server;\n\n  /**\n   * The result of calling `sendTransaction` to broadcast the transaction to the\n   * network.\n   */\n  public sendTransactionResponse?: Api.SendTransactionResponse;\n\n  /**\n   * If `sendTransaction` completes successfully (which means it has `status: 'PENDING'`),\n   * then `getTransaction` will be called in a loop for\n   * {@link MethodOptions.timeoutInSeconds} seconds. This array contains all\n   * the results of those calls.\n   */\n  public getTransactionResponseAll?: Api.GetTransactionResponse[];\n\n  /**\n   * The most recent result of calling `getTransaction`, from the\n   * `getTransactionResponseAll` array.\n   */\n  public getTransactionResponse?: Api.GetTransactionResponse;\n\n  static Errors = {\n    SendFailed: class SendFailedError extends Error {},\n    SendResultOnly: class SendResultOnlyError extends Error {},\n    TransactionStillPending: class TransactionStillPendingError extends Error {},\n  };\n\n  constructor(public assembled: AssembledTransaction<T>) {\n    const { server, allowHttp, headers, rpcUrl } = this.assembled.options;\n    this.server = server ?? new Server(rpcUrl, { allowHttp, headers });\n  }\n\n  /**\n   * Initialize a `SentTransaction` from {@link AssembledTransaction}\n   * `assembled`, passing an optional {@link Watcher} `watcher`. This will also\n   * send the transaction to the network.\n   */\n  static init = async <U>(\n    /** {@link AssembledTransaction} from which this SentTransaction was initialized */\n    assembled: AssembledTransaction<U>,\n    watcher?: Watcher,\n  ): Promise<SentTransaction<U>> => {\n    const tx = new SentTransaction(assembled);\n    const sent = await tx.send(watcher);\n    return sent;\n  };\n\n  private send = async (watcher?: Watcher): Promise<this> => {\n    this.sendTransactionResponse = await this.server.sendTransaction(\n      this.assembled.signed!,\n    );\n\n    if (this.sendTransactionResponse.status !== \"PENDING\") {\n      throw new SentTransaction.Errors.SendFailed(\n        `Sending the transaction to the network failed!\\n${JSON.stringify(\n          this.sendTransactionResponse,\n          null,\n          2,\n        )}`,\n      );\n    }\n\n    if (watcher?.onSubmitted) watcher.onSubmitted(this.sendTransactionResponse);\n\n    const { hash } = this.sendTransactionResponse;\n\n    const timeoutInSeconds =\n      this.assembled.options.timeoutInSeconds ?? DEFAULT_TIMEOUT;\n    this.getTransactionResponseAll = await withExponentialBackoff(\n      async () => {\n        const tx = await this.server.getTransaction(hash);\n        if (watcher?.onProgress) watcher.onProgress(tx);\n        return tx;\n      },\n      (resp) => resp.status === Api.GetTransactionStatus.NOT_FOUND,\n      timeoutInSeconds,\n    );\n\n    this.getTransactionResponse =\n      this.getTransactionResponseAll[this.getTransactionResponseAll.length - 1];\n    if (\n      this.getTransactionResponse.status === Api.GetTransactionStatus.NOT_FOUND\n    ) {\n      throw new SentTransaction.Errors.TransactionStillPending(\n        `Waited ${timeoutInSeconds} seconds for transaction to complete, but it did not. ` +\n          `Returning anyway. Check the transaction status manually. ` +\n          `Sent transaction: ${JSON.stringify(\n            this.sendTransactionResponse,\n            null,\n            2,\n          )}\\n` +\n          `All attempts to get the result: ${JSON.stringify(\n            this.getTransactionResponseAll,\n            null,\n            2,\n          )}`,\n      );\n    }\n\n    return this;\n  };\n\n  get result(): T {\n    // 1. check if transaction was submitted and awaited with `getTransaction`\n    if (\"getTransactionResponse\" in this && this.getTransactionResponse) {\n      // getTransactionResponse has a `returnValue` field unless it failed\n      if (\"returnValue\" in this.getTransactionResponse) {\n        return this.assembled.options.parseResultXdr(\n          this.getTransactionResponse.returnValue!,\n        );\n      }\n\n      // if \"returnValue\" not present, the transaction failed; return without\n      // parsing the result\n      throw new Error(\"Transaction failed! Cannot parse result.\");\n    }\n\n    // 2. otherwise, maybe it was merely sent with `sendTransaction`\n    if (this.sendTransactionResponse) {\n      const errorResult = this.sendTransactionResponse.errorResult?.result();\n      if (errorResult) {\n        throw new SentTransaction.Errors.SendFailed(\n          `Transaction simulation looked correct, but attempting to send the transaction failed. Check \\`simulation\\` and \\`sendTransactionResponseAll\\` to troubleshoot. Decoded \\`sendTransactionResponse.errorResultXdr\\`: ${errorResult}`,\n        );\n      }\n      throw new SentTransaction.Errors.SendResultOnly(\n        `Transaction was sent to the network, but not yet awaited. No result to show. Await transaction completion with \\`getTransaction(sendTransactionResponse.hash)\\``,\n      );\n    }\n\n    // 3. finally, if neither of those are present, throw an error\n    throw new Error(\n      `Sending transaction failed: ${JSON.stringify(this.assembled.signed)}`,\n    );\n  }\n}\n\nexport abstract class Watcher {\n  /**\n   * Function to call after transaction has been submitted successfully to\n   * the network for processing\n   */\n  abstract onSubmitted?(response?: Api.SendTransactionResponse): void;\n\n  /**\n   * Function to call every time the submitted transaction's status is\n   * checked while awaiting its full inclusion in the ledger\n   */\n  abstract onProgress?(response?: Api.GetTransactionResponse): void;\n}\n"],"names":["server","Server","DEFAULT_TIMEOUT","withExponentialBackoff","Api"],"mappings":"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"}