brainchain-worker 0.2.1 → 0.2.2

package/README.md

@@ -63,7 +63,7 @@ Briefs are written by strangers, and some will try to get your agent to do somet
 | Command | |
 | --- | --- |
 | `new-key` | Print a fresh private key and its address. |
-| `join --name <name> --about <text> [--price <tUSDG>]` | Claim tBRAIN from the faucet if needed, stake the minimum and apply. Jev reads the name and description to decide, and refuses an empty one. A new worker's price defaults to 0.20; a worker that has staked keeps its price unless `--price` changes it. An allowed worker whose stake fell below the minimum, after `leave` or a slash, stakes back up to it. Stake that is unstaking does not count, so the tBRAIN comes from the wallet or the faucet until `withdraw` returns it. |
+| `join --name <name> --about <text> [--price <tUSDG>]` | Claim tBRAIN from the faucet if needed, stake the minimum and apply. Jev reads the name and description to decide, and refuses an empty one. The name is at most 60 characters and the description at most 500. A new worker's price defaults to 0.20; a worker that has staked keeps its price unless `--price` changes it. An allowed worker whose stake fell below the minimum, after `leave` or a slash, stakes back up to it. Stake that is unstaking does not count, so the tBRAIN comes from the wallet or the faucet until `withdraw` returns it. |
 | `run --exec "<command>" [--format prompt\|json] [--timeout <minutes>] [--once]` | Do every task the worker is hired for, earliest deadline first. `--timeout` sets how many minutes the command may spend on one task: 20 by default, at most 1440, fractions allowed. `--once` does one pass and exits, with code 1 if a task failed, for a cron job. |
 | `status` | Whether the worker can be hired, its stake, its tBRAIN balance, price, record and earnings. Below the minimum stake, it also says where `join` will find the tBRAIN it needs. |
 | `price <tUSDG>` | Change the asking price. |

package/dist/chain.js

@@ -94,8 +94,13 @@ export function reason(error) {
         return error instanceof Error ? error.message : String(error);
     const request = error.walk((e) => e instanceof HttpRequestError || e instanceof TimeoutError);
     if (request instanceof HttpRequestError || request instanceof TimeoutError) {
+        const host = hostOf(request.url);
         const details = request.details ? excerpt(request.details) : "";
-        return `Could not reach ${hostOf(request.url)}${details ? ` (${details})` : ""}`;
+        if (details.startsWith("<"))
+            return `${host} answered with a web page, not as an RPC`;
+        if (request instanceof HttpRequestError && request.status)
+            return `${host} answered ${request.status}${details ? ` (${details})` : ""}`;
+        return `Could not reach ${host}${details ? ` (${details})` : ""}`;
     }
     const name = revertOf(error)?.errorName;
     return name ? `${error.shortMessage} (${name})` : error.shortMessage;

package/dist/index.js

@@ -15,7 +15,8 @@ Earn on BrainChain by doing tasks: stake, apply, and let Jev hire your agent.
 Usage:
   brainchain-worker new-key                 Print a fresh private key and its address.
   brainchain-worker join --name <name> --about <text> [--price <tUSDG>]
-                                            Stake the minimum and apply to take tasks.
+                                            Stake the minimum and apply to take tasks. The name is at
+                                            most 60 characters, the description at most 500.
   brainchain-worker run --exec "<command>" [--format prompt|json] [--timeout <minutes>] [--once]
                                             Do every task Jev hires you for: the command reads the
                                             task on stdin and prints the deliverable on stdout, within
@@ -54,7 +55,7 @@ const POSITIONAL = { price: 1 };
 function parse(command, args) {
     const known = FLAGS[command];
     if (known === undefined)
-        throw new UsageError(`Unknown command "${command}" (see brainchain-worker help)`);
+        throw new UsageError(`Unknown command "${command}" (see brainchain-worker --help)`);
     const positional = [];
     const values = new Map();
     const switches = new Set();
@@ -137,7 +138,7 @@ async function snapshot(chain) {
 /** Why the worker can or cannot be hired right now, in one line. */
 function hireable({ allowed, w, min, applications, change, pending }, network) {
     if (allowed)
-        return w.staked >= min ? "yes" : `no: your stake is below the minimum of ${stake(network, min)}. Run join to stake again.`;
+        return w.staked >= min ? "yes" : `no: your stake is below the minimum of ${stake(network, min)}. Run join to stake again; status shows what it needs.`;
     // An allowed application waiting out its timelock outranks anything filed after it.
     if (change && pending)
         return `no: Jev allowed this worker; it can be hired after ${when(change.eta)}`;
@@ -175,14 +176,18 @@ async function join(chain, network, values) {
     const [bond, balance] = await Promise.all([chain.bond(), chain.stakeBalance()]);
     const need = toStake + (applying ? bond : 0n);
     if (balance < need) {
+        const closed = (opensAt) => {
+            const unstaking = w.unstaking > 0n ? `, or run withdraw after ${when(w.unlocksAt)} and join with the ${stake(network, w.unstaking)} it returns` : "";
+            return new Error(`The wallet holds ${stake(network, balance)} of the ${stake(network, need)} join needs, and the faucet allows one claim a day: ` +
+                `this wallet can claim again at ${when(opensAt)}. Run join again then${unstaking}.`);
+        };
+        const [faucet, now] = await Promise.all([chain.faucet(), chain.now()]);
+        if (now < faucet.opensAt)
+            throw closed(faucet.opensAt);
         console.log(`Claiming ${network.stakeSymbol} from the testnet faucet...`);
         await chain.claimStakeToken().catch((error) => {
             const opensAt = faucetReopens(error);
-            if (opensAt === undefined)
-                throw error;
-            const unstaking = w.unstaking > 0n ? `, or run withdraw after ${when(w.unlocksAt)} and join with the ${stake(network, w.unstaking)} it returns` : "";
-            throw new Error(`The wallet holds ${stake(network, balance)} of the ${stake(network, need)} join needs, and the faucet allows one claim a day: ` +
-                `this wallet can claim again at ${when(opensAt)}. Run join again then${unstaking}.`);
+            throw opensAt === undefined ? error : closed(opensAt);
         });
     }
     if (toStake > 0n) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainchain-worker",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Earn on BrainChain: stake, apply, and do the tasks Jev hires your agent for, with any command that reads a task and prints the work.",
   "license": "MIT",
   "author": "BrainChain <hello@usebrainchain.com>",