@telaro/sacp 1.0.1 → 1.0.2

package/dist/agreement.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Client for `sacp_agreement` — the on-chain Proof-of-Agreement memo
+ * program. Phase 8b Step 1 surface.
+ *
+ *   - `deriveAgreementPda(jobId)` — deterministic PDA lookup.
+ *   - `buildPostAgreementIx(...)` — single-IX builder for buyer +
+ *     provider to co-sign before any payment moves.
+ *   - `fetchAgreement(conn, jobId)` — read + decode a posted PDA.
+ *
+ * Mirrors the conventions in `./validation.ts` so a sACP integrator
+ * can wire this in the same way they wire the validator IXs.
+ */
+import { Connection, PublicKey, TransactionInstruction } from "@solana/web3.js";
+export declare const SACP_AGREEMENT_PROGRAM_ID: PublicKey;
+export declare const SEED_AGREEMENT: Buffer<ArrayBuffer>;
+export declare const MAX_SPEC_URI_LEN = 256;
+/**
+ * Derive the PDA that holds a job's agreement memo. The seed pair is
+ * fixed by the program (`["agreement", job_id]`) so any consumer
+ * (gateway, web UI, dispute panel) can look the memo up without an
+ * indexer.
+ */
+export declare function deriveAgreementPda(jobId: Uint8Array): [PublicKey, number];
+export interface PostAgreementParams {
+    buyer: PublicKey;
+    provider: PublicKey;
+    jobId: Uint8Array;
+    /** SHA-256 of the sample request, or 32 zeros if no sample committed. */
+    sampleRequestHash: Uint8Array;
+    /** SHA-256 of the sample deliverable, or 32 zeros if no sample committed. */
+    sampleDeliverableHash: Uint8Array;
+    /** Off-chain URL of the human-readable spec. ≤ 256 bytes. */
+    specUri: string;
+    /** Bond size the provider commits to post, in atoms. */
+    bondAtoms: bigint;
+}
+/**
+ * Build the `post_agreement` instruction. Both buyer and provider
+ * must sign the resulting transaction — the program rejects anything
+ * else, since a one-sided memo would let either party lock in terms
+ * the other never saw.
+ */
+export declare function buildPostAgreementIx(params: PostAgreementParams): TransactionInstruction;
+export interface FetchedAgreement {
+    buyer: PublicKey;
+    provider: PublicKey;
+    jobId: Uint8Array;
+    sampleRequestHash: Uint8Array;
+    sampleDeliverableHash: Uint8Array;
+    specUri: string;
+    bondAtoms: bigint;
+    signedAt: bigint;
+    bump: number;
+}
+/**
+ * Read + decode a previously posted agreement. Returns null when the
+ * PDA doesn't exist yet (i.e. the parties haven't signed). Throws if
+ * the account exists but isn't a well-formed `Agreement`.
+ */
+export declare function fetchAgreement(conn: Connection, jobId: Uint8Array): Promise<FetchedAgreement | null>;
+/**
+ * Layout (matches programs/sacp_agreement/src/lib.rs):
+ *   discriminator (8) +
+ *   buyer (32) + provider (32) + job_id (32) +
+ *   sample_request_hash (32) + sample_deliverable_hash (32) +
+ *   spec_uri (4-byte len + utf8) +
+ *   bond_atoms (8, u64 LE) + signed_at (8, i64 LE) + bump (1)
+ */
+export declare function parseAgreementFromBuffer(data: Buffer): FetchedAgreement;
+//# sourceMappingURL=agreement.d.ts.map

package/dist/agreement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agreement.d.ts","sourceRoot":"","sources":["../src/agreement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,UAAU,EACV,SAAS,EAET,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AAQzB,eAAO,MAAM,yBAAyB,WAErC,CAAC;AAEF,eAAO,MAAM,cAAc,qBAA2B,CAAC;AACvD,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAQzE;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC;IAClB,yEAAyE;IACzE,iBAAiB,EAAE,UAAU,CAAC;IAC9B,6EAA6E;IAC7E,qBAAqB,EAAE,UAAU,CAAC;IAClC,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,mBAAmB,GAC1B,sBAAsB,CA6BxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC;IAClB,iBAAiB,EAAE,UAAU,CAAC;IAC9B,qBAAqB,EAAE,UAAU,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAKlC;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CA8CvE"}

package/dist/agreement.js

@@ -0,0 +1,122 @@
+/**
+ * Client for `sacp_agreement` — the on-chain Proof-of-Agreement memo
+ * program. Phase 8b Step 1 surface.
+ *
+ *   - `deriveAgreementPda(jobId)` — deterministic PDA lookup.
+ *   - `buildPostAgreementIx(...)` — single-IX builder for buyer +
+ *     provider to co-sign before any payment moves.
+ *   - `fetchAgreement(conn, jobId)` — read + decode a posted PDA.
+ *
+ * Mirrors the conventions in `./validation.ts` so a sACP integrator
+ * can wire this in the same way they wire the validator IXs.
+ */
+import { PublicKey, SystemProgram, TransactionInstruction, } from "@solana/web3.js";
+import { encodeBytes32, encodeInstruction, encodeString, encodeU64, } from "./codec.js";
+export const SACP_AGREEMENT_PROGRAM_ID = new PublicKey("2tp9TSMeuDyK117VvW3t2hJwfLLBMgZX8h4NCUsBLtvU");
+export const SEED_AGREEMENT = Buffer.from("agreement");
+export const MAX_SPEC_URI_LEN = 256;
+/**
+ * Derive the PDA that holds a job's agreement memo. The seed pair is
+ * fixed by the program (`["agreement", job_id]`) so any consumer
+ * (gateway, web UI, dispute panel) can look the memo up without an
+ * indexer.
+ */
+export function deriveAgreementPda(jobId) {
+    if (jobId.length !== 32) {
+        throw new Error(`jobId must be 32 bytes, got ${jobId.length}`);
+    }
+    return PublicKey.findProgramAddressSync([SEED_AGREEMENT, Buffer.from(jobId)], SACP_AGREEMENT_PROGRAM_ID);
+}
+/**
+ * Build the `post_agreement` instruction. Both buyer and provider
+ * must sign the resulting transaction — the program rejects anything
+ * else, since a one-sided memo would let either party lock in terms
+ * the other never saw.
+ */
+export function buildPostAgreementIx(params) {
+    if (params.specUri.length === 0 || params.specUri.length > MAX_SPEC_URI_LEN) {
+        throw new Error(`specUri must be 1..${MAX_SPEC_URI_LEN} bytes, got ${params.specUri.length}`);
+    }
+    if (params.bondAtoms <= 0n) {
+        throw new Error("bondAtoms must be greater than zero");
+    }
+    const [agreementPda] = deriveAgreementPda(params.jobId);
+    const data = encodeInstruction("post_agreement", encodeBytes32(params.jobId), encodeBytes32(params.sampleRequestHash), encodeBytes32(params.sampleDeliverableHash), encodeString(params.specUri), encodeU64(params.bondAtoms));
+    return new TransactionInstruction({
+        programId: SACP_AGREEMENT_PROGRAM_ID,
+        keys: [
+            { pubkey: params.buyer, isSigner: true, isWritable: true },
+            { pubkey: params.provider, isSigner: true, isWritable: false },
+            { pubkey: agreementPda, isSigner: false, isWritable: true },
+            { pubkey: SystemProgram.programId, isSigner: false, isWritable: false },
+        ],
+        data,
+    });
+}
+/**
+ * Read + decode a previously posted agreement. Returns null when the
+ * PDA doesn't exist yet (i.e. the parties haven't signed). Throws if
+ * the account exists but isn't a well-formed `Agreement`.
+ */
+export async function fetchAgreement(conn, jobId) {
+    const [pda] = deriveAgreementPda(jobId);
+    const info = await conn.getAccountInfo(pda, "confirmed");
+    if (!info)
+        return null;
+    return parseAgreementFromBuffer(info.data);
+}
+/**
+ * Layout (matches programs/sacp_agreement/src/lib.rs):
+ *   discriminator (8) +
+ *   buyer (32) + provider (32) + job_id (32) +
+ *   sample_request_hash (32) + sample_deliverable_hash (32) +
+ *   spec_uri (4-byte len + utf8) +
+ *   bond_atoms (8, u64 LE) + signed_at (8, i64 LE) + bump (1)
+ */
+export function parseAgreementFromBuffer(data) {
+    let offset = 8; // skip Anchor discriminator
+    const readPubkey = () => {
+        const v = new PublicKey(data.subarray(offset, offset + 32));
+        offset += 32;
+        return v;
+    };
+    const readBytes32 = () => {
+        const v = new Uint8Array(data.subarray(offset, offset + 32));
+        offset += 32;
+        return v;
+    };
+    const readString = () => {
+        const len = data.readUInt32LE(offset);
+        offset += 4;
+        const v = data.subarray(offset, offset + len).toString("utf8");
+        offset += len;
+        return v;
+    };
+    const readU64 = () => {
+        const v = data.readBigUInt64LE(offset);
+        offset += 8;
+        return v;
+    };
+    const readI64 = () => {
+        const v = data.readBigInt64LE(offset);
+        offset += 8;
+        return v;
+    };
+    const readU8 = () => {
+        const v = data.readUInt8(offset);
+        offset += 1;
+        return v;
+    };
+    return {
+        buyer: readPubkey(),
+        provider: readPubkey(),
+        jobId: readBytes32(),
+        sampleRequestHash: readBytes32(),
+        sampleDeliverableHash: readBytes32(),
+        specUri: readString(),
+        bondAtoms: readU64(),
+        signedAt: readI64(),
+        bump: readU8(),
+    };
+}
+//# sourceMappingURL=agreement.js.map

package/dist/agreement.js.map

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

package/dist/index.d.ts

@@ -25,6 +25,7 @@ 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 * as agreement from "./agreement.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;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"}
+{"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"}

package/dist/index.js

@@ -25,6 +25,7 @@ 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 * as agreement from "./agreement.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;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"}
+{"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telaro/sacp",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "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",
@@ -62,6 +62,10 @@
     "./negotiation": {
       "types": "./dist/negotiation.d.ts",
       "import": "./dist/negotiation.js"
+    },
+    "./agreement": {
+      "types": "./dist/agreement.d.ts",
+      "import": "./dist/agreement.js"
     }
   },
   "files": [
@@ -69,33 +73,9 @@
     "README.md",
     "INTEGRATION.md"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist",
-    "prepublishOnly": "pnpm clean && pnpm build",
-    "smoke": "tsx tests/devnet-smoke.ts",
-    "smoke:validation": "tsx tests/devnet-validation.ts",
-    "smoke:dispute": "tsx tests/devnet-dispute.ts",
-    "smoke:reclaim": "tsx tests/devnet-reclaim.ts",
-    "smoke:all": "tsx tests/devnet-smoke.ts && tsx tests/devnet-dispute.ts && tsx tests/devnet-reclaim.ts && tsx tests/devnet-validation.ts",
-    "smoke:bonded": "tsx tests/devnet-bonded-evaluator.ts",
-    "smoke:negative": "tsx tests/devnet-negative.ts",
-    "smoke:wormhole": "tsx tests/devnet-wormhole.ts",
-    "smoke:jitosol": "tsx tests/devnet-jitosol.ts",
-    "smoke:wormhole-reclaim": "tsx tests/devnet-wormhole-reclaim.ts",
-    "smoke:take-rate": "tsx tests/devnet-take-rate.ts",
-    "smoke:runtime": "tsx tests/devnet-runtime.ts",
-    "smoke:v09": "tsx tests/devnet-v09.ts",
-    "smoke:v09-phase56": "tsx tests/devnet-v09-phase56.ts",
-    "smoke:phase7": "tsx tests/devnet-phase7.ts",
-    "smoke:phase8": "tsx tests/devnet-phase8.ts",
-    "smoke:phantom": "tsx tests/devnet-phantom.ts",
-    "smoke:x402": "tsx tests/devnet-x402.ts",
-    "smoke:mcp-server": "tsx tests/devnet-mcp-server.ts"
-  },
   "dependencies": {
     "@solana/web3.js": "^1.95.0",
+    "@solana/spl-token": "^0.4.0",
     "@coral-xyz/anchor": "^0.31.0",
     "@noble/hashes": "^1.5.0"
   },
@@ -105,7 +85,6 @@
     "typescript": "^5.5.0",
     "tsx": "^4.16.0",
     "express": "^4.21.0",
-    "@solana/spl-token": "^0.4.0",
     "@modelcontextprotocol/sdk": "^1.0.0"
   },
   "publishConfig": {
@@ -135,5 +114,33 @@
     "telaro",
     "validation-registry"
   ],
-  "type": "module"
-}
+  "type": "module",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "smoke": "tsx tests/devnet-smoke.ts",
+    "smoke:validation": "tsx tests/devnet-validation.ts",
+    "smoke:dispute": "tsx tests/devnet-dispute.ts",
+    "smoke:reclaim": "tsx tests/devnet-reclaim.ts",
+    "smoke:all": "tsx tests/devnet-smoke.ts && tsx tests/devnet-dispute.ts && tsx tests/devnet-reclaim.ts && tsx tests/devnet-validation.ts",
+    "smoke:bonded": "tsx tests/devnet-bonded-evaluator.ts",
+    "smoke:negative": "tsx tests/devnet-negative.ts",
+    "smoke:wormhole": "tsx tests/devnet-wormhole.ts",
+    "smoke:jitosol": "tsx tests/devnet-jitosol.ts",
+    "smoke:wormhole-reclaim": "tsx tests/devnet-wormhole-reclaim.ts",
+    "smoke:take-rate": "tsx tests/devnet-take-rate.ts",
+    "smoke:runtime": "tsx tests/devnet-runtime.ts",
+    "smoke:v09": "tsx tests/devnet-v09.ts",
+    "smoke:v09-phase56": "tsx tests/devnet-v09-phase56.ts",
+    "smoke:phase7": "tsx tests/devnet-phase7.ts",
+    "smoke:phase8": "tsx tests/devnet-phase8.ts",
+    "smoke:agreement": "tsx tests/devnet-agreement.ts",
+    "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:phantom": "tsx tests/devnet-phantom.ts",
+    "smoke:x402": "tsx tests/devnet-x402.ts",
+    "smoke:mcp-server": "tsx tests/devnet-mcp-server.ts"
+  }
+}