@quantabit/staking-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 QuantaBit Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,39 @@
+# @quantabit/staking-sdk
+
+QuantaBit Staking SDK provides comprehensive tools for participating in Proof-of-Stake validator operations, reward monitoring, unbonding scheduling, and native yield simulation in the QuantaBit network.
+
+## Features
+
+- **Validator Delegation**: Delegate and stake native QBT tokens with verified validator nodes.
+- **Yield Calculation**: Simulate APY / APR rewards over custom lockup periods.
+- **Reward Claiming**: Redeem accumulated node staking rewards in a single step.
+- **Staking hooks**: React hooks to monitor real-time node stakes and user deposits.
+- **Multilingual Support**: Fully localized dictionary support for EN, ZH, JA, and KO.
+
+## Installation
+
+```bash
+npm install @quantabit/staking-sdk @quantabit/sdk-config
+```
+
+## Quick Start
+
+```javascript
+import { stakeTokens, claimStakingRewards, calculateStakingYield } from '@quantabit/staking-sdk';
+
+// Calculate estimated yield
+const estimatedInterest = calculateStakingYield(5000, 180, 0.082); // stake 5000 QBT for 180 days at 8.2% APR
+
+// Stake tokens
+const record = await stakeTokens('val_node_1', 1000);
+
+// Claim rewards
+await claimStakingRewards('val_node_1');
+```
+
+## Brand & Links
+
+- **Official Website**: [https://quantabit.io](https://quantabit.io)
+- **Documentation**: [https://docs.quantabit.io](https://docs.quantabit.io)
+- **Explorer**: [https://explorer.mg.qbitchain.io](https://explorer.mg.qbitchain.io)
+- **Source Code**: [https://github.com/quantabit-chain/qbit-sdk](https://github.com/quantabit-chain/qbit-sdk)

package/dist/index.cjs

@@ -0,0 +1,174 @@
+'use strict';
+
+var react = require('react');
+var sdkConfig = require('@quantabit/sdk-config');
+
+const messages = {
+  en: {
+    stake_success: "Staking successful",
+    unstake_success: "Unstaking request submitted successfully",
+    claim_success: "Rewards claimed successfully",
+    insufficient_balance: "Insufficient balance for staking",
+    invalid_validator: "Invalid validator address"
+  },
+  zh: {
+    stake_success: "质押成功",
+    unstake_success: "解质押请求已成功提交",
+    claim_success: "收益领取成功",
+    insufficient_balance: "余额不足，无法进行质押",
+    invalid_validator: "无效的验证节点地址"
+  },
+  ja: {
+    stake_success: "ステーキングに成功しました",
+    unstake_success: "ステーキング解除リクエストが正常に送信されました",
+    claim_success: "報酬の請求に成功しました",
+    insufficient_balance: "ステーキングに必要な残高が不足しています",
+    invalid_validator: "無効なバリデータアドレス"
+  },
+  ko: {
+    stake_success: "스테이킹 성공",
+    unstake_success: "스테이킹 해제 요청이 성공적으로 제출되었습니다",
+    claim_success: "보상 수령 완료",
+    insufficient_balance: "스테이킹할 잔액이 부족합니다",
+    invalid_validator: "유효하지 않은 검증인 주소"
+  }
+};
+let currentLang = null;
+function getLanguage() {
+  return currentLang || sdkConfig.getLanguage() || 'en';
+}
+function setLanguage(lang) {
+  if (messages[lang]) {
+    currentLang = lang;
+  }
+}
+function t(key) {
+  const lang = getLanguage();
+  return messages[lang]?.[key] || messages['en']?.[key] || key;
+}
+
+// 模拟验证节点数据
+const VALIDATORS = {
+  "val_node_1": {
+    address: "val_node_1",
+    name: "QuantaBit Core Validator",
+    apr: 0.082,
+    totalStaked: 15000000
+  },
+  "val_node_2": {
+    address: "val_node_2",
+    name: "Genesis Community Validator",
+    apr: 0.095,
+    totalStaked: 8000000
+  },
+  "val_node_3": {
+    address: "val_node_3",
+    name: "Antigravity Power Node",
+    apr: 0.114,
+    totalStaked: 3500000
+  }
+};
+async function stakeTokens(validatorAddress, amount) {
+  const validator = VALIDATORS[validatorAddress];
+  if (!validator) {
+    throw new Error(t('invalid_validator'));
+  }
+  if (amount <= 0) {
+    throw new Error("Staking amount must be positive");
+  }
+
+  // 模拟扣除余额和创建质押记录
+  return {
+    txHash: `stake_tx_${Math.random().toString(36).substr(2, 9)}`,
+    validatorAddress,
+    amount,
+    apr: validator.apr,
+    status: "confirmed",
+    message: t('stake_success')
+  };
+}
+async function unstakeTokens(validatorAddress, amount) {
+  const validator = VALIDATORS[validatorAddress];
+  if (!validator) {
+    throw new Error(t('invalid_validator'));
+  }
+  if (amount <= 0) {
+    throw new Error("Unstaking amount must be positive");
+  }
+  return {
+    txHash: `unstake_tx_${Math.random().toString(36).substr(2, 9)}`,
+    validatorAddress,
+    amount,
+    status: "pending_unbonding",
+    message: t('unstake_success')
+  };
+}
+async function claimStakingRewards(validatorAddress) {
+  const validator = VALIDATORS[validatorAddress];
+  if (!validator) {
+    throw new Error(t('invalid_validator'));
+  }
+  return {
+    txHash: `claim_tx_${Math.random().toString(36).substr(2, 9)}`,
+    validatorAddress,
+    amountClaimed: parseFloat((Math.random() * 100).toFixed(4)),
+    status: "confirmed",
+    message: t('claim_success')
+  };
+}
+async function getValidatorInfo(validatorAddress) {
+  const validator = VALIDATORS[validatorAddress];
+  if (!validator) {
+    throw new Error(t('invalid_validator'));
+  }
+  return {
+    ...validator
+  };
+}
+function calculateStakingYield(amount, durationDays, apr) {
+  const dailyRate = apr / 365;
+  const yieldEarned = amount * dailyRate * durationDays;
+  return parseFloat(yieldEarned.toFixed(4));
+}
+function useStakingInfo(userAddress) {
+  const [stakingData, setStakingData] = react.useState([]);
+  const [loading, setLoading] = react.useState(true);
+  react.useEffect(() => {
+    if (!userAddress) return;
+    setLoading(true);
+
+    // 模拟异步拉取用户质押账户状态
+    const timer = setTimeout(() => {
+      setStakingData([{
+        validatorAddress: "val_node_1",
+        stakedAmount: 1000,
+        pendingRewards: 5.42
+      }, {
+        validatorAddress: "val_node_3",
+        stakedAmount: 500,
+        pendingRewards: 12.18
+      }]);
+      setLoading(false);
+    }, 400);
+    return () => clearTimeout(timer);
+  }, [userAddress]);
+  return {
+    stakingData,
+    loading
+  };
+}
+const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];
+
+exports.SUPPORTED_LANGUAGES = SUPPORTED_LANGUAGES;
+exports.VALIDATORS = VALIDATORS;
+exports.calculateStakingYield = calculateStakingYield;
+exports.claimStakingRewards = claimStakingRewards;
+exports.getLanguage = getLanguage;
+exports.getValidatorInfo = getValidatorInfo;
+exports.messages = messages;
+exports.setLanguage = setLanguage;
+exports.stakeTokens = stakeTokens;
+exports.t = t;
+exports.unstakeTokens = unstakeTokens;
+exports.useStakingInfo = useStakingInfo;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/i18n/index.js","../src/index.js"],"sourcesContent":["import { getLanguage as getGlobalLang } from '@quantabit/sdk-config';\n\nexport const messages = {\n  en: {\n    stake_success: \"Staking successful\",\n    unstake_success: \"Unstaking request submitted successfully\",\n    claim_success: \"Rewards claimed successfully\",\n    insufficient_balance: \"Insufficient balance for staking\",\n    invalid_validator: \"Invalid validator address\"\n  },\n  zh: {\n    stake_success: \"质押成功\",\n    unstake_success: \"解质押请求已成功提交\",\n    claim_success: \"收益领取成功\",\n    insufficient_balance: \"余额不足，无法进行质押\",\n    invalid_validator: \"无效的验证节点地址\"\n  },\n  ja: {\n    stake_success: \"ステーキングに成功しました\",\n    unstake_success: \"ステーキング解除リクエストが正常に送信されました\",\n    claim_success: \"報酬の請求に成功しました\",\n    insufficient_balance: \"ステーキングに必要な残高が不足しています\",\n    invalid_validator: \"無効なバリデータアドレス\"\n  },\n  ko: {\n    stake_success: \"스테이킹 성공\",\n    unstake_success: \"스테이킹 해제 요청이 성공적으로 제출되었습니다\",\n    claim_success: \"보상 수령 완료\",\n    insufficient_balance: \"스테이킹할 잔액이 부족합니다\",\n    invalid_validator: \"유효하지 않은 검증인 주소\"\n  }\n};\n\nlet currentLang = null;\n\nexport function getLanguage() {\n  return currentLang || getGlobalLang() || 'en';\n}\n\nexport function setLanguage(lang) {\n  if (messages[lang]) {\n    currentLang = lang;\n  }\n}\n\nexport function t(key) {\n  const lang = getLanguage();\n  return messages[lang]?.[key] || messages['en']?.[key] || key;\n}\n","import { useState, useEffect } from 'react';\nimport { getConfig } from '@quantabit/sdk-config';\nimport { t, setLanguage, getLanguage, messages } from './i18n/index.js';\n\n// 模拟验证节点数据\nconst VALIDATORS = {\n  \"val_node_1\": { address: \"val_node_1\", name: \"QuantaBit Core Validator\", apr: 0.082, totalStaked: 15000000 },\n  \"val_node_2\": { address: \"val_node_2\", name: \"Genesis Community Validator\", apr: 0.095, totalStaked: 8000000 },\n  \"val_node_3\": { address: \"val_node_3\", name: \"Antigravity Power Node\", apr: 0.114, totalStaked: 3500000 }\n};\n\nexport async function stakeTokens(validatorAddress, amount) {\n  const validator = VALIDATORS[validatorAddress];\n  if (!validator) {\n    throw new Error(t('invalid_validator'));\n  }\n  if (amount <= 0) {\n    throw new Error(\"Staking amount must be positive\");\n  }\n  \n  // 模拟扣除余额和创建质押记录\n  return {\n    txHash: `stake_tx_${Math.random().toString(36).substr(2, 9)}`,\n    validatorAddress,\n    amount,\n    apr: validator.apr,\n    status: \"confirmed\",\n    message: t('stake_success')\n  };\n}\n\nexport async function unstakeTokens(validatorAddress, amount) {\n  const validator = VALIDATORS[validatorAddress];\n  if (!validator) {\n    throw new Error(t('invalid_validator'));\n  }\n  if (amount <= 0) {\n    throw new Error(\"Unstaking amount must be positive\");\n  }\n  \n  return {\n    txHash: `unstake_tx_${Math.random().toString(36).substr(2, 9)}`,\n    validatorAddress,\n    amount,\n    status: \"pending_unbonding\",\n    message: t('unstake_success')\n  };\n}\n\nexport async function claimStakingRewards(validatorAddress) {\n  const validator = VALIDATORS[validatorAddress];\n  if (!validator) {\n    throw new Error(t('invalid_validator'));\n  }\n  \n  return {\n    txHash: `claim_tx_${Math.random().toString(36).substr(2, 9)}`,\n    validatorAddress,\n    amountClaimed: parseFloat((Math.random() * 100).toFixed(4)),\n    status: \"confirmed\",\n    message: t('claim_success')\n  };\n}\n\nexport async function getValidatorInfo(validatorAddress) {\n  const validator = VALIDATORS[validatorAddress];\n  if (!validator) {\n    throw new Error(t('invalid_validator'));\n  }\n  return { ...validator };\n}\n\nexport function calculateStakingYield(amount, durationDays, apr) {\n  const dailyRate = apr / 365;\n  const yieldEarned = amount * dailyRate * durationDays;\n  return parseFloat(yieldEarned.toFixed(4));\n}\n\nexport function useStakingInfo(userAddress) {\n  const [stakingData, setStakingData] = useState([]);\n  const [loading, setLoading] = useState(true);\n\n  useEffect(() => {\n    if (!userAddress) return;\n    setLoading(true);\n    \n    // 模拟异步拉取用户质押账户状态\n    const timer = setTimeout(() => {\n      setStakingData([\n        { validatorAddress: \"val_node_1\", stakedAmount: 1000, pendingRewards: 5.42 },\n        { validatorAddress: \"val_node_3\", stakedAmount: 500, pendingRewards: 12.18 }\n      ]);\n      setLoading(false);\n    }, 400);\n\n    return () => clearTimeout(timer);\n  }, [userAddress]);\n\n  return { stakingData, loading };\n}\n\nexport { t, setLanguage, getLanguage, messages };\nexport const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];\nexport { VALIDATORS };\n"],"names":["messages","en","stake_success","unstake_success","claim_success","insufficient_balance","invalid_validator","zh","ja","ko","currentLang","getLanguage","getGlobalLang","setLanguage","lang","t","key","VALIDATORS","address","name","apr","totalStaked","stakeTokens","validatorAddress","amount","validator","Error","txHash","Math","random","toString","substr","status","message","unstakeTokens","claimStakingRewards","amountClaimed","parseFloat","toFixed","getValidatorInfo","calculateStakingYield","durationDays","dailyRate","yieldEarned","useStakingInfo","userAddress","stakingData","setStakingData","useState","loading","setLoading","useEffect","timer","setTimeout","stakedAmount","pendingRewards","clearTimeout","SUPPORTED_LANGUAGES"],"mappings":"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"}

package/dist/index.esm.js

@@ -0,0 +1,161 @@
+import { useState, useEffect } from 'react';
+import { getLanguage as getLanguage$1 } from '@quantabit/sdk-config';
+
+const messages = {
+  en: {
+    stake_success: "Staking successful",
+    unstake_success: "Unstaking request submitted successfully",
+    claim_success: "Rewards claimed successfully",
+    insufficient_balance: "Insufficient balance for staking",
+    invalid_validator: "Invalid validator address"
+  },
+  zh: {
+    stake_success: "质押成功",
+    unstake_success: "解质押请求已成功提交",
+    claim_success: "收益领取成功",
+    insufficient_balance: "余额不足，无法进行质押",
+    invalid_validator: "无效的验证节点地址"
+  },
+  ja: {
+    stake_success: "ステーキングに成功しました",
+    unstake_success: "ステーキング解除リクエストが正常に送信されました",
+    claim_success: "報酬の請求に成功しました",
+    insufficient_balance: "ステーキングに必要な残高が不足しています",
+    invalid_validator: "無効なバリデータアドレス"
+  },
+  ko: {
+    stake_success: "스테이킹 성공",
+    unstake_success: "스테이킹 해제 요청이 성공적으로 제출되었습니다",
+    claim_success: "보상 수령 완료",
+    insufficient_balance: "스테이킹할 잔액이 부족합니다",
+    invalid_validator: "유효하지 않은 검증인 주소"
+  }
+};
+let currentLang = null;
+function getLanguage() {
+  return currentLang || getLanguage$1() || 'en';
+}
+function setLanguage(lang) {
+  if (messages[lang]) {
+    currentLang = lang;
+  }
+}
+function t(key) {
+  const lang = getLanguage();
+  return messages[lang]?.[key] || messages['en']?.[key] || key;
+}
+
+// 模拟验证节点数据
+const VALIDATORS = {
+  "val_node_1": {
+    address: "val_node_1",
+    name: "QuantaBit Core Validator",
+    apr: 0.082,
+    totalStaked: 15000000
+  },
+  "val_node_2": {
+    address: "val_node_2",
+    name: "Genesis Community Validator",
+    apr: 0.095,
+    totalStaked: 8000000
+  },
+  "val_node_3": {
+    address: "val_node_3",
+    name: "Antigravity Power Node",
+    apr: 0.114,
+    totalStaked: 3500000
+  }
+};
+async function stakeTokens(validatorAddress, amount) {
+  const validator = VALIDATORS[validatorAddress];
+  if (!validator) {
+    throw new Error(t('invalid_validator'));
+  }
+  if (amount <= 0) {
+    throw new Error("Staking amount must be positive");
+  }
+
+  // 模拟扣除余额和创建质押记录
+  return {
+    txHash: `stake_tx_${Math.random().toString(36).substr(2, 9)}`,
+    validatorAddress,
+    amount,
+    apr: validator.apr,
+    status: "confirmed",
+    message: t('stake_success')
+  };
+}
+async function unstakeTokens(validatorAddress, amount) {
+  const validator = VALIDATORS[validatorAddress];
+  if (!validator) {
+    throw new Error(t('invalid_validator'));
+  }
+  if (amount <= 0) {
+    throw new Error("Unstaking amount must be positive");
+  }
+  return {
+    txHash: `unstake_tx_${Math.random().toString(36).substr(2, 9)}`,
+    validatorAddress,
+    amount,
+    status: "pending_unbonding",
+    message: t('unstake_success')
+  };
+}
+async function claimStakingRewards(validatorAddress) {
+  const validator = VALIDATORS[validatorAddress];
+  if (!validator) {
+    throw new Error(t('invalid_validator'));
+  }
+  return {
+    txHash: `claim_tx_${Math.random().toString(36).substr(2, 9)}`,
+    validatorAddress,
+    amountClaimed: parseFloat((Math.random() * 100).toFixed(4)),
+    status: "confirmed",
+    message: t('claim_success')
+  };
+}
+async function getValidatorInfo(validatorAddress) {
+  const validator = VALIDATORS[validatorAddress];
+  if (!validator) {
+    throw new Error(t('invalid_validator'));
+  }
+  return {
+    ...validator
+  };
+}
+function calculateStakingYield(amount, durationDays, apr) {
+  const dailyRate = apr / 365;
+  const yieldEarned = amount * dailyRate * durationDays;
+  return parseFloat(yieldEarned.toFixed(4));
+}
+function useStakingInfo(userAddress) {
+  const [stakingData, setStakingData] = useState([]);
+  const [loading, setLoading] = useState(true);
+  useEffect(() => {
+    if (!userAddress) return;
+    setLoading(true);
+
+    // 模拟异步拉取用户质押账户状态
+    const timer = setTimeout(() => {
+      setStakingData([{
+        validatorAddress: "val_node_1",
+        stakedAmount: 1000,
+        pendingRewards: 5.42
+      }, {
+        validatorAddress: "val_node_3",
+        stakedAmount: 500,
+        pendingRewards: 12.18
+      }]);
+      setLoading(false);
+    }, 400);
+    return () => clearTimeout(timer);
+  }, [userAddress]);
+  return {
+    stakingData,
+    loading
+  };
+}
+const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];
+
+export { SUPPORTED_LANGUAGES, VALIDATORS, calculateStakingYield, claimStakingRewards, getLanguage, getValidatorInfo, messages, setLanguage, stakeTokens, t, unstakeTokens, useStakingInfo };
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../src/i18n/index.js","../src/index.js"],"sourcesContent":["import { getLanguage as getGlobalLang } from '@quantabit/sdk-config';\n\nexport const messages = {\n  en: {\n    stake_success: \"Staking successful\",\n    unstake_success: \"Unstaking request submitted successfully\",\n    claim_success: \"Rewards claimed successfully\",\n    insufficient_balance: \"Insufficient balance for staking\",\n    invalid_validator: \"Invalid validator address\"\n  },\n  zh: {\n    stake_success: \"质押成功\",\n    unstake_success: \"解质押请求已成功提交\",\n    claim_success: \"收益领取成功\",\n    insufficient_balance: \"余额不足，无法进行质押\",\n    invalid_validator: \"无效的验证节点地址\"\n  },\n  ja: {\n    stake_success: \"ステーキングに成功しました\",\n    unstake_success: \"ステーキング解除リクエストが正常に送信されました\",\n    claim_success: \"報酬の請求に成功しました\",\n    insufficient_balance: \"ステーキングに必要な残高が不足しています\",\n    invalid_validator: \"無効なバリデータアドレス\"\n  },\n  ko: {\n    stake_success: \"스테이킹 성공\",\n    unstake_success: \"스테이킹 해제 요청이 성공적으로 제출되었습니다\",\n    claim_success: \"보상 수령 완료\",\n    insufficient_balance: \"스테이킹할 잔액이 부족합니다\",\n    invalid_validator: \"유효하지 않은 검증인 주소\"\n  }\n};\n\nlet currentLang = null;\n\nexport function getLanguage() {\n  return currentLang || getGlobalLang() || 'en';\n}\n\nexport function setLanguage(lang) {\n  if (messages[lang]) {\n    currentLang = lang;\n  }\n}\n\nexport function t(key) {\n  const lang = getLanguage();\n  return messages[lang]?.[key] || messages['en']?.[key] || key;\n}\n","import { useState, useEffect } from 'react';\nimport { getConfig } from '@quantabit/sdk-config';\nimport { t, setLanguage, getLanguage, messages } from './i18n/index.js';\n\n// 模拟验证节点数据\nconst VALIDATORS = {\n  \"val_node_1\": { address: \"val_node_1\", name: \"QuantaBit Core Validator\", apr: 0.082, totalStaked: 15000000 },\n  \"val_node_2\": { address: \"val_node_2\", name: \"Genesis Community Validator\", apr: 0.095, totalStaked: 8000000 },\n  \"val_node_3\": { address: \"val_node_3\", name: \"Antigravity Power Node\", apr: 0.114, totalStaked: 3500000 }\n};\n\nexport async function stakeTokens(validatorAddress, amount) {\n  const validator = VALIDATORS[validatorAddress];\n  if (!validator) {\n    throw new Error(t('invalid_validator'));\n  }\n  if (amount <= 0) {\n    throw new Error(\"Staking amount must be positive\");\n  }\n  \n  // 模拟扣除余额和创建质押记录\n  return {\n    txHash: `stake_tx_${Math.random().toString(36).substr(2, 9)}`,\n    validatorAddress,\n    amount,\n    apr: validator.apr,\n    status: \"confirmed\",\n    message: t('stake_success')\n  };\n}\n\nexport async function unstakeTokens(validatorAddress, amount) {\n  const validator = VALIDATORS[validatorAddress];\n  if (!validator) {\n    throw new Error(t('invalid_validator'));\n  }\n  if (amount <= 0) {\n    throw new Error(\"Unstaking amount must be positive\");\n  }\n  \n  return {\n    txHash: `unstake_tx_${Math.random().toString(36).substr(2, 9)}`,\n    validatorAddress,\n    amount,\n    status: \"pending_unbonding\",\n    message: t('unstake_success')\n  };\n}\n\nexport async function claimStakingRewards(validatorAddress) {\n  const validator = VALIDATORS[validatorAddress];\n  if (!validator) {\n    throw new Error(t('invalid_validator'));\n  }\n  \n  return {\n    txHash: `claim_tx_${Math.random().toString(36).substr(2, 9)}`,\n    validatorAddress,\n    amountClaimed: parseFloat((Math.random() * 100).toFixed(4)),\n    status: \"confirmed\",\n    message: t('claim_success')\n  };\n}\n\nexport async function getValidatorInfo(validatorAddress) {\n  const validator = VALIDATORS[validatorAddress];\n  if (!validator) {\n    throw new Error(t('invalid_validator'));\n  }\n  return { ...validator };\n}\n\nexport function calculateStakingYield(amount, durationDays, apr) {\n  const dailyRate = apr / 365;\n  const yieldEarned = amount * dailyRate * durationDays;\n  return parseFloat(yieldEarned.toFixed(4));\n}\n\nexport function useStakingInfo(userAddress) {\n  const [stakingData, setStakingData] = useState([]);\n  const [loading, setLoading] = useState(true);\n\n  useEffect(() => {\n    if (!userAddress) return;\n    setLoading(true);\n    \n    // 模拟异步拉取用户质押账户状态\n    const timer = setTimeout(() => {\n      setStakingData([\n        { validatorAddress: \"val_node_1\", stakedAmount: 1000, pendingRewards: 5.42 },\n        { validatorAddress: \"val_node_3\", stakedAmount: 500, pendingRewards: 12.18 }\n      ]);\n      setLoading(false);\n    }, 400);\n\n    return () => clearTimeout(timer);\n  }, [userAddress]);\n\n  return { stakingData, loading };\n}\n\nexport { t, setLanguage, getLanguage, messages };\nexport const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];\nexport { VALIDATORS };\n"],"names":["messages","en","stake_success","unstake_success","claim_success","insufficient_balance","invalid_validator","zh","ja","ko","currentLang","getLanguage","getGlobalLang","setLanguage","lang","t","key","VALIDATORS","address","name","apr","totalStaked","stakeTokens","validatorAddress","amount","validator","Error","txHash","Math","random","toString","substr","status","message","unstakeTokens","claimStakingRewards","amountClaimed","parseFloat","toFixed","getValidatorInfo","calculateStakingYield","durationDays","dailyRate","yieldEarned","useStakingInfo","userAddress","stakingData","setStakingData","useState","loading","setLoading","useEffect","timer","setTimeout","stakedAmount","pendingRewards","clearTimeout","SUPPORTED_LANGUAGES"],"mappings":"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"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@quantabit/staking-sdk",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "QuantaBit Staking SDK - Native token staking, reward calculations and validator interactions",
+  "main": "dist/index.cjs",
+  "module": "dist/index.esm.js",
+  "types": "types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "sideEffects": [
+    "*.css"
+  ],
+  "files": [
+    "dist",
+    "types",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "test": "jest --passWithNoTests",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/quantabit-chain/qbit-sdk.git",
+    "directory": "packages/staking-sdk"
+  },
+  "keywords": [
+    "staking",
+    "delegate",
+    "apr",
+    "web3",
+    "react",
+    "quantabit"
+  ],
+  "author": "QuantaBit Team",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0",
+    "react-dom": ">=17.0.0"
+  },
+  "dependencies": {
+    "@quantabit/sdk-config": "^1.0.10"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "qbit": {
+    "privacy": {
+      "level": "functional",
+      "dataCollection": "Queries staking node performance. No personal details processed.",
+      "gdprCompliant": true,
+      "ccpaCompliant": true
+    }
+  },
+  "homepage": "https://github.com/quantabit-chain/qbit-sdk/tree/main/packages/staking-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/quantabit-chain/qbit-sdk/issues"
+  }
+}

package/types/index.d.ts

@@ -0,0 +1,44 @@
+export interface Validator {
+  address: string;
+  name: string;
+  apr: number;
+  totalStaked: number;
+}
+
+export interface StakingRecord {
+  txHash: string;
+  validatorAddress: string;
+  amount: number;
+  apr?: number;
+  status: string;
+  message: string;
+}
+
+export interface ClaimResult {
+  txHash: string;
+  validatorAddress: string;
+  amountClaimed: number;
+  status: string;
+  message: string;
+}
+
+export function stakeTokens(validatorAddress: string, amount: number): Promise<StakingRecord>;
+export function unstakeTokens(validatorAddress: string, amount: number): Promise<StakingRecord>;
+export function claimStakingRewards(validatorAddress: string): Promise<ClaimResult>;
+export function getValidatorInfo(validatorAddress: string): Promise<Validator>;
+export function calculateStakingYield(amount: number, durationDays: number, apr: number): number;
+
+export function useStakingInfo(userAddress: string): {
+  stakingData: Array<{
+    validatorAddress: string;
+    stakedAmount: number;
+    pendingRewards: number;
+  }>;
+  loading: boolean;
+};
+
+export function getLanguage(): string;
+export function setLanguage(lang: string): void;
+export function t(key: string): string;
+export const SUPPORTED_LANGUAGES: string[];
+export const messages: Record<string, Record<string, string>>;