Testing and troubleshooting
Test code, contract conformance and operation with the platform separately. Successful dotnet build or tsc does not prove enrollment or an external service integration works.
Verification order
| Stage | Check | Evidence of success |
|---|---|---|
| Build | Packages, compiler and example files. | The project compiles with the pinned SDK version. |
| Handler | Valid and invalid inputs. | A test confirms the response and state change. |
| Contract | Operation names and exposition agreement with code. | A test uses the exact release artifact. |
| Enrollment | LinkKey, ControlPlane connectivity and identity storage. | The instance obtains and preserves its identity. |
| Runtime | Authorized caller, tenant, transports and configuration. | A real operation returns the expected result. |
| Integration | Provider configuration, callback and delivery. | A message or another effect appears in the external service. |
For Notes, only compilation with .NET SDK package 1.12.0 has been confirmed. Runtime and acceptance by an independent developer remain NOT_RUN.
Quick troubleshooting
| Symptom | Check |
|---|---|
| Cannot download the SDK | Private feed address, account permissions, SeeraOS.* mapping and package version. |
| Unit does not join the platform | CoreAddress, environment reachability, current LinkKey and identity store. |
| Call rejected as unauthenticated | Host authentication registration and the Auth profiles agreed for the deployment. |
| Operation does not match the contract | Handler, object and operation names, and the exact release exposition document. |
| Notes loses data after restart | The example stores notes in process memory, without a persistent database. |
| Discord linking does not finish | Callback reachability, redirect_uri and completion of the browser OAuth flow. |
| Discord notification is not delivered | Connection state, data.eventType, an existing route and bot permissions for the channel. |
Reporting an issue
Provide component versions, operation, attempt time, expected result and redacted diagnostics. Remove tokens, LinkKey, instance keys and provider secrets. Do not send complete customer records if they are unnecessary to reproduce the problem.
Public support channel and SDK access contact:
(information to be provided)
What this documentation does not establish
There is no accepted public matrix of supported SDK, toolkit and platform versions. Completion of this tutorial by an external developer has not been confirmed. Public page access does not grant a platform account or package access.