nanobook 0.14.0

Deterministic Rust execution engine for trading backtests: limit-order book, portfolio simulation, metrics, risk checks, and Python bindings
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

# Scripts

This directory contains utility scripts for nanobook operations.

## sanitize-audit.py

Publishable PII scrubber for nanobook audit logs.

### Purpose

Removes personally identifiable information (PII) from audit logs while preserving audit-log invariants needed for analysis:
- Sequence numbers (for cron mode idempotency)
- Timestamps (for clock skew detection)
- Order math (shares, prices, commission)
- Fill sequence (for reconciliation)

### PII Fields Scrubbed

- `account` - Account IDs in `run_started` events
- `ibkr_id` - Order IDs in `order_submitted` and `order_filled` events

### Usage

```bash
# Scrub an audit log (in-place)
python3 scripts/sanitize-audit.py audit.jsonl

# Scrub to a separate file
python3 scripts/sanitize-audit.py audit.jsonl audit_scrubbed.jsonl

# Check mode: verify no PII remains (exit code 1 if PII found)
python3 scripts/sanitize-audit.py --check audit.jsonl
```

### Idempotency

The script is idempotent — safe to run multiple times. Running it on an already-scrubbed file will report 0 lines with PII.

### Placeholder Values

- Account IDs: `"ACCOUNT_REDACTED"`
- Order IDs: `999999`

These placeholders are chosen to be clearly non-identifiable while preserving the data structure.