@toon-protocol/core 1.4.2 → 1.6.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';
 
@@ -432,6 +432,21 @@ interface IlpPeerInfo {
     ilpAddresses?: string[];
     /** BTP WebSocket endpoint URL for packet exchange (pay-per-event writes) */
     btpEndpoint: string;
+    /**
+     * ILP-over-HTTP endpoint URL (RFC-0035) for stateless, one-shot writes:
+     * `POST` an ILP PREPARE here and receive a FULFILL/REJECT body. Suited to
+     * pure consumers, browsers, and NAT'd agents that don't need a duplex BTP
+     * session. Absent when the node only exposes BTP. The same host typically
+     * also accepts an HTTP `Upgrade` to BTP — see {@link supportsUpgrade}.
+     */
+    httpEndpoint?: string;
+    /**
+     * Whether `httpEndpoint`'s host accepts an HTTP `Upgrade` to a BTP/WebSocket
+     * session (`Sec-WebSocket-Protocol: btp`). Lets a client start on
+     * ILP-over-HTTP and upgrade to duplex BTP when it becomes a peer or needs
+     * server-initiated packets, carrying its HTTP-proven identity across.
+     */
+    supportsUpgrade?: boolean;
     /**
      * Public Nostr relay WebSocket URL for FREE reads (e.g. `wss://<addr>.anyone/`
      * or `ws://host:7100`). Lets a client discover where to subscribe/read without
@@ -3704,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;
@@ -3721,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;
@@ -4502,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
  *
@@ -4509,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

@@ -414,6 +414,8 @@ function parseIlpPeerInfo(event) {
   const {
     ilpAddress,
     btpEndpoint,
+    httpEndpoint,
+    supportsUpgrade,
     blsHttpEndpoint,
     settlementEngine,
     assetCode,
@@ -428,6 +430,12 @@ function parseIlpPeerInfo(event) {
   if (btpEndpoint !== void 0 && typeof btpEndpoint !== "string") {
     throw new InvalidEventError("Invalid field: btpEndpoint must be a string");
   }
+  if (httpEndpoint !== void 0 && typeof httpEndpoint !== "string") {
+    throw new InvalidEventError("Invalid field: httpEndpoint must be a string");
+  }
+  if (supportsUpgrade !== void 0 && typeof supportsUpgrade !== "boolean") {
+    throw new InvalidEventError("Invalid field: supportsUpgrade must be a boolean");
+  }
   if (typeof assetCode !== "string" || assetCode.length === 0) {
     throw new InvalidEventError("Missing or invalid required field: assetCode");
   }
@@ -561,6 +569,8 @@ function parseIlpPeerInfo(event) {
   return {
     ilpAddress,
     btpEndpoint: typeof btpEndpoint === "string" ? btpEndpoint : "",
+    ...httpEndpoint !== void 0 && typeof httpEndpoint === "string" && { httpEndpoint },
+    ...supportsUpgrade !== void 0 && typeof supportsUpgrade === "boolean" && { supportsUpgrade },
     ...blsHttpEndpoint !== void 0 && typeof blsHttpEndpoint === "string" && { blsHttpEndpoint },
     assetCode,
     assetScale,
@@ -4621,8 +4631,7 @@ var SOLANA_CHAIN_PRESETS = {
     name: "solana-devnet",
     chainType: "solana",
     rpcUrl: "http://localhost:19899",
-    programId: "",
-    // TBD: set after program deployment
+    programId: "EdJxYPDxGvaJuu57DSUptf4soLv8enpdyQJJhHDLiydG",
     cluster: "devnet"
   }
 };
@@ -4631,8 +4640,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"
   }
 };
@@ -5300,6 +5308,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 {
@@ -5352,6 +5428,8 @@ export {
   ToonDecodeError,
   ToonEncodeError,
   ToonError,
+  UI_RENDERER_KIND,
+  UI_TAG,
   USDC_DECIMALS,
   USDC_NAME,
   USDC_SYMBOL,
@@ -5385,6 +5463,7 @@ export {
   buildSolanaProviderEntry,
   buildSwarmRequestEvent,
   buildSwarmSelectionEvent,
+  buildUiCoordinate,
   buildWorkflowDefinitionEvent,
   buildWotDeclarationEvent,
   calculateRouteAmount,
@@ -5411,6 +5490,7 @@ export {
   encodeEventToToonString,
   extractPrefixFromHandshake,
   getEventExpiration,
+  getUiCoordinate,
   hasMinReputation,
   hasRequireAttestation,
   hexToBytes,
@@ -5434,6 +5514,7 @@ export {
   parseServiceDiscovery,
   parseSwarmRequest,
   parseSwarmSelection,
+  parseUiCoordinate,
   parseWorkflowDefinition,
   parseWotDeclaration,
   publishSeedRelayEntry,
@@ -5445,6 +5526,7 @@ export {
   resolveRouteFees,
   resolveSolanaChainConfig,
   resolveTokenForChain,
+  selectLatestAddressable,
   shallowParseToon,
   validateChainId,
   validateIlpAddress,