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

package/dist/types/utils/schemas.d.ts

@@ -0,0 +1,351 @@
+/**
+ * @module utils/schemas
+ * @description Zod schemas for runtime validation of environment variables,
+ * tool arguments, agent manifests, and x402 payment parameters.
+ *
+ * These schemas enforce correctness at the boundary: CLI scripts refuse
+ * to run if required fields are missing or mis-typed, and SDK methods
+ * validate inputs before hitting the chain.
+ *
+ * Zod is a peer dependency — these schemas are tree-shaken if not imported.
+ *
+ * @category Utils
+ * @since v0.6.0
+ */
+/**
+ * @name createEnvSchema
+ * @description Create a Zod schema for SAP SDK environment variables.
+ * Validates that all required env vars are present and correctly typed.
+ *
+ * @returns A Zod schema object for env validation.
+ *
+ * @category Utils
+ * @since v0.6.0
+ *
+ * @example
+ * ```ts
+ * import { createEnvSchema } from "@synapse-sap/sdk";
+ *
+ * const schema = createEnvSchema();
+ * const env = schema.parse(process.env);
+ * // env.SOLANA_CLUSTER is typed as "mainnet-beta" | "devnet" | "localnet"
+ * ```
+ */
+export declare function createEnvSchema(): import("zod").ZodObject<{
+    SOLANA_CLUSTER: import("zod").ZodDefault<import("zod").ZodEnum<{
+        "mainnet-beta": "mainnet-beta";
+        devnet: "devnet";
+        localnet: "localnet";
+    }>>;
+    SOLANA_RPC_URL: import("zod").ZodOptional<import("zod").ZodString>;
+    SOLANA_FALLBACK_RPC_URL: import("zod").ZodOptional<import("zod").ZodString>;
+    SOLANA_WS_URL: import("zod").ZodOptional<import("zod").ZodString>;
+    WALLET_KEYPAIR_PATH: import("zod").ZodOptional<import("zod").ZodString>;
+    WALLET_PRIVATE_KEY: import("zod").ZodOptional<import("zod").ZodString>;
+    SAP_PROGRAM_ID: import("zod").ZodOptional<import("zod").ZodString>;
+    DATABASE_URL: import("zod").ZodOptional<import("zod").ZodString>;
+    LOG_LEVEL: import("zod").ZodDefault<import("zod").ZodEnum<{
+        error: "error";
+        debug: "debug";
+        info: "info";
+        warn: "warn";
+    }>>;
+    X402_ENDPOINT: import("zod").ZodOptional<import("zod").ZodString>;
+    AGENT_URI: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>;
+/**
+ * @name createEndpointDescriptorSchema
+ * @description Zod schema for {@link EndpointDescriptor}.
+ * @returns A Zod schema for endpoint descriptor validation.
+ * @category Utils
+ * @since v0.6.0
+ */
+export declare function createEndpointDescriptorSchema(): import("zod").ZodObject<{
+    url: import("zod").ZodString;
+    method: import("zod").ZodDefault<import("zod").ZodEnum<{
+        GET: "GET";
+        POST: "POST";
+        PUT: "PUT";
+        DELETE: "DELETE";
+    }>>;
+    contentType: import("zod").ZodDefault<import("zod").ZodString>;
+    requiresAuth: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    authType: import("zod").ZodOptional<import("zod").ZodEnum<{
+        bearer: "bearer";
+        "api-key": "api-key";
+        x402: "x402";
+        none: "none";
+    }>>;
+    requiresCSRF: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    requiresCookies: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    corsOrigins: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    requiredHeaders: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+}, import("zod/v4/core").$strip>;
+/**
+ * @name createHealthCheckSchema
+ * @description Zod schema for {@link HealthCheckDescriptor}.
+ * @returns A Zod schema for health check validation.
+ * @category Utils
+ * @since v0.6.0
+ */
+export declare function createHealthCheckSchema(): import("zod").ZodObject<{
+    url: import("zod").ZodString;
+    expectedStatus: import("zod").ZodDefault<import("zod").ZodNumber>;
+    timeoutMs: import("zod").ZodDefault<import("zod").ZodNumber>;
+    method: import("zod").ZodDefault<import("zod").ZodEnum<{
+        GET: "GET";
+        HEAD: "HEAD";
+    }>>;
+}, import("zod/v4/core").$strip>;
+/**
+ * @name createToolManifestEntrySchema
+ * @description Zod schema for a single tool in an agent manifest.
+ * @returns A Zod schema for tool manifest entry validation.
+ * @category Utils
+ * @since v0.6.0
+ */
+export declare function createToolManifestEntrySchema(): import("zod").ZodObject<{
+    name: import("zod").ZodString;
+    description: import("zod").ZodString;
+    protocol: import("zod").ZodString;
+    category: import("zod").ZodString;
+    inputSchema: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+    outputSchema: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+    httpMethod: import("zod").ZodDefault<import("zod").ZodEnum<{
+        GET: "GET";
+        POST: "POST";
+        PUT: "PUT";
+        DELETE: "DELETE";
+        COMPOUND: "COMPOUND";
+    }>>;
+    paymentMode: import("zod").ZodDefault<import("zod").ZodEnum<{
+        x402: "x402";
+        free: "free";
+        prepaid: "prepaid";
+        subscription: "subscription";
+    }>>;
+    pricePerCall: import("zod").ZodDefault<import("zod").ZodNumber>;
+    requiredArgs: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+    prerequisites: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+    endpointOverride: import("zod").ZodOptional<import("zod").ZodObject<{
+        url: import("zod").ZodString;
+        method: import("zod").ZodDefault<import("zod").ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PUT: "PUT";
+            DELETE: "DELETE";
+        }>>;
+        contentType: import("zod").ZodDefault<import("zod").ZodString>;
+        requiresAuth: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        authType: import("zod").ZodOptional<import("zod").ZodEnum<{
+            bearer: "bearer";
+            "api-key": "api-key";
+            x402: "x402";
+            none: "none";
+        }>>;
+        requiresCSRF: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        requiresCookies: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        corsOrigins: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        requiredHeaders: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>;
+/**
+ * @name createAgentManifestSchema
+ * @description Zod schema for a complete agent manifest.
+ * @returns A Zod schema for manifest validation.
+ * @category Utils
+ * @since v0.6.0
+ *
+ * @example
+ * ```ts
+ * import { createAgentManifestSchema } from "@synapse-sap/sdk";
+ *
+ * const schema = createAgentManifestSchema();
+ * const manifest = schema.parse(JSON.parse(fs.readFileSync("manifest.json", "utf-8")));
+ * ```
+ */
+export declare function createAgentManifestSchema(): import("zod").ZodObject<{
+    version: import("zod").ZodLiteral<"1.0.0">;
+    wallet: import("zod").ZodString;
+    name: import("zod").ZodString;
+    description: import("zod").ZodString;
+    endpoint: import("zod").ZodObject<{
+        url: import("zod").ZodString;
+        method: import("zod").ZodDefault<import("zod").ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PUT: "PUT";
+            DELETE: "DELETE";
+        }>>;
+        contentType: import("zod").ZodDefault<import("zod").ZodString>;
+        requiresAuth: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        authType: import("zod").ZodOptional<import("zod").ZodEnum<{
+            bearer: "bearer";
+            "api-key": "api-key";
+            x402: "x402";
+            none: "none";
+        }>>;
+        requiresCSRF: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        requiresCookies: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        corsOrigins: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        requiredHeaders: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+    }, import("zod/v4/core").$strip>;
+    healthCheck: import("zod").ZodOptional<import("zod").ZodObject<{
+        url: import("zod").ZodString;
+        expectedStatus: import("zod").ZodDefault<import("zod").ZodNumber>;
+        timeoutMs: import("zod").ZodDefault<import("zod").ZodNumber>;
+        method: import("zod").ZodDefault<import("zod").ZodEnum<{
+            GET: "GET";
+            HEAD: "HEAD";
+        }>>;
+    }, import("zod/v4/core").$strip>>;
+    tools: import("zod").ZodArray<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        description: import("zod").ZodString;
+        protocol: import("zod").ZodString;
+        category: import("zod").ZodString;
+        inputSchema: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+        outputSchema: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+        httpMethod: import("zod").ZodDefault<import("zod").ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PUT: "PUT";
+            DELETE: "DELETE";
+            COMPOUND: "COMPOUND";
+        }>>;
+        paymentMode: import("zod").ZodDefault<import("zod").ZodEnum<{
+            x402: "x402";
+            free: "free";
+            prepaid: "prepaid";
+            subscription: "subscription";
+        }>>;
+        pricePerCall: import("zod").ZodDefault<import("zod").ZodNumber>;
+        requiredArgs: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+        prerequisites: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+        endpointOverride: import("zod").ZodOptional<import("zod").ZodObject<{
+            url: import("zod").ZodString;
+            method: import("zod").ZodDefault<import("zod").ZodEnum<{
+                GET: "GET";
+                POST: "POST";
+                PUT: "PUT";
+                DELETE: "DELETE";
+            }>>;
+            contentType: import("zod").ZodDefault<import("zod").ZodString>;
+            requiresAuth: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            authType: import("zod").ZodOptional<import("zod").ZodEnum<{
+                bearer: "bearer";
+                "api-key": "api-key";
+                x402: "x402";
+                none: "none";
+            }>>;
+            requiresCSRF: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            requiresCookies: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            corsOrigins: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            requiredHeaders: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>>;
+    supportedNetworks: import("zod").ZodArray<import("zod").ZodString>;
+    generatedAt: import("zod").ZodString;
+}, import("zod/v4/core").$strip>;
+/**
+ * @name createPreparePaymentSchema
+ * @description Zod schema for x402 payment preparation parameters.
+ * @returns A Zod schema for payment option validation.
+ * @category Utils
+ * @since v0.6.0
+ */
+export declare function createPreparePaymentSchema(): import("zod").ZodObject<{
+    pricePerCall: import("zod").ZodUnion<readonly [import("zod").ZodNumber, import("zod").ZodString, import("zod").ZodBigInt]>;
+    maxCalls: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodNumber, import("zod").ZodString, import("zod").ZodBigInt]>>;
+    deposit: import("zod").ZodUnion<readonly [import("zod").ZodNumber, import("zod").ZodString, import("zod").ZodBigInt]>;
+    expiresAt: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodNumber, import("zod").ZodString, import("zod").ZodBigInt]>>;
+    volumeCurve: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+        afterCalls: import("zod").ZodNumber;
+        pricePerCall: import("zod").ZodUnion<readonly [import("zod").ZodNumber, import("zod").ZodString, import("zod").ZodBigInt]>;
+    }, import("zod/v4/core").$strip>>>;
+    tokenMint: import("zod").ZodOptional<import("zod").ZodString>;
+    tokenDecimals: import("zod").ZodDefault<import("zod").ZodNumber>;
+    networkIdentifier: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>;
+/**
+ * @name createRegisterAgentSchema
+ * @description Zod schema for agent registration arguments.
+ * @returns A Zod schema for registration validation.
+ * @category Utils
+ * @since v0.6.0
+ */
+export declare function createRegisterAgentSchema(): import("zod").ZodObject<{
+    name: import("zod").ZodString;
+    description: import("zod").ZodString;
+    agentId: import("zod").ZodNullable<import("zod").ZodOptional<import("zod").ZodString>>;
+    agentUri: import("zod").ZodNullable<import("zod").ZodOptional<import("zod").ZodString>>;
+    x402Endpoint: import("zod").ZodNullable<import("zod").ZodOptional<import("zod").ZodString>>;
+    capabilities: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        description: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        protocolId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        version: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    }, import("zod/v4/core").$strip>>>;
+    protocols: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+    pricing: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
+        tierId: import("zod").ZodString;
+        pricePerCall: import("zod").ZodUnion<readonly [import("zod").ZodNumber, import("zod").ZodString]>;
+        rateLimit: import("zod").ZodNumber;
+        tokenType: import("zod").ZodDefault<import("zod").ZodEnum<{
+            sol: "sol";
+            usdc: "usdc";
+            spl: "spl";
+        }>>;
+        settlementMode: import("zod").ZodDefault<import("zod").ZodEnum<{
+            x402: "x402";
+            instant: "instant";
+            escrow: "escrow";
+            batched: "batched";
+        }>>;
+    }, import("zod/v4/core").$strip>>>;
+}, import("zod/v4/core").$strip>;
+/**
+ * @name createCallArgsSchema
+ * @description Zod schema for `npm run call` script arguments.
+ * Ensures all required fields are present before executing an x402 call.
+ *
+ * @returns A Zod schema for call argument validation.
+ * @category Utils
+ * @since v0.6.0
+ */
+export declare function createCallArgsSchema(): import("zod").ZodObject<{
+    agentWallet: import("zod").ZodString;
+    tool: import("zod").ZodString;
+    args: import("zod").ZodDefault<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+    endpoint: import("zod").ZodOptional<import("zod").ZodString>;
+    network: import("zod").ZodOptional<import("zod").ZodString>;
+    maxRetries: import("zod").ZodDefault<import("zod").ZodNumber>;
+    timeoutMs: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>;
+/**
+ * @name validateOrThrow
+ * @description Validate a value against a Zod schema, throwing a SapValidationError
+ * with a friendly message if validation fails.
+ *
+ * @param schema - A Zod schema.
+ * @param value - The value to validate.
+ * @param label - A label for error messages (e.g. "environment", "call args").
+ * @returns The parsed and typed value.
+ * @throws {Error} With formatted validation errors.
+ *
+ * @category Utils
+ * @since v0.6.0
+ */
+export declare function validateOrThrow<T>(schema: {
+    parse: (v: unknown) => T;
+    safeParse: (v: unknown) => {
+        success: boolean;
+        error?: {
+            issues: Array<{
+                path: Array<string | number>;
+                message: string;
+            }>;
+        };
+    };
+}, value: unknown, label: string): T;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/types/utils/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/utils/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA2BH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe;;;;;;;;;;;;;;;;;;;;;iCAsD9B;AAMD;;;;;;GAMG;AACH,wBAAgB,8BAA8B;;;;;;;;;;;;;;;;;;;;iCAc7C;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB;;;;;;;;iCAStC;AAMD;;;;;;GAMG;AACH,wBAAgB,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAiB5C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAcxC;AAMD;;;;;;GAMG;AACH,wBAAgB,0BAA0B;;;;;;;;;;;;iCAoBzC;AAMD;;;;;;GAMG;AACH,wBAAgB,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAkCxC;AAMD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB;;;;;;;;iCAYnC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,MAAM,EAAE;IAAE,KAAK,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC;IAAC,SAAS,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,MAAM,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAA;KAAE,CAAA;CAAE,EACnK,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,CAAC,CAYH"}

package/dist/types/utils/serialization.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @module utils/serialization
+ * @description JSON-safe serialization helpers for on-chain account data.
+ *
+ * On-chain Anchor account objects contain `PublicKey` and `BN` instances
+ * that are not JSON-serializable. These helpers convert them to plain
+ * strings (`base58` and decimal `string`) recursively.
+ *
+ * @category Utils
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { serializeAccount } from "@synapse-sap/sdk/utils";
+ *
+ * const raw = await program.account.agent.fetch(pda);
+ * const json = serializeAccount(raw);
+ * // { authority: "GBL...", totalCalls: "42", ... }
+ * ```
+ */
+/**
+ * Recursively convert a single value for JSON serialization.
+ *
+ * - `PublicKey` → base58 string
+ * - `BN` → decimal string
+ * - `Uint8Array` / `Buffer` → hex string
+ * - `Array` → recursed
+ * - plain `object` → recursed via {@link serializeAccount}
+ * - primitives → identity
+ *
+ * @name serializeValue
+ * @description Transforms a single Anchor-typed value into its JSON-safe equivalent.
+ * @param value - The value to serialize.
+ * @returns The JSON-safe representation of `value`.
+ * @category Utils
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { serializeValue } from "@synapse-sap/sdk/utils";
+ *
+ * serializeValue(new PublicKey("11111111111111111111111111111111")); // "1111..."
+ * serializeValue(new BN(42)); // "42"
+ * ```
+ */
+export declare function serializeValue(value: unknown): any;
+/**
+ * Serialize an entire on-chain account object to a JSON-safe shape.
+ *
+ * Iterates over each key and delegates to {@link serializeValue}.
+ * Handles `PublicKey` → base58, `BN` → string, and nested
+ * objects / arrays recursively.
+ *
+ * @name serializeAccount
+ * @description Converts all non-primitive fields in an Anchor account record to JSON-safe strings.
+ * @param obj - The raw account object returned by `program.account.<name>.fetch()`.
+ * @returns A new plain object with all values converted.
+ * @category Utils
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { serializeAccount } from "@synapse-sap/sdk/utils";
+ *
+ * const raw = await program.account.agent.fetch(pda);
+ * const safe = serializeAccount(raw);
+ * console.log(JSON.stringify(safe));
+ * ```
+ */
+export declare function serializeAccount(obj: Record<string, any>): Record<string, any>;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/types/utils/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../../src/utils/serialization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAYlD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,wBAAgB,gBAAgB,CAE9B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAEvB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAOrB"}

package/dist/types/utils/validation.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @module utils/validation
+ * @description Runtime assertion helpers.
+ *
+ * @category Utils
+ * @since v0.1.0
+ */
+/**
+ * Assert that a condition holds, throwing a descriptive error otherwise.
+ *
+ * Uses TypeScript’s `asserts condition` return type so the compiler
+ * narrows the guarded value after the call.
+ *
+ * @name assert
+ * @description Runtime guard — throws `RangeError` with a `[SAP SDK]` prefix when the condition is falsy.
+ * @param condition - The boolean expression to verify.
+ * @param message   - Human-readable message included in the thrown error.
+ * @throws {RangeError} When `condition` is `false`.
+ * @category Utils
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { assert } from "@synapse-sap/sdk/utils";
+ *
+ * assert(name.length <= 64, "Agent name exceeds MAX_NAME_LEN");
+ * ```
+ */
+export declare function assert(condition: boolean, message: string): asserts condition;
+//# sourceMappingURL=validation.d.ts.map

package/dist/types/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CACpB,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAInB"}

package/dist/types/utils/volume-curve.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @module volume-curve
+ * @description Client-side mirror of the on-chain `calculate_settle_amount`
+ * function from `programs/synapse-agent-sap/src/instructions/escrow_v2.rs`.
+ *
+ * Used by {@link EscrowV2Module.settle} to pre-compute the settlement
+ * `amount` so it can chain `createPendingSettlement` in the same transaction
+ * as `settleCallsV2` (DisputeWindow flow). Keeping the math in one place
+ * here ensures the SDK stays byte-for-byte aligned with the program; if the
+ * on-chain curve algorithm ever changes, this file is the single source of
+ * truth on the client.
+ *
+ * @category Utilities
+ * @since v0.13.0
+ * @packageDocumentation
+ */
+import { BN } from "@coral-xyz/anchor";
+import type { VolumeCurveBreakpoint } from "../types/common";
+/**
+ * @function calculateSettleAmount
+ * @description Compute the lamport (or token base-unit) amount the on-chain
+ * `settle_calls_v2` handler will charge for `calls` calls, given the escrow's
+ * `pricePerCall`, `volumeCurve`, and the current settled+pending counter.
+ *
+ * Mirrors the exact algorithm of `calculate_settle_amount` in
+ * `escrow_v2.rs` (v0.7+):
+ *
+ * ```rust
+ * if curve.is_empty() { calls * base_price } else { walk-the-curve }
+ * ```
+ *
+ * Walks the curve from `cursor = totalCallsBefore` and at each cursor
+ * position picks the breakpoint price whose `afterCalls` threshold the
+ * cursor has passed. Calls are charged at the active price up to the next
+ * threshold, then the cursor advances and the loop repeats until all
+ * `calls` are accounted for.
+ *
+ * @param basePrice - Escrow's `pricePerCall` (BN, u64 lamports/base-units).
+ * @param curve - The escrow's `volumeCurve` array (may be empty).
+ * @param totalCallsBefore - `escrow.totalCallsSettled + escrow.pendingCalls`
+ *   AT THE MOMENT `settleCallsV2` runs on-chain.
+ * @param calls - Number of calls being settled in this batch.
+ * @returns The amount the on-chain handler will compute (BN, u64).
+ *
+ * @example
+ * ```ts
+ * import { calculateSettleAmount } from "@oobe-protocol-labs/synapse-sap-sdk";
+ *
+ * const amount = calculateSettleAmount(
+ *   escrow.pricePerCall,
+ *   escrow.volumeCurve,
+ *   escrow.totalCallsSettled.add(escrow.pendingCalls),
+ *   new BN(5),
+ * );
+ * ```
+ *
+ * @since v0.13.0
+ */
+export declare function calculateSettleAmount(basePrice: BN, curve: VolumeCurveBreakpoint[], totalCallsBefore: BN, calls: BN): BN;
+//# sourceMappingURL=volume-curve.d.ts.map

package/dist/types/utils/volume-curve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"volume-curve.d.ts","sourceRoot":"","sources":["../../../src/utils/volume-curve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AACvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAwB7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,EAAE,EACb,KAAK,EAAE,qBAAqB,EAAE,EAC9B,gBAAgB,EAAE,EAAE,EACpB,KAAK,EAAE,EAAE,GACR,EAAE,CA2CJ"}

package/dist/types/utils/x402-direct.d.ts

@@ -0,0 +1,114 @@
+/**
+ * @module utils/x402-direct
+ * @description Recognize x402 direct SPL token payments on an agent's ATA
+ * by scanning transaction history and filtering for x402 patterns.
+ *
+ * @category Utils
+ * @since v0.6.4
+ */
+import { type Connection, PublicKey } from "@solana/web3.js";
+/**
+ * @interface SettlementPayload
+ * @description Settlement metadata from the merchant's PAYMENT-RESPONSE.
+ * @category Utils
+ * @since v0.6.4
+ */
+export interface SettlementPayload {
+    /** SHA-256 service hash. */
+    readonly serviceHash: string;
+    /** Resource identifier. */
+    readonly resource: string;
+    /** Agent wallet (base58). */
+    readonly agentWallet: string;
+    /** Depositor wallet (base58). */
+    readonly depositorWallet: string;
+    /** Amount in smallest unit. */
+    readonly amount: string;
+    /** Service timestamp. */
+    readonly timestamp: number;
+}
+/**
+ * @interface X402DirectPayment
+ * @description A recognized x402 direct SPL transfer on an agent's ATA.
+ * @category Utils
+ * @since v0.6.4
+ */
+export interface X402DirectPayment {
+    /** Transaction signature. */
+    readonly signature: string;
+    /** Transfer amount (in smallest token unit). */
+    readonly amount: bigint;
+    /** Source ATA (payer). */
+    readonly payerAta: PublicKey;
+    /** Destination ATA (payTo / agent). */
+    readonly payeeAta: PublicKey;
+    /** Token mint used for transfer. */
+    readonly mint: PublicKey;
+    /** Memo data (if a Memo instruction was included). */
+    readonly memo: string | null;
+    /** Matched settlement payload (if server-side verification is available). */
+    readonly settlement: SettlementPayload | null;
+    /** Block time (unix seconds). */
+    readonly blockTime: number | null;
+    /** Slot number. */
+    readonly slot: number;
+}
+/**
+ * @interface GetX402DirectOptions
+ * @description Options for {@link getX402DirectPayments}.
+ * @category Utils
+ * @since v0.6.4
+ */
+export interface GetX402DirectOptions {
+    /** Max signatures to scan (default: 100). */
+    readonly limit?: number;
+    /** Only return transfers from this specific payer. */
+    readonly filterPayer?: PublicKey;
+    /** Known settlements from server-side PAYMENT-RESPONSE logs.
+     *  Used for deterministic hash matching. */
+    readonly knownSettlements?: SettlementPayload[];
+    /** Only include payments that match x402 memo prefix. Default: false. */
+    readonly requireMemo?: boolean;
+    /** Scan before this TX signature (pagination). */
+    readonly before?: string;
+    /** Scan after this TX signature (pagination). */
+    readonly until?: string;
+}
+/**
+ * @name getX402DirectPayments
+ * @description Scan an agent's ATA for x402 direct payments.
+ *
+ * Fetches recent transaction signatures for the given `payTo` ATA,
+ * inspects each transaction for SPL token transfers, and filters
+ * for x402 payment patterns (memo prefix, settlement hash match, etc.).
+ *
+ * @param connection - Solana RPC connection.
+ * @param payToAta   - The agent's receiving ATA (e.g. USDC ATA of Syra).
+ * @param opts       - Filter and pagination options.
+ * @returns Array of recognized x402 direct payments, newest first.
+ *
+ * @category Utils
+ * @since v0.6.4
+ *
+ * @example
+ * ```ts
+ * import { getX402DirectPayments, findATA } from "@oobe-protocol-labs/synapse-sap-sdk";
+ *
+ * const USDC_MINT = new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
+ * const payToAta = findATA(agentWallet, USDC_MINT);
+ *
+ * const payments = await getX402DirectPayments(connection, payToAta, {
+ *   limit: 50,
+ *   knownSettlements: savedSettlements, // from your API PAYMENT-RESPONSE logs
+ * });
+ *
+ * for (const p of payments) {
+ *   console.log(`${p.signature}: ${p.amount} from ${p.payerAta.toBase58()}`);
+ *   if (p.settlement) {
+ *     console.log(`  Matched settlement: ${p.settlement.serviceHash}`);
+ *   }
+ * }
+ * ```
+ */
+export declare function getX402DirectPayments(connection: Connection, payToAta: PublicKey, opts?: GetX402DirectOptions): Promise<X402DirectPayment[]>;
+//# sourceMappingURL=x402-direct.d.ts.map

package/dist/types/utils/x402-direct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402-direct.d.ts","sourceRoot":"","sources":["../../../src/utils/x402-direct.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,KAAK,UAAU,EACf,SAAS,EAGV,MAAM,iBAAiB,CAAC;AAOzB;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6BAA6B;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,iCAAiC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yBAAyB;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC9C,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC;IACjC;gDAC4C;IAC5C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAChD,yEAAyE;IACzE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AA6KD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,SAAS,EACnB,IAAI,CAAC,EAAE,oBAAoB,GAC1B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAmE9B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oobe-protocol-labs/synapse-sap-sdk",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "TypeScript SDK for Synapse SAP Protocol — x402 agentic escrow, dispute, staking, subscription & vault layers on Solana",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -49,7 +49,7 @@
   },
   "sideEffects": false,
   "scripts": {
-    "build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json",
+    "build": "tsc -p tsconfig.esm.json && tsc -p tsconfig.cjs.json",
     "clean": "rm -rf dist",
     "test": "vitest",
     "lint": "eslint src --ext .ts",