Files
histsdk/docs/reverse-engineering/wcf-open2-remote-latest.json
T
dohertj2 c95824a65d Initial commit: managed .NET 10 AVEVA Historian SDK + reverse-engineering toolkit
Full read-only SDK (src/AVEVA.Historian.Client) implementing the CLAUDE.md required
surface against AVEVA Historian's binary WCF protocol — no native AVEVA runtime
dependency. All operations live-verified against a local Historian:

- ProbeAsync, ReadRawAsync, ReadAggregateAsync, ReadAtTimeAsync, ReadEventsAsync
- BrowseTagNamesAsync, GetTagMetadataAsync (17 native data-type codes mapped)
- GetConnectionStatusAsync, GetStoreForwardStatusAsync, GetSystemParameterAsync
- 108/108 unit + integration tests pass

Includes the reverse-engineering toolkit (tools/AVEVA.Historian.ReverseEngineering)
used to decode the protocol: WCF probes, IL inspection via dnlib, and IL-rewrite
instrumentation (instrument-wcf-{write,read}message etc.) plus the .NET Framework
trace harness (tools/AVEVA.Historian.NativeTraceHarness) for parity testing.

Sanitized handoff evidence under docs/reverse-engineering/. Native AVEVA binaries
(current/, aveva-install-x64/, aveva-install-x86/) are gitignored — fetch separately
from the AVEVA installer.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 06:31:48 -04:00

313 lines
11 KiB
JSON

[
{
"Attempt": "legacy-v1-empty-v0-mode2",
"ServiceName": "Hist",
"Success": false,
"InputByteCount": 132,
"OutputByteCount": null,
"ErrorByteCount": 5,
"OutputBase64": null,
"ErrorBase64": "BKsAAAA=",
"NativeErrorType": 4,
"NativeErrorCode": 171,
"NativeErrorName": "AuthenticationFailed",
"LegacyHandle": null,
"LegacyConnectTimeFileTimeUtc": null,
"LegacyServerStatus": null,
"CloseHandleOneReturnCode": null,
"CloseReturnedHandleReturnCode": null,
"Close2SuccessfulVariant": null,
"Close2LastVariant": null,
"Close2LastErrorByteCount": null,
"Close2LastNativeErrorType": null,
"Close2LastNativeErrorCode": null,
"Close2LastNativeErrorName": null,
"RetrievalHandleOneIsOriginalAllowedReturnCode": null,
"RetrievalHandleOneIsOriginalAllowed": null,
"RetrievalHandleOneError": null,
"RetrievalReturnedHandleIsOriginalAllowedReturnCode": null,
"RetrievalReturnedHandleIsOriginalAllowed": null,
"RetrievalReturnedHandleError": null,
"Error": null
},
{
"Attempt": "legacy-v1-empty-v4-mode2",
"ServiceName": "Hist",
"Success": false,
"InputByteCount": 132,
"OutputByteCount": null,
"ErrorByteCount": 5,
"OutputBase64": null,
"ErrorBase64": "BKsAAAA=",
"NativeErrorType": 4,
"NativeErrorCode": 171,
"NativeErrorName": "AuthenticationFailed",
"LegacyHandle": null,
"LegacyConnectTimeFileTimeUtc": null,
"LegacyServerStatus": null,
"CloseHandleOneReturnCode": null,
"CloseReturnedHandleReturnCode": null,
"Close2SuccessfulVariant": null,
"Close2LastVariant": null,
"Close2LastErrorByteCount": null,
"Close2LastNativeErrorType": null,
"Close2LastNativeErrorCode": null,
"Close2LastNativeErrorName": null,
"RetrievalHandleOneIsOriginalAllowedReturnCode": null,
"RetrievalHandleOneIsOriginalAllowed": null,
"RetrievalHandleOneError": null,
"RetrievalReturnedHandleIsOriginalAllowedReturnCode": null,
"RetrievalReturnedHandleIsOriginalAllowed": null,
"RetrievalReturnedHandleError": null,
"Error": null
},
{
"Attempt": "legacy-v1-empty-v11-mode2",
"ServiceName": "Hist",
"Success": false,
"InputByteCount": 132,
"OutputByteCount": null,
"ErrorByteCount": 5,
"OutputBase64": null,
"ErrorBase64": "BKsAAAA=",
"NativeErrorType": 4,
"NativeErrorCode": 171,
"NativeErrorName": "AuthenticationFailed",
"LegacyHandle": null,
"LegacyConnectTimeFileTimeUtc": null,
"LegacyServerStatus": null,
"CloseHandleOneReturnCode": null,
"CloseReturnedHandleReturnCode": null,
"Close2SuccessfulVariant": null,
"Close2LastVariant": null,
"Close2LastErrorByteCount": null,
"Close2LastNativeErrorType": null,
"Close2LastNativeErrorCode": null,
"Close2LastNativeErrorName": null,
"RetrievalHandleOneIsOriginalAllowedReturnCode": null,
"RetrievalHandleOneIsOriginalAllowed": null,
"RetrievalHandleOneError": null,
"RetrievalReturnedHandleIsOriginalAllowedReturnCode": null,
"RetrievalReturnedHandleIsOriginalAllowed": null,
"RetrievalReturnedHandleError": null,
"Error": null
},
{
"Attempt": "legacy-v1-integrated-windows-v0-mode1026-hist",
"ServiceName": "Hist",
"Success": false,
"InputByteCount": 132,
"OutputByteCount": null,
"ErrorByteCount": null,
"OutputBase64": null,
"ErrorBase64": null,
"NativeErrorType": null,
"NativeErrorCode": null,
"NativeErrorName": null,
"LegacyHandle": null,
"LegacyConnectTimeFileTimeUtc": null,
"LegacyServerStatus": null,
"CloseHandleOneReturnCode": null,
"CloseReturnedHandleReturnCode": null,
"Close2SuccessfulVariant": null,
"Close2LastVariant": null,
"Close2LastErrorByteCount": null,
"Close2LastNativeErrorType": null,
"Close2LastNativeErrorCode": null,
"Close2LastNativeErrorName": null,
"RetrievalHandleOneIsOriginalAllowedReturnCode": null,
"RetrievalHandleOneIsOriginalAllowed": null,
"RetrievalHandleOneError": null,
"RetrievalReturnedHandleIsOriginalAllowedReturnCode": null,
"RetrievalReturnedHandleIsOriginalAllowed": null,
"RetrievalReturnedHandleError": null,
"Error": "ProtocolException: The requested upgrade is not supported by 'net.tcp://10.100.0.48:32568/Hist'. This could be due to mismatched bindings (for example security enabled on the client and not on the server)."
},
{
"Attempt": "legacy-v1-integrated-windows-v0-mode1026-hist-integrated",
"ServiceName": "Hist-Integrated",
"Success": true,
"InputByteCount": 132,
"OutputByteCount": 32,
"ErrorByteCount": null,
"OutputBase64": "<redacted-session-output>",
"ErrorBase64": null,
"NativeErrorType": null,
"NativeErrorCode": null,
"NativeErrorName": null,
"LegacyHandle": 0,
"LegacyConnectTimeFileTimeUtc": 134221370531642092,
"LegacyServerStatus": 0,
"CloseHandleOneReturnCode": 4,
"CloseReturnedHandleReturnCode": 4,
"Close2SuccessfulVariant": null,
"Close2LastVariant": "full32-base64",
"Close2LastErrorByteCount": 5,
"Close2LastNativeErrorType": 4,
"Close2LastNativeErrorCode": 51,
"Close2LastNativeErrorName": null,
"RetrievalHandleOneIsOriginalAllowedReturnCode": 4,
"RetrievalHandleOneIsOriginalAllowed": false,
"RetrievalHandleOneError": null,
"RetrievalReturnedHandleIsOriginalAllowedReturnCode": 0,
"RetrievalReturnedHandleIsOriginalAllowed": true,
"RetrievalReturnedHandleError": null,
"Error": null
},
{
"Attempt": "legacy-v1-integrated-windows-v4-mode1026-hist-integrated",
"ServiceName": "Hist-Integrated",
"Success": true,
"InputByteCount": 132,
"OutputByteCount": 32,
"ErrorByteCount": null,
"OutputBase64": "<redacted-session-output>",
"ErrorBase64": null,
"NativeErrorType": null,
"NativeErrorCode": null,
"NativeErrorName": null,
"LegacyHandle": 0,
"LegacyConnectTimeFileTimeUtc": 134221370533162076,
"LegacyServerStatus": 0,
"CloseHandleOneReturnCode": 4,
"CloseReturnedHandleReturnCode": 4,
"Close2SuccessfulVariant": null,
"Close2LastVariant": "full32-base64",
"Close2LastErrorByteCount": 5,
"Close2LastNativeErrorType": 4,
"Close2LastNativeErrorCode": 51,
"Close2LastNativeErrorName": null,
"RetrievalHandleOneIsOriginalAllowedReturnCode": 4,
"RetrievalHandleOneIsOriginalAllowed": false,
"RetrievalHandleOneError": null,
"RetrievalReturnedHandleIsOriginalAllowedReturnCode": 0,
"RetrievalReturnedHandleIsOriginalAllowed": true,
"RetrievalReturnedHandleError": null,
"Error": null
},
{
"Attempt": "legacy-v1-integrated-windows-v11-mode1026-hist-integrated",
"ServiceName": "Hist-Integrated",
"Success": true,
"InputByteCount": 132,
"OutputByteCount": 32,
"ErrorByteCount": null,
"OutputBase64": "<redacted-session-output>",
"ErrorBase64": null,
"NativeErrorType": null,
"NativeErrorCode": null,
"NativeErrorName": null,
"LegacyHandle": 0,
"LegacyConnectTimeFileTimeUtc": 134221370533962606,
"LegacyServerStatus": 0,
"CloseHandleOneReturnCode": 4,
"CloseReturnedHandleReturnCode": 4,
"Close2SuccessfulVariant": null,
"Close2LastVariant": "full32-base64",
"Close2LastErrorByteCount": 5,
"Close2LastNativeErrorType": 4,
"Close2LastNativeErrorCode": 51,
"Close2LastNativeErrorName": null,
"RetrievalHandleOneIsOriginalAllowedReturnCode": 4,
"RetrievalHandleOneIsOriginalAllowed": false,
"RetrievalHandleOneError": null,
"RetrievalReturnedHandleIsOriginalAllowedReturnCode": 0,
"RetrievalReturnedHandleIsOriginalAllowed": true,
"RetrievalReturnedHandleError": null,
"Error": null
},
{
"Attempt": "native-v3-integrated-windows-mode1026-hist-integrated",
"ServiceName": "Hist-Integrated",
"Success": false,
"InputByteCount": 230,
"OutputByteCount": null,
"ErrorByteCount": 5,
"OutputBase64": null,
"ErrorBase64": "BEkAAAA=",
"NativeErrorType": 4,
"NativeErrorCode": 73,
"NativeErrorName": "InvalidPacketVersion",
"LegacyHandle": null,
"LegacyConnectTimeFileTimeUtc": null,
"LegacyServerStatus": null,
"CloseHandleOneReturnCode": null,
"CloseReturnedHandleReturnCode": null,
"Close2SuccessfulVariant": null,
"Close2LastVariant": null,
"Close2LastErrorByteCount": null,
"Close2LastNativeErrorType": null,
"Close2LastNativeErrorCode": null,
"Close2LastNativeErrorName": null,
"RetrievalHandleOneIsOriginalAllowedReturnCode": null,
"RetrievalHandleOneIsOriginalAllowed": null,
"RetrievalHandleOneError": null,
"RetrievalReturnedHandleIsOriginalAllowedReturnCode": null,
"RetrievalReturnedHandleIsOriginalAllowed": null,
"RetrievalReturnedHandleError": null,
"Error": null
},
{
"Attempt": "legacy-v1-empty-v0-mode0",
"ServiceName": "Hist",
"Success": false,
"InputByteCount": 132,
"OutputByteCount": null,
"ErrorByteCount": 5,
"OutputBase64": null,
"ErrorBase64": "BKsAAAA=",
"NativeErrorType": 4,
"NativeErrorCode": 171,
"NativeErrorName": "AuthenticationFailed",
"LegacyHandle": null,
"LegacyConnectTimeFileTimeUtc": null,
"LegacyServerStatus": null,
"CloseHandleOneReturnCode": null,
"CloseReturnedHandleReturnCode": null,
"Close2SuccessfulVariant": null,
"Close2LastVariant": null,
"Close2LastErrorByteCount": null,
"Close2LastNativeErrorType": null,
"Close2LastNativeErrorCode": null,
"Close2LastNativeErrorName": null,
"RetrievalHandleOneIsOriginalAllowedReturnCode": null,
"RetrievalHandleOneIsOriginalAllowed": null,
"RetrievalHandleOneError": null,
"RetrievalReturnedHandleIsOriginalAllowedReturnCode": null,
"RetrievalReturnedHandleIsOriginalAllowed": null,
"RetrievalReturnedHandleError": null,
"Error": null
},
{
"Attempt": "legacy-v1-windows-user-v0-mode2",
"ServiceName": "Hist",
"Success": false,
"InputByteCount": 148,
"OutputByteCount": null,
"ErrorByteCount": 5,
"OutputBase64": null,
"ErrorBase64": "BKsAAAA=",
"NativeErrorType": 4,
"NativeErrorCode": 171,
"NativeErrorName": "AuthenticationFailed",
"LegacyHandle": null,
"LegacyConnectTimeFileTimeUtc": null,
"LegacyServerStatus": null,
"CloseHandleOneReturnCode": null,
"CloseReturnedHandleReturnCode": null,
"Close2SuccessfulVariant": null,
"Close2LastVariant": null,
"Close2LastErrorByteCount": null,
"Close2LastNativeErrorType": null,
"Close2LastNativeErrorCode": null,
"Close2LastNativeErrorName": null,
"RetrievalHandleOneIsOriginalAllowedReturnCode": null,
"RetrievalHandleOneIsOriginalAllowed": null,
"RetrievalHandleOneError": null,
"RetrievalReturnedHandleIsOriginalAllowedReturnCode": null,
"RetrievalReturnedHandleIsOriginalAllowed": null,
"RetrievalReturnedHandleError": null,
"Error": null
}
]