@kushbitx/sdk 0.1.0 → 0.1.2

package/README.md

@@ -9,9 +9,9 @@ Zero-dependency ESM client and runnable Node.js example for the complete KushBit
 | Token market preview | Free | Inspect basic Base token market data without connecting a wallet. |
 | Data coverage check | Free | See which risk checks have enough evidence before buying a report. |
 | SpendGuard | Free pilot | Evaluate payment policy before money moves, with optional protected policies and human approval. |
-| Token-risk report | 0.25 USDC | Receive structured token-risk evidence with missing checks identified. |
-| Transaction preflight | 0.05 USDC | Inspect an unsigned Base transaction before signing. |
-| Payment verification | 0.01 USDC | Verify an existing Base USDC payment against the expected recipient and amount. |
+| Token-risk report | 0.00098 USDC | Receive structured token-risk evidence with missing checks identified. |
+| Transaction preflight | 0.00098 USDC | Inspect an unsigned Base transaction before signing. |
+| Payment verification | 0.00288 USDC | Verify an existing Base USDC payment against the expected recipient and amount. |
 
 Paid endpoints use x402 and require explicit payment. There is no subscription. A delivered report can be `INCOMPLETE` when evidence is unavailable and may still incur the displayed fee.
 
@@ -62,11 +62,16 @@ import { KushBitxClient } from 'https://kushbitx.com/sdk/kushbitx.mjs';
 ## Links
 
 - Website: https://kushbitx.com
+- Source: https://github.com/BHamim/kushbitx-sdk
 - Tools: https://kushbitx.com/#tools
 - SpendGuard: https://kushbitx.com/spendguard
 - Integration example: https://kushbitx.com/examples/agent.mjs
 - Contact: Admin@kushbitx.com
 
+## Community contributions
+
+- [@mengxin10086](https://github.com/mengxin10086) built an independent MCP bridge for the free KushBitx endpoints. KushBitx reviewed and accepted commit `0e4d3226` ([source at that commit](https://github.com/mengxin10086/kushbitx-mcp-agent/tree/0e4d32267d4692d32cfb7c451d391cd59093a883)). It is third-party code, maintained by its author.
+
 ## Security
 
 Do not disclose suspected vulnerabilities in public issues. Report them privately to Admin@kushbitx.com.

package/kushbitx.mjs

@@ -12,6 +12,17 @@ function required(value, name) {
   return value;
 }
 
+function errorMessage(data) {
+  return data && typeof data === 'object' && typeof data.error === 'string' ? data.error : '';
+}
+
+// A success needs a JSON object body. null, arrays, scalars and invalid JSON are errors.
+function jsonObject({ data, parseError }, status) {
+  if (parseError) throw new Error('KushBitx returned invalid JSON with HTTP ' + status, { cause: parseError });
+  if (data === null || typeof data !== 'object' || Array.isArray(data)) throw new Error('KushBitx returned an empty or non-object JSON body with HTTP ' + status);
+  return data;
+}
+
 export class KushBitxClient {
   constructor({ baseUrl = 'https://kushbitx.com', fetchFn = globalThis.fetch } = {}) {
     if (typeof fetchFn !== 'function') throw new Error('A fetch implementation is required');
@@ -29,14 +40,22 @@ export class KushBitxClient {
       },
       ...(body === undefined ? {} : { body: JSON.stringify(body) })
     });
-    const data = await response.json().catch(() => ({}));
-    return { response, data };
+    // An unreadable body stays visible as data=null; it is never replaced by an empty object.
+    let data = null;
+    let parseError = null;
+    try {
+      data = await response.json();
+    } catch (error) {
+      parseError = error;
+    }
+    return { response, data, parseError };
   }
 
   async expect(path, options, statuses = [200]) {
     const result = await this.request(path, options);
-    if (!statuses.includes(result.response.status)) throw new Error(result.data.error || 'KushBitx request failed with HTTP ' + result.response.status);
-    return result.data;
+    const { status } = result.response;
+    if (!statuses.includes(status)) throw new Error(errorMessage(result.data) || 'KushBitx request failed with HTTP ' + status);
+    return jsonObject(result, status);
   }
 
   previewToken(address) {
@@ -75,8 +94,8 @@ export class KushBitxClient {
     const path = PAID_SERVICES[service];
     if (!path) throw new Error('Unknown paid service');
     const result = await this.request(path, { body: input });
-    if (result.response.status !== 402) throw new Error(result.data.error || 'Expected an HTTP 402 payment challenge');
-    return { service, path, challenge: result.data, paymentRequired: result.response.headers.get('PAYMENT-REQUIRED') };
+    if (result.response.status !== 402) throw new Error(errorMessage(result.data) || 'Expected an HTTP 402 payment challenge');
+    return { service, path, challenge: jsonObject(result, 402), paymentRequired: result.response.headers.get('PAYMENT-REQUIRED') };
   }
 
   prepareRecovery(service, input) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kushbitx/sdk",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Zero-dependency ESM client for KushBitx AgentProof services on Base",
   "type": "module",
   "exports": "./kushbitx.mjs",
@@ -20,13 +20,14 @@
     "payment-security",
     "spendguard"
   ],
-  "homepage": "https://kushbitx.com",
+  "homepage": "https://github.com/BHamim/kushbitx-sdk#readme",
   "repository": {
     "type": "git",
-    "url": "https://github.com/kushBitxHQ/kushbitx-sdk"
+    "url": "git+https://github.com/BHamim/kushbitx-sdk.git"
   },
   "bugs": {
-    "url": "https://github.com/kushBitxHQ/kushbitx-sdk/issues"
+    "url": "https://github.com/BHamim/kushbitx-sdk/issues",
+    "email": "admin@kushbitx.com"
   },
   "license": "Apache-2.0"
 }