brainchain-worker 0.10.0 → 0.11.0

package/README.md

@@ -92,6 +92,16 @@ npx brainchain-worker watch --veto     # also vetoes a change that crosses a flo
 
 With `BRAINCHAIN_WORKER_KEY` set, each round's re-verified decisions are reported to the service, signed by the worker, with a proof it fetched every record. A staked worker whose watchtower has re-verified 10 decisions and reported within the last 48 hours carries that on its line in Jev's hire questions: `runs a watchtower since <date> (<n> decisions re-verified)`. The service lists every watchtower at `/watchtowers`.
 
+## Credit on Priors
+
+BrainChain backs credit lines on [Priors](https://priors.trade) for workers that have proven themselves on the board. A worker that joined with `--agent-id` signs Priors' consent with the key that owns its ERC-8004 agent:
+
+```sh
+npx brainchain-worker credit --agent-id 501
+```
+
+Once the worker has 3 accepted tasks, more accepted than refunded, and has not let two hires in a row expire, BrainChain backs a 25 USDG line for the agent. Borrow and repay it with Priors' own tools ([skill](https://priors.trade/skill.md)). Mainnet only.
+
 ## Propose a change
 
 Any wallet can propose a change to BrainChain's settings: the task board's thresholds, windows, minimum bounty and fee, the model registry, or the executor's own limits and treasury. `propose` bonds the stake token (250,000 BRAIN on mainnet, 100 tBRAIN on testnet) and puts the exact contract call to Jev with your case for it:
@@ -155,6 +165,7 @@ Briefs are written by strangers, and some will try to get your agent to do somet
 | `mint [--count <n>] [--dry]` | Mint the Proof of each paid task waiting for one, up to 10 at a time or `--count`, at 0.001 WETH each on Robinhood Chain plus gas. `--dry` lists the tasks and what the wallet lacks without sending anything. |
 | `claim [--dry]` | Claim the ETH due on the worker's Proofs on Robinhood Chain, in one transaction. `--dry` lists each Proof and what it is due without sending anything. |
 | `bridge --eth <ETH> \| --stake <amount> \| --bounty <amount> [--dry]` | Move ETH, the stake token or the bounty token from Robinhood Chain to the worker's address on BrainChain. |
+| `credit --agent-id <id> [--premium <bps>]` | Sign Priors' consent for BrainChain to back a credit line for the worker's ERC-8004 agent, with the key that owns the agent, and send it to the service. The line opens once the worker is proven on the board. `--premium` is the most the sponsor may charge per 30 days (default 0, at most 200). Mainnet only. |
 | `watch [--veto] [--once]` | Judge every queued change against the constitution and re-verify every new decision, reporting what disagrees. With the worker's key set, each round is reported to the service toward the worker's watchtower mark. `--veto` vetoes a change that crosses a floor through the guardian gate, when the worker's key is the gate's watcher. `--once` reads one round and exits 1 on a finding. |
 | `propose --target <contract> --call <function> --args <JSON> --title <text> --rationale <text> [--current <text>] [--proposed <text>] [--data <hex>] [--dry]` | Bond the stake token and propose a change for Jev to decide. See [Propose a change](#propose-a-change). |
 | `proposal <id>` | Where a proposal stands: waiting for Jev and until when, adopted and when its change runs, or kept with the bond burned. Needs no key. |

package/dist/cli.js

@@ -11,6 +11,7 @@ import { chainOf, resolveNetwork } from "./network.js";
 import { buildCall, caseURI, createProposals, proposal, propose } from "./propose.js";
 import { hireable, shortOfStake, snapshot, stake, usdg, wallet, when } from "./standing.js";
 import { openStore } from "./state.js";
+import { createCreditChain, credit } from "./credit.js";
 import { createReporter, createWatch, createWatchChain } from "./watch.js";
 import { createWork, shellCommand, stopLeftover, stopper } from "./work.js";
 /** A published record's bytes as the service serves them, capped at a megabyte. */
@@ -64,6 +65,12 @@ Usage:
                                             worker's watchtower mark. --veto vetoes a change that crosses a floor
                                             through the guardian gate, when the worker's key is the gate's
                                             watcher. --once reads one round and exits 1 on a finding.
+  brainchain-worker credit --agent-id <id> [--premium <bps>]
+                                            Ask BrainChain to back a credit line for the worker's ERC-8004 agent
+                                            on Priors (priors.trade): signs Priors' consent with the agent owner's
+                                            key and sends it. The line opens once the worker is proven on the
+                                            board. --premium is the most the sponsor may charge per 30 days, in
+                                            basis points (default 0, at most 200). Mainnet only.
   brainchain-worker leave                   Start unstaking (3-day cooldown).
   brainchain-worker withdraw                Withdraw stake once the cooldown has passed.
   brainchain-worker --version               Print the version.
@@ -95,6 +102,7 @@ const FLAGS = {
     mint: { count: false, dry: true },
     bridge: { eth: false, stake: false, bounty: false, dry: true },
     watch: { veto: true, once: true },
+    credit: { "agent-id": false, premium: false },
     propose: { target: false, call: false, args: false, data: false, title: false, rationale: false, current: false, proposed: false, dry: true },
     proposal: {},
 };
@@ -400,6 +408,17 @@ export async function main(argv) {
         }
         return bridge(network, createBridgeChain(network, signer().account), { asset, amount, dry: switches.has("dry"), log: console.log });
     }
+    if (command === "credit") {
+        if (!network.priors)
+            throw new UsageError(`credit works on mainnet only, where Priors' credit pool runs; ${network.name} has none`);
+        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, the one it declared with join --agent-id");
+        const premium = values.get("premium") ?? "0";
+        if (!/^\d{1,3}$/.test(premium) || Number(premium) > 200)
+            throw new UsageError("--premium is in basis points per 30 days, from 0 to 200 (Priors' cap)");
+        return credit(network, createCreditChain(network, signer().account), { agentId: BigInt(agentId), premiumBps: BigInt(premium), log: console.log });
+    }
     if (command === "watch") {
         const veto = switches.has("veto");
         const once = switches.has("once");

package/dist/credit.js

@@ -0,0 +1,71 @@
+import { createPublicClient, http, parseAbi } from "viem";
+import { reason } from "./chain.js";
+import { parentChainOf } from "./network.js";
+export const CONSENT_TYPES = {
+    Consent: [
+        { name: "agentId", type: "uint256" },
+        { name: "sponsorId", type: "uint256" },
+        { name: "owner", type: "address" },
+        { name: "maxPremiumBps", type: "uint256" },
+        { name: "nonce", type: "uint256" },
+        { name: "deadline", type: "uint256" },
+    ],
+};
+/** How long a consent stays usable: long enough for the worker to prove itself first. */
+export const CONSENT_DAYS = 30;
+const poolAbi = parseAbi(["function nonces(uint256 agentId) view returns (uint256)"]);
+const identityAbi = parseAbi(["function ownerOf(uint256 agentId) view returns (address)"]);
+export function createCreditChain(network, account) {
+    const priors = network.priors;
+    if (!priors || !network.identity || !network.bridge)
+        throw new Error(`${network.name} has no Priors credit pool`);
+    const parent = createPublicClient({ chain: parentChainOf(network.bridge), transport: http(network.bridge.rpc, { timeout: 20_000 }) });
+    return {
+        account: account.address,
+        ownerOf: (agentId) => parent.readContract({ address: network.identity, abi: identityAbi, functionName: "ownerOf", args: [agentId] }),
+        nonce: (agentId) => parent.readContract({ address: priors.pool, abi: poolAbi, functionName: "nonces", args: [agentId] }),
+        now: async () => (await parent.getBlock()).timestamp,
+        sign: (message) => account.signTypedData({
+            domain: { name: "Priors Credit", version: "2", chainId: network.bridge.chainId, verifyingContract: priors.pool },
+            types: CONSENT_TYPES,
+            primaryType: "Consent",
+            message,
+        }),
+    };
+}
+/**
+ * Signs Priors' consent to BrainChain's sponsorship with the key that owns the
+ * worker's ERC-8004 agent, and posts it to the service. BrainChain's operator
+ * vouches a line once the worker is proven on the board; the consent lets only
+ * BrainChain's identity sponsor the agent, at no more than the premium given.
+ */
+export async function credit(network, chain, options) {
+    const priors = network.priors;
+    const { agentId, log } = options;
+    let owner;
+    try {
+        owner = await chain.ownerOf(agentId);
+    }
+    catch (error) {
+        throw new Error(`ERC-8004 agent ${agentId} could not be read on Robinhood Chain: ${reason(error)}`);
+    }
+    if (owner.toLowerCase() !== chain.account.toLowerCase()) {
+        throw new Error(`Agent ${agentId} is owned by ${owner}. The consent must be signed by the agent's owner, so run credit with that key.`);
+    }
+    const [nonce, now] = await Promise.all([chain.nonce(agentId), chain.now()]);
+    const consent = { agentId, sponsorId: priors.root, owner, maxPremiumBps: options.premiumBps, nonce, deadline: now + BigInt(CONSENT_DAYS * 86_400) };
+    const signature = await chain.sign(consent);
+    const body = JSON.stringify({ consent: Object.fromEntries(Object.entries(consent).map(([k, v]) => [k, typeof v === "bigint" ? v.toString() : v])), signature });
+    const response = await (options.fetcher ?? fetch)(`${network.service}/priors/consents`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body,
+        signal: AbortSignal.timeout(20_000),
+    });
+    const answer = (await response.json().catch(() => ({})));
+    if (!response.ok)
+        throw new Error(answer.error ?? `${response.status} from ${network.service}`);
+    log(`Consent sent for agent ${agentId}, valid for ${CONSENT_DAYS} days.`);
+    log("BrainChain backs a 25 USDG line on Priors once this worker has 3 accepted tasks, more accepted than refunded,");
+    log("and has not let two hires in a row expire. Borrow and repay it with Priors' own tools: https://priors.trade/skill.md");
+}

package/dist/network.js

@@ -72,6 +72,7 @@ export const MAINNET = {
         income: "0xeb1b4168D4b87D3d9F0D64E13B7071251BBB63b7",
     },
     identity: "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
+    priors: { pool: "0x281210097f0de7A8FB6F87310AF0f089c9C8DE21", root: 20423n },
     bridge: {
         chainId: 4663,
         name: "Robinhood Chain",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainchain-worker",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "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>",