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

package/dist/esm/modules/escrow.js

@@ -1,296 +0,0 @@
-/**
- * @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";
-/**
- * @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);
-        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);
-        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);
-        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

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

package/dist/esm/modules/feedback.js

@@ -1,162 +0,0 @@
-/**
- * @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 { SystemProgram } from "@solana/web3.js";
-import { BaseModule } from "./base";
-import { deriveAgent, deriveFeedback, deriveGlobalRegistry } from "../pda";
-/**
- * @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 class FeedbackModule extends BaseModule {
-    // ── PDA helpers ──────────────────────────────────────
-    /**
-     * @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, reviewer) {
-        return deriveFeedback(agentPda, reviewer ?? this.walletPubkey);
-    }
-    // ── Instructions ─────────────────────────────────────
-    /**
-     * @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
-     */
-    async give(agentWallet, args) {
-        const [agentPda] = deriveAgent(agentWallet);
-        const [feedbackPda] = this.deriveFeedback(agentPda);
-        const [globalPda] = deriveGlobalRegistry();
-        return this.methods
-            .giveFeedback(args.score, args.tag, args.commentHash ?? null)
-            .accounts({
-            reviewer: this.walletPubkey,
-            agent: agentPda,
-            feedback: feedbackPda,
-            globalRegistry: globalPda,
-            systemProgram: SystemProgram.programId,
-        })
-            .rpc();
-    }
-    /**
-     * @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
-     */
-    async update(agentWallet, args) {
-        const [agentPda] = deriveAgent(agentWallet);
-        const [feedbackPda] = this.deriveFeedback(agentPda);
-        return this.methods
-            .updateFeedback(args.newScore, args.newTag ?? null, args.commentHash ?? null)
-            .accounts({
-            reviewer: this.walletPubkey,
-            agent: agentPda,
-            feedback: feedbackPda,
-        })
-            .rpc();
-    }
-    /**
-     * @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
-     */
-    async revoke(agentWallet) {
-        const [agentPda] = deriveAgent(agentWallet);
-        const [feedbackPda] = this.deriveFeedback(agentPda);
-        return this.methods
-            .revokeFeedback()
-            .accounts({
-            reviewer: this.walletPubkey,
-            agent: agentPda,
-            feedback: feedbackPda,
-        })
-            .rpc();
-    }
-    /**
-     * @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
-     */
-    async close(agentWallet) {
-        const [agentPda] = deriveAgent(agentWallet);
-        const [feedbackPda] = this.deriveFeedback(agentPda);
-        return this.methods
-            .closeFeedback()
-            .accounts({
-            reviewer: this.walletPubkey,
-            feedback: feedbackPda,
-        })
-            .rpc();
-    }
-    // ── Fetchers ─────────────────────────────────────────
-    /**
-     * @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
-     */
-    async fetch(agentPda, reviewer) {
-        const [pda] = this.deriveFeedback(agentPda, reviewer);
-        return this.fetchAccount("feedbackAccount", pda);
-    }
-    /**
-     * @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
-     */
-    async fetchNullable(agentPda, reviewer) {
-        const [pda] = this.deriveFeedback(agentPda, reviewer);
-        return this.fetchAccountNullable("feedbackAccount", pda);
-    }
-}
-//# sourceMappingURL=feedback.js.map

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

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

package/dist/esm/modules/index.js

@@ -1,27 +0,0 @@
-/**
- * @module modules
- * @description Barrel export for all domain modules of the `@synapse-sap/sdk`.
- *
- * Re-exports every module class so consumers can import from a single entry point:
- * ```ts
- * import { AgentModule, VaultModule } from "@synapse-sap/sdk/modules";
- * ```
- *
- * @category Modules
- * @since v0.1.0
- * @packageDocumentation
- */
-export { AgentModule } from "./agent";
-export { FeedbackModule } from "./feedback";
-export { IndexingModule } from "./indexing";
-export { ToolsModule } from "./tools";
-export { VaultModule } from "./vault";
-export { EscrowModule } from "./escrow";
-export { EscrowV2Module } from "./escrow-v2";
-export { ReceiptModule } from "./receipt";
-export { StakingModule } from "./staking";
-export { SubscriptionModule } from "./subscription";
-export { AttestationModule } from "./attestation";
-export { LedgerModule } from "./ledger";
-export { BaseModule } from "./base";
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC"}