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

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

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

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

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

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

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

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

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

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

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

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