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

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,33 +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";
-//# 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"}

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"}

package/dist/types/utils/priority-fee.d.ts

@@ -1,205 +0,0 @@
-/**
- * @module utils/priority-fee
- * @description Compute budget and priority fee utilities for SAP transactions.
- *
- * Solana transactions that include a priority fee (via the Compute Budget program)
- * land faster because validators prefer higher-fee transactions. This module
- * provides a clean, composable API for building priority-fee instructions
- * that can be prepended to any Anchor method builder via `.preInstructions()`.
- *
- * Typical use: x402 settlement transactions where the receiving agent's RPC
- * has a short confirmation window (e.g., 30 seconds).
- *
- * @category Utils
- * @since v0.6.2
- *
- * @example
- * ```ts
- * import { buildPriorityFeeIxs, DEFAULT_SETTLE_PRIORITY } from "@synapse-sap/sdk";
- *
- * // Append to any Anchor method builder:
- * await program.methods
- *   .settleCalls(calls, hash)
- *   .accounts({ ... })
- *   .preInstructions(buildPriorityFeeIxs({ priorityFeeMicroLamports: 5000 }))
- *   .rpc({ skipPreflight: true });
- * ```
- */
-import { type TransactionInstruction } from "@solana/web3.js";
-/**
- * Default priority fee for settlement transactions (in microlamports).
- * 5000 µL ≈ 0.0005 SOL per 200k CU — fast enough for most agent RPCs.
- *
- * @since v0.6.2
- */
-export declare const DEFAULT_SETTLE_PRIORITY_FEE = 5000;
-/**
- * Default compute unit limit for settlement transactions.
- * `settle_calls` uses ~60k CU; 100k provides a safe margin.
- *
- * @since v0.6.2
- */
-export declare const DEFAULT_SETTLE_COMPUTE_UNITS = 100000;
-/**
- * Default compute unit limit for batch settlement transactions.
- * `settle_batch` with 10 entries uses ~200k CU; 300k provides margin.
- *
- * @since v0.6.2
- */
-export declare const DEFAULT_BATCH_SETTLE_COMPUTE_UNITS = 300000;
-/**
- * @name computeBatchSettleCu
- * @description Compute the CU limit needed by `settle_batch` for a
- * given entry count. Returned value is safe to pass to
- * `ComputeBudgetProgram.setComputeUnitLimit`.
- *
- * Formula: `60_000 + n * 25_000`, clamped to 1.2M.
- *
- * @param entryCount - Number of settlements in the batch (1..N).
- * @returns CU limit suitable for `setComputeUnitLimit`.
- *
- * @example
- * ```ts
- * const cu = computeBatchSettleCu(20); // 560_000
- * ```
- *
- * @category Utils
- * @since v0.11.0
- */
-export declare function computeBatchSettleCu(entryCount: number): number;
-/**
- * @interface PriorityFeeConfig
- * @description Configuration for building compute budget instructions.
- * @category Utils
- * @since v0.6.2
- */
-export interface PriorityFeeConfig {
-    /**
-     * Priority fee in microlamports per compute unit.
-     * Higher values = faster confirmation.
-     *
-     * Common values:
-     * - `1000` — low priority (~0.0001 SOL)
-     * - `5000` — medium priority (~0.0005 SOL) ← recommended for settle
-     * - `50000` — high priority (~0.005 SOL)
-     * - `0` — no priority fee (default Solana behavior)
-     *
-     * @default 0
-     */
-    readonly priorityFeeMicroLamports?: number;
-    /**
-     * Maximum compute units the transaction may consume.
-     * Setting an explicit limit avoids overpaying for unused CU.
-     *
-     * @default 200_000 (Solana default)
-     */
-    readonly computeUnits?: number;
-}
-/**
- * @interface SettleOptions
- * @description Options for x402 settlement transactions.
- * Controls priority fees, compute budget, and RPC behavior
- * to optimize confirmation speed for time-sensitive settlements.
- *
- * @category Registries
- * @since v0.6.2
- *
- * @example
- * ```ts
- * // Fast settlement with priority fee
- * const receipt = await x402.settle(depositor, 1, "data", {
- *   priorityFeeMicroLamports: 5000,
- *   computeUnits: 100_000,
- *   skipPreflight: true,
- * });
- *
- * // Use the convenience preset
- * import { FAST_SETTLE_OPTIONS } from "@synapse-sap/sdk";
- * const receipt = await x402.settle(depositor, 1, "data", FAST_SETTLE_OPTIONS);
- * ```
- */
-export interface SettleOptions extends PriorityFeeConfig {
-    /**
-     * Skip Solana simulation before submitting.
-     * Saves ~400ms but loses pre-flight error detection.
-     *
-     * Recommended for settlements where the escrow state
-     * has already been pre-fetched and validated.
-     *
-     * @default false
-     */
-    readonly skipPreflight?: boolean;
-    /**
-     * Transaction commitment level override.
-     * Uses the provider's default when omitted.
-     *
-     * - `"processed"` — fastest, least reliable
-     * - `"confirmed"` — balanced (recommended)
-     * - `"finalized"` — slowest, most reliable
-     */
-    readonly commitment?: "processed" | "confirmed" | "finalized";
-    /**
-     * Maximum number of RPC retry attempts.
-     * @default provider default (usually 3)
-     */
-    readonly maxRetries?: number;
-}
-/**
- * Recommended preset for fast x402 settlements.
- * Priority fee 5000 µL, 100k CU, skip preflight, confirmed commitment.
- *
- * @since v0.6.2
- */
-export declare const FAST_SETTLE_OPTIONS: Readonly<SettleOptions>;
-/**
- * Recommended preset for fast batch settlements.
- * Priority fee 5000 µL, 300k CU, skip preflight, confirmed commitment.
- *
- * @since v0.6.2
- */
-export declare const FAST_BATCH_SETTLE_OPTIONS: Readonly<SettleOptions>;
-/**
- * @name buildPriorityFeeIxs
- * @description Build compute budget instructions for priority fee transactions.
- *
- * Returns an array of 0–2 `TransactionInstruction`s:
- * - `SetComputeUnitPrice` (if `priorityFeeMicroLamports > 0`)
- * - `SetComputeUnitLimit` (if `computeUnits` provided)
- *
- * The returned array is designed to be passed directly to
- * Anchor's `.preInstructions()` builder method.
- *
- * @param config - Priority fee configuration.
- * @returns Array of compute budget instructions (may be empty).
- *
- * @category Utils
- * @since v0.6.2
- *
- * @example
- * ```ts
- * const ixs = buildPriorityFeeIxs({
- *   priorityFeeMicroLamports: 5000,
- *   computeUnits: 100_000,
- * });
- *
- * await program.methods
- *   .settleCalls(calls, hash)
- *   .accounts({ ... })
- *   .preInstructions(ixs)
- *   .rpc({ skipPreflight: true });
- * ```
- */
-export declare function buildPriorityFeeIxs(config?: PriorityFeeConfig): TransactionInstruction[];
-/**
- * @name buildRpcOptions
- * @description Build Anchor `.rpc()` options from {@link SettleOptions}.
- *
- * @param opts - Settle options.
- * @returns Options object suitable for Anchor `.rpc(opts)`.
- *
- * @category Utils
- * @since v0.6.2
- * @internal
- */
-export declare function buildRpcOptions(opts?: SettleOptions): Record<string, unknown> | undefined;
-//# sourceMappingURL=priority-fee.d.ts.map

package/dist/types/utils/priority-fee.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"priority-fee.d.ts","sourceRoot":"","sources":["../../../src/utils/priority-fee.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,iBAAiB,CAAC;AAMzB;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,OAAQ,CAAC;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,SAAU,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,kCAAkC,SAAU,CAAC;AA8B1D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAM/D;AAMD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAE3C;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD;;;;;;;;OAQG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IAEjC;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;IAE9D;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAMD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,aAAa,CAKtD,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,aAAa,CAK5D,CAAC;AAMH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,CAAC,EAAE,iBAAiB,GACzB,sBAAsB,EAAE,CAwB1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,IAAI,CAAC,EAAE,aAAa,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAgBrC"}