@toon-protocol/client 0.20.1 → 0.20.2

package/dist/index.d.ts

@@ -427,7 +427,7 @@ interface ToonClientConfig {
     }>;
     /** File path for persisting payment channel nonce/amount state across restarts */
     channelStorePath?: string;
-    /** Nostr relay URL for peer discovery. Default: 'ws://localhost:7100' */
+    /** Nostr relay URL for peer discovery. Default: 'wss://relay-ws.devnet.toonprotocol.dev' */
     relayUrl?: string;
     /**
      * Known peers to bootstrap with.
@@ -3932,17 +3932,21 @@ declare function buildSettlementInfo(rawConfig: ToonClientConfig): ClientSettlem
 /**
  * Devnet faucet helper.
  *
- * The deployed TOON devnet exposes a faucet that drips test funds to a given
- * chain address so a client can open payment channels and pay for writes:
+ * The deployed TOON devnet exposes a faucet that drips the settlement token
+ * (USDC) to a given chain address so a client can open payment channels and pay
+ * for writes. This helper hits the USDC-ONLY faucet legs — it funds USDC and
+ * assumes the wallet already holds enough native gas to transact:
  *
- *   EVM     `POST {faucetUrl}/api/request`        body `{ address }` → 100 ETH + 10k USDC
- *   Solana  `POST {faucetUrl}/api/solana/request` body `{ address }` → SOL + USDC
- *   Mina    `POST {faucetUrl}/api/mina/request`   body `{ address }` → native MINA + USDC
+ *   EVM     `POST {faucetUrl}/api/base-sepolia/request` body `{ address }` → USDC (Base Sepolia mint)
+ *   Solana  `POST {faucetUrl}/api/solana/usdc-request`  body `{ address }` → USDC (no SOL leg)
+ *   Mina    `POST {faucetUrl}/api/mina/usdc-request`    body `{ address }` → USDC (no MINA leg)
  *
  * Devnet edge (today): `https://faucet.devnet.toonprotocol.dev`.
  *
  * All three chains are live on the deployed faucet — the request shape is
- * identical (`{ address }`); only the path differs.
+ * identical (`{ address }`); only the path differs. (The EVM leg mints the
+ * ungated mock USDC on Base Sepolia and best-effort tops up gas; the Solana and
+ * Mina legs are strictly USDC-only and expect the address to already hold gas.)
  */
 /** Supported faucet chains. */
 type FaucetChain = 'evm' | 'solana' | 'mina';
@@ -3969,12 +3973,12 @@ interface FundWalletOptions {
 /**
  * Default faucet request timeout (ms) for a chain.
  *
- * EVM and Solana faucets respond in a few seconds, so 30s is plenty. The Mina
- * faucet sends native MINA *and* mints USDC on a chain that settles much more
- * slowly: the drip routinely succeeds server-side (the faucet logs
- * `✅ Mina faucet request completed`) but takes well over 30s to answer the
- * HTTP request, so a flat 30s budget makes the client give up on a request that
- * actually worked. Give mina a much longer budget.
+ * The EVM (Base Sepolia mint) and Solana USDC legs respond in a few seconds, so
+ * 30s is plenty. The Mina USDC leg TRANSFERS the token via an o1js-proven
+ * transaction on a chain that settles much more slowly: the drip routinely
+ * succeeds server-side but takes well over 30s to answer the HTTP request, so a
+ * flat 30s budget makes the client give up on a request that actually worked.
+ * Give mina a much longer budget.
  */
 declare function defaultFaucetTimeout(chain: FaucetChain): number;
 /**

package/dist/index.js

@@ -470,7 +470,10 @@ function applyDefaults(rawConfig) {
     connectorUrl,
     // Surface the derived `POST /ilp` endpoint so HTTP mode selects HttpIlpClient.
     ...connectorHttpEndpoint ? { connectorHttpEndpoint } : {},
-    relayUrl: config.relayUrl ?? "ws://localhost:7100",
+    // Last-resort relay default. An explicit `config.relayUrl` always wins;
+    // `applyNetworkPresets` does not set a per-network relay, so this fallback
+    // points at the public devnet relay rather than a dead localhost socket.
+    relayUrl: config.relayUrl ?? "wss://relay-ws.devnet.toonprotocol.dev",
     queryTimeout: config.queryTimeout ?? 3e4,
     maxRetries: config.maxRetries ?? 3,
     retryDelay: config.retryDelay ?? 1e3,
@@ -6868,11 +6871,11 @@ function defaultFaucetTimeout(chain) {
 function faucetPath(chain) {
   switch (chain) {
     case "evm":
-      return "/api/request";
+      return "/api/base-sepolia/request";
     case "solana":
-      return "/api/solana/request";
+      return "/api/solana/usdc-request";
     case "mina":
-      return "/api/mina/request";
+      return "/api/mina/usdc-request";
   }
 }
 async function fundWallet(faucetUrl, address, chain, options = {}) {