@toon-protocol/client 0.20.1 → 0.20.3

package/dist/index.d.ts

@@ -107,6 +107,8 @@ interface WalletBalanceSources {
         chainKey?: string;
         graphqlUrl: string;
         owner: string;
+        /** Settlement-token Field id (decimal). Reads the token balance when set. */
+        tokenId?: string;
     };
     /** Injectable fetch (Solana/Mina JSON-RPC & GraphQL) for tests. */
     fetchImpl?: typeof fetch;
@@ -427,7 +429,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 +3934,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 +3975,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,
@@ -4056,6 +4059,7 @@ var JsonFileChannelStore = class {
 
 // src/balance/WalletBalanceReader.ts
 import { createPublicClient as createPublicClient2, http as http2, defineChain as defineChain2 } from "viem";
+import { sha256 as sha2564 } from "@noble/hashes/sha2.js";
 var ERC20_READ_ABI = [
   { name: "balanceOf", type: "function", stateMutability: "view", inputs: [{ name: "account", type: "address" }], outputs: [{ type: "uint256" }] },
   { name: "decimals", type: "function", stateMutability: "view", inputs: [], outputs: [{ type: "uint8" }] },
@@ -4170,6 +4174,62 @@ async function readMinaBalance(opts) {
     assetScale: 9
   };
 }
+var BASE58_ALPHABET2 = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+function base58encode(bytes) {
+  let num = 0n;
+  for (const b of bytes) num = num * 256n + BigInt(b);
+  let out = "";
+  while (num > 0n) {
+    out = BASE58_ALPHABET2[Number(num % 58n)] + out;
+    num /= 58n;
+  }
+  for (const b of bytes) {
+    if (b === 0) out = "1" + out;
+    else break;
+  }
+  return out;
+}
+function minaTokenIdToBase58(tokenId) {
+  if (!/^\d+$/.test(tokenId)) {
+    throw new Error(`Mina tokenId must be a decimal Field string: "${tokenId}"`);
+  }
+  let field = BigInt(tokenId);
+  const le = new Uint8Array(32);
+  for (let i = 0; i < 32; i++) {
+    le[i] = Number(field & 0xffn);
+    field >>= 8n;
+  }
+  const body = new Uint8Array(1 + 32);
+  body[0] = 28;
+  body.set(le, 1);
+  const checksum = sha2564(sha2564(body)).slice(0, 4);
+  const raw = new Uint8Array(body.length + 4);
+  raw.set(body, 0);
+  raw.set(checksum, body.length);
+  return base58encode(raw);
+}
+async function readMinaTokenBalance(opts) {
+  const fetchImpl = opts.fetchImpl ?? fetch;
+  const token = minaTokenIdToBase58(opts.tokenId);
+  const query = "query($pk:PublicKey!,$t:TokenId){account(publicKey:$pk,token:$t){balance{total}}}";
+  const res = await fetchImpl(opts.graphqlUrl, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({ query, variables: { pk: opts.owner, t: token } })
+  });
+  if (!res.ok) throw new Error(`Mina GraphQL request failed: HTTP ${res.status}`);
+  const json = await res.json();
+  if (json.errors && json.errors.length > 0) {
+    throw new Error(`Mina GraphQL error: ${json.errors[0]?.message ?? "unknown"}`);
+  }
+  return {
+    chain: "mina",
+    address: opts.owner,
+    amount: String(json.data?.account?.balance?.total ?? "0"),
+    asset: "USDC",
+    assetScale: 9
+  };
+}
 var errText = (e) => e instanceof Error ? e.message : String(e);
 function foldNative(out, settled, errors) {
   if (settled.status === "fulfilled") out.native = settled.value;
@@ -4234,24 +4294,28 @@ async function readWalletBalances(sources) {
     );
   }
   if (sources.mina) {
-    const { chainKey = "mina", graphqlUrl, owner } = sources.mina;
+    const { chainKey = "mina", graphqlUrl, owner, tokenId } = sources.mina;
     tasks.push(
       (async () => {
         const out = { chain: "mina", chainKey, address: owner, tokens: [] };
         const errors = [];
-        const nativeR = await Promise.allSettled([readMinaBalance({ graphqlUrl, owner, fetchImpl })]);
+        const [nativeR, tokenR] = await Promise.allSettled([
+          readMinaBalance({ graphqlUrl, owner, fetchImpl }),
+          tokenId ? readMinaTokenBalance({ graphqlUrl, owner, tokenId, fetchImpl }) : Promise.resolve(void 0)
+        ]);
         foldNative(
           out,
-          nativeR[0].status === "fulfilled" ? {
+          nativeR.status === "fulfilled" ? {
             status: "fulfilled",
             value: {
-              symbol: nativeR[0].value.asset,
-              amount: nativeR[0].value.amount,
-              decimals: nativeR[0].value.assetScale
+              symbol: nativeR.value.asset,
+              amount: nativeR.value.amount,
+              decimals: nativeR.value.assetScale
             }
-          } : nativeR[0],
+          } : nativeR,
           errors
         );
+        foldToken(out, tokenR, void 0, errors);
         finalizeChain(out, errors);
         return out;
       })()
@@ -5935,7 +5999,12 @@ var ToonClient = class {
     if (mina?.graphqlUrl) {
       const minaAddress = this.getMinaAddress() ?? (await ensureDerived())?.mina.publicKey;
       if (minaAddress) {
-        sources.mina = { chainKey: "mina", graphqlUrl: mina.graphqlUrl, owner: minaAddress };
+        sources.mina = {
+          chainKey: "mina",
+          graphqlUrl: mina.graphqlUrl,
+          owner: minaAddress,
+          ...mina.tokenId ? { tokenId: mina.tokenId } : {}
+        };
       }
     }
     return readWalletBalances(sources);
@@ -6868,11 +6937,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 = {}) {