@scalebun/react-native 1.11.1 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (68) hide show
  1. package/android/build.gradle +8 -0
  2. package/android/src/androidTest/java/com/scalebun/rn/ota/ScaleBunOtaVerifierInstrumentedTest.kt +112 -0
  3. package/android/src/main/java/com/scalebun/rn/ota/OtaProtocol.kt +244 -0
  4. package/android/src/main/java/com/scalebun/rn/ota/ScaleBunOtaKeyRegistry.kt +100 -0
  5. package/android/src/main/java/com/scalebun/rn/ota/ScaleBunOtaModule.kt +115 -60
  6. package/android/src/main/java/com/scalebun/rn/ota/ScaleBunOtaReleaseVerifier.kt +129 -0
  7. package/android/src/main/java/com/scalebun/rn/ota/SlotManager.kt +18 -0
  8. package/android/src/oldarch/java/com/scalebun/rn/ota/ScaleBunOtaSpec.kt +4 -8
  9. package/dist/scalebun.full.js +127 -422
  10. package/dist/scalebun.slim.js +127 -422
  11. package/ios/Ota/OtaProtocol.swift +242 -0
  12. package/ios/Ota/OtaSlotManager.swift +26 -0
  13. package/ios/Ota/ScaleBunOtaBridge.mm +6 -3
  14. package/ios/Ota/ScaleBunOtaKeyRegistry.swift +147 -0
  15. package/ios/Ota/ScaleBunOtaModule.swift +125 -53
  16. package/ios/Ota/ScaleBunOtaReleaseVerifier.swift +115 -0
  17. package/ios/Ota/ScaleBunOtaVerifierTests.swift +92 -0
  18. package/lib/commonjs/core/config/schema.js +3 -12
  19. package/lib/commonjs/core/constants/version.js +1 -1
  20. package/lib/commonjs/features/network/NetworkFeature.js +39 -5
  21. package/lib/commonjs/features/network/thirdParty.js +90 -0
  22. package/lib/commonjs/features/ota/OtaOrchestrator.js +108 -60
  23. package/lib/commonjs/public/ScaleBunFacade.js +5 -41
  24. package/lib/module/core/config/schema.js +3 -12
  25. package/lib/module/core/constants/version.js +1 -1
  26. package/lib/module/features/network/NetworkFeature.js +38 -4
  27. package/lib/module/features/network/thirdParty.js +83 -0
  28. package/lib/module/features/ota/OtaOrchestrator.js +108 -60
  29. package/lib/module/public/ScaleBunFacade.js +5 -41
  30. package/lib/typescript/core/config/schema.d.ts +0 -3
  31. package/lib/typescript/core/constants/version.d.ts +1 -1
  32. package/lib/typescript/features/network/index.d.ts +18 -0
  33. package/lib/typescript/features/network/thirdParty.d.ts +65 -0
  34. package/lib/typescript/features/ota/OtaOrchestrator.d.ts +5 -8
  35. package/lib/typescript/features/ota/OtaTypes.d.ts +22 -0
  36. package/lib/typescript/public/ScaleBunFacade.d.ts +5 -11
  37. package/lib/typescript/specs/NativeScaleBunOta.d.ts +30 -20
  38. package/package.json +3 -13
  39. package/scalebun-react-native.podspec +4 -0
  40. package/src/core/config/schema.ts +3 -9
  41. package/src/core/constants/version.ts +1 -1
  42. package/src/features/network/NetworkFeature.ts +41 -4
  43. package/src/features/network/index.ts +18 -0
  44. package/src/features/network/thirdParty.ts +92 -0
  45. package/src/features/ota/OtaOrchestrator.ts +116 -70
  46. package/src/features/ota/OtaTypes.ts +23 -1
  47. package/src/public/ScaleBunFacade.ts +5 -53
  48. package/src/specs/NativeScaleBunOta.ts +32 -20
  49. package/lib/commonjs/features/ota/crypto/builtinVerifier.js +0 -248
  50. package/lib/commonjs/features/ota/crypto/loadEd25519.js +0 -40
  51. package/lib/commonjs/features/ota/crypto/loadSha512.js +0 -40
  52. package/lib/commonjs/features/ota/crypto/nativeVerifier.js +0 -121
  53. package/lib/commonjs/features/ota/signature.js +0 -175
  54. package/lib/module/features/ota/crypto/builtinVerifier.js +0 -240
  55. package/lib/module/features/ota/crypto/loadEd25519.js +0 -34
  56. package/lib/module/features/ota/crypto/loadSha512.js +0 -34
  57. package/lib/module/features/ota/crypto/nativeVerifier.js +0 -113
  58. package/lib/module/features/ota/signature.js +0 -169
  59. package/lib/typescript/features/ota/crypto/builtinVerifier.d.ts +0 -53
  60. package/lib/typescript/features/ota/crypto/loadEd25519.d.ts +0 -30
  61. package/lib/typescript/features/ota/crypto/loadSha512.d.ts +0 -15
  62. package/lib/typescript/features/ota/crypto/nativeVerifier.d.ts +0 -35
  63. package/lib/typescript/features/ota/signature.d.ts +0 -81
  64. package/src/features/ota/crypto/builtinVerifier.ts +0 -257
  65. package/src/features/ota/crypto/loadEd25519.ts +0 -41
  66. package/src/features/ota/crypto/loadSha512.ts +0 -35
  67. package/src/features/ota/crypto/nativeVerifier.ts +0 -117
  68. package/src/features/ota/signature.ts +0 -206
@@ -1,175 +0,0 @@
1
- "use strict";
2
-
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
6
- exports._resetSignatureWarnings = _resetSignatureWarnings;
7
- exports.verifyBundleSignature = verifyBundleSignature;
8
- var _internalLogger = require("../../core/logger/internalLogger");
9
- var _builtinVerifier = require("./crypto/builtinVerifier");
10
- var _nativeVerifier = require("./crypto/nativeVerifier");
11
- /**
12
- * Bundle signature verification (OTA-03).
13
- *
14
- * WHAT WAS WRONG. `ota-signing-key.service.ts` documents the intended model
15
- * exactly: the CLI generates an ed25519 keypair locally, uploads only the public
16
- * half, and "the device verifies every bundle's signature before install and
17
- * rejects forgeries." Two of those three steps did not exist. The CLI had no
18
- * signing code, and this SDK received `bundle.signature` in the check response
19
- * and never read it. The only client-side check was SHA-256 against a hash
20
- * delivered in the same response as the URL — which defends against a corrupted
21
- * download and nothing else. On a platform whose entire purpose is remote code
22
- * delivery, that is the control that matters most.
23
- *
24
- * WHY IT IS SHAPED LIKE THIS. React Native has no built-in ed25519, so the
25
- * verification primitive has to come from somewhere. It is resolved in order:
26
- * a host-supplied verifier, else the built-in one assembled from the OPTIONAL
27
- * `@noble/ed25519` + `@noble/hashes` peers, else nothing — and the SDK's job is
28
- * to decide, unambiguously, what happens in that last case.
29
- *
30
- * The built-in path exists because requiring every adopter to hand-write a
31
- * verifier put the most security-critical operation in the product in code the
32
- * SDK could neither test nor audit, and made a routine dependency bump able to
33
- * silently stop all updates. See `crypto/builtinVerifier.ts`. Signing stays
34
- * opt-in, and apps that never adopt it carry no curve arithmetic.
35
- *
36
- * THE POLICY, which is the important part:
37
- *
38
- * - A bundle carrying a signature, with a configured public key and a
39
- * verifier: verified. Failure REJECTS the install. This is the goal state.
40
- * - A bundle carrying a signature, with a public key configured, but no
41
- * verifier available: REJECT. The app asked for signature enforcement by
42
- * configuring a key; silently installing unverified code because a helper is
43
- * missing would turn a security feature into a placebo.
44
- * - No public key configured: skip, and say so once. Signing is opt-in per app,
45
- * and an app that has not adopted it must keep working.
46
- *
47
- * The failure mode is the whole design: an app that opts in cannot be
48
- * accidentally downgraded to unverified installs.
49
- */
50
-
51
- /** Verifies a detached ed25519 signature. Supplied by the host app. */
52
-
53
- let warnedNotConfigured = false;
54
-
55
- /**
56
- * Decide whether a bundle may be staged.
57
- *
58
- * Returns a structured outcome rather than a boolean so the caller can emit a
59
- * precise telemetry reason — "we shipped unverified code because no key was
60
- * configured" and "we refused because the signature was forged" are very
61
- * different operational events and must not collapse into one.
62
- */
63
- async function verifyBundleSignature(bundleSha256, signature, config) {
64
- const rawKey = config?.publicKey;
65
-
66
- // Normalize to a list. A single non-empty string is the pre-rotation config
67
- // shape and behaves exactly as before; an array pins several keys at once.
68
- const keys = (Array.isArray(rawKey) ? rawKey : rawKey ? [rawKey] : []).filter(k => typeof k === 'string' && k.trim().length > 0);
69
-
70
- // Signing not adopted by this app — nothing to enforce. Parity note: a
71
- // falsy single value (undefined, '') has always meant "not configured" and
72
- // still does.
73
- if (rawKey === undefined || rawKey === '' || rawKey === null) {
74
- if (!warnedNotConfigured) {
75
- warnedNotConfigured = true;
76
- _internalLogger.logger.warn('[OTA] No signing public key configured — bundles are accepted on SHA-256 ' + 'integrity alone. Configure `ota.publicSigningKey` to enforce authenticity.');
77
- }
78
- return {
79
- ok: true,
80
- reason: 'not_configured'
81
- };
82
- }
83
-
84
- // The host PROVIDED a key config that resolves to zero usable keys — an
85
- // empty array, or an array of blank strings. That is a broken attempt to
86
- // enable signing, not an absence of one, and the two must not collapse:
87
- // treating `publicSigningKeys: []` as "not configured" would let a config
88
- // mistake silently downgrade an app to unverified installs. Fail closed.
89
- if (keys.length === 0) {
90
- _internalLogger.logger.error('[OTA] Signing key config resolves to zero usable keys (empty array or blank ' + 'strings) — refusing to stage. Remove the config to disable signing, or pin ' + 'at least one real key.');
91
- return {
92
- ok: false,
93
- reason: 'no_keys'
94
- };
95
- }
96
-
97
- // The app opted in, so a bundle without a signature is a refusal, not a pass.
98
- if (!signature) {
99
- _internalLogger.logger.error('[OTA] Bundle has no signature but a signing key is configured — refusing to stage.');
100
- return {
101
- ok: false,
102
- reason: 'missing_signature'
103
- };
104
- }
105
-
106
- // Resolution order, and the order matters:
107
- // 1. A host-supplied verifier ALWAYS wins. A team with its own crypto
108
- // policy must be able to override whatever the SDK would otherwise pick.
109
- // 2. Otherwise the NATIVE verifier (CryptoKit / Android 13+ platform
110
- // ed25519). Preferred over the JS one because it runs outside the
111
- // bundle it protects and needs no optional peers; on OS levels without
112
- // ed25519 it delegates to the builtin internally.
113
- // 3. Otherwise the built-in @noble verifier, if the optional peers are
114
- // installed. This is the path that removes ~100 lines of hand-written
115
- // crypto plumbing from every app that adopts signing.
116
- // 4. Otherwise reject, because a configured key is a request for
117
- // enforcement and quietly installing unverified code would turn a
118
- // security feature into a placebo.
119
- const verifier = typeof config?.verifier === 'function' ? config.verifier : (0, _nativeVerifier.getNativeVerifier)() ?? (0, _builtinVerifier.getBuiltinVerifier)();
120
- if (!verifier) {
121
- _internalLogger.logger.error('[OTA] A signing key is configured but no signature verifier is available — ' + 'refusing to stage. Either install the optional peers ' + '`@noble/ed25519` and `@noble/hashes` (the SDK then verifies with no ' + 'further code), or provide your own `ota.verifySignature`.');
122
- return {
123
- ok: false,
124
- reason: 'no_verifier'
125
- };
126
- }
127
-
128
- // Try every pinned key; any single match accepts. The verifier contract is
129
- // unchanged (one key per call) so host-supplied verifiers keep working.
130
- //
131
- // Outcome labelling when nothing matched, and why it matters: if at least
132
- // one verifier call RAN TO COMPLETION and said no, the bundle failed
133
- // verification — 'invalid_signature'. Only when EVERY call threw is the
134
- // machinery itself suspect — 'verifier_threw'. Collapsing those (e.g. by
135
- // letting the last key's throw win) would point an investigation at the
136
- // host's verifier when the actual event was a forged bundle, or vice versa.
137
- let sawThrow = false;
138
- let sawCompletion = false;
139
- for (const key of keys) {
140
- try {
141
- const valid = await verifier({
142
- messageHex: bundleSha256,
143
- signature,
144
- publicKey: key
145
- });
146
- sawCompletion = true;
147
- if (valid) return {
148
- ok: true,
149
- reason: 'verified'
150
- };
151
- } catch (err) {
152
- // A throwing verifier is treated as a failed verification for this key,
153
- // never as a pass — but the remaining keys still get their chance.
154
- sawThrow = true;
155
- _internalLogger.logger.error(`[OTA] Signature verifier threw: ${err?.message ?? err}`);
156
- }
157
- }
158
- if (sawThrow && !sawCompletion) {
159
- return {
160
- ok: false,
161
- reason: 'verifier_threw'
162
- };
163
- }
164
- _internalLogger.logger.error(keys.length > 1 ? `[OTA] Bundle signature is INVALID under all ${keys.length} pinned keys — refusing to stage.` : '[OTA] Bundle signature is INVALID — refusing to stage.');
165
- return {
166
- ok: false,
167
- reason: 'invalid_signature'
168
- };
169
- }
170
-
171
- /** Test seam — resets the once-per-process "not configured" warning. */
172
- function _resetSignatureWarnings() {
173
- warnedNotConfigured = false;
174
- }
175
- //# sourceMappingURL=signature.js.map
@@ -1,240 +0,0 @@
1
- /**
2
- * Built-in ed25519 verifier, assembled from OPTIONAL peer dependencies.
3
- *
4
- * WHAT THIS REPLACES. Pinning `ota.publicSigningKey` used to require the host
5
- * app to write its own `verifySignature` — roughly a hundred lines of hex and
6
- * base64 decoding wrapped around a crypto library. That put the single most
7
- * security-critical operation in the product, the one deciding whether remote
8
- * code is authentic before it executes, in code the SDK could neither test nor
9
- * audit. Three failure modes all landed on the app author:
10
- *
11
- * - A verifier that always returns `true` silently disables the feature, and
12
- * nothing can detect it.
13
- * - @noble's hash-provider property moved between major versions, so a
14
- * routine dependency bump made every update fail closed with no signal
15
- * pointing at the cause.
16
- * - Hand-written base64 decoders tend to omit base64url, so a signature
17
- * containing `-` or `_` is rejected as a forgery.
18
- *
19
- * All three are now the SDK's problem, which is where they belong. A host that
20
- * installs `@noble/ed25519` and `@noble/hashes` gets verification by pinning a
21
- * key and writing no code at all.
22
- *
23
- * WHY OPTIONAL AND NOT A HARD DEPENDENCY. Most apps never adopt bundle
24
- * signing, and they should not carry curve arithmetic they will not run. The
25
- * `verifySignature` hook remains supported and still WINS over this, for teams
26
- * with their own crypto policy or a native implementation to delegate to.
27
- *
28
- * WHAT THIS DOES NOT FIX. Verification still happens in JS, inside the very
29
- * bundle it protects. An attacker who lands one malicious bundle by other means
30
- * can neuter the check for every update after it. Closing that needs native
31
- * verification — CryptoKit on iOS (13.4+, already the deployment target) and
32
- * `Signature.getInstance("Ed25519")` on Android API 33+, with a fallback below.
33
- */
34
-
35
- import { loadEd25519 } from './loadEd25519';
36
- import { loadSha512 } from './loadSha512';
37
- import { logger } from '../../../core/logger/internalLogger';
38
- const ED25519_SIGNATURE_BYTES = 64;
39
- const ED25519_PUBLIC_KEY_BYTES = 32;
40
-
41
- /** Hex → bytes. Returns null rather than throwing; callers treat null as "reject". */
42
- function hexToBytes(hex) {
43
- const clean = hex.trim().toLowerCase().replace(/^0x/, '');
44
- if (clean.length === 0 || clean.length % 2 !== 0 || /[^0-9a-f]/.test(clean)) return null;
45
- const out = new Uint8Array(clean.length / 2);
46
- for (let i = 0; i < out.length; i++) {
47
- out[i] = parseInt(clean.slice(i * 2, i * 2 + 2), 16);
48
- }
49
- return out;
50
- }
51
- const B64_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
52
-
53
- /**
54
- * Base64 → bytes, accepting base64url as well.
55
- *
56
- * The `-`/`_` handling is the point. A verifier that omits it rejects a
57
- * perfectly valid signature as a forgery the moment the signing side emits
58
- * base64url, and the resulting symptom — updates silently stop installing —
59
- * looks nothing like a decoding bug.
60
- */
61
- function base64ToBytes(b64) {
62
- const s = b64.trim().replace(/-/g, '+').replace(/_/g, '/').replace(/=+$/, '');
63
- if (s.length === 0) return null;
64
- const out = [];
65
- let buffer = 0;
66
- let bits = 0;
67
- for (const ch of s) {
68
- const idx = B64_ALPHABET.indexOf(ch);
69
- if (idx === -1) return null;
70
- buffer = buffer << 6 | idx;
71
- bits += 6;
72
- if (bits >= 8) {
73
- bits -= 8;
74
- out.push(buffer >> bits & 0xff);
75
- }
76
- }
77
- return Uint8Array.from(out);
78
- }
79
-
80
- /**
81
- * Decode a detached signature that may arrive hex- or base64-encoded.
82
- *
83
- * Tries the unambiguous case first: 128 hex characters is exactly 64 bytes and
84
- * cannot be anything else. Otherwise base64, then hex as a last resort. Only a
85
- * result of exactly 64 bytes is accepted, so a string that decodes under the
86
- * wrong scheme is rejected rather than fed to the curve code as garbage.
87
- */
88
- export function decodeSignature(sig) {
89
- const trimmed = sig.trim();
90
- if (/^(0x)?[0-9a-fA-F]{128}$/.test(trimmed)) {
91
- const hex = hexToBytes(trimmed);
92
- if (hex && hex.length === ED25519_SIGNATURE_BYTES) return hex;
93
- }
94
- const b64 = base64ToBytes(trimmed);
95
- if (b64 && b64.length === ED25519_SIGNATURE_BYTES) return b64;
96
- const hex = hexToBytes(trimmed);
97
- if (hex && hex.length === ED25519_SIGNATURE_BYTES) return hex;
98
- return null;
99
- }
100
-
101
- /**
102
- * Give @noble its SHA-512 provider.
103
- *
104
- * The property it reads moved between major versions — v2 wants
105
- * `etc.sha512Sync`, v3 wants `hashes.sha512` — so both are populated when
106
- * present. Getting this wrong does not fail loudly: verification simply throws
107
- * from inside the curve code and the outer catch converts it to "rejected",
108
- * which is indistinguishable from an actual forgery. That ambiguity is exactly
109
- * what made this a bad thing to ask app authors to maintain.
110
- */
111
- function wireSha512(ed, sha512) {
112
- // VARIADIC ON PURPOSE. @noble calls its hash provider with several byte
113
- // arrays to be hashed as one concatenated message. A wrapper taking a
114
- // single argument hashes only the first, silently produces the wrong
115
- // digest, and every genuine signature is then reported as INVALID — no
116
- // error, no exception, just an authenticity check that always says no.
117
- // Verified against a real CLI-produced signature; the single-argument form
118
- // failed every positive case while passing every negative one, which is
119
- // the most misleading shape a bug of this kind can take.
120
- const concat = parts => {
121
- if (parts.length === 1) return parts[0];
122
- let total = 0;
123
- for (const p of parts) total += p.length;
124
- const out = new Uint8Array(total);
125
- let off = 0;
126
- for (const p of parts) {
127
- out.set(p, off);
128
- off += p.length;
129
- }
130
- return out;
131
- };
132
- const sync = (...msgs) => sha512(concat(msgs));
133
- const asyncFn = async (...msgs) => sha512(concat(msgs));
134
-
135
- // EACH BRANCH GETS ITS OWN try. Wrapping both in one is a trap, and it cost
136
- // an afternoon: under v3 the `hashes` assignment succeeds and the `etc`
137
- // object is FROZEN, so the v2-shaped assignment throws "object is not
138
- // extensible" — discarding a verifier that was, by then, already correctly
139
- // wired. Only "neither shape took" means unavailable.
140
- let wired = false;
141
- try {
142
- if (ed.hashes && typeof ed.hashes === 'object') {
143
- if (typeof ed.hashes.sha512 !== 'function') ed.hashes.sha512 = sync;
144
- if (typeof ed.hashes.sha512Async !== 'function') ed.hashes.sha512Async = asyncFn;
145
- wired = typeof ed.hashes.sha512 === 'function';
146
- }
147
- } catch {
148
- /* frozen or absent — try the other shape */
149
- }
150
- try {
151
- if (ed.etc && typeof ed.etc === 'object') {
152
- if (typeof ed.etc.sha512Sync !== 'function') ed.etc.sha512Sync = sync;
153
- if (typeof ed.etc.sha512Async !== 'function') ed.etc.sha512Async = asyncFn;
154
- wired = wired || typeof ed.etc.sha512Sync === 'function';
155
- }
156
- } catch {
157
- /* frozen or absent — `wired` already records whether the other shape took */
158
- }
159
- return wired;
160
- }
161
- let resolved;
162
-
163
- /**
164
- * The built-in verifier, or null when the optional deps are not installed.
165
- * Resolution is cached, including the negative result — a missing dependency
166
- * does not become present at runtime, and retrying the require on every update
167
- * check would be pure overhead.
168
- */
169
- export function getBuiltinVerifier() {
170
- if (resolved !== undefined) return resolved;
171
- const ed = loadEd25519();
172
- const sha512 = loadSha512();
173
- if (!ed || !sha512) {
174
- resolved = null;
175
- return null;
176
- }
177
- if (!wireSha512(ed, sha512)) {
178
- // A shape neither branch matched — a @noble major this SDK predates.
179
- // Report "no verifier", which is actionable, rather than letting every
180
- // update fail deep inside the curve code with an opaque error.
181
- logger.error('[OTA] @noble/ed25519 is installed but its SHA-512 provider could not be ' + 'wired (unrecognised version shape). Supply `ota.verifySignature` ' + 'yourself, or pin a @noble/ed25519 version this SDK supports.');
182
- resolved = null;
183
- return null;
184
- }
185
- resolved = async ({
186
- messageHex,
187
- signature,
188
- publicKey
189
- }) => {
190
- const message = hexToBytes(messageHex);
191
- const pub = hexToBytes(publicKey);
192
- const sig = decodeSignature(signature);
193
- if (!message) {
194
- logger.error('[OTA] Bundle SHA-256 is not valid hex — refusing to stage.');
195
- return false;
196
- }
197
- if (!pub || pub.length !== ED25519_PUBLIC_KEY_BYTES) {
198
- // Worth naming precisely: a mistyped or wrongly-encoded key would
199
- // otherwise present as "every update is a forgery".
200
- logger.error(`[OTA] ota.publicSigningKey must be ${ED25519_PUBLIC_KEY_BYTES} bytes of hex ` + `(${ED25519_PUBLIC_KEY_BYTES * 2} characters) — got ` + `${pub ? `${pub.length} bytes` : 'a value that is not hex'}.`);
201
- return false;
202
- }
203
- if (!sig) {
204
- logger.error('[OTA] Bundle signature is not a 64-byte hex/base64 value.');
205
- return false;
206
- }
207
-
208
- // @noble THROWS rather than returning false for bytes that are not a
209
- // well-formed point — which is most forgeries, since a tampered
210
- // signature usually decodes to garbage rather than to a valid-but-wrong
211
- // point. Swallowing that here is deliberate: from the SDK's side a
212
- // malformed signature IS a rejection, and letting it escape would
213
- // surface as `verifier_threw`, the outcome reserved for a HOST verifier
214
- // misbehaving. Conflating "this bundle is forged" with "your verifier
215
- // is broken" would point every investigation in the wrong direction.
216
- try {
217
- // SYNC FIRST, and this is not a style preference. @noble's
218
- // `verifyAsync` reaches for `crypto.subtle` — "crypto.subtle must be
219
- // defined, consider polyfill" — which React Native does not provide
220
- // and neither does a plain Node test environment. The sync `verify`
221
- // uses the SHA-512 provider wired above and needs no WebCrypto, so
222
- // it is the path that actually works on a phone. Verification is a
223
- // few hundred microseconds over a 32-byte digest, once per update
224
- // check, so there is nothing to gain from the async form anyway.
225
- if (typeof ed.verify === 'function') return ed.verify(sig, message, pub);
226
- if (typeof ed.verifyAsync === 'function') return await ed.verifyAsync(sig, message, pub);
227
- return false;
228
- } catch {
229
- return false;
230
- }
231
- };
232
- __DEV__ && logger.debug('[OTA] Using built-in ed25519 verifier (@noble/ed25519 detected).');
233
- return resolved;
234
- }
235
-
236
- /** Test seam — clears the cached resolution. */
237
- export function _resetBuiltinVerifier() {
238
- resolved = undefined;
239
- }
240
- //# sourceMappingURL=builtinVerifier.js.map
@@ -1,34 +0,0 @@
1
- /**
2
- * Isolated lazy loader for the OPTIONAL `@noble/ed25519` dep.
3
- *
4
- * WHY ITS OWN FILE: Metro's dependency collector emits a dependency map one
5
- * entry short for a module containing TWO OR MORE different-string inline
6
- * `require()` calls, so the require indices desync and `_dependencyMap[N]`
7
- * reads `undefined` ("Requiring unknown module 'undefined'"). Exactly ONE
8
- * inline require per module avoids the miscount. `loadSha512` is a sibling file
9
- * for the same reason — see `push/adapters/loadNotifee.ts`, which hit this first.
10
- *
11
- * The string must still be STATICALLY resolvable at bundle time; hosts that do
12
- * not install it stub it via `withScaleBun`.
13
- */
14
-
15
- /** The subset of the @noble/ed25519 surface this SDK uses. */
16
-
17
- export function loadEd25519() {
18
- try {
19
- const mod = require('@noble/ed25519');
20
- const ed = mod?.default ?? mod;
21
- // Validate the API actually used, not mere truthiness: when the package
22
- // is absent `withScaleBun` resolves it to an EMPTY STUB MODULE, which is
23
- // a perfectly truthy object. A stub must read as "unavailable", because
24
- // treating it as available would make every signed update fail with a
25
- // crypto error instead of the actionable "no verifier" message.
26
- if (typeof ed?.verifyAsync === 'function' || typeof ed?.verify === 'function') {
27
- return ed;
28
- }
29
- return null;
30
- } catch {
31
- return null;
32
- }
33
- }
34
- //# sourceMappingURL=loadEd25519.js.map
@@ -1,34 +0,0 @@
1
- /**
2
- * Isolated lazy loader for the OPTIONAL `@noble/hashes` SHA-512.
3
- *
4
- * Separate file from `loadEd25519` because Metro miscounts a module holding two
5
- * different-string inline `require()` calls — see the comment there.
6
- *
7
- * ed25519 is defined in terms of SHA-512, and React Native has no native
8
- * SHA-512, so @noble/ed25519 cannot verify anything until a hash provider is
9
- * wired into it. Which property it expects differs by major version, so the
10
- * wiring lives in `builtinVerifier`, not here; this module only obtains the
11
- * function.
12
- */
13
-
14
- export function loadSha512() {
15
- try {
16
- // The `.js` SUFFIX IS REQUIRED, not stylistic. @noble/hashes v2 declares
17
- // its exports map with extensions — `"./sha2.js"`, not `"./sha2"` — so
18
- // the extensionless form misses the map entirely. Node still resolves it
19
- // by falling back to file-based lookup, which is why it passes here,
20
- // but Metro prints
21
- // "Attempted to import … not listed in the exports … Falling back to
22
- // file-based resolution"
23
- // on every bundle, and that fallback is exactly what a stricter resolver
24
- // (or a future Metro) drops. Caught while bundling a real Expo app.
25
- const mod = require('@noble/hashes/sha2.js');
26
- const sha512 = mod?.sha512 ?? mod?.default?.sha512;
27
- // A stubbed module yields undefined here, which correctly reads as
28
- // "unavailable" rather than throwing deep inside the curve code later.
29
- return typeof sha512 === 'function' ? sha512 : null;
30
- } catch {
31
- return null;
32
- }
33
- }
34
- //# sourceMappingURL=loadSha512.js.map
@@ -1,113 +0,0 @@
1
- /**
2
- * Native ed25519 verifier — platform crypto wrapped as a SignatureVerifier.
3
- *
4
- * WHY IT EXISTS. The built-in @noble verifier runs in JS, inside the very
5
- * bundle it protects: an attacker who lands one malicious bundle can neuter a
6
- * JS check for every update after it. Platform crypto (CryptoKit on iOS,
7
- * Android's conscrypt on API 33+) sits outside the bundle's reach — and using
8
- * it also drops the runtime dependency on the optional @noble peers wherever
9
- * the OS provides ed25519.
10
- *
11
- * WHAT IT DOES NOT FIX, stated plainly: the ORCHESTRATION still lives in JS.
12
- * A hostile bundle can skip calling any verifier and drive the native staging
13
- * methods directly. Moving the crypto native shrinks the attack surface (no
14
- * more tampering with a bundled crypto lib to flip a verdict) but the full
15
- * close needs native-ENFORCED staging with a natively-pinned key — an
16
- * architectural change tracked separately, not smuggled into this one.
17
- *
18
- * VERDICT CONTRACT (mirrors the spec): the native side resolves
19
- * 'valid' | 'invalid' | 'unavailable'. 'invalid' is a definitive NO.
20
- * 'unavailable' (Android < 33, malformed input, machinery failure) means this
21
- * source cannot answer — the composed verifier below then delegates to the
22
- * @noble builtin, and when that is absent too it THROWS, which the policy
23
- * layer converts to a rejection. Every path that cannot verify refuses.
24
- */
25
-
26
- import NativeScaleBunOta from '../../../specs/NativeScaleBunOta';
27
- import { logger } from '../../../core/logger/internalLogger';
28
- import { decodeSignature, getBuiltinVerifier } from './builtinVerifier';
29
- const ED25519_PUBLIC_KEY_HEX_CHARS = 64;
30
-
31
- /** bytes → lowercase hex (the native side takes clean hex only). */
32
- function bytesToHex(bytes) {
33
- let out = '';
34
- for (const b of bytes) out += b.toString(16).padStart(2, '0');
35
- return out;
36
- }
37
-
38
- /** Strict lowercase-hex normalization; null when the value is not hex. */
39
- function normalizeHex(value, expectedChars) {
40
- const clean = value.trim().toLowerCase().replace(/^0x/, '');
41
- if (clean.length !== expectedChars || /[^0-9a-f]/.test(clean)) return null;
42
- return clean;
43
- }
44
- let resolved;
45
-
46
- /**
47
- * The native-first verifier, or null when the native module (or its
48
- * verifyEd25519 method — an app running new JS against an old binary) is
49
- * absent. Cached like the builtin: module availability does not change at
50
- * runtime, and this is consulted on every update check.
51
- */
52
- export function getNativeVerifier() {
53
- if (resolved !== undefined) return resolved;
54
- const native = NativeScaleBunOta;
55
- if (!native || typeof native.verifyEd25519 !== 'function') {
56
- // Old binary, Jest, web/SSR — not an error, just not this source.
57
- resolved = null;
58
- return null;
59
- }
60
- resolved = async ({
61
- messageHex,
62
- signature,
63
- publicKey
64
- }) => {
65
- // All decoding and validation happens HERE, in one place, so both
66
- // platforms' native code only ever sees clean fixed-length hex. The
67
- // signature may arrive hex or base64 (the wire allows both) — reuse
68
- // the builtin's decoder rather than growing a second, subtly
69
- // different one.
70
- const message = normalizeHex(messageHex, 64);
71
- const key = normalizeHex(publicKey, ED25519_PUBLIC_KEY_HEX_CHARS);
72
- const sigBytes = decodeSignature(signature);
73
- if (!message || !key || !sigBytes) {
74
- // Same messages-by-symptom philosophy as the builtin: a mistyped
75
- // key must not present as "every update is a forgery".
76
- logger.error('[OTA] Signature inputs malformed (bundle hash, signature, or public key) — refusing to stage.');
77
- return false;
78
- }
79
- let verdict;
80
- try {
81
- verdict = await native.verifyEd25519(message, bytesToHex(sigBytes), key);
82
- } catch (err) {
83
- // A rejected promise is machinery failure, not a forgery verdict.
84
- logger.warn(`[OTA] Native ed25519 verify failed to run: ${err?.message ?? err}`);
85
- verdict = 'unavailable';
86
- }
87
- if (verdict === 'valid') return true;
88
- if (verdict === 'invalid') return false;
89
-
90
- // 'unavailable' (Android < 33) — fall back to the JS verifier so those
91
- // devices keep verifying rather than losing enforcement.
92
- const builtin = getBuiltinVerifier();
93
- if (builtin) {
94
- return builtin({
95
- messageHex,
96
- signature,
97
- publicKey
98
- });
99
- }
100
- // No source can verify. Throwing (rather than returning false) keeps
101
- // the policy layer's outcome labels honest: this surfaces as machinery
102
- // failure with an actionable message, not as "the bundle is forged".
103
- throw new Error('ed25519 unavailable: this OS has no native implementation (Android < 13) and the ' + 'optional peers @noble/ed25519 + @noble/hashes are not installed.');
104
- };
105
- __DEV__ && logger.debug('[OTA] Using native ed25519 verifier (platform crypto).');
106
- return resolved;
107
- }
108
-
109
- /** Test seam — clears the cached resolution. */
110
- export function _resetNativeVerifier() {
111
- resolved = undefined;
112
- }
113
- //# sourceMappingURL=nativeVerifier.js.map