@telaro/sacp 1.0.2 → 1.0.3

package/dist/index.d.ts

@@ -26,6 +26,7 @@ export * as takeRate from "./take_rate.js";
 export * as offering from "./offering.js";
 export * as negotiation from "./negotiation.js";
 export * as agreement from "./agreement.js";
+export * as jury from "./jury.js";
 export { SacpClient, JobSession, type JobActors, type JobSnapshot, type JobAction, type SacpClientConfig, } from "./runtime.js";
 export { LocalSigner, RemoteSigner, WalletAdapterSigner, type SacpSigner, type RemoteSignTransport, type BrowserWalletAdapter, } from "./signer.js";
 export { ProviderRuntime, EvaluatorRuntime, type ProviderRuntimeOptions, type EvaluatorRuntimeOptions, type WatcherCallbackContext, } from "./watcher.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAG5C,OAAO,EACL,UAAU,EACV,UAAU,EACV,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC7B,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,GACnB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,OAAO,EACL,UAAU,EACV,UAAU,EACV,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC7B,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,GACnB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -26,6 +26,7 @@ export * as takeRate from "./take_rate.js";
 export * as offering from "./offering.js";
 export * as negotiation from "./negotiation.js";
 export * as agreement from "./agreement.js";
+export * as jury from "./jury.js";
 // v0.8 runtime layer — high-level client + session.
 export { SacpClient, JobSession, } from "./runtime.js";
 export { LocalSigner, RemoteSigner, WalletAdapterSigner, } from "./signer.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAE5C,oDAAoD;AACpD,OAAO,EACL,UAAU,EACV,UAAU,GAKX,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,mBAAmB,GAIpB,MAAM,aAAa,CAAC;AAErB,8CAA8C;AAC9C,OAAO,EACL,eAAe,EACf,gBAAgB,GAIjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,sBAAsB,GAIvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,cAAc,GAEf,MAAM,cAAc,CAAC;AAEtB,8CAA8C;AAC9C,OAAO,EACL,oBAAoB,EACpB,kBAAkB,GAEnB,MAAM,cAAc,CAAC;AAMtB,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,GACnB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,oDAAoD;AACpD,OAAO,EACL,UAAU,EACV,UAAU,GAKX,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,mBAAmB,GAIpB,MAAM,aAAa,CAAC;AAErB,8CAA8C;AAC9C,OAAO,EACL,eAAe,EACf,gBAAgB,GAIjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,sBAAsB,GAIvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,cAAc,GAEf,MAAM,cAAc,CAAC;AAEtB,8CAA8C;AAC9C,OAAO,EACL,oBAAoB,EACpB,kBAAkB,GAEnB,MAAM,cAAc,CAAC;AAMtB,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,GACnB,MAAM,WAAW,CAAC"}

package/dist/jury.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Client for `sacp_jury` — VRF-seeded jury draw program (Phase 8b
+ * Step 4).
+ *
+ *   - `deriveJuryPda(jobIdHash)` — PDA lookup, deterministic from the
+ *     sha256(jobId) bytes that buyer + provider both produce.
+ *   - `buildOpenJuryIx(...)` — opens the Jury account before any
+ *     panel draw runs.
+ *   - `buildSealPanelIx(...)` — dev / test path. Caller supplies the
+ *     candidate list and a mock 32-byte seed.
+ *   - `buildSealPanelFromRandomnessIx(...)` — production path. Pass a
+ *     Switchboard On-Demand `Randomness` account; the program reads
+ *     its `result_buffer` directly.
+ *   - `fetchJury` / `parseJuryFromBuffer` — read + decode the sealed
+ *     panel for downstream consumers (e.g. evaluator UI).
+ */
+import { Connection, PublicKey, TransactionInstruction } from "@solana/web3.js";
+export declare const SACP_JURY_PROGRAM_ID: PublicKey;
+/**
+ * Switchboard On-Demand program id used by `seal_panel_from_randomness`.
+ * Same value baked into `programs/sacp_jury/src/lib.rs`. Exported so
+ * the client can derive Randomness PDAs without re-importing the
+ * Switchboard SDK.
+ */
+export declare const SWITCHBOARD_ON_DEMAND_PROGRAM_ID: PublicKey;
+export declare const SEED_JURY: Buffer<ArrayBuffer>;
+export declare const MAX_PANEL_SIZE = 9;
+export declare const MAX_CANDIDATES = 64;
+/** Derive the Jury PDA for a 32-byte jobId hash. */
+export declare function deriveJuryPda(jobIdHash: Uint8Array): [PublicKey, number];
+export interface OpenJuryParams {
+    caller: PublicKey;
+    jobIdHash: Uint8Array;
+    panelSize: number;
+}
+export declare function buildOpenJuryIx(params: OpenJuryParams): TransactionInstruction;
+export interface CandidateInput {
+    authority: PublicKey;
+    stakeAtoms: bigint;
+}
+export interface SealPanelParams {
+    cranker: PublicKey;
+    jury: PublicKey;
+    candidates: ReadonlyArray<CandidateInput>;
+    mockSeed: Uint8Array;
+}
+/**
+ * Dev / test path. Use this when you want a deterministic draw for a
+ * smoke test or local fixture. Production path is
+ * `buildSealPanelFromRandomnessIx`.
+ */
+export declare function buildSealPanelIx(params: SealPanelParams): TransactionInstruction;
+export interface SealPanelFromRandomnessParams {
+    cranker: PublicKey;
+    jury: PublicKey;
+    candidates: ReadonlyArray<CandidateInput>;
+    /** Switchboard On-Demand `Randomness` account that's been revealed. */
+    randomness: PublicKey;
+}
+/**
+ * Production path. The program reads the `result_buffer` from the
+ * Switchboard account directly — caller is responsible for having
+ * already triggered the Switchboard request + reveal flow before
+ * cranking this IX. Pre-reveal calls fail with
+ * `RandomnessNotResolved`.
+ */
+export declare function buildSealPanelFromRandomnessIx(params: SealPanelFromRandomnessParams): TransactionInstruction;
+export interface FetchedJury {
+    jobIdHash: Uint8Array;
+    panelSize: number;
+    sealed: boolean;
+    seedUsed: Uint8Array;
+    panel: PublicKey[];
+    bump: number;
+}
+export declare function fetchJury(conn: Connection, jobIdHash: Uint8Array): Promise<FetchedJury | null>;
+/**
+ * Layout (must match programs/sacp_jury/src/lib.rs Jury):
+ *   8 disc + 32 jobId + 1 panel_size + 1 sealed +
+ *   32 seed_used + 4 panel_len + 32 * panel_len + 1 bump.
+ */
+export declare function parseJuryFromBuffer(data: Buffer): FetchedJury;
+//# sourceMappingURL=jury.d.ts.map

package/dist/jury.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jury.d.ts","sourceRoot":"","sources":["../src/jury.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,UAAU,EACV,SAAS,EAET,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AAQzB,eAAO,MAAM,oBAAoB,WAEhC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,WAE5C,CAAC;AAEF,eAAO,MAAM,SAAS,qBAAsB,CAAC;AAC7C,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,SAAS,EAAE,UAAU,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAQxE;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,UAAU,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,sBAAsB,CAqB9E;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAgBD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,SAAS,CAAC;IACnB,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAC1C,QAAQ,EAAE,UAAU,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,eAAe,GACtB,sBAAsB,CAcxB;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,SAAS,CAAC;IACnB,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAC1C,uEAAuE;IACvE,UAAU,EAAE,SAAS,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,6BAA6B,GACpC,sBAAsB,CAcxB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,UAAU,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,UAAU,CAAC;IACrB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,UAAU,GACpB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAK7B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAiC7D"}

package/dist/jury.js

@@ -0,0 +1,142 @@
+/**
+ * Client for `sacp_jury` — VRF-seeded jury draw program (Phase 8b
+ * Step 4).
+ *
+ *   - `deriveJuryPda(jobIdHash)` — PDA lookup, deterministic from the
+ *     sha256(jobId) bytes that buyer + provider both produce.
+ *   - `buildOpenJuryIx(...)` — opens the Jury account before any
+ *     panel draw runs.
+ *   - `buildSealPanelIx(...)` — dev / test path. Caller supplies the
+ *     candidate list and a mock 32-byte seed.
+ *   - `buildSealPanelFromRandomnessIx(...)` — production path. Pass a
+ *     Switchboard On-Demand `Randomness` account; the program reads
+ *     its `result_buffer` directly.
+ *   - `fetchJury` / `parseJuryFromBuffer` — read + decode the sealed
+ *     panel for downstream consumers (e.g. evaluator UI).
+ */
+import { PublicKey, SystemProgram, TransactionInstruction, } from "@solana/web3.js";
+import { encodeBytes32, encodeInstruction, encodeU8, encodeU64, } from "./codec.js";
+export const SACP_JURY_PROGRAM_ID = new PublicKey("9tLdTxzEFKqqi9tK7DcRhoJ5HzWaxUzgqXnyjUZfM5i7");
+/**
+ * Switchboard On-Demand program id used by `seal_panel_from_randomness`.
+ * Same value baked into `programs/sacp_jury/src/lib.rs`. Exported so
+ * the client can derive Randomness PDAs without re-importing the
+ * Switchboard SDK.
+ */
+export const SWITCHBOARD_ON_DEMAND_PROGRAM_ID = new PublicKey("SBondMDrcV3K4kxZR1HNVT7osZxAHVHgYXL5Ze1oMUv");
+export const SEED_JURY = Buffer.from("jury");
+export const MAX_PANEL_SIZE = 9;
+export const MAX_CANDIDATES = 64;
+/** Derive the Jury PDA for a 32-byte jobId hash. */
+export function deriveJuryPda(jobIdHash) {
+    if (jobIdHash.length !== 32) {
+        throw new Error(`jobIdHash must be 32 bytes, got ${jobIdHash.length}`);
+    }
+    return PublicKey.findProgramAddressSync([SEED_JURY, Buffer.from(jobIdHash)], SACP_JURY_PROGRAM_ID);
+}
+export function buildOpenJuryIx(params) {
+    if (params.panelSize < 1 || params.panelSize > MAX_PANEL_SIZE) {
+        throw new Error(`panelSize must be 1..${MAX_PANEL_SIZE}, got ${params.panelSize}`);
+    }
+    const [jury] = deriveJuryPda(params.jobIdHash);
+    const data = encodeInstruction("open_jury", encodeBytes32(params.jobIdHash), encodeU8(params.panelSize));
+    return new TransactionInstruction({
+        programId: SACP_JURY_PROGRAM_ID,
+        keys: [
+            { pubkey: params.caller, isSigner: true, isWritable: true },
+            { pubkey: jury, isSigner: false, isWritable: true },
+            { pubkey: SystemProgram.programId, isSigner: false, isWritable: false },
+        ],
+        data,
+    });
+}
+function encodeCandidates(list) {
+    if (list.length > MAX_CANDIDATES) {
+        throw new Error(`candidate list exceeds MAX_CANDIDATES=${MAX_CANDIDATES}, got ${list.length}`);
+    }
+    const len = Buffer.alloc(4);
+    len.writeUInt32LE(list.length);
+    const parts = list.map((c) => Buffer.concat([c.authority.toBuffer(), encodeU64(c.stakeAtoms)]));
+    return Buffer.concat([len, ...parts]);
+}
+/**
+ * Dev / test path. Use this when you want a deterministic draw for a
+ * smoke test or local fixture. Production path is
+ * `buildSealPanelFromRandomnessIx`.
+ */
+export function buildSealPanelIx(params) {
+    const data = encodeInstruction("seal_panel", encodeCandidates(params.candidates), encodeBytes32(params.mockSeed));
+    return new TransactionInstruction({
+        programId: SACP_JURY_PROGRAM_ID,
+        keys: [
+            { pubkey: params.jury, isSigner: false, isWritable: true },
+            { pubkey: params.cranker, isSigner: true, isWritable: false },
+        ],
+        data,
+    });
+}
+/**
+ * Production path. The program reads the `result_buffer` from the
+ * Switchboard account directly — caller is responsible for having
+ * already triggered the Switchboard request + reveal flow before
+ * cranking this IX. Pre-reveal calls fail with
+ * `RandomnessNotResolved`.
+ */
+export function buildSealPanelFromRandomnessIx(params) {
+    const data = encodeInstruction("seal_panel_from_randomness", encodeCandidates(params.candidates));
+    return new TransactionInstruction({
+        programId: SACP_JURY_PROGRAM_ID,
+        keys: [
+            { pubkey: params.jury, isSigner: false, isWritable: true },
+            { pubkey: params.cranker, isSigner: true, isWritable: false },
+            { pubkey: params.randomness, isSigner: false, isWritable: false },
+        ],
+        data,
+    });
+}
+export async function fetchJury(conn, jobIdHash) {
+    const [pda] = deriveJuryPda(jobIdHash);
+    const info = await conn.getAccountInfo(pda, "confirmed");
+    if (!info)
+        return null;
+    return parseJuryFromBuffer(info.data);
+}
+/**
+ * Layout (must match programs/sacp_jury/src/lib.rs Jury):
+ *   8 disc + 32 jobId + 1 panel_size + 1 sealed +
+ *   32 seed_used + 4 panel_len + 32 * panel_len + 1 bump.
+ */
+export function parseJuryFromBuffer(data) {
+    let offset = 8;
+    const readBytes32 = () => {
+        const v = new Uint8Array(data.subarray(offset, offset + 32));
+        offset += 32;
+        return v;
+    };
+    const readU8 = () => {
+        const v = data.readUInt8(offset);
+        offset += 1;
+        return v;
+    };
+    const readU32 = () => {
+        const v = data.readUInt32LE(offset);
+        offset += 4;
+        return v;
+    };
+    const readPubkey = () => {
+        const v = new PublicKey(data.subarray(offset, offset + 32));
+        offset += 32;
+        return v;
+    };
+    const jobIdHash = readBytes32();
+    const panelSize = readU8();
+    const sealed = readU8() === 1;
+    const seedUsed = readBytes32();
+    const panelLen = readU32();
+    const panel = [];
+    for (let i = 0; i < panelLen; i++)
+        panel.push(readPubkey());
+    const bump = readU8();
+    return { jobIdHash, panelSize, sealed, seedUsed, panel, bump };
+}
+//# sourceMappingURL=jury.js.map

package/dist/jury.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jury.js","sourceRoot":"","sources":["../src/jury.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAEL,SAAS,EACT,aAAa,EACb,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,QAAQ,EACR,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,SAAS,CAC/C,8CAA8C,CAC/C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,IAAI,SAAS,CAC3D,6CAA6C,CAC9C,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAChC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAEjC,oDAAoD;AACpD,MAAM,UAAU,aAAa,CAAC,SAAqB;IACjD,IAAI,SAAS,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,mCAAmC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,SAAS,CAAC,sBAAsB,CACrC,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EACnC,oBAAoB,CACrB,CAAC;AACJ,CAAC;AAQD,MAAM,UAAU,eAAe,CAAC,MAAsB;IACpD,IAAI,MAAM,CAAC,SAAS,GAAG,CAAC,IAAI,MAAM,CAAC,SAAS,GAAG,cAAc,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CACb,wBAAwB,cAAc,SAAS,MAAM,CAAC,SAAS,EAAE,CAClE,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,iBAAiB,CAC5B,WAAW,EACX,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,EAC/B,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAC3B,CAAC;IACF,OAAO,IAAI,sBAAsB,CAAC;QAChC,SAAS,EAAE,oBAAoB;QAC/B,IAAI,EAAE;YACJ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;YAC3D,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;YACnD,EAAE,MAAM,EAAE,aAAa,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE;SACxE;QACD,IAAI;KACL,CAAC,CAAC;AACL,CAAC;AAOD,SAAS,gBAAgB,CAAC,IAAmC;IAC3D,IAAI,IAAI,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,yCAAyC,cAAc,SAAS,IAAI,CAAC,MAAM,EAAE,CAC9E,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5B,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CACjE,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;AACxC,CAAC;AASD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAuB;IAEvB,MAAM,IAAI,GAAG,iBAAiB,CAC5B,YAAY,EACZ,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,EACnC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAC/B,CAAC;IACF,OAAO,IAAI,sBAAsB,CAAC;QAChC,SAAS,EAAE,oBAAoB;QAC/B,IAAI,EAAE;YACJ,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;YAC1D,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE;SAC9D;QACD,IAAI;KACL,CAAC,CAAC;AACL,CAAC;AAUD;;;;;;GAMG;AACH,MAAM,UAAU,8BAA8B,CAC5C,MAAqC;IAErC,MAAM,IAAI,GAAG,iBAAiB,CAC5B,4BAA4B,EAC5B,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,CACpC,CAAC;IACF,OAAO,IAAI,sBAAsB,CAAC;QAChC,SAAS,EAAE,oBAAoB;QAC/B,IAAI,EAAE;YACJ,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;YAC1D,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE;YAC7D,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE;SAClE;QACD,IAAI;KACL,CAAC,CAAC;AACL,CAAC;AAWD,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAgB,EAChB,SAAqB;IAErB,MAAM,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACzD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,mBAAmB,CAAC,IAAI,CAAC,IAAc,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,WAAW,GAAG,GAAe,EAAE;QACnC,MAAM,CAAC,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC;QAC7D,MAAM,IAAI,EAAE,CAAC;QACb,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,GAAW,EAAE;QAC1B,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,IAAI,CAAC,CAAC;QACZ,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,GAAW,EAAE;QAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,IAAI,CAAC,CAAC;QACZ,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,GAAc,EAAE;QACjC,MAAM,CAAC,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC;QAC5D,MAAM,IAAI,EAAE,CAAC;QACb,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,WAAW,EAAE,CAAC;IAChC,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9B,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,OAAO,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC;IAEtB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACjE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telaro/sacp",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Solana Agent Commerce Protocol (sACP) — TypeScript SDK. Job lifecycle escrow + bonded validator registry on Solana, ERC-8183 compatible. Reference implementation by Telaro Protocol.",
   "license": "MIT",
   "main": "dist/index.js",
@@ -66,6 +66,10 @@
     "./agreement": {
       "types": "./dist/agreement.d.ts",
       "import": "./dist/agreement.js"
+    },
+    "./jury": {
+      "types": "./dist/jury.d.ts",
+      "import": "./dist/jury.js"
     }
   },
   "files": [
@@ -139,6 +143,7 @@
     "smoke:phase8b": "tsx tests/devnet-phase8b.ts",
     "smoke:jury-verdict": "tsx tests/devnet-jury-verdict.ts",
     "smoke:resolver-routing": "tsx tests/devnet-resolver-routing.ts",
+    "smoke:jury-sdk": "tsx tests/devnet-jury-sdk.ts",
     "smoke:phantom": "tsx tests/devnet-phantom.ts",
     "smoke:x402": "tsx tests/devnet-x402.ts",
     "smoke:mcp-server": "tsx tests/devnet-mcp-server.ts"