brainchain-worker 0.18.1 → 0.18.3

package/dist/bond.js

@@ -182,8 +182,8 @@ export function createBondChain(network, config, account, fetcher = fetch) {
 export const bondGas = (gasPrice, approves) => (GAS.create + (approves ? GAS.approve : 0n)) * gasPrice;
 const fee = (amount) => (amount * FEE_BPS) / BPS;
 /** Where a bond stands, in one line. */
-export function bondLine(network, b, indexed, now) {
-    const head = `Bond No. ${b.deed} on task ${b.task}: ${usdg(network, b.amount)}`;
+export function bondLine(network, b, indexed, now, page) {
+    const head = `Bond No. ${page?.number ?? b.deed} on task ${b.task}: ${usdg(network, b.amount)}`;
     if (b.status === DeedStatus.Settled) {
         if (b.remainderBps === Number(BPS))
             return `${head}, delivered at ${when(b.settledAt)}: ${usdg(network, b.amount - fee(b.amount))} back after Shipped's 1% fee (bond claim ${b.task} collects it)`;
@@ -204,6 +204,21 @@ function closed(network, config) {
         return "Bonds are not open yet: BrainChain's ProofIndex on Robinhood Chain, which a bond's check reads, is not deployed. A later release of brainchain-worker names it.";
     return undefined;
 }
+/** Shipped's own number and page for a deed; the registry id stands in when the API cannot be reached or the bond is a test. */
+export const SHIPPED_API = "https://api.shipped.bond";
+export async function deedPage(deed, fetchImpl = fetch) {
+    try {
+        const response = await fetchImpl(`${SHIPPED_API}/v1/deeds/${deed}`, { signal: AbortSignal.timeout(5_000) });
+        if (!response.ok)
+            return undefined;
+        const body = (await response.json());
+        const { number, url } = body.deed ?? {};
+        return typeof number === "string" && typeof url === "string" ? { number, url } : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
 /** Reads the task, says what the bond costs and what it does, and sends the approval and the bond. */
 export async function bond(network, config, chain, task, options) {
     const { log } = options;
@@ -217,8 +232,8 @@ export async function bond(network, config, chain, task, options) {
     if (t.poster.toLowerCase() === chain.account.toLowerCase())
         throw new Error(`Task ${task} was posted by this wallet. A bond guarantees delivery to someone else: it earns no standing on a task the worker posted itself.`);
     const hiredHere = t.status === Status.Hired && t.model.toLowerCase().endsWith(chain.account.slice(2).toLowerCase());
-    if (t.status !== Status.Open && !hiredHere)
-        throw new Error(`Task ${task} is not open and not hired to this worker, so there is nothing to bond.`);
+    if (!hiredHere)
+        throw new Error(`Task ${task} is not hired to this worker. Bond a task after Jev hires you for it.`);
     const now = await chain.now();
     if (t.deadline <= now)
         throw new Error(`Task ${task}'s deadline, ${when(t.deadline)}, has passed.`);
@@ -262,19 +277,24 @@ export async function bond(network, config, chain, task, options) {
     }
     log(`Bonding ${usdg(network, options.amount)} on task ${task}...`);
     const { deed, tx } = await chain.create(terms, options.amount);
-    log(`Bond No. ${deed} is open on Shipped (${tx}). Jev reads it when it hires; \`bond status ${task}\` follows it.`);
+    const page = await deedPage(deed, options.fetch);
+    log(page
+        ? `Bond No. ${page.number} is open on Shipped: ${page.url} (${tx}). Jev reads it when it hires; \`bond status ${task}\` follows it.`
+        : `Bond No. ${deed} is open on Shipped (${tx}). Jev reads it when it hires; \`bond status ${task}\` follows it.`);
 }
 /** Prints where the worker's bonds on a task stand. */
-export async function bondStatus(network, config, chain, task, log) {
+export async function bondStatus(network, config, chain, task, log, fetchImpl = fetch) {
     const shut = closed(network, config);
     if (shut)
         throw new Error(shut);
     const bonds = await chain.bondsOn(task);
     if (bonds.length === 0)
         return log(`${chain.account} has no bond on task ${task}.`);
-    const [now, indexed] = await Promise.all([chain.now(), chain.proofOf(task)]);
-    for (const b of bonds)
-        log(bondLine(network, b, indexed > 0n, now));
+    const [now, indexed, pages] = await Promise.all([chain.now(), chain.proofOf(task), Promise.all(bonds.map((b) => deedPage(b.deed, fetchImpl)))]);
+    bonds.forEach((b, i) => {
+        const page = pages[i];
+        log(`${bondLine(network, b, indexed > 0n, now, page)}${page ? ` ${page.url}` : ""}`);
+    });
 }
 /** Collects what a settled bond left the worker: withdraw(USDG) on the registry. */
 export async function bondClaim(network, config, chain, task, log) {

package/package.json

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