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

package/dist/esm/constants/limits.js

@@ -0,0 +1,158 @@
+/**
+ * @module constants/limits
+ * @description Protocol size limits, version constants, and enum numeric values.
+ *
+ * All values mirror the on-chain Rust constraints exactly.
+ * Used for client-side validation before sending transactions.
+ *
+ * @category Constants
+ * @since v0.1.0
+ */
+// ═══════════════════════════════════════════════════════════════════
+//  Size Limits (mirrors Rust impl blocks)
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Protocol size constraints mirroring the Rust `impl` blocks.
+ *
+ * Use these values for client-side validation before submitting
+ * transactions — exceeding any limit will cause an on-chain error.
+ *
+ * @name LIMITS
+ * @description A frozen object containing all protocol-enforced size and length bounds.
+ * @category Constants
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { LIMITS } from "@synapse-sap/sdk/constants";
+ *
+ * if (name.length > LIMITS.MAX_NAME_LEN) {
+ *   throw new Error("Agent name too long");
+ * }
+ * ```
+ */
+export const LIMITS = {
+    /** Max agent name length in bytes. */
+    MAX_NAME_LEN: 64,
+    /** Max agent description length in bytes. */
+    MAX_DESC_LEN: 256,
+    /** Max URI length (agent_uri, x402_endpoint). */
+    MAX_URI_LEN: 256,
+    /** Max agent DID-style identifier length. */
+    MAX_AGENT_ID_LEN: 128,
+    /** Max capabilities per agent. */
+    MAX_CAPABILITIES: 10,
+    /** Max pricing tiers per agent. */
+    MAX_PRICING_TIERS: 5,
+    /** Max protocol strings per agent. */
+    MAX_PROTOCOLS: 5,
+    /** Max active plugins per agent. */
+    MAX_PLUGINS: 5,
+    /** Max volume curve breakpoints per tier. */
+    MAX_VOLUME_CURVE_POINTS: 5,
+    /** Max feedback tag length. */
+    MAX_TAG_LEN: 32,
+    /** Max agents in a capability/protocol index. */
+    MAX_AGENTS_PER_INDEX: 100,
+    /** Max tool name length. */
+    MAX_TOOL_NAME_LEN: 32,
+    /** Max tools in a category index. */
+    MAX_TOOLS_PER_CATEGORY: 100,
+    /** Max attestation type length. */
+    MAX_ATTESTATION_TYPE_LEN: 32,
+    /** Max inscription size (encrypted_data per fragment). */
+    MAX_INSCRIPTION_SIZE: 750,
+    /** Inscriptions per epoch page. */
+    INSCRIPTIONS_PER_EPOCH: 1000,
+    /** Max memory chunk size (legacy). */
+    MAX_CHUNK_SIZE: 900,
+    /** Max write size per buffer append (legacy). */
+    MAX_BUFFER_WRITE_SIZE: 750,
+    /** Max total buffer page size (legacy). */
+    MAX_BUFFER_TOTAL_SIZE: 10_000,
+    /** Ring buffer capacity for MemoryLedger. */
+    RING_CAPACITY: 4096,
+    /** Max ledger write size per call. */
+    MAX_LEDGER_WRITE_SIZE: 750,
+    /** Max settlements in a batch. */
+    MAX_BATCH_SETTLEMENTS: 10,
+    /** Feedback score range: 0–1000. */
+    MAX_FEEDBACK_SCORE: 1000,
+};
+// ═══════════════════════════════════════════════════════════════════
+//  Protocol Versions
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Current on-chain protocol version for `AgentAccount`.
+ *
+ * @name AGENT_VERSION
+ * @description Integer version stamped into every agent account on registration.
+ * @category Constants
+ * @since v0.1.0
+ */
+export const AGENT_VERSION = 1;
+/**
+ * Current on-chain protocol version for `MemoryVault`.
+ *
+ * @name VAULT_PROTOCOL_VERSION
+ * @description Integer version stamped into every vault account on initialisation.
+ * @category Constants
+ * @since v0.1.0
+ */
+export const VAULT_PROTOCOL_VERSION = 1;
+// ═══════════════════════════════════════════════════════════════════
+//  Numeric Enum Values
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Tool category to `u8` discriminant mapping.
+ *
+ * Mirrors the Rust `ToolCategory` enum ordinals. Use these values
+ * when constructing or filtering tool-related instructions.
+ *
+ * @name TOOL_CATEGORY_VALUES
+ * @description Frozen mapping of tool category names to their on-chain `u8` discriminants.
+ * @category Constants
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { TOOL_CATEGORY_VALUES } from "@synapse-sap/sdk/constants";
+ *
+ * const categoryByte = TOOL_CATEGORY_VALUES.Swap; // 0
+ * ```
+ */
+export const TOOL_CATEGORY_VALUES = {
+    Swap: 0,
+    Lend: 1,
+    Stake: 2,
+    Nft: 3,
+    Payment: 4,
+    Data: 5,
+    Governance: 6,
+    Bridge: 7,
+    Analytics: 8,
+    Custom: 9,
+};
+/**
+ * HTTP method to `u8` discriminant mapping.
+ *
+ * Mirrors the Rust `HttpMethod` enum ordinals. Used when publishing
+ * or filtering tool endpoints.
+ *
+ * @name HTTP_METHOD_VALUES
+ * @description Frozen mapping of HTTP method names to their on-chain `u8` discriminants.
+ * @category Constants
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { HTTP_METHOD_VALUES } from "@synapse-sap/sdk/constants";
+ *
+ * const method = HTTP_METHOD_VALUES.Post; // 1
+ * ```
+ */
+export const HTTP_METHOD_VALUES = {
+    Get: 0,
+    Post: 1,
+    Put: 2,
+    Delete: 3,
+    Compound: 4,
+};
+//# sourceMappingURL=limits.js.map

package/dist/esm/constants/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../../src/constants/limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,sEAAsE;AACtE,0CAA0C;AAC1C,sEAAsE;AAEtE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,sCAAsC;IACtC,YAAY,EAAE,EAAE;IAChB,6CAA6C;IAC7C,YAAY,EAAE,GAAG;IACjB,iDAAiD;IACjD,WAAW,EAAE,GAAG;IAChB,6CAA6C;IAC7C,gBAAgB,EAAE,GAAG;IACrB,kCAAkC;IAClC,gBAAgB,EAAE,EAAE;IACpB,mCAAmC;IACnC,iBAAiB,EAAE,CAAC;IACpB,sCAAsC;IACtC,aAAa,EAAE,CAAC;IAChB,oCAAoC;IACpC,WAAW,EAAE,CAAC;IACd,6CAA6C;IAC7C,uBAAuB,EAAE,CAAC;IAC1B,+BAA+B;IAC/B,WAAW,EAAE,EAAE;IACf,iDAAiD;IACjD,oBAAoB,EAAE,GAAG;IACzB,4BAA4B;IAC5B,iBAAiB,EAAE,EAAE;IACrB,qCAAqC;IACrC,sBAAsB,EAAE,GAAG;IAC3B,mCAAmC;IACnC,wBAAwB,EAAE,EAAE;IAC5B,0DAA0D;IAC1D,oBAAoB,EAAE,GAAG;IACzB,mCAAmC;IACnC,sBAAsB,EAAE,IAAI;IAC5B,sCAAsC;IACtC,cAAc,EAAE,GAAG;IACnB,iDAAiD;IACjD,qBAAqB,EAAE,GAAG;IAC1B,2CAA2C;IAC3C,qBAAqB,EAAE,MAAM;IAC7B,6CAA6C;IAC7C,aAAa,EAAE,IAAI;IACnB,sCAAsC;IACtC,qBAAqB,EAAE,GAAG;IAC1B,kCAAkC;IAClC,qBAAqB,EAAE,EAAE;IACzB,oCAAoC;IACpC,kBAAkB,EAAE,IAAI;CAChB,CAAC;AAEX,sEAAsE;AACtE,qBAAqB;AACrB,sEAAsE;AAEtE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAE/B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAExC,sEAAsE;AACtE,uBAAuB;AACvB,sEAAsE;AAEtE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,GAAG,EAAE,CAAC;IACN,OAAO,EAAE,CAAC;IACV,IAAI,EAAE,CAAC;IACP,UAAU,EAAE,CAAC;IACb,MAAM,EAAE,CAAC;IACT,SAAS,EAAE,CAAC;IACZ,MAAM,EAAE,CAAC;CACD,CAAC;AAEX;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,GAAG,EAAE,CAAC;IACN,IAAI,EAAE,CAAC;IACP,GAAG,EAAE,CAAC;IACN,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,CAAC;CACH,CAAC"}

package/dist/esm/constants/programs.js

@@ -0,0 +1,75 @@
+/**
+ * @module constants/programs
+ * @description SAP v2 program IDs for each Solana cluster.
+ *
+ * The canonical program address is shared across mainnet, devnet,
+ * and localnet. If you deploy a custom instance, override the
+ * program ID in `SapClient.from(provider, customProgramId)`.
+ *
+ * @category Constants
+ * @since v0.1.0
+ */
+import { PublicKey } from "@solana/web3.js";
+// ═══════════════════════════════════════════════════════════════════
+//  Program Address
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * SAP v2 program address string (base58).
+ *
+ * Vanity keypair derived from the `SAPTU7a…` prefix.
+ *
+ * @name SAP_PROGRAM_ADDRESS
+ * @description The canonical on-chain program address shared by all Solana clusters.
+ * @category Constants
+ * @since v0.1.0
+ * @see {@link SAP_PROGRAM_ID}
+ */
+export const SAP_PROGRAM_ADDRESS = "SAPTU7aUXk2AaAdktexae1iuxXpokxzNDBAYYhaVyQL";
+// ═══════════════════════════════════════════════════════════════════
+//  Per-Network PublicKeys
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * SAP v2 mainnet-beta program ID.
+ *
+ * @name MAINNET_SAP_PROGRAM_ID
+ * @description `PublicKey` instance of {@link SAP_PROGRAM_ADDRESS} for mainnet-beta.
+ * @category Constants
+ * @since v0.1.0
+ * @see {@link SAP_PROGRAM_ADDRESS}
+ */
+export const MAINNET_SAP_PROGRAM_ID = new PublicKey(SAP_PROGRAM_ADDRESS);
+/**
+ * SAP v2 devnet program ID.
+ *
+ * @name DEVNET_SAP_PROGRAM_ID
+ * @description `PublicKey` instance of {@link SAP_PROGRAM_ADDRESS} for devnet.
+ * @category Constants
+ * @since v0.1.0
+ * @see {@link SAP_PROGRAM_ADDRESS}
+ */
+export const DEVNET_SAP_PROGRAM_ID = new PublicKey(SAP_PROGRAM_ADDRESS);
+/**
+ * Localnet / solana-test-validator program ID.
+ *
+ * Override with your own keypair if deploying locally at a different address.
+ *
+ * @name LOCALNET_SAP_PROGRAM_ID
+ * @description `PublicKey` instance of {@link SAP_PROGRAM_ADDRESS} for localnet / `solana-test-validator`.
+ * @category Constants
+ * @since v0.1.0
+ * @see {@link SAP_PROGRAM_ADDRESS}
+ */
+export const LOCALNET_SAP_PROGRAM_ID = new PublicKey(SAP_PROGRAM_ADDRESS);
+/**
+ * Default program ID used by `SapClient.from()` when no explicit ID is provided.
+ *
+ * Alias for {@link MAINNET_SAP_PROGRAM_ID}.
+ *
+ * @name SAP_PROGRAM_ID
+ * @description Convenience alias pointing to the mainnet-beta program ID.
+ * @category Constants
+ * @since v0.1.0
+ * @see {@link MAINNET_SAP_PROGRAM_ID}
+ */
+export const SAP_PROGRAM_ID = MAINNET_SAP_PROGRAM_ID;
+//# sourceMappingURL=programs.js.map

package/dist/esm/constants/programs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"programs.js","sourceRoot":"","sources":["../../../src/constants/programs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,sEAAsE;AACtE,mBAAmB;AACnB,sEAAsE;AAEtE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,6CAA6C,CAAC;AAEhD,sEAAsE;AACtE,0BAA0B;AAC1B,sEAAsE;AAEtE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,SAAS,CAAC,mBAAmB,CAAC,CAAC;AAEzE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,SAAS,CAAC,mBAAmB,CAAC,CAAC;AAExE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,SAAS,CAAC,mBAAmB,CAAC,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,sBAAsB,CAAC"}

package/dist/esm/constants/seeds.js

@@ -0,0 +1,54 @@
+/**
+ * @module constants/seeds
+ * @description PDA seed prefix constants.
+ *
+ * Every seed string mirrors the Rust `#[account(seeds = [...])]` definitions.
+ *
+ * @category Constants
+ * @since v0.1.0
+ */
+// ═══════════════════════════════════════════════════════════════════
+//  PDA Seed Prefixes
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * PDA seed prefix lookup table.
+ *
+ * Each key corresponds to an on-chain account type, and the value is the
+ * UTF-8 string used as the first seed segment in
+ * `PublicKey.findProgramAddressSync`.
+ *
+ * @name SEEDS
+ * @description Maps logical account names to their Rust-defined PDA seed prefix strings.
+ * @category Constants
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { SEEDS } from "@synapse-sap/sdk/constants";
+ *
+ * Buffer.from(SEEDS.AGENT); // => "sap_agent"
+ * ```
+ * @see {@link SeedKey}
+ */
+export const SEEDS = {
+    AGENT: "sap_agent",
+    FEEDBACK: "sap_feedback",
+    CAPABILITY_INDEX: "sap_cap_idx",
+    PROTOCOL_INDEX: "sap_proto_idx",
+    GLOBAL: "sap_global",
+    PLUGIN: "sap_plugin",
+    MEMORY: "sap_memory",
+    MEMORY_CHUNK: "sap_mem_chunk",
+    VAULT: "sap_vault",
+    SESSION: "sap_session",
+    EPOCH: "sap_epoch",
+    DELEGATE: "sap_delegate",
+    TOOL: "sap_tool",
+    CHECKPOINT: "sap_checkpoint",
+    ESCROW: "sap_escrow",
+    STATS: "sap_stats",
+    TOOL_CATEGORY: "sap_tool_cat",
+    ATTESTATION: "sap_attest",
+    LEDGER: "sap_ledger",
+    LEDGER_PAGE: "sap_page",
+};
+//# sourceMappingURL=seeds.js.map

package/dist/esm/constants/seeds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seeds.js","sourceRoot":"","sources":["../../../src/constants/seeds.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,sEAAsE;AACtE,qBAAqB;AACrB,sEAAsE;AAEtE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAE,WAAW;IAClB,QAAQ,EAAE,cAAc;IACxB,gBAAgB,EAAE,aAAa;IAC/B,cAAc,EAAE,eAAe;IAC/B,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,YAAY,EAAE,eAAe;IAC7B,KAAK,EAAE,WAAW;IAClB,OAAO,EAAE,aAAa;IACtB,KAAK,EAAE,WAAW;IAClB,QAAQ,EAAE,cAAc;IACxB,IAAI,EAAE,UAAU;IAChB,UAAU,EAAE,gBAAgB;IAC5B,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,WAAW;IAClB,aAAa,EAAE,cAAc;IAC7B,WAAW,EAAE,YAAY;IACzB,MAAM,EAAE,YAAY;IACpB,WAAW,EAAE,UAAU;CACf,CAAC"}

package/dist/esm/core/client.js

@@ -0,0 +1,384 @@
+/**
+ * @module core/client
+ * @description Core SapClient — thin wrapper around the Anchor program
+ * that wires up provider, IDL, and exposes typed module accessors.
+ *
+ * This is the primary entry point for the `@synapse-sap/sdk` package.
+ * All protocol domains (agent lifecycle, reputation, vault, escrow, etc.)
+ * are available as lazily-instantiated, strongly-typed module accessors.
+ *
+ * @since v0.1.0
+ * @category Core
+ *
+ * @example
+ * ```ts
+ * import { SapClient } from "@synapse-sap/sdk";
+ *
+ * const client = SapClient.from(provider);          // auto-IDL
+ * const client = SapClient.fromProgram(program);    // existing program
+ *
+ * // Use domain modules:
+ * await client.agent.register({ ... });
+ * await client.vault.initVault(vaultNonce);
+ * const escrow = await client.escrow.fetch(escrowPda);
+ * ```
+ */
+import { Program } from "@coral-xyz/anchor";
+import { SAP_PROGRAM_ID } from "../constants";
+import { AgentModule } from "../modules/agent";
+import { FeedbackModule } from "../modules/feedback";
+import { IndexingModule } from "../modules/indexing";
+import { ToolsModule } from "../modules/tools";
+import { VaultModule } from "../modules/vault";
+import { EscrowModule } from "../modules/escrow";
+import { AttestationModule } from "../modules/attestation";
+import { LedgerModule } from "../modules/ledger";
+import { EventParser } from "../events";
+import { DiscoveryRegistry } from "../registries/discovery";
+import { X402Registry } from "../registries/x402";
+import { SessionManager } from "../registries/session";
+import { AgentBuilder } from "../registries/builder";
+// IDL is embedded inside the SDK — no external workspace dependency
+import idl from "../idl/synapse_agent_sap.json";
+/**
+ * @name SapClient
+ * @description Root entry point for the Solana Agent Protocol v2 TypeScript SDK.
+ *
+ * Each protocol domain is exposed as a lazily-instantiated module:
+ * `agent`, `feedback`, `indexing`, `tools`, `vault`, `escrow`,
+ * `attestation`, `ledger`, `events`.
+ *
+ * Higher-level abstractions (`discovery`, `x402`, `session`, `builder`)
+ * compose the low-level modules into ergonomic workflows.
+ *
+ * Instantiate via the static factory methods {@link SapClient.from} or
+ * {@link SapClient.fromProgram} — the constructor is private.
+ *
+ * @category Core
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { SapClient } from "@synapse-sap/sdk";
+ * import { AnchorProvider } from "@coral-xyz/anchor";
+ *
+ * const provider = AnchorProvider.env();
+ * const client = SapClient.from(provider);
+ *
+ * // Register an agent
+ * await client.agent.register({
+ *   name: "SwapBot",
+ *   description: "AI-powered swap agent",
+ * });
+ *
+ * // Discover agents
+ * const agents = await client.discovery.findAgentsByProtocol("jupiter");
+ * ```
+ */
+export class SapClient {
+    /**
+     * @name program
+     * @description The underlying Anchor `Program` instance used for all RPC
+     * calls and account deserialization.
+     * @readonly
+     * @category Core
+     * @since v0.1.0
+     */
+    program;
+    /**
+     * @name walletPubkey
+     * @description The provider wallet's public key, extracted from the
+     * Anchor provider for convenience. This is the default authority /
+     * payer used by module instructions unless overridden.
+     * @readonly
+     * @category Core
+     * @since v0.1.0
+     */
+    walletPubkey;
+    // ── Lazy module singletons ────────────────────────
+    #agent;
+    #feedback;
+    #indexing;
+    #tools;
+    #vault;
+    #escrow;
+    #attestation;
+    #ledger;
+    #events;
+    // ── Lazy registry singletons ──────────────────────
+    #discovery;
+    #x402;
+    #session;
+    constructor(program) {
+        this.program = program;
+        this.walletPubkey = program.provider.wallet.publicKey;
+    }
+    // ═════════════════════════════════════════════
+    //  Factory Methods
+    // ═════════════════════════════════════════════
+    /**
+     * @name from
+     * @description Create a {@link SapClient} from an `AnchorProvider`.
+     * Automatically loads the embedded IDL shipped with the SDK.
+     *
+     * @param provider - A configured `AnchorProvider` with wallet and connection.
+     * @param programId - Optional override for the SAP program ID.
+     *   Defaults to `SAP_PROGRAM_ID` from `@synapse-sap/sdk/constants`.
+     * @returns A fully-initialised `SapClient` ready for use.
+     *
+     * @category Core
+     * @since v0.1.0
+     * @see {@link SapClient.fromProgram} for an alternative accepting a pre-built `Program`.
+     *
+     * @example
+     * ```ts
+     * import { SapClient } from "@synapse-sap/sdk";
+     * import { AnchorProvider } from "@coral-xyz/anchor";
+     *
+     * const provider = AnchorProvider.env();
+     * const client = SapClient.from(provider);
+     * ```
+     *
+     * @example Custom program ID (e.g. localnet)
+     * ```ts
+     * const client = SapClient.from(provider, myLocalProgramId);
+     * ```
+     */
+    static from(provider, programId = SAP_PROGRAM_ID) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const program = new Program(idl, provider);
+        // Override program ID if non-default
+        if (!programId.equals(SAP_PROGRAM_ID)) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            program.programId = programId;
+        }
+        return new SapClient(program);
+    }
+    /**
+     * @name fromProgram
+     * @description Create a {@link SapClient} from an existing Anchor `Program`
+     * instance. Useful when the caller already has a configured program or
+     * needs full control over IDL resolution.
+     *
+     * @param program - A pre-built Anchor `Program` targeting the SAP program.
+     * @returns A fully-initialised `SapClient` wrapping the supplied program.
+     *
+     * @category Core
+     * @since v0.1.0
+     * @see {@link SapClient.from} for the convenience factory that auto-loads the IDL.
+     *
+     * @example
+     * ```ts
+     * import { Program } from "@coral-xyz/anchor";
+     * import { SapClient } from "@synapse-sap/sdk";
+     *
+     * const program = new Program(idl, provider);
+     * const client = SapClient.fromProgram(program);
+     * ```
+     */
+    static fromProgram(program) {
+        return new SapClient(program);
+    }
+    // ═════════════════════════════════════════════
+    //  Module Accessors (lazy singletons)
+    // ═════════════════════════════════════════════
+    /**
+     * @name agent
+     * @description Agent lifecycle: register, update, deactivate, close, and
+     * query agent metrics on-chain.
+     * @returns {AgentModule} The lazily-instantiated `AgentModule` singleton.
+     * @category Modules
+     * @since v0.1.0
+     * @see {@link AgentModule}
+     */
+    get agent() {
+        return (this.#agent ??= new AgentModule(this.program));
+    }
+    /**
+     * @name feedback
+     * @description Trustless reputation: give, update, revoke, and close
+     * on-chain feedback entries for agents.
+     * @returns {FeedbackModule} The lazily-instantiated `FeedbackModule` singleton.
+     * @category Modules
+     * @since v0.1.0
+     * @see {@link FeedbackModule}
+     */
+    get feedback() {
+        return (this.#feedback ??= new FeedbackModule(this.program));
+    }
+    /**
+     * @name indexing
+     * @description Scalable discovery: capability, protocol, and tool-category
+     * on-chain indexes for agent search.
+     * @returns {IndexingModule} The lazily-instantiated `IndexingModule` singleton.
+     * @category Modules
+     * @since v0.1.0
+     * @see {@link IndexingModule}
+     */
+    get indexing() {
+        return (this.#indexing ??= new IndexingModule(this.program));
+    }
+    /**
+     * @name tools
+     * @description Tool schema registry: publish, inscribe, update, and close
+     * on-chain tool definitions.
+     * @returns {ToolsModule} The lazily-instantiated `ToolsModule` singleton.
+     * @category Modules
+     * @since v0.1.0
+     * @see {@link ToolsModule}
+     */
+    get tools() {
+        return (this.#tools ??= new ToolsModule(this.program));
+    }
+    /**
+     * @name vault
+     * @description Encrypted memory vault: initialise vaults, manage sessions,
+     * inscribe data, and delegate access.
+     * @returns {VaultModule} The lazily-instantiated `VaultModule` singleton.
+     * @category Modules
+     * @since v0.1.0
+     * @see {@link VaultModule}
+     */
+    get vault() {
+        return (this.#vault ??= new VaultModule(this.program));
+    }
+    /**
+     * @name escrow
+     * @description x402 escrow settlement: create escrow accounts, deposit
+     * funds, settle payments, and withdraw balances.
+     * @returns {EscrowModule} The lazily-instantiated `EscrowModule` singleton.
+     * @category Modules
+     * @since v0.1.0
+     * @see {@link EscrowModule}
+     */
+    get escrow() {
+        return (this.#escrow ??= new EscrowModule(this.program));
+    }
+    /**
+     * @name attestation
+     * @description Web of trust: create, revoke, and close on-chain
+     * attestations between agents.
+     * @returns {AttestationModule} The lazily-instantiated `AttestationModule` singleton.
+     * @category Modules
+     * @since v0.1.0
+     * @see {@link AttestationModule}
+     */
+    get attestation() {
+        return (this.#attestation ??= new AttestationModule(this.program));
+    }
+    /**
+     * @name ledger
+     * @description Unified on-chain memory: initialise ledger accounts, write
+     * entries, seal pages, and close ledgers.
+     * @returns {LedgerModule} The lazily-instantiated `LedgerModule` singleton.
+     * @category Modules
+     * @since v0.1.0
+     * @see {@link LedgerModule}
+     */
+    get ledger() {
+        return (this.#ledger ??= new LedgerModule(this.program));
+    }
+    /**
+     * @name events
+     * @description Decode SAP protocol events from on-chain transaction logs.
+     * @returns {EventParser} The lazily-instantiated `EventParser` singleton.
+     * @category Modules
+     * @since v0.1.0
+     * @see {@link EventParser}
+     */
+    get events() {
+        return (this.#events ??= new EventParser(this.program));
+    }
+    // ═════════════════════════════════════════════
+    //  Registry Accessors (high-level abstractions)
+    // ═════════════════════════════════════════════
+    /**
+     * @name discovery
+     * @description Agent & tool discovery across the SAP network.
+     * Provides high-level queries for locating agents by capability,
+     * protocol, or wallet address.
+     *
+     * @returns {DiscoveryRegistry} The lazily-instantiated `DiscoveryRegistry` singleton.
+     * @category Registries
+     * @since v0.1.0
+     * @see {@link DiscoveryRegistry}
+     *
+     * @example
+     * ```ts
+     * const agents = await client.discovery.findAgentsByProtocol("jupiter");
+     * const profile = await client.discovery.getAgentProfile(wallet);
+     * ```
+     */
+    get discovery() {
+        return (this.#discovery ??= new DiscoveryRegistry(this.program));
+    }
+    /**
+     * @name x402
+     * @description x402 micropayment lifecycle — pricing, escrow, headers,
+     * and settlement. Orchestrates the full pay-per-call flow between
+     * consumer and agent.
+     *
+     * @returns {X402Registry} The lazily-instantiated `X402Registry` singleton.
+     * @category Registries
+     * @since v0.1.0
+     * @see {@link X402Registry}
+     *
+     * @example
+     * ```ts
+     * const ctx = await client.x402.preparePayment(agentWallet, { ... });
+     * const headers = client.x402.buildPaymentHeaders(ctx);
+     * const receipt = await client.x402.settle(depositor, 5, serviceData);
+     * ```
+     */
+    get x402() {
+        return (this.#x402 ??= new X402Registry(this.program));
+    }
+    /**
+     * @name session
+     * @description Unified memory session lifecycle — vault, session, and
+     * ledger management. Provides a single interface for starting
+     * conversations, writing messages, and reading back history.
+     *
+     * @returns {SessionManager} The lazily-instantiated `SessionManager` singleton.
+     * @category Registries
+     * @since v0.1.0
+     * @see {@link SessionManager}
+     *
+     * @example
+     * ```ts
+     * const ctx = await client.session.start("conversation-123");
+     * await client.session.write(ctx, "Hello from agent");
+     * const msgs = await client.session.readLatest(ctx);
+     * ```
+     */
+    get session() {
+        return (this.#session ??= new SessionManager(this.program));
+    }
+    /**
+     * @name builder
+     * @description Fluent agent registration builder.
+     * Returns a **new** `AgentBuilder` on every access — use for one-shot
+     * registration flows. Chain configuration calls and finalise with
+     * `.register()`.
+     *
+     * @returns {AgentBuilder} A fresh `AgentBuilder` instance.
+     * @category Registries
+     * @since v0.1.0
+     * @see {@link AgentBuilder}
+     *
+     * @example
+     * ```ts
+     * await client.builder
+     *   .agent("SwapBot")
+     *   .description("AI-powered swap agent")
+     *   .x402Endpoint("https://api.example.com/x402")
+     *   .addCapability("jupiter:swap", { protocol: "jupiter" })
+     *   .addPricingTier({ tierId: "standard", pricePerCall: 1000, rateLimit: 60 })
+     *   .register();
+     * ```
+     */
+    get builder() {
+        return new AgentBuilder(this.program);
+    }
+}
+//# sourceMappingURL=client.js.map