hak-stader-plugin

Hedera Agent Kit plugin for Stader liquid staking on Hedera.

Stake HBAR → receive HBARX (a yield-bearing liquid staking token). HBARX earns staking rewards while remaining transferable and usable in DeFi — enabling a full agent-driven yield loop with hak-saucerswap-plugin:

Stake HBAR → receive HBARX → LP on SaucerSwap → farm rewards

Installation

npm install hak-stader-plugin

Quick Start

import HederaAgentKit from "@hashgraph/hedera-agent-kit";
import { staderPlugin, STADER_MAINNET } from "hak-stader-plugin";

const agent = new HederaAgentKit(
  process.env.HEDERA_ACCOUNT_ID!,
  process.env.HEDERA_PRIVATE_KEY!,
  { network: "mainnet" }
);

agent.registerPlugin(staderPlugin, {
  ...STADER_MAINNET,
  network: "mainnet",
});

Or using environment variables (see docs/CONFIGURATION.md):

STADER_NETWORK=mainnet

agent.registerPlugin(staderPlugin);

Tools

| Tool | Type | Description | |------|------|-------------| | stader_stake_hbar | Transaction | Stake HBAR and receive HBARX | | stader_approve_hbarx | Transaction | Approve HBARX allowance before unstaking | | stader_unstake_hbar | Transaction | Initiate unstake (1-day unbonding) | | stader_claim_withdrawal | Transaction | Claim HBAR after unbonding period | | stader_get_pending_withdrawals | Query | List pending withdrawal requests | | stader_get_hbarx_balance | Query | Get HBARX token balance for an account | | stader_get_exchange_rate | Query | Get HBARX/HBAR exchange rate and TVL | | stader_get_staking_info | Query | Get protocol status (paused, unbonding time) |

See docs/TOOLS.md for full parameter reference.

Network Defaults

| Field | Mainnet | Testnet | |-------|---------|---------| | Staking contract | 0.0.1027588 | 0.0.48247334* | | Undelegation contract | 0.0.1027587 | 0.0.48247333* | | HBARX token | 0.0.834116 | 0.0.48247328* | | Treasury account | 0.0.1412503 | 0.0.48247329* |

* Testnet deployment is no longer active on the current Hedera testnet environment.

Unstaking Flow

Unstaking HBARX requires three steps:

1. Approve — stader_approve_hbarx (grant HBARX allowance to the staking contract)
2. Unstake — stader_unstake_hbar (burns HBARX, begins 1-day unbonding)
3. Claim — stader_claim_withdrawal (after unbonding, retrieves HBAR)

Exchange Rate Note

The on-chain getExchangeRate() function is deprecated and returns 1.0. This plugin computes the real rate from treasury_hbar / hbarx_supply via the Hedera Mirror Node. The true rate reflects accrued staking rewards (~1.4 HBAR/HBARX as of mid-2025).

License

MIT — Juanma Gomez