@terminal3/t3n-sdk 2.3.0 → 2.4.0

package/dist/src/utils/errors.d.ts

@@ -54,6 +54,50 @@ export declare class RpcError extends T3nError {
     /** Per-request correlation id (JSON-RPC `error.data.request_id`). */
     requestId?: string | undefined);
 }
+/**
+ * Error thrown when the cluster's T3-TS-030 metering chargepoint
+ * denies a contract-register or contract-invocation request because
+ * the billing DID's available balance is below the operation's cost.
+ *
+ * Recognised by the SDK from a stable wire format the node emits
+ * for the `ServiceError::InsufficientCredit` variant — see
+ * `node/api/src/error.rs::service_insufficient_credit_wire_format_is_stable`.
+ * Subclass of `RpcError` so callers that catch the parent still see
+ * the structured `httpStatus` / `requestId` fields; callers that
+ * want the typed surface (frontends rendering an "out of credit"
+ * banner) `instanceof InsufficientCreditError` to read `available`
+ * and `required` directly.
+ *
+ * Terminal — do NOT retry. The next call needs either a mint to
+ * `account` (admin operation) or a reduction in the requested
+ * operation's cost.
+ */
+export declare class InsufficientCreditError extends RpcError {
+    /** Hex DID (no `did:t3n:` prefix) the chargepoint billed. */
+    readonly account: string;
+    /** Tokens the chargepoint required (parsed from `required=`). */
+    readonly required: bigint;
+    /** Tokens available on `account` at check time (parsed from `available=`). */
+    readonly available: bigint;
+    constructor(message: string, 
+    /** Hex DID (no `did:t3n:` prefix) the chargepoint billed. */
+    account: string, 
+    /** Tokens the chargepoint required (parsed from `required=`). */
+    required: bigint, 
+    /** Tokens available on `account` at check time (parsed from `available=`). */
+    available: bigint, rpcMethod?: string, requestId?: string);
+}
+/**
+ * Try to parse the node's stable `InsufficientCredit (account=..., required=..., available=...)`
+ * wire format. Returns the typed error on match, `null` otherwise.
+ * Callers wrap RPC error construction in this so a Forbidden whose
+ * detail matches the format surfaces as the typed class.
+ *
+ * The format is pinned by a server-side test
+ * (`api/src/error.rs::service_insufficient_credit_wire_format_is_stable`)
+ * so a node change that breaks this parser also breaks CI.
+ */
+export declare function tryParseInsufficientCredit(message: string, rpcMethod?: string, requestId?: string): InsufficientCreditError | null;
 /**
  * Error thrown when WASM operations fail
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@terminal3/t3n-sdk",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "type": "module",
   "description": "T3n TypeScript SDK - A minimal SDK that mirrors the server's RPC handler approach",
   "main": "dist/index.js",