@escro/sdk 0.4.0 → 0.4.1

package/dist/index.d.cts

@@ -1,5 +1,7 @@
 import { Keypair } from '@solana/web3.js';
 
+type SolanaCluster = "devnet" | "mainnet";
+
 /**
  * All possible lifecycle states of an AgentEscrow account on-chain.
  *
@@ -132,6 +134,10 @@ interface ProtocolStatsFigures {
 }
 /** Protocol-wide aggregate statistics: public, unauthenticated. */
 interface ProtocolStats extends ProtocolStatsFigures {
+    /** The Solana cluster this API serves (its `CLUSTER`). */
+    cluster: SolanaCluster;
+    /** That cluster's one USDC mint (`getUsdcMint`): every figure here is in this token. */
+    usdcMint: string;
     /**
      * Escro-operated fleet figures (ARCHITECTURE section 9): the same fields over
      * escrows whose buyer and assigned worker are both in the API's operator
@@ -378,8 +384,6 @@ interface ReviewPolicy {
     evaluate(deliverable: ReviewDeliverable): ReviewResult | Promise<ReviewResult>;
 }
 
-type SolanaCluster = "devnet" | "mainnet";
-
 /** Dispute tally with its outcome split (from the wallet's perspective). */
 interface DisputeRecord {
     /** Total disputes this wallet was party to (raised by either side). */
@@ -747,9 +751,11 @@ declare class Escro {
      * {@link Escro.releasePayment}, reporting whether the API recorded the release.
      * `ESCROW_NOT_SETTLED` (the API's RPC does not yet show the escrow closed), the codes
      * {@link Escro.confirm} retries and a network failure are retried for about 30 s. A
-     * failure never throws: the release already landed, so the signature is returned with
-     * `confirm.landed: false` and an `EscroConfirmError` (the API's code, or
-     * `NETWORK_ERROR` when the last call never reached it).
+     * failed record never throws: the release already landed, so the signature is returned
+     * with `confirm.landed: false` and an `EscroConfirmError` (the API's code, or
+     * `NETWORK_ERROR` when the last call never reached it). A release that failed at
+     * execution on chain throws an {@link EscroError} with code `TX_FAILED`, and the API is
+     * never asked to record it.
      *
      * @returns `{ signature, confirm }`.
      */

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 import { Keypair } from '@solana/web3.js';
 
+type SolanaCluster = "devnet" | "mainnet";
+
 /**
  * All possible lifecycle states of an AgentEscrow account on-chain.
  *
@@ -132,6 +134,10 @@ interface ProtocolStatsFigures {
 }
 /** Protocol-wide aggregate statistics: public, unauthenticated. */
 interface ProtocolStats extends ProtocolStatsFigures {
+    /** The Solana cluster this API serves (its `CLUSTER`). */
+    cluster: SolanaCluster;
+    /** That cluster's one USDC mint (`getUsdcMint`): every figure here is in this token. */
+    usdcMint: string;
     /**
      * Escro-operated fleet figures (ARCHITECTURE section 9): the same fields over
      * escrows whose buyer and assigned worker are both in the API's operator
@@ -378,8 +384,6 @@ interface ReviewPolicy {
     evaluate(deliverable: ReviewDeliverable): ReviewResult | Promise<ReviewResult>;
 }
 
-type SolanaCluster = "devnet" | "mainnet";
-
 /** Dispute tally with its outcome split (from the wallet's perspective). */
 interface DisputeRecord {
     /** Total disputes this wallet was party to (raised by either side). */
@@ -747,9 +751,11 @@ declare class Escro {
      * {@link Escro.releasePayment}, reporting whether the API recorded the release.
      * `ESCROW_NOT_SETTLED` (the API's RPC does not yet show the escrow closed), the codes
      * {@link Escro.confirm} retries and a network failure are retried for about 30 s. A
-     * failure never throws: the release already landed, so the signature is returned with
-     * `confirm.landed: false` and an `EscroConfirmError` (the API's code, or
-     * `NETWORK_ERROR` when the last call never reached it).
+     * failed record never throws: the release already landed, so the signature is returned
+     * with `confirm.landed: false` and an `EscroConfirmError` (the API's code, or
+     * `NETWORK_ERROR` when the last call never reached it). A release that failed at
+     * execution on chain throws an {@link EscroError} with code `TX_FAILED`, and the API is
+     * never asked to record it.
      *
      * @returns `{ signature, confirm }`.
      */

package/dist/index.js

@@ -658,7 +658,16 @@ async function signAndSend(base64Tx, wallet, connection, cluster) {
   const signature = await connection.sendRawTransaction(raw, {
     skipPreflight: false
   });
-  await connection.confirmTransaction({ signature, blockhash, lastValidBlockHeight }, "confirmed");
+  const { value } = await connection.confirmTransaction(
+    { signature, blockhash, lastValidBlockHeight },
+    "confirmed"
+  );
+  if (value.err !== null) {
+    throw new EscroError(
+      `Transaction ${signature} failed at execution: ${JSON.stringify(value.err)}`,
+      "TX_FAILED"
+    );
+  }
   return signature;
 }
 async function buildReleasePaymentTx(params) {
@@ -783,9 +792,11 @@ var Escro = class {
    * {@link Escro.releasePayment}, reporting whether the API recorded the release.
    * `ESCROW_NOT_SETTLED` (the API's RPC does not yet show the escrow closed), the codes
    * {@link Escro.confirm} retries and a network failure are retried for about 30 s. A
-   * failure never throws: the release already landed, so the signature is returned with
-   * `confirm.landed: false` and an `EscroConfirmError` (the API's code, or
-   * `NETWORK_ERROR` when the last call never reached it).
+   * failed record never throws: the release already landed, so the signature is returned
+   * with `confirm.landed: false` and an `EscroConfirmError` (the API's code, or
+   * `NETWORK_ERROR` when the last call never reached it). A release that failed at
+   * execution on chain throws an {@link EscroError} with code `TX_FAILED`, and the API is
+   * never asked to record it.
    *
    * @returns `{ signature, confirm }`.
    */