@monolythium/core-sdk 0.4.0 → 0.4.1

package/dist/index.cjs

@@ -4,6 +4,8 @@ var blake3_js = require('@noble/hashes/blake3.js');
 var sha3_js = require('@noble/hashes/sha3.js');
 var mlDsa_js = require('@noble/post-quantum/ml-dsa.js');
 var bls12381_js = require('@noble/curves/bls12-381.js');
+var bip39 = require('@scure/bip39');
+var english_js = require('@scure/bip39/wordlists/english.js');
 require('@noble/post-quantum/ml-kem.js');
 require('@noble/ciphers/chacha.js');
 require('@noble/hashes/utils.js');
@@ -437,10 +439,24 @@ var NODE_REGISTRY_SELECTORS = {
   /** `getOperatorNetworkMetadata(bytes32)` view (PF-6). */
   getOperatorNetworkMetadata: "0x" + selectorHex("getOperatorNetworkMetadata(bytes32)"),
   /** `getClusterDiversity(uint32)` view (PF-6). */
-  getClusterDiversity: "0x" + selectorHex("getClusterDiversity(uint32)")
+  getClusterDiversity: "0x" + selectorHex("getClusterDiversity(uint32)"),
+  /** `requestClusterJoin(uint32,bytes)` — CJ-1 joining operator posts an admit request. */
+  requestClusterJoin: "0x" + selectorHex("requestClusterJoin(uint32,bytes)"),
+  /** `voteClusterAdmit(uint32,bytes32,bytes)` — CJ-1 current member admit vote. */
+  voteClusterAdmit: "0x" + selectorHex("voteClusterAdmit(uint32,bytes32,bytes)"),
+  /** `cancelClusterJoin(uint32,bytes32)` — CJ-1 requester cancellation/refund. */
+  cancelClusterJoin: "0x" + selectorHex("cancelClusterJoin(uint32,bytes32)"),
+  /** `expireClusterJoin(uint32,bytes32)` — CJ-1 public reaper/refund. */
+  expireClusterJoin: "0x" + selectorHex("expireClusterJoin(uint32,bytes32)"),
+  /** `getClusterJoinRequest(uint32,bytes32)` — CJ-1 request status view. */
+  getClusterJoinRequest: "0x" + selectorHex("getClusterJoinRequest(uint32,bytes32)")
 };
-var NODE_REGISTRY_BLS_PUBKEY_BYTES = 48;
-var NODE_REGISTRY_DKG_THRESHOLD_SIG_BYTES = 96;
+var NODE_REGISTRY_LEGACY_CLUSTER_MEMBER_PUBKEY_BYTES = 48;
+var NODE_REGISTRY_BLS_PUBKEY_BYTES = NODE_REGISTRY_LEGACY_CLUSTER_MEMBER_PUBKEY_BYTES;
+var NODE_REGISTRY_CONSENSUS_PUBKEY_BYTES = 1952;
+var NODE_REGISTRY_CONSENSUS_POP_BYTES = 3309;
+var NODE_REGISTRY_DKG_ATTESTATION_SIG_BYTES = 96;
+var NODE_REGISTRY_DKG_THRESHOLD_SIG_BYTES = NODE_REGISTRY_DKG_ATTESTATION_SIG_BYTES;
 var NODE_REGISTRY_DKG_RESHARE_MIN_SIGNERS = 5;
 var NODE_REGISTRY_DKG_RESHARE_MAX_SIGNERS = 7;
 var NODE_REGISTRY_PENDING_CHANGE_MAX_INTENT_ID = (1n << 56n) - 1n;
@@ -510,7 +526,7 @@ function encodeSubmitPendingChangeCalldata(args) {
   const { kind, kindCode } = normalizePendingChangeKind(args.kind);
   const targetPubkey = expectLength2(
     toBytes(args.targetPubkey),
-    NODE_REGISTRY_BLS_PUBKEY_BYTES,
+    NODE_REGISTRY_CONSENSUS_PUBKEY_BYTES,
     "targetPubkey"
   );
   const effectiveEpoch = toUint64(args.effectiveEpoch, "effectiveEpoch");
@@ -524,8 +540,7 @@ function encodeSubmitPendingChangeCalldata(args) {
   if (kind !== "rotate" && intentId !== 0n) {
     throw new NodeRegistryError("only rotate pending changes may carry a non-zero intentId");
   }
-  const targetTail = new Uint8Array(32);
-  targetTail.set(targetPubkey.slice(32, 48), 0);
+  const targetPubkeyPadded = padToWord(targetPubkey);
   return bytesToHex(
     concatBytes(
       hexToBytes(NODE_REGISTRY_SELECTORS.submitPendingChange),
@@ -533,55 +548,59 @@ function encodeSubmitPendingChangeCalldata(args) {
       uint64Word(4n * 32n, "targetPubkeyOffset"),
       uint64Word(effectiveEpoch, "effectiveEpoch"),
       uint64Word(intentId, "intentId"),
-      uint64Word(BigInt(NODE_REGISTRY_BLS_PUBKEY_BYTES), "targetPubkeyLength"),
-      targetPubkey.slice(0, 32),
-      targetTail
+      uint64Word(BigInt(targetPubkey.length), "targetPubkeyLength"),
+      targetPubkeyPadded
     )
   );
 }
 function encodeCancelPendingChangeCalldata(args) {
   const targetPubkey = expectLength2(
     toBytes(args.targetPubkey),
-    NODE_REGISTRY_BLS_PUBKEY_BYTES,
+    NODE_REGISTRY_CONSENSUS_PUBKEY_BYTES,
     "targetPubkey"
   );
-  const targetTail = new Uint8Array(32);
-  targetTail.set(targetPubkey.slice(32, 48), 0);
+  const targetPubkeyPadded = padToWord(targetPubkey);
   return bytesToHex(
     concatBytes(
       hexToBytes(NODE_REGISTRY_SELECTORS.cancelPendingChange),
       uint64Word(args.epoch, "epoch"),
       uint64Word(2n * 32n, "targetPubkeyOffset"),
-      uint64Word(BigInt(NODE_REGISTRY_BLS_PUBKEY_BYTES), "targetPubkeyLength"),
-      targetPubkey.slice(0, 32),
-      targetTail
+      uint64Word(BigInt(targetPubkey.length), "targetPubkeyLength"),
+      targetPubkeyPadded
     )
   );
 }
-function parseDkgResharePublicKeys(blsPublicKeys) {
-  const keys = toBytes(blsPublicKeys);
-  if (keys.length % NODE_REGISTRY_BLS_PUBKEY_BYTES !== 0) {
-    throw new NodeRegistryError("blsPublicKeys length must be a multiple of 48 bytes");
+function parseDkgResharePublicKeys(consensusPublicKeys) {
+  const keys = toBytes(consensusPublicKeys);
+  if (keys.length % NODE_REGISTRY_CONSENSUS_PUBKEY_BYTES !== 0) {
+    throw new NodeRegistryError(
+      `consensusPublicKeys length must be a multiple of ${NODE_REGISTRY_CONSENSUS_PUBKEY_BYTES} bytes`
+    );
   }
-  const signerCount = keys.length / NODE_REGISTRY_BLS_PUBKEY_BYTES;
+  const signerCount = keys.length / NODE_REGISTRY_CONSENSUS_PUBKEY_BYTES;
   if (signerCount < NODE_REGISTRY_DKG_RESHARE_MIN_SIGNERS || signerCount > NODE_REGISTRY_DKG_RESHARE_MAX_SIGNERS) {
     throw new NodeRegistryError(
-      `blsPublicKeys must contain ${NODE_REGISTRY_DKG_RESHARE_MIN_SIGNERS}..${NODE_REGISTRY_DKG_RESHARE_MAX_SIGNERS} signers`
+      `consensusPublicKeys must contain ${NODE_REGISTRY_DKG_RESHARE_MIN_SIGNERS}..${NODE_REGISTRY_DKG_RESHARE_MAX_SIGNERS} signers`
     );
   }
   const out = [];
   const seen = /* @__PURE__ */ new Set();
-  for (let offset = 0; offset < keys.length; offset += NODE_REGISTRY_BLS_PUBKEY_BYTES) {
-    const key = keys.slice(offset, offset + NODE_REGISTRY_BLS_PUBKEY_BYTES);
+  for (let offset = 0; offset < keys.length; offset += NODE_REGISTRY_CONSENSUS_PUBKEY_BYTES) {
+    const key = keys.slice(offset, offset + NODE_REGISTRY_CONSENSUS_PUBKEY_BYTES);
     const keyHex = bytesToHex(key);
     if (seen.has(keyHex)) {
-      throw new NodeRegistryError("blsPublicKeys contains a duplicate signer pubkey");
+      throw new NodeRegistryError("consensusPublicKeys contains a duplicate signer pubkey");
     }
     seen.add(keyHex);
     out.push(key);
   }
   return out;
 }
+function dkgReshareConsensusPublicKeys(args) {
+  if (args.consensusPublicKeys !== void 0) return args.consensusPublicKeys;
+  if (args.blsPublicKeys !== void 0) return args.blsPublicKeys;
+  throw new NodeRegistryError("consensusPublicKeys is required");
+}
 function encodeAttestDkgReshareCalldata(args) {
   const intentId = toUint64(args.intentId, "intentId");
   if (intentId === 0n) {
@@ -590,10 +609,10 @@ function encodeAttestDkgReshareCalldata(args) {
   if (intentId > NODE_REGISTRY_PENDING_CHANGE_MAX_INTENT_ID) {
     throw new NodeRegistryError("intentId must be <= 2^56-1");
   }
-  const publicKeys = concatBytes(...parseDkgResharePublicKeys(args.blsPublicKeys));
+  const publicKeys = concatBytes(...parseDkgResharePublicKeys(dkgReshareConsensusPublicKeys(args)));
   const thresholdSig = expectLength2(
     toBytes(args.thresholdSig),
-    NODE_REGISTRY_DKG_THRESHOLD_SIG_BYTES,
+    NODE_REGISTRY_DKG_ATTESTATION_SIG_BYTES,
     "thresholdSig"
   );
   const keysPadded = padToWord(publicKeys);
@@ -604,15 +623,94 @@ function encodeAttestDkgReshareCalldata(args) {
     concatBytes(
       hexToBytes(NODE_REGISTRY_SELECTORS.attestDkgReshare),
       uint64Word(intentId, "intentId"),
-      uint64Word(offsetKeys, "blsPublicKeysOffset"),
+      uint64Word(offsetKeys, "consensusPublicKeysOffset"),
       uint64Word(offsetSig, "thresholdSigOffset"),
-      uint64Word(BigInt(publicKeys.length), "blsPublicKeysLength"),
+      uint64Word(BigInt(publicKeys.length), "consensusPublicKeysLength"),
       keysPadded,
       uint64Word(BigInt(thresholdSig.length), "thresholdSigLength"),
       sigPadded
     )
   );
 }
+function encodeRequestClusterJoinCalldata(args) {
+  const operatorPubkey = expectLength2(
+    toBytes(args.operatorPubkey),
+    NODE_REGISTRY_CONSENSUS_PUBKEY_BYTES,
+    "operatorPubkey"
+  );
+  const operatorPubkeyPadded = padToWord(operatorPubkey);
+  return bytesToHex(
+    concatBytes(
+      hexToBytes(NODE_REGISTRY_SELECTORS.requestClusterJoin),
+      uint32Word(toUint32(args.clusterId, "clusterId")),
+      uint64Word(2n * 32n, "operatorPubkeyOffset"),
+      uint64Word(BigInt(operatorPubkey.length), "operatorPubkeyLength"),
+      operatorPubkeyPadded
+    )
+  );
+}
+function encodeVoteClusterAdmitCalldata(args) {
+  const operatorId = expectLength2(toBytes(args.operatorId), 32, "operatorId");
+  const voterPubkey = expectLength2(
+    toBytes(args.voterPubkey),
+    NODE_REGISTRY_CONSENSUS_PUBKEY_BYTES,
+    "voterPubkey"
+  );
+  const voterPubkeyPadded = padToWord(voterPubkey);
+  return bytesToHex(
+    concatBytes(
+      hexToBytes(NODE_REGISTRY_SELECTORS.voteClusterAdmit),
+      uint32Word(toUint32(args.clusterId, "clusterId")),
+      operatorId,
+      uint64Word(3n * 32n, "voterPubkeyOffset"),
+      uint64Word(BigInt(voterPubkey.length), "voterPubkeyLength"),
+      voterPubkeyPadded
+    )
+  );
+}
+function encodeCancelClusterJoinCalldata(args) {
+  return bytesToHex(
+    concatBytes(
+      hexToBytes(NODE_REGISTRY_SELECTORS.cancelClusterJoin),
+      uint32Word(toUint32(args.clusterId, "clusterId")),
+      expectLength2(toBytes(args.operatorId), 32, "operatorId")
+    )
+  );
+}
+function encodeExpireClusterJoinCalldata(args) {
+  return bytesToHex(
+    concatBytes(
+      hexToBytes(NODE_REGISTRY_SELECTORS.expireClusterJoin),
+      uint32Word(toUint32(args.clusterId, "clusterId")),
+      expectLength2(toBytes(args.operatorId), 32, "operatorId")
+    )
+  );
+}
+function encodeGetClusterJoinRequestCalldata(args) {
+  return bytesToHex(
+    concatBytes(
+      hexToBytes(NODE_REGISTRY_SELECTORS.getClusterJoinRequest),
+      uint32Word(toUint32(args.clusterId, "clusterId")),
+      expectLength2(toBytes(args.operatorId), 32, "operatorId")
+    )
+  );
+}
+function decodeClusterJoinRequest(returnData) {
+  const bytes = expectLength2(toBytes(returnData), 8 * 32, "clusterJoinRequest");
+  const word = (i) => bytes.slice(i * 32, (i + 1) * 32);
+  const statusCode = numberFromWord(word(5), "status", 255);
+  return {
+    owner: bytesToHex(word(0).slice(12, 32)),
+    requestEpoch: u64FromWord(word(1)),
+    snapshotThreshold: numberFromWord(word(2), "snapshotThreshold", 65535),
+    snapshotN: numberFromWord(word(3), "snapshotN", 65535),
+    voteCount: numberFromWord(word(4), "voteCount", 65535),
+    statusCode,
+    status: clusterJoinRequestStatusLabel(statusCode),
+    bondLythoshi: uintFromWord(word(6)),
+    sealRosterPending: numberFromWord(word(7), "sealRosterPending", 1) === 1
+  };
+}
 function encodeReportServiceProbeCalldata(args) {
   if (!isValidPublicServiceProbeMask(args.serviceMask)) {
     throw new NodeRegistryError(
@@ -699,7 +797,9 @@ function deriveClusterAnchorAddress(roster, threshold) {
   if (!Number.isInteger(threshold) || threshold < 0 || threshold > 65535) {
     throw new NodeRegistryError("threshold must be a uint16");
   }
-  const members = roster.map((m, i) => expectLength2(toBytes(m), 48, `roster[${i}]`));
+  const members = roster.map(
+    (m, i) => expectLength2(toBytes(m), NODE_REGISTRY_LEGACY_CLUSTER_MEMBER_PUBKEY_BYTES, `roster[${i}]`)
+  );
   members.sort(compareBytes);
   const parts = [
     new TextEncoder().encode(MULTISIG_ADDRESS_DERIVATION_DOMAIN),
@@ -724,6 +824,36 @@ function u64FromWord(word) {
   }
   return v;
 }
+function uintFromWord(word) {
+  let v = 0n;
+  for (const byte of word) {
+    v = v << 8n | BigInt(byte);
+  }
+  return v;
+}
+function numberFromWord(word, name, max) {
+  const value = uintFromWord(word);
+  if (value > BigInt(max)) {
+    throw new NodeRegistryError(`${name} must be <= ${max}`);
+  }
+  return Number(value);
+}
+function clusterJoinRequestStatusLabel(status) {
+  switch (status) {
+    case 0:
+      return "none";
+    case 1:
+      return "open";
+    case 2:
+      return "admitted";
+    case 3:
+      return "cancelled";
+    case 4:
+      return "expired";
+    default:
+      return "unknown";
+  }
+}
 function u64BeBytes(value) {
   const out = new Uint8Array(8);
   let n = value;
@@ -755,6 +885,27 @@ function expectUint32(value, name) {
   }
   return value;
 }
+function toUint32(value, name) {
+  let parsed;
+  if (typeof value === "bigint") {
+    parsed = value;
+  } else if (typeof value === "number") {
+    if (!Number.isSafeInteger(value)) {
+      throw new NodeRegistryError(`${name} must be a safe integer`);
+    }
+    parsed = BigInt(value);
+  } else {
+    const trimmed = value.trim();
+    if (!/^\d+$/u.test(trimmed)) {
+      throw new NodeRegistryError(`${name} must be a decimal uint32`);
+    }
+    parsed = BigInt(trimmed);
+  }
+  if (parsed < 0n || parsed > 0xffffffffn) {
+    throw new NodeRegistryError(`${name} must fit uint32`);
+  }
+  return Number(parsed);
+}
 function uint32Word(value) {
   const out = new Uint8Array(32);
   const n = expectUint32(value, "uint32");
@@ -897,6 +1048,16 @@ function bigintToBeBytes(value, bytes, label) {
   }
   return out;
 }
+function parseBigint(value, label) {
+  if (value === void 0) throw new Error(`${label} missing`);
+  if (typeof value === "bigint") return value;
+  if (typeof value === "number") {
+    if (!Number.isSafeInteger(value) || value < 0) throw new Error(`${label} must be a non-negative safe integer`);
+    return BigInt(value);
+  }
+  if (value.startsWith("0x") || value.startsWith("0X")) return BigInt(value);
+  return BigInt(value);
+}
 
 // src/crypto/submission.ts
 async function fetchEncryptionKey(client) {
@@ -918,6 +1079,38 @@ async function buildEncryptedSubmission(_args) {
 async function submitEncryptedEnvelope(client, envelopeWireHex) {
   return client.call("lyth_submitEncrypted", [envelopeWireHex]);
 }
+function buildPlaintextSubmission(args) {
+  const signed = args.backend.signEvmTx(args.tx);
+  return {
+    signedTxWireHex: `0x${signed.wireHex}`,
+    innerTxHashHex: bytesToHex2(signed.txHash),
+    innerSighashHex: bytesToHex2(signed.sighash),
+    innerWireBytes: signed.wireBytes.length
+  };
+}
+async function submitPlaintextTransaction(client, signedTxWireHex, expectedTxHashHex) {
+  const returned = await client.call("mesh_submitTx", [signedTxWireHex]);
+  const returnedBytes = hexToBytes2(returned, "mesh_submitTx tx hash");
+  if (returnedBytes.length !== 32) {
+    throw new Error(
+      `mesh_submitTx tx hash must be 32 bytes, got ${returnedBytes.length}`
+    );
+  }
+  const expectedBytes = hexToBytes2(expectedTxHashHex, "expected tx hash");
+  if (!bytesEqual(returnedBytes, expectedBytes)) {
+    throw new Error(
+      `mesh_submitTx returned tx hash ${bytesToHex2(returnedBytes)} but the locally computed canonical hash is ${bytesToHex2(expectedBytes)}`
+    );
+  }
+  return bytesToHex2(returnedBytes);
+}
+function bytesEqual(a, b) {
+  if (a.length !== b.length) return false;
+  for (let i = 0; i < a.length; i++) {
+    if (a[i] !== b[i]) return false;
+  }
+  return true;
+}
 
 // src/crypto/bincode.ts
 var BincodeWriter = class {
@@ -1835,11 +2028,181 @@ function concatBytes3(...parts) {
 function isIdentifier(value) {
   return /^[a-z][a-z0-9_]*$/.test(value);
 }
+
+// src/crypto/tx.ts
+function encodeTransactionForHash(fields, tag) {
+  const n = normalizeTxFields(fields);
+  return concatBytes2(
+    Uint8Array.of(tag),
+    bigintToBeBytes(n.chainId, 8, "chainId"),
+    bigintToBeBytes(n.nonce, 8, "nonce"),
+    bigintToBeBytes(n.maxPriorityFeePerGas, 32, "maxPriorityFeePerGas"),
+    bigintToBeBytes(n.maxFeePerGas, 32, "maxFeePerGas"),
+    bigintToBeBytes(n.gasLimit, 8, "gasLimit"),
+    n.to === null ? Uint8Array.of(0) : concatBytes2(Uint8Array.of(1), n.to),
+    bigintToBeBytes(n.value, 32, "value"),
+    bigintToBeBytes(BigInt(n.input.length), 4, "input.length"),
+    n.input,
+    new Uint8Array(4),
+    // access_list length
+    encodeExtensionsForHash(n.extensions)
+  );
+}
+function bincodeSignedTransaction(fields, signature, publicKey) {
+  const n = normalizeTxFields(fields);
+  const sig = expectBytes(signature, ML_DSA_65_SIGNATURE_LEN, "ML-DSA-65 signature");
+  const pk = expectBytes(publicKey, ML_DSA_65_PUBLIC_KEY_LEN, "ML-DSA-65 public key");
+  const w = new BincodeWriter();
+  w.u64(n.chainId);
+  w.u64(n.nonce);
+  w.bytes(uint256Be(n.maxPriorityFeePerGas, "maxPriorityFeePerGas"));
+  w.bytes(uint256Be(n.maxFeePerGas, "maxFeePerGas"));
+  w.u64(n.gasLimit);
+  if (n.to === null) {
+    w.u8(0);
+  } else {
+    w.u8(1);
+    w.bytes(n.to);
+  }
+  w.bytes(uint256Be(n.value, "value"));
+  w.bytes(n.input);
+  w.u64(0n);
+  w.u64(BigInt(n.extensions.length));
+  for (const ext of n.extensions) bincodeTypedExtensionInto(w, ext);
+  bincodeMlDsa65OpaqueInto(w, sig);
+  bincodeMlDsa65OpaqueInto(w, pk);
+  return w.toBytes();
+}
+function normalizeTxFields(fields) {
+  return {
+    chainId: parseBigint(fields.chainId, "chainId"),
+    nonce: parseBigint(fields.nonce, "nonce"),
+    maxPriorityFeePerGas: parseBigint(fields.maxPriorityFeePerGas, "maxPriorityFeePerGas"),
+    maxFeePerGas: parseBigint(fields.maxFeePerGas, "maxFeePerGas"),
+    gasLimit: parseBigint(fields.gasLimit, "gasLimit"),
+    to: normalizeTo(fields.to),
+    value: parseBigint(fields.value, "value"),
+    input: normalizeBytes(fields.input ?? new Uint8Array(0), "input"),
+    extensions: normalizeExtensions(fields.extensions)
+  };
+}
+function normalizeTo(value) {
+  if (value === null) return null;
+  const bytes = normalizeBytes(value, "to");
+  return expectBytes(bytes, 20, "to");
+}
+function normalizeBytes(value, label) {
+  if (typeof value === "string") return hexToBytes2(value, label);
+  return value instanceof Uint8Array ? value : Uint8Array.from(value);
+}
+function normalizeExtensions(value) {
+  if (value === void 0) return [];
+  return value.map((ext, index) => {
+    if (!Number.isInteger(ext.kind) || ext.kind < 0 || ext.kind > 255) {
+      throw new Error(`extensions[${index}].kind out of u8 range`);
+    }
+    const body = normalizeBytes("bodyHex" in ext ? ext.bodyHex : ext.body, `extensions[${index}].body`);
+    if (body.length > 4294967295) {
+      throw new Error(`extensions[${index}].body exceeds u32 length`);
+    }
+    return { kind: ext.kind, body };
+  });
+}
+function encodeExtensionsForHash(extensions) {
+  const chunks = [bigintToBeBytes(BigInt(extensions.length), 4, "extensions.length")];
+  for (const ext of extensions) {
+    chunks.push(
+      Uint8Array.of(ext.kind),
+      bigintToBeBytes(BigInt(ext.body.length), 4, "extension.body.length"),
+      ext.body
+    );
+  }
+  return concatBytes2(...chunks);
+}
+function uint256Be(value, label) {
+  if (value < 0n || value >= 1n << 256n) throw new Error(`${label} out of u256 range`);
+  const out = new Uint8Array(32);
+  let v = value;
+  for (let i = 31; i >= 0; i--) {
+    out[i] = Number(v & 0xffn);
+    v >>= 8n;
+  }
+  return out;
+}
+function bincodeMlDsa65OpaqueInto(w, raw) {
+  w.enumVariant(ENUM_VARIANT_INDEX_ML_DSA_65);
+  w.u16(STANDARD_ALGO_NUMBER_ML_DSA_65);
+  w.bytes(raw);
+}
+function bincodeTypedExtensionInto(w, ext) {
+  w.u8(ext.kind);
+  w.bytes(ext.body);
+}
+
+// src/crypto/ml-dsa.ts
+var ML_DSA_65_SEED_LEN = 32;
+var ML_DSA_65_SIGNING_KEY_LEN = 4032;
 var ML_DSA_65_PUBLIC_KEY_LEN = 1952;
 var ML_DSA_65_SIGNATURE_LEN = 3309;
 var STANDARD_ALGO_NUMBER_ML_DSA_65 = 1001;
+var ENUM_VARIANT_INDEX_ML_DSA_65 = 5;
 var ADDRESS_DERIVATION_DOMAIN = "MONO_ADDRESS_BLAKE3_20_V1";
 var ADDRESS_DERIVATION_DOMAIN_BYTES = new TextEncoder().encode(ADDRESS_DERIVATION_DOMAIN);
+var MlDsa65Backend = class _MlDsa65Backend {
+  #secretKey;
+  #publicKey;
+  #addressBytes;
+  constructor(secretKey, publicKey) {
+    this.#secretKey = expectBytes(secretKey, ML_DSA_65_SIGNING_KEY_LEN, "ML-DSA-65 secret key").slice();
+    this.#publicKey = expectBytes(publicKey, ML_DSA_65_PUBLIC_KEY_LEN, "ML-DSA-65 public key").slice();
+    this.#addressBytes = mlDsa65AddressBytes(this.#publicKey);
+  }
+  static fromSeed(seed) {
+    const kp = mlDsa_js.ml_dsa65.keygen(expectBytes(seed, ML_DSA_65_SEED_LEN, "ML-DSA-65 seed"));
+    return new _MlDsa65Backend(kp.secretKey, kp.publicKey);
+  }
+  publicKey() {
+    return this.#publicKey.slice();
+  }
+  addressBytes() {
+    return this.#addressBytes.slice();
+  }
+  getAddress() {
+    return bytesToHex2(this.#addressBytes);
+  }
+  sign(message) {
+    return mlDsa_js.ml_dsa65.sign(message, this.#secretKey, { extraEntropy: false });
+  }
+  signPrehash(digest) {
+    return this.sign(expectBytes(digest, 32, "prehash"));
+  }
+  verify(message, signature) {
+    return mlDsa_js.ml_dsa65.verify(
+      expectBytes(signature, ML_DSA_65_SIGNATURE_LEN, "ML-DSA-65 signature"),
+      message,
+      this.#publicKey
+    );
+  }
+  signEvmTx(fields) {
+    const txHashPreimage = encodeTransactionForHash(fields, 1);
+    const sighash = sha3_js.keccak_256(txHashPreimage);
+    const signature = this.sign(sighash);
+    const wireBytes = bincodeSignedTransaction(fields, signature, this.#publicKey);
+    const txHash = sha3_js.keccak_256(
+      concatBytes2(
+        encodeTransactionForHash(fields, 2),
+        signature,
+        this.#publicKey
+      )
+    );
+    return {
+      wireHex: bytesToHex2(wireBytes).slice(2),
+      wireBytes,
+      sighash,
+      txHash
+    };
+  }
+};
 function mlDsa65AddressFromPublicKey(publicKey) {
   return bytesToHex2(mlDsa65AddressBytes(publicKey));
 }
@@ -3447,11 +3810,15 @@ var RpcClient = class _RpcClient {
     const params = status === void 0 ? operator == null ? [] : [operator] : [operator ?? null, status];
     return this.call("lyth_getClusterResignations", params);
   }
-  /** `lyth_getBlsRoundCertificate` — round-advancement BLS aggregate. */
+  /** `lyth_getRoundCertificate` — round-advancement certificate. */
+  async lythGetRoundCertificate(round) {
+    return this.call("lyth_getRoundCertificate", [encodeRpcInteger(round)]);
+  }
+  /** @deprecated Use lythGetRoundCertificate. */
   async lythGetBlsRoundCertificate(round) {
-    return this.call("lyth_getBlsRoundCertificate", [encodeRpcInteger(round)]);
+    return this.lythGetRoundCertificate(round);
   }
-  /** `lyth_getLeaderCertificate` — leader-vote BLS aggregate for a block ref. */
+  /** `lyth_getLeaderCertificate` — leader-vote certificate for a block ref. */
   async lythGetLeaderCertificate(round, authority, digest) {
     return this.call("lyth_getLeaderCertificate", [encodeRpcInteger(round), authority, digest]);
   }
@@ -4049,7 +4416,9 @@ function normalizeOperatorInfo(value) {
       (v, i) => parseRpcNumber(v, `operator info activeClusterIds[${i}]`)
     ),
     operatorKeyFingerprint: parseStringNullable(row["operatorKeyFingerprint"]),
-    blsKeyFingerprint: parseStringNullable(row["blsKeyFingerprint"]),
+    consensusKeyFingerprint: parseStringNullable(
+      row["consensusKeyFingerprint"] ?? row["blsKeyFingerprint"]
+    ),
     lifecycleState: String(row["lifecycleState"]),
     capability: capability && typeof capability === "object" && !Array.isArray(capability) ? capability : {}
   };
@@ -4058,7 +4427,7 @@ function normalizeClusterMember(value, label) {
   const row = expectObject(value, label);
   return {
     operatorId: String(row["operatorId"]),
-    blsPubkey: String(row["blsPubkey"]),
+    consensusPubkey: String(row["consensusPubkey"] ?? row["blsPubkey"]),
     state: String(row["state"])
   };
 }
@@ -4124,7 +4493,7 @@ function normalizeOperatorAuthority(value) {
     schemaVersion: parseRpcNumber(row["schemaVersion"], "operator authority schemaVersion"),
     operatorId: String(row["operatorId"]),
     authorityIndex: parseRpcNumber(row["authorityIndex"], "operator authority authorityIndex"),
-    blsPubkey: String(row["blsPubkey"]),
+    consensusPubkey: String(row["consensusPubkey"] ?? row["blsPubkey"]),
     active: Boolean(row["active"])
   };
 }
@@ -5870,7 +6239,7 @@ var NO_EVM_COMPACT_INCLUSION_TREE_ALGORITHM = "binary-keccak-receipt-tree";
 var NO_EVM_ARCHIVE_PROOF_SCHEMA = "mono.no_evm_receipt_archive_binding.v1";
 var NO_EVM_ARCHIVE_SIGNATURE_SCHEME = "mono.snapshot.sig.v1";
 var NO_EVM_FINALITY_EVIDENCE_SCHEMA = "mono.no_evm_receipt_finality.v1";
-var NO_EVM_FINALITY_EVIDENCE_SOURCE = "blsRoundCertificate";
+var NO_EVM_FINALITY_EVIDENCE_SOURCE = "roundCertificate";
 var EMPTY_ROOT_DOMAIN_BYTES = new TextEncoder().encode(NO_EVM_RECEIPTS_ROOT_DOMAIN);
 var LEAF_DOMAIN_BYTES = new TextEncoder().encode(NO_EVM_RECEIPT_LEAF_DOMAIN);
 var NODE_DOMAIN_BYTES = new TextEncoder().encode(NO_EVM_RECEIPT_NODE_DOMAIN);
@@ -6412,7 +6781,7 @@ function verifyBoundedReceiptProof(proof) {
   }
   const actualRoot = computeNoEvmReceiptsRoot(receipts);
   const expectedRoot = decodeHash(proof.receiptsRoot, "receiptsRoot");
-  if (!bytesEqual(expectedRoot, decodeHash(actualRoot, "computedReceiptsRoot"))) {
+  if (!bytesEqual2(expectedRoot, decodeHash(actualRoot, "computedReceiptsRoot"))) {
     throw new NoEvmReceiptProofError(
       "receipts_root_mismatch",
       `receiptsRoot mismatch: expected ${proof.receiptsRoot}, computed ${actualRoot}`
@@ -6420,7 +6789,7 @@ function verifyBoundedReceiptProof(proof) {
   }
   const actualTargetHash = computeNoEvmTargetReceiptHash(targetReceipt);
   const expectedTargetHash = decodeHash(proof.targetReceiptHash, "targetReceiptHash");
-  if (!bytesEqual(expectedTargetHash, decodeHash(actualTargetHash, "computedTargetReceiptHash"))) {
+  if (!bytesEqual2(expectedTargetHash, decodeHash(actualTargetHash, "computedTargetReceiptHash"))) {
     throw new NoEvmReceiptProofError(
       "target_receipt_hash_mismatch",
       `targetReceiptHash mismatch: expected ${proof.targetReceiptHash}, computed ${actualTargetHash}`
@@ -6477,7 +6846,7 @@ function verifyCompactReceiptProof(proof) {
   const targetReceipt = decodeHexBytes(targetReceiptBytes, "targetReceiptBytes");
   const actualTargetHash = computeNoEvmTargetReceiptHash(targetReceipt);
   const expectedTargetHash = decodeHash(proof.targetReceiptHash, "targetReceiptHash");
-  if (!bytesEqual(expectedTargetHash, decodeHash(actualTargetHash, "computedTargetReceiptHash"))) {
+  if (!bytesEqual2(expectedTargetHash, decodeHash(actualTargetHash, "computedTargetReceiptHash"))) {
     throw new NoEvmReceiptProofError(
       "target_receipt_hash_mismatch",
       `targetReceiptHash mismatch: expected ${proof.targetReceiptHash}, computed ${actualTargetHash}`
@@ -6488,7 +6857,7 @@ function verifyCompactReceiptProof(proof) {
     compactProof.leafHash,
     "compactInclusionProof.leafHash"
   );
-  if (!bytesEqual(expectedLeafHashBytes, actualLeafHashBytes)) {
+  if (!bytesEqual2(expectedLeafHashBytes, actualLeafHashBytes)) {
     throw new NoEvmReceiptProofError(
       "compact_leaf_hash_mismatch",
       `compactInclusionProof.leafHash mismatch: expected ${compactProof.leafHash}, computed ${bytesToHex6(
@@ -6498,7 +6867,7 @@ function verifyCompactReceiptProof(proof) {
   }
   const compactRootBytes = decodeHash(compactProof.root, "compactInclusionProof.root");
   const receiptsRootBytes = decodeHash(proof.receiptsRoot, "receiptsRoot");
-  if (!bytesEqual(receiptsRootBytes, compactRootBytes)) {
+  if (!bytesEqual2(receiptsRootBytes, compactRootBytes)) {
     throw new NoEvmReceiptProofError(
       "compact_root_mismatch",
       `receiptsRoot must equal compactInclusionProof.root: receiptsRoot ${proof.receiptsRoot}, compact root ${compactProof.root}`
@@ -6521,7 +6890,7 @@ function verifyCompactReceiptProof(proof) {
     siblingHashes,
     pathSides
   );
-  if (!bytesEqual(actualRootBytes, compactRootBytes)) {
+  if (!bytesEqual2(actualRootBytes, compactRootBytes)) {
     throw new NoEvmReceiptProofError(
       "compact_path_mismatch",
       `compact inclusion path mismatch: expected ${compactProof.root}, computed ${bytesToHex6(
@@ -6675,7 +7044,7 @@ function validateCoveringSnapshotObject(snapshot, archiveContentHash, proofBlock
       "archiveProof.coveringSnapshot.checkpointTo must match blockHeight"
     );
   }
-  if (!bytesEqual(checkpointContentHash, archiveContentHash)) {
+  if (!bytesEqual2(checkpointContentHash, archiveContentHash)) {
     throw new NoEvmReceiptProofError(
       "invalid_proof_shape",
       "archiveProof.coveringSnapshot.checkpointContentHash must match archiveProof.contentHash"
@@ -6874,7 +7243,7 @@ function validateFinalityBlockReference(blockReference, round, proofBlockHash) {
   );
   if (proofBlockHash !== void 0) {
     const blockHash = decodeHash(proofBlockHash, "blockHash");
-    if (!bytesEqual(digest, blockHash)) {
+    if (!bytesEqual2(digest, blockHash)) {
       throw new NoEvmReceiptProofError(
         "invalid_proof_shape",
         "finalityEvidence.blockReference.digest must match blockHash"
@@ -7224,7 +7593,7 @@ function assertHashBytes(value, field2) {
 function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function bytesEqual(a, b) {
+function bytesEqual2(a, b) {
   if (a.length !== b.length) return false;
   let diff = 0;
   for (let index = 0; index < a.length; index++) {
@@ -7432,6 +7801,251 @@ function assertWholeNumber(field2, value) {
     throw new Error(`${field2} must be a whole number`);
   }
 }
+var PQM1_ALGO_TAG_MLDSA65 = 1;
+var PQM1_VERSION_V1 = 1;
+var PQM1_PAYLOAD_LEN = 32;
+var PQM1_V1_MNEMONIC_WORDS = 24;
+var PQM1_V1_MLDSA65_DOMAIN_TAG = "monolythium.pqm1.v1.mldsa65";
+var Pqm1Error = class extends Error {
+  constructor(kind, message) {
+    super(message);
+    this.kind = kind;
+    this.name = "Pqm1Error";
+  }
+  kind;
+};
+var DOMAIN_BYTES = new TextEncoder().encode(PQM1_V1_MLDSA65_DOMAIN_TAG);
+function normalizeMnemonic(mnemonic) {
+  return mnemonic.trim().toLowerCase().replace(/\s+/g, " ");
+}
+function ensureSupportedPayload(bytes) {
+  if (bytes.length !== PQM1_PAYLOAD_LEN) {
+    throw new Pqm1Error("badPayloadLength", `PQM-1 payload must be ${PQM1_PAYLOAD_LEN} bytes, got ${bytes.length}`);
+  }
+  if (bytes[0] !== PQM1_ALGO_TAG_MLDSA65) {
+    throw new Pqm1Error("unsupportedAlgorithm", `unsupported PQM-1 algorithm tag 0x${bytes[0].toString(16).padStart(2, "0")}`);
+  }
+  if (bytes[1] !== PQM1_VERSION_V1) {
+    throw new Pqm1Error("unsupportedVersion", `unsupported PQM-1 version 0x${bytes[1].toString(16).padStart(2, "0")}`);
+  }
+}
+function parsePqm1Payload(payload) {
+  const bytes = expectBytes(payload, PQM1_PAYLOAD_LEN, "PQM-1 payload").slice();
+  ensureSupportedPayload(bytes);
+  return {
+    algoTag: PQM1_ALGO_TAG_MLDSA65,
+    version: PQM1_VERSION_V1,
+    entropy: bytes.slice(2),
+    bytes
+  };
+}
+function pqm1MnemonicToPayload(mnemonic) {
+  const normalized = normalizeMnemonic(mnemonic);
+  const words = normalized.length === 0 ? [] : normalized.split(" ");
+  if (words.length !== PQM1_V1_MNEMONIC_WORDS) {
+    throw new Pqm1Error("badWordCount", `PQM-1 mnemonic must be ${PQM1_V1_MNEMONIC_WORDS} words, got ${words.length}`);
+  }
+  let payload;
+  try {
+    payload = bip39.mnemonicToEntropy(normalized, english_js.wordlist);
+  } catch (e) {
+    throw new Pqm1Error("bip39Decode", `invalid PQM-1 mnemonic: ${e.message}`);
+  }
+  return parsePqm1Payload(payload);
+}
+function derivePqm1MlDsa65SeedFromPayload(payload) {
+  const parsed = parsePqm1Payload(payload);
+  return sha3_js.shake256(concatBytes2(DOMAIN_BYTES, parsed.bytes), { dkLen: ML_DSA_65_SEED_LEN });
+}
+function pqm1MnemonicToMlDsa65Seed(mnemonic) {
+  return derivePqm1MlDsa65SeedFromPayload(pqm1MnemonicToPayload(mnemonic).bytes);
+}
+function pqm1MnemonicToMlDsa65Backend(mnemonic) {
+  return MlDsa65Backend.fromSeed(pqm1MnemonicToMlDsa65Seed(mnemonic));
+}
+
+// src/cluster-join.ts
+var DEFAULT_CLUSTER_JOIN_EXECUTION_UNIT_LIMIT = REGISTRY_DEFAULT_EXECUTION_UNIT_LIMIT;
+var ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+var MAX_UINT32 = (1n << 32n) - 1n;
+function deriveClusterJoinOperatorId(operatorPubkey) {
+  return bytesToHex2(blake3_js.blake3(normalizeConsensusPubkey(operatorPubkey, "operatorPubkey")));
+}
+function clusterJoinRequestExists(view) {
+  return view.status !== "none" || view.owner.toLowerCase() !== ZERO_ADDRESS || view.bondLythoshi !== 0n;
+}
+async function readClusterJoinRequest(client, args) {
+  const data = encodeGetClusterJoinRequestCalldata({
+    clusterId: args.clusterId,
+    operatorId: normalizeOperatorId(args.operatorId)
+  });
+  const output = await client.call("eth_call", [
+    {
+      to: nodeRegistryAddressHex(),
+      data
+    },
+    "latest"
+  ]);
+  return decodeClusterJoinRequest(output);
+}
+async function preflightClusterJoinRequest(client, args) {
+  try {
+    return await readClusterJoinRequest(client, args);
+  } catch (cause) {
+    throw new Error(
+      `CJ-1 getClusterJoinRequest is not exposed or failed on the connected chain: ${errorMessage(cause)}`
+    );
+  }
+}
+function resolveClusterJoinExecutionFee(quote, options = {}) {
+  const quoted = parseBigint(quote.executionUnitPriceLythoshi, "executionUnitPriceLythoshi");
+  const floor = options.minPriceLythoshi === void 0 ? MIN_EXECUTION_UNIT_PRICE_LYTHOSHI : parseBigint(options.minPriceLythoshi, "minPriceLythoshi");
+  const multiplier = options.safetyMultiplier === void 0 ? EXECUTION_UNIT_PRICE_SAFETY_MULTIPLIER : parseBigint(options.safetyMultiplier, "safetyMultiplier");
+  if (multiplier <= 0n) throw new Error("safetyMultiplier must be greater than zero");
+  const base = quoted > floor ? quoted : floor;
+  const maxFeePerGas = base * multiplier;
+  const tip = options.priorityTipLythoshi === void 0 ? maxFeePerGas : clampPriorityTip(options.priorityTipLythoshi, maxFeePerGas);
+  return {
+    maxFeePerGas,
+    maxPriorityFeePerGas: tip,
+    gasLimit: options.executionUnitLimit ?? DEFAULT_CLUSTER_JOIN_EXECUTION_UNIT_LIMIT
+  };
+}
+function buildRequestClusterJoinTxFields(args) {
+  return {
+    chainId: args.chainId,
+    nonce: args.nonce,
+    maxFeePerGas: parseBigint(args.fee.maxFeePerGas, "maxFeePerGas"),
+    maxPriorityFeePerGas: parseBigint(args.fee.maxPriorityFeePerGas, "maxPriorityFeePerGas"),
+    gasLimit: parseBigint(
+      args.fee.gasLimit ?? DEFAULT_CLUSTER_JOIN_EXECUTION_UNIT_LIMIT,
+      "gasLimit"
+    ),
+    to: nodeRegistryAddressHex(),
+    value: parseU256(args.bondLythoshi, "bondLythoshi"),
+    input: encodeRequestClusterJoinCalldata({
+      clusterId: args.clusterId,
+      operatorPubkey: normalizeConsensusPubkey(args.operatorPubkey, "operatorPubkey")
+    })
+  };
+}
+function buildVoteClusterAdmitTxFields(args) {
+  return {
+    chainId: args.chainId,
+    nonce: args.nonce,
+    maxFeePerGas: parseBigint(args.fee.maxFeePerGas, "maxFeePerGas"),
+    maxPriorityFeePerGas: parseBigint(args.fee.maxPriorityFeePerGas, "maxPriorityFeePerGas"),
+    gasLimit: parseBigint(
+      args.fee.gasLimit ?? DEFAULT_CLUSTER_JOIN_EXECUTION_UNIT_LIMIT,
+      "gasLimit"
+    ),
+    to: nodeRegistryAddressHex(),
+    value: 0n,
+    input: encodeVoteClusterAdmitCalldata({
+      clusterId: args.clusterId,
+      operatorId: normalizeOperatorId(args.operatorId),
+      voterPubkey: normalizeConsensusPubkey(args.voterPubkey, "voterPubkey")
+    })
+  };
+}
+async function submitRequestClusterJoin(args) {
+  const clusterId = parseUint32(args.clusterId, "clusterId");
+  const operatorPubkey = normalizeConsensusPubkey(args.operatorPubkey, "operatorPubkey");
+  const operatorIdHex = deriveClusterJoinOperatorId(operatorPubkey);
+  const existing = await preflightClusterJoinRequest(args.client, {
+    clusterId,
+    operatorId: operatorIdHex
+  });
+  if (existing.status === "open") {
+    throw new Error("cluster join request is already open for this operator");
+  }
+  if (existing.status === "admitted") {
+    throw new Error("operator is already admitted for this cluster request");
+  }
+  const backend = pqm1MnemonicToMlDsa65Backend(args.mnemonic);
+  const senderAddress = addressToTypedBech32("user", backend.addressBytes());
+  const [chainId, nonce, quote] = await Promise.all([
+    args.client.ethChainId(),
+    args.client.lythGetTransactionCount(senderAddress),
+    args.client.lythExecutionUnitPrice()
+  ]);
+  const tx = buildRequestClusterJoinTxFields({
+    chainId,
+    nonce,
+    fee: resolveClusterJoinExecutionFee(quote, args),
+    clusterId,
+    operatorPubkey,
+    bondLythoshi: args.bondLythoshi
+  });
+  return submitClusterJoinTx(args.client, backend, tx, clusterId, operatorIdHex);
+}
+async function submitVoteClusterAdmit(args) {
+  const clusterId = parseUint32(args.clusterId, "clusterId");
+  const operatorIdHex = normalizeOperatorId(args.operatorId);
+  const existing = await preflightClusterJoinRequest(args.client, {
+    clusterId,
+    operatorId: operatorIdHex
+  });
+  if (!clusterJoinRequestExists(existing) || existing.status !== "open") {
+    throw new Error("candidate cluster join request is not open for voting");
+  }
+  const backend = pqm1MnemonicToMlDsa65Backend(args.mnemonic);
+  const senderAddress = addressToTypedBech32("user", backend.addressBytes());
+  const [chainId, nonce, quote] = await Promise.all([
+    args.client.ethChainId(),
+    args.client.lythGetTransactionCount(senderAddress),
+    args.client.lythExecutionUnitPrice()
+  ]);
+  const tx = buildVoteClusterAdmitTxFields({
+    chainId,
+    nonce,
+    fee: resolveClusterJoinExecutionFee(quote, args),
+    clusterId,
+    operatorId: operatorIdHex,
+    voterPubkey: args.voterPubkey
+  });
+  return submitClusterJoinTx(args.client, backend, tx, clusterId, operatorIdHex);
+}
+async function submitClusterJoinTx(client, backend, tx, clusterId, operatorIdHex) {
+  const plaintext = buildPlaintextSubmission({ backend, tx });
+  const txHash = await submitPlaintextTransaction(
+    client,
+    plaintext.signedTxWireHex,
+    plaintext.innerTxHashHex
+  );
+  return {
+    txHash,
+    clusterId: clusterId.toString(10),
+    operatorIdHex,
+    innerSighashHex: plaintext.innerSighashHex,
+    signedTxWireBytes: plaintext.innerWireBytes
+  };
+}
+function normalizeConsensusPubkey(value, label) {
+  const bytes = typeof value === "string" ? hexToBytes2(value, label) : value;
+  return expectBytes(bytes, NODE_REGISTRY_CONSENSUS_PUBKEY_BYTES, label).slice();
+}
+function normalizeOperatorId(value) {
+  const bytes = typeof value === "string" ? hexToBytes2(value, "operatorId") : value;
+  return bytesToHex2(expectBytes(bytes, 32, "operatorId"));
+}
+function parseUint32(value, label) {
+  const parsed = parseBigint(value, label);
+  if (parsed < 0n || parsed > MAX_UINT32) {
+    throw new Error(`${label} out of 32-bit range`);
+  }
+  return parsed;
+}
+function parseU256(value, label) {
+  const parsed = parseBigint(value, label);
+  if (parsed < 0n || parsed >= 1n << 256n) {
+    throw new Error(`${label} out of 256-bit range`);
+  }
+  return parsed;
+}
+function errorMessage(cause) {
+  return cause instanceof Error ? cause.message : String(cause);
+}
 var ORACLE_EVENT_SIGS = {
   oracleRoundFinalized: "OracleRoundFinalized(bytes32,uint64,uint256,uint64,uint32)",
   observationSubmitted: "ObservationSubmitted(bytes32,uint64,address,uint256,uint64)",
@@ -9735,7 +10349,7 @@ var MONOLYTHIUM_NETWORKS = {
 };
 
 // src/index.ts
-var version = "0.3.16";
+var version = "0.4.1";
 
 exports.ADDRESS_HRP = ADDRESS_HRP;
 exports.ADDRESS_KIND_HRPS = ADDRESS_KIND_HRPS;
@@ -9755,6 +10369,7 @@ exports.CHAIN_REGISTRY_RAW_BASE = CHAIN_REGISTRY_RAW_BASE;
 exports.CLOB_MARKET_ID_DOMAIN_TAG = CLOB_MARKET_ID_DOMAIN_TAG;
 exports.CLOB_SELECTORS = CLOB_SELECTORS;
 exports.CLUSTER_FORMED_EVENT_SIG = CLUSTER_FORMED_EVENT_SIG;
+exports.DEFAULT_CLUSTER_JOIN_EXECUTION_UNIT_LIMIT = DEFAULT_CLUSTER_JOIN_EXECUTION_UNIT_LIMIT;
 exports.DELEGATION_REVERT_TAGS = DELEGATION_REVERT_TAGS;
 exports.DELEGATION_SELECTORS = DELEGATION_SELECTORS;
 exports.DIVERSITY_SCORE_MAX = DIVERSITY_SCORE_MAX;
@@ -9809,9 +10424,13 @@ exports.NATIVE_MARKET_ORDER_BOOK_STREAM_TOPIC = NATIVE_MARKET_ORDER_BOOK_STREAM_
 exports.NODE_REGISTRY_BLS_PUBKEY_BYTES = NODE_REGISTRY_BLS_PUBKEY_BYTES;
 exports.NODE_REGISTRY_CAPABILITIES = NODE_REGISTRY_CAPABILITIES;
 exports.NODE_REGISTRY_CAPABILITY_MASK = NODE_REGISTRY_CAPABILITY_MASK;
+exports.NODE_REGISTRY_CONSENSUS_POP_BYTES = NODE_REGISTRY_CONSENSUS_POP_BYTES;
+exports.NODE_REGISTRY_CONSENSUS_PUBKEY_BYTES = NODE_REGISTRY_CONSENSUS_PUBKEY_BYTES;
+exports.NODE_REGISTRY_DKG_ATTESTATION_SIG_BYTES = NODE_REGISTRY_DKG_ATTESTATION_SIG_BYTES;
 exports.NODE_REGISTRY_DKG_RESHARE_MAX_SIGNERS = NODE_REGISTRY_DKG_RESHARE_MAX_SIGNERS;
 exports.NODE_REGISTRY_DKG_RESHARE_MIN_SIGNERS = NODE_REGISTRY_DKG_RESHARE_MIN_SIGNERS;
 exports.NODE_REGISTRY_DKG_THRESHOLD_SIG_BYTES = NODE_REGISTRY_DKG_THRESHOLD_SIG_BYTES;
+exports.NODE_REGISTRY_LEGACY_CLUSTER_MEMBER_PUBKEY_BYTES = NODE_REGISTRY_LEGACY_CLUSTER_MEMBER_PUBKEY_BYTES;
 exports.NODE_REGISTRY_PENDING_CHANGE_MAX_INTENT_ID = NODE_REGISTRY_PENDING_CHANGE_MAX_INTENT_ID;
 exports.NODE_REGISTRY_PUBLIC_SERVICE_MASK = NODE_REGISTRY_PUBLIC_SERVICE_MASK;
 exports.NODE_REGISTRY_SELECTORS = NODE_REGISTRY_SELECTORS;
@@ -9929,6 +10548,8 @@ exports.buildPlaceLimitOrderViaPlan = buildPlaceLimitOrderViaPlan;
 exports.buildPlaceSpotLimitOrderPlan = buildPlaceSpotLimitOrderPlan;
 exports.buildPlaceSpotMarketOrderExPlan = buildPlaceSpotMarketOrderExPlan;
 exports.buildPlaceSpotMarketOrderPlan = buildPlaceSpotMarketOrderPlan;
+exports.buildRequestClusterJoinTxFields = buildRequestClusterJoinTxFields;
+exports.buildVoteClusterAdmitTxFields = buildVoteClusterAdmitTxFields;
 exports.categoryRoot = categoryRoot;
 exports.checkMrvFeeDisplayConformance = checkMrvFeeDisplayConformance;
 exports.checkMrvStructuredFeeConformance = checkMrvStructuredFeeConformance;
@@ -9936,6 +10557,7 @@ exports.checkNativeDevkitCompatibility = checkNativeDevkitCompatibility;
 exports.clampPriorityTip = clampPriorityTip;
 exports.clobAddressHex = clobAddressHex;
 exports.clusterApyPercent = clusterApyPercent;
+exports.clusterJoinRequestExists = clusterJoinRequestExists;
 exports.compareNativeDevVersions = compareNativeDevVersions;
 exports.composeClaimBoundMessage = composeClaimBoundMessage;
 exports.computeNoEvmDacFinalityMessage = computeNoEvmDacFinalityMessage;
@@ -9947,6 +10569,7 @@ exports.computeQuoteLiquidity = computeQuoteLiquidity;
 exports.consumeNativeEvents = consumeNativeEvents;
 exports.decodeClusterDiversity = decodeClusterDiversity;
 exports.decodeClusterFormedEvent = decodeClusterFormedEvent;
+exports.decodeClusterJoinRequest = decodeClusterJoinRequest;
 exports.decodeHasPubkeyReturn = decodeHasPubkeyReturn;
 exports.decodeLookupPubkeyReturn = decodeLookupPubkeyReturn;
 exports.decodeNativeAgentStateResponse = decodeNativeAgentStateResponse;
@@ -9962,6 +10585,7 @@ exports.delegationAddressHex = delegationAddressHex;
 exports.denyRootFor = denyRootFor;
 exports.deriveClobMarketId = deriveClobMarketId;
 exports.deriveClusterAnchorAddress = deriveClusterAnchorAddress;
+exports.deriveClusterJoinOperatorId = deriveClusterJoinOperatorId;
 exports.deriveFeedId = deriveFeedId;
 exports.deriveMrvContractAddress = deriveMrvContractAddress;
 exports.deriveNativeSpotMarketId = deriveNativeSpotMarketId;
@@ -9971,6 +10595,7 @@ exports.encodeAttestDkgReshareCalldata = encodeAttestDkgReshareCalldata;
 exports.encodeBlockSelector = encodeBlockSelector;
 exports.encodeBridgeChallengeCalldata = encodeBridgeChallengeCalldata;
 exports.encodeBridgeClaimCalldata = encodeBridgeClaimCalldata;
+exports.encodeCancelClusterJoinCalldata = encodeCancelClusterJoinCalldata;
 exports.encodeCancelOrderCalldata = encodeCancelOrderCalldata;
 exports.encodeCancelPendingChangeCalldata = encodeCancelPendingChangeCalldata;
 exports.encodeClaimCalldata = encodeClaimCalldata;
@@ -9981,6 +10606,8 @@ exports.encodeCreateRequestCanonical = encodeCreateRequestCanonical;
 exports.encodeDelegateCalldata = encodeDelegateCalldata;
 exports.encodeDisableCalldata = encodeDisableCalldata;
 exports.encodeEnableCalldata = encodeEnableCalldata;
+exports.encodeExpireClusterJoinCalldata = encodeExpireClusterJoinCalldata;
+exports.encodeGetClusterJoinRequestCalldata = encodeGetClusterJoinRequestCalldata;
 exports.encodeHasPubkeyCalldata = encodeHasPubkeyCalldata;
 exports.encodeLockBridgeConfigCalldata = encodeLockBridgeConfigCalldata;
 exports.encodeLookupPubkeyCalldata = encodeLookupPubkeyCalldata;
@@ -10041,6 +10668,7 @@ exports.encodeRecoverOperatorNodeCalldata = encodeRecoverOperatorNodeCalldata;
 exports.encodeRedelegateCalldata = encodeRedelegateCalldata;
 exports.encodeRegisterPubkeyCalldata = encodeRegisterPubkeyCalldata;
 exports.encodeReportServiceProbeCalldata = encodeReportServiceProbeCalldata;
+exports.encodeRequestClusterJoinCalldata = encodeRequestClusterJoinCalldata;
 exports.encodeSetAutoCompoundCalldata = encodeSetAutoCompoundCalldata;
 exports.encodeSetBridgeResumeCooldownCalldata = encodeSetBridgeResumeCooldownCalldata;
 exports.encodeSetBridgeRouteFinalityCalldata = encodeSetBridgeRouteFinalityCalldata;
@@ -10052,6 +10680,7 @@ exports.encodeSetTickSizeCalldata = encodeSetTickSizeCalldata;
 exports.encodeSubmitBridgeProofCalldata = encodeSubmitBridgeProofCalldata;
 exports.encodeSubmitPendingChangeCalldata = encodeSubmitPendingChangeCalldata;
 exports.encodeUndelegateCalldata = encodeUndelegateCalldata;
+exports.encodeVoteClusterAdmitCalldata = encodeVoteClusterAdmitCalldata;
 exports.exportBridgeRouteCatalogueJson = exportBridgeRouteCatalogueJson;
 exports.fetchChainInfoLatest = fetchChainInfoLatest;
 exports.fetchChainRegistryLatest = fetchChainRegistryLatest;
@@ -10112,13 +10741,16 @@ exports.parseNameCategory = parseNameCategory;
 exports.parseNativeDecodedEvent = parseNativeDecodedEvent;
 exports.parseQuantity = parseQuantity;
 exports.parseQuantityBig = parseQuantityBig;
+exports.preflightClusterJoinRequest = preflightClusterJoinRequest;
 exports.proverMarketStateFromByte = proverMarketStateFromByte;
 exports.pubkeyRegistryAddressHex = pubkeyRegistryAddressHex;
 exports.quoteOperatorFee = quoteOperatorFee;
 exports.rankBridgeRoutes = rankBridgeRoutes;
 exports.rankMarketsByVolume = rankMarketsByVolume;
+exports.readClusterJoinRequest = readClusterJoinRequest;
 exports.requestSighash = requestSighash;
 exports.requireTypedAddress = requireTypedAddress;
+exports.resolveClusterJoinExecutionFee = resolveClusterJoinExecutionFee;
 exports.resolveExecutionFee = resolveExecutionFee;
 exports.resolveMaxExecutionUnitPrice = resolveMaxExecutionUnitPrice;
 exports.resolveRegistryExecutionFee = resolveRegistryExecutionFee;
@@ -10130,7 +10762,9 @@ exports.spendingPolicyAddressHex = spendingPolicyAddressHex;
 exports.submitMrvCallNativeTx = submitMrvCallNativeTx;
 exports.submitMrvDeployNativeTx = submitMrvDeployNativeTx;
 exports.submitMrvDeployPayloadNativeTx = submitMrvDeployPayloadNativeTx;
+exports.submitRequestClusterJoin = submitRequestClusterJoin;
 exports.submitSighash = submitSighash;
+exports.submitVoteClusterAdmit = submitVoteClusterAdmit;
 exports.transactionFeeExposure = transactionFeeExposure;
 exports.typedBech32ToAddress = typedBech32ToAddress;
 exports.validateAddress = validateAddress;