✨ (context-module) [DSDK-1515]: NativePreBalance DTO + owner-without-mint warn for TOKEN_ACCOUNT_STATE

[fAnselmi-Ledger]

📝 Description

PR-2 of the DMK alignment with CAL edits

• nativePreBalance in TOKEN_ACCOUNT_STATE response DTO
  (spec/backend/dynamic_descriptors_api.md#nativeprebalance) The field is now required on every backend response. It is the unsynced wrappable lamport excess (not the raw balance) that the device reads from the signed descriptor. Host-side we only need to accept it in the DTO, it is not consumed or validated here. An absent field means an old backend, we log a debug trace and carry on (no soundness loss, just extra screens on native-reset instructions).

• Warn when path-3 response has owner but no mint
  (spec/device/tlv_structs.md#owner-and-the-owner-binding-map) Before admitting an attested OWNER into the owner-binding map the device now checks ACCOUNT_ADDRESS == PDA([OWNER, tokenProgram, MINT], ATA program) and drops the binding silently when MINT is absent. DMK sends the same request as before, no functional change, but a response without mint is now inert: the fetch was paid for and the IS_SIGNER hide will not happen. The warn makes the regression visible in logs.

❓ Context

• JIRA or GitHub link: [TS][Solana-Signer] Solana clear sign - nativePreBalance DTO + owner-without-mint warn for TOKEN_ACCOUNT_STATE

✅ Checklist

Pull Requests must pass CI checks and undergo code review. Set the PR as Draft if it is not yet ready for review.

• Covered by automatic tests
• Changeset is provided
• Documentation is up-to-date
• Impact of the changes:
  • list of the changes

---

🧐 Checklist for the PR Reviewers

• The code aligns with the requirements described in the linked JIRA or GitHub issue.
• The PR description clearly documents the changes made and explains any technical trade-offs or design decisions.
• There are no undocumented trade-offs, technical debt, or maintainability issues.
• The PR has been tested thoroughly, and any potential edge cases have been considered and handled.
• Any new dependencies have been justified and documented.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
device-sdk-ts-sample	Ready	Preview	Sep 18, 2026 5:14pm UTC
doc-device-management-kit	Ready	Preview	Sep 18, 2026 5:14pm UTC

[github-actions]

Danger Check Results

Messages

✅	Danger: All checks passed successfully! 🎉

Generated by 🚫 dangerJS against c6a2056

[Copilot]

🟢 Approval recommended

No unresolved blocking issues were identified.

Pull request overview

Adds Solana TOKEN_ACCOUNT_STATE support for nativePreBalance and diagnostics for owner responses missing mint.

Changes:

• Accepts optional nativePreBalance and logs when absent.
• Warns when owner is returned without mint.
• Adds unit tests and a patch changeset.

File summaries

File	Description
packages/signer/context-module/src/modules/solana/token-account-state/data/HttpTokenAccountStateDataSource.ts	Adds DTO support and diagnostic logging.
packages/signer/context-module/src/modules/solana/token-account-state/data/HttpTokenAccountStateDataSource.test.ts	Tests the new logging behavior.
.changeset/tame-cities-sneeze.md	Records the package patch release.

Review details

• Files reviewed: 3/3 changed files
• Comments generated: 0
• Review effort level: Lite

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[sonarqubecloud]

Quality Gate passed

Issues
1 New issue
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud