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

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

@@ -1,145 +0,0 @@
-/**
- * @module utils/escrow-validation
- * @description Server-side escrow validation pipeline.
- *
- * Provides typed helpers to validate escrow state before settlement
- * and to build the correct SPL `AccountMeta[]` for token escrows.
- *
- * @category Utils
- * @since v0.6.4
- */
-import { PublicKey, type Connection, type AccountMeta } from "@solana/web3.js";
-import { SapError } from "../errors";
-import type { EscrowAccountData } from "../types";
-/**
- * @interface SplAccountMeta
- * @description Typed SPL account metadata for escrow operations.
- * @category Utils
- * @since v0.6.4
- */
-export interface SplAccountMeta {
-    /** Account role in the escrow pipeline. */
-    readonly kind: "escrowAta" | "depositorAta" | "tokenMint" | "tokenProgram";
-    /** Account public key. */
-    readonly pubkey: PublicKey;
-    /** Whether this account is writable. */
-    readonly writable: boolean;
-}
-/**
- * @interface EscrowValidationResult
- * @description Result of server-side escrow state validation.
- * @category Utils
- * @since v0.6.4
- */
-export interface EscrowValidationResult {
-    /** Whether the escrow is valid for settlement. */
-    readonly valid: boolean;
-    /** Escrow account data (if found). */
-    readonly escrow: EscrowAccountData | null;
-    /** Escrow PDA address. */
-    readonly escrowPda: PublicKey;
-    /** Agent PDA address. */
-    readonly agentPda: PublicKey;
-    /** Whether this is an SPL token escrow (vs SOL). */
-    readonly isSplEscrow: boolean;
-    /** Generated SPL account metas (empty for SOL escrows). */
-    readonly splAccounts: SplAccountMeta[];
-    /** Validation errors (empty when valid). */
-    readonly errors: string[];
-}
-/**
- * @name MissingEscrowAtaError
- * @description Thrown when an SPL escrow operation is missing required
- * Associated Token Accounts.
- * @category Errors
- * @since v0.6.4
- */
-export declare class MissingEscrowAtaError extends SapError {
-    /** The ATA address that is missing. */
-    readonly ataAddress: string;
-    /** Which side is missing: depositor or escrow. */
-    readonly side: "depositor" | "escrow";
-    constructor(ataAddress: string, side: "depositor" | "escrow");
-}
-/**
- * @name validateEscrowState
- * @description Validates that an escrow is in a correct state for settlement.
- *
- * Checks:
- * - Escrow PDA exists on-chain
- * - If SPL: depositor ATA exists, escrow ATA exists, token mint matches
- * - Balance >= requested settlement amount
- * - Escrow is not expired
- * - Max calls not exceeded
- *
- * @param connection  - Solana RPC connection.
- * @param agentWallet - The agent's wallet public key.
- * @param depositorWallet - The depositor's wallet public key.
- * @param fetchEscrow - Callback to fetch escrow data (avoids coupling to SapProgram).
- * @param opts
- * @param opts.callsToSettle - Number of calls to validate affordability for.
- *
- * @returns A detailed {@link EscrowValidationResult}.
- *
- * @category Utils
- * @since v0.6.4
- *
- * @example
- * ```ts
- * const result = await validateEscrowState(
- *   connection,
- *   agentWallet,
- *   depositorWallet,
- *   (pda) => client.escrow.fetchByPda(pda),
- *   { callsToSettle: 5 },
- * );
- *
- * if (!result.valid) {
- *   console.error("Escrow validation failed:", result.errors);
- * }
- * ```
- */
-export declare function validateEscrowState(connection: Connection, agentWallet: PublicKey, depositorWallet: PublicKey, fetchEscrow: (escrowPda: PublicKey) => Promise<EscrowAccountData | null>, opts?: {
-    callsToSettle?: number;
-}): Promise<EscrowValidationResult>;
-/**
- * @name attachSplAccounts
- * @description Build the typed `SplAccountMeta[]` for an SPL token escrow operation.
- * Does NOT validate existence — use {@link validateEscrowState} for full validation.
- *
- * @param escrowPda      - The escrow PDA address.
- * @param depositorWallet - The depositor's wallet public key.
- * @param tokenMint      - The SPL token mint.
- * @returns An array of typed {@link SplAccountMeta} for SPL escrow operations.
- *
- * @category Utils
- * @since v0.6.4
- *
- * @example
- * ```ts
- * const splMetas = attachSplAccounts(escrowPda, depositorWallet, usdcMint);
- *
- * // Convert to Anchor-compatible AccountMeta[]
- * const accountMetas = splMetas.map(m => ({
- *   pubkey: m.pubkey,
- *   isWritable: m.writable,
- *   isSigner: false,
- * }));
- *
- * await client.escrow.settle(depositor, calls, hash, accountMetas);
- * ```
- */
-export declare function attachSplAccounts(escrowPda: PublicKey, depositorWallet: PublicKey, tokenMint: PublicKey): SplAccountMeta[];
-/**
- * @name toAccountMetas
- * @description Convert typed {@link SplAccountMeta} to Anchor-compatible
- * `AccountMeta[]` for use with `.remainingAccounts()`.
- *
- * @param splMetas - Array of typed SPL account metas.
- * @returns `AccountMeta[]` compatible with Anchor's `remainingAccounts`.
- *
- * @category Utils
- * @since v0.6.4
- */
-export declare function toAccountMetas(splMetas: SplAccountMeta[]): AccountMeta[];
-//# sourceMappingURL=escrow-validation.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"escrow-validation.d.ts","sourceRoot":"","sources":["../../../src/utils/escrow-validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,SAAS,EACT,KAAK,UAAU,EACf,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAMlD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,GAAG,WAAW,GAAG,cAAc,CAAC;IAC3E,0BAA0B;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,sCAAsC;IACtC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC1C,0BAA0B;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,yBAAyB;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,cAAc,EAAE,CAAC;IACvC,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;CAC3B;AAMD;;;;;;GAMG;AACH,qBAAa,qBAAsB,SAAQ,QAAQ;IACjD,uCAAuC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,QAAQ,CAAC;gBAE1B,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,QAAQ;CAW7D;AASD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,SAAS,EACtB,eAAe,EAAE,SAAS,EAC1B,WAAW,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,EACxE,IAAI,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC,OAAO,CAAC,sBAAsB,CAAC,CAgGjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,SAAS,EAC1B,SAAS,EAAE,SAAS,GACnB,cAAc,EAAE,CAOlB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,WAAW,EAAE,CAMxE"}

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

@@ -1,75 +0,0 @@
-/**
- * @module utils/hash
- * @description Cryptographic hashing utilities.
- *
- * @category Utils
- * @since v0.1.0
- */
-/**
- * Compute the SHA-256 hash of a UTF-8 string or byte buffer.
- *
- * Returns a 32-byte `Uint8Array` suitable for PDA seeds
- * and Anchor instruction arguments.
- *
- * @name sha256
- * @description Hashes the input using Node’s `crypto.createHash("sha256")`.
- * @param input - A UTF-8 string, `Buffer`, or `Uint8Array` to hash.
- * @returns {Uint8Array} 32-byte SHA-256 digest.
- * @category Utils
- * @since v0.1.0
- * @example
- * ```ts
- * import { sha256 } from "@synapse-sap/sdk/utils";
- *
- * const hash = sha256("jupiter:swap"); // Uint8Array (32 bytes)
- * ```
- */
-export declare const sha256: (input: string | Buffer | Uint8Array) => Uint8Array;
-/**
- * Convert a `Uint8Array` hash to a plain `number[]`.
- *
- * Anchor instruction argument types expect `number[]` for hash fields
- * rather than typed arrays.
- *
- * @name hashToArray
- * @description Converts a byte array (typically 32 bytes) to a plain JavaScript `number[]`.
- * @param hash - The byte array to convert.
- * @returns {number[]} Shallow copy as a plain array of numbers.
- * @category Utils
- * @since v0.1.0
- * @example
- * ```ts
- * import { sha256, hashToArray } from "@synapse-sap/sdk/utils";
- *
- * const arr = hashToArray(sha256("jupiter:swap")); // number[]
- * ```
- */
-export declare const hashToArray: (hash: Uint8Array) => number[];
-/**
- * Compute the deterministic batch root used by `settle_batch` (v0.10.0).
- *
- * The on-chain program enforces:
- *   `batch_root == sha256(s_0 || s_1 || ... || s_{N-1})`
- * where each `s_i` is a 32-byte service hash, in the same order as the
- * `settlements: Settlement[]` array passed to the instruction.
- *
- * Use this helper to derive the seed for the {@link deriveSettlementReceipt}
- * PDA when batching settlements.
- *
- * @name computeBatchRoot
- * @param serviceHashes - Array of 32-byte service hashes (Buffer/Uint8Array/number[]).
- * @returns {Uint8Array} 32-byte batch root.
- * @throws If any `serviceHashes[i]` is not exactly 32 bytes long.
- * @category Utils
- * @since v0.10.0
- *
- * @example
- * ```ts
- * import { computeBatchRoot, hashToArray } from "@synapse-sap/sdk/utils";
- *
- * const root = computeBatchRoot([h1, h2, h3]);
- * await client.escrow.settleBatch(depositor, settlements, root);
- * ```
- */
-export declare const computeBatchRoot: (serviceHashes: ReadonlyArray<Uint8Array | Buffer | number[]>) => Uint8Array;
-//# sourceMappingURL=hash.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../src/utils/hash.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,GAAG,MAAM,GAAG,UAAU,KAAG,UAM5D,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,UAAU,KAAG,MAAM,EAAsB,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,gBAAgB,GAC3B,eAAe,aAAa,CAAC,UAAU,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,KAC3D,UAyBF,CAAC"}

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

@@ -1,36 +0,0 @@
-/**
- * @module utils
- * @description Shared utilities used across SDK modules.
- *
- * @category Utils
- * @since v0.1.0
- *
- * @example
- * ```ts
- * import { sha256, hashToArray, assert } from "@synapse-sap/sdk/utils";
- *
- * const hash = sha256("jupiter:swap");
- * const arr  = hashToArray(hash);      // number[] for Anchor args
- * ```
- */
-export { sha256, hashToArray, computeBatchRoot } from "./hash";
-export { assert } from "./validation";
-export { serializeAccount, serializeValue } from "./serialization";
-export { normalizeNetworkId, isNetworkEquivalent, getNetworkGenesisHash, getNetworkClusterName, isKnownNetwork, } from "./network-normalizer";
-export { validateEndpoint, validateEndpointDescriptor, validateHealthCheck, validateAgentEndpoints, } from "./endpoint-validator";
-export type { ValidateEndpointOptions } from "./endpoint-validator";
-export { getRpcUrl, getFallbackRpcUrl, createDualConnection, findATA, classifyAnchorError, extractAnchorErrorCode, } from "./rpc-strategy";
-export type { RpcConfig, DualConnection, AtaResult } from "./rpc-strategy";
-export { createEnvSchema, createEndpointDescriptorSchema, createHealthCheckSchema, createToolManifestEntrySchema, createAgentManifestSchema, createPreparePaymentSchema, createRegisterAgentSchema, createCallArgsSchema, validateOrThrow, } from "./schemas";
-export { buildPriorityFeeIxs, buildRpcOptions, FAST_SETTLE_OPTIONS, FAST_BATCH_SETTLE_OPTIONS, DEFAULT_SETTLE_PRIORITY_FEE, DEFAULT_SETTLE_COMPUTE_UNITS, DEFAULT_BATCH_SETTLE_COMPUTE_UNITS, computeBatchSettleCu, } from "./priority-fee";
-export type { PriorityFeeConfig, SettleOptions, } from "./priority-fee";
-export { validateEscrowState, attachSplAccounts, toAccountMetas, MissingEscrowAtaError, } from "./escrow-validation";
-export type { SplAccountMeta, EscrowValidationResult, } from "./escrow-validation";
-export { SapMerchantValidator, parseX402Headers, } from "./merchant-validator";
-export type { ParsedX402Headers, MerchantValidationResult, } from "./merchant-validator";
-export { getX402DirectPayments } from "./x402-direct";
-export type { X402DirectPayment, SettlementPayload, GetX402DirectOptions, } from "./x402-direct";
-export { SAP_ERRORS, SAP_ERROR_BY_NAME, decodeAnchorError, SapPreflightError, throwPredicted, } from "./anchor-errors";
-export type { SapErrorEntry, DecodedAnchorError, } from "./anchor-errors";
-export { calculateSettleAmount } from "./volume-curve";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGnE,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEpE,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,oBAAoB,EACpB,OAAO,EACP,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3E,OAAO,EACL,eAAe,EACf,8BAA8B,EAC9B,uBAAuB,EACvB,6BAA6B,EAC7B,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EACzB,oBAAoB,EACpB,eAAe,GAChB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,2BAA2B,EAC3B,4BAA4B,EAC5B,kCAAkC,EAClC,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,iBAAiB,EACjB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,cAAc,EACd,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,aAAa,EACb,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/types/utils/merchant-validator.d.ts

@@ -1,176 +0,0 @@
-/**
- * @module utils/merchant-validator
- * @description Standard Synapse merchant middleware for x402 settlement.
- *
- * Reads `X-Payment-*` headers from incoming HTTP requests, validates
- * the escrow on-chain, auto-generates the correct `AccountMeta[]`,
- * and throws explicit errors (e.g. {@link MissingEscrowAtaError})
- * instead of letting the program return a generic crash.
- *
- * Designed for agents like Syra/Invoica that receive x402 payments.
- *
- * @category Utils
- * @since v0.6.4
- */
-import { type PublicKey, type Connection, type AccountMeta } from "@solana/web3.js";
-import { BN } from "@coral-xyz/anchor";
-import type { EscrowValidationResult } from "./escrow-validation";
-import type { EscrowAccountData } from "../types";
-/**
- * @interface ParsedX402Headers
- * @description Parsed and typed x402 payment headers from incoming HTTP request.
- * @category Utils
- * @since v0.6.4
- */
-export interface ParsedX402Headers {
-    /** x402 protocol identifier — must be "SAP-x402". */
-    readonly protocol: string;
-    /** Escrow PDA address. */
-    readonly escrowPda: PublicKey;
-    /** Agent PDA address. */
-    readonly agentPda: PublicKey;
-    /** Depositor wallet address. */
-    readonly depositorWallet: PublicKey;
-    /** Max calls allowed. */
-    readonly maxCalls: BN;
-    /** Price per call. */
-    readonly pricePerCall: BN;
-    /** SAP program ID. */
-    readonly programId: PublicKey;
-    /** Network identifier. */
-    readonly network: string;
-}
-/**
- * @interface MerchantValidationResult
- * @description Complete validation result for merchant-side x402 processing.
- * @category Utils
- * @since v0.6.4
- */
-export interface MerchantValidationResult {
-    /** Whether the escrow is valid and ready for settlement. */
-    readonly valid: boolean;
-    /** Parsed x402 headers. */
-    readonly headers: ParsedX402Headers;
-    /** Full escrow validation result. */
-    readonly escrowValidation: EscrowValidationResult;
-    /** Pre-built AccountMeta[] for settlement TX (empty for SOL escrows). */
-    readonly accountMetas: AccountMeta[];
-    /** All validation errors. */
-    readonly errors: string[];
-}
-/**
- * @name parseX402Headers
- * @description Parse and validate x402 headers from an HTTP request.
- *
- * @param headers - HTTP headers object (case-insensitive key lookup).
- * @returns Parsed x402 headers.
- * @throws {SapValidationError} If required headers are missing or malformed.
- *
- * @category Utils
- * @since v0.6.4
- */
-export declare function parseX402Headers(headers: Record<string, string | string[] | undefined>): ParsedX402Headers;
-/**
- * @name SapMerchantValidator
- * @description Standard Synapse merchant middleware for x402 payment validation.
- *
- * Reads `X-Payment-*` headers, validates escrow state on-chain, generates
- * correct `AccountMeta[]` for SPL token escrows, and throws explicit errors
- * (e.g. {@link MissingEscrowAtaError}) when ATA accounts are missing.
- *
- * @category Utils
- * @since v0.6.4
- *
- * @example
- * ```ts
- * const validator = new SapMerchantValidator(connection, fetchEscrow);
- *
- * // Express.js integration
- * app.post("/api/v1/chat", async (req, res) => {
- *   try {
- *     const validation = await validator.validateRequest(req.headers, {
- *       callsToSettle: 1,
- *     });
- *
- *     if (!validation.valid) {
- *       return res.status(402).json({ errors: validation.errors });
- *     }
- *
- *     // Process request...
- *
- *     // Settle payment using pre-built account metas
- *     await client.escrow.settle(
- *       validation.headers.depositorWallet,
- *       1,
- *       serviceHash,
- *       validation.accountMetas,
- *     );
- *
- *     res.json({ result: "..." });
- *   } catch (err) {
- *     if (err instanceof MissingEscrowAtaError) {
- *       return res.status(402).json({
- *         error: err.message,
- *         side: err.side,
- *         ata: err.ataAddress,
- *       });
- *     }
- *     throw err;
- *   }
- * });
- * ```
- */
-export declare class SapMerchantValidator {
-    private readonly connection;
-    private readonly fetchEscrow;
-    /**
-     * @param connection  - Solana RPC connection.
-     * @param fetchEscrow - Callback to fetch escrow account data by PDA.
-     *   Typically `(pda) => client.escrow.fetchByPda(pda).catch(() => null)`.
-     */
-    constructor(connection: Connection, fetchEscrow: (escrowPda: PublicKey) => Promise<EscrowAccountData | null>);
-    /**
-     * @name validateRequest
-     * @description Full validation pipeline for an incoming x402 request.
-     *
-     * Steps:
-     * 1. Parse `X-Payment-*` headers
-     * 2. Fetch escrow on-chain
-     * 3. Validate escrow state (balance, expiry, max calls)
-     * 4. If SPL escrow: validate ATAs exist and mint matches
-     * 5. Build `AccountMeta[]` for settlement TX
-     *
-     * @param headers - HTTP headers from the incoming request.
-     * @param opts
-     * @param opts.callsToSettle     - Number of calls to validate affordability for (default: 1).
-     * @param opts.throwOnMissingAta - Throw {@link MissingEscrowAtaError} instead of returning errors (default: true).
-     *
-     * @returns A complete {@link MerchantValidationResult}.
-     *
-     * @throws {SapValidationError} If headers are missing or malformed.
-     * @throws {MissingEscrowAtaError} If SPL ATAs are missing and `throwOnMissingAta` is true.
-     *
-     * @category Utils
-     * @since v0.6.4
-     */
-    validateRequest(headers: Record<string, string | string[] | undefined>, opts?: {
-        callsToSettle?: number;
-        throwOnMissingAta?: boolean;
-    }): Promise<MerchantValidationResult>;
-    /**
-     * @name validateEscrow
-     * @description Validate escrow from pre-parsed headers (convenience method).
-     * Call this when you've already parsed the headers yourself.
-     *
-     * @param headers - Pre-parsed x402 headers.
-     * @param opts
-     * @returns The escrow validation result with pre-built account metas.
-     *
-     * @category Utils
-     * @since v0.6.4
-     */
-    validateEscrow(headers: ParsedX402Headers, opts?: {
-        callsToSettle?: number;
-    }): Promise<EscrowValidationResult>;
-}
-//# sourceMappingURL=merchant-validator.d.ts.map

package/dist/types/utils/merchant-validator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"merchant-validator.d.ts","sourceRoot":"","sources":["../../../src/utils/merchant-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAMvC,OAAO,KAAK,EACV,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAMlD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,0BAA0B;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,yBAAyB;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,gCAAgC;IAChC,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC;IACpC,yBAAyB;IACzB,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC;IACtB,sBAAsB;IACtB,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC;IAC1B,sBAAsB;IACtB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,0BAA0B;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,2BAA2B;IAC3B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,qCAAqC;IACrC,QAAQ,CAAC,gBAAgB,EAAE,sBAAsB,CAAC;IAClD,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,WAAW,EAAE,CAAC;IACrC,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;CAC3B;AAkBD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,iBAAiB,CA6EnB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAEW;IAEvC;;;;OAIG;gBAED,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,CACX,SAAS,EAAE,SAAS,KACjB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAMxC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,eAAe,CACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,EACtD,IAAI,CAAC,EAAE;QACL,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC7B,GACA,OAAO,CAAC,wBAAwB,CAAC;IAwCpC;;;;;;;;;;;OAWG;IACG,cAAc,CAClB,OAAO,EAAE,iBAAiB,EAC1B,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAChC,OAAO,CAAC,sBAAsB,CAAC;CASnC"}

package/dist/types/utils/network-normalizer.d.ts

@@ -1,120 +0,0 @@
-/**
- * @module utils/network-normalizer
- * @description Network identifier normalization for x402 payment headers.
- *
- * Solves the canonical-string mismatch between SAP clients and servers:
- * some providers accept `solana:mainnet-beta` while others require
- * the genesis-hash form `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`.
- *
- * This module provides a single source of truth for normalizing
- * network identifiers so that both clients and agents canonicalize
- * before comparing. Catches the Kamiyo "sap network mismatch" error
- * at the SDK level.
- *
- * @category Utils
- * @since v0.6.0
- */
-import { type SapNetworkId } from "../constants/network";
-/**
- * @name normalizeNetworkId
- * @description Normalize a raw network identifier string to its canonical
- * {@link SapNetworkId} form.
- *
- * Handles:
- *   - Case-insensitive matching
- *   - Stripping whitespace
- *   - Resolving genesis-hash vs. cluster-name aliases
- *   - Unknown strings are returned as-is (passthrough)
- *
- * @param raw - Raw network identifier string from headers, env vars, or config.
- * @returns The canonical {@link SapNetworkId}, or the trimmed input if unknown.
- *
- * @category Utils
- * @since v0.6.0
- *
- * @example
- * ```ts
- * import { normalizeNetworkId } from "@synapse-sap/sdk";
- *
- * normalizeNetworkId("solana:mainnet-beta");
- * // → "solana:mainnet-beta"
- *
- * normalizeNetworkId("5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp");
- * // → "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
- *
- * normalizeNetworkId("  MAINNET  ");
- * // → "solana:mainnet-beta"
- * ```
- */
-export declare function normalizeNetworkId(raw: string): SapNetworkId | string;
-/**
- * @name isNetworkEquivalent
- * @description Check if two network identifier strings refer to the same network,
- * even if they use different formats (cluster-name vs. genesis-hash).
- *
- * This is the key function that prevents the Kamiyo "sap network mismatch"
- * error — instead of comparing strings literally, we compare their
- * canonical equivalence class.
- *
- * @param a - First network identifier.
- * @param b - Second network identifier.
- * @returns `true` if both identifiers refer to the same Solana network.
- *
- * @category Utils
- * @since v0.6.0
- *
- * @example
- * ```ts
- * import { isNetworkEquivalent } from "@synapse-sap/sdk";
- *
- * isNetworkEquivalent("solana:mainnet-beta", "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp");
- * // → true
- *
- * isNetworkEquivalent("solana:devnet", "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1");
- * // → true
- *
- * isNetworkEquivalent("solana:mainnet-beta", "solana:devnet");
- * // → false
- * ```
- */
-export declare function isNetworkEquivalent(a: string, b: string): boolean;
-/**
- * @name getNetworkGenesisHash
- * @description Get the genesis-hash form of a network identifier.
- * Returns the genesis-hash variant for known networks, or the input as-is.
- *
- * Useful for agents that require the genesis-hash form (Kamiyo, Helius x402).
- *
- * @param networkId - Any network identifier.
- * @returns The genesis-hash form, or the input if unknown.
- *
- * @category Utils
- * @since v0.6.0
- */
-export declare function getNetworkGenesisHash(networkId: string): string;
-/**
- * @name getNetworkClusterName
- * @description Get the cluster-name form of a network identifier.
- * Returns the human-readable cluster name for known networks.
- *
- * Useful for providers that accept cluster names (Coinbase, Phantom).
- *
- * @param networkId - Any network identifier.
- * @returns The cluster-name form, or the input if unknown.
- *
- * @category Utils
- * @since v0.6.0
- */
-export declare function getNetworkClusterName(networkId: string): string;
-/**
- * @name isKnownNetwork
- * @description Check if a network identifier is recognized by the SDK.
- *
- * @param networkId - The network identifier to check.
- * @returns `true` if the identifier maps to a known Solana network.
- *
- * @category Utils
- * @since v0.6.0
- */
-export declare function isKnownNetwork(networkId: string): boolean;
-//# sourceMappingURL=network-normalizer.d.ts.map

package/dist/types/utils/network-normalizer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"network-normalizer.d.ts","sourceRoot":"","sources":["../../../src/utils/network-normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAsDrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,MAAM,CAcrE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CA2BjE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAS/D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAS/D;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAIzD"}