@telaro/sacp 1.0.0

package/dist/signer.js

@@ -0,0 +1,94 @@
+import { Transaction, sendAndConfirmTransaction, } from "@solana/web3.js";
+/** Local-keypair signer. Default for SDK consumers running in-process. */
+export class LocalSigner {
+    keypair;
+    constructor(keypair) {
+        this.keypair = keypair;
+    }
+    get publicKey() {
+        return this.keypair.publicKey;
+    }
+    async sendAndConfirm(connection, instructions, coSigners = []) {
+        const tx = new Transaction().add(...instructions);
+        return sendAndConfirmTransaction(connection, tx, [this.keypair, ...coSigners], { commitment: "confirmed" });
+    }
+    /** Convenience for runtimes that want raw Signer access (e.g. for
+     * `@solana/spl-token` helpers that demand `Signer` not just pubkey). */
+    asWeb3Signer() {
+        return this.keypair;
+    }
+}
+export class RemoteSigner {
+    publicKey;
+    transport;
+    constructor(publicKey, transport) {
+        this.publicKey = publicKey;
+        this.transport = transport;
+    }
+    async sendAndConfirm(connection, instructions, coSigners = []) {
+        const tx = new Transaction().add(...instructions);
+        const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash("confirmed");
+        tx.recentBlockhash = blockhash;
+        tx.lastValidBlockHeight = lastValidBlockHeight;
+        tx.feePayer = this.publicKey;
+        if (coSigners.length > 0)
+            tx.partialSign(...coSigners);
+        const message = tx.serializeMessage();
+        const signature = await this.transport.signMessage(Uint8Array.from(message));
+        tx.addSignature(this.publicKey, Buffer.from(signature));
+        const rawTx = tx.serialize();
+        const sig = await connection.sendRawTransaction(rawTx, {
+            skipPreflight: false,
+            preflightCommitment: "confirmed",
+        });
+        await connection.confirmTransaction({ signature: sig, blockhash, lastValidBlockHeight }, "confirmed");
+        return sig;
+    }
+}
+/**
+ * Browser signer that delegates signing to a connected wallet
+ * (Phantom, Backpack, Solflare, anything that follows the
+ * `@solana/wallet-adapter-base` `WalletAdapter` interface).
+ *
+ * Typical Phantom usage:
+ *
+ * ```ts
+ * await window.solana.connect();
+ * const signer = new WalletAdapterSigner(window.solana);
+ * const sacp = new SacpClient({ connection });
+ * const session = await sacp.openJob({
+ *   jobId,
+ *   actors: { client: signer, provider: ..., evaluator: ... },
+ * });
+ * await session.fund();
+ * ```
+ *
+ * Co-signers (ephemeral keypairs) are forwarded to the wallet's
+ * `sendTransaction` option. Phantom + Backpack both honor it.
+ */
+export class WalletAdapterSigner {
+    adapter;
+    constructor(adapter) {
+        this.adapter = adapter;
+    }
+    get publicKey() {
+        if (!this.adapter.publicKey) {
+            throw new Error("WalletAdapterSigner: wallet not connected (publicKey is null). Call adapter.connect() first.");
+        }
+        return this.adapter.publicKey;
+    }
+    async sendAndConfirm(connection, instructions, coSigners = []) {
+        const pk = this.publicKey; // throws if not connected
+        const tx = new Transaction().add(...instructions);
+        const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash("confirmed");
+        tx.recentBlockhash = blockhash;
+        tx.lastValidBlockHeight = lastValidBlockHeight;
+        tx.feePayer = pk;
+        const sig = await this.adapter.sendTransaction(tx, connection, {
+            signers: coSigners,
+        });
+        await connection.confirmTransaction({ signature: sig, blockhash, lastValidBlockHeight }, "confirmed");
+        return sig;
+    }
+}
+//# sourceMappingURL=signer.js.map

package/dist/signer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signer.js","sourceRoot":"","sources":["../src/signer.ts"],"names":[],"mappings":"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"}

package/dist/take_rate.d.ts

@@ -0,0 +1,44 @@
+import { Connection, PublicKey, TransactionInstruction } from "@solana/web3.js";
+/** Compute fee from a Provider payout, matching the on-chain math:
+ * `floor(amount * bps / 10_000)`. JS bigint avoids the u64 → u128 cast
+ * the program does, but the result is identical because we floor. */
+export declare function computeTakeRateFee(amount: bigint, bps: number): bigint;
+/** Treasury ATA for `bondMint`, owned by the Config PDA. Must be
+ * pre-initialized (via `createAssociatedTokenAccountIdempotent`) before
+ * any Job using `bondMint` can settle on the Provider side. */
+export declare function getTreasuryTokenAccount(bondMint: PublicKey): PublicKey;
+export interface InitConfigParams {
+    payer: PublicKey;
+    takeRateBps: number;
+    authority: PublicKey;
+}
+export declare function buildInitConfigIx(params: InitConfigParams): TransactionInstruction;
+export interface UpdateTakeRateParams {
+    authority: PublicKey;
+    newBps: number;
+}
+export declare function buildUpdateTakeRateIx(params: UpdateTakeRateParams): TransactionInstruction;
+export interface UpdateValidatorShareParams {
+    authority: PublicKey;
+    newBps: number;
+}
+export declare function buildUpdateValidatorShareIx(params: UpdateValidatorShareParams): TransactionInstruction;
+export interface SetConfigAuthorityParams {
+    authority: PublicKey;
+    newAuthority: PublicKey;
+}
+export declare function buildSetConfigAuthorityIx(params: SetConfigAuthorityParams): TransactionInstruction;
+export interface WithdrawTreasuryParams {
+    authority: PublicKey;
+    bondMint: PublicKey;
+    destination: PublicKey;
+    amount: bigint;
+}
+export declare function buildWithdrawTreasuryIx(params: WithdrawTreasuryParams): TransactionInstruction;
+export interface FetchedSacpConfig {
+    authority: PublicKey;
+    takeRateBps: number;
+    validatorShareBps: number;
+}
+export declare function fetchSacpConfig(connection: Connection): Promise<FetchedSacpConfig | null>;
+//# sourceMappingURL=take_rate.d.ts.map

package/dist/take_rate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"take_rate.d.ts","sourceRoot":"","sources":["../src/take_rate.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,SAAS,EAET,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AAiDzB;;qEAEqE;AACrE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAQtE;AAED;;+DAE+D;AAC/D,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,CAGtE;AAID,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,gBAAgB,GACvB,sBAAsB,CAqBxB;AAID,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,oBAAoB,GAC3B,sBAAsB,CAmBxB;AAID,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,0BAA0B,GACjC,sBAAsB,CAmBxB;AAID,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,SAAS,CAAC;CACzB;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,wBAAwB,GAC/B,sBAAsB,CAcxB;AAID,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,SAAS,CAAC;IACpB,WAAW,EAAE,SAAS,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,sBAAsB,GAC7B,sBAAsB,CAmBxB;AAID,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAUnC"}

package/dist/take_rate.js

@@ -0,0 +1,141 @@
+import { PublicKey, SystemProgram, TransactionInstruction, } from "@solana/web3.js";
+import { getAssociatedTokenAddressSync } from "@solana/spl-token";
+import { encodeInstruction, encodeU64, } from "./codec.js";
+import { FEE_DENOMINATOR_BPS, MAX_TAKE_RATE_BPS, MAX_VALIDATOR_SHARE_BPS, SACP_PROGRAM_ID, } from "./constants.js";
+import { findSacpConfigPda } from "./pdas.js";
+/**
+ * SDK surface for the v0.6 protocol take-rate.
+ *
+ * The Job program owns one Config PDA (seeds = ["config"]) that holds:
+ *   - authority: Pubkey that can update the rate, hand off authority,
+ *     and withdraw from the Treasury.
+ *   - take_rate_bps: u16 ∈ [0, MAX_TAKE_RATE_BPS] (5%). Applied on
+ *     every Provider-winning settlement (accept_work +
+ *     submit_verdict[winner=Provider]). Refund paths (reclaim_escrow,
+ *     submit_verdict[winner=Client]) pay no fee.
+ *
+ * Treasury accounting is per-mint. Each accepted bond mint requires a
+ * Treasury ATA owned by the Config PDA before the corresponding Job
+ * can settle on the Provider side. The SDK exposes
+ * `getTreasuryTokenAccount` so callers can derive + `createIdempotent`
+ * the ATA in their own setup flow.
+ *
+ * Encoding follows the same hand-rolled Borsh path as the rest of the
+ * SDK (see `codec.ts`) so there is no IDL dependency.
+ */
+const SPL_TOKEN_PROGRAM_ID = new PublicKey("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");
+function encodeU16(value) {
+    const buf = Buffer.alloc(2);
+    buf.writeUInt16LE(value & 0xffff);
+    return buf;
+}
+function encodePubkey(value) {
+    return Buffer.from(value.toBytes());
+}
+/** Compute fee from a Provider payout, matching the on-chain math:
+ * `floor(amount * bps / 10_000)`. JS bigint avoids the u64 → u128 cast
+ * the program does, but the result is identical because we floor. */
+export function computeTakeRateFee(amount, bps) {
+    if (bps === 0)
+        return 0n;
+    if (bps < 0 || bps > MAX_TAKE_RATE_BPS) {
+        throw new Error(`take rate ${bps} bps out of range [0, ${MAX_TAKE_RATE_BPS}]`);
+    }
+    return (amount * BigInt(bps)) / BigInt(FEE_DENOMINATOR_BPS);
+}
+/** Treasury ATA for `bondMint`, owned by the Config PDA. Must be
+ * pre-initialized (via `createAssociatedTokenAccountIdempotent`) before
+ * any Job using `bondMint` can settle on the Provider side. */
+export function getTreasuryTokenAccount(bondMint) {
+    const [configPda] = findSacpConfigPda();
+    return getAssociatedTokenAddressSync(bondMint, configPda, true);
+}
+export function buildInitConfigIx(params) {
+    if (params.takeRateBps < 0 || params.takeRateBps > MAX_TAKE_RATE_BPS) {
+        throw new Error(`take rate ${params.takeRateBps} bps out of range [0, ${MAX_TAKE_RATE_BPS}]`);
+    }
+    const [configPda] = findSacpConfigPda();
+    const data = encodeInstruction("init_config", encodeU16(params.takeRateBps), encodePubkey(params.authority));
+    return new TransactionInstruction({
+        programId: SACP_PROGRAM_ID,
+        keys: [
+            { pubkey: params.payer, isSigner: true, isWritable: true },
+            { pubkey: configPda, isSigner: false, isWritable: true },
+            { pubkey: SystemProgram.programId, isSigner: false, isWritable: false },
+        ],
+        data,
+    });
+}
+export function buildUpdateTakeRateIx(params) {
+    if (params.newBps < 0 || params.newBps > MAX_TAKE_RATE_BPS) {
+        throw new Error(`take rate ${params.newBps} bps out of range [0, ${MAX_TAKE_RATE_BPS}]`);
+    }
+    const [configPda] = findSacpConfigPda();
+    const data = encodeInstruction("update_take_rate", encodeU16(params.newBps));
+    return new TransactionInstruction({
+        programId: SACP_PROGRAM_ID,
+        keys: [
+            { pubkey: params.authority, isSigner: true, isWritable: false },
+            { pubkey: configPda, isSigner: false, isWritable: true },
+        ],
+        data,
+    });
+}
+export function buildUpdateValidatorShareIx(params) {
+    if (params.newBps < 0 || params.newBps > MAX_VALIDATOR_SHARE_BPS) {
+        throw new Error(`validator share ${params.newBps} bps out of range [0, ${MAX_VALIDATOR_SHARE_BPS}]`);
+    }
+    const [configPda] = findSacpConfigPda();
+    const data = encodeInstruction("update_validator_share", encodeU16(params.newBps));
+    return new TransactionInstruction({
+        programId: SACP_PROGRAM_ID,
+        keys: [
+            { pubkey: params.authority, isSigner: true, isWritable: false },
+            { pubkey: configPda, isSigner: false, isWritable: true },
+        ],
+        data,
+    });
+}
+export function buildSetConfigAuthorityIx(params) {
+    const [configPda] = findSacpConfigPda();
+    const data = encodeInstruction("set_config_authority", encodePubkey(params.newAuthority));
+    return new TransactionInstruction({
+        programId: SACP_PROGRAM_ID,
+        keys: [
+            { pubkey: params.authority, isSigner: true, isWritable: false },
+            { pubkey: configPda, isSigner: false, isWritable: true },
+        ],
+        data,
+    });
+}
+export function buildWithdrawTreasuryIx(params) {
+    if (params.amount <= 0n)
+        throw new Error("amount must be > 0");
+    const [configPda] = findSacpConfigPda();
+    const treasuryAta = getTreasuryTokenAccount(params.bondMint);
+    const data = encodeInstruction("withdraw_treasury", encodeU64(params.amount));
+    return new TransactionInstruction({
+        programId: SACP_PROGRAM_ID,
+        keys: [
+            { pubkey: params.authority, isSigner: true, isWritable: false },
+            { pubkey: configPda, isSigner: false, isWritable: false },
+            { pubkey: treasuryAta, isSigner: false, isWritable: true },
+            { pubkey: params.destination, isSigner: false, isWritable: true },
+            { pubkey: SPL_TOKEN_PROGRAM_ID, isSigner: false, isWritable: false },
+        ],
+        data,
+    });
+}
+export async function fetchSacpConfig(connection) {
+    const [configPda] = findSacpConfigPda();
+    const info = await connection.getAccountInfo(configPda, "confirmed");
+    if (!info)
+        return null;
+    const data = info.data;
+    // discriminator(8) | authority(32) | take_rate_bps(2) | validator_share_bps(2) | bump(1)
+    const authority = new PublicKey(data.subarray(8, 40));
+    const takeRateBps = data.readUInt16LE(40);
+    const validatorShareBps = data.readUInt16LE(42);
+    return { authority, takeRateBps, validatorShareBps };
+}
+//# sourceMappingURL=take_rate.js.map

package/dist/take_rate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"take_rate.js","sourceRoot":"","sources":["../src/take_rate.ts"],"names":[],"mappings":"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"}

package/dist/timeout.d.ts

@@ -0,0 +1,35 @@
+import { type FetchedJob } from "./job.js";
+import { SacpClient } from "./runtime.js";
+import type { SacpSigner } from "./signer.js";
+export interface ReclaimWatcherOptions {
+    client: SacpClient;
+    /** Buyer signer. Watcher only reclaims Jobs whose `client` field
+     * matches this pubkey. */
+    signer: SacpSigner;
+    /** Poll interval. Defaults to 30 seconds — Jobs don't usually
+     * expire on the second. */
+    pollIntervalMs?: number;
+    /** Optional safety margin in seconds added to `submit_deadline`
+     * before reclaiming, to allow for clock skew between the user's
+     * box and the cluster. Defaults to 30 s. */
+    graceSecs?: number;
+    /** Fired before each reclaim attempt. Throw to skip this Job (it
+     * stays eligible on the next tick). */
+    beforeReclaim?: (job: FetchedJob) => void | Promise<void>;
+    /** Fired after a successful reclaim tx. */
+    onReclaimed?: (job: FetchedJob, signature: string) => void | Promise<void>;
+    logger?: {
+        info: (m: string) => void;
+        error: (m: string, e?: unknown) => void;
+    };
+}
+export declare class ReclaimWatcher {
+    private readonly opts;
+    private timer;
+    private inFlight;
+    constructor(opts: ReclaimWatcherOptions);
+    start(): Promise<void>;
+    stop(): void;
+    private tick;
+}
+//# sourceMappingURL=timeout.d.ts.map

package/dist/timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../src/timeout.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAc,UAAU,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA0B9C,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,UAAU,CAAC;IACnB;8BAC0B;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB;+BAC2B;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;gDAE4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;2CACuC;IACvC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,2CAA2C;IAC3C,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAC1B,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;KACzC,CAAC;CACH;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAGG;IACxB,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,QAAQ,CAAqB;gBAEzB,IAAI,EAAE,qBAAqB;IAQjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,IAAI,IAAI,IAAI;YAOE,IAAI;CA4BnB"}

package/dist/timeout.js

@@ -0,0 +1,113 @@
+import { SACP_PROGRAM_ID } from "./constants.js";
+import { parseJobFromBuffer, buildReclaimEscrowIx, } from "./job.js";
+import { getAssociatedTokenAddressSync } from "@solana/spl-token";
+/**
+ * v0.9 Phase 5 — Timeout enforcement helper.
+ *
+ * `ReclaimWatcher` is a client-side daemon that scans for `Funded`
+ * Jobs whose client matches the supplied signer and whose
+ * `submit_deadline` has elapsed, then issues `reclaim_escrow` on
+ * each. It exists because forgetting to reclaim is the #1 way a
+ * buyer leaves money sitting in escrow.
+ *
+ * Why client-side, not a program-side crank: `reclaim_escrow`
+ * already gates on `client` signing, so anyone-callable auto-reclaim
+ * would need a program change (Phase 7+). The watcher is the cheap
+ * win that ships today; the program-side crank can replace it later
+ * without breaking this API.
+ *
+ * Offset reused from the watcher module:
+ *   Job discriminator(8) | job_id(8) | client(32) — so the client
+ *   pubkey sits at offset 16.
+ */
+const CLIENT_OFFSET = 16;
+export class ReclaimWatcher {
+    opts;
+    timer = null;
+    inFlight = new Set();
+    constructor(opts) {
+        this.opts = {
+            pollIntervalMs: 30_000,
+            graceSecs: 30,
+            ...opts,
+        };
+    }
+    async start() {
+        if (this.timer)
+            return;
+        await this.tick();
+        this.timer = setInterval(() => void this.tick(), this.opts.pollIntervalMs);
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    async tick() {
+        const { client, signer, graceSecs, beforeReclaim, onReclaimed, logger } = this.opts;
+        try {
+            const expired = await findExpiredJobsForClient(client.connection, signer.publicKey, graceSecs ?? 30);
+            for (const job of expired) {
+                const key = `${job.jobId}`;
+                if (this.inFlight.has(key))
+                    continue;
+                this.inFlight.add(key);
+                try {
+                    if (beforeReclaim)
+                        await beforeReclaim(job);
+                    const sig = await reclaim(client, signer, job);
+                    if (onReclaimed)
+                        await onReclaimed(job, sig);
+                    logger?.info?.(`reclaimed ${job.jobId} (sig ${sig})`);
+                }
+                catch (e) {
+                    logger?.error(`reclaim failed for job ${job.jobId}`, e);
+                }
+                finally {
+                    this.inFlight.delete(key);
+                }
+            }
+        }
+        catch (e) {
+            logger?.error("ReclaimWatcher tick failed", e);
+        }
+    }
+}
+/** Internal: list Funded Jobs whose client matches `actor` and whose
+ * deadline has passed (with `graceSecs` buffer). */
+async function findExpiredJobsForClient(conn, actor, graceSecs) {
+    const accounts = await conn.getProgramAccounts(SACP_PROGRAM_ID, {
+        commitment: "confirmed",
+        filters: [
+            { memcmp: { offset: CLIENT_OFFSET, bytes: actor.toBase58() } },
+        ],
+    });
+    const now = Math.floor(Date.now() / 1000);
+    const out = [];
+    for (const { account } of accounts) {
+        try {
+            const job = parseJobFromBuffer(account.data);
+            if (job.state !== "Funded")
+                continue;
+            const deadline = Number(job.submitDeadline);
+            if (now < deadline + graceSecs)
+                continue;
+            out.push(job);
+        }
+        catch {
+            // Not a Job — skip.
+        }
+    }
+    return out;
+}
+async function reclaim(client, signer, job) {
+    const clientAta = getAssociatedTokenAddressSync(job.bondMint, signer.publicKey);
+    const ix = buildReclaimEscrowIx({
+        client: signer.publicKey,
+        jobId: job.jobId,
+        clientTokenAccount: clientAta,
+    });
+    return signer.sendAndConfirm(client.connection, [ix]);
+}
+//# sourceMappingURL=timeout.js.map

package/dist/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../src/timeout.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,39 @@
+import type { PublicKey } from "@solana/web3.js";
+/**
+ * Job state machine, matching SRFC v0.1 §"Part A — State machine".
+ * Encoded on-chain as a u8 discriminator; the SDK exposes a string
+ * union for ergonomics.
+ */
+export type JobState = "Open" | "Funded" | "Submitted" | "Disputed" | "Settled";
+/** Numeric encoding used by the Anchor program. Mirrors the on-chain enum. */
+export declare const JOB_STATE_NUMERIC: Record<JobState, number>;
+/**
+ * Roles defined by sACP. `evaluator` is optional in v0.1 — if absent,
+ * the Job falls back to client-driven auto-settle on submit timeout.
+ *
+ * Spec note: the evaluator can be either a plain Pubkey (single signer
+ * or multisig PDA) or a Validator PDA from the Part B registry. Both
+ * resolve to a `Pubkey` from the SDK's perspective; the on-chain
+ * verdict path checks whether the signer matches a registered
+ * Validator and gates accordingly.
+ */
+export interface JobRoles {
+    client: PublicKey;
+    provider: PublicKey;
+    evaluator?: PublicKey;
+}
+/** Verdict outcomes recorded on-chain after dispute resolution. */
+export type VerdictWinner = "Client" | "Provider";
+export declare const VERDICT_WINNER_NUMERIC: Record<VerdictWinner, number>;
+/**
+ * Information returned to a caller after `create_job` succeeds. The
+ * Job PDA is deterministic from `(seed prefix, jobId)`, so callers
+ * holding `jobId` can re-derive `jobPda` later without storing it.
+ */
+export interface CreateJobResult {
+    jobId: bigint;
+    jobPda: PublicKey;
+    escrowPda: PublicKey;
+    txSignature: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAEhF,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAMtD,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,mEAAmE;AACnE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;AAElD,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAGhE,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/types.js

@@ -0,0 +1,13 @@
+/** Numeric encoding used by the Anchor program. Mirrors the on-chain enum. */
+export const JOB_STATE_NUMERIC = {
+    Open: 0,
+    Funded: 1,
+    Submitted: 2,
+    Disputed: 3,
+    Settled: 4,
+};
+export const VERDICT_WINNER_NUMERIC = {
+    Client: 0,
+    Provider: 1,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AASA,8EAA8E;AAC9E,MAAM,CAAC,MAAM,iBAAiB,GAA6B;IACzD,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,SAAS,EAAE,CAAC;IACZ,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,CAAC;CACX,CAAC;AAqBF,MAAM,CAAC,MAAM,sBAAsB,GAAkC;IACnE,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,CAAC;CACZ,CAAC"}

package/dist/validation.d.ts

@@ -0,0 +1,133 @@
+import { Connection, PublicKey, TransactionInstruction, type Signer } from "@solana/web3.js";
+import { findBondAuthorityPda, findBondVaultPda, findChallengePda, findValidatorPda } from "./pdas.js";
+import type { VerdictWinner } from "./types.js";
+/**
+ * Permissionless treasury vault bootstrap (one per bond mint).
+ * Anyone can pay rent; the vault is owned by a program PDA so funds
+ * can only be moved by a future governance instruction.
+ */
+export declare function buildInitTreasuryVaultIx(payer: PublicKey, bondMint: PublicKey): {
+    ix: TransactionInstruction;
+    treasuryVaultPda: PublicKey;
+};
+export interface RegisterValidatorParams {
+    authority: PublicKey;
+    /** SPL Token mint pinned to this validator. Can't be changed later. */
+    bondMint: PublicKey;
+    /** Off-chain operator info / SLA URI. */
+    metadataUri: string;
+}
+export interface RegisterValidatorBuildResult {
+    ix: TransactionInstruction;
+    validatorPda: PublicKey;
+    bondAuthorityPda: PublicKey;
+    bondVaultPda: PublicKey;
+}
+export declare function buildRegisterValidatorIx(params: RegisterValidatorParams): RegisterValidatorBuildResult;
+export interface StakeBondParams {
+    authority: PublicKey;
+    amount: bigint;
+    operatorTokenAccount: PublicKey;
+}
+export declare function buildStakeBondIx(params: StakeBondParams): TransactionInstruction;
+export declare function buildAcceptVerdictIx(authority: PublicKey, jobId: bigint, winner: VerdictWinner): TransactionInstruction;
+/**
+ * Full CPI bridge — the Validator PDA calls sacp_job::submit_verdict
+ * directly. The Job must have been created with
+ * `evaluator = validatorPda` for the sacp_job has_one check to pass.
+ *
+ * This is the bond-collateralized verdict path. Unlike
+ * `buildAcceptVerdictIx` (event-only), this one actually moves money:
+ * escrow drains to the chosen winner in the same transaction.
+ */
+export interface IssueVerdictParams {
+    authority: PublicKey;
+    client: PublicKey;
+    provider: PublicKey;
+    jobId: bigint;
+    bondMint: PublicKey;
+    winner: VerdictWinner;
+    clientTokenAccount: PublicKey;
+    providerTokenAccount: PublicKey;
+    /** v0.7+. Validator PDA's off-curve ATA on bondMint. SDK consumers
+     * should derive with
+     * `getAssociatedTokenAddressSync(bondMint, validatorPda, true)`
+     * and call `createAssociatedTokenAccountIdempotent` with
+     * `allowOwnerOffCurve=true` before any settlement. */
+    validatorTokenAccount: PublicKey;
+}
+export declare function buildIssueVerdictIx(params: IssueVerdictParams): TransactionInstruction;
+export interface ChallengeVerdictParams {
+    challenger: PublicKey;
+    validatorAuthority: PublicKey;
+    jobId: bigint;
+    evidenceUri: string;
+}
+export declare function buildChallengeVerdictIx(params: ChallengeVerdictParams): {
+    ix: TransactionInstruction;
+    challengePda: PublicKey;
+};
+export interface ResolveChallengeParams {
+    authority: PublicKey;
+    validatorAuthority: PublicKey;
+    /** The bond mint pinned at register_validator time. */
+    bondMint: PublicKey;
+    jobId: bigint;
+    slash: boolean;
+    /** Required when slash=true; ignored otherwise. */
+    challengerTokenAccount: PublicKey;
+}
+export declare function buildResolveChallengeIx(params: ResolveChallengeParams): TransactionInstruction;
+export declare function buildInitResolverConfigIx(params: {
+    payer: PublicKey;
+    authority: PublicKey;
+}): TransactionInstruction;
+export declare function buildSetResolverAuthorityIx(params: {
+    authority: PublicKey;
+    newAuthority: PublicKey;
+}): TransactionInstruction;
+export interface FetchedResolverConfig {
+    authority: PublicKey;
+}
+export declare function fetchResolverConfig(connection: Connection): Promise<FetchedResolverConfig | null>;
+export interface WithdrawBondParams {
+    authority: PublicKey;
+    amount: bigint;
+    operatorTokenAccount: PublicKey;
+}
+export declare function buildWithdrawBondIx(params: WithdrawBondParams): TransactionInstruction;
+export declare function registerValidator(connection: Connection, operator: Signer, params: {
+    bondMint: PublicKey;
+    metadataUri: string;
+}): Promise<{
+    validatorPda: PublicKey;
+    bondVaultPda: PublicKey;
+    txSignature: string;
+}>;
+export interface FetchedValidator {
+    authority: PublicKey;
+    metadataUri: string;
+    bondMint: PublicKey;
+    bondAmount: bigint;
+    slashCount: number;
+    activeChallenges: number;
+    registeredAt: bigint;
+    /** v0.9 Phase 7 reputation counters. Defaults to 0 on pre-v0.9
+     * Validator accounts (which serialize shorter, so the parse stops
+     * before these fields and we fill in 0). */
+    successfulSettles: number;
+    failedChallenges: number;
+    wonChallenges: number;
+}
+export declare function fetchValidator(connection: Connection, authority: PublicKey): Promise<FetchedValidator | null>;
+export interface FetchedChallenge {
+    jobId: bigint;
+    challenger: PublicKey;
+    validator: PublicKey;
+    evidenceUri: string;
+    filedAt: bigint;
+    resolved: boolean;
+}
+export declare function fetchChallenge(connection: Connection, jobId: bigint): Promise<FetchedChallenge | null>;
+export { findBondAuthorityPda, findBondVaultPda, findChallengePda, findValidatorPda, };
+//# sourceMappingURL=validation.d.ts.map