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

package/dist/types/modules/agent.d.ts

@@ -1,166 +0,0 @@
-/**
- * @module agent
- * @description Agent lifecycle operations for the Synapse Agent Protocol.
- *
- * Covers: register, update, deactivate, reactivate, close,
- * report calls, update reputation metrics, and account fetching.
- *
- * @category Modules
- * @since v0.1.0
- * @packageDocumentation
- */
-import { type PublicKey, type TransactionSignature } from "@solana/web3.js";
-import { BaseModule } from "./base";
-import type { AgentAccountData, AgentStatsData, RegisterAgentArgs, UpdateAgentArgs } from "../types";
-/**
- * @name AgentModule
- * @description Manages the full agent lifecycle on the Synapse Agent Protocol.
- *   Provides methods to register, update, deactivate, reactivate, and close
- *   agent identities, as well as self-report call metrics and reputation data.
- *
- * @category Modules
- * @since v0.1.0
- * @extends BaseModule
- *
- * @example
- * ```ts
- * const sap = new SapClient(provider);
- * // Register a new agent
- * const sig = await sap.agent.register({
- *   name: "my-agent",
- *   description: "An example agent",
- *   capabilities: [0, 1],
- *   pricing: { free: {} },
- *   protocols: [0],
- * });
- * // Fetch agent data
- * const data = await sap.agent.fetch();
- * ```
- */
-export declare class AgentModule extends BaseModule {
-    /**
-     * @name deriveAgent
-     * @description Derive the `AgentAccount` PDA for a wallet.
-     * @param wallet - The wallet public key. Defaults to the connected wallet.
-     * @returns A tuple of `[PublicKey, bump]` for the agent PDA.
-     * @see {@link deriveAgent} from `pda/` module for the underlying derivation.
-     * @since v0.1.0
-     */
-    deriveAgent(wallet?: PublicKey): readonly [PublicKey, number];
-    /**
-     * @name deriveStats
-     * @description Derive the `AgentStats` PDA for a given agent.
-     * @param agentPda - The agent account PDA.
-     * @returns A tuple of `[PublicKey, bump]` for the stats PDA.
-     * @see {@link deriveAgentStats} from `pda/` module for the underlying derivation.
-     * @since v0.1.0
-     */
-    deriveStats(agentPda: PublicKey): readonly [PublicKey, number];
-    /**
-     * @name register
-     * @description Register a new agent identity on-chain. Creates the
-     *   `AgentAccount`, `AgentStats`, and updates the `GlobalRegistry`.
-     * @param args - Registration parameters (name, description, capabilities, pricing, protocols, etc.).
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    register(args: RegisterAgentArgs): Promise<TransactionSignature>;
-    /**
-     * @name update
-     * @description Update an existing agent's metadata fields. All fields
-     *   are optional — only non-null values are written.
-     * @param args - Partial update parameters.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    update(args: UpdateAgentArgs): Promise<TransactionSignature>;
-    /**
-     * @name deactivate
-     * @description Deactivate an agent, setting `is_active = false`.
-     *   The agent remains on-chain but is excluded from active discovery.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    deactivate(): Promise<TransactionSignature>;
-    /**
-     * @name reactivate
-     * @description Reactivate a previously deactivated agent, restoring
-     *   it to active status.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    reactivate(): Promise<TransactionSignature>;
-    /**
-     * @name close
-     * @description Close an agent PDA and its associated stats PDA.
-     *   Rent is returned to the owner wallet.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    close(): Promise<TransactionSignature>;
-    /**
-     * @name reportCalls
-     * @description Self-report call metrics for the agent. This updates the
-     *   `AgentStats` counter but does not affect on-chain reputation.
-     * @param callsServed - The number of calls to report.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    reportCalls(callsServed: number | bigint): Promise<TransactionSignature>;
-    /**
-     * @name updateReputation
-     * @description Update self-reported latency and uptime metrics.
-     *   These are informational and do not affect on-chain reputation scoring.
-     * @param avgLatencyMs - Average response latency in milliseconds.
-     * @param uptimePercent - Uptime percentage (0–100).
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    updateReputation(avgLatencyMs: number, uptimePercent: number): Promise<TransactionSignature>;
-    /**
-     * @name fetch
-     * @description Fetch the deserialized `AgentAccount` data for a wallet.
-     * @param wallet - The wallet public key. Defaults to the connected wallet.
-     * @returns {Promise<AgentAccountData>} The agent account data.
-     * @throws Will throw if the agent account does not exist.
-     * @since v0.1.0
-     */
-    fetch(wallet?: PublicKey): Promise<AgentAccountData>;
-    /**
-     * @name fetchNullable
-     * @description Fetch the deserialized `AgentAccount` data, or `null`
-     *   if the account doesn't exist on-chain.
-     * @param wallet - The wallet public key. Defaults to the connected wallet.
-     * @returns {Promise<AgentAccountData | null>} The agent data or `null`.
-     * @since v0.1.0
-     */
-    fetchNullable(wallet?: PublicKey): Promise<AgentAccountData | null>;
-    /**
-     * @name fetchStats
-     * @description Fetch the deserialized `AgentStats` data for an agent.
-     * @param agentPda - The agent account PDA.
-     * @returns {Promise<AgentStatsData>} The agent stats data.
-     * @throws Will throw if the stats account does not exist.
-     * @since v0.1.0
-     */
-    fetchStats(agentPda: PublicKey): Promise<AgentStatsData>;
-    /**
-     * @name fetchStatsNullable
-     * @description Fetch the deserialized `AgentStats` data, or `null`
-     *   if the account doesn't exist on-chain.
-     * @param agentPda - The agent account PDA.
-     * @returns {Promise<AgentStatsData | null>} The stats data or `null`.
-     * @since v0.1.0
-     */
-    fetchStatsNullable(agentPda: PublicKey): Promise<AgentStatsData | null>;
-    /**
-     * @name fetchGlobalRegistry
-     * @description Fetch the `GlobalRegistry` singleton account that tracks
-     *   aggregate protocol statistics.
-     * @returns {Promise<GlobalRegistryData>} The global registry data.
-     * @throws Will throw if the registry has not been initialized.
-     * @since v0.1.0
-     */
-    fetchGlobalRegistry(): Promise<import("../types").GlobalRegistryData>;
-}
-//# sourceMappingURL=agent.d.ts.map

package/dist/types/modules/agent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/modules/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAiB,KAAK,SAAS,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,eAAe,EAChB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,WAAY,SAAQ,UAAU;IAGzC;;;;;;;OAOG;IACH,WAAW,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAI7D;;;;;;;OAOG;IACH,WAAW,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAM9D;;;;;;;OAOG;IACG,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA0BtE;;;;;;;OAOG;IACG,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsBlE;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAcjD;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAcjD;;;;;;OAMG;IACG,KAAK,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAiB5C;;;;;;;OAOG;IACG,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAc9E;;;;;;;;OAQG;IACG,gBAAgB,CACpB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,oBAAoB,CAAC;IAchC;;;;;;;OAOG;IACG,KAAK,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAK1D;;;;;;;OAOG;IACG,aAAa,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAKzE;;;;;;;OAOG;IACG,UAAU,CAAC,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC;IAK9D;;;;;;;OAOG;IACG,kBAAkB,CAAC,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAK7E;;;;;;;OAOG;IACG,mBAAmB,IAAI,OAAO,CAAC,OAAO,UAAU,EAAE,kBAAkB,CAAC;CAI5E"}

package/dist/types/modules/attestation.d.ts

@@ -1,96 +0,0 @@
-/**
- * @module attestation
- * @description Web-of-trust attestations — create, revoke, and close
- *   on-chain attestations that vouch for agent trustworthiness.
- *
- * Attestations are signed endorsements from one wallet to an agent,
- * forming a composable trust graph on Solana.
- *
- * @category Modules
- * @since v0.1.0
- * @packageDocumentation
- */
-import { type PublicKey, type TransactionSignature } from "@solana/web3.js";
-import { BaseModule } from "./base";
-import type { AgentAttestationData, CreateAttestationArgs } from "../types";
-/**
- * @name AttestationModule
- * @description Manages on-chain attestations for the Synapse Agent Protocol.
- *   Provides methods to create, revoke, close, and fetch attestation PDAs
- *   that form the web-of-trust layer.
- *
- * @category Modules
- * @since v0.1.0
- * @extends BaseModule
- *
- * @example
- * ```ts
- * const sap = new SapClient(provider);
- * // Create an attestation for an agent
- * const sig = await sap.attestation.create(agentWallet, {
- *   attestationType: { identity: {} },
- *   metadataHash: [...],
- *   expiresAt: null,
- * });
- * ```
- */
-export declare class AttestationModule extends BaseModule {
-    /**
-     * @name deriveAttestation
-     * @description Derive the `AgentAttestation` PDA for a given agent and attester.
-     * @param agentPda - The agent account PDA to attest.
-     * @param attester - The attester wallet. Defaults to the connected wallet.
-     * @returns A tuple of `[PublicKey, bump]` for the attestation PDA.
-     * @see {@link deriveAttestation} from `pda/` module for the underlying derivation.
-     * @since v0.1.0
-     */
-    deriveAttestation(agentPda: PublicKey, attester?: PublicKey): readonly [PublicKey, number];
-    /**
-     * @name create
-     * @description Create an on-chain attestation vouching for an agent.
-     *   The connected wallet becomes the attester.
-     * @param agentWallet - The wallet that owns the target agent.
-     * @param args - Attestation parameters (type, metadata hash, optional expiry).
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    create(agentWallet: PublicKey, args: CreateAttestationArgs): Promise<TransactionSignature>;
-    /**
-     * @name revoke
-     * @description Revoke a previously issued attestation. Only the original
-     *   attester may revoke.
-     * @param agentWallet - The wallet of the attested agent.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    revoke(agentWallet: PublicKey): Promise<TransactionSignature>;
-    /**
-     * @name close
-     * @description Close a revoked attestation PDA and reclaim rent to the attester.
-     * @param agentWallet - The wallet of the attested agent.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    close(agentWallet: PublicKey): Promise<TransactionSignature>;
-    /**
-     * @name fetch
-     * @description Fetch a deserialized `AgentAttestation` account.
-     * @param agentPda - The agent account PDA.
-     * @param attester - The attester wallet. Defaults to the connected wallet.
-     * @returns {Promise<AgentAttestationData>} The attestation account data.
-     * @throws Will throw if the attestation account does not exist.
-     * @since v0.1.0
-     */
-    fetch(agentPda: PublicKey, attester?: PublicKey): Promise<AgentAttestationData>;
-    /**
-     * @name fetchNullable
-     * @description Fetch a deserialized `AgentAttestation` account, or `null`
-     *   if it does not exist on-chain.
-     * @param agentPda - The agent account PDA.
-     * @param attester - The attester wallet. Defaults to the connected wallet.
-     * @returns {Promise<AgentAttestationData | null>} The attestation data or `null`.
-     * @since v0.1.0
-     */
-    fetchNullable(agentPda: PublicKey, attester?: PublicKey): Promise<AgentAttestationData | null>;
-}
-//# sourceMappingURL=attestation.d.ts.map

package/dist/types/modules/attestation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"attestation.d.ts","sourceRoot":"","sources":["../../../src/modules/attestation.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,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,iBAAkB,SAAQ,UAAU;IAG/C;;;;;;;;OAQG;IACH,iBAAiB,CACf,QAAQ,EAAE,SAAS,EACnB,QAAQ,CAAC,EAAE,SAAS,GACnB,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAM/B;;;;;;;;OAQG;IACG,MAAM,CACV,WAAW,EAAE,SAAS,EACtB,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,oBAAoB,CAAC;IAiBhC;;;;;;;OAOG;IACG,MAAM,CAAC,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAanE;;;;;;OAMG;IACG,KAAK,CAAC,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAiBlE;;;;;;;;OAQG;IACG,KAAK,CACT,QAAQ,EAAE,SAAS,EACnB,QAAQ,CAAC,EAAE,SAAS,GACnB,OAAO,CAAC,oBAAoB,CAAC;IAKhC;;;;;;;;OAQG;IACG,aAAa,CACjB,QAAQ,EAAE,SAAS,EACnB,QAAQ,CAAC,EAAE,SAAS,GACnB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;CAIxC"}

package/dist/types/modules/base.d.ts

@@ -1,126 +0,0 @@
-/**
- * @module base
- * @description Abstract base class for all SDK modules.
- *
- * Provides shared access to the Anchor program, provider,
- * and typed `fetch` / `fetchNullable` helpers.
- *
- * @category Modules
- * @since v0.1.0
- * @packageDocumentation
- */
-import { type AnchorProvider, type Program, BN } from "@coral-xyz/anchor";
-import type { PublicKey, TransactionSignature } from "@solana/web3.js";
-/**
- * Anchor `Program` instance typed for the Synapse Agent SAP IDL.
- *
- * @name SapProgram
- * @description Alias for `Program<any>` — the Anchor program reference
- *   used as the backbone of every module in the SDK.
- * @category Modules
- * @since v0.1.0
- */
-export type SapProgram = Program<any>;
-/**
- * @name SapTransactionResult
- * @description Instruction builder return type — a ready-to-send transaction.
- * Contains the finalized transaction signature after RPC submission.
- * @category Modules
- * @since v0.1.0
- */
-export interface SapTransactionResult {
-    /** The base-58 encoded transaction signature returned by the RPC node. */
-    readonly signature: TransactionSignature;
-}
-/**
- * @name BaseModule
- * @description Abstract base module inherited by every domain module in the SDK.
- * Encapsulates the Anchor program reference, provider access, and common
- * helpers for account fetching and BN construction.
- *
- * @abstract
- * @category Modules
- * @since v0.1.0
- *
- * @example
- * ```ts
- * class MyModule extends BaseModule {
- *   async doSomething() {
- *     const data = await this.fetchAccount<MyData>("myAccount", pda);
- *   }
- * }
- * ```
- */
-export declare abstract class BaseModule {
-    protected readonly program: SapProgram;
-    /**
-     * Create a new module instance.
-     *
-     * @param program - The Anchor `Program` instance for the SAP IDL.
-     * @protected
-     */
-    constructor(program: SapProgram);
-    /**
-     * @name methods
-     * @description Instruction method namespace — bypasses `noUncheckedIndexedAccess`
-     *   on `Program<any>` where every property is `T | undefined`.
-     *   Used internally by subclasses to build and send instructions.
-     * @returns The Anchor program `methods` object for chaining instruction builders.
-     * @protected
-     * @since v0.1.0
-     */
-    protected get methods(): any;
-    /**
-     * @name provider
-     * @description The AnchorProvider from the program, giving access to
-     *   the connection and wallet for signing transactions.
-     * @returns {AnchorProvider} The Anchor provider instance.
-     * @protected
-     * @since v0.1.0
-     */
-    protected get provider(): AnchorProvider;
-    /**
-     * @name walletPubkey
-     * @description Convenience accessor for the signer wallet's public key.
-     * @returns {PublicKey} The public key of the connected wallet.
-     * @protected
-     * @since v0.1.0
-     */
-    protected get walletPubkey(): PublicKey;
-    /**
-     * @name fetchAccount
-     * @description Generic account fetch — deserializes the on-chain account
-     *   data into the given type `T`, or throws if the account does not exist.
-     * @typeParam T - The expected deserialized account data type.
-     * @param accountName - The Anchor account discriminator name (e.g. `"agentAccount"`).
-     * @param address - The public key of the account to fetch.
-     * @returns {Promise<T>} The deserialized account data.
-     * @throws Will throw if the account does not exist on-chain.
-     * @protected
-     * @since v0.1.0
-     */
-    protected fetchAccount<T>(accountName: string, address: PublicKey): Promise<T>;
-    /**
-     * @name fetchAccountNullable
-     * @description Generic nullable account fetch — deserializes the on-chain
-     *   account data into type `T`, or returns `null` if the account does not exist.
-     * @typeParam T - The expected deserialized account data type.
-     * @param accountName - The Anchor account discriminator name (e.g. `"agentAccount"`).
-     * @param address - The public key of the account to fetch.
-     * @returns {Promise<T | null>} The deserialized account data, or `null`.
-     * @protected
-     * @since v0.1.0
-     */
-    protected fetchAccountNullable<T>(accountName: string, address: PublicKey): Promise<T | null>;
-    /**
-     * @name bn
-     * @description Create an Anchor `BN` from a number, bigint, or existing BN.
-     *   Passes through values that are already `BN` instances.
-     * @param value - The numeric value to convert.
-     * @returns {BN} An Anchor-compatible big number.
-     * @protected
-     * @since v0.1.0
-     */
-    protected bn(value: number | bigint | BN): BN;
-}
-//# sourceMappingURL=base.d.ts.map

package/dist/types/modules/base.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/modules/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,OAAO,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvE;;;;;;;;GAQG;AAEH,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;AAEtC;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,8BAAsB,UAAU;IAOlB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU;IANlD;;;;;OAKG;gBAC4B,OAAO,EAAE,UAAU;IAElD;;;;;;;;OAQG;IAEH,SAAS,KAAK,OAAO,IAAI,GAAG,CAG3B;IAED;;;;;;;OAOG;IACH,SAAS,KAAK,QAAQ,IAAI,cAAc,CAEvC;IAED;;;;;;OAMG;IACH,SAAS,KAAK,YAAY,IAAI,SAAS,CAEtC;IAED;;;;;;;;;;;OAWG;cACa,YAAY,CAAC,CAAC,EAC5B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,SAAS,GACjB,OAAO,CAAC,CAAC,CAAC;IAKb;;;;;;;;;;OAUG;cACa,oBAAoB,CAAC,CAAC,EACpC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,SAAS,GACjB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAKpB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,EAAE,GAAG,EAAE;CAI9C"}

package/dist/types/modules/escrow-v2.d.ts

@@ -1,100 +0,0 @@
-/**
- * @module escrow-v2
- * @description V2 escrow settlement layer — supports settlement security
- * modes (CoSigned, DisputeWindow), receipt-based dispute resolution,
- * pending settlements, and automatic resolution via merkle proofs.
- *
- * @category Modules
- * @since v0.7.0
- * @packageDocumentation
- */
-import { type PublicKey, type TransactionSignature, type AccountMeta, type Signer } from "@solana/web3.js";
-import { BN } from "@coral-xyz/anchor";
-import { BaseModule } from "./base";
-import type { EscrowAccountV2Data, PendingSettlementData, DisputeRecordData, CreateEscrowV2Args } from "../types";
-import type { SettleOptions } from "../utils/priority-fee";
-/**
- * @name EscrowV2Module
- * @description Manages V2 escrow accounts with settlement security modes,
- * dispute windows, and pending settlement flows.
- *
- * @category Modules
- * @since v0.7.0
- * @extends BaseModule
- */
-export declare class EscrowV2Module extends BaseModule {
-    /** Convert BN | number | bigint → number for PDA seed functions. */
-    private toNum;
-    deriveEscrow(agentPda: PublicKey, depositor?: PublicKey, nonce?: BN | number | bigint): readonly [PublicKey, number];
-    derivePendingSettlement(escrowV2Pda: PublicKey, settlementIndex: BN | number | bigint): readonly [PublicKey, number];
-    deriveDispute(pendingSettlementPda: PublicKey): readonly [PublicKey, number];
-    create(agentWallet: PublicKey, args: CreateEscrowV2Args, splAccounts?: AccountMeta[]): Promise<TransactionSignature>;
-    deposit(agentWallet: PublicKey, nonce: BN | number | bigint, amount: BN | number | bigint, splAccounts?: AccountMeta[]): Promise<TransactionSignature>;
-    settle(depositorWallet: PublicKey, nonce: BN | number | bigint, callsToSettle: BN | number | bigint, serviceHash: number[], splAccounts?: AccountMeta[], opts?: SettleOptions, coSigner?: Signer): Promise<TransactionSignature>;
-    /**
-     * Read the current `escrow.settlement_index` from chain.
-     *
-     * In DisputeWindow mode (`settlementSecurity = 2`), every successful
-     * `settleCallsV2` increments this value. The PRE-increment value is the
-     * one to pass to {@link createPendingSettlement} for that batch.
-     *
-     * @returns the current `settlementIndex` as `bigint` (next index to use
-     *   for `createPendingSettlement` if you have NOT yet called `settle` for
-     *   it; if you HAVE just settled, subtract 1 — but prefer the event
-     *   `SettlementPendingEvent.settlement_index` over arithmetic).
-     * @since v0.12.8
-     */
-    nextSettlementIndex(agentWallet: PublicKey, depositorWallet: PublicKey, nonce: BN | number | bigint): Promise<bigint>;
-    createPendingSettlement(agentWallet: PublicKey, depositorWallet: PublicKey, nonce: BN | number | bigint, settlementIndex: BN | number | bigint, callsToSettle: BN | number | bigint, amount: BN | number | bigint, serviceHash: number[], receiptMerkleRoot?: number[]): Promise<TransactionSignature>;
-    finalizeSettlement(agentWallet: PublicKey, depositorWallet: PublicKey, nonce: BN | number | bigint, settlementIndex: BN | number | bigint): Promise<TransactionSignature>;
-    /**
-     * Identify orphan PendingSettlement PDAs that cannot be finalized.
-     *
-     * @returns `null` if the PDA is finalizable (or already finalized / disputed).
-     *          Otherwise an object describing the inconsistency, suitable for
-     *          logging or feeding into a quarantine list. Use this from a
-     *          recovery script to scan a range of `settlement_index` values:
-     *
-     * ```ts
-     * for (let idx = 0n; idx < currentIdx; idx++) {
-     *   const orphan = await sap.escrowV2.diagnoseOrphanPending(
-     *     agentWallet, depositorWallet, nonce, idx,
-     *   );
-     *   if (orphan) log.warn({ idx, ...orphan }, "skip orphan");
-     * }
-     * ```
-     *
-     * @since v0.12.9
-     */
-    diagnoseOrphanPending(agentWallet: PublicKey, depositorWallet: PublicKey, nonce: BN | number | bigint, settlementIndex: BN | number | bigint): Promise<{
-        pendingPda: PublicKey;
-        psAmount: bigint;
-        escrowPendingAmount: bigint;
-        escrowBalance: bigint;
-        isFinalized: boolean;
-        isDisputed: boolean;
-        reason: "ok" | "missing" | "amount_exceeds_pending" | "amount_exceeds_balance" | "already_finalized" | "disputed";
-    } | null>;
-    fileDispute(agentWallet: PublicKey, nonce: BN | number | bigint, settlementIndex: BN | number | bigint, evidenceHash: number[], disputeType?: number): Promise<TransactionSignature>;
-    /**
-     * @deprecated Since v0.7.0 — Arbiter-based resolution removed.
-     * Use {@link ReceiptModule.submitReceiptProof} + {@link ReceiptModule.autoResolveDispute} instead.
-     */
-    resolveDispute(_depositorWallet: PublicKey, _agentWallet: PublicKey, _nonce: BN | number | bigint, _settlementIndex: BN | number | bigint, _outcome: number): Promise<TransactionSignature>;
-    closeDispute(pendingSettlementPda: PublicKey): Promise<TransactionSignature>;
-    closePendingSettlement(pendingSettlementPda: PublicKey): Promise<TransactionSignature>;
-    withdraw(agentWallet: PublicKey, nonce: BN | number | bigint, amount: BN | number | bigint): Promise<TransactionSignature>;
-    close(agentWallet: PublicKey, nonce?: BN | number | bigint): Promise<TransactionSignature>;
-    /**
-     * @deprecated Since v0.7.0 — Migration instruction removed from program.
-     */
-    migrateFromV1(_agentWallet: PublicKey): Promise<TransactionSignature>;
-    fetch(agentPda: PublicKey, depositor?: PublicKey, nonce?: BN | number | bigint): Promise<EscrowAccountV2Data>;
-    fetchNullable(agentPda: PublicKey, depositor?: PublicKey, nonce?: BN | number | bigint): Promise<EscrowAccountV2Data | null>;
-    fetchByPda(escrowPda: PublicKey): Promise<EscrowAccountV2Data>;
-    fetchPendingSettlement(pendingPda: PublicKey): Promise<PendingSettlementData>;
-    fetchPendingSettlementNullable(pendingPda: PublicKey): Promise<PendingSettlementData | null>;
-    fetchDispute(disputePda: PublicKey): Promise<DisputeRecordData>;
-    fetchDisputeNullable(disputePda: PublicKey): Promise<DisputeRecordData | null>;
-}
-//# sourceMappingURL=escrow-v2.d.ts.map

package/dist/types/modules/escrow-v2.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"escrow-v2.d.ts","sourceRoot":"","sources":["../../../src/modules/escrow-v2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,MAAM,EACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAUpC,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,UAAU,CAAC;AAKlB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG3D;;;;;;;;GAQG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAG5C,oEAAoE;IACpE,OAAO,CAAC,KAAK;IAMb,YAAY,CACV,QAAQ,EAAE,SAAS,EACnB,SAAS,CAAC,EAAE,SAAS,EACrB,KAAK,GAAE,EAAE,GAAG,MAAM,GAAG,MAAU,GAC9B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAI/B,uBAAuB,CACrB,WAAW,EAAE,SAAS,EACtB,eAAe,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,GACpC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAI/B,aAAa,CACX,oBAAoB,EAAE,SAAS,GAC9B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAMzB,MAAM,CACV,WAAW,EAAE,SAAS,EACtB,IAAI,EAAE,kBAAkB,EACxB,WAAW,GAAE,WAAW,EAAO,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IA8H1B,OAAO,CACX,WAAW,EAAE,SAAS,EACtB,KAAK,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,EAC3B,MAAM,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,EAC5B,WAAW,GAAE,WAAW,EAAO,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IAe1B,MAAM,CACV,eAAe,EAAE,SAAS,EAC1B,KAAK,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,EAC3B,aAAa,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,EACnC,WAAW,EAAE,MAAM,EAAE,EACrB,WAAW,GAAE,WAAW,EAAO,EAC/B,IAAI,CAAC,EAAE,aAAa,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,CAAC;IA2ChC;;;;;;;;;;;;OAYG;IACG,mBAAmB,CACvB,WAAW,EAAE,SAAS,EACtB,eAAe,EAAE,SAAS,EAC1B,KAAK,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,GAC1B,OAAO,CAAC,MAAM,CAAC;IAeZ,uBAAuB,CAC3B,WAAW,EAAE,SAAS,EACtB,eAAe,EAAE,SAAS,EAC1B,KAAK,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,EAC3B,eAAe,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,EACrC,aAAa,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,EACnC,MAAM,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,EAC5B,WAAW,EAAE,MAAM,EAAE,EACrB,iBAAiB,GAAE,MAAM,EAA0B,GAClD,OAAO,CAAC,oBAAoB,CAAC;IA0C1B,kBAAkB,CACtB,WAAW,EAAE,SAAS,EACtB,eAAe,EAAE,SAAS,EAC1B,KAAK,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,EAC3B,eAAe,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,GACpC,OAAO,CAAC,oBAAoB,CAAC;IA6DhC;;;;;;;;;;;;;;;;;;OAkBG;IACG,qBAAqB,CACzB,WAAW,EAAE,SAAS,EACtB,eAAe,EAAE,SAAS,EAC1B,KAAK,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,EAC3B,eAAe,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,GACpC,OAAO,CAAC;QACT,UAAU,EAAE,SAAS,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,OAAO,CAAC;QACrB,UAAU,EAAE,OAAO,CAAC;QACpB,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,wBAAwB,GAAG,wBAAwB,GAAG,mBAAmB,GAAG,UAAU,CAAC;KACnH,GAAG,IAAI,CAAC;IAsCH,WAAW,CACf,WAAW,EAAE,SAAS,EACtB,KAAK,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,EAC3B,eAAe,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,EACrC,YAAY,EAAE,MAAM,EAAE,EACtB,WAAW,GAAE,MAAU,GACtB,OAAO,CAAC,oBAAoB,CAAC;IAkBhC;;;OAGG;IACG,cAAc,CAClB,gBAAgB,EAAE,SAAS,EAC3B,YAAY,EAAE,SAAS,EACvB,MAAM,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,EAC5B,gBAAgB,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,EACtC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,CAAC;IAI1B,YAAY,CAChB,oBAAoB,EAAE,SAAS,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IAY1B,sBAAsB,CAC1B,oBAAoB,EAAE,SAAS,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IAU1B,QAAQ,CACZ,WAAW,EAAE,SAAS,EACtB,KAAK,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,EAC3B,MAAM,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,GAC3B,OAAO,CAAC,oBAAoB,CAAC;IAa1B,KAAK,CACT,WAAW,EAAE,SAAS,EACtB,KAAK,GAAE,EAAE,GAAG,MAAM,GAAG,MAAU,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IAahC;;OAEG;IACG,aAAa,CACjB,YAAY,EAAE,SAAS,GACtB,OAAO,CAAC,oBAAoB,CAAC;IAM1B,KAAK,CACT,QAAQ,EAAE,SAAS,EACnB,SAAS,CAAC,EAAE,SAAS,EACrB,KAAK,GAAE,EAAE,GAAG,MAAM,GAAG,MAAU,GAC9B,OAAO,CAAC,mBAAmB,CAAC;IAKzB,aAAa,CACjB,QAAQ,EAAE,SAAS,EACnB,SAAS,CAAC,EAAE,SAAS,EACrB,KAAK,GAAE,EAAE,GAAG,MAAM,GAAG,MAAU,GAC9B,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAKhC,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI9D,sBAAsB,CAC1B,UAAU,EAAE,SAAS,GACpB,OAAO,CAAC,qBAAqB,CAAC;IAI3B,8BAA8B,CAClC,UAAU,EAAE,SAAS,GACpB,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAIlC,YAAY,CAChB,UAAU,EAAE,SAAS,GACpB,OAAO,CAAC,iBAAiB,CAAC;IAIvB,oBAAoB,CACxB,UAAU,EAAE,SAAS,GACpB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;CAGrC"}