@toon-protocol/core 1.2.0 → 1.4.0

package/dist/index.d.ts

@@ -84,6 +84,337 @@ declare const TEXT_TO_SPEECH_KIND = 5300;
  * Optional provider support -- not all nodes are required to handle this kind.
  */
 declare const TRANSLATION_KIND = 5302;
+/**
+ * Workflow Chain definition (kind 10040).
+ * Replaceable event defining a multi-step DVM pipeline where each step's
+ * output feeds into the next step's input. Uses a unique `d` tag per
+ * workflow instance for NIP-33 parameterized replaceable semantics.
+ * In the TOON-specific replaceable range (10032-10099).
+ */
+declare const WORKFLOW_CHAIN_KIND = 10040;
+/**
+ * Job Review (kind 31117)
+ * NIP-33 parameterized replaceable event for post-job reviews.
+ * `d` tag = job request event ID enforces one review per job per reviewer.
+ * Rating tag contains integer 1-5. Role tag indicates 'customer' or 'provider'.
+ */
+declare const JOB_REVIEW_KIND = 31117;
+/**
+ * Web of Trust declaration (kind 30382)
+ * NIP-33 parameterized replaceable event endorsing a provider pubkey.
+ * `d` tag = target provider pubkey enforces one WoT declaration per
+ * declarer per target. Used for reputation scoring sybil defense.
+ */
+declare const WEB_OF_TRUST_KIND = 30382;
+/**
+ * Prefix Claim (kind 10034)
+ * Replaceable event requesting a prefix claim from an upstream node.
+ * The content field contains a PrefixClaimContent JSON payload with the
+ * requested prefix string. Payment is carried in the ILP PREPARE packet.
+ */
+declare const PREFIX_CLAIM_KIND = 10034;
+/**
+ * Prefix Grant (kind 10037)
+ * Replaceable event confirming a prefix claim was accepted by the upstream node.
+ * Published by the upstream node after validating payment and prefix availability.
+ * Contains the granted prefix, claimer's pubkey, and derived ILP address.
+ */
+declare const PREFIX_GRANT_KIND = 10037;
+/**
+ * ILP root prefix for the TOON network.
+ * `g.` is the ILP global allocation prefix (standard ILP convention).
+ * `toon` is the TOON network identifier.
+ * The genesis node uses this directly -- it does not derive its address from a pubkey.
+ * All other nodes derive addresses as children of their upstream peer's prefix.
+ */
+/**
+ * Blob Storage DVM kind (kind 5094).
+ * Used for permanent blob storage requests (e.g., Arweave uploads).
+ * The blob data is base64-encoded in the `i` tag with type `blob`.
+ * Payment is carried in the ILP PREPARE packet (prepaid model).
+ */
+declare const BLOB_STORAGE_REQUEST_KIND = 5094;
+/**
+ * Blob Storage Result DVM kind (kind 6094).
+ * Reserved for informational result events. In the prepaid model,
+ * the Arweave tx ID is returned in the ILP FULFILL data field,
+ * NOT as a kind:6094 event.
+ */
+declare const BLOB_STORAGE_RESULT_KIND = 6094;
+/**
+ * Pet Interaction Request DVM kind (kind 5900).
+ * Used for pet interaction requests (feed, play, clean, etc.).
+ * Kind 5900 chosen to leave room for future DVM kinds in 5000-5899 range.
+ * Payment is carried in the ILP PREPARE packet (prepaid model).
+ */
+declare const PET_INTERACTION_REQUEST_KIND = 5900;
+/**
+ * Pet Interaction Result DVM kind (kind 6900).
+ * Result kind = request kind + 1000 per NIP-90 convention.
+ * In the prepaid model, the new pet state is returned in the ILP FULFILL
+ * data field as base64-encoded JSON.
+ */
+declare const PET_INTERACTION_RESULT_KIND = 6900;
+/**
+ * Pet Interaction Event kind (kind 14919).
+ * Optimistic interaction event published to relays after processing.
+ * Contains action details, stat changes, and brain hash.
+ * No proof or mina_tx tags -- those are added by the proof settlement
+ * pipeline after ZK proof generation.
+ */
+declare const PET_INTERACTION_EVENT_KIND = 14919;
+declare const ILP_ROOT_PREFIX = "g.toon";
+
+/**
+ * Shared ILP address validation utilities.
+ *
+ * Centralizes ILP address structure validation used by both
+ * `derive-child-address.ts` and `btp-prefix-exchange.ts`.
+ *
+ * @module
+ */
+/**
+ * Returns `true` if the string is a structurally valid ILP address
+ * (dot-separated, non-empty segments, valid characters only).
+ */
+declare function isValidIlpAddressStructure(address: string): boolean;
+/**
+ * Validates that a string is a valid ILP address. Throws a `ToonError`
+ * with code `ADDRESS_INVALID_PREFIX` on any structural violation.
+ *
+ * @throws {ToonError} With code `ADDRESS_INVALID_PREFIX` if the address
+ *   contains empty segments or invalid characters.
+ */
+declare function validateIlpAddress(address: string): void;
+
+/**
+ * Deterministic ILP address derivation from Nostr pubkeys.
+ *
+ * Derives a child ILP address by appending the first 8 hex characters
+ * of a Nostr pubkey as a new segment to a parent ILP address prefix.
+ *
+ * @module
+ */
+/**
+ * Derives a child ILP address by appending the first 8 hex characters of a
+ * Nostr pubkey as a new segment to a parent ILP address prefix.
+ *
+ * @param parentPrefix - The parent ILP address prefix (e.g., `g.toon` or `g.toon.ef567890`)
+ * @param childPubkey - The child's Nostr pubkey (hex string, at least 8 characters)
+ * @returns The derived child ILP address (e.g., `g.toon.abcd1234`)
+ *
+ * @throws {ToonError} With code `ADDRESS_INVALID_PREFIX` if `parentPrefix` is empty or
+ *   contains invalid ILP address characters.
+ * @throws {ToonError} With code `ADDRESS_INVALID_PUBKEY` if `childPubkey` is shorter than
+ *   8 hex characters or contains non-hex characters.
+ *
+ * @example
+ * ```ts
+ * deriveChildAddress('g.toon', 'abcd1234abcd1234...') // => 'g.toon.abcd1234'
+ * deriveChildAddress('g.toon.ef567890', '11aabb22...') // => 'g.toon.ef567890.11aabb22'
+ * ```
+ */
+declare function deriveChildAddress(parentPrefix: string, childPubkey: string): string;
+
+/**
+ * BTP handshake prefix exchange utilities.
+ *
+ * Provides extraction, building, and validation functions for the prefix
+ * data exchanged during BTP handshake. This module defines the structural
+ * type for prefix extension data but does NOT modify the BTP wire protocol
+ * (which lives in @toon-protocol/connector).
+ *
+ * @module
+ */
+/**
+ * Shape of prefix data in BTP handshake messages.
+ * Upstream peers include this in their handshake response so that
+ * connecting nodes can derive their own ILP address.
+ */
+interface BtpHandshakeExtension {
+    prefix: string;
+}
+/**
+ * Extracts and validates the prefix field from BTP handshake response data.
+ *
+ * Fail-closed behavior: throws if the prefix is absent, empty, or invalid.
+ * This is the critical safety contract -- nodes MUST NOT fall back to
+ * hardcoded addresses when the upstream peer omits the prefix.
+ *
+ * @param handshakeData - The handshake response data object
+ * @returns The validated prefix string
+ *
+ * @throws {ToonError} With code `ADDRESS_MISSING_PREFIX` if the `prefix` field
+ *   is absent or empty.
+ * @throws {ToonError} With code `ADDRESS_INVALID_PREFIX` if the prefix fails
+ *   ILP address validation.
+ */
+declare function extractPrefixFromHandshake(handshakeData: Record<string, unknown>): string;
+/**
+ * Constructs the prefix extension data that upstream peers include
+ * in their handshake response.
+ *
+ * Validates the address before building the handshake data to ensure
+ * upstream peers never send structurally invalid prefixes.
+ *
+ * @param ownIlpAddress - The upstream peer's own ILP address
+ * @returns The handshake extension data containing the prefix
+ *
+ * @throws {ToonError} With code `ADDRESS_INVALID_PREFIX` if the address
+ *   is not a valid ILP address.
+ */
+declare function buildPrefixHandshakeData(ownIlpAddress: string): BtpHandshakeExtension;
+/**
+ * Cross-validates the handshake prefix against the upstream peer's
+ * kind:10032 advertised address.
+ *
+ * When both values are available and they do not match, throws a
+ * ToonError indicating potential prefix spoofing. When the advertised
+ * prefix is undefined (kind:10032 not yet discovered), validation is
+ * deferred (no-op).
+ *
+ * @param handshakePrefix - The prefix received during BTP handshake
+ * @param advertisedPrefix - The upstream peer's kind:10032 advertised address (optional)
+ *
+ * @throws {ToonError} With code `ADDRESS_PREFIX_MISMATCH` if both values
+ *   are available and do not match.
+ */
+declare function validatePrefixConsistency(handshakePrefix: string, advertisedPrefix?: string): void;
+/**
+ * Checks whether a derived address collides with any known peer addresses.
+ *
+ * Safety net for the 8-char truncation collision case (exceedingly unlikely
+ * at < 9,292 peers, but the check exists per E7-R001).
+ *
+ * @param derivedAddress - The newly derived ILP address
+ * @param knownPeerAddresses - List of existing peer addresses to check against
+ *
+ * @throws {ToonError} With code `ADDRESS_COLLISION` if the derived address
+ *   already exists in the known peer list.
+ */
+declare function checkAddressCollision(derivedAddress: string, knownPeerAddresses: string[]): void;
+
+/**
+ * Address assignment orchestration layer.
+ *
+ * Combines BTP prefix extraction with deterministic address derivation
+ * to assign ILP addresses during the handshake process.
+ *
+ * @module
+ */
+/**
+ * Orchestrates address assignment from BTP handshake data:
+ * 1. Extracts and validates the prefix from handshake data
+ * 2. Derives the child address using `deriveChildAddress(prefix, ownPubkey)`
+ *
+ * @param handshakeData - The BTP handshake response data object
+ * @param ownPubkey - The connecting node's Nostr pubkey (hex string)
+ * @returns The derived ILP address
+ *
+ * @throws {ToonError} With code `ADDRESS_MISSING_PREFIX` if the handshake
+ *   data lacks a prefix field (fail-closed behavior).
+ * @throws {ToonError} With code `ADDRESS_INVALID_PREFIX` if the prefix is
+ *   not a valid ILP address.
+ * @throws {ToonError} With code `ADDRESS_INVALID_PUBKEY` if the pubkey is
+ *   shorter than 8 hex characters or contains non-hex characters.
+ */
+declare function assignAddressFromHandshake(handshakeData: Record<string, unknown>, ownPubkey: string): string;
+/**
+ * Determines whether a node configuration represents a genesis node.
+ *
+ * Genesis nodes use `ILP_ROOT_PREFIX` (`g.toon`) directly without
+ * derivation -- they are the root of the address hierarchy and do
+ * not need a handshake to learn their prefix.
+ *
+ * @param config - Node configuration with optional ilpAddress
+ * @returns `true` if the node's configured address equals `ILP_ROOT_PREFIX`
+ */
+declare function isGenesisNode(config: {
+    ilpAddress?: string;
+}): boolean;
+
+/**
+ * AddressRegistry tracks upstream prefix -> derived ILP address mappings.
+ *
+ * Used by multi-peered nodes to manage address lifecycle: when an upstream
+ * peer connects, the node derives and registers an address; when the peer
+ * disconnects, the address is removed and kind:10032 republished.
+ *
+ * Addresses are returned in insertion order so that the primary address
+ * (first inserted) is stable across lifecycle events.
+ *
+ * @module
+ */
+/**
+ * Tracks the mapping from upstream ILP prefix to derived ILP address.
+ *
+ * Uses a `Map<string, string>` internally, which preserves insertion order
+ * per the ECMAScript specification.
+ */
+declare class AddressRegistry {
+    private readonly prefixToAddress;
+    /**
+     * Registers a new upstream prefix -> derived address mapping.
+     *
+     * @param upstreamPrefix - The upstream peer's ILP address prefix
+     * @param derivedAddress - The derived ILP address for this node under that prefix
+     */
+    addAddress(upstreamPrefix: string, derivedAddress: string): void;
+    /**
+     * Removes the mapping for the given upstream prefix.
+     *
+     * @param upstreamPrefix - The upstream prefix to remove
+     * @returns The removed derived address, or `undefined` if the prefix was not found
+     */
+    removeAddress(upstreamPrefix: string): string | undefined;
+    /**
+     * Returns all derived addresses in insertion order.
+     */
+    getAddresses(): string[];
+    /**
+     * Returns `true` if the given upstream prefix is registered.
+     */
+    hasPrefix(upstreamPrefix: string): boolean;
+    /**
+     * Returns the number of registered addresses.
+     */
+    get size(): number;
+    /**
+     * Returns the primary (first inserted) address.
+     *
+     * @returns The first address, or `undefined` if the registry is empty
+     */
+    getPrimaryAddress(): string | undefined;
+}
+
+/**
+ * Prefix validation utility for the TOON prefix claim marketplace.
+ *
+ * Validates requested prefix strings against naming rules:
+ * lowercase alphanumeric only, length constraints, no reserved words.
+ */
+/**
+ * Result of prefix validation.
+ */
+interface PrefixValidationResult {
+    /** Whether the prefix is valid. */
+    valid: boolean;
+    /** Reason for rejection (only present when valid is false). */
+    reason?: string;
+}
+/**
+ * Validates a prefix string for use in the prefix claim marketplace.
+ *
+ * Rules:
+ * - Lowercase alphanumeric only (`[a-z0-9]`)
+ * - Minimum 2 characters
+ * - Maximum 16 characters
+ * - No reserved words (`toon`, `ilp`, `local`, `peer`, `test`)
+ *
+ * @param prefix - The prefix string to validate
+ * @returns Validation result with valid flag and optional reason
+ */
+declare function validatePrefix(prefix: string): PrefixValidationResult;
 
 /**
  * TypeScript interfaces for ILP-related Nostr events.
@@ -97,6 +428,8 @@ interface IlpPeerInfo {
     pubkey?: string;
     /** ILP address of the peer's connector (e.g., "g.example.connector") */
     ilpAddress: string;
+    /** All ILP addresses of this peer (one per upstream peering). When absent (pre-Epic-7 events), consumers should default to [ilpAddress]. */
+    ilpAddresses?: string[];
     /** BTP WebSocket endpoint URL for packet exchange */
     btpEndpoint: string;
     /** Optional BLS HTTP endpoint for direct packet delivery (bootstrap only) */
@@ -115,6 +448,12 @@ interface IlpPeerInfo {
     preferredTokens?: Record<string, string>;
     /** Maps chain identifier to TokenNetwork contract address (EVM-specific) */
     tokenNetworks?: Record<string, string>;
+    /** Routing fee per byte charged by this node as an intermediary, serialized as a non-negative integer string (e.g., '2'). Defaults to '0' (free routing) when absent. */
+    feePerByte?: string;
+    /** Prefix pricing for prefix claim marketplace. basePrice is in USDC micro-units as a non-negative integer string. */
+    prefixPricing?: {
+        basePrice: string;
+    };
 }
 /**
  * Subscription handle for real-time event updates.
@@ -221,9 +560,17 @@ declare function parseIlpPeerInfo(event: NostrEvent): IlpPeerInfo;
 /**
  * Builds and signs a kind:10032 Nostr event from IlpPeerInfo data.
  *
+ * When `ilpAddresses` is present, validates that the array is non-empty and
+ * that all elements are structurally valid ILP addresses. Normalizes
+ * `ilpAddress` (singular) to equal `ilpAddresses[0]` for backward compatibility.
+ *
  * @param info - The ILP peer info to serialize into the event
  * @param secretKey - The secret key to sign the event with
  * @returns A signed Nostr event
+ *
+ * @throws {ToonError} With code `INVALID_FEE` if `feePerByte` is not a non-negative integer string
+ * @throws {ToonError} With code `ADDRESS_EMPTY_ADDRESSES` if `ilpAddresses` is an empty array
+ * @throws {ToonError} With code `ADDRESS_INVALID_PREFIX` if any element of `ilpAddresses` is invalid
  */
 declare function buildIlpPeerInfoEvent(info: IlpPeerInfo, secretKey: Uint8Array): NostrEvent;
 
@@ -271,6 +618,184 @@ declare function buildSeedRelayListEvent(secretKey: Uint8Array, entries: SeedRel
  */
 declare function parseSeedRelayList(event: NostrEvent): SeedRelayEntry[];
 
+/**
+ * Event builders, parsers, and reputation scoring for DVM reputation system.
+ *
+ * Defines two new event kinds:
+ * - Kind 31117 (Job Review): NIP-33 parameterized replaceable event for
+ *   post-job reviews with integer 1-5 ratings.
+ * - Kind 30382 (Web of Trust): NIP-33 parameterized replaceable event for
+ *   endorsing provider pubkeys.
+ *
+ * Also provides:
+ * - `ReputationScoreCalculator`: Pure logic class computing composite
+ *   reputation scores from pre-gathered signals.
+ * - `hasMinReputation()`: Utility for extracting `min_reputation` parameter
+ *   from parsed job request params.
+ */
+
+/** Parameters for building a Kind 31117 Job Review event. */
+interface JobReviewParams {
+    /** 64-char hex event ID of the original Kind 5xxx job request. */
+    jobRequestEventId: string;
+    /** 64-char hex pubkey of the target provider being reviewed. */
+    targetPubkey: string;
+    /** Integer rating 1-5. */
+    rating: number;
+    /** Role of the reviewer: 'customer' or 'provider'. */
+    role: 'customer' | 'provider';
+    /** Optional text review content. */
+    content?: string;
+}
+/** Parsed result from a Kind 31117 Job Review event. */
+interface ParsedJobReview {
+    /** Job request event ID from the `d` tag. */
+    jobRequestEventId: string;
+    /** Target provider pubkey from the `p` tag. */
+    targetPubkey: string;
+    /** Integer rating 1-5. */
+    rating: number;
+    /** Role of the reviewer. */
+    role: 'customer' | 'provider';
+    /** Review text content. */
+    content: string;
+}
+/** Parameters for building a Kind 30382 Web of Trust declaration event. */
+interface WotDeclarationParams {
+    /** 64-char hex pubkey of the target provider being endorsed. */
+    targetPubkey: string;
+    /** Optional endorsement reason. */
+    content?: string;
+}
+/** Parsed result from a Kind 30382 Web of Trust declaration event. */
+interface ParsedWotDeclaration {
+    /** Target provider pubkey from the `p` tag. */
+    targetPubkey: string;
+    /** Declarer pubkey from the event's pubkey field. */
+    declarerPubkey: string;
+    /** Endorsement content. */
+    content: string;
+}
+/** Individual reputation signal values. */
+interface ReputationSignals {
+    /** Count of WoT declarations from non-zero-volume declarers. */
+    trustedBy: number;
+    /** Total USDC settled through the provider's payment channels. */
+    channelVolumeUsdc: number;
+    /** Count of Kind 6xxx result events published by the provider. */
+    jobsCompleted: number;
+    /** Mean rating from verified customer reviews (0 when no reviews). */
+    avgRating: number;
+}
+/** Composite reputation score with individual signal values. */
+interface ReputationScore {
+    /** The composite reputation score. */
+    score: number;
+    /** Individual signal values used to compute the score. */
+    signals: ReputationSignals;
+}
+/**
+ * Builds a Kind 31117 Job Review event (NIP-33 parameterized replaceable).
+ *
+ * The `d` tag = job request event ID enforces one review per job per reviewer.
+ * Tags: `d` (job request ID), `p` (target pubkey), `rating`, `role`.
+ *
+ * @param params - The job review parameters.
+ * @param secretKey - The secret key to sign the event with.
+ * @returns A signed Nostr event.
+ * @throws ToonError for invalid inputs.
+ */
+declare function buildJobReviewEvent(params: JobReviewParams, secretKey: Uint8Array): NostrEvent;
+/**
+ * Parses a Kind 31117 event into a ParsedJobReview.
+ *
+ * Returns `null` for malformed events (wrong kind, missing tags, invalid rating).
+ *
+ * @param event - The Nostr event to parse.
+ * @returns The parsed job review, or null if invalid.
+ */
+declare function parseJobReview(event: NostrEvent): ParsedJobReview | null;
+/**
+ * Builds a Kind 30382 Web of Trust declaration event (NIP-33 parameterized replaceable).
+ *
+ * The `d` tag = target pubkey enforces one WoT declaration per declarer per target.
+ *
+ * @param params - The WoT declaration parameters.
+ * @param secretKey - The secret key to sign the event with.
+ * @returns A signed Nostr event.
+ * @throws ToonError for invalid inputs.
+ */
+declare function buildWotDeclarationEvent(params: WotDeclarationParams, secretKey: Uint8Array): NostrEvent;
+/**
+ * Parses a Kind 30382 event into a ParsedWotDeclaration.
+ *
+ * Returns `null` for malformed events (wrong kind, missing tags,
+ * d tag not matching p tag).
+ *
+ * @param event - The Nostr event to parse.
+ * @returns The parsed WoT declaration, or null if invalid.
+ */
+declare function parseWotDeclaration(event: NostrEvent): ParsedWotDeclaration | null;
+/**
+ * Pure logic class for computing composite reputation scores.
+ *
+ * Receives pre-computed signals (WoT declarations, reviews, channel volume,
+ * job count) and calculates the composite score. Does NOT perform relay
+ * queries or on-chain reads. The caller is responsible for gathering signals.
+ *
+ * Formula: score = (trusted_by x 100) + (log10(max(1, channel_volume_usdc)) x 10)
+ *                + (jobs_completed x 5) + (avg_rating x 20)
+ */
+declare class ReputationScoreCalculator {
+    /**
+     * Computes the composite reputation score from pre-computed signals.
+     *
+     * @param signals - The individual signal values.
+     * @returns The composite score with individual signals.
+     */
+    calculateScore(signals: ReputationSignals): ReputationScore;
+    /**
+     * Computes the threshold-filtered trusted_by count from WoT declarations.
+     *
+     * Declarers with non-zero channel volume contribute 1 to the count.
+     * Declarers with zero channel volume contribute 0 (sybil defense).
+     *
+     * @param wotDeclarations - Parsed WoT declarations targeting the provider.
+     * @param getChannelVolume - Callback to look up a declarer's channel volume.
+     * @returns The count of WoT declarations from non-zero-volume declarers.
+     */
+    computeTrustedBy(wotDeclarations: ParsedWotDeclaration[], getChannelVolume: (pubkey: string) => number): number;
+    /**
+     * Computes the average rating from verified customer reviews only.
+     *
+     * Reviews are provided as tuples of `{ review, reviewerPubkey }` so the
+     * calculator can filter by the verified customer set. Reviews from pubkeys
+     * NOT in `verifiedCustomerPubkeys` are excluded entirely (customer-gate
+     * sybil defense per E6-R013).
+     *
+     * @param reviews - Parsed job reviews with reviewer pubkeys.
+     * @param verifiedCustomerPubkeys - Set of pubkeys that authored Kind 5xxx requests.
+     * @returns The mean rating from verified reviews, or 0 when no verified reviews exist.
+     */
+    computeAvgRating(reviews: {
+        review: ParsedJobReview;
+        reviewerPubkey: string;
+    }[], verifiedCustomerPubkeys: Set<string>): number;
+}
+/**
+ * Extracts the `min_reputation` parameter value from parsed job request params.
+ *
+ * Follows the same pattern as `hasRequireAttestation()`.
+ *
+ * @param params - The params array from a parsed job request.
+ * @returns The numeric threshold value, null if not present, or throws on invalid value.
+ * @throws ToonError with code REPUTATION_INVALID_MIN_REPUTATION if value is non-numeric.
+ */
+declare function hasMinReputation(params: {
+    key: string;
+    value: string;
+}[]): number | null;
+
 /**
  * Event builder and parser for kind:10035 Service Discovery events.
  *
@@ -312,6 +837,8 @@ interface SkillDescriptor {
     models?: string[];
     /** Placeholder for Epic 6 TEE attestation integration. */
     attestation?: Record<string, unknown>;
+    /** Composite reputation score with individual signal values (Story 6.4). */
+    reputation?: ReputationScore;
 }
 /** Content payload for a kind:10035 Service Discovery event. */
 interface ServiceDiscoveryContent {
@@ -547,6 +1074,8 @@ interface JobResultParams {
     amount: string;
     /** Result data (text, URL, etc.). */
     content: string;
+    /** Optional 64-char hex event ID of the provider's latest kind:10033 attestation event. */
+    attestationEventId?: string;
 }
 /**
  * Parameters for building a Kind 7000 DVM job feedback event.
@@ -611,6 +1140,8 @@ interface ParsedJobResult {
     amount: string;
     /** Result data from the content field. */
     content: string;
+    /** Optional event ID of the provider's kind:10033 attestation event. */
+    attestationEventId?: string;
 }
 /**
  * Parsed result from a Kind 7000 DVM job feedback event.
@@ -688,6 +1219,12 @@ declare function parseJobRequest(event: NostrEvent): ParsedJobRequest | null;
  * NIP-90 tags: `e` (request event ID), `p` (customer pubkey), and `amount`
  * (compute cost + currency).
  *
+ * The `amount` tag is **informational** (a receipt of the agreed price).
+ * In the prepaid protocol model, payment is sent with the job request
+ * (via `publishEvent()` with the `amount` option), NOT triggered by
+ * parsing the result event's amount tag. The amount tag serves as a
+ * record of what was agreed upon, not as a payment trigger.
+ *
  * Returns `null` for malformed events. Follows the lenient parse pattern.
  *
  * @param event - The Nostr event to parse.
@@ -702,13 +1239,529 @@ declare function parseJobResult(event: NostrEvent): ParsedJobResult | null;
  * (job state). The status value must be one of: `'processing'`, `'error'`,
  * `'success'`, `'partial'`.
  *
- * Returns `null` for malformed events or invalid status values.
- * Follows the lenient parse pattern.
+ * Returns `null` for malformed events or invalid status values.
+ * Follows the lenient parse pattern.
+ *
+ * @param event - The Nostr event to parse.
+ * @returns The parsed job feedback, or null if invalid.
+ */
+declare function parseJobFeedback(event: NostrEvent): ParsedJobFeedback | null;
+
+/**
+ * Event builder and parser for Workflow Chain events (kind:10040).
+ *
+ * Workflow chains define multi-step DVM pipelines where each step's output
+ * automatically feeds into the next step's input. The workflow definition
+ * event contains an ordered list of steps, initial input, and a total bid
+ * that is split across steps.
+ *
+ * Kind:10040 is in the TOON-specific replaceable range (10032-10099).
+ * Each workflow instance uses a unique `d` tag to avoid unintentional
+ * replacement of in-progress workflows.
+ *
+ * Tag reference (kind:10040):
+ *   Content: JSON-serialized workflow definition body
+ *   Required: ['d', uniqueWorkflowId], ['bid', totalBid, 'usdc']
+ *   Content JSON: { steps: WorkflowStep[], initialInput: { data, type }, totalBid }
+ */
+
+/**
+ * A single step in a workflow chain.
+ *
+ * Each step specifies a DVM kind (5000-5999) and a description.
+ * Optionally, a step can target a specific provider and allocate
+ * an explicit portion of the total bid.
+ */
+interface WorkflowStep {
+    /** DVM job request kind (5000-5999 range). */
+    kind: number;
+    /** Human-readable description of the step's purpose. */
+    description: string;
+    /** Optional 64-char hex pubkey of a specific target provider. */
+    targetProvider?: string;
+    /** Optional explicit bid allocation in USDC micro-units as string. */
+    bidAllocation?: string;
+}
+/**
+ * Parameters for building a kind:10040 Workflow Chain event.
+ */
+interface WorkflowDefinitionParams {
+    /** Ordered list of workflow steps (at least one required). */
+    steps: WorkflowStep[];
+    /** Initial input for the first step. */
+    initialInput: {
+        /** The input data (text, JSON, etc.). */
+        data: string;
+        /** Input type identifier (e.g., 'text', 'json'). */
+        type: string;
+    };
+    /** Total bid for the entire workflow in USDC micro-units as string. */
+    totalBid: string;
+    /** Optional body text for the event content field. */
+    content?: string;
+    /** Optional workflow ID for deterministic `d` tag (defaults to timestamp-based). */
+    workflowId?: string;
+}
+/**
+ * Parsed result from a kind:10040 Workflow Chain event.
+ */
+interface ParsedWorkflowDefinition {
+    /** Ordered list of workflow steps. */
+    steps: WorkflowStep[];
+    /** Initial input for the first step. */
+    initialInput: {
+        /** The input data. */
+        data: string;
+        /** Input type identifier. */
+        type: string;
+    };
+    /** Total bid for the entire workflow in USDC micro-units as string. */
+    totalBid: string;
+    /** Event content field (JSON-serialized workflow body). */
+    content: string;
+}
+/**
+ * Builds a kind:10040 Workflow Chain event.
+ *
+ * Validates steps, initial input, total bid, and per-step bid allocations
+ * (if provided). Serializes the workflow definition as JSON content.
+ *
+ * @param params - The workflow definition parameters.
+ * @param secretKey - The secret key to sign the event with.
+ * @returns A signed Nostr event.
+ * @throws ToonError if validation fails.
+ */
+declare function buildWorkflowDefinitionEvent(params: WorkflowDefinitionParams, secretKey: Uint8Array): NostrEvent;
+/**
+ * Parses a kind:10040 event into a ParsedWorkflowDefinition.
+ *
+ * Validates the event kind, parses JSON content, validates the steps
+ * array, initialInput, and totalBid. Returns `null` for malformed events.
+ *
+ * @param event - The Nostr event to parse.
+ * @returns The parsed workflow definition, or null if invalid.
+ */
+declare function parseWorkflowDefinition(event: NostrEvent): ParsedWorkflowDefinition | null;
+
+/**
+ * Event builders and parsers for DVM Agent Swarm events (Story 6.2).
+ *
+ * Swarm events extend NIP-90 DVM events with competitive bidding tags:
+ * - `['swarm', maxProviders]` -- maximum number of providers in the swarm
+ * - `['judge', judgeIdentifier]` -- who selects the winner (default: 'customer')
+ *
+ * Swarm request events are standard Kind 5xxx events with additional tags.
+ * Non-swarm-aware providers can still participate via the standard Kind 5xxx path.
+ *
+ * Selection events are Kind 7000 feedback events with a `winner` tag
+ * referencing the winning Kind 6xxx result event ID.
+ *
+ * Tag reference (swarm-specific additions):
+ *
+ * Kind 5xxx (Swarm Job Request):
+ *   Standard NIP-90 tags + ['swarm', maxProviders], ['judge', judgeId]
+ *
+ * Kind 7000 (Swarm Selection):
+ *   Standard NIP-90 feedback tags + ['winner', winnerResultEventId]
+ */
+
+/**
+ * Parameters for building a swarm request event (Kind 5xxx with swarm tags).
+ *
+ * Extends `JobRequestParams` with swarm-specific fields:
+ * - `maxProviders`: Maximum number of providers in the competitive swarm (>= 1).
+ * - `judge`: Who selects the winner (default: 'customer'). Can be 'customer',
+ *   'auto', or a specific pubkey.
+ */
+interface SwarmRequestParams extends JobRequestParams {
+    /** Maximum number of providers to collect submissions from (>= 1). */
+    maxProviders: number;
+    /** Who selects the winner (default: 'customer'). */
+    judge?: string;
+}
+/**
+ * Parameters for building a swarm selection event (Kind 7000 with winner tag).
+ */
+interface SwarmSelectionParams {
+    /** 64-char hex event ID of the original swarm request. */
+    swarmRequestEventId: string;
+    /** 64-char hex event ID of the winning Kind 6xxx result. */
+    winnerResultEventId: string;
+    /** 64-char hex pubkey of the customer who posted the swarm request. */
+    customerPubkey: string;
+}
+/**
+ * Parsed result from a Kind 5xxx swarm request event.
+ * Extends `ParsedJobRequest` with swarm-specific fields.
+ */
+interface ParsedSwarmRequest extends ParsedJobRequest {
+    /** Maximum number of providers in the swarm. */
+    maxProviders: number;
+    /** Who selects the winner. */
+    judge: string;
+}
+/**
+ * Parsed result from a Kind 7000 swarm selection event.
+ */
+interface ParsedSwarmSelection {
+    /** Event ID of the original swarm request. */
+    swarmRequestEventId: string;
+    /** Event ID of the winning Kind 6xxx result. */
+    winnerResultEventId: string;
+}
+/**
+ * Builds a Kind 5xxx swarm request event.
+ *
+ * Delegates to `buildJobRequestEvent()` for the base NIP-90 event, then
+ * appends swarm-specific tags: `swarm` (max providers) and `judge` (selector).
+ *
+ * The resulting event is a valid Kind 5xxx event that non-swarm-aware
+ * providers can also parse via `parseJobRequest()`.
+ *
+ * @param params - The swarm request parameters.
+ * @param secretKey - The secret key to sign the event with.
+ * @returns A signed Nostr event.
+ * @throws ToonError if maxProviders < 1 or base params are invalid.
+ */
+declare function buildSwarmRequestEvent(params: SwarmRequestParams, secretKey: Uint8Array): NostrEvent;
+/**
+ * Builds a Kind 7000 swarm selection event.
+ *
+ * Creates a feedback event with `status: 'success'`, an `e` tag referencing
+ * the swarm request, and a `winner` tag referencing the winning result.
+ *
+ * @param params - The swarm selection parameters.
+ * @param secretKey - The secret key to sign the event with.
+ * @returns A signed Nostr event.
+ * @throws ToonError if event IDs or pubkey are not valid 64-char hex.
+ */
+declare function buildSwarmSelectionEvent(params: SwarmSelectionParams, secretKey: Uint8Array): NostrEvent;
+/**
+ * Parses a Kind 5xxx event into a ParsedSwarmRequest.
+ *
+ * Delegates to `parseJobRequest()` for base fields, then extracts the
+ * `swarm` and `judge` tags. Returns `null` if the event is not a valid
+ * swarm request (missing `swarm` tag, invalid kind range, etc.).
+ *
+ * @param event - The Nostr event to parse.
+ * @returns The parsed swarm request, or null if invalid/not a swarm request.
+ */
+declare function parseSwarmRequest(event: NostrEvent): ParsedSwarmRequest | null;
+/**
+ * Parses a Kind 7000 event into a ParsedSwarmSelection.
+ *
+ * Validates the event kind is exactly 7000 and extracts the `winner` tag
+ * and `e` tag (swarm request reference). Returns `null` if the event is
+ * not a valid swarm selection (missing `winner` tag, wrong kind, etc.).
+ *
+ * @param event - The Nostr event to parse.
+ * @returns The parsed swarm selection, or null if invalid.
+ */
+declare function parseSwarmSelection(event: NostrEvent): ParsedSwarmSelection | null;
+
+/**
+ * Event builders and parsers for prefix claim (kind 10034) and
+ * prefix grant (kind 10037) events.
+ *
+ * Prefix claims are part of the TOON prefix marketplace: a node sends a
+ * kind 10034 event with payment to claim a prefix from an upstream peer.
+ * The upstream responds with a kind 10037 grant confirmation.
+ */
+
+/** Content payload for a kind 10034 prefix claim event. */
+interface PrefixClaimContent {
+    /** The prefix string being requested (e.g., 'useast'). */
+    requestedPrefix: string;
+}
+/** Content payload for a kind 10037 prefix grant event. */
+interface PrefixGrantContent {
+    /** The prefix that was granted. */
+    grantedPrefix: string;
+    /** Pubkey of the node that received the prefix. */
+    claimerPubkey: string;
+    /** The ILP address derived from the granted prefix. */
+    ilpAddress: string;
+}
+/**
+ * Builds and signs a kind 10034 prefix claim event.
+ *
+ * @param content - The prefix claim content with the requested prefix
+ * @param secretKey - The 32-byte secret key to sign the event with
+ * @returns A signed Nostr event of kind 10034
+ */
+declare function buildPrefixClaimEvent(content: PrefixClaimContent, secretKey: Uint8Array): NostrEvent;
+/**
+ * Parses a kind 10034 prefix claim event into PrefixClaimContent.
+ *
+ * Returns null for malformed events. Follows the lenient parse pattern.
+ *
+ * @param event - The Nostr event to parse
+ * @returns The parsed prefix claim content, or null if invalid
+ */
+declare function parsePrefixClaimEvent(event: NostrEvent): PrefixClaimContent | null;
+/**
+ * Builds and signs a kind 10037 prefix grant event.
+ *
+ * @param content - The prefix grant content with granted prefix details
+ * @param secretKey - The 32-byte secret key to sign the event with
+ * @returns A signed Nostr event of kind 10037
+ */
+declare function buildPrefixGrantEvent(content: PrefixGrantContent, secretKey: Uint8Array): NostrEvent;
+/**
+ * Parses a kind 10037 prefix grant event into PrefixGrantContent.
+ *
+ * Returns null for malformed events. Follows the lenient parse pattern.
+ *
+ * @param event - The Nostr event to parse
+ * @returns The parsed prefix grant content, or null if invalid
+ */
+declare function parsePrefixGrantEvent(event: NostrEvent): PrefixGrantContent | null;
+
+/**
+ * AttestationVerifier -- TEE attestation verification, state lifecycle,
+ * and attestation-aware peer ranking for Story 4.3.
+ *
+ * This is a pure logic class with no transport layer. It receives parsed
+ * attestation data and returns verification results. The transport layer
+ * (subscribing to kind:10033 events on relays) is a Story 4.6 concern.
+ *
+ * The AttestationVerifier is the single source of truth for attestation
+ * state (R-E4-008). Both the kind:10033 Nostr event path and the /health
+ * HTTP endpoint derive their TEE state from the same verifier instance.
+ *
+ * Attestation State Machine (Decision 12):
+ *   VALID (within validitySeconds)
+ *     -> STALE (within graceSeconds after validity expires)
+ *       -> UNATTESTED (after grace period expires)
+ *
+ * Trust degrades; money doesn't -- attestation state changes never
+ * trigger payment channel closure.
+ */
+
+/**
+ * Attestation lifecycle state.
+ *
+ * Transitions: VALID -> STALE -> UNATTESTED.
+ * A peer that was never attested starts as UNATTESTED.
+ */
+declare enum AttestationState {
+    /** Attestation is within validity period. */
+    VALID = "valid",
+    /** Attestation has expired but is within the grace period. */
+    STALE = "stale",
+    /** Attestation has expired past the grace period or was never attested. */
+    UNATTESTED = "unattested"
+}
+/** Result of PCR verification against a known-good registry. */
+interface VerificationResult {
+    valid: boolean;
+    reason?: string;
+}
+/**
+ * Descriptor for a peer in the attestation-aware ranking system.
+ * Used by `rankPeers()` to order peers by attestation status.
+ */
+interface PeerDescriptor {
+    pubkey: string;
+    relayUrl: string;
+    attested: boolean;
+    attestationTimestamp?: number;
+}
+/**
+ * Configuration for the AttestationVerifier.
+ */
+interface AttestationVerifierConfig {
+    /** Map of known-good PCR values. Key is PCR hash, value is trust status. */
+    knownGoodPcrs: Map<string, boolean>;
+    /** Attestation validity period in seconds (default: 300). */
+    validitySeconds?: number;
+    /** Grace period in seconds after validity expires before marking as unattested (default: 30). */
+    graceSeconds?: number;
+}
+/**
+ * Verifies TEE attestations, computes attestation lifecycle state,
+ * and ranks peers by attestation status.
+ *
+ * Single source of truth for attestation state (R-E4-008).
+ */
+declare class AttestationVerifier {
+    private readonly knownGoodPcrs;
+    private readonly validitySeconds;
+    private readonly graceSeconds;
+    constructor(config: AttestationVerifierConfig);
+    /**
+     * Verifies a TEE attestation's PCR values against the known-good registry.
+     *
+     * All three PCR values (pcr0, pcr1, pcr2) must be present and truthy in
+     * the registry for verification to pass.
+     *
+     * @param attestation - The TEE attestation to verify.
+     * @returns Verification result with `valid: true` or `valid: false` with reason.
+     */
+    verify(attestation: TeeAttestation): VerificationResult;
+    /**
+     * Computes the attestation lifecycle state based on timing.
+     *
+     * Boundary behavior:
+     * - At exactly `attestedAt + validitySeconds`: VALID (inclusive <=)
+     * - At exactly `attestedAt + validitySeconds + graceSeconds`: STALE (inclusive <=)
+     * - After grace expires: UNATTESTED
+     *
+     * @param _attestation - The TEE attestation (unused, reserved for future per-attestation logic).
+     * @param attestedAt - Unix timestamp when the attestation was created.
+     * @param now - Optional current unix timestamp (defaults to real clock).
+     * @returns The current attestation state.
+     */
+    getAttestationState(_attestation: TeeAttestation, attestedAt: number, now?: number): AttestationState;
+    /**
+     * Ranks peers by attestation status: attested peers first, then non-attested.
+     *
+     * Preserves relative order within each group (stable sort via filter).
+     * Does NOT mutate the input array -- returns a new sorted array.
+     *
+     * Attestation is a preference, not a requirement. Non-attested peers
+     * remain in the result and are connectable.
+     *
+     * @param peers - Array of peer descriptors to rank.
+     * @returns New array with attested peers first, preserving relative order.
+     */
+    rankPeers(peers: PeerDescriptor[]): PeerDescriptor[];
+}
+
+/**
+ * Customer-side attestation result verifier for TEE-attested DVM results.
+ *
+ * Verifies that a Kind 6xxx DVM result was computed in a valid TEE enclave
+ * by checking the referenced kind:10033 attestation event. Three checks:
+ * 1. Pubkey match: kind:10033 author === Kind 6xxx author (same provider)
+ * 2. PCR validity: PCR values pass AttestationVerifier.verify()
+ * 3. Time validity: attestation was VALID at result creation time
+ *
+ * This is a pure logic class with no transport concerns. The caller is
+ * responsible for fetching the attestation event from the relay.
+ */
+
+/** Configuration for constructing an AttestedResultVerifier. */
+interface AttestedResultVerificationOptions {
+    /** The AttestationVerifier instance for PCR and state checks. */
+    attestationVerifier: AttestationVerifier;
+}
+/** Result of verifying an attested DVM result. */
+interface AttestedResultVerificationResult {
+    /** Whether the attestation verification passed all checks. */
+    valid: boolean;
+    /** Reason for failure (undefined when valid). */
+    reason?: string;
+    /** Attestation lifecycle state (undefined when verification fails before state check). */
+    attestationState?: AttestationState;
+}
+/**
+ * Verifies TEE attestation on Kind 6xxx DVM result events.
+ *
+ * Follows the same pure-logic pattern as AttestationVerifier (Story 4.3).
+ * Time injection is NOT at construction -- `resultEvent.created_at` is
+ * used as the `now` parameter at call site.
+ */
+declare class AttestedResultVerifier {
+    private readonly attestationVerifier;
+    constructor(options: AttestedResultVerificationOptions);
+    /**
+     * Verifies that a Kind 6xxx result was computed in a valid TEE enclave.
+     *
+     * Performs three checks:
+     * (a) Pubkey match: attestationEvent.pubkey === resultEvent.pubkey
+     * (b) PCR validity: AttestationVerifier.verify(parsedAttestation.attestation)
+     * (c) Time validity: attestation was VALID at resultEvent.created_at
+     *
+     * @param resultEvent - The Kind 6xxx result Nostr event.
+     * @param _parsedResult - The parsed job result (reserved for future use).
+     * @param attestationEvent - The kind:10033 attestation Nostr event.
+     * @param parsedAttestation - The parsed attestation data.
+     * @returns Verification result with valid flag, reason, and attestation state.
+     */
+    verifyAttestedResult(resultEvent: NostrEvent, _parsedResult: ParsedJobResult, attestationEvent: NostrEvent, parsedAttestation: ParsedAttestation): AttestedResultVerificationResult;
+}
+/**
+ * Checks whether a parsed job request's params include `require_attestation=true`.
+ *
+ * @param params - The params array from a parsed job request.
+ * @returns true if `require_attestation` is set to `'true'`.
+ */
+declare function hasRequireAttestation(params: {
+    key: string;
+    value: string;
+}[]): boolean;
+
+/**
+ * Event builders and parsers for kind:5094 Blob Storage DVM requests.
+ *
+ * Kind 5094 is a NIP-90 DVM job request for permanent blob storage (Arweave).
+ * The blob data is base64-encoded in the `i` tag with type `blob`.
+ * Payment is carried in the ILP PREPARE packet (prepaid model, D7-001).
+ *
+ * Tag layout:
+ *   Required: ['i', base64Blob, 'blob'], ['bid', amount, 'usdc'], ['output', contentType]
+ *   Optional: ['param', 'uploadId', uuid], ['param', 'chunkIndex', idx],
+ *             ['param', 'totalChunks', total], ['param', 'contentType', type]
+ */
+
+/**
+ * Parameters for building a kind:5094 Blob Storage DVM request event.
+ */
+interface BlobStorageRequestParams {
+    /** The raw blob data to store. */
+    blobData: Buffer;
+    /** MIME type of the blob (default: 'application/octet-stream'). */
+    contentType?: string;
+    /** Bid amount in USDC micro-units as string (bigint-compatible). */
+    bid: string;
+    /** Optional key-value parameters (e.g., uploadId, chunkIndex, totalChunks). */
+    params?: {
+        key: string;
+        value: string;
+    }[];
+}
+/**
+ * Parsed result from a kind:5094 Blob Storage DVM request event.
+ */
+interface ParsedBlobStorageRequest {
+    /** The decoded blob data. */
+    blobData: Buffer;
+    /** MIME type of the blob. */
+    contentType: string;
+    /** Upload ID for chunked uploads. */
+    uploadId?: string;
+    /** Chunk index for chunked uploads. */
+    chunkIndex?: number;
+    /** Total number of chunks for chunked uploads. */
+    totalChunks?: number;
+}
+/**
+ * Builds a kind:5094 Blob Storage DVM request event.
+ *
+ * Constructs a signed Nostr event with the blob base64-encoded in the `i` tag,
+ * a `bid` tag for payment declaration, and an `output` tag for content type.
+ *
+ * @param params - The blob storage request parameters.
+ * @param secretKey - The secret key to sign the event with.
+ * @returns A signed Nostr event.
+ * @throws ToonError if required params are missing.
+ */
+declare function buildBlobStorageRequest(params: BlobStorageRequestParams, secretKey: Uint8Array): NostrEvent;
+/**
+ * Parses a kind:5094 event into a ParsedBlobStorageRequest.
+ *
+ * Validates the event kind is 5094, extracts the base64-encoded blob from the
+ * `i` tag, the content type from the `output` tag, and optional chunked upload
+ * params from `param` tags.
+ *
+ * Returns `null` for malformed events (wrong kind, missing required tags,
+ * invalid base64). Follows the lenient parse pattern.
  *
  * @param event - The Nostr event to parse.
- * @returns The parsed job feedback, or null if invalid.
+ * @returns The parsed blob storage request, or null if invalid.
  */
-declare function parseJobFeedback(event: NostrEvent): ParsedJobFeedback | null;
+declare function parseBlobStorageRequest(event: NostrEvent): ParsedBlobStorageRequest | null;
 
 /**
  * Peer discovery using Nostr NIP-02 follow lists.
@@ -980,36 +2033,32 @@ declare function publishSeedRelayEntry(config: PublishSeedRelayConfig): Promise<
 }>;
 
 /**
- * Pure functions for settlement chain negotiation.
- * No I/O or side effects — used during peer registration to determine
- * the best matching settlement chain and token.
- */
-/**
- * Negotiates the best matching settlement chain between requester and responder.
+ * Pure function for calculating ILP PREPARE amount including intermediary routing fees.
  *
- * Preference order:
- * 1. Chain in intersection with requester's preferred token
- * 2. Chain in intersection with responder's preferred token
- * 3. First chain in intersection (requester's order preserved)
+ * Formula: totalAmount = basePricePerByte * packetBytes + SUM(hopFees[i] * packetBytes)
  *
- * @param requesterChains - Chain identifiers the requester supports
- * @param responderChains - Chain identifiers the responder supports
- * @param requesterPreferredTokens - Requester's preferred tokens by chain
- * @param responderPreferredTokens - Responder's preferred tokens by chain
- * @returns The negotiated chain identifier, or null if no intersection
+ * All arithmetic uses bigint -- no floating point, no overflow risk.
  */
-declare function negotiateSettlementChain(requesterChains: string[], responderChains: string[], requesterPreferredTokens?: Record<string, string>, responderPreferredTokens?: Record<string, string>): string | null;
 /**
- * Resolves which token to use for a given chain.
+ * Parameters for route-aware fee calculation.
+ */
+interface CalculateRouteAmountParams {
+    /** Base price per byte charged by the destination node. */
+    basePricePerByte: bigint;
+    /** Length of the TOON-encoded packet in bytes. */
+    packetByteLength: number;
+    /** Per-byte fees for each intermediary hop on the route (ordered sender-to-destination). */
+    hopFees: bigint[];
+}
+/**
+ * Calculates the total ILP PREPARE amount including intermediary routing fees.
  *
- * Priority: requester's preference > responder's preference > undefined
+ * For a direct route (empty hopFees), returns basePricePerByte * packetByteLength.
+ * For multi-hop routes, adds each intermediary's feePerByte * packetByteLength.
  *
- * @param chain - The chain identifier to resolve token for
- * @param requesterPreferredTokens - Requester's preferred tokens by chain
- * @param responderPreferredTokens - Responder's preferred tokens by chain
- * @returns The token address, or undefined if neither party has a preference
+ * @returns Total amount as bigint.
  */
-declare function resolveTokenForChain(chain: string, requesterPreferredTokens?: Record<string, string>, responderPreferredTokens?: Record<string, string>): string | undefined;
+declare function calculateRouteAmount(params: CalculateRouteAmountParams): bigint;
 
 /**
  * Bootstrap state machine types, event types, and client interfaces.
@@ -1055,6 +2104,10 @@ interface BootstrapResult {
     negotiatedChain?: string;
     /** Peer's settlement address */
     settlementAddress?: string;
+    /** Token address for the negotiated chain */
+    tokenAddress?: string;
+    /** TokenNetwork/program/zkApp address for the negotiated chain */
+    tokenNetwork?: string;
 }
 /**
  * Callback interface for connector Admin API operations.
@@ -1150,7 +2203,6 @@ type BootstrapEventListener = (event: BootstrapEvent) => void;
  */
 interface IlpSendResult {
     accepted: boolean;
-    fulfillment?: string;
     data?: string;
     code?: string;
     message?: string;
@@ -1224,6 +2276,83 @@ interface BootstrapServiceConfig extends BootstrapConfig {
     basePricePerByte?: bigint;
 }
 
+/**
+ * Resolves intermediary routing fees from discovered peers using LCA-based
+ * route resolution on the ILP address tree.
+ *
+ * Algorithm:
+ * 1. Split sender and destination ILP addresses into segments.
+ * 2. Find the longest common ancestor (LCA) -- shared prefix of segments.
+ * 3. Intermediaries are the segments on the path from LCA down to destination's parent.
+ * 4. For each intermediary, look up feePerByte from discovered peers.
+ * 5. Unknown intermediaries default to feePerByte 0n with a warning.
+ */
+
+/**
+ * Parameters for resolving route fees.
+ */
+interface ResolveRouteFeesParams {
+    /** ILP address of the destination node. */
+    destination: string;
+    /** ILP address of the sender (own node). */
+    ownIlpAddress: string;
+    /** All discovered peers (including peered ones) with their ILP peer info. */
+    discoveredPeers: DiscoveredPeer[];
+}
+/**
+ * Result of route fee resolution.
+ */
+interface ResolveRouteFeesResult {
+    /** Per-byte fees for each intermediary hop, ordered sender-to-destination. */
+    hopFees: bigint[];
+    /** Warning messages for unknown intermediaries that defaulted to 0. */
+    warnings: string[];
+}
+/**
+ * Resolves intermediary routing fees for a route from sender to destination.
+ *
+ * Uses LCA-based route resolution: intermediary hops are the ILP address
+ * segments between the longest common ancestor and the destination's parent.
+ *
+ * The peer lookup map is cached by array reference to avoid rebuilding it
+ * on every call when the same discoveredPeers array is passed repeatedly.
+ *
+ * @returns Hop fees and any warnings about unknown intermediaries.
+ */
+declare function resolveRouteFees(params: ResolveRouteFeesParams): ResolveRouteFeesResult;
+
+/**
+ * Pure functions for settlement chain negotiation.
+ * No I/O or side effects — used during peer registration to determine
+ * the best matching settlement chain and token.
+ */
+/**
+ * Negotiates the best matching settlement chain between requester and responder.
+ *
+ * Preference order:
+ * 1. Chain in intersection with requester's preferred token
+ * 2. Chain in intersection with responder's preferred token
+ * 3. First chain in intersection (requester's order preserved)
+ *
+ * @param requesterChains - Chain identifiers the requester supports
+ * @param responderChains - Chain identifiers the responder supports
+ * @param requesterPreferredTokens - Requester's preferred tokens by chain
+ * @param responderPreferredTokens - Responder's preferred tokens by chain
+ * @returns The negotiated chain identifier, or null if no intersection
+ */
+declare function negotiateSettlementChain(requesterChains: string[], responderChains: string[], requesterPreferredTokens?: Record<string, string>, responderPreferredTokens?: Record<string, string>): string | null;
+/**
+ * Resolves which token to use for a given chain.
+ *
+ * Priority: requester's preference > responder's preference > undefined
+ *
+ * @param chain - The chain identifier to resolve token for
+ * @param requesterPreferredTokens - Requester's preferred tokens by chain
+ * @param responderPreferredTokens - Responder's preferred tokens by chain
+ * @returns The token address, or undefined if neither party has a preference
+ */
+declare function resolveTokenForChain(chain: string, requesterPreferredTokens?: Record<string, string>, responderPreferredTokens?: Record<string, string>): string | undefined;
+
 /**
  * Bootstrap service for peer discovery and network initialization.
  *
@@ -1374,6 +2503,19 @@ declare class BootstrapService {
      * @returns Map of pubkey to IlpPeerInfo for discovered peers
      */
     discoverPeersViaRelay(relayUrl: string, excludePubkeys?: string[]): Promise<Map<string, IlpPeerInfo>>;
+    /**
+     * Re-advertise own kind:10032 to all previously bootstrapped peers.
+     *
+     * Called after topology changes (addUpstreamPeer/removeUpstreamPeer) to
+     * propagate updated ILP address lists to the network. Uses the same
+     * ILP-first announcement path as the initial Phase 2 bootstrap.
+     *
+     * For non-ILP mode, publishes directly to each peer's relay URL.
+     *
+     * @param results - The bootstrap results from the initial bootstrap() call
+     * @returns Number of peers successfully re-announced to
+     */
+    republish(results: BootstrapResult[]): Promise<number>;
     /**
      * Get our pubkey.
      */
@@ -1414,6 +2556,8 @@ interface DiscoveryTracker {
     peerWith(pubkey: string): Promise<void>;
     /** Get discovered peers not yet peered with. */
     getDiscoveredPeers(): DiscoveredPeer[];
+    /** Get all discovered peers regardless of peering status (for fee calculation). */
+    getAllDiscoveredPeers(): DiscoveredPeer[];
     /** Check if a pubkey has been actively peered with. */
     isPeered(pubkey: string): boolean;
     /** Count of registered (peered) peers. */
@@ -1428,6 +2572,14 @@ interface DiscoveryTracker {
     setConnectorAdmin(admin: ConnectorAdminClient): void;
     /** Set channel client for payment channel opening (optional). */
     setChannelClient(client: ConnectorChannelClient): void;
+    /** Get negotiation metadata for a peer (for lazy channel opening). */
+    getPeerNegotiation(peerId: string): {
+        chain: string;
+        chainType: string;
+        settlementAddress: string;
+        tokenAddress?: string;
+        tokenNetwork?: string;
+    } | undefined;
     /** Mark pubkeys as already-peered (e.g., from bootstrap phase). */
     addExcludedPubkeys(pubkeys: string[]): void;
 }
@@ -1478,9 +2630,7 @@ interface SendPacketParams {
     /** Amount as BigInt (not string) */
     amount: bigint;
     /** Binary data (not base64 string) */
-    data: Uint8Array;
-    /** 32-byte SHA-256 execution condition */
-    executionCondition?: Uint8Array;
+    data?: Uint8Array;
     /**
      * Packet expiration. Included for structural compatibility with ConnectorNode
      * but is not set by the direct client — callers or the connector provide it
@@ -1493,15 +2643,13 @@ interface SendPacketParams {
  *
  * Accepts both string discriminants ('fulfill'/'reject') for backward
  * compatibility with test mocks, and numeric PacketType enum values
- * (13 = FULFILL, 14 = REJECT) used by @toon-protocol/connector@1.6.0+.
+ * (13 = FULFILL, 14 = REJECT) used by @toon-protocol/connector@2.0.0+.
  */
 type SendPacketResult = {
     type: 'fulfill';
-    fulfillment: Uint8Array | Buffer;
     data?: Uint8Array | Buffer;
 } | {
     type: 13;
-    fulfillment: Uint8Array | Buffer;
     data?: Uint8Array | Buffer;
 } | {
     type: 'reject';
@@ -1525,17 +2673,10 @@ interface ConnectorNodeLike {
     sendPacket(params: SendPacketParams): Promise<SendPacketResult>;
 }
 /**
- * Configuration options for the direct runtime client.
- *
- * @deprecated toonDecoder is no longer used for condition computation.
- * Execution condition is computed directly from raw data bytes:
- *   condition = SHA-256(SHA-256(raw_data_bytes))
+ * @deprecated No longer used. Kept for backward compatibility.
  */
 interface DirectRuntimeClientConfig {
-    /**
-     * @deprecated No longer used. Execution condition is computed from raw data
-     * bytes to match the connector's PaymentHandlerAdapter.
-     */
+    /** @deprecated No longer used. */
     toonDecoder?: (bytes: Uint8Array) => {
         id: string;
     };
@@ -1548,7 +2689,7 @@ interface DirectRuntimeClientConfig {
  * @param config - Optional configuration (e.g., toonDecoder for condition computation)
  * @returns An IlpClient instance
  */
-declare function createDirectIlpClient(connector: ConnectorNodeLike, config?: DirectRuntimeClientConfig): IlpClient;
+declare function createDirectIlpClient(connector: ConnectorNodeLike, _config?: DirectRuntimeClientConfig): IlpClient;
 /**
  * @deprecated Use createDirectIlpClient instead
  */
@@ -1757,117 +2898,6 @@ declare function createHttpIlpClient(connectorUrl: string): IlpClient;
  */
 declare function createHttpChannelClient(adminUrl: string): ConnectorChannelClient;
 
-/**
- * AttestationVerifier -- TEE attestation verification, state lifecycle,
- * and attestation-aware peer ranking for Story 4.3.
- *
- * This is a pure logic class with no transport layer. It receives parsed
- * attestation data and returns verification results. The transport layer
- * (subscribing to kind:10033 events on relays) is a Story 4.6 concern.
- *
- * The AttestationVerifier is the single source of truth for attestation
- * state (R-E4-008). Both the kind:10033 Nostr event path and the /health
- * HTTP endpoint derive their TEE state from the same verifier instance.
- *
- * Attestation State Machine (Decision 12):
- *   VALID (within validitySeconds)
- *     -> STALE (within graceSeconds after validity expires)
- *       -> UNATTESTED (after grace period expires)
- *
- * Trust degrades; money doesn't -- attestation state changes never
- * trigger payment channel closure.
- */
-
-/**
- * Attestation lifecycle state.
- *
- * Transitions: VALID -> STALE -> UNATTESTED.
- * A peer that was never attested starts as UNATTESTED.
- */
-declare enum AttestationState {
-    /** Attestation is within validity period. */
-    VALID = "valid",
-    /** Attestation has expired but is within the grace period. */
-    STALE = "stale",
-    /** Attestation has expired past the grace period or was never attested. */
-    UNATTESTED = "unattested"
-}
-/** Result of PCR verification against a known-good registry. */
-interface VerificationResult {
-    valid: boolean;
-    reason?: string;
-}
-/**
- * Descriptor for a peer in the attestation-aware ranking system.
- * Used by `rankPeers()` to order peers by attestation status.
- */
-interface PeerDescriptor {
-    pubkey: string;
-    relayUrl: string;
-    attested: boolean;
-    attestationTimestamp?: number;
-}
-/**
- * Configuration for the AttestationVerifier.
- */
-interface AttestationVerifierConfig {
-    /** Map of known-good PCR values. Key is PCR hash, value is trust status. */
-    knownGoodPcrs: Map<string, boolean>;
-    /** Attestation validity period in seconds (default: 300). */
-    validitySeconds?: number;
-    /** Grace period in seconds after validity expires before marking as unattested (default: 30). */
-    graceSeconds?: number;
-}
-/**
- * Verifies TEE attestations, computes attestation lifecycle state,
- * and ranks peers by attestation status.
- *
- * Single source of truth for attestation state (R-E4-008).
- */
-declare class AttestationVerifier {
-    private readonly knownGoodPcrs;
-    private readonly validitySeconds;
-    private readonly graceSeconds;
-    constructor(config: AttestationVerifierConfig);
-    /**
-     * Verifies a TEE attestation's PCR values against the known-good registry.
-     *
-     * All three PCR values (pcr0, pcr1, pcr2) must be present and truthy in
-     * the registry for verification to pass.
-     *
-     * @param attestation - The TEE attestation to verify.
-     * @returns Verification result with `valid: true` or `valid: false` with reason.
-     */
-    verify(attestation: TeeAttestation): VerificationResult;
-    /**
-     * Computes the attestation lifecycle state based on timing.
-     *
-     * Boundary behavior:
-     * - At exactly `attestedAt + validitySeconds`: VALID (inclusive <=)
-     * - At exactly `attestedAt + validitySeconds + graceSeconds`: STALE (inclusive <=)
-     * - After grace expires: UNATTESTED
-     *
-     * @param _attestation - The TEE attestation (unused, reserved for future per-attestation logic).
-     * @param attestedAt - Unix timestamp when the attestation was created.
-     * @param now - Optional current unix timestamp (defaults to real clock).
-     * @returns The current attestation state.
-     */
-    getAttestationState(_attestation: TeeAttestation, attestedAt: number, now?: number): AttestationState;
-    /**
-     * Ranks peers by attestation status: attested peers first, then non-attested.
-     *
-     * Preserves relative order within each group (stable sort via filter).
-     * Does NOT mutate the input array -- returns a new sorted array.
-     *
-     * Attestation is a preference, not a requirement. Non-attested peers
-     * remain in the result and are connectable.
-     *
-     * @param peers - Array of peer descriptors to rank.
-     * @returns New array with attested peers first, preserving relative order.
-     */
-    rankPeers(peers: PeerDescriptor[]): PeerDescriptor[];
-}
-
 /**
  * AttestationBootstrap -- attestation-first seed relay bootstrap for Story 4.6.
  *
@@ -2023,8 +3053,6 @@ interface HandlePacketRequest {
  */
 interface HandlePacketAcceptResponse {
     accept: true;
-    /** Base64-encoded fulfillment (SHA-256 of event.id) */
-    fulfillment: string;
     /** Base64-encoded response data (e.g., TOON-encoded response for relay back in ILP FULFILL) */
     data?: string;
     metadata?: Record<string, unknown>;
@@ -2256,7 +3284,7 @@ declare function createToonNode(config: ToonNodeConfig): ToonNode;
  * The legacy on-chain mock contract on Anvil uses 18 decimals (inherited
  * from the original ERC-20 deploy script in the connector repo). The
  * constants below reflect production USDC semantics (6 decimals). When
- * interacting with the Anvil mock contract directly (e.g., fund-peer-wallet.sh,
+ * interacting with the Anvil mock contract directly (e.g., via the
  * faucet), use 18 decimals for on-chain amounts. The pricing pipeline
  * (basePricePerByte * toonLength) is denomination-agnostic (bigint math)
  * and works correctly regardless of on-chain decimals.
@@ -2314,10 +3342,10 @@ declare const MOCK_USDC_CONFIG: MockUsdcConfig;
 /**
  * Multi-environment chain configuration for TOON relay nodes.
  *
- * Provides chain presets for three deployment environments:
- * - **anvil** (local dev): Deterministic Anvil addresses, localhost RPC
- * - **arbitrum-sepolia** (staging): Circle testnet USDC on Arbitrum Sepolia
- * - **arbitrum-one** (production): Native USDC on Arbitrum One
+ * Provides chain presets for three blockchain families:
+ * - **EVM**: Anvil (local dev), Arbitrum Sepolia (staging), Arbitrum One (production)
+ * - **Solana**: solana-devnet (local dev)
+ * - **Mina**: mina-devnet (local dev)
  *
  * Environment variable overrides:
  * - `TOON_CHAIN` overrides the config-level chain parameter
@@ -2327,11 +3355,27 @@ declare const MOCK_USDC_CONFIG: MockUsdcConfig;
  * @module
  */
 /**
- * Supported chain preset names.
+ * Blockchain family type. Matches the connector's BlockchainType.
+ */
+type ChainType = 'evm' | 'solana' | 'mina';
+/**
+ * Supported EVM chain preset names (backward-compatible).
  */
 type ChainName = 'anvil' | 'arbitrum-sepolia' | 'arbitrum-one';
 /**
- * Resolved chain configuration with all fields populated.
+ * Supported Solana chain preset names.
+ */
+type SolanaChainName = 'solana-devnet';
+/**
+ * Supported Mina chain preset names.
+ */
+type MinaChainName = 'mina-devnet';
+/**
+ * All supported chain preset names across all chain types.
+ */
+type MultiChainName = ChainName | SolanaChainName | MinaChainName;
+/**
+ * Resolved EVM chain configuration with all fields populated.
  */
 interface ChainPreset {
     /** Preset identifier ('anvil' | 'arbitrum-sepolia' | 'arbitrum-one'). */
@@ -2348,7 +3392,81 @@ interface ChainPreset {
     registryAddress: string;
 }
 /**
- * Built-in chain presets for supported deployment environments.
+ * Resolved Solana chain configuration.
+ */
+interface SolanaChainPreset {
+    /** Preset identifier (e.g., 'solana-devnet'). */
+    name: string;
+    /** Chain type discriminator. */
+    chainType: 'solana';
+    /** Solana cluster RPC endpoint (HTTP). */
+    rpcUrl: string;
+    /** Payment channel program ID (base58-encoded). TBD until deployed. */
+    programId: string;
+    /** Solana cluster name for chain ID namespacing (e.g., 'devnet'). */
+    cluster: string;
+    /** Optional SPL token mint address. */
+    tokenMint?: string;
+}
+/**
+ * Resolved Mina chain configuration.
+ */
+interface MinaChainPreset {
+    /** Preset identifier (e.g., 'mina-devnet'). */
+    name: string;
+    /** Chain type discriminator. */
+    chainType: 'mina';
+    /** Mina GraphQL endpoint. */
+    graphqlUrl: string;
+    /** zkApp address for the payment channel contract. TBD until deployed. */
+    zkAppAddress: string;
+    /** Mina network name (e.g., 'devnet'). */
+    network: string;
+    /** Optional Mina token ID. */
+    tokenId?: string;
+}
+/**
+ * EVM-specific provider configuration entry.
+ */
+interface EVMProviderConfigEntry {
+    chainType: 'evm';
+    chainId: string;
+    rpcUrl: string;
+    registryAddress: string;
+    keyId: string;
+}
+/**
+ * Solana-specific provider configuration entry.
+ */
+interface SolanaProviderConfigEntry {
+    chainType: 'solana';
+    chainId: string;
+    rpcUrl: string;
+    programId: string;
+    keyId: string;
+    wsUrl?: string;
+    cluster?: string;
+    tokenMint?: string;
+}
+/**
+ * Mina-specific provider configuration entry.
+ */
+interface MinaProviderConfigEntry {
+    chainType: 'mina';
+    chainId: string;
+    graphqlUrl: string;
+    zkAppAddress: string;
+    keyId?: string;
+    tokenId?: string;
+    network?: string;
+}
+/**
+ * Discriminated union of all chain provider config entries.
+ * Mirrors the connector's ChainProviderConfigEntry type for passthrough.
+ */
+type ChainProviderConfigEntry = EVMProviderConfigEntry | SolanaProviderConfigEntry | MinaProviderConfigEntry;
+/**
+ * Built-in EVM chain presets for supported deployment environments.
  *
  * Each preset provides the chainId, RPC URL, USDC address, and
  * TokenNetwork address for its environment. Fields can be overridden
@@ -2398,6 +3516,65 @@ declare function buildEip712Domain(config: ChainPreset): {
     chainId: number;
     verifyingContract: string;
 };
+/**
+ * Built-in Solana chain presets.
+ */
+declare const SOLANA_CHAIN_PRESETS: Record<SolanaChainName, SolanaChainPreset>;
+/**
+ * Built-in Mina chain presets.
+ */
+declare const MINA_CHAIN_PRESETS: Record<MinaChainName, MinaChainPreset>;
+/**
+ * Resolve a Solana chain preset by name, with env var overrides.
+ *
+ * Environment variable overrides:
+ * - `SOLANA_RPC_URL` overrides the preset's rpcUrl
+ * - `SOLANA_PROGRAM_ID` overrides the preset's programId
+ *
+ * @param name - Solana chain preset name
+ * @returns Resolved Solana chain preset
+ * @throws ToonError if the name is not recognized
+ */
+declare function resolveSolanaChainConfig(name: SolanaChainName): SolanaChainPreset;
+/**
+ * Resolve a Mina chain preset by name, with env var overrides.
+ *
+ * Environment variable overrides:
+ * - `MINA_GRAPHQL_URL` overrides the preset's graphqlUrl
+ * - `MINA_ZKAPP_ADDRESS` overrides the preset's zkAppAddress
+ *
+ * @param name - Mina chain preset name
+ * @returns Resolved Mina chain preset
+ * @throws ToonError if the name is not recognized
+ */
+declare function resolveMinaChainConfig(name: MinaChainName): MinaChainPreset;
+/**
+ * Build a ChainProviderConfigEntry from a resolved EVM chain preset.
+ *
+ * Converts the TOON-specific ChainPreset into the connector's
+ * ChainProviderConfigEntry format for the `chainProviders` array.
+ *
+ * @param config - Resolved EVM chain preset
+ * @param keyId - Key identifier for signing operations
+ * @returns EVM chain provider config entry
+ */
+declare function buildEvmProviderEntry(config: ChainPreset, keyId: string): EVMProviderConfigEntry;
+/**
+ * Build a ChainProviderConfigEntry from a resolved Solana chain preset.
+ *
+ * @param config - Resolved Solana chain preset
+ * @param keyId - Key identifier for Ed25519 signing operations
+ * @returns Solana chain provider config entry
+ */
+declare function buildSolanaProviderEntry(config: SolanaChainPreset, keyId: string): SolanaProviderConfigEntry;
+/**
+ * Build a ChainProviderConfigEntry from a resolved Mina chain preset.
+ *
+ * @param config - Resolved Mina chain preset
+ * @param keyId - Optional key identifier for signing operations
+ * @returns Mina chain provider config entry
+ */
+declare function buildMinaProviderEntry(config: MinaChainPreset, keyId?: string): MinaProviderConfigEntry;
 
 /**
  * Shared ILP PREPARE packet construction for the TOON protocol.
@@ -2847,4 +4024,4 @@ declare function createLogger(config: LoggerConfig): Logger;
  */
 declare const VERSION = "0.1.0";
 
-export { type AgentRuntimeClient, ArDrivePeerRegistry, AttestationBootstrap, type AttestationBootstrapConfig, type AttestationBootstrapEvent, type AttestationBootstrapEventListener, type AttestationBootstrapResult, type AttestationEventOptions, AttestationState, AttestationVerifier, type AttestationVerifierConfig, type BootstrapConfig, BootstrapError, type BootstrapEvent, type BootstrapEventListener, type BootstrapPhase, type BootstrapResult, BootstrapService, type BootstrapServiceConfig, type BuildIlpPrepareParams, CHAIN_PRESETS, type ChainName, type ChainPreset, type ChannelState, type ConnectorAdminClient, type ConnectorAdminLike, type ConnectorChannelClient, type ConnectorChannelLike, type ConnectorNodeLike, type DeriveFromKmsSeedOptions, type DeterminismReport, type DirectRuntimeClientConfig, type DiscoveredPeer, type DiscoveryTracker, type DiscoveryTrackerConfig, type DvmJobStatus, type EmbeddableConnectorLike, type ForbiddenPattern, type GenesisPeer, GenesisPeerLoader, type HandlePacketAcceptResponse, type HandlePacketRejectResponse, type HandlePacketRequest, type HandlePacketResponse, ILP_PEER_INFO_KIND, IMAGE_GENERATION_KIND, type IlpClient, type IlpPeerInfo, type IlpPreparePacket, type IlpSendResult, JOB_FEEDBACK_KIND, JOB_REQUEST_KIND_BASE, JOB_RESULT_KIND_BASE, type JobFeedbackParams, type JobRequestParams, type JobResultParams, KmsIdentityError, type KmsKeypair, type KnownPeer, type LogEntry, type LogLevel, type Logger, type LoggerConfig, MOCK_USDC_ADDRESS, MOCK_USDC_CONFIG, type MockUsdcConfig, type NixBuildResult, NixBuilder, type NixBuilderConfig, NostrPeerDiscovery, type OpenChannelParams, type OpenChannelResult, type PacketHandler, type ParsedAttestation, type ParsedJobFeedback, type ParsedJobRequest, type ParsedJobResult, PcrReproducibilityError, type PcrReproducibilityResult, type PeerDescriptor, type PublishSeedRelayConfig, type RegisterPeerParams, SEED_RELAY_LIST_KIND, SERVICE_DISCOVERY_KIND, SeedRelayDiscovery, type SeedRelayDiscoveryConfig, type SeedRelayDiscoveryResult, type SeedRelayEntry, type SendPacketParams, type SendPacketResult, type ServiceDiscoveryContent, type SettlementConfig, type SkillDescriptor, type SocialDiscoveryEvent, type SocialDiscoveryEventListener, SocialPeerDiscovery, type SocialPeerDiscoveryConfig, type Subscription, TEE_ATTESTATION_KIND, TEXT_GENERATION_KIND, TEXT_TO_SPEECH_KIND, TRANSLATION_KIND, type TeeAttestation, ToonError, type ToonNode, type ToonNodeConfig, type ToonNodeStartResult, USDC_DECIMALS, USDC_NAME, USDC_SYMBOL, VERSION, type VerificationResult, type VerifyOptions, type Violation, analyzeDockerfileForNonDeterminism, buildAttestationEvent, buildEip712Domain, buildIlpPeerInfoEvent, buildIlpPrepare, buildJobFeedbackEvent, buildJobRequestEvent, buildJobResultEvent, buildSeedRelayListEvent, buildServiceDiscoveryEvent, createAgentRuntimeClient, createDirectChannelClient, createDirectConnectorAdmin, createDirectIlpClient, createDirectRuntimeClient, createDiscoveryTracker, createHttpChannelClient, createHttpConnectorAdmin, createHttpIlpClient$1 as createHttpIlpClient, createHttpRuntimeClient, createHttpIlpClient as createHttpRuntimeClientV2, createLogger, createToonNode, deriveFromKmsSeed, negotiateSettlementChain, parseAttestation, parseIlpPeerInfo, parseJobFeedback, parseJobRequest, parseJobResult, parseSeedRelayList, parseServiceDiscovery, publishSeedRelayEntry, readDockerfileNix, resolveChainConfig, resolveTokenForChain, validateChainId, verifyPcrReproducibility };
+export { AddressRegistry, type AgentRuntimeClient, ArDrivePeerRegistry, AttestationBootstrap, type AttestationBootstrapConfig, type AttestationBootstrapEvent, type AttestationBootstrapEventListener, type AttestationBootstrapResult, type AttestationEventOptions, AttestationState, AttestationVerifier, type AttestationVerifierConfig, type AttestedResultVerificationOptions, type AttestedResultVerificationResult, AttestedResultVerifier, BLOB_STORAGE_REQUEST_KIND, BLOB_STORAGE_RESULT_KIND, type BlobStorageRequestParams, type BootstrapConfig, BootstrapError, type BootstrapEvent, type BootstrapEventListener, type BootstrapPhase, type BootstrapResult, BootstrapService, type BootstrapServiceConfig, type BtpHandshakeExtension, type BuildIlpPrepareParams, CHAIN_PRESETS, type CalculateRouteAmountParams, type ChainName, type ChainPreset, type ChainProviderConfigEntry, type ChainType, type ChannelState, type ConnectorAdminClient, type ConnectorAdminLike, type ConnectorChannelClient, type ConnectorChannelLike, type ConnectorNodeLike, type DeriveFromKmsSeedOptions, type DeterminismReport, type DirectRuntimeClientConfig, type DiscoveredPeer, type DiscoveryTracker, type DiscoveryTrackerConfig, type DvmJobStatus, type EVMProviderConfigEntry, type EmbeddableConnectorLike, type ForbiddenPattern, type GenesisPeer, GenesisPeerLoader, type HandlePacketAcceptResponse, type HandlePacketRejectResponse, type HandlePacketRequest, type HandlePacketResponse, ILP_PEER_INFO_KIND, ILP_ROOT_PREFIX, IMAGE_GENERATION_KIND, type IlpClient, type IlpPeerInfo, type IlpPreparePacket, type IlpSendResult, JOB_FEEDBACK_KIND, JOB_REQUEST_KIND_BASE, JOB_RESULT_KIND_BASE, JOB_REVIEW_KIND, type JobFeedbackParams, type JobRequestParams, type JobResultParams, type JobReviewParams, KmsIdentityError, type KmsKeypair, type KnownPeer, type LogEntry, type LogLevel, type Logger, type LoggerConfig, MINA_CHAIN_PRESETS, MOCK_USDC_ADDRESS, MOCK_USDC_CONFIG, type MinaChainName, type MinaChainPreset, type MinaProviderConfigEntry, type MockUsdcConfig, type MultiChainName, type NixBuildResult, NixBuilder, type NixBuilderConfig, NostrPeerDiscovery, type OpenChannelParams, type OpenChannelResult, PET_INTERACTION_EVENT_KIND, PET_INTERACTION_REQUEST_KIND, PET_INTERACTION_RESULT_KIND, PREFIX_CLAIM_KIND, PREFIX_GRANT_KIND, type PacketHandler, type ParsedAttestation, type ParsedBlobStorageRequest, type ParsedJobFeedback, type ParsedJobRequest, type ParsedJobResult, type ParsedJobReview, type ParsedSwarmRequest, type ParsedSwarmSelection, type ParsedWorkflowDefinition, type ParsedWotDeclaration, PcrReproducibilityError, type PcrReproducibilityResult, type PeerDescriptor, type PrefixClaimContent, type PrefixGrantContent, type PrefixValidationResult, type PublishSeedRelayConfig, type RegisterPeerParams, type ReputationScore, ReputationScoreCalculator, type ReputationSignals, type ResolveRouteFeesParams, type ResolveRouteFeesResult, SEED_RELAY_LIST_KIND, SERVICE_DISCOVERY_KIND, SOLANA_CHAIN_PRESETS, SeedRelayDiscovery, type SeedRelayDiscoveryConfig, type SeedRelayDiscoveryResult, type SeedRelayEntry, type SendPacketParams, type SendPacketResult, type ServiceDiscoveryContent, type SettlementConfig, type SkillDescriptor, type SocialDiscoveryEvent, type SocialDiscoveryEventListener, SocialPeerDiscovery, type SocialPeerDiscoveryConfig, type SolanaChainName, type SolanaChainPreset, type SolanaProviderConfigEntry, type Subscription, type SwarmRequestParams, type SwarmSelectionParams, TEE_ATTESTATION_KIND, TEXT_GENERATION_KIND, TEXT_TO_SPEECH_KIND, TRANSLATION_KIND, type TeeAttestation, ToonError, type ToonNode, type ToonNodeConfig, type ToonNodeStartResult, USDC_DECIMALS, USDC_NAME, USDC_SYMBOL, VERSION, type VerificationResult, type VerifyOptions, type Violation, WEB_OF_TRUST_KIND, WORKFLOW_CHAIN_KIND, type WorkflowDefinitionParams, type WorkflowStep, type WotDeclarationParams, analyzeDockerfileForNonDeterminism, assignAddressFromHandshake, buildAttestationEvent, buildBlobStorageRequest, buildEip712Domain, buildEvmProviderEntry, buildIlpPeerInfoEvent, buildIlpPrepare, buildJobFeedbackEvent, buildJobRequestEvent, buildJobResultEvent, buildJobReviewEvent, buildMinaProviderEntry, buildPrefixClaimEvent, buildPrefixGrantEvent, buildPrefixHandshakeData, buildSeedRelayListEvent, buildServiceDiscoveryEvent, buildSolanaProviderEntry, buildSwarmRequestEvent, buildSwarmSelectionEvent, buildWorkflowDefinitionEvent, buildWotDeclarationEvent, calculateRouteAmount, checkAddressCollision, createAgentRuntimeClient, createDirectChannelClient, createDirectConnectorAdmin, createDirectIlpClient, createDirectRuntimeClient, createDiscoveryTracker, createHttpChannelClient, createHttpConnectorAdmin, createHttpIlpClient$1 as createHttpIlpClient, createHttpRuntimeClient, createHttpIlpClient as createHttpRuntimeClientV2, createLogger, createToonNode, deriveChildAddress, deriveFromKmsSeed, extractPrefixFromHandshake, hasMinReputation, hasRequireAttestation, isGenesisNode, isValidIlpAddressStructure, negotiateSettlementChain, parseAttestation, parseBlobStorageRequest, parseIlpPeerInfo, parseJobFeedback, parseJobRequest, parseJobResult, parseJobReview, parsePrefixClaimEvent, parsePrefixGrantEvent, parseSeedRelayList, parseServiceDiscovery, parseSwarmRequest, parseSwarmSelection, parseWorkflowDefinition, parseWotDeclaration, publishSeedRelayEntry, readDockerfileNix, resolveChainConfig, resolveMinaChainConfig, resolveRouteFees, resolveSolanaChainConfig, resolveTokenForChain, validateChainId, validateIlpAddress, validatePrefix, validatePrefixConsistency, verifyPcrReproducibility };