@phantom/openclaw-plugin 0.1.0 → 0.1.1

package/README.md

@@ -6,6 +6,55 @@ Direct integration with Phantom wallet for OpenClaw agents. This plugin wraps th
 
 The Phantom OpenClaw Plugin provides native integration with Phantom wallet functionality. Instead of being a generic MCP bridge, it directly integrates the Phantom MCP Server tools as OpenClaw tools, providing a seamless experience for AI agents.
 
+## Quick Start
+
+Get up and running in under 5 minutes:
+
+### Installation Checklist
+
+- [ ] **Step 1:** Get your App ID from [phantom.com/portal](https://phantom.com/portal)
+  - Sign in with Gmail or Apple
+  - Click "Create App"
+  - Go to Dashboard → View App → Redirect URLs
+  - Add `http://localhost:8080/callback` as a redirect URL
+  - Navigate to "Phantom Connect" tab
+  - Copy your App ID
+
+- [ ] **Step 2:** Install the plugin
+
+  ```bash
+  openclaw plugins install @phantom/openclaw-plugin
+  ```
+
+- [ ] **Step 3:** Configure in `~/.openclaw/openclaw.json`
+
+  ```json
+  {
+    "plugins": {
+      "enabled": true,
+      "entries": {
+        "phantom-openclaw-plugin": {
+          "enabled": true,
+          "config": {
+            "PHANTOM_APP_ID": "your_app_id_from_portal"
+          }
+        }
+      }
+    }
+  }
+  ```
+
+- [ ] **Step 4:** Restart OpenClaw
+
+- [ ] **Step 5:** Test with your agent
+  ```text
+  Ask: "What are my Phantom wallet addresses?"
+  ```
+
+**⚠️ Important:** Use the same email address for both the Phantom Portal and OpenClaw authentication!
+
+See [Prerequisites](#prerequisites) below for detailed setup instructions.
+
 ## Features
 
 - **Direct Integration**: Built on top of `@phantom/mcp-server` for reliable wallet operations
@@ -20,7 +69,11 @@ Before using this plugin, you **must** obtain an App ID from the Phantom Portal:
 1. **Visit the Phantom Portal**: Go to [phantom.com/portal](https://phantom.com/portal)
 2. **Sign in**: Use your Gmail or Apple account to sign in
 3. **Create an App**: Click "Create App" and fill in the required details
-4. **Get Your App ID**: Navigate to the "Phantom Connect" tab to find your App ID
+4. **Configure Redirect URL**:
+   - Navigate to Dashboard → View App → Redirect URLs
+   - Add `http://localhost:8080/callback` as a redirect URL
+   - This allows the OAuth callback to work correctly
+5. **Get Your App ID**: Navigate to the "Phantom Connect" tab to find your App ID
    - Your app is automatically approved for development use
    - Copy the App ID for the configuration below
 
@@ -88,6 +141,7 @@ Sign an arbitrary message with the Phantom wallet.
 **Parameters:**
 
 - `message` (string, required): The message to sign
+- `networkId` (string, required): Network identifier (e.g., "solana:mainnet", "eip155:1")
 - `derivationIndex` (number, optional): Derivation index for the wallet (default: 0)
 
 **Example:**
@@ -95,6 +149,7 @@ Sign an arbitrary message with the Phantom wallet.
 ```json
 {
   "message": "Hello, Phantom!",
+  "networkId": "solana:mainnet",
   "derivationIndex": 0
 }
 ```
@@ -105,17 +160,18 @@ Sign a blockchain transaction.
 
 **Parameters:**
 
-- `transaction` (string, required): Base64-encoded transaction data
+- `transaction` (string, required): The transaction to sign (format depends on chain: base64url for Solana, RLP-encoded hex for Ethereum)
+- `networkId` (string, required): Network identifier (e.g., "solana:mainnet", "eip155:1" for Ethereum mainnet)
 - `derivationIndex` (number, optional): Derivation index for the wallet (default: 0)
-- `chain` (string, optional): Blockchain chain identifier
+- `account` (string, optional): Specific account address to use for simulation/signing
 
 **Example:**
 
 ```json
 {
-  "transaction": "base64-encoded-transaction-data",
-  "derivationIndex": 0,
-  "chain": "solana"
+  "transaction": "base64url-encoded-transaction-data",
+  "networkId": "solana:mainnet",
+  "derivationIndex": 0
 }
 ```
 
@@ -192,6 +248,36 @@ Fetch a Solana swap quote from Phantom's quotes API. Optionally execute the swap
 
 **⚠️ Warning:** When `execute: true`, this tool submits transactions immediately and irreversibly.
 
+## Network IDs Reference
+
+Network identifiers follow the CAIP-2/CAIP-10 format. Here are the supported networks:
+
+### Solana
+
+- Mainnet: `solana:mainnet`
+- Devnet: `solana:devnet`
+- Testnet: `solana:testnet`
+
+### Ethereum / EVM Chains
+
+- Ethereum Mainnet: `eip155:1`
+- Ethereum Sepolia: `eip155:11155111`
+- Polygon Mainnet: `eip155:137`
+- Polygon Amoy: `eip155:80002`
+- Base Mainnet: `eip155:8453`
+- Base Sepolia: `eip155:84532`
+- Arbitrum One: `eip155:42161`
+- Arbitrum Sepolia: `eip155:421614`
+
+### Bitcoin
+
+- Mainnet: `bip122:000000000019d6689c085ae165831e93`
+
+### Sui
+
+- Mainnet: `sui:mainnet`
+- Testnet: `sui:testnet`
+
 ## Authentication
 
 On first use, the plugin will automatically initiate the Phantom OAuth flow:

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * OpenClaw Plugin API types
+ */
+/**
+ * OpenClaw Plugin API interface
+ */
+type OpenClawApi = {
+    /** Plugin configuration provided by OpenClaw */
+    config?: Record<string, unknown>;
+    /** Register a tool with OpenClaw */
+    registerTool: (definition: {
+        name: string;
+        description: string;
+        parameters: unknown;
+        execute: (id: string, params: Record<string, unknown>) => Promise<{
+            content: unknown;
+            isError?: boolean;
+        }>;
+    }) => void;
+};
+
+/**
+ * Phantom OpenClaw Plugin
+ *
+ * Integrates Phantom wallet operations directly with OpenClaw agents
+ * by wrapping the Phantom MCP Server tools.
+ */
+
+/**
+ * Plugin registration function
+ */
+declare function register(api: OpenClawApi): Promise<void>;
+
+export { register as default };

package/dist/index.js

@@ -0,0 +1,170 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  default: () => register
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/session.ts
+var import_mcp_server = require("@phantom/mcp-server");
+var PluginSession = class {
+  constructor(options = {}) {
+    this.initialized = false;
+    this.initializingPromise = null;
+    this.sessionManager = new import_mcp_server.SessionManager({
+      appId: options.appId ?? "phantom-openclaw",
+      callbackPort: options.callbackPort,
+      sessionDir: options.sessionDir
+    });
+  }
+  /**
+   * Initialize the session (authenticate if needed)
+   * Thread-safe: concurrent calls will await the same initialization promise
+   */
+  async initialize() {
+    if (this.initialized) {
+      return;
+    }
+    if (this.initializingPromise) {
+      return this.initializingPromise;
+    }
+    this.initializingPromise = this.sessionManager.initialize().then(() => {
+      this.initialized = true;
+    }).catch((error) => {
+      this.initializingPromise = null;
+      throw error;
+    });
+    return this.initializingPromise;
+  }
+  /**
+   * Get the authenticated PhantomClient
+   */
+  getClient() {
+    if (!this.initialized) {
+      throw new Error("Session not initialized. Call initialize() first.");
+    }
+    return this.sessionManager.getClient();
+  }
+  /**
+   * Get the current session data
+   */
+  getSession() {
+    if (!this.initialized) {
+      throw new Error("Session not initialized. Call initialize() first.");
+    }
+    return this.sessionManager.getSession();
+  }
+};
+
+// src/tools/register-tools.ts
+var import_typebox = require("@sinclair/typebox");
+var import_mcp_server2 = require("@phantom/mcp-server");
+function convertSchema(mcpSchema) {
+  return import_typebox.Type.Object(
+    Object.fromEntries(Object.entries(mcpSchema.properties || {}).map(([key, _value]) => [key, import_typebox.Type.Unknown()]))
+  );
+}
+function registerPhantomTools(api, session) {
+  for (const mcpTool of import_mcp_server2.tools) {
+    api.registerTool({
+      name: mcpTool.name,
+      description: mcpTool.description,
+      parameters: convertSchema(mcpTool.inputSchema),
+      async execute(_id, params) {
+        const createLogger = (prefix) => ({
+          info: (msg) => console.info(`[${prefix}] ${msg}`),
+          // eslint-disable-line no-console
+          error: (msg) => console.error(`[${prefix}] ${msg}`),
+          // eslint-disable-line no-console
+          debug: (msg) => console.debug(`[${prefix}] ${msg}`),
+          // eslint-disable-line no-console
+          child: (name) => createLogger(`${prefix}:${name}`)
+        });
+        const context = {
+          client: session.getClient(),
+          session: session.getSession(),
+          logger: createLogger(mcpTool.name)
+        };
+        try {
+          const result = await mcpTool.handler(params, context);
+          const normalized = result ?? null;
+          return {
+            content: [
+              {
+                type: "text",
+                text: typeof normalized === "string" ? normalized : JSON.stringify(normalized, null, 2)
+              }
+            ]
+          };
+        } catch (error) {
+          const errorMessage = error instanceof Error ? error.message : String(error);
+          return {
+            content: [
+              {
+                type: "text",
+                text: JSON.stringify({ error: errorMessage }, null, 2)
+              }
+            ],
+            isError: true
+          };
+        }
+      }
+    });
+  }
+}
+
+// src/index.ts
+var sessionInstance = null;
+function getSession(config) {
+  if (!sessionInstance) {
+    const appId = typeof config?.PHANTOM_APP_ID === "string" ? config.PHANTOM_APP_ID : void 0;
+    let callbackPort;
+    if (typeof config?.PHANTOM_CALLBACK_PORT === "number") {
+      callbackPort = config.PHANTOM_CALLBACK_PORT;
+    } else if (typeof config?.PHANTOM_CALLBACK_PORT === "string") {
+      const parsed = parseInt(config.PHANTOM_CALLBACK_PORT, 10);
+      if (!isNaN(parsed) && parsed > 0 && parsed <= 65535) {
+        callbackPort = parsed;
+      }
+    }
+    sessionInstance = new PluginSession({
+      appId,
+      callbackPort
+    });
+  }
+  return sessionInstance;
+}
+function resetSession() {
+  sessionInstance = null;
+}
+async function register(api) {
+  try {
+    const session = getSession(api.config);
+    await session.initialize();
+    registerPhantomTools(api, session);
+  } catch (error) {
+    console.error("Failed to initialize Phantom OpenClaw plugin:", error);
+    resetSession();
+    throw error;
+  }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/session.ts","../src/tools/register-tools.ts"],"sourcesContent":["/**\n * Phantom OpenClaw Plugin\n *\n * Integrates Phantom wallet operations directly with OpenClaw agents\n * by wrapping the Phantom MCP Server tools.\n */\n\nimport type { OpenClawApi } from \"./client/types.js\";\nimport { PluginSession } from \"./session.js\";\nimport { registerPhantomTools } from \"./tools/register-tools.js\";\n\n// Singleton session instance\nlet sessionInstance: PluginSession | null = null;\n\n/**\n * Get or create the plugin session with configuration\n */\nfunction getSession(config?: Record<string, unknown>): PluginSession {\n  if (!sessionInstance) {\n    // Extract configuration from OpenClaw API config\n    const appId = typeof config?.PHANTOM_APP_ID === \"string\" ? config.PHANTOM_APP_ID : undefined;\n\n    // Parse callback port - accept both number and numeric string\n    let callbackPort: number | undefined;\n    if (typeof config?.PHANTOM_CALLBACK_PORT === \"number\") {\n      callbackPort = config.PHANTOM_CALLBACK_PORT;\n    } else if (typeof config?.PHANTOM_CALLBACK_PORT === \"string\") {\n      const parsed = parseInt(config.PHANTOM_CALLBACK_PORT, 10);\n      if (!isNaN(parsed) && parsed > 0 && parsed <= 65535) {\n        callbackPort = parsed;\n      }\n    }\n\n    sessionInstance = new PluginSession({\n      appId,\n      callbackPort,\n    });\n  }\n  return sessionInstance;\n}\n\n/**\n * Reset the session singleton (used for cleanup on initialization failure)\n */\nfunction resetSession(): void {\n  sessionInstance = null;\n}\n\n/**\n * Plugin registration function\n */\nexport default async function register(api: OpenClawApi) {\n  try {\n    // Initialize session (authenticate if needed)\n    const session = getSession(api.config);\n    await session.initialize();\n\n    // Register all Phantom MCP tools\n    registerPhantomTools(api, session);\n  } catch (error) {\n    console.error(\"Failed to initialize Phantom OpenClaw plugin:\", error); // eslint-disable-line no-console\n    // Reset singleton so next attempt gets a fresh instance\n    resetSession();\n    throw error;\n  }\n}\n","/**\n * Session management for Phantom OpenClaw plugin\n * Wraps the SessionManager from @phantom/mcp-server\n */\n\nimport { SessionManager } from \"@phantom/mcp-server\";\nimport type { PhantomClient, SessionData } from \"@phantom/mcp-server\";\n\n/**\n * Configuration options for PluginSession\n */\nexport interface PluginSessionOptions {\n  /** Application identifier from Phantom Portal */\n  appId?: string;\n  /** OAuth callback port (default: 8080) */\n  callbackPort?: number;\n  /** Directory to store session data (default: ~/.phantom-mcp) */\n  sessionDir?: string;\n}\n\n/**\n * Plugin session manager\n * Handles authentication and provides access to PhantomClient\n */\nexport class PluginSession {\n  private sessionManager: SessionManager;\n  private initialized = false;\n  private initializingPromise: Promise<void> | null = null;\n\n  constructor(options: PluginSessionOptions = {}) {\n    // Initialize SessionManager with configuration\n    this.sessionManager = new SessionManager({\n      appId: options.appId ?? \"phantom-openclaw\",\n      callbackPort: options.callbackPort,\n      sessionDir: options.sessionDir,\n    });\n  }\n\n  /**\n   * Initialize the session (authenticate if needed)\n   * Thread-safe: concurrent calls will await the same initialization promise\n   */\n  async initialize(): Promise<void> {\n    if (this.initialized) {\n      return;\n    }\n\n    // If already initializing, return the existing promise\n    if (this.initializingPromise) {\n      return this.initializingPromise;\n    }\n\n    // Create and store the initialization promise\n    this.initializingPromise = this.sessionManager\n      .initialize()\n      .then(() => {\n        this.initialized = true;\n      })\n      .catch(error => {\n        // Clear promise on error so subsequent calls can retry\n        this.initializingPromise = null;\n        throw error;\n      });\n\n    return this.initializingPromise;\n  }\n\n  /**\n   * Get the authenticated PhantomClient\n   */\n  getClient(): PhantomClient {\n    if (!this.initialized) {\n      throw new Error(\"Session not initialized. Call initialize() first.\");\n    }\n    return this.sessionManager.getClient();\n  }\n\n  /**\n   * Get the current session data\n   */\n  getSession(): SessionData {\n    if (!this.initialized) {\n      throw new Error(\"Session not initialized. Call initialize() first.\");\n    }\n    return this.sessionManager.getSession();\n  }\n}\n","/**\n * Register Phantom MCP tools as OpenClaw tools\n */\n\nimport { Type } from \"@sinclair/typebox\";\nimport { tools } from \"@phantom/mcp-server\";\nimport type { OpenClawApi } from \"../client/types.js\";\nimport type { PluginSession } from \"../session.js\";\n\n/**\n * Convert MCP tool JSON schema to TypeBox schema\n */\nfunction convertSchema(mcpSchema: any): any {\n  // For now, use Type.Unknown() - we could do more sophisticated conversion\n  return Type.Object(\n    Object.fromEntries(Object.entries(mcpSchema.properties || {}).map(([key, _value]) => [key, Type.Unknown()])),\n  );\n}\n\n/**\n * Register all Phantom MCP tools with OpenClaw\n */\nexport function registerPhantomTools(api: OpenClawApi, session: PluginSession): void {\n  for (const mcpTool of tools) {\n    api.registerTool({\n      name: mcpTool.name,\n      description: mcpTool.description,\n      parameters: convertSchema(mcpTool.inputSchema),\n      async execute(_id: string, params: Record<string, unknown>) {\n        // Create tool context for MCP tool with recursive logger\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const createLogger = (prefix: string): any => ({\n          info: (msg: string) => console.info(`[${prefix}] ${msg}`), // eslint-disable-line no-console\n          error: (msg: string) => console.error(`[${prefix}] ${msg}`), // eslint-disable-line no-console\n          debug: (msg: string) => console.debug(`[${prefix}] ${msg}`), // eslint-disable-line no-console\n          child: (name: string) => createLogger(`${prefix}:${name}`),\n        });\n\n        const context = {\n          client: session.getClient(),\n          session: session.getSession(),\n          logger: createLogger(mcpTool.name),\n        };\n\n        try {\n          // Execute the MCP tool handler\n          const result = await mcpTool.handler(params, context);\n\n          // Return in OpenClaw format with defensive handling for undefined\n          const normalized = result ?? null;\n          return {\n            content: [\n              {\n                type: \"text\" as const,\n                text: typeof normalized === \"string\" ? normalized : JSON.stringify(normalized, null, 2),\n              },\n            ],\n          };\n        } catch (error) {\n          const errorMessage = error instanceof Error ? error.message : String(error);\n          return {\n            content: [\n              {\n                type: \"text\" as const,\n                text: JSON.stringify({ error: errorMessage }, null, 2),\n              },\n            ],\n            isError: true,\n          };\n        }\n      },\n    });\n  }\n}\n"],"mappings":"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","names":["import_mcp_server"]}

package/dist/index.mjs

@@ -0,0 +1,147 @@
+// src/session.ts
+import { SessionManager } from "@phantom/mcp-server";
+var PluginSession = class {
+  constructor(options = {}) {
+    this.initialized = false;
+    this.initializingPromise = null;
+    this.sessionManager = new SessionManager({
+      appId: options.appId ?? "phantom-openclaw",
+      callbackPort: options.callbackPort,
+      sessionDir: options.sessionDir
+    });
+  }
+  /**
+   * Initialize the session (authenticate if needed)
+   * Thread-safe: concurrent calls will await the same initialization promise
+   */
+  async initialize() {
+    if (this.initialized) {
+      return;
+    }
+    if (this.initializingPromise) {
+      return this.initializingPromise;
+    }
+    this.initializingPromise = this.sessionManager.initialize().then(() => {
+      this.initialized = true;
+    }).catch((error) => {
+      this.initializingPromise = null;
+      throw error;
+    });
+    return this.initializingPromise;
+  }
+  /**
+   * Get the authenticated PhantomClient
+   */
+  getClient() {
+    if (!this.initialized) {
+      throw new Error("Session not initialized. Call initialize() first.");
+    }
+    return this.sessionManager.getClient();
+  }
+  /**
+   * Get the current session data
+   */
+  getSession() {
+    if (!this.initialized) {
+      throw new Error("Session not initialized. Call initialize() first.");
+    }
+    return this.sessionManager.getSession();
+  }
+};
+
+// src/tools/register-tools.ts
+import { Type } from "@sinclair/typebox";
+import { tools } from "@phantom/mcp-server";
+function convertSchema(mcpSchema) {
+  return Type.Object(
+    Object.fromEntries(Object.entries(mcpSchema.properties || {}).map(([key, _value]) => [key, Type.Unknown()]))
+  );
+}
+function registerPhantomTools(api, session) {
+  for (const mcpTool of tools) {
+    api.registerTool({
+      name: mcpTool.name,
+      description: mcpTool.description,
+      parameters: convertSchema(mcpTool.inputSchema),
+      async execute(_id, params) {
+        const createLogger = (prefix) => ({
+          info: (msg) => console.info(`[${prefix}] ${msg}`),
+          // eslint-disable-line no-console
+          error: (msg) => console.error(`[${prefix}] ${msg}`),
+          // eslint-disable-line no-console
+          debug: (msg) => console.debug(`[${prefix}] ${msg}`),
+          // eslint-disable-line no-console
+          child: (name) => createLogger(`${prefix}:${name}`)
+        });
+        const context = {
+          client: session.getClient(),
+          session: session.getSession(),
+          logger: createLogger(mcpTool.name)
+        };
+        try {
+          const result = await mcpTool.handler(params, context);
+          const normalized = result ?? null;
+          return {
+            content: [
+              {
+                type: "text",
+                text: typeof normalized === "string" ? normalized : JSON.stringify(normalized, null, 2)
+              }
+            ]
+          };
+        } catch (error) {
+          const errorMessage = error instanceof Error ? error.message : String(error);
+          return {
+            content: [
+              {
+                type: "text",
+                text: JSON.stringify({ error: errorMessage }, null, 2)
+              }
+            ],
+            isError: true
+          };
+        }
+      }
+    });
+  }
+}
+
+// src/index.ts
+var sessionInstance = null;
+function getSession(config) {
+  if (!sessionInstance) {
+    const appId = typeof config?.PHANTOM_APP_ID === "string" ? config.PHANTOM_APP_ID : void 0;
+    let callbackPort;
+    if (typeof config?.PHANTOM_CALLBACK_PORT === "number") {
+      callbackPort = config.PHANTOM_CALLBACK_PORT;
+    } else if (typeof config?.PHANTOM_CALLBACK_PORT === "string") {
+      const parsed = parseInt(config.PHANTOM_CALLBACK_PORT, 10);
+      if (!isNaN(parsed) && parsed > 0 && parsed <= 65535) {
+        callbackPort = parsed;
+      }
+    }
+    sessionInstance = new PluginSession({
+      appId,
+      callbackPort
+    });
+  }
+  return sessionInstance;
+}
+function resetSession() {
+  sessionInstance = null;
+}
+async function register(api) {
+  try {
+    const session = getSession(api.config);
+    await session.initialize();
+    registerPhantomTools(api, session);
+  } catch (error) {
+    console.error("Failed to initialize Phantom OpenClaw plugin:", error);
+    resetSession();
+    throw error;
+  }
+}
+export {
+  register as default
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/session.ts","../src/tools/register-tools.ts","../src/index.ts"],"sourcesContent":["/**\n * Session management for Phantom OpenClaw plugin\n * Wraps the SessionManager from @phantom/mcp-server\n */\n\nimport { SessionManager } from \"@phantom/mcp-server\";\nimport type { PhantomClient, SessionData } from \"@phantom/mcp-server\";\n\n/**\n * Configuration options for PluginSession\n */\nexport interface PluginSessionOptions {\n  /** Application identifier from Phantom Portal */\n  appId?: string;\n  /** OAuth callback port (default: 8080) */\n  callbackPort?: number;\n  /** Directory to store session data (default: ~/.phantom-mcp) */\n  sessionDir?: string;\n}\n\n/**\n * Plugin session manager\n * Handles authentication and provides access to PhantomClient\n */\nexport class PluginSession {\n  private sessionManager: SessionManager;\n  private initialized = false;\n  private initializingPromise: Promise<void> | null = null;\n\n  constructor(options: PluginSessionOptions = {}) {\n    // Initialize SessionManager with configuration\n    this.sessionManager = new SessionManager({\n      appId: options.appId ?? \"phantom-openclaw\",\n      callbackPort: options.callbackPort,\n      sessionDir: options.sessionDir,\n    });\n  }\n\n  /**\n   * Initialize the session (authenticate if needed)\n   * Thread-safe: concurrent calls will await the same initialization promise\n   */\n  async initialize(): Promise<void> {\n    if (this.initialized) {\n      return;\n    }\n\n    // If already initializing, return the existing promise\n    if (this.initializingPromise) {\n      return this.initializingPromise;\n    }\n\n    // Create and store the initialization promise\n    this.initializingPromise = this.sessionManager\n      .initialize()\n      .then(() => {\n        this.initialized = true;\n      })\n      .catch(error => {\n        // Clear promise on error so subsequent calls can retry\n        this.initializingPromise = null;\n        throw error;\n      });\n\n    return this.initializingPromise;\n  }\n\n  /**\n   * Get the authenticated PhantomClient\n   */\n  getClient(): PhantomClient {\n    if (!this.initialized) {\n      throw new Error(\"Session not initialized. Call initialize() first.\");\n    }\n    return this.sessionManager.getClient();\n  }\n\n  /**\n   * Get the current session data\n   */\n  getSession(): SessionData {\n    if (!this.initialized) {\n      throw new Error(\"Session not initialized. Call initialize() first.\");\n    }\n    return this.sessionManager.getSession();\n  }\n}\n","/**\n * Register Phantom MCP tools as OpenClaw tools\n */\n\nimport { Type } from \"@sinclair/typebox\";\nimport { tools } from \"@phantom/mcp-server\";\nimport type { OpenClawApi } from \"../client/types.js\";\nimport type { PluginSession } from \"../session.js\";\n\n/**\n * Convert MCP tool JSON schema to TypeBox schema\n */\nfunction convertSchema(mcpSchema: any): any {\n  // For now, use Type.Unknown() - we could do more sophisticated conversion\n  return Type.Object(\n    Object.fromEntries(Object.entries(mcpSchema.properties || {}).map(([key, _value]) => [key, Type.Unknown()])),\n  );\n}\n\n/**\n * Register all Phantom MCP tools with OpenClaw\n */\nexport function registerPhantomTools(api: OpenClawApi, session: PluginSession): void {\n  for (const mcpTool of tools) {\n    api.registerTool({\n      name: mcpTool.name,\n      description: mcpTool.description,\n      parameters: convertSchema(mcpTool.inputSchema),\n      async execute(_id: string, params: Record<string, unknown>) {\n        // Create tool context for MCP tool with recursive logger\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const createLogger = (prefix: string): any => ({\n          info: (msg: string) => console.info(`[${prefix}] ${msg}`), // eslint-disable-line no-console\n          error: (msg: string) => console.error(`[${prefix}] ${msg}`), // eslint-disable-line no-console\n          debug: (msg: string) => console.debug(`[${prefix}] ${msg}`), // eslint-disable-line no-console\n          child: (name: string) => createLogger(`${prefix}:${name}`),\n        });\n\n        const context = {\n          client: session.getClient(),\n          session: session.getSession(),\n          logger: createLogger(mcpTool.name),\n        };\n\n        try {\n          // Execute the MCP tool handler\n          const result = await mcpTool.handler(params, context);\n\n          // Return in OpenClaw format with defensive handling for undefined\n          const normalized = result ?? null;\n          return {\n            content: [\n              {\n                type: \"text\" as const,\n                text: typeof normalized === \"string\" ? normalized : JSON.stringify(normalized, null, 2),\n              },\n            ],\n          };\n        } catch (error) {\n          const errorMessage = error instanceof Error ? error.message : String(error);\n          return {\n            content: [\n              {\n                type: \"text\" as const,\n                text: JSON.stringify({ error: errorMessage }, null, 2),\n              },\n            ],\n            isError: true,\n          };\n        }\n      },\n    });\n  }\n}\n","/**\n * Phantom OpenClaw Plugin\n *\n * Integrates Phantom wallet operations directly with OpenClaw agents\n * by wrapping the Phantom MCP Server tools.\n */\n\nimport type { OpenClawApi } from \"./client/types.js\";\nimport { PluginSession } from \"./session.js\";\nimport { registerPhantomTools } from \"./tools/register-tools.js\";\n\n// Singleton session instance\nlet sessionInstance: PluginSession | null = null;\n\n/**\n * Get or create the plugin session with configuration\n */\nfunction getSession(config?: Record<string, unknown>): PluginSession {\n  if (!sessionInstance) {\n    // Extract configuration from OpenClaw API config\n    const appId = typeof config?.PHANTOM_APP_ID === \"string\" ? config.PHANTOM_APP_ID : undefined;\n\n    // Parse callback port - accept both number and numeric string\n    let callbackPort: number | undefined;\n    if (typeof config?.PHANTOM_CALLBACK_PORT === \"number\") {\n      callbackPort = config.PHANTOM_CALLBACK_PORT;\n    } else if (typeof config?.PHANTOM_CALLBACK_PORT === \"string\") {\n      const parsed = parseInt(config.PHANTOM_CALLBACK_PORT, 10);\n      if (!isNaN(parsed) && parsed > 0 && parsed <= 65535) {\n        callbackPort = parsed;\n      }\n    }\n\n    sessionInstance = new PluginSession({\n      appId,\n      callbackPort,\n    });\n  }\n  return sessionInstance;\n}\n\n/**\n * Reset the session singleton (used for cleanup on initialization failure)\n */\nfunction resetSession(): void {\n  sessionInstance = null;\n}\n\n/**\n * Plugin registration function\n */\nexport default async function register(api: OpenClawApi) {\n  try {\n    // Initialize session (authenticate if needed)\n    const session = getSession(api.config);\n    await session.initialize();\n\n    // Register all Phantom MCP tools\n    registerPhantomTools(api, session);\n  } catch (error) {\n    console.error(\"Failed to initialize Phantom OpenClaw plugin:\", error); // eslint-disable-line no-console\n    // Reset singleton so next attempt gets a fresh instance\n    resetSession();\n    throw error;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phantom/openclaw-plugin",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "OpenClaw plugin that bridges tool calls to Phantom's MCP server for wallet operations.",
   "repository": {
     "type": "git",
@@ -41,7 +41,7 @@
     "typescript": "^5.0.4"
   },
   "dependencies": {
-    "@phantom/mcp-server": "workspace:^",
+    "@phantom/mcp-server": "^0.1.2",
     "@sinclair/typebox": "^0.32.0"
   },
   "files": [
@@ -52,4 +52,4 @@
   "publishConfig": {
     "directory": "_release/package"
   }
-}
+}