clutch-hub-sdk-js 3.0.0 → 4.0.0

package/CHANGELOG.md

@@ -1,3 +1,25 @@
+## [4.0.0](https://github.com/clutchprotocol/clutch-hub-sdk-js/compare/v3.0.0...v4.0.0) (2026-09-04)
+
+
+### ⚠ BREAKING CHANGES
+
+* `requestFaucet` is removed from `ClutchHubSdk` and the
+`FaucetResponse` type is no longer exported. There is no replacement — the
+server endpoint is gone; CLT is obtained by depositing USDT.
+
+Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
+
+### Features
+
+* remove requestFaucet ([a8186f5](https://github.com/clutchprotocol/clutch-hub-sdk-js/commit/a8186f555588f781a8c7a1e905e724b343ae2948))
+
+
+### Reverts
+
+* the 4.0.0 release commit that npm rejected ([ba16f76](https://github.com/clutchprotocol/clutch-hub-sdk-js/commit/ba16f76e6e49b9153dcd0c5e954e926c9f0f0dee))
+* the 4.0.0 release commit, which npm rejected ([fd456d9](https://github.com/clutchprotocol/clutch-hub-sdk-js/commit/fd456d98c2f70a3f8d86da82eaaa84289919a0d6))
+* the orphaned 4.0.0 release commit ([9d49388](https://github.com/clutchprotocol/clutch-hub-sdk-js/commit/9d49388b45c67ef030dd2d78775b815228c9253e))
+
 ## [3.0.0](https://github.com/clutchprotocol/clutch-hub-sdk-js/compare/v2.0.1...v3.0.0) (2026-07-30)
 
 

package/CLAUDE.md

@@ -10,13 +10,13 @@ Only four source files — the SDK is deliberately small:
 
 - `src/sdk.ts` — everything important: `ClutchHubSdk` class, JWT auth caching, signing/hashing,
   RLP encoding (`encodeFunctionCall`), all GraphQL queries/mutations/subscriptions inline as
-  template strings, faucet helper. Also exports `stripHexPrefix`, `normalizeTxHashForRlp`,
+  template strings. Also exports `stripHexPrefix`, `normalizeTxHashForRlp`,
   `UnsignedTransaction`.
 - `src/subscriptions.ts` — `hubGraphqlWsUrl()` (HTTP base URL → `ws(s)://…/graphql/ws`),
   `createHubSubscriptionClient()` (graphql-ws client: `lazy: false`, infinite retry, 10s keepAlive),
   shared GraphQL field-selection constants (`RIDE_REQUEST_GQL_FIELDS` etc.), `SubscriptionHandlers<T>`.
 - `src/types.ts` — arg/result interfaces (`RideRequestArgs`, `AvailableActiveTrip`, `MapBounds`,
-  `Signature`, `FaucetResponse`, …).
+  `Signature`, …).
 - `src/index.ts` — barrel re-exports. New public symbols must be reachable from here.
 
 There is no test suite. `test_rlp_fix.{js,mjs}` are ad-hoc manual scripts run against `dist/` after
@@ -68,8 +68,7 @@ legacy JSON-string quoting); empty referrer encodes as `''`.
   `subscribeAccountBalance`. All multiplex over **one shared graphql-ws socket per
   (hub URL, publicKey)**, refcounted in a module-global map; the last dispose closes the socket.
   Always call the returned dispose function or sockets/refcounts leak.
-- **Misc**: `requestFaucet(address)` — plain `POST /faucet` (no JWT), returns
-  `{ ok: false, error }` instead of throwing; `getGraphqlWsUrl()`.
+- **Misc**: `getGraphqlWsUrl()`.
 
 ## Adding a New Transaction Type
 

package/README.md

@@ -27,9 +27,6 @@ import { ClutchHubSdk } from 'clutch-hub-sdk-js';
 // proof-of-key-ownership challenge (the key stays local, it is never sent).
 const sdk = new ClutchHubSdk('http://localhost:3000', publicKey, privateKey);
 
-// Fund test wallet
-await sdk.requestFaucet(publicKey);
-
 // Create, sign, and submit a ride request
 const unsigned = await sdk.createUnsignedRideRequest({
   pickup: { latitude: 35.7, longitude: 51.4 },
@@ -45,7 +42,6 @@ await sdk.submitTransaction(signed.rawTransaction);
 - Client-side signing (private keys never sent to server)
 - Full ride lifecycle: request, offer, accept, pay, cancel
 - GraphQL queries and WebSocket subscriptions
-- Testnet faucet helper
 - TypeScript types
 
 ## API methods
@@ -56,7 +52,6 @@ await sdk.submitTransaction(signed.rawTransaction);
 | Write | `createUnsignedRide*`, `signTransaction`, `submitTransaction` |
 | Read | `listRideRequests`, `listRideOffers`, `listActiveTrips`, `getAccountBalance`, … |
 | Live | `subscribeRideRequests`, `subscribeRideOffers`, `subscribeActiveTrips`, … |
-| Faucet | `requestFaucet(recipientAddress)` |
 
 Full reference: https://docs.clutchprotocol.io/clutch-hub-sdk-js/api-reference
 

package/dist/sdk.d.ts

@@ -1,6 +1,6 @@
 import { Buffer } from 'buffer';
 import { type SubscriptionHandlers } from './subscriptions.js';
-import { AvailableRideRequest, AvailableRideOffer, AvailableActiveTrip, AvailableCompletedTrip, AvailableRecentTrip, BurnArgs, FaucetResponse, MapBounds, RideRequestArgs, RideOfferArgs, RideAcceptanceArgs, RidePayArgs, RideCancelArgs, RideRequestCancelArgs, Signature } from './types.js';
+import { AvailableRideRequest, AvailableRideOffer, AvailableActiveTrip, AvailableCompletedTrip, AvailableRecentTrip, BurnArgs, MapBounds, RideRequestArgs, RideOfferArgs, RideAcceptanceArgs, RidePayArgs, RideCancelArgs, RideRequestCancelArgs, Signature } from './types.js';
 /** Strip 0x/0X prefix - hex parsers (e.g. @noble/secp256k1) do not accept it. Exported for consumers. */
 export declare function stripHexPrefix(hex: string): string;
 /**
@@ -275,11 +275,6 @@ export declare class ClutchHubSdk {
     subscribeAccountBalance(options: {
         publicKey?: string;
     } | undefined, handlers: SubscriptionHandlers<bigint>): () => void;
-    /**
-     * Request test CLT from the Hub API faucet (POST /faucet). Requires `faucet_enabled` and a funded
-     * `faucet_private_key` on the server. No GraphQL auth token required for this HTTP endpoint.
-     */
-    requestFaucet(recipientAddress: string): Promise<FaucetResponse>;
     /**
      * Builds the nested array representing the function call for RLP encoding.
      */

package/dist/sdk.js

@@ -868,27 +868,6 @@ export class ClutchHubSdk {
             release();
         };
     }
-    /**
-     * Request test CLT from the Hub API faucet (POST /faucet). Requires `faucet_enabled` and a funded
-     * `faucet_private_key` on the server. No GraphQL auth token required for this HTTP endpoint.
-     */
-    async requestFaucet(recipientAddress) {
-        try {
-            const res = await this.apiClient.post('/faucet', { address: recipientAddress });
-            return {
-                ok: true,
-                amount_clt: res.data.amount_clt,
-                node: res.data.node,
-            };
-        }
-        catch (err) {
-            const ax = err;
-            const msg = typeof ax.response?.data?.error === 'string'
-                ? ax.response.data.error
-                : ax.message ?? 'Faucet request failed';
-            return { ok: false, error: String(msg) };
-        }
-    }
     /**
      * Builds the nested array representing the function call for RLP encoding.
      */

package/dist/types.d.ts

@@ -47,13 +47,6 @@ export interface ChainInfo {
     totalSupply: bigint;
     mintAuthority: string;
 }
-/** Response from POST /faucet when the Hub API faucet is enabled (test networks). */
-export interface FaucetResponse {
-    ok: boolean;
-    amount_clt?: number;
-    node?: unknown;
-    error?: string;
-}
 /** Map viewport bounds for filtering ride requests by pickup location. */
 export interface MapBounds {
     minLat: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clutch-hub-sdk-js",
-  "version": "3.0.0",
+  "version": "4.0.0",
   "description": "JavaScript SDK for interacting with the clutch-hub-api",
   "main": "dist/index.js",
   "module": "dist/index.js",

package/src/sdk.ts

@@ -20,7 +20,6 @@ import {
   AvailableCompletedTrip,
   AvailableRecentTrip,
   BurnArgs,
-  FaucetResponse,
   MapBounds,
   RideRequestArgs,
   RideOfferArgs,
@@ -1155,31 +1154,6 @@ export class ClutchHubSdk {
     };
   }
 
-  /**
-   * Request test CLT from the Hub API faucet (POST /faucet). Requires `faucet_enabled` and a funded
-   * `faucet_private_key` on the server. No GraphQL auth token required for this HTTP endpoint.
-   */
-  public async requestFaucet(recipientAddress: string): Promise<FaucetResponse> {
-    try {
-      const res = await this.apiClient.post<{ ok: boolean; amount_clt: number; node: unknown }>(
-        '/faucet',
-        { address: recipientAddress }
-      );
-      return {
-        ok: true,
-        amount_clt: res.data.amount_clt,
-        node: res.data.node,
-      };
-    } catch (err: unknown) {
-      const ax = err as { response?: { data?: { error?: string } }; message?: string };
-      const msg =
-        typeof ax.response?.data?.error === 'string'
-          ? ax.response.data.error
-          : ax.message ?? 'Faucet request failed';
-      return { ok: false, error: String(msg) };
-    }
-  }
-
   /**
    * Builds the nested array representing the function call for RLP encoding.
    */

package/src/types.ts

@@ -57,14 +57,6 @@ export interface ChainInfo {
   mintAuthority: string;
 }
 
-/** Response from POST /faucet when the Hub API faucet is enabled (test networks). */
-export interface FaucetResponse {
-  ok: boolean;
-  amount_clt?: number;
-  node?: unknown;
-  error?: string;
-}
-
 /** Map viewport bounds for filtering ride requests by pickup location. */
 export interface MapBounds {
   minLat: number;