# 做市商快速上手

Source: https://docs.hedgehood.io/zh/earn-upfront/makers/quickstart

从白名单地址到在 Robinhood Chain 测试网上报价的机器人，共七步。示例用 Python SDK；[TypeScript](https://github.com/0xHedgeHood/hedgehood-maker-ts) 和 [Go](https://github.com/0xHedgeHood/hedgehood-maker-go) 客户端做的事完全一样。SDK 从不替你签名或发送交易：它打印未签名的交易，由你检查后自己发送。

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

## 1. 加入白名单

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

## 2. 授权热签名密钥

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

:::caution

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

:::

## 3. 出资

每个报价可以选择权利金怎么付（报价里的 `externalAccount`）：

| 出资方式 | `externalAccount` | 配置 |
|---|---|---|
| 结算合约余额 | `0x0` | `USDG.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. 打印并发送配置交易

```bash
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 买入，其余都拒绝。

```python
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` 时还会为你持有的多头报平仓价：

```bash
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 有抵押品）：

```bash
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` 按链上时间检查。

下一步：[到期结算](https://docs.hedgehood.io/zh/earn-upfront/makers/settlement)。
