naracli 1.0.17 → 1.0.22

package/src/tests/zkid.test.ts

@@ -0,0 +1,153 @@
+/**
+ * Tests for `zkid` CLI commands
+ *
+ * Run: npm test
+ */
+
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { runCli, hasWallet } from "./helpers.js";
+
+// ─── Help output ──────────────────────────────────────────────────
+
+describe("zkid --help", () => {
+  it("shows all subcommands", async () => {
+    const { stdout, exitCode } = await runCli(["zkid", "--help"]);
+    assert.equal(exitCode, 0);
+    for (const cmd of ["create", "info", "deposit", "scan", "withdraw", "id-commitment", "transfer"]) {
+      assert.ok(stdout.includes(cmd), `missing subcommand: ${cmd}`);
+    }
+  });
+
+  it("zkid deposit --help lists all valid denominations", async () => {
+    const { stdout, exitCode } = await runCli(["zkid", "deposit", "--help"]);
+    assert.equal(exitCode, 0);
+    for (const amt of ["1", "10", "100", "1000", "10000", "100000"]) {
+      assert.ok(stdout.includes(amt), `missing denomination: ${amt}`);
+    }
+  });
+
+  it("zkid withdraw --help shows --recipient option", async () => {
+    const { stdout, exitCode } = await runCli(["zkid", "withdraw", "--help"]);
+    assert.equal(exitCode, 0);
+    assert.ok(stdout.includes("--recipient"));
+  });
+
+  it("zkid transfer --help shows <new-id-commitment>", async () => {
+    const { stdout, exitCode } = await runCli(["zkid", "transfer", "--help"]);
+    assert.equal(exitCode, 0);
+    assert.ok(stdout.includes("<new-id-commitment>"));
+  });
+});
+
+// ─── deposit validation (no chain needed) ────────────────────────
+
+describe("zkid deposit denomination validation", () => {
+  for (const bad of ["0", "2", "5", "50", "500", "9999", "200000"]) {
+    it(`rejects invalid amount "${bad}"`, async () => {
+      if (!hasWallet) return;
+      const { stderr, exitCode } = await runCli(["zkid", "deposit", "alice", bad]);
+      assert.equal(exitCode, 1);
+      assert.ok(stderr.includes("Valid denominations"), `stderr: ${stderr}`);
+    });
+  }
+
+  it("help text contains all valid denominations", async () => {
+    const { stdout } = await runCli(["zkid", "deposit", "--help"]);
+    for (const amt of ["1", "10", "100", "1000", "10000", "100000"]) {
+      assert.ok(stdout.includes(amt));
+    }
+  });
+});
+
+// ─── transfer validation (no chain needed) ───────────────────────
+
+describe("zkid transfer commitment validation", () => {
+  it("rejects commitment shorter than 64 chars", async () => {
+    if (!hasWallet) return;
+    const { stderr, exitCode } = await runCli(["zkid", "transfer", "alice", "deadbeef"]);
+    assert.equal(exitCode, 1);
+    assert.ok(stderr.includes("Invalid id-commitment"), `stderr: ${stderr}`);
+  });
+
+  it("rejects commitment with non-hex characters", async () => {
+    if (!hasWallet) return;
+    const { stderr, exitCode } = await runCli(["zkid", "transfer", "alice", "z".repeat(64)]);
+    assert.equal(exitCode, 1);
+    assert.ok(stderr.includes("Invalid id-commitment"), `stderr: ${stderr}`);
+  });
+
+  it("rejects commitment that is 63 chars (one short)", async () => {
+    if (!hasWallet) return;
+    const { stderr, exitCode } = await runCli(["zkid", "transfer", "alice", "a".repeat(63)]);
+    assert.equal(exitCode, 1);
+    assert.ok(stderr.includes("Invalid id-commitment"), `stderr: ${stderr}`);
+  });
+});
+
+// ─── withdraw validation (no chain needed) ───────────────────────
+
+describe("zkid withdraw validation", () => {
+  it("rejects --recipient that is not a valid public key", async () => {
+    if (!hasWallet) return;
+    const { stderr, exitCode } = await runCli(["zkid", "withdraw", "alice", "--recipient", "bad-key"]);
+    assert.equal(exitCode, 1);
+    assert.ok(stderr.includes("Invalid recipient address"), `stderr: ${stderr}`);
+  });
+});
+
+// ─── Read-only chain queries ──────────────────────────────────────
+
+describe("zkid info (read-only)", () => {
+  it("--json returns { exists: false } for non-existent ZK ID", async () => {
+    const { stdout, exitCode } = await runCli(["zkid", "info", "--json", "definitely-does-not-exist-xyz999"]);
+    assert.equal(exitCode, 0);
+    const json = JSON.parse(stdout);
+    assert.equal(json.exists, false);
+  });
+
+  it("text output mentions 'does not exist' for non-existent ZK ID", async () => {
+    const { stdout, exitCode } = await runCli(["zkid", "info", "definitely-does-not-exist-xyz999"]);
+    assert.equal(exitCode, 0);
+    assert.ok(stdout.includes("does not exist"), `stdout: ${stdout}`);
+  });
+});
+
+// ─── id-commitment (requires wallet) ─────────────────────────────
+
+describe("zkid id-commitment", () => {
+  it("outputs a 64-char hex commitment", async () => {
+    if (!hasWallet) return;
+    const { stdout, exitCode } = await runCli(["zkid", "id-commitment", "test-name"]);
+    assert.equal(exitCode, 0);
+    const match = stdout.match(/ID commitment:\s+([0-9a-f]{64})/);
+    assert.ok(match, `no commitment in output: ${stdout}`);
+  });
+
+  it("--json output contains idCommitment as 64-char hex", async () => {
+    if (!hasWallet) return;
+    const { stdout, exitCode } = await runCli(["zkid", "id-commitment", "--json", "test-name"]);
+    assert.equal(exitCode, 0);
+    const json = JSON.parse(stdout);
+    assert.ok("idCommitment" in json);
+    assert.match(json.idCommitment, /^[0-9a-f]{64}$/);
+  });
+
+  it("same wallet+name yields the same commitment (deterministic)", async () => {
+    if (!hasWallet) return;
+    const r1 = await runCli(["zkid", "id-commitment", "--json", "my-id"]);
+    const r2 = await runCli(["zkid", "id-commitment", "--json", "my-id"]);
+    assert.equal(r1.exitCode, 0);
+    assert.equal(r2.exitCode, 0);
+    assert.equal(JSON.parse(r1.stdout).idCommitment, JSON.parse(r2.stdout).idCommitment);
+  });
+
+  it("different names yield different commitments", async () => {
+    if (!hasWallet) return;
+    const r1 = await runCli(["zkid", "id-commitment", "--json", "name-aaa"]);
+    const r2 = await runCli(["zkid", "id-commitment", "--json", "name-bbb"]);
+    assert.equal(r1.exitCode, 0);
+    assert.equal(r2.exitCode, 0);
+    assert.notEqual(JSON.parse(r1.stdout).idCommitment, JSON.parse(r2.stdout).idCommitment);
+  });
+});

package/src/types/snarkjs.d.ts

@@ -3,7 +3,10 @@ declare module "snarkjs" {
     fullProve(
       input: Record<string, string>,
       wasmPath: string,
-      zkeyPath: string
+      zkeyPath: string,
+      logger?: any,
+      wtnsCalc?: any,
+      options?: any
     ): Promise<{ proof: any; publicSignals: string[] }>;
   };
 }

package/dist/quest/nara_quest.json

@@ -1,534 +0,0 @@
-{
-  "address": "EXPLAHaMHLK9p7w5jVqEVY671NkkCKSHTNhhyUrPAboZ",
-  "metadata": {
-    "name": "nara_quest",
-    "version": "0.1.0",
-    "spec": "0.1.0",
-    "description": "Created with Anchor"
-  },
-  "instructions": [
-    {
-      "name": "create_question",
-      "discriminator": [
-        222,
-        74,
-        49,
-        30,
-        160,
-        220,
-        179,
-        27
-      ],
-      "accounts": [
-        {
-          "name": "game_config",
-          "writable": true,
-          "pda": {
-            "seeds": [
-              {
-                "kind": "const",
-                "value": [
-                  103,
-                  97,
-                  109,
-                  101,
-                  95,
-                  99,
-                  111,
-                  110,
-                  102,
-                  105,
-                  103
-                ]
-              }
-            ]
-          }
-        },
-        {
-          "name": "pool",
-          "writable": true,
-          "pda": {
-            "seeds": [
-              {
-                "kind": "const",
-                "value": [
-                  112,
-                  111,
-                  111,
-                  108
-                ]
-              }
-            ]
-          }
-        },
-        {
-          "name": "vault",
-          "writable": true,
-          "pda": {
-            "seeds": [
-              {
-                "kind": "const",
-                "value": [
-                  118,
-                  97,
-                  117,
-                  108,
-                  116
-                ]
-              }
-            ]
-          }
-        },
-        {
-          "name": "authority",
-          "writable": true,
-          "signer": true
-        },
-        {
-          "name": "system_program",
-          "address": "11111111111111111111111111111111"
-        }
-      ],
-      "args": [
-        {
-          "name": "question",
-          "type": "string"
-        },
-        {
-          "name": "answer_hash",
-          "type": {
-            "array": [
-              "u8",
-              32
-            ]
-          }
-        },
-        {
-          "name": "deadline",
-          "type": "i64"
-        },
-        {
-          "name": "reward_amount",
-          "type": "u64"
-        }
-      ]
-    },
-    {
-      "name": "initialize",
-      "discriminator": [
-        175,
-        175,
-        109,
-        31,
-        13,
-        152,
-        155,
-        237
-      ],
-      "accounts": [
-        {
-          "name": "game_config",
-          "writable": true,
-          "pda": {
-            "seeds": [
-              {
-                "kind": "const",
-                "value": [
-                  103,
-                  97,
-                  109,
-                  101,
-                  95,
-                  99,
-                  111,
-                  110,
-                  102,
-                  105,
-                  103
-                ]
-              }
-            ]
-          }
-        },
-        {
-          "name": "pool",
-          "writable": true,
-          "pda": {
-            "seeds": [
-              {
-                "kind": "const",
-                "value": [
-                  112,
-                  111,
-                  111,
-                  108
-                ]
-              }
-            ]
-          }
-        },
-        {
-          "name": "authority",
-          "writable": true,
-          "signer": true
-        },
-        {
-          "name": "system_program",
-          "address": "11111111111111111111111111111111"
-        }
-      ],
-      "args": []
-    },
-    {
-      "name": "submit_answer",
-      "discriminator": [
-        221,
-        73,
-        184,
-        157,
-        1,
-        150,
-        231,
-        48
-      ],
-      "accounts": [
-        {
-          "name": "pool",
-          "writable": true,
-          "pda": {
-            "seeds": [
-              {
-                "kind": "const",
-                "value": [
-                  112,
-                  111,
-                  111,
-                  108
-                ]
-              }
-            ]
-          }
-        },
-        {
-          "name": "winner_record",
-          "writable": true,
-          "pda": {
-            "seeds": [
-              {
-                "kind": "const",
-                "value": [
-                  119,
-                  105,
-                  110,
-                  110,
-                  101,
-                  114
-                ]
-              },
-              {
-                "kind": "account",
-                "path": "user"
-              }
-            ]
-          }
-        },
-        {
-          "name": "vault",
-          "writable": true,
-          "pda": {
-            "seeds": [
-              {
-                "kind": "const",
-                "value": [
-                  118,
-                  97,
-                  117,
-                  108,
-                  116
-                ]
-              }
-            ]
-          }
-        },
-        {
-          "name": "user",
-          "writable": true
-        },
-        {
-          "name": "payer",
-          "writable": true,
-          "signer": true
-        },
-        {
-          "name": "system_program",
-          "address": "11111111111111111111111111111111"
-        }
-      ],
-      "args": [
-        {
-          "name": "proof_a",
-          "type": {
-            "array": [
-              "u8",
-              64
-            ]
-          }
-        },
-        {
-          "name": "proof_b",
-          "type": {
-            "array": [
-              "u8",
-              128
-            ]
-          }
-        },
-        {
-          "name": "proof_c",
-          "type": {
-            "array": [
-              "u8",
-              64
-            ]
-          }
-        }
-      ]
-    },
-    {
-      "name": "transfer_authority",
-      "discriminator": [
-        48,
-        169,
-        76,
-        72,
-        229,
-        180,
-        55,
-        161
-      ],
-      "accounts": [
-        {
-          "name": "game_config",
-          "writable": true,
-          "pda": {
-            "seeds": [
-              {
-                "kind": "const",
-                "value": [
-                  103,
-                  97,
-                  109,
-                  101,
-                  95,
-                  99,
-                  111,
-                  110,
-                  102,
-                  105,
-                  103
-                ]
-              }
-            ]
-          }
-        },
-        {
-          "name": "authority",
-          "signer": true
-        }
-      ],
-      "args": [
-        {
-          "name": "new_authority",
-          "type": "pubkey"
-        }
-      ]
-    }
-  ],
-  "accounts": [
-    {
-      "name": "GameConfig",
-      "discriminator": [
-        45,
-        146,
-        146,
-        33,
-        170,
-        69,
-        96,
-        133
-      ]
-    },
-    {
-      "name": "Pool",
-      "discriminator": [
-        241,
-        154,
-        109,
-        4,
-        17,
-        177,
-        109,
-        188
-      ]
-    },
-    {
-      "name": "WinnerRecord",
-      "discriminator": [
-        248,
-        27,
-        49,
-        33,
-        45,
-        88,
-        210,
-        100
-      ]
-    }
-  ],
-  "errors": [
-    {
-      "code": 6000,
-      "name": "Unauthorized",
-      "msg": "Only the authority can perform this action"
-    },
-    {
-      "code": 6001,
-      "name": "PoolNotActive",
-      "msg": "Pool has no active question"
-    },
-    {
-      "code": 6002,
-      "name": "DeadlineExpired",
-      "msg": "The deadline for this question has passed"
-    },
-    {
-      "code": 6003,
-      "name": "InvalidProof",
-      "msg": "ZK proof verification failed"
-    },
-    {
-      "code": 6004,
-      "name": "InvalidDeadline",
-      "msg": "Deadline must be in the future"
-    },
-    {
-      "code": 6005,
-      "name": "InsufficientReward",
-      "msg": "Reward amount must be greater than zero"
-    },
-    {
-      "code": 6006,
-      "name": "InsufficientPoolBalance",
-      "msg": "Pool balance insufficient for reward transfer"
-    },
-    {
-      "code": 6007,
-      "name": "QuestionTooLong",
-      "msg": "Question exceeds maximum length"
-    },
-    {
-      "code": 6008,
-      "name": "AlreadyAnswered",
-      "msg": "Already answered this round"
-    }
-  ],
-  "types": [
-    {
-      "name": "GameConfig",
-      "type": {
-        "kind": "struct",
-        "fields": [
-          {
-            "name": "authority",
-            "type": "pubkey"
-          },
-          {
-            "name": "next_question_id",
-            "type": "u64"
-          },
-          {
-            "name": "bump",
-            "type": "u8"
-          }
-        ]
-      }
-    },
-    {
-      "name": "Pool",
-      "type": {
-        "kind": "struct",
-        "fields": [
-          {
-            "name": "round",
-            "type": "u64"
-          },
-          {
-            "name": "question_id",
-            "type": "u64"
-          },
-          {
-            "name": "question",
-            "type": "string"
-          },
-          {
-            "name": "answer_hash",
-            "type": {
-              "array": [
-                "u8",
-                32
-              ]
-            }
-          },
-          {
-            "name": "deadline",
-            "type": "i64"
-          },
-          {
-            "name": "reward_amount",
-            "type": "u64"
-          },
-          {
-            "name": "reward_count",
-            "type": "u32"
-          },
-          {
-            "name": "reward_per_winner",
-            "type": "u64"
-          },
-          {
-            "name": "winner_count",
-            "type": "u32"
-          },
-          {
-            "name": "is_active",
-            "type": "bool"
-          },
-          {
-            "name": "bump",
-            "type": "u8"
-          }
-        ]
-      }
-    },
-    {
-      "name": "WinnerRecord",
-      "type": {
-        "kind": "struct",
-        "fields": [
-          {
-            "name": "bump",
-            "type": "u8"
-          },
-          {
-            "name": "round",
-            "type": "u64"
-          },
-          {
-            "name": "rewarded",
-            "type": "bool"
-          }
-        ]
-      }
-    }
-  ]
-}