@monolythium/core-sdk 0.4.16 → 0.4.18

package/dist/crypto/index.d.cts

@@ -1,5 +1,5 @@
-import { I as MlDsa65Backend } from '../submission-BdBhOdg7.cjs';
-export { k3 as ADDRESS_DERIVATION_DOMAIN, k4 as CLUSTER_MLKEM_SHAMIR, k5 as CLUSTER_MLKEM_SHAMIR_ALGO, k6 as ClusterSealKeyEntryInput, K as ClusterSealKeys, L as ClusterSealKeysSource, k7 as DKG_AEAD_TAG_LEN, k8 as DKG_NONCE_LEN, k9 as DecryptHint, ka as ENCRYPTED_SUBMISSION_UNAVAILABLE_MESSAGE, kb as ENUM_VARIANT_INDEX_ML_DSA_65, kc as EncryptedEnvelope, kd as EncryptedSubmission, E as EncryptionKey, ke as JsonRpcCallClient, kf as LythiumSealEnvelope, kg as ML_DSA_65_PUBLIC_KEY_LEN, kh as ML_DSA_65_SEED_LEN, ki as ML_DSA_65_SIGNATURE_LEN, kj as ML_DSA_65_SIGNING_KEY_LEN, kk as ML_KEM_768_CIPHERTEXT_LEN, kl as ML_KEM_768_ENCAPSULATION_KEY_LEN, km as ML_KEM_768_SHARED_SECRET_LEN, F as MempoolClass, D as NativeEvmTxFields, kn as NativeTxExtension, ko as NativeTxExtensionDescriptor, kp as NativeTxExtensionLike, kq as NonceAad, kr as OperatorSealKeypair, ks as PlaintextSubmission, kt as SEAL_COMMIT_LEN, ku as SEAL_DK_LEN, kv as SEAL_EK_LEN, kw as SEAL_KEM_CT_LEN, kx as SEAL_KEM_SEED_LEN, ky as SEAL_KEY_LEN, kz as SEAL_NONCE_LEN, kA as SEAL_SHARE_LEN, kB as SEAL_TAG_LEN, kC as STANDARD_ALGO_NUMBER_ML_DSA_65, kD as SealRandomSource, kE as SealRecipient, kF as SealedSubmission, kG as bincodeDecryptHint, kH as bincodeEncryptedEnvelope, kI as bincodeNonceAad, kJ as bincodeSignedTransaction, kK as buildEncryptedEnvelope, kL as buildEncryptedSubmission, kM as buildPlaintextSubmission, kN as cryptoRandomSource, kO as encodeMlDsa65Opaque, kP as encodeSealEnvelope, kQ as encodeTransactionForHash, kR as encryptInnerTx, kS as fetchEncryptionKey, kT as generateOperatorSealKeypair, kU as getClusterSealKeys, kV as mlDsa65AddressBytes, kW as mlDsa65AddressFromPublicKey, kX as outerSigDigest, kY as parseClusterSealKeys, kZ as sealRosterHash, k_ as sealToCluster, k$ as sealTransaction, l0 as submitEncryptedEnvelope, l1 as submitPlaintextTransaction, l2 as submitSealedTransaction, l3 as submitTransactionWithPrivacy } from '../submission-BdBhOdg7.cjs';
+import { I as MlDsa65Backend } from '../submission-Cr6u_2he.cjs';
+export { kb as ADDRESS_DERIVATION_DOMAIN, kc as CLUSTER_MLKEM_SHAMIR, kd as CLUSTER_MLKEM_SHAMIR_ALGO, ke as ClusterSealKeyEntryInput, K as ClusterSealKeys, L as ClusterSealKeysSource, kf as DKG_AEAD_TAG_LEN, kg as DKG_NONCE_LEN, kh as DecryptHint, ki as ENCRYPTED_SUBMISSION_UNAVAILABLE_MESSAGE, kj as ENUM_VARIANT_INDEX_ML_DSA_65, kk as EncryptedEnvelope, kl as EncryptedSubmission, E as EncryptionKey, km as JsonRpcCallClient, kn as LythiumSealEnvelope, ko as ML_DSA_65_PUBLIC_KEY_LEN, kp as ML_DSA_65_SEED_LEN, kq as ML_DSA_65_SIGNATURE_LEN, kr as ML_DSA_65_SIGNING_KEY_LEN, ks as ML_KEM_768_CIPHERTEXT_LEN, kt as ML_KEM_768_ENCAPSULATION_KEY_LEN, ku as ML_KEM_768_SHARED_SECRET_LEN, F as MempoolClass, D as NativeEvmTxFields, kv as NativeTxExtension, kw as NativeTxExtensionDescriptor, kx as NativeTxExtensionLike, ky as NonceAad, kz as OperatorSealKeypair, kA as PlaintextSubmission, kB as SEAL_COMMIT_LEN, kC as SEAL_DK_LEN, kD as SEAL_EK_LEN, kE as SEAL_KEM_CT_LEN, kF as SEAL_KEM_SEED_LEN, kG as SEAL_KEY_LEN, kH as SEAL_NONCE_LEN, kI as SEAL_SHARE_LEN, kJ as SEAL_TAG_LEN, kK as STANDARD_ALGO_NUMBER_ML_DSA_65, kL as SealRandomSource, kM as SealRecipient, kN as SealedSubmission, kO as bincodeDecryptHint, kP as bincodeEncryptedEnvelope, kQ as bincodeNonceAad, kR as bincodeSignedTransaction, kS as buildEncryptedEnvelope, kT as buildEncryptedSubmission, kU as buildPlaintextSubmission, kV as cryptoRandomSource, kW as encodeMlDsa65Opaque, kX as encodeSealEnvelope, kY as encodeTransactionForHash, kZ as encryptInnerTx, k_ as fetchEncryptionKey, k$ as generateOperatorSealKeypair, l0 as getClusterSealKeys, l1 as mlDsa65AddressBytes, l2 as mlDsa65AddressFromPublicKey, l3 as outerSigDigest, l4 as parseClusterSealKeys, l5 as sealRosterHash, l6 as sealToCluster, l7 as sealTransaction, l8 as submitEncryptedEnvelope, l9 as submitPlaintextTransaction, la as submitSealedTransaction, lb as submitTransactionWithPrivacy } from '../submission-Cr6u_2he.cjs';
 
 declare class BincodeWriter {
     #private;

package/dist/crypto/index.d.ts

@@ -1,5 +1,5 @@
-import { I as MlDsa65Backend } from '../submission-BdBhOdg7.js';
-export { k3 as ADDRESS_DERIVATION_DOMAIN, k4 as CLUSTER_MLKEM_SHAMIR, k5 as CLUSTER_MLKEM_SHAMIR_ALGO, k6 as ClusterSealKeyEntryInput, K as ClusterSealKeys, L as ClusterSealKeysSource, k7 as DKG_AEAD_TAG_LEN, k8 as DKG_NONCE_LEN, k9 as DecryptHint, ka as ENCRYPTED_SUBMISSION_UNAVAILABLE_MESSAGE, kb as ENUM_VARIANT_INDEX_ML_DSA_65, kc as EncryptedEnvelope, kd as EncryptedSubmission, E as EncryptionKey, ke as JsonRpcCallClient, kf as LythiumSealEnvelope, kg as ML_DSA_65_PUBLIC_KEY_LEN, kh as ML_DSA_65_SEED_LEN, ki as ML_DSA_65_SIGNATURE_LEN, kj as ML_DSA_65_SIGNING_KEY_LEN, kk as ML_KEM_768_CIPHERTEXT_LEN, kl as ML_KEM_768_ENCAPSULATION_KEY_LEN, km as ML_KEM_768_SHARED_SECRET_LEN, F as MempoolClass, D as NativeEvmTxFields, kn as NativeTxExtension, ko as NativeTxExtensionDescriptor, kp as NativeTxExtensionLike, kq as NonceAad, kr as OperatorSealKeypair, ks as PlaintextSubmission, kt as SEAL_COMMIT_LEN, ku as SEAL_DK_LEN, kv as SEAL_EK_LEN, kw as SEAL_KEM_CT_LEN, kx as SEAL_KEM_SEED_LEN, ky as SEAL_KEY_LEN, kz as SEAL_NONCE_LEN, kA as SEAL_SHARE_LEN, kB as SEAL_TAG_LEN, kC as STANDARD_ALGO_NUMBER_ML_DSA_65, kD as SealRandomSource, kE as SealRecipient, kF as SealedSubmission, kG as bincodeDecryptHint, kH as bincodeEncryptedEnvelope, kI as bincodeNonceAad, kJ as bincodeSignedTransaction, kK as buildEncryptedEnvelope, kL as buildEncryptedSubmission, kM as buildPlaintextSubmission, kN as cryptoRandomSource, kO as encodeMlDsa65Opaque, kP as encodeSealEnvelope, kQ as encodeTransactionForHash, kR as encryptInnerTx, kS as fetchEncryptionKey, kT as generateOperatorSealKeypair, kU as getClusterSealKeys, kV as mlDsa65AddressBytes, kW as mlDsa65AddressFromPublicKey, kX as outerSigDigest, kY as parseClusterSealKeys, kZ as sealRosterHash, k_ as sealToCluster, k$ as sealTransaction, l0 as submitEncryptedEnvelope, l1 as submitPlaintextTransaction, l2 as submitSealedTransaction, l3 as submitTransactionWithPrivacy } from '../submission-BdBhOdg7.js';
+import { I as MlDsa65Backend } from '../submission-Cr6u_2he.js';
+export { kb as ADDRESS_DERIVATION_DOMAIN, kc as CLUSTER_MLKEM_SHAMIR, kd as CLUSTER_MLKEM_SHAMIR_ALGO, ke as ClusterSealKeyEntryInput, K as ClusterSealKeys, L as ClusterSealKeysSource, kf as DKG_AEAD_TAG_LEN, kg as DKG_NONCE_LEN, kh as DecryptHint, ki as ENCRYPTED_SUBMISSION_UNAVAILABLE_MESSAGE, kj as ENUM_VARIANT_INDEX_ML_DSA_65, kk as EncryptedEnvelope, kl as EncryptedSubmission, E as EncryptionKey, km as JsonRpcCallClient, kn as LythiumSealEnvelope, ko as ML_DSA_65_PUBLIC_KEY_LEN, kp as ML_DSA_65_SEED_LEN, kq as ML_DSA_65_SIGNATURE_LEN, kr as ML_DSA_65_SIGNING_KEY_LEN, ks as ML_KEM_768_CIPHERTEXT_LEN, kt as ML_KEM_768_ENCAPSULATION_KEY_LEN, ku as ML_KEM_768_SHARED_SECRET_LEN, F as MempoolClass, D as NativeEvmTxFields, kv as NativeTxExtension, kw as NativeTxExtensionDescriptor, kx as NativeTxExtensionLike, ky as NonceAad, kz as OperatorSealKeypair, kA as PlaintextSubmission, kB as SEAL_COMMIT_LEN, kC as SEAL_DK_LEN, kD as SEAL_EK_LEN, kE as SEAL_KEM_CT_LEN, kF as SEAL_KEM_SEED_LEN, kG as SEAL_KEY_LEN, kH as SEAL_NONCE_LEN, kI as SEAL_SHARE_LEN, kJ as SEAL_TAG_LEN, kK as STANDARD_ALGO_NUMBER_ML_DSA_65, kL as SealRandomSource, kM as SealRecipient, kN as SealedSubmission, kO as bincodeDecryptHint, kP as bincodeEncryptedEnvelope, kQ as bincodeNonceAad, kR as bincodeSignedTransaction, kS as buildEncryptedEnvelope, kT as buildEncryptedSubmission, kU as buildPlaintextSubmission, kV as cryptoRandomSource, kW as encodeMlDsa65Opaque, kX as encodeSealEnvelope, kY as encodeTransactionForHash, kZ as encryptInnerTx, k_ as fetchEncryptionKey, k$ as generateOperatorSealKeypair, l0 as getClusterSealKeys, l1 as mlDsa65AddressBytes, l2 as mlDsa65AddressFromPublicKey, l3 as outerSigDigest, l4 as parseClusterSealKeys, l5 as sealRosterHash, l6 as sealToCluster, l7 as sealTransaction, l8 as submitEncryptedEnvelope, l9 as submitPlaintextTransaction, la as submitSealedTransaction, lb as submitTransactionWithPrivacy } from '../submission-Cr6u_2he.js';
 
 declare class BincodeWriter {
     #private;

package/dist/index.cjs

@@ -266,84 +266,6 @@ function expectLength(value, len, name) {
   return value instanceof Uint8Array ? value : Uint8Array.from(value);
 }
 
-// src/native-events.ts
-var NATIVE_MARKET_EVENT_FAMILY = "market";
-function nativeMarketEventFilter(filter = {}) {
-  return { ...filter, family: NATIVE_MARKET_EVENT_FAMILY };
-}
-function isNativeDecodedEvent(value) {
-  const row = asRecord(value);
-  return row !== null && typeof row["block_height"] === "number" && typeof row["tx_index"] === "number" && typeof row["sequence"] === "number" && typeof row["family"] === "string" && typeof row["event_name"] === "string" && typeof row["payload_hash"] === "string";
-}
-function parseNativeDecodedEvent(event) {
-  if (isNativeDecodedEvent(event.decoded)) {
-    return event.decoded;
-  }
-  try {
-    const parsed = JSON.parse(event.decodedJson);
-    if (isNativeDecodedEvent(parsed)) {
-      return parsed;
-    }
-  } catch {
-  }
-  throw SdkError.malformed(
-    `native event ${event.eventTopic} at logIndex ${event.logIndex} is missing a typed decoded payload`
-  );
-}
-function nativeEventMatches(event, filter = {}) {
-  if (filter.address !== void 0 && event.address !== filter.address) return false;
-  if (filter.eventTopic !== void 0 && event.eventTopic !== filter.eventTopic) return false;
-  if (filter.family === void 0 && filter.eventName === void 0) return true;
-  let decoded;
-  try {
-    decoded = parseNativeDecodedEvent(event);
-  } catch {
-    return false;
-  }
-  if (filter.family !== void 0 && decoded.family !== filter.family) return false;
-  if (filter.eventName !== void 0 && decoded.event_name !== filter.eventName) return false;
-  return true;
-}
-function nativeEventsFromReceipt(receipt, filter = {}) {
-  return receipt.events.filter((event) => nativeEventMatches(event, filter)).map((event) => ({
-    ...event,
-    decoded: parseNativeDecodedEvent(event)
-  }));
-}
-function nativeMarketEventsFromReceipt(receipt, filter = {}) {
-  return nativeEventsFromReceipt(receipt, nativeMarketEventFilter(filter));
-}
-function nativeEventsFromHistory(response) {
-  return {
-    ...response,
-    events: response.events.map((event) => ({
-      ...event,
-      decoded: parseNativeDecodedEvent(event)
-    }))
-  };
-}
-function nativeMarketEventsFromHistory(response) {
-  return {
-    ...response,
-    filters: { ...response.filters, family: NATIVE_MARKET_EVENT_FAMILY },
-    events: response.events.filter((event) => nativeEventMatches(event, { family: NATIVE_MARKET_EVENT_FAMILY })).map((event) => ({
-      ...event,
-      decoded: parseNativeDecodedEvent(event)
-    }))
-  };
-}
-async function consumeNativeEvents(receipt, consumer, filter = {}) {
-  const events = nativeEventsFromReceipt(receipt, filter);
-  for (const event of events) {
-    await consumer(event);
-  }
-  return events.length;
-}
-function asRecord(value) {
-  if (value === null || typeof value !== "object" || Array.isArray(value)) return null;
-  return value;
-}
-
 // src/consts.ts
 var BURN_ADDR = "0x0000000000000000000000000000000000000000";
 var PRECOMPILE_ADDRESSES = {
@@ -528,6 +450,9 @@ var NODE_REGISTRY_ARCHIVE_KIND_EPOCH_SEED = 3;
 var NODE_REGISTRY_TAG_ARCHIVE_CHALLENGE = 50;
 var NODE_REGISTRY_TAG_SERVICE_SCORE = 36;
 var NODE_REGISTRY_TAG_TREASURY = 31;
+var NODE_REGISTRY_TAG_CLUSTER_CHARTER = 49;
+var NODE_REGISTRY_SUBKIND_CHARTER_DELEGATOR_BPS = 0;
+var NODE_REGISTRY_SUBKIND_CHARTER_MEMBER_SHARES = 1;
 var PENDING_CHANGE_KIND_CODES = {
   add: 1,
   remove: 2,
@@ -1321,6 +1246,40 @@ function slotProbeAuthority() {
   buf[33] = 10;
   return bytesToHex(sha3_js.keccak_256(buf));
 }
+function slotClusterCharter(clusterId, subkind) {
+  if (!Number.isInteger(subkind) || subkind < 0 || subkind > 255) {
+    throw new NodeRegistryError("charter subkind must be a u8");
+  }
+  const buf = new Uint8Array(1 + 4 + 1);
+  buf[0] = NODE_REGISTRY_TAG_CLUSTER_CHARTER;
+  buf.set(u32BeBytes(toUint32(clusterId, "clusterId")), 1);
+  buf[5] = subkind;
+  return bytesToHex(sha3_js.keccak_256(buf));
+}
+function slotClusterCharterDelegator(clusterId) {
+  return slotClusterCharter(clusterId, NODE_REGISTRY_SUBKIND_CHARTER_DELEGATOR_BPS);
+}
+function slotClusterCharterMembers(clusterId) {
+  return slotClusterCharter(clusterId, NODE_REGISTRY_SUBKIND_CHARTER_MEMBER_SHARES);
+}
+function decodeActiveCharter(delegatorWord, membersWord) {
+  const presence = leftPadToWord(toBytes(delegatorWord), "charterDelegatorWord");
+  let raw = 0n;
+  for (const b of presence) {
+    raw = raw << 8n | BigInt(b);
+  }
+  if (raw === 0n) {
+    return { present: false, delegatorShareBps: 0, memberShareBps: [] };
+  }
+  const delegatorShareBps = Number(raw - 1n > 0xffffn ? 0xffffn : raw - 1n);
+  const packed = leftPadToWord(toBytes(membersWord), "charterMembersWord");
+  const memberShareBps = [];
+  for (let i = 0; i < NODE_REGISTRY_FORM_CLUSTER_MEMBER_COUNT; i += 1) {
+    const at = 12 + 2 * i;
+    memberShareBps.push(packed[at] << 8 | packed[at + 1]);
+  }
+  return { present: true, delegatorShareBps, memberShareBps };
+}
 function decodeClusterJoinRequest(returnData) {
   const bytes = expectLength2(toBytes(returnData), 8 * 32, "clusterJoinRequest");
   const word = (i) => bytes.slice(i * 32, (i + 1) * 32);
@@ -1634,6 +1593,15 @@ function padToWord(bytes) {
   out.set(bytes);
   return out;
 }
+function leftPadToWord(bytes, name) {
+  if (bytes.length === 32) return bytes;
+  if (bytes.length > 32) {
+    throw new NodeRegistryError(`${name} must be <= 32 bytes, got ${bytes.length}`);
+  }
+  const out = new Uint8Array(32);
+  out.set(bytes, 32 - bytes.length);
+  return out;
+}
 function toBytes(value) {
   if (typeof value === "string") {
     return hexToBytes(value);
@@ -1654,10 +1622,11 @@ function displayTextBytes(value, maxBytes, name) {
   return bytes;
 }
 function hexToBytes(hex) {
-  const body = hex.startsWith("0x") || hex.startsWith("0X") ? hex.slice(2) : hex;
-  if (body.length % 2 !== 0 || !/^[0-9a-fA-F]*$/.test(body)) {
+  const raw = hex.startsWith("0x") || hex.startsWith("0X") ? hex.slice(2) : hex;
+  if (!/^[0-9a-fA-F]*$/.test(raw)) {
     throw new NodeRegistryError("invalid hex bytes");
   }
+  const body = raw.length % 2 !== 0 ? `0${raw}` : raw;
   const out = new Uint8Array(body.length / 2);
   for (let i = 0; i < out.length; i++) {
     out[i] = Number.parseInt(body.slice(i * 2, i * 2 + 2), 16);
@@ -1707,6 +1676,84 @@ function decodeDynamicBytesResult(bytes, expectedLength, label) {
   return bytes.slice(64, 64 + expectedLength);
 }
 
+// src/native-events.ts
+var NATIVE_MARKET_EVENT_FAMILY = "market";
+function nativeMarketEventFilter(filter = {}) {
+  return { ...filter, family: NATIVE_MARKET_EVENT_FAMILY };
+}
+function isNativeDecodedEvent(value) {
+  const row = asRecord(value);
+  return row !== null && typeof row["block_height"] === "number" && typeof row["tx_index"] === "number" && typeof row["sequence"] === "number" && typeof row["family"] === "string" && typeof row["event_name"] === "string" && typeof row["payload_hash"] === "string";
+}
+function parseNativeDecodedEvent(event) {
+  if (isNativeDecodedEvent(event.decoded)) {
+    return event.decoded;
+  }
+  try {
+    const parsed = JSON.parse(event.decodedJson);
+    if (isNativeDecodedEvent(parsed)) {
+      return parsed;
+    }
+  } catch {
+  }
+  throw SdkError.malformed(
+    `native event ${event.eventTopic} at logIndex ${event.logIndex} is missing a typed decoded payload`
+  );
+}
+function nativeEventMatches(event, filter = {}) {
+  if (filter.address !== void 0 && event.address !== filter.address) return false;
+  if (filter.eventTopic !== void 0 && event.eventTopic !== filter.eventTopic) return false;
+  if (filter.family === void 0 && filter.eventName === void 0) return true;
+  let decoded;
+  try {
+    decoded = parseNativeDecodedEvent(event);
+  } catch {
+    return false;
+  }
+  if (filter.family !== void 0 && decoded.family !== filter.family) return false;
+  if (filter.eventName !== void 0 && decoded.event_name !== filter.eventName) return false;
+  return true;
+}
+function nativeEventsFromReceipt(receipt, filter = {}) {
+  return receipt.events.filter((event) => nativeEventMatches(event, filter)).map((event) => ({
+    ...event,
+    decoded: parseNativeDecodedEvent(event)
+  }));
+}
+function nativeMarketEventsFromReceipt(receipt, filter = {}) {
+  return nativeEventsFromReceipt(receipt, nativeMarketEventFilter(filter));
+}
+function nativeEventsFromHistory(response) {
+  return {
+    ...response,
+    events: response.events.map((event) => ({
+      ...event,
+      decoded: parseNativeDecodedEvent(event)
+    }))
+  };
+}
+function nativeMarketEventsFromHistory(response) {
+  return {
+    ...response,
+    filters: { ...response.filters, family: NATIVE_MARKET_EVENT_FAMILY },
+    events: response.events.filter((event) => nativeEventMatches(event, { family: NATIVE_MARKET_EVENT_FAMILY })).map((event) => ({
+      ...event,
+      decoded: parseNativeDecodedEvent(event)
+    }))
+  };
+}
+async function consumeNativeEvents(receipt, consumer, filter = {}) {
+  const events = nativeEventsFromReceipt(receipt, filter);
+  for (const event of events) {
+    await consumer(event);
+  }
+  return events.length;
+}
+function asRecord(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) return null;
+  return value;
+}
+
 // src/crypto/bytes.ts
 function concatBytes2(...chunks) {
   const len = chunks.reduce((n, c) => n + c.length, 0);
@@ -3361,8 +3408,8 @@ var TESTNET_69420 = {
   network: "testnet-69420",
   display_name: "Monolythium Testnet",
   description: "Public Monolythium testnet. Testnet state may reset without notice; do not store value on this network.",
-  genesis_hash: "0x0d2903aeac5aa127b3fb75cd1405c2c193896981e8897671792d3817a6fdf689",
-  binary_sha: "52f1694c5a6d",
+  genesis_hash: "0x11774775b5c3bfc36ecb9c37e7252b49898caaacdb55668de3913fe60c660258",
+  binary_sha: "b4257f14",
   rpc: [
     {
       url: "http://178.105.12.9:8545",
@@ -3421,18 +3468,18 @@ var TESTNET_69420 = {
       notes: "operator-8"
     },
     {
-      url: "http://162.55.54.198:8545",
+      url: "http://95.217.156.190:8545",
       provider: "monolythium-foundation",
-      region: "fsn1",
+      region: "hel1",
       tier: "official",
-      notes: "operator-9"
+      notes: "operator-10"
     },
     {
-      url: "http://95.217.156.190:8545",
+      url: "http://162.55.54.198:8545",
       provider: "monolythium-foundation",
-      region: "hel1",
+      region: "fsn1",
       tier: "official",
-      notes: "operator-10"
+      notes: "operator-9"
     },
     {
       url: "http://178.105.45.210:8545",
@@ -4268,17 +4315,35 @@ var RpcClient = class _RpcClient {
   async ethBlockNumber() {
     return parseQuantityBig(await this.call(ethCompatMethod("blockNumber"), []));
   }
-  /** `eth_getBalance` — balance + Merkle proof envelope. */
+  /**
+   * `eth_getBalance` — balance + Merkle proof envelope.
+   *
+   * The node may answer with a bare `0x…` hex word or a proof-wrapped
+   * object; both are normalized to a consistent {@link AccountProofResponse}
+   * via {@link normalizeAccountProof} so `.value` is always the bare word.
+   */
   async ethGetBalance(address, block = "latest") {
-    return this.call("eth_getBalance", [address, encodeBlockSelector(block)]);
+    return normalizeAccountProof(
+      await this.call("eth_getBalance", [address, encodeBlockSelector(block)])
+    );
   }
-  /** `eth_getStorageAt` — storage word + Merkle proof. */
+  /**
+   * `eth_getStorageAt` — storage word + Merkle proof.
+   *
+   * The node returns a proof-wrapped object
+   * `{ value, proof, stateRoot, blockNumber }` (some builds use a bare
+   * `0x…` hex word). Both shapes are normalized to a consistent
+   * {@link AccountProofResponse} via {@link normalizeAccountProof}; `.value`
+   * is always the bare storage word (even-length hex, `0x0` when zero).
+   */
   async ethGetStorageAt(address, slot, block = "latest") {
-    return this.call("eth_getStorageAt", [
-      address,
-      slot,
-      encodeBlockSelector(block)
-    ]);
+    return normalizeAccountProof(
+      await this.call("eth_getStorageAt", [
+        address,
+        slot,
+        encodeBlockSelector(block)
+      ])
+    );
   }
   /** `eth_getTransactionCount` — sender nonce. */
   async ethGetTransactionCount(address, block = "latest") {
@@ -4387,9 +4452,14 @@ var RpcClient = class _RpcClient {
   async lythGetRegistration(peerId) {
     return this.call("lyth_getRegistration", [peerId]);
   }
-  /** `lyth_registryStateProof` — Merkle proof for a registry entry. */
+  /**
+   * `lyth_registryStateProof` — Merkle proof for a registry entry.
+   *
+   * Normalized through {@link normalizeAccountProof} so a bare-hex or
+   * proof-wrapped answer both yield a consistent {@link AccountProofResponse}.
+   */
   async lythRegistryStateProof(peerId) {
-    return this.call("lyth_registryStateProof", [peerId]);
+    return normalizeAccountProof(await this.call("lyth_registryStateProof", [peerId]));
   }
   /** `lyth_getAccountPolicy` — privacy posture for an account. */
   async lythGetAccountPolicy(address) {
@@ -4765,6 +4835,55 @@ var RpcClient = class _RpcClient {
   async lythGetClusterDiversity(clusterId) {
     return this.call("lyth_getClusterDiversity", [clusterId]);
   }
+  /**
+   * Component H — read a cluster's ACTIVE economics charter (Law §6.8).
+   *
+   * There is no `lyth_*` / view-selector for the active charter, so this
+   * SLOADs the two `TAG_CLUSTER_CHARTER` (`0x31`) storage words from the
+   * node-registry account `0x1005` via `eth_getStorageAt` and decodes them
+   * with {@link decodeActiveCharter}. Returns `{ present: false }` (zeroed
+   * shares) for genesis / 3-arg-formCluster clusters that never adopted a
+   * charter. The active record carries no `effectiveEpoch` — that lives on
+   * the pending amendment ({@link lythGetPendingCharter}).
+   */
+  async lythGetClusterCharter(clusterId, block = "latest") {
+    const registry = nodeRegistryAddressHex();
+    const [delegator, members] = await Promise.all([
+      this.ethGetStorageAt(registry, slotClusterCharterDelegator(clusterId), block),
+      this.ethGetStorageAt(registry, slotClusterCharterMembers(clusterId), block)
+    ]);
+    return decodeActiveCharter(delegator.value, members.value);
+  }
+  /**
+   * Component H — read a cluster's PENDING charter amendment (Law §6.8).
+   *
+   * Calls the `getPendingCharter(uint32)` view on the node-registry account
+   * `0x1005` over `eth_call` and decodes the return with
+   * {@link decodePendingCharter}. Returns `{ present: false }` when no
+   * amendment is posted; otherwise carries the proposed shares plus the
+   * `effectiveEpoch` at which the delegator-protective cooldown lands.
+   */
+  async lythGetPendingCharter(clusterId, block = "latest") {
+    const data = await this.ethCall(
+      { to: nodeRegistryAddressHex(), data: encodeGetPendingCharterCalldata(clusterId) },
+      block
+    );
+    return decodePendingCharter(data);
+  }
+  /**
+   * Component A — read a cluster's settled per-cluster ServiceScore (the
+   * `u64` the reward path reads each block). SLOADs the `TAG_SERVICE_SCORE`
+   * (`0x24`) score slot from `0x1005` via `eth_getStorageAt`; `0n` means the
+   * cluster has never been scored.
+   */
+  async lythGetClusterServiceScore(clusterId, block = "latest") {
+    const word = await this.ethGetStorageAt(
+      nodeRegistryAddressHex(),
+      slotClusterServiceScore(clusterId),
+      block
+    );
+    return parseQuantityBig(word.value);
+  }
   /**
    * PF-6 — `lyth_getOperatorNetworkMetadata`: ASN/geo/hosting-class/IP/PCR
    * for a peer. `operatorId` is the 32-byte operator/peer id as `0x…` hex
@@ -5262,6 +5381,38 @@ function parseQuantity(hex) {
   }
   return Number(big);
 }
+function normalizeStorageWord(value) {
+  if (value === null || value === void 0 || value === "") return "0x0";
+  if (typeof value !== "string") {
+    throw SdkError.malformed(`storage word is not a string: ${typeof value}`);
+  }
+  const body = value.startsWith("0x") || value.startsWith("0X") ? value.slice(2) : value;
+  if (body.length === 0) return "0x0";
+  if (!/^[0-9a-fA-F]+$/.test(body)) {
+    throw SdkError.malformed(`invalid hex storage word: ${value}`);
+  }
+  return body.length % 2 === 0 ? `0x${body}` : `0x0${body}`;
+}
+function normalizeAccountProof(result) {
+  if (typeof result === "string" || result === null || result === void 0) {
+    return { value: normalizeStorageWord(result), state_root: "0x", block_number: 0n };
+  }
+  const obj = result;
+  const stateRoot = obj.state_root ?? obj.stateRoot ?? "0x";
+  const rawBlock = obj.block_number ?? obj.blockNumber ?? 0;
+  let blockNumber;
+  try {
+    blockNumber = typeof rawBlock === "bigint" ? rawBlock : BigInt(rawBlock);
+  } catch {
+    blockNumber = 0n;
+  }
+  return {
+    value: normalizeStorageWord(obj.value),
+    state_root: stateRoot,
+    block_number: blockNumber,
+    proof: obj.proof ?? null
+  };
+}
 function encodeRpcInteger(v) {
   if (typeof v === "bigint") return `0x${v.toString(16)}`;
   return v;
@@ -12144,7 +12295,7 @@ var MONOLYTHIUM_NETWORKS = {
 };
 
 // src/index.ts
-var version = "0.4.8";
+var version = "0.4.18";
 
 exports.ADDRESS_HRP = ADDRESS_HRP;
 exports.ADDRESS_KIND_HRPS = ADDRESS_KIND_HRPS;
@@ -12258,7 +12409,10 @@ exports.NODE_REGISTRY_OPERATOR_SEAL_EK_BYTES = NODE_REGISTRY_OPERATOR_SEAL_EK_BY
 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;
+exports.NODE_REGISTRY_SUBKIND_CHARTER_DELEGATOR_BPS = NODE_REGISTRY_SUBKIND_CHARTER_DELEGATOR_BPS;
+exports.NODE_REGISTRY_SUBKIND_CHARTER_MEMBER_SHARES = NODE_REGISTRY_SUBKIND_CHARTER_MEMBER_SHARES;
 exports.NODE_REGISTRY_TAG_ARCHIVE_CHALLENGE = NODE_REGISTRY_TAG_ARCHIVE_CHALLENGE;
+exports.NODE_REGISTRY_TAG_CLUSTER_CHARTER = NODE_REGISTRY_TAG_CLUSTER_CHARTER;
 exports.NODE_REGISTRY_TAG_SERVICE_SCORE = NODE_REGISTRY_TAG_SERVICE_SCORE;
 exports.NODE_REGISTRY_TAG_TREASURY = NODE_REGISTRY_TAG_TREASURY;
 exports.NODE_REGISTRY_UPDATE_CHARTER_MESSAGE_DOMAIN = NODE_REGISTRY_UPDATE_CHARTER_MESSAGE_DOMAIN;
@@ -12418,6 +12572,7 @@ exports.computeNoEvmRoundFinalityMessage = computeNoEvmRoundFinalityMessage;
 exports.computeNoEvmTargetReceiptHash = computeNoEvmTargetReceiptHash;
 exports.computeQuoteLiquidity = computeQuoteLiquidity;
 exports.consumeNativeEvents = consumeNativeEvents;
+exports.decodeActiveCharter = decodeActiveCharter;
 exports.decodeClusterCharter = decodeClusterCharter;
 exports.decodeClusterDiversity = decodeClusterDiversity;
 exports.decodeClusterFormedEvent = decodeClusterFormedEvent;
@@ -12661,6 +12816,9 @@ exports.serviceMaskToBitIndex = serviceMaskToBitIndex;
 exports.serviceProbeStatusLabel = serviceProbeStatusLabel;
 exports.setDestinationRoot = setDestinationRoot;
 exports.slotArchiveChallengePass = slotArchiveChallengePass;
+exports.slotClusterCharter = slotClusterCharter;
+exports.slotClusterCharterDelegator = slotClusterCharterDelegator;
+exports.slotClusterCharterMembers = slotClusterCharterMembers;
 exports.slotClusterServiceScore = slotClusterServiceScore;
 exports.slotEpochChallengeSeed = slotEpochChallengeSeed;
 exports.slotProbeAuthority = slotProbeAuthority;