feat: single-APDU INSTALL [for install] / [for make selectable] ops (v3.6.18)

Iterating the final install step no longer needs a delete + re-load of the
.cap:

- `POST /api/ram-install-app` runs INSTALL [for install] (`mode: "install"`,
  P1 0x0C/0x04 by make_selectable) or INSTALL [for make selectable]
  (`mode: "make_selectable"`, GP 11.5.2.3.3 Table 11-44) for an already
  loaded package.  The APDU builders are shared with `_cap_apdu_sequence`
  (`_cap_install_apdu`, `_cap_make_selectable_apdu` - one builder, no drift)
  and the per-step send/PoR/counter logic is the extracted shared
  `_ram_send_gp_apdu` (used by /api/ram-install too).
- PWA: the RAM op selector gains "INSTALL [for install] (loaded package)"
  and "INSTALL [for make selectable]" with Load File / Module / Instance AID
  inputs (instance defaults to the module AID); the result renders through
  the shared `ramShowInstallResult` and `final_cntr` keeps the preset in
  sync.
- Explore: an **Install** button on a package's module AIDs that have no
  instance yet, and a **Make selectable** button on INSTALLED (0x03)
  instances - both switch the op and pre-fill the AIDs.
- tests: the install APDU pinned to the live no-STK packet and to the
  sequence tail, the make-selectable APDU, ramHasInstance, the Explore
  buttons and the op wiring; docs/api.md updated.

650 frontend / 498 Python green; version 3.6.18; sw simple-v291.
This commit is contained in:
2026-09-28 08:10:40 +03:00
parent 6403fb9f29
commit face2268ca
7 changed files with 414 additions and 109 deletions
+35
View File
@@ -1207,6 +1207,41 @@ class CapApduSequenceTest(unittest.TestCase):
self.assertEqual(seq[0][:10], '80E6020012')
self.assertIn('06A00000010001' + '07A0000000040000' + '000000', seq[0])
def test_install_apdu_matches_the_live_apdu_and_the_sequence_tail(self):
# /api/ram-install-app reuses the exact final APDU of the full
# sequence (one builder, no drift). Pinned to the live no-STK
# INSTALL [for install] (decrypted 2026-09-28).
from pysim_simple_server.server import _cap_apdu_sequence, _cap_install_apdu
self.assertEqual(
_cap_install_apdu('F0414C46416101', 'F0414C4641610101'),
'80E60C0020' + '07F0414C46416101' + '08F0414C4641610101'
+ '08F0414C4641610101' + '0100' + '02C900' + '00')
stk = 'EA0F800D000000000102011203AF4D0100'
seq = _cap_apdu_sequence('F0414C46416101', 'F0414C4641610101', 'AABBCCDD',
stk_params=stk)
self.assertEqual(seq[-1], _cap_install_apdu(
'F0414C46416101', 'F0414C4641610101', stk_params=stk))
# case 3: the length is header + Lc data, no trailing Le
lc = int(seq[-1][8:10], 16)
self.assertEqual(len(seq[-1]), 10 + 2 * lc)
# make selectable switches P1 to 0x0C
self.assertTrue(_cap_install_apdu(
'F0414C46416101', 'F0414C4641610101').startswith('80E60C00'))
self.assertTrue(_cap_install_apdu(
'F0414C46416101', 'F0414C4641610101',
make_selectable=False).startswith('80E60400'))
def test_make_selectable_apdu(self):
# GP Card Spec 11.5.2.3.3, Table 11-44: '00' '00' lv(AID)
# lv(privileges) lv(params) lv(token); case 3.
from pysim_simple_server.server import _cap_make_selectable_apdu
self.assertEqual(
_cap_make_selectable_apdu('F0414C4641610101'),
'80E608000F' + '0000' + '08F0414C4641610101' + '0100' + '0000')
self.assertEqual(
_cap_make_selectable_apdu('F0414C4641610101', '04'),
'80E608000F' + '0000' + '08F0414C4641610101' + '0104' + '0000')
def test_gen_install_returns_the_apdu_list(self):
# /api/scp81/gen-install: build the INSTALL/LOAD/INSTALL list for a
# .cap without touching any listener or script state.