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

package/dist/types/types/instructions.d.ts

@@ -1,400 +0,0 @@
-/**
- * @module types/instructions
- * @description Instruction argument DTOs and helper enumerations.
- *
- * These interfaces map 1:1 to the Anchor instruction argument structs.
- * Use them when calling SDK module methods.
- *
- * @category Types
- * @since v0.1.0
- */
-import type { PublicKey } from "@solana/web3.js";
-import type BN from "bn.js";
-import type { Capability, PricingTier, VolumeCurveBreakpoint } from "./common";
-/**
- * @interface RegisterAgentArgs
- * @description Arguments for the `registerAgent` instruction.
- *
- * Creates a new on-chain agent identity with the given profile,
- * capabilities, pricing tiers, and protocol support.
- *
- * @category Types
- * @since v0.1.0
- *
- * @example
- * ```ts
- * import { TokenType } from "@synapse-sap/sdk";
- *
- * const args: RegisterAgentArgs = {
- *   name: "My Agent",
- *   description: "A helpful Solana agent",
- *   capabilities: [{ id: "jupiter:swap", description: null, protocolId: "jupiter", version: "1.0" }],
- *   pricing: [],
- *   protocols: ["solana-agent-protocol"],
- * };
- * ```
- */
-export interface RegisterAgentArgs {
-    /** Agent display name. */
-    readonly name: string;
-    /** Agent description. */
-    readonly description: string;
-    /** Capabilities the agent exposes. */
-    readonly capabilities: Capability[];
-    /** Pricing tiers for the agent's services. */
-    readonly pricing: PricingTier[];
-    /** Supported protocol identifiers. */
-    readonly protocols: string[];
-    /** Optional off-chain agent identifier. */
-    readonly agentId?: string | null;
-    /** Optional URI to extended metadata. */
-    readonly agentUri?: string | null;
-    /** Optional x402 payment endpoint. */
-    readonly x402Endpoint?: string | null;
-}
-/**
- * @interface UpdateAgentArgs
- * @description Arguments for the `updateAgent` instruction.
- *
- * All fields are optional — pass only the fields you want to change.
- * `null` values are ignored on-chain.
- *
- * @category Types
- * @since v0.1.0
- */
-export interface UpdateAgentArgs {
-    readonly name?: string | null;
-    readonly description?: string | null;
-    readonly capabilities?: Capability[] | null;
-    readonly pricing?: PricingTier[] | null;
-    readonly protocols?: string[] | null;
-    readonly agentId?: string | null;
-    readonly agentUri?: string | null;
-    readonly x402Endpoint?: string | null;
-}
-/**
- * @interface GiveFeedbackArgs
- * @description Arguments for the `giveFeedback` instruction.
- *
- * Submits a reputation score and tag for the target agent.
- * Each reviewer can only submit one feedback per agent.
- *
- * @category Types
- * @since v0.1.0
- */
-export interface GiveFeedbackArgs {
-    /** Reputation score (1–100). */
-    readonly score: number;
-    /** Freeform tag / category for the feedback. */
-    readonly tag: string;
-    /** Optional SHA-256 hash of an off-chain comment. */
-    readonly commentHash?: number[] | null;
-}
-/**
- * @interface UpdateFeedbackArgs
- * @description Arguments for the `updateFeedback` instruction.
- *
- * Allows the original reviewer to revise their score and/or tag.
- *
- * @category Types
- * @since v0.1.0
- */
-export interface UpdateFeedbackArgs {
-    /** Updated reputation score (1–100). */
-    readonly newScore: number;
-    /** Updated tag (optional). */
-    readonly newTag?: string | null;
-    /** Updated off-chain comment hash (optional). */
-    readonly commentHash?: number[] | null;
-}
-/**
- * @interface PublishToolArgs
- * @description Arguments for the `publishTool` instruction.
- *
- * Registers a new tool descriptor on-chain with hashed metadata.
- * Hash fields are SHA-256 digests of the corresponding off-chain content.
- *
- * @category Types
- * @since v0.1.0
- */
-export interface PublishToolArgs {
-    /** Human-readable tool name. */
-    readonly toolName: string;
-    /** SHA-256 hash of the tool name (PDA seed). */
-    readonly toolNameHash: number[];
-    /** SHA-256 hash of the protocol identifier. */
-    readonly protocolHash: number[];
-    /** SHA-256 hash of the tool description. */
-    readonly descriptionHash: number[];
-    /** SHA-256 hash of the input JSON schema. */
-    readonly inputSchemaHash: number[];
-    /** SHA-256 hash of the output JSON schema. */
-    readonly outputSchemaHash: number[];
-    /** HTTP method discriminant index. */
-    readonly httpMethod: number;
-    /** Tool category discriminant index. */
-    readonly category: number;
-    /** Total number of parameters. */
-    readonly paramsCount: number;
-    /** Number of required parameters. */
-    readonly requiredParams: number;
-    /** Whether the tool is a compound (multi-step) operation. */
-    readonly isCompound: boolean;
-}
-/**
- * @interface UpdateToolArgs
- * @description Arguments for the `updateTool` instruction.
- *
- * All fields are optional — only pass the fields to update.
- *
- * @category Types
- * @since v0.1.0
- */
-export interface UpdateToolArgs {
-    readonly descriptionHash?: number[] | null;
-    readonly inputSchemaHash?: number[] | null;
-    readonly outputSchemaHash?: number[] | null;
-    readonly httpMethod?: number | null;
-    readonly category?: number | null;
-    readonly paramsCount?: number | null;
-    readonly requiredParams?: number | null;
-}
-/**
- * @interface InscribeToolSchemaArgs
- * @description Arguments for the `inscribeToolSchema` instruction.
- *
- * Writes a tool’s JSON schema (input, output, or description) on-chain
- * as an inscription, with optional compression.
- *
- * @category Types
- * @since v0.1.0
- * @see {@link SchemaType} for schema type discriminants.
- * @see {@link CompressionType} for compression discriminants.
- */
-export interface InscribeToolSchemaArgs {
-    /** Schema type discriminant (input / output / description). */
-    readonly schemaType: number;
-    /** Raw (optionally compressed) schema bytes. */
-    readonly schemaData: Buffer;
-    /** SHA-256 hash of the uncompressed schema. */
-    readonly schemaHash: number[];
-    /** Compression algorithm discriminant. */
-    readonly compression: number;
-}
-/**
- * @interface InscribeMemoryArgs
- * @description Arguments for the `inscribeMemory` instruction.
- *
- * Writes an encrypted memory fragment into a vault session.
- * Supports multi-fragment inscriptions and epoch-based partitioning.
- *
- * @category Types
- * @since v0.1.0
- */
-export interface InscribeMemoryArgs {
-    /** Sequence number within the session. */
-    readonly sequence: number;
-    /** NaCl-encrypted payload. */
-    readonly encryptedData: Buffer;
-    /** Encryption nonce (12 bytes). */
-    readonly nonce: number[];
-    /** SHA-256 hash of the plaintext content. */
-    readonly contentHash: number[];
-    /** Total fragments in this inscription. */
-    readonly totalFragments: number;
-    /** Zero-based index of this fragment. */
-    readonly fragmentIndex: number;
-    /** Compression algorithm discriminant. */
-    readonly compression: number;
-    /** Target epoch index. */
-    readonly epochIndex: number;
-}
-/**
- * @interface CompactInscribeArgs
- * @description Arguments for the `compactInscribe` instruction.
- *
- * A simplified inscription variant that omits fragmentation and epoch
- * fields — ideal for small, single-fragment payloads.
- *
- * @category Types
- * @since v0.1.0
- */
-export interface CompactInscribeArgs {
-    /** Sequence number within the session. */
-    readonly sequence: number;
-    /** NaCl-encrypted payload. */
-    readonly encryptedData: Buffer;
-    /** Encryption nonce (12 bytes). */
-    readonly nonce: number[];
-    /** SHA-256 hash of the plaintext content. */
-    readonly contentHash: number[];
-}
-/**
- * @interface CreateEscrowArgs
- * @description Arguments for the `createEscrow` instruction.
- *
- * Creates a pre-funded escrow account for micropayments to an agent,
- * optionally with volume-based discount breakpoints.
- *
- * @category Types
- * @since v0.1.0
- * @deprecated Since v0.7.0 — Use {@link CreateEscrowV2Args} for V2 escrows.
- * @see {@link VolumeCurveBreakpoint} for discount curve details.
- */
-export interface CreateEscrowArgs {
-    /** Base price per call in token base units. */
-    readonly pricePerCall: BN;
-    /** Maximum number of calls the escrow should fund. */
-    readonly maxCalls: BN;
-    /** Initial deposit amount. */
-    readonly initialDeposit: BN;
-    /** Unix timestamp when the escrow expires. */
-    readonly expiresAt: BN;
-    /** Volume discount breakpoints (pass `[]` for none). */
-    readonly volumeCurve: VolumeCurveBreakpoint[];
-    /** SPL token mint (pass `null` for native SOL). */
-    readonly tokenMint: PublicKey | null;
-    /** Decimal places for the token. */
-    readonly tokenDecimals: number;
-}
-/**
- * @interface CreateAttestationArgs
- * @description Arguments for the `createAttestation` instruction.
- *
- * Issues a web-of-trust attestation for a target agent.
- *
- * @category Types
- * @since v0.1.0
- */
-export interface CreateAttestationArgs {
-    /** Freeform attestation type (e.g. `"kyc"`, `"audit"`). */
-    readonly attestationType: string;
-    /** SHA-256 hash of off-chain attestation metadata. */
-    readonly metadataHash: number[];
-    /** Unix timestamp when the attestation expires. */
-    readonly expiresAt: BN;
-}
-/**
- * @name DelegatePermission
- * @description Bitmask constants for vault delegate permissions.
- *
- * Combine with bitwise OR to grant multiple permissions.
- *
- * | Bit | Value | Permission          |
- * | --- | ----- | ------------------- |
- * | 0   | 1     | Inscribe memories   |
- * | 1   | 2     | Close sessions      |
- * | 2   | 4     | Open sessions       |
- * | —   | 7     | All permissions     |
- *
- * @category Types
- * @since v0.1.0
- *
- * @example
- * ```ts
- * import { DelegatePermission } from "@synapse-sap/sdk";
- *
- * // Grant inscribe + open session
- * const perms = DelegatePermission.Inscribe | DelegatePermission.OpenSession;
- * ```
- */
-export declare const DelegatePermission: {
-    readonly Inscribe: 1;
-    readonly CloseSession: 2;
-    readonly OpenSession: 4;
-    readonly All: 7;
-};
-/**
- * @name DelegatePermissionBit
- * @description Union of valid {@link DelegatePermission} bit values.
- */
-export type DelegatePermissionBit = (typeof DelegatePermission)[keyof typeof DelegatePermission];
-/**
- * @name SchemaType
- * @description Numeric discriminants for tool schema types.
- *
- * Used in the `inscribeToolSchema` instruction to specify which schema
- * is being written on-chain.
- *
- * @category Types
- * @since v0.1.0
- *
- * @example
- * ```ts
- * import { SchemaType } from "@synapse-sap/sdk";
- *
- * const args = { schemaType: SchemaType.Input, ... };
- * ```
- */
-export declare const SchemaType: {
-    readonly Input: 0;
-    readonly Output: 1;
-    readonly Description: 2;
-};
-/**
- * @name SchemaTypeValue
- * @description Union of valid {@link SchemaType} discriminant values.
- */
-export type SchemaTypeValue = (typeof SchemaType)[keyof typeof SchemaType];
-/**
- * @name CompressionType
- * @description Numeric discriminants for compression algorithms.
- *
- * Used in inscription instructions to declare the compression format
- * of the payload so consumers can decompress correctly.
- *
- * @category Types
- * @since v0.1.0
- *
- * @example
- * ```ts
- * import { CompressionType } from "@synapse-sap/sdk";
- *
- * const args = { compression: CompressionType.Gzip, ... };
- * ```
- */
-export declare const CompressionType: {
-    readonly None: 0;
-    readonly Deflate: 1;
-    readonly Gzip: 2;
-    readonly Brotli: 3;
-};
-/**
- * @name CompressionTypeValue
- * @description Union of valid {@link CompressionType} discriminant values.
- */
-export type CompressionTypeValue = (typeof CompressionType)[keyof typeof CompressionType];
-/**
- * @interface CreateEscrowV2Args
- * @description Arguments for the `createEscrowV2` instruction.
- * @category Types
- * @since v0.5.0
- */
-export interface CreateEscrowV2Args {
-    readonly escrowNonce: BN;
-    readonly pricePerCall: BN;
-    readonly maxCalls: BN;
-    readonly initialDeposit: BN;
-    readonly expiresAt: BN;
-    readonly volumeCurve: VolumeCurveBreakpoint[];
-    readonly tokenMint: PublicKey | null;
-    readonly tokenDecimals: number;
-    /** 0=SelfReport, 1=CoSigned, 2=DisputeWindow */
-    readonly settlementSecurity: number;
-    readonly disputeWindowSlots: BN;
-    readonly coSigner: PublicKey | null;
-    readonly arbiter: PublicKey | null;
-}
-/**
- * @interface CreateSubscriptionArgs
- * @description Arguments for the `createSubscription` instruction.
- * @category Types
- * @since v0.5.0
- */
-export interface CreateSubscriptionArgs {
-    readonly subId: BN;
-    readonly pricePerInterval: BN;
-    readonly billingInterval: number;
-    readonly initialFund: BN;
-}
-//# sourceMappingURL=instructions.d.ts.map

package/dist/types/types/instructions.d.ts.map

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

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

@@ -1,110 +0,0 @@
-/**
- * @module utils/endpoint-validator
- * @description Endpoint validation utilities for SAP agent discovery.
- *
- * Fetches advertised endpoints and verifies they respond with JSON,
- * proper CORS headers, and SAP-compatible behavior. Designed to
- * fail fast when an endpoint 404s, requires CSRF tokens, or
- * serves HTML instead of JSON.
- *
- * Used by:
- *   - CLI `discovery validate` command
- *   - SDK programmatic validation before x402 calls
- *   - Integration test harnesses
- *
- * @category Utils
- * @since v0.6.0
- */
-import type { EndpointDescriptor, HealthCheckDescriptor, EndpointValidationResult } from "../types/endpoint";
-/**
- * @interface ValidateEndpointOptions
- * @description Options for endpoint validation.
- * @category Utils
- * @since v0.6.0
- */
-export interface ValidateEndpointOptions {
-    /** Timeout in milliseconds (default: 10000). */
-    readonly timeoutMs?: number;
-    /** Number of retries on failure (default: 1). */
-    readonly retries?: number;
-    /** HTTP method override (default: uses descriptor or HEAD). */
-    readonly method?: string;
-    /** Custom headers to include in the validation request. */
-    readonly headers?: Record<string, string>;
-    /** If true, also sends a preflight OPTIONS request. */
-    readonly checkCors?: boolean;
-}
-/**
- * @name validateEndpoint
- * @description Validate a single endpoint URL for SAP compatibility.
- *
- * Performs the following checks:
- *   1. URL is reachable (no 4xx/5xx)
- *   2. Response Content-Type is JSON
- *   3. CORS headers are present (if checkCors enabled)
- *   4. No redirect to HTML login pages
- *   5. Measures response latency
- *
- * @param url - The endpoint URL to validate.
- * @param opts - Validation options.
- * @returns An {@link EndpointValidationResult} with detailed check results.
- *
- * @category Utils
- * @since v0.6.0
- *
- * @example
- * ```ts
- * const result = await validateEndpoint("https://api.example.com/x402");
- * if (!result.reachable) console.error(result.error);
- * ```
- */
-export declare function validateEndpoint(url: string, opts?: ValidateEndpointOptions): Promise<EndpointValidationResult>;
-/**
- * @name validateEndpointDescriptor
- * @description Validate an {@link EndpointDescriptor} with context-aware checks.
- *
- * Uses the descriptor's method, auth requirements, and other metadata to
- * perform a more targeted validation than raw URL checking.
- *
- * @param descriptor - The endpoint descriptor to validate.
- * @param opts - Additional options.
- * @returns An {@link EndpointValidationResult}.
- *
- * @category Utils
- * @since v0.6.0
- */
-export declare function validateEndpointDescriptor(descriptor: EndpointDescriptor, opts?: ValidateEndpointOptions): Promise<EndpointValidationResult>;
-/**
- * @name validateHealthCheck
- * @description Validate an agent's health-check endpoint.
- *
- * @param health - The health-check descriptor.
- * @returns An {@link EndpointValidationResult}.
- *
- * @category Utils
- * @since v0.6.0
- */
-export declare function validateHealthCheck(health: HealthCheckDescriptor): Promise<EndpointValidationResult>;
-/**
- * @name validateAgentEndpoints
- * @description Validate all endpoints for an agent (primary + health + tool overrides).
- *
- * @param params - Object containing the endpoints to validate.
- * @param params.endpoint - Primary endpoint descriptor.
- * @param params.healthCheck - Optional health-check descriptor.
- * @param params.toolEndpoints - Optional array of tool-specific endpoint overrides.
- * @param opts - Validation options.
- * @returns A map of `label → EndpointValidationResult`.
- *
- * @category Utils
- * @since v0.6.0
- */
-export declare function validateAgentEndpoints(params: {
-    endpoint: EndpointDescriptor;
-    healthCheck?: HealthCheckDescriptor;
-    toolEndpoints?: Array<{
-        name: string;
-        endpoint: EndpointDescriptor;
-    }>;
-}, opts?: ValidateEndpointOptions): Promise<Map<string, EndpointValidationResult>>;
-//# sourceMappingURL=endpoint-validator.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"endpoint-validator.d.ts","sourceRoot":"","sources":["../../../src/utils/endpoint-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAM3B;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,gDAAgD;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,uDAAuD;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC,wBAAwB,CAAC,CA+FnC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,kBAAkB,EAC9B,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC,wBAAwB,CAAC,CA6BnC;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,wBAAwB,CAAC,CAmBnC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE;IACN,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,kBAAkB,CAAA;KAAE,CAAC,CAAC;CACvE,EACD,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAsBhD"}

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