@toon-protocol/core 1.5.0 → 2.0.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { T as ToonError } from './index-DSgMeweu.js';
 export { I as InvalidEventError, P as PeerDiscoveryError, a as ToonDecodeError, b as ToonEncodeError, c as ToonRoutingMeta, d as decodeEventFromToon, e as encodeEventToToon, f as encodeEventToToonString, s as shallowParseToon } from './index-DSgMeweu.js';
-import { NostrEvent } from 'nostr-tools/pure';
+import { NostrEvent, Event } from 'nostr-tools/pure';
 import { SimplePool } from 'nostr-tools/pool';
 import { TurboAuthenticatedClient } from '@ardrive/turbo-sdk';
 
@@ -479,7 +479,7 @@ interface IlpPeerInfo {
     swapPairs?: SwapPair[];
 }
 /**
- * Declarative advertisement of a token swap pair supported by a swap-capable peer (Mill).
+ * Declarative advertisement of a token swap pair supported by a swap-capable peer (Swap).
  *
  * Source and target assets use the same `{blockchain}:{network}[:{chainId}]` chain format
  * as `IlpPeerInfo.supportedChains`. Rate is serialized as a decimal string (not a float) to
@@ -2473,15 +2473,15 @@ declare function resolveTokenForChain(chain: string, requesterPreferredTokens?:
  * Shared balance-proof hash helpers — the single source of truth for the
  * byte/field layout that ALL signers and verifiers across the monorepo depend
  * on:
- *  - the Mill-side signer (`packages/mill/src/payment-channel-signer.ts`)
+ *  - the Swap-side signer (`packages/swap/src/payment-channel-signer.ts`)
  *  - the sender-side settlement verifier (`packages/sdk/src/settlement/{evm,solana,mina}.ts`)
  *  - the client-side balance-proof signers (`packages/client/src/signing/{solana,mina}-signer.ts`)
  *
- * Originally extracted from the Mill signer (Story 12.4) into `@toon-protocol/sdk`
+ * Originally extracted from the Swap signer (Story 12.4) into `@toon-protocol/sdk`
  * (Story 12.6 AC-6). Relocated here to `@toon-protocol/core` so the client can
  * consume the canonical hashes WITHOUT taking a dependency on `@toon-protocol/sdk`
  * (the client only depends on core). `@toon-protocol/sdk` re-exports these names
- * unchanged, so Mill and existing SDK consumers are unaffected.
+ * unchanged, so Swap and existing SDK consumers are unaffected.
  *
  * Any change to a hash layout here automatically applies to every signer AND
  * verifier — they cannot drift.
@@ -2533,7 +2533,7 @@ declare function balanceProofHashSolana(channelId: string, cumulativeAmount: big
  * `channelId` / `recipient` strings into the fixed field-element array a Mina
  * Schnorr signature is computed over.
  *
- * @stable — Mill signer and SDK verifier depend on the exact derivation.
+ * @stable — Swap signer and SDK verifier depend on the exact derivation.
  */
 declare function minaHashToField(s: string): bigint;
 /**
@@ -2543,20 +2543,20 @@ declare function minaHashToField(s: string): bigint;
  *     nonce,
  *     minaHashToField(recipient) ]
  *
- * This is the EXACT `fields` array that the Mill's `MinaPaymentChannelSigner`
+ * This is the EXACT `fields` array that the Swap's `MinaPaymentChannelSigner`
  * passes to `mina-signer`'s `signFields(...)`, and that the sender-side
  * `verifyMinaSignature` re-derives and passes to `verifyFields(...)`. Keeping
- * the derivation here (shared across `@toon-protocol/mill`, `@toon-protocol/sdk`,
+ * the derivation here (shared across `@toon-protocol/swap`, `@toon-protocol/sdk`,
  * and `@toon-protocol/client`) prevents signer/verifier drift — mirroring the
  * EVM/Solana hash helpers above.
  *
- * NOTE: this is the Mill↔sender wire contract (a Schnorr signature over four
+ * NOTE: this is the Swap↔sender wire contract (a Schnorr signature over four
  * field elements), NOT the connector's on-chain `MinaPaymentChannelSDK`
  * Poseidon-commitment proof shape. The two are distinct; see
  * `packages/sdk/src/settlement/mina.ts` for the relationship + the
  * remaining on-chain-settlement gap.
  *
- * @stable — Mill signer and SDK verifier depend on the exact byte layout.
+ * @stable — Swap signer and SDK verifier depend on the exact byte layout.
  */
 declare function balanceProofFieldsMina(channelId: string, cumulativeAmount: bigint, nonce: bigint, recipient: string): bigint[];
 
@@ -2582,13 +2582,13 @@ declare function base58Decode(str: string): Uint8Array;
 /**
  * Mina private-key format conversion.
  *
- * `deriveFullIdentity()` / `deriveMillKeys()` emit a Mina Pallas scalar as a
+ * `deriveFullIdentity()` / `deriveSwapKeys()` emit a Mina Pallas scalar as a
  * big-endian hex string, but `mina-signer`'s `signFields`/`derivePublicKey`
  * require the Mina base58check (`EK…`) private-key format. This helper bridges
  * the two so a hex-derived Mina key produces signatures verifiable by the
  * sender-side `verifyMinaSignature`.
  *
- * Mirrors `hexToMinaBase58PrivateKey` in `packages/mill/src/payment-channel-signer.ts`
+ * Mirrors `hexToMinaBase58PrivateKey` in `packages/swap/src/payment-channel-signer.ts`
  * (same fixed Mina base58check wire standard — version byte `0x5a`, non-zero
  * tag `0x01`, little-endian scalar, double-sha256 checksum).
  *
@@ -2608,11 +2608,11 @@ declare function hexToMinaBase58PrivateKey(privateKey: string): string;
  * Derive the Mina base58 (`B62…`) public key for a private-key scalar, using
  * the optional `mina-signer` peer dep.
  *
- * `deriveFullIdentity()` / `deriveMillKeys()` emit only a keccak **hex
+ * `deriveFullIdentity()` / `deriveSwapKeys()` emit only a keccak **hex
  * placeholder** for the Mina public key — they deliberately avoid pulling
  * Pallas curve math into derivation. That placeholder is unfundable and is
  * rejected by Mina GraphQL balance queries, so wallet views that display it
- * (e.g. the townhouse `/wallet/balances` mill Mina leg) show an unusable hex
+ * (e.g. a swap node's `/wallet/balances` Mina leg) show an unusable hex
  * string. This resolves the real, fundable `B62…` address when `mina-signer`
  * is installed.
  *
@@ -3677,7 +3677,7 @@ type ChainType = 'evm' | 'solana' | 'mina';
  * `anvil` is the local-dev chain. `arbitrum-*` and `base-*` are the public
  * Arbitrum and Base networks used by the network-mode resolver
  * (see network-profile.ts). Base is the primary EVM chain for single-EVM
- * nodes; the apex connector and Mill can hold providers for both families.
+ * nodes; the apex connector and Swap can hold providers for both families.
  */
 type ChainName = 'anvil' | 'arbitrum-sepolia' | 'arbitrum-one' | 'base-sepolia' | 'base-mainnet';
 /**
@@ -3719,7 +3719,7 @@ interface SolanaChainPreset {
     chainType: 'solana';
     /** Solana cluster RPC endpoint (HTTP). */
     rpcUrl: string;
-    /** Payment channel program ID (base58-encoded). TBD until deployed. */
+    /** Payment channel program ID (base58-encoded). */
     programId: string;
     /** Solana cluster name for chain ID namespacing (e.g., 'devnet'). */
     cluster: string;
@@ -3736,7 +3736,7 @@ interface MinaChainPreset {
     chainType: 'mina';
     /** Mina GraphQL endpoint. */
     graphqlUrl: string;
-    /** zkApp address for the payment channel contract. TBD until deployed. */
+    /** zkApp address for the payment channel contract. */
     zkAppAddress: string;
     /** Mina network name (e.g., 'devnet'). */
     network: string;
@@ -3910,7 +3910,7 @@ declare function buildSolanaProviderEntry(config: SolanaChainPreset, keyId: stri
 declare function buildMinaProviderEntry(config: MinaChainPreset, keyId?: string): MinaProviderConfigEntry;
 
 /**
- * Network-mode resolution for the Townhouse `network` flag.
+ * Network-mode resolution for the TOON connector `network` flag.
  *
  * A single operator-facing selector — `mainnet | testnet | devnet | custom` —
  * resolves a coherent multi-chain configuration that is consumed by BOTH:
@@ -3918,18 +3918,18 @@ declare function buildMinaProviderEntry(config: MinaChainPreset, keyId?: string)
  * to point at the project's dev chains — e.g. the Akash-hosted anvil + solana.)
  *
  * - the **apex** standalone connector (its `chainProviders` settlement array), and
- * - the **children** node containers (town/mill), via a small set of env vars the
+ * - the **children** node containers (relay/swap), via a small set of env vars the
  *   HS compose template interpolates (`EVM_CHAIN`, `EVM_RPC_URL`, `EVM_CHAIN_ID`,
  *   `EVM_USDC_ADDRESS`, `SOLANA_RPC_URL`, `SOLANA_USDC_MINT`).
  *
  * Design notes:
  * - **All tiers are public.** No tier resolves to a local chain (anvil/lightnet),
  *   so a node never points at an unreachable `localhost` RPC. This is what fixes
- *   the "JsonRpcProvider failed to detect network" boot-loop that left town nodes
+ *   the "JsonRpcProvider failed to detect network" boot-loop that left relay nodes
  *   permanently disconnected (an empty RPC fell back to the `anvil` preset whose
  *   `localhost:8545` does not exist in the HS network).
- * - **EVM = Base (primary) + Arbitrum.** The single-EVM town node uses Base; the
- *   apex connector and Mill can hold providers for both families.
+ * - **EVM = Base (primary) + Arbitrum.** The single-EVM relay node uses Base; the
+ *   apex connector and Swap can hold providers for both families.
  * - **Settlement status.** TOON's settlement contracts are deployed for the
  *   public **testnet/devnet** tiers (EVM Base Sepolia registry + TokenNetwork,
  *   Solana devnet program, Mina devnet zkApp — source of truth: e2e/testnets.json),
@@ -3981,7 +3981,7 @@ interface NetworkFamilyStatus {
  * Only keys with real values are present (absent ⇒ compose `${VAR:-}` default).
  */
 interface NetworkNodeEnv {
-    /** Primary EVM chain preset name → town `TOON_CHAIN` (`'none'` ⇒ relay-only). */
+    /** Primary EVM chain preset name → relay `TOON_CHAIN` (`'none'` ⇒ relay-only). */
     EVM_CHAIN?: string;
     EVM_RPC_URL?: string;
     EVM_CHAIN_ID?: string;
@@ -4007,7 +4007,7 @@ interface NetworkProfile {
     /** Per-family settlement readiness. */
     status: NetworkFamilyStatus;
 }
-/** Sentinel for the town node meaning "no EVM settlement chain — run relay-only". */
+/** Sentinel for the relay node meaning "no EVM settlement chain — run relay-only". */
 declare const RELAY_ONLY_CHAIN = "none";
 /**
  * Resolve a {@link NetworkProfile} from a network mode.
@@ -4517,6 +4517,100 @@ interface Logger {
  */
 declare function createLogger(config: LoggerConfig): Logger;
 
+/**
+ * Pure helpers for NIP-on-TOON UI renderer resolution.
+ *
+ * An event may carry a `ui` tag whose value is an addressable coordinate
+ * pointing at a `kind:31036` renderer event. The coordinate convention is:
+ *
+ *     31036:<renderer-author-pubkey>:<target-kind>
+ *
+ * where the trailing segment (the renderer event's `d` tag value) is the
+ * kind of event the renderer knows how to render.
+ *
+ * These helpers are intentionally PURE: they parse coordinate strings and
+ * select the latest addressable event from a set of candidates. The actual
+ * resolution (relay query + cache) is client-local and lives outside core.
+ *
+ * Mirrors the style of `parseRepositoryReference` in `../nip34/types.ts`.
+ */
+
+/** The renderer event kind for NIP-on-TOON UI rendering. */
+declare const UI_RENDERER_KIND = 31036;
+/** Tag name carrying the UI renderer coordinate on a rendered event. */
+declare const UI_TAG = "ui";
+/**
+ * A parsed `ui` renderer coordinate.
+ * Format: "31036:<pubkey>:<targetKind>"
+ */
+interface UiCoordinate {
+    /** Always {@link UI_RENDERER_KIND} (31036). */
+    kind: typeof UI_RENDERER_KIND;
+    /** The renderer author's 64-hex pubkey. */
+    pubkey: string;
+    /** The kind of event this renderer targets (the renderer's `d` value). */
+    targetKind: number;
+}
+/**
+ * Parse a `ui` renderer coordinate string of the form
+ * `31036:<pubkey>:<targetKind>`.
+ *
+ * Returns `null` on any malformed input: wrong segment count, a leading kind
+ * other than 31036, a pubkey that is not 64-hex, or a non-integer target kind.
+ *
+ * Pure: no IO, no relay fetch.
+ *
+ * @param coord - The coordinate string (e.g. a `ui` tag value).
+ * @returns The parsed {@link UiCoordinate}, or `null` if malformed.
+ */
+declare function parseUiCoordinate(coord: string): UiCoordinate | null;
+/**
+ * Build a `ui` renderer coordinate string of the form
+ * `31036:<pubkey>:<targetKind>`.
+ *
+ * The inverse of {@link parseUiCoordinate}. Returns `null` if the inputs are
+ * invalid (pubkey not 64-hex, or target kind not a non-negative integer), so
+ * that `build`→`parse` round-trips cleanly.
+ *
+ * Pure: no IO, no relay fetch.
+ *
+ * @param ref - The renderer author pubkey and target kind.
+ * @returns The coordinate string, or `null` if the inputs are invalid.
+ */
+declare function buildUiCoordinate(ref: {
+    pubkey: string;
+    targetKind: number;
+}): string | null;
+/**
+ * Read the `ui` tag value off an event and parse it into a coordinate.
+ *
+ * Convenience wrapper around {@link parseUiCoordinate} that pulls the first
+ * `ui` tag's value from `event.tags`. Returns `null` if the event has no
+ * `ui` tag or the tag value is malformed.
+ *
+ * Pure: no IO, no relay fetch.
+ *
+ * @param event - The event that may reference a renderer via a `ui` tag.
+ * @returns The parsed {@link UiCoordinate}, or `null`.
+ */
+declare function getUiCoordinate(event: Event): UiCoordinate | null;
+/**
+ * Select the latest addressable/replaceable event from a set of candidates
+ * that share an addressable coordinate.
+ *
+ * Implements NIP-33 latest-wins: the event with the greatest `created_at`
+ * wins. Ties on `created_at` are broken by the lexicographically lowest `id`
+ * per the NIP-01 convention.
+ *
+ * Does not itself group by coordinate — callers pass the candidate set for a
+ * single coordinate (e.g. the result of a relay query filtered by author +
+ * kind + `#d`). Pure: no IO, no relay fetch.
+ *
+ * @param events - Candidate events sharing a coordinate.
+ * @returns The latest event, or `undefined` for an empty input.
+ */
+declare function selectLatestAddressable<T extends Event>(events: T[]): T | undefined;
+
 /**
  * @toon-protocol/core
  *
@@ -4524,4 +4618,4 @@ declare function createLogger(config: LoggerConfig): Logger;
  */
 declare const VERSION = "0.1.0";
 
-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 BuildIlpPeerInfoOptions, type BuildIlpPrepareParams, CHAIN_PRESETS, type CalculateRouteAmountParams, type ChainName, type ChainPreset, type ChainProviderConfigEntry, type ChainType, type ChannelState, type ClientNetworkPresets, type ConnectorAdminClient, type ConnectorAdminLike, type ConnectorChannelClient, type ConnectorChannelLike, type ConnectorNodeLike, type CustomEndpoints, type DeriveFromKmsSeedOptions, type DeterminismReport, type DirectRuntimeClientConfig, type DiscoveredPeer, type DiscoveryTracker, type DiscoveryTrackerConfig, type DvmJobStatus, type EVMProviderConfigEntry, EXPIRATION_TAG, type EmbeddableConnectorLike, type ForbiddenPattern, type GenesisPeer, GenesisPeerLoader, type HandlePacketAcceptResponse, type HandlePacketRejectResponse, type HandlePacketRequest, type HandlePacketResponse, ILP_PEER_INFO_KIND, ILP_ROOT_PREFIX, ILP_TO_SEMANTIC, 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 NetworkFamilyStatus, type NetworkMode, type NetworkNodeEnv, type NetworkProfile, 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, RELAY_ONLY_CHAIN, 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 SwapPair, 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, balanceProofFieldsMina, balanceProofHashEvm, balanceProofHashSolana, base58Decode, base58Encode, bigintToBytes32BE, buildAttestationEvent, buildBlobStorageRequest, buildEip712Domain, buildEvmProviderEntry, buildIlpPeerInfoEvent, buildIlpPrepare, buildJobFeedbackEvent, buildJobRequestEvent, buildJobResultEvent, buildJobReviewEvent, buildMinaProviderEntry, buildPrefixClaimEvent, buildPrefixGrantEvent, buildPrefixHandshakeData, buildSeedRelayListEvent, buildServiceDiscoveryEvent, buildSolanaProviderEntry, buildSwarmRequestEvent, buildSwarmSelectionEvent, buildWorkflowDefinitionEvent, buildWotDeclarationEvent, calculateRouteAmount, checkAddressCollision, concatBytes, createAgentRuntimeClient, createDirectChannelClient, createDirectConnectorAdmin, createDirectIlpClient, createDirectRuntimeClient, createDiscoveryTracker, createHttpChannelClient, createHttpConnectorAdmin, createHttpIlpClient$1 as createHttpIlpClient, createHttpRuntimeClient, createHttpIlpClient as createHttpRuntimeClientV2, createLogger, createToonNode, deriveChildAddress, deriveFromKmsSeed, deriveMinaPublicKeyBase58, extractPrefixFromHandshake, getEventExpiration, hasMinReputation, hasRequireAttestation, hexToBytes, hexToMinaBase58PrivateKey, ilpCodeToSemantic, isEventExpired, isGenesisNode, isValidIlpAddressStructure, minaHashToField, negotiateSettlementChain, parseAttestation, parseBlobStorageRequest, parseIlpPeerInfo, parseJobFeedback, parseJobRequest, parseJobResult, parseJobReview, parsePrefixClaimEvent, parsePrefixGrantEvent, parseSeedRelayList, parseServiceDiscovery, parseSwarmRequest, parseSwarmSelection, parseWorkflowDefinition, parseWotDeclaration, publishSeedRelayEntry, readDockerfileNix, resolveChainConfig, resolveClientNetwork, resolveMinaChainConfig, resolveNetworkProfile, resolveRouteFees, resolveSolanaChainConfig, resolveTokenForChain, validateChainId, validateIlpAddress, validatePrefix, validatePrefixConsistency, 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 BuildIlpPeerInfoOptions, type BuildIlpPrepareParams, CHAIN_PRESETS, type CalculateRouteAmountParams, type ChainName, type ChainPreset, type ChainProviderConfigEntry, type ChainType, type ChannelState, type ClientNetworkPresets, type ConnectorAdminClient, type ConnectorAdminLike, type ConnectorChannelClient, type ConnectorChannelLike, type ConnectorNodeLike, type CustomEndpoints, type DeriveFromKmsSeedOptions, type DeterminismReport, type DirectRuntimeClientConfig, type DiscoveredPeer, type DiscoveryTracker, type DiscoveryTrackerConfig, type DvmJobStatus, type EVMProviderConfigEntry, EXPIRATION_TAG, type EmbeddableConnectorLike, type ForbiddenPattern, type GenesisPeer, GenesisPeerLoader, type HandlePacketAcceptResponse, type HandlePacketRejectResponse, type HandlePacketRequest, type HandlePacketResponse, ILP_PEER_INFO_KIND, ILP_ROOT_PREFIX, ILP_TO_SEMANTIC, 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 NetworkFamilyStatus, type NetworkMode, type NetworkNodeEnv, type NetworkProfile, 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, RELAY_ONLY_CHAIN, 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 SwapPair, 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, UI_RENDERER_KIND, UI_TAG, USDC_DECIMALS, USDC_NAME, USDC_SYMBOL, type UiCoordinate, VERSION, type VerificationResult, type VerifyOptions, type Violation, WEB_OF_TRUST_KIND, WORKFLOW_CHAIN_KIND, type WorkflowDefinitionParams, type WorkflowStep, type WotDeclarationParams, analyzeDockerfileForNonDeterminism, assignAddressFromHandshake, balanceProofFieldsMina, balanceProofHashEvm, balanceProofHashSolana, base58Decode, base58Encode, bigintToBytes32BE, buildAttestationEvent, buildBlobStorageRequest, buildEip712Domain, buildEvmProviderEntry, buildIlpPeerInfoEvent, buildIlpPrepare, buildJobFeedbackEvent, buildJobRequestEvent, buildJobResultEvent, buildJobReviewEvent, buildMinaProviderEntry, buildPrefixClaimEvent, buildPrefixGrantEvent, buildPrefixHandshakeData, buildSeedRelayListEvent, buildServiceDiscoveryEvent, buildSolanaProviderEntry, buildSwarmRequestEvent, buildSwarmSelectionEvent, buildUiCoordinate, buildWorkflowDefinitionEvent, buildWotDeclarationEvent, calculateRouteAmount, checkAddressCollision, concatBytes, createAgentRuntimeClient, createDirectChannelClient, createDirectConnectorAdmin, createDirectIlpClient, createDirectRuntimeClient, createDiscoveryTracker, createHttpChannelClient, createHttpConnectorAdmin, createHttpIlpClient$1 as createHttpIlpClient, createHttpRuntimeClient, createHttpIlpClient as createHttpRuntimeClientV2, createLogger, createToonNode, deriveChildAddress, deriveFromKmsSeed, deriveMinaPublicKeyBase58, extractPrefixFromHandshake, getEventExpiration, getUiCoordinate, hasMinReputation, hasRequireAttestation, hexToBytes, hexToMinaBase58PrivateKey, ilpCodeToSemantic, isEventExpired, isGenesisNode, isValidIlpAddressStructure, minaHashToField, negotiateSettlementChain, parseAttestation, parseBlobStorageRequest, parseIlpPeerInfo, parseJobFeedback, parseJobRequest, parseJobResult, parseJobReview, parsePrefixClaimEvent, parsePrefixGrantEvent, parseSeedRelayList, parseServiceDiscovery, parseSwarmRequest, parseSwarmSelection, parseUiCoordinate, parseWorkflowDefinition, parseWotDeclaration, publishSeedRelayEntry, readDockerfileNix, resolveChainConfig, resolveClientNetwork, resolveMinaChainConfig, resolveNetworkProfile, resolveRouteFees, resolveSolanaChainConfig, resolveTokenForChain, selectLatestAddressable, validateChainId, validateIlpAddress, validatePrefix, validatePrefixConsistency, verifyPcrReproducibility };

package/dist/index.js

@@ -2232,7 +2232,14 @@ var NostrPeerDiscovery = class {
 };
 
 // src/discovery/genesis-peers.json
-var genesis_peers_default = [];
+var genesis_peers_default = [
+  {
+    pubkey: "522e93098bf650f141a07f0ecfc1ace0f5d0397932afc01826e9ef46888b7bce",
+    relayUrl: "wss://relay-ws.devnet.toonprotocol.dev",
+    ilpAddress: "g.proxy.relay.store",
+    btpEndpoint: "wss://proxy.store.devnet.toonprotocol.dev:443"
+  }
+];
 
 // src/discovery/GenesisPeerLoader.ts
 var PUBKEY_REGEX3 = /^[0-9a-f]{64}$/;
@@ -4631,8 +4638,7 @@ var SOLANA_CHAIN_PRESETS = {
     name: "solana-devnet",
     chainType: "solana",
     rpcUrl: "http://localhost:19899",
-    programId: "",
-    // TBD: set after program deployment
+    programId: "EdJxYPDxGvaJuu57DSUptf4soLv8enpdyQJJhHDLiydG",
     cluster: "devnet"
   }
 };
@@ -4641,8 +4647,7 @@ var MINA_CHAIN_PRESETS = {
     name: "mina-devnet",
     chainType: "mina",
     graphqlUrl: "http://localhost:19085/graphql",
-    zkAppAddress: "",
-    // TBD: set after zkApp deployment
+    zkAppAddress: "B62qrH1As4odHiNyKpTZMHaM6tRs6gi5DJ53efZKQBtbaR5CUctbDs6",
     network: "devnet"
   }
 };
@@ -5310,6 +5315,74 @@ function createLogger(config) {
   return logger;
 }
 
+// src/ui/coordinate.ts
+var UI_RENDERER_KIND = 31036;
+var UI_TAG = "ui";
+var HEX64_RE = /^[0-9a-f]{64}$/;
+function parseUiCoordinate(coord) {
+  if (typeof coord !== "string") {
+    return null;
+  }
+  const parts = coord.split(":");
+  if (parts.length !== 3) {
+    return null;
+  }
+  const [kindStr, pubkey, targetKindStr] = parts;
+  if (kindStr === void 0 || pubkey === void 0 || targetKindStr === void 0) {
+    return null;
+  }
+  if (kindStr !== String(UI_RENDERER_KIND)) {
+    return null;
+  }
+  if (!HEX64_RE.test(pubkey)) {
+    return null;
+  }
+  if (!/^\d+$/.test(targetKindStr)) {
+    return null;
+  }
+  const targetKind = Number(targetKindStr);
+  if (!Number.isInteger(targetKind)) {
+    return null;
+  }
+  return {
+    kind: UI_RENDERER_KIND,
+    pubkey,
+    targetKind
+  };
+}
+function buildUiCoordinate(ref) {
+  const { pubkey, targetKind } = ref;
+  if (typeof pubkey !== "string" || !HEX64_RE.test(pubkey)) {
+    return null;
+  }
+  if (!Number.isInteger(targetKind) || targetKind < 0) {
+    return null;
+  }
+  return `${UI_RENDERER_KIND}:${pubkey}:${targetKind}`;
+}
+function getUiCoordinate(event) {
+  const value = event.tags.find((t) => t[0] === UI_TAG)?.[1];
+  if (value === void 0) {
+    return null;
+  }
+  return parseUiCoordinate(value);
+}
+function selectLatestAddressable(events) {
+  let latest;
+  for (const event of events) {
+    if (latest === void 0) {
+      latest = event;
+      continue;
+    }
+    if (event.created_at > latest.created_at) {
+      latest = event;
+    } else if (event.created_at === latest.created_at && event.id < latest.id) {
+      latest = event;
+    }
+  }
+  return latest;
+}
+
 // src/index.ts
 var VERSION = "0.1.0";
 export {
@@ -5362,6 +5435,8 @@ export {
   ToonDecodeError,
   ToonEncodeError,
   ToonError,
+  UI_RENDERER_KIND,
+  UI_TAG,
   USDC_DECIMALS,
   USDC_NAME,
   USDC_SYMBOL,
@@ -5395,6 +5470,7 @@ export {
   buildSolanaProviderEntry,
   buildSwarmRequestEvent,
   buildSwarmSelectionEvent,
+  buildUiCoordinate,
   buildWorkflowDefinitionEvent,
   buildWotDeclarationEvent,
   calculateRouteAmount,
@@ -5421,6 +5497,7 @@ export {
   encodeEventToToonString,
   extractPrefixFromHandshake,
   getEventExpiration,
+  getUiCoordinate,
   hasMinReputation,
   hasRequireAttestation,
   hexToBytes,
@@ -5444,6 +5521,7 @@ export {
   parseServiceDiscovery,
   parseSwarmRequest,
   parseSwarmSelection,
+  parseUiCoordinate,
   parseWorkflowDefinition,
   parseWotDeclaration,
   publishSeedRelayEntry,
@@ -5455,6 +5533,7 @@ export {
   resolveRouteFees,
   resolveSolanaChainConfig,
   resolveTokenForChain,
+  selectLatestAddressable,
   shallowParseToon,
   validateChainId,
   validateIlpAddress,