feat(swift-sdk): add BLAST address sync for iOS

.github/workflows/book-preview.yml

@@ -0,0 +1,85 @@
+name: Book Preview (PR)
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+    paths:
+      - 'book/**'
+      - '.github/workflows/book-preview.yml'
+
+permissions:
+  contents: read
+  pull-requests: write
+
+concurrency:
+  group: book-preview-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  preview:
+    name: Build book preview
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Checkout PR
+        uses: actions/checkout@v4
+
+      - name: Install mdBook
+        run: |
+          mkdir -p "$HOME/.local/bin"
+          curl -sSL https://github.com/rust-lang/mdBook/releases/download/v0.4.40/mdbook-v0.4.40-x86_64-unknown-linux-gnu.tar.gz \
+            | tar -xz -C "$HOME/.local/bin"
+          echo "$HOME/.local/bin" >> "$GITHUB_PATH"
+
+      - name: Build book
+        run: mdbook build book
+
+      - name: Upload preview artifact
+        id: upload
+        uses: actions/upload-artifact@v4
+        with:
+          name: book-preview-pr-${{ github.event.pull_request.number }}
+          path: book/book
+          retention-days: 30
+
+      - name: Post preview link
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const prNumber = context.payload.pull_request.number;
+            const runId = context.runId;
+            const repoUrl = `https://github.com/${context.repo.owner}/${context.repo.repo}`;
+            const artifactUrl = `${repoUrl}/actions/runs/${runId}`;
+
+            const { data: comments } = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: prNumber,
+            });
+
+            const marker = '<!-- book-preview -->';
+            const existing = comments.find(c => c.body.includes(marker));
+            const body = [
+              marker,
+              `📖 **Book Preview** built successfully.`,
+              ``,
+              `Download the preview from the [workflow artifacts](${artifactUrl}).`,
+              `To view locally: download the artifact, unzip, and open \`index.html\`.`,
+              ``,
+              `_Updated at ${new Date().toISOString()}_`,
+            ].join('\n');
+
+            if (existing) {
+              await github.rest.issues.updateComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                comment_id: existing.id,
+                body,
+              });
+            } else {
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: prNumber,
+                body,
+              });
+            }

book/book.toml

@@ -12,3 +12,5 @@ build-dir = "book"
 default-theme = "navy"
 preferred-dark-theme = "navy"
 git-repository-url = "https://github.com/dashpay/platform"
+additional-js = ["mermaid.min.js", "mermaid-init.js"]
+

book/mermaid-init.js

@@ -0,0 +1,43 @@
+// Mermaid initialization for mdBook (without preprocessor)
+// Converts ```mermaid code blocks into rendered diagrams.
+(() => {
+    const darkThemes = ['ayu', 'navy', 'coal'];
+    const lightThemes = ['light', 'rust'];
+
+    const classList = document.getElementsByTagName('html')[0].classList;
+
+    let lastThemeWasLight = true;
+    for (const cssClass of classList) {
+        if (darkThemes.includes(cssClass)) {
+            lastThemeWasLight = false;
+            break;
+        }
+    }
+
+    const theme = lastThemeWasLight ? 'default' : 'dark';
+
+    // Convert code blocks with language-mermaid into mermaid divs
+    document.querySelectorAll('pre code.language-mermaid').forEach((codeBlock) => {
+        const pre = codeBlock.parentElement;
+        const div = document.createElement('div');
+        div.className = 'mermaid';
+        div.textContent = codeBlock.textContent;
+        pre.parentElement.replaceChild(div, pre);
+    });
+
+    mermaid.initialize({ startOnLoad: true, theme });
+
+    // Re-render on theme switch
+    for (const darkTheme of darkThemes) {
+        const el = document.getElementById(darkTheme);
+        if (el) el.addEventListener('click', () => {
+            if (lastThemeWasLight) window.location.reload();
+        });
+    }
+    for (const lightTheme of lightThemes) {
+        const el = document.getElementById(lightTheme);
+        if (el) el.addEventListener('click', () => {
+            if (!lastThemeWasLight) window.location.reload();
+        });
+    }
+})();