@telaro/sacp 1.0.0

package/dist/constants.js

@@ -0,0 +1,50 @@
+import { PublicKey } from "@solana/web3.js";
+/**
+ * sACP program IDs.
+ *
+ * v0.1 deployments live on Solana devnet. Mainnet program IDs will
+ * be added at v1.0; the SDK is version-locked, so a v0.1 SDK only
+ * talks to a v0.1 deployment.
+ *
+ * Deployed: 2026-06-04, slot 467078075 (job) / 467078115 (validation).
+ */
+export const SACP_PROGRAM_ID = new PublicKey("8WAQhJJUnPqiKoJ35dNMSbRWNJsdRqu1f7uVqMwLHZuF");
+export const SACP_VALIDATION_PROGRAM_ID = new PublicKey("GbWzXwirzzed3WjshJaMat9hiWgVSiPR8tAUj4oJnfMC");
+/** Job state machine seed namespace — keeps PDAs cleanly separated. */
+export const JOB_SEED_PREFIX = "job";
+export const ESCROW_SEED_PREFIX = "escrow";
+export const ESCROW_VAULT_SEED_PREFIX = "vault";
+export const SUBMISSION_SEED_PREFIX = "submission";
+export const VERDICT_SEED_PREFIX = "verdict";
+export const CONFIG_SEED_PREFIX = "config";
+export const OFFERING_SEED_PREFIX = "offering";
+export const NEGOTIATION_SEED_PREFIX = "negotiation";
+/** Validation registry seed namespace. */
+export const VALIDATOR_SEED_PREFIX = "validator";
+export const BOND_SEED_PREFIX = "bond";
+export const BOND_AUTHORITY_SEED_PREFIX = "bond_authority";
+export const BOND_VAULT_SEED_PREFIX = "bond_vault";
+export const CHALLENGE_SEED_PREFIX = "challenge";
+export const TREASURY_AUTHORITY_SEED_PREFIX = "treasury_authority";
+export const TREASURY_VAULT_SEED_PREFIX = "treasury_vault";
+export const RESOLVER_CONFIG_SEED_PREFIX = "resolver_config";
+/**
+ * Default windows (seconds) baked into v0.1. These can be overridden
+ * per-job at `create_job` time; the constants are the protocol-level
+ * defaults that match the spec.
+ */
+export const DEFAULT_SUBMIT_WINDOW_SECS = 24 * 60 * 60;
+export const DEFAULT_ACCEPT_WINDOW_SECS = 48 * 60 * 60;
+export const DEFAULT_DISPUTE_WINDOW_SECS = 7 * 24 * 60 * 60;
+export const DEFAULT_CHALLENGE_WINDOW_SECS = 48 * 60 * 60;
+/** Slash distribution constants (basis points). */
+export const SLASH_TO_CHALLENGER_BPS = 7_000;
+export const SLASH_TO_TREASURY_BPS = 3_000;
+/** Protocol take-rate constants. Program-enforced cap; the authority
+ * can choose any value in [0, MAX_TAKE_RATE_BPS]. */
+export const FEE_DENOMINATOR_BPS = 10_000;
+export const MAX_TAKE_RATE_BPS = 500;
+/** Maximum fraction of the protocol fee routable to the evaluator
+ * (v0.7+). 10_000 bps = 100% of the fee. */
+export const MAX_VALIDATOR_SHARE_BPS = 10_000;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,SAAS,CAC1C,8CAA8C,CAC/C,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,SAAS,CACrD,8CAA8C,CAC/C,CAAC;AAEF,uEAAuE;AACvE,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAC3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAChD,MAAM,CAAC,MAAM,sBAAsB,GAAG,YAAY,CAAC;AACnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAC7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAC3C,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAC/C,MAAM,CAAC,MAAM,uBAAuB,GAAG,aAAa,CAAC;AAErD,0CAA0C;AAC1C,MAAM,CAAC,MAAM,qBAAqB,GAAG,WAAW,CAAC;AACjD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AACvC,MAAM,CAAC,MAAM,0BAA0B,GAAG,gBAAgB,CAAC;AAC3D,MAAM,CAAC,MAAM,sBAAsB,GAAG,YAAY,CAAC;AACnD,MAAM,CAAC,MAAM,qBAAqB,GAAG,WAAW,CAAC;AACjD,MAAM,CAAC,MAAM,8BAA8B,GAAG,oBAAoB,CAAC;AACnE,MAAM,CAAC,MAAM,0BAA0B,GAAG,gBAAgB,CAAC;AAC3D,MAAM,CAAC,MAAM,2BAA2B,GAAG,iBAAiB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACvD,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACvD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAC5D,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAE1D,mDAAmD;AACnD,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAE3C;qDACqD;AACrD,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC;4CAC4C;AAC5C,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC"}

package/dist/dispatcher.d.ts

@@ -0,0 +1,87 @@
+import { Connection, PublicKey } from "@solana/web3.js";
+/**
+ * v0.9 — Webhook event dispatcher.
+ *
+ * `WebhookDispatcher` subscribes to the sACP program's logs via the
+ * standard Solana `logsSubscribe` RPC and re-emits each Anchor `emit!`
+ * as an HTTP POST to one or more endpoints. Each request carries an
+ * HMAC-SHA256 signature in the `X-Sacp-Signature` header so receivers
+ * can verify authenticity without trusting the network path.
+ *
+ * Header format (Stripe-style):
+ *   X-Sacp-Signature: t=<unix_ts>,v1=<hex_hmac>
+ *   v1 = hex(HMAC-SHA256(secret, "<unix_ts>." + raw_body))
+ *
+ * The dispatcher is a thin worker — it doesn't parse the Anchor event
+ * payload, it ships the raw log line + program id. Receivers decode
+ * the discriminator themselves with `@coral-xyz/anchor` or matching
+ * borsh structs. Keeping it dumb here means new events (v0.9+ adds
+ * Offering* events) don't require a dispatcher update.
+ */
+export type SacpEventName = "JobCreated" | "JobFunded" | "WorkSubmitted" | "JobDisputed" | "JobSettled" | "VerdictRecorded" | "SettlementPublished" | "FeeAccrued" | "ValidatorFeeAccrued";
+export interface WebhookEndpoint {
+    url: string;
+    /** HMAC-SHA256 shared secret. Treat as a credential — rotate by
+     * deploying a new endpoint with a fresh secret, then deleting the
+     * old one once consumers are migrated. */
+    hmacSecret: string;
+    /** Optional allow-list. When set, only these event names are
+     * delivered to this endpoint. Defaults to "all sACP events". */
+    events?: SacpEventName[];
+    /** Custom headers (e.g. for partner-specific routing). */
+    extraHeaders?: Record<string, string>;
+    /** Override the default 10 s request timeout. */
+    timeoutMs?: number;
+}
+export interface WebhookDispatcherOptions {
+    connection: Connection;
+    endpoints: WebhookEndpoint[];
+    /** Defaults to the sACP job program. Override only when watching a
+     * sibling program (sacp_validation, future sacp_offering). */
+    programId?: PublicKey;
+    /** Defaults to 3 retries with exponential backoff (1s, 2s, 4s). */
+    retryStrategy?: {
+        maxAttempts: number;
+        baseDelayMs: number;
+    };
+    logger?: {
+        info: (m: string) => void;
+        error: (m: string, e?: unknown) => void;
+    };
+    /** Inject a fetch impl for tests / non-Node environments. Defaults
+     * to the global `fetch`. */
+    fetchImpl?: typeof fetch;
+}
+interface RawEvent {
+    programLogs: string[];
+    signature: string;
+    slot: number;
+    timestamp: number;
+}
+/**
+ * Sign a payload with the standard X-Sacp-Signature scheme. Exported
+ * so receivers can verify symmetrically.
+ */
+export declare function signWebhookBody(body: string, secret: string, timestamp?: number): {
+    header: string;
+    timestamp: number;
+};
+/**
+ * Verify an incoming sACP webhook. Returns true iff the signature
+ * matches the body within `toleranceSecs` of the current clock.
+ * Receivers should reject otherwise (replay protection).
+ */
+export declare function verifyWebhookSignature(body: string, header: string, secret: string, toleranceSecs?: number): boolean;
+export declare class WebhookDispatcher {
+    private readonly opts;
+    private subscriptionId;
+    constructor(opts: WebhookDispatcherOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /** Manual dispatch — for tests or when feeding logs from a backfill. */
+    dispatch(event: RawEvent): Promise<void>;
+    private handle;
+    private deliver;
+}
+export {};
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAWxD;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,WAAW,GACX,eAAe,GACf,aAAa,GACb,YAAY,GACZ,iBAAiB,GACjB,qBAAqB,GACrB,YAAY,GACZ,qBAAqB,CAAC;AAE1B,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ;;8CAE0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB;oEACgE;IAChE,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B;kEAC8D;IAC9D,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,mEAAmE;IACnE,aAAa,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,CAAC;IAChF;gCAC4B;IAC5B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,UAAU,QAAQ;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,MAAsC,GAChD;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAGvC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,aAAa,GAAE,MAAY,GAC1B,OAAO,CAoBT;AAwCD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAInB;IACF,OAAO,CAAC,cAAc,CAAuB;gBAEjC,IAAI,EAAE,wBAAwB;IAYpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,wEAAwE;IAClE,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;YAIhC,MAAM;YAeN,OAAO;CAuDtB"}

package/dist/dispatcher.js

@@ -0,0 +1,175 @@
+import { hmac } from "@noble/hashes/hmac";
+import { sha256 } from "@noble/hashes/sha256";
+import { bytesToHex, randomBytes } from "@noble/hashes/utils";
+import { SACP_PROGRAM_ID } from "./constants.js";
+/** Pure-JS HMAC-SHA256 → hex. Works in both Node and the browser
+ * (no `node:crypto` dependency). */
+function hmacHex(secret, message) {
+    return bytesToHex(hmac(sha256, new TextEncoder().encode(secret), new TextEncoder().encode(message)));
+}
+/**
+ * Sign a payload with the standard X-Sacp-Signature scheme. Exported
+ * so receivers can verify symmetrically.
+ */
+export function signWebhookBody(body, secret, timestamp = Math.floor(Date.now() / 1000)) {
+    const sig = hmacHex(secret, `${timestamp}.${body}`);
+    return { header: `t=${timestamp},v1=${sig}`, timestamp };
+}
+/**
+ * Verify an incoming sACP webhook. Returns true iff the signature
+ * matches the body within `toleranceSecs` of the current clock.
+ * Receivers should reject otherwise (replay protection).
+ */
+export function verifyWebhookSignature(body, header, secret, toleranceSecs = 300) {
+    const parts = Object.fromEntries(header.split(",").map((kv) => {
+        const [k, v] = kv.split("=");
+        return [k?.trim(), v?.trim()];
+    }));
+    const t = Number(parts["t"]);
+    const v1 = parts["v1"];
+    if (!t || !v1)
+        return false;
+    const now = Math.floor(Date.now() / 1000);
+    if (Math.abs(now - t) > toleranceSecs)
+        return false;
+    const expected = hmacHex(secret, `${t}.${body}`);
+    // Constant-time compare.
+    if (expected.length !== v1.length)
+        return false;
+    let diff = 0;
+    for (let i = 0; i < expected.length; i++) {
+        diff |= expected.charCodeAt(i) ^ v1.charCodeAt(i);
+    }
+    return diff === 0;
+}
+/** Extract the Anchor event name from a single log line, if present.
+ * Anchor emits events as `Program data: <base64>` after a `Program
+ * log: Instruction: <name>` separator. The event name itself doesn't
+ * appear on chain; receivers decode the discriminator. We surface a
+ * best-effort name by sniffing the preceding `Instruction:` line. */
+function sniffEventName(logs) {
+    // The dispatcher exposes the raw logs; callers do the heavy
+    // lifting. We just return the instruction name as a coarse filter
+    // so endpoints can opt out cheaply.
+    for (let i = logs.length - 1; i >= 0; i--) {
+        const m = logs[i]?.match(/Program log: Instruction: (\w+)/);
+        if (m) {
+            const ix = m[1];
+            switch (ix) {
+                case "CreateJob":
+                    return "JobCreated";
+                case "FundJob":
+                    return "JobFunded";
+                case "SubmitWork":
+                    return "WorkSubmitted";
+                case "DisputeWork":
+                    return "JobDisputed";
+                case "AcceptWork":
+                case "SubmitVerdict":
+                case "ReclaimEscrow":
+                    return "JobSettled";
+                case "RecordVerdict":
+                    return "VerdictRecorded";
+                case "PublishSettlementVaa":
+                    return "SettlementPublished";
+                default:
+                    return "unknown";
+            }
+        }
+    }
+    return "unknown";
+}
+export class WebhookDispatcher {
+    opts;
+    subscriptionId = null;
+    constructor(opts) {
+        this.opts = {
+            programId: opts.programId ?? SACP_PROGRAM_ID,
+            retryStrategy: opts.retryStrategy ?? {
+                maxAttempts: 3,
+                baseDelayMs: 1_000,
+            },
+            fetchImpl: opts.fetchImpl ?? fetch,
+            ...opts,
+        };
+    }
+    async start() {
+        if (this.subscriptionId !== null)
+            return;
+        this.subscriptionId = this.opts.connection.onLogs(this.opts.programId, (logs, ctx) => {
+            void this.handle({
+                programLogs: logs.logs,
+                signature: logs.signature,
+                slot: ctx.slot,
+                timestamp: Math.floor(Date.now() / 1000),
+            });
+        }, "confirmed");
+    }
+    async stop() {
+        if (this.subscriptionId !== null) {
+            await this.opts.connection.removeOnLogsListener(this.subscriptionId);
+            this.subscriptionId = null;
+        }
+    }
+    /** Manual dispatch — for tests or when feeding logs from a backfill. */
+    async dispatch(event) {
+        return this.handle(event);
+    }
+    async handle(event) {
+        const name = sniffEventName(event.programLogs);
+        const body = JSON.stringify({
+            eventId: `${event.signature}:${event.slot}`,
+            event: name,
+            signature: event.signature,
+            slot: event.slot,
+            timestamp: event.timestamp,
+            logs: event.programLogs,
+        });
+        await Promise.all(this.opts.endpoints.map((ep) => this.deliver(ep, name, body)));
+    }
+    async deliver(ep, name, body) {
+        if (ep.events && !ep.events.includes(name))
+            return;
+        const { maxAttempts, baseDelayMs } = this.opts.retryStrategy;
+        const bodyBytes = new TextEncoder().encode(body);
+        const saltBytes = randomBytes(8);
+        const idemInput = new Uint8Array(bodyBytes.length + saltBytes.length);
+        idemInput.set(bodyBytes, 0);
+        idemInput.set(saltBytes, bodyBytes.length);
+        const idem = bytesToHex(sha256(idemInput)).slice(0, 24);
+        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+            const { header } = signWebhookBody(body, ep.hmacSecret);
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), ep.timeoutMs ?? 10_000);
+            try {
+                const res = await this.opts.fetchImpl(ep.url, {
+                    method: "POST",
+                    headers: {
+                        "content-type": "application/json",
+                        "x-sacp-signature": header,
+                        "x-sacp-idempotency-key": idem,
+                        ...(ep.extraHeaders ?? {}),
+                    },
+                    body,
+                    signal: controller.signal,
+                });
+                clearTimeout(timeoutId);
+                if (res.ok)
+                    return;
+                if (res.status >= 400 && res.status < 500) {
+                    // 4xx: receiver rejected — don't retry.
+                    this.opts.logger?.error(`webhook ${ep.url} returned ${res.status}; not retrying`);
+                    return;
+                }
+            }
+            catch (e) {
+                clearTimeout(timeoutId);
+                this.opts.logger?.error(`webhook attempt ${attempt}/${maxAttempts} failed for ${ep.url}`, e);
+            }
+            if (attempt < maxAttempts) {
+                await new Promise((r) => setTimeout(r, baseDelayMs * Math.pow(2, attempt - 1)));
+            }
+        }
+    }
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/dispatcher.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,93 @@
+import { PublicKey } from "@solana/web3.js";
+/**
+ * Anchor-event decoder for sACP.
+ *
+ * Anchor 0.30 emits events as `Program data: <base64>` lines in the
+ * program log. The base64 decodes to `[8-byte discriminator | borsh
+ * payload]`. The discriminator is `sha256("event:<EventName>")[..8]`.
+ *
+ * This module gives consumers a way to consume program logs (from
+ * `connection.onLogs` subscriptions) without depending on a generated
+ * IDL. We pre-compute every discriminator at module load.
+ *
+ * Usage:
+ *   const events = parseSacpEvents(log.logs);
+ *   for (const e of events) {
+ *     if (e.type === "JobSettled") { ... }
+ *   }
+ */
+export type SacpEvent = {
+    type: "JobCreated";
+    jobId: bigint;
+    client: PublicKey;
+    provider: PublicKey;
+    evaluator: PublicKey;
+    amount: bigint;
+} | {
+    type: "JobFunded";
+    jobId: bigint;
+    amount: bigint;
+} | {
+    type: "WorkSubmitted";
+    jobId: bigint;
+    provider: PublicKey;
+} | {
+    type: "JobDisputed";
+    jobId: bigint;
+    reasonHash: Uint8Array;
+} | {
+    type: "JobSettled";
+    jobId: bigint;
+    winner: number;
+} | {
+    type: "VerdictRecorded";
+    jobId: bigint;
+    winner: number;
+    evaluator: PublicKey;
+} | {
+    type: "ValidatorRegistered";
+    authority: PublicKey;
+    metadataUri: string;
+    bondMint: PublicKey;
+} | {
+    type: "BondStaked";
+    authority: PublicKey;
+    amount: bigint;
+    total: bigint;
+} | {
+    type: "VerdictAccepted";
+    authority: PublicKey;
+    jobId: bigint;
+    winner: number;
+} | {
+    type: "ChallengeFiled";
+    jobId: bigint;
+    challenger: PublicKey;
+    validator: PublicKey;
+} | {
+    type: "ValidatorSlashed";
+    authority: PublicKey;
+    jobId: bigint;
+    amount: bigint;
+    toChallenger: bigint;
+    toTreasury: bigint;
+} | {
+    type: "ChallengeDismissed";
+    jobId: bigint;
+} | {
+    type: "BondWithdrawn";
+    authority: PublicKey;
+    amount: bigint;
+};
+/**
+ * Parse a single Anchor "Program data:" log line. Returns null when the
+ * line isn't a known sACP event (caller can ignore).
+ */
+export declare function parseSacpEventLine(line: string): SacpEvent | null;
+/**
+ * Sweep a whole `logs` array (from `Logs` callback or
+ * `getTransaction().meta.logMessages`) and return every decoded sACP
+ * event in order.
+ */
+export declare function parseSacpEvents(logs: readonly string[]): SacpEvent[];
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnH;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,GAChF;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,SAAS,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,GAC/F;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChF;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,GACtF;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,SAAS,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC3H;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,SAAS,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAyGpE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAkBjE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAAE,CAOpE"}

package/dist/events.js

@@ -0,0 +1,142 @@
+import { sha256 } from "@noble/hashes/sha256";
+import { PublicKey } from "@solana/web3.js";
+function eventDiscriminator(name) {
+    const digest = sha256(new TextEncoder().encode(`event:${name}`));
+    return Buffer.from(digest.subarray(0, 8));
+}
+const DISCRIMINATORS = [
+    "JobCreated",
+    "JobFunded",
+    "WorkSubmitted",
+    "JobDisputed",
+    "JobSettled",
+    "VerdictRecorded",
+    "ValidatorRegistered",
+    "BondStaked",
+    "VerdictAccepted",
+    "ChallengeFiled",
+    "ValidatorSlashed",
+    "ChallengeDismissed",
+    "BondWithdrawn",
+].map((type) => ({ type: type, bytes: eventDiscriminator(type) }));
+function eq(a, b) {
+    return a.length === b.length && a.compare(b) === 0;
+}
+class Reader {
+    buf;
+    offset = 0;
+    constructor(buf) {
+        this.buf = buf;
+    }
+    u64() {
+        const v = this.buf.readBigUInt64LE(this.offset);
+        this.offset += 8;
+        return v;
+    }
+    u8() {
+        const v = this.buf.readUInt8(this.offset);
+        this.offset += 1;
+        return v;
+    }
+    pubkey() {
+        const slice = this.buf.subarray(this.offset, this.offset + 32);
+        this.offset += 32;
+        return new PublicKey(slice);
+    }
+    string() {
+        const len = this.buf.readUInt32LE(this.offset);
+        this.offset += 4;
+        const s = this.buf.subarray(this.offset, this.offset + len).toString("utf8");
+        this.offset += len;
+        return s;
+    }
+    bytes32() {
+        const slice = this.buf.subarray(this.offset, this.offset + 32);
+        this.offset += 32;
+        return new Uint8Array(slice);
+    }
+}
+function decodePayload(type, payload) {
+    const r = new Reader(payload);
+    try {
+        switch (type) {
+            case "JobCreated":
+                return { type, jobId: r.u64(), client: r.pubkey(), provider: r.pubkey(), evaluator: r.pubkey(), amount: r.u64() };
+            case "JobFunded":
+                return { type, jobId: r.u64(), amount: r.u64() };
+            case "WorkSubmitted":
+                return { type, jobId: r.u64(), provider: r.pubkey() };
+            case "JobDisputed":
+                return { type, jobId: r.u64(), reasonHash: r.bytes32() };
+            case "JobSettled":
+                return { type, jobId: r.u64(), winner: r.u8() };
+            case "VerdictRecorded":
+                return { type, jobId: r.u64(), winner: r.u8(), evaluator: r.pubkey() };
+            case "ValidatorRegistered":
+                return { type, authority: r.pubkey(), metadataUri: r.string(), bondMint: r.pubkey() };
+            case "BondStaked":
+                return { type, authority: r.pubkey(), amount: r.u64(), total: r.u64() };
+            case "VerdictAccepted":
+                return { type, authority: r.pubkey(), jobId: r.u64(), winner: r.u8() };
+            case "ChallengeFiled":
+                return { type, jobId: r.u64(), challenger: r.pubkey(), validator: r.pubkey() };
+            case "ValidatorSlashed":
+                return {
+                    type,
+                    authority: r.pubkey(),
+                    jobId: r.u64(),
+                    amount: r.u64(),
+                    toChallenger: r.u64(),
+                    toTreasury: r.u64(),
+                };
+            case "ChallengeDismissed":
+                return { type, jobId: r.u64() };
+            case "BondWithdrawn":
+                return { type, authority: r.pubkey(), amount: r.u64() };
+        }
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse a single Anchor "Program data:" log line. Returns null when the
+ * line isn't a known sACP event (caller can ignore).
+ */
+export function parseSacpEventLine(line) {
+    const idx = line.indexOf("Program data: ");
+    if (idx === -1)
+        return null;
+    const b64 = line.slice(idx + "Program data: ".length).trim();
+    let buf;
+    try {
+        buf = Buffer.from(b64, "base64");
+    }
+    catch {
+        return null;
+    }
+    if (buf.length < 8)
+        return null;
+    const head = buf.subarray(0, 8);
+    for (const d of DISCRIMINATORS) {
+        if (eq(head, d.bytes)) {
+            return decodePayload(d.type, buf.subarray(8));
+        }
+    }
+    return null;
+}
+/**
+ * Sweep a whole `logs` array (from `Logs` callback or
+ * `getTransaction().meta.logMessages`) and return every decoded sACP
+ * event in order.
+ */
+export function parseSacpEvents(logs) {
+    const out = [];
+    for (const line of logs) {
+        const e = parseSacpEventLine(line);
+        if (e)
+            out.push(e);
+    }
+    return out;
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @telaro/sacp — Solana Agent Commerce Protocol SDK
+ *
+ * Reference implementation of the sACP v0.1 specification. See
+ * `docs/srfc/sacp-v0.1.md` for the full protocol document.
+ *
+ * The SDK is split into two namespaces matching the two halves of the
+ * spec:
+ *
+ * - `./job` — Part A. Job lifecycle (Open → Funded → Submitted →
+ *   Settled / Disputed). Used by Clients to create jobs, Providers to
+ *   submit work, Evaluators to settle disputes.
+ * - `./validation` — Part B. Bonded validator registry. Used by
+ *   validator operators to stake bond and act as Evaluators across
+ *   many Jobs.
+ *
+ * The two parts share the constants and PDA helpers exported from this
+ * top-level entry point.
+ */
+export * as job from "./job.js";
+export * as validation from "./validation.js";
+export * as events from "./events.js";
+export * as wormhole from "./wormhole.js";
+export * as lst from "./lst.js";
+export * as takeRate from "./take_rate.js";
+export * as offering from "./offering.js";
+export * as negotiation from "./negotiation.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";
+export { WebhookDispatcher, signWebhookBody, verifyWebhookSignature, type WebhookEndpoint, type WebhookDispatcherOptions, type SacpEventName, } from "./dispatcher.js";
+export { ReclaimWatcher, type ReclaimWatcherOptions, } from "./timeout.js";
+export { NegotiationNamespace, NegotiationSession, type NegotiationSessionAction, } from "./runtime.js";
+export type { FetchedNegotiation, NegotiationState, } from "./negotiation.js";
+export { SACP_PROGRAM_ID, SACP_VALIDATION_PROGRAM_ID, FEE_DENOMINATOR_BPS, MAX_TAKE_RATE_BPS, MAX_VALIDATOR_SHARE_BPS, } from "./constants.js";
+export { findJobPda, findEscrowPda, findEscrowVaultPda, findSubmissionPda, findVerdictPda, findValidatorPda, findBondPda, findChallengePda, findSacpConfigPda, findResolverConfigPda, findOfferingPda, findNegotiationPda, } from "./pdas.js";
+export type { JobState, JobRoles, VerdictWinner } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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;AAGhD,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"}