ironq-sdk 0.1.0

package/dist/constants.d.ts

@@ -0,0 +1,11 @@
+import { PublicKey } from "@solana/web3.js";
+/** IronQ program ID (Devnet) */
+export declare const PROGRAM_ID: PublicKey;
+/** PDA seed constants matching the on-chain program */
+export declare const SEEDS: {
+    readonly QUEUE: Buffer<ArrayBuffer>;
+    readonly VAULT: Buffer<ArrayBuffer>;
+    readonly JOB: Buffer<ArrayBuffer>;
+    readonly WORKER: Buffer<ArrayBuffer>;
+    readonly RESULT: Buffer<ArrayBuffer>;
+};

package/dist/constants.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SEEDS = exports.PROGRAM_ID = void 0;
+const web3_js_1 = require("@solana/web3.js");
+/** IronQ program ID (Devnet) */
+exports.PROGRAM_ID = new web3_js_1.PublicKey("J6GjTDeKugyMhFEuTYnEbsBCVSHsPimmbHcURbJ3wtrQ");
+/** PDA seed constants matching the on-chain program */
+exports.SEEDS = {
+    QUEUE: Buffer.from("queue"),
+    VAULT: Buffer.from("vault"),
+    JOB: Buffer.from("job"),
+    WORKER: Buffer.from("worker"),
+    RESULT: Buffer.from("result"),
+};

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { PROGRAM_ID } from "./constants";
+export { findQueuePDA, findVaultPDA, findJobPDA, findWorkerPDA, findResultPDA, } from "./pda";
+export type { JobStatus, QueueConfig, Job, Worker, JobResult, } from "./types";

package/dist/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findResultPDA = exports.findWorkerPDA = exports.findJobPDA = exports.findVaultPDA = exports.findQueuePDA = exports.PROGRAM_ID = void 0;
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "PROGRAM_ID", { enumerable: true, get: function () { return constants_1.PROGRAM_ID; } });
+var pda_1 = require("./pda");
+Object.defineProperty(exports, "findQueuePDA", { enumerable: true, get: function () { return pda_1.findQueuePDA; } });
+Object.defineProperty(exports, "findVaultPDA", { enumerable: true, get: function () { return pda_1.findVaultPDA; } });
+Object.defineProperty(exports, "findJobPDA", { enumerable: true, get: function () { return pda_1.findJobPDA; } });
+Object.defineProperty(exports, "findWorkerPDA", { enumerable: true, get: function () { return pda_1.findWorkerPDA; } });
+Object.defineProperty(exports, "findResultPDA", { enumerable: true, get: function () { return pda_1.findResultPDA; } });

package/dist/pda.d.ts

@@ -0,0 +1,12 @@
+import { PublicKey } from "@solana/web3.js";
+import { BN } from "@coral-xyz/anchor";
+/** Derive the QueueConfig PDA for a given authority. */
+export declare function findQueuePDA(authority: PublicKey): [PublicKey, number];
+/** Derive the vault token account PDA for a given queue. */
+export declare function findVaultPDA(queue: PublicKey): [PublicKey, number];
+/** Derive the Job PDA from queue key and job ID. */
+export declare function findJobPDA(queue: PublicKey, jobId: BN | number): [PublicKey, number];
+/** Derive the Worker PDA from queue key and worker wallet. */
+export declare function findWorkerPDA(queue: PublicKey, wallet: PublicKey): [PublicKey, number];
+/** Derive the JobResult PDA from a job key. */
+export declare function findResultPDA(job: PublicKey): [PublicKey, number];

package/dist/pda.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findQueuePDA = findQueuePDA;
+exports.findVaultPDA = findVaultPDA;
+exports.findJobPDA = findJobPDA;
+exports.findWorkerPDA = findWorkerPDA;
+exports.findResultPDA = findResultPDA;
+const web3_js_1 = require("@solana/web3.js");
+const constants_1 = require("./constants");
+/** Derive the QueueConfig PDA for a given authority. */
+function findQueuePDA(authority) {
+    return web3_js_1.PublicKey.findProgramAddressSync([constants_1.SEEDS.QUEUE, authority.toBuffer()], constants_1.PROGRAM_ID);
+}
+/** Derive the vault token account PDA for a given queue. */
+function findVaultPDA(queue) {
+    return web3_js_1.PublicKey.findProgramAddressSync([constants_1.SEEDS.VAULT, queue.toBuffer()], constants_1.PROGRAM_ID);
+}
+/** Derive the Job PDA from queue key and job ID. */
+function findJobPDA(queue, jobId) {
+    const buf = Buffer.alloc(8);
+    buf.writeBigUInt64LE(BigInt(jobId.toString()));
+    return web3_js_1.PublicKey.findProgramAddressSync([constants_1.SEEDS.JOB, queue.toBuffer(), buf], constants_1.PROGRAM_ID);
+}
+/** Derive the Worker PDA from queue key and worker wallet. */
+function findWorkerPDA(queue, wallet) {
+    return web3_js_1.PublicKey.findProgramAddressSync([constants_1.SEEDS.WORKER, queue.toBuffer(), wallet.toBuffer()], constants_1.PROGRAM_ID);
+}
+/** Derive the JobResult PDA from a job key. */
+function findResultPDA(job) {
+    return web3_js_1.PublicKey.findProgramAddressSync([constants_1.SEEDS.RESULT, job.toBuffer()], constants_1.PROGRAM_ID);
+}

package/dist/types.d.ts

@@ -0,0 +1,78 @@
+import { PublicKey } from "@solana/web3.js";
+import { BN } from "@coral-xyz/anchor";
+/** Job lifecycle status variants (Anchor enum format). */
+export type JobStatus = {
+    open: {};
+} | {
+    claimed: {};
+} | {
+    submitted: {};
+} | {
+    completed: {};
+} | {
+    disputed: {};
+} | {
+    expired: {};
+} | {
+    cancelled: {};
+};
+/** Deserialized QueueConfig account. */
+export interface QueueConfig {
+    version: number;
+    authority: PublicKey;
+    rewardMint: PublicKey;
+    arbiter: PublicKey;
+    vault: PublicKey;
+    minWorkerStake: BN;
+    jobTimeout: BN;
+    slashRateBps: number;
+    crankRewardBps: number;
+    totalJobsCreated: BN;
+    totalActiveWorkers: number;
+    isPaused: boolean;
+    maxConcurrentJobs: number;
+    pendingAuthority: PublicKey | null;
+    bump: number;
+}
+/** Deserialized Job account. */
+export interface Job {
+    version: number;
+    queue: PublicKey;
+    jobId: BN;
+    creator: PublicKey;
+    worker: PublicKey;
+    status: JobStatus;
+    rewardAmount: BN;
+    dataHash: number[];
+    createdAt: BN;
+    claimedAt: BN;
+    deadline: BN;
+    priority: number;
+    maxRetries: number;
+    retryCount: number;
+    bump: number;
+}
+/** Deserialized Worker account. */
+export interface Worker {
+    version: number;
+    queue: PublicKey;
+    wallet: PublicKey;
+    stakeAmount: BN;
+    jobsCompleted: number;
+    jobsFailed: number;
+    totalEarned: BN;
+    activeJobs: number;
+    maxConcurrentJobs: number;
+    isActive: boolean;
+    registeredAt: BN;
+    bump: number;
+}
+/** Deserialized JobResult account. */
+export interface JobResult {
+    version: number;
+    job: PublicKey;
+    worker: PublicKey;
+    resultHash: number[];
+    submittedAt: BN;
+    bump: number;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "ironq-sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for the IronQ on-chain job queue on Solana",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist/",
+    "src/"
+  ],
+  "keywords": ["solana", "anchor", "job-queue", "ironq"],
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/amanhij/IronQ.git",
+    "directory": "ironq/sdk"
+  },
+  "homepage": "https://github.com/amanhij/IronQ",
+  "bugs": {
+    "url": "https://github.com/amanhij/IronQ/issues"
+  },
+  "peerDependencies": {
+    "@coral-xyz/anchor": ">=0.30.0",
+    "@solana/web3.js": ">=1.90.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "@coral-xyz/anchor": "^0.31.1",
+    "@solana/web3.js": "^1.95.0"
+  }
+}

package/src/constants.ts

@@ -0,0 +1,15 @@
+import { PublicKey } from "@solana/web3.js";
+
+/** IronQ program ID (Devnet) */
+export const PROGRAM_ID = new PublicKey(
+  "J6GjTDeKugyMhFEuTYnEbsBCVSHsPimmbHcURbJ3wtrQ"
+);
+
+/** PDA seed constants matching the on-chain program */
+export const SEEDS = {
+  QUEUE: Buffer.from("queue"),
+  VAULT: Buffer.from("vault"),
+  JOB: Buffer.from("job"),
+  WORKER: Buffer.from("worker"),
+  RESULT: Buffer.from("result"),
+} as const;

package/src/index.ts

@@ -0,0 +1,15 @@
+export { PROGRAM_ID } from "./constants";
+export {
+  findQueuePDA,
+  findVaultPDA,
+  findJobPDA,
+  findWorkerPDA,
+  findResultPDA,
+} from "./pda";
+export type {
+  JobStatus,
+  QueueConfig,
+  Job,
+  Worker,
+  JobResult,
+} from "./types";

package/src/pda.ts

@@ -0,0 +1,51 @@
+import { PublicKey } from "@solana/web3.js";
+import { BN } from "@coral-xyz/anchor";
+import { PROGRAM_ID, SEEDS } from "./constants";
+
+/** Derive the QueueConfig PDA for a given authority. */
+export function findQueuePDA(authority: PublicKey): [PublicKey, number] {
+  return PublicKey.findProgramAddressSync(
+    [SEEDS.QUEUE, authority.toBuffer()],
+    PROGRAM_ID
+  );
+}
+
+/** Derive the vault token account PDA for a given queue. */
+export function findVaultPDA(queue: PublicKey): [PublicKey, number] {
+  return PublicKey.findProgramAddressSync(
+    [SEEDS.VAULT, queue.toBuffer()],
+    PROGRAM_ID
+  );
+}
+
+/** Derive the Job PDA from queue key and job ID. */
+export function findJobPDA(
+  queue: PublicKey,
+  jobId: BN | number
+): [PublicKey, number] {
+  const buf = Buffer.alloc(8);
+  buf.writeBigUInt64LE(BigInt(jobId.toString()));
+  return PublicKey.findProgramAddressSync(
+    [SEEDS.JOB, queue.toBuffer(), buf],
+    PROGRAM_ID
+  );
+}
+
+/** Derive the Worker PDA from queue key and worker wallet. */
+export function findWorkerPDA(
+  queue: PublicKey,
+  wallet: PublicKey
+): [PublicKey, number] {
+  return PublicKey.findProgramAddressSync(
+    [SEEDS.WORKER, queue.toBuffer(), wallet.toBuffer()],
+    PROGRAM_ID
+  );
+}
+
+/** Derive the JobResult PDA from a job key. */
+export function findResultPDA(job: PublicKey): [PublicKey, number] {
+  return PublicKey.findProgramAddressSync(
+    [SEEDS.RESULT, job.toBuffer()],
+    PROGRAM_ID
+  );
+}

package/src/types.ts

@@ -0,0 +1,76 @@
+import { PublicKey } from "@solana/web3.js";
+import { BN } from "@coral-xyz/anchor";
+
+/** Job lifecycle status variants (Anchor enum format). */
+export type JobStatus =
+  | { open: {} }
+  | { claimed: {} }
+  | { submitted: {} }
+  | { completed: {} }
+  | { disputed: {} }
+  | { expired: {} }
+  | { cancelled: {} };
+
+/** Deserialized QueueConfig account. */
+export interface QueueConfig {
+  version: number;
+  authority: PublicKey;
+  rewardMint: PublicKey;
+  arbiter: PublicKey;
+  vault: PublicKey;
+  minWorkerStake: BN;
+  jobTimeout: BN;
+  slashRateBps: number;
+  crankRewardBps: number;
+  totalJobsCreated: BN;
+  totalActiveWorkers: number;
+  isPaused: boolean;
+  maxConcurrentJobs: number;
+  pendingAuthority: PublicKey | null;
+  bump: number;
+}
+
+/** Deserialized Job account. */
+export interface Job {
+  version: number;
+  queue: PublicKey;
+  jobId: BN;
+  creator: PublicKey;
+  worker: PublicKey;
+  status: JobStatus;
+  rewardAmount: BN;
+  dataHash: number[];
+  createdAt: BN;
+  claimedAt: BN;
+  deadline: BN;
+  priority: number;
+  maxRetries: number;
+  retryCount: number;
+  bump: number;
+}
+
+/** Deserialized Worker account. */
+export interface Worker {
+  version: number;
+  queue: PublicKey;
+  wallet: PublicKey;
+  stakeAmount: BN;
+  jobsCompleted: number;
+  jobsFailed: number;
+  totalEarned: BN;
+  activeJobs: number;
+  maxConcurrentJobs: number;
+  isActive: boolean;
+  registeredAt: BN;
+  bump: number;
+}
+
+/** Deserialized JobResult account. */
+export interface JobResult {
+  version: number;
+  job: PublicKey;
+  worker: PublicKey;
+  resultHash: number[];
+  submittedAt: BN;
+  bump: number;
+}