跳到主要内容
Markdownllms.txt

做市商快速上手

从白名单地址到在 Robinhood Chain 测试网上报价的机器人,共七步。示例用 Python SDK;TypeScript 和 Go 客户端做的事完全一样。SDK 从不替你签名或发送交易:它打印未签名的交易,由你检查后自己发送。

pip install hedgehood-maker
git clone https://github.com/0xHedgeHood/hedgehood-maker-py && cd hedgehood-maker-py # 示例脚本在这里

1. 加入白名单​

把你的做市商地址发到 admin@hedgehood.io:这个账户的 USDG 用来支付权利金,多头也记在它名下。网关拒绝其他地址登录。

2. 授权热签名密钥​

让做市商密钥保持冷存储。从做市商地址调用 RfqSettler.setSigner(hotKey, expiresAt);在 expiresAt 之前,热密钥可以代表做市商登录并签名报价。只有 expiresAt > validUntil 的报价才有效,所以要在过期前轮换;setSigner(key, 0) 撤销授权。

警告

热签名密钥在过期前拥有做市商对结算合约余额和多头的全部权限。有效期要短,余额只放你打算报价的金额。

3. 出资​

每个报价可以选择权利金怎么付(报价里的 externalAccount):

出资方式externalAccount配置
结算合约余额0x0USDG.approve(settler, x),然后 deposit(USDG, maker, x)。取出时先 requestWithdraw,再在 5 分钟到 1 天 + 5 分钟之间 withdraw
钱包授权付款的钱包从该钱包 USDG.approve(settler, x);如果它不是做市商本人,还要调用一次 linkMaker(maker, true)

4. 允许结算合约交付你的多头(报平仓价才需要)​

要为提前平仓(side 1)报价,结算合约必须能转移你的多头:从做市商地址调用 OptionsCore.setOperator(settler, true)。只买不卖可以跳过。

5. 打印并发送配置交易​

python examples/onboard.py --maker 0xYourMaker --signer 0xYourHotKey --signer-days 7 --deposit 1000 --sell --rpc

它打印每笔未签名的交易(和一行 cast send),加上 --rpc 时还会显示你当前的链上状态:epoch、签名者、余额、授权额度、operator。Go 命令行用 hedgehood-maker tx … 和 hedgehood-maker state 做同样的事。逐笔检查后自己发送。

6. 连接机器人​

能跑通的最小做市商:对每个开仓询价按名义金额的 40 bps 买入,其余都拒绝。

import asyncio, os
from hedgehood_maker import MAKER_BUYS, RFQ, TESTNET, Decline, MakerClient
from hedgehood_maker.fees import notional

def price(rfq: RFQ):
if rfq.side != MAKER_BUYS:
return Decline("no_inventory")
return notional(rfq.amount, rfq.series.strike) * 40 // 10_000 # 权利金,USDG 原始单位,不含手续费

client = MakerClient(
TESTNET.gateway_ws,
os.environ["HEDGEHOOD_SIGNER_KEY"], # 第 2 步的热密钥
price,
maker="0xYourMaker",
chain_id=TESTNET.chain_id, settler=TESTNET.settler,
on_event=lambda f: print(f.type, f.raw), # won、lost、fill、rejected……
)
asyncio.run(client.run())

MakerClient 负责登录,在窗口内调用你的定价函数(留 150 毫秒余量,定价太慢就以 timeout 拒绝),用新的 nonce 和当前 epoch 构建并签名报价,按网关的规则先自查,断线后退避重连。examples/simple_maker.py 在此基础上加了 Black-Scholes 定价、含手续费的权利金计算,加 --sell 时还会为你持有的多头报平仓价:

export HEDGEHOOD_SIGNER_KEY=...
python examples/simple_maker.py --maker 0xYourMaker --mode vol --vol 0.6 --spot TSLA=390 --edge 0.05 --sell

7. 端到端测试​

自己发一个询价(报价用任意 taker 地址都行;成交需要 taker 有抵押品):

curl -s https://testnet-rfq.hedgehood.io/v1/rfq -H 'content-type: application/json' -d \
'{"underlying":"TSLA","expiry":<一个挂牌的纽约 16:00 收盘时间>,"strike":"400000000","isPut":true,
"side":0,"amount":"2000000000000000000","taker":"0xYourTestTaker"}'

你的机器人应该先记录到 rfq,然后是 won 或 lost。之后关注你的成绩单:https://testnet-rfq.hedgehood.io/v1/makers。

运营建议​

  • 每个询价都回复。 不想报的就拒绝;连续 20 个询价不回复会触发熔断。
  • 不要撤销已中标的报价。 收到 won 后再 increaseEpoch 或 invalidateNonces 就是失约;一小时内三次会被暂停。想停止报价,发送 {"type":"pause"}。
  • 每个未成交报价背后都要有资金。 因资金不足而回滚的成交同样会让用户失败。
  • 每个做市商只能有一个连接。 新的登录会顶掉旧的。
  • 时钟要同步 NTP。 validUntil 按链上时间检查。

下一步:到期结算。