@ilalv3/cli 0.2.15 → 0.2.16

package/README.md

@@ -134,6 +134,10 @@ ILAL_ARTIFACT_CACHE=/opt/ilal/artifacts/ilal-v1
 | `ilal credential prove` | Trader flow: hosted/cached ZK artifacts → local proof → mint or renew CNF |
 | `ilal credential mint` | Mint CNF via Coinbase EAS attestation |
 | `ilal credential renew` | Renew CNF via EAS attestation |
+| `ilal issuer create` | Create issuer standard profile and return `standard_id` |
+| `ilal issuer set-jurisdiction` | Set allowed jurisdictions |
+| `ilal issuer set-type` | Set accredited-only requirement |
+| `ilal issuer get` | Read standard profile and `credentialType` |
 | `ilal swap` | Compliant swap via ILALRouter with optional `--min-amount-out` |
 | `ilal pool add-liquidity` | Add liquidity to a compliant pool |
 | `ilal pool remove-liquidity` | Remove liquidity from a compliant pool |
@@ -152,6 +156,19 @@ ILAL_ARTIFACT_CACHE=/opt/ilal/artifacts/ilal-v1
 
 Session note: ILAL hookData is a one-time EIP-712 authorization with a deadline and nonce. The expensive compliance step is the CNF issuance or renewal; swaps do not verify a fresh ZK proof. Use `ilal session sign` to export hookData, and `ilal swap --hook-data <hex>` to execute with an externally signed authorization.
 
+## Issuer standards
+
+External issuers can define a compliance standard and use its `standard_id` as the on-chain `credentialType` for pool policy registration:
+
+```bash
+ilal issuer create --standard "Goldfinch Accredited Investor"
+ilal issuer set-jurisdiction --allow US,EU,SG
+ilal issuer set-type --accredited-only true
+ilal issuer get
+```
+
+Profiles are stored in `.ilal-issuer-standards.json`. Pools enforce the returned `standard_id` through `PolicyRegistry.requiredCredentialType`.
+
 ## Configuration
 
 The CLI reads `.ilal.json` in the current directory. Run `ilal init` to create it, or pass flags directly:

package/dist/commands/issuer.d.ts

@@ -0,0 +1,14 @@
+export declare function issuerCreate(opts: {
+    standard: string;
+}): Promise<void>;
+export declare function issuerSetJurisdiction(opts: {
+    id?: string;
+    allow: string;
+}): Promise<void>;
+export declare function issuerSetType(opts: {
+    id?: string;
+    accreditedOnly: string | boolean;
+}): Promise<void>;
+export declare function issuerGet(opts: {
+    id?: string;
+}): Promise<void>;

package/dist/commands/issuer.js

@@ -0,0 +1,134 @@
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { resolve } from "path";
+import { keccak256, stringToBytes, isHex } from "viem";
+import { fmt, header, log, die } from "../ui.js";
+const STORE_FILE = ".ilal-issuer-standards.json";
+function storePath() {
+    return resolve(process.cwd(), STORE_FILE);
+}
+function loadStore() {
+    const path = storePath();
+    if (!existsSync(path))
+        return { version: 1, standards: {} };
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        return {
+            version: 1,
+            latest: parsed.latest,
+            standards: parsed.standards ?? {},
+        };
+    }
+    catch {
+        die(`Could not parse ${STORE_FILE}. Fix or remove the file and try again.`);
+    }
+}
+function saveStore(store) {
+    writeFileSync(storePath(), JSON.stringify(store, null, 2) + "\n");
+}
+function normalizeId(id, store) {
+    const resolved = id ?? store?.latest;
+    if (!resolved)
+        die("Standard id required. Pass --id <standard_id> or run `ilal issuer create` first.");
+    if (!isHex(resolved) || resolved.length !== 66)
+        die("standard_id must be 0x + 32 bytes.");
+    return resolved;
+}
+function parseJurisdictions(raw) {
+    const list = raw.split(",").map((item) => item.trim()).filter(Boolean);
+    if (list.length === 0)
+        die("--allow must include at least one jurisdiction, e.g. US,EU,SG");
+    return [...new Set(list)];
+}
+function parseBool(raw) {
+    if (typeof raw === "boolean")
+        return raw;
+    const value = raw.trim().toLowerCase();
+    if (["true", "1", "yes", "y"].includes(value))
+        return true;
+    if (["false", "0", "no", "n"].includes(value))
+        return false;
+    die("--accredited-only must be true or false");
+}
+function printStandard(item) {
+    log.kv("standard_id", fmt.cyan(item.id));
+    log.kv("standard", item.standard);
+    log.kv("jurisdictions", item.allowedJurisdictions.length ? item.allowedJurisdictions.join(", ") : fmt.badge("unset", "yellow"));
+    log.kv("accredited only", item.accreditedOnly === null ? fmt.badge("unset", "yellow") : String(item.accreditedOnly));
+    log.kv("credentialType", fmt.cyan(item.id));
+    log.kv("updated", fmt.gray(item.updatedAt));
+}
+export async function issuerCreate(opts) {
+    const standard = opts.standard.trim();
+    if (!standard)
+        die("--standard <name> required");
+    const store = loadStore();
+    const now = new Date().toISOString();
+    const id = keccak256(stringToBytes(`ILAL_STANDARD_V1:${standard}`));
+    const existing = store.standards[id];
+    const item = existing ?? {
+        id,
+        standard,
+        allowedJurisdictions: [],
+        accreditedOnly: null,
+        createdAt: now,
+        updatedAt: now,
+    };
+    item.standard = standard;
+    item.updatedAt = now;
+    store.standards[id] = item;
+    store.latest = id;
+    saveStore(store);
+    header("Issuer Standard Created");
+    log.section("Standard");
+    printStandard(item);
+    log.line();
+    log.callout("Use this id as credentialType", `ilal pool policy set --cred-type ${id}`, "green");
+    log.kv("file", fmt.gray(storePath()));
+    console.log();
+}
+export async function issuerSetJurisdiction(opts) {
+    const store = loadStore();
+    const id = normalizeId(opts.id, store);
+    const item = store.standards[id];
+    if (!item)
+        die(`Unknown standard_id ${id}. Run \`ilal issuer create --standard <name>\` first.`);
+    item.allowedJurisdictions = parseJurisdictions(opts.allow);
+    item.updatedAt = new Date().toISOString();
+    store.latest = id;
+    saveStore(store);
+    header("Issuer Jurisdiction Updated");
+    log.section("Standard");
+    printStandard(item);
+    log.kv("file", fmt.gray(storePath()));
+    console.log();
+}
+export async function issuerSetType(opts) {
+    const store = loadStore();
+    const id = normalizeId(opts.id, store);
+    const item = store.standards[id];
+    if (!item)
+        die(`Unknown standard_id ${id}. Run \`ilal issuer create --standard <name>\` first.`);
+    item.accreditedOnly = parseBool(opts.accreditedOnly);
+    item.updatedAt = new Date().toISOString();
+    store.latest = id;
+    saveStore(store);
+    header("Issuer Investor Type Updated");
+    log.section("Standard");
+    printStandard(item);
+    log.kv("file", fmt.gray(storePath()));
+    console.log();
+}
+export async function issuerGet(opts) {
+    const store = loadStore();
+    const id = normalizeId(opts.id, store);
+    const item = store.standards[id];
+    if (!item)
+        die(`Unknown standard_id ${id}. Available standards: ${Object.keys(store.standards).length}`);
+    header("Issuer Standard");
+    log.section("Standard");
+    printStandard(item);
+    log.line();
+    log.info("This CLI profile is the issuer-side descriptor. Pools enforce the matching credentialType on-chain via PolicyRegistry.");
+    log.command(`ilal pool policy set --cred-type ${item.id} --issuer <CNFIssuer> --registry <PolicyRegistry> --pool <poolId>`);
+    console.log();
+}

package/dist/index.js

@@ -13,13 +13,14 @@ import { init } from "./commands/init.js";
 import { status } from "./commands/status.js";
 import { swap } from "./commands/swap.js";
 import { addLiquidity, removeLiquidity } from "./commands/liquidity.js";
+import { issuerCreate, issuerGet, issuerSetJurisdiction, issuerSetType } from "./commands/issuer.js";
 import { fmt } from "./ui.js";
 import { COINBASE_SCHEMA_UID } from "./constants.js";
 const program = new Command();
 program
     .name("ilal")
     .description("ILAL Protocol CLI — Uniswap v4 compliance hook toolkit")
-    .version("0.2.15")
+    .version("0.2.16")
     .addHelpText("before", `\n  ${fmt.bold(fmt.cyan("◆"))} ${fmt.bold("ILAL Protocol")}  ${fmt.gray("Uniswap v4 Compliance Hook")}\n`);
 // ─── init ─────────────────────────────────────────────────────────────────────
 program
@@ -96,6 +97,38 @@ const err = (e) => {
     console.error(fmt.red(`\nError: ${e instanceof Error ? e.message : String(e)}\n`));
     process.exit(1);
 };
+// ─── issuer ──────────────────────────────────────────────────────────────────
+const issuer = program.command("issuer").description("Issuer standard management");
+issuer
+    .command("create")
+    .description("Create an issuer compliance standard profile and return a standard_id")
+    .requiredOption("--standard <name>", "Compliance standard name, e.g. Goldfinch Accredited Investor")
+    .action(async (opts) => {
+    await issuerCreate(opts).catch(err);
+});
+issuer
+    .command("set-jurisdiction")
+    .description("Set allowed jurisdictions for an issuer standard")
+    .option("--id <standard_id>", "Standard id (defaults to latest created standard)")
+    .requiredOption("--allow <list>", "Comma-separated jurisdictions, e.g. US,EU,SG")
+    .action(async (opts) => {
+    await issuerSetJurisdiction(opts).catch(err);
+});
+issuer
+    .command("set-type")
+    .description("Set investor type requirements for an issuer standard")
+    .option("--id <standard_id>", "Standard id (defaults to latest created standard)")
+    .requiredOption("--accredited-only <bool>", "true or false")
+    .action(async (opts) => {
+    await issuerSetType(opts).catch(err);
+});
+issuer
+    .command("get")
+    .description("Read an issuer standard profile")
+    .option("--id <standard_id>", "Standard id (defaults to latest created standard)")
+    .action(async (opts) => {
+    await issuerGet(opts).catch(err);
+});
 // ─── credential ───────────────────────────────────────────────────────────────
 const credential = program.command("credential").description("Manage compliance credentials (CNF)");
 credential

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ilalv3/cli",
-  "version": "0.2.15",
+  "version": "0.2.16",
   "description": "ILAL Protocol CLI — compliant swaps and credential management for Uniswap v4",
   "type": "module",
   "bin": {