@tangle-network/blueprint-ui 0.4.0 → 0.5.1

package/dist/iframe/testing-index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/iframe/testing.tsx"],"sourcesContent":["// Testing harness for iframe blueprints. The promise of the SDK is that\n// publishers can iterate on their UI without running the Tangle Cloud dapp\n// — these utilities are what makes that true.\n\nimport {\n  type FC,\n  type ReactNode,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport type { Address } from 'viem';\n\nimport type {\n  ServiceSnapshot,\n  WalletSnapshot,\n} from './tangleIframeClient';\nimport type {\n  CallJobRequest,\n  JobInputs,\n  JobResultEvent,\n  ParentMessage,\n  ServiceContextBroadcast,\n  ServiceContextJob,\n  ServiceContextOperator,\n} from '../wallet/parentBridgeProtocol';\n\nexport type MockWalletInput = Partial<{\n  address: Address | null;\n  chainId: number;\n  isConnected: boolean;\n}>;\n\nexport type MockServiceInput = Partial<{\n  blueprintId: string;\n  serviceId: string | null;\n  operators: readonly ServiceContextOperator[];\n  jobs: readonly ServiceContextJob[];\n  mode: string | null;\n}>;\n\n/**\n * Construct a deterministic wallet snapshot for tests. Defaults:\n * connected, vitalik.eth's address, Base Sepolia (84532).\n */\nexport function mockWallet(input: MockWalletInput = {}): WalletSnapshot {\n  return {\n    address:\n      input.address === undefined\n        ? '0xd8da6bf26964af9d7eed9e03e53415d37aa96045'\n        : input.address,\n    chainId: input.chainId ?? 84532,\n    isConnected: input.isConnected ?? input.address !== null,\n  };\n}\n\n/**\n * Construct a deterministic service snapshot for tests. Defaults: blueprint\n * id `0`, no service deployed yet (serviceId null), single mock operator on\n * the canonical local sidecar URL.\n */\nexport function mockServiceContext(\n  input: MockServiceInput = {},\n): ServiceSnapshot {\n  return {\n    blueprintId: input.blueprintId ?? '0',\n    serviceId: input.serviceId === undefined ? null : input.serviceId,\n    operators:\n      input.operators ?? [\n        {\n          address: '0x70997970C51812dc3A010C7d01b50e0d17dc79C8',\n          rpcAddress: 'http://localhost:8545',\n          status: 'active',\n        },\n      ],\n    jobs:\n      input.jobs ?? [\n        { index: 0, name: 'invoke' },\n      ],\n    mode: input.mode ?? null,\n  };\n}\n\nexport type CallJobHandler = (\n  request: CallJobRequest,\n) => Promise<{\n  status: 'success' | 'error';\n  data?: unknown;\n  error?: string;\n  /** Streaming chunks emitted in order before the terminal status. */\n  chunks?: readonly unknown[];\n}>;\n\ntype HarnessProps = {\n  appId?: string;\n  wallet?: WalletSnapshot;\n  service?: ServiceSnapshot;\n  /** Override callJob behavior. Default: returns a static `{ ok: true }`. */\n  onCallJob?: CallJobHandler;\n  /** Surface a floating debug panel that lets the developer flip state at runtime. */\n  showDebugPanel?: boolean;\n  children: ReactNode;\n};\n\n/**\n * Drop-in parent simulator for tests + storybook + standalone dev. Wraps\n * children in a fake parent that:\n *\n *   - Acks the iframe's handshake immediately\n *   - Broadcasts the configured wallet + service context on mount\n *   - Intercepts `callJob` requests and routes them through `onCallJob`\n *   - (Optional) Mounts a floating debug panel so the developer can\n *     mutate state at runtime: change account, switch chain, set\n *     serviceId, fire a custom job\n *\n * The harness runs in the same JS context as the iframe app — there's no\n * cross-frame postMessage, just same-window event dispatch. That keeps it\n * fully synchronous + assertable, but the messages still flow through the\n * exact same protocol surface the production bridge uses.\n *\n * Usage:\n *\n *   <TangleParentHarness wallet={mockWallet()} service={mockServiceContext()}>\n *     <TangleIframeProvider appId=\"my-app\" mode=\"bridge\" parentOrigin=\"harness://\">\n *       <App />\n *     </TangleIframeProvider>\n *   </TangleParentHarness>\n *\n * Set `mode=\"bridge\"` + `parentOrigin=\"harness://\"` on the provider so it\n * matches the harness's synthetic origin. In production, use `mode=\"auto\"`\n * (the default).\n */\nexport const TangleParentHarness: FC<HarnessProps> = ({\n  appId = 'harness',\n  wallet = mockWallet(),\n  service = mockServiceContext(),\n  onCallJob,\n  showDebugPanel = false,\n  children,\n}) => {\n  const [currentWallet, setCurrentWallet] = useState<WalletSnapshot>(wallet);\n  const [currentService, setCurrentService] =\n    useState<ServiceSnapshot>(service);\n  const [callLog, setCallLog] = useState<CallJobRequest[]>([]);\n  const callJobHandler = useRef<CallJobHandler | undefined>(onCallJob);\n  callJobHandler.current = onCallJob;\n  const seenHandshake = useRef(false);\n\n  // Listen for iframe → \"parent\" messages. Since the harness shares the\n  // window, `window.postMessage` with the synthetic origin is the easiest\n  // wire — the iframe SDK posts to `window.parent`, which in same-window\n  // mode IS this listener.\n  useEffect(() => {\n    const reply = (message: ParentMessage) => {\n      window.dispatchEvent(\n        new MessageEvent('message', {\n          data: message,\n          origin: HARNESS_ORIGIN,\n        }),\n      );\n    };\n\n    const broadcast = () => {\n      const broadcastMsg: ServiceContextBroadcast = {\n        kind: 'tangle.app.serviceContext',\n        blueprintId: currentService.blueprintId ?? '0',\n        serviceId: currentService.serviceId,\n        operators: currentService.operators,\n        jobs: currentService.jobs,\n        mode: currentService.mode,\n      };\n      reply(broadcastMsg);\n      // Also broadcast wallet — combined into accountChanged + chainChanged.\n      reply({\n        kind: 'tangle.app.accountChanged',\n        account: currentWallet.address,\n      });\n      if (currentWallet.chainId !== null) {\n        reply({\n          kind: 'tangle.app.chainChanged',\n          chainId: currentWallet.chainId,\n        });\n      }\n    };\n\n    const handler = async (event: MessageEvent) => {\n      // The iframe posts via `window.parent.postMessage(msg, parentOrigin)`.\n      // In same-window mode, that fires a message event on this same window\n      // with origin = parentOrigin. Filter out events the harness itself\n      // dispatched (origin === HARNESS_ORIGIN) — those are replies.\n      if (event.origin === HARNESS_ORIGIN) return;\n      const data = event.data;\n      if (typeof data !== 'object' || data === null) return;\n      const message = data as { kind?: string; correlationId?: string };\n\n      switch (message.kind) {\n        case 'tangle.app.handshake': {\n          if (!seenHandshake.current) {\n            seenHandshake.current = true;\n            reply({\n              kind: 'tangle.app.handshakeAck',\n              appId,\n              protocolVersion: '1',\n            });\n            broadcast();\n          }\n          return;\n        }\n        case 'tangle.app.readAccount': {\n          if (typeof message.correlationId !== 'string') return;\n          reply({\n            kind: 'tangle.app.readAccountResult',\n            correlationId: message.correlationId,\n            ok: true,\n            data: {\n              account:\n                currentWallet.address ??\n                ('0x0000000000000000000000000000000000000000' as Address),\n              chainId: currentWallet.chainId ?? 0,\n            },\n          });\n          return;\n        }\n        case 'tangle.app.callJob': {\n          if (typeof message.correlationId !== 'string') return;\n          const request = message as unknown as CallJobRequest;\n          setCallLog((prev) => [...prev, request]);\n          // Default behavior when no handler: emit a single `success` with\n          // a echo of the inputs so UIs render *something* in dev mode.\n          const handler = callJobHandler.current;\n          if (!handler) {\n            const result: JobResultEvent = {\n              kind: 'tangle.app.jobResult',\n              correlationId: request.correlationId,\n              status: 'success',\n              data: { echo: request.inputs },\n            };\n            reply(result);\n            return;\n          }\n          try {\n            const outcome = await handler(request);\n            for (const chunk of outcome.chunks ?? []) {\n              reply({\n                kind: 'tangle.app.jobResult',\n                correlationId: request.correlationId,\n                status: 'streaming',\n                chunk,\n              });\n            }\n            reply({\n              kind: 'tangle.app.jobResult',\n              correlationId: request.correlationId,\n              status: outcome.status,\n              ...(outcome.data !== undefined ? { data: outcome.data } : {}),\n              ...(outcome.error !== undefined ? { error: outcome.error } : {}),\n            });\n          } catch (err) {\n            reply({\n              kind: 'tangle.app.jobResult',\n              correlationId: request.correlationId,\n              status: 'error',\n              error: err instanceof Error ? err.message : String(err),\n            });\n          }\n          return;\n        }\n        // Wallet ops respond optimistically — tests that want to assert\n        // specific signatures should pre-set them via the dev handler.\n        case 'tangle.app.signMessage': {\n          if (typeof message.correlationId !== 'string') return;\n          reply({\n            kind: 'tangle.app.signMessageResult',\n            correlationId: message.correlationId,\n            ok: true,\n            data: { signature: '0xdeadbeef' as `0x${string}` },\n          });\n          return;\n        }\n        case 'tangle.app.signTransaction': {\n          if (typeof message.correlationId !== 'string') return;\n          reply({\n            kind: 'tangle.app.signTransactionResult',\n            correlationId: message.correlationId,\n            ok: true,\n            data: { txHash: ('0x' + '00'.repeat(32)) as `0x${string}` },\n          });\n          return;\n        }\n        case 'tangle.app.switchChain': {\n          if (\n            typeof message.correlationId !== 'string' ||\n            typeof (message as unknown as { chainId?: number }).chainId !== 'number'\n          ) {\n            return;\n          }\n          const chainId = (message as unknown as { chainId: number }).chainId;\n          setCurrentWallet((w) => ({ ...w, chainId }));\n          reply({\n            kind: 'tangle.app.switchChainResult',\n            correlationId: message.correlationId,\n            ok: true,\n            data: { chainId },\n          });\n          return;\n        }\n      }\n    };\n    window.addEventListener('message', handler);\n    return () => window.removeEventListener('message', handler);\n  }, [appId, currentWallet, currentService]);\n\n  // Re-broadcast when state changes.\n  useEffect(() => {\n    if (!seenHandshake.current) return;\n    window.dispatchEvent(\n      new MessageEvent('message', {\n        data: {\n          kind: 'tangle.app.accountChanged',\n          account: currentWallet.address,\n        },\n        origin: HARNESS_ORIGIN,\n      }),\n    );\n  }, [currentWallet.address]);\n\n  useEffect(() => {\n    if (!seenHandshake.current || currentWallet.chainId === null) return;\n    window.dispatchEvent(\n      new MessageEvent('message', {\n        data: {\n          kind: 'tangle.app.chainChanged',\n          chainId: currentWallet.chainId,\n        },\n        origin: HARNESS_ORIGIN,\n      }),\n    );\n  }, [currentWallet.chainId]);\n\n  useEffect(() => {\n    if (!seenHandshake.current) return;\n    window.dispatchEvent(\n      new MessageEvent('message', {\n        data: {\n          kind: 'tangle.app.serviceContext',\n          blueprintId: currentService.blueprintId ?? '0',\n          serviceId: currentService.serviceId,\n          operators: currentService.operators,\n          jobs: currentService.jobs,\n          mode: currentService.mode,\n        },\n        origin: HARNESS_ORIGIN,\n      }),\n    );\n  }, [currentService]);\n\n  const debugApi = useMemo(\n    () => ({\n      setWallet: setCurrentWallet,\n      setService: setCurrentService,\n      callLog,\n    }),\n    [callLog],\n  );\n\n  return (\n    <>\n      {children}\n      {showDebugPanel && <DebugPanel api={debugApi} />}\n    </>\n  );\n};\n\n/**\n * Synthetic origin every harness instance uses. Stable across tests so the\n * iframe SDK + the harness can pin to the same string.\n */\nexport const HARNESS_ORIGIN = 'harness://tangle.local';\n\n// ── Debug panel ──────────────────────────────────────────────────────────────\n\nconst DebugPanel: FC<{\n  api: {\n    setWallet: (w: WalletSnapshot | ((prev: WalletSnapshot) => WalletSnapshot)) => void;\n    setService: (\n      s: ServiceSnapshot | ((prev: ServiceSnapshot) => ServiceSnapshot),\n    ) => void;\n    callLog: readonly CallJobRequest[];\n  };\n}> = ({ api }) => {\n  const [open, setOpen] = useState(true);\n  const [tab, setTab] = useState<'wallet' | 'service' | 'log'>('wallet');\n  if (!open) {\n    return (\n      <button\n        type=\"button\"\n        onClick={() => setOpen(true)}\n        style={debugStyles.collapsedTrigger}\n      >\n        Debug\n      </button>\n    );\n  }\n  return (\n    <div style={debugStyles.panel}>\n      <header style={debugStyles.header}>\n        <strong style={{ fontSize: 11 }}>TANGLE DEV HARNESS</strong>\n        <button\n          type=\"button\"\n          onClick={() => setOpen(false)}\n          style={debugStyles.closeButton}\n          aria-label=\"Close debug panel\"\n        >\n          ×\n        </button>\n      </header>\n      <nav style={debugStyles.tabs}>\n        {(['wallet', 'service', 'log'] as const).map((t) => (\n          <button\n            key={t}\n            type=\"button\"\n            onClick={() => setTab(t)}\n            style={{\n              ...debugStyles.tab,\n              ...(tab === t ? debugStyles.tabActive : {}),\n            }}\n          >\n            {t}\n          </button>\n        ))}\n      </nav>\n      <div style={debugStyles.body}>\n        {tab === 'wallet' && <WalletTab api={api} />}\n        {tab === 'service' && <ServiceTab api={api} />}\n        {tab === 'log' && <CallLogTab callLog={api.callLog} />}\n      </div>\n    </div>\n  );\n};\n\nconst WalletTab: FC<{\n  api: { setWallet: (w: WalletSnapshot | ((prev: WalletSnapshot) => WalletSnapshot)) => void };\n}> = ({ api }) => {\n  const [address, setAddressInput] = useState(\n    '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',\n  );\n  const [chainId, setChainIdInput] = useState('84532');\n  const applyConnect = useCallback(() => {\n    api.setWallet({\n      address: address as Address,\n      chainId: Number(chainId) || null,\n      isConnected: true,\n    });\n  }, [address, chainId, api]);\n  const disconnect = useCallback(() => {\n    api.setWallet({ address: null, chainId: null, isConnected: false });\n  }, [api]);\n  return (\n    <div>\n      <label style={debugStyles.label}>address</label>\n      <input\n        value={address}\n        onChange={(e) => setAddressInput(e.target.value)}\n        style={debugStyles.input}\n      />\n      <label style={debugStyles.label}>chain id</label>\n      <input\n        value={chainId}\n        onChange={(e) => setChainIdInput(e.target.value)}\n        style={debugStyles.input}\n      />\n      <div style={debugStyles.buttonRow}>\n        <button type=\"button\" onClick={applyConnect} style={debugStyles.primary}>\n          Set connected\n        </button>\n        <button type=\"button\" onClick={disconnect} style={debugStyles.secondary}>\n          Disconnect\n        </button>\n      </div>\n    </div>\n  );\n};\n\nconst ServiceTab: FC<{\n  api: {\n    setService: (\n      s: ServiceSnapshot | ((prev: ServiceSnapshot) => ServiceSnapshot),\n    ) => void;\n  };\n}> = ({ api }) => {\n  const [serviceId, setServiceIdInput] = useState('1');\n  const [blueprintId, setBlueprintIdInput] = useState('0');\n  const apply = useCallback(() => {\n    api.setService((prev) => ({\n      ...prev,\n      serviceId: serviceId || null,\n      blueprintId,\n    }));\n  }, [api, serviceId, blueprintId]);\n  const clearService = useCallback(() => {\n    api.setService((prev) => ({ ...prev, serviceId: null }));\n  }, [api]);\n  return (\n    <div>\n      <label style={debugStyles.label}>blueprint id</label>\n      <input\n        value={blueprintId}\n        onChange={(e) => setBlueprintIdInput(e.target.value)}\n        style={debugStyles.input}\n      />\n      <label style={debugStyles.label}>service id (empty = not deployed)</label>\n      <input\n        value={serviceId}\n        onChange={(e) => setServiceIdInput(e.target.value)}\n        style={debugStyles.input}\n      />\n      <div style={debugStyles.buttonRow}>\n        <button type=\"button\" onClick={apply} style={debugStyles.primary}>\n          Apply\n        </button>\n        <button type=\"button\" onClick={clearService} style={debugStyles.secondary}>\n          Clear service\n        </button>\n      </div>\n    </div>\n  );\n};\n\nconst CallLogTab: FC<{ callLog: readonly CallJobRequest[] }> = ({ callLog }) => {\n  if (callLog.length === 0) {\n    return <p style={debugStyles.empty}>No callJob requests yet.</p>;\n  }\n  return (\n    <ol style={debugStyles.log}>\n      {callLog.map((entry) => (\n        <li key={entry.correlationId} style={debugStyles.logEntry}>\n          <strong>job {entry.jobIndex}</strong>\n          <pre style={debugStyles.pre}>\n            {JSON.stringify(entry.inputs, null, 2)}\n          </pre>\n        </li>\n      ))}\n    </ol>\n  );\n};\n\n// Inline styles keep the harness style-system-agnostic — consumers may not\n// ship Tailwind, and the panel shouldn't add a dependency.\nconst debugStyles = {\n  panel: {\n    position: 'fixed' as const,\n    right: 12,\n    top: 12,\n    width: 280,\n    zIndex: 99999,\n    background: '#0b0b14',\n    color: '#fff',\n    border: '1px solid #3a3a52',\n    borderRadius: 10,\n    boxShadow: '0 14px 32px rgba(0,0,0,0.4)',\n    fontFamily:\n      'ui-monospace, SFMono-Regular, Menlo, Monaco, \"Cascadia Code\", monospace',\n    fontSize: 12,\n  },\n  header: {\n    display: 'flex',\n    alignItems: 'center',\n    justifyContent: 'space-between',\n    padding: '8px 10px',\n    borderBottom: '1px solid #2a2a3e',\n  },\n  closeButton: {\n    background: 'none',\n    border: 'none',\n    color: '#fff',\n    fontSize: 18,\n    cursor: 'pointer',\n    lineHeight: 1,\n  },\n  tabs: {\n    display: 'flex',\n    borderBottom: '1px solid #2a2a3e',\n  },\n  tab: {\n    flex: 1,\n    background: 'none',\n    border: 'none',\n    color: '#a0a0c0',\n    padding: '6px 8px',\n    cursor: 'pointer',\n    fontSize: 11,\n    textTransform: 'uppercase' as const,\n  },\n  tabActive: {\n    color: '#fff',\n    borderBottom: '2px solid #818cf8',\n  },\n  body: {\n    padding: 10,\n    maxHeight: 320,\n    overflow: 'auto' as const,\n  },\n  label: {\n    display: 'block',\n    color: '#a0a0c0',\n    fontSize: 10,\n    marginBottom: 4,\n    marginTop: 6,\n    textTransform: 'uppercase' as const,\n  },\n  input: {\n    width: '100%',\n    background: '#15152a',\n    border: '1px solid #2a2a3e',\n    color: '#fff',\n    padding: '6px 8px',\n    borderRadius: 4,\n    fontFamily: 'inherit',\n    fontSize: 11,\n    boxSizing: 'border-box' as const,\n  },\n  buttonRow: { display: 'flex', gap: 6, marginTop: 8 },\n  primary: {\n    flex: 1,\n    background: '#4f46e5',\n    color: '#fff',\n    border: 'none',\n    padding: '6px 8px',\n    borderRadius: 4,\n    cursor: 'pointer',\n    fontSize: 11,\n    fontFamily: 'inherit',\n  },\n  secondary: {\n    flex: 1,\n    background: 'transparent',\n    color: '#a0a0c0',\n    border: '1px solid #3a3a52',\n    padding: '6px 8px',\n    borderRadius: 4,\n    cursor: 'pointer',\n    fontSize: 11,\n    fontFamily: 'inherit',\n  },\n  collapsedTrigger: {\n    position: 'fixed' as const,\n    right: 12,\n    top: 12,\n    zIndex: 99999,\n    padding: '6px 10px',\n    background: '#0b0b14',\n    border: '1px solid #3a3a52',\n    color: '#fff',\n    borderRadius: 6,\n    fontFamily: 'inherit',\n    fontSize: 11,\n    cursor: 'pointer',\n  },\n  log: { listStyle: 'none', padding: 0, margin: 0 },\n  logEntry: {\n    padding: 6,\n    borderBottom: '1px solid #2a2a3e',\n    fontSize: 11,\n  },\n  pre: {\n    margin: '4px 0 0',\n    color: '#a0a0c0',\n    fontSize: 10,\n    whiteSpace: 'pre-wrap' as const,\n    wordBreak: 'break-word' as const,\n  },\n  empty: { color: '#a0a0c0', fontSize: 11, margin: 0 },\n} as const;\n\nexport type { JobInputs };\n"],"mappings":";AAIA;AAAA,EAGE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAoWH,mBAEqB,KAFrB;AAjUG,SAAS,WAAW,QAAyB,CAAC,GAAmB;AACtE,SAAO;AAAA,IACL,SACE,MAAM,YAAY,SACd,+CACA,MAAM;AAAA,IACZ,SAAS,MAAM,WAAW;AAAA,IAC1B,aAAa,MAAM,eAAe,MAAM,YAAY;AAAA,EACtD;AACF;AAOO,SAAS,mBACd,QAA0B,CAAC,GACV;AACjB,SAAO;AAAA,IACL,aAAa,MAAM,eAAe;AAAA,IAClC,WAAW,MAAM,cAAc,SAAY,OAAO,MAAM;AAAA,IACxD,WACE,MAAM,aAAa;AAAA,MACjB;AAAA,QACE,SAAS;AAAA,QACT,YAAY;AAAA,QACZ,QAAQ;AAAA,MACV;AAAA,IACF;AAAA,IACF,MACE,MAAM,QAAQ;AAAA,MACZ,EAAE,OAAO,GAAG,MAAM,SAAS;AAAA,IAC7B;AAAA,IACF,MAAM,MAAM,QAAQ;AAAA,EACtB;AACF;AAmDO,IAAM,sBAAwC,CAAC;AAAA,EACpD,QAAQ;AAAA,EACR,SAAS,WAAW;AAAA,EACpB,UAAU,mBAAmB;AAAA,EAC7B;AAAA,EACA,iBAAiB;AAAA,EACjB;AACF,MAAM;AACJ,QAAM,CAAC,eAAe,gBAAgB,IAAI,SAAyB,MAAM;AACzE,QAAM,CAAC,gBAAgB,iBAAiB,IACtC,SAA0B,OAAO;AACnC,QAAM,CAAC,SAAS,UAAU,IAAI,SAA2B,CAAC,CAAC;AAC3D,QAAM,iBAAiB,OAAmC,SAAS;AACnE,iBAAe,UAAU;AACzB,QAAM,gBAAgB,OAAO,KAAK;AAMlC,YAAU,MAAM;AACd,UAAM,QAAQ,CAAC,YAA2B;AACxC,aAAO;AAAA,QACL,IAAI,aAAa,WAAW;AAAA,UAC1B,MAAM;AAAA,UACN,QAAQ;AAAA,QACV,CAAC;AAAA,MACH;AAAA,IACF;AAEA,UAAM,YAAY,MAAM;AACtB,YAAM,eAAwC;AAAA,QAC5C,MAAM;AAAA,QACN,aAAa,eAAe,eAAe;AAAA,QAC3C,WAAW,eAAe;AAAA,QAC1B,WAAW,eAAe;AAAA,QAC1B,MAAM,eAAe;AAAA,QACrB,MAAM,eAAe;AAAA,MACvB;AACA,YAAM,YAAY;AAElB,YAAM;AAAA,QACJ,MAAM;AAAA,QACN,SAAS,cAAc;AAAA,MACzB,CAAC;AACD,UAAI,cAAc,YAAY,MAAM;AAClC,cAAM;AAAA,UACJ,MAAM;AAAA,UACN,SAAS,cAAc;AAAA,QACzB,CAAC;AAAA,MACH;AAAA,IACF;AAEA,UAAM,UAAU,OAAO,UAAwB;AAK7C,UAAI,MAAM,WAAW,eAAgB;AACrC,YAAM,OAAO,MAAM;AACnB,UAAI,OAAO,SAAS,YAAY,SAAS,KAAM;AAC/C,YAAM,UAAU;AAEhB,cAAQ,QAAQ,MAAM;AAAA,QACpB,KAAK,wBAAwB;AAC3B,cAAI,CAAC,cAAc,SAAS;AAC1B,0BAAc,UAAU;AACxB,kBAAM;AAAA,cACJ,MAAM;AAAA,cACN;AAAA,cACA,iBAAiB;AAAA,YACnB,CAAC;AACD,sBAAU;AAAA,UACZ;AACA;AAAA,QACF;AAAA,QACA,KAAK,0BAA0B;AAC7B,cAAI,OAAO,QAAQ,kBAAkB,SAAU;AAC/C,gBAAM;AAAA,YACJ,MAAM;AAAA,YACN,eAAe,QAAQ;AAAA,YACvB,IAAI;AAAA,YACJ,MAAM;AAAA,cACJ,SACE,cAAc,WACb;AAAA,cACH,SAAS,cAAc,WAAW;AAAA,YACpC;AAAA,UACF,CAAC;AACD;AAAA,QACF;AAAA,QACA,KAAK,sBAAsB;AACzB,cAAI,OAAO,QAAQ,kBAAkB,SAAU;AAC/C,gBAAM,UAAU;AAChB,qBAAW,CAAC,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC;AAGvC,gBAAMA,WAAU,eAAe;AAC/B,cAAI,CAACA,UAAS;AACZ,kBAAM,SAAyB;AAAA,cAC7B,MAAM;AAAA,cACN,eAAe,QAAQ;AAAA,cACvB,QAAQ;AAAA,cACR,MAAM,EAAE,MAAM,QAAQ,OAAO;AAAA,YAC/B;AACA,kBAAM,MAAM;AACZ;AAAA,UACF;AACA,cAAI;AACF,kBAAM,UAAU,MAAMA,SAAQ,OAAO;AACrC,uBAAW,SAAS,QAAQ,UAAU,CAAC,GAAG;AACxC,oBAAM;AAAA,gBACJ,MAAM;AAAA,gBACN,eAAe,QAAQ;AAAA,gBACvB,QAAQ;AAAA,gBACR;AAAA,cACF,CAAC;AAAA,YACH;AACA,kBAAM;AAAA,cACJ,MAAM;AAAA,cACN,eAAe,QAAQ;AAAA,cACvB,QAAQ,QAAQ;AAAA,cAChB,GAAI,QAAQ,SAAS,SAAY,EAAE,MAAM,QAAQ,KAAK,IAAI,CAAC;AAAA,cAC3D,GAAI,QAAQ,UAAU,SAAY,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC;AAAA,YAChE,CAAC;AAAA,UACH,SAAS,KAAK;AACZ,kBAAM;AAAA,cACJ,MAAM;AAAA,cACN,eAAe,QAAQ;AAAA,cACvB,QAAQ;AAAA,cACR,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,YACxD,CAAC;AAAA,UACH;AACA;AAAA,QACF;AAAA;AAAA;AAAA,QAGA,KAAK,0BAA0B;AAC7B,cAAI,OAAO,QAAQ,kBAAkB,SAAU;AAC/C,gBAAM;AAAA,YACJ,MAAM;AAAA,YACN,eAAe,QAAQ;AAAA,YACvB,IAAI;AAAA,YACJ,MAAM,EAAE,WAAW,aAA8B;AAAA,UACnD,CAAC;AACD;AAAA,QACF;AAAA,QACA,KAAK,8BAA8B;AACjC,cAAI,OAAO,QAAQ,kBAAkB,SAAU;AAC/C,gBAAM;AAAA,YACJ,MAAM;AAAA,YACN,eAAe,QAAQ;AAAA,YACvB,IAAI;AAAA,YACJ,MAAM,EAAE,QAAS,OAAO,KAAK,OAAO,EAAE,EAAoB;AAAA,UAC5D,CAAC;AACD;AAAA,QACF;AAAA,QACA,KAAK,0BAA0B;AAC7B,cACE,OAAO,QAAQ,kBAAkB,YACjC,OAAQ,QAA4C,YAAY,UAChE;AACA;AAAA,UACF;AACA,gBAAM,UAAW,QAA2C;AAC5D,2BAAiB,CAAC,OAAO,EAAE,GAAG,GAAG,QAAQ,EAAE;AAC3C,gBAAM;AAAA,YACJ,MAAM;AAAA,YACN,eAAe,QAAQ;AAAA,YACvB,IAAI;AAAA,YACJ,MAAM,EAAE,QAAQ;AAAA,UAClB,CAAC;AACD;AAAA,QACF;AAAA,MACF;AAAA,IACF;AACA,WAAO,iBAAiB,WAAW,OAAO;AAC1C,WAAO,MAAM,OAAO,oBAAoB,WAAW,OAAO;AAAA,EAC5D,GAAG,CAAC,OAAO,eAAe,cAAc,CAAC;AAGzC,YAAU,MAAM;AACd,QAAI,CAAC,cAAc,QAAS;AAC5B,WAAO;AAAA,MACL,IAAI,aAAa,WAAW;AAAA,QAC1B,MAAM;AAAA,UACJ,MAAM;AAAA,UACN,SAAS,cAAc;AAAA,QACzB;AAAA,QACA,QAAQ;AAAA,MACV,CAAC;AAAA,IACH;AAAA,EACF,GAAG,CAAC,cAAc,OAAO,CAAC;AAE1B,YAAU,MAAM;AACd,QAAI,CAAC,cAAc,WAAW,cAAc,YAAY,KAAM;AAC9D,WAAO;AAAA,MACL,IAAI,aAAa,WAAW;AAAA,QAC1B,MAAM;AAAA,UACJ,MAAM;AAAA,UACN,SAAS,cAAc;AAAA,QACzB;AAAA,QACA,QAAQ;AAAA,MACV,CAAC;AAAA,IACH;AAAA,EACF,GAAG,CAAC,cAAc,OAAO,CAAC;AAE1B,YAAU,MAAM;AACd,QAAI,CAAC,cAAc,QAAS;AAC5B,WAAO;AAAA,MACL,IAAI,aAAa,WAAW;AAAA,QAC1B,MAAM;AAAA,UACJ,MAAM;AAAA,UACN,aAAa,eAAe,eAAe;AAAA,UAC3C,WAAW,eAAe;AAAA,UAC1B,WAAW,eAAe;AAAA,UAC1B,MAAM,eAAe;AAAA,UACrB,MAAM,eAAe;AAAA,QACvB;AAAA,QACA,QAAQ;AAAA,MACV,CAAC;AAAA,IACH;AAAA,EACF,GAAG,CAAC,cAAc,CAAC;AAEnB,QAAM,WAAW;AAAA,IACf,OAAO;AAAA,MACL,WAAW;AAAA,MACX,YAAY;AAAA,MACZ;AAAA,IACF;AAAA,IACA,CAAC,OAAO;AAAA,EACV;AAEA,SACE,iCACG;AAAA;AAAA,IACA,kBAAkB,oBAAC,cAAW,KAAK,UAAU;AAAA,KAChD;AAEJ;AAMO,IAAM,iBAAiB;AAI9B,IAAM,aAQD,CAAC,EAAE,IAAI,MAAM;AAChB,QAAM,CAAC,MAAM,OAAO,IAAI,SAAS,IAAI;AACrC,QAAM,CAAC,KAAK,MAAM,IAAI,SAAuC,QAAQ;AACrE,MAAI,CAAC,MAAM;AACT,WACE;AAAA,MAAC;AAAA;AAAA,QACC,MAAK;AAAA,QACL,SAAS,MAAM,QAAQ,IAAI;AAAA,QAC3B,OAAO,YAAY;AAAA,QACpB;AAAA;AAAA,IAED;AAAA,EAEJ;AACA,SACE,qBAAC,SAAI,OAAO,YAAY,OACtB;AAAA,yBAAC,YAAO,OAAO,YAAY,QACzB;AAAA,0BAAC,YAAO,OAAO,EAAE,UAAU,GAAG,GAAG,gCAAkB;AAAA,MACnD;AAAA,QAAC;AAAA;AAAA,UACC,MAAK;AAAA,UACL,SAAS,MAAM,QAAQ,KAAK;AAAA,UAC5B,OAAO,YAAY;AAAA,UACnB,cAAW;AAAA,UACZ;AAAA;AAAA,MAED;AAAA,OACF;AAAA,IACA,oBAAC,SAAI,OAAO,YAAY,MACpB,WAAC,UAAU,WAAW,KAAK,EAAY,IAAI,CAAC,MAC5C;AAAA,MAAC;AAAA;AAAA,QAEC,MAAK;AAAA,QACL,SAAS,MAAM,OAAO,CAAC;AAAA,QACvB,OAAO;AAAA,UACL,GAAG,YAAY;AAAA,UACf,GAAI,QAAQ,IAAI,YAAY,YAAY,CAAC;AAAA,QAC3C;AAAA,QAEC;AAAA;AAAA,MARI;AAAA,IASP,CACD,GACH;AAAA,IACA,qBAAC,SAAI,OAAO,YAAY,MACrB;AAAA,cAAQ,YAAY,oBAAC,aAAU,KAAU;AAAA,MACzC,QAAQ,aAAa,oBAAC,cAAW,KAAU;AAAA,MAC3C,QAAQ,SAAS,oBAAC,cAAW,SAAS,IAAI,SAAS;AAAA,OACtD;AAAA,KACF;AAEJ;AAEA,IAAM,YAED,CAAC,EAAE,IAAI,MAAM;AAChB,QAAM,CAAC,SAAS,eAAe,IAAI;AAAA,IACjC;AAAA,EACF;AACA,QAAM,CAAC,SAAS,eAAe,IAAI,SAAS,OAAO;AACnD,QAAM,eAAe,YAAY,MAAM;AACrC,QAAI,UAAU;AAAA,MACZ;AAAA,MACA,SAAS,OAAO,OAAO,KAAK;AAAA,MAC5B,aAAa;AAAA,IACf,CAAC;AAAA,EACH,GAAG,CAAC,SAAS,SAAS,GAAG,CAAC;AAC1B,QAAM,aAAa,YAAY,MAAM;AACnC,QAAI,UAAU,EAAE,SAAS,MAAM,SAAS,MAAM,aAAa,MAAM,CAAC;AAAA,EACpE,GAAG,CAAC,GAAG,CAAC;AACR,SACE,qBAAC,SACC;AAAA,wBAAC,WAAM,OAAO,YAAY,OAAO,qBAAO;AAAA,IACxC;AAAA,MAAC;AAAA;AAAA,QACC,OAAO;AAAA,QACP,UAAU,CAAC,MAAM,gBAAgB,EAAE,OAAO,KAAK;AAAA,QAC/C,OAAO,YAAY;AAAA;AAAA,IACrB;AAAA,IACA,oBAAC,WAAM,OAAO,YAAY,OAAO,sBAAQ;AAAA,IACzC;AAAA,MAAC;AAAA;AAAA,QACC,OAAO;AAAA,QACP,UAAU,CAAC,MAAM,gBAAgB,EAAE,OAAO,KAAK;AAAA,QAC/C,OAAO,YAAY;AAAA;AAAA,IACrB;AAAA,IACA,qBAAC,SAAI,OAAO,YAAY,WACtB;AAAA,0BAAC,YAAO,MAAK,UAAS,SAAS,cAAc,OAAO,YAAY,SAAS,2BAEzE;AAAA,MACA,oBAAC,YAAO,MAAK,UAAS,SAAS,YAAY,OAAO,YAAY,WAAW,wBAEzE;AAAA,OACF;AAAA,KACF;AAEJ;AAEA,IAAM,aAMD,CAAC,EAAE,IAAI,MAAM;AAChB,QAAM,CAAC,WAAW,iBAAiB,IAAI,SAAS,GAAG;AACnD,QAAM,CAAC,aAAa,mBAAmB,IAAI,SAAS,GAAG;AACvD,QAAM,QAAQ,YAAY,MAAM;AAC9B,QAAI,WAAW,CAAC,UAAU;AAAA,MACxB,GAAG;AAAA,MACH,WAAW,aAAa;AAAA,MACxB;AAAA,IACF,EAAE;AAAA,EACJ,GAAG,CAAC,KAAK,WAAW,WAAW,CAAC;AAChC,QAAM,eAAe,YAAY,MAAM;AACrC,QAAI,WAAW,CAAC,UAAU,EAAE,GAAG,MAAM,WAAW,KAAK,EAAE;AAAA,EACzD,GAAG,CAAC,GAAG,CAAC;AACR,SACE,qBAAC,SACC;AAAA,wBAAC,WAAM,OAAO,YAAY,OAAO,0BAAY;AAAA,IAC7C;AAAA,MAAC;AAAA;AAAA,QACC,OAAO;AAAA,QACP,UAAU,CAAC,MAAM,oBAAoB,EAAE,OAAO,KAAK;AAAA,QACnD,OAAO,YAAY;AAAA;AAAA,IACrB;AAAA,IACA,oBAAC,WAAM,OAAO,YAAY,OAAO,+CAAiC;AAAA,IAClE;AAAA,MAAC;AAAA;AAAA,QACC,OAAO;AAAA,QACP,UAAU,CAAC,MAAM,kBAAkB,EAAE,OAAO,KAAK;AAAA,QACjD,OAAO,YAAY;AAAA;AAAA,IACrB;AAAA,IACA,qBAAC,SAAI,OAAO,YAAY,WACtB;AAAA,0BAAC,YAAO,MAAK,UAAS,SAAS,OAAO,OAAO,YAAY,SAAS,mBAElE;AAAA,MACA,oBAAC,YAAO,MAAK,UAAS,SAAS,cAAc,OAAO,YAAY,WAAW,2BAE3E;AAAA,OACF;AAAA,KACF;AAEJ;AAEA,IAAM,aAAyD,CAAC,EAAE,QAAQ,MAAM;AAC9E,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO,oBAAC,OAAE,OAAO,YAAY,OAAO,sCAAwB;AAAA,EAC9D;AACA,SACE,oBAAC,QAAG,OAAO,YAAY,KACpB,kBAAQ,IAAI,CAAC,UACZ,qBAAC,QAA6B,OAAO,YAAY,UAC/C;AAAA,yBAAC,YAAO;AAAA;AAAA,MAAK,MAAM;AAAA,OAAS;AAAA,IAC5B,oBAAC,SAAI,OAAO,YAAY,KACrB,eAAK,UAAU,MAAM,QAAQ,MAAM,CAAC,GACvC;AAAA,OAJO,MAAM,aAKf,CACD,GACH;AAEJ;AAIA,IAAM,cAAc;AAAA,EAClB,OAAO;AAAA,IACL,UAAU;AAAA,IACV,OAAO;AAAA,IACP,KAAK;AAAA,IACL,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,YAAY;AAAA,IACZ,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,cAAc;AAAA,IACd,WAAW;AAAA,IACX,YACE;AAAA,IACF,UAAU;AAAA,EACZ;AAAA,EACA,QAAQ;AAAA,IACN,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,gBAAgB;AAAA,IAChB,SAAS;AAAA,IACT,cAAc;AAAA,EAChB;AAAA,EACA,aAAa;AAAA,IACX,YAAY;AAAA,IACZ,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,UAAU;AAAA,IACV,QAAQ;AAAA,IACR,YAAY;AAAA,EACd;AAAA,EACA,MAAM;AAAA,IACJ,SAAS;AAAA,IACT,cAAc;AAAA,EAChB;AAAA,EACA,KAAK;AAAA,IACH,MAAM;AAAA,IACN,YAAY;AAAA,IACZ,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,eAAe;AAAA,EACjB;AAAA,EACA,WAAW;AAAA,IACT,OAAO;AAAA,IACP,cAAc;AAAA,EAChB;AAAA,EACA,MAAM;AAAA,IACJ,SAAS;AAAA,IACT,WAAW;AAAA,IACX,UAAU;AAAA,EACZ;AAAA,EACA,OAAO;AAAA,IACL,SAAS;AAAA,IACT,OAAO;AAAA,IACP,UAAU;AAAA,IACV,cAAc;AAAA,IACd,WAAW;AAAA,IACX,eAAe;AAAA,EACjB;AAAA,EACA,OAAO;AAAA,IACL,OAAO;AAAA,IACP,YAAY;AAAA,IACZ,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,SAAS;AAAA,IACT,cAAc;AAAA,IACd,YAAY;AAAA,IACZ,UAAU;AAAA,IACV,WAAW;AAAA,EACb;AAAA,EACA,WAAW,EAAE,SAAS,QAAQ,KAAK,GAAG,WAAW,EAAE;AAAA,EACnD,SAAS;AAAA,IACP,MAAM;AAAA,IACN,YAAY;AAAA,IACZ,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,cAAc;AAAA,IACd,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,YAAY;AAAA,EACd;AAAA,EACA,WAAW;AAAA,IACT,MAAM;AAAA,IACN,YAAY;AAAA,IACZ,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,cAAc;AAAA,IACd,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,YAAY;AAAA,EACd;AAAA,EACA,kBAAkB;AAAA,IAChB,UAAU;AAAA,IACV,OAAO;AAAA,IACP,KAAK;AAAA,IACL,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,cAAc;AAAA,IACd,YAAY;AAAA,IACZ,UAAU;AAAA,IACV,QAAQ;AAAA,EACV;AAAA,EACA,KAAK,EAAE,WAAW,QAAQ,SAAS,GAAG,QAAQ,EAAE;AAAA,EAChD,UAAU;AAAA,IACR,SAAS;AAAA,IACT,cAAc;AAAA,IACd,UAAU;AAAA,EACZ;AAAA,EACA,KAAK;AAAA,IACH,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,UAAU;AAAA,IACV,YAAY;AAAA,IACZ,WAAW;AAAA,EACb;AAAA,EACA,OAAO,EAAE,OAAO,WAAW,UAAU,IAAI,QAAQ,EAAE;AACrD;","names":["handler"]}
+{"version":3,"sources":["../../src/iframe/testing.tsx"],"sourcesContent":["// Testing harness for iframe blueprints. The promise of the SDK is that\n// publishers can iterate on their UI without running the Tangle Cloud dapp\n// — these utilities are what makes that true.\n\nimport {\n  type FC,\n  type ReactNode,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport type { Address } from 'viem';\n\nimport type {\n  ServiceSnapshot,\n  WalletSnapshot,\n} from './tangleIframeClient';\nimport type {\n  CallJobRequest,\n  JobInputs,\n  JobResultEvent,\n  ParentMessage,\n  ServiceContextBroadcast,\n  ServiceContextJob,\n  ServiceContextOperator,\n} from '../wallet/parentBridgeProtocol';\n\nexport type MockWalletInput = Partial<{\n  address: Address | null;\n  chainId: number;\n  isConnected: boolean;\n}>;\n\nexport type MockServiceInput = Partial<{\n  blueprintId: string;\n  serviceId: string | null;\n  operators: readonly ServiceContextOperator[];\n  jobs: readonly ServiceContextJob[];\n  mode: string | null;\n  chain: import('../wallet/parentBridgeProtocol').ChainContext | null;\n}>;\n\n/**\n * Construct a deterministic wallet snapshot for tests. Defaults:\n * connected, vitalik.eth's address, Base Sepolia (84532).\n */\nexport function mockWallet(input: MockWalletInput = {}): WalletSnapshot {\n  return {\n    address:\n      input.address === undefined\n        ? '0xd8da6bf26964af9d7eed9e03e53415d37aa96045'\n        : input.address,\n    chainId: input.chainId ?? 84532,\n    isConnected: input.isConnected ?? input.address !== null,\n  };\n}\n\n/**\n * Construct a deterministic service snapshot for tests. Defaults: blueprint\n * id `0`, no service deployed yet (serviceId null), single mock operator on\n * the canonical local sidecar URL.\n */\nexport function mockServiceContext(\n  input: MockServiceInput = {},\n): ServiceSnapshot {\n  return {\n    blueprintId: input.blueprintId ?? '0',\n    serviceId: input.serviceId === undefined ? null : input.serviceId,\n    operators:\n      input.operators ?? [\n        {\n          address: '0x70997970C51812dc3A010C7d01b50e0d17dc79C8',\n          rpcAddress: 'http://localhost:8545',\n          status: 'active',\n        },\n      ],\n    jobs:\n      input.jobs ?? [\n        { index: 0, name: 'invoke' },\n      ],\n    mode: input.mode ?? null,\n    chain:\n      input.chain === undefined\n        ? {\n            id: 84532,\n            name: 'Base Sepolia',\n            rpcUrl: 'https://sepolia.base.org',\n            blockExplorerUrl: 'https://sepolia.basescan.org',\n            nativeCurrency: { name: 'Sepolia Ether', symbol: 'ETH', decimals: 18 },\n          }\n        : input.chain,\n  };\n}\n\nexport type CallJobHandler = (\n  request: CallJobRequest,\n) => Promise<{\n  status: 'success' | 'error';\n  data?: unknown;\n  error?: string;\n  /** Streaming chunks emitted in order before the terminal status. */\n  chunks?: readonly unknown[];\n}>;\n\ntype HarnessProps = {\n  appId?: string;\n  wallet?: WalletSnapshot;\n  service?: ServiceSnapshot;\n  /** Override callJob behavior. Default: returns a static `{ ok: true }`. */\n  onCallJob?: CallJobHandler;\n  /** Surface a floating debug panel that lets the developer flip state at runtime. */\n  showDebugPanel?: boolean;\n  children: ReactNode;\n};\n\n/**\n * Drop-in parent simulator for tests + storybook + standalone dev. Wraps\n * children in a fake parent that:\n *\n *   - Acks the iframe's handshake immediately\n *   - Broadcasts the configured wallet + service context on mount\n *   - Intercepts `callJob` requests and routes them through `onCallJob`\n *   - (Optional) Mounts a floating debug panel so the developer can\n *     mutate state at runtime: change account, switch chain, set\n *     serviceId, fire a custom job\n *\n * The harness runs in the same JS context as the iframe app — there's no\n * cross-frame postMessage, just same-window event dispatch. That keeps it\n * fully synchronous + assertable, but the messages still flow through the\n * exact same protocol surface the production bridge uses.\n *\n * Usage:\n *\n *   <TangleParentHarness wallet={mockWallet()} service={mockServiceContext()}>\n *     <TangleIframeProvider appId=\"my-app\" mode=\"bridge\" parentOrigin=\"harness://\">\n *       <App />\n *     </TangleIframeProvider>\n *   </TangleParentHarness>\n *\n * Set `mode=\"bridge\"` + `parentOrigin=\"harness://\"` on the provider so it\n * matches the harness's synthetic origin. In production, use `mode=\"auto\"`\n * (the default).\n */\nexport const TangleParentHarness: FC<HarnessProps> = ({\n  appId = 'harness',\n  wallet = mockWallet(),\n  service = mockServiceContext(),\n  onCallJob,\n  showDebugPanel = false,\n  children,\n}) => {\n  const [currentWallet, setCurrentWallet] = useState<WalletSnapshot>(wallet);\n  const [currentService, setCurrentService] =\n    useState<ServiceSnapshot>(service);\n  const [callLog, setCallLog] = useState<CallJobRequest[]>([]);\n  const callJobHandler = useRef<CallJobHandler | undefined>(onCallJob);\n  callJobHandler.current = onCallJob;\n  const seenHandshake = useRef(false);\n\n  // Bridge the iframe → \"parent\" channel. The SDK posts via\n  // `window.parent.postMessage(msg, parentOrigin)`. In a real iframe that\n  // crosses a window boundary; in the harness both live in one window, where\n  // a same-window `postMessage` with a synthetic targetOrigin is *not*\n  // delivered (the origin won't match the document's real origin in jsdom /\n  // happy-dom / a real browser). So we intercept `window.parent.postMessage`\n  // directly — identical to how production parents receive frames, minus the\n  // window hop. Replies still travel back as dispatched `message` events\n  // tagged with HARNESS_ORIGIN, which the SDK's listener filters for.\n  useEffect(() => {\n    const reply = (message: ParentMessage) => {\n      window.dispatchEvent(\n        new MessageEvent('message', {\n          data: message,\n          origin: HARNESS_ORIGIN,\n        }),\n      );\n    };\n\n    const broadcast = () => {\n      const broadcastMsg: ServiceContextBroadcast = {\n        kind: 'tangle.app.serviceContext',\n        blueprintId: currentService.blueprintId ?? '0',\n        serviceId: currentService.serviceId,\n        operators: currentService.operators,\n        jobs: currentService.jobs,\n        mode: currentService.mode,\n        ...(currentService.chain !== null\n          ? { chain: currentService.chain }\n          : {}),\n      };\n      reply(broadcastMsg);\n      // Also broadcast wallet — combined into accountChanged + chainChanged.\n      reply({\n        kind: 'tangle.app.accountChanged',\n        account: currentWallet.address,\n      });\n      if (currentWallet.chainId !== null) {\n        reply({\n          kind: 'tangle.app.chainChanged',\n          chainId: currentWallet.chainId,\n        });\n      }\n    };\n\n    const handleInbound = async (data: unknown) => {\n      if (typeof data !== 'object' || data === null) return;\n      const message = data as { kind?: string; correlationId?: string };\n\n      switch (message.kind) {\n        case 'tangle.app.handshake': {\n          if (!seenHandshake.current) {\n            seenHandshake.current = true;\n            reply({\n              kind: 'tangle.app.handshakeAck',\n              appId,\n              protocolVersion: '1',\n            });\n            broadcast();\n          }\n          return;\n        }\n        case 'tangle.app.readAccount': {\n          if (typeof message.correlationId !== 'string') return;\n          reply({\n            kind: 'tangle.app.readAccountResult',\n            correlationId: message.correlationId,\n            ok: true,\n            data: {\n              account:\n                currentWallet.address ??\n                ('0x0000000000000000000000000000000000000000' as Address),\n              chainId: currentWallet.chainId ?? 0,\n            },\n          });\n          return;\n        }\n        case 'tangle.app.callJob': {\n          if (typeof message.correlationId !== 'string') return;\n          const request = message as unknown as CallJobRequest;\n          setCallLog((prev) => [...prev, request]);\n          // Default behavior when no handler: emit a single `success` with\n          // a echo of the inputs so UIs render *something* in dev mode.\n          const handler = callJobHandler.current;\n          if (!handler) {\n            const result: JobResultEvent = {\n              kind: 'tangle.app.jobResult',\n              correlationId: request.correlationId,\n              status: 'success',\n              data: { echo: request.inputs },\n            };\n            reply(result);\n            return;\n          }\n          try {\n            const outcome = await handler(request);\n            for (const chunk of outcome.chunks ?? []) {\n              reply({\n                kind: 'tangle.app.jobResult',\n                correlationId: request.correlationId,\n                status: 'streaming',\n                chunk,\n              });\n            }\n            reply({\n              kind: 'tangle.app.jobResult',\n              correlationId: request.correlationId,\n              status: outcome.status,\n              ...(outcome.data !== undefined ? { data: outcome.data } : {}),\n              ...(outcome.error !== undefined ? { error: outcome.error } : {}),\n            });\n          } catch (err) {\n            reply({\n              kind: 'tangle.app.jobResult',\n              correlationId: request.correlationId,\n              status: 'error',\n              error: err instanceof Error ? err.message : String(err),\n            });\n          }\n          return;\n        }\n        // Wallet ops respond optimistically — tests that want to assert\n        // specific signatures should pre-set them via the dev handler.\n        case 'tangle.app.signMessage': {\n          if (typeof message.correlationId !== 'string') return;\n          reply({\n            kind: 'tangle.app.signMessageResult',\n            correlationId: message.correlationId,\n            ok: true,\n            data: { signature: '0xdeadbeef' as `0x${string}` },\n          });\n          return;\n        }\n        case 'tangle.app.signTypedData': {\n          if (typeof message.correlationId !== 'string') return;\n          // The harness signs deterministically — production parents show\n          // an approval modal first. Tests that need to assert the\n          // typed-data payload should inspect callLog (extend later if\n          // needed) or pass a custom onSignTypedData handler.\n          reply({\n            kind: 'tangle.app.signTypedDataResult',\n            correlationId: message.correlationId,\n            ok: true,\n            data: {\n              signature: ('0x' + '11'.repeat(65)) as `0x${string}`,\n            },\n          });\n          return;\n        }\n        case 'tangle.app.signTransaction': {\n          if (typeof message.correlationId !== 'string') return;\n          reply({\n            kind: 'tangle.app.signTransactionResult',\n            correlationId: message.correlationId,\n            ok: true,\n            data: { txHash: ('0x' + '00'.repeat(32)) as `0x${string}` },\n          });\n          return;\n        }\n        case 'tangle.app.switchChain': {\n          if (\n            typeof message.correlationId !== 'string' ||\n            typeof (message as unknown as { chainId?: number }).chainId !== 'number'\n          ) {\n            return;\n          }\n          const chainId = (message as unknown as { chainId: number }).chainId;\n          setCurrentWallet((w) => ({ ...w, chainId }));\n          reply({\n            kind: 'tangle.app.switchChainResult',\n            correlationId: message.correlationId,\n            ok: true,\n            data: { chainId },\n          });\n          return;\n        }\n      }\n    };\n\n    // Route the iframe's outbound posts straight into the handler. We expose\n    // only `postMessage` — the SDK never touches other `window.parent`\n    // members — and restore the original on teardown.\n    const originalParent = window.parent;\n    const proxyParent = {\n      postMessage: (message: unknown) => {\n        void handleInbound(message);\n      },\n    } as unknown as Window;\n    Object.defineProperty(window, 'parent', {\n      configurable: true,\n      get: () => proxyParent,\n    });\n    return () => {\n      Object.defineProperty(window, 'parent', {\n        configurable: true,\n        value: originalParent,\n      });\n    };\n  }, [appId, currentWallet, currentService]);\n\n  // Re-broadcast when state changes.\n  useEffect(() => {\n    if (!seenHandshake.current) return;\n    window.dispatchEvent(\n      new MessageEvent('message', {\n        data: {\n          kind: 'tangle.app.accountChanged',\n          account: currentWallet.address,\n        },\n        origin: HARNESS_ORIGIN,\n      }),\n    );\n  }, [currentWallet.address]);\n\n  useEffect(() => {\n    if (!seenHandshake.current || currentWallet.chainId === null) return;\n    window.dispatchEvent(\n      new MessageEvent('message', {\n        data: {\n          kind: 'tangle.app.chainChanged',\n          chainId: currentWallet.chainId,\n        },\n        origin: HARNESS_ORIGIN,\n      }),\n    );\n  }, [currentWallet.chainId]);\n\n  useEffect(() => {\n    if (!seenHandshake.current) return;\n    window.dispatchEvent(\n      new MessageEvent('message', {\n        data: {\n          kind: 'tangle.app.serviceContext',\n          blueprintId: currentService.blueprintId ?? '0',\n          serviceId: currentService.serviceId,\n          operators: currentService.operators,\n          jobs: currentService.jobs,\n          mode: currentService.mode,\n          ...(currentService.chain !== null\n            ? { chain: currentService.chain }\n            : {}),\n        },\n        origin: HARNESS_ORIGIN,\n      }),\n    );\n  }, [currentService]);\n\n  const debugApi = useMemo(\n    () => ({\n      setWallet: setCurrentWallet,\n      setService: setCurrentService,\n      callLog,\n    }),\n    [callLog],\n  );\n\n  return (\n    <>\n      {children}\n      {showDebugPanel && <DebugPanel api={debugApi} />}\n    </>\n  );\n};\n\n/**\n * Synthetic origin every harness instance uses. Stable across tests so the\n * iframe SDK + the harness can pin to the same string.\n */\nexport const HARNESS_ORIGIN = 'harness://tangle.local';\n\n// ── Debug panel ──────────────────────────────────────────────────────────────\n\nconst DebugPanel: FC<{\n  api: {\n    setWallet: (w: WalletSnapshot | ((prev: WalletSnapshot) => WalletSnapshot)) => void;\n    setService: (\n      s: ServiceSnapshot | ((prev: ServiceSnapshot) => ServiceSnapshot),\n    ) => void;\n    callLog: readonly CallJobRequest[];\n  };\n}> = ({ api }) => {\n  const [open, setOpen] = useState(true);\n  const [tab, setTab] = useState<'wallet' | 'service' | 'log'>('wallet');\n  if (!open) {\n    return (\n      <button\n        type=\"button\"\n        onClick={() => setOpen(true)}\n        style={debugStyles.collapsedTrigger}\n      >\n        Debug\n      </button>\n    );\n  }\n  return (\n    <div style={debugStyles.panel}>\n      <header style={debugStyles.header}>\n        <strong style={{ fontSize: 11 }}>TANGLE DEV HARNESS</strong>\n        <button\n          type=\"button\"\n          onClick={() => setOpen(false)}\n          style={debugStyles.closeButton}\n          aria-label=\"Close debug panel\"\n        >\n          ×\n        </button>\n      </header>\n      <nav style={debugStyles.tabs}>\n        {(['wallet', 'service', 'log'] as const).map((t) => (\n          <button\n            key={t}\n            type=\"button\"\n            onClick={() => setTab(t)}\n            style={{\n              ...debugStyles.tab,\n              ...(tab === t ? debugStyles.tabActive : {}),\n            }}\n          >\n            {t}\n          </button>\n        ))}\n      </nav>\n      <div style={debugStyles.body}>\n        {tab === 'wallet' && <WalletTab api={api} />}\n        {tab === 'service' && <ServiceTab api={api} />}\n        {tab === 'log' && <CallLogTab callLog={api.callLog} />}\n      </div>\n    </div>\n  );\n};\n\nconst WalletTab: FC<{\n  api: { setWallet: (w: WalletSnapshot | ((prev: WalletSnapshot) => WalletSnapshot)) => void };\n}> = ({ api }) => {\n  const [address, setAddressInput] = useState(\n    '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',\n  );\n  const [chainId, setChainIdInput] = useState('84532');\n  const applyConnect = useCallback(() => {\n    api.setWallet({\n      address: address as Address,\n      chainId: Number(chainId) || null,\n      isConnected: true,\n    });\n  }, [address, chainId, api]);\n  const disconnect = useCallback(() => {\n    api.setWallet({ address: null, chainId: null, isConnected: false });\n  }, [api]);\n  return (\n    <div>\n      <label style={debugStyles.label}>address</label>\n      <input\n        value={address}\n        onChange={(e) => setAddressInput(e.target.value)}\n        style={debugStyles.input}\n      />\n      <label style={debugStyles.label}>chain id</label>\n      <input\n        value={chainId}\n        onChange={(e) => setChainIdInput(e.target.value)}\n        style={debugStyles.input}\n      />\n      <div style={debugStyles.buttonRow}>\n        <button type=\"button\" onClick={applyConnect} style={debugStyles.primary}>\n          Set connected\n        </button>\n        <button type=\"button\" onClick={disconnect} style={debugStyles.secondary}>\n          Disconnect\n        </button>\n      </div>\n    </div>\n  );\n};\n\nconst ServiceTab: FC<{\n  api: {\n    setService: (\n      s: ServiceSnapshot | ((prev: ServiceSnapshot) => ServiceSnapshot),\n    ) => void;\n  };\n}> = ({ api }) => {\n  const [serviceId, setServiceIdInput] = useState('1');\n  const [blueprintId, setBlueprintIdInput] = useState('0');\n  const apply = useCallback(() => {\n    api.setService((prev) => ({\n      ...prev,\n      serviceId: serviceId || null,\n      blueprintId,\n    }));\n  }, [api, serviceId, blueprintId]);\n  const clearService = useCallback(() => {\n    api.setService((prev) => ({ ...prev, serviceId: null }));\n  }, [api]);\n  return (\n    <div>\n      <label style={debugStyles.label}>blueprint id</label>\n      <input\n        value={blueprintId}\n        onChange={(e) => setBlueprintIdInput(e.target.value)}\n        style={debugStyles.input}\n      />\n      <label style={debugStyles.label}>service id (empty = not deployed)</label>\n      <input\n        value={serviceId}\n        onChange={(e) => setServiceIdInput(e.target.value)}\n        style={debugStyles.input}\n      />\n      <div style={debugStyles.buttonRow}>\n        <button type=\"button\" onClick={apply} style={debugStyles.primary}>\n          Apply\n        </button>\n        <button type=\"button\" onClick={clearService} style={debugStyles.secondary}>\n          Clear service\n        </button>\n      </div>\n    </div>\n  );\n};\n\nconst CallLogTab: FC<{ callLog: readonly CallJobRequest[] }> = ({ callLog }) => {\n  if (callLog.length === 0) {\n    return <p style={debugStyles.empty}>No callJob requests yet.</p>;\n  }\n  return (\n    <ol style={debugStyles.log}>\n      {callLog.map((entry) => (\n        <li key={entry.correlationId} style={debugStyles.logEntry}>\n          <strong>job {entry.jobIndex}</strong>\n          <pre style={debugStyles.pre}>\n            {JSON.stringify(entry.inputs, null, 2)}\n          </pre>\n        </li>\n      ))}\n    </ol>\n  );\n};\n\n// Inline styles keep the harness style-system-agnostic — consumers may not\n// ship Tailwind, and the panel shouldn't add a dependency.\nconst debugStyles = {\n  panel: {\n    position: 'fixed' as const,\n    right: 12,\n    top: 12,\n    width: 280,\n    zIndex: 99999,\n    background: '#0b0b14',\n    color: '#fff',\n    border: '1px solid #3a3a52',\n    borderRadius: 10,\n    boxShadow: '0 14px 32px rgba(0,0,0,0.4)',\n    fontFamily:\n      'ui-monospace, SFMono-Regular, Menlo, Monaco, \"Cascadia Code\", monospace',\n    fontSize: 12,\n  },\n  header: {\n    display: 'flex',\n    alignItems: 'center',\n    justifyContent: 'space-between',\n    padding: '8px 10px',\n    borderBottom: '1px solid #2a2a3e',\n  },\n  closeButton: {\n    background: 'none',\n    border: 'none',\n    color: '#fff',\n    fontSize: 18,\n    cursor: 'pointer',\n    lineHeight: 1,\n  },\n  tabs: {\n    display: 'flex',\n    borderBottom: '1px solid #2a2a3e',\n  },\n  tab: {\n    flex: 1,\n    background: 'none',\n    border: 'none',\n    color: '#a0a0c0',\n    padding: '6px 8px',\n    cursor: 'pointer',\n    fontSize: 11,\n    textTransform: 'uppercase' as const,\n  },\n  tabActive: {\n    color: '#fff',\n    borderBottom: '2px solid #818cf8',\n  },\n  body: {\n    padding: 10,\n    maxHeight: 320,\n    overflow: 'auto' as const,\n  },\n  label: {\n    display: 'block',\n    color: '#a0a0c0',\n    fontSize: 10,\n    marginBottom: 4,\n    marginTop: 6,\n    textTransform: 'uppercase' as const,\n  },\n  input: {\n    width: '100%',\n    background: '#15152a',\n    border: '1px solid #2a2a3e',\n    color: '#fff',\n    padding: '6px 8px',\n    borderRadius: 4,\n    fontFamily: 'inherit',\n    fontSize: 11,\n    boxSizing: 'border-box' as const,\n  },\n  buttonRow: { display: 'flex', gap: 6, marginTop: 8 },\n  primary: {\n    flex: 1,\n    background: '#4f46e5',\n    color: '#fff',\n    border: 'none',\n    padding: '6px 8px',\n    borderRadius: 4,\n    cursor: 'pointer',\n    fontSize: 11,\n    fontFamily: 'inherit',\n  },\n  secondary: {\n    flex: 1,\n    background: 'transparent',\n    color: '#a0a0c0',\n    border: '1px solid #3a3a52',\n    padding: '6px 8px',\n    borderRadius: 4,\n    cursor: 'pointer',\n    fontSize: 11,\n    fontFamily: 'inherit',\n  },\n  collapsedTrigger: {\n    position: 'fixed' as const,\n    right: 12,\n    top: 12,\n    zIndex: 99999,\n    padding: '6px 10px',\n    background: '#0b0b14',\n    border: '1px solid #3a3a52',\n    color: '#fff',\n    borderRadius: 6,\n    fontFamily: 'inherit',\n    fontSize: 11,\n    cursor: 'pointer',\n  },\n  log: { listStyle: 'none', padding: 0, margin: 0 },\n  logEntry: {\n    padding: 6,\n    borderBottom: '1px solid #2a2a3e',\n    fontSize: 11,\n  },\n  pre: {\n    margin: '4px 0 0',\n    color: '#a0a0c0',\n    fontSize: 10,\n    whiteSpace: 'pre-wrap' as const,\n    wordBreak: 'break-word' as const,\n  },\n  empty: { color: '#a0a0c0', fontSize: 11, margin: 0 },\n} as const;\n\nexport type { JobInputs };\n"],"mappings":"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","names":[]}

package/dist/{parentBridgeProtocol-CqK9e6Fk.d.ts → parentBridgeProtocol-BS2zbIvX.d.ts}

@@ -30,6 +30,28 @@ type SignTransactionRequest = {
     data: Hex;
     value?: string;
 };
+type SignTypedDataRequest = {
+    kind: 'tangle.app.signTypedData';
+    correlationId: string;
+    chainId: number;
+    domain: Readonly<{
+        name?: string;
+        version?: string;
+        chainId?: number;
+        verifyingContract?: Address;
+        salt?: Hex;
+    }>;
+    /** EIP-712 types map; do NOT include the EIP712Domain entry (the parent
+     * injects it derived from `domain`). */
+    types: Readonly<Record<string, ReadonlyArray<{
+        name: string;
+        type: string;
+    }>>>;
+    /** Top-level type name in `types` whose values appear in `message`. */
+    primaryType: string;
+    /** The actual typed-data values. Shape matches `types[primaryType]`. */
+    message: Readonly<Record<string, unknown>>;
+};
 type HandshakeAck = {
     kind: 'tangle.app.handshakeAck';
     appId: string;
@@ -65,6 +87,11 @@ type SignTransactionResult = {
 } & ResultEnvelope<{
     txHash: Hex;
 }>;
+type SignTypedDataResult = {
+    kind: 'tangle.app.signTypedDataResult';
+} & ResultEnvelope<{
+    signature: Hex;
+}>;
 type AccountChanged = {
     kind: 'tangle.app.accountChanged';
     account: Address | null;
@@ -83,6 +110,33 @@ type ServiceContextJob = {
     readonly name: string;
     readonly inputSchema?: unknown;
 };
+/**
+ * Chain configuration the parent broadcasts to the iframe along with
+ * service context. Iframes use this to build a `viem` public client for
+ * READ-ONLY queries (`useTanglePublicClient` is the convenience hook).
+ *
+ * Iframes can ignore this and roll their own RPC config — particularly
+ * when they need to read from chains OTHER than the active one (e.g. a
+ * trading dapp pulling oracle data from mainnet while the active service
+ * lives on Base Sepolia). The injected client is a hint, not a constraint.
+ *
+ * `rpcUrl` is the public RPC the parent uses, NOT a wallet RPC. Iframes
+ * cannot sign or submit with this URL; signing always routes upstream via
+ * the bridge.
+ */
+type ChainContext = {
+    readonly id: number;
+    readonly name: string;
+    readonly rpcUrl: string;
+    /** Block-explorer base URL — useful for rendering tx links. */
+    readonly blockExplorerUrl?: string;
+    /** Native currency metadata for cost displays. */
+    readonly nativeCurrency?: {
+        readonly name: string;
+        readonly symbol: string;
+        readonly decimals: number;
+    };
+};
 type ServiceContextBroadcast = {
     kind: 'tangle.app.serviceContext';
     readonly blueprintId: string;
@@ -90,6 +144,10 @@ type ServiceContextBroadcast = {
     readonly operators: readonly ServiceContextOperator[];
     readonly jobs: readonly ServiceContextJob[];
     readonly mode: string | null;
+    /** Active chain the parent is connected to; iframes can build a viem
+     * publicClient against this for convenience. Optional for backwards
+     * compatibility with parents that haven't been upgraded yet. */
+    readonly chain?: ChainContext;
 };
 type JobInputs = Readonly<Record<string, unknown>>;
 type CallJobRequest = {
@@ -123,8 +181,8 @@ type JobResultEvent = {
         readonly eta_ms?: number;
     };
 };
-type ParentMessage = HandshakeAck | ReadAccountResult | SwitchChainResult | SignMessageResult | SignTransactionResult | AccountChanged | ChainChanged | ServiceContextBroadcast | JobResultEvent;
-type IframeRequest = HandshakeRequest | ReadAccountRequest | SwitchChainRequest | SignMessageRequest | SignTransactionRequest | CallJobRequest;
+type ParentMessage = HandshakeAck | ReadAccountResult | SwitchChainResult | SignMessageResult | SignTransactionResult | SignTypedDataResult | AccountChanged | ChainChanged | ServiceContextBroadcast | JobResultEvent;
+type IframeRequest = HandshakeRequest | ReadAccountRequest | SwitchChainRequest | SignMessageRequest | SignTransactionRequest | SignTypedDataRequest | CallJobRequest;
 declare const NO_WALLET_ADDRESS = "0x0000000000000000000000000000000000000000";
 /**
  * Cryptographically-random ASCII correlation id matching the parent's
@@ -133,4 +191,4 @@ declare const NO_WALLET_ADDRESS = "0x0000000000000000000000000000000000000000";
  */
 declare function makeCorrelationId(prefix: string): string;
 
-export { type AccountChanged as A, type CallJobRequest as C, type HandshakeAck as H, type IframeRequest as I, type JobInputs as J, NO_WALLET_ADDRESS as N, type ParentMessage as P, type ReadAccountRequest as R, type ServiceContextBroadcast as S, TANGLE_IFRAME_PROTOCOL_PREFIX as T, type ChainChanged as a, type HandshakeRequest as b, type JobResultEvent as c, type JobResultStatus as d, type ReadAccountResult as e, type ServiceContextJob as f, type ServiceContextOperator as g, type SignMessageRequest as h, type SignMessageResult as i, type SignTransactionRequest as j, type SignTransactionResult as k, type SwitchChainRequest as l, type SwitchChainResult as m, TANGLE_IFRAME_PROTOCOL_VERSION as n, makeCorrelationId as o };
+export { type AccountChanged as A, type CallJobRequest as C, type HandshakeAck as H, type IframeRequest as I, type JobInputs as J, NO_WALLET_ADDRESS as N, type ParentMessage as P, type ReadAccountRequest as R, type ServiceContextBroadcast as S, TANGLE_IFRAME_PROTOCOL_PREFIX as T, type ChainChanged as a, type ChainContext as b, type HandshakeRequest as c, type JobResultEvent as d, type JobResultStatus as e, type ReadAccountResult as f, type ServiceContextJob as g, type ServiceContextOperator as h, type SignMessageRequest as i, type SignMessageResult as j, type SignTransactionRequest as k, type SignTransactionResult as l, type SignTypedDataRequest as m, type SignTypedDataResult as n, type SwitchChainRequest as o, type SwitchChainResult as p, TANGLE_IFRAME_PROTOCOL_VERSION as q, makeCorrelationId as r };

package/dist/{tangleIframeClient-D-PP-KhN.d.ts → tangleIframeClient-CAyUr99p.d.ts}

@@ -1,5 +1,5 @@
 import { Address, Hex } from 'viem';
-import { g as ServiceContextOperator, f as ServiceContextJob, d as JobResultStatus, J as JobInputs } from './parentBridgeProtocol-CqK9e6Fk.js';
+import { h as ServiceContextOperator, g as ServiceContextJob, b as ChainContext, e as JobResultStatus, m as SignTypedDataRequest, J as JobInputs } from './parentBridgeProtocol-BS2zbIvX.js';
 
 type WalletSnapshot = {
     readonly address: Address | null;
@@ -12,6 +12,9 @@ type ServiceSnapshot = {
     readonly operators: readonly ServiceContextOperator[];
     readonly jobs: readonly ServiceContextJob[];
     readonly mode: string | null;
+    /** Chain context broadcast by the parent — drives `useTanglePublicClient`.
+     * `null` when the parent hasn't sent one (older parent or dev mode). */
+    readonly chain: ChainContext | null;
 };
 type JobInvocation = {
     readonly correlationId: string;
@@ -59,6 +62,7 @@ declare class TangleIframeClient {
     private handshakeAcked;
     private handshakeWaiters;
     private installed;
+    private handshakeRetry;
     private listeners;
     private pendingJobs;
     constructor(options: TangleIframeClientOptions);
@@ -75,6 +79,21 @@ declare class TangleIframeClient {
         value?: bigint;
     }): Promise<Hex>;
     switchChain(chainId: number): Promise<number>;
+    /**
+     * EIP-712 typed-data signing. The parent renders the typed-data fields in
+     * its approval modal; the user audits what they're signing. Use for
+     * operator envelopes, off-chain attestations, anything that needs a
+     * signature outside the standard blueprint-job RFQ flow.
+     *
+     * Shape mirrors viem's `signTypedData` argument. Do not include the
+     * EIP712Domain entry in `types` — the parent injects it from `domain`.
+     */
+    signTypedData(args: {
+        domain: SignTypedDataRequest['domain'];
+        types: SignTypedDataRequest['types'];
+        primaryType: string;
+        message: Readonly<Record<string, unknown>>;
+    }): Promise<Hex>;
     /**
      * Invoke a blueprint job. Returns a Promise that resolves on terminal
      * status (`success` or `error`); subscribe to the `job` event for
@@ -89,6 +108,7 @@ declare class TangleIframeClient {
         inputs: JobInputs;
         stream?: boolean;
     }): Promise<JobInvocation>;
+    private clearHandshakeRetry;
     private postHandshake;
     private postToParent;
     private handleParentMessage;

package/dist/wallet/index.d.ts

@@ -1,7 +1,7 @@
 export { T as TANGLE_CLOUD_ORIGINS_DEFAULT, d as detectTangleCloudParentOrigin } from '../detectParentOrigin-BYruoIdc.js';
 import * as wagmi from 'wagmi';
 import { Address } from 'viem';
-export { A as AccountChanged, C as CallJobRequest, a as ChainChanged, H as HandshakeAck, b as HandshakeRequest, I as IframeRequest, J as JobInputs, c as JobResultEvent, d as JobResultStatus, N as NO_WALLET_ADDRESS, P as ParentMessage, R as ReadAccountRequest, e as ReadAccountResult, S as ServiceContextBroadcast, f as ServiceContextJob, g as ServiceContextOperator, h as SignMessageRequest, i as SignMessageResult, j as SignTransactionRequest, k as SignTransactionResult, l as SwitchChainRequest, m as SwitchChainResult, T as TANGLE_IFRAME_PROTOCOL_PREFIX, n as TANGLE_IFRAME_PROTOCOL_VERSION, o as makeCorrelationId } from '../parentBridgeProtocol-CqK9e6Fk.js';
+export { A as AccountChanged, C as CallJobRequest, a as ChainChanged, b as ChainContext, H as HandshakeAck, c as HandshakeRequest, I as IframeRequest, J as JobInputs, d as JobResultEvent, e as JobResultStatus, N as NO_WALLET_ADDRESS, P as ParentMessage, R as ReadAccountRequest, f as ReadAccountResult, S as ServiceContextBroadcast, g as ServiceContextJob, h as ServiceContextOperator, i as SignMessageRequest, j as SignMessageResult, k as SignTransactionRequest, l as SignTransactionResult, m as SignTypedDataRequest, n as SignTypedDataResult, o as SwitchChainRequest, p as SwitchChainResult, T as TANGLE_IFRAME_PROTOCOL_PREFIX, q as TANGLE_IFRAME_PROTOCOL_VERSION, r as makeCorrelationId } from '../parentBridgeProtocol-BS2zbIvX.js';
 
 type EventName = 'accountsChanged' | 'chainChanged' | 'connect' | 'disconnect' | 'message';
 type Listener = (...args: unknown[]) => void;

package/dist/wallet/index.js

@@ -5,7 +5,7 @@ import {
   TANGLE_IFRAME_PROTOCOL_VERSION,
   detectTangleCloudParentOrigin,
   makeCorrelationId
-} from "../chunk-BLXSBQU4.js";
+} from "../chunk-ZKICSKZH.js";
 
 // src/wallet/parentBridgeConnector.ts
 import { createConnector } from "wagmi";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/blueprint-ui",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Shared blueprint UI components, hooks, and contract utilities for Tangle Network apps",
   "license": "MIT OR Apache-2.0",
   "repository": {

package/src/iframe/TangleIframeProvider.tsx

@@ -57,6 +57,7 @@ const NULL_SERVICE: ServiceSnapshot = {
   operators: [],
   jobs: [],
   mode: null,
+  chain: null,
 };
 
 /**

package/src/iframe/hooks.ts

@@ -1,5 +1,12 @@
 import { useCallback, useEffect, useMemo, useState } from 'react';
-import type { Address, Hex } from 'viem';
+import {
+  createPublicClient,
+  http,
+  type Address,
+  type Chain,
+  type Hex,
+  type PublicClient,
+} from 'viem';
 
 import { useTangleIframeContext } from './TangleIframeProvider';
 import type {
@@ -7,7 +14,11 @@ import type {
   ServiceSnapshot,
   WalletSnapshot,
 } from './tangleIframeClient';
-import type { JobInputs } from '../wallet/parentBridgeProtocol';
+import type {
+  ChainContext,
+  JobInputs,
+  SignTypedDataRequest,
+} from '../wallet/parentBridgeProtocol';
 
 /**
  * Read-only view of the connected wallet, plus the operations the iframe
@@ -24,6 +35,12 @@ export function useTangleWallet(): WalletSnapshot & {
     data: Hex;
     value?: bigint;
   }) => Promise<Hex>;
+  signTypedData: (args: {
+    domain: SignTypedDataRequest['domain'];
+    types: SignTypedDataRequest['types'];
+    primaryType: string;
+    message: Readonly<Record<string, unknown>>;
+  }) => Promise<Hex>;
   switchChain: (chainId: number) => Promise<number>;
 } {
   const { client, wallet } = useTangleIframeContext();
@@ -41,6 +58,18 @@ export function useTangleWallet(): WalletSnapshot & {
     },
     [client],
   );
+  const signTypedData = useCallback(
+    (args: {
+      domain: SignTypedDataRequest['domain'];
+      types: SignTypedDataRequest['types'];
+      primaryType: string;
+      message: Readonly<Record<string, unknown>>;
+    }) => {
+      if (!client) throw new Error('Wallet not available in dev mode.');
+      return client.signTypedData(args);
+    },
+    [client],
+  );
   const switchChain = useCallback(
     (chainId: number) => {
       if (!client) throw new Error('Wallet not available in dev mode.');
@@ -48,7 +77,70 @@ export function useTangleWallet(): WalletSnapshot & {
     },
     [client],
   );
-  return { ...wallet, signMessage, sendTransaction, switchChain };
+  return {
+    ...wallet,
+    signMessage,
+    sendTransaction,
+    signTypedData,
+    switchChain,
+  };
+}
+
+/**
+ * Chain configuration broadcast by the parent: chain id, name, RPC URL,
+ * block explorer, native currency. Returns `null` until the parent has
+ * sent its first `serviceContext` broadcast (or in dev mode without a
+ * seeded harness).
+ *
+ * Use this when you want to display chain-aware info (block explorer
+ * links, native currency labels) or when you want to build your own viem
+ * client with the parent's RPC URL. For a pre-built read-only client,
+ * see `useTanglePublicClient()`.
+ */
+export function useChainContext(): ChainContext | null {
+  return useTangleIframeContext().service.chain;
+}
+
+/**
+ * Read-only viem `PublicClient` pinned to the chain the parent dapp is
+ * connected to. Useful for `readContract`, `getBalance`, `multicall`, etc.
+ *
+ * Returns `null` until the parent broadcasts a chain context. Iframes that
+ * need to read from chains *other* than the active one should bring their
+ * own client — this hook is a convenience for the common case, not a
+ * constraint. Multi-chain dashboards just create additional clients
+ * directly via `createPublicClient`.
+ *
+ * Memoized per chain id + RPC URL, so consumers get a stable identity
+ * across re-renders.
+ */
+export function useTanglePublicClient(): PublicClient | null {
+  const chain = useChainContext();
+  return useMemo(() => {
+    if (!chain) return null;
+    const chainConfig: Chain = {
+      id: chain.id,
+      name: chain.name,
+      nativeCurrency:
+        chain.nativeCurrency !== undefined
+          ? { ...chain.nativeCurrency }
+          : { name: 'Ether', symbol: 'ETH', decimals: 18 },
+      rpcUrls: {
+        default: { http: [chain.rpcUrl] },
+      },
+      ...(chain.blockExplorerUrl
+        ? {
+            blockExplorers: {
+              default: { name: 'Explorer', url: chain.blockExplorerUrl },
+            },
+          }
+        : {}),
+    } as Chain;
+    return createPublicClient({
+      chain: chainConfig,
+      transport: http(chain.rpcUrl),
+    });
+  }, [chain]);
 }
 
 /**

package/src/iframe/index.ts

@@ -48,6 +48,8 @@ export {
   useTangleAddress,
   useTangleReady,
   useTangleMode,
+  useChainContext,
+  useTanglePublicClient,
 } from './hooks';
 
 export {
@@ -63,10 +65,13 @@ export {
 // against the same wire format if they want to skip the React layer.
 export type {
   CallJobRequest,
+  ChainContext,
   JobInputs,
   JobResultEvent,
   JobResultStatus,
   ServiceContextBroadcast,
   ServiceContextJob,
   ServiceContextOperator,
+  SignTypedDataRequest,
+  SignTypedDataResult,
 } from '../wallet/parentBridgeProtocol';

package/src/iframe/integration.test.tsx

@@ -0,0 +1,91 @@
+import { render, screen, waitFor } from '@testing-library/react';
+import { describe, expect, it } from 'vitest';
+
+import { TangleIframeProvider } from './TangleIframeProvider';
+import {
+  useChainContext,
+  useTangleService,
+  useTangleWallet,
+} from './hooks';
+import {
+  HARNESS_ORIGIN,
+  TangleParentHarness,
+  mockServiceContext,
+  mockWallet,
+} from './testing';
+
+/**
+ * End-to-end: a consumer app mounts `TangleIframeProvider` (forced bridge
+ * mode) *inside* `TangleParentHarness`. This is exactly how a downstream
+ * blueprint tests itself, and it exercises the parts that unit tests of the
+ * client alone can't:
+ *   - React mounts child effects before parent effects, so the provider's
+ *     `install()` posts its first handshake before the harness has wired its
+ *     `window.parent.postMessage` interceptor. The client's standing retry
+ *     must recover from that dropped handshake.
+ *   - The harness must receive iframe→parent posts via the `window.parent`
+ *     override (same-window `postMessage` with a synthetic origin is dropped
+ *     by the DOM), and replies must flow back as dispatched `message` events.
+ * A regression in either path makes wallet/service context never arrive.
+ */
+function Probe() {
+  const wallet = useTangleWallet();
+  const service = useTangleService();
+  const chain = useChainContext();
+  return (
+    <div>
+      <span data-testid="address">{wallet.address ?? 'none'}</span>
+      <span data-testid="connected">{String(wallet.isConnected)}</span>
+      <span data-testid="chainId">{String(wallet.chainId)}</span>
+      <span data-testid="serviceId">{service.serviceId ?? 'none'}</span>
+      <span data-testid="operators">{String(service.operators.length)}</span>
+      <span data-testid="chainName">{chain?.name ?? 'none'}</span>
+    </div>
+  );
+}
+
+function mount(opts?: {
+  address?: `0x${string}` | null;
+  serviceId?: string | null;
+}) {
+  return render(
+    <TangleParentHarness
+      appId="probe-app"
+      wallet={mockWallet({ address: opts?.address })}
+      service={mockServiceContext({ serviceId: opts?.serviceId ?? '7' })}
+    >
+      <TangleIframeProvider
+        appId="probe-app"
+        mode="bridge"
+        parentOrigin={HARNESS_ORIGIN}
+      >
+        <Probe />
+      </TangleIframeProvider>
+    </TangleParentHarness>,
+  );
+}
+
+describe('TangleIframeProvider ↔ TangleParentHarness integration', () => {
+  it('propagates wallet + chain + service context after handshake', async () => {
+    mount();
+    await waitFor(() => {
+      expect(screen.getByTestId('connected').textContent).toBe('true');
+    });
+    expect(screen.getByTestId('address').textContent).toBe(
+      '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',
+    );
+    expect(screen.getByTestId('chainId').textContent).toBe('84532');
+    expect(screen.getByTestId('serviceId').textContent).toBe('7');
+    expect(screen.getByTestId('operators').textContent).toBe('1');
+    expect(screen.getByTestId('chainName').textContent).toBe('Base Sepolia');
+  });
+
+  it('reports a disconnected wallet when the parent has no account', async () => {
+    mount({ address: null });
+    await waitFor(() => {
+      expect(screen.getByTestId('serviceId').textContent).toBe('7');
+    });
+    expect(screen.getByTestId('connected').textContent).toBe('false');
+    expect(screen.getByTestId('address').textContent).toBe('none');
+  });
+});