JLP Protocol Specification

struct AuthPayloadV2 {
    char     worker_name[64];   // UTF-8 worker name / BTC payout address
    char     password[32];      // Optional pool password (null-padded)
    uint64_t timestamp_ms;      // Client wall-clock time in ms (little-endian)
    uint8_t  nonce[16];         // Per-AUTH random nonce
};

struct WorkAssignment {
    uint8_t  public_key[33];    // Compressed secp256k1 target pubkey
    uint8_t  range_start[32];   // Big-endian 32-byte chunk start
    uint8_t  range_end[32];     // Big-endian 32-byte chunk end
    uint32_t dp_bits;           // Distinguished-point bit threshold (LE)
    uint64_t work_id;           // Low 64 bits of the chunk identifier (LE)

    // v3 additions
    uint8_t  kangaroo_type;     // 1=TAME_ONLY, 2=WILD_ONLY (0=BOTH reserved)
    uint64_t start_offset_a;    // Inclusive low 64 bits of worker's offset window
    uint64_t start_offset_b;    // Exclusive upper bound (b > a)
};

struct DistinguishedPointV2 {
    uint64_t work_id;           // Chunk id from the active WORK_ASN
    uint32_t sequence;          // Per-(worker, work_id) monotonic counter
    uint8_t  x[32];             // Big-endian X coordinate
    uint8_t  d[32];             // Big-endian walked distance
    uint8_t  type;              // 0=tame, 1=wild
    uint8_t  dp_bits;           // Leading-zero bit count required of x
};

struct DPBatchV2 {
    uint32_t count;             // 1 .. MAX_BATCH_SIZE (10,000)
    DistinguishedPointV2 dps[count];
};

// Wire size: 4 + (count * 78) bytes
// Server rejects any payload >= 1 MB (MAX_MESSAGE_SIZE).

struct DistinguishedPointV3 {
    uint64_t work_id;           // Chunk id from the active WORK_ASN
    uint32_t sequence;          // Per-(worker, work_id) monotonic counter
    uint8_t  x[32];             // Big-endian X coordinate
    uint8_t  d[32];             // Big-endian walked distance
    uint8_t  type;              // 0=tame, 1=wild
    uint8_t  dp_bits;           // Leading-zero bit count required of x
    uint8_t  ckpt_root[32];     // Merkle root over the walk's checkpoint
                                //   distances (one checkpoint every
                                //   CHECKPOINT_INTERVAL = 65536 jumps)
    uint32_t n_segments;        // Committed segment count (checkpoint_count - 1)
};

struct DPBatchV3 {
    uint32_t count;             // 1 .. MAX_BATCH_SIZE (10,000)
    DistinguishedPointV3 dps[count];
};

// Wire size: 4 + (count * 114) bytes

struct AuthOkPayload {
    uint8_t latest_version[16]; // ASCII semver of the latest client,
                                //   null-padded (e.g. "1.5.4")
    uint8_t min_version[16];    // ASCII semver of the minimum supported client
    uint8_t flags;              // bit0 = update_available,
                                //   bit1 = maintenance_active
    uint8_t reserved[3];
    uint8_t download_url[256];  // HTTPS URL of the latest signed binary,
                                //   null-padded; all-zero disables auto update
    uint8_t sha256[32];         // Raw SHA-256 of the binary at download_url
};

struct MaintenancePayload {
    uint8_t  active;            // 1 = maintenance in effect (back off),
                                //   0 = all clear (resume)
    uint8_t  reserved;
    uint32_t retry_after_secs;  // Suggested base reconnect backoff in seconds
                                //   (LE); client adds jitter
    uint8_t  message[256];      // Operator note, null-padded ASCII
};

struct PoolStats {
    uint64_t total_dps;         // Cumulative pool DP count
    uint32_t total_workers;     // Distinct worker names ever seen
    uint32_t active_workers;    // Workers active in last 5 minutes
    float    dps_per_second;    // Pool aggregate DP rate
    float    your_share;        // Fraction of total_dps for this worker name
    uint64_t your_dps;          // DPs credited to this worker name
    uint32_t uptime_seconds;    // Server uptime
};