跳到主要内容

机构质押 API

机构质押 API 用于管理和操作 Ethereum 账户及资产。

Base URL​

https://stake.goldshell.com/api

认证​

所有方法都需要 API Key。请在请求头中包含：

Authorization: {your key}

请联系 GoldShell 官方获取密钥；不要将密钥提交到代码库或公开文档。

方法​

创建存款数据​

为一个或多个验证者生成可在链上广播的存款数据。

  • 方法：POST
  • URL：/v1/validators/institution/deposits
  • 请求字段：
    • num_validators：要创建的验证者数量（整数，必填）。
    • amount：每个验证者的 ETH 存款额，32 至 2048（整数，必填）。
    • eth1_withdrawal_address：提款 Ethereum 地址（字符串，必填）。
    • chain：网络名，例如 mainnet 或 hoodi（字符串，必填）。
  • 响应字段：deposits 包含每个验证者的 pubkey、withdrawal_credentials、amount、signature、deposit_message_root、deposit_data_root 和 network_name；calldata 可用于提交存款合约交易。
{
  "num_validators": 2,
  "amount": 32,
  "eth1_withdrawal_address": "0xYourWithdrawalAddress",
  "chain": "mainnet"
}

退出验证者​

为指定验证者创建退出请求。

  • 方法：POST
  • URL：/v1/validators/institution/exit
  • 请求字段：validators（待退出验证者公钥数组）和 network_type（网络名），均为必填。
  • 响应字段：validators 数组中的每个对象包含 public_key、successful，失败时还包含可选的 reason。
{
  "validators": ["0xValidatorPublicKey1", "0xValidatorPublicKey2"],
  "network_type": "mainnet"
}

创建部分提款数据​

为 0x02 类型验证者生成部分提款数据，提款后验证者余额不得低于 32 ETH。

  • 方法：POST
  • URL：/v1/validators/institution/partial-withdrawals
  • 请求字段：public_key、amount（1 至最大可提取数量）和 network_type，均为必填。
  • 响应字段：data，即可用于链上提交的提款合约 calldata。
{
  "public_key": "0xValidatorPublicKey",
  "amount": 2,
  "network_type": "mainnet"
}

创建补充存款数据​

为 0x02 类型验证者生成补充余额的存款数据，验证者余额上限为 2048 ETH。

  • 方法：POST
  • URL：/v1/validators/institution/top-up
  • 请求字段：public_key、amount、eth1_withdrawal_address 和 chain。
  • 响应包含存款对象和可提交至存款合约的 calldata。
{
  "public_key": "0xValidatorPublicKey",
  "amount": 20,
  "eth1_withdrawal_address": "0xYourWithdrawalAddress",
  "chain": "mainnet"
}