@agentlayer.tech/wallet 0.1.95 → 0.1.96

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

@@ -97,8 +97,8 @@ Important:
 - The EVM tool surface is intentionally narrow: Velora and Uniswap swap quote/execute, Aave V3 account/reserve/position flows, native transfers, ERC-20 transfers, fee quotes, and receipt lookup only. No arbitrary calldata, standalone approvals, or generic contract execution are exposed to the agent.
 - Velora swap and Aave V3 support are currently limited to `ethereum` and `base`. Test carefully because the upstream WDK protocol packages are still beta.
 - Agents can call `set_wallet_backend` to switch the active wallet for the current OpenClaw plugin session between Solana, EVM, and Bitcoin. This does not edit `openclaw.json`; plugin config remains the startup default.
-- EVM core read and transfer tools accept an optional per-call `network` override for `ethereum`, `base`, or `robinhood`; Velora/Aave remain limited to Ethereum/Base, while Uniswap supports all three.
-- Agents can also call `set_evm_network` to select the active EVM network for the current OpenClaw plugin session. After that, EVM tools default to the selected network unless a specific call passes its own `network` value. Do not edit code, plugin config, or environment variables just to switch between Base, Ethereum, and Robinhood.
+- EVM core read and transfer tools accept an optional per-call `network` override for `ethereum`, `base`, `robinhood`, or `goat`; Velora/Aave remain limited to Ethereum/Base, while Uniswap supports Ethereum/Base/Robinhood only. GOAT uses BTC as the native gas asset and exposes no bridge, DEX, or GOAT Flow/x402 operation through this core surface.
+- Agents can also call `set_evm_network` to select the active EVM network for the current OpenClaw plugin session. After that, EVM tools default to the selected network unless a specific call passes its own `network` value. Do not edit code, plugin config, or environment variables just to switch between Base, Ethereum, Robinhood, and GOAT.
 - `get_wallet_balance` returns an enriched wallet overview for Solana and EVM: native balance, discovered token balances, per-asset USD values when pricing is available, and `total_value_usd`.
 - Solana wallet overview uses Solana RPC only for balance and token-account discovery. Token prices come from Jupiter, not RPC, and internal transfer/staking checks continue to use native-only balance reads.
 - If the user needs to recover the mnemonic later, host-side reveal stays outside the agent tool surface via `agent-wallet/scripts/manage_openclaw_btc_wallet.py reveal-seed`.

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

@@ -18,7 +18,8 @@ const PREVIEW_BOUND_SWAP_TOOLS = new Set([
   "flash_trade_open_position",
   "flash_trade_close_position",
 ]);
-const EVM_CORE_NETWORKS = ["ethereum", "base", "robinhood"];
+const EVM_CORE_NETWORKS = ["ethereum", "base", "robinhood", "goat"];
+const EVM_UNISWAP_NETWORKS = ["ethereum", "base", "robinhood"];
 const AUTONOMOUS_BASE_SWAP_TOOLS = new Set([
   "swap_evm_tokens",
   "swap_evm_uniswap_tokens",
@@ -205,6 +206,7 @@ function normalizeWalletBackend(value) {
     eth: "wdk_evm_local",
     base: "wdk_evm_local",
     robinhood: "wdk_evm_local",
+    goat: "wdk_evm_local",
     wdk_evm_local: "wdk_evm_local",
     "wdk-evm-local": "wdk_evm_local",
     evm_local: "wdk_evm_local",
@@ -218,7 +220,7 @@ function normalizeWalletBackend(value) {
   };
   const backend = aliases[normalized] || normalized;
   if (!["solana_local", "wdk_evm_local", "wdk_btc_local"].includes(backend)) {
-    throw new Error("Wallet backend must be solana, evm, ethereum, base, robinhood, btc, or bitcoin.");
+    throw new Error("Wallet backend must be solana, evm, ethereum, base, robinhood, goat, btc, or bitcoin.");
   }
   return backend;
 }
@@ -236,17 +238,18 @@ function normalizeEvmNetwork(value) {
     eth: "ethereum",
     "eth-mainnet": "ethereum",
     "base-mainnet": "base",
+    "goat-mainnet": "goat",
   };
   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, base, or robinhood.");
+  if (["sepolia", "base-sepolia", "base_sepolia", "goat-testnet", "goat-testnet3"].includes(network)) {
+    throw new Error("EVM testnets are no longer supported. Use ethereum, base, robinhood, or goat.");
   }
   if (!EVM_CORE_NETWORKS.includes(network)) {
-    throw new Error("EVM network must be 'ethereum', 'base', or 'robinhood'.");
+    throw new Error("EVM network must be 'ethereum', 'base', 'robinhood', or 'goat'.");
   }
   return network;
 }
@@ -370,6 +373,10 @@ function networkForBackend(api, backend) {
   }
 }
 
+function isGoatEvmNetwork(network) {
+  return ["goat", "goat-mainnet", "eip155:2345"].includes(String(network || "").trim().toLowerCase());
+}
+
 function effectiveConfigForBackend(api, backend) {
   const config = resolvePluginConfig(api);
   return {
@@ -591,6 +598,8 @@ function registerTool(api, definition) {
         const impliedNetwork =
           ["base", "base-mainnet"].includes(requestedWallet)
             ? "base"
+            : ["goat", "goat-mainnet"].includes(requestedWallet)
+              ? "goat"
             : ["ethereum", "eth", "mainnet", "eth-mainnet"].includes(requestedWallet)
               ? "ethereum"
               : null;
@@ -674,6 +683,15 @@ function registerTool(api, definition) {
       if (activeBackend === "wdk_evm_local" && effectiveParams.network !== undefined) {
         configOverride.network = normalizeSelectableEvmNetwork(effectiveParams.network);
       }
+      if (
+        definition.name === "x402_pay_request" &&
+        activeBackend === "wdk_evm_local" &&
+        isGoatEvmNetwork(configOverride.network)
+      ) {
+        throw new Error(
+          "GOAT x402 payments are not enabled in this wallet surface. Use the supported core GOAT wallet operations instead."
+        );
+      }
       await attachApprovalForExecute(api, configOverride, userId, definition.name, effectiveParams);
       const executeWalletTool = async () =>
         callWalletCli(api, "invoke", [
@@ -844,12 +862,12 @@ const walletSessionToolDefinitions = [
       properties: {
         backend: {
           type: "string",
-          enum: ["solana", "sol", "evm", "ethereum", "base", "robinhood", "bitcoin", "btc"],
+          enum: ["solana", "sol", "evm", "ethereum", "base", "robinhood", "goat", "bitcoin", "btc"],
           description: "Wallet backend or common alias to make active.",
         },
         network: {
           type: "string",
-          description: "Optional network for the selected wallet. Examples: mainnet, ethereum, base, robinhood, bitcoin.",
+          description: "Optional network for the selected wallet. Examples: mainnet, ethereum, base, robinhood, goat, bitcoin.",
         },
       },
       required: ["backend"],
@@ -1640,7 +1658,7 @@ const evmToolDefinitions = [
   {
     name: "set_evm_network",
     description:
-      "Select the active EVM network for subsequent wallet tool calls in this OpenClaw plugin session. Use this to switch between ethereum, base, and robinhood instead of editing code or plugin configuration.",
+      "Select the active EVM network for subsequent wallet tool calls in this OpenClaw plugin session. Use this to switch between ethereum, base, robinhood, and goat instead of editing code or plugin configuration.",
     parameters: {
       type: "object",
       properties: {
@@ -1693,7 +1711,7 @@ const evmToolDefinitions = [
   },
   {
     name: "get_evm_transaction_receipt",
-    description: "Get the transaction receipt for a broadcast EVM transaction hash.",
+    description: "Get the transaction receipt for a broadcast EVM transaction hash. On GOAT, a receipt confirms L2 inclusion; it does not by itself prove Bitcoin-backed finality.",
     parameters: {
       type: "object",
       properties: {
@@ -1972,7 +1990,7 @@ const evmToolDefinitions = [
         token_out: { type: "string" },
         amount_in_raw: { type: "string" },
         slippage_bps: { type: "integer" },
-        network: { type: "string", enum: EVM_CORE_NETWORKS },
+        network: { type: "string", enum: EVM_UNISWAP_NETWORKS },
       },
       required: ["token_in", "token_out", "amount_in_raw"],
       additionalProperties: false,
@@ -1990,7 +2008,7 @@ const evmToolDefinitions = [
         dex_id: { type: "string" },
         all_chains: { type: "boolean" },
         limit: { type: "integer" },
-        network: { type: "string", enum: EVM_CORE_NETWORKS },
+        network: { type: "string", enum: EVM_UNISWAP_NETWORKS },
       },
       additionalProperties: false,
     },
@@ -2014,7 +2032,7 @@ const evmToolDefinitions = [
         },
         page_size: { type: "integer", minimum: 1, maximum: 20 },
         current_page: { type: "integer", minimum: 1 },
-        network: { type: "string", enum: EVM_CORE_NETWORKS },
+        network: { type: "string", enum: EVM_UNISWAP_NETWORKS },
       },
       required: ["protocol"],
       additionalProperties: false,
@@ -2028,7 +2046,7 @@ const evmToolDefinitions = [
       properties: {
         protocol: { type: "string", enum: ["V3"] },
         limit: { type: "integer", minimum: 1, maximum: 100 },
-        network: { type: "string", enum: EVM_CORE_NETWORKS },
+        network: { type: "string", enum: EVM_UNISWAP_NETWORKS },
       },
       additionalProperties: false,
     },
@@ -2047,7 +2065,7 @@ const evmToolDefinitions = [
         mode: { type: "string", enum: ["preview", "prepare", "execute"] },
         purpose: { type: "string" },
         user_intent: { type: "boolean" },
-        network: { type: "string", enum: EVM_CORE_NETWORKS },
+        network: { type: "string", enum: EVM_UNISWAP_NETWORKS },
       },
       required: ["token_in", "token_out", "amount_in_raw", "mode", "purpose"],
       additionalProperties: false,
@@ -2070,7 +2088,7 @@ const evmToolDefinitions = [
         mode: { type: "string", enum: ["preview", "prepare", "execute"] },
         purpose: { type: "string" },
         user_intent: { type: "boolean" },
-        network: { type: "string", enum: EVM_CORE_NETWORKS },
+        network: { type: "string", enum: EVM_UNISWAP_NETWORKS },
       },
       required: ["action", "protocol", "request", "mode", "purpose"],
       additionalProperties: false,

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

@@ -18,7 +18,8 @@ const PREVIEW_BOUND_SWAP_TOOLS = new Set([
   "flash_trade_open_position",
   "flash_trade_close_position",
 ]);
-const EVM_CORE_NETWORKS = ["ethereum", "base", "robinhood"];
+const EVM_CORE_NETWORKS = ["ethereum", "base", "robinhood", "goat"];
+const EVM_UNISWAP_NETWORKS = ["ethereum", "base", "robinhood"];
 const AUTONOMOUS_BASE_SWAP_TOOLS = new Set([
   "swap_evm_tokens",
   "swap_evm_uniswap_tokens",
@@ -205,6 +206,7 @@ function normalizeWalletBackend(value) {
     eth: "wdk_evm_local",
     base: "wdk_evm_local",
     robinhood: "wdk_evm_local",
+    goat: "wdk_evm_local",
     wdk_evm_local: "wdk_evm_local",
     "wdk-evm-local": "wdk_evm_local",
     evm_local: "wdk_evm_local",
@@ -218,7 +220,7 @@ function normalizeWalletBackend(value) {
   };
   const backend = aliases[normalized] || normalized;
   if (!["solana_local", "wdk_evm_local", "wdk_btc_local"].includes(backend)) {
-    throw new Error("Wallet backend must be solana, evm, ethereum, base, robinhood, btc, or bitcoin.");
+    throw new Error("Wallet backend must be solana, evm, ethereum, base, robinhood, goat, btc, or bitcoin.");
   }
   return backend;
 }
@@ -236,17 +238,18 @@ function normalizeEvmNetwork(value) {
     eth: "ethereum",
     "eth-mainnet": "ethereum",
     "base-mainnet": "base",
+    "goat-mainnet": "goat",
   };
   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, base, or robinhood.");
+  if (["sepolia", "base-sepolia", "base_sepolia", "goat-testnet", "goat-testnet3"].includes(network)) {
+    throw new Error("EVM testnets are no longer supported. Use ethereum, base, robinhood, or goat.");
   }
   if (!EVM_CORE_NETWORKS.includes(network)) {
-    throw new Error("EVM network must be 'ethereum', 'base', or 'robinhood'.");
+    throw new Error("EVM network must be 'ethereum', 'base', 'robinhood', or 'goat'.");
   }
   return network;
 }
@@ -370,6 +373,10 @@ function networkForBackend(api, backend) {
   }
 }
 
+function isGoatEvmNetwork(network) {
+  return ["goat", "goat-mainnet", "eip155:2345"].includes(String(network || "").trim().toLowerCase());
+}
+
 function effectiveConfigForBackend(api, backend) {
   const config = resolvePluginConfig(api);
   return {
@@ -591,6 +598,8 @@ function registerTool(api, definition) {
         const impliedNetwork =
           ["base", "base-mainnet"].includes(requestedWallet)
             ? "base"
+            : ["goat", "goat-mainnet"].includes(requestedWallet)
+              ? "goat"
             : ["ethereum", "eth", "mainnet", "eth-mainnet"].includes(requestedWallet)
               ? "ethereum"
               : null;
@@ -674,6 +683,15 @@ function registerTool(api, definition) {
       if (activeBackend === "wdk_evm_local" && effectiveParams.network !== undefined) {
         configOverride.network = normalizeSelectableEvmNetwork(effectiveParams.network);
       }
+      if (
+        definition.name === "x402_pay_request" &&
+        activeBackend === "wdk_evm_local" &&
+        isGoatEvmNetwork(configOverride.network)
+      ) {
+        throw new Error(
+          "GOAT x402 payments are not enabled in this wallet surface. Use the supported core GOAT wallet operations instead."
+        );
+      }
       await attachApprovalForExecute(api, configOverride, userId, definition.name, effectiveParams);
       const executeWalletTool = async () =>
         callWalletCli(api, "invoke", [
@@ -844,12 +862,12 @@ const walletSessionToolDefinitions = [
       properties: {
         backend: {
           type: "string",
-          enum: ["solana", "sol", "evm", "ethereum", "base", "robinhood", "bitcoin", "btc"],
+          enum: ["solana", "sol", "evm", "ethereum", "base", "robinhood", "goat", "bitcoin", "btc"],
           description: "Wallet backend or common alias to make active.",
         },
         network: {
           type: "string",
-          description: "Optional network for the selected wallet. Examples: mainnet, ethereum, base, robinhood, bitcoin.",
+          description: "Optional network for the selected wallet. Examples: mainnet, ethereum, base, robinhood, goat, bitcoin.",
         },
       },
       required: ["backend"],
@@ -1640,7 +1658,7 @@ const evmToolDefinitions = [
   {
     name: "set_evm_network",
     description:
-      "Select the active EVM network for subsequent wallet tool calls in this OpenClaw plugin session. Use this to switch between ethereum, base, and robinhood instead of editing code or plugin configuration.",
+      "Select the active EVM network for subsequent wallet tool calls in this OpenClaw plugin session. Use this to switch between ethereum, base, robinhood, and goat instead of editing code or plugin configuration.",
     parameters: {
       type: "object",
       properties: {
@@ -1693,7 +1711,7 @@ const evmToolDefinitions = [
   },
   {
     name: "get_evm_transaction_receipt",
-    description: "Get the transaction receipt for a broadcast EVM transaction hash.",
+    description: "Get the transaction receipt for a broadcast EVM transaction hash. On GOAT, a receipt confirms L2 inclusion; it does not by itself prove Bitcoin-backed finality.",
     parameters: {
       type: "object",
       properties: {
@@ -1972,7 +1990,7 @@ const evmToolDefinitions = [
         token_out: { type: "string" },
         amount_in_raw: { type: "string" },
         slippage_bps: { type: "integer" },
-        network: { type: "string", enum: EVM_CORE_NETWORKS },
+        network: { type: "string", enum: EVM_UNISWAP_NETWORKS },
       },
       required: ["token_in", "token_out", "amount_in_raw"],
       additionalProperties: false,
@@ -1990,7 +2008,7 @@ const evmToolDefinitions = [
         dex_id: { type: "string" },
         all_chains: { type: "boolean" },
         limit: { type: "integer" },
-        network: { type: "string", enum: EVM_CORE_NETWORKS },
+        network: { type: "string", enum: EVM_UNISWAP_NETWORKS },
       },
       additionalProperties: false,
     },
@@ -2014,7 +2032,7 @@ const evmToolDefinitions = [
         },
         page_size: { type: "integer", minimum: 1, maximum: 20 },
         current_page: { type: "integer", minimum: 1 },
-        network: { type: "string", enum: EVM_CORE_NETWORKS },
+        network: { type: "string", enum: EVM_UNISWAP_NETWORKS },
       },
       required: ["protocol"],
       additionalProperties: false,
@@ -2028,7 +2046,7 @@ const evmToolDefinitions = [
       properties: {
         protocol: { type: "string", enum: ["V3"] },
         limit: { type: "integer", minimum: 1, maximum: 100 },
-        network: { type: "string", enum: EVM_CORE_NETWORKS },
+        network: { type: "string", enum: EVM_UNISWAP_NETWORKS },
       },
       additionalProperties: false,
     },
@@ -2047,7 +2065,7 @@ const evmToolDefinitions = [
         mode: { type: "string", enum: ["preview", "prepare", "execute"] },
         purpose: { type: "string" },
         user_intent: { type: "boolean" },
-        network: { type: "string", enum: EVM_CORE_NETWORKS },
+        network: { type: "string", enum: EVM_UNISWAP_NETWORKS },
       },
       required: ["token_in", "token_out", "amount_in_raw", "mode", "purpose"],
       additionalProperties: false,
@@ -2070,7 +2088,7 @@ const evmToolDefinitions = [
         mode: { type: "string", enum: ["preview", "prepare", "execute"] },
         purpose: { type: "string" },
         user_intent: { type: "boolean" },
-        network: { type: "string", enum: EVM_CORE_NETWORKS },
+        network: { type: "string", enum: EVM_UNISWAP_NETWORKS },
       },
       required: ["action", "protocol", "request", "mode", "purpose"],
       additionalProperties: false,

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

@@ -2,7 +2,7 @@
   "id": "agent-wallet",
   "name": "Agent Wallet",
   "description": "Official OpenClaw plugin bridge for the agent-wallet backends, including Solana, local BTC, and local EVM.",
-  "version": "0.1.95",
+  "version": "0.1.96",
   "contracts": {
     "tools": [
       "agentlayer_autonomous_approve",
@@ -100,7 +100,7 @@
       },
       "network": {
         "type": "string",
-        "description": "Backend network selector. Solana uses mainnet. BTC uses bitcoin. EVM uses ethereum/base."
+        "description": "Backend network selector. Solana uses mainnet. BTC uses bitcoin. EVM uses ethereum/base/robinhood/goat."
       },
       "wdkBtcServiceUrl": {
         "type": "string",

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

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

package/VERSION

@@ -1 +1 @@
-0.1.95
+0.1.96

package/agent-wallet/README.md

@@ -383,8 +383,8 @@ 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` 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
+- supported EVM networks are `ethereum`, `base`, `robinhood`, and `goat`
+- OpenClaw-facing EVM core read and transfer tools accept an optional per-call `network` override for those mainnet networks, so the agent can switch without editing host config. GOAT uses BTC as its 18-decimal native gas asset; token discovery is intentionally native-only until a reviewed GOAT indexer is added, while explicit ERC-20 balance and metadata reads remain available.
 - 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
 - you can manage that binding through `agent_wallet.openclaw_cli`:
@@ -406,7 +406,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`
+- also binds the paired EVM network by default: `ethereum <-> base` (GOAT remains an independent EVM network binding)
 - 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`
 

package/agent-wallet/agent_wallet/__init__.py

@@ -2,7 +2,7 @@
 
 # Keep in sync with package.json, pyproject.toml, and the npm installer version.
 # scripts/check_release_version.mjs enforces this on release.
-__version__ = "0.1.95"
+__version__ = "0.1.96"
 
 __all__ = [
     "config",

package/agent-wallet/agent_wallet/autonomous_policy.py

@@ -37,6 +37,7 @@ from dataclasses import dataclass, field
 from typing import Callable
 
 from agent_wallet.approval import issue_approval_token
+from agent_wallet.networks import AUTONOMOUS_MAINNET_NETWORKS
 from agent_wallet.spending_limits import SpendingConfig, SpendingLedger
 from agent_wallet.wallet_layer.base import WalletBackendError
 
@@ -46,7 +47,7 @@ AUTONOMOUS_ISSUER = "autonomous-policy"
 
 #: Networks treated as "real money" and therefore gated behind
 #: ``allow_mainnet`` regardless of the per-tool allow-list.
-MAINNET_NETWORKS = frozenset({"mainnet", "mainnet-beta", "ethereum", "base", "robinhood", "arbitrum", "optimism", "polygon"})
+MAINNET_NETWORKS = AUTONOMOUS_MAINNET_NETWORKS
 
 TokenIssuer = Callable[..., str]
 

package/agent-wallet/agent_wallet/config.py

@@ -7,6 +7,8 @@ from typing import Iterator
 
 from pydantic_settings import BaseSettings
 
+from agent_wallet.networks import EVM_CORE_MAINNETS, EVM_CORE_NETWORK_ALIASES, EVM_CORE_TESTNETS
+
 PACKAGE_ROOT = Path(__file__).resolve().parents[1]
 DEFAULT_PROVIDER_GATEWAY_URL = "https://agent-layer-production.up.railway.app"
 
@@ -112,24 +114,18 @@ def normalize_solana_network(network: str | None) -> str:
 def normalize_evm_network(network: str | None) -> str:
     """Canonicalize supported EVM network names and reject testnets."""
     normalized = str(network or "").strip().lower() or "ethereum"
-    aliases = {
-        "mainnet": "ethereum",
-        "eth": "ethereum",
-        "eth-mainnet": "ethereum",
-        "base-mainnet": "base",
-    }
-    normalized = aliases.get(normalized, normalized)
-    if normalized in {"sepolia", "base-sepolia", "base_sepolia"}:
+    normalized = EVM_CORE_NETWORK_ALIASES.get(normalized, normalized)
+    if normalized in EVM_CORE_TESTNETS:
         from agent_wallet.wallet_layer.base import WalletBackendError
 
         raise WalletBackendError(
-            "EVM testnets are no longer supported by agent-wallet. Use ethereum, base, or robinhood."
+            "EVM testnets are no longer supported by agent-wallet. Use ethereum, base, robinhood, or goat."
         )
-    if normalized not in {"ethereum", "base", "robinhood"}:
+    if normalized not in EVM_CORE_MAINNETS:
         from agent_wallet.wallet_layer.base import WalletBackendError
 
         raise WalletBackendError(
-            f"Unsupported EVM network: {normalized}. Use ethereum, base, or robinhood."
+            f"Unsupported EVM network: {normalized}. Use ethereum, base, robinhood, or goat."
         )
     return normalized
 

package/agent-wallet/agent_wallet/networks.py

@@ -0,0 +1,25 @@
+"""Canonical network identifiers used by agent-wallet policy gates.
+
+The Python wallet backend owns approval and autonomous-execution policy. Keep
+the selectable EVM network set and its mainnet identities here so additions
+cannot silently reach one policy gate but miss another.
+"""
+
+EVM_CORE_MAINNETS = frozenset({"ethereum", "base", "robinhood", "goat"})
+EVM_CORE_NETWORK_ALIASES = {
+    "mainnet": "ethereum",
+    "eth": "ethereum",
+    "eth-mainnet": "ethereum",
+    "base-mainnet": "base",
+    "goat-mainnet": "goat",
+}
+EVM_CORE_TESTNETS = frozenset({"sepolia", "base-sepolia", "base_sepolia", "goat-testnet", "goat-testnet3"})
+EVM_CORE_MAINNET_CAIP_IDS = frozenset({"eip155:1", "eip155:8453", "eip155:4663", "eip155:2345"})
+GOAT_EVM_NETWORK_IDENTIFIERS = frozenset({"goat", "goat-mainnet", "eip155:2345"})
+
+# The autonomous engine may also govern legacy supported operation classes
+# outside the selectable EVM wallet surface. Keep that superset derived from
+# the core EVM mainnet definition rather than re-listing its members.
+AUTONOMOUS_MAINNET_NETWORKS = frozenset(
+    {"mainnet", "mainnet-beta", "arbitrum", "optimism", "polygon"} | EVM_CORE_MAINNETS
+)

package/agent-wallet/agent_wallet/openclaw_adapter.py

@@ -11,6 +11,13 @@ from agent_wallet.approval import inspect_approval_token, verify_approval_token
 from agent_wallet.autonomous_policy import OperationRequest
 from agent_wallet.exceptions import ProviderError
 from agent_wallet.models import AgentToolResult, AgentToolSpec
+from agent_wallet.networks import (
+    EVM_CORE_MAINNET_CAIP_IDS,
+    EVM_CORE_MAINNETS,
+    EVM_CORE_NETWORK_ALIASES,
+    EVM_CORE_TESTNETS,
+    GOAT_EVM_NETWORK_IDENTIFIERS,
+)
 from agent_wallet.providers import x402
 from agent_wallet.wallet_layer.base import AgentWalletBackend, WalletBackendError
 
@@ -74,7 +81,7 @@ class OpenClawWalletAdapter:
         if chain == "bitcoin":
             return normalized == "bitcoin"
         if chain == "evm":
-            return normalized in {"ethereum", "base", "robinhood", "eip155:1", "eip155:8453", "eip155:4663"}
+            return normalized in EVM_CORE_MAINNETS | EVM_CORE_MAINNET_CAIP_IDS
         if chain == "solana":
             return normalized in {"mainnet", "solana:5eykt4usfv8p8njdtrepy1vzkqzkvdp"}
         return normalized == "mainnet"
@@ -85,6 +92,10 @@ class OpenClawWalletAdapter:
     def _is_mainnet_for_backend(self, backend: AgentWalletBackend) -> bool:
         return self._is_mainnet_network(getattr(backend, "network", ""))
 
+    @staticmethod
+    def _is_goat_evm_network(network: Any) -> bool:
+        return str(network or "").strip().lower() in GOAT_EVM_NETWORK_IDENTIFIERS
+
     def _supports_evm_velora(self) -> bool:
         return str(getattr(self.backend, "chain", "")).strip().lower() == "evm" and self._is_mainnet()
 
@@ -93,17 +104,13 @@ class OpenClawWalletAdapter:
 
     def _normalize_evm_tool_network(self, value: Any) -> str:
         network = str(value or "").strip().lower()
-        aliases = {
-            "mainnet": "ethereum",
-            "eth": "ethereum",
-            "eth-mainnet": "ethereum",
-            "base-mainnet": "base",
-        }
-        network = aliases.get(network, network)
-        if network in {"sepolia", "base-sepolia", "base_sepolia"}:
-            raise WalletBackendError("EVM testnets are no longer supported. Use ethereum, base, or robinhood.")
-        if network not in {"ethereum", "base", "robinhood"}:
-            raise WalletBackendError("EVM network must be 'ethereum', 'base', or 'robinhood'.")
+        network = EVM_CORE_NETWORK_ALIASES.get(network, network)
+        if network in EVM_CORE_TESTNETS:
+            raise WalletBackendError(
+                "EVM testnets are no longer supported. Use ethereum, base, robinhood, or goat."
+            )
+        if network not in EVM_CORE_MAINNETS:
+            raise WalletBackendError("EVM network must be 'ethereum', 'base', 'robinhood', or 'goat'.")
         return network
 
     def _resolve_backend_for_args(self, args: dict[str, Any]) -> AgentWalletBackend:
@@ -1229,7 +1236,7 @@ class OpenClawWalletAdapter:
                         "properties": {
                             "network": {
                                 "type": "string",
-                                "enum": ["ethereum", "base", "robinhood"],
+                                "enum": ["ethereum", "base", "robinhood", "goat"],
                                 "description": "Optional EVM network override for this request.",
                             },
                         },
@@ -1246,7 +1253,7 @@ class OpenClawWalletAdapter:
                         "properties": {
                             "network": {
                                 "type": "string",
-                                "enum": ["ethereum", "base", "robinhood"],
+                                "enum": ["ethereum", "base", "robinhood", "goat"],
                                 "description": "Optional EVM network override for this request.",
                             },
                         },
@@ -1271,7 +1278,7 @@ class OpenClawWalletAdapter:
                             },
                             "network": {
                                 "type": "string",
-                                "enum": ["ethereum", "base", "robinhood"],
+                                "enum": ["ethereum", "base", "robinhood", "goat"],
                                 "description": "Optional EVM network override for this request.",
                             },
                         },
@@ -1352,7 +1359,7 @@ class OpenClawWalletAdapter:
                         "properties": {
                             "network": {
                                 "type": "string",
-                                "enum": ["ethereum", "base", "robinhood"],
+                                "enum": ["ethereum", "base", "robinhood", "goat"],
                                 "description": "Optional EVM network override for this request.",
                             },
                         },
@@ -1365,7 +1372,7 @@ class OpenClawWalletAdapter:
                     name="set_evm_network",
                     description=(
                         "Select the active EVM network for subsequent wallet tool calls in this "
-                        "runtime session. Use this to switch between ethereum, base, and robinhood instead "
+                        "runtime session. Use this to switch between ethereum, base, robinhood, and goat instead "
                         "of editing code or plugin configuration."
                     ),
                     input_schema={
@@ -1373,7 +1380,7 @@ class OpenClawWalletAdapter:
                         "properties": {
                             "network": {
                                 "type": "string",
-                                "enum": ["ethereum", "base", "robinhood"],
+                                "enum": ["ethereum", "base", "robinhood", "goat"],
                                 "description": "EVM network to make active for subsequent calls.",
                             },
                         },
@@ -1395,7 +1402,7 @@ class OpenClawWalletAdapter:
                             },
                             "network": {
                                 "type": "string",
-                                "enum": ["ethereum", "base", "robinhood"],
+                                "enum": ["ethereum", "base", "robinhood", "goat"],
                                 "description": "Optional EVM network override for this request.",
                             },
                         },
@@ -1417,7 +1424,7 @@ class OpenClawWalletAdapter:
                             },
                             "network": {
                                 "type": "string",
-                                "enum": ["ethereum", "base", "robinhood"],
+                                "enum": ["ethereum", "base", "robinhood", "goat"],
                                 "description": "Optional EVM network override for this request.",
                             },
                         },
@@ -1435,7 +1442,7 @@ class OpenClawWalletAdapter:
                         "properties": {
                             "network": {
                                 "type": "string",
-                                "enum": ["ethereum", "base", "robinhood"],
+                                "enum": ["ethereum", "base", "robinhood", "goat"],
                                 "description": "Optional EVM network override for this request.",
                             },
                         },
@@ -1446,7 +1453,10 @@ class OpenClawWalletAdapter:
                 ),
                 AgentToolSpec(
                     name="get_evm_transaction_receipt",
-                    description="Get the transaction receipt for a broadcast EVM transaction hash.",
+                    description=(
+                        "Get the transaction receipt for a broadcast EVM transaction hash. On GOAT, a receipt "
+                        "confirms L2 inclusion; it does not by itself prove Bitcoin-backed finality."
+                    ),
                     input_schema={
                         "type": "object",
                         "properties": {
@@ -1456,7 +1466,7 @@ class OpenClawWalletAdapter:
                             },
                             "network": {
                                 "type": "string",
-                                "enum": ["ethereum", "base", "robinhood"],
+                                "enum": ["ethereum", "base", "robinhood", "goat"],
                                 "description": "Optional EVM network override for this request.",
                             },
                         },
@@ -1489,7 +1499,7 @@ class OpenClawWalletAdapter:
                             "approval_token": {"type": "string"},
                             "network": {
                                 "type": "string",
-                                "enum": ["ethereum", "base", "robinhood"],
+                                "enum": ["ethereum", "base", "robinhood", "goat"],
                                 "description": "Optional EVM network override for this request.",
                             },
                         },
@@ -1524,7 +1534,7 @@ class OpenClawWalletAdapter:
                             "approval_token": {"type": "string"},
                             "network": {
                                 "type": "string",
-                                "enum": ["ethereum", "base", "robinhood"],
+                                "enum": ["ethereum", "base", "robinhood", "goat"],
                                 "description": "Optional EVM network override for this request.",
                             },
                         },
@@ -4320,6 +4330,14 @@ class OpenClawWalletAdapter:
                 return AgentToolResult(tool=tool_name, ok=True, data=data)
 
             if tool_name == "x402_pay_request":
+                if (
+                    str(getattr(active_backend, "chain", "")).strip().lower() == "evm"
+                    and self._is_goat_evm_network(getattr(active_backend, "network", ""))
+                ):
+                    raise WalletBackendError(
+                        "GOAT x402 payments are not enabled in this wallet surface. "
+                        "Use the supported core GOAT wallet operations instead."
+                    )
                 url = args.get("url")
                 method = args.get("method", "GET")
                 headers = args.get("headers")

package/agent-wallet/agent_wallet/providers/evm_portfolio.py

@@ -117,6 +117,7 @@ TOKEN_METADATA: dict[str, dict[str, dict[str, Any]]] = {
 }
 
 COINGECKO_IDS = {
+    "BTC": "bitcoin",
     "ETH": "ethereum",
     "WETH": "ethereum",
     "USDC": "usd-coin",
@@ -142,7 +143,7 @@ _PRICE_CACHE: dict[str, tuple[float, float]] = {}
 
 def _normalize_network(network: str) -> str:
     normalized = str(network or "").strip().lower()
-    if normalized not in {"ethereum", "base", "robinhood"}:
+    if normalized not in {"ethereum", "base", "robinhood", "goat"}:
         raise ProviderError("evm-portfolio", f"Unsupported EVM portfolio network: {network}")
     return normalized
 
@@ -207,7 +208,7 @@ async def _gateway_rpc_call(network: str, method: str, params: list[Any]) -> dic
     if not gateway_url:
         raise ProviderError(
             "evm-portfolio",
-            "Provider gateway URL is required for EVM portfolio lookup on ethereum/base/robinhood.",
+            "Provider gateway URL is required for EVM portfolio lookup on supported EVM networks.",
         )
     try:
         response = await client.post(
@@ -230,6 +231,12 @@ async def _gateway_rpc_call(network: str, method: str, params: list[Any]) -> dic
 
 async def fetch_token_balances(address: str, network: str) -> list[dict[str, Any]]:
     normalized_network = _normalize_network(network)
+    # GOAT uses the shared RPC gateway rather than Alchemy. Its upstream does
+    # not provide Alchemy's account-wide ERC-20 index, so return a truthful
+    # native-only portfolio. Explicit per-token balance and metadata tools keep
+    # working through ordinary EVM RPC calls.
+    if normalized_network == "goat":
+        return []
     cache_key = f"{normalized_network}:{address.lower()}"
     cached = _cache_get_token_balances(cache_key)
     if cached is not None:

package/agent-wallet/agent_wallet/wallet_layer/wdk_evm.py

@@ -668,7 +668,7 @@ class WdkEvmLocalWalletBackend(AgentWalletBackend):
             "configured_network": self.network,
             "service_active_network": str(data.get("activeNetwork") or "").strip() or None,
             "available_networks": sorted(str(key) for key in profiles.keys()),
-            "agent_selectable_networks": ["ethereum", "base", "robinhood"],
+            "agent_selectable_networks": ["ethereum", "base", "robinhood", "goat"],
             "swap_supported_networks": ["ethereum", "base", "robinhood"],
             "network_profiles": {
                 str(network): {

package/agent-wallet/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "agent-wallet",
   "name": "Agent Wallet",
   "description": "Plugin-friendly wallet backend for OpenClaw agents with safe wallet tools and runtime instructions across Solana, local BTC, and local EVM.",
-  "version": "0.1.95",
+  "version": "0.1.96",
   "skills": ["skills/wallet-operator"],
   "configSchema": {
     "type": "object",

package/agent-wallet/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "openclaw-agent-wallet"
-version = "0.1.95"
+version = "0.1.96"
 description = "Plugin-friendly wallet backend for OpenClaw agents"
 requires-python = ">=3.10"
 dependencies = [

package/claude-code/plugins/agent-wallet/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-wallet",
   "displayName": "Agent Wallet",
-  "version": "0.1.95",
+  "version": "0.1.96",
   "description": "Claude Code bridge for the existing AgentLayer wallet runtime. Connects to Solana, Bitcoin, and EVM wallets without creating a new one.",
   "author": {
     "name": "AgentLayer"

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

@@ -41,11 +41,11 @@ See the sections below for exact tool names and parameters.
 2. `get_wallet_address` — the address for the active backend.
 3. `get_wallet_capabilities` — chain, backend, and the safety limits in force.
 4. `set_wallet_backend` (`backend`: solana / evm / ethereum / base /
-   robinhood / btc / bitcoin, optional `network`) — switch backend for this
+   robinhood / goat / btc / bitcoin, optional `network`) — switch backend for this
    session without touching config files.
 5. For EVM specifically: `get_evm_network` shows the effective network and
    which networks support swaps; `set_evm_network` (ethereum / base /
-   robinhood) changes it.
+   robinhood / goat) changes it.
 
 Balance reads (Solana): `get_wallet_balance` / `get_wallet_portfolio` are the
 same enriched payload (native SOL + non-zero SPL accounts + USD pricing via

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

@@ -1,6 +1,6 @@
 {
   "name": "agent-wallet",
-  "version": "0.1.95",
+  "version": "0.1.96",
   "description": "Codex plugin bridge for the AgentLayer wallet runtime.",
   "author": {
     "name": "AgentLayer"

package/codex/plugins/agent-wallet/server.py

@@ -372,6 +372,7 @@ def _normalize_wallet_backend(value: Any) -> str:
         "eth": "wdk_evm_local",
         "base": "wdk_evm_local",
         "robinhood": "wdk_evm_local",
+        "goat": "wdk_evm_local",
         "wdk_evm_local": "wdk_evm_local",
         "wdk-evm-local": "wdk_evm_local",
         "evm_local": "wdk_evm_local",
@@ -385,7 +386,7 @@ def _normalize_wallet_backend(value: Any) -> str:
     }
     backend = aliases.get(normalized, normalized)
     if backend not in BACKENDS:
-        raise RuntimeError("Wallet backend must be solana, evm, ethereum, base, robinhood, btc, or bitcoin.")
+        raise RuntimeError("Wallet backend must be solana, evm, ethereum, base, robinhood, goat, btc, or bitcoin.")
     return backend
 
 
@@ -404,16 +405,17 @@ def _normalize_evm_network(value: Any) -> str:
         "eth": "ethereum",
         "eth-mainnet": "ethereum",
         "base-mainnet": "base",
+        "goat-mainnet": "goat",
     }
     return aliases.get(normalized, normalized)
 
 
 def _normalize_selectable_evm_network(value: Any) -> str:
     network = _normalize_evm_network(value)
-    if network in {"sepolia", "base-sepolia", "base_sepolia"}:
-        raise RuntimeError("EVM testnets are no longer supported. Use ethereum, base, or robinhood.")
-    if network not in {"ethereum", "base", "robinhood"}:
-        raise RuntimeError("EVM network must be 'ethereum', 'base', or 'robinhood'.")
+    if network in {"sepolia", "base-sepolia", "base_sepolia", "goat-testnet", "goat-testnet3"}:
+        raise RuntimeError("EVM testnets are no longer supported. Use ethereum, base, robinhood, or goat.")
+    if network not in {"ethereum", "base", "robinhood", "goat"}:
+        raise RuntimeError("EVM network must be 'ethereum', 'base', 'robinhood', or 'goat'.")
     return network
 
 
@@ -423,6 +425,8 @@ def _implied_evm_network_from_backend_alias(value: Any) -> str | None:
         return "base"
     if normalized == "robinhood":
         return "robinhood"
+    if normalized in {"goat", "goat-mainnet"}:
+        return "goat"
     if normalized in {"ethereum", "eth", "mainnet", "eth-mainnet"}:
         return "ethereum"
     return None
@@ -475,7 +479,7 @@ def _default_backend() -> str:
 
 def _default_evm_network() -> str | None:
     configured = _normalize_evm_network(os.getenv("WDK_EVM_NETWORK"))
-    if configured in {"ethereum", "base", "robinhood"}:
+    if configured in {"ethereum", "base", "robinhood", "goat"}:
         return configured
     return _configured_network_for_backend("wdk_evm_local")
 
@@ -1209,11 +1213,11 @@ def _manual_tool_definitions() -> list[dict[str, Any]]:
                 "properties": {
                     "backend": {
                         "type": "string",
-                        "description": "solana, evm, ethereum, base, robinhood, btc, or bitcoin.",
+                        "description": "solana, evm, ethereum, base, robinhood, goat, btc, or bitcoin.",
                     },
                     "network": {
                         "type": "string",
-                        "description": "Optional network override. Use ethereum, base, or robinhood for EVM.",
+                        "description": "Optional network override. Use ethereum, base, robinhood, or goat for EVM.",
                     },
                     "address": {
                         "type": "string",
@@ -1248,7 +1252,7 @@ def _manual_tool_definitions() -> list[dict[str, Any]]:
                 "properties": {
                     "backend": {
                         "type": "string",
-                        "description": "solana, evm, ethereum, base, robinhood, btc, or bitcoin.",
+                        "description": "solana, evm, ethereum, base, robinhood, goat, btc, or bitcoin.",
                     },
                     "wallet": {
                         "type": "string",
@@ -1266,14 +1270,14 @@ def _manual_tool_definitions() -> list[dict[str, Any]]:
         {
             "name": "set_evm_network",
             "description": (
-                "Set the active EVM network for this Codex MCP session to ethereum, base, or robinhood."
+                "Set the active EVM network for this Codex MCP session to ethereum, base, robinhood, or goat."
             ),
             "input_schema": {
                 "type": "object",
                 "properties": {
                     "network": {
                         "type": "string",
-                        "description": "ethereum, base, or robinhood.",
+                        "description": "ethereum, base, robinhood, or goat.",
                     }
                 },
                 "required": ["network"],

package/codex/plugins/agent-wallet/skills/wallet-operator/SKILL.md

@@ -16,4 +16,4 @@ Rules:
 - 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, and `set_evm_network` to pick ethereum, base, or robinhood.
+- Use `set_wallet_backend` to switch between Solana, EVM, and Bitcoin wallets within a session, and `set_evm_network` to pick ethereum, base, robinhood, or goat.

package/hermes/plugins/agent_wallet/plugin.yaml

@@ -1,5 +1,5 @@
 name: agent-wallet
-version: 0.1.95
+version: 0.1.96
 description: Thin Hermes Agent bridge to the existing AgentLayer/OpenClaw wallet backend
 provides_tools:
   - agent_wallet_tools

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentlayer.tech/wallet",
-  "version": "0.1.95",
+  "version": "0.1.96",
   "description": "Universal AgentLayer wallet installer for OpenClaw, Codex, Claude Code, and Hermes.",
   "type": "module",
   "repository": {

package/wdk-btc-wallet/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wdk-btc-wallet",
-  "version": "0.1.95",
+  "version": "0.1.96",
   "private": true,
   "type": "module",
   "description": "Separate BTC-only wallet service built on Tether WDK.",

package/wdk-evm-wallet/.env.example

@@ -11,7 +11,10 @@ WDK_EVM_RPC_GATEWAY_PROVIDER=alchemy
 PROVIDER_GATEWAY_URL=https://agent-layer-production.up.railway.app
 PROVIDER_GATEWAY_BEARER_TOKEN=
 # Mainnet ethereum/base/robinhood are forced through provider-gateway -> Alchemy.
-# Direct per-network URLs below are only relevant for testnet-style paths.
+# GOAT mainnet is forced through provider-gateway -> shared GOAT RPC. The gateway
+# is configured with SHARED_EVM_GOAT_RPC_URL=https://rpc.goat.network; it has no
+# local URL override. Direct per-network URLs below are only relevant for the
+# existing testnet-style paths.
 WDK_EVM_ETHEREUM_RPC_URL=
 WDK_EVM_SEPOLIA_RPC_URL=https://sepolia.drpc.org
 WDK_EVM_BASE_RPC_URL=

package/wdk-evm-wallet/README.md

@@ -74,9 +74,22 @@ This service intentionally supports a narrow surface:
 - `sepolia`
 - `base`
 - `base-sepolia`
+- `robinhood`
+- `goat` (GOAT Network mainnet, chain ID `2345`)
+- `goat-testnet` (GOAT Testnet3, chain ID `48816`; local runtime testing only)
 
 The active network is persistent and can be switched without changing code.
 
+GOAT is an EVM-compatible network whose native transfer and gas asset is BTC
+(18-decimal EVM base units), rather than ETH. Mainnet uses the allow-listed
+provider-gateway `shared` route, whose only GOAT upstream is configured as
+`SHARED_EVM_GOAT_RPC_URL` (normally `https://rpc.goat.network`). Testnet3 uses
+the fixed official endpoint `https://rpc.testnet3.goat.network`. Higher-level
+callers cannot supply a remote URL. Existing generic capabilities — native BTC
+balance/transfer, ERC-20 reads/transfers, fee quotes, and receipts — are
+available. GOAT bridge, DEX, and GOAT Flow/x402 operations remain deliberately
+out of scope until they receive separate protocol-specific safety reviews.
+
 ## API
 
 - `GET /health`
@@ -184,6 +197,7 @@ Environment variables:
 - `WDK_EVM_SEPOLIA_RPC_URL`
 - `WDK_EVM_BASE_RPC_URL`
 - `WDK_EVM_BASE_SEPOLIA_RPC_URL`
+- `WDK_EVM_ROBINHOOD_RPC_URL`
 - `MORPHO_API_BASE_URL`
 - `UNISWAP_API_KEY`
 - `UNISWAP_TRADING_API_BASE_URL`
@@ -227,10 +241,12 @@ Gateway mode:
 - `PROVIDER_GATEWAY_URL` defaults to `https://agent-layer-production.up.railway.app`
 - set `PROVIDER_GATEWAY_URL=https://...` only when overriding the hosted default
 - `PROVIDER_GATEWAY_BEARER_TOKEN` is optional and only needed when the gateway is protected
-- `ethereum` and `base` mainnet are always routed through the provider gateway raw EVM RPC route
-- `ethereum` and `base` mainnet are pinned to the gateway `provider=alchemy` path
+- `ethereum`, `base`, and `robinhood` mainnet are always routed through the provider gateway raw EVM RPC route pinned to `provider=alchemy`
+- GOAT mainnet is always routed through the provider gateway raw EVM RPC route pinned to `provider=shared`; configure its only allowed upstream with `SHARED_EVM_GOAT_RPC_URL=https://rpc.goat.network`
 - direct `WDK_EVM_ETHEREUM_RPC_URL` and `WDK_EVM_BASE_RPC_URL` values no longer override mainnet routing
 - `WDK_EVM_SEPOLIA_RPC_URL` and `WDK_EVM_BASE_SEPOLIA_RPC_URL` remain direct per-network testnet overrides
+- GOAT Testnet3 uses its fixed official public RPC endpoint. Mainnet requires a
+  gateway deployment that includes the GOAT shared-RPC allowlist.
 
 Local security note:
 

package/wdk-evm-wallet/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wdk-evm-wallet",
-  "version": "0.1.95",
+  "version": "0.1.96",
   "private": true,
   "type": "module",
   "description": "Separate EVM wallet service built on Tether WDK.",

package/wdk-evm-wallet/src/config.js

@@ -27,7 +27,7 @@ function readPackageVersion() {
 
 const PACKAGE_VERSION = readPackageVersion();
 const DEFAULT_PROVIDER_GATEWAY_URL = "https://agent-layer-production.up.railway.app";
-const ENFORCED_GATEWAY_MAINNETS = new Set(["ethereum", "base", "robinhood"]);
+const ENFORCED_GATEWAY_MAINNETS = new Set(["ethereum", "base", "robinhood", "goat"]);
 
 const DEFAULT_NETWORK_PROFILES = {
   ethereum: {
@@ -55,6 +55,16 @@ const DEFAULT_NETWORK_PROFILES = {
     providerUrl: "https://rpc.mainnet.chain.robinhood.com",
     nativeSymbol: "ETH",
   },
+  goat: {
+    chainId: 2345,
+    providerUrl: "https://rpc.goat.network",
+    nativeSymbol: "BTC",
+  },
+  "goat-testnet": {
+    chainId: 48816,
+    providerUrl: "https://rpc.testnet3.goat.network",
+    nativeSymbol: "BTC",
+  },
 };
 
 // Robinhood Chain uses the Universal Router 2.1.1 deployment. Keep this
@@ -191,6 +201,8 @@ function normalizeNetworkKey(value) {
     "base-mainnet": "base",
     base_sepolia: "base-sepolia",
     "robinhood-mainnet": "robinhood",
+    "goat-mainnet": "goat",
+    "goat-testnet3": "goat-testnet",
   };
   return aliases[normalized] || normalized;
 }
@@ -252,7 +264,7 @@ export function loadConfig(env = process.env) {
   const network = normalizeNetworkKey(env.WDK_EVM_NETWORK ?? DEFAULTS.network) || DEFAULTS.network;
   if (!Object.hasOwn(DEFAULT_NETWORK_PROFILES, network)) {
     throw new Error(
-      "WDK_EVM_NETWORK must be one of: ethereum, sepolia, base, base-sepolia, robinhood."
+      "WDK_EVM_NETWORK must be one of: ethereum, sepolia, base, base-sepolia, robinhood, goat, goat-testnet."
     );
   }
 
@@ -274,10 +286,14 @@ export function loadConfig(env = process.env) {
   function resolveProviderUrl(networkKey, envValue, fallbackUrl) {
     const direct = String(envValue ?? "").trim();
     if (ENFORCED_GATEWAY_MAINNETS.has(networkKey)) {
+      // GOAT's explicitly allow-listed gateway upstream is the official shared
+      // RPC. The other mainnets are pinned to Alchemy. Do not accept a caller-
+      // supplied upstream URL for any mainnet.
+      const enforcedProvider = networkKey === "goat" ? "shared" : "alchemy";
       const enforcedGatewayUrl = buildGatewayEvmRpcUrl(
         providerGatewayUrl,
         networkKey,
-        "alchemy",
+        enforcedProvider,
         providerGatewayToken
       );
       if (!enforcedGatewayUrl) {
@@ -344,6 +360,21 @@ export function loadConfig(env = process.env) {
         DEFAULT_NETWORK_PROFILES.robinhood.providerUrl
       ),
     },
+    // GOAT is an EIP-1559 EVM network that uses BTC (18 decimals) as its
+    // native gas token. Keep the official RPC endpoint fixed in source: host
+    // integrations must never select an arbitrary remote RPC URL.
+    goat: {
+      ...DEFAULT_NETWORK_PROFILES.goat,
+      providerUrl: resolveProviderUrl("goat", "", DEFAULT_NETWORK_PROFILES.goat.providerUrl),
+    },
+    "goat-testnet": {
+      ...DEFAULT_NETWORK_PROFILES["goat-testnet"],
+      providerUrl: resolveProviderUrl(
+        "goat-testnet",
+        "",
+        DEFAULT_NETWORK_PROFILES["goat-testnet"].providerUrl
+      ),
+    },
   };
 
   // Route Uniswap Trading API calls through the provider-gateway by default so the

package/wdk-evm-wallet/src/network_state.js

@@ -12,11 +12,17 @@ function assertValidNetwork(network, fieldName = "network") {
     "base-mainnet": "base",
     base_sepolia: "base-sepolia",
     "robinhood-mainnet": "robinhood",
+    "goat-mainnet": "goat",
+    "goat-testnet3": "goat-testnet",
   };
   const effective = aliases[normalized] || normalized;
-  if (!["ethereum", "sepolia", "base", "base-sepolia", "robinhood"].includes(effective)) {
+  if (
+    !["ethereum", "sepolia", "base", "base-sepolia", "robinhood", "goat", "goat-testnet"].includes(
+      effective
+    )
+  ) {
     throw new Error(
-      `${fieldName} must be one of: ethereum, sepolia, base, base-sepolia, robinhood.`
+      `${fieldName} must be one of: ethereum, sepolia, base, base-sepolia, robinhood, goat, goat-testnet.`
     );
   }
   return effective;

package/wdk-evm-wallet/src/wdk_evm_wallet.js

@@ -602,11 +602,17 @@ function assertValidNetwork(network, fieldName = "network") {
     "base-mainnet": "base",
     base_sepolia: "base-sepolia",
     "robinhood-mainnet": "robinhood",
+    "goat-mainnet": "goat",
+    "goat-testnet3": "goat-testnet",
   };
   const effective = aliases[normalized] || normalized;
-  if (!["ethereum", "sepolia", "base", "base-sepolia", "robinhood"].includes(effective)) {
+  if (
+    !["ethereum", "sepolia", "base", "base-sepolia", "robinhood", "goat", "goat-testnet"].includes(
+      effective
+    )
+  ) {
     throw new Error(
-      `${fieldName} must be one of: ethereum, sepolia, base, base-sepolia, robinhood.`
+      `${fieldName} must be one of: ethereum, sepolia, base, base-sepolia, robinhood, goat, goat-testnet.`
     );
   }
   return effective;