btcd-skill-beta

# BTCD PGP Collateralization Flow

This skill contains a **complete, self-contained** Node.js project to run the full BTCD collateralization lifecycle on the PGP (Elastos) chain.

## Bundled Code Location

All runnable code is inside the `scripts/` directory relative to this SKILL.md:

```
scripts/
├── package.json
├── .env.template.txt
├── setup.js
├── 00-create-order.js
├── 01-take-order.js
├── 02-lock-btc-collateral.js
├── 03-submit-btc-proof.js
├── 05-claim-btcd-tokens.js
├── 06-repay-loan.js
├── abi/                    # Contract ABIs (LoanContract, Order, Issuer, ERC20, ArbitratorManager)
├── utils/                  # Shared utilities (config, wallet, EVM/BTC clients, logger, state, proof, arbiter)
└── state/                  # Flow state persists here
```

## Setup Instructions

1. **Copy the entire `scripts/` directory** to a working directory:
   ```bash
   cp -r <path-to-this-skill>/scripts/ /tmp/btcd-flow/
   cd /tmp/btcd-flow/
   ```

2. **Create `.env`** from the template. Only two values need changing:
   ```bash
   cp .env.template.txt .env
   ```
   Edit `.env` and set:
   - `EVM_PRIVATE_KEY` — your EVM private key (with `0x` prefix)
   - `BTC_PRIVATE_KEY` — your BTC private key (hex, **no** `0x` prefix)

   Optionally adjust `LENDING_AMOUNT` (minimum 10) and `LENDING_DAYS` (only 90 or 180).

   All other values (contract addresses, RPC URLs, subgraph URLs) are **fixed for PGP chain** and must not be changed.

3. **Install dependencies:**
   ```bash
   npm install
   ```

4. **Ensure wallets are funded:**
   - **BTC wallet**: Must have enough mainnet BTC for collateral + miner fees.
   - **EVM wallet**: Must have PGA tokens for gas fees on PGP chain. To get PGA tokens, go to **https://swap.pgpgas.org** — you need USDT on BSC chain, bridge it to PGP, then swap for PGA tokens and/or BTCD.

## CRITICAL: Check State Before Running

**Before running any step**, always read `state/flow-state.json` to u...