@ilalv3/cli 0.2.14 → 0.2.16

package/README.md

@@ -34,7 +34,7 @@ ilal status --wallet 0xc0807D4778a9E5FE15ad68A8500e64d65BA78D58
 ilal demo check --wallet 0xc0807D4778a9E5FE15ad68A8500e64d65BA78D58
 
 # 4. Execute a compliant swap with the seeded reviewer key
-PRIVATE_KEY=0x... ilal swap --amount-in 1 --token-in 0x3d5b92a8Cea5BBe1c6f63b73D69DA6457e6436E2 --min-amount-out 0
+PRIVATE_KEY=0x... ilal swap --amount-in 1 --token-in 0x8C38061e31FB02df445576685975d85F01D8686d --min-amount-out 0
 ```
 
 For a fully seeded local/testnet demo, deploy mock EAS + demo pool pieces:
@@ -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,16 +156,29 @@ 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:
 
 ```bash
 ilal swap \
-  --router    0x88125331f169aF4Dc81ADa6E8A189110566E457a \
-  --hook      0x5f1de4376C7a59b5BBC5E5cd766D40995E9e4A80 \
+  --router    0xA571F7f41c8abC19F20ABAe648e26a75fbe1F434 \
+  --hook      0x4847B222d11938A70073292d97cDB98ff8D64a80 \
   --issuer    0x33541301e35d33eDf554c4DFba1e04d04FCc52F4 \
-  --pool-id   0x8b6d21e53673584f192bdad8b65e2002e9e8eea730c62adad5ac1f4a084164a4 \
+  --pool-id   0x426925fe1ebecf2da7184f9749622ab1a4b8870c888d75da10332aee2080c86f \
   --amount-in 0.001
 ```
 
@@ -172,19 +189,19 @@ ilal swap \
 | CNFIssuer | `0x33541301e35d33eDf554c4DFba1e04d04FCc52F4` |
 | MockEAS | `0x6A98096DF6F54DBF40498dC5525d84AEA840663A` |
 | ZKVerifierAdapter | `0x9467ED8d962221e3C1865a387481B862B1b5bE95` |
-| ComplianceHook | `0x5f1de4376C7a59b5BBC5E5cd766D40995E9e4A80` |
-| ILALRouter | `0x88125331f169aF4Dc81ADa6E8A189110566E457a` |
+| ComplianceHook | `0x4847B222d11938A70073292d97cDB98ff8D64a80` |
+| ILALRouter | `0xA571F7f41c8abC19F20ABAe648e26a75fbe1F434` |
 | PolicyRegistry | `0x83d8111B415E97bA91eaAe717c2D9Ae6f0DD19d4` |
-| Currency0 / TOKA | `0x3d5b92a8Cea5BBe1c6f63b73D69DA6457e6436E2` |
-| Currency1 / TOKB | `0x6145F81e3691d991a4D2033FE25BeB140487B7Ee` |
-| Pool ID | `0x8b6d21e53673584f192bdad8b65e2002e9e8eea730c62adad5ac1f4a084164a4` |
+| Currency0 / TOKA | `0x8C38061e31FB02df445576685975d85F01D8686d` |
+| Currency1 / TOKB | `0xD0e6467D562829d215dB48CDfF4C289095D90B6B` |
+| Pool ID | `0x426925fe1ebecf2da7184f9749622ab1a4b8870c888d75da10332aee2080c86f` |
 
 Live proof:
 
 - CNF ZK mint tx: `0xb9aa16c9604a575c8b2281cbfe9ba24fedbf205283a7b05638fbc413ed78de41`
-- Add liquidity tx: `0xc3dba6d488933e1568541ece17ce43307fb173eb747dff303f3631456eccb16a`
-- Swap tx: `0x360461d2a3c19acdc3ba125e55689679fcf809946d8a5092e833eb9e94b0f52f`
-- Router bypass fix verified: `ComplianceHook.authorizedRouter()` returns `0x88125331f169aF4Dc81ADa6E8A189110566E457a`
+- Add liquidity tx: `0x1ffd6b1546b3f3846d8f86fc21ec059a83a02f23130390c1b9343733d3a9776f`
+- Swap tx: `0x36427e232b323e4a8c310286d0312dbf1f4ecde86d58245a81713aafe4df0720`
+- Router bypass fix verified: `ComplianceHook.authorizedRouter()` returns `0xA571F7f41c8abC19F20ABAe648e26a75fbe1F434`
 
 ## License
 

package/dist/commands/demo.js

@@ -11,9 +11,9 @@ const POOL_MANAGER = {
 const SAMPLE = {
     wallet: "0xc0807D4778a9E5FE15ad68A8500e64d65BA78D58",
     issuer: "0x33541301e35d33eDf554c4DFba1e04d04FCc52F4",
-    hook: "0x5f1de4376C7a59b5BBC5E5cd766D40995E9e4A80",
-    router: "0x88125331f169aF4Dc81ADa6E8A189110566E457a",
-    pool: "0x8b6d21e53673584f192bdad8b65e2002e9e8eea730c62adad5ac1f4a084164a4",
+    hook: "0x4847B222d11938A70073292d97cDB98ff8D64a80",
+    router: "0xA571F7f41c8abC19F20ABAe648e26a75fbe1F434",
+    pool: "0x426925fe1ebecf2da7184f9749622ab1a4b8870c888d75da10332aee2080c86f",
     proof: "0x91f2b8a0c43e902f7f1a8c0d",
     session: "0x6b84eac5e0db21f8d5d43b7a",
 };

package/dist/commands/init.js

@@ -11,13 +11,13 @@ import { fmt, log, header, die } from "../ui.js";
 const PRESETS = {
     "84532": {
         issuer: "0x33541301e35d33eDf554c4DFba1e04d04FCc52F4",
-        hook: "0x5f1de4376C7a59b5BBC5E5cd766D40995E9e4A80",
+        hook: "0x4847B222d11938A70073292d97cDB98ff8D64a80",
         registry: "0x83d8111B415E97bA91eaAe717c2D9Ae6f0DD19d4",
-        router: "0x88125331f169aF4Dc81ADa6E8A189110566E457a",
-        treasury: "0x1804c8AB1F12E6bbf3894d4083f33e07309d1f38",
-        tokenA: "0x3d5b92a8Cea5BBe1c6f63b73D69DA6457e6436E2",
-        tokenB: "0x6145F81e3691d991a4D2033FE25BeB140487B7Ee",
-        poolId: "0x8b6d21e53673584f192bdad8b65e2002e9e8eea730c62adad5ac1f4a084164a4",
+        router: "0xA571F7f41c8abC19F20ABAe648e26a75fbe1F434",
+        treasury: "0xc0807D4778a9E5FE15ad68A8500e64d65BA78D58",
+        tokenA: "0x8C38061e31FB02df445576685975d85F01D8686d",
+        tokenB: "0xD0e6467D562829d215dB48CDfF4C289095D90B6B",
+        poolId: "0x426925fe1ebecf2da7184f9749622ab1a4b8870c888d75da10332aee2080c86f",
         fee: "8388608",
         tickSpacing: "60",
         rpc: "https://sepolia.base.org",

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/commands/liquidity.d.ts

@@ -9,7 +9,7 @@
  * Usage:
  *   ilal pool add-liquidity \
  *     --tick-lower -600 --tick-upper 600 \
- *     --liquidity  1000000000000000000 \
+ *     --liquidity  1000000000000 \
  *     --router 0xROUTER --hook 0xHOOK --issuer 0xISSUER \
  *     --pool-id 0xPOOLID --token-a 0xTOKA --token-b 0xTOKB
  */

package/dist/commands/liquidity.js

@@ -9,7 +9,7 @@
  * Usage:
  *   ilal pool add-liquidity \
  *     --tick-lower -600 --tick-upper 600 \
- *     --liquidity  1000000000000000000 \
+ *     --liquidity  1000000000000 \
  *     --router 0xROUTER --hook 0xHOOK --issuer 0xISSUER \
  *     --pool-id 0xPOOLID --token-a 0xTOKA --token-b 0xTOKB
  */

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.14")
+    .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.14",
+  "version": "0.2.16",
   "description": "ILAL Protocol CLI — compliant swaps and credential management for Uniswap v4",
   "type": "module",
   "bin": {