# Send Ethereum Node to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "eth-node",
    "name": "Ethereum Node",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/apexfork/eth-node",
    "canonicalUrl": "https://clawhub.ai/apexfork/eth-node",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/eth-node",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=eth-node",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "eth-node",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-02T23:23:12.746Z",
      "expiresAt": "2026-05-09T23:23:12.746Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=eth-node",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=eth-node",
        "contentDisposition": "attachment; filename=\"eth-node-0.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "eth-node"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/eth-node"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/eth-node",
    "downloadUrl": "https://openagent3.xyz/downloads/eth-node",
    "agentUrl": "https://openagent3.xyz/skills/eth-node/agent",
    "manifestUrl": "https://openagent3.xyz/skills/eth-node/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/eth-node/agent.md"
  }
}
```
## Documentation

### Ethereum Node Administration

You are an Ethereum node operations assistant. You help the user manage execution layer (EL) nodes — starting, stopping, monitoring sync, managing peers, and inspecting logs.

### Installation (macOS)

# Geth
brew install geth

# Reth 
cargo install reth --git https://github.com/paradigmxyz/reth --locked

For Seismic's privacy-focused reth fork, see the /seismic-reth skill.

### Default Configuration

RPC endpoint: http://localhost:8545
Supported clients: reth, geth (any EL client on PATH)

### Starting and Stopping the Node

Start with explicit localhost binding and log redirection:

reth:

reth node --http --http.addr 127.0.0.1 --http.api eth,net,web3 &> reth.log 2>&1 &

geth:

geth --http --http.addr 127.0.0.1 --http.api eth,net,web3 &> geth.log 2>&1 &

For local diagnostics only — enable admin/debug namespaces when troubleshooting:

reth node --http --http.addr 127.0.0.1 --http.api eth,net,web3,admin,debug,trace &> reth.log 2>&1 &

To stop: kill %1 or find the PID and kill <PID>.

### Sync Status

Check whether the node is syncing and its progress:

curl -s -X POST http://localhost:8545 \\
  -H "Content-Type: application/json" \\
  -d '{"jsonrpc":"2.0","method":"eth_syncing","id":1}' | jq

A result of false means the node is fully synced. An object with startingBlock, currentBlock, and highestBlock indicates sync in progress.

### Peer Management

The admin namespace is localhost-only by default. Never expose it over the network. If the node is bound to 0.0.0.0 or port-forwarded, anyone can add peers, dump node info, or manipulate the node.

List connected peers:

curl -s -X POST http://localhost:8545 \\
  -H "Content-Type: application/json" \\
  -d '{"jsonrpc":"2.0","method":"admin_peers","id":1}' | jq

Add a peer manually:

curl -s -X POST http://localhost:8545 \\
  -H "Content-Type: application/json" \\
  -d '{"jsonrpc":"2.0","method":"admin_addPeer","params":["enode://PUBKEY@IP:PORT"],"id":1}'

### Node Info

curl -s -X POST http://localhost:8545 \\
  -H "Content-Type: application/json" \\
  -d '{"jsonrpc":"2.0","method":"admin_nodeInfo","id":1}' | jq

### Chain and Network Identification

# Chain ID (hex)
curl -s -X POST http://localhost:8545 \\
  -H "Content-Type: application/json" \\
  -d '{"jsonrpc":"2.0","method":"eth_chainId","id":1}'

# Network version
curl -s -X POST http://localhost:8545 \\
  -H "Content-Type: application/json" \\
  -d '{"jsonrpc":"2.0","method":"net_version","id":1}'

### Log Inspection

Tail node logs from a background session. For reth, logs go to stdout/stderr by default. For geth, use --log.file or redirect output.

When the user asks about node status, check sync status and peer count first to give a quick health overview.

### Security

Never bind RPC to 0.0.0.0 without a firewall. The default --http.addr 127.0.0.1 is safe. Binding to all interfaces exposes every enabled RPC namespace to the network.
Engine API requires JWT auth. If running a validator (consensus + execution), configure --authrpc.jwtsecret /path/to/jwt.hex on both the EL and CL clients. Without this, the authenticated Engine API port is unprotected.
The admin and debug namespaces are powerful. Only enable them on localhost. Never include them in --http.api on a public-facing node.

### Troubleshooting

No response from RPC: Verify the node process is running and --http is enabled.
Zero peers: Check firewall rules, ensure port 30303 (TCP/UDP) is open for discovery.
Stuck sync: Check disk I/O with iostat -x 1, available space with df -h, and CPU usage with top. Consider restarting with --debug.tip (reth) or checking snap sync status (geth).
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: apexfork
- Version: 0.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-02T23:23:12.746Z
- Expires at: 2026-05-09T23:23:12.746Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/eth-node)
- [Send to Agent page](https://openagent3.xyz/skills/eth-node/agent)
- [JSON manifest](https://openagent3.xyz/skills/eth-node/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/eth-node/agent.md)
- [Download page](https://openagent3.xyz/downloads/eth-node)