Errors

1
import { ErrorCode, isGwopError, ErrorResponse } from "@gwop/sdk/errors";
2
3
try {
4
  await gwop.invoices.create({ body: { amountUsdc: -1 } });
5
} catch (err) {
6
  // Match on error code — access statusCode, headers, body
7
  if (isGwopError(err, ErrorCode.ValidationError)) {
8
    console.log(err.statusCode); // 400
9
  }
10
11
  // Access structured error fields — use instanceof ErrorResponse
12
  if (err instanceof ErrorResponse) {
13
    console.log(err.error.code);    // "VALIDATION_ERROR"
14
    console.log(err.error.message); // "amount_usdc must be at least 1 (0.000001 USDC)"
15
  }
16
}

1
import { ErrorCode, isGwopError, ErrorResponse } from "@gwop/sdk/errors";
2
3
try {
4
  await gwop.invoices.create({ body: { amountUsdc: 1_000_000 } });
5
} catch (err) {
6
  // Recommended — works across all SDK methods
7
  if (isGwopError(err, ErrorCode.ValidationError)) {
8
    err.statusCode; // 400
9
  }
10
11
  if (isGwopError(err, ErrorCode.RateLimited)) {
12
    err.headers.get("retry-after"); // When to retry
13
  }
14
15
  // Manual access — when you need the full ErrorResponse type
16
  if (err instanceof ErrorResponse) {
17
    err.error.code;    // UPPER_SNAKE_CASE error code
18
    err.error.message; // Human-readable description
19
    err.statusCode;    // HTTP status code
20
  }
21
22
  // Any SDK HTTP error
23
  if (isGwopError(err)) {
24
    err.statusCode; // HTTP status code
25
    err.headers;    // Response headers
26
    err.body;       // Raw response body
27
  }
28
}

1
import { ErrorCode, isGwopError } from "@gwop/sdk/errors";
2
3
async function createInvoiceWithRetry(amount: number, maxRetries = 3) {
4
  const idempotencyKey = crypto.randomUUID();
5
6
  for (let attempt = 0; attempt < maxRetries; attempt++) {
7
    try {
8
      return await gwop.invoices.create({
9
        idempotencyKey,
10
        body: { amountUsdc: amount },
11
      });
12
    } catch (err) {
13
      if (isGwopError(err, ErrorCode.RateLimited)) {
14
        const retryAfter = err.headers.get("retry-after") ?? "60";
15
        await new Promise((r) => setTimeout(r, Number(retryAfter) * 1000));
16
        continue;
17
      }
18
      throw err; // Don't retry client errors
19
    }
20
  }
21
  throw new Error("Max retries exceeded");
22
}

1
import { ErrorCode, isGwopError } from "@gwop/sdk/errors";
2
3
try {
4
  await gwop.authIntents.exchange({ authIntentId, idempotencyKey: crypto.randomUUID() });
5
} catch (err) {
6
  if (isGwopError(err, ErrorCode.AuthIntentNotSettled)) {
7
    // Agent hasn't paid yet — poll and retry
8
  } else if (isGwopError(err, ErrorCode.AuthIntentNotFound)) {
9
    // Invalid intent ID — create a new one
10
  } else if (isGwopError(err, ErrorCode.AuthIntentExpired)) {
11
    // TTL exceeded — create a new auth intent
12
  } else {
13
    throw err;
14
  }
15
}