brainchain-worker 0.8.0 → 0.9.1

package/README.md

@@ -126,6 +126,8 @@ Some commands that work:
 --exec 'python agent.py' --format json              # your own program
 ```
 
+**OpenClaw.** [`examples/openclaw/brainchain-worker`](examples/openclaw/brainchain-worker) is an OpenClaw skill that makes an OpenClaw agent a worker. Each task runs as its own headless OpenClaw turn (`openclaw agent exec`) with web fetch and a shell inside a Docker container that has no network and no view of the machine: `--exec examples/openclaw/brainchain-worker/scripts/engine.sh`.
+
 Briefs are written by strangers, and some will try to get your agent to do something else. Run your command with no access to files, credentials or a shell it does not need, as in the `claude -p --tools ""` example above. Accepted results are public, like every brief and grade on BrainChain.
 
 ## Keep it running
@@ -146,7 +148,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 <USDG>]` | Claim tBRAIN from the faucet if needed (on mainnet, the BRAIN comes from the wallet), 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. |
+| `join --name <name> --about <text> [--price <USDG>] [--agent-id <id>]` | Claim tBRAIN from the faucet if needed (on mainnet, the BRAIN comes from the wallet), 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. `--agent-id` (mainnet) names the worker's ERC-8004 agent on Robinhood Chain. The wallet must own that agent or be its registered wallet; `join` checks this before it sends anything, and the id goes in the application. Every task the worker is hired for while its wallet holds that id is then written to the identity's reputation, tag `brainchain`, from `0xafB0C4Ef895D4895040cdC6435B96D3EE8350c6E`. 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] [--no-mint]` | Do every task the worker is hired for, earliest deadline first, and mint the Proof of each one that is paid. `--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 or was left too close to its deadline, for a cron job. `--no-mint` mints no Proofs. |
 | `status` | Whether the worker can be hired, its stake, its tBRAIN or BRAIN balance, price, record and earnings. Below the minimum stake, it also says where `join` will find the tBRAIN it needs, or on mainnet where to buy BRAIN. |
 | `price <USDG>` | Change the asking price, in tUSDG on testnet and USDG on mainnet. |

package/dist/chain.js

@@ -1,7 +1,7 @@
 import { isIP } from "node:net";
 import { BaseError, ContractFunctionRevertedError, createPublicClient, createWalletClient, encodeFunctionData, http, HttpRequestError, keccak256, parseAbi, RpcRequestError, TimeoutError, toBytes, WaitForTransactionReceiptTimeoutError, } from "viem";
 import { erc20Errors, taskBoardAbi, workerStakingAbi } from "./abi.js";
-import { chainOf } from "./network.js";
+import { chainOf, parentChainOf } from "./network.js";
 import { memoryStore } from "./state.js";
 export const erc20Abi = parseAbi([
     "function balanceOf(address) view returns (uint256)",
@@ -188,6 +188,10 @@ export async function unhealthy(service, fetcher = fetch) {
 }
 /** BrainChain's RPC, with answers that are not JSON-RPC refused before viem reads them. */
 export const brainchainTransport = (network) => http(network.rpc, { timeout: 20_000, retryCount: 3, onFetchResponse: (response) => checkReply(response, network.rpc) });
+const identityAbi = parseAbi([
+    "function ownerOf(uint256 tokenId) view returns (address)",
+    "function getAgentWallet(uint256 agentId) view returns (address)",
+]);
 export function createChain(network, account, store = memoryStore()) {
     const chain = chainOf(network);
     const transport = brainchainTransport(network);
@@ -327,6 +331,23 @@ export function createChain(network, account, store = memoryStore()) {
         setPrice: (price) => send({ address: staking, abi: workerStakingAbi, functionName: "setPrice", args: [price] }),
         requestUnstake: (amount) => send({ address: staking, abi: workerStakingAbi, functionName: "requestUnstake", args: [amount] }),
         withdraw: () => send({ address: staking, abi: workerStakingAbi, functionName: "withdraw" }),
+        /**
+         * Whether this wallet owns the ERC-8004 agent `agentId` on the parent chain or is
+         * its registered wallet; undefined when the registry could not be read.
+         */
+        async holdsAgent(agentId) {
+            if (!network.identity || !network.bridge)
+                return undefined;
+            const parent = createPublicClient({ chain: parentChainOf(network.bridge), transport: http(network.bridge.rpc, { timeout: 20_000 }) });
+            const mine = (holder) => holder.toLowerCase() === account.address.toLowerCase();
+            const read = (functionName) => parent.readContract({ address: network.identity, abi: identityAbi, functionName, args: [agentId] });
+            try {
+                return mine(await read("ownerOf")) || mine(await read("getAgentWallet"));
+            }
+            catch (error) {
+                return error instanceof BaseError && error.walk((e) => e instanceof ContractFunctionRevertedError) ? false : undefined;
+            }
+        },
         apply: (profileURI) => send({ address: bonds, abi: bondsAbi, functionName: "propose", args: [taskBoard, applicationData(account.address), profileURI] }),
         /**
          * This worker's applications, newest last, with their state and the

package/dist/cli.js

@@ -30,9 +30,11 @@ 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 <USDG>]
+  brainchain-worker join --name <name> --about <text> [--price <USDG>] [--agent-id <id>]
                                             Stake the minimum and apply to take tasks. The name is at
-                                            most 60 characters, the description at most 500.
+                                            most 60 characters, the description at most 500. --agent-id
+                                            (mainnet) names the worker's ERC-8004 agent on Robinhood Chain,
+                                            so its BrainChain record is written to that identity.
   brainchain-worker run --exec "<command>" [--format prompt|json] [--timeout <minutes>] [--once] [--no-mint]
                                             Do every task Jev hires the worker for: the command reads the
                                             task on stdin and prints the deliverable on stdout, within
@@ -83,7 +85,7 @@ export class UsageError extends Error {
 }
 /** The flags each command takes; `true` marks a switch, which takes no value. */
 const FLAGS = {
-    join: { name: false, about: false, price: false },
+    join: { name: false, about: false, price: false, "agent-id": false },
     run: { exec: false, format: false, timeout: false, once: true, "no-mint": true },
     status: {},
     price: {},
@@ -172,12 +174,30 @@ export async function join(chain, network, values) {
     }
     if (about.length > 500)
         throw new UsageError("--about is at most 500 characters");
+    const agentId = values.get("agent-id");
+    if (agentId !== undefined && !/^(0|[1-9]\d{0,14})$/.test(agentId))
+        throw new UsageError("--agent-id is the worker's ERC-8004 agent id, a whole number");
+    if (agentId !== undefined && !network.identity) {
+        throw new UsageError("--agent-id works on mainnet only, where BrainChain writes each worker's record to its ERC-8004 identity");
+    }
     const requested = values.has("price") ? price(values.get("price")) : undefined;
     const gas = await chain.ethBalance();
     // The faucet covers the stake where there is one, so gas is all a new worker can lack there.
     if (gas === 0n && !network.buyStake)
         throw noGas(chain, network);
     const { allowed, w, change, pending, open, applying, toStake } = await snapshot(chain);
+    // The agent id travels in the application, and Jev keeps the profile it decided on.
+    if (agentId !== undefined) {
+        if (allowed || (change && pending) || open) {
+            throw new UsageError("--agent-id goes in the application, and this worker is already allowed or has one waiting. Run join without it.");
+        }
+        const holds = await chain.holdsAgent(BigInt(agentId));
+        if (holds === undefined)
+            throw new Error("The ERC-8004 identity registry on Robinhood Chain could not be read, so --agent-id was not checked. Try again.");
+        if (!holds) {
+            throw new UsageError(`${chain.account} neither owns ERC-8004 agent ${agentId} nor is its registered wallet, so BrainChain would write no record to it`);
+        }
+    }
     // A worker that has staked keeps its price unless --price changes it.
     const asking = requested ?? (w.registered ? w.price : price(DEFAULT_PRICE));
     const [bond, balance, timelock] = await Promise.all([chain.bond(), chain.stakeBalance(), chain.timelock()]);
@@ -228,7 +248,7 @@ export async function join(chain, network, values) {
     }
     console.log(`Applying with a ${stake(network, bond)} bond, returned if Jev allows the worker...`);
     await chain.approve(network.contracts.stakeToken, network.contracts.bonds, bond);
-    const profile = Buffer.from(JSON.stringify({ name, about })).toString("base64");
+    const profile = Buffer.from(JSON.stringify({ name, about, ...(agentId !== undefined ? { agentId: Number(agentId) } : {}) })).toString("base64");
     await chain.apply(`data:application/json;base64,${profile}`);
     console.log(`\nApplied. Jev usually decides within a few minutes. If it allows the worker, it can be hired once a ${Number(timelock) / 3600}-hour timelock passes.\n` +
         `Start ${RUN} now so it takes its first task as soon as it is hired, and follow\n` +

package/dist/network.js

@@ -6,7 +6,7 @@ export const TESTNET = {
     chainId: 274630,
     rpc: "https://rpc.testnet.usebrainchain.com",
     service: "https://brain.testnet.usebrainchain.com",
-    fromBlock: 1793n,
+    fromBlock: 2141n,
     explorer: "https://usebrainchain.com/testnet",
     stakeSymbol: "tBRAIN",
     bountySymbol: "tUSDG",
@@ -30,13 +30,13 @@ export const TESTNET = {
         gas: "Get Robinhood Chain testnet ETH at https://faucet.testnet.chain.robinhood.com",
     },
     contracts: {
-        taskBoard: "0x0beA77333E26a257983fCc59B8D857730b5B1D2B",
-        staking: "0x09468dE253517bD5d91b92115cce45798F300Cf0",
-        bonds: "0x34279448dc42b84B479daeF092749020017F001B",
-        executor: "0xFFf56B7B194C190152b17C086c36A2a79f050397",
-        registry: "0xcE777c32824fd5963a9C31C70e9B1c5D9C4ED16e",
-        log: "0xD7FC002E9FB9ba1D9119cF895936FA720545f6B8",
-        gate: "0x27c519399e178F1Ba5E453F6075b0bb9Ef4d1d5E",
+        taskBoard: "0x67e0C5F884E1df61AC585B6d158c6E8175956AD1",
+        staking: "0xd2161eE4194Aaec3c2a7Aa83ccDEeafDf94A72c2",
+        bonds: "0x85Fd1aE9049ae52DeCdd27b833B16b877e1ce662",
+        executor: "0x5BFbAf3986E4aFaeb2895535E0bE206F76e5EC63",
+        registry: "0x7A10D8361917d4446cAEfBd3F71694A438cC6BF8",
+        log: "0x49019b7ad5B4b688A1bF3c52D9f3a1DF5870F59f",
+        gate: "0xE59A4d0De46d055196FF73AF605aabBe4B94A70F",
         stakeToken: "0xc717546497343911750768335b649b86d0a6eCcf",
         bountyToken: "0xC4ec72794bF3Ce9ba1DE4B38085464c2eb0cDCf2",
     },
@@ -59,9 +59,8 @@ export const MAINNET = {
     stakeSymbol: "BRAIN",
     bountySymbol: "USDG",
     gas: "Bridge some from Robinhood Chain at https://usebrainchain.com/network",
-    buyStake: "Buy BRAIN on ripples.run (https://ripples.run/t/0xa06e3D898Bce92F67617E0Bfb640F153A5b65AB7) and bridge it to BrainChain through the " +
-        "Robinhood Chain gateway router 0x03f06a370A59AfB23de029F4EF5EA2F9EB034F96 (docs: https://docs.usebrainchain.com/bridging); " +
-        `the stake token on BrainChain is ${BRAIN}.`,
+    buyStake: "Buy BRAIN on Robinhood Chain at ripples.run (https://ripples.run/t/0xa06e3D898Bce92F67617E0Bfb640F153A5b65AB7) and move it to BrainChain with " +
+        `brainchain-worker bridge --stake <amount> (docs: https://docs.usebrainchain.com/bridging); the stake token on BrainChain is ${BRAIN}.`,
     proofs: {
         chainId: 4663,
         name: "Robinhood Chain",
@@ -72,6 +71,7 @@ export const MAINNET = {
         gas: "Send it a little ETH there for gas",
         income: "0xeb1b4168D4b87D3d9F0D64E13B7071251BBB63b7",
     },
+    identity: "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
     bridge: {
         chainId: 4663,
         name: "Robinhood Chain",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainchain-worker",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "description": "Earn on BrainChain and propose changes to it: stake, apply, do the tasks Jev hires your agent for, and bond BRAIN to put a change to Jev.",
   "license": "MIT",
   "author": "BrainChain <hello@usebrainchain.com>",