@telaro/sacp 1.0.0

package/dist/wormhole.d.ts

@@ -0,0 +1,88 @@
+import { Connection, PublicKey, TransactionInstruction, type Signer } from "@solana/web3.js";
+/**
+ * Cross-chain settlement publish via Wormhole.
+ *
+ * `publish_settlement_vaa` is a permissionless instruction on
+ * `sacp_job` that fires a Wormhole VAA whenever a Job is in the
+ * `Settled` state. The VAA payload is consumed by any EVM-side
+ * relayer interested in mirroring sACP settlements (Base ERC-8183,
+ * generic ACP relays, agent dashboards).
+ *
+ * Payload layout (big-endian, EVM-friendly):
+ *   [0]     version (currently 1)
+ *   [1..5]  magic ("sACP")
+ *   [5..13] job_id (u64 BE)
+ *   [13]    winner (0 = Client, 1 = Provider)
+ *   [14..46] evaluator pubkey (32 bytes)
+ *   [46..54] amount (u64 BE)
+ *   [54..62] settled_at (i64 BE — unix seconds)
+ *   [62]    state (always 4 = Settled)
+ */
+/** Wormhole core bridge program IDs. */
+export declare const WORMHOLE_CORE_BRIDGE_MAINNET: PublicKey;
+export declare const WORMHOLE_CORE_BRIDGE_DEVNET: PublicKey;
+/** PDA helpers — Wormhole core bridge owns these. */
+export declare function findWormholeBridgePda(wormholeProgram: PublicKey): [PublicKey, number];
+export declare function findWormholeFeeCollectorPda(wormholeProgram: PublicKey): [PublicKey, number];
+/** sACP emitter PDA — distinct from Telaro's `["emitter"]`. */
+export declare function findSacpEmitterPda(): [PublicKey, number];
+/** Wormhole sequence PDA — derived from emitter. */
+export declare function findWormholeSequencePda(wormholeProgram: PublicKey, emitter: PublicKey): [PublicKey, number];
+export interface PublishSettlementVaaParams {
+    payer: PublicKey;
+    /** Fresh ephemeral keypair public key — Wormhole takes ownership. */
+    wormholeMessage: PublicKey;
+    jobId: bigint;
+    nonce: number;
+    /** Defaults to devnet. Override with `WORMHOLE_CORE_BRIDGE_MAINNET`. */
+    wormholeProgram?: PublicKey;
+}
+export declare function buildPublishSettlementVaaIx(params: PublishSettlementVaaParams): {
+    ix: TransactionInstruction;
+    wormholeEmitter: PublicKey;
+    wormholeSequence: PublicKey;
+};
+/**
+ * Convenience: build, sign, send, and confirm a
+ * `publish_settlement_vaa` transaction in one call. Generates a fresh
+ * Wormhole message keypair internally so the caller doesn't have to
+ * remember the rotating-keypair convention.
+ *
+ * Returns the signature, the message account pubkey (for indexers to
+ * fetch the VAA from), and the post-publish Wormhole sequence number.
+ *
+ * For more control (e.g. batching the publish with other instructions
+ * in a single tx) use `buildPublishSettlementVaaIx` directly.
+ */
+export declare function publishSettlementVaa(connection: Connection, payer: Signer, jobId: bigint, options?: {
+    nonce?: number;
+    wormholeProgram?: PublicKey;
+    commitment?: "confirmed" | "finalized";
+}): Promise<{
+    signature: string;
+    wormholeMessage: PublicKey;
+    wormholeSequence: PublicKey;
+    wormholeEmitter: PublicKey;
+}>;
+/**
+ * Decode a settlement VAA payload back into structured fields. Useful
+ * for relayers / indexers reading Wormhole messages.
+ */
+export interface DecodedSacpSettlement {
+    version: number;
+    jobId: bigint;
+    winner: 0 | 1;
+    evaluator: PublicKey;
+    /** v2+ only. `null` on v1 payloads (legacy). */
+    provider: PublicKey | null;
+    amount: bigint;
+    settledAt: bigint;
+    state: number;
+}
+/**
+ * Decode an sACP settlement VAA payload. Handles both:
+ *   - v1 (63 bytes): no provider pubkey. Returned with `provider = null`.
+ *   - v2 (95 bytes): includes the provider pubkey at offset 46.
+ */
+export declare function decodeSettlementPayload(payload: Uint8Array): DecodedSacpSettlement | null;
+//# sourceMappingURL=wormhole.d.ts.map

package/dist/wormhole.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wormhole.d.ts","sourceRoot":"","sources":["../src/wormhole.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAEV,SAAS,EAKT,sBAAsB,EAEtB,KAAK,MAAM,EACZ,MAAM,iBAAiB,CAAC;AAKzB;;;;;;;;;;;;;;;;;;GAkBG;AAEH,wCAAwC;AACxC,eAAO,MAAM,4BAA4B,WAExC,CAAC;AACF,eAAO,MAAM,2BAA2B,WAEvC,CAAC;AAEF,qDAAqD;AACrD,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,SAAS,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAErF;AAED,wBAAgB,2BAA2B,CACzC,eAAe,EAAE,SAAS,GACzB,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAKxD;AAED,oDAAoD;AACpD,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,SAAS,EAC1B,OAAO,EAAE,SAAS,GACjB,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,SAAS,CAAC;IACjB,qEAAqE;IACrE,eAAe,EAAE,SAAS,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,eAAe,CAAC,EAAE,SAAS,CAAC;CAC7B;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,0BAA0B,GACjC;IACD,EAAE,EAAE,sBAAsB,CAAC;IAC3B,eAAe,EAAE,SAAS,CAAC;IAC3B,gBAAgB,EAAE,SAAS,CAAC;CAC7B,CAgCA;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5B,UAAU,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC;CACnC,GACL,OAAO,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,SAAS,CAAC;IAC3B,gBAAgB,EAAE,SAAS,CAAC;IAC5B,eAAe,EAAE,SAAS,CAAC;CAC5B,CAAC,CAqBD;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;IACd,SAAS,EAAE,SAAS,CAAC;IACrB,gDAAgD;IAChD,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,UAAU,GAClB,qBAAqB,GAAG,IAAI,CA4C9B"}

package/dist/wormhole.js

@@ -0,0 +1,152 @@
+import { Keypair, PublicKey, SYSVAR_CLOCK_PUBKEY, SYSVAR_RENT_PUBKEY, SystemProgram, Transaction, TransactionInstruction, sendAndConfirmTransaction, } from "@solana/web3.js";
+import { encodeInstruction } from "./codec.js";
+import { SACP_PROGRAM_ID } from "./constants.js";
+import { findJobPda } from "./pdas.js";
+/**
+ * Cross-chain settlement publish via Wormhole.
+ *
+ * `publish_settlement_vaa` is a permissionless instruction on
+ * `sacp_job` that fires a Wormhole VAA whenever a Job is in the
+ * `Settled` state. The VAA payload is consumed by any EVM-side
+ * relayer interested in mirroring sACP settlements (Base ERC-8183,
+ * generic ACP relays, agent dashboards).
+ *
+ * Payload layout (big-endian, EVM-friendly):
+ *   [0]     version (currently 1)
+ *   [1..5]  magic ("sACP")
+ *   [5..13] job_id (u64 BE)
+ *   [13]    winner (0 = Client, 1 = Provider)
+ *   [14..46] evaluator pubkey (32 bytes)
+ *   [46..54] amount (u64 BE)
+ *   [54..62] settled_at (i64 BE — unix seconds)
+ *   [62]    state (always 4 = Settled)
+ */
+/** Wormhole core bridge program IDs. */
+export const WORMHOLE_CORE_BRIDGE_MAINNET = new PublicKey("worm2ZoG2kUd4vFXhvjh93UUH596ayRfgQ2MgjNMTth");
+export const WORMHOLE_CORE_BRIDGE_DEVNET = new PublicKey("3u8hJUVTA4jH1wYAyUur7FFZVQ8H635K3tSHHF4ssjQ5");
+/** PDA helpers — Wormhole core bridge owns these. */
+export function findWormholeBridgePda(wormholeProgram) {
+    return PublicKey.findProgramAddressSync([Buffer.from("Bridge")], wormholeProgram);
+}
+export function findWormholeFeeCollectorPda(wormholeProgram) {
+    return PublicKey.findProgramAddressSync([Buffer.from("fee_collector")], wormholeProgram);
+}
+/** sACP emitter PDA — distinct from Telaro's `["emitter"]`. */
+export function findSacpEmitterPda() {
+    return PublicKey.findProgramAddressSync([Buffer.from("sacp_emitter")], SACP_PROGRAM_ID);
+}
+/** Wormhole sequence PDA — derived from emitter. */
+export function findWormholeSequencePda(wormholeProgram, emitter) {
+    return PublicKey.findProgramAddressSync([Buffer.from("Sequence"), emitter.toBuffer()], wormholeProgram);
+}
+export function buildPublishSettlementVaaIx(params) {
+    const wh = params.wormholeProgram ?? WORMHOLE_CORE_BRIDGE_DEVNET;
+    const [jobPda] = findJobPda(params.jobId);
+    const [wormholeBridge] = findWormholeBridgePda(wh);
+    const [wormholeFeeCollector] = findWormholeFeeCollectorPda(wh);
+    const [wormholeEmitter] = findSacpEmitterPda();
+    const [wormholeSequence] = findWormholeSequencePda(wh, wormholeEmitter);
+    // Nonce: 4-byte little-endian unsigned. Borsh u32.
+    const nonceBytes = Buffer.alloc(4);
+    nonceBytes.writeUInt32LE(params.nonce >>> 0);
+    const data = encodeInstruction("publish_settlement_vaa", nonceBytes);
+    const ix = new TransactionInstruction({
+        programId: SACP_PROGRAM_ID,
+        keys: [
+            { pubkey: jobPda, isSigner: false, isWritable: false },
+            { pubkey: params.payer, isSigner: true, isWritable: true },
+            { pubkey: params.wormholeMessage, isSigner: true, isWritable: true },
+            { pubkey: wh, isSigner: false, isWritable: false },
+            { pubkey: wormholeBridge, isSigner: false, isWritable: true },
+            { pubkey: wormholeEmitter, isSigner: false, isWritable: false },
+            { pubkey: wormholeSequence, isSigner: false, isWritable: true },
+            { pubkey: wormholeFeeCollector, isSigner: false, isWritable: true },
+            { pubkey: SYSVAR_CLOCK_PUBKEY, isSigner: false, isWritable: false },
+            { pubkey: SYSVAR_RENT_PUBKEY, isSigner: false, isWritable: false },
+            { pubkey: SystemProgram.programId, isSigner: false, isWritable: false },
+        ],
+        data,
+    });
+    return { ix, wormholeEmitter, wormholeSequence };
+}
+/**
+ * Convenience: build, sign, send, and confirm a
+ * `publish_settlement_vaa` transaction in one call. Generates a fresh
+ * Wormhole message keypair internally so the caller doesn't have to
+ * remember the rotating-keypair convention.
+ *
+ * Returns the signature, the message account pubkey (for indexers to
+ * fetch the VAA from), and the post-publish Wormhole sequence number.
+ *
+ * For more control (e.g. batching the publish with other instructions
+ * in a single tx) use `buildPublishSettlementVaaIx` directly.
+ */
+export async function publishSettlementVaa(connection, payer, jobId, options = {}) {
+    const wormholeMessage = Keypair.generate();
+    const { ix, wormholeEmitter, wormholeSequence } = buildPublishSettlementVaaIx({
+        payer: payer.publicKey,
+        wormholeMessage: wormholeMessage.publicKey,
+        jobId,
+        nonce: options.nonce ?? Math.floor(Math.random() * 0xffffffff),
+        wormholeProgram: options.wormholeProgram,
+    });
+    const signature = await sendAndConfirmTransaction(connection, new Transaction().add(ix), [payer, wormholeMessage], { commitment: options.commitment ?? "confirmed" });
+    return {
+        signature,
+        wormholeMessage: wormholeMessage.publicKey,
+        wormholeSequence,
+        wormholeEmitter,
+    };
+}
+/**
+ * Decode an sACP settlement VAA payload. Handles both:
+ *   - v1 (63 bytes): no provider pubkey. Returned with `provider = null`.
+ *   - v2 (95 bytes): includes the provider pubkey at offset 46.
+ */
+export function decodeSettlementPayload(payload) {
+    if (payload.length !== 63 && payload.length !== 95)
+        return null;
+    const buf = Buffer.from(payload);
+    const version = buf.readUInt8(0);
+    const magic = buf.subarray(1, 5).toString("utf8");
+    if (magic !== "sACP")
+        return null;
+    const jobId = buf.readBigUInt64BE(5);
+    const winner = buf.readUInt8(13);
+    if (winner !== 0 && winner !== 1)
+        return null;
+    const evaluator = new PublicKey(buf.subarray(14, 46));
+    if (payload.length === 63) {
+        // v1 layout — no provider field.
+        const amount = buf.readBigUInt64BE(46);
+        const settledAt = buf.readBigInt64BE(54);
+        const state = buf.readUInt8(62);
+        return {
+            version,
+            jobId,
+            winner: winner,
+            evaluator,
+            provider: null,
+            amount,
+            settledAt,
+            state,
+        };
+    }
+    // v2 layout — provider at [46..78], amount at [78..86], settledAt at
+    // [86..94], state at [94].
+    const provider = new PublicKey(buf.subarray(46, 78));
+    const amount = buf.readBigUInt64BE(78);
+    const settledAt = buf.readBigInt64BE(86);
+    const state = buf.readUInt8(94);
+    return {
+        version,
+        jobId,
+        winner: winner,
+        evaluator,
+        provider,
+        amount,
+        settledAt,
+        state,
+    };
+}
+//# sourceMappingURL=wormhole.js.map

package/dist/wormhole.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wormhole.js","sourceRoot":"","sources":["../src/wormhole.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,OAAO,EACP,SAAS,EACT,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,sBAAsB,EACtB,yBAAyB,GAE1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC;;;;;;;;;;;;;;;;;;GAkBG;AAEH,wCAAwC;AACxC,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,SAAS,CACvD,6CAA6C,CAC9C,CAAC;AACF,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,SAAS,CACtD,8CAA8C,CAC/C,CAAC;AAEF,qDAAqD;AACrD,MAAM,UAAU,qBAAqB,CAAC,eAA0B;IAC9D,OAAO,SAAS,CAAC,sBAAsB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,eAA0B;IAE1B,OAAO,SAAS,CAAC,sBAAsB,CACrC,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,EAC9B,eAAe,CAChB,CAAC;AACJ,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,kBAAkB;IAChC,OAAO,SAAS,CAAC,sBAAsB,CACrC,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,EAC7B,eAAe,CAChB,CAAC;AACJ,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,uBAAuB,CACrC,eAA0B,EAC1B,OAAkB;IAElB,OAAO,SAAS,CAAC,sBAAsB,CACrC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,EAC7C,eAAe,CAChB,CAAC;AACJ,CAAC;AAYD,MAAM,UAAU,2BAA2B,CACzC,MAAkC;IAMlC,MAAM,EAAE,GAAG,MAAM,CAAC,eAAe,IAAI,2BAA2B,CAAC;IACjE,MAAM,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,CAAC,cAAc,CAAC,GAAG,qBAAqB,CAAC,EAAE,CAAC,CAAC;IACnD,MAAM,CAAC,oBAAoB,CAAC,GAAG,2BAA2B,CAAC,EAAE,CAAC,CAAC;IAC/D,MAAM,CAAC,eAAe,CAAC,GAAG,kBAAkB,EAAE,CAAC;IAC/C,MAAM,CAAC,gBAAgB,CAAC,GAAG,uBAAuB,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;IAExE,mDAAmD;IACnD,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,UAAU,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,iBAAiB,CAAC,wBAAwB,EAAE,UAAU,CAAC,CAAC;IAErE,MAAM,EAAE,GAAG,IAAI,sBAAsB,CAAC;QACpC,SAAS,EAAE,eAAe;QAC1B,IAAI,EAAE;YACJ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE;YACtD,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;YAC1D,EAAE,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;YACpE,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE;YAClD,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;YAC7D,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE;YAC/D,EAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;YAC/D,EAAE,MAAM,EAAE,oBAAoB,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;YACnE,EAAE,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE;YACnE,EAAE,MAAM,EAAE,kBAAkB,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE;YAClE,EAAE,MAAM,EAAE,aAAa,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE;SACxE;QACD,IAAI;KACL,CAAC,CAAC;IAEH,OAAO,EAAE,EAAE,EAAE,eAAe,EAAE,gBAAgB,EAAE,CAAC;AACnD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAAsB,EACtB,KAAa,EACb,KAAa,EACb,UAII,EAAE;IAON,MAAM,eAAe,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC3C,MAAM,EAAE,EAAE,EAAE,eAAe,EAAE,gBAAgB,EAAE,GAAG,2BAA2B,CAAC;QAC5E,KAAK,EAAE,KAAK,CAAC,SAAS;QACtB,eAAe,EAAE,eAAe,CAAC,SAAS;QAC1C,KAAK;QACL,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC;QAC9D,eAAe,EAAE,OAAO,CAAC,eAAe;KACzC,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,MAAM,yBAAyB,CAC/C,UAAU,EACV,IAAI,WAAW,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EACzB,CAAC,KAAK,EAAE,eAAe,CAAC,EACxB,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,WAAW,EAAE,CAClD,CAAC;IACF,OAAO;QACL,SAAS;QACT,eAAe,EAAE,eAAe,CAAC,SAAS;QAC1C,gBAAgB;QAChB,eAAe;KAChB,CAAC;AACJ,CAAC;AAkBD;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAmB;IAEnB,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAChE,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,KAAK,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,MAAM,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAEtD,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC1B,iCAAiC;QACjC,MAAM,MAAM,GAAG,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QACvC,MAAM,SAAS,GAAG,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAChC,OAAO;YACL,OAAO;YACP,KAAK;YACL,MAAM,EAAE,MAAe;YACvB,SAAS;YACT,QAAQ,EAAE,IAAI;YACd,MAAM;YACN,SAAS;YACT,KAAK;SACN,CAAC;IACJ,CAAC;IAED,qEAAqE;IACrE,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAChC,OAAO;QACL,OAAO;QACP,KAAK;QACL,MAAM,EAAE,MAAe;QACvB,SAAS;QACT,QAAQ;QACR,MAAM;QACN,SAAS;QACT,KAAK;KACN,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,138 @@
+{
+  "name": "@telaro/sacp",
+  "version": "1.0.0",
+  "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",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./job": {
+      "types": "./dist/job.d.ts",
+      "import": "./dist/job.js"
+    },
+    "./validation": {
+      "types": "./dist/validation.d.ts",
+      "import": "./dist/validation.js"
+    },
+    "./events": {
+      "types": "./dist/events.d.ts",
+      "import": "./dist/events.js"
+    },
+    "./wormhole": {
+      "types": "./dist/wormhole.d.ts",
+      "import": "./dist/wormhole.js"
+    },
+    "./lst": {
+      "types": "./dist/lst.d.ts",
+      "import": "./dist/lst.js"
+    },
+    "./take-rate": {
+      "types": "./dist/take_rate.d.ts",
+      "import": "./dist/take_rate.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime.d.ts",
+      "import": "./dist/runtime.js"
+    },
+    "./signer": {
+      "types": "./dist/signer.d.ts",
+      "import": "./dist/signer.js"
+    },
+    "./watcher": {
+      "types": "./dist/watcher.d.ts",
+      "import": "./dist/watcher.js"
+    },
+    "./dispatcher": {
+      "types": "./dist/dispatcher.d.ts",
+      "import": "./dist/dispatcher.js"
+    },
+    "./offering": {
+      "types": "./dist/offering.d.ts",
+      "import": "./dist/offering.js"
+    },
+    "./timeout": {
+      "types": "./dist/timeout.d.ts",
+      "import": "./dist/timeout.js"
+    },
+    "./negotiation": {
+      "types": "./dist/negotiation.d.ts",
+      "import": "./dist/negotiation.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "INTEGRATION.md"
+  ],
+  "dependencies": {
+    "@solana/web3.js": "^1.95.0",
+    "@coral-xyz/anchor": "^0.31.0",
+    "@noble/hashes": "^1.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/express": "^4.17.21",
+    "typescript": "^5.5.0",
+    "tsx": "^4.16.0",
+    "express": "^4.21.0",
+    "@solana/spl-token": "^0.4.0",
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Telaro-Protocol/Telaro-Protocol.git",
+    "directory": "packages/sacp"
+  },
+  "homepage": "https://sacp.dev",
+  "bugs": {
+    "url": "https://github.com/Telaro-Protocol/Telaro-Protocol/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "agent-commerce",
+    "ai-agents",
+    "anchor",
+    "erc-8004",
+    "erc-8183",
+    "escrow",
+    "sacp",
+    "solana",
+    "telaro",
+    "validation-registry"
+  ],
+  "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:phantom": "tsx tests/devnet-phantom.ts",
+    "smoke:x402": "tsx tests/devnet-x402.ts",
+    "smoke:mcp-server": "tsx tests/devnet-mcp-server.ts"
+  }
+}