nara-sdk 1.0.34 → 1.0.36

package/index.ts

@@ -24,6 +24,8 @@ export {
   submitAnswer,
   submitAnswerViaRelay,
   parseQuestReward,
+  computeAnswerHash,
+  createQuestion,
   type QuestInfo,
   type ZkProof,
   type ZkProofHex,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nara-sdk",
-  "version": "1.0.34",
+  "version": "1.0.36",
   "description": "SDK for the Nara chain (Solana-compatible)",
   "module": "index.ts",
   "main": "index.ts",

package/src/quest.ts

@@ -264,11 +264,18 @@ export async function hasAnswered(
 /**
  * Generate a ZK proof for a quest answer.
  * Throws if the answer is wrong (circuit assertion fails).
+ *
+ * @param answer - The answer string (passed directly as circuit input)
+ * @param answerHash - The on-chain answer hash bytes
+ * @param userPubkey - The user's public key (binds proof to user)
+ * @param round - The quest round number (binds proof to round, prevents replay)
+ * @param options - Optional circuit paths
  */
 export async function generateProof(
   answer: string,
   answerHash: number[],
   userPubkey: PublicKey,
+  round: string,
   options?: QuestOptions
 ): Promise<{ solana: ZkProof; hex: ZkProofHex }> {
   const wasmPath = options?.circuitWasmPath ?? process.env.QUEST_CIRCUIT_WASM ?? DEFAULT_CIRCUIT_WASM;
@@ -285,6 +292,7 @@ export async function generateProof(
       answer_hash: answerHashFieldStr,
       pubkey_lo: lo,
       pubkey_hi: hi,
+      round: round,
     },
     wasmPath,
     zkeyPath
@@ -427,3 +435,52 @@ export async function parseQuestReward(
     winner,
   };
 }
+
+/**
+ * Compute the Poseidon answer hash for a given answer string.
+ * Uses answerToField (UTF-8 encoding) consistent with on-chain question creation.
+ */
+export async function computeAnswerHash(answer: string): Promise<number[]> {
+  const circomlibjs = await import("circomlibjs");
+  const poseidon = await circomlibjs.buildPoseidon();
+  const fieldVal = answerToField(answer);
+  const hashRaw = poseidon([fieldVal]);
+  const hashStr: string = poseidon.F.toString(hashRaw);
+  return Array.from(toBigEndian32(BigInt(hashStr)));
+}
+
+/**
+ * Create a new quest question on-chain (authority only).
+ *
+ * @param connection - Solana connection
+ * @param wallet - Authority keypair (must be the program authority)
+ * @param question - The question text
+ * @param answer - The answer string (will be hashed with Poseidon + answerToField)
+ * @param deadlineSeconds - Duration in seconds from now until the deadline
+ * @param rewardSol - Total reward amount in SOL/NARA
+ * @param difficulty - Difficulty level (default: 1)
+ * @param options - Optional program ID override
+ */
+export async function createQuestion(
+  connection: Connection,
+  wallet: Keypair,
+  question: string,
+  answer: string,
+  deadlineSeconds: number,
+  rewardSol: number,
+  difficulty: number = 1,
+  options?: QuestOptions
+): Promise<string> {
+  const program = createProgram(connection, wallet, options?.programId);
+  const answerHash = await computeAnswerHash(answer);
+  const deadline = new anchor.BN(Math.floor(Date.now() / 1000) + deadlineSeconds);
+  const rewardAmount = new anchor.BN(Math.round(rewardSol * LAMPORTS_PER_SOL));
+
+  const signature = await program.methods
+    .createQuestion(question, answerHash as any, deadline, rewardAmount, difficulty)
+    .accounts({ authority: wallet.publicKey } as any)
+    .signers([wallet])
+    .rpc();
+
+  return signature;
+}