kuantum-qrng-sdk 1.0.0

package/dist/QuantumOracleSDK.d.ts

@@ -0,0 +1,25 @@
+export declare class QuantumSDK {
+    private provider;
+    private wallet;
+    private contractAddress;
+    private contract;
+    private relayerUrl;
+    /**
+     * @param rpcUrl Monad network RPC URL
+     * @param contractAddress Deployed QuantumOracle contract address
+     * @param privateKey Private key of the caller/dApp wallet that pays for transaction gas
+     * @param relayerUrl Optional custom relayer URL, defaults to http://localhost:3000
+     */
+    constructor(rpcUrl: string, contractAddress: string, privateKey: string, relayerUrl?: string);
+    /**
+     * Fetches quantum random number & signature from the off-chain relayer,
+     * then submits it directly to the Monad smart contract.
+     *
+     * @returns The transaction hash of the successful transaction.
+     */
+    fetchAndSubmitRandom(): Promise<string>;
+    /**
+     * Helper to query the last verified random number on-chain.
+     */
+    getLastRandomNumber(): Promise<number>;
+}

package/dist/QuantumOracleSDK.js

@@ -0,0 +1,84 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuantumSDK = void 0;
+const ethers_1 = require("ethers");
+const axios_1 = __importDefault(require("axios"));
+// Minimal ABI for interacting with the consumeRandom function of the QuantumOracle contract
+const ORACLE_ABI = [
+    'function consumeRandom(uint8 _randomNumber, bytes calldata _signature) external',
+    'function lastRandomNumber() external view address',
+    'function oracleNode() external view address'
+];
+class QuantumSDK {
+    provider;
+    wallet;
+    contractAddress;
+    contract;
+    relayerUrl;
+    /**
+     * @param rpcUrl Monad network RPC URL
+     * @param contractAddress Deployed QuantumOracle contract address
+     * @param privateKey Private key of the caller/dApp wallet that pays for transaction gas
+     * @param relayerUrl Optional custom relayer URL, defaults to http://localhost:3000
+     */
+    constructor(rpcUrl, contractAddress, privateKey, relayerUrl = 'http://localhost:3000') {
+        this.provider = new ethers_1.JsonRpcProvider(rpcUrl);
+        this.wallet = new ethers_1.Wallet(privateKey, this.provider);
+        this.contractAddress = contractAddress;
+        this.contract = new ethers_1.Contract(contractAddress, ORACLE_ABI, this.wallet);
+        this.relayerUrl = relayerUrl;
+    }
+    /**
+     * Fetches quantum random number & signature from the off-chain relayer,
+     * then submits it directly to the Monad smart contract.
+     *
+     * @returns The transaction hash of the successful transaction.
+     */
+    async fetchAndSubmitRandom() {
+        try {
+            console.log(`[SDK] Fetching quantum random number from relayer: ${this.relayerUrl}/quantum-random...`);
+            // 1. Fetch random number and signature from off-chain relayer
+            const response = await axios_1.default.get(`${this.relayerUrl}/quantum-random`);
+            const { randomNumber, signature, oracleAddress } = response.data;
+            if (randomNumber === undefined || !signature) {
+                throw new Error('Invalid response from QRNG Relayer');
+            }
+            console.log(`[SDK] Quantum Number retrieved: ${randomNumber}`);
+            console.log(`[SDK] Relayer Signature: ${signature}`);
+            console.log(`[SDK] Signed by Oracle Address: ${oracleAddress}`);
+            // 2. Submit transaction to Monad contract
+            console.log(`[SDK] Submitting transaction to QuantumOracle at ${this.contractAddress}...`);
+            const tx = await this.contract.consumeRandom(randomNumber, signature);
+            console.log(`[SDK] Transaction submitted! Hash: ${tx.hash}`);
+            // 3. Wait for confirmation
+            console.log('[SDK] Waiting for block confirmation...');
+            const receipt = await tx.wait();
+            if (!receipt || receipt.status !== 1) {
+                throw new Error('Transaction execution failed on-chain');
+            }
+            console.log(`[SDK] Transaction confirmed successfully in block ${receipt.blockNumber}!`);
+            return tx.hash;
+        }
+        catch (error) {
+            console.error('[SDK] Error in fetchAndSubmitRandom:', error.message || error);
+            throw error;
+        }
+    }
+    /**
+     * Helper to query the last verified random number on-chain.
+     */
+    async getLastRandomNumber() {
+        try {
+            const num = await this.contract.lastRandomNumber();
+            return Number(num);
+        }
+        catch (error) {
+            console.error('[SDK] Error reading last random number:', error.message || error);
+            throw error;
+        }
+    }
+}
+exports.QuantumSDK = QuantumSDK;

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "kuantum-qrng-sdk",
+  "version": "1.0.0",
+  "description": "TypeScript SDK for Monad QRNG Oracle",
+  "main": "dist/QuantumOracleSDK.js",
+  "types": "dist/QuantumOracleSDK.d.ts",
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "axios": "^1.7.2",
+    "ethers": "^6.13.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.5"
+  }
+}

package/src/QuantumOracleSDK.ts

@@ -0,0 +1,94 @@
+import { JsonRpcProvider, Wallet, Contract } from 'ethers';
+import axios from 'axios';
+
+// Minimal ABI for interacting with the consumeRandom function of the QuantumOracle contract
+const ORACLE_ABI = [
+  'function consumeRandom(uint8 _randomNumber, bytes calldata _signature) external',
+  'function lastRandomNumber() external view address',
+  'function oracleNode() external view address'
+];
+
+export class QuantumSDK {
+  private provider: JsonRpcProvider;
+  private wallet: Wallet;
+  private contractAddress: string;
+  private contract: Contract;
+  private relayerUrl: string;
+
+  /**
+   * @param rpcUrl Monad network RPC URL
+   * @param contractAddress Deployed QuantumOracle contract address
+   * @param privateKey Private key of the caller/dApp wallet that pays for transaction gas
+   * @param relayerUrl Optional custom relayer URL, defaults to http://localhost:3000
+   */
+  constructor(
+    rpcUrl: string,
+    contractAddress: string,
+    privateKey: string,
+    relayerUrl: string = 'http://localhost:3000'
+  ) {
+    this.provider = new JsonRpcProvider(rpcUrl);
+    this.wallet = new Wallet(privateKey, this.provider);
+    this.contractAddress = contractAddress;
+    this.contract = new Contract(contractAddress, ORACLE_ABI, this.wallet);
+    this.relayerUrl = relayerUrl;
+  }
+
+  /**
+   * Fetches quantum random number & signature from the off-chain relayer,
+   * then submits it directly to the Monad smart contract.
+   * 
+   * @returns The transaction hash of the successful transaction.
+   */
+  async fetchAndSubmitRandom(): Promise<string> {
+    try {
+      console.log(`[SDK] Fetching quantum random number from relayer: ${this.relayerUrl}/quantum-random...`);
+      
+      // 1. Fetch random number and signature from off-chain relayer
+      const response = await axios.get(`${this.relayerUrl}/quantum-random`);
+      const { randomNumber, signature, oracleAddress } = response.data;
+
+      if (randomNumber === undefined || !signature) {
+        throw new Error('Invalid response from QRNG Relayer');
+      }
+
+      console.log(`[SDK] Quantum Number retrieved: ${randomNumber}`);
+      console.log(`[SDK] Relayer Signature: ${signature}`);
+      console.log(`[SDK] Signed by Oracle Address: ${oracleAddress}`);
+
+      // 2. Submit transaction to Monad contract
+      console.log(`[SDK] Submitting transaction to QuantumOracle at ${this.contractAddress}...`);
+      
+      const tx = await this.contract.consumeRandom(randomNumber, signature);
+      console.log(`[SDK] Transaction submitted! Hash: ${tx.hash}`);
+
+      // 3. Wait for confirmation
+      console.log('[SDK] Waiting for block confirmation...');
+      const receipt = await tx.wait();
+      
+      if (!receipt || receipt.status !== 1) {
+        throw new Error('Transaction execution failed on-chain');
+      }
+
+      console.log(`[SDK] Transaction confirmed successfully in block ${receipt.blockNumber}!`);
+      return tx.hash;
+
+    } catch (error: any) {
+      console.error('[SDK] Error in fetchAndSubmitRandom:', error.message || error);
+      throw error;
+    }
+  }
+
+  /**
+   * Helper to query the last verified random number on-chain.
+   */
+  async getLastRandomNumber(): Promise<number> {
+    try {
+      const num = await this.contract.lastRandomNumber();
+      return Number(num);
+    } catch (error: any) {
+      console.error('[SDK] Error reading last random number:', error.message || error);
+      throw error;
+    }
+  }
+}

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "CommonJS",
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"]
+}