@agentlayer.tech/wallet 0.1.28 → 0.1.30

package/claude-code/plugins/agent-wallet/README.md

@@ -0,0 +1,65 @@
+# Agent Wallet Claude Code Plugin
+
+This plugin adds the existing local AgentLayer wallet runtime to Claude Code.
+
+It does not create a new wallet. It reuses the current runtime under:
+
+```bash
+~/.openclaw/agent-wallet-runtime/current/agent-wallet
+```
+
+Primary design rules:
+
+- keep wallet policy, approvals, and signing in `agent-wallet/`
+- keep this plugin as a thin MCP bridge for Claude Code
+- reuse the same wallets, networks, and tool surface already used by OpenClaw, Hermes, and Codex
+- avoid secrets in plugin config or marketplace metadata
+
+## What it exposes
+
+- direct wallet tools for Solana, Bitcoin, and EVM (same surface as OpenClaw and Codex)
+- session wallet selection with `set_wallet_backend`
+- EVM network selection with `set_evm_network`
+- auto-managed approval binding for `preview -> execute` write flows
+
+## Runtime requirements
+
+- install the AgentLayer runtime first with `npx @agentlayer.tech/wallet install --yes`
+- keep the local wallet files and `~/.openclaw/sealed_keys.json` in place
+- run `npx @agentlayer.tech/wallet claude-code install --yes` to register this plugin
+
+## Installation
+
+### Automated (recommended)
+
+```bash
+npx @agentlayer.tech/wallet install --yes
+npx @agentlayer.tech/wallet claude-code install --yes
+```
+
+### Manual
+
+```bash
+# Load for a single session (dev / testing)
+claude --plugin-dir /path/to/claude-code/plugins/agent-wallet
+
+# Or install permanently via Claude Code:
+# 1. Open Claude Code
+# 2. Run /plugin and point it at this directory
+```
+
+## Path resolution
+
+The bridge resolves the wallet runtime from:
+
+1. `AGENT_WALLET_PACKAGE_ROOT`
+2. `OPENCLAW_AGENT_WALLET_PACKAGE_ROOT`
+3. `~/.openclaw/agent-wallet-runtime/current/agent-wallet`
+
+If the runtime lives elsewhere, set one of the env overrides before starting Claude Code.
+
+## MCP server
+
+The plugin launches an MCP server via `scripts/run_mcp.sh`, which runs the same
+`server.py` FastMCP bridge used by the Codex plugin. `${CLAUDE_PLUGIN_ROOT}` is
+substituted by Claude Code at plugin load time.

package/claude-code/plugins/agent-wallet/scripts/run_mcp.sh

@@ -0,0 +1,34 @@
+#!/bin/sh
+set -eu
+
+SCRIPT_DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+PLUGIN_ROOT=$(CDPATH= cd -- "$SCRIPT_DIR/.." && pwd)
+OPENCLAW_HOME=${OPENCLAW_HOME:-"$HOME/.openclaw"}
+PACKAGE_ROOT=${AGENT_WALLET_PACKAGE_ROOT:-${OPENCLAW_AGENT_WALLET_PACKAGE_ROOT:-"$OPENCLAW_HOME/agent-wallet-runtime/current/agent-wallet"}}
+
+# Resolve server.py: check sibling codex plugin (same npm package), then local copy
+CODEX_SERVER="$PLUGIN_ROOT/../../codex/plugins/agent-wallet/server.py"
+LOCAL_SERVER="$PLUGIN_ROOT/server.py"
+
+if [ -f "$LOCAL_SERVER" ]; then
+  SERVER_PY="$LOCAL_SERVER"
+elif [ -f "$CODEX_SERVER" ]; then
+  SERVER_PY=$(CDPATH= cd -- "$PLUGIN_ROOT/../../codex/plugins/agent-wallet" && pwd)/server.py
+else
+  printf '{"error":"agent-wallet server.py not found. Run: npx @agentlayer.tech/wallet install --yes"}\n' >&2
+  exit 1
+fi
+
+if [ -n "${AGENT_WALLET_PYTHON:-}" ]; then
+  PYTHON_BIN=$AGENT_WALLET_PYTHON
+elif [ -n "${OPENCLAW_AGENT_WALLET_PYTHON:-}" ]; then
+  PYTHON_BIN=$OPENCLAW_AGENT_WALLET_PYTHON
+elif [ -x "$PACKAGE_ROOT/.venv/bin/python" ]; then
+  PYTHON_BIN=$PACKAGE_ROOT/.venv/bin/python
+elif [ -x "$PACKAGE_ROOT/.runtime-venv/bin/python" ]; then
+  PYTHON_BIN=$PACKAGE_ROOT/.runtime-venv/bin/python
+else
+  PYTHON_BIN=python3
+fi
+
+exec "$PYTHON_BIN" "$SERVER_PY"

package/claude-code/plugins/agent-wallet/skills/wallet-operator/SKILL.md

@@ -0,0 +1,18 @@
+---
+description: "Use when the user asks Claude Code to interact with the local AgentLayer wallet runtime: check balances, transfer tokens, swap, DeFi operations, or x402 payments. Prefer wallet tools over shell commands. Preview writes first and execute only after explicit user confirmation."
+---
+
+# Agent Wallet Operator
+
+Use this skill when the user wants Claude Code to work with the existing local AgentLayer wallet.
+
+Rules:
+
+- Do not create a new wallet unless the user explicitly requests wallet provisioning.
+- Prefer wallet tools over shelling out to chain CLIs, curl, or ad hoc scripts.
+- For writes, start with `preview` or `intent_preview` when the tool supports it.
+- Execute only after the user explicitly confirms the shown summary.
+- On mainnet, restate the network, asset, amount, and destination before execute.
+- Do not ask the user for `approval_token`. The bridge manages approval binding internally.
+- If approval context is missing or stale, repeat preview instead of improvising.
+- Use `set_wallet_backend` to switch between Solana, EVM, and Bitcoin wallets within a session.

package/codex/plugins/agent-wallet/.codex-plugin/plugin.json

@@ -0,0 +1,38 @@
+{
+  "name": "agent-wallet",
+  "version": "0.1.0",
+  "description": "Codex plugin bridge for the AgentLayer wallet runtime.",
+  "author": {
+    "name": "AgentLayer"
+  },
+  "homepage": "https://github.com/lopushok9/Agent-Layer",
+  "repository": "https://github.com/lopushok9/Agent-Layer",
+  "license": "SEE LICENSE IN ../../../LICENSE",
+  "keywords": [
+    "codex",
+    "wallet",
+    "solana",
+    "bitcoin",
+    "evm",
+    "agentlayer"
+  ],
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json",
+  "interface": {
+    "displayName": "Agent Wallet",
+    "shortDescription": "Use the local AgentLayer wallet runtime directly in Codex",
+    "longDescription": "Agent Wallet adds the existing local AgentLayer wallet runtime to Codex without creating a new wallet. It reuses the current OpenClaw runtime, keeps secrets local, and exposes the same Solana, Bitcoin, EVM, x402, Jupiter, Kamino, LI.FI, Bags, and Flash Trade tool surface through a Codex-native MCP bridge.",
+    "developerName": "AgentLayer",
+    "category": "Coding",
+    "capabilities": [
+      "Interactive",
+      "Read",
+      "Write"
+    ],
+    "websiteURL": "https://github.com/lopushok9/Agent-Layer",
+    "privacyPolicyURL": "https://openai.com/policies/privacy-policy/",
+    "termsOfServiceURL": "https://openai.com/policies/terms-of-use/",
+    "defaultPrompt": "Use my existing AgentLayer wallet here in Codex, preview wallet writes first, and execute only after explicit confirmation.",
+    "brandColor": "#0F766E"
+  }
+}

package/codex/plugins/agent-wallet/.mcp.json

@@ -0,0 +1,15 @@
+{
+  "mcpServers": {
+    "agent-wallet": {
+      "command": "sh",
+      "args": [
+        "-lc",
+        "exec \"${AGENT_WALLET_CODEX_PLUGIN_ROOT:-$HOME/plugins}/agent-wallet/scripts/run_mcp.sh\""
+      ],
+      "env": {
+        "FASTMCP_SHOW_SERVER_BANNER": "false",
+        "FASTMCP_LOG_LEVEL": "ERROR"
+      }
+    }
+  }
+}

package/codex/plugins/agent-wallet/README.md

@@ -0,0 +1,39 @@
+# Agent Wallet Codex Plugin
+
+This plugin adds the existing local AgentLayer wallet runtime to Codex.
+
+It does not create a new wallet. It reuses the current runtime under:
+
+```bash
+~/.openclaw/agent-wallet-runtime/current/agent-wallet
+```
+
+Primary design rules:
+
+- keep wallet policy, approvals, and signing in `agent-wallet/`
+- keep this plugin as a thin MCP bridge for Codex
+- reuse the same wallets, networks, and tool surface already used by OpenClaw and Hermes
+- avoid secrets in plugin config or marketplace metadata
+
+## What it exposes
+
+- direct wallet tools for Solana, Bitcoin, and EVM
+- session wallet selection with `set_wallet_backend`
+- EVM network selection with `set_evm_network`
+- auto-managed approval binding for `preview -> execute` write flows
+
+## Runtime requirements
+
+- install the AgentLayer runtime first with `npx @agentlayer.tech/wallet install --yes`
+- keep the local wallet files and `~/.openclaw/sealed_keys.json` in place
+- use `wallet codex install --yes` to install this plugin into Codex
+
+## Path resolution
+
+The bridge resolves the wallet runtime from:
+
+1. `AGENT_WALLET_PACKAGE_ROOT`
+2. `OPENCLAW_AGENT_WALLET_PACKAGE_ROOT`
+3. `~/.openclaw/agent-wallet-runtime/current/agent-wallet`
+
+If the runtime lives elsewhere, set one of the env overrides before starting Codex.

package/codex/plugins/agent-wallet/scripts/run_mcp.sh

@@ -0,0 +1,21 @@
+#!/bin/sh
+set -eu
+
+SCRIPT_DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+PLUGIN_ROOT=$(CDPATH= cd -- "$SCRIPT_DIR/.." && pwd)
+OPENCLAW_HOME=${OPENCLAW_HOME:-"$HOME/.openclaw"}
+PACKAGE_ROOT=${AGENT_WALLET_PACKAGE_ROOT:-${OPENCLAW_AGENT_WALLET_PACKAGE_ROOT:-"$OPENCLAW_HOME/agent-wallet-runtime/current/agent-wallet"}}
+
+if [ -n "${AGENT_WALLET_PYTHON:-}" ]; then
+  PYTHON_BIN=$AGENT_WALLET_PYTHON
+elif [ -n "${OPENCLAW_AGENT_WALLET_PYTHON:-}" ]; then
+  PYTHON_BIN=$OPENCLAW_AGENT_WALLET_PYTHON
+elif [ -x "$PACKAGE_ROOT/.venv/bin/python" ]; then
+  PYTHON_BIN=$PACKAGE_ROOT/.venv/bin/python
+elif [ -x "$PACKAGE_ROOT/.runtime-venv/bin/python" ]; then
+  PYTHON_BIN=$PACKAGE_ROOT/.runtime-venv/bin/python
+else
+  PYTHON_BIN=python3
+fi
+
+exec "$PYTHON_BIN" "$PLUGIN_ROOT/server.py"