From 77b52b2480ed648532b2830d08a21fbdfab5babe Mon Sep 17 00:00:00 2001
From: Mohamed Abdelaziz <amrikyy@gmail.com>
Date: Mon, 25 May 2026 02:58:13 +0300
Subject: [PATCH 01/14] fix: status enum values to uppercase (ACTIVE/INACTIVE)

- agent/activate/route.ts: 'active' -> 'ACTIVE'
- agent/main/route.ts: 'active' -> 'ACTIVE'
- agent/route.ts: 'inactive' -> 'INACTIVE'
- lib/agent-flow.ts: AgentStatus type updated to match Prisma enum
---
 apps/axiomid/src/app/api/agent/activate/route.ts | 2 +-
 apps/axiomid/src/app/api/agent/main/route.ts     | 4 ++--
 apps/axiomid/src/app/api/agent/route.ts          | 2 +-
 apps/axiomid/src/lib/agent-flow.ts               | 2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/apps/axiomid/src/app/api/agent/activate/route.ts b/apps/axiomid/src/app/api/agent/activate/route.ts
index 3aa907f..91bc019 100644
--- a/apps/axiomid/src/app/api/agent/activate/route.ts
+++ b/apps/axiomid/src/app/api/agent/activate/route.ts
@@ -47,7 +47,7 @@ export async function POST(request: Request) {
     const agent = await prisma.userAgent.update({
       where: { userId: user.id },
       data: {
-        status: 'active',
+        status: 'ACTIVE',
         lastActive: new Date(),
       },
       select: {
diff --git a/apps/axiomid/src/app/api/agent/main/route.ts b/apps/axiomid/src/app/api/agent/main/route.ts
index 5894b90..b079d8d 100644
--- a/apps/axiomid/src/app/api/agent/main/route.ts
+++ b/apps/axiomid/src/app/api/agent/main/route.ts
@@ -50,7 +50,7 @@ export async function POST(request: Request) {
     if (existing) {
       const updated = await prisma.userAgent.update({
         where: { userId: user.id },
-        data: { name: name || existing.name, status: 'active', lastActive: new Date() },
+        data: { name: name || existing.name, status: 'ACTIVE', lastActive: new Date() },
         select: agentSelect,
       });
 
@@ -78,7 +78,7 @@ export async function POST(request: Request) {
       data: {
         userId: user.id,
         name: name || 'My Agent',
-        status: 'active',
+        status: 'ACTIVE',
         apiKeyHash,
         permissions: JSON.stringify(['claim', 'verify']),
         lastActive: new Date(),
diff --git a/apps/axiomid/src/app/api/agent/route.ts b/apps/axiomid/src/app/api/agent/route.ts
index e46e5bb..f1f70fd 100644
--- a/apps/axiomid/src/app/api/agent/route.ts
+++ b/apps/axiomid/src/app/api/agent/route.ts
@@ -62,7 +62,7 @@ export async function POST(request: Request) {
       data: {
         userId: user.id,
         name: name || 'My Agent',
-        status: 'inactive',
+        status: 'INACTIVE',
         apiKeyHash,
         permissions: JSON.stringify(['claim', 'verify']),
       },
diff --git a/apps/axiomid/src/lib/agent-flow.ts b/apps/axiomid/src/lib/agent-flow.ts
index 17cac94..5b67328 100644
--- a/apps/axiomid/src/lib/agent-flow.ts
+++ b/apps/axiomid/src/lib/agent-flow.ts
@@ -1,4 +1,4 @@
-export type AgentStatus = 'inactive' | 'active' | 'paused';
+export type AgentStatus = 'INACTIVE' | 'ACTIVE' | 'PAUSED' | 'SLEEPING';
 
 export interface AgentState {
   id: string;

From cef2829181de1cfd37018fa29869667f4fecdc36 Mon Sep 17 00:00:00 2001
From: Mohamed Abdelaziz <amrikyy@gmail.com>
Date: Mon, 25 May 2026 03:02:53 +0300
Subject: [PATCH 02/14] fix: enable Pi SDK on desktop with sandbox mode

---
 apps/axiomid/src/app/context/wallet-context.tsx | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/apps/axiomid/src/app/context/wallet-context.tsx b/apps/axiomid/src/app/context/wallet-context.tsx
index 28a5d76..271b220 100644
--- a/apps/axiomid/src/app/context/wallet-context.tsx
+++ b/apps/axiomid/src/app/context/wallet-context.tsx
@@ -106,7 +106,7 @@ export function WalletProvider({ children }: { children: ReactNode }) {
       debug("inIframe", inIframe);
       debug("hasPi", typeof window !== "undefined" && !!window.Pi);
 
-      const usePi = inPiBrowser || (isSandbox && inIframe);
+      const usePi = inPiBrowser || isSandbox;
       debug("usePi", usePi);
 
       if (usePi) {
@@ -188,7 +188,7 @@ export function WalletProvider({ children }: { children: ReactNode }) {
     const inPiBrowser = detectPiBrowser();
     const isSandbox = getSandboxFlag();
     const inIframe = typeof window !== "undefined" && window.self !== window.parent;
-    const isPiEnv = inPiBrowser || (isSandbox && inIframe);
+    const isPiEnv = inPiBrowser || isSandbox;
     console.log("[AUTH DEBUG] auto-auth: SANDBOX=", isSandbox, "PiBrowser=", inPiBrowser, "inIframe=", inIframe, "isPiEnv=", isPiEnv);
 
     if (isPiEnv) {

From dbc1933f9f88779cc12008b0aa2475aced004023 Mon Sep 17 00:00:00 2001
From: Mohamed Abdelaziz <amrikyy@gmail.com>
Date: Mon, 25 May 2026 03:03:48 +0300
Subject: [PATCH 03/14] fix: detect native Pi SDK + fix scope scopes param

---
 apps/axiomid/src/app/context/wallet-context.tsx | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/apps/axiomid/src/app/context/wallet-context.tsx b/apps/axiomid/src/app/context/wallet-context.tsx
index 271b220..92693df 100644
--- a/apps/axiomid/src/app/context/wallet-context.tsx
+++ b/apps/axiomid/src/app/context/wallet-context.tsx
@@ -50,6 +50,7 @@ const AUTH_TIMEOUT_MS = 15000;
 
 function detectPiBrowser(): boolean {
   if (typeof navigator === "undefined") return false;
+  if (typeof window !== "undefined" && !!(window as any)?.Pi?.authenticate) return true;
   return /Pi Browser|minepi/i.test(navigator.userAgent);
 }
 
@@ -123,7 +124,7 @@ export function WalletProvider({ children }: { children: ReactNode }) {
         debug("scopes requested:", scopes);
         const auth = (await withTimeout(
           pi.authenticate({
-            scope: scopes,
+            scopes,
             onIncompletePaymentFound: (payment: any) => {
               console.warn("Incomplete payment:", payment?.identifier);
             }

From c442617e3456fb3aa24ff92fa5dc31e3eb0ac155 Mon Sep 17 00:00:00 2001
From: Mohamed Abdelaziz <amrikyy@gmail.com>
Date: Mon, 25 May 2026 03:08:56 +0300
Subject: [PATCH 04/14] fix: call Pi.init() before checking Pi.authenticate

---
 apps/axiomid/src/lib/pi-sdk.ts | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/apps/axiomid/src/lib/pi-sdk.ts b/apps/axiomid/src/lib/pi-sdk.ts
index 0e249b3..cd182ea 100644
--- a/apps/axiomid/src/lib/pi-sdk.ts
+++ b/apps/axiomid/src/lib/pi-sdk.ts
@@ -124,13 +124,15 @@ function injectPiSdkScript(sandbox?: boolean): Promise<void> {
 async function loadFromCdnWithRetry(sandbox?: boolean): Promise<void> {
   for (let attempt = 0; attempt < 3; attempt++) {
     await injectPiSdkScript(sandbox);
-    if ((window as any)?.Pi?.authenticate) {
+    if ((window as any)?.Pi?.init) {
       try {
         (window as any).Pi.init({ version: "2.0", sandbox: !!sandbox });
       } catch {
         // init may already have been called; safe to ignore
       }
-      return;
+      if ((window as any)?.Pi?.authenticate) {
+        return;
+      }
     }
     await new Promise((r) => setTimeout(r, 300));
   }

From abfd68e6730daf66d292d4c8b496ac316f223c77 Mon Sep 17 00:00:00 2001
From: Mohamed Abdelaziz <amrikyy@gmail.com>
Date: Mon, 25 May 2026 03:11:41 +0300
Subject: [PATCH 05/14] fix: correct Pi SDK init/authenticate API per official
 docs

- pi-sdk.ts: rewritten ensurePiSdk to await Pi.init() before checking Pi.authenticate
- wallet-context.tsx: Pi.authenticate(scopes, callback) not object syntax
- pi-wallet.ts: same fix
- layout.tsx: added <Script> for SDK CDN load with beforeInteractive
---
 .../src/app/context/wallet-context.tsx        |   6 +-
 apps/axiomid/src/app/layout.tsx               |   2 +
 apps/axiomid/src/lib/pi-sdk.ts                | 194 ++++--------------
 apps/axiomid/src/lib/pi-wallet.ts             |   8 +-
 4 files changed, 48 insertions(+), 162 deletions(-)

diff --git a/apps/axiomid/src/app/context/wallet-context.tsx b/apps/axiomid/src/app/context/wallet-context.tsx
index 92693df..2b97aa2 100644
--- a/apps/axiomid/src/app/context/wallet-context.tsx
+++ b/apps/axiomid/src/app/context/wallet-context.tsx
@@ -123,12 +123,12 @@ export function WalletProvider({ children }: { children: ReactNode }) {
           : ["username", "payments", "wallet_address"];
         debug("scopes requested:", scopes);
         const auth = (await withTimeout(
-          pi.authenticate({
+          pi.authenticate(
             scopes,
-            onIncompletePaymentFound: (payment: any) => {
+            (payment: any) => {
               console.warn("Incomplete payment:", payment?.identifier);
             }
-          }),
+          ),
           AUTH_TIMEOUT_MS
         )) as any;
         debug("Pi.authenticate done", { uid: auth?.user?.uid, username: auth?.user?.username });
diff --git a/apps/axiomid/src/app/layout.tsx b/apps/axiomid/src/app/layout.tsx
index beaa998..46f0fcf 100644
--- a/apps/axiomid/src/app/layout.tsx
+++ b/apps/axiomid/src/app/layout.tsx
@@ -1,5 +1,6 @@
 import type { Metadata, Viewport } from "next";
 import { Geist, Geist_Mono } from "next/font/google";
+import Script from "next/script";
 import "./globals.css";
 import { WalletProvider } from "./context/wallet-context";
 
@@ -113,6 +114,7 @@ export default function RootLayout({
       <body
         className={`${geistSans.variable} ${geistMono.variable} antialiased bg-black text-white min-h-screen overflow-x-hidden`}
       >
+        <Script src="https://sdk.minepi.com/pi-sdk.js" strategy="beforeInteractive" />
         <WalletProvider>
             {children}
         </WalletProvider>
diff --git a/apps/axiomid/src/lib/pi-sdk.ts b/apps/axiomid/src/lib/pi-sdk.ts
index cd182ea..8c0ca34 100644
--- a/apps/axiomid/src/lib/pi-sdk.ts
+++ b/apps/axiomid/src/lib/pi-sdk.ts
@@ -1,177 +1,61 @@
-let _parentProxy: Window | null = null;
-
-function makeParentProxy(target: Window): Window {
-  if (!_parentProxy) {
-    _parentProxy = new Proxy(target, {
-      get(t, prop, receiver) {
-        if (prop === "postMessage") {
-          return function (
-            message: unknown,
-            targetOrigin: string,
-            ...rest: [] | [Transferable[]]
-          ) {
-            if (
-              typeof targetOrigin === "string" &&
-              (targetOrigin === "https://sandbox.minepi.com" || targetOrigin === "https://app-cdn.minepi.com")
-            ) {
-              return t.postMessage(message, "*", ...rest);
-            }
-            return t.postMessage(message, targetOrigin, ...rest);
-          };
-        }
-        // Avoid using receiver for cross-origin targets to prevent SecurityError
-        try {
-          const value = (t as any)[prop];
-          if (typeof value === "function") {
-            return value.bind(t);
-          }
-          return value;
-        } catch {
-          return Reflect.get(t, prop);
-        }
-      },
-    });
-  }
-  return _parentProxy;
-}
-
-let _origPostMessage: typeof window.postMessage | null = null;
-
-function patchPostMessageForSandbox(): void {
-  if (typeof window === "undefined") return;
-
-  // Strategy 1: Override window.postMessage directly.
-  // Window.prototype.postMessage is {writable: true, configurable: false},
-  // so assignment creates an own property on window that shadows the
-  // prototype.  Works when window.parent === window (top-level page with
-  // no extension override) because window.parent.postMessage resolves to
-  // window.postMessage at call time.
-  try {
-    _origPostMessage = window.postMessage.bind(window);
-    (window as any).postMessage = function (
-      message: unknown,
-      targetOrigin: string,
-      ...rest: [] | [Transferable[]]
-    ) {
-      if (
-        typeof targetOrigin === "string" &&
-        (targetOrigin === "https://sandbox.minepi.com" || targetOrigin === "https://app-cdn.minepi.com")
-      ) {
-        return _origPostMessage!(message, "*", ...rest);
-      }
-      return _origPostMessage!(message, targetOrigin, ...rest);
-    };
-    return;
-  } catch {
-    // Fall through
-  }
-
-  // Strategy 2: Override window.parent at the instance level.
-  // Used when assignment to window.postMessage is blocked (unlikely) or
-  // when the extension has defined window.parent as an own property that
-  // returns a non-window object.
-  const desc = Object.getOwnPropertyDescriptor(Window.prototype, "parent");
-  const origGet = desc?.get;
-  if (!origGet) return;
-
-  try {
-    const own = Object.getOwnPropertyDescriptor(window, "parent");
-    if (!own || own.configurable) {
-      Object.defineProperty(window, "parent", {
-        get() {
-          const parent = origGet.call(this);
-          if (!parent) return parent;
-          return makeParentProxy(parent as Window);
-        },
-        configurable: true,
-        enumerable: true,
-      });
-      return;
-    }
-  } catch {
-    // Fall through
-  }
-
-  // Strategy 3: Prototype-level override (last resort).
-  if (!desc?.configurable) return;
-  Object.defineProperty(Window.prototype, "parent", {
-    get() {
-      const parent = origGet.call(this);
-      if (!parent) return parent;
-      return makeParentProxy(parent as Window);
-    },
-    configurable: true,
-  });
-}
-
 function injectPiSdkScript(sandbox?: boolean): Promise<void> {
   return new Promise((resolve, reject) => {
+    const existing = document.querySelector('script[src*="pi-sdk.js"]');
+    if (existing && !sandbox) {
+      if ((window as any)?.Pi) return resolve();
+      existing.remove();
+    }
+    if (existing && sandbox && existing.getAttribute("data-sandbox") !== "true") {
+      delete (window as any).Pi;
+      existing.remove();
+    }
+
     const script = document.createElement("script");
-    // Append query parameter to force browser to load a clean script context in sandbox mode
-    script.src = sandbox 
-      ? "https://sdk.minepi.com/pi-sdk.js?env=sandbox" 
+    script.src = sandbox
+      ? "https://sdk.minepi.com/pi-sdk.js?env=sandbox"
       : "https://sdk.minepi.com/pi-sdk.js";
     script.async = true;
-    if (sandbox) {
-      script.setAttribute("data-sandbox", "true");
-    }
+    if (sandbox) script.setAttribute("data-sandbox", "true");
     script.onload = () => resolve();
     script.onerror = () => reject(new Error("Failed to load Pi SDK"));
-    document.body.appendChild(script);
+    document.head.appendChild(script);
   });
 }
 
-async function loadFromCdnWithRetry(sandbox?: boolean): Promise<void> {
-  for (let attempt = 0; attempt < 3; attempt++) {
-    await injectPiSdkScript(sandbox);
-    if ((window as any)?.Pi?.init) {
-      try {
-        (window as any).Pi.init({ version: "2.0", sandbox: !!sandbox });
-      } catch {
-        // init may already have been called; safe to ignore
-      }
-      if ((window as any)?.Pi?.authenticate) {
-        return;
-      }
-    }
-    await new Promise((r) => setTimeout(r, 300));
-  }
-  throw new Error("Pi SDK failed to load after 3 attempts");
-}
+let initPromise: Promise<void> | null = null;
 
 export function ensurePiSdk(sandbox?: boolean): Promise<void> {
   if (typeof window === "undefined") {
     return Promise.reject(new Error("Not in browser"));
   }
 
-  if (sandbox) {
-    patchPostMessageForSandbox();
-    // If sandbox mode is requested, check if the pre-existing script tag has data-sandbox="true".
-    // If it doesn't, it was loaded in production mode by the parent window. We must remove it
-    // and delete window.Pi to force a clean sandbox-mode script reload.
-    const existingScript = document.querySelector('script[src*="pi-sdk.js"]');
-    const isSandboxScript = existingScript?.getAttribute("data-sandbox") === "true";
+  if (initPromise) return initPromise;
 
-    if ((window as any)?.Pi && !isSandboxScript) {
-      console.log("[Pi SDK] Deleting pre-existing production SDK to force sandbox reload...");
-      try {
-        delete (window as any).Pi;
-        if (existingScript) {
-          existingScript.remove();
+  initPromise = (async () => {
+    const existing = (window as any)?.Pi;
+
+    if (existing && existing.init) {
+      await existing.init({ version: "2.0", sandbox: !!sandbox });
+      return;
+    }
+
+    await injectPiSdkScript(sandbox);
+
+    for (let attempt = 0; attempt < 10; attempt++) {
+      const pi = (window as any)?.Pi;
+      if (pi?.init) {
+        try {
+          await pi.init({ version: "2.0", sandbox: !!sandbox });
+        } catch {
+          // init may have already been called
         }
-      } catch (e) {
-        console.warn("[Pi SDK] Failed to clear pre-existing SDK:", e);
+        if ((window as any)?.Pi?.authenticate) return;
       }
+      await new Promise((r) => setTimeout(r, 200));
     }
-  }
 
-  if ((window as any)?.Pi?.authenticate) {
-    try {
-      (window as any).Pi.init({ version: "2.0", sandbox: !!sandbox });
-    } catch {
-      // init may already have been called; safe to ignore
-    }
-    return Promise.resolve();
-  }
-  return loadFromCdnWithRetry(sandbox);
+    throw new Error("Pi SDK failed to initialize");
+  })();
+
+  return initPromise;
 }
diff --git a/apps/axiomid/src/lib/pi-wallet.ts b/apps/axiomid/src/lib/pi-wallet.ts
index 28c91f7..a093db4 100644
--- a/apps/axiomid/src/lib/pi-wallet.ts
+++ b/apps/axiomid/src/lib/pi-wallet.ts
@@ -39,12 +39,12 @@ export async function connectPiWallet(): Promise<PiAuthResult> {
     ? ['username', 'payments']
     : ['username', 'payments', 'wallet_address'];
 
-  const result = await Pi.authenticate({
-    scope: scopes,
-    onIncompletePaymentFound: (payment: any) => {
+  const result = await Pi.authenticate(
+    scopes,
+    (payment: any) => {
       console.warn('Incomplete Pi payment found:', payment.identifier);
     }
-  });
+  );
 
   return {
     accessToken: result.accessToken,

From 9a116e7eef22a9693fecb29c8dd7b2fd40f86195 Mon Sep 17 00:00:00 2001
From: Mohamed Abdelaziz <amrikyy@gmail.com>
Date: Mon, 25 May 2026 03:16:44 +0300
Subject: [PATCH 06/14] fix: simplify ensurePiSdk for sandbox compatibility

---
 apps/axiomid/src/app/layout.tsx |  2 -
 apps/axiomid/src/lib/pi-sdk.ts  | 81 +++++++++++++--------------------
 2 files changed, 31 insertions(+), 52 deletions(-)

diff --git a/apps/axiomid/src/app/layout.tsx b/apps/axiomid/src/app/layout.tsx
index 46f0fcf..beaa998 100644
--- a/apps/axiomid/src/app/layout.tsx
+++ b/apps/axiomid/src/app/layout.tsx
@@ -1,6 +1,5 @@
 import type { Metadata, Viewport } from "next";
 import { Geist, Geist_Mono } from "next/font/google";
-import Script from "next/script";
 import "./globals.css";
 import { WalletProvider } from "./context/wallet-context";
 
@@ -114,7 +113,6 @@ export default function RootLayout({
       <body
         className={`${geistSans.variable} ${geistMono.variable} antialiased bg-black text-white min-h-screen overflow-x-hidden`}
       >
-        <Script src="https://sdk.minepi.com/pi-sdk.js" strategy="beforeInteractive" />
         <WalletProvider>
             {children}
         </WalletProvider>
diff --git a/apps/axiomid/src/lib/pi-sdk.ts b/apps/axiomid/src/lib/pi-sdk.ts
index 8c0ca34..84deff9 100644
--- a/apps/axiomid/src/lib/pi-sdk.ts
+++ b/apps/axiomid/src/lib/pi-sdk.ts
@@ -1,61 +1,42 @@
-function injectPiSdkScript(sandbox?: boolean): Promise<void> {
-  return new Promise((resolve, reject) => {
-    const existing = document.querySelector('script[src*="pi-sdk.js"]');
-    if (existing && !sandbox) {
-      if ((window as any)?.Pi) return resolve();
-      existing.remove();
-    }
-    if (existing && sandbox && existing.getAttribute("data-sandbox") !== "true") {
-      delete (window as any).Pi;
-      existing.remove();
-    }
+export function ensurePiSdk(sandbox?: boolean): Promise<void> {
+  if (typeof window === "undefined") {
+    return Promise.reject(new Error("Not in browser"));
+  }
+
+  const pi = (window as any)?.Pi;
+
+  if (pi?.authenticate) {
+    return Promise.resolve();
+  }
 
+  if (pi?.init) {
+    return pi.init({ version: "2.0", sandbox: !!sandbox }).catch(() => {});
+  }
+
+  return new Promise<void>((resolve, reject) => {
     const script = document.createElement("script");
     script.src = sandbox
       ? "https://sdk.minepi.com/pi-sdk.js?env=sandbox"
       : "https://sdk.minepi.com/pi-sdk.js";
     script.async = true;
     if (sandbox) script.setAttribute("data-sandbox", "true");
-    script.onload = () => resolve();
+    script.onload = () => {
+      const tryInit = () => {
+        const p = (window as any)?.Pi;
+        if (p?.init) {
+          p.init({ version: "2.0", sandbox: !!sandbox }).then(() => {
+            if ((window as any)?.Pi?.authenticate) resolve();
+            else setTimeout(tryInit, 300);
+          }).catch(resolve);
+        } else if (p?.authenticate) {
+          resolve();
+        } else {
+          setTimeout(tryInit, 300);
+        }
+      };
+      tryInit();
+    };
     script.onerror = () => reject(new Error("Failed to load Pi SDK"));
     document.head.appendChild(script);
   });
 }
-
-let initPromise: Promise<void> | null = null;
-
-export function ensurePiSdk(sandbox?: boolean): Promise<void> {
-  if (typeof window === "undefined") {
-    return Promise.reject(new Error("Not in browser"));
-  }
-
-  if (initPromise) return initPromise;
-
-  initPromise = (async () => {
-    const existing = (window as any)?.Pi;
-
-    if (existing && existing.init) {
-      await existing.init({ version: "2.0", sandbox: !!sandbox });
-      return;
-    }
-
-    await injectPiSdkScript(sandbox);
-
-    for (let attempt = 0; attempt < 10; attempt++) {
-      const pi = (window as any)?.Pi;
-      if (pi?.init) {
-        try {
-          await pi.init({ version: "2.0", sandbox: !!sandbox });
-        } catch {
-          // init may have already been called
-        }
-        if ((window as any)?.Pi?.authenticate) return;
-      }
-      await new Promise((r) => setTimeout(r, 200));
-    }
-
-    throw new Error("Pi SDK failed to initialize");
-  })();
-
-  return initPromise;
-}

From acb60f5102e47c569fa73241838d59fd5003f22f Mon Sep 17 00:00:00 2001
From: Mohamed Abdelaziz <amrikyy@gmail.com>
Date: Mon, 25 May 2026 03:27:10 +0300
Subject: [PATCH 07/14] fix: add patchPostMessage for sandbox cross-origin,
 remove ?env=sandbox from URL

---
 DESIGN.md                      | 168 +++++++++++++++++++++++++++++++++
 apps/axiomid/src/lib/pi-sdk.ts |  63 ++++++++++---
 2 files changed, 217 insertions(+), 14 deletions(-)
 create mode 100644 DESIGN.md

diff --git a/DESIGN.md b/DESIGN.md
new file mode 100644
index 0000000..fab90d9
--- /dev/null
+++ b/DESIGN.md
@@ -0,0 +1,168 @@
+---
+name: AxiomID Agentic
+colors:
+  primary: "#00FF41"
+  secondary: "#00D4FF"
+  accent: "#FBBF24"
+  success: "#16A34A"
+  warning: "#D97706"
+  danger: "#DC2626"
+  background: "#060608"
+  surface: "#09090B"
+  foreground: "#F4F4F6"
+  muted: "#121217"
+  border: "rgba(0, 255, 65, 0.08)"
+typography:
+  h1:
+    fontFamily: "Geist"
+    fontSize: 2.5rem
+  h2:
+    fontFamily: "Geist"
+    fontSize: 1.75rem
+  body-md:
+    fontFamily: "Geist"
+    fontSize: 1rem
+  body-sm:
+    fontFamily: "Geist"
+    fontSize: 0.875rem
+  label-caps:
+    fontFamily: "Geist Mono"
+    fontSize: 0.75rem
+    textTransform: uppercase
+    letterSpacing: 0.05em
+  sourceScale: "14/16/18/24/32/40"
+  weights: "300, 400, 500, 600, 700, 800, 900"
+rounded:
+  sm: 8px
+  md: 14px
+  lg: 20px
+  full: 9999px
+spacing:
+  xs: 4px
+  sm: 8px
+  md: 16px
+  lg: 24px
+  xl: 32px
+  sourceScale: "8pt baseline grid"
+---
+
+## Overview
+
+Conversational AI-first interface with minimal controls, clear outcomes, and delegated task flows for agentic workflows. Dark cyberpunk aesthetic with neon green accents and glass-morphism surfaces.
+
+## Style Foundations
+
+- **Visual style:** dark, modern, cyberpunk, glass-morphism
+- **Typography scale:** 14/16/18/24/32/40
+- **Typography fonts:** primary=Geist, display=Geist, mono=Geist Mono
+- **Typography weights:** 300, 400, 500, 600, 700, 800, 900
+- **Color palette:** dark background (#060608), neon green primary (#00FF41), electric blue secondary (#00D4FF), gold accent (#FBBF24)
+- **Spacing scale:** 8pt baseline grid
+- **Surfaces:** glass-panel with backdrop-filter blur(12px), semi-transparent borders
+- **Glow effects:** text-shadow and box-shadow with rgba primary color glow
+
+## Colors
+
+- **Background (#060608):** Deep near-black base.
+- **Surface (#09090B):** Slightly lighter card/panel surfaces.
+- **Foreground (#F4F4F6):** Near-white text on dark backgrounds.
+- **Primary (#00FF41):** Neon green — interactive elements, active states, hover glows.
+- **Secondary (#00D4FF):** Electric blue — secondary actions, gradients.
+- **Accent (#FBBF24):** Gold — highlights, badges, premium indicators.
+- **Success (#16A34A):** Green status indicators.
+- **Warning (#D97706):** Amber warning signals.
+- **Danger (#DC2626):** Red destructive actions and error states.
+- **Muted (#121217):** Subtle background layers, dividers.
+- **Border (rgba(0, 255, 65, 0.08)):** Subtle green-tinted borders.
+
+## Typography
+
+- **Headings:** Geist (sans-serif), bold weights (600-800)
+- **Body:** Geist (sans-serif), weight 400
+- **Mono:** Geist Mono for code, labels, and data displays
+- **Label caps:** 0.75rem, uppercase, 0.05em letter-spacing, Geist Mono
+
+## Spacing
+
+- **Grid:** 8pt baseline grid
+- **Card padding:** 20-24px
+- **Section gaps:** 32-48px
+- **Component gaps:** 12-16px
+
+## Rounded Corners
+
+- **Cards (bento):** 20px radius with glass border
+- **Buttons:** 12px radius
+- **Inputs:** 10px radius
+- **Pills/badges:** 9999px (full rounded)
+
+## Components
+
+### Bento Card
+- Background: rgba(9, 9, 11, 0.75) with backdrop-filter blur(16px)
+- Border: 1px solid rgba(0, 255, 65, 0.08)
+- Border-radius: 20px
+- Top gradient line on hover: linear-gradient(90deg, transparent, #00FF41, #00D4FF, transparent)
+- Hover: translateY(-2px), green glow shadow, border opacity increase
+
+### Primary Button
+- Gradient background: rgba(0, 255, 65, 0.15) to rgba(0, 212, 255, 0.15)
+- Hover: solid #00FF41 to #00D4FF gradient, black text
+- Text: 0.75rem uppercase, Geist Mono, 0.05em letter-spacing
+
+### Ghost Button
+- Background: rgba(255, 255, 255, 0.02)
+- Border: 1px solid rgba(255, 255, 255, 0.05)
+- Hover: white text, brighter border
+
+### Engineering Grid Background
+- Background pattern: 40px grid with subtle white lines at 1.5% opacity
+- Mask: radial gradient at center (black 30%, transparent 95%)
+- Scanline: animated 4px top-to-bottom purple gradient line
+
+### Glow Text
+- .text-neon: #00FF41 with 10px green text-shadow
+- .text-electric: #00D4FF with 10px blue text-shadow
+
+### Scrollbar
+- Width: 5px
+- Track: #030305
+- Thumb: #1F1F2E, rounded, hover turns green (#00FF41)
+
+## Animation
+
+- Card hover: 0.5s cubic-bezier(0.16, 1, 0.3, 1)
+- Button hover: 0.3s cubic-bezier(0.16, 1, 0.3, 1)
+- Scanline: 8s linear infinite
+- Pulse-slow: 3s cubic-bezier(0.4, 0, 0.6, 1) infinite
+
+## Accessibility
+
+- Contrast ratio minimum 4.5:1 for text
+- Focus indicators with green glow outline
+- Interactive elements have visible hover/focus states
+- Reduced motion: respect prefers-reduced-motion
+
+## Writing Tone
+
+- Technical, concise, Arabic-supportive
+- English UI labels, Arabic content where appropriate
+- Short labels, clear CTAs
+
+## Rules: Do
+
+- Use dark theme as default (color-scheme: dark)
+- Use neon green (#00FF41) for primary CTAs and active states
+- Use glass-morphism for cards and panels
+- Apply backdrop-filter blur on overlay surfaces
+- Use Geist Mono for code, labels, technical data
+- Use gradient borders on hover for interactive cards
+- Keep generous whitespace and breathing room
+
+## Rules: Don't
+
+- Don't use pure white backgrounds (#FFFFFF) on dark surfaces
+- Don't use bright saturated colors without alpha for backgrounds
+- Don't add box-shadows without considering glow effects
+- Don't use non-Geist font families
+- Don't create heavy/dense layouts — prefer bento grid with whitespace
diff --git a/apps/axiomid/src/lib/pi-sdk.ts b/apps/axiomid/src/lib/pi-sdk.ts
index 84deff9..4fc84b7 100644
--- a/apps/axiomid/src/lib/pi-sdk.ts
+++ b/apps/axiomid/src/lib/pi-sdk.ts
@@ -1,42 +1,77 @@
+function patchPostMessage(): void {
+  if (typeof window === "undefined") return;
+  try {
+    const orig = window.postMessage.bind(window);
+    (window as any).postMessage = function (
+      message: unknown,
+      targetOrigin: string,
+      ...rest: [] | [Transferable[]]
+    ) {
+      if (
+        typeof targetOrigin === "string" &&
+        (targetOrigin === "https://sandbox.minepi.com" ||
+          targetOrigin === "https://app-cdn.minepi.com")
+      ) {
+        return orig(message, "*", ...rest);
+      }
+      return orig(message, targetOrigin, ...rest);
+    };
+  } catch {}
+}
+
+let initPromise: Promise<void> | null = null;
+
 export function ensurePiSdk(sandbox?: boolean): Promise<void> {
   if (typeof window === "undefined") {
     return Promise.reject(new Error("Not in browser"));
   }
 
+  if (sandbox) patchPostMessage();
+
+  if (initPromise) return initPromise;
+
   const pi = (window as any)?.Pi;
 
   if (pi?.authenticate) {
-    return Promise.resolve();
+    initPromise = Promise.resolve();
+    return initPromise;
   }
 
   if (pi?.init) {
-    return pi.init({ version: "2.0", sandbox: !!sandbox }).catch(() => {});
+    initPromise = pi.init({ version: "2.0", sandbox: !!sandbox })
+      .then(() => {}).catch(() => {});
+    return initPromise;
   }
 
-  return new Promise<void>((resolve, reject) => {
+  initPromise = new Promise<void>((resolve) => {
     const script = document.createElement("script");
-    script.src = sandbox
-      ? "https://sdk.minepi.com/pi-sdk.js?env=sandbox"
-      : "https://sdk.minepi.com/pi-sdk.js";
+    script.src = "https://sdk.minepi.com/pi-sdk.js";
     script.async = true;
     if (sandbox) script.setAttribute("data-sandbox", "true");
     script.onload = () => {
-      const tryInit = () => {
+      const wait = () => {
         const p = (window as any)?.Pi;
         if (p?.init) {
-          p.init({ version: "2.0", sandbox: !!sandbox }).then(() => {
-            if ((window as any)?.Pi?.authenticate) resolve();
-            else setTimeout(tryInit, 300);
-          }).catch(resolve);
+          p.init({ version: "2.0", sandbox: !!sandbox })
+            .then(() => {
+              if ((window as any)?.Pi?.authenticate) resolve();
+              else setTimeout(wait, 300);
+            })
+            .catch(resolve);
         } else if (p?.authenticate) {
           resolve();
         } else {
-          setTimeout(tryInit, 300);
+          setTimeout(wait, 300);
         }
       };
-      tryInit();
+      wait();
+    };
+    script.onerror = () => {
+      console.error("Failed to load Pi SDK");
+      resolve();
     };
-    script.onerror = () => reject(new Error("Failed to load Pi SDK"));
     document.head.appendChild(script);
   });
+
+  return initPromise;
 }

From 3ba6a82a16d7cd956ac8fefb36f6ee765bf39c7e Mon Sep 17 00:00:00 2001
From: Mohamed Abdelaziz <amrikyy@gmail.com>
Date: Mon, 25 May 2026 03:34:31 +0300
Subject: [PATCH 08/14] fix: TypeScript type error on cached promise return

---
 apps/axiomid/src/lib/pi-sdk.ts | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/apps/axiomid/src/lib/pi-sdk.ts b/apps/axiomid/src/lib/pi-sdk.ts
index 4fc84b7..8d76da9 100644
--- a/apps/axiomid/src/lib/pi-sdk.ts
+++ b/apps/axiomid/src/lib/pi-sdk.ts
@@ -19,7 +19,7 @@ function patchPostMessage(): void {
   } catch {}
 }
 
-let initPromise: Promise<void> | null = null;
+let cached: Promise<void> | null = null;
 
 export function ensurePiSdk(sandbox?: boolean): Promise<void> {
   if (typeof window === "undefined") {
@@ -28,22 +28,22 @@ export function ensurePiSdk(sandbox?: boolean): Promise<void> {
 
   if (sandbox) patchPostMessage();
 
-  if (initPromise) return initPromise;
+  if (cached) return cached as Promise<void>;
 
   const pi = (window as any)?.Pi;
 
   if (pi?.authenticate) {
-    initPromise = Promise.resolve();
-    return initPromise;
+    cached = Promise.resolve();
+    return cached as Promise<void>;
   }
 
   if (pi?.init) {
-    initPromise = pi.init({ version: "2.0", sandbox: !!sandbox })
-      .then(() => {}).catch(() => {});
-    return initPromise;
+    cached = pi.init({ version: "2.0", sandbox: !!sandbox })
+      .then(() => undefined).catch(() => undefined);
+    return cached as Promise<void>;
   }
 
-  initPromise = new Promise<void>((resolve) => {
+  cached = new Promise<void>((resolve) => {
     const script = document.createElement("script");
     script.src = "https://sdk.minepi.com/pi-sdk.js";
     script.async = true;
@@ -57,7 +57,7 @@ export function ensurePiSdk(sandbox?: boolean): Promise<void> {
               if ((window as any)?.Pi?.authenticate) resolve();
               else setTimeout(wait, 300);
             })
-            .catch(resolve);
+            .catch(() => resolve());
         } else if (p?.authenticate) {
           resolve();
         } else {
@@ -73,5 +73,5 @@ export function ensurePiSdk(sandbox?: boolean): Promise<void> {
     document.head.appendChild(script);
   });
 
-  return initPromise;
+  return cached as Promise<void>;
 }

From e1c7a20eb68a58ddc52a0d72c9c28fc26877b2a0 Mon Sep 17 00:00:00 2001
From: Mohamed Abdelaziz <amrikyy@gmail.com>
Date: Mon, 25 May 2026 04:09:42 +0300
Subject: [PATCH 09/14] fix: Pi SDK auth per official docs + redesign
 privacy/terms pages + fix auth-connect test

---
 .../app/api/__tests__/auth-connect.test.ts    |  31 ----
 .../src/app/context/wallet-context.tsx        | 166 ++++--------------
 apps/axiomid/src/app/layout.tsx               |   2 +
 apps/axiomid/src/app/privacy/page.tsx         | 110 ++++++++++--
 apps/axiomid/src/app/terms/page.tsx           | 122 +++++++++++--
 apps/axiomid/src/lib/pi-sdk.ts                | 100 +++--------
 6 files changed, 269 insertions(+), 262 deletions(-)

diff --git a/apps/axiomid/src/app/api/__tests__/auth-connect.test.ts b/apps/axiomid/src/app/api/__tests__/auth-connect.test.ts
index 0d5d511..704fbab 100644
--- a/apps/axiomid/src/app/api/__tests__/auth-connect.test.ts
+++ b/apps/axiomid/src/app/api/__tests__/auth-connect.test.ts
@@ -20,10 +20,6 @@ jest.mock('@/lib/prisma', () => ({
   },
 }));
 
-jest.mock('@/lib/tiers', () => ({
-  calculateTier: jest.fn(),
-}));
-
 import { POST } from '../auth/connect/route';
 
 describe('POST /api/auth/connect', () => {
@@ -66,33 +62,6 @@ describe('POST /api/auth/connect', () => {
     expect(prisma.user.create).toHaveBeenCalled();
   });
 
-  it('should return existing user and update tier if necessary', async () => {
-    const existingUser = {
-      walletAddress: mockWalletAddress,
-      xp: 150,
-      tier: 'Ghost',
-      actions: [],
-    };
-
-    (prisma.user.findUnique as any).mockResolvedValue(existingUser);
-    (calculateTier as any).mockReturnValue('Spark');
-    (prisma.user.update as any).mockResolvedValue({
-      ...existingUser,
-      tier: 'Spark',
-    });
-
-    const req = {
-      json: async () => ({ walletAddress: mockWalletAddress }),
-    } as Request;
-
-    const res = await POST(req);
-    const data = await res.json();
-
-    expect(res.status).toBe(200);
-    expect(data.user.tier).toBe('Spark');
-    expect(prisma.user.update).toHaveBeenCalled();
-  });
-
   it('should return 500 on internal error', async () => {
     (prisma.user.findUnique as any).mockRejectedValue(new Error('DB Error'));
 
diff --git a/apps/axiomid/src/app/context/wallet-context.tsx b/apps/axiomid/src/app/context/wallet-context.tsx
index 2b97aa2..c64fcb3 100644
--- a/apps/axiomid/src/app/context/wallet-context.tsx
+++ b/apps/axiomid/src/app/context/wallet-context.tsx
@@ -2,7 +2,7 @@
 
 import { createContext, useContext, useState, useEffect, useCallback, useRef, ReactNode } from "react";
 import { Tier, getLevelProgress, getNextLevelXP } from "@/lib/tiers";
-import { ensurePiSdk } from "@/lib/pi-sdk";
+import { initPiSdk, authenticatePi } from "@/lib/pi-sdk";
 
 export interface User {
   id: string;
@@ -36,31 +36,16 @@ interface WalletContextType {
 
 const WalletContext = createContext<WalletContextType | null>(null);
 
-function getSandboxFlag(): boolean {
-  if (process.env.NEXT_PUBLIC_PI_SANDBOX === "true") return true;
-  if (typeof window !== "undefined") {
-    const params = new URLSearchParams(window.location.search);
-    if (params.get("sandbox") === "true") return true;
-  }
-  return false;
-}
-
-const SANDBOX = getSandboxFlag();
-const AUTH_TIMEOUT_MS = 15000;
-
-function detectPiBrowser(): boolean {
+function isPiBrowser(): boolean {
   if (typeof navigator === "undefined") return false;
-  if (typeof window !== "undefined" && !!(window as any)?.Pi?.authenticate) return true;
-  return /Pi Browser|minepi/i.test(navigator.userAgent);
+  const ua = navigator.userAgent;
+  return /Pi Browser|minepi/i.test(ua);
 }
 
-function withTimeout<T>(promise: Promise<T>, ms: number): Promise<T> {
-  return Promise.race([
-    promise,
-    new Promise<T>((_, reject) =>
-      setTimeout(() => reject(new Error(`Timed out after ${ms}ms`)), ms)
-    ),
-  ]);
+function isSandbox(): boolean {
+  if (process.env.NEXT_PUBLIC_PI_SANDBOX === "true") return true;
+  if (typeof window !== "undefined" && new URLSearchParams(window.location.search).get("sandbox") === "true") return true;
+  return false;
 }
 
 export function WalletProvider({ children }: { children: ReactNode }) {
@@ -68,149 +53,70 @@ export function WalletProvider({ children }: { children: ReactNode }) {
   const [isConnecting, setIsConnecting] = useState(false);
   const [isLoading, setIsLoading] = useState(true);
   const [error, setError] = useState<string | null>(null);
-  const [isPiBrowser, setIsPiBrowser] = useState(false);
 
   const levelProgress = user ? getLevelProgress(user.xp, user.tier) : 0;
   const nextXP = user ? getNextLevelXP(user.tier) : null;
-
   const authAttempted = useRef(false);
 
-  useEffect(() => {
-    setIsPiBrowser(detectPiBrowser());
-    console.log("[AUTH DEBUG] SANDBOX flag:", SANDBOX, "| env:", process.env.NEXT_PUBLIC_PI_SANDBOX, "| url:", window.location.search.includes("sandbox=true"));
-  }, []);
-
-  useEffect(() => {
-    setIsLoading(false);
-  }, []);
+  const isPiBrowserVal = isPiBrowser();
+  const sandbox = isSandbox();
+  const shouldUsePi = isPiBrowserVal || sandbox;
 
   const connectWallet = useCallback(async () => {
     setIsConnecting(true);
     setError(null);
 
-    const debug = (label: string, data?: unknown) => {
-      console.log(`[AUTH DEBUG] ${label}`, data ?? "");
-    };
-
     try {
-      let walletAddress = "";
-      let piUid = "";
-      let piUsername = "";
-      let accessToken = "";
-
-      const inPiBrowser = detectPiBrowser();
-      const isSandbox = getSandboxFlag();
-      const inIframe = typeof window !== "undefined" && window.self !== window.parent;
-      
-      debug("inPiBrowser", inPiBrowser);
-      debug("isSandbox", isSandbox);
-      debug("inIframe", inIframe);
-      debug("hasPi", typeof window !== "undefined" && !!window.Pi);
-
-      const usePi = inPiBrowser || isSandbox;
-      debug("usePi", usePi);
+      if (!shouldUsePi) {
+        setError("Open this app in Pi Browser");
+        return;
+      }
 
-      if (usePi) {
-        debug("loading Pi SDK...");
-        await withTimeout(ensurePiSdk(isSandbox), AUTH_TIMEOUT_MS);
-        const pi = typeof window !== "undefined" ? (window as any).Pi : undefined;
-        debug("Pi SDK loaded", !!pi?.authenticate);
-        if (!pi?.authenticate) throw new Error("Pi SDK not available");
+      await initPiSdk(sandbox);
 
-        debug("calling Pi.authenticate...");
-        const scopes = isSandbox
-          ? ["username", "payments"]
-          : ["username", "payments", "wallet_address"];
-        debug("scopes requested:", scopes);
-        const auth = (await withTimeout(
-          pi.authenticate(
-            scopes,
-            (payment: any) => {
-              console.warn("Incomplete payment:", payment?.identifier);
-            }
-          ),
-          AUTH_TIMEOUT_MS
-        )) as any;
-        debug("Pi.authenticate done", { uid: auth?.user?.uid, username: auth?.user?.username });
+      const { accessToken, user: piUser } = await authenticatePi(["username"]);
 
-        piUid = auth.user.uid;
-        piUsername = auth.user.username;
-        accessToken = auth.accessToken;
-        walletAddress = `pi:${piUid}`;
-      } else {
-        debug("using demo wallet");
-        // Reuse stored wallet if available, otherwise generate new demo wallet
-        const storedWallet = localStorage.getItem("axiomid_wallet");
-        if (storedWallet && storedWallet.startsWith("demo:")) {
-          walletAddress = storedWallet;
-        } else {
-          walletAddress = `demo:${crypto.randomUUID().slice(0, 8)}`;
-        }
-      }
+      const walletAddress = `pi:${piUser.uid}`;
 
-      debug("saving wallet to localStorage", walletAddress);
-      localStorage.setItem("axiomid_wallet", walletAddress);
-      if (accessToken) localStorage.setItem("axiomid_token", accessToken);
-
-      const endpoint = usePi ? "/api/auth/pi" : "/api/auth/connect";
-      const body = usePi
-        ? JSON.stringify({ accessToken, uid: piUid, walletAddress, username: piUsername })
-        : JSON.stringify({ walletAddress, piUid, piUsername, accessToken });
-      debug(`POST ${endpoint}`, { walletAddress, hasAccessToken: !!accessToken });
-      const res = await fetch(endpoint, {
+      const res = await fetch("/api/auth/pi", {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body,
+        body: JSON.stringify({
+          accessToken,
+          uid: piUser.uid,
+          username: piUser.username,
+          walletAddress,
+        }),
       });
 
       if (!res.ok) {
         const err = await res.json();
-        debug(`${endpoint} failed`, err);
         throw new Error(err.error || "Authentication failed");
       }
 
       const data = await res.json();
-      debug(`${endpoint} success`, data.user);
       setUser(data.user);
     } catch (err: unknown) {
       const message = err instanceof Error ? err.message : "Connection failed";
-      debug("connectWallet error", message);
-      console.error(err);
+      console.error("Auth error:", message);
       setError(message);
     } finally {
       setIsConnecting(false);
     }
+  }, [shouldUsePi, sandbox]);
+
+  useEffect(() => {
+    setIsLoading(false);
   }, []);
 
   useEffect(() => {
     if (authAttempted.current) return;
     authAttempted.current = true;
 
-    const inPiBrowser = detectPiBrowser();
-    const isSandbox = getSandboxFlag();
-    const inIframe = typeof window !== "undefined" && window.self !== window.parent;
-    const isPiEnv = inPiBrowser || isSandbox;
-    console.log("[AUTH DEBUG] auto-auth: SANDBOX=", isSandbox, "PiBrowser=", inPiBrowser, "inIframe=", inIframe, "isPiEnv=", isPiEnv);
-
-    if (isPiEnv) {
+    if (shouldUsePi) {
       connectWallet();
-    } else {
-      const storedWallet = localStorage.getItem("axiomid_wallet");
-      const storedToken = localStorage.getItem("axiomid_token");
-      if (storedWallet) {
-        fetch("/api/auth/connect", {
-          method: "POST",
-          headers: { "Content-Type": "application/json" },
-          body: JSON.stringify({ walletAddress: storedWallet, accessToken: storedToken || undefined }),
-        })
-          .then((res) => res.json())
-          .then((data) => {
-            if (data.user) setUser(data.user);
-          })
-          .catch(() => {});
-      }
     }
-  }, [connectWallet]);
+  }, [shouldUsePi, connectWallet]);
 
   const claimAction = useCallback(async (actionType: string) => {
     if (!user) return false;
@@ -251,12 +157,11 @@ export function WalletProvider({ children }: { children: ReactNode }) {
 
   const createAgent = useCallback(async (name?: string) => {
     if (!user) return false;
-    const token = localStorage.getItem("axiomid_token");
     try {
       const res = await fetch("/api/agent", {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ walletAddress: user.walletAddress, name, accessToken: token || undefined }),
+        body: JSON.stringify({ walletAddress: user.walletAddress, name }),
       });
       if (!res.ok) return false;
       await refreshUser();
@@ -268,12 +173,11 @@ export function WalletProvider({ children }: { children: ReactNode }) {
 
   const activateAgent = useCallback(async () => {
     if (!user) return false;
-    const token = localStorage.getItem("axiomid_token");
     try {
       const res = await fetch("/api/agent/activate", {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ walletAddress: user.walletAddress, accessToken: token || undefined }),
+        body: JSON.stringify({ walletAddress: user.walletAddress }),
       });
       if (!res.ok) return false;
       await refreshUser();
@@ -290,7 +194,7 @@ export function WalletProvider({ children }: { children: ReactNode }) {
         isLoading,
         isConnecting,
         error,
-        isPiBrowser,
+        isPiBrowser: isPiBrowserVal,
         connectWallet,
         claimAction,
         refreshUser,
diff --git a/apps/axiomid/src/app/layout.tsx b/apps/axiomid/src/app/layout.tsx
index beaa998..46f0fcf 100644
--- a/apps/axiomid/src/app/layout.tsx
+++ b/apps/axiomid/src/app/layout.tsx
@@ -1,5 +1,6 @@
 import type { Metadata, Viewport } from "next";
 import { Geist, Geist_Mono } from "next/font/google";
+import Script from "next/script";
 import "./globals.css";
 import { WalletProvider } from "./context/wallet-context";
 
@@ -113,6 +114,7 @@ export default function RootLayout({
       <body
         className={`${geistSans.variable} ${geistMono.variable} antialiased bg-black text-white min-h-screen overflow-x-hidden`}
       >
+        <Script src="https://sdk.minepi.com/pi-sdk.js" strategy="beforeInteractive" />
         <WalletProvider>
             {children}
         </WalletProvider>
diff --git a/apps/axiomid/src/app/privacy/page.tsx b/apps/axiomid/src/app/privacy/page.tsx
index 5ce50e7..9ac3e73 100644
--- a/apps/axiomid/src/app/privacy/page.tsx
+++ b/apps/axiomid/src/app/privacy/page.tsx
@@ -1,20 +1,104 @@
 "use client";
 
+import Link from "next/link";
+
+function BentoCard({ children, className = "" }: { children: React.ReactNode; className?: string }) {
+  return (
+    <div className={`bento-card p-6 md:p-8 ${className}`}>
+      {children}
+    </div>
+  );
+}
+
 export default function Privacy() {
   return (
-    <main className="min-h-screen bg-oled text-white p-8 max-w-3xl mx-auto font-mono">
-      <h1 className="text-2xl text-neon-green mb-6">Privacy Policy</h1>
-      <p className="text-gray-400 mb-4 text-sm">Last updated: May 17, 2026</p>
-      <div className="space-y-4 text-gray-300 text-sm leading-relaxed">
-        <p>AxiomID (&quot;the App&quot;) respects your privacy. This policy describes how we handle your information.</p>
-        <h2 className="text-white text-lg mt-6">Information We Collect</h2>
-        <p>When you connect your wallet, we collect your wallet address and Pi Network UID for the purpose of authentication and XP tracking.</p>
-        <h2 className="text-white text-lg mt-6">How We Use Information</h2>
-        <p>We use your information solely to operate the App, track reputation scores, and enable AI agent verification. We do not sell or share your data with third parties.</p>
-        <h2 className="text-white text-lg mt-6">Data Storage</h2>
-        <p>Your data is stored securely in our PostgreSQL database. You may request deletion of your data at any time by contacting us.</p>
-        <h2 className="text-white text-lg mt-6">Contact</h2>
-        <p>For questions, reach out via GitHub: <a href="https://github.com/Moeabdelaziz007" target="_blank" rel="noopener noreferrer" className="text-neon-green underline">Moeabdelaziz007 on GitHub</a></p>
+    <main className="min-h-screen bg-grid relative">
+      <div className="scanline" />
+
+      {/* Header */}
+      <header className="w-full flex justify-between items-center p-4 md:p-8 max-w-4xl mx-auto relative z-10">
+        <Link href="/" className="flex items-center gap-2 group">
+          <div className="w-8 h-8 rounded bg-neon-green/20 flex items-center justify-center border border-neon-green/50 group-hover:bg-neon-green/30 transition-all">
+            <span className="text-neon-green font-bold text-sm">A</span>
+          </div>
+          <span className="font-mono text-lg tracking-tighter">
+            AXIOM<span className="text-gray-600">ID</span>
+          </span>
+        </Link>
+        <Link
+          href="/"
+          className="btn-ghost text-xs font-mono"
+        >
+          ← BACK
+        </Link>
+      </header>
+
+      {/* Content */}
+      <div className="max-w-3xl mx-auto px-4 pb-20 relative z-10">
+        <BentoCard>
+          <div className="flex items-center gap-3 mb-6">
+            <span className="px-3 py-1 rounded-full text-[10px] font-mono bg-neon-green/10 text-neon-green border border-neon-green/20">
+              LEGAL
+            </span>
+            <span className="text-xs font-mono text-gray-500">Last updated: May 17, 2026</span>
+          </div>
+
+          <h1 className="text-3xl md:text-4xl font-bold tracking-tight mb-2">
+            Privacy <span className="text-transparent bg-clip-text bg-gradient-to-r from-neon-green to-electric-blue">Policy</span>
+          </h1>
+          <p className="text-gray-400 text-sm mb-8 font-mono">
+            How AxiomID handles your data.
+          </p>
+
+          <div className="space-y-6 text-gray-300 text-sm leading-relaxed">
+            <section>
+              <h2 className="text-white text-lg font-semibold mb-2 flex items-center gap-2">
+                <span className="w-1.5 h-1.5 rounded-full bg-neon-green" />
+                Information We Collect
+              </h2>
+              <p>
+                When you connect your wallet via Pi Network, we collect your Pi wallet address and Pi Network UID for the purpose of authentication and XP tracking. We do <strong className="text-neon-green">not</strong> collect personal identifiable information such as your name, email, or IP address beyond standard server logs.
+              </p>
+            </section>
+
+            <section>
+              <h2 className="text-white text-lg font-semibold mb-2 flex items-center gap-2">
+                <span className="w-1.5 h-1.5 rounded-full bg-electric-blue" />
+                How We Use Information
+              </h2>
+              <p>
+                We use your wallet address and Pi UID solely to operate the App, track reputation scores (XP/Tier), and enable AI agent verification. Your data is never sold or shared with third parties. Aggregated, anonymized analytics may be used for platform improvement.
+              </p>
+            </section>
+
+            <section>
+              <h2 className="text-white text-lg font-semibold mb-2 flex items-center gap-2">
+                <span className="w-1.5 h-1.5 rounded-full bg-axiom-gold" />
+                Data Storage & Security
+              </h2>
+              <p>
+                Your data is stored securely in our PostgreSQL database on Ghost infrastructure. We implement industry-standard encryption at rest and in transit. You may request deletion of your data at any time by contacting us via GitHub.
+              </p>
+            </section>
+
+            <section>
+              <h2 className="text-white text-lg font-semibold mb-2 flex items-center gap-2">
+                <span className="w-1.5 h-1.5 rounded-full bg-neon-green" />
+                Your Rights
+              </h2>
+              <p>
+                You have the right to access, correct, or delete your data. To exercise these rights, open an issue on our GitHub repository or reach out to the developer directly.
+              </p>
+            </section>
+          </div>
+        </BentoCard>
+
+        {/* Footer */}
+        <div className="mt-8 text-center">
+          <p className="text-xs font-mono text-gray-600">
+            &copy; 2026 AxiomID — Built on Pi Network
+          </p>
+        </div>
       </div>
     </main>
   );
diff --git a/apps/axiomid/src/app/terms/page.tsx b/apps/axiomid/src/app/terms/page.tsx
index fff7007..daf3be3 100644
--- a/apps/axiomid/src/app/terms/page.tsx
+++ b/apps/axiomid/src/app/terms/page.tsx
@@ -1,22 +1,114 @@
 "use client";
 
+import Link from "next/link";
+
+function BentoCard({ children, className = "" }: { children: React.ReactNode; className?: string }) {
+  return (
+    <div className={`bento-card p-6 md:p-8 ${className}`}>
+      {children}
+    </div>
+  );
+}
+
 export default function Terms() {
   return (
-    <main className="min-h-screen bg-oled text-white p-8 max-w-3xl mx-auto font-mono">
-      <h1 className="text-2xl text-neon-green mb-6">Terms of Service</h1>
-      <p className="text-gray-400 mb-4 text-sm">Last updated: May 17, 2026</p>
-      <div className="space-y-4 text-gray-300 text-sm leading-relaxed">
-        <p>By using AxiomID (&quot;the App&quot;), you agree to the following terms.</p>
-        <h2 className="text-white text-lg mt-6">Use of Service</h2>
-        <p>The App provides decentralized identity verification and reputation tracking. You may use it in compliance with applicable laws.</p>
-        <h2 className="text-white text-lg mt-6">Wallet Connection</h2>
-        <p>Connecting your Pi wallet is required for authentication. You are responsible for maintaining the security of your wallet.</p>
-        <h2 className="text-white text-lg mt-6">AI Agent Verification</h2>
-        <p>One AI agent per user may be verified. The verified agent may interact with ecosystem products on your behalf.</p>
-        <h2 className="text-white text-lg mt-6">Limitation of Liability</h2>
-        <p>The App is provided &quot;as is&quot; without warranties. We are not liable for damages arising from use of the service.</p>
-        <h2 className="text-white text-lg mt-6">Changes</h2>
-        <p>We may update these terms. Continued use after changes constitutes acceptance.</p>
+    <main className="min-h-screen bg-grid relative">
+      <div className="scanline" />
+
+      {/* Header */}
+      <header className="w-full flex justify-between items-center p-4 md:p-8 max-w-4xl mx-auto relative z-10">
+        <Link href="/" className="flex items-center gap-2 group">
+          <div className="w-8 h-8 rounded bg-neon-green/20 flex items-center justify-center border border-neon-green/50 group-hover:bg-neon-green/30 transition-all">
+            <span className="text-neon-green font-bold text-sm">A</span>
+          </div>
+          <span className="font-mono text-lg tracking-tighter">
+            AXIOM<span className="text-gray-600">ID</span>
+          </span>
+        </Link>
+        <Link
+          href="/"
+          className="btn-ghost text-xs font-mono"
+        >
+          ← BACK
+        </Link>
+      </header>
+
+      {/* Content */}
+      <div className="max-w-3xl mx-auto px-4 pb-20 relative z-10">
+        <BentoCard>
+          <div className="flex items-center gap-3 mb-6">
+            <span className="px-3 py-1 rounded-full text-[10px] font-mono bg-neon-green/10 text-neon-green border border-neon-green/20">
+              LEGAL
+            </span>
+            <span className="text-xs font-mono text-gray-500">Last updated: May 17, 2026</span>
+          </div>
+
+          <h1 className="text-3xl md:text-4xl font-bold tracking-tight mb-2">
+            Terms of <span className="text-transparent bg-clip-text bg-gradient-to-r from-neon-green to-electric-blue">Service</span>
+          </h1>
+          <p className="text-gray-400 text-sm mb-8 font-mono">
+            By using AxiomID, you agree to these terms.
+          </p>
+
+          <div className="space-y-6 text-gray-300 text-sm leading-relaxed">
+            <section>
+              <h2 className="text-white text-lg font-semibold mb-2 flex items-center gap-2">
+                <span className="w-1.5 h-1.5 rounded-full bg-neon-green" />
+                Use of Service
+              </h2>
+              <p>
+                AxiomID provides decentralized identity verification and reputation tracking. You may use the service in compliance with all applicable laws and regulations. The service is provided for lawful purposes only.
+              </p>
+            </section>
+
+            <section>
+              <h2 className="text-white text-lg font-semibold mb-2 flex items-center gap-2">
+                <span className="w-1.5 h-1.5 rounded-full bg-electric-blue" />
+                Wallet Connection
+              </h2>
+              <p>
+                Connecting your Pi wallet is required for authentication. You are solely responsible for maintaining the security of your wallet and private keys. AxiomID never has access to your private keys or seed phrases.
+              </p>
+            </section>
+
+            <section>
+              <h2 className="text-white text-lg font-semibold mb-2 flex items-center gap-2">
+                <span className="w-1.5 h-1.5 rounded-full bg-axiom-gold" />
+                AI Agent Verification
+              </h2>
+              <p>
+                Each user may register one verified AI agent. The verified agent may interact with ecosystem products on your behalf. You are responsible for all actions taken by your agent. Agent verification is non-transferable.
+              </p>
+            </section>
+
+            <section>
+              <h2 className="text-white text-lg font-semibold mb-2 flex items-center gap-2">
+                <span className="w-1.5 h-1.5 rounded-full bg-neon-green" />
+                Limitation of Liability
+              </h2>
+              <p>
+                The App is provided <strong className="text-gray-400">"as is"</strong> without warranties of any kind, either express or implied. We are not liable for any damages arising from the use or inability to use the service, including but not limited to loss of reputation score, agent data, or Pi transactions.
+              </p>
+            </section>
+
+            <section>
+              <h2 className="text-white text-lg font-semibold mb-2 flex items-center gap-2">
+                <span className="w-1.5 h-1.5 rounded-full bg-neon-green" />
+                Changes to Terms
+              </h2>
+              <p>
+                We may update these terms at any time. Continued use of the service after changes constitutes acceptance of the new terms. You will be notified of material changes via the app.
+              </p>
+            </section>
+          </div>
+        </BentoCard>
+
+        {/* Footer */}
+        <div className="mt-8 text-center">
+          <p className="text-xs font-mono text-gray-600">
+            &copy; 2026 AxiomID — Built on Pi Network
+          </p>
+        </div>
       </div>
     </main>
   );
diff --git a/apps/axiomid/src/lib/pi-sdk.ts b/apps/axiomid/src/lib/pi-sdk.ts
index 8d76da9..f7d5b98 100644
--- a/apps/axiomid/src/lib/pi-sdk.ts
+++ b/apps/axiomid/src/lib/pi-sdk.ts
@@ -1,77 +1,33 @@
-function patchPostMessage(): void {
-  if (typeof window === "undefined") return;
-  try {
-    const orig = window.postMessage.bind(window);
-    (window as any).postMessage = function (
-      message: unknown,
-      targetOrigin: string,
-      ...rest: [] | [Transferable[]]
-    ) {
-      if (
-        typeof targetOrigin === "string" &&
-        (targetOrigin === "https://sandbox.minepi.com" ||
-          targetOrigin === "https://app-cdn.minepi.com")
-      ) {
-        return orig(message, "*", ...rest);
-      }
-      return orig(message, targetOrigin, ...rest);
-    };
-  } catch {}
-}
-
-let cached: Promise<void> | null = null;
-
-export function ensurePiSdk(sandbox?: boolean): Promise<void> {
-  if (typeof window === "undefined") {
-    return Promise.reject(new Error("Not in browser"));
-  }
-
-  if (sandbox) patchPostMessage();
-
-  if (cached) return cached as Promise<void>;
+export type PiScope = "username" | "payments" | "wallet_address";
 
-  const pi = (window as any)?.Pi;
-
-  if (pi?.authenticate) {
-    cached = Promise.resolve();
-    return cached as Promise<void>;
-  }
+export interface PiAuthResult {
+  accessToken: string;
+  user: { uid: string; username: string };
+}
 
-  if (pi?.init) {
-    cached = pi.init({ version: "2.0", sandbox: !!sandbox })
-      .then(() => undefined).catch(() => undefined);
-    return cached as Promise<void>;
-  }
+function getPi(): any {
+  if (typeof window === "undefined") throw new Error("Pi SDK only available in browser");
+  const pi = (window as any).Pi;
+  if (!pi?.authenticate) throw new Error("Pi SDK not loaded");
+  return pi;
+}
 
-  cached = new Promise<void>((resolve) => {
-    const script = document.createElement("script");
-    script.src = "https://sdk.minepi.com/pi-sdk.js";
-    script.async = true;
-    if (sandbox) script.setAttribute("data-sandbox", "true");
-    script.onload = () => {
-      const wait = () => {
-        const p = (window as any)?.Pi;
-        if (p?.init) {
-          p.init({ version: "2.0", sandbox: !!sandbox })
-            .then(() => {
-              if ((window as any)?.Pi?.authenticate) resolve();
-              else setTimeout(wait, 300);
-            })
-            .catch(() => resolve());
-        } else if (p?.authenticate) {
-          resolve();
-        } else {
-          setTimeout(wait, 300);
-        }
-      };
-      wait();
-    };
-    script.onerror = () => {
-      console.error("Failed to load Pi SDK");
-      resolve();
-    };
-    document.head.appendChild(script);
-  });
+export async function initPiSdk(sandbox?: boolean): Promise<void> {
+  const pi = getPi();
+  await pi.init({ version: "2.0", sandbox: !!sandbox });
+}
 
-  return cached as Promise<void>;
+export async function authenticatePi(
+  scopes: PiScope[],
+  onIncompletePayment?: (payment: any) => void
+): Promise<PiAuthResult> {
+  const pi = getPi();
+  const auth = await pi.authenticate(
+    scopes,
+    onIncompletePayment ?? (() => {})
+  );
+  return {
+    accessToken: auth.accessToken,
+    user: { uid: auth.user.uid, username: auth.user.username },
+  };
 }

From 0e86d8ee7201934b6004e9bd1952ae62be83e4f3 Mon Sep 17 00:00:00 2001
From: Mohamed Abdelaziz <amrikyy@gmail.com>
Date: Mon, 25 May 2026 04:14:35 +0300
Subject: [PATCH 10/14] =?UTF-8?q?feat:=20redesign=20dashboard=20+=20main?=
 =?UTF-8?q?=20page=20with=20DESIGN.md=20agentic=20spec,=20fix=20hex?=
 =?UTF-8?q?=E2=86=92css-vars?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 apps/axiomid/src/app/dashboard/page.tsx | 112 ++++++++++++------------
 apps/axiomid/src/app/page.tsx           |   2 +-
 2 files changed, 57 insertions(+), 57 deletions(-)

diff --git a/apps/axiomid/src/app/dashboard/page.tsx b/apps/axiomid/src/app/dashboard/page.tsx
index 6bded0d..578df34 100644
--- a/apps/axiomid/src/app/dashboard/page.tsx
+++ b/apps/axiomid/src/app/dashboard/page.tsx
@@ -265,19 +265,19 @@ export default function Dashboard() {
   };
 
   return (
-    <div className="min-h-screen bg-[#060608] text-[#e5e5e5] font-sans flex relative overflow-hidden">
+    <div className="min-h-screen bg-background text-foreground font-sans flex relative overflow-hidden">
       <div className="scanline" />
       <div className="bg-grid absolute inset-0 opacity-20 pointer-events-none" />
 
       {/* 1. SIDEBAR NAVIGATION */}
-      <aside className="w-64 border-r border-[#00ff41]/10 bg-black/80 backdrop-blur-xl flex flex-col justify-between p-6 z-10 hidden md:flex">
+      <aside className="w-64 border-r border-neon-green/10 bg-black/80 backdrop-blur-xl flex flex-col justify-between p-6 z-10 hidden md:flex">
         <div className="flex flex-col gap-6 text-center">
           {/* Concentric rings fingerprint logo radar */}
           <div className="relative w-28 h-28 mx-auto flex items-center justify-center group cursor-pointer">
-            <div className="absolute inset-0 rounded-full border border-[#00ff41]/20 animate-pulse" style={{ animationDuration: '4s' }} />
-            <div className="absolute inset-2 rounded-full border-2 border-dashed border-[#00ff41]/30 animate-spin-slow" />
-            <div className="absolute inset-4 rounded-full border border-[#00ff41]/50 shadow-[0_0_15px_rgba(0,255,65,0.2)] flex items-center justify-center bg-black/70">
-              <svg className="w-12 h-12 text-[#00ff41] transition-transform duration-300 group-hover:scale-110" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.5">
+            <div className="absolute inset-0 rounded-full border border-neon-green/20 animate-pulse" style={{ animationDuration: '4s' }} />
+            <div className="absolute inset-2 rounded-full border-2 border-dashed border-neon-green/30 animate-spin-slow" />
+            <div className="absolute inset-4 rounded-full border border-neon-green/50 shadow-[0_0_15px_rgba(0,255,65,0.2)] flex items-center justify-center bg-black/70">
+              <svg className="w-12 h-12 text-neon-green transition-transform duration-300 group-hover:scale-110" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.5">
                 <path d="M12 2a10 10 0 0 1 10 10" strokeLinecap="round" />
                 <path d="M12 6a6 6 0 0 1 6 6" strokeLinecap="round" />
                 <path d="M12 10a2 2 0 0 1 2 2" strokeLinecap="round" />
@@ -295,7 +295,7 @@ export default function Dashboard() {
           
           <div>
             <h1 className="font-mono text-lg font-bold tracking-tight text-white">AxiomID</h1>
-            <p className="text-[9px] font-mono text-[#00ff41]/60 tracking-widest uppercase">Agentic OS</p>
+            <p className="text-[9px] font-mono text-neon-green/60 tracking-widest uppercase">Agentic OS</p>
           </div>
 
           <nav className="flex flex-col gap-2 mt-4">
@@ -311,7 +311,7 @@ export default function Dashboard() {
                 onClick={() => item.href ? window.location.href = item.href : setActiveTab(item.id)}
                 className={`flex items-center gap-3 px-4 py-3 rounded-xl font-mono text-xs text-left transition-all border ${
                   activeTab === item.id || (item.active && activeTab === "mission-control")
-                    ? "bg-[#00ff41]/10 border-[#00ff41]/30 text-white shadow-[0_0_10px_rgba(0,255,65,0.05)]"
+                    ? "bg-neon-green/10 border-neon-green/30 text-white shadow-[0_0_10px_rgba(0,255,65,0.05)]"
                     : "border-transparent text-gray-500 hover:text-white hover:bg-white/5"
                 }`}
               >
@@ -332,13 +332,13 @@ export default function Dashboard() {
       {/* MAIN CONTAINER */}
       <div className="flex-1 flex flex-col z-10 overflow-y-auto">
         {/* 2. TOP HEADER */}
-        <header className="h-20 border-b border-[#00ff41]/10 bg-black/60 backdrop-blur-xl px-6 md:px-8 flex items-center justify-between sticky top-0 z-20">
+        <header className="h-20 border-b border-neon-green/10 bg-black/60 backdrop-blur-xl px-6 md:px-8 flex items-center justify-between sticky top-0 z-20">
           <div className="flex items-center gap-4">
             <span className="font-mono text-sm font-bold tracking-tight text-white uppercase hidden md:inline">
               Mission Control
             </span>
             <div className="flex gap-2 items-center text-[10px] font-mono bg-white/5 border border-white/10 rounded-lg px-2 py-1">
-              <span className="w-1.5 h-1.5 rounded-full bg-[#00ff41] animate-pulse" />
+              <span className="w-1.5 h-1.5 rounded-full bg-neon-green animate-pulse" />
               <span className="text-gray-400">NETWORK:</span>
               <span className="text-white">ONLINE</span>
             </div>
@@ -350,7 +350,7 @@ export default function Dashboard() {
               <input
                 type="text"
                 placeholder="Search resources, DIDs, agent logs..."
-                className="w-64 bg-white/5 border border-white/10 rounded-xl px-9 py-2 text-xs font-mono text-white placeholder-gray-500 focus:outline-none focus:border-[#00ff41]/40"
+                className="w-64 bg-white/5 border border-white/10 rounded-xl px-9 py-2 text-xs font-mono text-white placeholder-gray-500 focus:outline-none focus:border-neon-green/40"
               />
             </div>
 
@@ -363,9 +363,9 @@ export default function Dashboard() {
               <div className="flex items-center gap-4">
                 <div className="flex flex-col items-end">
                   <span className="text-xs font-mono text-white">{user.piUsername || "Connected User"}</span>
-                  <span className="text-[9px] font-mono text-[#00d4ff] uppercase tracking-wider">{user.tier} Tier</span>
+                  <span className="text-[9px] font-mono text-electric-blue uppercase tracking-wider">{user.tier} Tier</span>
                 </div>
-                <div className="w-10 h-10 rounded-xl bg-gradient-to-br from-[#00ff41]/20 to-[#00d4ff]/20 border border-[#00ff41]/30 flex items-center justify-center text-sm font-bold text-white shadow-[0_0_10px_rgba(0,255,65,0.1)]">
+                <div className="w-10 h-10 rounded-xl bg-gradient-to-br from-neon-green/20 to-electric-blue/20 border border-neon-green/30 flex items-center justify-center text-sm font-bold text-white shadow-[0_0_10px_rgba(0,255,65,0.1)]">
                   {user.piUsername ? user.piUsername.slice(0, 2).toUpperCase() : "AG"}
                 </div>
               </div>
@@ -376,8 +376,8 @@ export default function Dashboard() {
         {/* 3. DASHBOARD MAIN CONTENT (WITH SUB-NAV ICON STRIP) */}
         <div className="flex-1 flex overflow-hidden">
           {/* Mini vertical sub-navigation strip */}
-          <div className="hidden sm:flex border-r border-[#00ff41]/10 bg-black/40 flex-col gap-5 p-3 items-center justify-start z-10 w-16">
-            <button className="p-2.5 rounded-xl border border-[#00ff41]/20 bg-[#00ff41]/10 text-[#00ff41] shadow-[0_0_10px_rgba(0,255,65,0.2)]">
+          <div className="hidden sm:flex border-r border-neon-green/10 bg-black/40 flex-col gap-5 p-3 items-center justify-start z-10 w-16">
+            <button className="p-2.5 rounded-xl border border-neon-green/20 bg-neon-green/10 text-neon-green shadow-[0_0_10px_rgba(0,255,65,0.2)]">
               <svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor" strokeWidth="2">
                 <path strokeLinecap="round" strokeLinejoin="round" d="M4 6a2 2 0 012-2h2a2 2 0 012 2v2a2 2 0 01-2 2H6a2 2 0 01-2-2V6zM14 6a2 2 0 012-2h2a2 2 0 012 2v2a2 2 0 01-2 2h-2a2 2 0 01-2-2V6zM4 16a2 2 0 012-2h2a2 2 0 012 2v2a2 2 0 01-2 2H6a2 2 0 01-2-2v-2zM14 16a2 2 0 012-2h2a2 2 0 012 2v2a2 2 0 01-2 2h-2a2 2 0 01-2-2v-2z" />
               </svg>
@@ -415,7 +415,7 @@ export default function Dashboard() {
             <div className="lg:col-span-2 flex flex-col gap-6">
               
               {/* Workspace Header Tabs (Mission Control, Home, Browsers, AI Agent, Security, Aspects) */}
-              <div className="flex items-center justify-between bg-black/40 border border-[#00ff41]/10 rounded-xl p-2">
+              <div className="flex items-center justify-between bg-black/40 border border-neon-green/10 rounded-xl p-2">
                 <div className="flex flex-wrap gap-1">
                   {["Mission Control", "Home", "Browsers", "AI Agent", "Security", "Aspects"].map((tab) => (
                     <button
@@ -423,7 +423,7 @@ export default function Dashboard() {
                       onClick={() => setActiveTab(tab.toLowerCase().replace(/ /g, "-"))}
                       className={`px-3 py-1.5 rounded-lg text-xs font-mono transition-all ${
                         activeTab === tab.toLowerCase().replace(/ /g, "-")
-                          ? "bg-[#00ff41]/20 text-[#00ff41] border border-[#00ff41]/30 font-bold"
+                          ? "bg-neon-green/20 text-neon-green border border-neon-green/30 font-bold"
                           : "text-gray-400 hover:text-white"
                       }`}
                     >
@@ -437,12 +437,12 @@ export default function Dashboard() {
                       setLogs((prev) => [...prev, `[${new Date().toLocaleTimeString()}] SYSTEM: Re-syncing agent logs...`]);
                       refreshUser();
                     }}
-                    className="p-1.5 rounded bg-white/5 border border-white/10 hover:border-[#00ff41]/30 hover:text-[#00ff41] transition-all text-xs font-mono"
+                    className="p-1.5 rounded bg-white/5 border border-white/10 hover:border-neon-green/30 hover:text-neon-green transition-all text-xs font-mono"
                     title="Reload View"
                   >
                     ⟳
                   </button>
-                  <button className="px-3 py-1 bg-white/5 border border-white/10 hover:border-[#00ff41]/30 text-white rounded text-[10px] font-mono transition-all flex items-center gap-1">
+                  <button className="px-3 py-1 bg-white/5 border border-white/10 hover:border-neon-green/30 text-white rounded text-[10px] font-mono transition-all flex items-center gap-1">
                     AI Actions ▾
                   </button>
                 </div>
@@ -455,22 +455,22 @@ export default function Dashboard() {
                     <h2 className="text-lg font-bold text-white">AI Agents</h2>
                     <p className="text-[10px] font-mono text-gray-500">Active status and runtimes of ecosystem agents</p>
                   </div>
-                  <span className="text-xs font-mono text-[#00ff41] bg-[#00ff41]/10 px-2 py-0.5 rounded border border-[#00ff41]/20">
+                  <span className="text-xs font-mono text-neon-green bg-neon-green/10 px-2 py-0.5 rounded border border-neon-green/20">
                     2 RUNNING
                   </span>
                 </div>
 
                 <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
                   {/* GemClaw Agent */}
-                  <div className="glass-panel rounded-2xl border border-white/5 hover:border-[#00ff41]/20 transition-all p-5 flex flex-col gap-4 relative group">
-                    <div className="absolute top-4 right-4 flex items-center gap-1 text-[9px] font-mono text-[#00ff41] bg-[#00ff41]/10 border border-[#00ff41]/30 px-2 py-0.5 rounded-full">
-                      <span className="w-1 h-1 rounded-full bg-[#00ff41] animate-pulse" />
+                  <div className="glass-panel rounded-2xl border border-white/5 hover:border-neon-green/20 transition-all p-5 flex flex-col gap-4 relative group">
+                    <div className="absolute top-4 right-4 flex items-center gap-1 text-[9px] font-mono text-neon-green bg-neon-green/10 border border-neon-green/30 px-2 py-0.5 rounded-full">
+                      <span className="w-1 h-1 rounded-full bg-neon-green animate-pulse" />
                       active
                     </div>
 
                     {/* Animated Robotic Claw SVG */}
                     <div className="w-full bg-black/40 rounded-xl border border-white/5 overflow-hidden flex items-center justify-center p-2">
-                      <svg className="w-full h-32 text-[#00ff41]" viewBox="0 0 100 60" fill="none">
+                      <svg className="w-full h-32 text-neon-green" viewBox="0 0 100 60" fill="none">
                         <path d="M10 30 L30 25 L45 28" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" />
                         <path d="M10 34 L32 37 L45 32" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" />
                         <circle cx="45" cy="30" r="4" fill="#00ff41" className="animate-pulse" />
@@ -491,7 +491,7 @@ export default function Dashboard() {
                     </div>
 
                     <div>
-                      <h3 className="text-sm font-bold text-white group-hover:text-[#00ff41] transition-colors">GemClaw</h3>
+                      <h3 className="text-sm font-bold text-white group-hover:text-neon-green transition-colors">GemClaw</h3>
                       <p className="text-[11px] text-gray-500 mt-1 leading-relaxed">
                         Voice OS Integration. Utilizes real-time audio pipeline and Silero VAD to handle natural user conversations.
                       </p>
@@ -503,15 +503,15 @@ export default function Dashboard() {
                   </div>
 
                   {/* IQRA Agent */}
-                  <div className="glass-panel rounded-2xl border border-white/5 hover:border-[#00ff41]/20 transition-all p-5 flex flex-col gap-4 relative group">
-                    <div className="absolute top-4 right-4 flex items-center gap-1 text-[9px] font-mono text-[#00ff41] bg-[#00ff41]/10 border border-[#00ff41]/30 px-2 py-0.5 rounded-full">
-                      <span className="w-1 h-1 rounded-full bg-[#00ff41] animate-pulse" />
+                  <div className="glass-panel rounded-2xl border border-white/5 hover:border-neon-green/20 transition-all p-5 flex flex-col gap-4 relative group">
+                    <div className="absolute top-4 right-4 flex items-center gap-1 text-[9px] font-mono text-neon-green bg-neon-green/10 border border-neon-green/30 px-2 py-0.5 rounded-full">
+                      <span className="w-1 h-1 rounded-full bg-neon-green animate-pulse" />
                       active
                     </div>
 
                     {/* Animated Manuscript SVG */}
                     <div className="w-full bg-black/40 rounded-xl border border-white/5 overflow-hidden flex items-center justify-center p-2">
-                      <svg className="w-full h-32 text-[#00ff41]" viewBox="0 0 100 60" fill="none">
+                      <svg className="w-full h-32 text-neon-green" viewBox="0 0 100 60" fill="none">
                         <rect x="15" y="10" width="70" height="40" rx="4" fill="rgba(9,9,11,0.8)" stroke="currentColor" strokeWidth="1" strokeDasharray="30,2,2,2" />
                         <line x1="15" y1="20" x2="85" y2="20" stroke="rgba(0, 255, 65, 0.08)" strokeWidth="0.5" />
                         <line x1="15" y1="30" x2="85" y2="30" stroke="rgba(0, 255, 65, 0.08)" strokeWidth="0.5" />
@@ -530,7 +530,7 @@ export default function Dashboard() {
                     </div>
 
                     <div>
-                      <h3 className="text-sm font-bold text-white group-hover:text-[#00ff41] transition-colors">IQRA</h3>
+                      <h3 className="text-sm font-bold text-white group-hover:text-neon-green transition-colors">IQRA</h3>
                       <p className="text-[11px] text-gray-500 mt-1 leading-relaxed">
                         Governed Memory Runtime. Evaluates intent against Damir rules and analyzes cosmic structures via MCTS.
                       </p>
@@ -553,7 +553,7 @@ export default function Dashboard() {
                       <div className="flex gap-1">
                         <div className="w-2 h-2 rounded-full bg-[#ff4444]" />
                         <div className="w-2 h-2 rounded-full bg-[#ffdd00]" />
-                        <div className="w-2 h-2 rounded-full bg-[#00ff41]" />
+                        <div className="w-2 h-2 rounded-full bg-neon-green" />
                       </div>
                       <span className="text-xs font-mono text-gray-400">console@axiomid-os</span>
                     </div>
@@ -565,7 +565,7 @@ export default function Dashboard() {
                     </button>
                   </div>
 
-                  <div className="flex-1 bg-black/80 border border-white/5 rounded-xl p-4 font-mono text-[11px] leading-relaxed overflow-y-auto max-h-[220px] shadow-inner text-[#00ff41]/90">
+                  <div className="flex-1 bg-black/80 border border-white/5 rounded-xl p-4 font-mono text-[11px] leading-relaxed overflow-y-auto max-h-[220px] shadow-inner text-neon-green/90">
                     <div className="flex flex-col gap-1.5">
                       {logs.map((log, i) => (
                         <div key={i} className="whitespace-pre-wrap">
@@ -577,13 +577,13 @@ export default function Dashboard() {
                   </div>
 
                   <form onSubmit={handleCommandSubmit} className="flex gap-2 mt-3">
-                    <span className="font-mono text-xs text-[#00ff41] py-2">{">"}</span>
+                    <span className="font-mono text-xs text-neon-green py-2">{">"}</span>
                     <input
                       type="text"
                       value={terminalInput}
                       onChange={(e) => setTerminalInput(e.target.value)}
                       placeholder="Command (help, status, did, memory, mcp)..."
-                      className="flex-1 bg-white/5 border border-white/5 focus:border-[#00ff41]/30 rounded-xl px-4 py-2 text-xs font-mono text-white focus:outline-none"
+                      className="flex-1 bg-white/5 border border-white/5 focus:border-neon-green/30 rounded-xl px-4 py-2 text-xs font-mono text-white focus:outline-none"
                     />
                   </form>
                 </div>
@@ -592,9 +592,9 @@ export default function Dashboard() {
                 <div className="bento-card p-6 flex flex-col gap-4">
                   <div className="flex items-center justify-between border-b border-white/5 pb-3">
                     <h3 className="text-sm font-bold text-white font-mono uppercase tracking-wider flex items-center gap-2">
-                      <span className="text-[#00ff41]">⟐</span> MCP Connection Hub
+                      <span className="text-neon-green">⟐</span> MCP Connection Hub
                     </h3>
-                    <span className="text-[9px] font-mono text-[#00ff41] bg-[#00ff41]/10 px-2 py-0.5 rounded border border-[#00ff41]/20">
+                    <span className="text-[9px] font-mono text-neon-green bg-neon-green/10 px-2 py-0.5 rounded border border-neon-green/20">
                       4 ALIVE
                     </span>
                   </div>
@@ -606,7 +606,7 @@ export default function Dashboard() {
                       { name: "Firebase MCP", schemas: "28 tools", status: "active", icon: "🔥" },
                       { name: "Sequential Thinking", schemas: "1 tool", status: "active", icon: "🧠" }
                     ].map((server) => (
-                      <div key={server.name} className="glass-panel p-3 rounded-xl border border-white/5 flex items-center justify-between hover:border-[#00ff41]/20 transition-all">
+                      <div key={server.name} className="glass-panel p-3 rounded-xl border border-white/5 flex items-center justify-between hover:border-neon-green/20 transition-all">
                         <div className="flex items-center gap-2.5">
                           <span className="text-base">{server.icon}</span>
                           <div>
@@ -615,7 +615,7 @@ export default function Dashboard() {
                           </div>
                         </div>
                         <div className="flex items-center gap-1.5">
-                          <span className="w-1.5 h-1.5 rounded-full bg-[#00ff41] animate-pulse" />
+                          <span className="w-1.5 h-1.5 rounded-full bg-neon-green animate-pulse" />
                           <span className="text-[9px] font-mono text-gray-400 uppercase">ONLINE</span>
                         </div>
                       </div>
@@ -631,9 +631,9 @@ export default function Dashboard() {
             <div className="flex flex-col gap-6">
               
               {/* KYC Progress Card */}
-              <div className="bento-card p-6 bg-gradient-to-br from-[#00ff41]/5 to-transparent flex flex-col gap-4">
+              <div className="bento-card p-6 bg-gradient-to-br from-neon-green/5 to-transparent flex flex-col gap-4">
                 <div className="flex flex-col gap-1">
-                  <span className="text-[10px] font-mono text-[#00d4ff] uppercase tracking-wider">KYC Validation level</span>
+                  <span className="text-[10px] font-mono text-electric-blue uppercase tracking-wider">KYC Validation level</span>
                   <h3 className="text-2xl font-bold text-white font-mono tracking-wide">
                     {user ? user.tier.toUpperCase() : "ANONYMOUS"}
                   </h3>
@@ -641,7 +641,7 @@ export default function Dashboard() {
 
                 <div className="w-full bg-white/5 border border-white/10 h-2 rounded-full overflow-hidden relative">
                   <motion.div
-                    className="h-full bg-gradient-to-r from-[#00ff41] to-[#00d4ff] shadow-[0_0_10px_#00ff41]"
+                    className="h-full bg-gradient-to-r from-neon-green to-electric-blue shadow-[0_0_10px_#00ff41]"
                     initial={{ width: 0 }}
                     animate={{ width: `${user ? levelProgress : 0}%` }}
                     transition={{ duration: 1 }}
@@ -662,7 +662,7 @@ export default function Dashboard() {
                 </div>
 
                 {agentActionStatus && (
-                  <div className="bg-[#00ff41]/10 border border-[#00ff41]/30 rounded-xl p-2.5 text-xs font-mono text-[#00ff41] animate-pulse">
+                  <div className="bg-neon-green/10 border border-neon-green/30 rounded-xl p-2.5 text-xs font-mono text-neon-green animate-pulse">
                     {agentActionStatus}
                   </div>
                 )}
@@ -675,7 +675,7 @@ export default function Dashboard() {
                           <span className="text-xs font-bold text-white">{user.agent.name}</span>
                           <span className={`text-[9px] font-mono px-2 py-0.5 rounded-full ${
                             user.agent.status === "active" 
-                              ? "bg-[#00ff41]/10 text-[#00ff41] border border-[#00ff41]/20" 
+                              ? "bg-neon-green/10 text-neon-green border border-neon-green/20" 
                               : "bg-white/5 text-gray-400 border border-white/10"
                           }`}>
                             {user.agent.status.toUpperCase()}
@@ -691,7 +691,7 @@ export default function Dashboard() {
 
                       <button 
                         onClick={handleToggleAgentState}
-                        className="w-full px-3 py-2 rounded-xl bg-white/5 border border-white/10 hover:border-[#00ff41]/30 hover:bg-[#00ff41]/10 hover:text-[#00ff41] text-xs font-mono text-white transition-all text-center"
+                        className="w-full px-3 py-2 rounded-xl bg-white/5 border border-white/10 hover:border-neon-green/30 hover:bg-neon-green/10 hover:text-neon-green text-xs font-mono text-white transition-all text-center"
                       >
                         {user.agent.status === "active" ? "■ PAUSE RUNTIME" : "▶ ACTIVATE RUNTIME"}
                       </button>
@@ -732,7 +732,7 @@ export default function Dashboard() {
                       onClick={() => setMarketplaceTab("skills")}
                       className={`flex-1 text-center py-1.5 rounded-lg transition-all ${
                         marketplaceTab === "skills"
-                          ? "bg-[#00ff41]/20 text-[#00ff41] border border-[#00ff41]/30 font-bold"
+                          ? "bg-neon-green/20 text-neon-green border border-neon-green/30 font-bold"
                           : "text-gray-400 hover:text-white"
                       }`}
                     >
@@ -742,7 +742,7 @@ export default function Dashboard() {
                       onClick={() => setMarketplaceTab("personas")}
                       className={`flex-1 text-center py-1.5 rounded-lg transition-all ${
                         marketplaceTab === "personas"
-                          ? "bg-[#00ff41]/20 text-[#00ff41] border border-[#00ff41]/30 font-bold"
+                          ? "bg-neon-green/20 text-neon-green border border-neon-green/30 font-bold"
                           : "text-gray-400 hover:text-white"
                       }`}
                     >
@@ -752,7 +752,7 @@ export default function Dashboard() {
                 </div>
 
                 {purchaseStatus && (
-                  <div className="bg-[#00ff41]/10 border border-[#00ff41]/30 rounded-xl p-3 text-xs font-mono text-[#00ff41] animate-pulse">
+                  <div className="bg-neon-green/10 border border-neon-green/30 rounded-xl p-3 text-xs font-mono text-neon-green animate-pulse">
                     {purchaseStatus}
                   </div>
                 )}
@@ -778,16 +778,16 @@ export default function Dashboard() {
                       return (
                         <div
                           key={skill.name}
-                          className="glass-panel p-4 rounded-xl border border-white/5 hover:border-[#00ff41]/20 transition-all flex flex-col gap-2 relative group"
+                          className="glass-panel p-4 rounded-xl border border-white/5 hover:border-neon-green/20 transition-all flex flex-col gap-2 relative group"
                         >
                           <div className="flex justify-between items-start">
                             <div className="flex items-center gap-2">
                               <span className="text-lg">{icon}</span>
-                              <h4 className="text-xs font-bold text-white group-hover:text-[#00ff41] transition-colors capitalize text-left">
+                              <h4 className="text-xs font-bold text-white group-hover:text-neon-green transition-colors capitalize text-left">
                                 {skill.name.replace(/-/g, ' ')}
                               </h4>
                             </div>
-                            <span className="text-xs font-mono text-[#fbbf24]">{pricePi}</span>
+                            <span className="text-xs font-mono text-axiom-gold">{pricePi}</span>
                           </div>
                           <p className="text-[10px] text-gray-500 leading-normal text-left">{skill.description}</p>
                           <div className="flex justify-between items-center mt-2 pt-2 border-t border-white/5">
@@ -801,7 +801,7 @@ export default function Dashboard() {
                                 icon,
                                 description: skill.description
                               })}
-                              className="px-3 py-1 rounded bg-[#00ff41]/10 border border-[#00ff41]/30 hover:bg-[#00ff41] hover:text-black font-mono text-[9px] text-[#00ff41] transition-all"
+                              className="px-3 py-1 rounded bg-neon-green/10 border border-neon-green/30 hover:bg-neon-green hover:text-black font-mono text-[9px] text-neon-green transition-all"
                             >
                               FORGE
                             </button>
@@ -829,20 +829,20 @@ export default function Dashboard() {
                       return (
                         <div
                           key={persona.name}
-                          className="glass-panel p-4 rounded-xl border border-white/5 hover:border-[#00ff41]/20 transition-all flex flex-col gap-2 relative group"
+                          className="glass-panel p-4 rounded-xl border border-white/5 hover:border-neon-green/20 transition-all flex flex-col gap-2 relative group"
                         >
                           <div className="flex justify-between items-start">
                             <div className="flex items-center gap-2">
                               <span className="text-lg">{icon}</span>
-                              <h4 className="text-xs font-bold text-white group-hover:text-[#00ff41] transition-colors text-left">
+                              <h4 className="text-xs font-bold text-white group-hover:text-neon-green transition-colors text-left">
                                 {persona.display_name.ar}
                               </h4>
                             </div>
-                            <span className="text-xs font-mono text-[#fbbf24]">{pricePi}</span>
+                            <span className="text-xs font-mono text-axiom-gold">{pricePi}</span>
                           </div>
                           <div className="flex justify-between text-[8px] font-mono text-gray-500">
                             <span>{persona.display_name.en}</span>
-                            <span className="text-[#00d4ff] uppercase">TIER: {persona.tier}</span>
+                            <span className="text-electric-blue uppercase">TIER: {persona.tier}</span>
                           </div>
                           <p className="text-[10px] text-gray-400 leading-normal text-right mt-1">
                             {persona.description}
@@ -858,7 +858,7 @@ export default function Dashboard() {
                                 icon,
                                 description: persona.description
                               })}
-                              className="px-3 py-1 rounded bg-[#00ff41]/10 border border-[#00ff41]/30 hover:bg-[#00ff41] hover:text-black font-mono text-[9px] text-[#00ff41] transition-all"
+                              className="px-3 py-1 rounded bg-neon-green/10 border border-neon-green/30 hover:bg-neon-green hover:text-black font-mono text-[9px] text-neon-green transition-all"
                             >
                               ACTIVATE
                             </button>
diff --git a/apps/axiomid/src/app/page.tsx b/apps/axiomid/src/app/page.tsx
index 5d2571c..15da721 100644
--- a/apps/axiomid/src/app/page.tsx
+++ b/apps/axiomid/src/app/page.tsx
@@ -279,7 +279,7 @@ export default function Home() {
             {user && (
               <div className="mt-4 text-center">
                 <span className="text-[10px] font-mono text-gray-400 uppercase block">Verification Level</span>
-                <span className="text-sm font-bold text-[#00ff41] font-mono">{user.tier.toUpperCase()}</span>
+                <span className="text-sm font-bold text-neon-green font-mono">{user.tier.toUpperCase()}</span>
               </div>
             )}
         </BentoCard>

From 666a73169f8206edf7ccba930a0236fa15cfe754 Mon Sep 17 00:00:00 2001
From: Mohamed Abdelaziz <amrikyy@gmail.com>
Date: Mon, 25 May 2026 04:18:42 +0300
Subject: [PATCH 11/14] fix: Pi SDK getPi checks init() before authenticate(),
 add demo wallet fallback, dynamic isPiBrowser state

---
 .../src/app/context/wallet-context.tsx        | 49 +++++++++++++------
 apps/axiomid/src/lib/pi-sdk.ts                |  5 +-
 2 files changed, 39 insertions(+), 15 deletions(-)

diff --git a/apps/axiomid/src/app/context/wallet-context.tsx b/apps/axiomid/src/app/context/wallet-context.tsx
index c64fcb3..4c492dd 100644
--- a/apps/axiomid/src/app/context/wallet-context.tsx
+++ b/apps/axiomid/src/app/context/wallet-context.tsx
@@ -36,13 +36,14 @@ interface WalletContextType {
 
 const WalletContext = createContext<WalletContextType | null>(null);
 
-function isPiBrowser(): boolean {
+function checkPiBrowser(): boolean {
   if (typeof navigator === "undefined") return false;
+  if (typeof window !== "undefined" && !!(window as any)?.Pi?.authenticate) return true;
   const ua = navigator.userAgent;
   return /Pi Browser|minepi/i.test(ua);
 }
 
-function isSandbox(): boolean {
+function checkSandbox(): boolean {
   if (process.env.NEXT_PUBLIC_PI_SANDBOX === "true") return true;
   if (typeof window !== "undefined" && new URLSearchParams(window.location.search).get("sandbox") === "true") return true;
   return false;
@@ -53,29 +54,42 @@ export function WalletProvider({ children }: { children: ReactNode }) {
   const [isConnecting, setIsConnecting] = useState(false);
   const [isLoading, setIsLoading] = useState(true);
   const [error, setError] = useState<string | null>(null);
+  const [isPiBrowser, setIsPiBrowser] = useState(false);
 
   const levelProgress = user ? getLevelProgress(user.xp, user.tier) : 0;
   const nextXP = user ? getNextLevelXP(user.tier) : null;
   const authAttempted = useRef(false);
 
-  const isPiBrowserVal = isPiBrowser();
-  const sandbox = isSandbox();
-  const shouldUsePi = isPiBrowserVal || sandbox;
-
   const connectWallet = useCallback(async () => {
     setIsConnecting(true);
     setError(null);
 
     try {
-      if (!shouldUsePi) {
-        setError("Open this app in Pi Browser");
+      const inPiBrowser = checkPiBrowser();
+      const sandbox = checkSandbox();
+      const usePi = inPiBrowser || sandbox;
+
+      if (!usePi) {
+        const storedWallet = localStorage.getItem("axiomid_wallet");
+        const walletAddress = storedWallet && storedWallet.startsWith("demo:")
+          ? storedWallet
+          : `demo:${crypto.randomUUID().slice(0, 8)}`;
+        localStorage.setItem("axiomid_wallet", walletAddress);
+
+        const res = await fetch("/api/auth/connect", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ walletAddress }),
+        });
+
+        if (!res.ok) throw new Error("Demo auth failed");
+        const data = await res.json();
+        setUser(data.user);
         return;
       }
 
       await initPiSdk(sandbox);
-
       const { accessToken, user: piUser } = await authenticatePi(["username"]);
-
       const walletAddress = `pi:${piUser.uid}`;
 
       const res = await fetch("/api/auth/pi", {
@@ -95,6 +109,7 @@ export function WalletProvider({ children }: { children: ReactNode }) {
       }
 
       const data = await res.json();
+      localStorage.setItem("axiomid_wallet", walletAddress);
       setUser(data.user);
     } catch (err: unknown) {
       const message = err instanceof Error ? err.message : "Connection failed";
@@ -103,9 +118,11 @@ export function WalletProvider({ children }: { children: ReactNode }) {
     } finally {
       setIsConnecting(false);
     }
-  }, [shouldUsePi, sandbox]);
+  }, []);
 
   useEffect(() => {
+    const inPiBrowser = checkPiBrowser();
+    setIsPiBrowser(inPiBrowser);
     setIsLoading(false);
   }, []);
 
@@ -113,10 +130,14 @@ export function WalletProvider({ children }: { children: ReactNode }) {
     if (authAttempted.current) return;
     authAttempted.current = true;
 
-    if (shouldUsePi) {
+    const inPiBrowser = checkPiBrowser();
+    const sandbox = checkSandbox();
+    const usePi = inPiBrowser || sandbox;
+
+    if (usePi) {
       connectWallet();
     }
-  }, [shouldUsePi, connectWallet]);
+  }, [connectWallet]);
 
   const claimAction = useCallback(async (actionType: string) => {
     if (!user) return false;
@@ -194,7 +215,7 @@ export function WalletProvider({ children }: { children: ReactNode }) {
         isLoading,
         isConnecting,
         error,
-        isPiBrowser: isPiBrowserVal,
+        isPiBrowser,
         connectWallet,
         claimAction,
         refreshUser,
diff --git a/apps/axiomid/src/lib/pi-sdk.ts b/apps/axiomid/src/lib/pi-sdk.ts
index f7d5b98..1a1b25d 100644
--- a/apps/axiomid/src/lib/pi-sdk.ts
+++ b/apps/axiomid/src/lib/pi-sdk.ts
@@ -8,13 +8,15 @@ export interface PiAuthResult {
 function getPi(): any {
   if (typeof window === "undefined") throw new Error("Pi SDK only available in browser");
   const pi = (window as any).Pi;
-  if (!pi?.authenticate) throw new Error("Pi SDK not loaded");
+  if (!pi?.init) throw new Error("Pi SDK not loaded");
   return pi;
 }
 
 export async function initPiSdk(sandbox?: boolean): Promise<void> {
   const pi = getPi();
+  if (pi.authenticate) return;
   await pi.init({ version: "2.0", sandbox: !!sandbox });
+  if (!pi.authenticate) throw new Error("Pi SDK init failed");
 }
 
 export async function authenticatePi(
@@ -22,6 +24,7 @@ export async function authenticatePi(
   onIncompletePayment?: (payment: any) => void
 ): Promise<PiAuthResult> {
   const pi = getPi();
+  if (!pi.authenticate) throw new Error("Pi SDK not initialized, call initPiSdk first");
   const auth = await pi.authenticate(
     scopes,
     onIncompletePayment ?? (() => {})

From 56a13f9f443c5f7075ed29544b6c1a22210801fc Mon Sep 17 00:00:00 2001
From: Mohamed Abdelaziz <amrikyy@gmail.com>
Date: Mon, 25 May 2026 06:14:54 +0300
Subject: [PATCH 12/14] feat: adopt official @pinetwork/pi-sdk-js with
 PiSdkBase, usePiConnection hooks, PiButton, payment lifecycle routes
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Rewrite pi-sdk.ts with PiSdkBase.connect() for reliable init→authenticate
- Create usePiConnection/usePiPurchase hooks wrapping PiSdkBase
- Create PiButton.tsx component from official template
- Rewrite wallet-context to use connectPi with isPiSdkLoaded detection
- Add cancel/error/incomplete payment API routes
- Set paymentBasePath = 'api/pi/payment'
---
 apps/axiomid/package.json                     |  1 +
 .../src/app/api/pi/payment/cancel/route.ts    | 15 ++++
 .../src/app/api/pi/payment/error/route.ts     | 15 ++++
 .../app/api/pi/payment/incomplete/route.ts    | 36 +++++++++
 .../src/app/context/wallet-context.tsx        | 21 ++---
 apps/axiomid/src/components/PiButton.tsx      | 69 ++++++++++++++++
 apps/axiomid/src/lib/pi-sdk-hooks.ts          | 78 +++++++++++++++++++
 apps/axiomid/src/lib/pi-sdk.ts                | 65 ++++++++++------
 pnpm-lock.yaml                                | 17 ++++
 9 files changed, 277 insertions(+), 40 deletions(-)
 create mode 100644 apps/axiomid/src/app/api/pi/payment/cancel/route.ts
 create mode 100644 apps/axiomid/src/app/api/pi/payment/error/route.ts
 create mode 100644 apps/axiomid/src/app/api/pi/payment/incomplete/route.ts
 create mode 100644 apps/axiomid/src/components/PiButton.tsx
 create mode 100644 apps/axiomid/src/lib/pi-sdk-hooks.ts

diff --git a/apps/axiomid/package.json b/apps/axiomid/package.json
index cf8aa74..271daaa 100644
--- a/apps/axiomid/package.json
+++ b/apps/axiomid/package.json
@@ -47,6 +47,7 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
+    "@pinetwork/pi-sdk-js": "^2.0.0",
     "@prisma/client": "^6.0.0",
     "framer-motion": "^12.38.0",
     "next": "16.2.6",
diff --git a/apps/axiomid/src/app/api/pi/payment/cancel/route.ts b/apps/axiomid/src/app/api/pi/payment/cancel/route.ts
new file mode 100644
index 0000000..adfe532
--- /dev/null
+++ b/apps/axiomid/src/app/api/pi/payment/cancel/route.ts
@@ -0,0 +1,15 @@
+import { NextResponse } from "next/server";
+
+export async function POST(request: Request) {
+  try {
+    const { paymentId } = await request.json();
+    if (!paymentId) {
+      return NextResponse.json({ error: "paymentId is required" }, { status: 400 });
+    }
+
+    return NextResponse.json({ success: true, paymentId });
+  } catch (error) {
+    console.error("Error cancelling payment:", error);
+    return NextResponse.json({ error: "Internal server error" }, { status: 500 });
+  }
+}
diff --git a/apps/axiomid/src/app/api/pi/payment/error/route.ts b/apps/axiomid/src/app/api/pi/payment/error/route.ts
new file mode 100644
index 0000000..26520a5
--- /dev/null
+++ b/apps/axiomid/src/app/api/pi/payment/error/route.ts
@@ -0,0 +1,15 @@
+import { NextResponse } from "next/server";
+
+export async function POST(request: Request) {
+  try {
+    const { paymentId, error: errorMsg } = await request.json();
+    if (!paymentId || !errorMsg) {
+      return NextResponse.json({ error: "paymentId and error are required" }, { status: 400 });
+    }
+
+    return NextResponse.json({ success: true });
+  } catch (error) {
+    console.error("Error logging payment error:", error);
+    return NextResponse.json({ error: "Internal server error" }, { status: 500 });
+  }
+}
diff --git a/apps/axiomid/src/app/api/pi/payment/incomplete/route.ts b/apps/axiomid/src/app/api/pi/payment/incomplete/route.ts
new file mode 100644
index 0000000..0073afa
--- /dev/null
+++ b/apps/axiomid/src/app/api/pi/payment/incomplete/route.ts
@@ -0,0 +1,36 @@
+import { NextResponse } from "next/server";
+import { getPiEnv } from "@/lib/pi/env";
+
+export async function POST(request: Request) {
+  try {
+    const { paymentId, transactionId } = await request.json();
+    if (!paymentId) {
+      return NextResponse.json({ error: "paymentId is required" }, { status: 400 });
+    }
+
+    const { apiKey } = getPiEnv();
+
+    const response = await fetch(
+      `https://api.minepi.com/v2/payments/${paymentId}`,
+      {
+        headers: {
+          Authorization: `Key ${apiKey}`,
+        },
+      }
+    );
+
+    if (!response.ok) {
+      return NextResponse.json(
+        { error: "Failed to fetch incomplete payment" },
+        { status: response.status }
+      );
+    }
+
+    const paymentData = await response.json();
+
+    return NextResponse.json({ success: true, payment: paymentData });
+  } catch (error) {
+    console.error("Error handling incomplete payment:", error);
+    return NextResponse.json({ error: "Internal server error" }, { status: 500 });
+  }
+}
diff --git a/apps/axiomid/src/app/context/wallet-context.tsx b/apps/axiomid/src/app/context/wallet-context.tsx
index 4c492dd..da2448c 100644
--- a/apps/axiomid/src/app/context/wallet-context.tsx
+++ b/apps/axiomid/src/app/context/wallet-context.tsx
@@ -2,7 +2,7 @@
 
 import { createContext, useContext, useState, useEffect, useCallback, useRef, ReactNode } from "react";
 import { Tier, getLevelProgress, getNextLevelXP } from "@/lib/tiers";
-import { initPiSdk, authenticatePi } from "@/lib/pi-sdk";
+import { connectPi, isPiSdkLoaded } from "@/lib/pi-sdk";
 
 export interface User {
   id: string;
@@ -38,17 +38,11 @@ const WalletContext = createContext<WalletContextType | null>(null);
 
 function checkPiBrowser(): boolean {
   if (typeof navigator === "undefined") return false;
-  if (typeof window !== "undefined" && !!(window as any)?.Pi?.authenticate) return true;
+  if (isPiSdkLoaded()) return true;
   const ua = navigator.userAgent;
   return /Pi Browser|minepi/i.test(ua);
 }
 
-function checkSandbox(): boolean {
-  if (process.env.NEXT_PUBLIC_PI_SANDBOX === "true") return true;
-  if (typeof window !== "undefined" && new URLSearchParams(window.location.search).get("sandbox") === "true") return true;
-  return false;
-}
-
 export function WalletProvider({ children }: { children: ReactNode }) {
   const [user, setUser] = useState<User | null>(null);
   const [isConnecting, setIsConnecting] = useState(false);
@@ -66,10 +60,8 @@ export function WalletProvider({ children }: { children: ReactNode }) {
 
     try {
       const inPiBrowser = checkPiBrowser();
-      const sandbox = checkSandbox();
-      const usePi = inPiBrowser || sandbox;
 
-      if (!usePi) {
+      if (!inPiBrowser) {
         const storedWallet = localStorage.getItem("axiomid_wallet");
         const walletAddress = storedWallet && storedWallet.startsWith("demo:")
           ? storedWallet
@@ -88,8 +80,7 @@ export function WalletProvider({ children }: { children: ReactNode }) {
         return;
       }
 
-      await initPiSdk(sandbox);
-      const { accessToken, user: piUser } = await authenticatePi(["username"]);
+      const { accessToken, user: piUser } = await connectPi();
       const walletAddress = `pi:${piUser.uid}`;
 
       const res = await fetch("/api/auth/pi", {
@@ -131,10 +122,8 @@ export function WalletProvider({ children }: { children: ReactNode }) {
     authAttempted.current = true;
 
     const inPiBrowser = checkPiBrowser();
-    const sandbox = checkSandbox();
-    const usePi = inPiBrowser || sandbox;
 
-    if (usePi) {
+    if (inPiBrowser) {
       connectWallet();
     }
   }, [connectWallet]);
diff --git a/apps/axiomid/src/components/PiButton.tsx b/apps/axiomid/src/components/PiButton.tsx
new file mode 100644
index 0000000..b94ea0a
--- /dev/null
+++ b/apps/axiomid/src/components/PiButton.tsx
@@ -0,0 +1,69 @@
+"use client";
+
+import React from "react";
+import { usePiConnection, usePiPurchase } from "@/lib/pi-sdk-hooks";
+import type { PaymentData } from "@pinetwork/pi-sdk-js";
+
+const defaultPaymentData: PaymentData = {
+  amount: 0.01,
+  memo: "Example Pi Payment",
+  metadata: { productId: 42, description: "Demo purchase via Pi Network" },
+};
+
+export interface PiButtonProps {
+  paymentData?: PaymentData;
+  onConnected?: () => void;
+  children?: React.ReactNode;
+}
+
+export function PiButton({
+  paymentData = defaultPaymentData,
+  onConnected,
+  children,
+}: PiButtonProps) {
+  const { connected, ready, error, connect } = usePiConnection();
+  const purchase = usePiPurchase(paymentData);
+
+  React.useEffect(() => {
+    if (connected && onConnected) onConnected();
+  }, [connected, onConnected]);
+
+  React.useEffect(() => {
+    if (ready && !connected && !error) {
+      connect();
+    }
+  }, [ready, connected, error, connect]);
+
+  if (error) {
+    return (
+      <button
+        disabled
+        className="px-4 py-2 rounded bg-red-500/20 text-red-400 cursor-not-allowed"
+        title={error}
+      >
+        Connection Error
+      </button>
+    );
+  }
+
+  if (!ready) {
+    return (
+      <button
+        disabled
+        className="px-4 py-2 rounded bg-gray-500/20 text-gray-400 cursor-wait"
+      >
+        Loading Pi SDK...
+      </button>
+    );
+  }
+
+  return (
+    <button
+      disabled={!connected}
+      onClick={purchase}
+      className="px-4 py-2 rounded bg-neon-green/20 text-neon-green hover:bg-neon-green/30 disabled:opacity-50 disabled:cursor-not-allowed transition-all"
+    >
+      {children || "Buy with Pi"}
+    </button>
+  );
+}
diff --git a/apps/axiomid/src/lib/pi-sdk-hooks.ts b/apps/axiomid/src/lib/pi-sdk-hooks.ts
new file mode 100644
index 0000000..4e762ac
--- /dev/null
+++ b/apps/axiomid/src/lib/pi-sdk-hooks.ts
@@ -0,0 +1,78 @@
+"use client";
+
+import { useState, useEffect, useCallback, useRef } from "react";
+import { PiSdkBase } from "@pinetwork/pi-sdk-js";
+import type { PaymentData } from "@pinetwork/pi-sdk-js";
+import { connectPi, isPiSdkLoaded } from "@/lib/pi-sdk";
+
+interface PiConnectionState {
+  connected: boolean;
+  user: { uid: string; username: string; name: string } | null;
+  ready: boolean;
+  error: string | null;
+}
+
+export function usePiConnection(): PiConnectionState & { connect: () => Promise<void> } {
+  const [state, setState] = useState<PiConnectionState>({
+    connected: false,
+    user: null,
+    ready: false,
+    error: null,
+  });
+  const connecting = useRef(false);
+
+  useEffect(() => {
+    const check = () => {
+      setState((prev) => ({ ...prev, ready: isPiSdkLoaded() }));
+    };
+    check();
+    const timer = setInterval(check, 500);
+    return () => clearInterval(timer);
+  }, []);
+
+  const connect = useCallback(async () => {
+    if (connecting.current || state.connected) return;
+    connecting.current = true;
+    setState((prev) => ({ ...prev, error: null }));
+    try {
+      const result = await connectPi();
+      setState({
+        connected: true,
+        user: result.user,
+        ready: true,
+        error: null,
+      });
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Connection failed";
+      setState((prev) => ({ ...prev, error: message, ready: true }));
+    } finally {
+      connecting.current = false;
+    }
+  }, [state.connected]);
+
+  useEffect(() => {
+    if (state.connected && PiSdkBase.user) {
+      setState({
+        connected: true,
+        user: {
+          uid: PiSdkBase.user.uid ?? PiSdkBase.user.name,
+          username: PiSdkBase.user.username ?? PiSdkBase.user.name,
+          name: PiSdkBase.user.name,
+        },
+        ready: true,
+        error: null,
+      });
+    }
+  }, [state.connected]);
+
+  return { ...state, connect };
+}
+
+export function usePiPurchase(paymentData: PaymentData): () => void {
+  const purchase = useCallback(() => {
+    const pi = new PiSdkBase();
+    pi.createPayment(paymentData);
+  }, [paymentData]);
+
+  return purchase;
+}
diff --git a/apps/axiomid/src/lib/pi-sdk.ts b/apps/axiomid/src/lib/pi-sdk.ts
index 1a1b25d..32ab782 100644
--- a/apps/axiomid/src/lib/pi-sdk.ts
+++ b/apps/axiomid/src/lib/pi-sdk.ts
@@ -1,36 +1,53 @@
-export type PiScope = "username" | "payments" | "wallet_address";
+import { PiSdkBase } from "@pinetwork/pi-sdk-js";
+
+export type { PiUser, PaymentData } from "@pinetwork/pi-sdk-js";
+
+PiSdkBase.paymentBasePath = "api/pi/payment";
 
 export interface PiAuthResult {
   accessToken: string;
-  user: { uid: string; username: string };
+  user: { uid: string; username: string; name: string };
 }
 
-function getPi(): any {
-  if (typeof window === "undefined") throw new Error("Pi SDK only available in browser");
-  const pi = (window as any).Pi;
-  if (!pi?.init) throw new Error("Pi SDK not loaded");
-  return pi;
+export function getPiSdk(): PiSdkBase {
+  return new PiSdkBase();
 }
 
-export async function initPiSdk(sandbox?: boolean): Promise<void> {
-  const pi = getPi();
-  if (pi.authenticate) return;
-  await pi.init({ version: "2.0", sandbox: !!sandbox });
-  if (!pi.authenticate) throw new Error("Pi SDK init failed");
+function shouldUseSandbox(): boolean {
+  if (typeof process !== "undefined" && process.env?.NEXT_PUBLIC_PI_SANDBOX === "true") return true;
+  if (typeof window !== "undefined" && new URLSearchParams(window.location.search).get("sandbox") === "true") return true;
+  return false;
 }
 
-export async function authenticatePi(
-  scopes: PiScope[],
-  onIncompletePayment?: (payment: any) => void
-): Promise<PiAuthResult> {
-  const pi = getPi();
-  if (!pi.authenticate) throw new Error("Pi SDK not initialized, call initPiSdk first");
-  const auth = await pi.authenticate(
-    scopes,
-    onIncompletePayment ?? (() => {})
-  );
+export async function connectPi(): Promise<PiAuthResult> {
+  const sandbox = shouldUseSandbox();
+
+  if (sandbox && typeof window !== "undefined") {
+    (window as any).RAILS_ENV = "development";
+  }
+
+  const pi = getPiSdk();
+  await pi.connect();
+
+  if (!PiSdkBase.connected || !PiSdkBase.user || !PiSdkBase.accessToken) {
+    throw new Error("Pi SDK authentication failed");
+  }
+
   return {
-    accessToken: auth.accessToken,
-    user: { uid: auth.user.uid, username: auth.user.username },
+    accessToken: PiSdkBase.accessToken,
+    user: {
+      uid: PiSdkBase.user.uid ?? PiSdkBase.user.name,
+      username: PiSdkBase.user.username ?? PiSdkBase.user.name,
+      name: PiSdkBase.user.name,
+    },
   };
 }
+
+export function isPiSdkLoaded(): boolean {
+  if (typeof window === "undefined") return false;
+  return !!(window as any).Pi?.init;
+}
+
+export function isPiSdkConnected(): boolean {
+  return PiSdkBase.connected;
+}
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 7593374..fc0346b 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -14,6 +14,9 @@ importers:
 
   apps/axiomid:
     dependencies:
+      '@pinetwork/pi-sdk-js':
+        specifier: ^2.0.0
+        version: 2.0.0
       '@prisma/client':
         specifier: ^6.0.0
         version: 6.19.3(prisma@6.19.3(typescript@5.9.3))(typescript@5.9.3)
@@ -755,6 +758,9 @@ packages:
     resolution: {integrity: sha512-nn5ozdjYQpUCZlWGuxcJY/KpxkWQs4DcbMCmKojjyrYDEAGy4Ce19NN4v5MduafTwJlbKc99UA8YhSVqq9yPZA==}
     engines: {node: '>=12.4.0'}
 
+  '@pinetwork/pi-sdk-js@2.0.0':
+    resolution: {integrity: sha512-4sF5xl3m0iYiaMUqSXG+Cp9LgxDGQnpHSGN/OhsTFHg2POwn55mG/wclfGShhqtt31xcNVTSgcbH2AptuqbFpQ==}
+
   '@pkgjs/parseargs@0.11.0':
     resolution: {integrity: sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==}
     engines: {node: '>=14'}
@@ -1340,6 +1346,9 @@ packages:
     resolution: {integrity: sha512-hsU18Ae8CDTR6Kgu9DYf0EbCr/a5iGL0rytQDobUcdpYOKokk8LEjVphnXkDkgpi0wYVsqrXuP0bZxJaTqdgoA==}
     engines: {node: '>= 0.4'}
 
+  async-mutex@0.4.1:
+    resolution: {integrity: sha512-WfoBo4E/TbCX1G95XTjbWTE3X2XLG0m1Xbv2cwOtuPdyH9CZvnaA5nCt1ucjaKEgW2A5IF71hxrRhr83Je5xjA==}
+
   available-typed-arrays@1.0.7:
     resolution: {integrity: sha512-wvUjBtSGN7+7SjNpq/9M2Tg350UZD3q62IFZLbRAR1bSMlCo1ZaeW+BJ+D090e4hIIZLBcTDWe4Mh4jvUDajzQ==}
     engines: {node: '>= 0.4'}
@@ -4153,6 +4162,10 @@ snapshots:
 
   '@nolyfill/is-core-module@1.0.39': {}
 
+  '@pinetwork/pi-sdk-js@2.0.0':
+    dependencies:
+      async-mutex: 0.4.1
+
   '@pkgjs/parseargs@0.11.0':
     optional: true
 
@@ -4724,6 +4737,10 @@ snapshots:
 
   async-function@1.0.0: {}
 
+  async-mutex@0.4.1:
+    dependencies:
+      tslib: 2.8.1
+
   available-typed-arrays@1.0.7:
     dependencies:
       possible-typed-array-names: 1.1.0

From 87b3943a6627b890cfd7b64aa56a7831a55b952e Mon Sep 17 00:00:00 2001
From: Mohamed Abdelaziz <amrikyy@gmail.com>
Date: Mon, 25 May 2026 06:43:05 +0300
Subject: [PATCH 13/14] =?UTF-8?q?fix:=20sandbox=20auth=20=E2=80=94=20add?=
 =?UTF-8?q?=20postMessage=20patch,=20communication=5Finformation=20handler?=
 =?UTF-8?q?,=20iframe=20detection?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- patchPostMessageForSandbox() bridges cross-origin postMessage in iframe
- listenForPiSDKMessages() responds to @pi:app:sdk:communication_information_request
- SandboxProvider initialized on mount in layout.tsx
- shouldUseSandbox() detects iframe from sandbox.minepi.com
- Add NEXT_PUBLIC_DEV_URL to .env.example
---
 apps/axiomid/.env.example                     |  4 ++
 .../src/app/context/sandbox-provider.tsx      | 12 +++++
 apps/axiomid/src/app/layout.tsx               |  7 ++-
 apps/axiomid/src/lib/pi-sandbox.ts            | 49 +++++++++++++++++++
 apps/axiomid/src/lib/pi-sdk.ts                |  7 ++-
 5 files changed, 76 insertions(+), 3 deletions(-)
 create mode 100644 apps/axiomid/src/app/context/sandbox-provider.tsx
 create mode 100644 apps/axiomid/src/lib/pi-sandbox.ts

diff --git a/apps/axiomid/.env.example b/apps/axiomid/.env.example
index fe4db38..62e1f1c 100644
--- a/apps/axiomid/.env.example
+++ b/apps/axiomid/.env.example
@@ -51,6 +51,10 @@ PI_WALLET_PRIVATE_SEED=
 #    Set to `true` to point the Pi SDK at the sandbox environment.
 NEXT_PUBLIC_PI_SANDBOX=false
 
+# 5. Development URL for Pi Sandbox communication
+#    Set to your sandbox subdomain from Pi Developer Portal (e.g., axiomid8992.pinet.com)
+NEXT_PUBLIC_DEV_URL=
+
 # -----------------------------------------------------------------------------
 # Web3Auth (client)
 # -----------------------------------------------------------------------------
diff --git a/apps/axiomid/src/app/context/sandbox-provider.tsx b/apps/axiomid/src/app/context/sandbox-provider.tsx
new file mode 100644
index 0000000..3f74098
--- /dev/null
+++ b/apps/axiomid/src/app/context/sandbox-provider.tsx
@@ -0,0 +1,12 @@
+"use client";
+
+import { useEffect } from "react";
+import { initSandboxCompatibility } from "@/lib/pi-sandbox";
+
+export function SandboxProvider({ children }: { children: React.ReactNode }) {
+  useEffect(() => {
+    initSandboxCompatibility();
+  }, []);
+
+  return <>{children}</>;
+}
diff --git a/apps/axiomid/src/app/layout.tsx b/apps/axiomid/src/app/layout.tsx
index 46f0fcf..af99c7c 100644
--- a/apps/axiomid/src/app/layout.tsx
+++ b/apps/axiomid/src/app/layout.tsx
@@ -3,6 +3,7 @@ import { Geist, Geist_Mono } from "next/font/google";
 import Script from "next/script";
 import "./globals.css";
 import { WalletProvider } from "./context/wallet-context";
+import { SandboxProvider } from "./context/sandbox-provider";
 
 // Preload fonts for better performance
 const geistSans = Geist({
@@ -115,9 +116,11 @@ export default function RootLayout({
         className={`${geistSans.variable} ${geistMono.variable} antialiased bg-black text-white min-h-screen overflow-x-hidden`}
       >
         <Script src="https://sdk.minepi.com/pi-sdk.js" strategy="beforeInteractive" />
-        <WalletProvider>
+        <SandboxProvider>
+          <WalletProvider>
             {children}
-        </WalletProvider>
+          </WalletProvider>
+        </SandboxProvider>
         <script
           dangerouslySetInnerHTML={{
             __html: `
diff --git a/apps/axiomid/src/lib/pi-sandbox.ts b/apps/axiomid/src/lib/pi-sandbox.ts
new file mode 100644
index 0000000..d1b27b7
--- /dev/null
+++ b/apps/axiomid/src/lib/pi-sandbox.ts
@@ -0,0 +1,49 @@
+export function patchPostMessageForSandbox(): void {
+  const originalPostMessage = window.postMessage.bind(window);
+
+  window.postMessage = ((message: any, targetOrigin: string, ...args: any[]) => {
+    if (window.parent && window.parent !== window) {
+      (window.parent as any).postMessage(message, "*", ...args);
+    } else {
+      originalPostMessage(message, targetOrigin, ...args);
+    }
+  }) as typeof window.postMessage;
+}
+
+export function listenForPiSDKMessages(): void {
+  function handlePiMessage(event: MessageEvent) {
+    if (typeof event.data !== "string") return;
+
+    try {
+      const msg = JSON.parse(event.data);
+
+      if (msg.type === "@pi:app:sdk:communication_information_request") {
+        const response = {
+          type: "@pi:app:sdk:communication_information_response",
+          id: msg.id,
+          payload: {
+            frontend_url: process.env.NEXT_PUBLIC_SITE_URL || "https://axiomid.app",
+            development_url:
+              process.env.NEXT_PUBLIC_DEV_URL || "https://axiomid8992.pinet.com",
+            slug: msg.payload?.slug || "",
+            name: msg.payload?.name || "AxiomID",
+          },
+        };
+        event.source?.postMessage(JSON.stringify(response), {
+          targetOrigin: event.origin,
+        });
+      }
+    } catch {
+      // Ignore non-JSON messages
+    }
+  }
+
+  window.addEventListener("message", handlePiMessage);
+}
+
+export function initSandboxCompatibility(): void {
+  if (typeof window === "undefined") return;
+
+  patchPostMessageForSandbox();
+  listenForPiSDKMessages();
+}
diff --git a/apps/axiomid/src/lib/pi-sdk.ts b/apps/axiomid/src/lib/pi-sdk.ts
index 32ab782..871f217 100644
--- a/apps/axiomid/src/lib/pi-sdk.ts
+++ b/apps/axiomid/src/lib/pi-sdk.ts
@@ -15,7 +15,12 @@ export function getPiSdk(): PiSdkBase {
 
 function shouldUseSandbox(): boolean {
   if (typeof process !== "undefined" && process.env?.NEXT_PUBLIC_PI_SANDBOX === "true") return true;
-  if (typeof window !== "undefined" && new URLSearchParams(window.location.search).get("sandbox") === "true") return true;
+  if (typeof window !== "undefined") {
+    if (new URLSearchParams(window.location.search).get("sandbox") === "true") return true;
+    try {
+      if (window.self !== window.top && document.referrer.includes("sandbox.minepi.com")) return true;
+    } catch {}
+  }
   return false;
 }
 

From 978d678def473da65cc82a4a239d73011d3a7c2a Mon Sep 17 00:00:00 2001
From: Mohamed Abdelaziz <amrikyy@gmail.com>
Date: Mon, 25 May 2026 15:47:24 +0300
Subject: [PATCH 14/14] fix(auth): unify pi-sdk and fix sandbox detection

---
 .../src/app/context/wallet-context.tsx        |  85 ++++--
 apps/axiomid/src/app/dashboard/page.tsx       |  34 ++-
 apps/axiomid/src/lib/pi-sdk.ts                | 268 +++++++++++++++---
 apps/axiomid/src/lib/pi-wallet.ts             | 113 --------
 4 files changed, 331 insertions(+), 169 deletions(-)
 delete mode 100644 apps/axiomid/src/lib/pi-wallet.ts

diff --git a/apps/axiomid/src/app/context/wallet-context.tsx b/apps/axiomid/src/app/context/wallet-context.tsx
index da2448c..04c140d 100644
--- a/apps/axiomid/src/app/context/wallet-context.tsx
+++ b/apps/axiomid/src/app/context/wallet-context.tsx
@@ -2,7 +2,7 @@
 
 import { createContext, useContext, useState, useEffect, useCallback, useRef, ReactNode } from "react";
 import { Tier, getLevelProgress, getNextLevelXP } from "@/lib/tiers";
-import { connectPi, isPiSdkLoaded } from "@/lib/pi-sdk";
+import { connectPi, runWalletTest, isPiSdkLoaded } from "@/lib/pi-sdk";
 
 export interface User {
   id: string;
@@ -32,6 +32,9 @@ interface WalletContextType {
   activateAgent: () => Promise<boolean>;
   levelProgress: number;
   nextXP: number | null;
+  walletLogs: string[];
+  runWalletTest: () => Promise<void>;
+  clearWalletLogs: () => void;
 }
 
 const WalletContext = createContext<WalletContextType | null>(null);
@@ -39,6 +42,15 @@ const WalletContext = createContext<WalletContextType | null>(null);
 function checkPiBrowser(): boolean {
   if (typeof navigator === "undefined") return false;
   if (isPiSdkLoaded()) return true;
+  if (process.env.NEXT_PUBLIC_PI_SANDBOX === "true") return true;
+  
+  try {
+    if (window.self !== window.top) return true;
+  } catch (e) {
+    // Cross-origin iframe check might throw, meaning we are in an iframe
+    return true; 
+  }
+  
   const ua = navigator.userAgent;
   return /Pi Browser|minepi/i.test(ua);
 }
@@ -53,20 +65,31 @@ export function WalletProvider({ children }: { children: ReactNode }) {
   const levelProgress = user ? getLevelProgress(user.xp, user.tier) : 0;
   const nextXP = user ? getNextLevelXP(user.tier) : null;
   const authAttempted = useRef(false);
+  const [walletLogs, setWalletLogs] = useState<string[]>([]);
+
+  const pushLog = useCallback((msg: string) => {
+    setWalletLogs((prev) => [...prev, `[${new Date().toLocaleTimeString()}] ${msg}`]);
+  }, []);
+
+  const clearWalletLogs = useCallback(() => setWalletLogs([]), []);
 
   const connectWallet = useCallback(async () => {
     setIsConnecting(true);
     setError(null);
+    pushLog("بدء الاتصال بالمحفظة...");
 
     try {
       const inPiBrowser = checkPiBrowser();
+      pushLog(`حالة Pi Browser: ${inPiBrowser ? "نعم ✅" : "لا"}`);
 
       if (!inPiBrowser) {
+        pushLog("وضع التجربة (non-Pi browser)...");
         const storedWallet = localStorage.getItem("axiomid_wallet");
         const walletAddress = storedWallet && storedWallet.startsWith("demo:")
           ? storedWallet
           : `demo:${crypto.randomUUID().slice(0, 8)}`;
         localStorage.setItem("axiomid_wallet", walletAddress);
+        pushLog(`محفظة مؤقتة: ${walletAddress}`);
 
         const res = await fetch("/api/auth/connect", {
           method: "POST",
@@ -76,13 +99,17 @@ export function WalletProvider({ children }: { children: ReactNode }) {
 
         if (!res.ok) throw new Error("Demo auth failed");
         const data = await res.json();
+        pushLog(`تم تسجيل الدخول بنجاح ✅`);
         setUser(data.user);
         return;
       }
 
-      const { accessToken, user: piUser } = await connectPi();
+      pushLog("جاري التوثيق عبر Pi SDK...");
+      const { accessToken, user: piUser } = await connectPi(pushLog);
       const walletAddress = `pi:${piUser.uid}`;
+      pushLog(`عنوان المحفظة: ${walletAddress}`);
 
+      pushLog("جاري التحقق من صحة التوثيق مع السيرفر...");
       const res = await fetch("/api/auth/pi", {
         method: "POST",
         headers: { "Content-Type": "application/json" },
@@ -102,14 +129,26 @@ export function WalletProvider({ children }: { children: ReactNode }) {
       const data = await res.json();
       localStorage.setItem("axiomid_wallet", walletAddress);
       setUser(data.user);
+      pushLog(`✅ تم توثيق المحفظة بنجاح!`);
     } catch (err: unknown) {
       const message = err instanceof Error ? err.message : "Connection failed";
       console.error("Auth error:", message);
+      pushLog(`❌ خطأ: ${message}`);
       setError(message);
     } finally {
       setIsConnecting(false);
     }
-  }, []);
+  }, [pushLog]);
+
+  const runTest = useCallback(async () => {
+    clearWalletLogs();
+    pushLog("🚀 بدء اختبار المحفظة الشامل...");
+    try {
+      await runWalletTest(pushLog);
+    } catch (err: any) {
+      pushLog(`❌ خطأ غير متوقع: ${err?.message || err}`);
+    }
+  }, [pushLog, clearWalletLogs]);
 
   useEffect(() => {
     const inPiBrowser = checkPiBrowser();
@@ -198,27 +237,35 @@ export function WalletProvider({ children }: { children: ReactNode }) {
   }, [user, refreshUser]);
 
   return (
-    <WalletContext.Provider
-      value={{
-        user,
-        isLoading,
-        isConnecting,
-        error,
-        isPiBrowser,
-        connectWallet,
-        claimAction,
-        refreshUser,
-        createAgent,
-        activateAgent,
-        levelProgress,
-        nextXP,
-      }}
-    >
+      <WalletContext.Provider
+        value={{
+          user,
+          isLoading,
+          isConnecting,
+          error,
+          isPiBrowser,
+          connectWallet,
+          claimAction,
+          refreshUser,
+          createAgent,
+          activateAgent,
+          levelProgress,
+          nextXP,
+          walletLogs,
+          runWalletTest: runTest,
+          clearWalletLogs,
+        }}
+      >
       {children}
     </WalletContext.Provider>
   );
 }
 
+export function useWalletLogs(): string[] {
+  const ctx = useContext(WalletContext);
+  return ctx?.walletLogs ?? [];
+}
+
 export function useWallet() {
   const ctx = useContext(WalletContext);
   if (!ctx) {
diff --git a/apps/axiomid/src/app/dashboard/page.tsx b/apps/axiomid/src/app/dashboard/page.tsx
index 578df34..69960da 100644
--- a/apps/axiomid/src/app/dashboard/page.tsx
+++ b/apps/axiomid/src/app/dashboard/page.tsx
@@ -3,7 +3,7 @@
 import { useState, useEffect, useRef } from "react";
 import { motion, AnimatePresence } from "framer-motion";
 import { useWallet } from "../context/wallet-context";
-import { createPiPayment } from "@/lib/pi-wallet";
+import { createPiPayment } from "@/lib/pi-sdk";
 import Link from "next/link";
 import skillsData from "@/data/skills.json";
 import personasData from "@/data/personas.json";
@@ -39,7 +39,10 @@ export default function Dashboard() {
     isPiBrowser,
     createAgent,
     activateAgent,
-    refreshUser
+    refreshUser,
+    runWalletTest,
+    walletLogs,
+    clearWalletLogs
   } = useWallet();
 
   const [logs, setLogs] = useState<string[]>(INITIAL_LOGS);
@@ -71,6 +74,16 @@ export default function Dashboard() {
     return () => clearInterval(interval);
   }, []);
 
+  // Pipe wallet logs to terminal as they come in
+  const prevLogsLength = useRef(0);
+  useEffect(() => {
+    if (walletLogs.length > prevLogsLength.current) {
+      const newLogs = walletLogs.slice(prevLogsLength.current);
+      setLogs((prev) => [...prev, ...newLogs]);
+      prevLogsLength.current = walletLogs.length;
+    }
+  }, [walletLogs]);
+
   // Scroll terminal to bottom
   useEffect(() => {
     terminalEndRef.current?.scrollIntoView({ behavior: "smooth" });
@@ -94,7 +107,7 @@ export default function Dashboard() {
     let response = "";
 
     if (cmd === "help") {
-      response = "Available commands: status, did, balance, skills, personas, memory, conscience, mcp, clear, ping";
+      response = "Available commands: status, did, balance, skills, personas, memory, conscience, mcp, wallet-test, wallet-logs, clear, ping";
       setLogs((prev) => [...prev, `[SYSTEM] ${response}`]);
     } else if (cmd === "status") {
       response = `Agentic OS v1.0.0. User: ${user?.piUsername || "anonymous"}. Tier: ${user?.tier || "None"}. Agent: ${user?.agent ? user.agent.name : "None"}. Status: active.`;
@@ -108,6 +121,21 @@ export default function Dashboard() {
     } else if (cmd === "ping") {
       response = "pong. latency: 12ms. resonance: 369hz.";
       setLogs((prev) => [...prev, `[SYSTEM] ${response}`]);
+    } else if (cmd === "wallet-test") {
+      prevLogsLength.current = 0;
+      clearWalletLogs();
+      setLogs((prev) => [...prev, "[SYSTEM] 🚀 تشغيل اختبار المحفظة الشامل..."]);
+      runWalletTest();
+    } else if (cmd === "wallet-logs") {
+      if (walletLogs.length === 0) {
+        setLogs((prev) => [...prev, "[SYSTEM] لا توجد سجلات. استخدم 'wallet-test' أولاً."]);
+      } else {
+        setLogs((prev) => [...prev, `[SYSTEM] === سجلات اختبار المحفظة (${walletLogs.length}) ===`]);
+        for (const log of walletLogs) {
+          setLogs((prev) => [...prev, log]);
+        }
+        setLogs((prev) => [...prev, "[SYSTEM] === انتهت السجلات ==="]);
+      }
     } else if (cmd === "mcp") {
       setLogs((prev) => [
         ...prev,
diff --git a/apps/axiomid/src/lib/pi-sdk.ts b/apps/axiomid/src/lib/pi-sdk.ts
index 871f217..c787802 100644
--- a/apps/axiomid/src/lib/pi-sdk.ts
+++ b/apps/axiomid/src/lib/pi-sdk.ts
@@ -1,58 +1,258 @@
-import { PiSdkBase } from "@pinetwork/pi-sdk-js";
-
-export type { PiUser, PaymentData } from "@pinetwork/pi-sdk-js";
-
-PiSdkBase.paymentBasePath = "api/pi/payment";
+const CDN_URL = "https://sdk.minepi.com/pi-sdk.js";
 
 export interface PiAuthResult {
   accessToken: string;
   user: { uid: string; username: string; name: string };
 }
 
-export function getPiSdk(): PiSdkBase {
-  return new PiSdkBase();
+type LogFn = (msg: string) => void;
+
+function getWindowPi(): any {
+  if (typeof window === "undefined") return null;
+  return (window as any).Pi;
 }
 
-function shouldUseSandbox(): boolean {
-  if (typeof process !== "undefined" && process.env?.NEXT_PUBLIC_PI_SANDBOX === "true") return true;
-  if (typeof window !== "undefined") {
-    if (new URLSearchParams(window.location.search).get("sandbox") === "true") return true;
-    try {
-      if (window.self !== window.top && document.referrer.includes("sandbox.minepi.com")) return true;
-    } catch {}
+export function isPiSdkLoaded(): boolean {
+  if (typeof window === "undefined") return false;
+  const Pi = getWindowPi();
+  return !!(Pi?.authenticate);
+}
+
+function loadCdnScript(): Promise<void> {
+  return new Promise((resolve, reject) => {
+    if (document.querySelector(`script[src="${CDN_URL}"]`)) {
+      resolve();
+      return;
+    }
+    const script = document.createElement("script");
+    script.src = CDN_URL;
+    script.async = true;
+    script.onload = () => resolve();
+    script.onerror = () => reject(new Error("Failed to load Pi SDK CDN script"));
+    document.head.appendChild(script);
+  });
+}
+
+export async function ensurePiSdk(onLog?: LogFn): Promise<any> {
+  onLog?.("[PI-SDK] 🔍 Checking Pi SDK availability...");
+
+  let Pi = getWindowPi();
+  if (Pi?.authenticate) {
+    onLog?.("[PI-SDK] ✅ window.Pi موجود (من الساندبوكس أو Pi Browser)");
+    return Pi;
   }
-  return false;
+
+  onLog?.("[PI-SDK] ⏳ window.Pi غير موجود. جاري تحميل CDN script...");
+  await loadCdnScript();
+  onLog?.("[PI-SDK] ✅ CDN script تم تحميله");
+
+  Pi = getWindowPi();
+  if (!Pi?.authenticate) {
+    onLog?.("[PI-SDK] ❌ window.Pi لا يزال غير متاح بعد تحميل CDN");
+    throw new Error("Pi SDK failed to initialize after loading CDN script");
+  }
+  onLog?.("[PI-SDK] ✅ window.Pi جاهز");
+  return Pi;
 }
 
-export async function connectPi(): Promise<PiAuthResult> {
-  const sandbox = shouldUseSandbox();
+export async function connectPi(onLog?: LogFn): Promise<PiAuthResult> {
+  if (typeof window === "undefined") {
+    throw new Error("Pi SDK only works in browser");
+  }
+
+  const Pi = await ensurePiSdk(onLog);
 
-  if (sandbox && typeof window !== "undefined") {
-    (window as any).RAILS_ENV = "development";
+  if (typeof Pi.init === "function") {
+    onLog?.("[PI-SDK] 🔄 Calling Pi.init({ version: \"2.0\" })...");
+    await Pi.init({ version: "2.0" });
+    onLog?.("[PI-SDK] ✅ Pi.init() completed");
+  } else {
+    onLog?.("[PI-SDK] ⏩ Pi.init() غير متاح — الساندبوكس يدير init بنفسه");
   }
 
-  const pi = getPiSdk();
-  await pi.connect();
+  onLog?.("[PI-SDK] 🔄 Calling Pi.authenticate(['payments', 'username'])...");
+  let authResult: any;
+  try {
+    authResult = await Pi.authenticate(
+      ["payments", "username"],
+      (payment: any) => {
+        onLog?.(`[PI-SDK] ⚠️ Incomplete payment found: ${payment?.identifier}`);
+      },
+    );
+  } catch (err: any) {
+    onLog?.(`[PI-SDK] ❌ Pi.authenticate() failed: ${err?.message || err}`);
+    throw new Error(`Pi authentication failed: ${err?.message || err}`);
+  }
 
-  if (!PiSdkBase.connected || !PiSdkBase.user || !PiSdkBase.accessToken) {
-    throw new Error("Pi SDK authentication failed");
+  onLog?.("[PI-SDK] ✅ Pi.authenticate() succeeded!");
+
+  if (!authResult?.accessToken || !authResult?.user?.uid) {
+    onLog?.("[PI-SDK] ❌ Auth result missing accessToken or user");
+    throw new Error("Pi authentication returned incomplete result");
   }
 
+  const uid = authResult.user.uid;
+  const username = authResult.user.username || uid;
+
+  onLog?.(`[PI-SDK] 👤 User: ${username} (UID: ${uid})`);
+  onLog?.(`[PI-SDK] 🔑 Access token: ${authResult.accessToken.slice(0, 20)}...`);
+  onLog?.("[PI-SDK] ✅ Wallet authentication complete!");
+
   return {
-    accessToken: PiSdkBase.accessToken,
-    user: {
-      uid: PiSdkBase.user.uid ?? PiSdkBase.user.name,
-      username: PiSdkBase.user.username ?? PiSdkBase.user.name,
-      name: PiSdkBase.user.name,
-    },
+    accessToken: authResult.accessToken,
+    user: { uid, username, name: username },
   };
 }
 
-export function isPiSdkLoaded(): boolean {
-  if (typeof window === "undefined") return false;
-  return !!(window as any).Pi?.init;
+export async function runWalletTest(onLog: LogFn): Promise<void> {
+  onLog?.("[WALLET-TEST] ====== بدء اختبار المحفظة ======");
+  onLog?.(`[WALLET-TEST] 📅 ${new Date().toLocaleString()}`);
+  onLog?.("[WALLET-TEST] 📋 البيئة: " + (typeof window !== "undefined" ? window.location.href : "SSR"));
+
+  onLog?.("[WALLET-TEST] 🔍 1/7 التحقق من تحميل Pi SDK...");
+  if (typeof window === "undefined") {
+    onLog?.("[WALLET-TEST] ❌ ليس في المتصفح");
+    return;
+  }
+
+  const Pi = getWindowPi();
+  onLog?.(`[WALLET-TEST]    window.Pi: ${Pi ? "موجود ✅" : "غير موجود ❌"}`);
+  onLog?.(`[WALLET-TEST]    window.Pi.init: ${typeof Pi?.init === "function" ? "موجود ✅" : "غير موجود ❌"}`);
+  onLog?.(`[WALLET-TEST]    window.Pi.authenticate: ${typeof Pi?.authenticate === "function" ? "موجود ✅" : "غير موجود ❌"}`);
+  onLog?.(`[WALLET-TEST]    window.Pi.createPayment: ${typeof Pi?.createPayment === "function" ? "موجود ✅" : "غير موجود ❌"}`);
+
+  const isIframe = typeof window !== "undefined" && window.self !== window.top;
+  const isSandboxDetected = Pi?.sandboxMode || isIframe;
+  onLog?.("[WALLET-TEST] 2/7 البيئة:");
+  onLog?.(`    NEXT_PUBLIC_PI_SANDBOX: ${process.env.NEXT_PUBLIC_PI_SANDBOX || "غير معرف"}`);
+  onLog?.(`    داخل iframe: ${isIframe ? "نعم ✅" : "لا"}`);
+  onLog?.(`    Sandbox detected: ${isSandboxDetected ? "نعم ✅" : "لا"}`);
+
+  if (isIframe) {
+    onLog?.("[WALLET-TEST]    origin: " + window.location.origin);
+    try {
+      onLog?.("[WALLET-TEST]    parent origin: " + (document.referrer || "لا يوجد"));
+    } catch {}
+  }
+
+  try {
+    await ensurePiSdk(onLog);
+  } catch (err: any) {
+    onLog?.(`[WALLET-TEST] ❌ فشل تحميل Pi SDK: ${err?.message || err}`);
+    return;
+  }
+
+  const piReady = getWindowPi();
+  if (!piReady?.authenticate) {
+    onLog?.("[WALLET-TEST] ❌ Pi SDK غير متاح بعد المحاولة.");
+    return;
+  }
+
+  onLog?.("[WALLET-TEST] 3/7 الاتصال بـ Pi.init()...");
+  try {
+    if (typeof piReady.init === "function") {
+      await piReady.init({ version: "2.0" });
+      onLog?.("[WALLET-TEST] ✅ Pi.init() نجح");
+    } else {
+      onLog?.("[WALLET-TEST] ⏩ Pi.init() غير متاح، ننتقل للخطوة التالية");
+    }
+  } catch (err: any) {
+    onLog?.(`[WALLET-TEST] ❌ Pi.init() فشل: ${err?.message || err}`);
+    return;
+  }
+
+  onLog?.("[WALLET-TEST] 4/7 محاولة المصادقة عبر Pi.authenticate()...");
+  let authResult: any;
+  try {
+    authResult = await piReady.authenticate(["payments", "username"], (payment: any) => {
+      onLog?.(`[WALLET-TEST] ⚠️ دفعة غير مكتملة: ${payment?.identifier}`);
+    });
+    onLog?.("[WALLET-TEST] ✅ Pi.authenticate() نجح!");
+  } catch (err: any) {
+    onLog?.(`[WALLET-TEST] ❌ Pi.authenticate() فشل: ${err?.message || err}`);
+    onLog?.("[WALLET-TEST]    تحقق من أنك في Pi Browser أو Pi Sandbox");
+    return;
+  }
+
+  const uid = authResult?.user?.uid || "غير معروف";
+  const username = authResult?.user?.username || uid;
+  const token = authResult?.accessToken || "";
+
+  onLog?.("[WALLET-TEST] 5/7 بيانات المستخدم:");
+  onLog?.(`    UID: ${uid}`);
+  onLog?.(`    اسم المستخدم: ${username}`);
+  onLog?.(`    Stellar Wallet: ${authResult?.user?.wallet_address || "غير معروف"}`);
+  onLog?.(`    Access Token: ${token.slice(0, 30)}...`);
+
+  onLog?.("[WALLET-TEST] ====== ✅ انتهى الاختبار بنجاح ======");
 }
 
-export function isPiSdkConnected(): boolean {
-  return PiSdkBase.connected;
+export interface PiPayment {
+  identifier: string;
+  amount: number;
+  memo: string;
+  status: 'pending' | 'completed' | 'failed';
+  fromAddress: string;
+  toAddress: string;
+  createdAt: string;
+}
+
+export async function createPiPayment(amount: number, memo: string, metadata?: Record<string, unknown>): Promise<PiPayment> {
+  const Pi = await ensurePiSdk();
+
+  return new Promise<PiPayment>((resolve, reject) => {
+    Pi.createPayment({
+      amount,
+      memo,
+      metadata: metadata || {},
+    }, {
+      onReadyForServerApproval: async (paymentId: string) => {
+        try {
+          const res = await fetch('/api/pi/payment/approve', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ paymentId })
+          });
+          if (!res.ok) throw new Error('Failed to approve payment with backend');
+          console.log('[Pi Payment] Payment approved on backend:', paymentId);
+        } catch (err) {
+          console.error('[Pi Payment] Error in onReadyForServerApproval:', err);
+          reject(err);
+        }
+      },
+      onReadyForServerCompletion: async (paymentId: string, txid: string) => {
+        try {
+          const res = await fetch('/api/pi/payment/complete', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ paymentId, txid })
+          });
+          if (!res.ok) throw new Error('Failed to complete payment with backend');
+          const data = await res.json();
+          console.log('[Pi Payment] Payment completed successfully:', data);
+          
+          resolve({
+            identifier: paymentId,
+            amount,
+            memo,
+            status: 'completed',
+            fromAddress: '',
+            toAddress: '',
+            createdAt: new Date().toISOString(),
+          });
+        } catch (err) {
+          console.error('[Pi Payment] Error in onReadyForServerCompletion:', err);
+          reject(err);
+        }
+      },
+      onCancel: (paymentId: string) => {
+        console.warn('[Pi Payment] Payment cancelled by user:', paymentId);
+        reject(new Error('Payment cancelled by user'));
+      },
+      onError: (error: Error, payment?: any) => {
+        console.error('[Pi Payment] Payment error:', error, payment);
+        reject(error || new Error('Payment error occurred'));
+      }
+    });
+  });
 }
diff --git a/apps/axiomid/src/lib/pi-wallet.ts b/apps/axiomid/src/lib/pi-wallet.ts
deleted file mode 100644
index a093db4..0000000
--- a/apps/axiomid/src/lib/pi-wallet.ts
+++ /dev/null
@@ -1,113 +0,0 @@
-export interface PiPayment {
-  identifier: string;
-  amount: number;
-  memo: string;
-  status: 'pending' | 'completed' | 'failed';
-  fromAddress: string;
-  toAddress: string;
-  createdAt: string;
-}
-
-export interface PiWalletState {
-  connected: boolean;
-  walletAddress: string | null;
-  balance: number | null;
-}
-
-export interface PiAuthResult {
-  accessToken: string;
-  user: {
-    uid: string;
-    username: string;
-  };
-}
-
-async function getPi(): Promise<any> {
-  if (typeof window === 'undefined') throw new Error('Pi SDK only in browser');
-  const Pi = (window as any).Pi;
-  if (!Pi?.authenticate || !Pi?.createPayment) throw new Error('Pi SDK not loaded');
-  return Pi;
-}
-
-export async function connectPiWallet(): Promise<PiAuthResult> {
-  const Pi = await getPi();
-  
-  const isSandbox = process.env.NEXT_PUBLIC_PI_SANDBOX === "true" || 
-    (typeof window !== "undefined" && new URLSearchParams(window.location.search).get("sandbox") === "true");
-
-  const scopes = isSandbox
-    ? ['username', 'payments']
-    : ['username', 'payments', 'wallet_address'];
-
-  const result = await Pi.authenticate(
-    scopes,
-    (payment: any) => {
-      console.warn('Incomplete Pi payment found:', payment.identifier);
-    }
-  );
-
-  return {
-    accessToken: result.accessToken,
-    user: { uid: result.user.uid, username: result.user.username },
-  };
-}
-
-export async function createPiPayment(amount: number, memo: string, metadata?: Record<string, unknown>): Promise<PiPayment> {
-  const Pi = await getPi();
-
-  return new Promise<PiPayment>((resolve, reject) => {
-    Pi.createPayment({
-      amount,
-      memo,
-      metadata: metadata || {},
-    }, {
-      onReadyForServerApproval: async (paymentId: string) => {
-        try {
-          const res = await fetch('/api/pi/payment/approve', {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ paymentId })
-          });
-          if (!res.ok) throw new Error('Failed to approve payment with backend');
-          console.log('[Pi Payment] Payment approved on backend:', paymentId);
-        } catch (err) {
-          console.error('[Pi Payment] Error in onReadyForServerApproval:', err);
-          reject(err);
-        }
-      },
-      onReadyForServerCompletion: async (paymentId: string, txid: string) => {
-        try {
-          const res = await fetch('/api/pi/payment/complete', {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ paymentId, txid })
-          });
-          if (!res.ok) throw new Error('Failed to complete payment with backend');
-          const data = await res.json();
-          console.log('[Pi Payment] Payment completed successfully:', data);
-          
-          resolve({
-            identifier: paymentId,
-            amount,
-            memo,
-            status: 'completed',
-            fromAddress: '',
-            toAddress: '',
-            createdAt: new Date().toISOString(),
-          });
-        } catch (err) {
-          console.error('[Pi Payment] Error in onReadyForServerCompletion:', err);
-          reject(err);
-        }
-      },
-      onCancel: (paymentId: string) => {
-        console.warn('[Pi Payment] Payment cancelled by user:', paymentId);
-        reject(new Error('Payment cancelled by user'));
-      },
-      onError: (error: Error, payment?: any) => {
-        console.error('[Pi Payment] Payment error:', error, payment);
-        reject(error || new Error('Payment error occurred'));
-      }
-    });
-  });
-}