structs-energy

# Structs Energy Management

## Decision Tree

```
Need more capacity?
├── Have Alpha Matter?
│   ├── Infuse into a reactor (safest, immediate, 1g ≈ 1kW minus commission)
│   │   → See "Reactor Infusion" below
│   └── Infuse into a generator (higher ratio, IRREVERSIBLE, vulnerable to raids)
│       → See "Generator Infusion" below
└── No Alpha Matter?
    └── Buy energy from a provider via agreement
        → See "Buy Energy" below

Have surplus energy?
└── Sell it by creating a provider
    → See "Sell Energy" below
```

---

## Reactor Infusion (most common path)

Infusing Alpha Matter (ualpha) into a reactor immediately increases the player's capacity. This is the safest and most common way to get more energy.

### How It Works

When you infuse ualpha into a reactor, the system generates power equal to the amount infused. This power is split between you and the reactor based on the reactor's **commission rate**:

- **Player receives**: `power * (1 - commission)`
- **Reactor receives**: `power * commission`

The player's capacity increases automatically — no allocation or substation setup needed.

### Example

Infusing 3,000,000 ualpha into a reactor with 4% commission:

```json
{
  "destinationType": "reactor",
  "destinationId": "3-1",
  "fuel": "3000000",
  "power": "3000000",
  "commission": "0.040000000000000000",
  "playerId": "1-33"
}
```

- `fuel`: 3,000,000 ualpha infused
- `power`: 3,000,000 mW generated (1 ualpha = 1 mW = 0.001 W)
- Reactor keeps 4%: 120,000 mW (120 W)
- Player receives 96%: 2,880,000 mW (2,880 W) added to capacity

### Procedure

1. Check current capacity: `structsd query structs player [id]`
2. Choose a reactor (usually your guild's): `structsd query structs reactor [id]` — note the `commission` field
3. Infuse:

```
structsd tx structs reactor-infuse [your-address] [validator-address] [amount]ualpha --from [key-name] --gas auto --gas-adjustment 1.5 -y
```

**Important**: The amount **must include the denomination**, e.g. `60000000ual...