@oobe-protocol-labs/synapse-sap-sdk 0.14.0 → 0.15.1

package/dist/esm/modules/escrow.d.ts

@@ -0,0 +1,168 @@
+/**
+ * @module escrow
+ * @description x402 escrow settlement layer — create, deposit,
+ * settle, withdraw, batch settle, and close escrow accounts.
+ *
+ * Supports both SOL and SPL token escrows. SPL operations require
+ * passing additional `AccountMeta[]` via the `splAccounts` parameter.
+ *
+ * @category Modules
+ * @since v0.1.0
+ * @packageDocumentation
+ */
+import { type PublicKey, type TransactionSignature, type AccountMeta } from "@solana/web3.js";
+import { BN } from "@coral-xyz/anchor";
+import { BaseModule } from "./base";
+import type { EscrowAccountData, CreateEscrowArgs, Settlement } from "../types";
+import type { SettleOptions } from "../utils/priority-fee";
+/**
+ * @name EscrowModule
+ * @description Manages x402-compatible escrow accounts for agent micropayments.
+ *   Provides methods to create, fund, settle, withdraw, batch-settle, close,
+ *   and fetch escrow PDAs on the Synapse Agent Protocol.
+ *
+ * @category Modules
+ * @since v0.1.0
+ * @extends BaseModule
+ *
+ * @example
+ * ```ts
+ * const sap = new SapClient(provider);
+ * // Create a SOL escrow for an agent
+ * const sig = await sap.escrow.create(agentWallet, {
+ *   pricePerCall: new BN(1_000_000),
+ *   maxCalls: new BN(100),
+ *   initialDeposit: new BN(100_000_000),
+ *   expiresAt: null,
+ *   volumeCurve: null,
+ *   tokenMint: null,
+ *   tokenDecimals: null,
+ * });
+ * ```
+ *
+ * @deprecated Since v0.7.0 — Use {@link EscrowV2Module} (`client.escrowV2`) instead.
+ * V1 escrows lack settlement security, dispute resolution, and staking integration.
+ * Existing V1 escrows can be migrated via `client.escrowV2.migrateFromV1()`.
+ */
+export declare class EscrowModule extends BaseModule {
+    /**
+     * @name deriveEscrow
+     * @description Derive the `EscrowAccount` PDA for a given agent and depositor.
+     * @param agentPda - The agent account PDA.
+     * @param depositor - The depositor wallet. Defaults to the connected wallet.
+     * @returns A tuple of `[PublicKey, bump]` for the escrow PDA.
+     * @see {@link deriveEscrow} from `pda/` module for the underlying derivation.
+     * @since v0.1.0
+     */
+    deriveEscrow(agentPda: PublicKey, depositor?: PublicKey): readonly [PublicKey, number];
+    /**
+     * @name create
+     * @description Create a new escrow for agent micropayments.
+     *
+     *   For **SOL escrow**: pass `tokenMint: null` and leave `splAccounts` empty.
+     *   For **SPL escrow**: pass `tokenMint`, `tokenDecimals`, and provide
+     *   `splAccounts` with `[depositorAta, escrowAta, tokenMint, tokenProgram]`.
+     *
+     * @param agentWallet - The wallet of the agent to pay.
+     * @param args - Escrow creation parameters (price, max calls, deposit, expiry, volume curve, token info).
+     * @param splAccounts - Remaining accounts for SPL token transfers:
+     *   `[depositorAta, escrowAta, tokenMint, tokenProgram]`. Defaults to `[]`.
+     * @returns {Promise<TransactionSignature>} The transaction signature.
+     * @since v0.1.0
+     */
+    create(agentWallet: PublicKey, args: CreateEscrowArgs, splAccounts?: AccountMeta[]): Promise<TransactionSignature>;
+    /**
+     * @name deposit
+     * @description Deposit additional funds into an existing escrow.
+     * @param agentWallet - The wallet of the agent associated with the escrow.
+     * @param amount - The amount to deposit (lamports for SOL, smallest unit for SPL).
+     * @param splAccounts - Remaining accounts for SPL token transfers. Defaults to `[]`.
+     * @returns {Promise<TransactionSignature>} The transaction signature.
+     * @since v0.1.0
+     */
+    deposit(agentWallet: PublicKey, amount: BN | number | bigint, splAccounts?: AccountMeta[]): Promise<TransactionSignature>;
+    /**
+     * @name settle
+     * @description Agent settles calls — claims earned funds from the escrow.
+     *   Must be called by the agent owner wallet.
+     * @param depositorWallet - The wallet of the client who funded the escrow.
+     * @param callsToSettle - Number of calls to settle payment for.
+     * @param serviceHash - A 32-byte SHA-256 hash identifying the service rendered.
+     * @param splAccounts - Remaining accounts for SPL token transfers. Defaults to `[]`.
+     * @param opts - Optional {@link SettleOptions} for priority fees and RPC tuning.
+     * @returns {Promise<TransactionSignature>} The transaction signature.
+     * @since v0.1.0
+     * @updated v0.6.2 — Added optional `opts` parameter for priority fees.
+     */
+    settle(depositorWallet: PublicKey, callsToSettle: BN | number | bigint, serviceHash: number[], splAccounts?: AccountMeta[], opts?: SettleOptions): Promise<TransactionSignature>;
+    /**
+     * @name withdraw
+     * @description Client withdraws un-settled funds from their escrow.
+     * @param agentWallet - The wallet of the agent associated with the escrow.
+     * @param amount - The amount to withdraw (lamports for SOL, smallest unit for SPL).
+     * @param splAccounts - Remaining accounts for SPL token transfers. Defaults to `[]`.
+     * @returns {Promise<TransactionSignature>} The transaction signature.
+     * @since v0.1.0
+     */
+    withdraw(agentWallet: PublicKey, amount: BN | number | bigint, splAccounts?: AccountMeta[]): Promise<TransactionSignature>;
+    /**
+     * @name close
+     * @description Close an empty escrow PDA (balance must be 0) and reclaim rent.
+     * @param agentWallet - The wallet of the agent associated with the escrow.
+     * @returns {Promise<TransactionSignature>} The transaction signature.
+     * @since v0.1.0
+     */
+    close(agentWallet: PublicKey): Promise<TransactionSignature>;
+    /**
+     * @name settleBatch
+     * @description Batch settlement — process up to 10 settlements in a single
+     *   transaction. Must be called by the agent owner wallet.
+     *
+     * @param depositorWallet - The wallet of the client who funded the escrow.
+     * @param settlements - Array of settlement entries (up to 10).
+     * @param batchRoot - Optional pre-computed batch root
+     *   (`sha256(s_0 || s_1 || ... || s_{N-1})`). When omitted the SDK
+     *   computes it from `settlements[*].serviceHash`. **Required on-chain
+     *   since v0.10.0** to seed the anti-replay receipt PDA.
+     * @param splAccounts - Remaining accounts for SPL token transfers. Defaults to `[]`.
+     * @param opts - Optional {@link SettleOptions} for priority fees and RPC tuning.
+     * @returns {Promise<TransactionSignature>} The transaction signature.
+     *
+     * @since v0.1.0
+     * @updated v0.6.2 — Added optional `opts` parameter for priority fees.
+     * @updated v0.10.0 — Added `batchRoot` argument and required
+     *   `settlementReceipt` PDA on-chain (anti-replay).
+     */
+    settleBatch(depositorWallet: PublicKey, settlements: Settlement[], batchRoot?: Uint8Array | number[] | null, splAccounts?: AccountMeta[], opts?: SettleOptions): Promise<TransactionSignature>;
+    /**
+     * @name fetch
+     * @description Fetch a deserialized `EscrowAccount`.
+     * @param agentPda - The agent account PDA.
+     * @param depositor - The depositor wallet. Defaults to the connected wallet.
+     * @returns {Promise<EscrowAccountData>} The escrow account data.
+     * @throws Will throw if the escrow account does not exist.
+     * @since v0.1.0
+     */
+    fetch(agentPda: PublicKey, depositor?: PublicKey): Promise<EscrowAccountData>;
+    /**
+     * @name fetchNullable
+     * @description Fetch a deserialized `EscrowAccount`, or `null` if it
+     *   does not exist on-chain.
+     * @param agentPda - The agent account PDA.
+     * @param depositor - The depositor wallet. Defaults to the connected wallet.
+     * @returns {Promise<EscrowAccountData | null>} The escrow data or `null`.
+     * @since v0.1.0
+     */
+    fetchNullable(agentPda: PublicKey, depositor?: PublicKey): Promise<EscrowAccountData | null>;
+    /**
+     * @name fetchByPda
+     * @description Fetch an escrow account by its PDA address directly,
+     *   bypassing PDA derivation.
+     * @param escrowPda - The escrow PDA public key.
+     * @returns {Promise<EscrowAccountData>} The escrow account data.
+     * @throws Will throw if the escrow account does not exist.
+     * @since v0.1.0
+     */
+    fetchByPda(escrowPda: PublicKey): Promise<EscrowAccountData>;
+}
+//# sourceMappingURL=escrow.d.ts.map

package/dist/esm/modules/escrow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escrow.d.ts","sourceRoot":"","sources":["../../../src/modules/escrow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAQpC,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACX,MAAM,UAAU,CAAC;AAMlB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAK3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,YAAa,SAAQ,UAAU;IAG1C;;;;;;;;OAQG;IACH,YAAY,CACV,QAAQ,EAAE,SAAS,EACnB,SAAS,CAAC,EAAE,SAAS,GACpB,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAM/B;;;;;;;;;;;;;;OAcG;IACG,MAAM,CACV,WAAW,EAAE,SAAS,EACtB,IAAI,EAAE,gBAAgB,EACtB,WAAW,GAAE,WAAW,EAAO,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IAkChC;;;;;;;;OAQG;IACG,OAAO,CACX,WAAW,EAAE,SAAS,EACtB,MAAM,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,EAC5B,WAAW,GAAE,WAAW,EAAO,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IAiChC;;;;;;;;;;;;OAYG;IACG,MAAM,CACV,eAAe,EAAE,SAAS,EAC1B,aAAa,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,EACnC,WAAW,EAAE,MAAM,EAAE,EACrB,WAAW,GAAE,WAAW,EAAO,EAC/B,IAAI,CAAC,EAAE,aAAa,GACnB,OAAO,CAAC,oBAAoB,CAAC;IA4BhC;;;;;;;;OAQG;IACG,QAAQ,CACZ,WAAW,EAAE,SAAS,EACtB,MAAM,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,EAC5B,WAAW,GAAE,WAAW,EAAO,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IAuChC;;;;;;OAMG;IACG,KAAK,CAAC,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA0BlE;;;;;;;;;;;;;;;;;;;OAmBG;IACG,WAAW,CACf,eAAe,EAAE,SAAS,EAC1B,WAAW,EAAE,UAAU,EAAE,EACzB,SAAS,CAAC,EAAE,UAAU,GAAG,MAAM,EAAE,GAAG,IAAI,EACxC,WAAW,GAAE,WAAW,EAAO,EAC/B,IAAI,CAAC,EAAE,aAAa,GACnB,OAAO,CAAC,oBAAoB,CAAC;IAgDhC;;;;;;;;OAQG;IACG,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKnF;;;;;;;;OAQG;IACG,aAAa,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAKlG;;;;;;;;OAQG;IACG,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAGnE"}

package/dist/esm/modules/escrow.js

@@ -0,0 +1,332 @@
+/**
+ * @module escrow
+ * @description x402 escrow settlement layer — create, deposit,
+ * settle, withdraw, batch settle, and close escrow accounts.
+ *
+ * Supports both SOL and SPL token escrows. SPL operations require
+ * passing additional `AccountMeta[]` via the `splAccounts` parameter.
+ *
+ * @category Modules
+ * @since v0.1.0
+ * @packageDocumentation
+ */
+import { SystemProgram, } from "@solana/web3.js";
+import { BaseModule } from "./base";
+import { deriveAgent, deriveAgentStats, deriveEscrow, deriveStake, deriveSettlementReceipt, } from "../pda";
+import { buildPriorityFeeIxs, computeBatchSettleCu, buildRpcOptions, } from "../utils/priority-fee";
+import { computeBatchRoot, hashToArray } from "../utils/hash";
+import { isAcceptedPaymentToken } from "../constants/payments";
+import { throwPredicted } from "../utils/anchor-errors";
+/**
+ * @name EscrowModule
+ * @description Manages x402-compatible escrow accounts for agent micropayments.
+ *   Provides methods to create, fund, settle, withdraw, batch-settle, close,
+ *   and fetch escrow PDAs on the Synapse Agent Protocol.
+ *
+ * @category Modules
+ * @since v0.1.0
+ * @extends BaseModule
+ *
+ * @example
+ * ```ts
+ * const sap = new SapClient(provider);
+ * // Create a SOL escrow for an agent
+ * const sig = await sap.escrow.create(agentWallet, {
+ *   pricePerCall: new BN(1_000_000),
+ *   maxCalls: new BN(100),
+ *   initialDeposit: new BN(100_000_000),
+ *   expiresAt: null,
+ *   volumeCurve: null,
+ *   tokenMint: null,
+ *   tokenDecimals: null,
+ * });
+ * ```
+ *
+ * @deprecated Since v0.7.0 — Use {@link EscrowV2Module} (`client.escrowV2`) instead.
+ * V1 escrows lack settlement security, dispute resolution, and staking integration.
+ * Existing V1 escrows can be migrated via `client.escrowV2.migrateFromV1()`.
+ */
+export class EscrowModule extends BaseModule {
+    // ── PDA helpers ──────────────────────────────────────
+    /**
+     * @name deriveEscrow
+     * @description Derive the `EscrowAccount` PDA for a given agent and depositor.
+     * @param agentPda - The agent account PDA.
+     * @param depositor - The depositor wallet. Defaults to the connected wallet.
+     * @returns A tuple of `[PublicKey, bump]` for the escrow PDA.
+     * @see {@link deriveEscrow} from `pda/` module for the underlying derivation.
+     * @since v0.1.0
+     */
+    deriveEscrow(agentPda, depositor) {
+        return deriveEscrow(agentPda, depositor ?? this.walletPubkey);
+    }
+    // ── Instructions ─────────────────────────────────────
+    /**
+     * @name create
+     * @description Create a new escrow for agent micropayments.
+     *
+     *   For **SOL escrow**: pass `tokenMint: null` and leave `splAccounts` empty.
+     *   For **SPL escrow**: pass `tokenMint`, `tokenDecimals`, and provide
+     *   `splAccounts` with `[depositorAta, escrowAta, tokenMint, tokenProgram]`.
+     *
+     * @param agentWallet - The wallet of the agent to pay.
+     * @param args - Escrow creation parameters (price, max calls, deposit, expiry, volume curve, token info).
+     * @param splAccounts - Remaining accounts for SPL token transfers:
+     *   `[depositorAta, escrowAta, tokenMint, tokenProgram]`. Defaults to `[]`.
+     * @returns {Promise<TransactionSignature>} The transaction signature.
+     * @since v0.1.0
+     */
+    async create(agentWallet, args, splAccounts = []) {
+        // v0.10.0 client-side guard — surface the on-chain rejection earlier.
+        if (!isAcceptedPaymentToken(args.tokenMint ?? null)) {
+            throw new Error("createEscrow: tokenMint must be null (SOL) or USDC (mainnet/devnet). " +
+                "On-chain will reject with PaymentTokenNotAllowed.");
+        }
+        const [agentPda] = deriveAgent(agentWallet);
+        const [escrowPda] = this.deriveEscrow(agentPda);
+        const [stakePda] = deriveStake(agentPda);
+        return this.methods
+            .createEscrow(args.pricePerCall, args.maxCalls, args.initialDeposit, args.expiresAt, args.volumeCurve, args.tokenMint, args.tokenDecimals)
+            .accounts({
+            depositor: this.walletPubkey,
+            agent: agentPda,
+            agentStake: stakePda,
+            escrow: escrowPda,
+            systemProgram: SystemProgram.programId,
+        })
+            .remainingAccounts(splAccounts)
+            .rpc();
+    }
+    /**
+     * @name deposit
+     * @description Deposit additional funds into an existing escrow.
+     * @param agentWallet - The wallet of the agent associated with the escrow.
+     * @param amount - The amount to deposit (lamports for SOL, smallest unit for SPL).
+     * @param splAccounts - Remaining accounts for SPL token transfers. Defaults to `[]`.
+     * @returns {Promise<TransactionSignature>} The transaction signature.
+     * @since v0.1.0
+     */
+    async deposit(agentWallet, amount, splAccounts = []) {
+        const [agentPda] = deriveAgent(agentWallet);
+        const [escrowPda] = this.deriveEscrow(agentPda);
+        // v0.13.0 preflight — escrow must exist; SPL deposits must include the
+        // 4 expected remaining accounts; SOL deposits must NOT include them.
+        const escrow = await this.requireAccountExists("escrowAccount", escrowPda, { predicted: "NotAuthority", hint: "Escrow PDA not found — call createEscrow first" });
+        const isSpl = escrow.tokenMint != null;
+        if (isSpl && splAccounts.length < 4) {
+            throwPredicted("SplTokenRequired", "Pass [depositorAta, escrowAta, tokenMint, tokenProgram] in splAccounts");
+        }
+        if (!isSpl && splAccounts.length > 0) {
+            throwPredicted("InvalidTokenAccount", "SOL escrow does not accept splAccounts; pass an empty array");
+        }
+        if (BigInt(this.bn(amount).toString()) <= 0n) {
+            throwPredicted("InsufficientEscrowBalance", "Deposit amount must be > 0");
+        }
+        return this.methods
+            .depositEscrow(this.bn(amount))
+            .accounts({
+            depositor: this.walletPubkey,
+            escrow: escrowPda,
+            systemProgram: SystemProgram.programId,
+        })
+            .remainingAccounts(splAccounts)
+            .rpc();
+    }
+    /**
+     * @name settle
+     * @description Agent settles calls — claims earned funds from the escrow.
+     *   Must be called by the agent owner wallet.
+     * @param depositorWallet - The wallet of the client who funded the escrow.
+     * @param callsToSettle - Number of calls to settle payment for.
+     * @param serviceHash - A 32-byte SHA-256 hash identifying the service rendered.
+     * @param splAccounts - Remaining accounts for SPL token transfers. Defaults to `[]`.
+     * @param opts - Optional {@link SettleOptions} for priority fees and RPC tuning.
+     * @returns {Promise<TransactionSignature>} The transaction signature.
+     * @since v0.1.0
+     * @updated v0.6.2 — Added optional `opts` parameter for priority fees.
+     */
+    async settle(depositorWallet, callsToSettle, serviceHash, splAccounts = [], opts) {
+        const [agentPda] = deriveAgent(this.walletPubkey);
+        const [escrowPda] = deriveEscrow(agentPda, depositorWallet);
+        const [statsPda] = deriveAgentStats(agentPda);
+        const [receiptPda] = deriveSettlementReceipt(escrowPda, serviceHash);
+        const preIxs = buildPriorityFeeIxs(opts);
+        const rpcOpts = buildRpcOptions(opts);
+        let builder = this.methods
+            .settleCalls(this.bn(callsToSettle), serviceHash)
+            .accounts({
+            wallet: this.walletPubkey,
+            agent: agentPda,
+            agentStats: statsPda,
+            escrow: escrowPda,
+            settlementReceipt: receiptPda,
+            systemProgram: SystemProgram.programId,
+        })
+            .remainingAccounts(splAccounts);
+        if (preIxs.length > 0) {
+            builder = builder.preInstructions(preIxs);
+        }
+        return builder.rpc(rpcOpts);
+    }
+    /**
+     * @name withdraw
+     * @description Client withdraws un-settled funds from their escrow.
+     * @param agentWallet - The wallet of the agent associated with the escrow.
+     * @param amount - The amount to withdraw (lamports for SOL, smallest unit for SPL).
+     * @param splAccounts - Remaining accounts for SPL token transfers. Defaults to `[]`.
+     * @returns {Promise<TransactionSignature>} The transaction signature.
+     * @since v0.1.0
+     */
+    async withdraw(agentWallet, amount, splAccounts = []) {
+        const [agentPda] = deriveAgent(agentWallet);
+        const [escrowPda] = this.deriveEscrow(agentPda);
+        // v0.13.0 preflight — verify balance covers amount, token program shape
+        // matches, and depositor matches the on-chain depositor.
+        const escrow = await this.requireAccountExists("escrowAccount", escrowPda, { predicted: "NotAuthority", hint: "Escrow PDA not found" });
+        const wantBN = this.bn(amount);
+        const want = BigInt(wantBN.toString());
+        if (want <= 0n)
+            throwPredicted("InsufficientEscrowBalance", "Withdraw amount must be > 0");
+        if (want > BigInt(escrow.balance.toString())) {
+            throwPredicted("InsufficientEscrowBalance", `requested ${want}, escrow.balance ${escrow.balance.toString()}`);
+        }
+        const isSpl = escrow.tokenMint != null;
+        if (isSpl && splAccounts.length < 4) {
+            throwPredicted("SplTokenRequired", "Pass [depositorAta, escrowAta, tokenMint, tokenProgram]");
+        }
+        if (!isSpl && splAccounts.length > 0) {
+            throwPredicted("InvalidTokenAccount", "SOL escrow does not accept splAccounts");
+        }
+        return this.methods
+            .withdrawEscrow(this.bn(amount))
+            .accounts({
+            depositor: this.walletPubkey,
+            escrow: escrowPda,
+            systemProgram: SystemProgram.programId,
+        })
+            .remainingAccounts(splAccounts)
+            .rpc();
+    }
+    /**
+     * @name close
+     * @description Close an empty escrow PDA (balance must be 0) and reclaim rent.
+     * @param agentWallet - The wallet of the agent associated with the escrow.
+     * @returns {Promise<TransactionSignature>} The transaction signature.
+     * @since v0.1.0
+     */
+    async close(agentWallet) {
+        const [agentPda] = deriveAgent(agentWallet);
+        const [escrowPda] = this.deriveEscrow(agentPda);
+        // v0.13.0 preflight — close fails on-chain if balance != 0.
+        const escrow = await this.requireAccountExists("escrowAccount", escrowPda, { predicted: "NotAuthority", hint: "Escrow PDA already closed or never created" });
+        if (BigInt(escrow.balance.toString()) !== 0n) {
+            throwPredicted("EscrowNotEmpty", `balance ${escrow.balance.toString()} > 0 — withdraw remaining funds first`);
+        }
+        return this.methods
+            .closeEscrow()
+            .accounts({
+            depositor: this.walletPubkey,
+            escrow: escrowPda,
+        })
+            .rpc();
+    }
+    /**
+     * @name settleBatch
+     * @description Batch settlement — process up to 10 settlements in a single
+     *   transaction. Must be called by the agent owner wallet.
+     *
+     * @param depositorWallet - The wallet of the client who funded the escrow.
+     * @param settlements - Array of settlement entries (up to 10).
+     * @param batchRoot - Optional pre-computed batch root
+     *   (`sha256(s_0 || s_1 || ... || s_{N-1})`). When omitted the SDK
+     *   computes it from `settlements[*].serviceHash`. **Required on-chain
+     *   since v0.10.0** to seed the anti-replay receipt PDA.
+     * @param splAccounts - Remaining accounts for SPL token transfers. Defaults to `[]`.
+     * @param opts - Optional {@link SettleOptions} for priority fees and RPC tuning.
+     * @returns {Promise<TransactionSignature>} The transaction signature.
+     *
+     * @since v0.1.0
+     * @updated v0.6.2 — Added optional `opts` parameter for priority fees.
+     * @updated v0.10.0 — Added `batchRoot` argument and required
+     *   `settlementReceipt` PDA on-chain (anti-replay).
+     */
+    async settleBatch(depositorWallet, settlements, batchRoot, splAccounts = [], opts) {
+        const [agentPda] = deriveAgent(this.walletPubkey);
+        const [escrowPda] = deriveEscrow(agentPda, depositorWallet);
+        const [statsPda] = deriveAgentStats(agentPda);
+        const rootBytes = batchRoot && batchRoot !== null
+            ? batchRoot instanceof Uint8Array
+                ? batchRoot
+                : Uint8Array.from(batchRoot)
+            : computeBatchRoot(settlements.map((s) => s.serviceHash));
+        const rootArr = hashToArray(rootBytes);
+        const [receiptPda] = deriveSettlementReceipt(escrowPda, rootBytes);
+        // Auto-size CU to the batch length so callers don't have to think
+        // about it. The default Solana cap (200k) overflows past ~8
+        // settlements; we compute a tight ceiling and let the caller
+        // override via `opts.computeUnits` if they want.
+        // Setting the CU limit is FREE — it doesn't add lamports, only
+        // caps the maximum the runtime is allowed to charge.
+        const effectiveOpts = {
+            ...opts,
+            computeUnits: opts?.computeUnits ?? computeBatchSettleCu(settlements.length),
+        };
+        const preIxs = buildPriorityFeeIxs(effectiveOpts);
+        const rpcOpts = buildRpcOptions(effectiveOpts);
+        let builder = this.methods
+            .settleBatch(settlements, rootArr)
+            .accountsPartial({
+            wallet: this.walletPubkey,
+            agent: agentPda,
+            agentStats: statsPda,
+            escrow: escrowPda,
+            settlementReceipt: receiptPda,
+            systemProgram: SystemProgram.programId,
+        })
+            .remainingAccounts(splAccounts);
+        if (preIxs.length > 0) {
+            builder = builder.preInstructions(preIxs);
+        }
+        return builder.rpc(rpcOpts);
+    }
+    // ── Fetchers ─────────────────────────────────────────
+    /**
+     * @name fetch
+     * @description Fetch a deserialized `EscrowAccount`.
+     * @param agentPda - The agent account PDA.
+     * @param depositor - The depositor wallet. Defaults to the connected wallet.
+     * @returns {Promise<EscrowAccountData>} The escrow account data.
+     * @throws Will throw if the escrow account does not exist.
+     * @since v0.1.0
+     */
+    async fetch(agentPda, depositor) {
+        const [pda] = this.deriveEscrow(agentPda, depositor);
+        return this.fetchAccount("escrowAccount", pda);
+    }
+    /**
+     * @name fetchNullable
+     * @description Fetch a deserialized `EscrowAccount`, or `null` if it
+     *   does not exist on-chain.
+     * @param agentPda - The agent account PDA.
+     * @param depositor - The depositor wallet. Defaults to the connected wallet.
+     * @returns {Promise<EscrowAccountData | null>} The escrow data or `null`.
+     * @since v0.1.0
+     */
+    async fetchNullable(agentPda, depositor) {
+        const [pda] = this.deriveEscrow(agentPda, depositor);
+        return this.fetchAccountNullable("escrowAccount", pda);
+    }
+    /**
+     * @name fetchByPda
+     * @description Fetch an escrow account by its PDA address directly,
+     *   bypassing PDA derivation.
+     * @param escrowPda - The escrow PDA public key.
+     * @returns {Promise<EscrowAccountData>} The escrow account data.
+     * @throws Will throw if the escrow account does not exist.
+     * @since v0.1.0
+     */
+    async fetchByPda(escrowPda) {
+        return this.fetchAccount("escrowAccount", escrowPda);
+    }
+}
+//# sourceMappingURL=escrow.js.map

package/dist/esm/modules/escrow.js.map

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

package/dist/esm/modules/feedback.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @module feedback
+ * @description Trustless reputation system — give, update, revoke, and close
+ *   on-chain feedback entries for agents.
+ *
+ * Feedback entries are PDA-based reviews tied to an agent and a reviewer wallet,
+ * enabling permissionless, verifiable reputation on Solana.
+ *
+ * @category Modules
+ * @since v0.1.0
+ * @packageDocumentation
+ */
+import { type PublicKey, type TransactionSignature } from "@solana/web3.js";
+import { BaseModule } from "./base";
+import type { FeedbackAccountData, GiveFeedbackArgs, UpdateFeedbackArgs } from "../types";
+/**
+ * @name FeedbackModule
+ * @description Manages on-chain feedback entries for the Synapse Agent Protocol.
+ *   Provides methods to give, update, revoke, close, and fetch feedback PDAs
+ *   that form the trustless reputation layer.
+ *
+ * @category Modules
+ * @since v0.1.0
+ * @extends BaseModule
+ *
+ * @example
+ * ```ts
+ * const sap = new SapClient(provider);
+ * const sig = await sap.feedback.give(agentWallet, {
+ *   score: 5,
+ *   tag: { quality: {} },
+ *   commentHash: null,
+ * });
+ * ```
+ */
+export declare class FeedbackModule extends BaseModule {
+    /**
+     * @name deriveFeedback
+     * @description Derive the `FeedbackAccount` PDA for a given agent and reviewer.
+     * @param agentPda - The agent account PDA to review.
+     * @param reviewer - The reviewer wallet. Defaults to the connected wallet.
+     * @returns A tuple of `[PublicKey, bump]` for the feedback PDA.
+     * @see {@link deriveFeedback} from `pda/` module for the underlying derivation.
+     * @since v0.1.0
+     */
+    deriveFeedback(agentPda: PublicKey, reviewer?: PublicKey): readonly [PublicKey, number];
+    /**
+     * @name give
+     * @description Leave on-chain feedback for an agent. Creates a new
+     *   `FeedbackAccount` PDA owned by the reviewer.
+     * @param agentWallet - The wallet that owns the target agent.
+     * @param args - Feedback parameters (score, tag, optional comment hash).
+     * @returns {Promise<TransactionSignature>} The transaction signature.
+     * @since v0.1.0
+     */
+    give(agentWallet: PublicKey, args: GiveFeedbackArgs): Promise<TransactionSignature>;
+    /**
+     * @name update
+     * @description Update an existing feedback entry. Only the original reviewer
+     *   may update their feedback.
+     * @param agentWallet - The wallet that owns the target agent.
+     * @param args - Updated feedback parameters (new score, optional new tag, optional comment hash).
+     * @returns {Promise<TransactionSignature>} The transaction signature.
+     * @since v0.1.0
+     */
+    update(agentWallet: PublicKey, args: UpdateFeedbackArgs): Promise<TransactionSignature>;
+    /**
+     * @name revoke
+     * @description Revoke a feedback entry, marking it as revoked and excluding
+     *   it from reputation calculations.
+     * @param agentWallet - The wallet that owns the target agent.
+     * @returns {Promise<TransactionSignature>} The transaction signature.
+     * @since v0.1.0
+     */
+    revoke(agentWallet: PublicKey): Promise<TransactionSignature>;
+    /**
+     * @name close
+     * @description Close a revoked feedback PDA and reclaim rent to the reviewer.
+     * @param agentWallet - The wallet that owns the target agent.
+     * @returns {Promise<TransactionSignature>} The transaction signature.
+     * @since v0.1.0
+     */
+    close(agentWallet: PublicKey): Promise<TransactionSignature>;
+    /**
+     * @name fetch
+     * @description Fetch a deserialized `FeedbackAccount`.
+     * @param agentPda - The agent account PDA.
+     * @param reviewer - The reviewer wallet. Defaults to the connected wallet.
+     * @returns {Promise<FeedbackAccountData>} The feedback account data.
+     * @throws Will throw if the feedback account does not exist.
+     * @since v0.1.0
+     */
+    fetch(agentPda: PublicKey, reviewer?: PublicKey): Promise<FeedbackAccountData>;
+    /**
+     * @name fetchNullable
+     * @description Fetch a deserialized `FeedbackAccount`, or `null` if it
+     *   does not exist on-chain.
+     * @param agentPda - The agent account PDA.
+     * @param reviewer - The reviewer wallet. Defaults to the connected wallet.
+     * @returns {Promise<FeedbackAccountData | null>} The feedback data or `null`.
+     * @since v0.1.0
+     */
+    fetchNullable(agentPda: PublicKey, reviewer?: PublicKey): Promise<FeedbackAccountData | null>;
+}
+//# sourceMappingURL=feedback.d.ts.map

package/dist/esm/modules/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../../src/modules/feedback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAiB,KAAK,SAAS,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE1F;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAG5C;;;;;;;;OAQG;IACH,cAAc,CACZ,QAAQ,EAAE,SAAS,EACnB,QAAQ,CAAC,EAAE,SAAS,GACnB,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAM/B;;;;;;;;OAQG;IACG,IAAI,CACR,WAAW,EAAE,SAAS,EACtB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,oBAAoB,CAAC;IAiBhC;;;;;;;;OAQG;IACG,MAAM,CACV,WAAW,EAAE,SAAS,EACtB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,oBAAoB,CAAC;IAchC;;;;;;;OAOG;IACG,MAAM,CAAC,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAcnE;;;;;;OAMG;IACG,KAAK,CAAC,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAelE;;;;;;;;OAQG;IACG,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAKpF;;;;;;;;OAQG;IACG,aAAa,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;CAIpG"}