@ophirai/sdk 0.1.0

package/dist/identity.js

@@ -0,0 +1,108 @@
+import nacl from 'tweetnacl';
+import bs58 from 'bs58';
+import { OphirError, OphirErrorCode } from '@ophirai/protocol';
+/** Multicodec prefix for Ed25519 public key (varint-encoded 0xed) */
+const ED25519_MULTICODEC_PREFIX = new Uint8Array([0xed, 0x01]);
+const DID_KEY_PREFIX = 'did:key:z';
+/**
+ * Generate an Ed25519 keypair for agent identity.
+ *
+ * @throws {OphirError} if the generated keypair has unexpected key lengths.
+ *
+ * @example
+ * ```typescript
+ * const { publicKey, secretKey } = generateKeyPair();
+ * // publicKey: Uint8Array(32), secretKey: Uint8Array(64)
+ * ```
+ */
+export function generateKeyPair() {
+    const kp = nacl.sign.keyPair();
+    if (kp.publicKey.length !== 32 || kp.secretKey.length !== 64) {
+        throw new OphirError(OphirErrorCode.INVALID_MESSAGE, `Key generation produced invalid lengths: publicKey=${kp.publicKey.length}, secretKey=${kp.secretKey.length}`);
+    }
+    return { publicKey: kp.publicKey, secretKey: kp.secretKey };
+}
+/**
+ * Convert Ed25519 public key to did:key:z6Mk... format.
+ * Prepends multicodec prefix (0xed01) then base58-btc encodes with 'z' prefix.
+ *
+ * @throws {OphirError} if publicKey is not exactly 32 bytes.
+ *
+ * @example
+ * ```typescript
+ * const did = publicKeyToDid(keypair.publicKey);
+ * // 'did:key:z6Mk...'
+ * ```
+ */
+export function publicKeyToDid(publicKey) {
+    if (publicKey.length !== 32) {
+        throw new OphirError(OphirErrorCode.INVALID_MESSAGE, `Invalid public key length: expected 32, got ${publicKey.length}`);
+    }
+    const prefixed = new Uint8Array(ED25519_MULTICODEC_PREFIX.length + publicKey.length);
+    prefixed.set(ED25519_MULTICODEC_PREFIX);
+    prefixed.set(publicKey, ED25519_MULTICODEC_PREFIX.length);
+    return `did:key:z${bs58.encode(prefixed)}`;
+}
+/**
+ * Extract Ed25519 public key from did:key string.
+ *
+ * @throws {OphirError} if input is empty, DID format is invalid, or extracted key is not 32 bytes.
+ *
+ * @example
+ * ```typescript
+ * const publicKey = didToPublicKey('did:key:z6Mk...');
+ * // Uint8Array(32)
+ * ```
+ */
+export function didToPublicKey(did) {
+    if (!did || typeof did !== 'string') {
+        throw new OphirError(OphirErrorCode.INVALID_MESSAGE, 'DID must be a non-empty string');
+    }
+    if (!did.startsWith(DID_KEY_PREFIX)) {
+        throw new OphirError(OphirErrorCode.INVALID_MESSAGE, `Invalid did:key format: ${did}. Expected format: did:key:z<base58-encoded-ed25519-public-key>`);
+    }
+    const encoded = did.slice(DID_KEY_PREFIX.length);
+    const decoded = bs58.decode(encoded);
+    // Strip the 2-byte multicodec prefix
+    if (decoded.length < 2 ||
+        decoded[0] !== ED25519_MULTICODEC_PREFIX[0] ||
+        decoded[1] !== ED25519_MULTICODEC_PREFIX[1]) {
+        throw new OphirError(OphirErrorCode.INVALID_MESSAGE, 'Invalid multicodec prefix — expected Ed25519 (0xed01)');
+    }
+    const publicKey = decoded.slice(2);
+    if (publicKey.length !== 32) {
+        throw new OphirError(OphirErrorCode.INVALID_MESSAGE, `Invalid public key length after DID decoding: expected 32, got ${publicKey.length}`);
+    }
+    return publicKey;
+}
+/**
+ * Generate a complete agent identity bundle.
+ *
+ * @param endpoint - The HTTPS endpoint URL for the agent.
+ * @throws {OphirError} if endpoint is not a valid URL with http or https protocol.
+ *
+ * @example
+ * ```typescript
+ * const identity = generateAgentIdentity('https://agent.example.com');
+ * // { agentId: 'did:key:z6Mk...', keypair: { publicKey, secretKey }, endpoint: 'https://...' }
+ * ```
+ */
+export function generateAgentIdentity(endpoint) {
+    if (!endpoint || typeof endpoint !== 'string') {
+        throw new OphirError(OphirErrorCode.INVALID_MESSAGE, 'endpoint must be a non-empty string');
+    }
+    try {
+        const url = new URL(endpoint);
+        if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+            throw new OphirError(OphirErrorCode.INVALID_MESSAGE, `endpoint must use http or https protocol, got: ${url.protocol}`);
+        }
+    }
+    catch (e) {
+        if (e instanceof OphirError)
+            throw e;
+        throw new OphirError(OphirErrorCode.INVALID_MESSAGE, `endpoint is not a valid URL: ${endpoint}`);
+    }
+    const keypair = generateKeyPair();
+    const agentId = publicKeyToDid(keypair.publicKey);
+    return { agentId, keypair, endpoint };
+}

package/dist/index.d.ts

@@ -0,0 +1,122 @@
+/**
+ * @module @ophirai/sdk
+ *
+ * SDK for the Ophir Agent Negotiation Protocol.
+ * Provides BuyerAgent, SellerAgent, Ed25519 signing, JSON-RPC transport,
+ * Solana escrow management, and integration utilities.
+ */
+export { canonicalize, sign, verify, agreementHash, signMessage, verifyMessage, } from './signing.js';
+export { generateKeyPair, publicKeyToDid, didToPublicKey, generateAgentIdentity, } from './identity.js';
+/** Shared types for escrow configuration, service offerings, pricing, and agreements. */
+export type { 
+/** Configuration for Solana escrow operations (program ID, RPC endpoint). */
+EscrowConfig, 
+/** A service a seller offers (category, description, base price, currency, unit). */
+ServiceOffering, 
+/** Pricing strategy for quote generation (fixed, competitive, dynamic). */
+PricingStrategy, 
+/** Custom comparator function for ranking quotes. */
+RankingFunction, 
+/** Seller identity and service catalog, parsed from an Agent Card. */
+SellerInfo, 
+/** Dual-signed agreement between buyer and seller with final terms and agreement hash. */
+Agreement, 
+/** Result of filing an SLA dispute (dispute ID and outcome status). */
+DisputeResult, 
+/** Result of a job execution (success flag, data, and optional error). */
+JobResult, } from './types.js';
+/** JSON-RPC 2.0 client for sending negotiation messages over HTTPS. */
+export { JsonRpcClient } from './transport.js';
+/** Configuration options for the JSON-RPC client (timeout, headers). */
+export type { JsonRpcClientConfig } from './transport.js';
+/** Tracks the state of a single negotiation session, enforcing valid transitions. */
+export { NegotiationSession } from './negotiation.js';
+/** Express-based JSON-RPC 2.0 server that dispatches to registered method handlers. */
+export { NegotiationServer } from './server.js';
+export { buildRFQ, buildQuote, buildCounter, buildAccept, buildReject, buildDispute, } from './messages.js';
+/** Pre-built SLA templates and comparison/conversion utilities. */
+export { SLA_TEMPLATES, compareSLAs, meetsSLARequirements, slaToLockstepSpec, } from './sla.js';
+export type { 
+/** Result of comparing two SLA specifications metric-by-metric. */
+SLAComparisonResult, 
+/** Per-metric comparison detail (name, offered vs required, met flag). */
+SLAComparisonDetail, 
+/** Result of checking if an SLA meets requirements (meets flag, gaps). */
+SLAMeetsResult, 
+/** A gap between a required SLA target and an offered value. */
+SLAGap, 
+/** A single behavioral check in a Lockstep verification spec. */
+LockstepBehavioralCheck, 
+/** Full Lockstep verification spec converted from SLA terms. */
+LockstepVerificationSpec, } from './sla.js';
+/** Sell-side agent that receives RFQs, generates quotes, and manages agreements. */
+export { SellerAgent } from './seller.js';
+/** Configuration for creating a SellerAgent (keypair, endpoint, services, pricing). */
+export type { SellerAgentConfig } from './seller.js';
+/** Buy-side agent that sends RFQs, collects quotes, ranks, and accepts offers. */
+export { BuyerAgent } from './buyer.js';
+/** Configuration for creating a BuyerAgent (keypair, endpoint, escrow config). */
+export type { BuyerAgentConfig } from './buyer.js';
+/** Manages Solana PDA escrow operations (create, release, dispute, cancel). */
+export { EscrowManager } from './escrow.js';
+/** On-chain escrow status enum (Active, Released, Disputed, Cancelled). */
+export type { EscrowStatus, EscrowAccountData } from './escrow.js';
+/** Discover agents via A2A Agent Cards at /.well-known/agent.json endpoints. */
+export { discoverAgents, parseAgentCard } from './discovery.js';
+/** A2A-compatible Agent Card describing an agent's identity and capabilities. */
+export type { AgentCard, NegotiationCapability } from './discovery.js';
+/** Convert agreements to Lockstep specs and monitor SLA compliance. */
+export { agreementToLockstepSpec, LockstepMonitor } from './lockstep.js';
+export type { 
+/** Lockstep behavioral verification specification derived from SLA terms. */
+LockstepSpec, 
+/** A single behavioral requirement in a Lockstep verification spec. */
+LockstepBehavioralRequirement, 
+/** Configuration for the LockstepMonitor (verification endpoint URL). */
+LockstepMonitorConfig, 
+/** Result of an SLA compliance check (compliant flag and violation details). */
+ComplianceResult, } from './lockstep.js';
+/** Convert agreements to x402 HTTP payment headers and parse responses. */
+export { agreementToX402Headers, parseX402Response } from './x402.js';
+/** All protocol-level types re-exported from @ophirai/protocol for convenience. */
+export type { 
+/** Agent identity with did:key identifier and HTTP endpoint. */
+AgentIdentity, 
+/** Service category and requirements specified by the buyer. */
+ServiceRequirement, 
+/** Budget constraints (max price, currency, unit, total budget). */
+BudgetConstraint, 
+/** SLA requirements with metrics and dispute resolution terms. */
+SLARequirement, 
+/** Single SLA metric (name, target, comparison operator). */
+SLAMetric, 
+/** Accepted payment method (network and token). */
+PaymentMethod, 
+/** Seller's pricing offer (price, currency, unit, model, volume discounts). */
+PricingOffer, 
+/** Execution metadata for a running service. */
+ExecutionInfo, 
+/** Escrow deposit requirements from a seller's quote. */
+EscrowRequirement, 
+/** Agreed-upon final terms (price, currency, unit, SLA, escrow). */
+FinalTerms, 
+/** Evidence of an SLA violation for dispute filing. */
+ViolationEvidence, 
+/** Union type of all 11 negotiation states. */
+NegotiationState, 
+/** Parameters for a negotiate/rfq message. */
+RFQParams, 
+/** Parameters for a negotiate/quote message. */
+QuoteParams, 
+/** Parameters for a negotiate/counter message. */
+CounterParams, 
+/** Parameters for a negotiate/accept message (dual-signed). */
+AcceptParams, 
+/** Parameters for a negotiate/reject message. */
+RejectParams, 
+/** Parameters for a negotiate/dispute message. */
+DisputeParams, 
+/** JSON-RPC 2.0 request envelope with typed params. */
+JsonRpcRequest, 
+/** JSON-RPC 2.0 response envelope with typed result. */
+JsonRpcResponse, } from '@ophirai/protocol';

package/dist/index.js

@@ -0,0 +1,43 @@
+/**
+ * @module @ophirai/sdk
+ *
+ * SDK for the Ophir Agent Negotiation Protocol.
+ * Provides BuyerAgent, SellerAgent, Ed25519 signing, JSON-RPC transport,
+ * Solana escrow management, and integration utilities.
+ */
+// ── Cryptographic signing ────────────────────────────────────────────
+export { canonicalize, sign, verify, agreementHash, signMessage, verifyMessage, } from './signing.js';
+// ── Agent identity (did:key) ─────────────────────────────────────────
+export { generateKeyPair, publicKeyToDid, didToPublicKey, generateAgentIdentity, } from './identity.js';
+// ── JSON-RPC transport ──────────────────────────────────────────────
+/** JSON-RPC 2.0 client for sending negotiation messages over HTTPS. */
+export { JsonRpcClient } from './transport.js';
+// ── Negotiation state machine ────────────────────────────────────────
+/** Tracks the state of a single negotiation session, enforcing valid transitions. */
+export { NegotiationSession } from './negotiation.js';
+// ── JSON-RPC server ─────────────────────────────────────────────────
+/** Express-based JSON-RPC 2.0 server that dispatches to registered method handlers. */
+export { NegotiationServer } from './server.js';
+// ── Message builders ────────────────────────────────────────────────
+export { buildRFQ, buildQuote, buildCounter, buildAccept, buildReject, buildDispute, } from './messages.js';
+// ── SLA utilities ───────────────────────────────────────────────────
+/** Pre-built SLA templates and comparison/conversion utilities. */
+export { SLA_TEMPLATES, compareSLAs, meetsSLARequirements, slaToLockstepSpec, } from './sla.js';
+// ── Seller agent ────────────────────────────────────────────────────
+/** Sell-side agent that receives RFQs, generates quotes, and manages agreements. */
+export { SellerAgent } from './seller.js';
+// ── Buyer agent ─────────────────────────────────────────────────────
+/** Buy-side agent that sends RFQs, collects quotes, ranks, and accepts offers. */
+export { BuyerAgent } from './buyer.js';
+// ── Solana escrow ───────────────────────────────────────────────────
+/** Manages Solana PDA escrow operations (create, release, dispute, cancel). */
+export { EscrowManager } from './escrow.js';
+// ── Agent discovery (A2A) ───────────────────────────────────────────
+/** Discover agents via A2A Agent Cards at /.well-known/agent.json endpoints. */
+export { discoverAgents, parseAgentCard } from './discovery.js';
+// ── Lockstep verification ───────────────────────────────────────────
+/** Convert agreements to Lockstep specs and monitor SLA compliance. */
+export { agreementToLockstepSpec, LockstepMonitor } from './lockstep.js';
+// ── x402 payment headers ───────────────────────────────────────────
+/** Convert agreements to x402 HTTP payment headers and parse responses. */
+export { agreementToX402Headers, parseX402Response } from './x402.js';

package/dist/lockstep.d.ts

@@ -0,0 +1,94 @@
+import type { Agreement, DisputeResult } from './types.js';
+/** A single behavioral requirement in a Lockstep verification spec. */
+export interface LockstepBehavioralRequirement {
+    metric: string;
+    operator: string;
+    threshold: number;
+    measurement_method: string;
+    measurement_window: string;
+}
+/** Lockstep behavioral verification specification derived from SLA terms. */
+export interface LockstepSpec {
+    spec_version: string;
+    agent_id: string;
+    behavioral_requirements: LockstepBehavioralRequirement[];
+    verification_mode: string;
+    on_violation: {
+        action: string;
+        escrow_address?: string;
+        penalty_rate?: number;
+    };
+}
+/** Convert agreed SLA terms into a Lockstep behavioral verification specification.
+ * @param agreement - The finalized agreement containing SLA metrics and escrow details
+ * @returns A Lockstep spec with behavioral requirements derived from the agreement's SLA metrics
+ * @example
+ * ```typescript
+ * const spec = agreementToLockstepSpec(agreement);
+ * console.log(spec.behavioral_requirements); // [{ metric: 'latency', operator: '<=', ... }]
+ * ```
+ */
+export declare function agreementToLockstepSpec(agreement: Agreement): LockstepSpec;
+/** Configuration for the LockstepMonitor. */
+export interface LockstepMonitorConfig {
+    /** Lockstep verification API endpoint. Defaults to the Lockstep public API. */
+    verificationEndpoint?: string;
+}
+/** Result of an SLA compliance check against the Lockstep verification service. */
+export interface ComplianceResult {
+    compliant: boolean;
+    violations: {
+        metric: string;
+        threshold: number;
+        observed: number;
+        timestamp: string;
+    }[];
+}
+/**
+ * Monitor agent compliance with agreed SLA terms via Lockstep verification.
+ */
+export declare class LockstepMonitor {
+    private verificationEndpoint;
+    private specs;
+    constructor(config?: LockstepMonitorConfig);
+    /** Register an agreement for continuous SLA monitoring. Operates locally if the endpoint is unavailable.
+     * @param agreement - The finalized agreement to monitor for SLA compliance
+     * @returns An object containing the assigned monitoringId
+     * @example
+     * ```typescript
+     * const monitor = new LockstepMonitor();
+     * const { monitoringId } = await monitor.startMonitoring(agreement);
+     * ```
+     */
+    startMonitoring(agreement: Agreement): Promise<{
+        monitoringId: string;
+    }>;
+    /** Check SLA compliance for a monitored agreement.
+     * Returns unknown compliance status if the verification endpoint is unavailable,
+     * so callers can distinguish between verified compliance and missing data.
+     * @param monitoringId - The monitoring ID returned by startMonitoring
+     * @returns A compliance result with violation details; `compliant` is false with an empty violations array when the endpoint is unreachable (unknown state)
+     * @example
+     * ```typescript
+     * const result = await monitor.checkCompliance(monitoringId);
+     * if (!result.compliant) console.log('Violations:', result.violations);
+     * ```
+     */
+    checkCompliance(monitoringId: string): Promise<ComplianceResult>;
+    /** Trigger an SLA violation dispute via the Lockstep service. Returns a pending result if the endpoint is unavailable.
+     * @param monitoringId - The monitoring ID for the agreement in violation
+     * @param violation - Details of the observed SLA violation
+     * @returns The dispute result with outcome status ("pending" when the endpoint is unavailable)
+     * @example
+     * ```typescript
+     * const dispute = await monitor.triggerDispute(monitoringId, {
+     *   metric: 'latency', threshold: 200, observed: 450,
+     * });
+     * ```
+     */
+    triggerDispute(monitoringId: string, violation: {
+        metric: string;
+        threshold: number;
+        observed: number;
+    }): Promise<DisputeResult>;
+}

package/dist/lockstep.js

@@ -0,0 +1,127 @@
+const DEFAULT_LOCKSTEP_ENDPOINT = 'https://api.lockstep.dev/v1';
+/** Convert agreed SLA terms into a Lockstep behavioral verification specification.
+ * @param agreement - The finalized agreement containing SLA metrics and escrow details
+ * @returns A Lockstep spec with behavioral requirements derived from the agreement's SLA metrics
+ * @example
+ * ```typescript
+ * const spec = agreementToLockstepSpec(agreement);
+ * console.log(spec.behavioral_requirements); // [{ metric: 'latency', operator: '<=', ... }]
+ * ```
+ */
+export function agreementToLockstepSpec(agreement) {
+    const sla = agreement.final_terms.sla;
+    const metrics = sla?.metrics ?? [];
+    return {
+        spec_version: '1.0',
+        agent_id: agreement.agreement_id,
+        behavioral_requirements: metrics.map((m) => ({
+            metric: m.name === 'custom' && m.custom_name ? m.custom_name : m.name,
+            operator: m.comparison,
+            threshold: m.target,
+            measurement_method: m.measurement_method ?? 'rolling_average',
+            measurement_window: m.measurement_window ?? '1h',
+        })),
+        verification_mode: 'continuous',
+        on_violation: {
+            action: 'trigger_dispute',
+            escrow_address: agreement.escrow?.address,
+            penalty_rate: metrics.length > 0 && metrics[0].penalty_per_violation
+                ? parseFloat(metrics[0].penalty_per_violation.amount) || undefined
+                : undefined,
+        },
+    };
+}
+/**
+ * Monitor agent compliance with agreed SLA terms via Lockstep verification.
+ */
+export class LockstepMonitor {
+    verificationEndpoint;
+    specs = new Map();
+    constructor(config = {}) {
+        this.verificationEndpoint =
+            config.verificationEndpoint ?? DEFAULT_LOCKSTEP_ENDPOINT;
+    }
+    /** Register an agreement for continuous SLA monitoring. Operates locally if the endpoint is unavailable.
+     * @param agreement - The finalized agreement to monitor for SLA compliance
+     * @returns An object containing the assigned monitoringId
+     * @example
+     * ```typescript
+     * const monitor = new LockstepMonitor();
+     * const { monitoringId } = await monitor.startMonitoring(agreement);
+     * ```
+     */
+    async startMonitoring(agreement) {
+        const spec = agreementToLockstepSpec(agreement);
+        const monitoringId = `mon_${agreement.agreement_id}`;
+        this.specs.set(monitoringId, spec);
+        try {
+            await fetch(`${this.verificationEndpoint}/monitors`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ monitoring_id: monitoringId, spec }),
+            });
+            // Spec is already stored locally; remote registration is best-effort
+        }
+        catch (_err) {
+            // Lockstep endpoint not available — operate in local mode.
+            // This is best-effort: the spec is stored locally regardless.
+        }
+        return { monitoringId };
+    }
+    /** Check SLA compliance for a monitored agreement.
+     * Returns unknown compliance status if the verification endpoint is unavailable,
+     * so callers can distinguish between verified compliance and missing data.
+     * @param monitoringId - The monitoring ID returned by startMonitoring
+     * @returns A compliance result with violation details; `compliant` is false with an empty violations array when the endpoint is unreachable (unknown state)
+     * @example
+     * ```typescript
+     * const result = await monitor.checkCompliance(monitoringId);
+     * if (!result.compliant) console.log('Violations:', result.violations);
+     * ```
+     */
+    async checkCompliance(monitoringId) {
+        try {
+            const res = await fetch(`${this.verificationEndpoint}/monitors/${monitoringId}/compliance`);
+            if (res.ok) {
+                return (await res.json());
+            }
+        }
+        catch (_err) {
+            // Lockstep endpoint unavailable — cannot verify compliance
+        }
+        // Cannot verify compliance — report as non-compliant with no specific violations
+        // so callers don't mistakenly treat unverified state as verified compliance.
+        return { compliant: false, violations: [] };
+    }
+    /** Trigger an SLA violation dispute via the Lockstep service. Returns a pending result if the endpoint is unavailable.
+     * @param monitoringId - The monitoring ID for the agreement in violation
+     * @param violation - Details of the observed SLA violation
+     * @returns The dispute result with outcome status ("pending" when the endpoint is unavailable)
+     * @example
+     * ```typescript
+     * const dispute = await monitor.triggerDispute(monitoringId, {
+     *   metric: 'latency', threshold: 200, observed: 450,
+     * });
+     * ```
+     */
+    async triggerDispute(monitoringId, violation) {
+        const spec = this.specs.get(monitoringId);
+        try {
+            const res = await fetch(`${this.verificationEndpoint}/monitors/${monitoringId}/dispute`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ violation, spec }),
+            });
+            if (res.ok) {
+                return (await res.json());
+            }
+        }
+        catch (_err) {
+            // Lockstep endpoint unavailable — return pending result
+        }
+        return {
+            dispute_id: `dispute_${monitoringId}_${Date.now()}`,
+            outcome: 'pending',
+        };
+    }
+}

package/dist/messages.d.ts

@@ -0,0 +1,172 @@
+import type { AgentIdentity, ServiceRequirement, BudgetConstraint, SLARequirement, PaymentMethod, PricingOffer, ExecutionInfo, EscrowRequirement, FinalTerms, ViolationEvidence, JsonRpcRequest, RFQParams, QuoteParams, CounterParams, AcceptParams, RejectParams, DisputeParams } from '@ophirai/protocol';
+/**
+ * Build a signed RFQ (Request for Quote) message. Signs the RFQ with the buyer's Ed25519 key
+ * so that sellers can verify the buyer authorized this request.
+ *
+ * @throws {OphirError} if buyer identity fields are missing.
+ * @throws {OphirError} if secretKey is not 64 bytes.
+ *
+ * @example
+ * ```typescript
+ * const rfq = buildRFQ({
+ *   buyer: { agent_id: 'did:key:z6Mk...', endpoint: 'https://buyer.example.com' },
+ *   service: { category: 'inference' },
+ *   budget: { max_price_per_unit: '0.01', currency: 'USDC', unit: 'request' },
+ *   secretKey: keypair.secretKey,
+ * });
+ * ```
+ */
+export declare function buildRFQ(params: {
+    buyer: AgentIdentity;
+    service: ServiceRequirement;
+    budget: BudgetConstraint;
+    sla?: SLARequirement;
+    sellers?: string[];
+    maxRounds?: number;
+    ttlMs?: number;
+    acceptedPayments?: PaymentMethod[];
+    secretKey: Uint8Array;
+}): JsonRpcRequest<RFQParams>;
+/**
+ * Build a signed Quote response message. Signs the quote with the seller's Ed25519 key.
+ *
+ * @throws {OphirError} if rfqId or seller identity fields are missing.
+ *
+ * @example
+ * ```typescript
+ * const quote = buildQuote({
+ *   rfqId: 'a1b2c3d4-...',
+ *   seller: { agent_id: 'did:key:z6Mk...', endpoint: 'https://seller.example.com' },
+ *   pricing: { price_per_unit: '0.005', currency: 'USDC', unit: 'request', pricing_model: 'fixed' },
+ *   secretKey: keypair.secretKey,
+ * });
+ * ```
+ */
+export declare function buildQuote(params: {
+    rfqId: string;
+    seller: AgentIdentity;
+    pricing: PricingOffer;
+    sla?: SLARequirement;
+    execution?: ExecutionInfo;
+    escrow?: EscrowRequirement;
+    ttlMs?: number;
+    secretKey: Uint8Array;
+}): JsonRpcRequest<QuoteParams>;
+/**
+ * Build a signed counter-offer message. Signs with the sender's Ed25519 key.
+ *
+ * @throws {OphirError} if rfqId, inResponseTo, or from.agent_id are missing.
+ *
+ * @example
+ * ```typescript
+ * const counter = buildCounter({
+ *   rfqId: 'a1b2c3d4-...',
+ *   inResponseTo: 'e5f6g7h8-...',
+ *   round: 1,
+ *   from: { agent_id: 'did:key:z6Mk...', role: 'buyer' },
+ *   modifications: { price_per_unit: '0.008' },
+ *   secretKey: keypair.secretKey,
+ * });
+ * ```
+ */
+export declare function buildCounter(params: {
+    rfqId: string;
+    inResponseTo: string;
+    round: number;
+    from: {
+        agent_id: string;
+        role: 'buyer' | 'seller';
+    };
+    modifications: Record<string, unknown>;
+    justification?: string;
+    ttlMs?: number;
+    secretKey: Uint8Array;
+}): JsonRpcRequest<CounterParams>;
+/**
+ * Build an Accept message with agreement hash and buyer signature.
+ *
+ * Validates that finalTerms contains the required fields: price_per_unit, currency, and unit.
+ *
+ * @throws {OphirError} if rfqId, acceptingMessageId, or required finalTerms fields are missing.
+ *
+ * @example
+ * ```typescript
+ * const accept = buildAccept({
+ *   rfqId: 'a1b2c3d4-...',
+ *   acceptingMessageId: 'e5f6g7h8-...',
+ *   finalTerms: { price_per_unit: '0.01', currency: 'USDC', unit: 'request' },
+ *   buyerSecretKey: keypair.secretKey,
+ * });
+ * ```
+ */
+export declare function buildAccept(params: {
+    rfqId: string;
+    acceptingMessageId: string;
+    finalTerms: FinalTerms;
+    buyerSecretKey: Uint8Array;
+    sellerSignature?: string;
+}): JsonRpcRequest<AcceptParams>;
+/**
+ * Build a signed Reject message to decline a negotiation. Signs with the rejecting
+ * agent's Ed25519 key so that receivers can verify the rejection is authorized.
+ *
+ * @throws {OphirError} if rfqId, rejectingMessageId, reason, or agentId are empty.
+ * @throws {OphirError} if secretKey is not 64 bytes.
+ *
+ * @example
+ * ```typescript
+ * const reject = buildReject({
+ *   rfqId: 'a1b2c3d4-...',
+ *   rejectingMessageId: 'e5f6g7h8-...',
+ *   reason: 'Price too high',
+ *   agentId: 'did:key:z6Mk...',
+ *   secretKey: keypair.secretKey,
+ * });
+ * ```
+ */
+export declare function buildReject(params: {
+    rfqId: string;
+    rejectingMessageId: string;
+    reason: string;
+    agentId: string;
+    secretKey: Uint8Array;
+}): JsonRpcRequest<RejectParams>;
+/**
+ * Build a signed Dispute message with violation evidence.
+ *
+ * @throws {OphirError} if agreementId, filedBy.agent_id, requestedRemedy, or escrowAction are empty.
+ *
+ * @example
+ * ```typescript
+ * const dispute = buildDispute({
+ *   agreementId: 'a1b2c3d4-...',
+ *   filedBy: { agent_id: 'did:key:z6Mk...', role: 'buyer' },
+ *   violation: {
+ *     sla_metric: 'uptime_pct',
+ *     agreed_value: 99.9,
+ *     observed_value: 95.0,
+ *     measurement_window: '24h',
+ *     evidence_hash: 'abc123',
+ *   },
+ *   requestedRemedy: 'Full refund',
+ *   escrowAction: 'release_to_buyer',
+ *   secretKey: keypair.secretKey,
+ * });
+ * ```
+ */
+export declare function buildDispute(params: {
+    agreementId: string;
+    filedBy: {
+        agent_id: string;
+        role: 'buyer' | 'seller';
+    };
+    violation: ViolationEvidence;
+    requestedRemedy: string;
+    escrowAction: string;
+    lockstepReport?: {
+        verification_id: string;
+        result: 'PASS' | 'FAIL';
+        deviations: string[];
+    };
+    secretKey: Uint8Array;
+}): JsonRpcRequest<DisputeParams>;