@orbinum/sdk 0.1.0 → 0.3.0

package/dist/index.js

@@ -23,9 +23,11 @@ __export(index_exports, {
   AccountMappingModule: () => AccountMappingModule,
   AccountMappingPrecompile: () => AccountMappingPrecompile,
   ChainModule: () => ChainModule,
+  CircuitId: () => CircuitId,
   CryptoPrecompiles: () => CryptoPrecompiles,
   EncryptedMemo: () => EncryptedMemo,
   EvmClient: () => EvmClient,
+  KNOWN_PRECOMPILES: () => KNOWN_PRECOMPILES,
   MerkleModule: () => MerkleModule,
   NoteBuilder: () => NoteBuilder,
   OrbinumClient: () => OrbinumClient,
@@ -53,9 +55,12 @@ __export(index_exports, {
   evmAddressToAccountId: () => evmAddressToAccountId,
   evmToImplicitSubstrate: () => evmToImplicitSubstrate,
   evmToSubstrate: () => evmToSubstrate,
+  formatBalance: () => formatBalance,
+  formatORB: () => formatORB,
   fromHex: () => fromHex,
   getPolkadotSigner: () => import_signer.getPolkadotSigner,
   getPolkadotSignerFromPjs: () => import_pjs_signer.getPolkadotSignerFromPjs,
+  getPrecompileLabel: () => getPrecompileLabel,
   implicitSubstrateToEvm: () => implicitSubstrateToEvm,
   isEvmAddress: () => isEvmAddress,
   isImplicitEvmAccount: () => isImplicitEvmAccount,
@@ -1581,6 +1586,57 @@ var SP_SEL = {
   // unshield(bytes,bytes32,bytes32,uint32,uint256,bytes32)                → 0xdcf1bff2
   UNSHIELD: new Uint8Array([220, 241, 191, 242])
 };
+var KNOWN_PRECOMPILES = {
+  // ── Ethereum standard (EIP) ─────────────────────────────────────────────
+  "0x0000000000000000000000000000000000000001": {
+    name: "ECRecover",
+    functions: { "00000000": "ecrecover(bytes32,uint8,bytes32,bytes32)" }
+  },
+  "0x0000000000000000000000000000000000000002": { name: "SHA256", functions: {} },
+  "0x0000000000000000000000000000000000000003": { name: "RIPEMD160", functions: {} },
+  "0x0000000000000000000000000000000000000004": { name: "Identity", functions: {} },
+  "0x0000000000000000000000000000000000000005": { name: "ModExp", functions: {} },
+  // ── Frontier / non-standard ─────────────────────────────────────────────
+  "0x0000000000000000000000000000000000000400": { name: "SHA3FIPS256", functions: {} },
+  "0x0000000000000000000000000000000000000401": { name: "ECRecoverPublicKey", functions: {} },
+  "0x0000000000000000000000000000000000000402": { name: "Curve25519Add", functions: {} },
+  "0x0000000000000000000000000000000000000403": { name: "Curve25519ScalarMul", functions: {} },
+  // ── Orbinum custom ───────────────────────────────────────────────────────
+  "0x0000000000000000000000000000000000000800": {
+    name: "AccountMapping",
+    functions: {
+      d03149ab: "resolveAlias(string)",
+      "7a0ed62c": "getAliasOf(address)",
+      "47e05c6c": "hasPrivateLink(string,bytes32)",
+      dca49d0e: "mapAccount()",
+      "08f57367": "unmapAccount()",
+      "7fac359e": "releaseAlias()",
+      "4d023ab9": "cancelSale()",
+      "2f8839c3": "registerAlias(string)",
+      "5ac998e7": "transferAlias(address)",
+      "1625df3a": "buyAlias(string)",
+      "32091192": "putAliasOnSale(uint256,address[])",
+      "6f579c0c": "removeChainLink(uint32)",
+      "5f3e837c": "addChainLink(uint32,bytes,bytes)",
+      c04e98f4: "registerPrivateLink(uint32,bytes32)",
+      dfd8b57e: "removePrivateLink(bytes32)",
+      "4df1f33d": "revealPrivateLink(bytes32,bytes,bytes32,bytes)",
+      "776cf9ff": "setAccountMetadata(bytes,bytes,bytes)"
+    }
+  },
+  "0x0000000000000000000000000000000000000801": {
+    name: "ShieldedPool",
+    functions: {
+      "781442b9": "shield(uint32,uint256,bytes32,bytes)",
+      dcd5b898: "privateTransfer(bytes,bytes32,bytes32[],bytes32[],bytes[])",
+      dcf1bff2: "unshield(bytes,bytes32,bytes32,uint32,uint256,bytes32)"
+    }
+  }
+};
+function getPrecompileLabel(address) {
+  if (!address) return null;
+  return KNOWN_PRECOMPILES[address.toLowerCase()]?.name ?? null;
+}
 
 // src/precompiles/ShieldedPoolPrecompile.ts
 var ShieldedPoolPrecompile = class {
@@ -2336,9 +2392,78 @@ async function decryptJson(key, iv, ciphertext) {
   return JSON.parse(new TextDecoder().decode(plainBuf), vaultReviver);
 }
 
+// src/utils/format.ts
+var LOCALE_DECIMAL_SEP = new Intl.NumberFormat(void 0).formatToParts(1.1).find((p) => p.type === "decimal")?.value ?? ".";
+function formatIntegerLocale(intPart) {
+  try {
+    return BigInt(intPart || "0").toLocaleString(void 0);
+  } catch {
+    return (intPart || "0").replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+  }
+}
+function normalizeDecimalForDisplay(raw, maxFractionDigits) {
+  let value = raw.trim();
+  if (!value) return null;
+  let sign = "";
+  if (value.startsWith("-")) {
+    sign = "-";
+    value = value.slice(1);
+  }
+  if (!/^\d*(\.\d*)?$/.test(value)) return null;
+  let [integerPart = "0", fractionPart = ""] = value.split(".");
+  integerPart = integerPart.replace(/^0+(?=\d)/, "") || "0";
+  const limit = Math.max(0, maxFractionDigits);
+  fractionPart = fractionPart.slice(0, limit).replace(/0+$/, "");
+  const formattedInt = formatIntegerLocale(integerPart);
+  return fractionPart ? `${sign}${formattedInt}${LOCALE_DECIMAL_SEP}${fractionPart}` : `${sign}${formattedInt}`;
+}
+function bigintFormatUnits(value, decimals) {
+  const negative = value < 0n;
+  const abs = negative ? -value : value;
+  const divider = 10n ** BigInt(decimals);
+  const intPart = abs / divider;
+  const fracPart = abs % divider;
+  const fracStr = fracPart.toString().padStart(decimals, "0");
+  return (negative ? "-" : "") + intPart.toString() + "." + fracStr;
+}
+function formatBalance(raw, options = {}) {
+  const opts = typeof options === "number" ? { decimals: options } : options;
+  const { decimals = 18, symbol = "ORB", showSymbol = true, precision = 6 } = opts;
+  const zero = showSymbol ? `0 ${symbol}` : "0";
+  if (raw === null || raw === void 0) return zero;
+  const rawStr = String(raw).trim().replace(/,/g, "");
+  if (!rawStr || rawStr === "0" || rawStr === "0x0") return zero;
+  if (rawStr.includes(".") && !rawStr.startsWith("0x")) {
+    const formatted = normalizeDecimalForDisplay(rawStr, precision);
+    if (!formatted || formatted === "0" || formatted === "-0") return zero;
+    return showSymbol ? `${formatted} ${symbol}` : formatted;
+  }
+  try {
+    const n = BigInt(rawStr);
+    const decimalStr = bigintFormatUnits(n, decimals);
+    const formatted = normalizeDecimalForDisplay(decimalStr, precision);
+    if (!formatted || formatted === "0" || formatted === "-0") return zero;
+    return showSymbol ? `${formatted} ${symbol}` : formatted;
+  } catch (e) {
+    console.warn("[formatBalance] Failed to parse:", raw, e);
+    return zero;
+  }
+}
+function formatORB(raw, precision = 6) {
+  return formatBalance(raw, { decimals: 18, symbol: "ORB", showSymbol: true, precision });
+}
+
 // src/types.ts
 var SLIP0044_NAMESPACE = 2147483648;
 
+// src/types/pallet-extrinsics/zk-verifier.ts
+var CircuitId = {
+  Transfer: 1,
+  Unshield: 2,
+  Disclosure: 3,
+  PrivateLink: 4
+};
+
 // src/index.ts
 var import_signer = require("polkadot-api/signer");
 var import_pjs_signer = require("polkadot-api/pjs-signer");
@@ -2347,9 +2472,11 @@ var import_pjs_signer = require("polkadot-api/pjs-signer");
   AccountMappingModule,
   AccountMappingPrecompile,
   ChainModule,
+  CircuitId,
   CryptoPrecompiles,
   EncryptedMemo,
   EvmClient,
+  KNOWN_PRECOMPILES,
   MerkleModule,
   NoteBuilder,
   OrbinumClient,
@@ -2377,9 +2504,12 @@ var import_pjs_signer = require("polkadot-api/pjs-signer");
   evmAddressToAccountId,
   evmToImplicitSubstrate,
   evmToSubstrate,
+  formatBalance,
+  formatORB,
   fromHex,
   getPolkadotSigner,
   getPolkadotSignerFromPjs,
+  getPrecompileLabel,
   implicitSubstrateToEvm,
   isEvmAddress,
   isImplicitEvmAccount,

package/dist/index.mjs

@@ -1509,6 +1509,57 @@ var SP_SEL = {
   // unshield(bytes,bytes32,bytes32,uint32,uint256,bytes32)                → 0xdcf1bff2
   UNSHIELD: new Uint8Array([220, 241, 191, 242])
 };
+var KNOWN_PRECOMPILES = {
+  // ── Ethereum standard (EIP) ─────────────────────────────────────────────
+  "0x0000000000000000000000000000000000000001": {
+    name: "ECRecover",
+    functions: { "00000000": "ecrecover(bytes32,uint8,bytes32,bytes32)" }
+  },
+  "0x0000000000000000000000000000000000000002": { name: "SHA256", functions: {} },
+  "0x0000000000000000000000000000000000000003": { name: "RIPEMD160", functions: {} },
+  "0x0000000000000000000000000000000000000004": { name: "Identity", functions: {} },
+  "0x0000000000000000000000000000000000000005": { name: "ModExp", functions: {} },
+  // ── Frontier / non-standard ─────────────────────────────────────────────
+  "0x0000000000000000000000000000000000000400": { name: "SHA3FIPS256", functions: {} },
+  "0x0000000000000000000000000000000000000401": { name: "ECRecoverPublicKey", functions: {} },
+  "0x0000000000000000000000000000000000000402": { name: "Curve25519Add", functions: {} },
+  "0x0000000000000000000000000000000000000403": { name: "Curve25519ScalarMul", functions: {} },
+  // ── Orbinum custom ───────────────────────────────────────────────────────
+  "0x0000000000000000000000000000000000000800": {
+    name: "AccountMapping",
+    functions: {
+      d03149ab: "resolveAlias(string)",
+      "7a0ed62c": "getAliasOf(address)",
+      "47e05c6c": "hasPrivateLink(string,bytes32)",
+      dca49d0e: "mapAccount()",
+      "08f57367": "unmapAccount()",
+      "7fac359e": "releaseAlias()",
+      "4d023ab9": "cancelSale()",
+      "2f8839c3": "registerAlias(string)",
+      "5ac998e7": "transferAlias(address)",
+      "1625df3a": "buyAlias(string)",
+      "32091192": "putAliasOnSale(uint256,address[])",
+      "6f579c0c": "removeChainLink(uint32)",
+      "5f3e837c": "addChainLink(uint32,bytes,bytes)",
+      c04e98f4: "registerPrivateLink(uint32,bytes32)",
+      dfd8b57e: "removePrivateLink(bytes32)",
+      "4df1f33d": "revealPrivateLink(bytes32,bytes,bytes32,bytes)",
+      "776cf9ff": "setAccountMetadata(bytes,bytes,bytes)"
+    }
+  },
+  "0x0000000000000000000000000000000000000801": {
+    name: "ShieldedPool",
+    functions: {
+      "781442b9": "shield(uint32,uint256,bytes32,bytes)",
+      dcd5b898: "privateTransfer(bytes,bytes32,bytes32[],bytes32[],bytes[])",
+      dcf1bff2: "unshield(bytes,bytes32,bytes32,uint32,uint256,bytes32)"
+    }
+  }
+};
+function getPrecompileLabel(address) {
+  if (!address) return null;
+  return KNOWN_PRECOMPILES[address.toLowerCase()]?.name ?? null;
+}
 
 // src/precompiles/ShieldedPoolPrecompile.ts
 var ShieldedPoolPrecompile = class {
@@ -2264,9 +2315,78 @@ async function decryptJson(key, iv, ciphertext) {
   return JSON.parse(new TextDecoder().decode(plainBuf), vaultReviver);
 }
 
+// src/utils/format.ts
+var LOCALE_DECIMAL_SEP = new Intl.NumberFormat(void 0).formatToParts(1.1).find((p) => p.type === "decimal")?.value ?? ".";
+function formatIntegerLocale(intPart) {
+  try {
+    return BigInt(intPart || "0").toLocaleString(void 0);
+  } catch {
+    return (intPart || "0").replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+  }
+}
+function normalizeDecimalForDisplay(raw, maxFractionDigits) {
+  let value = raw.trim();
+  if (!value) return null;
+  let sign = "";
+  if (value.startsWith("-")) {
+    sign = "-";
+    value = value.slice(1);
+  }
+  if (!/^\d*(\.\d*)?$/.test(value)) return null;
+  let [integerPart = "0", fractionPart = ""] = value.split(".");
+  integerPart = integerPart.replace(/^0+(?=\d)/, "") || "0";
+  const limit = Math.max(0, maxFractionDigits);
+  fractionPart = fractionPart.slice(0, limit).replace(/0+$/, "");
+  const formattedInt = formatIntegerLocale(integerPart);
+  return fractionPart ? `${sign}${formattedInt}${LOCALE_DECIMAL_SEP}${fractionPart}` : `${sign}${formattedInt}`;
+}
+function bigintFormatUnits(value, decimals) {
+  const negative = value < 0n;
+  const abs = negative ? -value : value;
+  const divider = 10n ** BigInt(decimals);
+  const intPart = abs / divider;
+  const fracPart = abs % divider;
+  const fracStr = fracPart.toString().padStart(decimals, "0");
+  return (negative ? "-" : "") + intPart.toString() + "." + fracStr;
+}
+function formatBalance(raw, options = {}) {
+  const opts = typeof options === "number" ? { decimals: options } : options;
+  const { decimals = 18, symbol = "ORB", showSymbol = true, precision = 6 } = opts;
+  const zero = showSymbol ? `0 ${symbol}` : "0";
+  if (raw === null || raw === void 0) return zero;
+  const rawStr = String(raw).trim().replace(/,/g, "");
+  if (!rawStr || rawStr === "0" || rawStr === "0x0") return zero;
+  if (rawStr.includes(".") && !rawStr.startsWith("0x")) {
+    const formatted = normalizeDecimalForDisplay(rawStr, precision);
+    if (!formatted || formatted === "0" || formatted === "-0") return zero;
+    return showSymbol ? `${formatted} ${symbol}` : formatted;
+  }
+  try {
+    const n = BigInt(rawStr);
+    const decimalStr = bigintFormatUnits(n, decimals);
+    const formatted = normalizeDecimalForDisplay(decimalStr, precision);
+    if (!formatted || formatted === "0" || formatted === "-0") return zero;
+    return showSymbol ? `${formatted} ${symbol}` : formatted;
+  } catch (e) {
+    console.warn("[formatBalance] Failed to parse:", raw, e);
+    return zero;
+  }
+}
+function formatORB(raw, precision = 6) {
+  return formatBalance(raw, { decimals: 18, symbol: "ORB", showSymbol: true, precision });
+}
+
 // src/types.ts
 var SLIP0044_NAMESPACE = 2147483648;
 
+// src/types/pallet-extrinsics/zk-verifier.ts
+var CircuitId = {
+  Transfer: 1,
+  Unshield: 2,
+  Disclosure: 3,
+  PrivateLink: 4
+};
+
 // src/index.ts
 import { getPolkadotSigner } from "polkadot-api/signer";
 import { getPolkadotSignerFromPjs } from "polkadot-api/pjs-signer";
@@ -2274,9 +2394,11 @@ export {
   AccountMappingModule,
   AccountMappingPrecompile,
   ChainModule,
+  CircuitId,
   CryptoPrecompiles,
   EncryptedMemo,
   EvmClient,
+  KNOWN_PRECOMPILES,
   MerkleModule,
   NoteBuilder,
   OrbinumClient,
@@ -2304,9 +2426,12 @@ export {
   evmAddressToAccountId,
   evmToImplicitSubstrate,
   evmToSubstrate,
+  formatBalance,
+  formatORB,
   fromHex,
   getPolkadotSigner,
   getPolkadotSignerFromPjs,
+  getPrecompileLabel,
   implicitSubstrateToEvm,
   isEvmAddress,
   isImplicitEvmAccount,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orbinum/sdk",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Official TypeScript SDK for Orbinum.",
   "author": "Orbinum",
   "license": "ISC",