wraith-protocol · truthixify · Aug 28, 2026 · Aug 27, 2026 · Aug 27, 2026 · Aug 27, 2026
diff --git a/examples/stellar-solid-receive/.env.example b/examples/stellar-solid-receive/.env.example
@@ -0,0 +1,2 @@
+# Optional: pre-fill the secret key input (128 hex chars / 64 bytes).
+# VITE_STELLAR_SECRET_KEY=aabbcc...
diff --git a/examples/stellar-solid-receive/index.html b/examples/stellar-solid-receive/index.html
@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Wraith Stellar — Solid.js Receive</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
diff --git a/examples/stellar-solid-receive/package.json b/examples/stellar-solid-receive/package.json
@@ -0,0 +1,21 @@
+{
+  "name": "@wraith-protocol/example-stellar-solid-receive",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@wraith-protocol/sdk": "workspace:*",
+    "@wraith-protocol/sdk-solid": "workspace:*",
+    "solid-js": "^1.9.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vite": "^6.1.0",
+    "vite-plugin-solid": "^2.11.0"
+  }
+}
diff --git a/examples/stellar-solid-receive/src/App.tsx b/examples/stellar-solid-receive/src/App.tsx
@@ -0,0 +1,208 @@
+import { createSignal, createMemo, Show, For } from 'solid-js';
+import { createStealthKeys, createScanner } from '@wraith-protocol/sdk-solid';
+import {
+  bytesToHex,
+  scanAnnouncements as stellarScanAnnouncements,
+  type Announcement,
+} from '@wraith-protocol/sdk/chains/stellar';
+
+// Canned announcement fixture — used in dev/demo without a live Horizon node.
+const CANNED_ANNOUNCEMENTS: Announcement[] = [];
+
+function parseHex(hex: string): Uint8Array | null {
+  const clean = hex.replace(/^0x/i, '').trim();
+  if (!/^[0-9a-fA-F]+$/.test(clean) || clean.length % 2 !== 0) return null;
+  return new Uint8Array(clean.match(/.{1,2}/g)!.map((b) => parseInt(b, 16)));
+}
+
+export default function App() {
+  const [input, setInput] = createSignal((import.meta as any).env?.VITE_STELLAR_SECRET_KEY ?? '');
+
+  // Primitives
+  const stealthKeys = createStealthKeys();
+  const scanner = createScanner();
+
+  const metaAddress = createMemo(() => stealthKeys.metaAddress());
+
+  function handleDerive() {
+    const bytes = parseHex(input());
+    if (!bytes) return;
+    if (bytes.length !== 64) return;
+
+    const k = stealthKeys.deriveKeys(bytes);
+    stealthKeys.encodeMetaAddress(k.spendingPubKey, k.viewingPubKey);
+  }
+
+  function handleScan() {
+    const k = stealthKeys.keys();
+    if (!k) return;
+
+    // Scan the canned fixture (in a real app, call scanner.scan({ chain: 'testnet' }))
+    scanner.match(CANNED_ANNOUNCEMENTS, k.viewingKey, k.spendingPubKey, k.spendingScalar);
+  }
+
+  return (
+    <main
+      style={{ 'max-width': '640px', margin: '40px auto', 'font-family': 'system-ui, sans-serif' }}
+    >
+      <h1>Wraith Stellar — Receive Stealth Payments (Solid.js)</h1>
+      <p>
+        Enter your 64-byte hex secret key to derive your stealth keys and meta-address. Share the
+        meta-address with senders.
+      </p>
+
+      <section style={{ margin: '24px 0' }}>
+        <label
+          for="secret"
+          style={{ display: 'block', 'margin-bottom': '8px', 'font-weight': '600' }}
+        >
+          Secret Key (hex, 64 bytes)
+        </label>
+        <textarea
+          id="secret"
+          rows={3}
+          style={{ width: '100%', 'font-family': 'monospace', padding: '8px' }}
+          value={input()}
+          onInput={(e) => setInput(e.currentTarget.value)}
+          placeholder="aa... (128 hex chars)"
+        />
+        <button
+          onClick={handleDerive}
+          style={{ 'margin-top': '8px', padding: '8px 24px', cursor: 'pointer' }}
+          disabled={stealthKeys.loading()}
+        >
+          Derive Stealth Keys
+        </button>
+      </section>
+
+      <Show when={stealthKeys.error()}>
+        <section style={{ color: '#c00', margin: '16px 0' }}>
+          <strong>Error:</strong> {stealthKeys.error()}
+        </section>
+      </Show>
+
+      <Show when={stealthKeys.keys()}>
+        {(k) => (
+          <section
+            style={{
+              background: '#f5f5f5',
+              border: '1px solid #ddd',
+              'border-radius': '8px',
+              padding: '16px',
+              margin: '16px 0',
+            }}
+          >
+            <h2>Your Stealth Keys</h2>
+            <table style={{ width: '100%', 'border-collapse': 'collapse' }}>
+              <tbody>
+                <For
+                  each={[
+                    ['Spending Secret Key', bytesToHex(k().spendingKey)],
+                    ['Spending Public Key', bytesToHex(k().spendingPubKey)],
+                    ['Viewing Secret Key', bytesToHex(k().viewingKey)],
+                    ['Viewing Public Key', bytesToHex(k().viewingPubKey)],
+                    ['Spending Scalar', k().spendingScalar.toString()],
+                  ]}
+                >
+                  {([label, val]) => (
+                    <tr>
+                      <td
+                        style={{
+                          padding: '6px 8px',
+                          'font-weight': '500',
+                          'white-space': 'nowrap',
+                        }}
+                      >
+                        {label}
+                      </td>
+                      <td
+                        style={{
+                          padding: '6px 8px',
+                          'font-family': 'monospace',
+                          'font-size': '13px',
+                          'word-break': 'break-all',
+                        }}
+                      >
+                        {val}
+                      </td>
+                    </tr>
+                  )}
+                </For>
+              </tbody>
+            </table>
+
+            <Show when={metaAddress()}>
+              {(addr) => (
+                <div style={{ 'margin-top': '16px' }}>
+                  <strong>Stealth Meta-Address</strong>
+                  <pre
+                    style={{
+                      background: '#fff',
+                      border: '1px solid #ccc',
+                      'border-radius': '4px',
+                      padding: '12px',
+                      'margin-top': '6px',
+                      overflow: 'auto',
+                      cursor: 'pointer',
+                    }}
+                    onClick={() => navigator.clipboard.writeText(addr())}
+                    title="Click to copy"
+                  >
+                    {addr()}
+                  </pre>
+                  <p style={{ 'font-size': '13px', color: '#666' }}>
+                    Click the meta-address to copy it. Share this with anyone who wants to send you
+                    stealth payments.
+                  </p>
+                </div>
+              )}
+            </Show>
+
+            <button
+              onClick={handleScan}
+              style={{ 'margin-top': '12px', padding: '8px 24px', cursor: 'pointer' }}
+              disabled={scanner.scanning()}
+            >
+              {scanner.scanning() ? 'Scanning…' : 'Scan for Payments (canned fixture)'}
+            </button>
+          </section>
+        )}
+      </Show>
+
+      <Show when={scanner.matched().length > 0}>
+        <section
+          style={{
+            background: '#f0fff0',
+            border: '1px solid #bdb',
+            'border-radius': '8px',
+            padding: '16px',
+            margin: '16px 0',
+          }}
+        >
+          <h2>Matched Payments ({scanner.matched().length})</h2>
+          <For each={scanner.matched()}>
+            {(m) => (
+              <div
+                style={{ 'margin-bottom': '12px', 'font-family': 'monospace', 'font-size': '13px' }}
+              >
+                <div>
+                  <strong>Stealth Address:</strong> {m.stealthAddress}
+                </div>
+                <div>
+                  <strong>View Tag:</strong> {m.viewTag}
+                </div>
+              </div>
+            )}
+          </For>
+        </section>
+      </Show>
+
+      <Show when={scanner.matched().length === 0 && stealthKeys.keys()}>
+        <p style={{ color: '#666', 'font-size': '13px' }}>
+          No matched payments found in the canned fixture. In production, call{' '}
+          <code>scanner.scan(&#123; chain: 'mainnet' &#125;)</code> against a live Horizon node.
+        </p>
+      </Show>
+    </main>
+  );
+}
diff --git a/examples/stellar-solid-receive/src/main.tsx b/examples/stellar-solid-receive/src/main.tsx
@@ -0,0 +1,4 @@
+import { render } from 'solid-js/web';
+import App from './App';
+
+render(() => <App />, document.getElementById('root')!);
diff --git a/examples/stellar-solid-receive/src/vite-env.d.ts b/examples/stellar-solid-receive/src/vite-env.d.ts
@@ -0,0 +1 @@
+/// <reference types="vite/client" />
diff --git a/examples/stellar-solid-receive/tsconfig.json b/examples/stellar-solid-receive/tsconfig.json
@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "preserve",
+    "jsxImportSource": "solid-js",
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "isolatedModules": true
+  },
+  "include": ["src"]
+}
diff --git a/examples/stellar-solid-receive/vite.config.ts b/examples/stellar-solid-receive/vite.config.ts
@@ -0,0 +1,6 @@
+import { defineConfig } from 'vite';
+import solid from 'vite-plugin-solid';
+
+export default defineConfig({
+  plugins: [solid()],
+});
diff --git a/packages/sdk-solid/package.json b/packages/sdk-solid/package.json
@@ -0,0 +1,40 @@
+{
+  "name": "@wraith-protocol/sdk-solid",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@wraith-protocol/sdk": "workspace:*",
+    "solid-js": "^1.9.0"
+  },
+  "peerDependencies": {
+    "solid-js": "^1.9.0"
+  },
+  "devDependencies": {
+    "@solidjs/testing-library": "^0.8.10",
+    "@testing-library/jest-dom": "^6.0.0",
+    "jsdom": "^25.0.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.0",
+    "vite-plugin-solid": "^2.11.0",
+    "vitest": "^3.1.0"
+  }
+}
diff --git a/packages/sdk-solid/src/index.ts b/packages/sdk-solid/src/index.ts
@@ -0,0 +1,5 @@
+export { createStealthKeys } from './primitives/createStealthKeys.js';
+export { createScanner } from './primitives/createScanner.js';
+export { createMetaAddress } from './primitives/createMetaAddress.js';
+export type { ChainType, AnyStealthMetaAddress } from './primitives/createMetaAddress.js';
+export { createActivity } from './primitives/createActivity.js';
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		# Optional: pre-fill the secret key input (128 hex chars / 64 bytes).
		# VITE_STELLAR_SECRET_KEY=aabbcc...