# Send Stakingverse Ethereum 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": "stakingverse-ethereum",
    "name": "Stakingverse Ethereum",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/LUKSOAgent/stakingverse-ethereum",
    "canonicalUrl": "https://clawhub.ai/LUKSOAgent/stakingverse-ethereum",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/stakingverse-ethereum",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=stakingverse-ethereum",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/check-state.js",
      "scripts/position.js",
      "scripts/stake.mjs"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "stakingverse-ethereum",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T17:19:54.734Z",
      "expiresAt": "2026-05-07T17:19:54.734Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=stakingverse-ethereum",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=stakingverse-ethereum",
        "contentDisposition": "attachment; filename=\"stakingverse-ethereum-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "stakingverse-ethereum"
      },
      "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/stakingverse-ethereum"
    },
    "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/stakingverse-ethereum",
    "downloadUrl": "https://openagent3.xyz/downloads/stakingverse-ethereum",
    "agentUrl": "https://openagent3.xyz/skills/stakingverse-ethereum/agent",
    "manifestUrl": "https://openagent3.xyz/skills/stakingverse-ethereum/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/stakingverse-ethereum/agent.md"
  }
}
```
## Documentation

### StakeWise Ethereum Staking Skill

Stake ETH on StakeWise V3 and receive osETH (liquid staking token). Earn staking rewards while keeping your ETH liquid.

### What This Skill Does

Stake ETH → Receive osETH tokens (handles state updates automatically)
Unstake ETH → Burn osETH for ETH
Check staked position → View vault shares and earned rewards
Monitor vault state → Check if keeper state update is required
Query harvest proofs → Get Merkle proofs from subgraph for deposits

### Required Credentials

Set these environment variables or edit the scripts:

export STAKEWISE_VAULT="0x8A93A876912c9F03F88Bc9114847cf5b63c89f56"
export KEEPER="0x6B5815467da09DaA7DC83Db21c9239d98Bb487b5"
export PRIVATE_KEY="your_private_key"
export MY_ADDRESS="your_address"
export RPC_URL="https://ethereum-rpc.publicnode.com"

### Quick Start

# Stake 0.1 ETH (auto-handles state updates)
node scripts/stake.mjs 0.1

# Check staked position
node scripts/position.js

# Unstake 0.05 osETH
node scripts/unstake.js 0.05

# Check if state update required
node scripts/check-state.js

### Architecture Overview

StakeWise V3 uses a keeper-oracle pattern for state updates:

User (EOA/UP)
    ↓
Vault Contract
    ↓
Keeper (Oracle) - Validates and processes rewards
    ↓
osETH Token - Liquid staking token

### Key Components

ComponentAddressPurposeVault0x8A93A876912c9F03F88Bc9114847cf5b63c89f56Staking/unstaking logicKeeper0x6B5815467da09DaA7DC83Db21c9239d98Bb487b5Oracle for state updatesosETH TokenDynamic per vaultLiquid staking tokenSubgraphhttps://graphs.stakewise.io/mainnet-a/subgraphs/name/stakewise/prodHarvest proofs and data

### The State Update Mechanism

Why state updates?

StakeWise accumulates rewards off-chain via validators
Keeper periodically "harvests" and posts state on-chain
Users can only deposit when state is current

When is state update required?

const vault = new ethers.Contract(vaultAddress, vaultAbi, provider);
const needsUpdate = await vault.isStateUpdateRequired();
// true = must update state before depositing

### Staking Flow (With State Update)

Step 1: Check State
    User
      ↓
    vault.isStateUpdateRequired()
      ↓
    Returns: true (update needed)

Step 2: Query Subgraph for Harvest Params
    User
      ↓
    POST to StakeWise subgraph
      ↓
    Returns: rewardsRoot, reward, unlockedMevReward, proof[]

Step 3: Update State and Deposit
    User
      ↓
    vault.updateStateAndDeposit(harvestParams, receiver, referrer)
      ↓
    Keeper validates harvest
      ↓
    Vault mints osETH to receiver
      ↓
    User receives osETH

### Stake ETH (Full Flow with State Update)

import { ethers } from 'ethers';
import fetch from 'node-fetch';

// Setup
const provider = new ethers.JsonRpcProvider(process.env.RPC_URL);
const wallet = new ethers.Wallet(process.env.PRIVATE_KEY, provider);

// Vault ABI (minimal)
const VAULT_ABI = [
  'function isStateUpdateRequired() view returns (bool)',
  'function updateStateAndDeposit(tuple(bytes32 rewardsRoot, uint256 reward, uint256 unlockedMevReward, bytes32[] proof) harvestParams, address receiver, address referrer) external payable',
  'function deposit(address receiver, address referrer) external payable'
];

const vault = new ethers.Contract(
  process.env.STAKEWISE_VAULT,
  VAULT_ABI,
  wallet
);

// Amount to stake
const stakeAmount = ethers.parseEther('0.1'); // 0.1 ETH

// Step 1: Check if state update required
const needsUpdate = await vault.isStateUpdateRequired();
console.log('State update required:', needsUpdate);

if (needsUpdate) {
  // Step 2: Query subgraph for harvest params
  const subgraphQuery = {
    query: \`
      query getHarvestProofs($vault: String!) {
        harvestProofs(
          where: { vault: $vault }
          orderBy: blockNumber
          orderDirection: desc
          first: 1
        ) {
          rewardsRoot
          reward
          unlockedMevReward
          proof
        }
      }
    \`,
    variables: {
      vault: process.env.STAKEWISE_VAULT.toLowerCase()
    }
  };

  const response = await fetch('https://graphs.stakewise.io/mainnet-a/subgraphs/name/stakewise/prod', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(subgraphQuery)
  });

  const data = await response.json();
  const harvestProof = data.data.harvestProofs[0];

  // Step 3: Call updateStateAndDeposit
  const harvestParams = {
    rewardsRoot: harvestProof.rewardsRoot,
    reward: BigInt(harvestProof.reward),
    unlockedMevReward: BigInt(harvestProof.unlockedMevReward),
    proof: harvestProof.proof
  };

  const tx = await vault.updateStateAndDeposit(
    harvestParams,
    process.env.MY_ADDRESS,  // receiver
    ethers.ZeroAddress,       // referrer (optional)
    { value: stakeAmount }
  );

  const receipt = await tx.wait();
  console.log(\`Staked ${ethers.formatEther(stakeAmount)} ETH with state update\`);
  console.log(\`Transaction: ${receipt.hash}\`);
} else {
  // Simple deposit (no state update needed)
  const tx = await vault.deposit(
    process.env.MY_ADDRESS,
    ethers.ZeroAddress,
    { value: stakeAmount }
  );

  const receipt = await tx.wait();
  console.log(\`Staked ${ethers.formatEther(stakeAmount)} ETH\`);
  console.log(\`Transaction: ${receipt.hash}\`);
}

### Check Staked Position

const OSETH_ABI = [
  'function balanceOf(address) view returns (uint256)',
  'function convertToAssets(uint256 shares) view returns (uint256)'
];

// Get osETH token address from vault
const osEthAddress = await vault.osToken();
const osEth = new ethers.Contract(osEthAddress, OSETH_ABI, provider);

const osEthBalance = await osEth.balanceOf(process.env.MY_ADDRESS);
const underlyingEth = await osEth.convertToAssets(osEthBalance);

console.log(\`osETH Balance: ${ethers.formatEther(osEthBalance)}\`);
console.log(\`Equivalent ETH: ${ethers.formatEther(underlyingEth)}\`);

### Unstake ETH

const VAULT_FULL_ABI = [
  'function redeem(uint256 shares, address receiver, address owner) returns (uint256 assets)',
  'function maxRedeem(address owner) view returns (uint256)'
];

const vaultFull = new ethers.Contract(
  process.env.STAKEWISE_VAULT,
  VAULT_FULL_ABI,
  wallet
);

// Check max redeemable
const maxShares = await vaultFull.maxRedeem(process.env.MY_ADDRESS);
console.log(\`Max redeemable: ${ethers.formatEther(maxShares)} osETH\`);

// Redeem shares for ETH
const sharesToRedeem = ethers.parseEther('0.05');
const tx = await vaultFull.redeem(
  sharesToRedeem,
  process.env.MY_ADDRESS,  // receiver
  process.env.MY_ADDRESS   // owner
);

const receipt = await tx.wait();
console.log(\`Redeemed ${ethers.formatEther(sharesToRedeem)} osETH for ETH\`);
console.log(\`Transaction: ${receipt.hash}\`);

### Get Latest Harvest Proof

const query = {
  query: \`
    query {
      harvestProofs(
        orderBy: blockNumber
        orderDirection: desc
        first: 1
      ) {
        id
        vault
        rewardsRoot
        reward
        unlockedMevReward
        proof
        blockNumber
      }
    }
  \`
};

const response = await fetch('https://graphs.stakewise.io/mainnet-a/subgraphs/name/stakewise/prod', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(query)
});

const data = await response.json();
console.log(data.data.harvestProofs[0]);

### Get Vault State

const query = {
  query: \`
    query {
      vaults(first: 1) {
        id
        address
        totalAssets
        totalShares
        apr
      }
    }
  \`
};

### "State update required"

The keeper hasn't posted recent rewards
Query subgraph for latest harvest proof
Use updateStateAndDeposit() instead of deposit()

### "Invalid harvest proof"

Proof may be outdated
Always query subgraph immediately before depositing
Proofs are block-specific

### "Insufficient shares"

Trying to redeem more osETH than you have
Check balance: osETH.balanceOf(yourAddress)

### "Vault is paused"

Emergency pause may be active
Check: vault.paused()
Wait for StakeWise team to unpause

### Important Notes

APY varies: Based on Ethereum validator rewards, typically 3-5%
osETH is rebasing: Balance increases automatically as rewards accrue
Keeper dependency: Deposits require valid state (keeper must be active)
Gas costs: State updates cost more gas than simple deposits
MEV rewards: Part of harvest includes MEV extraction rewards

### Resources

StakeWise App: https://app.stakewise.io
StakeWise Docs: https://docs.stakewise.io
Subgraph: https://graphs.stakewise.io/mainnet-a/subgraphs/name/stakewise/prod
Vault: 0x8A93A876912c9F03F88Bc9114847cf5b63c89f56
Keeper: 0x6B5815467da09DaA7DC83Db21c9239d98Bb487b5
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: LUKSOAgent
- Version: 1.0.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-04-30T17:19:54.734Z
- Expires at: 2026-05-07T17:19:54.734Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/stakingverse-ethereum)
- [Send to Agent page](https://openagent3.xyz/skills/stakingverse-ethereum/agent)
- [JSON manifest](https://openagent3.xyz/skills/stakingverse-ethereum/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/stakingverse-ethereum/agent.md)
- [Download page](https://openagent3.xyz/downloads/stakingverse-ethereum)