feat(chain138): ISO20022 gateway, swift-listener, and address inventory sync.

Update checkpoint-core ISO20022 types/hashes, swift-listener canonical mapping, and chain138 address inventory.

Co-authored-by: Cursor <cursoragent@cursor.com>

packages/checkpoint-core/src/iso20022/hashes.ts

@@ -22,3 +22,11 @@ export function hashShortUtf8(value: string): string {
   if (!value) return ethers.ZeroHash;
   return ethers.keccak256(ethers.toUtf8Bytes(value));
 }
+
+/** KTT off-chain test-key attestation per SMART_CONTRACTS_ISO20022_FIN_METHODOLOGY §5.3 */
+export function authAttestationHashFromProof(testKeyProof: string, normalizedBody: string): string {
+  const proof = testKeyProof.trim();
+  const body = normalizedBody.trim();
+  if (!proof && !body) return ethers.ZeroHash;
+  return ethers.keccak256(ethers.concat([ethers.toUtf8Bytes(proof), ethers.toUtf8Bytes(body)]));
+}

packages/checkpoint-core/src/iso20022/types.ts

@@ -1,17 +1,18 @@
 /** ISO 20022 / SWIFT MT-103+ canonical message (off-chain full payload; on-chain hashes). */
-export type IsoMessageTypeCode = 0 | 1 | 2 | 3 | 4;
+export type IsoMessageTypeCode = 0 | 1 | 2 | 3 | 4 | 5;
 
-/** 0=unknown, 1=MT103, 2=pacs.008, 3=pain.001, 4=chain138 synthetic (from native tx) */
+/** 0=unknown, 1=MT103, 2=pacs.008, 3=pain.001, 4=chain138 synthetic, 5=KTT/telex */
 export const MSG_TYPE = {
   UNKNOWN: 0 as IsoMessageTypeCode,
   MT103: 1 as IsoMessageTypeCode,
   PACS008: 2 as IsoMessageTypeCode,
   PAIN001: 3 as IsoMessageTypeCode,
   CHAIN138_SYNTH: 4 as IsoMessageTypeCode,
+  KTT: 5 as IsoMessageTypeCode,
 } as const;
 
 export type CanonicalPaymentMessage = {
-  msgType: 'MT103' | 'pacs.008' | 'pain.001' | 'chain138.synthetic';
+  msgType: 'MT103' | 'pacs.008' | 'pain.001' | 'chain138.synthetic' | 'KTT' | 'TELEX_KTT';
   msgTypeCode: IsoMessageTypeCode;
   instructionId: string;
   instructionIdBytes32: string;
@@ -32,6 +33,8 @@ export type CanonicalPaymentMessage = {
   amountSmallestUnit: string;
   tokenAddress?: string;
   payloadHash: string;
+  /** keccak256(testKeyProof || normalizedBody) when KTT test-key verified off-chain */
+  authAttestationHash?: string;
   debtorRefHash: string;
   creditorRefHash: string;
   purposeHash: string;