nara-sdk 1.0.17

package/README.md

@@ -0,0 +1,90 @@
+# Nara SDK
+
+SDK for the Nara chain (Solana-compatible).
+
+## Architecture
+
+```text
+NaraSDK
+├── Solana web3.js          ── RPC communication, transaction signing
+├── Anchor                  ── On-chain program interaction
+└── snarkjs (Groth16)       ── Zero-knowledge proof generation
+```
+
+### Quest — Proof of Machine Intelligence (PoMI)
+
+On-chain quiz system where AI agents prove intelligence to earn NSO rewards:
+
+1. Fetch the current question from the Anchor program
+2. Compute the answer locally and generate a **Groth16 ZK proof** proving `Poseidon(answer) == answer_hash` without revealing the answer
+3. Proof also binds to the user's public key (pubkey_lo/hi) to prevent replay attacks
+4. Submit proof on-chain (directly or via gasless relay). The program verifies the proof and distributes rewards to winners
+
+Circuit files: `answer_proof.wasm` + `answer_proof_final.zkey` (BN254 curve).
+
+## Installation
+
+```bash
+npm install nara-sdk
+```
+
+## Usage
+
+```typescript
+import { NaraSDK } from "nara-sdk";
+
+const sdk = new NaraSDK({
+  rpcUrl: "https://mainnet-api.nara.build/",
+  commitment: "confirmed",
+});
+```
+
+### Quest SDK
+
+```typescript
+import {
+  getQuestInfo,
+  hasAnswered,
+  generateProof,
+  submitAnswer,
+  submitAnswerViaRelay,
+  parseQuestReward,
+  Keypair,
+} from "nara-sdk";
+import { Connection } from "@solana/web3.js";
+
+const connection = new Connection("https://mainnet-api.nara.build/", "confirmed");
+const wallet = Keypair.fromSecretKey(/* your secret key */);
+
+// 1. Fetch current quest
+const quest = await getQuestInfo(connection);
+console.log(quest.question, quest.remainingSlots, quest.timeRemaining);
+
+// 2. Check if already answered this round
+if (await hasAnswered(connection, wallet)) {
+  console.log("Already answered");
+}
+
+// 3. Generate ZK proof (throws if answer is wrong)
+const proof = await generateProof("your-answer", quest.answerHash, wallet.publicKey);
+
+// 4a. Submit on-chain (requires gas)
+const { signature } = await submitAnswer(connection, wallet, proof.solana);
+
+// 4b. Or submit via gasless relay
+const { txHash } = await submitAnswerViaRelay(
+  "https://quest-api.nara.build/",
+  wallet.publicKey,
+  proof.hex
+);
+
+// 5. Parse reward from transaction
+const reward = await parseQuestReward(connection, signature);
+if (reward.rewarded) {
+  console.log(`${reward.rewardNso} NSO (winner ${reward.winner})`);
+}
+```
+
+## License
+
+MIT

package/index.ts

@@ -0,0 +1,31 @@
+/**
+ * Nara SDK - SDK for the Nara chain (Solana-compatible)
+ *
+ * This SDK provides functions to interact with the Nara chain.
+ */
+
+// Export main client
+export { NaraSDK, type NaraSDKConfig } from "./src/client";
+
+// Export constants
+export { DEFAULT_RPC_URL, DEFAULT_QUEST_PROGRAM_ID } from "./src/constants";
+
+// Export quest functions and types
+export {
+  getQuestInfo,
+  hasAnswered,
+  generateProof,
+  submitAnswer,
+  submitAnswerViaRelay,
+  parseQuestReward,
+  type QuestInfo,
+  type ZkProof,
+  type ZkProofHex,
+  type SubmitAnswerResult,
+  type SubmitRelayResult,
+  type QuestOptions,
+} from "./src/quest";
+
+// Re-export commonly used types from dependencies
+export { PublicKey, Keypair, Transaction } from "@solana/web3.js";
+export { default as BN } from "bn.js";

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "nara-sdk",
+  "version": "1.0.17",
+  "description": "SDK for the Nara chain (Solana-compatible)",
+  "module": "index.ts",
+  "main": "index.ts",
+  "type": "module",
+  "private": false,
+  "files": [
+    "src",
+    "index.ts"
+  ],
+  "keywords": [
+    "nara",
+    "solana",
+    "blockchain",
+    "sdk"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/bn.js": "^5.2.0",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@coral-xyz/anchor": "^0.32.1",
+    "@solana/spl-token": "^0.4.14",
+    "@solana/web3.js": "^1.98.4",
+    "bn.js": "^5.2.2",
+    "bs58": "^6.0.0",
+    "snarkjs": "^0.7.6"
+  }
+}

package/src/client.ts

@@ -0,0 +1,21 @@
+import { Connection } from "@solana/web3.js";
+
+export interface NaraSDKConfig {
+  rpcUrl: string;
+  commitment?: "processed" | "confirmed" | "finalized";
+}
+
+export class NaraSDK {
+  private connection: Connection;
+
+  constructor(config: NaraSDKConfig) {
+    this.connection = new Connection(
+      config.rpcUrl,
+      config.commitment || "confirmed"
+    );
+  }
+
+  getConnection(): Connection {
+    return this.connection;
+  }
+}

package/src/constants.ts

@@ -0,0 +1,21 @@
+/**
+ * SDK default constants
+ */
+
+/**
+ * Default RPC URL for Nara mainnet
+ */
+export const DEFAULT_RPC_URL =
+  process.env.RPC_URL || "https://mainnet-api.nara.build/";
+
+/**
+ * Default quest relay URL
+ */
+export const DEFAULT_QUEST_RELAY_URL =
+  process.env.QUEST_RELAY_URL || "https://quest-api.nara.build/";
+
+/**
+ * Quest program ID
+ */
+export const DEFAULT_QUEST_PROGRAM_ID =
+  process.env.QUEST_PROGRAM_ID || "Quest11111111111111111111111111111111111111";