207 lines
6.6 KiB
Markdown
207 lines
6.6 KiB
Markdown
<!-- file: deltas/0.3.10/pre.006.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta `0.3.10-pre.006` — Transaction V1 + parité Yellowstone transaction/block
|
|
|
|
## Base requise
|
|
|
|
```text
|
|
livraison : 0.3.10-pre.005-fix.002
|
|
workspace.package.version = 0.3.10-pre.5.fix.2
|
|
```
|
|
|
|
Le gate opérateur communiqué le 2026-09-06 ferme cette baseline : audits statiques propres, `cargo check --workspace` PASS, Clippy strict PASS, common RAW PASS, 387 tests Transport avec suites publiques/release/doctests PASS, et suite Backfill complète PASS, y compris hardening et les deux canaris WS/Helius.
|
|
|
|
## Objectif
|
|
|
|
Fermer avant le Worker concret :
|
|
|
|
```text
|
|
Transaction V1 / SIMD-0385 dans la common source-neutral
|
|
Yellowstone Transaction -> transaction wire exact
|
|
Yellowstone Block -> même transaction wire + block_time
|
|
qualification RAW-direct vs hydration
|
|
```
|
|
|
|
Aucun adapter productif `Transport DTO -> common` n'est ajouté. `TR-C2` reste Worker-owned et `pre.007` reste le premier point où la crate Worker concrète peut apparaître.
|
|
|
|
## Version
|
|
|
|
```text
|
|
workspace.package.version = 0.3.10-pre.6
|
|
Cargo.toml header = 499
|
|
workspace members = 20
|
|
```
|
|
|
|
## Common wire Legacy/V0/V1
|
|
|
|
`ksp-raw-transaction-lib` ajoute un modèle source-neutral :
|
|
|
|
```text
|
|
RawSolanaMessageVersion
|
|
RawSolanaMessageHeader
|
|
RawSolanaCompiledInstruction
|
|
RawSolanaAddressTableLookup
|
|
RawSolanaTransactionConfig
|
|
RawSolanaTransactionMessage
|
|
RawSolanaTransactionWire
|
|
```
|
|
|
|
et deux serializers :
|
|
|
|
```text
|
|
serialize_solana_transaction_wire
|
|
serialize_solana_transaction_wire_base64
|
|
```
|
|
|
|
Legacy et V0 conservent le layout signatures-first existant. V1 suit SIMD-0385 : `0x81`, header, config mask, lifetime, compteurs, adresses, valeurs config, headers/payloads d'instructions et signatures terminales.
|
|
|
|
Les gardes V1 verrouillent notamment :
|
|
|
|
```text
|
|
transaction <= 4096 bytes
|
|
1..=12 signatures
|
|
<= 64 adresses
|
|
<= 64 instructions
|
|
num_readonly_signed < num_required_signatures
|
|
indexes programme/comptes bornés
|
|
aucune Address Lookup Table
|
|
aucune adresse dupliquée
|
|
config présente, y compris vide
|
|
aucun trailing byte après les signatures
|
|
```
|
|
|
|
Les goldens couvrent Legacy, V0, V1 configuration complète et V1 configuration vide.
|
|
|
|
## Extraction de signature V1
|
|
|
|
`extract_raw_transaction_signature_from_binary_base64` distingue désormais :
|
|
|
|
```text
|
|
premier octet == 0x81 -> parser V1 et signatures terminales
|
|
sinon -> parser short-vector signatures-first Legacy/V0
|
|
```
|
|
|
|
Le parser V1 parcourt structurellement mask/config, adresses, headers, payloads et signatures et exige la fin exacte du wire.
|
|
|
|
## Parité Yellowstone
|
|
|
|
`crates/ksp-job-backfill-lib/tests/yellowstone_raw_parity.rs` monte un serveur Geyser local déterministe, ouvre le vrai `YellowstoneGrpcChannel::open_standard_subscribe` puis reçoit :
|
|
|
|
```text
|
|
SubscribeUpdateTransaction V1
|
|
SubscribeUpdateBlock V1 portant la même transaction
|
|
```
|
|
|
|
La projection vers `RawSolanaTransactionWire` est strictement test-only. Le canari exige le même wire V1 exact pour les deux updates et vérifie slot, transaction index et `block_time` côté Block.
|
|
|
|
## Qualification RAW
|
|
|
|
Le gate ferme volontairement une qualification partielle :
|
|
|
|
```text
|
|
Yellowstone transaction wire = direct/fiable
|
|
Yellowstone Transaction RAW = hydration HTTP obligatoire : block_time absent
|
|
Yellowstone Block RAW complet= hydration HTTP obligatoire : meta JSON byte-identical non prouvée
|
|
```
|
|
|
|
Aucun champ manquant n'est inventé et aucune projection protobuf -> JSON ad hoc n'est introduite pour forcer un hash RAW identique.
|
|
|
|
## Dependency firewall
|
|
|
|
Le Backfill ajoute uniquement en dev :
|
|
|
|
```text
|
|
tonic = { workspace = true, features = ["codegen", "server"] }
|
|
yellowstone-grpc-proto = { workspace = true, features = ["tonic"] }
|
|
```
|
|
|
|
`dependency_boundary.rs` verrouille leur absence des dépendances production et `hardening.rs` recalibre le set dev exact. Les dépendances normales restent inchangées.
|
|
|
|
Il n'existe toujours aucun edge productif :
|
|
|
|
```text
|
|
ksp-onchain-transport-lib -> ksp-raw-transaction-lib
|
|
ksp-raw-transaction-lib -> ksp-onchain-transport-lib
|
|
```
|
|
|
|
## Fraîcheur externe revalidée
|
|
|
|
Revalidation le 2026-09-07 :
|
|
|
|
```text
|
|
SIMD-0385 : Transaction V1, status Review, version byte 129, signatures terminales, sans ALT
|
|
Solana Transaction V1 examples : capacité Yellowstone avec Message.config ; activation cluster encore feature-gated/pre-release
|
|
```
|
|
|
|
Sources :
|
|
|
|
```text
|
|
https://github.com/solana-foundation/solana-improvement-documents/blob/main/proposals/0385-transaction-v1.md
|
|
https://github.com/solana-foundation/transaction-v1-examples
|
|
https://github.com/rpcpool/yellowstone-grpc/blob/master/yellowstone-grpc-proto/proto/solana-storage.proto
|
|
```
|
|
|
|
KSP implémente la capacité de lecture/canonicalisation V1 sans déclarer son activation sur Mainnet ou un autre cluster.
|
|
|
|
## Fichiers ajoutés
|
|
|
|
```text
|
|
crates/ksp-job-backfill-lib/tests/yellowstone_raw_parity.rs
|
|
crates/ksp-raw-transaction-lib/src/wire.rs
|
|
crates/ksp-raw-transaction-lib/unit_tests/wire.rs
|
|
deltas/0.3.10/pre.006.md
|
|
```
|
|
|
|
## Fichiers modifiés
|
|
|
|
```text
|
|
Cargo.toml
|
|
crates/ksp-job-backfill-lib/Cargo.toml
|
|
crates/ksp-job-backfill-lib/tests/dependency_boundary.rs
|
|
crates/ksp-job-backfill-lib/tests/hardening.rs
|
|
crates/ksp-raw-transaction-lib/src/lib.rs
|
|
crates/ksp-raw-transaction-lib/src/signature.rs
|
|
crates/ksp-raw-transaction-lib/tests/dependency_boundary.rs
|
|
crates/ksp-raw-transaction-lib/tests/public_api.rs
|
|
crates/ksp-raw-transaction-lib/tests/release_completeness.rs
|
|
crates/ksp-raw-transaction-lib/unit_tests/signature.rs
|
|
docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md
|
|
docs/plans/031-V0_3_10_RAW_TRANSACTION_INGEST_PLAN.md
|
|
docs/validation/027-V0_3_10_RAW_TRANSACTION_INGEST.md
|
|
```
|
|
|
|
## Fichiers supprimés
|
|
|
|
Aucun.
|
|
|
|
## Gate opérateur demandé
|
|
|
|
```bash
|
|
cargo fmt --all
|
|
python3 scripts/audit_rust_workspace_rules.py
|
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
|
cargo check --workspace
|
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
|
cargo test -p ksp-raw-transaction-lib
|
|
cargo test -p ksp-onchain-transport-lib
|
|
cargo test -p ksp-job-backfill-lib
|
|
cargo tree -p ksp-job-backfill-lib --edges normal
|
|
cargo tree -p ksp-job-backfill-lib --edges dev
|
|
cargo tree -p ksp-job-backfill-lib -e features
|
|
```
|
|
|
|
Les arbres Cargo sont requis car `pre.006` ajoute deux dev-dependencies test-only.
|
|
|
|
## Décisions prises
|
|
|
|
```text
|
|
common sérialise Legacy/V0/V1 sans dépendre de Transport
|
|
V1 est reconnu par 0x81 et possède des signatures terminales
|
|
Yellowstone Transaction/Block conservent un transaction wire V1 exact sur canari
|
|
Yellowstone RAW complet reste hydraté par HTTP tant que TR-C4 meta/block_time complet n'est pas prouvé
|
|
aucun RAW v2 automatique
|
|
aucun Worker concret avant pre.007
|
|
TR-C2 reste Worker-owned
|
|
```
|