@toon-protocol/townhouse 0.1.3 → 0.2.0

package/dist/compose/townhouse-hs.yml

@@ -22,10 +22,10 @@
 #     Story 45.4 boots only connector + townhouse-api at apex install
 #
 # Digest placeholders (substituted at build time from dist/image-manifest.json):
-#   @sha256:2b4b38bba0538ff1be4ff966ba941461485718bf6c2ba09bdf4b75df3c700e84 → @sha256:<hex>
-#   @sha256:36b0563b0bfc9fdda1a5723fb1496427188048cdf9f96c813b71c32161532874         → @sha256:<hex>
-#   @sha256:1fd4e8015087314d9f99240ecce81f48bac318311f77aeacb57d881594d133cc         → @sha256:<hex>
-#   @sha256:ebc5f8e38672954a76c69bda90924a3a0ad7cdac42520f22d2e05960d06986ae          → @sha256:<hex>
+#   @sha256:f8f5d24ea14f288d2469459cf38ffcb93c5aa30c70c5387fe5451259cd78b8c4 → @sha256:<hex>
+#   @sha256:464e556d2388d3f804987340fd0a4369ca9de0b8e4f8e00072ef5a821e5107bc         → @sha256:<hex>
+#   @sha256:d60e3678b376b5215ce10a8730632dcb7042265aaeefde254b1d1feed4e8088b         → @sha256:<hex>
+#   @sha256:b7b5f3522a5885c0fdb4197181ee55dfae795782c3f4a81aae24e1422fccbd9e          → @sha256:<hex>
 #   @sha256:3343c19649290043e521c81b467b7c6410b8eaedd76d48804ea9b6fc810cddb0    → @sha256:<hex>
 #
 # Scope guard (Story 45.2 does NOT include):
@@ -152,7 +152,7 @@ services:
   # Port D21-008: Fastify host API on 127.0.0.1:28090.
   # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   townhouse-api:
-    image: ghcr.io/toon-protocol/townhouse-api@sha256:2b4b38bba0538ff1be4ff966ba941461485718bf6c2ba09bdf4b75df3c700e84
+    image: ghcr.io/toon-protocol/townhouse-api@sha256:f8f5d24ea14f288d2469459cf38ffcb93c5aa30c70c5387fe5451259cd78b8c4
     container_name: townhouse-hs-api
     # Run as the operator's host UID so bind-mounted ~/.townhouse files
     # (rw------- 600) are readable. TOWNHOUSE_UID is injected by `townhouse hs up`.
@@ -252,7 +252,7 @@ services:
   # start at first run).
   # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   town:
-    image: ghcr.io/toon-protocol/town@sha256:36b0563b0bfc9fdda1a5723fb1496427188048cdf9f96c813b71c32161532874
+    image: ghcr.io/toon-protocol/town@sha256:464e556d2388d3f804987340fd0a4369ca9de0b8e4f8e00072ef5a821e5107bc
     container_name: townhouse-hs-town
     profiles: [town]
     networks:
@@ -303,7 +303,7 @@ services:
   # Lazy-provisioned via Epic 46: `townhouse node add mill`
   # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   mill:
-    image: ghcr.io/toon-protocol/mill@sha256:1fd4e8015087314d9f99240ecce81f48bac318311f77aeacb57d881594d133cc
+    image: ghcr.io/toon-protocol/mill@sha256:d60e3678b376b5215ce10a8730632dcb7042265aaeefde254b1d1feed4e8088b
     container_name: townhouse-hs-mill
     profiles: [mill]
     networks:
@@ -351,7 +351,7 @@ services:
   # Lazy-provisioned via Epic 46: `townhouse node add dvm`
   # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   dvm:
-    image: ghcr.io/toon-protocol/dvm@sha256:ebc5f8e38672954a76c69bda90924a3a0ad7cdac42520f22d2e05960d06986ae
+    image: ghcr.io/toon-protocol/dvm@sha256:b7b5f3522a5885c0fdb4197181ee55dfae795782c3f4a81aae24e1422fccbd9e
     container_name: townhouse-hs-dvm
     profiles: [dvm]
     networks:

package/dist/image-manifest.json

@@ -1,27 +1,27 @@
 {
   "schemaVersion": 1,
-  "townhouseVersion": "0.1.3",
-  "builtAt": "2026-06-02T13:43:36.534Z",
+  "townhouseVersion": "0.2.0",
+  "builtAt": "2026-06-02T15:50:15.649Z",
   "images": {
     "townhouse-api": {
       "name": "ghcr.io/toon-protocol/townhouse-api",
-      "tag": "0.1.3",
-      "digest": "sha256:2b4b38bba0538ff1be4ff966ba941461485718bf6c2ba09bdf4b75df3c700e84"
+      "tag": "0.2.0",
+      "digest": "sha256:f8f5d24ea14f288d2469459cf38ffcb93c5aa30c70c5387fe5451259cd78b8c4"
     },
     "town": {
       "name": "ghcr.io/toon-protocol/town",
-      "tag": "0.1.3",
-      "digest": "sha256:36b0563b0bfc9fdda1a5723fb1496427188048cdf9f96c813b71c32161532874"
+      "tag": "0.2.0",
+      "digest": "sha256:464e556d2388d3f804987340fd0a4369ca9de0b8e4f8e00072ef5a821e5107bc"
     },
     "mill": {
       "name": "ghcr.io/toon-protocol/mill",
-      "tag": "0.1.3",
-      "digest": "sha256:1fd4e8015087314d9f99240ecce81f48bac318311f77aeacb57d881594d133cc"
+      "tag": "0.2.0",
+      "digest": "sha256:d60e3678b376b5215ce10a8730632dcb7042265aaeefde254b1d1feed4e8088b"
     },
     "dvm": {
       "name": "ghcr.io/toon-protocol/dvm",
-      "tag": "0.1.3",
-      "digest": "sha256:ebc5f8e38672954a76c69bda90924a3a0ad7cdac42520f22d2e05960d06986ae"
+      "tag": "0.2.0",
+      "digest": "sha256:b7b5f3522a5885c0fdb4197181ee55dfae795782c3f4a81aae24e1422fccbd9e"
     },
     "connector": {
       "name": "ghcr.io/toon-protocol/connector",

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { E as EncryptedWallet, T as TownhouseConfig, W as WalletManager, a as ComposeProfile, N as NodeType$1, B as BandwidthStats, H as HealthCheckOptions } from './manager-SsneW_Mj.js';
-export { A as ApiConfig, b as ComposeLoaderError, C as ComposeLoaderOptions, c as ConnectorConfig, d as ContainerSpec, D as DerivedNodeKeys, e as DvmNodeConfig, L as LoggingConfig, M as MillNodeConfig, f as NodeKeyInfo, g as NodeKeys, h as NodesConfig, O as OrchestratorEvents, i as TownNodeConfig, j as TransportConfig, k as WalletConfig, l as WalletManagerConfig, m as WalletState, n as loadComposeTemplate, o as materializeComposeTemplate } from './manager-SsneW_Mj.js';
+import { E as EncryptedWallet, T as TownhouseConfig, W as WalletManager, a as ComposeProfile, N as NodeType$1, B as BandwidthStats, H as HealthCheckOptions, b as ChainProviderEntry } from './manager-BtpOFwd6.js';
+export { A as ApiConfig, c as ChainType, d as ComposeLoaderError, C as ComposeLoaderOptions, e as ConnectorConfig, f as ContainerSpec, D as DerivedNodeKeys, g as DvmNodeConfig, h as EvmChainProvider, L as LoggingConfig, M as MillNodeConfig, i as MinaChainProvider, j as NodeKeyInfo, k as NodeKeys, l as NodesConfig, O as OrchestratorEvents, S as SolanaChainProvider, m as TownNodeConfig, n as TransportConfig, o as WalletConfig, p as WalletManagerConfig, q as WalletState, r as loadComposeTemplate, s as materializeComposeTemplate } from './manager-BtpOFwd6.js';
 import { EventEmitter } from 'node:events';
 import Docker from 'dockerode';
 import { FastifyBaseLogger, FastifyInstance } from 'fastify';
@@ -1269,6 +1269,12 @@ interface WizardInitRequest {
     transport: {
         mode: 'direct' | 'ator';
     };
+    /**
+     * Optional settlement chains (connector chainProviders) to configure during
+     * first-run setup. Omitted/empty → the connector uses the dev-Anvil default.
+     * Validated deeply when the resulting config is saved.
+     */
+    chainProviders?: ChainProviderEntry[];
 }
 /** Progress messages streamed over WS /api/wizard/progress */
 type WizardProgressMessage = {
@@ -2038,4 +2044,4 @@ declare class BootReconciler {
     private appendLog;
 }
 
-export { type AggregateEarningsInput, type AggregatedEarnings, type AggregatedEarningsStatus, type AggregatorLogger, type ApiDeps, type ApiServer, type BandwidthPayload, BandwidthStats, BootReconciler, ComposeProfile, ConfigValidationError, ConnectorAdminClient, ConnectorConfigGenerator, type ConnectorRuntimeConfig, DEFAULT_ATOR_PROXY, type DeltaComputer, type DepositAddressEntry, type DepositAddressesPayload, type DivergenceAction, type DivergenceLog, DockerOrchestrator, type DvmHealthResponse, EncryptedWallet, HealthCheckOptions, type HealthResponse, type HsHostnameResponse, type ImageManifest, ImageManifestSchema, type JobsByKindEntry, type JobsRecentPayload, type MetricsPayload, type MetricsPeerEntry, type MetricsResponse, type MillHealthResponse, type MillSwapsRecentPayload, type NodeDetail, type NodeEarnings, type NodeHealthPayload, type NodeInfo, type NodeState, NodeType$1 as NodeType, type NodesYaml, type NodesYamlEntry, NodesYamlEntrySchema, NodesYamlSchema, type NostrEventPayload, OrchestratorError, type PacketLogEntry, type PacketLogFilter, type PacketTimeseriesPayload, type PeerEntry, type PeerStatus, PeerTypeResolver, type PeersResponse, type PerAsset, type ReconcileSummary, type RevealRequest, type RevealResponse, type SnapshotEntry, SnapshotWriter, type SnapshotWriterOptions, type SwapByPairEntry, type TimeseriesBucket, type TownHealthPayload, TownhouseConfig, type TransactionReceiptPayload, type TransportPatchRequest, type TransportPatchResponse, TransportProbe, type TransportStatusPayload, type WalletBalanceEntry, type WalletBalancesPayload, WalletManager, type WithdrawDryRunResponse, type WithdrawRequest, type WithdrawResponse, type WithdrawSuccessResponse, type WizardInitRequest, type WizardProgressMessage, type WizardStatePayload, type WsBatchMessage, type WsConnectorRestartedMessage, type WsConnectorRestartingMessage, type WsHeartbeatMessage, type WsMessage, type WsMetricsMessage, type WsNodeStateMessage, type WsRelayEventsMessage, createApiServer, createDeltaComputer, createWizardApiServer, decryptWallet, encryptWallet, getDefaultConfig, loadConfig, loadWallet, readImageManifest, readNodesYaml, saveConfig, saveWallet, utcDayBoundary, utcMonthBoundary, utcYearBoundary, validateConfig, writeNodesYaml };
+export { type AggregateEarningsInput, type AggregatedEarnings, type AggregatedEarningsStatus, type AggregatorLogger, type ApiDeps, type ApiServer, type BandwidthPayload, BandwidthStats, BootReconciler, ChainProviderEntry, ComposeProfile, ConfigValidationError, ConnectorAdminClient, ConnectorConfigGenerator, type ConnectorRuntimeConfig, DEFAULT_ATOR_PROXY, type DeltaComputer, type DepositAddressEntry, type DepositAddressesPayload, type DivergenceAction, type DivergenceLog, DockerOrchestrator, type DvmHealthResponse, EncryptedWallet, HealthCheckOptions, type HealthResponse, type HsHostnameResponse, type ImageManifest, ImageManifestSchema, type JobsByKindEntry, type JobsRecentPayload, type MetricsPayload, type MetricsPeerEntry, type MetricsResponse, type MillHealthResponse, type MillSwapsRecentPayload, type NodeDetail, type NodeEarnings, type NodeHealthPayload, type NodeInfo, type NodeState, NodeType$1 as NodeType, type NodesYaml, type NodesYamlEntry, NodesYamlEntrySchema, NodesYamlSchema, type NostrEventPayload, OrchestratorError, type PacketLogEntry, type PacketLogFilter, type PacketTimeseriesPayload, type PeerEntry, type PeerStatus, PeerTypeResolver, type PeersResponse, type PerAsset, type ReconcileSummary, type RevealRequest, type RevealResponse, type SnapshotEntry, SnapshotWriter, type SnapshotWriterOptions, type SwapByPairEntry, type TimeseriesBucket, type TownHealthPayload, TownhouseConfig, type TransactionReceiptPayload, type TransportPatchRequest, type TransportPatchResponse, TransportProbe, type TransportStatusPayload, type WalletBalanceEntry, type WalletBalancesPayload, WalletManager, type WithdrawDryRunResponse, type WithdrawRequest, type WithdrawResponse, type WithdrawSuccessResponse, type WizardInitRequest, type WizardProgressMessage, type WizardStatePayload, type WsBatchMessage, type WsConnectorRestartedMessage, type WsConnectorRestartingMessage, type WsHeartbeatMessage, type WsMessage, type WsMetricsMessage, type WsNodeStateMessage, type WsRelayEventsMessage, createApiServer, createDeltaComputer, createWizardApiServer, decryptWallet, encryptWallet, getDefaultConfig, loadConfig, loadWallet, readImageManifest, readNodesYaml, saveConfig, saveWallet, utcDayBoundary, utcMonthBoundary, utcYearBoundary, validateConfig, writeNodesYaml };

package/dist/index.js

@@ -34,7 +34,7 @@ import {
   utcYearBoundary,
   validateConfig,
   writeNodesYaml
-} from "./chunk-QHFUIWEN.js";
+} from "./chunk-B4KWPVEK.js";
 import "./chunk-5O4SBV5O.js";
 import "./chunk-GQNBZJ6F.js";
 import "./chunk-I2R4CRUX.js";

package/dist/{manager-SsneW_Mj.d.ts → manager-BtpOFwd6.d.ts}

@@ -58,29 +58,65 @@ interface ConnectorConfig {
     adminPort: number;
 }
 /**
- * Connector chain-provider entry — surfaces what the connector needs to spin
- * up its settlement subsystem (AccountManager + ClaimReceiver). Without at
- * least one entry, `/admin/earnings.json` returns 503 and Townhouse's
+ * Connector chain-provider entry — what the connector needs to spin up its
+ * settlement subsystem (AccountManager + ClaimReceiver) for one chain. Without
+ * at least one entry, `/admin/earnings.json` returns 503 and Townhouse's
  * earnings data plane breaks (Epic 47 BUG-1).
  *
+ * This is a discriminated union on `chainType` that mirrors the connector's
+ * `ProviderConfig` contract (EVM | Solana | Mina), so entries pass straight
+ * through `ConnectorConfigGenerator` to the connector. The connector already
+ * implements payment-channel providers for all three chains.
+ *
  * Dev-Anvil deterministic placeholders are exposed via
  * `DEFAULT_HS_CHAIN_PROVIDERS` in `defaults.ts`; operators running on real
  * chains override this in their `config.yaml`.
  */
-interface ChainProviderEntry {
-    /** Currently only 'evm' supported. */
+/** Supported settlement chain families. */
+type ChainType = 'evm' | 'solana' | 'mina';
+/** EVM settlement chain (Base, Arbitrum, Anvil dev, …). */
+interface EvmChainProvider {
     chainType: 'evm';
     /** Canonical chain id, e.g. 'evm:base:31337' (dev-Anvil) or 'evm:base:8453' (mainnet). */
     chainId: string;
-    /** Chain RPC endpoint. May be a dead address in offline/demo mode. */
+    /** JSON-RPC endpoint. May be a dead address in offline/demo mode. */
     rpcUrl: string;
     /** PaymentChannel registry contract. */
     registryAddress: string;
     /** Settlement token (USDC, etc.) contract. */
     tokenAddress: string;
-    /** Hex private key the connector signs settlement claims with. */
+    /** Hex private key / key id the connector signs settlement claims with. */
+    keyId: string;
+}
+/** Solana settlement chain. */
+interface SolanaChainProvider {
+    chainType: 'solana';
+    /** Canonical chain id, e.g. 'solana:devnet' or 'solana:mainnet'. */
+    chainId: string;
+    /** Cluster RPC endpoint (HTTP). */
+    rpcUrl: string;
+    /** WebSocket endpoint for account subscriptions (derived from rpcUrl if absent). */
+    wsUrl?: string;
+    /** On-chain payment-channel program id (base58). */
+    programId: string;
+    /** Settlement token mint (base58). */
+    tokenMint?: string;
+    /** Key id the connector signs settlement claims with. */
     keyId: string;
 }
+/** Mina settlement chain. */
+interface MinaChainProvider {
+    chainType: 'mina';
+    /** Canonical chain id, e.g. 'mina:devnet' or 'mina:mainnet'. */
+    chainId: string;
+    /** Mina GraphQL endpoint. */
+    graphqlUrl: string;
+    /** zkApp address for the payment-channel contract (base58). */
+    zkAppAddress: string;
+    /** Key id the connector signs settlement claims with. */
+    keyId?: string;
+}
+type ChainProviderEntry = EvmChainProvider | SolanaChainProvider | MinaChainProvider;
 /**
  * Hidden-service publication config (Story 35.5 of the connector repo).
  *
@@ -516,4 +552,4 @@ declare class WalletManager {
     private deriveNodeKeys;
 }
 
-export { type ApiConfig as A, type BandwidthStats as B, type ComposeLoaderOptions as C, type DerivedNodeKeys as D, type EncryptedWallet as E, type HealthCheckOptions as H, type LoggingConfig as L, type MillNodeConfig as M, type NodeType as N, type OrchestratorEvents as O, type TownhouseConfig as T, WalletManager as W, type ComposeProfile as a, ComposeLoaderError as b, type ConnectorConfig as c, type ContainerSpec as d, type DvmNodeConfig as e, type NodeKeyInfo as f, type NodeKeys as g, type NodesConfig as h, type TownNodeConfig as i, type TransportConfig as j, type WalletConfig as k, type WalletManagerConfig as l, type WalletState as m, loadComposeTemplate as n, materializeComposeTemplate as o };
+export { type ApiConfig as A, type BandwidthStats as B, type ComposeLoaderOptions as C, type DerivedNodeKeys as D, type EncryptedWallet as E, type HealthCheckOptions as H, type LoggingConfig as L, type MillNodeConfig as M, type NodeType as N, type OrchestratorEvents as O, type SolanaChainProvider as S, type TownhouseConfig as T, WalletManager as W, type ComposeProfile as a, type ChainProviderEntry as b, type ChainType as c, ComposeLoaderError as d, type ConnectorConfig as e, type ContainerSpec as f, type DvmNodeConfig as g, type EvmChainProvider as h, type MinaChainProvider as i, type NodeKeyInfo as j, type NodeKeys as k, type NodesConfig as l, type TownNodeConfig as m, type TransportConfig as n, type WalletConfig as o, type WalletManagerConfig as p, type WalletState as q, loadComposeTemplate as r, materializeComposeTemplate as s };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toon-protocol/townhouse",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "TOON Townhouse — host-native orchestrator + dashboard for Docker-containerized TOON nodes",
   "type": "module",
   "main": "./dist/index.js",
@@ -73,9 +73,9 @@
     "vitest": "^1.0.0",
     "@toon-protocol/core": "^1.4.1",
     "@toon-protocol/mill": "^0.1.0",
-    "@toon-protocol/sdk": "^0.5.0",
+    "@toon-protocol/client": "^0.9.1",
     "@toon-protocol/relay": "^1.3.1",
-    "@toon-protocol/client": "^0.9.1"
+    "@toon-protocol/sdk": "^0.5.0"
   },
   "scripts": {
     "build": "tsup",