@oobe-protocol-labs/synapse-sap-sdk 0.1.0

package/dist/types/events/index.d.ts

@@ -0,0 +1,248 @@
+/**
+ * @module events
+ * @description Decode SAP v2 events from transaction logs.
+ *
+ * Uses Anchor's event parser under the hood. Provides a
+ * strongly-typed, filterable event stream.
+ *
+ * @category Events
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { EventParser } from "@synapse-sap/sdk/events";
+ *
+ * const events = client.events.parseLogs(txLogs);
+ * for (const event of events) {
+ *   if (event.name === "PaymentSettledEvent") {
+ *     console.log(event.data);
+ *   }
+ * }
+ * ```
+ */
+import { type Program, BN } from "@coral-xyz/anchor";
+import type { PublicKey } from "@solana/web3.js";
+/**
+ * Decoded payload for the `RegisteredEvent` emitted when a new agent is registered.
+ *
+ * @interface RegisteredEventData
+ * @name RegisteredEventData
+ * @description Contains the agent PDA, owner wallet, display name, capabilities list, and timestamp.
+ * @category Events
+ * @since v0.1.0
+ * @see {@link SapEvent}
+ */
+export interface RegisteredEventData {
+    readonly name: "RegisteredEvent";
+    readonly data: {
+        agent: PublicKey;
+        wallet: PublicKey;
+        name: string;
+        capabilities: string[];
+        timestamp: BN;
+    };
+}
+/**
+ * Decoded payload for the `UpdatedEvent` emitted when an agent’s profile is modified.
+ *
+ * @interface UpdatedEventData
+ * @name UpdatedEventData
+ * @description Contains the agent PDA, owner wallet, a list of changed field names, and timestamp.
+ * @category Events
+ * @since v0.1.0
+ * @see {@link SapEvent}
+ */
+export interface UpdatedEventData {
+    readonly name: "UpdatedEvent";
+    readonly data: {
+        agent: PublicKey;
+        wallet: PublicKey;
+        updatedFields: string[];
+        timestamp: BN;
+    };
+}
+/**
+ * Decoded payload for the `FeedbackEvent` emitted when a reviewer submits feedback.
+ *
+ * @interface FeedbackEventData
+ * @name FeedbackEventData
+ * @description Contains the agent PDA, reviewer wallet, numeric score, tag, and timestamp.
+ * @category Events
+ * @since v0.1.0
+ * @see {@link SapEvent}
+ */
+export interface FeedbackEventData {
+    readonly name: "FeedbackEvent";
+    readonly data: {
+        agent: PublicKey;
+        reviewer: PublicKey;
+        score: number;
+        tag: string;
+        timestamp: BN;
+    };
+}
+/**
+ * Decoded payload for the `MemoryInscribedEvent` emitted when data is written to a vault.
+ *
+ * @interface MemoryInscribedEventData
+ * @name MemoryInscribedEventData
+ * @description Contains vault/session PDAs, sequence info, encrypted data, nonce, content hash,
+ *   fragment metadata, compression flag, and timestamp.
+ * @category Events
+ * @since v0.1.0
+ * @see {@link SapEvent}
+ */
+export interface MemoryInscribedEventData {
+    readonly name: "MemoryInscribedEvent";
+    readonly data: {
+        vault: PublicKey;
+        session: PublicKey;
+        sequence: number;
+        epochIndex: number;
+        encryptedData: number[];
+        nonce: number[];
+        contentHash: number[];
+        totalFragments: number;
+        fragmentIndex: number;
+        compression: number;
+        dataLen: number;
+        nonceVersion: number;
+        timestamp: BN;
+    };
+}
+/**
+ * Decoded payload for the `PaymentSettledEvent` emitted when an escrow settlement occurs.
+ *
+ * @interface PaymentSettledEventData
+ * @name PaymentSettledEventData
+ * @description Contains escrow/agent/depositor PDAs, settlement counts, amounts, service hash,
+ *   and remaining balance.
+ * @category Events
+ * @since v0.1.0
+ * @see {@link SapEvent}
+ */
+export interface PaymentSettledEventData {
+    readonly name: "PaymentSettledEvent";
+    readonly data: {
+        escrow: PublicKey;
+        agent: PublicKey;
+        depositor: PublicKey;
+        callsSettled: BN;
+        amount: BN;
+        serviceHash: number[];
+        totalCallsSettled: BN;
+        remainingBalance: BN;
+        timestamp: BN;
+    };
+}
+/**
+ * Decoded payload for the `LedgerEntryEvent` emitted when data is appended to a ledger.
+ *
+ * @interface LedgerEntryEventData
+ * @name LedgerEntryEventData
+ * @description Contains session/ledger PDAs, entry index, raw data, content hash,
+ *   Merkle root, and timestamp.
+ * @category Events
+ * @since v0.1.0
+ * @see {@link SapEvent}
+ */
+export interface LedgerEntryEventData {
+    readonly name: "LedgerEntryEvent";
+    readonly data: {
+        session: PublicKey;
+        ledger: PublicKey;
+        entryIndex: number;
+        data: number[];
+        contentHash: number[];
+        dataLen: number;
+        merkleRoot: number[];
+        timestamp: BN;
+    };
+}
+/**
+ * Discriminated union of all known SAP v2 event types.
+ *
+ * @name SapEvent
+ * @description Use the `name` discriminant to narrow to a specific event payload.
+ * @category Events
+ * @since v0.1.0
+ */
+export type SapEvent = RegisteredEventData | UpdatedEventData | FeedbackEventData | MemoryInscribedEventData | PaymentSettledEventData | LedgerEntryEventData;
+/**
+ * Exhaustive list of all SAP v2 event name strings.
+ *
+ * @name SAP_EVENT_NAMES
+ * @description Frozen array of every event discriminant emitted by the program.
+ *   Useful for log filtering and exhaustive switch checks.
+ * @category Events
+ * @since v0.1.0
+ * @see {@link SapEventName}
+ */
+export declare const SAP_EVENT_NAMES: readonly ["RegisteredEvent", "UpdatedEvent", "DeactivatedEvent", "ReactivatedEvent", "ClosedEvent", "FeedbackEvent", "FeedbackUpdatedEvent", "FeedbackRevokedEvent", "ReputationUpdatedEvent", "CallsReportedEvent", "VaultInitializedEvent", "SessionOpenedEvent", "MemoryInscribedEvent", "EpochOpenedEvent", "SessionClosedEvent", "VaultClosedEvent", "SessionPdaClosedEvent", "EpochPageClosedEvent", "VaultNonceRotatedEvent", "DelegateAddedEvent", "DelegateRevokedEvent", "ToolPublishedEvent", "ToolSchemaInscribedEvent", "ToolUpdatedEvent", "ToolDeactivatedEvent", "ToolReactivatedEvent", "ToolClosedEvent", "ToolInvocationReportedEvent", "CheckpointCreatedEvent", "EscrowCreatedEvent", "EscrowDepositedEvent", "PaymentSettledEvent", "EscrowWithdrawnEvent", "BatchSettledEvent", "AttestationCreatedEvent", "AttestationRevokedEvent", "LedgerEntryEvent", "LedgerSealedEvent"];
+/**
+ * String literal union of all SAP v2 event names.
+ *
+ * @name SapEventName
+ * @description Derived from {@link SAP_EVENT_NAMES} for compile-time exhaustiveness.
+ * @category Events
+ * @since v0.1.0
+ */
+export type SapEventName = (typeof SAP_EVENT_NAMES)[number];
+/**
+ * A single parsed event extracted from transaction logs.
+ *
+ * @interface ParsedEvent
+ * @name ParsedEvent
+ * @description Lightweight container with a `name` discriminant and untyped `data` record.
+ *   Narrow via {@link SapEventName} for type-safe access.
+ * @category Events
+ * @since v0.1.0
+ */
+export interface ParsedEvent {
+    readonly name: string;
+    readonly data: Record<string, any>;
+}
+/**
+ * Typed wrapper around Anchor’s `EventParser` for SAP v2 programs.
+ *
+ * Extracts strongly-typed {@link ParsedEvent} objects from raw
+ * transaction log lines.
+ *
+ * @name EventParser
+ * @description Instantiate with an Anchor `Program` and call {@link EventParser.parseLogs}
+ *   to decode events, or {@link EventParser.filterByName} to narrow results.
+ * @category Events
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * const parser = new EventParser(program);
+ * const events = parser.parseLogs(txLogs);
+ * const settled = parser.filterByName(events, "PaymentSettledEvent");
+ * ```
+ */
+export declare class EventParser {
+    private readonly parser;
+    /**
+     * Create a new `EventParser`.
+     *
+     * @param program - An Anchor `Program` instance whose IDL defines the events to decode.
+     */
+    constructor(program: Program<any>);
+    /**
+     * Parse raw transaction log lines into typed events.
+     *
+     * @param logs - Array of log strings from a confirmed transaction.
+     * @returns {ParsedEvent[]} Decoded events found in the logs.
+     */
+    parseLogs(logs: string[]): ParsedEvent[];
+    /**
+     * Filter a list of parsed events by event name.
+     *
+     * @param events - The full array of {@link ParsedEvent} objects to filter.
+     * @param name   - The {@link SapEventName} to match against.
+     * @returns {ParsedEvent[]} Only events whose `name` matches.
+     */
+    filterByName<N extends SapEventName>(events: ParsedEvent[], name: N): ParsedEvent[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/events/index.d.ts.map

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

package/dist/types/idl/index.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @module idl
+ * @description Embedded IDL for the SAP v2 program.
+ *
+ * The JSON artifact is bundled with the SDK so it works as a
+ * standalone package without needing the program workspace.
+ *
+ * ### Updating the IDL
+ *
+ * After rebuilding the Anchor program, run:
+ * ```sh
+ * yarn sync-idl            # copies from ../target/idl/
+ * ```
+ * or manually copy the file into `src/idl/synapse_agent_sap.json`.
+ *
+ * @example
+ * ```ts
+ * import { SAP_IDL, type SynapseAgentSapIDL } from "@synapse-sap/sdk/idl";
+ * ```
+ *
+ * @category IDL
+ * @since v0.1.0
+ */
+/**
+ * TypeScript type representing the Anchor IDL for the `synapse_agent_sap` program.
+ *
+ * @name SynapseAgentSapIDL
+ * @description Anchor IDL type derived from the bundled JSON artifact.
+ *   Automatically stays in sync with the program — no manual maintenance needed.
+ * @category IDL
+ * @since v0.1.0
+ */
+export type SynapseAgentSapIDL = any;
+/**
+ * The complete Anchor IDL object for the `synapse_agent_sap` program.
+ *
+ * @name SAP_IDL
+ * @description Pre-loaded IDL JSON artifact bundled with the SDK.
+ *   Can be passed directly to `new anchor.Program()` or used for
+ *   instruction introspection.
+ * @category IDL
+ * @since v0.1.0
+ */
+export declare const SAP_IDL: any;
+/**
+ * Program address embedded in the IDL metadata.
+ *
+ * @name IDL_PROGRAM_ADDRESS
+ * @description The deployed program address as declared in the Anchor IDL.
+ * @category IDL
+ * @since v0.1.0
+ */
+export declare const IDL_PROGRAM_ADDRESS: string;
+/**
+ * IDL metadata block (name, version, spec, description).
+ *
+ * @name IDL_METADATA
+ * @description Anchor IDL metadata containing program name, version string,
+ *   spec version, and human-readable description.
+ * @category IDL
+ * @since v0.1.0
+ */
+export declare const IDL_METADATA: {
+    name: string;
+    version: string;
+    spec: string;
+    description: string;
+};
+export default SAP_IDL;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/idl/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/idl/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH;;;;;;;;GAQG;AAEH,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAErC;;;;;;;;;GASG;AAEH,eAAO,MAAM,OAAO,EAAc,GAAG,CAAC;AAEtC;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAwB,CAAC;AAE3D;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY;;;;;CAAmB,CAAC;AAE7C,eAAe,OAAO,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @synapse-sap/sdk — TypeScript SDK for SAP v2 (Solana Agent Protocol)
+ *
+ * Modular architecture:
+ *
+ * | Path              | Description                                   |
+ * |-------------------|-----------------------------------------------|
+ * | `core/`           | SapClient, SapConnection (RPC factory)        |
+ * | `types/`          | On-chain enums, account data, instruction DTOs|
+ * | `constants/`      | Program IDs, PDA seeds, size limits           |
+ * | `pda/`            | Deterministic PDA derivation helpers          |
+ * | `events/`         | Transaction-log event parser                  |
+ * | `errors/`         | Typed SDK error classes                       |
+ * | `utils/`          | Hashing, validation, serialization            |
+ * | `modules/`        | Low-level per-domain instruction wrappers     |
+ * | `registries/`     | High-level abstractions (discovery, x402, …)  |
+ * | `plugin/`         | SynapseAgentKit adapter (52 tools)            |
+ * | `idl/`            | Embedded Anchor IDL                           |
+ *
+ * @example
+ * ```ts
+ * import { SapClient, SapConnection } from "@synapse-sap/sdk";
+ *
+ * // Quick start — from Anchor provider
+ * const client = SapClient.from(provider);
+ *
+ * // Or from RPC URL (synapse-client-sdk compatible)
+ * const conn = SapConnection.devnet();
+ * const client2 = conn.fromKeypair(keypair);
+ *
+ * // Use domain modules:
+ * await client.agent.register({ ... });
+ * await client.escrow.create(agentWallet, { ... });
+ * await client.ledger.write(sessionPda, data, contentHash);
+ *
+ * // Use registries (high-level):
+ * const agents = await client.discovery.findAgentsByProtocol("jupiter");
+ * const ctx = await client.session.start("conv-123");
+ * ```
+ *
+ * @packageDocumentation
+ * @category SDK
+ * @since v0.1.0
+ */
+export { SapClient, SapConnection } from "./core";
+export type { SapCluster, SapConnectionConfig } from "./core";
+export type { TokenTypeKind, PluginTypeKind, SettlementModeKind, ToolHttpMethodKind, ToolCategoryKind, DelegatePermissionBit, SchemaTypeValue, CompressionTypeValue, Capability, VolumeCurveBreakpoint, PricingTier, PluginRef, Settlement, AgentAccountData, FeedbackAccountData, CapabilityIndexData, ProtocolIndexData, GlobalRegistryData, MemoryVaultData, SessionLedgerData, EpochPageData, VaultDelegateData, ToolDescriptorData, SessionCheckpointData, EscrowAccountData, AgentStatsData, ToolCategoryIndexData, AgentAttestationData, MemoryLedgerData, LedgerPageData, RegisterAgentArgs, UpdateAgentArgs, GiveFeedbackArgs, UpdateFeedbackArgs, PublishToolArgs, UpdateToolArgs, InscribeMemoryArgs, CompactInscribeArgs, CreateEscrowArgs, CreateAttestationArgs, InscribeToolSchemaArgs, } from "./types";
+export { TokenType, PluginType, SettlementMode, ToolHttpMethod, ToolCategory, DelegatePermission, SchemaType, CompressionType, } from "./types";
+export { SAP_PROGRAM_ADDRESS, SAP_PROGRAM_ID, MAINNET_SAP_PROGRAM_ID, DEVNET_SAP_PROGRAM_ID, LOCALNET_SAP_PROGRAM_ID, SEEDS, LIMITS, AGENT_VERSION, VAULT_PROTOCOL_VERSION, TOOL_CATEGORY_VALUES, HTTP_METHOD_VALUES, } from "./constants";
+export { SAP_IDL, IDL_PROGRAM_ADDRESS, IDL_METADATA } from "./idl/index";
+export type { SynapseAgentSapIDL } from "./idl/index";
+export { deriveGlobalRegistry, deriveAgent, deriveAgentStats, deriveFeedback, deriveCapabilityIndex, deriveProtocolIndex, deriveToolCategoryIndex, deriveVault, deriveSession, deriveEpochPage, deriveVaultDelegate, deriveCheckpoint, deriveTool, deriveEscrow, deriveAttestation, deriveLedger, deriveLedgerPage, } from "./pda";
+export { sha256, hashToArray, assert } from "./utils";
+export { serializeAccount, serializeValue } from "./utils";
+export { SapError, SapValidationError, SapRpcError, SapAccountNotFoundError, SapTimeoutError, SapPermissionError, } from "./errors";
+export { EventParser, SAP_EVENT_NAMES } from "./events";
+export type { SapEvent, SapEventName, ParsedEvent, RegisteredEventData, UpdatedEventData, FeedbackEventData, MemoryInscribedEventData, PaymentSettledEventData, LedgerEntryEventData, } from "./events";
+export { AgentModule, FeedbackModule, IndexingModule, ToolsModule, VaultModule, EscrowModule, AttestationModule, LedgerModule, BaseModule, } from "./modules/index";
+export type { SapProgram, SapTransactionResult } from "./modules/base";
+export { createSAPPlugin, SAPPlugin } from "./plugin/index";
+export type { SAPPluginConfig, SynapsePlugin, PluginMeta, PluginContext, PluginInstallResult, } from "./plugin/index";
+export type { ProtocolMethod, PluginProtocol, } from "./plugin/protocols";
+export { SAP_PROTOCOLS } from "./plugin/protocols";
+export { SapPostgres, SapSyncEngine, SAP_TABLE_MAP } from "./postgres";
+export type { PgClient, SyncAllResult, SapAccountType, SyncMeta, AgentRow, EscrowRow, ToolRow, LedgerRow, EventRow, SyncCursorRow, SyncOptions, } from "./postgres";
+export { DiscoveryRegistry, X402Registry, SessionManager, AgentBuilder, } from "./registries/index";
+export type { DiscoveredAgent, AgentProfile, DiscoveredTool, NetworkOverview, ToolCategoryName, CostEstimate, PaymentContext, PreparePaymentOptions, X402Headers, EscrowBalance, SettlementResult, BatchSettlementResult, SessionContext, WriteResult, SealResult, RingBufferEntry, SessionStatus, CapabilityInput, PricingTierInput, ToolInput, RegisterResult, RegisterWithToolsResult, } from "./registries/index";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

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

@@ -0,0 +1,166 @@
+/**
+ * @module agent
+ * @description Agent lifecycle operations for the Solana 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 Solana 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,96 @@
+/**
+ * @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 Solana 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

@@ -0,0 +1 @@
+{"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"}