com_r35157_nenjim-hubd-impl_ref/openspec/changes/archive/2026-08-11-51-add-exact-input-token-swaps-through-jupiter-swap-v2/tasks.md

1. Public API

• 1.1 Add the ValueTagged JupiterSwapService exact-input method with complete public Javadoc and validation/failure contracts.
• 1.2 Add the immutable JupiterSwapResult value containing the signature and actual human-readable amounts.

2. Reference Implementation

• 2.1 Add the reference implementation with injected SolanaBlockChain and SolanaWallet dependencies and private Swap V2 wire DTOs.
• 2.2 Validate arguments, both on-chain mint accounts and programs, mint decimal metadata, and exact raw input conversion before order acquisition.
• 2.3 Implement keyless /order acquisition in exact-input mode, always excluding JupiterZ, with JVM-wide interruptible two-second request-start pacing.
• 2.4 Validate order identity and transaction metadata before signing through SolanaWallet.
• 2.5 Submit a signed transaction once through /execute, without retries or order throttling, and validate the confirmed result and actual amounts.

3. Verification

• 3.1 Compile Detag-generated main and test source sets and run the repository's existing test/check tasks without adding automated tests.
• 3.2 Run strict OpenSpec validation and git diff --check.
• 3.3 Review the complete diff for stale imports, generated-file edits, unrelated refactors, tests, and any implementation that violates the module or retry boundaries.

4. Review Follow-up Validation

• 4.1 Validate the returned taker and nullable slippage before signing.
• 4.2 Base64-decode the returned transaction and reject invalid or empty decoded content before signing.
• 4.3 Require both execution status Success and an explicit result code 0.
• 4.4 Re-run compilation, Detag, existing tests, strict OpenSpec validation, and diff checks without adding tests.