@telaro/sacp 1.0.0

package/dist/index.js

@@ -0,0 +1,39 @@
+/**
+ * @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";
+// v0.8 runtime layer — high-level client + session.
+export { SacpClient, JobSession, } from "./runtime.js";
+export { LocalSigner, RemoteSigner, WalletAdapterSigner, } from "./signer.js";
+// v0.9 runtime watchers + webhook dispatcher.
+export { ProviderRuntime, EvaluatorRuntime, } from "./watcher.js";
+export { WebhookDispatcher, signWebhookBody, verifyWebhookSignature, } from "./dispatcher.js";
+export { ReclaimWatcher, } from "./timeout.js";
+// v1.0 Phase 8 — Negotiation namespace types.
+export { NegotiationNamespace, NegotiationSession, } from "./runtime.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";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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;AAEhD,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/job.d.ts

@@ -0,0 +1,99 @@
+import { Connection, PublicKey, TransactionInstruction, type Signer } from "@solana/web3.js";
+import { findEscrowPda, findEscrowVaultPda, findJobPda, findSubmissionPda, findVerdictPda } from "./pdas.js";
+import type { CreateJobResult, JobRoles, JobState, VerdictWinner } from "./types.js";
+export interface CreateJobParams {
+    jobId: bigint;
+    roles: Required<JobRoles>;
+    bondMint: PublicKey;
+    amount: bigint;
+    workUri: string;
+    submitWindowSecs?: bigint;
+}
+export interface CreateJobBuildResult {
+    ix: TransactionInstruction;
+    jobPda: PublicKey;
+    escrowPda: PublicKey;
+    escrowVaultPda: PublicKey;
+}
+export declare function buildCreateJobIx(params: CreateJobParams): CreateJobBuildResult;
+export interface FundJobParams {
+    client: PublicKey;
+    jobId: bigint;
+    amount: bigint;
+    clientTokenAccount: PublicKey;
+}
+export declare function buildFundJobIx(params: FundJobParams): TransactionInstruction;
+export declare function buildSubmitWorkIx(provider: PublicKey, jobId: bigint, submissionUri: string): TransactionInstruction;
+export interface AcceptWorkParams {
+    client: PublicKey;
+    provider: PublicKey;
+    jobId: bigint;
+    bondMint: PublicKey;
+    providerTokenAccount: PublicKey;
+}
+export declare function buildAcceptWorkIx(params: AcceptWorkParams): TransactionInstruction;
+export declare function buildDisputeWorkIx(client: PublicKey, jobId: bigint, reasonHash: Uint8Array): TransactionInstruction;
+export interface SubmitVerdictParams {
+    evaluator: PublicKey;
+    client: PublicKey;
+    provider: PublicKey;
+    jobId: bigint;
+    bondMint: PublicKey;
+    winner: VerdictWinner;
+    clientTokenAccount: PublicKey;
+    providerTokenAccount: PublicKey;
+    /** v0.7+. Evaluator's payout ATA — receives the validator-share
+     * slice of the protocol fee when winner=Provider. For non-bonded
+     * evaluators this is `getAssociatedTokenAddressSync(bondMint,
+     * evaluator)`; for bonded validators it's the Validator PDA's
+     * off-curve ATA. */
+    evaluatorTokenAccount: PublicKey;
+}
+export declare function buildSubmitVerdictIx(params: SubmitVerdictParams): TransactionInstruction;
+export interface RecordVerdictParams {
+    payer: PublicKey;
+    jobId: bigint;
+    /** IPFS / HTTPS URI of the verdict rationale. Can be empty string. */
+    evidenceUri: string;
+}
+export declare function buildRecordVerdictIx(params: RecordVerdictParams): {
+    ix: TransactionInstruction;
+    verdictPda: PublicKey;
+};
+export interface FetchedVerdict {
+    jobId: bigint;
+    winner: 0 | 1;
+    evaluator: PublicKey;
+    issuedAt: bigint;
+    evidenceUri: string;
+}
+export declare function fetchVerdict(connection: Connection, jobId: bigint): Promise<FetchedVerdict | null>;
+export interface ReclaimEscrowParams {
+    client: PublicKey;
+    jobId: bigint;
+    clientTokenAccount: PublicKey;
+}
+export declare function buildReclaimEscrowIx(params: ReclaimEscrowParams): TransactionInstruction;
+export declare function createJob(connection: Connection, client: Signer, params: Omit<CreateJobParams, "roles"> & {
+    provider: PublicKey;
+    evaluator: PublicKey;
+}): Promise<CreateJobResult>;
+export interface FetchedJob {
+    jobId: bigint;
+    state: JobState;
+    roles: Required<JobRoles>;
+    bondMint: PublicKey;
+    amount: bigint;
+    workUri: string;
+    createdAt: bigint;
+    submitDeadline: bigint;
+}
+/**
+ * Parse a Job account buffer into the typed shape. Exported so the
+ * v0.8 runtime layer can use it after `getProgramAccounts` returns
+ * raw account data (instead of paying for one round-trip per Job).
+ */
+export declare function parseJobFromBuffer(data: Buffer): FetchedJob;
+export declare function fetchJob(connection: Connection, jobId: bigint): Promise<FetchedJob | null>;
+export { findJobPda, findEscrowPda, findEscrowVaultPda, findSubmissionPda, findVerdictPda, };
+//# sourceMappingURL=job.d.ts.map

package/dist/job.d.ts.map

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

package/dist/job.js

@@ -0,0 +1,297 @@
+import { PublicKey, SystemProgram, SYSVAR_RENT_PUBKEY, Transaction, TransactionInstruction, sendAndConfirmTransaction, } from "@solana/web3.js";
+import { encodeI64, encodeBytes32, encodeInstruction, encodeString, encodeU64, encodeU8, } from "./codec.js";
+import { SACP_PROGRAM_ID } from "./constants.js";
+import { findEscrowPda, findEscrowVaultPda, findJobPda, findSacpConfigPda, findSubmissionPda, findVerdictPda, } from "./pdas.js";
+import { getTreasuryTokenAccount } from "./take_rate.js";
+import { JOB_STATE_NUMERIC, VERDICT_WINNER_NUMERIC } from "./types.js";
+/**
+ * Part A — Job Lifecycle SDK surface (v0.2).
+ *
+ * v0.2 wires real SPL Token escrow:
+ *   - `create_job` initializes an Escrow vault TokenAccount owned by
+ *     an Escrow PDA authority.
+ *   - `fund_job` transfers tokens from Client → vault.
+ *   - `accept_work`, `submit_verdict`, `reclaim_escrow` drain the
+ *     vault to the appropriate party via PDA-signed CPI and close it.
+ *
+ * Wire-level v0.1 SDK is incompatible with the v0.2 program — the
+ * Anchor account orders changed when escrow was introduced. The SDK
+ * is version-pinned to the on-chain program; a v0.1 SDK will fail
+ * with InstructionDidNotDeserialize if called against the v0.2
+ * deployment.
+ */
+const SACP_PROGRAM = SACP_PROGRAM_ID;
+const SPL_TOKEN_PROGRAM_ID = new PublicKey("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");
+const SPL_ASSOCIATED_TOKEN_PROGRAM_ID = new PublicKey("ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL");
+const URI_MAX_BYTES = 256;
+function assertUri(uri, name) {
+    const len = Buffer.byteLength(uri, "utf8");
+    if (len > URI_MAX_BYTES) {
+        throw new Error(`${name} exceeds 256-byte limit (got ${len} bytes)`);
+    }
+}
+export function buildCreateJobIx(params) {
+    assertUri(params.workUri, "workUri");
+    if (params.amount <= 0n)
+        throw new Error("amount must be > 0");
+    const submitWindow = params.submitWindowSecs ?? BigInt(24 * 60 * 60);
+    if (submitWindow <= 0n)
+        throw new Error("submitWindowSecs must be > 0");
+    const [jobPda] = findJobPda(params.jobId);
+    const [escrowPda] = findEscrowPda(params.jobId);
+    const [escrowVaultPda] = findEscrowVaultPda(params.jobId);
+    const data = encodeInstruction("create_job", encodeU64(params.jobId), encodeU64(params.amount), encodeString(params.workUri), encodeI64(submitWindow));
+    const ix = new TransactionInstruction({
+        programId: SACP_PROGRAM,
+        keys: [
+            { pubkey: params.roles.client, isSigner: true, isWritable: true },
+            { pubkey: params.roles.provider, isSigner: false, isWritable: false },
+            { pubkey: params.roles.evaluator, isSigner: false, isWritable: false },
+            { pubkey: params.bondMint, isSigner: false, isWritable: false },
+            { pubkey: jobPda, isSigner: false, isWritable: true },
+            { pubkey: escrowPda, isSigner: false, isWritable: false },
+            { pubkey: escrowVaultPda, isSigner: false, isWritable: true },
+            { pubkey: SPL_TOKEN_PROGRAM_ID, isSigner: false, isWritable: false },
+            { pubkey: SPL_ASSOCIATED_TOKEN_PROGRAM_ID, isSigner: false, isWritable: false },
+            { pubkey: SYSVAR_RENT_PUBKEY, isSigner: false, isWritable: false },
+            { pubkey: SystemProgram.programId, isSigner: false, isWritable: false },
+        ],
+        data,
+    });
+    return { ix, jobPda, escrowPda, escrowVaultPda };
+}
+export function buildFundJobIx(params) {
+    const [jobPda] = findJobPda(params.jobId);
+    const [escrowVaultPda] = findEscrowVaultPda(params.jobId);
+    const data = encodeInstruction("fund_job", encodeU64(params.amount));
+    return new TransactionInstruction({
+        programId: SACP_PROGRAM,
+        keys: [
+            { pubkey: params.client, isSigner: true, isWritable: true },
+            { pubkey: jobPda, isSigner: false, isWritable: true },
+            { pubkey: params.clientTokenAccount, isSigner: false, isWritable: true },
+            { pubkey: escrowVaultPda, isSigner: false, isWritable: true },
+            { pubkey: SPL_TOKEN_PROGRAM_ID, isSigner: false, isWritable: false },
+        ],
+        data,
+    });
+}
+// ─────────────────────────────── submit_work ─────────────────────────
+export function buildSubmitWorkIx(provider, jobId, submissionUri) {
+    assertUri(submissionUri, "submissionUri");
+    const [jobPda] = findJobPda(jobId);
+    const [submissionPda] = findSubmissionPda(jobId);
+    const data = encodeInstruction("submit_work", encodeString(submissionUri));
+    return new TransactionInstruction({
+        programId: SACP_PROGRAM,
+        keys: [
+            { pubkey: provider, isSigner: true, isWritable: true },
+            { pubkey: jobPda, isSigner: false, isWritable: true },
+            { pubkey: submissionPda, isSigner: false, isWritable: true },
+            { pubkey: SystemProgram.programId, isSigner: false, isWritable: false },
+        ],
+        data,
+    });
+}
+export function buildAcceptWorkIx(params) {
+    const [jobPda] = findJobPda(params.jobId);
+    const [escrowPda] = findEscrowPda(params.jobId);
+    const [escrowVaultPda] = findEscrowVaultPda(params.jobId);
+    const [configPda] = findSacpConfigPda();
+    const treasuryAta = getTreasuryTokenAccount(params.bondMint);
+    const data = encodeInstruction("accept_work");
+    return new TransactionInstruction({
+        programId: SACP_PROGRAM,
+        keys: [
+            { pubkey: params.client, isSigner: true, isWritable: true },
+            { pubkey: jobPda, isSigner: false, isWritable: true },
+            { pubkey: params.provider, isSigner: false, isWritable: false },
+            { pubkey: escrowPda, isSigner: false, isWritable: false },
+            { pubkey: escrowVaultPda, isSigner: false, isWritable: true },
+            { pubkey: params.providerTokenAccount, isSigner: false, isWritable: true },
+            { pubkey: configPda, isSigner: false, isWritable: false },
+            { pubkey: treasuryAta, isSigner: false, isWritable: true },
+            { pubkey: SPL_TOKEN_PROGRAM_ID, isSigner: false, isWritable: false },
+        ],
+        data,
+    });
+}
+// ─────────────────────────────── dispute_work ────────────────────────
+export function buildDisputeWorkIx(client, jobId, reasonHash) {
+    const [jobPda] = findJobPda(jobId);
+    const data = encodeInstruction("dispute_work", encodeBytes32(reasonHash));
+    return new TransactionInstruction({
+        programId: SACP_PROGRAM,
+        keys: [
+            { pubkey: client, isSigner: true, isWritable: false },
+            { pubkey: jobPda, isSigner: false, isWritable: true },
+        ],
+        data,
+    });
+}
+export function buildSubmitVerdictIx(params) {
+    const [jobPda] = findJobPda(params.jobId);
+    const [escrowPda] = findEscrowPda(params.jobId);
+    const [escrowVaultPda] = findEscrowVaultPda(params.jobId);
+    const [configPda] = findSacpConfigPda();
+    const treasuryAta = getTreasuryTokenAccount(params.bondMint);
+    const data = encodeInstruction("submit_verdict", encodeU8(VERDICT_WINNER_NUMERIC[params.winner]));
+    return new TransactionInstruction({
+        programId: SACP_PROGRAM,
+        keys: [
+            { pubkey: params.evaluator, isSigner: true, isWritable: true },
+            { pubkey: jobPda, isSigner: false, isWritable: true },
+            { pubkey: params.client, isSigner: false, isWritable: false },
+            { pubkey: params.provider, isSigner: false, isWritable: false },
+            { pubkey: escrowPda, isSigner: false, isWritable: false },
+            { pubkey: escrowVaultPda, isSigner: false, isWritable: true },
+            { pubkey: params.clientTokenAccount, isSigner: false, isWritable: true },
+            { pubkey: params.providerTokenAccount, isSigner: false, isWritable: true },
+            { pubkey: configPda, isSigner: false, isWritable: false },
+            { pubkey: treasuryAta, isSigner: false, isWritable: true },
+            { pubkey: params.evaluatorTokenAccount, isSigner: false, isWritable: true },
+            { pubkey: SPL_TOKEN_PROGRAM_ID, isSigner: false, isWritable: false },
+        ],
+        data,
+    });
+}
+export function buildRecordVerdictIx(params) {
+    const [jobPda] = findJobPda(params.jobId);
+    const [verdictPda] = findVerdictPda(params.jobId);
+    const data = encodeInstruction("record_verdict", encodeString(params.evidenceUri));
+    const ix = new TransactionInstruction({
+        programId: SACP_PROGRAM,
+        keys: [
+            { pubkey: params.payer, isSigner: true, isWritable: true },
+            { pubkey: jobPda, isSigner: false, isWritable: false },
+            { pubkey: verdictPda, isSigner: false, isWritable: true },
+            { pubkey: SystemProgram.programId, isSigner: false, isWritable: false },
+        ],
+        data,
+    });
+    return { ix, verdictPda };
+}
+export async function fetchVerdict(connection, jobId) {
+    const [verdictPda] = findVerdictPda(jobId);
+    const info = await connection.getAccountInfo(verdictPda, "confirmed");
+    if (!info)
+        return null;
+    const data = info.data;
+    let offset = 8;
+    const idRead = data.readBigUInt64LE(offset);
+    offset += 8;
+    const winner = data.readUInt8(offset);
+    offset += 1;
+    const evaluator = new PublicKey(data.subarray(offset, offset + 32));
+    offset += 32;
+    const issuedAt = data.readBigInt64LE(offset);
+    offset += 8;
+    const uriLen = data.readUInt32LE(offset);
+    offset += 4;
+    const evidenceUri = data.subarray(offset, offset + uriLen).toString("utf8");
+    return { jobId: idRead, winner, evaluator, issuedAt, evidenceUri };
+}
+export function buildReclaimEscrowIx(params) {
+    const [jobPda] = findJobPda(params.jobId);
+    const [escrowPda] = findEscrowPda(params.jobId);
+    const [escrowVaultPda] = findEscrowVaultPda(params.jobId);
+    const data = encodeInstruction("reclaim_escrow");
+    return new TransactionInstruction({
+        programId: SACP_PROGRAM,
+        keys: [
+            { pubkey: params.client, isSigner: true, isWritable: true },
+            { pubkey: jobPda, isSigner: false, isWritable: true },
+            { pubkey: escrowPda, isSigner: false, isWritable: false },
+            { pubkey: escrowVaultPda, isSigner: false, isWritable: true },
+            { pubkey: params.clientTokenAccount, isSigner: false, isWritable: true },
+            { pubkey: SPL_TOKEN_PROGRAM_ID, isSigner: false, isWritable: false },
+        ],
+        data,
+    });
+}
+// ─────────────────────────────── convenience ─────────────────────────
+export async function createJob(connection, client, params) {
+    const { ix, jobPda, escrowVaultPda } = buildCreateJobIx({
+        jobId: params.jobId,
+        roles: {
+            client: client.publicKey,
+            provider: params.provider,
+            evaluator: params.evaluator,
+        },
+        bondMint: params.bondMint,
+        amount: params.amount,
+        workUri: params.workUri,
+        submitWindowSecs: params.submitWindowSecs,
+    });
+    const tx = new Transaction().add(ix);
+    const sig = await sendAndConfirmTransaction(connection, tx, [client], {
+        commitment: "confirmed",
+    });
+    return {
+        jobId: params.jobId,
+        jobPda,
+        escrowPda: escrowVaultPda,
+        txSignature: sig,
+    };
+}
+/**
+ * Parse a Job account buffer into the typed shape. Exported so the
+ * v0.8 runtime layer can use it after `getProgramAccounts` returns
+ * raw account data (instead of paying for one round-trip per Job).
+ */
+export function parseJobFromBuffer(data) {
+    let offset = 8;
+    const readU64 = () => {
+        const v = data.readBigUInt64LE(offset);
+        offset += 8;
+        return v;
+    };
+    const readI64 = () => {
+        const v = data.readBigInt64LE(offset);
+        offset += 8;
+        return v;
+    };
+    const readPubkey = () => {
+        const pk = new PublicKey(data.subarray(offset, offset + 32));
+        offset += 32;
+        return pk;
+    };
+    const readString = () => {
+        const len = data.readUInt32LE(offset);
+        offset += 4;
+        const s = data.subarray(offset, offset + len).toString("utf8");
+        offset += len;
+        return s;
+    };
+    const idRead = readU64();
+    const client = readPubkey();
+    const provider = readPubkey();
+    const evaluator = readPubkey();
+    const bondMint = readPubkey();
+    const amount = readU64();
+    const workUri = readString();
+    const stateByte = data.readUInt8(offset);
+    offset += 1;
+    const createdAt = readI64();
+    const submitDeadline = readI64();
+    const stateName = (Object.entries(JOB_STATE_NUMERIC).find(([, v]) => v === stateByte)?.[0] ?? "Open");
+    return {
+        jobId: idRead,
+        state: stateName,
+        roles: { client, provider, evaluator },
+        bondMint,
+        amount,
+        workUri,
+        createdAt,
+        submitDeadline,
+    };
+}
+export async function fetchJob(connection, jobId) {
+    const [jobPda] = findJobPda(jobId);
+    const info = await connection.getAccountInfo(jobPda, "confirmed");
+    if (!info)
+        return null;
+    return parseJobFromBuffer(info.data);
+}
+export { findJobPda, findEscrowPda, findEscrowVaultPda, findSubmissionPda, findVerdictPda, };
+//# sourceMappingURL=job.js.map

package/dist/job.js.map

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

package/dist/lst.d.ts

@@ -0,0 +1,52 @@
+import { PublicKey } from "@solana/web3.js";
+/**
+ * Liquid-staking-token (LST) bond adapter constants.
+ *
+ * No code change in the program is needed to accept an LST as bond —
+ * sACP v0.4 accepts any plain SPL Token mint with no freeze authority,
+ * which all major Solana LSTs satisfy. This file gives integrators a
+ * single, version-pinned source for the canonical LST mints + helpers
+ * to compute "real bond" in SOL terms.
+ *
+ * For each LST we list the mainnet mint and (if known) a devnet
+ * equivalent. Devnet LSTs are usually thin or non-existent, so
+ * integration tests that need a "JitoSOL-shaped" mint should create a
+ * fresh `Mint` with no freeze authority and pretend.
+ */
+export interface LstMintInfo {
+    /** Display name for the LST. */
+    name: string;
+    /** Mainnet mint address. */
+    mainnet: PublicKey;
+    /** Devnet mint address, if the LST has a devnet deployment. */
+    devnet?: PublicKey;
+    /** Decimals (typically 9 for SOL-pegged LSTs). */
+    decimals: number;
+    /**
+     * Brief blurb on the LST's design — used by the SDK's
+     * `formatBondInfo` helper to surface "what is this bond actually
+     * worth?" hints to a UI.
+     */
+    description: string;
+}
+export declare const JITOSOL: LstMintInfo;
+export declare const MSOL: LstMintInfo;
+export declare const BSOL: LstMintInfo;
+/** Convenience lookup by name. */
+export declare const LST_REGISTRY: Record<string, LstMintInfo>;
+/**
+ * Convert a bond amount in LST atomic units to display SOL given a
+ * known LST → SOL exchange rate. The rate is typically fetched off-
+ * chain (e.g. JitoSOL provides a sanctum API) and changes slowly.
+ *
+ * For example: 10_000_000_000 JitoSOL atomic units (= 10 JitoSOL)
+ * at a rate of 1.15 SOL per JitoSOL → 11.5 SOL of effective bond.
+ */
+export declare function lstToSolDisplay(atomicAmount: bigint, lst: LstMintInfo, ratePerLst: number): number;
+/**
+ * Quick check: does the SDK consider this mint a known LST? Used by
+ * the validator detail page in `/explore/sacp` to show a small
+ * "appreciating bond" badge.
+ */
+export declare function isKnownLst(mint: PublicKey): LstMintInfo | null;
+//# sourceMappingURL=lst.d.ts.map

package/dist/lst.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lst.d.ts","sourceRoot":"","sources":["../src/lst.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,OAAO,EAAE,SAAS,CAAC;IACnB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,OAAO,EAAE,WAWrB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,WAOlB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,WAOlB,CAAC;AAEF,kCAAkC;AAClC,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAIpD,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,WAAW,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,IAAI,CAO9D"}

package/dist/lst.js

@@ -0,0 +1,58 @@
+import { PublicKey } from "@solana/web3.js";
+export const JITOSOL = {
+    name: "JitoSOL",
+    mainnet: new PublicKey("J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn"),
+    decimals: 9,
+    description: "JitoSOL is Jito's liquid-staked SOL. The price-per-token grows as " +
+        "MEV + staking rewards accrue, so a bond denominated in JitoSOL " +
+        "appreciates in SOL terms while held. v0.4 sACP accepts JitoSOL " +
+        "without code changes — the bond_amount field stays constant in " +
+        "JitoSOL units, and the slash split (70/30) divides those JitoSOL " +
+        "units rather than the underlying SOL.",
+};
+export const MSOL = {
+    name: "mSOL",
+    mainnet: new PublicKey("mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So"),
+    decimals: 9,
+    description: "mSOL is Marinade's liquid-staked SOL. Same accrual story as " +
+        "JitoSOL — the bond appreciates in SOL terms over time.",
+};
+export const BSOL = {
+    name: "bSOL",
+    mainnet: new PublicKey("bSo13r4TkiE4KumL71LsHTPpL2euBYLFx6h9HP3piy1"),
+    decimals: 9,
+    description: "bSOL is BlazeStake's liquid-staked SOL. Compatible with sACP " +
+        "v0.4 as a bond mint.",
+};
+/** Convenience lookup by name. */
+export const LST_REGISTRY = {
+    JitoSOL: JITOSOL,
+    mSOL: MSOL,
+    bSOL: BSOL,
+};
+/**
+ * Convert a bond amount in LST atomic units to display SOL given a
+ * known LST → SOL exchange rate. The rate is typically fetched off-
+ * chain (e.g. JitoSOL provides a sanctum API) and changes slowly.
+ *
+ * For example: 10_000_000_000 JitoSOL atomic units (= 10 JitoSOL)
+ * at a rate of 1.15 SOL per JitoSOL → 11.5 SOL of effective bond.
+ */
+export function lstToSolDisplay(atomicAmount, lst, ratePerLst) {
+    const wholeLst = Number(atomicAmount) / 10 ** lst.decimals;
+    return wholeLst * ratePerLst;
+}
+/**
+ * Quick check: does the SDK consider this mint a known LST? Used by
+ * the validator detail page in `/explore/sacp` to show a small
+ * "appreciating bond" badge.
+ */
+export function isKnownLst(mint) {
+    for (const lst of Object.values(LST_REGISTRY)) {
+        if (lst.mainnet.equals(mint) || (lst.devnet && lst.devnet.equals(mint))) {
+            return lst;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=lst.js.map

package/dist/lst.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lst.js","sourceRoot":"","sources":["../src/lst.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAkC5C,MAAM,CAAC,MAAM,OAAO,GAAgB;IAClC,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,IAAI,SAAS,CAAC,8CAA8C,CAAC;IACtE,QAAQ,EAAE,CAAC;IACX,WAAW,EACT,oEAAoE;QACpE,iEAAiE;QACjE,iEAAiE;QACjE,iEAAiE;QACjE,mEAAmE;QACnE,uCAAuC;CAC1C,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAgB;IAC/B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,IAAI,SAAS,CAAC,6CAA6C,CAAC;IACrE,QAAQ,EAAE,CAAC;IACX,WAAW,EACT,8DAA8D;QAC9D,wDAAwD;CAC3D,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAgB;IAC/B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,IAAI,SAAS,CAAC,6CAA6C,CAAC;IACrE,QAAQ,EAAE,CAAC;IACX,WAAW,EACT,+DAA+D;QAC/D,sBAAsB;CACzB,CAAC;AAEF,kCAAkC;AAClC,MAAM,CAAC,MAAM,YAAY,GAAgC;IACvD,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,IAAI;CACX,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,YAAoB,EACpB,GAAgB,EAChB,UAAkB;IAElB,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,QAAQ,CAAC;IAC3D,OAAO,QAAQ,GAAG,UAAU,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAe;IACxC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9C,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACxE,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/negotiation.d.ts

@@ -0,0 +1,66 @@
+import { Connection, PublicKey, TransactionInstruction } from "@solana/web3.js";
+export type NegotiationState = "Open" | "Countered" | "Accepted" | "Cancelled";
+export interface ProposeTermsParams {
+    buyer: PublicKey;
+    provider: PublicKey;
+    evaluator: PublicKey;
+    bondMint: PublicKey;
+    negotiationId: bigint;
+    amount: bigint;
+    workUri: string;
+    submitWindowSecs: bigint;
+}
+export interface ProposeTermsBuildResult {
+    ix: TransactionInstruction;
+    negotiationPda: PublicKey;
+}
+export declare function buildProposeTermsIx(params: ProposeTermsParams): ProposeTermsBuildResult;
+export interface CounterTermsParams {
+    signer: PublicKey;
+    buyer: PublicKey;
+    negotiationId: bigint;
+    amount: bigint;
+    workUri: string;
+    submitWindowSecs: bigint;
+}
+export declare function buildCounterTermsIx(params: CounterTermsParams): TransactionInstruction;
+export declare function buildAcceptTermsIx(params: {
+    signer: PublicKey;
+    buyer: PublicKey;
+    negotiationId: bigint;
+}): TransactionInstruction;
+export declare function buildCancelNegotiationIx(params: {
+    signer: PublicKey;
+    buyer: PublicKey;
+    negotiationId: bigint;
+}): TransactionInstruction;
+export interface MaterializeJobParams {
+    buyer: PublicKey;
+    bondMint: PublicKey;
+    negotiationId: bigint;
+    jobId: bigint;
+}
+export interface MaterializeJobBuildResult {
+    ix: TransactionInstruction;
+    jobPda: PublicKey;
+    escrowPda: PublicKey;
+    escrowVaultPda: PublicKey;
+}
+export declare function buildMaterializeJobIx(params: MaterializeJobParams): MaterializeJobBuildResult;
+export interface FetchedNegotiation {
+    pda: PublicKey;
+    buyer: PublicKey;
+    provider: PublicKey;
+    evaluator: PublicKey;
+    bondMint: PublicKey;
+    negotiationId: bigint;
+    currentAmount: bigint;
+    currentWorkUri: string;
+    currentSubmitWindowSecs: bigint;
+    state: NegotiationState;
+    lastProposer: PublicKey;
+    createdAt: bigint;
+    updatedAt: bigint;
+}
+export declare function fetchNegotiation(connection: Connection, buyer: PublicKey, negotiationId: bigint): Promise<FetchedNegotiation | null>;
+//# sourceMappingURL=negotiation.d.ts.map