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

package/dist/esm/postgres/sync.js.map

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

package/dist/esm/postgres/types.js

@@ -0,0 +1,41 @@
+/**
+ * @module postgres/types
+ * @description PostgreSQL adapter type definitions for SAP v2.
+ *
+ * Defines configuration, row shapes, and query result types
+ * for the PostgreSQL off-chain mirror.
+ *
+ * @category Postgres
+ * @since v0.1.0
+ */
+/**
+ * @name SapTableName
+ * @description Mapping of account types to PostgreSQL table names.
+ * @category Postgres
+ * @since v0.1.0
+ */
+export const SAP_TABLE_MAP = {
+    global_registry: "sap_global_registry",
+    agents: "sap_agents",
+    agent_stats: "sap_agent_stats",
+    feedbacks: "sap_feedbacks",
+    capability_indexes: "sap_capability_indexes",
+    protocol_indexes: "sap_protocol_indexes",
+    plugin_slots: "sap_plugin_slots",
+    memory_entries: "sap_memory_entries",
+    memory_chunks: "sap_memory_chunks",
+    memory_vaults: "sap_memory_vaults",
+    sessions: "sap_sessions",
+    epoch_pages: "sap_epoch_pages",
+    vault_delegates: "sap_vault_delegates",
+    tools: "sap_tools",
+    checkpoints: "sap_checkpoints",
+    escrows: "sap_escrows",
+    tool_category_indexes: "sap_tool_category_indexes",
+    attestations: "sap_attestations",
+    memory_buffers: "sap_memory_buffers",
+    memory_digests: "sap_memory_digests",
+    memory_ledgers: "sap_memory_ledgers",
+    ledger_pages: "sap_ledger_pages",
+};
+//# sourceMappingURL=types.js.map

package/dist/esm/postgres/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/postgres/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAwEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAmC;IAC3D,eAAe,EAAE,qBAAqB;IACtC,MAAM,EAAE,YAAY;IACpB,WAAW,EAAE,iBAAiB;IAC9B,SAAS,EAAE,eAAe;IAC1B,kBAAkB,EAAE,wBAAwB;IAC5C,gBAAgB,EAAE,sBAAsB;IACxC,YAAY,EAAE,kBAAkB;IAChC,cAAc,EAAE,oBAAoB;IACpC,aAAa,EAAE,mBAAmB;IAClC,aAAa,EAAE,mBAAmB;IAClC,QAAQ,EAAE,cAAc;IACxB,WAAW,EAAE,iBAAiB;IAC9B,eAAe,EAAE,qBAAqB;IACtC,KAAK,EAAE,WAAW;IAClB,WAAW,EAAE,iBAAiB;IAC9B,OAAO,EAAE,aAAa;IACtB,qBAAqB,EAAE,2BAA2B;IAClD,YAAY,EAAE,kBAAkB;IAChC,cAAc,EAAE,oBAAoB;IACpC,cAAc,EAAE,oBAAoB;IACpC,cAAc,EAAE,oBAAoB;IACpC,YAAY,EAAE,kBAAkB;CACjC,CAAC"}

package/dist/esm/registries/builder.js

@@ -0,0 +1,410 @@
+/**
+ * @module registries/builder
+ * @description Fluent agent registration builder.
+ *
+ * Provides a chainable API for registering a fully-configured agent
+ * in a single flow — identity, capabilities, pricing tiers, tools,
+ * x402 endpoint, and discovery indexes.
+ *
+ * Instead of calling 5+ separate instructions manually, developers
+ * use a single builder chain that validates inputs and batches
+ * the registration cleanly.
+ *
+ * @category Registries
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * const result = await client.builder
+ *   .agent("SwapBot")
+ *   .description("AI-powered Jupiter swap agent")
+ *   .x402Endpoint("https://swapbot.example.com/x402")
+ *   .addCapability("jupiter:swap", { protocol: "jupiter", version: "6.0" })
+ *   .addCapability("jupiter:quote", { protocol: "jupiter", version: "6.0" })
+ *   .addPricingTier({
+ *     tierId: "standard",
+ *     pricePerCall: 1000,
+ *     rateLimit: 60,
+ *     tokenType: "sol",
+ *     settlementMode: "x402",
+ *   })
+ *   .addProtocol("jupiter")
+ *   .register();
+ *
+ * // Or register with tools:
+ * const result = await client.builder
+ *   .agent("DataBot")
+ *   .description("Real-time DeFi data feeds")
+ *   .addTool({ name: "getPrice", protocol: "pyth", category: "data", ... })
+ *   .registerWithTools();
+ * ```
+ */
+import { SystemProgram, } from "@solana/web3.js";
+import { BN } from "@coral-xyz/anchor";
+import { deriveAgent, deriveAgentStats, deriveTool, deriveGlobalRegistry, } from "../pda";
+import { sha256, hashToArray, assert } from "../utils";
+import { LIMITS, TOOL_CATEGORY_VALUES, HTTP_METHOD_VALUES } from "../constants";
+import { TokenType, SettlementMode } from "../types";
+// ═══════════════════════════════════════════════════════════════════
+//  Agent Builder
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name AgentBuilder
+ * @description Fluent builder for registering a fully-configured agent on-chain.
+ *
+ * Chains identity setters, capability/pricing/protocol adders, and tool
+ * definitions into a single validated registration flow. Validates all
+ * inputs against on-chain limits before sending transactions.
+ *
+ * @category Registries
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * const result = await client.builder
+ *   .agent("SwapBot")
+ *   .description("AI-powered Jupiter swap agent")
+ *   .x402Endpoint("https://swapbot.example.com/x402")
+ *   .addCapability("jupiter:swap", { protocol: "jupiter", version: "6.0" })
+ *   .addPricingTier({ tierId: "standard", pricePerCall: 1000, rateLimit: 60 })
+ *   .register();
+ * ```
+ */
+export class AgentBuilder {
+    program;
+    wallet;
+    _name = "";
+    _description = "";
+    _agentId = null;
+    _agentUri = null;
+    _x402Endpoint = null;
+    _capabilities = [];
+    _pricing = [];
+    _protocols = [];
+    _tools = [];
+    constructor(program) {
+        this.program = program;
+        this.wallet = program.provider.wallet.publicKey;
+    }
+    // ── Fluent Setters ───────────────────────────────────
+    /**
+     * @name agent
+     * @description Set the agent display name.
+     * @param name - Display name (max 64 characters).
+     * @returns `this` for chaining.
+     * @since v0.1.0
+     */
+    agent(name) {
+        assert(name.length <= LIMITS.MAX_NAME_LEN, `Name exceeds ${LIMITS.MAX_NAME_LEN} chars`);
+        this._name = name;
+        return this;
+    }
+    /**
+     * @name description
+     * @description Set the agent description.
+     * @param desc - Description text (max 256 characters).
+     * @returns `this` for chaining.
+     * @since v0.1.0
+     */
+    description(desc) {
+        assert(desc.length <= LIMITS.MAX_DESC_LEN, `Description exceeds ${LIMITS.MAX_DESC_LEN} chars`);
+        this._description = desc;
+        return this;
+    }
+    /**
+     * @name agentId
+     * @description Set a DID-style agent identifier.
+     * @param id - Agent identifier string.
+     * @returns `this` for chaining.
+     * @since v0.1.0
+     */
+    agentId(id) {
+        assert(id.length <= LIMITS.MAX_AGENT_ID_LEN, `Agent ID exceeds ${LIMITS.MAX_AGENT_ID_LEN} chars`);
+        this._agentId = id;
+        return this;
+    }
+    /**
+     * @name agentUri
+     * @description Set an agent metadata URI.
+     * @param uri - Metadata URI string.
+     * @returns `this` for chaining.
+     * @since v0.1.0
+     */
+    agentUri(uri) {
+        assert(uri.length <= LIMITS.MAX_URI_LEN, `URI exceeds ${LIMITS.MAX_URI_LEN} chars`);
+        this._agentUri = uri;
+        return this;
+    }
+    /**
+     * @name x402Endpoint
+     * @description Set the x402 payment endpoint URL.
+     * @param url - The x402 endpoint URL for the agent.
+     * @returns `this` for chaining.
+     * @since v0.1.0
+     */
+    x402Endpoint(url) {
+        assert(url.length <= LIMITS.MAX_URI_LEN, `x402 endpoint exceeds ${LIMITS.MAX_URI_LEN} chars`);
+        this._x402Endpoint = url;
+        return this;
+    }
+    /**
+     * @name addCapability
+     * @description Add a capability to the agent.
+     *
+     * @param id - Capability identifier string (e.g. `"jupiter:swap"`).
+     * @param opts - Optional capability metadata.
+     * @param opts.protocol - Protocol the capability belongs to.
+     * @param opts.version - Capability version string.
+     * @param opts.description - Human-readable capability description.
+     * @returns `this` for chaining.
+     * @since v0.1.0
+     *
+     * @example
+     * ```ts
+     * builder.addCapability("jupiter:swap", { protocol: "jupiter", version: "6.0" })
+     * ```
+     */
+    addCapability(id, opts) {
+        assert(this._capabilities.length < LIMITS.MAX_CAPABILITIES, `Max ${LIMITS.MAX_CAPABILITIES} capabilities`);
+        this._capabilities.push({
+            id,
+            description: opts?.description ?? null,
+            protocolId: opts?.protocol ?? null,
+            version: opts?.version ?? null,
+        });
+        return this;
+    }
+    /**
+     * @name addPricingTier
+     * @description Add a pricing tier for the agent's services.
+     * Supports flat-rate, volume-curve, and configurable settlement modes.
+     *
+     * @param input - Pricing tier configuration.
+     * @returns `this` for chaining.
+     * @since v0.1.0
+     *
+     * @example
+     * ```ts
+     * builder.addPricingTier({
+     *   tierId: "standard",
+     *   pricePerCall: 1000,
+     *   rateLimit: 60,
+     *   tokenType: "sol",
+     *   settlementMode: "x402",
+     * })
+     * ```
+     */
+    addPricingTier(input) {
+        assert(this._pricing.length < LIMITS.MAX_PRICING_TIERS, `Max ${LIMITS.MAX_PRICING_TIERS} pricing tiers`);
+        const tokenType = this.resolveTokenType(input.tokenType ?? "sol");
+        const settlementMode = input.settlementMode
+            ? this.resolveSettlementMode(input.settlementMode)
+            : null;
+        const volumeCurve = input.volumeCurve
+            ? input.volumeCurve.map((v) => ({
+                afterCalls: v.afterCalls,
+                pricePerCall: new BN(v.pricePerCall.toString()),
+            }))
+            : null;
+        this._pricing.push({
+            tierId: input.tierId,
+            pricePerCall: new BN(input.pricePerCall.toString()),
+            minPricePerCall: input.minPricePerCall
+                ? new BN(input.minPricePerCall.toString())
+                : null,
+            maxPricePerCall: input.maxPricePerCall
+                ? new BN(input.maxPricePerCall.toString())
+                : null,
+            rateLimit: input.rateLimit,
+            maxCallsPerSession: input.maxCallsPerSession ?? 0,
+            burstLimit: input.burstLimit ?? null,
+            tokenType,
+            tokenMint: input.tokenMint ?? null,
+            tokenDecimals: input.tokenDecimals ?? null,
+            settlementMode,
+            minEscrowDeposit: input.minEscrowDeposit
+                ? new BN(input.minEscrowDeposit.toString())
+                : null,
+            batchIntervalSec: input.batchIntervalSec ?? null,
+            volumeCurve,
+        });
+        return this;
+    }
+    /**
+     * @name addProtocol
+     * @description Add a protocol the agent supports.
+     * Duplicates are silently ignored.
+     *
+     * @param protocolId - Protocol identifier string (e.g. `"jupiter"`).
+     * @returns `this` for chaining.
+     * @since v0.1.0
+     *
+     * @example
+     * ```ts
+     * builder.addProtocol("jupiter")
+     * ```
+     */
+    addProtocol(protocolId) {
+        assert(this._protocols.length < LIMITS.MAX_PROTOCOLS, `Max ${LIMITS.MAX_PROTOCOLS} protocols`);
+        if (!this._protocols.includes(protocolId)) {
+            this._protocols.push(protocolId);
+        }
+        return this;
+    }
+    /**
+     * @name addTool
+     * @description Add a tool to be published after registration.
+     * Only used with {@link AgentBuilder.registerWithTools}.
+     *
+     * @param tool - Tool configuration.
+     * @returns `this` for chaining.
+     * @since v0.1.0
+     */
+    addTool(tool) {
+        this._tools.push(tool);
+        return this;
+    }
+    // ── Registration ─────────────────────────────────────
+    /**
+     * @name register
+     * @description Register the agent on-chain.
+     * Validates all inputs before sending the transaction.
+     *
+     * @returns A {@link RegisterResult} with the transaction signature and derived PDAs.
+     * @throws If validation fails (missing name, description, or limit exceeded).
+     * @since v0.1.0
+     */
+    async register() {
+        this.validate();
+        const [agentPda] = deriveAgent(this.wallet);
+        const [statsPda] = deriveAgentStats(agentPda);
+        const [globalPda] = deriveGlobalRegistry();
+        const txSignature = await this.methods
+            .registerAgent(this._name, this._description, this._capabilities, this._pricing, this._protocols, this._agentId, this._agentUri, this._x402Endpoint)
+            .accounts({
+            wallet: this.wallet,
+            agent: agentPda,
+            agentStats: statsPda,
+            globalRegistry: globalPda,
+            systemProgram: SystemProgram.programId,
+        })
+            .rpc();
+        return { txSignature, agentPda, statsPda };
+    }
+    /**
+     * @name registerWithTools
+     * @description Register the agent AND publish all configured tools.
+     * Sends agent registration first, then tool publications sequentially.
+     *
+     * @returns A {@link RegisterWithToolsResult} with agent and tool transaction signatures.
+     * @throws If validation fails or any tool publication fails.
+     * @since v0.1.0
+     */
+    async registerWithTools() {
+        const result = await this.register();
+        const toolSignatures = [];
+        const [globalPda] = deriveGlobalRegistry();
+        for (const tool of this._tools) {
+            const toolNameHash = hashToArray(sha256(tool.name));
+            const [toolPda] = deriveTool(result.agentPda, new Uint8Array(toolNameHash));
+            const httpMethod = HTTP_METHOD_VALUES[(tool.httpMethod ?? "post")] ?? 1;
+            const category = TOOL_CATEGORY_VALUES[(tool.category ?? "Custom")] ?? 9;
+            const txSignature = await this.methods
+                .publishTool(tool.name, toolNameHash, hashToArray(sha256(tool.protocol)), hashToArray(sha256(tool.description)), hashToArray(sha256(tool.inputSchema)), hashToArray(sha256(tool.outputSchema)), httpMethod, category, tool.paramsCount, tool.requiredParams, tool.isCompound ?? false)
+                .accounts({
+                wallet: this.wallet,
+                agent: result.agentPda,
+                tool: toolPda,
+                globalRegistry: globalPda,
+                systemProgram: SystemProgram.programId,
+            })
+                .rpc();
+            toolSignatures.push({ name: tool.name, txSignature });
+        }
+        return { ...result, toolSignatures };
+    }
+    // ── Reset ────────────────────────────────────────────
+    /**
+     * @name reset
+     * @description Reset the builder to its initial state.
+     * Clears all configured values so the builder can be reused.
+     *
+     * @returns `this` for chaining.
+     * @since v0.1.0
+     */
+    reset() {
+        this._name = "";
+        this._description = "";
+        this._agentId = null;
+        this._agentUri = null;
+        this._x402Endpoint = null;
+        this._capabilities = [];
+        this._pricing = [];
+        this._protocols = [];
+        this._tools = [];
+        return this;
+    }
+    // ── Validation ───────────────────────────────────────
+    /**
+     * @name validate
+     * @description Validate all builder inputs against on-chain limits.
+     * @throws If any required field is missing or any limit is exceeded.
+     * @private
+     */
+    validate() {
+        assert(this._name.length > 0, "Agent name is required");
+        assert(this._description.length > 0, "Agent description is required");
+        assert(this._capabilities.length <= LIMITS.MAX_CAPABILITIES, `Max ${LIMITS.MAX_CAPABILITIES} capabilities`);
+        assert(this._pricing.length <= LIMITS.MAX_PRICING_TIERS, `Max ${LIMITS.MAX_PRICING_TIERS} pricing tiers`);
+        assert(this._protocols.length <= LIMITS.MAX_PROTOCOLS, `Max ${LIMITS.MAX_PROTOCOLS} protocols`);
+    }
+    // ── Helpers ──────────────────────────────────────────
+    /**
+     * @name resolveTokenType
+     * @description Resolve a token type string to the on-chain enum variant.
+     * @param t - Token type string (`"sol"`, `"usdc"`, or `"spl"`).
+     * @returns The corresponding {@link TokenTypeKind} enum value.
+     * @private
+     */
+    resolveTokenType(t) {
+        switch (t) {
+            case "sol":
+                return TokenType.Sol;
+            case "usdc":
+                return TokenType.Usdc;
+            case "spl":
+                return TokenType.Spl;
+        }
+    }
+    /**
+     * @name resolveSettlementMode
+     * @description Resolve a settlement mode string to the on-chain enum variant.
+     * @param m - Settlement mode string (`"instant"`, `"escrow"`, `"batched"`, or `"x402"`).
+     * @returns The corresponding {@link SettlementModeKind} enum value.
+     * @private
+     */
+    resolveSettlementMode(m) {
+        switch (m) {
+            case "instant":
+                return SettlementMode.Instant;
+            case "escrow":
+                return SettlementMode.Escrow;
+            case "batched":
+                return SettlementMode.Batched;
+            case "x402":
+                return SettlementMode.X402;
+        }
+    }
+    /**
+     * @name methods
+     * @description Accessor for the Anchor program methods namespace.
+     * @returns The program methods object for building RPC calls.
+     * @private
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    get methods() {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+        return this.program.methods;
+    }
+}
+//# sourceMappingURL=builder.js.map

package/dist/esm/registries/builder.js.map

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