@agentlayer.tech/wallet 0.1.27 → 0.1.30

package/.openclaw/extensions/agent-wallet/README.md

@@ -79,7 +79,7 @@ If that runtime is not present, set `plugins.entries.agent-wallet.config.package
 
 That installs the Python backend, Node dependencies for the local BTC/EVM runtimes, patches the OpenClaw plugin config, and provisions the first encrypted per-user Solana mainnet wallet when no explicit signer is already configured. EVM readiness can still be auto-healed during normal wallet switching when the runtime has sealed local vault credentials.
 
-For self-hosted installs, prefer `SOLANA_RPC_URL` / `SOLANA_RPC_URLS` in local env and treat the plugin `rpcUrl` / `rpcUrls` fields as fallback only. If the local runtime exposes `ALCHEMY_API_KEY` or `HELIUS_API_KEY`, the wallet can derive the Solana RPC URL automatically for `mainnet` or `devnet`. Local env always takes precedence over `openclaw.json`.
+For self-hosted installs, prefer `SOLANA_RPC_URL` / `SOLANA_RPC_URLS` in local env and treat the plugin `rpcUrl` / `rpcUrls` fields as fallback only. If the local runtime exposes `ALCHEMY_API_KEY` or `HELIUS_API_KEY`, the wallet can derive the Solana RPC URL automatically for `mainnet`. Local env always takes precedence over `openclaw.json`.
 
 Provide only `AGENT_WALLET_BOOT_KEY` to the runtime. Provision `master_key`, `approval_secret`, and any signer `private_key` into `sealed_keys.json`, not `openclaw.json`.
 
@@ -134,14 +134,13 @@ For staking specifically, the normal agent flow should be:
 
 The extension is already network-aware:
 
-- `plugins.entries.agent-wallet.config.network` selects `mainnet`, `devnet`, or `testnet`
-- each network uses a separate wallet file for the same `userId`
-- switching networks does not merge balances across clusters
+- `plugins.entries.agent-wallet.config.network` selects `mainnet` for Solana, `bitcoin` for BTC, or the supported EVM networks
+- Solana mainnet wallets keep the same per-user file layout
+- switching the configured backend network does not merge balances across chains
 
 Recommended local switch helper:
 
 ```bash
-python agent-wallet/scripts/switch_openclaw_wallet_network.py --network devnet
 python agent-wallet/scripts/switch_openclaw_wallet_network.py --network mainnet
 ```
 

package/.openclaw/extensions/agent-wallet/dist/index.js

@@ -308,13 +308,15 @@ function normalizeEvmNetwork(value) {
     eth: "ethereum",
     "eth-mainnet": "ethereum",
     "base-mainnet": "base",
-    base_sepolia: "base-sepolia",
   };
   return aliases[normalized] || normalized;
 }
 
 function normalizeSelectableEvmNetwork(value) {
   const network = normalizeEvmNetwork(value);
+  if (["sepolia", "base-sepolia", "base_sepolia"].includes(network)) {
+    throw new Error("EVM testnets are no longer supported. Use ethereum or base.");
+  }
   if (!["ethereum", "base"].includes(network)) {
     throw new Error("EVM network must be 'ethereum' or 'base'.");
   }
@@ -331,8 +333,11 @@ function normalizeSolanaNetwork(value) {
     "mainnet-beta": "mainnet",
   };
   const normalized = aliases[network] || network;
-  if (!["mainnet", "devnet", "testnet"].includes(normalized)) {
-    throw new Error("Solana network must be mainnet, devnet, or testnet.");
+  if (["devnet", "testnet"].includes(normalized)) {
+    throw new Error("Solana devnet/testnet are no longer supported. Use mainnet.");
+  }
+  if (normalized !== "mainnet") {
+    throw new Error("Solana network must be mainnet.");
   }
   return normalized;
 }
@@ -347,8 +352,11 @@ function normalizeBtcNetwork(value) {
     mainnet: "bitcoin",
   };
   const normalized = aliases[network] || network;
-  if (!["bitcoin", "testnet", "regtest"].includes(normalized)) {
-    throw new Error("Bitcoin network must be bitcoin, testnet, or regtest.");
+  if (["testnet", "regtest"].includes(normalized)) {
+    throw new Error("Bitcoin testnet/regtest are no longer supported. Use bitcoin.");
+  }
+  if (normalized !== "bitcoin") {
+    throw new Error("Bitcoin network must be bitcoin.");
   }
   return normalized;
 }
@@ -399,7 +407,6 @@ function inferBackendForTool(toolName) {
     toolName === "transfer_spl_token" ||
     toolName === "sign_wallet_message" ||
     toolName === "close_empty_token_accounts" ||
-    toolName === "request_devnet_airdrop" ||
     toolName === "get_wallet_portfolio" ||
     toolName === "get_solana_token_prices"
   ) {
@@ -956,7 +963,7 @@ const walletSessionToolDefinitions = [
   {
     name: "x402_pay_request",
     description:
-      `Prepare or execute an x402 paid request using the active wallet backend. This milestone executes the Solana exact buyer flow and keeps EVM as prepare-only. ${OPENCLAW_EXECUTE_APPROVAL_GUIDANCE}`,
+      "Pay for and call an x402 endpoint using the active wallet backend. The tool probes the endpoint, validates compatibility, signs the payment, and returns the service response in one call.",
     parameters: {
       type: "object",
       properties: {
@@ -966,18 +973,9 @@ const walletSessionToolDefinitions = [
         query: { type: "object", additionalProperties: true },
         json_body: {},
         text_body: { type: "string" },
-        mode: {
-          type: "string",
-          enum: ["prepare", "execute"],
-          description: "prepare validates the payment plan; execute sends the paid retry.",
-        },
         purpose: { type: "string" },
-        user_intent: {
-          type: "boolean",
-          description: "Must be true for prepare mode.",
-        },
       },
-      required: ["url", "mode", "purpose"],
+      required: ["url", "purpose"],
       additionalProperties: false,
     },
   },
@@ -1000,7 +998,7 @@ const walletSessionToolDefinitions = [
         },
         network: {
           type: "string",
-          description: "Optional network for the selected wallet. Examples: mainnet, devnet, ethereum, base, bitcoin, testnet.",
+          description: "Optional network for the selected wallet. Examples: mainnet, ethereum, base, bitcoin.",
         },
       },
       required: ["backend"],
@@ -1278,6 +1276,21 @@ const solanaToolDefinitions = [
       additionalProperties: false,
     },
   },
+  {
+    name: "get_kamino_open_positions",
+    description:
+      "Get all open Kamino lending positions for a Solana wallet on mainnet, aggregated across markets with loan details, reserve APYs, and rewards.",
+    parameters: {
+      type: "object",
+      properties: {
+        user: {
+          type: "string",
+          description: "Optional Solana wallet address override.",
+        },
+      },
+      additionalProperties: false,
+    },
+  },
   {
     name: "sign_wallet_message",
     description: "Sign an arbitrary message with the connected wallet after explicit user confirmation in chat.",
@@ -1692,19 +1705,6 @@ const solanaToolDefinitions = [
       additionalProperties: false,
     },
   },
-  {
-    name: "request_devnet_airdrop",
-    description: "Request devnet or testnet SOL from the faucet.",
-    optional: true,
-    parameters: {
-      type: "object",
-      properties: {
-        amount: { type: "number" },
-      },
-      required: ["amount"],
-      additionalProperties: false,
-    },
-  },
 ];
 
 const btcToolDefinitions = [

package/.openclaw/extensions/agent-wallet/index.ts

@@ -308,13 +308,15 @@ function normalizeEvmNetwork(value) {
     eth: "ethereum",
     "eth-mainnet": "ethereum",
     "base-mainnet": "base",
-    base_sepolia: "base-sepolia",
   };
   return aliases[normalized] || normalized;
 }
 
 function normalizeSelectableEvmNetwork(value) {
   const network = normalizeEvmNetwork(value);
+  if (["sepolia", "base-sepolia", "base_sepolia"].includes(network)) {
+    throw new Error("EVM testnets are no longer supported. Use ethereum or base.");
+  }
   if (!["ethereum", "base"].includes(network)) {
     throw new Error("EVM network must be 'ethereum' or 'base'.");
   }
@@ -331,8 +333,11 @@ function normalizeSolanaNetwork(value) {
     "mainnet-beta": "mainnet",
   };
   const normalized = aliases[network] || network;
-  if (!["mainnet", "devnet", "testnet"].includes(normalized)) {
-    throw new Error("Solana network must be mainnet, devnet, or testnet.");
+  if (["devnet", "testnet"].includes(normalized)) {
+    throw new Error("Solana devnet/testnet are no longer supported. Use mainnet.");
+  }
+  if (normalized !== "mainnet") {
+    throw new Error("Solana network must be mainnet.");
   }
   return normalized;
 }
@@ -347,8 +352,11 @@ function normalizeBtcNetwork(value) {
     mainnet: "bitcoin",
   };
   const normalized = aliases[network] || network;
-  if (!["bitcoin", "testnet", "regtest"].includes(normalized)) {
-    throw new Error("Bitcoin network must be bitcoin, testnet, or regtest.");
+  if (["testnet", "regtest"].includes(normalized)) {
+    throw new Error("Bitcoin testnet/regtest are no longer supported. Use bitcoin.");
+  }
+  if (normalized !== "bitcoin") {
+    throw new Error("Bitcoin network must be bitcoin.");
   }
   return normalized;
 }
@@ -399,7 +407,6 @@ function inferBackendForTool(toolName) {
     toolName === "transfer_spl_token" ||
     toolName === "sign_wallet_message" ||
     toolName === "close_empty_token_accounts" ||
-    toolName === "request_devnet_airdrop" ||
     toolName === "get_wallet_portfolio" ||
     toolName === "get_solana_token_prices"
   ) {
@@ -956,7 +963,7 @@ const walletSessionToolDefinitions = [
   {
     name: "x402_pay_request",
     description:
-      `Prepare or execute an x402 paid request using the active wallet backend. This milestone executes the Solana exact buyer flow and keeps EVM as prepare-only. ${OPENCLAW_EXECUTE_APPROVAL_GUIDANCE}`,
+      "Pay for and call an x402 endpoint using the active wallet backend. The tool probes the endpoint, validates compatibility, signs the payment, and returns the service response in one call.",
     parameters: {
       type: "object",
       properties: {
@@ -966,18 +973,9 @@ const walletSessionToolDefinitions = [
         query: { type: "object", additionalProperties: true },
         json_body: {},
         text_body: { type: "string" },
-        mode: {
-          type: "string",
-          enum: ["prepare", "execute"],
-          description: "prepare validates the payment plan; execute sends the paid retry.",
-        },
         purpose: { type: "string" },
-        user_intent: {
-          type: "boolean",
-          description: "Must be true for prepare mode.",
-        },
       },
-      required: ["url", "mode", "purpose"],
+      required: ["url", "purpose"],
       additionalProperties: false,
     },
   },
@@ -1000,7 +998,7 @@ const walletSessionToolDefinitions = [
         },
         network: {
           type: "string",
-          description: "Optional network for the selected wallet. Examples: mainnet, devnet, ethereum, base, bitcoin, testnet.",
+          description: "Optional network for the selected wallet. Examples: mainnet, ethereum, base, bitcoin.",
         },
       },
       required: ["backend"],
@@ -1278,6 +1276,21 @@ const solanaToolDefinitions = [
       additionalProperties: false,
     },
   },
+  {
+    name: "get_kamino_open_positions",
+    description:
+      "Get all open Kamino lending positions for a Solana wallet on mainnet, aggregated across markets with loan details, reserve APYs, and rewards.",
+    parameters: {
+      type: "object",
+      properties: {
+        user: {
+          type: "string",
+          description: "Optional Solana wallet address override.",
+        },
+      },
+      additionalProperties: false,
+    },
+  },
   {
     name: "sign_wallet_message",
     description: "Sign an arbitrary message with the connected wallet after explicit user confirmation in chat.",
@@ -1692,19 +1705,6 @@ const solanaToolDefinitions = [
       additionalProperties: false,
     },
   },
-  {
-    name: "request_devnet_airdrop",
-    description: "Request devnet or testnet SOL from the faucet.",
-    optional: true,
-    parameters: {
-      type: "object",
-      properties: {
-        amount: { type: "number" },
-      },
-      required: ["amount"],
-      additionalProperties: false,
-    },
-  },
 ];
 
 const btcToolDefinitions = [

package/.openclaw/extensions/agent-wallet/openclaw.plugin.json

@@ -35,6 +35,7 @@
       "get_jupiter_earn_tokens",
       "get_kamino_lend_market_reserves",
       "get_kamino_lend_markets",
+      "get_kamino_open_positions",
       "get_kamino_lend_user_obligations",
       "get_kamino_lend_user_rewards",
       "get_lifi_quote",
@@ -57,7 +58,6 @@
       "manage_evm_aave_position",
       "manage_evm_lido_position",
       "manage_evm_lido_withdrawal",
-      "request_devnet_airdrop",
       "set_evm_network",
       "set_wallet_backend",
       "sign_wallet_message",
@@ -92,7 +92,7 @@
       },
       "network": {
         "type": "string",
-        "description": "Backend network selector. Solana uses mainnet/devnet/testnet. BTC uses bitcoin/testnet/regtest. EVM uses ethereum/sepolia/base/base-sepolia."
+        "description": "Backend network selector. Solana uses mainnet. BTC uses bitcoin. EVM uses ethereum/base."
       },
       "wdkBtcServiceUrl": {
         "type": "string",

package/.openclaw/extensions/agent-wallet/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentlayertech/agent-wallet-plugin",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "description": "OpenClaw plugin bridge for the AgentLayer wallet runtime.",
   "type": "module",
   "license": "SEE LICENSE IN ../../../LICENSE",

package/CHANGELOG.md

@@ -2,6 +2,58 @@
 
 ## Unreleased
 
+## v0.1.30 - 2026-05-30
+
+- Added a Claude Code plugin bridge under `claude-code/plugins/agent-wallet` so
+  the existing local wallet runtime can be used directly inside Claude Code
+  without creating a new wallet.
+- The Claude Code bridge connects to the current `~/.openclaw` runtime and
+  reuses the same Solana, Bitcoin, and EVM wallet surface already used by
+  OpenClaw, Hermes, and Codex.
+- Added `wallet claude-code install --yes`, which symlinks the bundled Claude
+  Code plugin into `~/.claude/plugins/agent-wallet` and attempts to register it
+  via the Claude Code CLI.
+- Fixed the `smoke_install_from_github` test, which was failing because
+  `setup.sh` checks for the Codex plugin manifest but the test bundle never
+  created that path.
+- Added the Claude Code plugin manifest check to `setup.sh` so bundle integrity
+  is validated for both the Codex and Claude Code plugin surfaces.
+
+## v0.1.29 - 2026-05-29
+
+- Added a new `Codex` plugin bridge under `codex/plugins/agent-wallet` so the
+  existing local wallet runtime can be used directly inside Codex without
+  creating a second wallet.
+- Kept the Codex bridge non-custodial and additive: it reuses the current
+  `agent-wallet` runtime, existing wallets, and the current tool surface
+  instead of replacing OpenClaw or Hermes.
+- Added `wallet codex install --yes`, which links the bundled Codex plugin into
+  the standard local plugin marketplace path and can ask Codex to install the
+  plugin from that local marketplace.
+- Added `get_kamino_open_positions`, which aggregates the wallet's Kamino
+  positions across markets with loan details, reserve APYs, and rewards.
+- Removed Solana devnet/testnet support from the wallet runtime, host bridges,
+  and local helper scripts so the supported Solana surface is now mainnet-only.
+- Removed EVM testnet support from the wallet runtime and host bridges so the
+  supported EVM surface is now `ethereum` and `base` mainnet only.
+- Removed Bitcoin `testnet` and `regtest` support from the wallet runtime,
+  host bridges, and local helper scripts so the supported BTC surface is now
+  `bitcoin` mainnet only.
+
+## v0.1.28 - 2026-05-28
+
+- Simplified `x402_pay_request` into a single-shot paid execution flow while
+  keeping `x402_preview_request` as an optional research tool.
+- Hardened x402 execution with explicit payment requirement validation, longer
+  paid-request timeouts, structured settlement logging, and safer settlement
+  header parsing.
+- Fixed Base x402 EVM signing by normalizing typed-data byte fields before
+  sending them through the local WDK signer bridge.
+- Reduced x402 preview confusion in OpenClaw by exposing a payment summary
+  without approval-token style confirmation semantics.
+- Added an early safety guard for `x402.alchemy.com` so unsupported wallet-auth
+  flows fail before spending funds.
+
 ## v0.1.27 - 2026-05-27
 
 - Improved Solana swap fallback landing by enabling Jupiter dynamic slippage

package/README.md

@@ -16,6 +16,12 @@ For Hermes:
 npx @agentlayer.tech/wallet install --yes && npx @agentlayer.tech/wallet hermes install --yes
 ```
 
+For Codex:
+
+```bash
+npx @agentlayer.tech/wallet install --yes && npx @agentlayer.tech/wallet codex install --yes
+```
+
 AgentLayer is a beta local-first wallet and finance stack for agents.
 
 The repository includes:
@@ -23,6 +29,7 @@ The repository includes:
 - `agent-wallet/` - the main wallet backend for AgentLayer
 - `.openclaw/` - the local AgentLayer bridge layer for the OpenClaw wallet integration
 - `hermes/` - optional Hermes Agent plugin bridge for the same wallet backend
+- `codex/` - optional Codex plugin bridge for the same wallet backend
 - `wdk-btc-wallet/` - the local Bitcoin wallet service
 - `wdk-evm-wallet/` - the local EVM wallet service
 - `provider-gateway/` - shared provider access for Solana RPC, Bags, and related finance reads
@@ -84,6 +91,7 @@ Useful npm CLI commands:
 wallet status
 wallet doctor
 wallet hermes install --yes
+wallet codex install --yes
 wallet update --yes
 wallet update --yes --dry-run
 wallet rollback
@@ -200,6 +208,7 @@ Kamino integration gives the wallet a structured Solana lending surface:
 - `get_kamino_lend_market_reserves` - inspect reserve metrics for one Kamino market.
 - `get_kamino_lend_user_obligations` - inspect the wallet's obligations inside a Kamino market.
 - `get_kamino_lend_user_rewards` - fetch the wallet's Kamino rewards summary.
+- `get_kamino_open_positions` - aggregate all open Kamino positions across markets with loan details, reserve APYs, and rewards.
 - `kamino_lend_deposit` - preview, prepare, or execute a lending deposit.
 - `kamino_lend_withdraw` - preview, prepare, or execute a lending withdrawal.
 - `kamino_lend_borrow` - preview, prepare, or execute a borrow.

package/agent-wallet/README.md

@@ -26,7 +26,7 @@ It provides:
 - runtime instructions for safe wallet usage
 - a single `invoke()` method for safe dispatch
 - OpenClaw-style plugin manifest and skill bundle
-- explicit network-aware results so the host and agent can see `devnet` vs `mainnet`
+- explicit network-aware results so the host and agent can see the active chain network
 
 ## Hermes integration
 
@@ -98,6 +98,7 @@ Current safe tools:
 - `get_kamino_lend_market_reserves`
 - `get_kamino_lend_user_obligations`
 - `get_kamino_lend_user_rewards`
+- `get_kamino_open_positions`
 - `jupiter_earn_deposit`
 - `jupiter_earn_withdraw`
 - `kamino_lend_deposit`
@@ -107,7 +108,6 @@ Current safe tools:
 - `close_empty_token_accounts`
 - `deactivate_solana_stake`
 - `withdraw_solana_stake`
-- `request_devnet_airdrop`
 - `x402_search_services`
 - `x402_get_service_details`
 - `x402_preview_request`
@@ -190,7 +190,7 @@ For production `mainnet`, prefer a dedicated RPC instead of the public Solana en
 
 - `SOLANA_RPC_URL` for one primary endpoint
 - `SOLANA_RPC_URLS` as a comma-separated ordered failover list
-- or just `ALCHEMY_API_KEY` / `HELIUS_API_KEY`, which auto-derive a primary Solana RPC for `mainnet` or `devnet`
+- or just `ALCHEMY_API_KEY` / `HELIUS_API_KEY`, which auto-derive a primary Solana RPC for `mainnet`
 
 Production recommendation: treat RPC as deployment-owned config, not wallet logic. Runtime env wins over `openclaw.json` plugin config, so keep `Alchemy/Helius/QuickNode` endpoints in deployment secrets or service env and use plugin `rpcUrl` / `rpcUrls` only as local fallback.
 
@@ -277,9 +277,7 @@ export AGENT_WALLET_BOOT_KEY='paste-generated-secret-here'
 In that mode, `agent-wallet` will auto-resolve:
 
 - `mainnet` -> `https://solana-mainnet.g.alchemy.com/v2/<ALCHEMY_API_KEY>`
-- `devnet` -> `https://solana-devnet.g.alchemy.com/v2/<ALCHEMY_API_KEY>`
 - `mainnet` -> `https://mainnet.helius-rpc.com/?api-key=<HELIUS_API_KEY>`
-- `devnet` -> `https://devnet.helius-rpc.com/?api-key=<HELIUS_API_KEY>`
 
 and still append the official Solana endpoint as fallback.
 
@@ -317,7 +315,7 @@ printf '%s\n' 'your-local-btc-password' | \
 python -m agent_wallet.openclaw_cli btc-wallet-create \
   --user-id alice@example.com \
   --password-stdin \
-  --config-json '{"backend":"wdk_btc_local","network":"testnet","wdkBtcServiceUrl":"http://127.0.0.1:8080"}'
+  --config-json '{"backend":"wdk_btc_local","network":"bitcoin","wdkBtcServiceUrl":"http://127.0.0.1:8080"}'
 ```
 
 If you want a friendlier host-shell flow, use:
@@ -325,7 +323,7 @@ If you want a friendlier host-shell flow, use:
 ```bash
 python scripts/manage_openclaw_btc_wallet.py setup \
   --user-id alice@example.com \
-  --network testnet \
+  --network bitcoin \
   --service-url http://127.0.0.1:8080
 ```
 
@@ -340,11 +338,11 @@ If you want a true one-command OpenClaw bootstrap, use:
 ```bash
 python agent-wallet/scripts/bootstrap_openclaw_btc.py \
   --user-id alice@example.com \
-  --network testnet \
+  --network bitcoin \
   --service-url http://127.0.0.1:8080
 ```
 
-For BTC mainnet, use the same bootstrap with `--network mainnet`. The script normalizes that to `bitcoin` in plugin config automatically.
+You can also pass `--network mainnet`; the bootstrap normalizes that alias to `bitcoin`.
 
 For the simplest host-side UX, use the shell wrapper instead:
 
@@ -356,7 +354,7 @@ That is the intended "agent/host installs, user only enters password" entrypoint
 
 - the script wraps the full BTC bootstrap
 - it auto-starts the local `wdk-btc-wallet` service for localhost URLs if needed
-- it asks for `user-id` and shows a small `mainnet / testnet / regtest` menu if you did not pass them as args or env
+- it asks for `user-id` and defaults BTC network to `mainnet` if you did not pass it explicitly
 - it prompts for the BTC wallet password interactively unless you explicitly pass `--password-stdin`
 - it prefers `/tmp/agent-wallet-venv/bin/python`, then `agent-wallet/.venv/bin/python`, and only then falls back to system `python3`
 - it creates or unlocks the BTC wallet binding and patches local OpenClaw config in one pass
@@ -407,7 +405,7 @@ For the local EVM backend (`backend=wdk_evm_local`), the lifecycle mirrors the B
 - `agent-wallet` talks to it through a local bearer token loaded from `~/.openclaw/wdk-evm-wallet/local-auth-token`
 - `agent-wallet` stores only a per-user EVM wallet binding under `~/.openclaw/users/<normalized-user-id>/wallets/evm-<network>-agent.json`
 - the runtime can auto-create missing EVM bindings or auto-unlock the local vault during ordinary OpenClaw switching/tool calls when `sealed_keys.json` contains `wdk_evm_wallet_password`
-- supported EVM networks are `ethereum`, `sepolia`, `base`, and `base-sepolia`
+- supported EVM networks are `ethereum` and `base`
 - OpenClaw-facing EVM tools accept an optional per-call `network` override for `ethereum` or `base`, so the agent can switch between the two mainnet EVM paths without editing host config
 - EVM `get_wallet_balance` now returns an enriched portfolio-style payload with native balance, discovered ERC-20 balances, and USD values when token discovery and pricing are available
 - if a requested EVM network binding is missing, `agent-wallet` auto-binds it from the same local wallet when there is exactly one reusable EVM wallet for that user or when `wdkEvmWalletId` is provided explicitly
@@ -430,7 +428,7 @@ That wrapper:
 - defaults to `http://127.0.0.1:8081`
 - can auto-start `wdk-evm-wallet/run-local.sh` if the local service is not already healthy
 - creates or unlocks the local EVM wallet binding
-- also binds the paired EVM network by default: `ethereum <-> base`, `sepolia <-> base-sepolia`
+- also binds the paired EVM network by default: `ethereum <-> base`
 - stores the entered EVM vault password into `sealed_keys.json` when `AGENT_WALLET_BOOT_KEY` is available, so later OpenClaw wallet switching can auto-raise the EVM backend without another password prompt
 - patches OpenClaw config to `backend=wdk_evm_local`
 
@@ -441,7 +439,7 @@ printf '%s\n' 'your-local-evm-password' | \
 python -m agent_wallet.openclaw_cli evm-wallet-create \
   --user-id alice@example.com \
   --password-stdin \
-  --config-json '{"backend":"wdk_evm_local","network":"sepolia","wdkEvmServiceUrl":"http://127.0.0.1:8081"}'
+  --config-json '{"backend":"wdk_evm_local","network":"ethereum","wdkEvmServiceUrl":"http://127.0.0.1:8081"}'
 ```
 
 After that, `onboard` and `invoke` can use the bound EVM wallet by `user_id` without manually passing `wdkEvmWalletId` every time.
@@ -500,14 +498,13 @@ This keeps wallet creation and custody in the host/runtime layer while the agent
 
 The wallet backend is already network-scoped:
 
-- `devnet` and `mainnet` use different wallet files
-- per-user wallets are stored as `solana-<network>-agent.json`
-- switching networks does not mix balances or stake accounts across clusters
+- Solana stays on `mainnet`
+- per-user Solana wallets continue to use `solana-mainnet-agent.json`
+- switching BTC or EVM networks does not mix balances across chains
 
 For a local OpenClaw install, use:
 
 ```bash
-python agent-wallet/scripts/switch_openclaw_wallet_network.py --network devnet
 python agent-wallet/scripts/switch_openclaw_wallet_network.py --network mainnet
 ```
 
@@ -570,7 +567,7 @@ Operational notes:
 
 - this path uses Solana RPC and the Stake Program directly, without third-party DeFi APIs
 - stake creation allocates a new stake account controlled by the connected wallet as staker and withdrawer
-- preview and prepare were live-checked on devnet against a real wallet context
+- preview and prepare were live-checked against a real wallet context
 
 ## Official OpenClaw plugin
 
@@ -612,13 +609,13 @@ Public-safe helper scripts are available in `agent-wallet/scripts/`:
 Both scripts now use generic defaults instead of hardcoded local usernames or paths. Sensitive secrets must be supplied via protected environment variables, not config JSON or CLI arguments.
 When `~/.openclaw/agent-wallet-runtime/current` exists, the config installer now prefers that trusted runtime path over a workspace checkout for the plugin manifest, package root, and Python bridge launcher.
 
-Recommended devnet setup:
+Recommended Solana mainnet setup:
 
 ```bash
 AGENT_WALLET_BACKEND=solana_local
 AGENT_WALLET_BOOT_KEY=change-this-in-production
-SOLANA_NETWORK=devnet
-SOLANA_RPC_URLS=https://api.devnet.solana.com
+SOLANA_NETWORK=mainnet
+SOLANA_RPC_URLS=https://api.mainnet-beta.solana.com
 SOLANA_AUTO_CREATE_WALLET=true
 AGENT_WALLET_SIGN_ONLY=false
 ```
@@ -641,4 +638,3 @@ The package now supports:
 - Jupiter-based swap preview and execution on mainnet
 - compact swap `fee_summary` in preview/prepare/execute, including known network fees and route fee bps when Jupiter provides them
 - zero-balance token account cleanup
-- devnet/testnet faucet airdrop