@nokinc-flur/sdk 1.1.2 → 1.1.4

package/dist/index.js

@@ -1563,64 +1563,113 @@ function constantTimeEqual(a, b) {
   return diff === 0;
 }
 
-// src/crypto/ed25519.ts
-import { ed25519 } from "@noble/curves/ed25519";
-function generateKeyPair() {
-  const privateKey = ed25519.utils.randomPrivateKey();
-  const publicKey = ed25519.getPublicKey(privateKey);
-  return { privateKey, publicKey };
+// src/offline/oac.ts
+import { z as z5 } from "zod";
+
+// src/crypto/p256-issuer.ts
+import { p256 } from "@noble/curves/nist";
+function bytesToBase64(bytes) {
+  if (typeof Buffer !== "undefined") {
+    return Buffer.from(bytes).toString("base64");
+  }
+  let bin = "";
+  for (let i = 0; i < bytes.length; i++) bin += String.fromCharCode(bytes[i]);
+  return btoa(bin);
 }
-function publicKeyFromPrivate(privateKey) {
-  return ed25519.getPublicKey(privateKey);
+function base64ToBytes(b64) {
+  if (typeof Buffer !== "undefined") {
+    return new Uint8Array(Buffer.from(b64, "base64"));
+  }
+  const bin = atob(b64);
+  const out = new Uint8Array(bin.length);
+  for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
+  return out;
+}
+var P256_SPKI_HEADER = new Uint8Array([
+  48,
+  89,
+  48,
+  19,
+  6,
+  7,
+  42,
+  134,
+  72,
+  206,
+  61,
+  2,
+  1,
+  6,
+  8,
+  42,
+  134,
+  72,
+  206,
+  61,
+  3,
+  1,
+  7,
+  3,
+  66,
+  0
+]);
+function p256SpkiB64ToRaw(spkiB64) {
+  const spki = base64ToBytes(spkiB64);
+  if (spki.length !== P256_SPKI_HEADER.length + 65) {
+    throw new Error("p256: invalid SPKI length");
+  }
+  for (let i = 0; i < P256_SPKI_HEADER.length; i++) {
+    if (spki[i] !== P256_SPKI_HEADER[i]) {
+      throw new Error("p256: invalid SPKI header");
+    }
+  }
+  return spki.slice(P256_SPKI_HEADER.length);
 }
-function sign(message, privateKey) {
-  return ed25519.sign(message, privateKey);
+function signIssuerP256(bytes, issuerPrivateKey) {
+  const sig = p256.sign(bytes, issuerPrivateKey, { prehash: true });
+  return bytesToBase64(sig.toBytes("der"));
 }
-function verify(message, signature, publicKey) {
+function verifyIssuerP256(bytes, signatureB64, issuerPublicKeySpkiB64) {
   try {
-    return ed25519.verify(signature, message, publicKey);
+    const pubRaw = p256SpkiB64ToRaw(issuerPublicKeySpkiB64);
+    const sigBytes = base64ToBytes(signatureB64);
+    return p256.verify(sigBytes, bytes, pubRaw, {
+      prehash: true,
+      format: "der"
+    });
   } catch {
     return false;
   }
 }
-function signCanonical(value, privateKey) {
-  return sign(canonicalJSONBytes(value), privateKey);
-}
-function verifyCanonical(value, signature, publicKey) {
-  return verify(canonicalJSONBytes(value), signature, publicKey);
-}
 
 // src/offline/oac.ts
-import { z as z5 } from "zod";
 var OAC_DEFAULT_PER_TX_KOBO = 5e5;
 var OAC_DEFAULT_CUMULATIVE_KOBO = 2e6;
 var OAC_DEFAULT_VALIDITY_MS = 24 * 60 * 60 * 1e3;
-var HexString = (length) => z5.string().regex(
-  new RegExp(`^[0-9a-fA-F]{${length * 2}}$`),
-  `expected ${length}-byte hex string`
-);
+var Base64Std = z5.string().min(16).max(4096).regex(/^[A-Za-z0-9+/]+={0,2}$/, "expected base64 (standard) string");
 var OACSchema = z5.object({
   userId: z5.string().min(1),
   deviceId: z5.string().min(1),
-  devicePublicKey: HexString(32),
+  /** SubjectPublicKeyInfo DER, base64 (P-256). */
+  devicePublicKey: Base64Std,
   perTxCapKobo: z5.number().int().nonnegative(),
   cumulativeCapKobo: z5.number().int().nonnegative(),
   validFromMs: z5.number().int().nonnegative(),
   validUntilMs: z5.number().int().positive(),
   counterSeed: z5.number().int().nonnegative(),
   nonce: z5.string().min(1),
-  issuerSig: HexString(64)
+  /** ASN.1 DER ECDSA(SHA-256) signature, base64. */
+  issuerSig: Base64Std
 }).refine((v) => v.validUntilMs > v.validFromMs, {
   message: "validUntilMs must be greater than validFromMs"
 }).refine((v) => v.perTxCapKobo <= v.cumulativeCapKobo, {
   message: "perTxCapKobo must not exceed cumulativeCapKobo"
 });
 function buildOAC(input) {
-  const devicePublicKey = typeof input.devicePublicKey === "string" ? input.devicePublicKey : bytesToHex(input.devicePublicKey);
   return {
     userId: input.userId,
     deviceId: input.deviceId,
-    devicePublicKey,
+    devicePublicKey: input.devicePublicKey,
     perTxCapKobo: input.perTxCapKobo ?? OAC_DEFAULT_PER_TX_KOBO,
     cumulativeCapKobo: input.cumulativeCapKobo ?? OAC_DEFAULT_CUMULATIVE_KOBO,
     validFromMs: input.validFromMs,
@@ -1630,36 +1679,25 @@ function buildOAC(input) {
   };
 }
 function signOAC(unsigned, issuerPrivateKey) {
-  const issuerSig = bytesToHex(
-    sign(canonicalJSONBytes(unsigned), issuerPrivateKey)
+  const issuerSig = signIssuerP256(
+    canonicalJSONBytes(unsigned),
+    issuerPrivateKey
   );
   return { ...unsigned, issuerSig };
 }
-function verifyOAC(oac, issuerPublicKey) {
+function verifyOAC(oac, issuerPublicKeySpkiB64) {
   try {
     const parsed = OACSchema.parse(oac);
     const { issuerSig, ...unsigned } = parsed;
-    return verify(
+    return verifyIssuerP256(
       canonicalJSONBytes(unsigned),
-      hexToBytes(issuerSig),
-      issuerPublicKey
+      issuerSig,
+      issuerPublicKeySpkiB64
     );
   } catch {
     return false;
   }
 }
-function bytesToHex(b) {
-  let s = "";
-  for (let i = 0; i < b.length; i++) s += b[i].toString(16).padStart(2, "0");
-  return s;
-}
-function hexToBytes(s) {
-  if (s.length % 2 !== 0) throw new Error("hex: odd length");
-  const out = new Uint8Array(s.length / 2);
-  for (let i = 0; i < out.length; i++)
-    out[i] = parseInt(s.slice(i * 2, i * 2 + 2), 16);
-  return out;
-}
 
 // src/offline/codec.ts
 var ALPHABET = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ $%*+-./:";
@@ -1716,19 +1754,19 @@ function decodeBase45(s) {
 
 // src/offline/messages.ts
 import { z as z6 } from "zod";
-var HexSig = z6.string().regex(/^[0-9a-fA-F]{128}$/, "expected 64-byte hex signature");
+var Base64Sig = z6.string().min(16).max(4096).regex(/^[A-Za-z0-9+/]+={0,2}$/, "expected base64 (standard) signature");
 var OfflinePaymentRequestSchema = z6.object({
   reference: z6.string().min(1),
   amountKobo: z6.number().int().positive(),
   merchantOAC: OACSchema,
   expiresAtMs: z6.number().int().positive(),
-  merchantSig: HexSig
+  merchantSig: Base64Sig
 });
 var OfflinePaymentAuthorizationSchema = z6.object({
   request: OfflinePaymentRequestSchema,
   payerOAC: OACSchema,
   payerCounter: z6.number().int().positive(),
-  payerSig: HexSig
+  payerSig: Base64Sig
 });
 function buildPaymentRequest(input) {
   if (!Number.isInteger(input.amountKobo) || input.amountKobo <= 0) {
@@ -1745,27 +1783,28 @@ function buildPaymentRequest(input) {
   };
 }
 function signPaymentRequest(unsigned, merchantDevicePrivateKey) {
-  const merchantSig = bytesToHex(
-    sign(canonicalJSONBytes(unsigned), merchantDevicePrivateKey)
+  const merchantSig = signIssuerP256(
+    canonicalJSONBytes(unsigned),
+    merchantDevicePrivateKey
   );
   return { ...unsigned, merchantSig };
 }
-function verifyPaymentRequest(req, issuerPublicKey) {
+function verifyPaymentRequest(req, issuerPublicKeySpkiB64) {
   try {
     const parsed = OfflinePaymentRequestSchema.parse(req);
     const { issuerSig: merchantOacSig, ...merchantOacUnsigned } = parsed.merchantOAC;
-    if (!verify(
+    if (!verifyIssuerP256(
       canonicalJSONBytes(merchantOacUnsigned),
-      hexToBytes(merchantOacSig),
-      issuerPublicKey
+      merchantOacSig,
+      issuerPublicKeySpkiB64
     )) {
       return false;
     }
     const { merchantSig, ...unsigned } = parsed;
-    return verify(
+    return verifyIssuerP256(
       canonicalJSONBytes(unsigned),
-      hexToBytes(merchantSig),
-      hexToBytes(parsed.merchantOAC.devicePublicKey)
+      merchantSig,
+      parsed.merchantOAC.devicePublicKey
     );
   } catch {
     return false;
@@ -1785,28 +1824,30 @@ function buildAuthorization(input) {
   };
 }
 function signAuthorization(unsigned, payerDevicePrivateKey) {
-  const payerSig = bytesToHex(
-    sign(canonicalJSONBytes(unsigned), payerDevicePrivateKey)
+  const payerSig = signIssuerP256(
+    canonicalJSONBytes(unsigned),
+    payerDevicePrivateKey
   );
   return { ...unsigned, payerSig };
 }
-function verifyAuthorization(auth, issuerPublicKey) {
+function verifyAuthorization(auth, issuerPublicKeySpkiB64) {
   try {
     const parsed = OfflinePaymentAuthorizationSchema.parse(auth);
-    if (!verifyPaymentRequest(parsed.request, issuerPublicKey)) return false;
+    if (!verifyPaymentRequest(parsed.request, issuerPublicKeySpkiB64))
+      return false;
     const { issuerSig: payerOacSig, ...payerOacUnsigned } = parsed.payerOAC;
-    if (!verify(
+    if (!verifyIssuerP256(
       canonicalJSONBytes(payerOacUnsigned),
-      hexToBytes(payerOacSig),
-      issuerPublicKey
+      payerOacSig,
+      issuerPublicKeySpkiB64
     )) {
       return false;
     }
     const { payerSig, ...unsigned } = parsed;
-    return verify(
+    return verifyIssuerP256(
       canonicalJSONBytes(unsigned),
-      hexToBytes(payerSig),
-      hexToBytes(parsed.payerOAC.devicePublicKey)
+      payerSig,
+      parsed.payerOAC.devicePublicKey
     );
   } catch {
     return false;
@@ -1838,7 +1879,7 @@ function decodeAuthorizationQR(s) {
 // src/offline/settlements.ts
 import { z as z7 } from "zod";
 import { sha256 } from "@noble/hashes/sha256";
-import { bytesToHex as bytesToHex2 } from "@noble/hashes/utils";
+import { bytesToHex } from "@noble/hashes/utils";
 var OfflineTokenSchema = z7.object({
   tokenId: z7.string().uuid(),
   tokenSerial: z7.string(),
@@ -1862,10 +1903,14 @@ var PaymentClaimSchema = z7.object({
   occurredAtMs: z7.number().int().nonnegative(),
   completedAtMs: z7.number().int().nonnegative().optional(),
   contextId: z7.string().optional(),
-  payerPubkey: z7.string().regex(/^[0-9a-f]{64}$/i),
-  payerSignature: z7.string().regex(/^[0-9a-f]+$/i),
-  payeePubkey: z7.string().regex(/^[0-9a-f]{64}$/i).optional(),
-  payeeSignature: z7.string().regex(/^[0-9a-f]+$/i).optional()
+  // Stage 2c: P-256 device keys are now SubjectPublicKeyInfo DER, base64.
+  // Signatures are ASN.1 DER ECDSA(SHA-256), base64. Backwards-incompatible
+  // wire change; the backend has the matching widening in offline-settlements
+  // service + zod schema.
+  payerPubkey: z7.string().min(16).max(4096).regex(/^[A-Za-z0-9+/]+={0,2}$/),
+  payerSignature: z7.string().min(16).max(4096).regex(/^[A-Za-z0-9+/]+={0,2}$/),
+  payeePubkey: z7.string().min(16).max(4096).regex(/^[A-Za-z0-9+/]+={0,2}$/).optional(),
+  payeeSignature: z7.string().min(16).max(4096).regex(/^[A-Za-z0-9+/]+={0,2}$/).optional()
 });
 var SettlementSchema = z7.object({
   settlementId: z7.string().uuid(),
@@ -1889,7 +1934,7 @@ var SettleResponseSchema = z7.object({
 });
 var ENCOUNTER_DOMAIN = "offline:v1:encounter";
 async function sha256Hex(input) {
-  return bytesToHex2(sha256(new TextEncoder().encode(input)));
+  return bytesToHex(sha256(new TextEncoder().encode(input)));
 }
 async function computeEncounterId(input) {
   return sha256Hex(
@@ -2293,10 +2338,6 @@ var PASS_STATES = [
   "expired",
   "revoked"
 ];
-var HexString2 = (length) => z9.string().regex(
-  new RegExp(`^[0-9a-fA-F]{${length * 2}}$`),
-  `expected ${length}-byte hex string`
-);
 var PassMetadataSchema = z9.record(
   z9.union([z9.string(), z9.number(), z9.boolean(), z9.null()])
 );
@@ -2317,9 +2358,9 @@ var PassSchema = z9.object({
   nonce: z9.string().min(1),
   /** Device id this pass is bound to (FK to backend `device_keys`). */
   holderDeviceId: z9.string().min(1),
-  /** 32-byte hex Ed25519 public key of the bound device. The redemption signature
-   *  is verified against this key — it is the security-critical binding. */
-  holderDevicePubkey: HexString2(32),
+  /** SubjectPublicKeyInfo DER (P-256) of the bound device, base64. The redemption
+   *  signature is verified against this key — it is the security-critical binding. */
+  holderDevicePubkey: z9.string().min(64).max(4096).regex(/^[A-Za-z0-9+/]+={0,2}$/),
   /** Optional fixed amount for monetary passes (vouchers, gift cards) in kobo. */
   amountKobo: z9.number().int().nonnegative().optional(),
   /** ISO-4217-ish currency code; required on the wire. SDK builders default to NGN. */
@@ -2328,7 +2369,8 @@ var PassSchema = z9.object({
   counterSeed: z9.number().int().nonnegative(),
   /** Optional cumulative spend cap in kobo across all redemptions of this pass. */
   cumulativeCapKobo: z9.number().int().nonnegative().optional(),
-  issuerSig: HexString2(64)
+  /** ASN.1 DER ECDSA P-256 signature, base64. */
+  issuerSig: z9.string().min(64).max(2048).regex(/^[A-Za-z0-9+/]+={0,2}$/)
 }).refine((v) => v.validUntilMs > v.validFromMs, {
   message: "validUntilMs must be greater than validFromMs"
 });
@@ -2361,19 +2403,20 @@ function buildPass(input) {
   return out;
 }
 function signPass(unsigned, issuerPrivateKey) {
-  const issuerSig = bytesToHex(
-    sign(canonicalJSONBytes(unsigned), issuerPrivateKey)
+  const issuerSig = signIssuerP256(
+    canonicalJSONBytes(unsigned),
+    issuerPrivateKey
   );
   return { ...unsigned, issuerSig };
 }
-function verifyPass(pass, issuerPublicKey) {
+function verifyPass(pass, issuerPublicKeySpkiB64) {
   try {
     const parsed = PassSchema.parse(pass);
     const { issuerSig, ...unsigned } = parsed;
-    return verify(
+    return verifyIssuerP256(
       canonicalJSONBytes(unsigned),
-      hexToBytes(issuerSig),
-      issuerPublicKey
+      issuerSig,
+      issuerPublicKeySpkiB64
     );
   } catch {
     return false;
@@ -2385,7 +2428,7 @@ function isPassWithinValidity(pass, nowMs) {
 
 // src/passes/redemption.ts
 import { z as z10 } from "zod";
-var HexSig2 = z10.string().regex(/^[0-9a-fA-F]{128}$/, "expected 64-byte hex signature");
+var Base64Std2 = z10.string().min(16).max(2048).regex(/^[A-Za-z0-9+/]+={0,2}$/, "expected base64 (std)");
 var RedemptionSchema = z10.object({
   pass: PassSchema,
   redeemerId: z10.string().min(1),
@@ -2396,7 +2439,8 @@ var RedemptionSchema = z10.object({
   /** Amount being redeemed in kobo (0 for non-monetary passes like ride tickets). */
   amountKobo: z10.number().int().nonnegative(),
   nonce: z10.string().min(1),
-  holderSig: HexSig2
+  /** ASN.1 DER ECDSA P-256 signature over canonicalJSONBytes(unsigned), base64. */
+  holderSig: Base64Std2
 });
 var REDEEMABLE_STATES = /* @__PURE__ */ new Set(["issued", "active"]);
 function buildRedemption(input) {
@@ -2450,31 +2494,28 @@ function buildRedemption(input) {
   };
 }
 function signRedemption(unsigned, holderDevicePrivateKey) {
-  const holderSig = bytesToHex(
-    sign(canonicalJSONBytes(unsigned), holderDevicePrivateKey)
+  const holderSig = signIssuerP256(
+    canonicalJSONBytes(unsigned),
+    holderDevicePrivateKey
   );
   return { ...unsigned, holderSig };
 }
-function verifyRedemption(r, issuerPublicKey) {
+function verifyRedemption(r, issuerPublicKeySpkiB64) {
   try {
     const parsed = RedemptionSchema.parse(r);
     if (parsed.counter <= parsed.pass.counterSeed) return false;
     const { issuerSig, ...passUnsigned } = parsed.pass;
-    if (!verify(
+    if (!verifyIssuerP256(
       canonicalJSONBytes(passUnsigned),
-      hexToBytes(issuerSig),
-      issuerPublicKey
+      issuerSig,
+      issuerPublicKeySpkiB64
     )) {
       return false;
     }
-    const holderHex = parsed.pass.holderDevicePubkey;
-    if (typeof holderHex !== "string") return false;
+    const holderPub = parsed.pass.holderDevicePubkey;
+    if (typeof holderPub !== "string") return false;
     const { holderSig, ...unsigned } = parsed;
-    return verify(
-      canonicalJSONBytes(unsigned),
-      hexToBytes(holderSig),
-      hexToBytes(holderHex)
-    );
+    return verifyIssuerP256(canonicalJSONBytes(unsigned), holderSig, holderPub);
   } catch {
     return false;
   }
@@ -2484,10 +2525,6 @@ function verifyRedemption(r, issuerPublicKey) {
 import { z as z11 } from "zod";
 var RECEIPT_CHANNELS = ["cash", "pass"];
 var RECEIPT_KINDS = RECEIPT_CHANNELS;
-var HexString3 = (length) => z11.string().regex(
-  new RegExp(`^[0-9a-fA-F]{${length * 2}}$`),
-  `expected ${length}-byte hex string`
-);
 var ReceiptPayloadSchema = z11.record(
   z11.union([z11.string(), z11.number(), z11.boolean(), z11.null()])
 );
@@ -2505,7 +2542,8 @@ var ReceiptSchema = z11.object({
   issuedAtMs: z11.number().int().nonnegative(),
   issuerId: z11.string().min(1),
   payload: ReceiptPayloadSchema,
-  issuerSig: HexString3(64)
+  /** ASN.1 DER ECDSA P-256 signature, base64. */
+  issuerSig: z11.string().min(64).max(2048).regex(/^[A-Za-z0-9+/]+={0,2}$/)
 }).superRefine((v, ctx) => {
   if (v.channel === "cash") {
     if (!v.intentId) {
@@ -2571,19 +2609,20 @@ function buildReceipt(input) {
   return out;
 }
 function signReceipt(unsigned, issuerPrivateKey) {
-  const issuerSig = bytesToHex(
-    sign(canonicalJSONBytes(unsigned), issuerPrivateKey)
+  const issuerSig = signIssuerP256(
+    canonicalJSONBytes(unsigned),
+    issuerPrivateKey
   );
   return { ...unsigned, issuerSig };
 }
-function verifyReceipt(r, issuerPublicKey) {
+function verifyReceipt(r, issuerPublicKeySpkiB64) {
   try {
     const parsed = ReceiptSchema.parse(r);
     const { issuerSig, ...unsigned } = parsed;
-    return verify(
+    return verifyIssuerP256(
       canonicalJSONBytes(unsigned),
-      hexToBytes(issuerSig),
-      issuerPublicKey
+      issuerSig,
+      issuerPublicKeySpkiB64
     );
   } catch {
     return false;
@@ -2918,17 +2957,49 @@ function createAccountsClient(opts) {
 // src/me-offline/client.ts
 import { z as z13 } from "zod";
 var Hex64 = z13.string().regex(/^[0-9a-f]{64}$/i);
-var HexAny = z13.string().regex(/^[0-9a-f]+$/i);
 var Sha256Hex = z13.string().regex(/^[0-9a-f]{64}$/i);
+var Base64Std3 = z13.string().regex(/^[A-Za-z0-9+/]+={0,2}$/);
 var RegisterDeviceKeyInputSchema = z13.object({
   deviceId: z13.string().min(1).max(128),
   publicKeyHex: Hex64
 });
+var AttestationSecurityLevelSchema = z13.enum([
+  "STRONGBOX",
+  "TEE",
+  "SECURE_ENCLAVE",
+  "SOFTWARE"
+]);
+var DeviceKeyAlgSchema = z13.literal("p256");
+var RegisterDeviceKeyP256InputSchema = z13.object({
+  deviceId: z13.string().min(1).max(128),
+  /** P-256 SubjectPublicKeyInfo DER, base64. */
+  publicKeySpkiB64: Base64Std3.min(64).max(4096),
+  /** Base64 of the server-issued enrollment challenge string. */
+  challengeB64: Base64Std3.min(8).max(1024),
+  /** iOS App Attest payload or Android X.509 Key Attestation chain. */
+  attestationChainB64: z13.array(Base64Std3.min(16).max(16384)).min(1).max(16),
+  securityLevel: AttestationSecurityLevelSchema
+});
+var P256EnrollmentChallengeInputSchema = z13.object({
+  deviceId: z13.string().min(1).max(128)
+});
+var P256EnrollmentChallengeResultSchema = z13.object({
+  challenge: z13.string().min(16),
+  expiresAtMs: z13.number().int().positive()
+});
 var DeviceKeyRecordSchema = z13.object({
   id: z13.string().uuid(),
   userId: z13.string().uuid(),
   deviceId: z13.string(),
-  publicKeyHex: Hex64,
+  /** Always 'p256' on the consumer offline rail. Field retained for forward-compat. */
+  alg: DeviceKeyAlgSchema.default("p256"),
+  /** Legacy ed25519 hex key. Always null on new records (kept for back-compat reads). */
+  publicKeyHex: Hex64.nullable().default(null),
+  /** P-256 SubjectPublicKeyInfo DER, base64. Required for new records. */
+  publicKeySpkiB64: Base64Std3.nullable().default(null),
+  securityLevel: AttestationSecurityLevelSchema.nullable().default(null),
+  hardwareBacked: z13.boolean().default(false),
+  attestedAtMs: z13.number().int().nonnegative().nullable().default(null),
   createdAtMs: z13.number().int().nonnegative(),
   revokedAtMs: z13.number().int().nonnegative().nullable()
 });
@@ -2937,7 +3008,10 @@ var ConsumerOACSchema = z13.object({
   issuerId: z13.string().min(1).max(64),
   userId: z13.string().uuid(),
   deviceId: z13.string().min(1).max(128),
-  devicePubkeyHex: Hex64,
+  /** Always 'p256'. Field retained for forward-compat. */
+  alg: z13.literal("p256").default("p256"),
+  /** P-256 SubjectPublicKeyInfo DER, base64. */
+  devicePubkeySpkiB64: Base64Std3.min(64).max(4096),
   perTxCapKobo: z13.number().int().positive(),
   cumulativeCapKobo: z13.number().int().positive(),
   currency: z13.string().length(3),
@@ -2948,8 +3022,10 @@ var ConsumerOACSchema = z13.object({
 });
 var SignedConsumerOACSchema = z13.object({
   oac: ConsumerOACSchema,
-  issuerSig: HexAny,
-  issuerPublicKeyHex: Hex64
+  /** ASN.1 DER ECDSA P-256 issuer signature, base64. */
+  issuerSig: Base64Std3.min(16).max(2048),
+  /** Issuer's P-256 public key as SubjectPublicKeyInfo DER, base64. */
+  issuerPublicKeySpkiB64: Base64Std3.min(64).max(4096)
 });
 var OACRecordSchema = SignedConsumerOACSchema.extend({
   currentOfflineSpentKobo: z13.number().int().nonnegative(),
@@ -2981,6 +3057,7 @@ var EnableOfflineInputSchema = z13.object({
   installId: z13.string().min(1).max(128),
   partnerId: z13.string().min(1).max(64).optional()
 });
+var ProvisionOfflineAllowanceInputSchema = EnableOfflineInputSchema;
 var DisableOfflineInputSchema = z13.object({
   deviceId: z13.string().min(1).max(128),
   installId: z13.string().min(1).max(128).optional(),
@@ -3018,6 +3095,7 @@ var EnableOfflineResultSchema = z13.object({
   hold: OfflineHoldRecordSchema,
   oac: OACRecordSchema
 });
+var ProvisionOfflineAllowanceResultSchema = EnableOfflineResultSchema;
 var DisableOfflineResultSchema = z13.object({
   hold: OfflineHoldRecordSchema,
   trusted: z13.boolean(),
@@ -3031,6 +3109,8 @@ var OfflineStateResultSchema = z13.object({
   active: OACRecordSchema.nullable()
 });
 var ConsumerPaymentClaimSchema = z13.object({
+  /** Always 'p256'. Retained for forward-compat and as an explicit domain marker. */
+  alg: z13.literal("p256").default("p256"),
   oacId: z13.string().uuid(),
   encounterId: Sha256Hex.optional(),
   payerUserId: z13.string().uuid(),
@@ -3043,10 +3123,10 @@ var ConsumerPaymentClaimSchema = z13.object({
   occurredAtMs: z13.number().int().nonnegative(),
   completedAtMs: z13.number().int().nonnegative().optional(),
   contextId: z13.string().max(128).optional(),
-  payerPubkeyHex: Hex64,
-  payerSignature: HexAny,
-  payeePubkeyHex: Hex64.optional(),
-  payeeSignature: HexAny.optional()
+  payerPubkeySpkiB64: Base64Std3.min(64).max(4096),
+  payerSignatureDerB64: Base64Std3.min(16).max(2048),
+  payeePubkeySpkiB64: Base64Std3.min(64).max(4096).optional(),
+  payeeSignatureDerB64: Base64Std3.min(16).max(2048).optional()
 });
 var ConsumerSettlementSchema = z13.object({
   settlementId: z13.string().uuid(),
@@ -3060,7 +3140,8 @@ var ConsumerSettlementSchema = z13.object({
   status: z13.enum(["SETTLED", "REVIEW"]),
   reviewReason: z13.string().nullable(),
   ledgerRef: z13.string().nullable(),
-  issuerSig: HexAny,
+  /** ASN.1 DER ECDSA P-256 issuer signature, base64. */
+  issuerSig: Base64Std3.min(16).max(2048),
   createdAtMs: z13.number().int().nonnegative()
 });
 var ConsumerSettleResultSchema = z13.object({
@@ -3112,6 +3193,18 @@ function createMeOfflineClient(opts) {
       RegisterDeviceKeyInputSchema.parse(input),
       (raw) => DeviceKeyRecordSchema.parse(raw)
     ),
+    issueP256EnrollmentChallenge: (input) => call(
+      "POST",
+      "/v1/me/offline/keys/p256/challenge",
+      P256EnrollmentChallengeInputSchema.parse(input),
+      (raw) => P256EnrollmentChallengeResultSchema.parse(raw)
+    ),
+    registerDeviceKeyP256: (input) => call(
+      "POST",
+      "/v1/me/offline/keys/p256",
+      RegisterDeviceKeyP256InputSchema.parse(input),
+      (raw) => DeviceKeyRecordSchema.parse(raw)
+    ),
     listDeviceKeys: () => call(
       "GET",
       "/v1/me/offline/keys",
@@ -3124,6 +3217,12 @@ function createMeOfflineClient(opts) {
       RevokeDeviceKeyInputSchema.parse(input),
       () => void 0
     ),
+    provisionAllowance: (input) => call(
+      "POST",
+      "/v1/me/offline/allowance",
+      ProvisionOfflineAllowanceInputSchema.parse(input),
+      (raw) => ProvisionOfflineAllowanceResultSchema.parse(raw)
+    ),
     enable: (input) => call(
       "POST",
       "/v1/me/offline/enable",
@@ -3169,6 +3268,185 @@ function createMeOfflineClient(opts) {
   };
 }
 
+// src/me-offline/signer.ts
+import { p256 as p2562 } from "@noble/curves/nist";
+var CLAIM_DOMAIN_V2 = "flur:consumer-offline:v2:claim";
+function canonicalClaimSigningPayload(claim) {
+  return {
+    domain: CLAIM_DOMAIN_V2,
+    alg: claim.alg,
+    oacId: claim.oacId,
+    payerUserId: claim.payerUserId,
+    payeeUserId: claim.payeeUserId,
+    payerDeviceId: claim.payerDeviceId,
+    payerNonce: claim.payerNonce,
+    payeeNonce: claim.payeeNonce,
+    amountKobo: claim.amountKobo,
+    currency: claim.currency,
+    occurredAtMs: claim.occurredAtMs,
+    completedAtMs: claim.completedAtMs ?? null,
+    contextId: claim.contextId ?? null
+  };
+}
+function canonicalClaimSigningBytes(claim) {
+  return canonicalJSONBytes(canonicalClaimSigningPayload(claim));
+}
+function bytesToBase642(bytes) {
+  if (typeof Buffer !== "undefined") {
+    return Buffer.from(bytes).toString("base64");
+  }
+  let bin = "";
+  for (let i = 0; i < bytes.length; i++) bin += String.fromCharCode(bytes[i]);
+  return btoa(bin);
+}
+function base64ToBytes2(b64) {
+  if (typeof Buffer !== "undefined") {
+    return new Uint8Array(Buffer.from(b64, "base64"));
+  }
+  const bin = atob(b64);
+  const out = new Uint8Array(bin.length);
+  for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
+  return out;
+}
+var P256_SPKI_HEADER2 = new Uint8Array([
+  48,
+  89,
+  48,
+  19,
+  6,
+  7,
+  42,
+  134,
+  72,
+  206,
+  61,
+  2,
+  1,
+  6,
+  8,
+  42,
+  134,
+  72,
+  206,
+  61,
+  3,
+  1,
+  7,
+  3,
+  66,
+  0
+]);
+function p256PublicKeyToSpkiB64(rawUncompressed) {
+  if (rawUncompressed.length !== 65 || rawUncompressed[0] !== 4) {
+    throw new Error("p256: expected 65-byte uncompressed point");
+  }
+  const out = new Uint8Array(P256_SPKI_HEADER2.length + rawUncompressed.length);
+  out.set(P256_SPKI_HEADER2, 0);
+  out.set(rawUncompressed, P256_SPKI_HEADER2.length);
+  return bytesToBase642(out);
+}
+function p256SpkiB64ToPublicKey(spkiB64) {
+  const spki = base64ToBytes2(spkiB64);
+  if (spki.length !== P256_SPKI_HEADER2.length + 65) {
+    throw new Error("p256: invalid SPKI length");
+  }
+  for (let i = 0; i < P256_SPKI_HEADER2.length; i++) {
+    if (spki[i] !== P256_SPKI_HEADER2[i]) {
+      throw new Error("p256: invalid SPKI header");
+    }
+  }
+  return spki.slice(P256_SPKI_HEADER2.length);
+}
+function createSoftwareP256Signer(privateKey) {
+  const raw = p2562.getPublicKey(privateKey, false);
+  const spkiB64 = p256PublicKeyToSpkiB64(raw);
+  return {
+    alg: "p256",
+    async getPublicKey() {
+      return { alg: "p256", publicKey: spkiB64 };
+    },
+    async sign(bytes) {
+      const sig = p2562.sign(bytes, privateKey, { prehash: true });
+      const der = sig.toBytes("der");
+      return { alg: "p256", signature: bytesToBase642(der) };
+    }
+  };
+}
+function verifyClaimSignature(input) {
+  try {
+    if (input.alg !== "p256") return false;
+    const sigDer = base64ToBytes2(input.signature);
+    const pub = p256SpkiB64ToPublicKey(input.publicKey);
+    return p2562.verify(sigDer, input.bytes, pub, {
+      prehash: true,
+      format: "der"
+    });
+  } catch {
+    return false;
+  }
+}
+
+// src/me-offline/sms.ts
+var OFFLINE_CLAIM_SMS_PREFIX = "FLURC1.";
+var TOKEN_RE = /(?:^|\s)(FLURC1\.[A-Za-z0-9_-]+={0,2})(?:\s|$)/;
+function encodeOfflineClaimSmsMessage(claim) {
+  const parsed = ConsumerPaymentClaimSchema.parse(claim);
+  const json = JSON.stringify(parsed);
+  return `${OFFLINE_CLAIM_SMS_PREFIX}${base64UrlEncodeUtf8(json)}`;
+}
+function decodeOfflineClaimSmsMessage(message) {
+  const token = extractOfflineClaimSmsToken(message);
+  if (!token) {
+    throw new Error("offline claim SMS token not found");
+  }
+  const encoded = token.slice(OFFLINE_CLAIM_SMS_PREFIX.length);
+  let raw;
+  try {
+    raw = JSON.parse(base64UrlDecodeUtf8(encoded));
+  } catch {
+    throw new Error("offline claim SMS token is malformed");
+  }
+  const parsed = ConsumerPaymentClaimSchema.safeParse(raw);
+  if (!parsed.success) {
+    throw new Error("offline claim SMS token is invalid");
+  }
+  return parsed.data;
+}
+function extractOfflineClaimSmsToken(message) {
+  const trimmed = message.trim();
+  if (trimmed.startsWith(OFFLINE_CLAIM_SMS_PREFIX)) {
+    return trimmed.split(/\s+/, 1)[0] ?? null;
+  }
+  return TOKEN_RE.exec(message)?.[1] ?? null;
+}
+function base64UrlEncodeUtf8(input) {
+  const bytes = new TextEncoder().encode(input);
+  let binary = "";
+  for (const byte of bytes) binary += String.fromCharCode(byte);
+  const base64 = typeof btoa === "function" ? btoa(binary) : typeof Buffer !== "undefined" ? Buffer.from(bytes).toString("base64") : void 0;
+  if (!base64) throw new Error("base64 encoder unavailable");
+  return base64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/g, "");
+}
+function base64UrlDecodeUtf8(input) {
+  const base64 = input.replace(/-/g, "+").replace(/_/g, "/");
+  const padded = base64.padEnd(
+    base64.length + (4 - base64.length % 4) % 4,
+    "="
+  );
+  if (typeof atob === "function") {
+    const binary = atob(padded);
+    const bytes = new Uint8Array(binary.length);
+    for (let index = 0; index < binary.length; index++) {
+      bytes[index] = binary.charCodeAt(index);
+    }
+    return new TextDecoder().decode(bytes);
+  }
+  if (typeof Buffer !== "undefined") {
+    return Buffer.from(padded, "base64").toString("utf8");
+  }
+  throw new Error("base64 decoder unavailable");
+}
+
 // src/partner-funding/client.ts
 import { z as z14 } from "zod";
 var MinorString = z14.string().regex(/^-?\d+$/);
@@ -3544,14 +3822,15 @@ function buildArtifactBody(input) {
   return { ...header, data: input.data };
 }
 function signArtifact(body, privateKey) {
-  const sig = bytesToHex(sign(canonicalJSONBytes(body), privateKey));
+  const sig = signIssuerP256(canonicalJSONBytes(body), privateKey);
   return { body, sig };
 }
 function encodeArtifactUri(signed) {
   const bodyBytes = canonicalJSONBytes(signed.body);
   const bodyB64 = base64UrlEncode(bodyBytes);
-  const sigB64 = base64UrlEncode(hexToBytes(signed.sig));
-  return `${FLUR_ARTIFACT_URI_PREFIX}${signed.body.t}/${bodyB64}.${sigB64}`;
+  const sigBytes = base64UrlDecode(signed.sig);
+  const sigB64Url = base64UrlEncode(sigBytes);
+  return `${FLUR_ARTIFACT_URI_PREFIX}${signed.body.t}/${bodyB64}.${sigB64Url}`;
 }
 function decodeArtifactUri(uri) {
   if (!uri.startsWith(FLUR_ARTIFACT_URI_PREFIX)) {
@@ -3582,9 +3861,9 @@ function decodeArtifactUri(uri) {
   }
   const bodyBytes = base64UrlDecode(payload.slice(0, dot));
   const sigBytes = base64UrlDecode(payload.slice(dot + 1));
-  if (sigBytes.length !== 64) {
+  if (sigBytes.length < 64 || sigBytes.length > 80) {
     throw new FlurArtifactError(
-      `Signature must be 64 bytes, got ${sigBytes.length}`,
+      `Signature length out of range: ${sigBytes.length}`,
       "INVALID_SIGNATURE"
     );
   }
@@ -3611,17 +3890,26 @@ function decodeArtifactUri(uri) {
     type,
     bodyBytes,
     body: bodyJson,
-    sig: bytesToHex(sigBytes)
+    // Encode as standard base64 (not url-safe) for sig field consistency.
+    sig: encodeStdBase64(sigBytes)
   };
 }
-function verifyArtifactSignature(decoded, publicKey, options = {}) {
+function encodeStdBase64(bytes) {
+  if (typeof Buffer !== "undefined") {
+    return Buffer.from(bytes).toString("base64");
+  }
+  let bin = "";
+  for (let i = 0; i < bytes.length; i++) bin += String.fromCharCode(bytes[i]);
+  return typeof btoa === "function" ? btoa(bin) : "";
+}
+function verifyArtifactSignature(decoded, publicKeySpkiB64, options = {}) {
   if (options.enforceExpiry !== false && decoded.body.exp !== void 0) {
     const now = options.nowSeconds ?? Math.floor(Date.now() / 1e3);
     if (decoded.body.exp < now) {
       throw new FlurArtifactError("Artifact has expired", "EXPIRED");
     }
   }
-  return verify(decoded.bodyBytes, hexToBytes(decoded.sig), publicKey);
+  return verifyIssuerP256(decoded.bodyBytes, decoded.sig, publicKeySpkiB64);
 }
 
 // src/artifacts/types.ts
@@ -3640,7 +3928,7 @@ var ARTIFACT_TYPES = {
   PASS: "pass",
   IDENTITY: "identity"
 };
-var HexString4 = (length) => z16.string().regex(
+var HexString = (length) => z16.string().regex(
   new RegExp(`^[0-9a-fA-F]{${length * 2}}$`),
   `expected ${length}-byte hex string`
 );
@@ -3658,7 +3946,7 @@ var ReceiptArtifactSchema = z16.object({
   settledAtMs: z16.number().int().positive(),
   ledgerTxnId: z16.string().min(1).max(64).optional(),
   memo: z16.string().max(140).optional(),
-  hashChainPrev: HexString4(32).optional()
+  hashChainPrev: HexString(32).optional()
 });
 var ShortId = z16.string().min(1).max(64);
 var PositiveInt = z16.number().int().positive();
@@ -3740,7 +4028,7 @@ var StatementArtifactSchema = z16.object({
   closingBalanceKobo: z16.number().int(),
   transactionCount: NonNegativeInt,
   currency: Currency2,
-  hashChainPrev: HexString4(32).optional()
+  hashChainPrev: HexString(32).optional()
 }).refine((v) => v.periodEndMs > v.periodStartMs, {
   message: "periodEndMs must be greater than periodStartMs",
   path: ["periodEndMs"]
@@ -3773,7 +4061,7 @@ var IdentityArtifactSchema = z16.object({
     "kyc_tier",
     "age_band"
   ]),
-  claimValueHash: HexString4(32),
+  claimValueHash: HexString(32),
   attestedAtMs: PositiveInt
 });
 var ARTIFACT_BODY_SCHEMAS = {
@@ -3837,7 +4125,7 @@ function createArtifactUri(input) {
   const signed = signArtifact(body, input.privateKey);
   return { uri: encodeArtifactUri(signed), signed };
 }
-function verifyArtifactUri(uri, publicKey, options = {}) {
+function verifyArtifactUri(uri, publicKeySpkiB64, options = {}) {
   const decoded = decodeArtifactUri(uri);
   if (!isKnownArtifactType(decoded.type)) {
     throw new FlurArtifactError(
@@ -3859,7 +4147,7 @@ function verifyArtifactUri(uri, publicKey, options = {}) {
       "INVALID_BODY"
     );
   }
-  const ok = verifyArtifactSignature(decoded, publicKey, options);
+  const ok = verifyArtifactSignature(decoded, publicKeySpkiB64, options);
   if (!ok) {
     throw new FlurArtifactError(
       "Artifact signature verification failed",
@@ -3895,6 +4183,8 @@ export {
   AccountSchema,
   ApiCredentialPublicSchema,
   ArtifactHeaderSchema,
+  AttestationSecurityLevelSchema,
+  CLAIM_DOMAIN_V2,
   COLLECTION_INTENT_STATUSES,
   COLLECTION_PAYMENT_STATUSES,
   CUSTODIAL_MODES,
@@ -3913,6 +4203,7 @@ export {
   CreatePayoutInputSchema,
   CreateWithdrawalInputSchema,
   CreateWithdrawalResultSchema,
+  DeviceKeyAlgSchema,
   DeviceKeyRecordSchema,
   DisableOfflineInputSchema,
   DisableOfflineResultSchema,
@@ -3949,6 +4240,7 @@ export {
   OAC_DEFAULT_CUMULATIVE_KOBO,
   OAC_DEFAULT_PER_TX_KOBO,
   OAC_DEFAULT_VALIDITY_MS,
+  OFFLINE_CLAIM_SMS_PREFIX,
   OfflineClaimArtifactSchema,
   OfflineHoldRecordSchema,
   OfflinePaymentAuthorizationArtifactSchema,
@@ -3957,6 +4249,8 @@ export {
   OfflineStateResultSchema,
   OfflineStatusResultSchema,
   OfflineTokenSchema,
+  P256EnrollmentChallengeInputSchema,
+  P256EnrollmentChallengeResultSchema,
   PARTNER_FUNDING_DIRECTIONS,
   PARTNER_FUNDING_STATUSES,
   PARTNER_KINDS,
@@ -3980,6 +4274,8 @@ export {
   PayoutEventInputSchema,
   ProviderEventInputSchema,
   ProviderEventRecordSchema,
+  ProvisionOfflineAllowanceInputSchema,
+  ProvisionOfflineAllowanceResultSchema,
   PublicCollectionIntentSchema,
   RECEIPT_CHANNELS,
   RECEIPT_KINDS,
@@ -3991,6 +4287,7 @@ export {
   RecordPayoutEventResultSchema,
   RedemptionSchema,
   RegisterDeviceKeyInputSchema,
+  RegisterDeviceKeyP256InputSchema,
   ReversalRecordArtifactSchema,
   RevokeDeviceKeyInputSchema,
   SETTLEMENT_SCHEDULES,
@@ -4013,6 +4310,8 @@ export {
   buildPaymentRequest,
   buildReceipt,
   buildRedemption,
+  canonicalClaimSigningBytes,
+  canonicalClaimSigningPayload,
   canonicalJSONBytes,
   canonicalJSONStringify,
   canonicalRequestString,
@@ -4037,18 +4336,21 @@ export {
   createPassesClient,
   createReceiptArtifactUri,
   createReceiptsClient,
+  createSoftwareP256Signer,
   decodeArtifactUri,
   decodeAuthorizationQR,
   decodeBase45,
+  decodeOfflineClaimSmsMessage,
   decodePaymentRequestQR,
   encodeArtifactUri,
   encodeAuthorizationQR,
   encodeBase45,
   encodeNQR,
+  encodeOfflineClaimSmsMessage,
   encodePaymentRequestQR,
+  extractOfflineClaimSmsToken,
   formatAmount,
   generateDynamicQR,
-  generateKeyPair,
   generateStaticQR,
   init,
   isHardenedArtifactType,
@@ -4059,13 +4361,10 @@ export {
   parseAmountInput,
   parseNQR,
   parseQR,
-  publicKeyFromPrivate,
   readTLV,
   routingHint,
-  sign,
   signArtifact,
   signAuthorization,
-  signCanonical,
   signOAC,
   signPartnerRequest,
   signPass,
@@ -4073,11 +4372,10 @@ export {
   signReceipt,
   signRedemption,
   signRequestHMAC,
-  verify,
   verifyArtifactSignature,
   verifyArtifactUri,
   verifyAuthorization,
-  verifyCanonical,
+  verifyClaimSignature,
   verifyOAC,
   verifyPass,
   verifyPaymentRequest,