@kaspacom/kcc20-tx-builder 0.6.2 → 0.7.0

package/src/snapshot-operation.ts

@@ -618,7 +618,7 @@ export function createKcc20SnapshotPsktBuilder(
         params.holderExtensionCommitment,
         "holder extension commitment",
       ),
-      totalSupply: positiveI64(params.totalSupply, "total supply"),
+      totalSupply: positiveWideAmount(params.totalSupply, "total supply"),
       claimNotBeforeDaaScore: positiveI64(
         params.claimNotBeforeDaaScore,
         "claim-not-before DAA score",
@@ -1830,6 +1830,22 @@ export function createKcc20SnapshotPsktBuilder(
     return amount;
   }
 
+  function positiveWideAmount(value, label) {
+    let amount;
+    try {
+      if (typeof value === "number" && !Number.isSafeInteger(value)) {
+        throw new Error("unsafe integer");
+      }
+      amount = BigInt(value);
+    } catch {
+      throw new Error(`${label} must be a positive unsigned two-limb integer`);
+    }
+    if (amount <= 0n || amount > (1n << 126n) - 1n) {
+      throw new Error(`${label} must be a positive unsigned two-limb integer`);
+    }
+    return amount;
+  }
+
   function nonnegativeI64(value, label) {
     let amount;
     try {

package/src/snapshot-signerless.ts

@@ -37,9 +37,9 @@ export function buildSnapshotTokenMetadata({
   protocolFeeRecipient,
   protocolFeeBps = 0n,
 }) {
-  const amount = positiveI64(totalAllocation, "total allocation");
+  const amount = positiveWideAmount(totalAllocation, "total allocation");
   const extension = {
-    kind: 1,
+    kind: amount > MAX_I64 ? 2 : 1,
     creator: bytes32(creator, "creator"),
     ticker: bytes32(ticker, "ticker"),
     name: bytes32(name, "name"),
@@ -164,13 +164,15 @@ export function snapshotStartPlanCommitment({
   shards,
 }) {
   const normalized = normalizeStartShards(shards, false);
+  const supply = wideAmountLimbs(totalSupply, "total supply");
   return hash256(
     Uint8Array.of(0x22),
     bytes32(migrationCommitment, "migration commitment"),
     bytes32(manifestCommitment, "manifest commitment"),
     bytes32(extensionCommitment, "holder extension commitment"),
     nonzeroBytes32(tokenId, "token id"),
-    leI64(positiveI64(totalSupply, "total supply")),
+    leI64(supply.high),
+    leI64(supply.low),
     leI64(claimActivation(claimNotBeforeDaaScore).lockTime),
     leI64(normalized.length),
     ...normalized.flatMap(shardPlanParts),
@@ -202,7 +204,7 @@ export function buildBootstrapGenesisPlan({
     "holder extension commitment",
   );
   const token = nonzeroBytes32(expectedTokenId, "expected token id");
-  const supply = positiveI64(totalSupply, "total supply");
+  const supply = positiveWideAmount(totalSupply, "total supply");
   const activation = claimActivation(claimNotBeforeDaaScore).lockTime;
   const bootstrapTemplate = templateParts(bootstrapArtifact);
   validateStartShards(normalized, {
@@ -816,7 +818,8 @@ export function encodeSnapshotBootstrapState(state) {
     push(value.migrationId),
     push(value.manifestCommitment),
     push(value.holderExtensionCommitment),
-    push(leI64(value.totalSupply)),
+    push(leI64(value.totalSupplyHigh)),
+    push(leI64(value.totalSupplyLow)),
     push(leI64(value.claimNotBeforeDaaScore)),
     push(value.expectedTokenId),
     push(value.kcc20TemplateHash),
@@ -1159,7 +1162,7 @@ function normalizeBootstrapState(state) {
       state.holderExtensionCommitment,
       "holder extension commitment",
     ),
-    totalSupply: positiveI64(state.totalSupply, "total supply"),
+    totalSupply: positiveWideAmount(state.totalSupply, "total supply"),
     claimNotBeforeDaaScore: positiveI64(
       state.claimNotBeforeDaaScore,
       "claim-not-before DAA score",
@@ -1217,6 +1220,9 @@ function normalizeBootstrapState(state) {
       "start plan commitment",
     ),
   };
+  const supplyLimbs = wideAmountLimbs(value.totalSupply, "total supply");
+  value.totalSupplyHigh = supplyLimbs.high;
+  value.totalSupplyLow = supplyLimbs.low;
   if (
     value.claimNotBeforeDaaScore >= LOCK_TIME_THRESHOLD ||
     value.shardCount > BigInt(MAX_SNAPSHOT_SHARDS) ||
@@ -1503,6 +1509,24 @@ function positiveI64(value, label) {
   return number;
 }
 
+function positiveWideAmount(value, label) {
+  if (typeof value === "number" && !Number.isSafeInteger(value)) {
+    throw new Error(`${label} must not be an unsafe JavaScript number`);
+  }
+  const number = BigInt(value);
+  const maximum = (1n << 126n) - 1n;
+  if (number <= 0n || number > maximum) {
+    throw new Error(`${label} must be a positive unsigned two-limb integer`);
+  }
+  return number;
+}
+
+function wideAmountLimbs(value, label) {
+  const amount = positiveWideAmount(value, label);
+  const base = 1n << 63n;
+  return { high: amount / base, low: amount % base };
+}
+
 function equalBytes(a, b) {
   const left = Uint8Array.from(a ?? []);
   const right = Uint8Array.from(b ?? []);