@secondlayer/stacks 4.0.0 → 4.2.0

package/dist/src/tools/index.js

@@ -402,7 +402,8 @@ var AnchorMode = {
 };
 var PostConditionModeWire = {
   Allow: 1,
-  Deny: 2
+  Deny: 2,
+  Originator: 3
 };
 var AddressHashMode = {
   P2PKH: 0,
@@ -425,7 +426,8 @@ var FungibleConditionCode = {
 };
 var NonFungibleConditionCode = {
   Sends: 16,
-  DoesNotSend: 17
+  DoesNotSend: 17,
+  MaybeSent: 18
 };
 var PoxConditionCode = {
   WillNotPerform: 48,
@@ -519,7 +521,7 @@ function serializePrincipal(principal) {
 function serializeAssetInfo(asset) {
   return concatBytes(serializeAddress2(asset.address), serializeLPString2(asset.contractName), serializeLPString2(asset.assetName));
 }
-function serializePostCondition(pc) {
+function serializePostConditionWire(pc) {
   const parts = [];
   switch (pc.type) {
     case "stx":
@@ -558,9 +560,8 @@ function serializePostCondition(pc) {
 }
 function serializePostConditions(pcs) {
   const parts = [writeUInt32BE(pcs.length)];
-  for (const pc of pcs) {
-    parts.push(serializePostCondition(pc));
-  }
+  for (const pc of pcs)
+    parts.push(serializePostConditionWire(pc));
   return concatBytes(...parts);
 }
 function serializePayload(payload) {
@@ -1301,6 +1302,441 @@ function clarityValueToJSInner(abiType, cv) {
   throw new Error(`Unknown ABI type: ${JSON.stringify(abiType)}`);
 }
 
+// src/transactions/wire/deserialize.ts
+function readSpendingCondition(r) {
+  const hashMode = r.readUInt8();
+  const signer = bytesToHex(r.readBytes(20));
+  const nonce = r.readBigUInt64BE();
+  const fee = r.readBigUInt64BE();
+  if (hashMode === AddressHashMode.P2PKH || hashMode === AddressHashMode.P2WPKH) {
+    const keyEncoding = r.readUInt8();
+    const signature = bytesToHex(r.readBytes(RECOVERABLE_ECDSA_SIG_LENGTH_BYTES));
+    return {
+      hashMode,
+      signer,
+      nonce,
+      fee,
+      keyEncoding,
+      signature
+    };
+  }
+  const fieldCount = r.readUInt32BE();
+  const fields = [];
+  for (let i = 0;i < fieldCount; i++) {
+    const fieldType = r.readUInt8();
+    if (fieldType <= 1) {
+      const keyLen = fieldType === 0 ? 33 : 65;
+      fields.push({
+        type: "publicKey",
+        pubKeyEncoding: fieldType,
+        data: bytesToHex(r.readBytes(keyLen))
+      });
+    } else {
+      fields.push({
+        type: "signature",
+        pubKeyEncoding: fieldType === 2 ? 0 : 1,
+        data: bytesToHex(r.readBytes(RECOVERABLE_ECDSA_SIG_LENGTH_BYTES))
+      });
+    }
+  }
+  const signaturesRequired = r.readUInt16BE();
+  return {
+    hashMode,
+    signer,
+    nonce,
+    fee,
+    fields,
+    signaturesRequired
+  };
+}
+function readAuthorization(r) {
+  const authType = r.readUInt8();
+  const spendingCondition = readSpendingCondition(r);
+  if (authType === AuthType.Standard) {
+    return { authType: AuthType.Standard, spendingCondition };
+  }
+  const sponsorSpendingCondition = readSpendingCondition(r);
+  return {
+    authType: AuthType.Sponsored,
+    spendingCondition,
+    sponsorSpendingCondition
+  };
+}
+function readAssetInfo(r) {
+  return {
+    address: readAddress(r),
+    contractName: readLPString(r),
+    assetName: readLPString(r)
+  };
+}
+function readPostConditionPrincipal(r) {
+  const type = r.readUInt8();
+  switch (type) {
+    case PostConditionPrincipalId.Origin:
+      return { type: "origin" };
+    case PostConditionPrincipalId.Standard:
+      return { type: "standard", address: readAddress(r) };
+    case PostConditionPrincipalId.Contract:
+      return {
+        type: "contract",
+        address: readAddress(r),
+        contractName: readLPString(r)
+      };
+    default:
+      return { type: "origin" };
+  }
+}
+function readPostCondition(r) {
+  const assetType = r.readUInt8();
+  const principal = readPostConditionPrincipal(r);
+  switch (assetType) {
+    case AssetType.STX:
+      return {
+        type: "stx",
+        principal,
+        conditionCode: r.readUInt8(),
+        amount: r.readBigUInt64BE()
+      };
+    case AssetType.Fungible:
+      return {
+        type: "ft",
+        principal,
+        asset: readAssetInfo(r),
+        conditionCode: r.readUInt8(),
+        amount: r.readBigUInt64BE()
+      };
+    case AssetType.NonFungible:
+      return {
+        type: "nft",
+        principal,
+        asset: readAssetInfo(r),
+        assetId: readCV(r),
+        conditionCode: r.readUInt8()
+      };
+    case AssetType.Staking:
+      return {
+        type: "staking",
+        principal,
+        conditionCode: r.readUInt8(),
+        amount: r.readBigUInt64BE()
+      };
+    case AssetType.Pox:
+      return {
+        type: "pox",
+        principal,
+        conditionCode: r.readUInt8()
+      };
+    default:
+      throw new Error(`Unknown post-condition asset type: 0x${assetType.toString(16).padStart(2, "0")}`);
+  }
+}
+function readPostConditions(r) {
+  const count = r.readUInt32BE();
+  const pcs = [];
+  for (let i = 0;i < count; i++) {
+    try {
+      pcs.push(readPostCondition(r));
+    } catch (e) {
+      if (e instanceof Error && e.message.startsWith("Unknown post-condition asset type:")) {
+        throw new Error(`${e.message} (post-condition ${i + 1}/${count})`);
+      }
+      throw e;
+    }
+  }
+  return pcs;
+}
+function readPayload(r) {
+  const payloadType = r.readUInt8();
+  switch (payloadType) {
+    case PayloadType.TokenTransfer: {
+      const recipient = readCV(r);
+      const amount = r.readBigUInt64BE();
+      const memoBytes = r.readBytes(MEMO_MAX_LENGTH_BYTES);
+      const memo = bytesToAscii(memoBytes).replace(/\0+$/, "");
+      return {
+        payloadType: PayloadType.TokenTransfer,
+        recipient,
+        amount,
+        memo
+      };
+    }
+    case PayloadType.ContractCall: {
+      const contractAddress = readAddress(r);
+      const contractName = readLPString(r);
+      const functionName = readLPString(r);
+      const numArgs = r.readUInt32BE();
+      const functionArgs = [];
+      for (let i = 0;i < numArgs; i++)
+        functionArgs.push(readCV(r));
+      return {
+        payloadType: PayloadType.ContractCall,
+        contractAddress,
+        contractName,
+        functionName,
+        functionArgs
+      };
+    }
+    case PayloadType.SmartContract: {
+      const contractName = readLPString(r);
+      const codeBody = readLPString(r, 4);
+      return { payloadType: PayloadType.SmartContract, contractName, codeBody };
+    }
+    case PayloadType.VersionedSmartContract: {
+      const clarityVersion = r.readUInt8();
+      const contractName = readLPString(r);
+      const codeBody = readLPString(r, 4);
+      return {
+        payloadType: PayloadType.VersionedSmartContract,
+        clarityVersion,
+        contractName,
+        codeBody
+      };
+    }
+    case PayloadType.Coinbase: {
+      const coinbaseBuffer = bytesToHex(r.readBytes(COINBASE_BYTES_LENGTH));
+      return { payloadType: PayloadType.Coinbase, coinbaseBuffer };
+    }
+    case PayloadType.CoinbaseToAltRecipient: {
+      const coinbaseBuffer = bytesToHex(r.readBytes(COINBASE_BYTES_LENGTH));
+      const recipient = readCV(r);
+      return {
+        payloadType: PayloadType.CoinbaseToAltRecipient,
+        coinbaseBuffer,
+        recipient
+      };
+    }
+    case PayloadType.PoisonMicroblock: {
+      const header1 = bytesToHex(r.readBytes(MICROBLOCK_HEADER_BYTES_LENGTH));
+      const header2 = bytesToHex(r.readBytes(MICROBLOCK_HEADER_BYTES_LENGTH));
+      return { payloadType: PayloadType.PoisonMicroblock, header1, header2 };
+    }
+    case PayloadType.TenureChange: {
+      const tenureConsensusHash = bytesToHex(r.readBytes(20));
+      const prevTenureConsensusHash = bytesToHex(r.readBytes(20));
+      const burnViewConsensusHash = bytesToHex(r.readBytes(20));
+      const previousTenureEnd = bytesToHex(r.readBytes(32));
+      const previousTenureBlocks = r.readUInt32BE();
+      const cause = r.readUInt8();
+      const pubkeyHash = bytesToHex(r.readBytes(20));
+      return {
+        payloadType: PayloadType.TenureChange,
+        tenureConsensusHash,
+        prevTenureConsensusHash,
+        burnViewConsensusHash,
+        previousTenureEnd,
+        previousTenureBlocks,
+        cause,
+        pubkeyHash
+      };
+    }
+    case PayloadType.NakamotoCoinbase: {
+      const coinbaseBuffer = bytesToHex(r.readBytes(COINBASE_BYTES_LENGTH));
+      const optionalCV = readCV(r);
+      const recipient = optionalCV.type === "none" ? null : optionalCV.type === "some" ? optionalCV.value : optionalCV;
+      const vrfProof = bytesToHex(r.readBytes(VRF_PROOF_BYTES_LENGTH));
+      return {
+        payloadType: PayloadType.NakamotoCoinbase,
+        coinbaseBuffer,
+        recipient,
+        vrfProof
+      };
+    }
+    default:
+      throw new Error(`Unknown payload type: ${payloadType}`);
+  }
+}
+function deserializePostConditionWire(input) {
+  const bytes = typeof input === "string" ? hexToBytes(without0x(input)) : input;
+  return readPostCondition(new BytesReader(bytes));
+}
+function deserializeTransaction(input, meta) {
+  const bytes = typeof input === "string" ? hexToBytes(without0x(input)) : input;
+  const r = new BytesReader(bytes);
+  const tx = {
+    version: r.readUInt8(),
+    chainId: r.readUInt32BE(),
+    auth: readAuthorization(r),
+    anchorMode: r.readUInt8(),
+    postConditionMode: r.readUInt8(),
+    postConditions: readPostConditions(r),
+    payload: readPayload(r)
+  };
+  if (meta?._multisig) {
+    tx._multisig = meta._multisig;
+  }
+  return tx;
+}
+
+// src/postconditions/convert.ts
+var MAX_U64 = 18446744073709551615n;
+function parsePostConditionAmount(amount) {
+  const value = intToBigInt(amount);
+  if (value < 0n || value > MAX_U64) {
+    throw new RangeError(`Post-condition amount must be between 0 and ${MAX_U64} (u64 max), received: ${value}`);
+  }
+  return value;
+}
+var FUNGIBLE_CODE_MAP = {
+  eq: FungibleConditionCode.Equal,
+  gt: FungibleConditionCode.Greater,
+  gte: FungibleConditionCode.GreaterEqual,
+  lt: FungibleConditionCode.Less,
+  lte: FungibleConditionCode.LessEqual
+};
+var FUNGIBLE_CODE_REVERSE = {
+  [FungibleConditionCode.Equal]: "eq",
+  [FungibleConditionCode.Greater]: "gt",
+  [FungibleConditionCode.GreaterEqual]: "gte",
+  [FungibleConditionCode.Less]: "lt",
+  [FungibleConditionCode.LessEqual]: "lte"
+};
+var NFT_CODE_MAP = {
+  sent: NonFungibleConditionCode.Sends,
+  "not-sent": NonFungibleConditionCode.DoesNotSend,
+  "maybe-sent": NonFungibleConditionCode.MaybeSent
+};
+var NFT_CODE_REVERSE = {
+  [NonFungibleConditionCode.Sends]: "sent",
+  [NonFungibleConditionCode.DoesNotSend]: "not-sent",
+  [NonFungibleConditionCode.MaybeSent]: "maybe-sent"
+};
+var POX_CODE_MAP = {
+  "will-not-perform": PoxConditionCode.WillNotPerform,
+  "may-perform": PoxConditionCode.MayPerform,
+  "will-perform": PoxConditionCode.WillPerform
+};
+var POX_CODE_REVERSE = {
+  [PoxConditionCode.WillNotPerform]: "will-not-perform",
+  [PoxConditionCode.MayPerform]: "may-perform",
+  [PoxConditionCode.WillPerform]: "will-perform"
+};
+function resolvePrincipal(address) {
+  if (address === "origin")
+    return { type: "origin" };
+  const [addr, name] = address.split(".");
+  if (name) {
+    return { type: "contract", address: addr, contractName: name };
+  }
+  return { type: "standard", address: addr };
+}
+function principalToString(principal) {
+  if (principal.type === "origin")
+    return "origin";
+  if (principal.type === "contract") {
+    return `${principal.address}.${principal.contractName}`;
+  }
+  return principal.address;
+}
+function assetToString(asset) {
+  return `${asset.address}.${asset.contractName}::${asset.assetName}`;
+}
+function parseAsset(asset) {
+  const [contractId, tokenName] = asset.split("::");
+  const [addr, name] = parseContractId(contractId);
+  return { address: addr, contractName: name, assetName: tokenName };
+}
+function convertPostCondition(pc) {
+  switch (pc.type) {
+    case "stx-postcondition":
+      return {
+        type: "stx",
+        principal: resolvePrincipal(pc.address),
+        conditionCode: FUNGIBLE_CODE_MAP[pc.condition],
+        amount: parsePostConditionAmount(pc.amount)
+      };
+    case "ft-postcondition":
+      return {
+        type: "ft",
+        principal: resolvePrincipal(pc.address),
+        asset: parseAsset(pc.asset),
+        conditionCode: FUNGIBLE_CODE_MAP[pc.condition],
+        amount: parsePostConditionAmount(pc.amount)
+      };
+    case "nft-postcondition":
+      return {
+        type: "nft",
+        principal: resolvePrincipal(pc.address),
+        asset: parseAsset(pc.asset),
+        conditionCode: NFT_CODE_MAP[pc.condition],
+        assetId: pc.assetId
+      };
+    case "staking-postcondition":
+      return {
+        type: "staking",
+        principal: resolvePrincipal(pc.address),
+        conditionCode: FUNGIBLE_CODE_MAP[pc.condition],
+        amount: parsePostConditionAmount(pc.amount)
+      };
+    case "pox-postcondition":
+      return {
+        type: "pox",
+        principal: resolvePrincipal(pc.address),
+        conditionCode: POX_CODE_MAP[pc.condition]
+      };
+  }
+}
+function wireToPostCondition(wire) {
+  switch (wire.type) {
+    case "stx":
+      return {
+        type: "stx-postcondition",
+        address: principalToString(wire.principal),
+        condition: fungibleName(wire.conditionCode),
+        amount: wire.amount.toString()
+      };
+    case "ft":
+      return {
+        type: "ft-postcondition",
+        address: principalToString(wire.principal),
+        condition: fungibleName(wire.conditionCode),
+        amount: wire.amount.toString(),
+        asset: assetToString(wire.asset)
+      };
+    case "nft":
+      return {
+        type: "nft-postcondition",
+        address: principalToString(wire.principal),
+        condition: nftName(wire.conditionCode),
+        asset: assetToString(wire.asset),
+        assetId: wire.assetId
+      };
+    case "staking":
+      return {
+        type: "staking-postcondition",
+        address: principalToString(wire.principal),
+        condition: fungibleName(wire.conditionCode),
+        amount: wire.amount.toString()
+      };
+    case "pox":
+      return {
+        type: "pox-postcondition",
+        address: principalToString(wire.principal),
+        condition: poxName(wire.conditionCode)
+      };
+  }
+}
+function fungibleName(code) {
+  const name = FUNGIBLE_CODE_REVERSE[code];
+  if (!name)
+    throw new Error(`Unknown fungible post-condition code: ${code}`);
+  return name;
+}
+function nftName(code) {
+  const name = NFT_CODE_REVERSE[code];
+  if (!name)
+    throw new Error(`Unknown nft post-condition code: ${code}`);
+  return name;
+}
+function poxName(code) {
+  const name = POX_CODE_REVERSE[code];
+  if (!name)
+    throw new Error(`Unknown pox post-condition code: ${code}`);
+  return name;
+}
+function fromHex(hex) {
+  return wireToPostCondition(deserializePostConditionWire(hex));
+}
+
 // src/transactions/authorization.ts
 import { hmac } from "@noble/hashes/hmac.js";
 import { sha256 as sha2563 } from "@noble/hashes/sha2.js";
@@ -1379,106 +1815,43 @@ import {
 } from "@noble/secp256k1";
 var OP_CHECKMULTISIG = 174;
 function makeRedeemScript(publicKeys, signaturesRequired) {
-  const parts = [];
-  parts.push(new Uint8Array([80 + signaturesRequired]));
-  for (const pk of publicKeys) {
-    const pkBytes = hexToBytes(pk);
-    parts.push(new Uint8Array([pkBytes.length]));
-    parts.push(pkBytes);
-  }
-  parts.push(new Uint8Array([80 + publicKeys.length]));
-  parts.push(new Uint8Array([OP_CHECKMULTISIG]));
-  return concatBytes(...parts);
-}
-function createMultiSigSpendingCondition(publicKeys, signaturesRequired, nonce, fee, hashMode = AddressHashMode.P2SH) {
-  const redeemScript = makeRedeemScript(publicKeys, signaturesRequired);
-  const signer = bytesToHex(hash160(redeemScript));
-  return {
-    hashMode,
-    signer,
-    nonce,
-    fee,
-    fields: [],
-    signaturesRequired
-  };
-}
-
-// src/transactions/build.ts
-function resolvePcMode(mode) {
-  return mode === "allow" ? PostConditionModeWire.Allow : PostConditionModeWire.Deny;
-}
-function convertPostConditions(pcs) {
-  if (!pcs || pcs.length === 0)
-    return [];
-  return pcs.map(convertPostCondition);
-}
-function resolvePrincipal(address) {
-  if (address === "origin")
-    return { type: "origin" };
-  const [addr, name] = address.split(".");
-  if (name) {
-    return { type: "contract", address: addr, contractName: name };
-  }
-  return { type: "standard", address: addr };
-}
-var FUNGIBLE_CODE_MAP = {
-  eq: FungibleConditionCode.Equal,
-  gt: FungibleConditionCode.Greater,
-  gte: FungibleConditionCode.GreaterEqual,
-  lt: FungibleConditionCode.Less,
-  lte: FungibleConditionCode.LessEqual
-};
-function convertPostCondition(pc) {
-  switch (pc.type) {
-    case "stx-postcondition":
-      return {
-        type: "stx",
-        principal: resolvePrincipal(pc.address),
-        conditionCode: FUNGIBLE_CODE_MAP[pc.condition],
-        amount: intToBigInt(pc.amount)
-      };
-    case "ft-postcondition": {
-      const [contractId, tokenName] = pc.asset.split("::");
-      const [addr, name] = parseContractId(contractId);
-      return {
-        type: "ft",
-        principal: resolvePrincipal(pc.address),
-        asset: { address: addr, contractName: name, assetName: tokenName },
-        conditionCode: FUNGIBLE_CODE_MAP[pc.condition],
-        amount: intToBigInt(pc.amount)
-      };
-    }
-    case "nft-postcondition": {
-      const [contractId, tokenName] = pc.asset.split("::");
-      const [addr, name] = parseContractId(contractId);
-      return {
-        type: "nft",
-        principal: resolvePrincipal(pc.address),
-        asset: { address: addr, contractName: name, assetName: tokenName },
-        conditionCode: pc.condition === "sent" ? NonFungibleConditionCode.Sends : NonFungibleConditionCode.DoesNotSend,
-        assetId: pc.assetId
-      };
-    }
-    case "staking-postcondition":
-      return {
-        type: "staking",
-        principal: resolvePrincipal(pc.address),
-        conditionCode: FUNGIBLE_CODE_MAP[pc.condition],
-        amount: intToBigInt(pc.amount)
-      };
-    case "pox-postcondition":
-      return {
-        type: "pox",
-        principal: resolvePrincipal(pc.address),
-        conditionCode: POX_CODE_MAP[pc.condition]
-      };
+  const parts = [];
+  parts.push(new Uint8Array([80 + signaturesRequired]));
+  for (const pk of publicKeys) {
+    const pkBytes = hexToBytes(pk);
+    parts.push(new Uint8Array([pkBytes.length]));
+    parts.push(pkBytes);
   }
+  parts.push(new Uint8Array([80 + publicKeys.length]));
+  parts.push(new Uint8Array([OP_CHECKMULTISIG]));
+  return concatBytes(...parts);
+}
+function createMultiSigSpendingCondition(publicKeys, signaturesRequired, nonce, fee, hashMode = AddressHashMode.P2SH) {
+  const redeemScript = makeRedeemScript(publicKeys, signaturesRequired);
+  const signer = bytesToHex(hash160(redeemScript));
+  return {
+    hashMode,
+    signer,
+    nonce,
+    fee,
+    fields: [],
+    signaturesRequired
+  };
+}
+
+// src/transactions/build.ts
+function resolvePcMode(mode) {
+  if (mode === "allow")
+    return PostConditionModeWire.Allow;
+  if (mode === "originator")
+    return PostConditionModeWire.Originator;
+  return PostConditionModeWire.Deny;
+}
+function convertPostConditions(pcs) {
+  if (!pcs || pcs.length === 0)
+    return [];
+  return pcs.map((pc) => convertPostCondition(typeof pc === "string" ? fromHex(pc) : pc));
 }
-var POX_CODE_MAP = {
-  "will-not-perform": PoxConditionCode.WillNotPerform,
-  "may-perform": PoxConditionCode.MayPerform,
-  "will-perform": PoxConditionCode.WillPerform
-};
 function resolveSpendingCondition(opts, nonce, fee) {
   if (opts.publicKeys) {
     return createMultiSigSpendingCondition(opts.publicKeys, opts.signaturesRequired, nonce, fee, opts.hashMode);
@@ -1979,6 +2352,16 @@ class ContractResponseError extends Error {
     this.errorValue = errorValue;
   }
 }
+// src/clarity/structuredData.ts
+import { sha256 as sha2564 } from "@noble/hashes/sha2.js";
+var SIP018_PREFIX = new Uint8Array([
+  83,
+  73,
+  80,
+  48,
+  49,
+  56
+]);
 // src/clarity/abi/standards.ts
 var SIP010_ABI = {
   functions: [
@@ -2515,262 +2898,6 @@ async function getPrimaryName(client, address) {
   }
 }
 
-// src/transactions/wire/deserialize.ts
-function readSpendingCondition(r) {
-  const hashMode = r.readUInt8();
-  const signer = bytesToHex(r.readBytes(20));
-  const nonce = r.readBigUInt64BE();
-  const fee = r.readBigUInt64BE();
-  if (hashMode === AddressHashMode.P2PKH || hashMode === AddressHashMode.P2WPKH) {
-    const keyEncoding = r.readUInt8();
-    const signature = bytesToHex(r.readBytes(RECOVERABLE_ECDSA_SIG_LENGTH_BYTES));
-    return {
-      hashMode,
-      signer,
-      nonce,
-      fee,
-      keyEncoding,
-      signature
-    };
-  }
-  const fieldCount = r.readUInt32BE();
-  const fields = [];
-  for (let i = 0;i < fieldCount; i++) {
-    const fieldType = r.readUInt8();
-    if (fieldType <= 1) {
-      const keyLen = fieldType === 0 ? 33 : 65;
-      fields.push({
-        type: "publicKey",
-        pubKeyEncoding: fieldType,
-        data: bytesToHex(r.readBytes(keyLen))
-      });
-    } else {
-      fields.push({
-        type: "signature",
-        pubKeyEncoding: fieldType === 2 ? 0 : 1,
-        data: bytesToHex(r.readBytes(RECOVERABLE_ECDSA_SIG_LENGTH_BYTES))
-      });
-    }
-  }
-  const signaturesRequired = r.readUInt16BE();
-  return {
-    hashMode,
-    signer,
-    nonce,
-    fee,
-    fields,
-    signaturesRequired
-  };
-}
-function readAuthorization(r) {
-  const authType = r.readUInt8();
-  const spendingCondition = readSpendingCondition(r);
-  if (authType === AuthType.Standard) {
-    return { authType: AuthType.Standard, spendingCondition };
-  }
-  const sponsorSpendingCondition = readSpendingCondition(r);
-  return {
-    authType: AuthType.Sponsored,
-    spendingCondition,
-    sponsorSpendingCondition
-  };
-}
-function readAssetInfo(r) {
-  return {
-    address: readAddress(r),
-    contractName: readLPString(r),
-    assetName: readLPString(r)
-  };
-}
-function readPostConditionPrincipal(r) {
-  const type = r.readUInt8();
-  switch (type) {
-    case PostConditionPrincipalId.Origin:
-      return { type: "origin" };
-    case PostConditionPrincipalId.Standard:
-      return { type: "standard", address: readAddress(r) };
-    case PostConditionPrincipalId.Contract:
-      return {
-        type: "contract",
-        address: readAddress(r),
-        contractName: readLPString(r)
-      };
-    default:
-      return { type: "origin" };
-  }
-}
-function readPostConditions(r) {
-  const count = r.readUInt32BE();
-  const pcs = [];
-  for (let i = 0;i < count; i++) {
-    const assetType = r.readUInt8();
-    const principal = readPostConditionPrincipal(r);
-    switch (assetType) {
-      case AssetType.STX:
-        pcs.push({
-          type: "stx",
-          principal,
-          conditionCode: r.readUInt8(),
-          amount: r.readBigUInt64BE()
-        });
-        break;
-      case AssetType.Fungible:
-        pcs.push({
-          type: "ft",
-          principal,
-          asset: readAssetInfo(r),
-          conditionCode: r.readUInt8(),
-          amount: r.readBigUInt64BE()
-        });
-        break;
-      case AssetType.NonFungible:
-        pcs.push({
-          type: "nft",
-          principal,
-          asset: readAssetInfo(r),
-          assetId: readCV(r),
-          conditionCode: r.readUInt8()
-        });
-        break;
-      case AssetType.Staking:
-        pcs.push({
-          type: "staking",
-          principal,
-          conditionCode: r.readUInt8(),
-          amount: r.readBigUInt64BE()
-        });
-        break;
-      case AssetType.Pox:
-        pcs.push({
-          type: "pox",
-          principal,
-          conditionCode: r.readUInt8()
-        });
-        break;
-      default:
-        throw new Error(`Unknown post-condition asset type: 0x${assetType.toString(16).padStart(2, "0")} (post-condition ${i + 1}/${count})`);
-    }
-  }
-  return pcs;
-}
-function readPayload(r) {
-  const payloadType = r.readUInt8();
-  switch (payloadType) {
-    case PayloadType.TokenTransfer: {
-      const recipient = readCV(r);
-      const amount = r.readBigUInt64BE();
-      const memoBytes = r.readBytes(MEMO_MAX_LENGTH_BYTES);
-      const memo = bytesToAscii(memoBytes).replace(/\0+$/, "");
-      return {
-        payloadType: PayloadType.TokenTransfer,
-        recipient,
-        amount,
-        memo
-      };
-    }
-    case PayloadType.ContractCall: {
-      const contractAddress = readAddress(r);
-      const contractName = readLPString(r);
-      const functionName = readLPString(r);
-      const numArgs = r.readUInt32BE();
-      const functionArgs = [];
-      for (let i = 0;i < numArgs; i++)
-        functionArgs.push(readCV(r));
-      return {
-        payloadType: PayloadType.ContractCall,
-        contractAddress,
-        contractName,
-        functionName,
-        functionArgs
-      };
-    }
-    case PayloadType.SmartContract: {
-      const contractName = readLPString(r);
-      const codeBody = readLPString(r, 4);
-      return { payloadType: PayloadType.SmartContract, contractName, codeBody };
-    }
-    case PayloadType.VersionedSmartContract: {
-      const clarityVersion = r.readUInt8();
-      const contractName = readLPString(r);
-      const codeBody = readLPString(r, 4);
-      return {
-        payloadType: PayloadType.VersionedSmartContract,
-        clarityVersion,
-        contractName,
-        codeBody
-      };
-    }
-    case PayloadType.Coinbase: {
-      const coinbaseBuffer = bytesToHex(r.readBytes(COINBASE_BYTES_LENGTH));
-      return { payloadType: PayloadType.Coinbase, coinbaseBuffer };
-    }
-    case PayloadType.CoinbaseToAltRecipient: {
-      const coinbaseBuffer = bytesToHex(r.readBytes(COINBASE_BYTES_LENGTH));
-      const recipient = readCV(r);
-      return {
-        payloadType: PayloadType.CoinbaseToAltRecipient,
-        coinbaseBuffer,
-        recipient
-      };
-    }
-    case PayloadType.PoisonMicroblock: {
-      const header1 = bytesToHex(r.readBytes(MICROBLOCK_HEADER_BYTES_LENGTH));
-      const header2 = bytesToHex(r.readBytes(MICROBLOCK_HEADER_BYTES_LENGTH));
-      return { payloadType: PayloadType.PoisonMicroblock, header1, header2 };
-    }
-    case PayloadType.TenureChange: {
-      const tenureConsensusHash = bytesToHex(r.readBytes(20));
-      const prevTenureConsensusHash = bytesToHex(r.readBytes(20));
-      const burnViewConsensusHash = bytesToHex(r.readBytes(20));
-      const previousTenureEnd = bytesToHex(r.readBytes(32));
-      const previousTenureBlocks = r.readUInt32BE();
-      const cause = r.readUInt8();
-      const pubkeyHash = bytesToHex(r.readBytes(20));
-      return {
-        payloadType: PayloadType.TenureChange,
-        tenureConsensusHash,
-        prevTenureConsensusHash,
-        burnViewConsensusHash,
-        previousTenureEnd,
-        previousTenureBlocks,
-        cause,
-        pubkeyHash
-      };
-    }
-    case PayloadType.NakamotoCoinbase: {
-      const coinbaseBuffer = bytesToHex(r.readBytes(COINBASE_BYTES_LENGTH));
-      const optionalCV = readCV(r);
-      const recipient = optionalCV.type === "none" ? null : optionalCV.type === "some" ? optionalCV.value : optionalCV;
-      const vrfProof = bytesToHex(r.readBytes(VRF_PROOF_BYTES_LENGTH));
-      return {
-        payloadType: PayloadType.NakamotoCoinbase,
-        coinbaseBuffer,
-        recipient,
-        vrfProof
-      };
-    }
-    default:
-      throw new Error(`Unknown payload type: ${payloadType}`);
-  }
-}
-function deserializeTransaction(input, meta) {
-  const bytes = typeof input === "string" ? hexToBytes(without0x(input)) : input;
-  const r = new BytesReader(bytes);
-  const tx = {
-    version: r.readUInt8(),
-    chainId: r.readUInt32BE(),
-    auth: readAuthorization(r),
-    anchorMode: r.readUInt8(),
-    postConditionMode: r.readUInt8(),
-    postConditions: readPostConditions(r),
-    payload: readPayload(r)
-  };
-  if (meta?._multisig) {
-    tx._multisig = meta._multisig;
-  }
-  return tx;
-}
-
 // src/chains/definitions.ts
 var mainnet = {
   id: 1,
@@ -2895,6 +3022,17 @@ async function getContractSource(client, params) {
   }
 }
 
+// src/actions/public/getDataVar.ts
+async function getDataVar(client, params) {
+  const [address, name] = parseContractId(params.contract);
+  const path = `/v2/data_var/${address}/${name}/${params.varName}?proof=0`;
+  const data = await client.request(path, { method: "GET" });
+  if (typeof data?.data !== "string") {
+    throw new MalformedResponseError(`getDataVar: /v2/data_var/${address}/${name}/${params.varName} response is missing "data"`);
+  }
+  return deserializeCVBytes(data.data);
+}
+
 // src/actions/public/getRawBlock.ts
 async function getRawBlock(client, params) {
   try {
@@ -3056,6 +3194,7 @@ function publicActions(client) {
     readContract: (params) => readContract(client, params),
     getContractAbi: (params) => getContractAbi(client, params),
     getContractSource: (params) => getContractSource(client, params),
+    getDataVar: (params) => getDataVar(client, params),
     getMapEntry: (params) => getMapEntry(client, params),
     estimateFee: (params) => estimateFee(client, params),
     multicall: (params) => multicall(client, params),
@@ -3442,5 +3581,5 @@ export {
   bnsResolve
 };
 
-//# debugId=16EF5FF1D953A99864756E2164756E21
+//# debugId=FCFEA59EA081F1EE64756E2164756E21
 //# sourceMappingURL=index.js.map