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

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

@@ -1,150 +0,0 @@
-/**
- * @module events/geyser
- * @description Yellowstone gRPC (Geyser) event stream for SAP v2.
- *
- * Drop-in alternative to the WebSocket `connection.onLogs()` pipeline.
- * Uses Triton / Helius / any Yellowstone-compatible gRPC endpoint to
- * receive program transaction updates with sub-second latency and
- * automatic reconnection.
- *
- * @category Events
- * @since v0.6.3
- *
- * @example
- * ```ts
- * import { GeyserEventStream } from "@oobe-protocol-labs/synapse-sap-sdk";
- * import { EventParser }       from "@oobe-protocol-labs/synapse-sap-sdk";
- *
- * const stream = new GeyserEventStream({
- *   endpoint:  "https://grpc.triton.one",
- *   token:     process.env.GEYSER_TOKEN!,
- *   programId: "SAPpUhsWLJG1FfkGRcXagEDMrMsWGjbky7AyhGpFETZ",
- * });
- *
- * const parser = new EventParser(program);
- *
- * stream.on("logs", (logs, signature, slot) => {
- *   const events = parser.parseLogs(logs);
- *   for (const event of events) {
- *     console.log(event.name, event.data);
- *   }
- * });
- *
- * stream.on("error", (err) => console.error("gRPC error:", err));
- *
- * await stream.connect();
- * // ... later
- * await stream.disconnect();
- * ```
- */
-import { EventEmitter } from "events";
-/**
- * Configuration for the Yellowstone gRPC event stream.
- *
- * @interface GeyserConfig
- * @since v0.6.3
- */
-export interface GeyserConfig {
-    /** Yellowstone gRPC endpoint URL (e.g. "https://grpc.triton.one") */
-    endpoint: string;
-    /** Authentication token for the gRPC endpoint */
-    token: string;
-    /** SAP program ID to filter. Defaults to SAP v2 program. */
-    programId?: string;
-    /**
-     * Commitment level for the subscription.
-     * @default "confirmed"
-     */
-    commitment?: "processed" | "confirmed" | "finalized";
-    /**
-     * Automatically reconnect on disconnect.
-     * @default true
-     */
-    autoReconnect?: boolean;
-    /**
-     * Delay between reconnection attempts in ms.
-     * @default 3000
-     */
-    reconnectDelayMs?: number;
-    /**
-     * Maximum number of reconnection attempts. 0 = unlimited.
-     * @default 0
-     */
-    maxReconnectAttempts?: number;
-    /**
-     * Include failed transactions in the stream.
-     * @default false
-     */
-    includeFailedTxs?: boolean;
-}
-/**
- * Events emitted by {@link GeyserEventStream}.
- *
- * @interface GeyserStreamEvents
- * @since v0.6.3
- */
-export interface GeyserStreamEvents {
-    /**
-     * Emitted for each transaction's log messages.
-     * Same shape as `connection.onLogs()` callback — plug into `EventParser.parseLogs()`.
-     */
-    logs: (logs: string[], signature: string, slot: number) => void;
-    /** Emitted when the gRPC stream connects or reconnects. */
-    connected: () => void;
-    /** Emitted when the stream disconnects. */
-    disconnected: (reason: string) => void;
-    /** Emitted on transport or parsing errors. */
-    error: (err: Error) => void;
-    /** Emitted on reconnection attempt. */
-    reconnecting: (attempt: number) => void;
-}
-/**
- * Yellowstone gRPC event stream for SAP v2 programs.
- *
- * Wraps `@triton-one/yellowstone-grpc` and emits parsed log lines
- * compatible with the existing {@link EventParser}.
- *
- * @name GeyserEventStream
- * @category Events
- * @since v0.6.3
- *
- * @example
- * ```ts
- * const stream = new GeyserEventStream({
- *   endpoint: "https://grpc.triton.one",
- *   token:    process.env.GEYSER_TOKEN!,
- * });
- *
- * stream.on("logs", (logs, sig, slot) => {
- *   const events = parser.parseLogs(logs);
- *   events.forEach(e => db.insertEvent(e));
- * });
- *
- * await stream.connect();
- * ```
- */
-export declare class GeyserEventStream extends EventEmitter {
-    private readonly config;
-    private client;
-    private stream;
-    private reconnectAttempts;
-    private _connected;
-    private _stopped;
-    constructor(config: GeyserConfig);
-    /** Whether the gRPC stream is currently connected. */
-    get connected(): boolean;
-    /**
-     * Connect to the Yellowstone gRPC endpoint and start streaming.
-     *
-     * @throws If `@triton-one/yellowstone-grpc` is not installed.
-     */
-    connect(): Promise<void>;
-    /**
-     * Disconnect from the gRPC stream and stop reconnection.
-     */
-    disconnect(): Promise<void>;
-    private subscribe;
-    private handleMessage;
-    private maybeReconnect;
-}
-//# sourceMappingURL=geyser.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"geyser.d.ts","sourceRoot":"","sources":["../../../src/events/geyser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAMtC;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IAEjB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IAEd,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,UAAU,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;IAErD;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEhE,2DAA2D;IAC3D,SAAS,EAAE,MAAM,IAAI,CAAC;IAEtB,2CAA2C;IAC3C,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAEvC,8CAA8C;IAC9C,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAE5B,uCAAuC;IACvC,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAEhD,OAAO,CAAC,MAAM,CAAa;IAE3B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,YAAY;IAchC,sDAAsD;IACtD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAkBnB,SAAS;IA8EvB,OAAO,CAAC,aAAa;YA2BP,cAAc;CAqB7B"}

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAE,EAAE,EAAoC,MAAM,mBAAmB,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAMjD;;;;;;;;;GASG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE;QACb,KAAK,EAAE,SAAS,CAAC;QACjB,MAAM,EAAE,SAAS,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,SAAS,EAAE,EAAE,CAAC;KACf,CAAC;CACH;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE;QACb,KAAK,EAAE,SAAS,CAAC;QACjB,MAAM,EAAE,SAAS,CAAC;QAClB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,SAAS,EAAE,EAAE,CAAC;KACf,CAAC;CACH;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE;QACb,KAAK,EAAE,SAAS,CAAC;QACjB,QAAQ,EAAE,SAAS,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,EAAE,CAAC;KACf,CAAC;CACH;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE;QACb,KAAK,EAAE,SAAS,CAAC;QACjB,OAAO,EAAE,SAAS,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,EAAE,CAAC;KACf,CAAC;CACH;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE;QACb,MAAM,EAAE,SAAS,CAAC;QAClB,KAAK,EAAE,SAAS,CAAC;QACjB,SAAS,EAAE,SAAS,CAAC;QACrB,YAAY,EAAE,EAAE,CAAC;QACjB,MAAM,EAAE,EAAE,CAAC;QACX,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,iBAAiB,EAAE,EAAE,CAAC;QACtB,gBAAgB,EAAE,EAAE,CAAC;QACrB,SAAS,EAAE,EAAE,CAAC;KACf,CAAC;CACH;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE;QACb,OAAO,EAAE,SAAS,CAAC;QACnB,MAAM,EAAE,SAAS,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,SAAS,EAAE,EAAE,CAAC;KACf,CAAC;CACH;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAChB,mBAAmB,GACnB,gBAAgB,GAChB,iBAAiB,GACjB,wBAAwB,GACxB,uBAAuB,GACvB,oBAAoB,CAAC;AAMzB;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,u2BAuClB,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAM5D;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAE3C;;;;OAIG;gBAES,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC;IAIjC;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE;IASxC;;;;;;OAMG;IACH,YAAY,CAAC,CAAC,SAAS,YAAY,EACjC,MAAM,EAAE,WAAW,EAAE,EACrB,IAAI,EAAE,CAAC,GACN,WAAW,EAAE;CAGjB"}

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

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

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

@@ -1,85 +0,0 @@
-/**
- * @synapse-sap/sdk — TypeScript SDK for SAP v2 (Synapse 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)            |
- * | `parser/`         | Transaction decode, instruction + event parse |
- * | `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, KeypairWallet } from "./core";
-export type { SapCluster, SapConnectionConfig, SapWallet } from "./core";
-export type { TokenTypeKind, PluginTypeKind, SettlementModeKind, ToolHttpMethodKind, ToolCategoryKind, DelegatePermissionBit, SchemaTypeValue, CompressionTypeValue, SettlementSecurityKind, DisputeOutcomeKind, BillingIntervalKind, DisputeTypeValue, ResolutionLayerKind, Capability, VolumeCurveBreakpoint, PricingTier, PluginRef, Settlement, AgentAccountData, FeedbackAccountData, CapabilityIndexData, ProtocolIndexData, GlobalRegistryData, MemoryVaultData, SessionLedgerData, EpochPageData, VaultDelegateData, ToolDescriptorData, SessionCheckpointData, EscrowAccountData, AgentStatsData, ToolCategoryIndexData, AgentAttestationData, MemoryLedgerData, LedgerPageData, EscrowAccountV2Data, PendingSettlementData, DisputeRecordData, ReceiptBatchData, AgentStakeData, SubscriptionData, CounterShardData, IndexPageData, RegisterAgentArgs, UpdateAgentArgs, GiveFeedbackArgs, UpdateFeedbackArgs, PublishToolArgs, UpdateToolArgs, InscribeMemoryArgs, CompactInscribeArgs, CreateEscrowArgs, CreateAttestationArgs, InscribeToolSchemaArgs, CreateEscrowV2Args, CreateSubscriptionArgs, EndpointDescriptor, HealthCheckDescriptor, ToolManifestEntry, AgentManifest, EndpointValidationResult, } from "./types";
-export { TokenType, PluginType, SettlementMode, ToolHttpMethod, ToolCategory, DelegatePermission, SchemaType, CompressionType, SettlementSecurity, DisputeOutcome, BillingInterval, DisputeType, ResolutionLayer, } 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, SapNetwork, } from "./constants";
-export type { SapNetworkId } 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, deriveEscrowV2, derivePendingSettlement, deriveDispute, deriveStake, deriveSubscription, deriveShard, deriveIndexPage, deriveAttestation, deriveLedger, deriveLedgerPage, deriveReceiptBatch, deriveSettlementReceipt, } from "./pda";
-export { sha256, hashToArray, assert, computeBatchRoot } from "./utils";
-export { serializeAccount, serializeValue } from "./utils";
-export { USDC_MINT_MAINNET, USDC_MINT_DEVNET, MIN_AGENT_STAKE_LAMPORTS, MAX_DELEGATE_DURATION_SECS, isAcceptedUsdcMint, isAcceptedPaymentToken, } from "./constants";
-export { normalizeNetworkId, isNetworkEquivalent, getNetworkGenesisHash, getNetworkClusterName, isKnownNetwork, } from "./utils";
-export { validateEndpoint, validateEndpointDescriptor, validateHealthCheck, validateAgentEndpoints, } from "./utils";
-export type { ValidateEndpointOptions } from "./utils";
-export { getRpcUrl, getFallbackRpcUrl, createDualConnection, findATA, classifyAnchorError, extractAnchorErrorCode, } from "./utils";
-export type { RpcConfig, DualConnection, AtaResult } from "./utils";
-export { createEnvSchema, createEndpointDescriptorSchema, createHealthCheckSchema, createToolManifestEntrySchema, createAgentManifestSchema, createPreparePaymentSchema, createRegisterAgentSchema, createCallArgsSchema, validateOrThrow, } from "./utils";
-export { buildPriorityFeeIxs, buildRpcOptions, FAST_SETTLE_OPTIONS, FAST_BATCH_SETTLE_OPTIONS, DEFAULT_SETTLE_PRIORITY_FEE, DEFAULT_SETTLE_COMPUTE_UNITS, DEFAULT_BATCH_SETTLE_COMPUTE_UNITS, computeBatchSettleCu, } from "./utils";
-export type { PriorityFeeConfig, } from "./utils";
-export { validateEscrowState, attachSplAccounts, toAccountMetas, MissingEscrowAtaError, SapMerchantValidator, parseX402Headers, getX402DirectPayments, } from "./utils";
-export type { SplAccountMeta, EscrowValidationResult, ParsedX402Headers, MerchantValidationResult, X402DirectPayment, SettlementPayload, GetX402DirectOptions, } 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 { GeyserEventStream } from "./events/geyser";
-export type { GeyserConfig, GeyserStreamEvents } from "./events/geyser";
-export { AgentModule, FeedbackModule, IndexingModule, ToolsModule, VaultModule, EscrowModule, EscrowV2Module, ReceiptModule, StakingModule, SubscriptionModule, 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 { parseSapInstructionsFromTransaction, parseSapInstructionNamesFromTransaction, parseSapInstructionsFromList, parseSapInstructionNamesFromList, containsSapInstruction, parseSapTransactionComplete, parseSapTransactionBatch, decodeInnerInstructions, filterSapInnerInstructions, extractAccountKeys, TransactionParser, } from "./parser";
-export type { DecodedSapInstruction, DecodedInnerInstruction, ParsedSapTransaction, ParseFilterOptions, SapInstructionCoder, CompiledInner, InnerInstructionGroup, } from "./parser";
-export { DiscoveryRegistry, X402Registry, SessionManager, AgentBuilder, MetaplexBridge, } from "./registries/index";
-export type { DiscoveredAgent, AgentProfile, DiscoveredTool, NetworkOverview, ToolCategoryName, CostEstimate, PaymentContext, PreparePaymentOptions, X402Headers, EscrowBalance, SettlementResult, BatchSettlementResult, SettleOptions, SessionContext, WriteResult, SealResult, RingBufferEntry, SessionStatus, CapabilityInput, PricingTierInput, ToolInput, RegisterResult, RegisterWithToolsResult, UnifiedProfile, AgentIdentifierResolution, MplAgentSnapshot, Eip8004Registration, Eip8004Service, AttachAgentIdentityOpts, UpdateAgentIdentityUriOpts, } from "./registries/index";
-//# sourceMappingURL=index.d.ts.map

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

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