@secondlayer/stacks 4.0.0 → 4.1.0

package/dist/src/pox5/index.d.ts

@@ -6,7 +6,7 @@ type LocalAccount = {
 	publicKey: string
 	/** Raw ECDSA sign over a hash */
 	sign(hash: Uint8Array): Uint8Array
-	/** Sign a structured message (SIP-018) */
+	/** Sign a raw UTF-8 / byte message (`sha256(bytes)`). Not SIP-018. */
 	signMessage(message: string | Uint8Array): string
 };
 /** Account with a user-provided signing function (sync or async). */
@@ -200,6 +200,24 @@ type Pox5Activation = {
 	firstRewardCycleId: number
 };
 /**
+* `/v2/pox` fields a pox-5 integration actually needs. `sbtcContract` is
+* compiled into the boot contract per network — never hardcode it.
+*/
+type Pox5Info = {
+	contractId?: string
+	currentBurnchainBlockHeight?: number
+	firstBurnchainBlockHeight?: number
+	/** Token principal pox-5 custodies. Read this for sBTC post-conditions. */
+	sbtcContract?: string
+	sbtcRegistryContract?: string
+	contractVersions: Array<{
+		contractId: string
+		activationBurnchainBlockHeight: number
+		firstRewardCycleId: number
+	}>
+};
+declare function getPoxInfo2(client: Client): Promise<Pox5Info>;
+/**
 * Read pox-5's activation entry from the node. Returns `undefined` when the
 * node doesn't know about pox-5 yet (pre-4.0.0 node software).
 */
@@ -212,6 +230,67 @@ declare function isPox5Active(client: Client): Promise<boolean>;
 /** Throw a descriptive error unless pox-5 is active on the client's chain. */
 declare function assertPox5Active(client: Client): Promise<void>;
 /**
+* Numeric `(err uN)` codes from pox-5. Missing numbers were never assigned
+* on-chain. Pair with {@link parsePox5Error} / {@link describePox5Error}.
+*/
+declare const Pox5ErrorCode: {
+	readonly Unauthorized: 1
+	readonly CannotSetupBondTooSoon: 2
+	readonly CannotSetupBondTooLate: 3
+	readonly BondAlreadySetup: 4
+	readonly StakerAlreadyAdded: 5
+	readonly BondNotFound: 7
+	readonly InsufficientStx: 8
+	readonly AlreadyRegistered: 9
+	readonly TooMuchSats: 10
+	readonly NotAllowlisted: 11
+	readonly SignerKeyGrantUsed: 12
+	readonly InvalidSignatureRecover: 13
+	readonly InvalidSignaturePubkey: 14
+	readonly SignerKeyGrantNotFound: 17
+	readonly AlreadyStaked: 19
+	readonly InvalidNumCycles: 20
+	readonly SignerNotFound: 23
+	readonly InvalidStartBurnHeight: 24
+	readonly UnauthorizedSignerRegistration: 26
+	readonly NotStaking: 27
+	readonly UnstakeInPreparePhase: 28
+	readonly InvalidBondPeriodOrdering: 29
+	readonly DistributionAlreadyComputed: 30
+	readonly BondNotActive: 31
+	readonly NoClaimableRewards: 32
+	readonly ActiveBondNotIncluded: 33
+	readonly NotBondParticipant: 34
+	readonly CannotAnnounceL1EarlyUnlock: 35
+	readonly InvalidOldSignerManager: 36
+	readonly InvalidUnstakeSbtcAmount: 37
+	readonly CannotUnstakeSbtc: 38
+	readonly ReadTxOutOfBounds: 39
+	readonly InvalidBtcHeader: 40
+	readonly InvalidMerkleProof: 41
+	readonly InvalidLockupScript: 42
+	readonly BondAlreadyStarted: 43
+	readonly UpdateBondSameSigner: 44
+	readonly InvalidLockupAmount: 45
+	readonly DuplicateLockupOutpoint: 46
+	readonly StakeInPreparePhase: 47
+	readonly RolloverTooEarly: 48
+	readonly ReentrantCall: 49
+	readonly L1EarlyExitAlreadyAnnounced: 50
+	readonly InsufficientReserveBalance: 51
+	readonly InvalidUnlockHeight: 52
+	readonly RewardsPaused: 53
+};
+type Pox5ErrorCode = (typeof Pox5ErrorCode)[keyof typeof Pox5ErrorCode];
+declare const POX5_ERROR_NAMES: Record<Pox5ErrorCode, string>;
+/** Extract `(err uN)` from a Clarity value or Hiro `repr` string. */
+declare function parsePox5Error(result: ClarityValue | string | undefined): number | undefined;
+declare function describePox5Error(code: number | bigint): {
+	code: number
+	name: string
+	description: string
+} | undefined;
+/**
 * Stacks hard-fork epoch activation heights, as Bitcoin burn block heights.
 *
 * Epoch 4.0 carries both SIP-044 (the native Bitcoin SPV built-ins / Clarity 6)
@@ -442,7 +521,7 @@ type FeeTier = "min" | "low" | "mid" | "high";
 /** Fee input accepted by wallet actions: an explicit amount or a named tier. */
 type FeeParam = IntegerType | FeeTier;
 type FungibleComparator = "eq" | "gt" | "gte" | "lt" | "lte";
-type NonFungibleComparator = "sent" | "not-sent";
+type NonFungibleComparator = "sent" | "not-sent" | "maybe-sent";
 type StxPostCondition = {
 	type: "stx-postcondition"
 	address: string
@@ -476,6 +555,9 @@ type PoxPostCondition = {
 	condition: PoxComparator
 };
 type PostCondition = StxPostCondition | FtPostCondition | NftPostCondition | StakingPostCondition | PoxPostCondition;
+/** Serialized PC hex is accepted anywhere a `PostCondition` object is. */
+type PostConditionInput = PostCondition | string;
+type PostConditionMode = "allow" | "deny" | "originator";
 /**
 * Mapped read-return types for the pox-5 contract — the JS shapes
 * `getContract` produces from the ABI (camelCase keys, `uint` → `bigint`,
@@ -523,8 +605,8 @@ declare function pox5ContractId(client: Client): string;
 type TxOptions = {
 	fee?: FeeParam
 	nonce?: IntegerType
-	postConditions?: PostCondition[]
-	postConditionMode?: "allow" | "deny"
+	postConditions?: PostConditionInput[]
+	postConditionMode?: PostConditionMode
 };
 /**
 * One proven L1 timelock output — a Bitcoin SPV inclusion proof of the lockup
@@ -647,6 +729,7 @@ type Pox5Actions = {
 	pox5: {
 		isActive: () => Promise<boolean>
 		getActivation: () => Promise<Pox5Activation | undefined>
+		getPoxInfo: () => Promise<Pox5Info>
 		contractId: () => string
 		getStakerState: (staker: string) => Promise<StakerState>
 		getStakerInfo: (staker: string) => Promise<StakerInfo>
@@ -1593,4 +1676,4 @@ declare const POX5_ABI: {
 		}
 	}]
 };
-export { verifySignerGrant, stakerPreimage, stakerConsensusBuff, signSignerGrant, serializeCScriptNum, rewardCycleToBurnHeight, pushScriptBytes, pushCScriptNum, pox5ContractId, pox5, isPox5Active, isInPreparePhase, getPox5Activation, computeSignerGrantHash, burnHeightToRewardCycle, burnHeightToDistributionIndex, buildLockupScript, buildLockupOutputScript, buildLockupAddress, buildDefaultStakerUnlockBytes, bondUnlockCycle, bondPhaseAtHeight, bondPeriodToRewardCycle, bondPeriodToBurnHeight, assertPox5Active, UpdateBondRegistrationParams, UnstakeSbtcParams, UnstakeParams, StakerState, StakeUpdateParams, StakeParams, SignerGrantOptions, SetupBondParams, RevokeSignerGrantParams, RegisterForBondParams, PoxCycleParams, Pox5EventTopic, Pox5Activation, Pox5Actions, POX5_SIGNER_DOMAIN, POX5_EVENT_TOPICS, POX5_CONTRACT_NAME, POX5_CONTRACT_ID_MAINNET, POX5_ACTIVATION_BURN_HEIGHT_MAINNET, POX5_ABI, MAX_NUM_CYCLES, L1LockupOutput, GrantSignerKeyParams, ClaimStakerRewardsForSignerParams, ClaimRewardsParams, CalculateRewardsParams, C_SCRIPT_NUM_MAX, BuildLockupScriptOptions, BtcLockup, BondPhase, BondCycleParams, BOND_LENGTH_CYCLES, BOND_GAP_CYCLES, BITCOIN_LOCKTIME_THRESHOLD, AnnounceL1EarlyExitParams };
+export { verifySignerGrant, stakerPreimage, stakerConsensusBuff, signSignerGrant, serializeCScriptNum, rewardCycleToBurnHeight, pushScriptBytes, pushCScriptNum, pox5ContractId, pox5, parsePox5Error, isPox5Active, isInPreparePhase, getPoxInfo2 as getPoxInfo, getPox5Activation, describePox5Error, computeSignerGrantHash, burnHeightToRewardCycle, burnHeightToDistributionIndex, buildLockupScript, buildLockupOutputScript, buildLockupAddress, buildDefaultStakerUnlockBytes, bondUnlockCycle, bondPhaseAtHeight, bondPeriodToRewardCycle, bondPeriodToBurnHeight, assertPox5Active, UpdateBondRegistrationParams, UnstakeSbtcParams, UnstakeParams, StakerState, StakeUpdateParams, StakeParams, SignerGrantOptions, SetupBondParams, RevokeSignerGrantParams, RegisterForBondParams, PoxCycleParams, Pox5Info, Pox5EventTopic, Pox5ErrorCode, Pox5Activation, Pox5Actions, POX5_SIGNER_DOMAIN, POX5_EVENT_TOPICS, POX5_ERROR_NAMES, POX5_CONTRACT_NAME, POX5_CONTRACT_ID_MAINNET, POX5_ACTIVATION_BURN_HEIGHT_MAINNET, POX5_ABI, MAX_NUM_CYCLES, L1LockupOutput, GrantSignerKeyParams, ClaimStakerRewardsForSignerParams, ClaimRewardsParams, CalculateRewardsParams, C_SCRIPT_NUM_MAX, BuildLockupScriptOptions, BtcLockup, BondPhase, BondCycleParams, BOND_LENGTH_CYCLES, BOND_GAP_CYCLES, BITCOIN_LOCKTIME_THRESHOLD, AnnounceL1EarlyExitParams };

package/dist/src/pox5/index.js

@@ -9,15 +9,19 @@ import {
 } from "../../shared/stacks-5nmz5ad9.js";
 import {
   getContract
-} from "../../shared/stacks-z3vztaz1.js";
+} from "../../shared/stacks-jpt52csy.js";
 import {
   multicall
 } from "../../shared/stacks-2evvn48s.js";
-import"../../shared/stacks-90jcxs98.js";
+import"../../shared/stacks-fb75yew8.js";
 import"../../shared/stacks-27fmgajb.js";
 import"../../shared/stacks-709tra19.js";
 import"../../shared/stacks-4z72akdf.js";
-import"../../shared/stacks-jx146qf1.js";
+import {
+  structuredDataHash
+} from "../../shared/stacks-1arrcd11.js";
+import"../../shared/stacks-hnqt5rz4.js";
+import"../../shared/stacks-w23294am.js";
 import {
   Cl,
   serializeCVBytes
@@ -66,6 +70,23 @@ var C_SCRIPT_NUM_MAX = 549755813888n;
 var BITCOIN_LOCKTIME_THRESHOLD = 500000000n;
 
 // src/pox5/activation.ts
+async function getPoxInfo(client) {
+  const info = await client.request("/v2/pox", {
+    method: "GET"
+  });
+  return {
+    contractId: info.contract_id,
+    currentBurnchainBlockHeight: info.current_burnchain_block_height,
+    firstBurnchainBlockHeight: info.first_burnchain_block_height,
+    sbtcContract: info.pox_5_sbtc_contract,
+    sbtcRegistryContract: info.pox_5_sbtc_registry_contract,
+    contractVersions: (info.contract_versions ?? []).map((v) => ({
+      contractId: v.contract_id,
+      activationBurnchainBlockHeight: v.activation_burnchain_block_height,
+      firstRewardCycleId: v.first_reward_cycle_id
+    }))
+  };
+}
 async function getPox5Activation(client) {
   const info = await client.request("/v2/pox", {
     method: "GET"
@@ -93,6 +114,169 @@ async function assertPox5Active(client) {
     throw new Error("pox-5 is not active on this chain yet (Epoch 4.0 activates at Bitcoin block 960,230 on mainnet, ~2026-07-29). " + "Check getPox5Activation(client) for this network's activation height.");
   }
 }
+// src/pox5/errors.ts
+var Pox5ErrorCode = {
+  Unauthorized: 1,
+  CannotSetupBondTooSoon: 2,
+  CannotSetupBondTooLate: 3,
+  BondAlreadySetup: 4,
+  StakerAlreadyAdded: 5,
+  BondNotFound: 7,
+  InsufficientStx: 8,
+  AlreadyRegistered: 9,
+  TooMuchSats: 10,
+  NotAllowlisted: 11,
+  SignerKeyGrantUsed: 12,
+  InvalidSignatureRecover: 13,
+  InvalidSignaturePubkey: 14,
+  SignerKeyGrantNotFound: 17,
+  AlreadyStaked: 19,
+  InvalidNumCycles: 20,
+  SignerNotFound: 23,
+  InvalidStartBurnHeight: 24,
+  UnauthorizedSignerRegistration: 26,
+  NotStaking: 27,
+  UnstakeInPreparePhase: 28,
+  InvalidBondPeriodOrdering: 29,
+  DistributionAlreadyComputed: 30,
+  BondNotActive: 31,
+  NoClaimableRewards: 32,
+  ActiveBondNotIncluded: 33,
+  NotBondParticipant: 34,
+  CannotAnnounceL1EarlyUnlock: 35,
+  InvalidOldSignerManager: 36,
+  InvalidUnstakeSbtcAmount: 37,
+  CannotUnstakeSbtc: 38,
+  ReadTxOutOfBounds: 39,
+  InvalidBtcHeader: 40,
+  InvalidMerkleProof: 41,
+  InvalidLockupScript: 42,
+  BondAlreadyStarted: 43,
+  UpdateBondSameSigner: 44,
+  InvalidLockupAmount: 45,
+  DuplicateLockupOutpoint: 46,
+  StakeInPreparePhase: 47,
+  RolloverTooEarly: 48,
+  ReentrantCall: 49,
+  L1EarlyExitAlreadyAnnounced: 50,
+  InsufficientReserveBalance: 51,
+  InvalidUnlockHeight: 52,
+  RewardsPaused: 53
+};
+var POX5_ERROR_NAMES = {
+  [Pox5ErrorCode.Unauthorized]: "ERR_UNAUTHORIZED",
+  [Pox5ErrorCode.CannotSetupBondTooSoon]: "ERR_CANNOT_SETUP_BOND_TOO_SOON",
+  [Pox5ErrorCode.CannotSetupBondTooLate]: "ERR_CANNOT_SETUP_BOND_TOO_LATE",
+  [Pox5ErrorCode.BondAlreadySetup]: "ERR_BOND_ALREADY_SETUP",
+  [Pox5ErrorCode.StakerAlreadyAdded]: "ERR_STAKER_ALREADY_ADDED",
+  [Pox5ErrorCode.BondNotFound]: "ERR_BOND_NOT_FOUND",
+  [Pox5ErrorCode.InsufficientStx]: "ERR_INSUFFICIENT_STX",
+  [Pox5ErrorCode.AlreadyRegistered]: "ERR_ALREADY_REGISTERED",
+  [Pox5ErrorCode.TooMuchSats]: "ERR_TOO_MUCH_SATS",
+  [Pox5ErrorCode.NotAllowlisted]: "ERR_NOT_ALLOWLISTED",
+  [Pox5ErrorCode.SignerKeyGrantUsed]: "ERR_SIGNER_KEY_GRANT_USED",
+  [Pox5ErrorCode.InvalidSignatureRecover]: "ERR_INVALID_SIGNATURE_RECOVER",
+  [Pox5ErrorCode.InvalidSignaturePubkey]: "ERR_INVALID_SIGNATURE_PUBKEY",
+  [Pox5ErrorCode.SignerKeyGrantNotFound]: "ERR_SIGNER_KEY_GRANT_NOT_FOUND",
+  [Pox5ErrorCode.AlreadyStaked]: "ERR_ALREADY_STAKED",
+  [Pox5ErrorCode.InvalidNumCycles]: "ERR_INVALID_NUM_CYCLES",
+  [Pox5ErrorCode.SignerNotFound]: "ERR_SIGNER_NOT_FOUND",
+  [Pox5ErrorCode.InvalidStartBurnHeight]: "ERR_INVALID_START_BURN_HEIGHT",
+  [Pox5ErrorCode.UnauthorizedSignerRegistration]: "ERR_UNAUTHORIZED_SIGNER_REGISTRATION",
+  [Pox5ErrorCode.NotStaking]: "ERR_NOT_STAKING",
+  [Pox5ErrorCode.UnstakeInPreparePhase]: "ERR_UNSTAKE_IN_PREPARE_PHASE",
+  [Pox5ErrorCode.InvalidBondPeriodOrdering]: "ERR_INVALID_BOND_PERIOD_ORDERING",
+  [Pox5ErrorCode.DistributionAlreadyComputed]: "ERR_DISTRIBUTION_ALREADY_COMPUTED",
+  [Pox5ErrorCode.BondNotActive]: "ERR_BOND_NOT_ACTIVE",
+  [Pox5ErrorCode.NoClaimableRewards]: "ERR_NO_CLAIMABLE_REWARDS",
+  [Pox5ErrorCode.ActiveBondNotIncluded]: "ERR_ACTIVE_BOND_NOT_INCLUDED",
+  [Pox5ErrorCode.NotBondParticipant]: "ERR_NOT_BOND_PARTICIPANT",
+  [Pox5ErrorCode.CannotAnnounceL1EarlyUnlock]: "ERR_CANNOT_ANNOUNCE_L1_EARLY_UNLOCK",
+  [Pox5ErrorCode.InvalidOldSignerManager]: "ERR_INVALID_OLD_SIGNER_MANAGER",
+  [Pox5ErrorCode.InvalidUnstakeSbtcAmount]: "ERR_INVALID_UNSTAKE_SBTC_AMOUNT",
+  [Pox5ErrorCode.CannotUnstakeSbtc]: "ERR_CANNOT_UNSTAKE_SBTC",
+  [Pox5ErrorCode.ReadTxOutOfBounds]: "ERR_READ_TX_OUT_OF_BOUNDS",
+  [Pox5ErrorCode.InvalidBtcHeader]: "ERR_INVALID_BTC_HEADER",
+  [Pox5ErrorCode.InvalidMerkleProof]: "ERR_INVALID_MERKLE_PROOF",
+  [Pox5ErrorCode.InvalidLockupScript]: "ERR_INVALID_LOCKUP_SCRIPT",
+  [Pox5ErrorCode.BondAlreadyStarted]: "ERR_BOND_ALREADY_STARTED",
+  [Pox5ErrorCode.UpdateBondSameSigner]: "ERR_UPDATE_BOND_SAME_SIGNER",
+  [Pox5ErrorCode.InvalidLockupAmount]: "ERR_INVALID_LOCKUP_AMOUNT",
+  [Pox5ErrorCode.DuplicateLockupOutpoint]: "ERR_DUPLICATE_LOCKUP_OUTPOINT",
+  [Pox5ErrorCode.StakeInPreparePhase]: "ERR_STAKE_IN_PREPARE_PHASE",
+  [Pox5ErrorCode.RolloverTooEarly]: "ERR_ROLLOVER_TOO_EARLY",
+  [Pox5ErrorCode.ReentrantCall]: "ERR_REENTRANT_CALL",
+  [Pox5ErrorCode.L1EarlyExitAlreadyAnnounced]: "ERR_L1_EARLY_EXIT_ALREADY_ANNOUNCED",
+  [Pox5ErrorCode.InsufficientReserveBalance]: "ERR_INSUFFICIENT_RESERVE_BALANCE",
+  [Pox5ErrorCode.InvalidUnlockHeight]: "ERR_INVALID_UNLOCK_HEIGHT",
+  [Pox5ErrorCode.RewardsPaused]: "ERR_REWARDS_PAUSED"
+};
+var POX5_ERROR_DESCRIPTIONS = {
+  [Pox5ErrorCode.Unauthorized]: "Caller is not authorized.",
+  [Pox5ErrorCode.CannotSetupBondTooSoon]: "Bond setup window has not opened.",
+  [Pox5ErrorCode.CannotSetupBondTooLate]: "Bond setup window has closed.",
+  [Pox5ErrorCode.BondAlreadySetup]: "This bond period is already set up.",
+  [Pox5ErrorCode.StakerAlreadyAdded]: "Staker is already on this bond.",
+  [Pox5ErrorCode.BondNotFound]: "No bond at this index.",
+  [Pox5ErrorCode.InsufficientStx]: "Not enough STX for this operation.",
+  [Pox5ErrorCode.AlreadyRegistered]: "Staker already has an overlapping position.",
+  [Pox5ErrorCode.TooMuchSats]: "Sats amount exceeds the allowlist maximum.",
+  [Pox5ErrorCode.NotAllowlisted]: "Principal is not on the bond allowlist.",
+  [Pox5ErrorCode.SignerKeyGrantUsed]: "This signer-key grant was already consumed.",
+  [Pox5ErrorCode.InvalidSignatureRecover]: "Could not recover a public key from the signature.",
+  [Pox5ErrorCode.InvalidSignaturePubkey]: "Recovered public key does not match the signer key.",
+  [Pox5ErrorCode.SignerKeyGrantNotFound]: "No grant found for this signer key.",
+  [Pox5ErrorCode.AlreadyStaked]: "Principal already has an overlapping stake.",
+  [Pox5ErrorCode.InvalidNumCycles]: "Cycle count is outside the allowed range.",
+  [Pox5ErrorCode.SignerNotFound]: "No signer found for this principal.",
+  [Pox5ErrorCode.InvalidStartBurnHeight]: "Start burn height must fall in the current reward cycle.",
+  [Pox5ErrorCode.UnauthorizedSignerRegistration]: "Caller is not authorized to register this signer.",
+  [Pox5ErrorCode.NotStaking]: "Principal is not currently staking.",
+  [Pox5ErrorCode.UnstakeInPreparePhase]: "Unstaking is not allowed in the prepare phase.",
+  [Pox5ErrorCode.InvalidBondPeriodOrdering]: "Bond periods were supplied out of order.",
+  [Pox5ErrorCode.DistributionAlreadyComputed]: "Reward distribution already computed for this period.",
+  [Pox5ErrorCode.BondNotActive]: "Bond is not currently active.",
+  [Pox5ErrorCode.NoClaimableRewards]: "No claimable rewards for this caller.",
+  [Pox5ErrorCode.ActiveBondNotIncluded]: "The currently active bond was not included in the list.",
+  [Pox5ErrorCode.NotBondParticipant]: "Caller is not in a bond.",
+  [Pox5ErrorCode.CannotAnnounceL1EarlyUnlock]: "Early-exit announce is not valid for this membership.",
+  [Pox5ErrorCode.InvalidOldSignerManager]: "old-signer-manager does not match the staker's current signer.",
+  [Pox5ErrorCode.InvalidUnstakeSbtcAmount]: "sBTC unstake amount is invalid.",
+  [Pox5ErrorCode.CannotUnstakeSbtc]: "Bond participant did not stake sBTC.",
+  [Pox5ErrorCode.ReadTxOutOfBounds]: "Lockup proof buffer was truncated.",
+  [Pox5ErrorCode.InvalidBtcHeader]: "Bitcoin header in the lockup proof is invalid.",
+  [Pox5ErrorCode.InvalidMerkleProof]: "Merkle proof in the lockup proof is invalid.",
+  [Pox5ErrorCode.InvalidLockupScript]: "Lockup output script does not match.",
+  [Pox5ErrorCode.BondAlreadyStarted]: "Cannot register after the bond has started.",
+  [Pox5ErrorCode.UpdateBondSameSigner]: "update-bond-registration cannot keep the same signer.",
+  [Pox5ErrorCode.InvalidLockupAmount]: "Lockup output amount does not match sats.",
+  [Pox5ErrorCode.DuplicateLockupOutpoint]: "The same Bitcoin outpoint appeared twice in the lockup list.",
+  [Pox5ErrorCode.StakeInPreparePhase]: "Cannot modify next-cycle stake during the prepare phase.",
+  [Pox5ErrorCode.RolloverTooEarly]: "Bond rollover is too early.",
+  [Pox5ErrorCode.ReentrantCall]: "Reentrant call into pox-5 while a trait call is in flight.",
+  [Pox5ErrorCode.L1EarlyExitAlreadyAnnounced]: "L1 early exit already announced for this bond period.",
+  [Pox5ErrorCode.InsufficientReserveBalance]: "Reserve withdrawal exceeds the balance.",
+  [Pox5ErrorCode.InvalidUnlockHeight]: "Unlock height is below the bond minimum or at/above 500,000,000.",
+  [Pox5ErrorCode.RewardsPaused]: "Signer reward claims are paused."
+};
+function parsePox5Error(result) {
+  if (result == null)
+    return;
+  if (typeof result === "string") {
+    const match = result.trim().match(/^\(err u(\d+)\)$/);
+    return match ? Number(match[1]) : undefined;
+  }
+  if (result.type !== "err")
+    return;
+  return result.value.type === "uint" ? Number(result.value.value) : undefined;
+}
+function describePox5Error(code) {
+  const n = Number(code);
+  const name = POX5_ERROR_NAMES[n];
+  if (!name)
+    return;
+  return { code: n, name, description: POX5_ERROR_DESCRIPTIONS[n] };
+}
 // src/pox5/cycles.ts
 function burnHeightToRewardCycle(burnHeight, params) {
   if (burnHeight < params.firstBurnchainBlockHeight) {
@@ -208,20 +392,19 @@ function buildDefaultStakerUnlockBytes(publicKey) {
 }
 // src/pox5/grants.ts
 import { secp256k1 } from "@noble/curves/secp256k1.js";
-import { sha256 as sha2562 } from "@noble/hashes/sha2.js";
-var SIP018_PREFIX = hexToBytes("534950303138");
 function computeSignerGrantHash(opts) {
-  const domain = serializeCVBytes(Cl.tuple({
-    name: Cl.stringAscii(POX5_SIGNER_DOMAIN.name),
-    version: Cl.stringAscii(POX5_SIGNER_DOMAIN.version),
-    "chain-id": Cl.uint(opts.chainId)
-  }));
-  const message = serializeCVBytes(Cl.tuple({
-    topic: Cl.stringAscii("grant-authorization"),
-    "signer-manager": Cl.principal(opts.signerManager),
-    "auth-id": Cl.uint(opts.authId)
-  }));
-  return sha2562(concatBytes(SIP018_PREFIX, sha2562(domain), sha2562(message)));
+  return structuredDataHash({
+    domain: Cl.tuple({
+      name: Cl.stringAscii(POX5_SIGNER_DOMAIN.name),
+      version: Cl.stringAscii(POX5_SIGNER_DOMAIN.version),
+      "chain-id": Cl.uint(opts.chainId)
+    }),
+    message: Cl.tuple({
+      topic: Cl.stringAscii("grant-authorization"),
+      "signer-manager": Cl.principal(opts.signerManager),
+      "auth-id": Cl.uint(opts.authId)
+    })
+  });
 }
 async function signSignerGrant(account, opts) {
   const vrs = await account.sign(computeSignerGrantHash(opts));
@@ -828,9 +1011,23 @@ function toBytes2(input) {
 function optionalBytes(input) {
   return input === undefined ? null : toBytes2(input);
 }
+var MAX_LOCKUP_OUTPUTS = 10;
+var MAX_LEAF_HASHES = 14;
 function btcLockupArg(lockup) {
   if ("sbtcSats" in lockup)
     return { err: intToBigInt(lockup.sbtcSats) };
+  if (lockup.l1Outputs.length === 0) {
+    throw new Error("registerForBond: l1Outputs is empty — nothing would be locked");
+  }
+  if (lockup.l1Outputs.length > MAX_LOCKUP_OUTPUTS) {
+    throw new Error(`registerForBond: ${lockup.l1Outputs.length} lockup outputs; pox-5 accepts at most ${MAX_LOCKUP_OUTPUTS}`);
+  }
+  for (let i = 0;i < lockup.l1Outputs.length; i++) {
+    const n = lockup.l1Outputs[i]?.leafHashes.length ?? 0;
+    if (n > MAX_LEAF_HASHES) {
+      throw new Error(`registerForBond: output ${i} has ${n} merkle siblings; pox-5 accepts at most ${MAX_LEAF_HASHES}`);
+    }
+  }
   return {
     ok: {
       outputs: lockup.l1Outputs.map((o) => ({
@@ -1067,6 +1264,7 @@ function pox5() {
     pox5: {
       isActive: () => isPox5Active(client),
       getActivation: () => getPox5Activation(client),
+      getPoxInfo: () => getPoxInfo(client),
       contractId: () => pox5ContractId(client),
       getStakerState: (staker) => getStakerState(client, staker),
       getStakerInfo: (staker) => getStakerInfo(client, staker),
@@ -1108,9 +1306,12 @@ export {
   pushCScriptNum,
   pox5ContractId,
   pox5,
+  parsePox5Error,
   isPox5Active,
   isInPreparePhase,
+  getPoxInfo,
   getPox5Activation,
+  describePox5Error,
   computeSignerGrantHash,
   burnHeightToRewardCycle,
   burnHeightToDistributionIndex,
@@ -1123,8 +1324,10 @@ export {
   bondPeriodToRewardCycle,
   bondPeriodToBurnHeight,
   assertPox5Active,
+  Pox5ErrorCode,
   POX5_SIGNER_DOMAIN,
   POX5_EVENT_TOPICS,
+  POX5_ERROR_NAMES,
   POX5_CONTRACT_NAME,
   POX5_CONTRACT_ID_MAINNET,
   POX5_ACTIVATION_BURN_HEIGHT_MAINNET,
@@ -1136,5 +1339,5 @@ export {
   BITCOIN_LOCKTIME_THRESHOLD
 };
 
-//# debugId=204443BAA918DCBD64756E2164756E21
+//# debugId=A1DC6FC93AED92D864756E2164756E21
 //# sourceMappingURL=index.js.map