Initial project state: .NET reference, design, Rust port (M0+M1), evidence
rust / build / test / clippy / fmt (push) Has been cancelled

Layout:
- src/                    .NET 10 x64 reference: MxNativeCodec, MxNativeClient,
                          MxAsbClient, probes, tests, harnesses. Executable spec.
- design/                 Architectural plan for the Rust port (M0–M6), error
                          model, protocol invariants, risks (R1–R16), adversarial
                          review log (review.md).
- rust/                   Rust workspace. M0 skeleton + M1 codec parity.
                          mxaccess-codec: 215 unit tests + 2 cross-implementation
                          parity tests (byte-identical against .NET reference).
                          Other crates are M0 stubs awaiting M2+.
- captures/               Frida + netsh + pcap evidence per CLAUDE.md
                          ("captures are evidence, not throwaway logs").
- analysis/               Decompiled C# (frida/proxy/decompiled-*),
                          Ghidra exports for native DLLs (`exports/` only —
                          working state at `projects/` and AVEVA's input
                          binaries at `input/` are gitignored).
- docs/                   Reverse-engineering reference docs.
- tools/                  Setup-LiveProbeEnv.ps1 (Infisical credential fetcher),
                          Compute-Crc.ps1 (.NET parity helper).
- .github/workflows/      Rust CI: fmt + build + test + clippy on Windows.
- LICENSE                 MIT (Joseph Doherty, 2026).

Verified:
- cargo test --workspace → 217 passed (215 unit + 2 .NET parity), 0 failed
- cargo clippy --workspace -- -D warnings → clean
- cargo fmt --all -- --check → clean
- cargo publish --dry-run -p mxaccess-codec → packages cleanly

Excluded from history (see .gitignore):
- **/bin, **/obj, **/target — build artifacts
- analysis/ghidra/projects/ — Ghidra working state (regenerable)
- analysis/ghidra/input/ — AVEVA proprietary DLLs (vendor IP)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Joseph Doherty
2026-05-05 06:21:00 -04:00
parent 43733699b0
commit fe2a6db786
3849 changed files with 352975 additions and 0 deletions
@@ -0,0 +1,55 @@
using ArchestrAServices.ASBIDataContract;
using ArchestrAServices.Contract;
namespace ArchestrAServices.ASBContract;
public interface IDataV2toV1
{
IAsbInterfaceSettings Settings { get; }
ArchestrAResult KeepAlive(ConnectionId Id);
void OnConnect(ConnectionId ConnectionId, ulong Timeout);
ArchestrAResult ActivateUser(ConnectionId Id, UserToken UserToken);
ArchestrAResult ExchangeCapabilities(out string ServiceCapabilities, ConnectionId Id, string ClientCapabilities);
ArchestrAResult Read(out ItemStatusV2[] Status, out RuntimeValue[] Values, ConnectionId Id, ItemIdentity[] Items);
ArchestrAResult Write(out ItemStatusV2[] Status, ConnectionId Id, ItemIdentity[] Items, WriteValueV2[] Values, uint WriteHandle);
ArchestrAResult WriteUser(out ItemStatusV2[] Status, ConnectionId Id, ItemIdentity[] Items, WriteValueV2[] Values, UserToken User, uint WriteHandle);
ArchestrAResult WriteVerified(out ItemStatusV2[] Status, ConnectionId Id, ItemIdentity[] Items, WriteValueV2[] Values, UserToken User, UserToken Supervisor, uint WriteHandle);
ArchestrAResult WriteSecured(out ItemStatusV2[] Status, ConnectionId Id, ItemIdentity[] Items, WriteValueV2[] Values, UserToken User, uint WriteHandle);
ArchestrAResult WriteConfirmed(out WriteValueV2 ValueReceived, out long WriteToken, ConnectionId Id, ItemIdentity Item, WriteValueV2 Value, UserToken User, UserToken Supervisor);
ArchestrAResult ConfirmWrite(ConnectionId Id, ItemIdentity Item, long WriteToken, WriteValueV2 Value, UserToken User, UserToken Supervisor, uint WriteHandle);
ArchestrAResult PublishWriteComplete(out ItemWriteCompleteV2[] CompleteWrites, ConnectionId Id);
ArchestrAResult CreateSubscription(out long SubscriptionId, ConnectionId Id, long MaxQueueSize, ulong SampleInterval);
ArchestrAResult SetSubscriptionState(ConnectionId Id, long SubscriptionId, ArchestrAServices.ASBIDataContract.Variant NewState, ushort StateToChange);
ArchestrAResult GetSubscriptionState(out ArchestrAServices.ASBIDataContract.Variant State, ConnectionId Id, long SubscriptionId, ushort StateToGet);
ArchestrAResult DeleteSubscription(ConnectionId Id, long SubscriptionId);
ArchestrAResult AddMonitoredItems(out ItemStatus[] Status, out ItemRegistration[] ItemCapabilities, ConnectionId Id, long SubscriptionId, MonitoredItem[] Items, byte RequireId);
ArchestrAResult DeleteMonitoredItems(out ItemStatus[] Status, ConnectionId Id, long SubscriptionId, MonitoredItem[] Items);
ArchestrAResult GetMonitoredItems(out MonitoredItem[] Items, ConnectionId Id, long SubscriptionId);
ArchestrAResult Publish(out ItemStatus[] Status, out MonitoredItemValue[] Values, ConnectionId Id, long SubscriptionId);
ArchestrAResult RegisterItems(out ItemStatus[] Status, out ItemRegistration[] ItemCapabilities, ConnectionId Id, ItemIdentity[] Items, byte RequireId, byte RegisterOnly);
ArchestrAResult UnregisterItems(out ItemStatus[] Status, ConnectionId Id, ItemIdentity[] Items);
void OnDisconnect(ConnectionId Id);
}
@@ -0,0 +1,61 @@
namespace ArchestrAServices.ASBContract;
public struct ItemStatusV2
{
private ItemIdentity itemField;
private ushort errorCodeField;
private bool errorCodeFieldSpecified;
private ASBStatus statusField;
public ItemIdentity Item
{
get
{
return itemField;
}
set
{
itemField = value;
}
}
public ushort ErrorCode
{
get
{
return errorCodeField;
}
set
{
errorCodeField = value;
ErrorCodeSpecified = true;
}
}
public bool ErrorCodeSpecified
{
get
{
return errorCodeFieldSpecified;
}
set
{
errorCodeFieldSpecified = value;
}
}
public ASBStatus Status
{
get
{
return statusField;
}
set
{
statusField = value;
}
}
}
@@ -0,0 +1,50 @@
using System.Xml.Serialization;
namespace ArchestrAServices.ASBContract;
public class ItemWriteCompleteV2
{
private ItemStatusV2[] statusField;
private uint writeHandleField;
private bool writeHandleFieldSpecified;
public ItemStatusV2[] Status
{
get
{
return statusField;
}
set
{
statusField = value;
}
}
public uint WriteHandle
{
get
{
return writeHandleField;
}
set
{
writeHandleField = value;
WriteHandleSpecified = true;
}
}
[XmlIgnore]
public bool WriteHandleSpecified
{
get
{
return writeHandleFieldSpecified;
}
set
{
writeHandleFieldSpecified = value;
}
}
}
@@ -0,0 +1,138 @@
using System;
using System.Xml.Serialization;
using ArchestrAServices.ASBIDataContract;
namespace ArchestrAServices.ASBContract;
public struct WriteValueV2
{
private bool hasQTField;
private bool hasQTFieldSpecified;
private Variant valueField;
private ASBStatus statusField;
private DateTime timestampField;
private bool timestampFieldSpecified;
private string commentField;
private int arrayElementIndexField;
private bool arrayElementIndexFieldSpecified;
public bool HasQT
{
get
{
return hasQTField;
}
set
{
hasQTField = value;
HasQTSpecified = true;
}
}
[XmlIgnore]
public bool HasQTSpecified
{
get
{
return hasQTFieldSpecified;
}
set
{
hasQTFieldSpecified = value;
}
}
public Variant Value
{
get
{
return valueField;
}
set
{
valueField = value;
}
}
public ASBStatus Status
{
get
{
return statusField;
}
set
{
statusField = value;
}
}
public DateTime Timestamp
{
get
{
return timestampField;
}
set
{
timestampField = value;
TimestampSpecified = true;
}
}
public bool TimestampSpecified
{
get
{
return timestampFieldSpecified;
}
set
{
timestampFieldSpecified = value;
}
}
public string Comment
{
get
{
return commentField;
}
set
{
commentField = value;
}
}
public int ArrayElementIndex
{
get
{
return arrayElementIndexField;
}
set
{
arrayElementIndexField = value;
ArrayElementIndexSpecified = true;
}
}
public bool ArrayElementIndexSpecified
{
get
{
return arrayElementIndexFieldSpecified;
}
set
{
arrayElementIndexFieldSpecified = value;
}
}
}