@liens/cli 0.1.0 → 0.1.2

package/README.md

@@ -1,18 +1,48 @@
-# lien-cli
+# @liens/cli
+
+The command-line half of the same toolkit the LIEN Designer runs in the browser. Both call `@liens/sdk`; both fold a Composition through the same Rust `hook-runtime` the Anchor executor links. The number `lien` prints is the number the chain runs.
 
 ```
-npm i -g lien-cli
+npm i -g @liens/cli
+lien list                                              # the six standard knots
+lien create slip-knot --pool SOL-USDC --venue marginfi # scaffold a Composition
+lien simulate --pool SOL-USDC --steps 240              # backtest against pool history
+lien deploy --cluster devnet                           # print the on-chain install plan (does NOT broadcast)
 ```
 
-## Commands
+The actual broadcast is `lien deploy --cluster <cluster> --execute --keypair <path>`. The `--execute` flag is explicit by design — a fat-fingered `lien deploy` should not write to mainnet.
 
-```
-lien list                            print the standard hook library
-lien create hook --name MyHook       scaffold a hook source file
-lien create composition              prompt-driven composition.ts
-lien simulate --pool SOL-USDC        run the deterministic simulator
-lien action                          write .github/workflows/lien-hook-ci.yml
-lien deploy --cluster mainnet        print an Anchor deploy plan (does not broadcast)
-```
+## Six commands
+
+| command | what it does |
+|---|---|
+| `lien list` | print the six standard knots with their flags, lifecycle events, params |
+| `lien create <knot> --pool <pair> --venue <lender>` | scaffold a `lien.toml` with the named knot installed |
+| `lien simulate --pool <pair> --steps <n>` | run the Composition against `<n>` steps of pool history; print accept / reject / side-effects |
+| `lien deploy --cluster <cluster>` | print the install plan; `--execute --keypair <path>` to broadcast |
+| `lien action --workflow <name>` | write a GitHub Actions workflow that runs `lien simulate` on every push |
+| `lien publish <knot>` | (coming) wrap `publish_hook` for knot authors |
+
+## Six standard knots
+
+| knot | code id | fires on |
+|---|---|---|
+| the slip knot | `DynamicLTV` | beforeBorrow / afterDeposit |
+| the timer hitch | `TimeTriggerLiq` | beforeLiquidate |
+| the lock knot | `WhitelistBorrow` | beforeBorrow |
+| the double bowline | `AntiMEVLiq` | beforeLiquidate |
+| the double helix | `AutoHedge` | afterBorrow / afterDeposit |
+| the rolling hitch | `ReputationRate` | beforeBorrow |
+
+Each is a real implementation with passing tests on the Rust side. The CLI prints them out so you don't have to open the browser.
+
+## Lender targets
+
+Marginfi v2 · Kamino Lend · Save (formerly Solend). Adapters ship from source for the moment — `pnpm -r build` from the monorepo covers them — npm publish for adapter packages tracks the next stable release.
+
+## Links
 
-`lien deploy` is plan-only by design — actually running `anchor deploy` requires the operator to confirm the keypair pubkey and balance.
+- Site: https://liens.fi
+- SDK: `npm i @liens/sdk`
+- Source: https://github.com/liens-fi/lien
+- License: Apache-2.0

package/dist/bin.js

@@ -5,16 +5,18 @@ import { simulateCommand } from "./commands/simulate.js";
 import { deployCommand } from "./commands/deploy.js";
 import { listCommand } from "./commands/list.js";
 import { actionCommand } from "./commands/action.js";
+import { receiptsCommand } from "./commands/receipts.js";
 const program = new Command();
 program
     .name("lien")
     .description("Lien — tie your loans. Create, simulate, and deploy Solana lending hooks.")
-    .version("0.1.0");
+    .version("0.1.2");
 program.addCommand(createCommand());
 program.addCommand(simulateCommand());
 program.addCommand(deployCommand());
 program.addCommand(listCommand());
 program.addCommand(actionCommand());
+program.addCommand(receiptsCommand());
 program.parseAsync(process.argv).catch((err) => {
     console.error(err instanceof Error ? err.message : err);
     process.exitCode = 1;

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAC9B,OAAO;KACJ,IAAI,CAAC,MAAM,CAAC;KACZ,WAAW,CACV,2EAA2E,CAC5E;KACA,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;AACtC,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;AAEpC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC7C,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAC9B,OAAO;KACJ,IAAI,CAAC,MAAM,CAAC;KACZ,WAAW,CACV,2EAA2E,CAC5E;KACA,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;AACtC,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;AAEtC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC7C,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/commands/receipts.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function receiptsCommand(): Command;
+//# sourceMappingURL=receipts.d.ts.map

package/dist/commands/receipts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipts.d.ts","sourceRoot":"","sources":["../../src/commands/receipts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8DpC,wBAAgB,eAAe,IAAI,OAAO,CA2EzC"}

package/dist/commands/receipts.js

@@ -0,0 +1,109 @@
+import { Command } from "commander";
+import kleur from "kleur";
+import { Connection, PublicKey } from "@solana/web3.js";
+const LIEN_EXECUTOR_ID = "5yNMqcyZsGQJk4xvw4jjvoRBSnGs8mgramEa3HQe5faD";
+const EVENT_KIND_LABEL = {
+    0: "beforeDeposit",
+    1: "afterDeposit",
+    2: "beforeBorrow",
+    3: "afterBorrow",
+    4: "beforeRepay",
+    5: "afterRepay",
+    6: "beforeLiquidate",
+    7: "afterLiquidate",
+};
+function parseExecutorLogs(logs) {
+    // The executor emits a CompositionExecuted event via Anchor's `emit!`. Anchor
+    // prints "Program data: <base64>" lines for these. We don't decode the full
+    // borsh payload here — that's what @liens/sdk does. The CLI surface is a
+    // human-readable summary, so we look for the program log markers and pull
+    // the obvious bytes (event kind + counts) from the borsh prefix.
+    const out = {};
+    for (const line of logs) {
+        if (!line.includes("Program data:"))
+            continue;
+        const b64 = line.split("Program data:")[1]?.trim();
+        if (!b64)
+            continue;
+        let buf;
+        try {
+            buf = Buffer.from(b64, "base64");
+        }
+        catch {
+            continue;
+        }
+        // Anchor event layout: 8-byte discriminator + struct fields.
+        // CompositionExecuted: composition(32) + pool(32) + event_kind(u8) +
+        // position_owner(32) + adapter(u8) + hook_count_eligible(u8) +
+        // hook_count_skipped(u8) + timestamp(i64)
+        if (buf.length < 8 + 32 + 32 + 1 + 32 + 1 + 1 + 1)
+            continue;
+        out.composition = new PublicKey(buf.subarray(8, 40)).toBase58();
+        out.pool = new PublicKey(buf.subarray(40, 72)).toBase58();
+        out.event_kind = buf[72];
+        // position_owner = bytes 73..105
+        // adapter = byte 105
+        out.hook_count_eligible = buf[106];
+        out.hook_count_skipped = buf[107];
+        break;
+    }
+    return out;
+}
+export function receiptsCommand() {
+    return new Command("receipts")
+        .description("Pull a HookRan receipt off the chain and pretty-print it. Single signature for now; per-pool window coming next.")
+        .option("--signature <sig>", "Transaction signature to inspect")
+        .option("--rpc <url>", "RPC endpoint", "https://api.mainnet-beta.solana.com")
+        .action(async (opts) => {
+        if (!opts.signature) {
+            console.error(kleur.red("error:") +
+                " --signature is required. example: lien receipts --signature 3AWddY...");
+            process.exitCode = 1;
+            return;
+        }
+        const conn = new Connection(opts.rpc, "confirmed");
+        const tx = await conn.getTransaction(opts.signature, {
+            maxSupportedTransactionVersion: 0,
+        });
+        if (!tx) {
+            console.error(kleur.red("error:") +
+                ` no transaction found at ${opts.signature} on ${opts.rpc}`);
+            process.exitCode = 1;
+            return;
+        }
+        const logs = tx.meta?.logMessages ?? [];
+        const parsed = parseExecutorLogs(logs);
+        const receipt = {
+            signature: opts.signature,
+            slot: tx.slot,
+            blockTime: tx.blockTime ?? null,
+            ...parsed,
+        };
+        console.log(kleur.bold().yellow("lien receipts"));
+        console.log(`  signature       ${receipt.signature}`);
+        console.log(`  slot            ${receipt.slot}`);
+        console.log(`  block time      ${receipt.blockTime
+            ? new Date(receipt.blockTime * 1000).toISOString()
+            : "(unknown)"}`);
+        console.log(`  executor        ${LIEN_EXECUTOR_ID}`);
+        if (receipt.event_kind !== undefined) {
+            console.log(`  event           ${EVENT_KIND_LABEL[receipt.event_kind] ?? "?"} (kind=${receipt.event_kind})`);
+            console.log(`  pool            ${receipt.pool ?? "?"}`);
+            console.log(`  composition     ${receipt.composition ?? "?"}`);
+            console.log(`  hooks eligible  ${receipt.hook_count_eligible ?? "?"}`);
+            console.log(`  hooks skipped   ${receipt.hook_count_skipped ?? "?"}`);
+        }
+        else {
+            console.log(kleur.dim("  (no CompositionExecuted event in this transaction — was the signature an executor call?)"));
+        }
+        // Raw logs for forensics
+        console.log("");
+        console.log(kleur.dim("  raw program logs:"));
+        for (const line of logs) {
+            if (line.startsWith("Program log:") || line.includes("Program data:")) {
+                console.log(kleur.dim(`    ${line}`));
+            }
+        }
+    });
+}
+//# sourceMappingURL=receipts.js.map

package/dist/commands/receipts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipts.js","sourceRoot":"","sources":["../../src/commands/receipts.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liens/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Lien command-line tools \u2014 create, simulate, and deploy lending hooks on Solana.",
   "type": "module",
   "bin": {