# HyperGrowth FillShield Buyer Kit

This kit buys one `hyperliquid-fillshield` x402 artifact from
`https://api.hyper-growth.xyz`.

You do not need the HyperGrowth repository. Download these files into a new
directory and run the buyer helper from there.

The helper reads wallet secrets only from environment variables. Do not paste
private keys, payment signatures, or full payment payloads into chat or issue
comments.

## Fast Path

```bash
mkdir hypergrowth-fillshield-buyer
cd hypergrowth-fillshield-buyer
curl -fsSLO https://hyper-growth.xyz/buyer-kit/package.json
curl -fsSLO https://hyper-growth.xyz/buyer-kit/x402-buy-service.mjs
curl -fsSLO https://hyper-growth.xyz/buyer-kit/hyperliquid-fillshield.valid.json
npm install
export BUYER_WALLET_PRIVATE_KEY="<redacted>"
export X402_RPC_URL="https://mainnet.base.org"
npm run buy:fillshield
```

PowerShell:

```powershell
New-Item -ItemType Directory -Force hypergrowth-fillshield-buyer | Out-Null
Set-Location hypergrowth-fillshield-buyer
Invoke-WebRequest https://hyper-growth.xyz/buyer-kit/package.json -OutFile package.json
Invoke-WebRequest https://hyper-growth.xyz/buyer-kit/x402-buy-service.mjs -OutFile x402-buy-service.mjs
Invoke-WebRequest https://hyper-growth.xyz/buyer-kit/hyperliquid-fillshield.valid.json -OutFile hyperliquid-fillshield.valid.json
npm install
$env:BUYER_WALLET_PRIVATE_KEY = "<redacted>"
$env:X402_RPC_URL = "https://mainnet.base.org"
npm run buy:fillshield
```

## What The Helper Does

- Sends `POST https://api.hyper-growth.xyz/v1/hyperliquid-fillshield`.
- Treats HTTP `402` as the expected quote response.
- Builds the x402 payment payload from the quote.
- Retries the exact same URL, method, and body with `PAYMENT-SIGNATURE`.

The command caps spend at `100000` atomic USDC (`0.10` USDC) on Base and keeps
the same request body for quote and paid retry. Count success only when the
result reports `COMPLETED` with an artifact ref and receipt ref.