@secondlayer/stacks 2.12.0 → 2.14.0

package/dist/src/accounts/index.d.cts

@@ -41,7 +41,29 @@ declare function mnemonicToAccount(mnemonic: string, options?: {
 	accountIndex?: number
 	addressVersion?: number
 }): LocalAccount;
+type BitcoinNetwork = "mainnet" | "testnet" | "regtest";
+type BitcoinKeyType = "p2wpkh" | "p2tr";
+type MnemonicToBitcoinKeysOptions = {
+	/** `'p2wpkh'` (BIP84, `bc1q…`) or `'p2tr'` (BIP86, `bc1p…`). */
+	type: BitcoinKeyType
+	network?: BitcoinNetwork
+	accountIndex?: number
+	/** 0 = receive chain, 1 = change chain. */
+	changeIndex?: number
+	addressIndex?: number
+};
+type BitcoinKeys = {
+	/** 32-byte private key, hex. */
+	privateKey: string
+	/** 33-byte compressed public key, hex. */
+	publicKey: string
+	address: string
+	/** Full BIP84/BIP86 derivation path. */
+	path: string
+};
+/**\\n* Derive Bitcoin keys + address from the same mnemonic that backs a Stacks\\n* account — BIP84 (native segwit) or BIP86 (taproot) paths, matching what\\n* Leather/Xverse derive for the paired BTC account. Pure derivation: no\\n* Bitcoin transaction building or signing.\\n*\\n* @example\\n* const btc = mnemonicToBitcoinKeys(mnemonic, { type: "p2tr" });\\n* btc.address; // bc1p…\\n* btc.path;    // m/86'/0'/0'/0/0\\n*/
+declare function mnemonicToBitcoinKeys(mnemonic: string, options: MnemonicToBitcoinKeysOptions): BitcoinKeys;
 declare function toAccount(source: AccountSource): CustomAccount;
 /** Create a ProviderAccount by querying the wallet for addresses */
 declare function providerToAccount(provider: StacksProvider): Promise<ProviderAccount>;
-export { toAccount, providerToAccount, privateKeyToAccount, mnemonicToAccount, compressPrivateKey, StacksProvider, ProviderAccount, LocalAccount, CustomAccount, AccountSource };
+export { toAccount, providerToAccount, privateKeyToAccount, mnemonicToBitcoinKeys, mnemonicToAccount, compressPrivateKey, StacksProvider, ProviderAccount, MnemonicToBitcoinKeysOptions, LocalAccount, CustomAccount, BitcoinKeys, BitcoinKeyType, AccountSource };

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

@@ -41,7 +41,29 @@ declare function mnemonicToAccount(mnemonic: string, options?: {
 	accountIndex?: number
 	addressVersion?: number
 }): LocalAccount;
+type BitcoinNetwork = "mainnet" | "testnet" | "regtest";
+type BitcoinKeyType = "p2wpkh" | "p2tr";
+type MnemonicToBitcoinKeysOptions = {
+	/** `'p2wpkh'` (BIP84, `bc1q…`) or `'p2tr'` (BIP86, `bc1p…`). */
+	type: BitcoinKeyType
+	network?: BitcoinNetwork
+	accountIndex?: number
+	/** 0 = receive chain, 1 = change chain. */
+	changeIndex?: number
+	addressIndex?: number
+};
+type BitcoinKeys = {
+	/** 32-byte private key, hex. */
+	privateKey: string
+	/** 33-byte compressed public key, hex. */
+	publicKey: string
+	address: string
+	/** Full BIP84/BIP86 derivation path. */
+	path: string
+};
+/**\\n* Derive Bitcoin keys + address from the same mnemonic that backs a Stacks\\n* account — BIP84 (native segwit) or BIP86 (taproot) paths, matching what\\n* Leather/Xverse derive for the paired BTC account. Pure derivation: no\\n* Bitcoin transaction building or signing.\\n*\\n* @example\\n* const btc = mnemonicToBitcoinKeys(mnemonic, { type: "p2tr" });\\n* btc.address; // bc1p…\\n* btc.path;    // m/86'/0'/0'/0/0\\n*/
+declare function mnemonicToBitcoinKeys(mnemonic: string, options: MnemonicToBitcoinKeysOptions): BitcoinKeys;
 declare function toAccount(source: AccountSource): CustomAccount;
 /** Create a ProviderAccount by querying the wallet for addresses */
 declare function providerToAccount(provider: StacksProvider): Promise<ProviderAccount>;
-export { toAccount, providerToAccount, privateKeyToAccount, mnemonicToAccount, compressPrivateKey, StacksProvider, ProviderAccount, LocalAccount, CustomAccount, AccountSource };
+export { toAccount, providerToAccount, privateKeyToAccount, mnemonicToBitcoinKeys, mnemonicToAccount, compressPrivateKey, StacksProvider, ProviderAccount, MnemonicToBitcoinKeysOptions, LocalAccount, CustomAccount, BitcoinKeys, BitcoinKeyType, AccountSource };

package/dist/src/accounts/index.js

@@ -1,3 +1,8 @@
+import {
+  publicKeyToP2trAddress,
+  publicKeyToP2wpkhAddress
+} from "../../shared/stacks-0cdm20eh.js";
+import"../../shared/stacks-5nmz5ad9.js";
 import {
   providerToAccount
 } from "../../shared/stacks-qcae5852.js";
@@ -78,6 +83,32 @@ function mnemonicToAccount(mnemonic, options) {
   const privateKeyHex = compressPrivateKey(bytesToHex(child.privateKey));
   return privateKeyToAccount(privateKeyHex, { addressVersion });
 }
+// src/accounts/mnemonicToBitcoinKeys.ts
+import { HDKey as HDKey2 } from "@scure/bip32";
+import { mnemonicToSeedSync as mnemonicToSeedSync2 } from "@scure/bip39";
+var PURPOSE = { p2wpkh: 84, p2tr: 86 };
+function mnemonicToBitcoinKeys(mnemonic, options) {
+  const {
+    type,
+    network = "mainnet",
+    accountIndex = 0,
+    changeIndex = 0,
+    addressIndex = 0
+  } = options;
+  const coinType = network === "mainnet" ? 0 : 1;
+  const path = `m/${PURPOSE[type]}'/${coinType}'/${accountIndex}'/${changeIndex}/${addressIndex}`;
+  const seed = mnemonicToSeedSync2(mnemonic);
+  const child = HDKey2.fromMasterSeed(seed).derive(path);
+  if (!child.privateKey || !child.publicKey)
+    throw new Error("Failed to derive Bitcoin key");
+  const address = type === "p2wpkh" ? publicKeyToP2wpkhAddress(child.publicKey, network) : publicKeyToP2trAddress(child.publicKey, network);
+  return {
+    privateKey: bytesToHex(child.privateKey),
+    publicKey: bytesToHex(child.publicKey),
+    address,
+    path
+  };
+}
 // src/accounts/toAccount.ts
 function toAccount(source) {
   return {
@@ -91,9 +122,10 @@ export {
   toAccount,
   providerToAccount,
   privateKeyToAccount,
+  mnemonicToBitcoinKeys,
   mnemonicToAccount,
   compressPrivateKey
 };
 
-//# debugId=AE3E7159A40E2C1E64756E2164756E21
+//# debugId=D63669131B82ABCA64756E2164756E21
 //# sourceMappingURL=index.js.map

package/dist/src/accounts/index.js.map

@@ -1,12 +1,13 @@
 {
   "version": 3,
-  "sources": ["../src/accounts/privateKeyToAccount.ts", "../src/accounts/mnemonicToAccount.ts", "../src/accounts/toAccount.ts"],
+  "sources": ["../src/accounts/privateKeyToAccount.ts", "../src/accounts/mnemonicToAccount.ts", "../src/accounts/mnemonicToBitcoinKeys.ts", "../src/accounts/toAccount.ts"],
   "sourcesContent": [
     "import { hmac } from \"@noble/hashes/hmac.js\";\nimport { sha256 } from \"@noble/hashes/sha2.js\";\nimport { etc, getPublicKey as nobleGetPublicKey, sign } from \"@noble/secp256k1\";\nimport { c32address } from \"../utils/c32.ts\";\nimport { bytesToHex, hexToBytes, without0x } from \"../utils/encoding.ts\";\nimport { hash160 } from \"../utils/hash.ts\";\nimport type { LocalAccount } from \"./types.ts\";\n\nfunction ensureSyncSigning() {\n\tif (!etc.hmacSha256Sync) {\n\t\tetc.hmacSha256Sync = (key: Uint8Array, ...msgs: Uint8Array[]) => {\n\t\t\tconst h = hmac.create(sha256, key);\n\t\t\tfor (const msg of msgs) h.update(msg);\n\t\t\treturn h.digest();\n\t\t};\n\t}\n}\n\nconst PRIVATE_KEY_COMPRESSED_LENGTH = 33;\n\nexport function privateKeyToAccount(\n\tprivateKey: string | Uint8Array,\n\toptions?: { addressVersion?: number },\n): LocalAccount {\n\tensureSyncSigning();\n\tconst keyBytes = normalizePrivateKey(privateKey);\n\tconst rawKey = keyBytes.slice(0, 32);\n\n\t// Always derive compressed public key\n\tconst publicKeyBytes = nobleGetPublicKey(rawKey, true);\n\tconst publicKeyHex = bytesToHex(publicKeyBytes);\n\n\t// Default to mainnet single-sig (22)\n\tconst addressVersion = options?.addressVersion ?? 22;\n\tconst address = c32address(\n\t\taddressVersion,\n\t\tbytesToHex(hash160(publicKeyBytes)),\n\t);\n\n\treturn {\n\t\ttype: \"local\",\n\t\taddress,\n\t\tpublicKey: publicKeyHex,\n\n\t\tsign(hash: Uint8Array): Uint8Array {\n\t\t\tconst sig = sign(hash, rawKey, { lowS: true });\n\t\t\tconst result = new Uint8Array(65);\n\t\t\tresult[0] = sig.recovery;\n\t\t\tresult.set(sig.toCompactRawBytes(), 1);\n\t\t\treturn result;\n\t\t},\n\n\t\tsignMessage(message: string | Uint8Array): string {\n\t\t\tconst msgBytes =\n\t\t\t\ttypeof message === \"string\"\n\t\t\t\t\t? new TextEncoder().encode(message)\n\t\t\t\t\t: message;\n\t\t\tconst msgHash = sha256(msgBytes);\n\t\t\tconst sigBytes = this.sign(msgHash);\n\t\t\treturn bytesToHex(sigBytes);\n\t\t},\n\t};\n}\n\nfunction normalizePrivateKey(key: string | Uint8Array): Uint8Array {\n\tif (typeof key === \"string\") {\n\t\treturn hexToBytes(without0x(key));\n\t}\n\treturn key;\n}\n\n/** Append 0x01 suffix if not already compressed */\nexport function compressPrivateKey(key: string | Uint8Array): string {\n\tconst hex = typeof key === \"string\" ? without0x(key) : bytesToHex(key);\n\tif (hex.length === PRIVATE_KEY_COMPRESSED_LENGTH * 2) return hex;\n\treturn `${hex}01`;\n}\n",
     "import { HDKey } from \"@scure/bip32\";\nimport { mnemonicToSeedSync } from \"@scure/bip39\";\nimport { bytesToHex } from \"../utils/encoding.ts\";\nimport {\n\tcompressPrivateKey,\n\tprivateKeyToAccount,\n} from \"./privateKeyToAccount.ts\";\nimport type { LocalAccount } from \"./types.ts\";\n\nconst STX_DERIVATION_PATH = \"m/44'/5757'/0'/0\";\n\nexport function mnemonicToAccount(\n\tmnemonic: string,\n\toptions?: {\n\t\taccountIndex?: number;\n\t\taddressVersion?: number;\n\t},\n): LocalAccount {\n\tconst { accountIndex = 0, addressVersion } = options ?? {};\n\n\tconst seed = mnemonicToSeedSync(mnemonic);\n\tconst root = HDKey.fromMasterSeed(seed);\n\tconst child = root.derive(`${STX_DERIVATION_PATH}/${accountIndex}`);\n\n\tif (!child.privateKey) throw new Error(\"Failed to derive private key\");\n\n\tconst privateKeyHex = compressPrivateKey(bytesToHex(child.privateKey));\n\treturn privateKeyToAccount(privateKeyHex, { addressVersion });\n}\n",
+    "import { HDKey } from \"@scure/bip32\";\nimport { mnemonicToSeedSync } from \"@scure/bip39\";\nimport {\n\tpublicKeyToP2trAddress,\n\tpublicKeyToP2wpkhAddress,\n} from \"../bitcoin/address.ts\";\nimport type { BitcoinNetwork } from \"../bitcoin/constants.ts\";\nimport { bytesToHex } from \"../utils/encoding.ts\";\n\nexport type BitcoinKeyType = \"p2wpkh\" | \"p2tr\";\n\nexport type MnemonicToBitcoinKeysOptions = {\n\t/** `'p2wpkh'` (BIP84, `bc1q…`) or `'p2tr'` (BIP86, `bc1p…`). */\n\ttype: BitcoinKeyType;\n\tnetwork?: BitcoinNetwork;\n\taccountIndex?: number;\n\t/** 0 = receive chain, 1 = change chain. */\n\tchangeIndex?: number;\n\taddressIndex?: number;\n};\n\nexport type BitcoinKeys = {\n\t/** 32-byte private key, hex. */\n\tprivateKey: string;\n\t/** 33-byte compressed public key, hex. */\n\tpublicKey: string;\n\taddress: string;\n\t/** Full BIP84/BIP86 derivation path. */\n\tpath: string;\n};\n\nconst PURPOSE: Record<BitcoinKeyType, number> = { p2wpkh: 84, p2tr: 86 };\n\n/**\n * Derive Bitcoin keys + address from the same mnemonic that backs a Stacks\n * account — BIP84 (native segwit) or BIP86 (taproot) paths, matching what\n * Leather/Xverse derive for the paired BTC account. Pure derivation: no\n * Bitcoin transaction building or signing.\n *\n * @example\n * const btc = mnemonicToBitcoinKeys(mnemonic, { type: \"p2tr\" });\n * btc.address; // bc1p…\n * btc.path;    // m/86'/0'/0'/0/0\n */\nexport function mnemonicToBitcoinKeys(\n\tmnemonic: string,\n\toptions: MnemonicToBitcoinKeysOptions,\n): BitcoinKeys {\n\tconst {\n\t\ttype,\n\t\tnetwork = \"mainnet\",\n\t\taccountIndex = 0,\n\t\tchangeIndex = 0,\n\t\taddressIndex = 0,\n\t} = options;\n\n\t// BIP44 coin type: 0' mainnet, 1' testnet/regtest.\n\tconst coinType = network === \"mainnet\" ? 0 : 1;\n\tconst path = `m/${PURPOSE[type]}'/${coinType}'/${accountIndex}'/${changeIndex}/${addressIndex}`;\n\n\tconst seed = mnemonicToSeedSync(mnemonic);\n\tconst child = HDKey.fromMasterSeed(seed).derive(path);\n\tif (!child.privateKey || !child.publicKey)\n\t\tthrow new Error(\"Failed to derive Bitcoin key\");\n\n\tconst address =\n\t\ttype === \"p2wpkh\"\n\t\t\t? publicKeyToP2wpkhAddress(child.publicKey, network)\n\t\t\t: publicKeyToP2trAddress(child.publicKey, network);\n\n\treturn {\n\t\tprivateKey: bytesToHex(child.privateKey),\n\t\tpublicKey: bytesToHex(child.publicKey),\n\t\taddress,\n\t\tpath,\n\t};\n}\n",
     "import type { AccountSource, CustomAccount } from \"./types.ts\";\n\nexport function toAccount(source: AccountSource): CustomAccount {\n\treturn {\n\t\ttype: \"custom\",\n\t\taddress: source.address,\n\t\tpublicKey: source.publicKey,\n\t\tsign: source.sign,\n\t};\n}\n"
   ],
-  "mappings": ";;;;;;;;;;;;;AAAA;AACA;AACA,8BAAc;AAMd,SAAS,iBAAiB,GAAG;AAAA,EAC5B,IAAI,CAAC,IAAI,gBAAgB;AAAA,IACxB,IAAI,iBAAiB,CAAC,QAAoB,SAAuB;AAAA,MAChE,MAAM,IAAI,KAAK,OAAO,QAAQ,GAAG;AAAA,MACjC,WAAW,OAAO;AAAA,QAAM,EAAE,OAAO,GAAG;AAAA,MACpC,OAAO,EAAE,OAAO;AAAA;AAAA,EAElB;AAAA;AAGD,IAAM,gCAAgC;AAE/B,SAAS,mBAAmB,CAClC,YACA,SACe;AAAA,EACf,kBAAkB;AAAA,EAClB,MAAM,WAAW,oBAAoB,UAAU;AAAA,EAC/C,MAAM,SAAS,SAAS,MAAM,GAAG,EAAE;AAAA,EAGnC,MAAM,iBAAiB,kBAAkB,QAAQ,IAAI;AAAA,EACrD,MAAM,eAAe,WAAW,cAAc;AAAA,EAG9C,MAAM,iBAAiB,SAAS,kBAAkB;AAAA,EAClD,MAAM,UAAU,WACf,gBACA,WAAW,QAAQ,cAAc,CAAC,CACnC;AAAA,EAEA,OAAO;AAAA,IACN,MAAM;AAAA,IACN;AAAA,IACA,WAAW;AAAA,IAEX,IAAI,CAAC,MAA8B;AAAA,MAClC,MAAM,MAAM,KAAK,MAAM,QAAQ,EAAE,MAAM,KAAK,CAAC;AAAA,MAC7C,MAAM,SAAS,IAAI,WAAW,EAAE;AAAA,MAChC,OAAO,KAAK,IAAI;AAAA,MAChB,OAAO,IAAI,IAAI,kBAAkB,GAAG,CAAC;AAAA,MACrC,OAAO;AAAA;AAAA,IAGR,WAAW,CAAC,SAAsC;AAAA,MACjD,MAAM,WACL,OAAO,YAAY,WAChB,IAAI,YAAY,EAAE,OAAO,OAAO,IAChC;AAAA,MACJ,MAAM,UAAU,OAAO,QAAQ;AAAA,MAC/B,MAAM,WAAW,KAAK,KAAK,OAAO;AAAA,MAClC,OAAO,WAAW,QAAQ;AAAA;AAAA,EAE5B;AAAA;AAGD,SAAS,mBAAmB,CAAC,KAAsC;AAAA,EAClE,IAAI,OAAO,QAAQ,UAAU;AAAA,IAC5B,OAAO,WAAW,UAAU,GAAG,CAAC;AAAA,EACjC;AAAA,EACA,OAAO;AAAA;AAID,SAAS,kBAAkB,CAAC,KAAkC;AAAA,EACpE,MAAM,MAAM,OAAO,QAAQ,WAAW,UAAU,GAAG,IAAI,WAAW,GAAG;AAAA,EACrE,IAAI,IAAI,WAAW,gCAAgC;AAAA,IAAG,OAAO;AAAA,EAC7D,OAAO,GAAG;AAAA;;AC3EX;AACA;AAQA,IAAM,sBAAsB;AAErB,SAAS,iBAAiB,CAChC,UACA,SAIe;AAAA,EACf,QAAQ,eAAe,GAAG,mBAAmB,WAAW,CAAC;AAAA,EAEzD,MAAM,OAAO,mBAAmB,QAAQ;AAAA,EACxC,MAAM,OAAO,MAAM,eAAe,IAAI;AAAA,EACtC,MAAM,QAAQ,KAAK,OAAO,GAAG,uBAAuB,cAAc;AAAA,EAElE,IAAI,CAAC,MAAM;AAAA,IAAY,MAAM,IAAI,MAAM,8BAA8B;AAAA,EAErE,MAAM,gBAAgB,mBAAmB,WAAW,MAAM,UAAU,CAAC;AAAA,EACrE,OAAO,oBAAoB,eAAe,EAAE,eAAe,CAAC;AAAA;;ACzBtD,SAAS,SAAS,CAAC,QAAsC;AAAA,EAC/D,OAAO;AAAA,IACN,MAAM;AAAA,IACN,SAAS,OAAO;AAAA,IAChB,WAAW,OAAO;AAAA,IAClB,MAAM,OAAO;AAAA,EACd;AAAA;",
-  "debugId": "AE3E7159A40E2C1E64756E2164756E21",
+  "mappings": "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",
+  "debugId": "D63669131B82ABCA64756E2164756E21",
   "names": []
 }

package/dist/src/actions/index.cjs

@@ -23,14 +23,19 @@ __export(exports_actions, {
   isFeeTier: () => isFeeTier,
   indexTxSource: () => indexTxSource,
   getTransaction: () => getTransaction,
+  getRawBlock: () => getRawBlock,
   getNonce: () => getNonce,
+  getNftHoldings: () => getNftHoldings,
+  getMempoolStats: () => getMempoolStats,
   getMapEntry: () => getMapEntry,
+  getContractSource: () => getContractSource,
   getContractAbi: () => getContractAbi,
   getContract: () => getContract,
   getBlockHeight: () => getBlockHeight,
   getBlock: () => getBlock,
   getBalance: () => getBalance,
   getAccountInfo: () => getAccountInfo,
+  getAccountHistory: () => getAccountHistory,
   extendedApiSource: () => extendedApiSource,
   estimateFee: () => estimateFee,
   deployContract: () => deployContract,
@@ -39,5 +44,5 @@ __export(exports_actions, {
 });
 module.exports = __toCommonJS(exports_actions);
 
-//# debugId=38538D184946FE2164756E2164756E21
+//# debugId=096C166E216C663864756E2164756E21
 //# sourceMappingURL=index.cjs.map

package/dist/src/actions/index.cjs.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "38538D184946FE2164756E2164756E21",
+  "debugId": "096C166E216C663864756E2164756E21",
   "names": []
 }

package/dist/src/actions/index.d.cts

@@ -415,6 +415,34 @@ type GetBlockParams = {
 	hash?: string
 };
 declare function getBlock(client: Client, params?: GetBlockParams): Promise<any>;
+type GetRawBlockParams = {
+	height: number
+};
+/**
+* Raw node RPC block shape (`/v2/blocks/{height}`) — distinct from
+* {@link getBlock}'s Hiro extended-API shape. Carries consensus/identity
+* fields (`index_block_hash`, `miner_txid`, ...) that the indexed API doesn't
+* expose, for trust-minimized use cases (e.g. block-header proofs) that can't
+* rely on a third-party indexer.
+*/
+type RawBlockResponse = {
+	hash: string
+	height: number
+	parent_block_hash: string
+	burn_block_height: number
+	burn_block_hash: string
+	burn_block_time: number
+	index_block_hash: string
+	parent_index_block_hash: string
+	miner_txid: string
+	txs: string[]
+};
+/**
+* Fetch a block by height directly from a stacks-node (not Hiro's extended
+* API — see {@link getBlock} for that). Returns `null` when the node has no
+* block at that height.
+*/
+declare function getRawBlock(client: Client, params: GetRawBlockParams): Promise<RawBlockResponse | null>;
 declare function getBlockHeight(client: Client): Promise<number>;
 type ReadContractParams = {
 	contract: string
@@ -427,6 +455,21 @@ type GetContractAbiParams = {
 	contract: string
 };
 declare function getContractAbi(client: Client, params: GetContractAbiParams): Promise<any>;
+type GetContractSourceParams = {
+	contract: string
+};
+type ContractSourceResponse = {
+	source: string
+	publish_height: number
+	marf_proof?: string
+};
+/**
+* Fetch a deployed contract's Clarity source. Node-RPC only (`/v2/contracts/source`)
+* — not available through Hiro's extended API or a tenant proxy, so `client`
+* must be configured against a direct node transport. Returns `null` when the
+* node has no source for the contract.
+*/
+declare function getContractSource(client: Client, params: GetContractSourceParams): Promise<ContractSourceResponse | null>;
 type GetMapEntryParams = {
 	contract: string
 	mapName: string
@@ -594,6 +637,33 @@ type GetTransactionParams = {
 * Returns `null` when the source has no record of the transaction.
 */
 declare function getTransaction(client: Client, params: GetTransactionParams): Promise<TransactionReceipt | null>;
+type GetAccountHistoryParams = {
+	address: string
+	/** Capped at 50. Default 20. */
+	limit?: number
+};
+type AccountHistoryResponse = {
+	results: unknown[]
+	total: number
+};
+/** Paginated transaction history for a principal (Hiro extended API). */
+declare function getAccountHistory(client: Client, params: GetAccountHistoryParams): Promise<AccountHistoryResponse>;
+/**
+* Current mempool statistics: pending count, fee distribution, age buckets
+* (Hiro extended API).
+*/
+declare function getMempoolStats(client: Client): Promise<any>;
+type GetNftHoldingsParams = {
+	address: string
+	/** Capped at 50. Default 20. */
+	limit?: number
+};
+type NftHoldingsResponse = {
+	results: unknown[]
+	total: number
+};
+/** NFT holdings for a principal across all collections (Hiro extended API). */
+declare function getNftHoldings(client: Client, params: GetNftHoldingsParams): Promise<NftHoldingsResponse>;
 type WaitForTransactionReceiptParams = {
 	txid: string
 	/** Anchor-block confirmations to wait for. Default 1 (mined). */
@@ -1162,4 +1232,4 @@ declare class ContractResponseError extends Error {
 	name: string;
 	constructor(message: string, errorValue: unknown);
 }
-export { watchTransaction, watchNftEvent, watchMempool, watchBlocks, watchAddressBalance, watchAddress, waitForTransactionReceipt, transferStx, sponsorTransaction, simulateTransaction, simulateCall, signTransactionAction, signMessage2 as signMessage, sendTransaction, resolveFee, readContract, multicall, minimumFee, isProviderAccount, isFeeTier, indexTxSource, getTransaction, getNonce, getMapEntry, getContractAbi, getContract, getBlockHeight, getBlock, getBalance, getAccountInfo, extendedApiSource, estimateFee, deployContract, callContract, WatchTransactionParams, WatchNftEventParams, WatchMempoolParams, WatchBlocksParams, WatchAddressParams, WatchAddressBalanceParams, WaitForTransactionReceiptParams, TransferStxParams, TransactionStatusSource, TransactionStatus, TransactionSnapshot, TransactionReceipt, SponsorTransactionParams, SimulateTransferResult, SimulateTransactionResult, SimulateTransactionParams, SimulateDeployResult, SimulateContractCallResult, SimulateCallSuccess, SimulateCallResult, SimulateCallParams, SimulateCallFailure, SignTransactionParams, SignMessageParams, SendTransactionResult, SendTransactionParams, ReadContractParams, MulticallSuccessResult, MulticallResult, MulticallParams, MulticallFailureResult, MulticallCall, IndexTxSourceParams, GetTransactionParams, GetNonceParams, GetMapEntryParams, GetContractParams, GetContractAbiParams, GetBlockParams, GetBalanceParams, GetAccountInfoParams, FeeTier, FeeParam, FeeEstimation, EstimateFeeParams, DeployContractParams, ContractResponseError, ContractInstance, ContractCallOptions, ContractBuildCallOptions, CallContractParams, AccountInfo };
+export { watchTransaction, watchNftEvent, watchMempool, watchBlocks, watchAddressBalance, watchAddress, waitForTransactionReceipt, transferStx, sponsorTransaction, simulateTransaction, simulateCall, signTransactionAction, signMessage2 as signMessage, sendTransaction, resolveFee, readContract, multicall, minimumFee, isProviderAccount, isFeeTier, indexTxSource, getTransaction, getRawBlock, getNonce, getNftHoldings, getMempoolStats, getMapEntry, getContractSource, getContractAbi, getContract, getBlockHeight, getBlock, getBalance, getAccountInfo, getAccountHistory, extendedApiSource, estimateFee, deployContract, callContract, WatchTransactionParams, WatchNftEventParams, WatchMempoolParams, WatchBlocksParams, WatchAddressParams, WatchAddressBalanceParams, WaitForTransactionReceiptParams, TransferStxParams, TransactionStatusSource, TransactionStatus, TransactionSnapshot, TransactionReceipt, SponsorTransactionParams, SimulateTransferResult, SimulateTransactionResult, SimulateTransactionParams, SimulateDeployResult, SimulateContractCallResult, SimulateCallSuccess, SimulateCallResult, SimulateCallParams, SimulateCallFailure, SignTransactionParams, SignMessageParams, SendTransactionResult, SendTransactionParams, ReadContractParams, RawBlockResponse, NftHoldingsResponse, MulticallSuccessResult, MulticallResult, MulticallParams, MulticallFailureResult, MulticallCall, IndexTxSourceParams, GetTransactionParams, GetRawBlockParams, GetNonceParams, GetNftHoldingsParams, GetMapEntryParams, GetContractSourceParams, GetContractParams, GetContractAbiParams, GetBlockParams, GetBalanceParams, GetAccountInfoParams, GetAccountHistoryParams, FeeTier, FeeParam, FeeEstimation, EstimateFeeParams, DeployContractParams, ContractSourceResponse, ContractResponseError, ContractInstance, ContractCallOptions, ContractBuildCallOptions, CallContractParams, AccountInfo, AccountHistoryResponse };

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

@@ -415,6 +415,34 @@ type GetBlockParams = {
 	hash?: string
 };
 declare function getBlock(client: Client, params?: GetBlockParams): Promise<any>;
+type GetRawBlockParams = {
+	height: number
+};
+/**
+* Raw node RPC block shape (`/v2/blocks/{height}`) — distinct from
+* {@link getBlock}'s Hiro extended-API shape. Carries consensus/identity
+* fields (`index_block_hash`, `miner_txid`, ...) that the indexed API doesn't
+* expose, for trust-minimized use cases (e.g. block-header proofs) that can't
+* rely on a third-party indexer.
+*/
+type RawBlockResponse = {
+	hash: string
+	height: number
+	parent_block_hash: string
+	burn_block_height: number
+	burn_block_hash: string
+	burn_block_time: number
+	index_block_hash: string
+	parent_index_block_hash: string
+	miner_txid: string
+	txs: string[]
+};
+/**
+* Fetch a block by height directly from a stacks-node (not Hiro's extended
+* API — see {@link getBlock} for that). Returns `null` when the node has no
+* block at that height.
+*/
+declare function getRawBlock(client: Client, params: GetRawBlockParams): Promise<RawBlockResponse | null>;
 declare function getBlockHeight(client: Client): Promise<number>;
 type ReadContractParams = {
 	contract: string
@@ -427,6 +455,21 @@ type GetContractAbiParams = {
 	contract: string
 };
 declare function getContractAbi(client: Client, params: GetContractAbiParams): Promise<any>;
+type GetContractSourceParams = {
+	contract: string
+};
+type ContractSourceResponse = {
+	source: string
+	publish_height: number
+	marf_proof?: string
+};
+/**
+* Fetch a deployed contract's Clarity source. Node-RPC only (`/v2/contracts/source`)
+* — not available through Hiro's extended API or a tenant proxy, so `client`
+* must be configured against a direct node transport. Returns `null` when the
+* node has no source for the contract.
+*/
+declare function getContractSource(client: Client, params: GetContractSourceParams): Promise<ContractSourceResponse | null>;
 type GetMapEntryParams = {
 	contract: string
 	mapName: string
@@ -594,6 +637,33 @@ type GetTransactionParams = {
 * Returns `null` when the source has no record of the transaction.
 */
 declare function getTransaction(client: Client, params: GetTransactionParams): Promise<TransactionReceipt | null>;
+type GetAccountHistoryParams = {
+	address: string
+	/** Capped at 50. Default 20. */
+	limit?: number
+};
+type AccountHistoryResponse = {
+	results: unknown[]
+	total: number
+};
+/** Paginated transaction history for a principal (Hiro extended API). */
+declare function getAccountHistory(client: Client, params: GetAccountHistoryParams): Promise<AccountHistoryResponse>;
+/**
+* Current mempool statistics: pending count, fee distribution, age buckets
+* (Hiro extended API).
+*/
+declare function getMempoolStats(client: Client): Promise<any>;
+type GetNftHoldingsParams = {
+	address: string
+	/** Capped at 50. Default 20. */
+	limit?: number
+};
+type NftHoldingsResponse = {
+	results: unknown[]
+	total: number
+};
+/** NFT holdings for a principal across all collections (Hiro extended API). */
+declare function getNftHoldings(client: Client, params: GetNftHoldingsParams): Promise<NftHoldingsResponse>;
 type WaitForTransactionReceiptParams = {
 	txid: string
 	/** Anchor-block confirmations to wait for. Default 1 (mined). */
@@ -1162,4 +1232,4 @@ declare class ContractResponseError extends Error {
 	name: string;
 	constructor(message: string, errorValue: unknown);
 }
-export { watchTransaction, watchNftEvent, watchMempool, watchBlocks, watchAddressBalance, watchAddress, waitForTransactionReceipt, transferStx, sponsorTransaction, simulateTransaction, simulateCall, signTransactionAction, signMessage2 as signMessage, sendTransaction, resolveFee, readContract, multicall, minimumFee, isProviderAccount, isFeeTier, indexTxSource, getTransaction, getNonce, getMapEntry, getContractAbi, getContract, getBlockHeight, getBlock, getBalance, getAccountInfo, extendedApiSource, estimateFee, deployContract, callContract, WatchTransactionParams, WatchNftEventParams, WatchMempoolParams, WatchBlocksParams, WatchAddressParams, WatchAddressBalanceParams, WaitForTransactionReceiptParams, TransferStxParams, TransactionStatusSource, TransactionStatus, TransactionSnapshot, TransactionReceipt, SponsorTransactionParams, SimulateTransferResult, SimulateTransactionResult, SimulateTransactionParams, SimulateDeployResult, SimulateContractCallResult, SimulateCallSuccess, SimulateCallResult, SimulateCallParams, SimulateCallFailure, SignTransactionParams, SignMessageParams, SendTransactionResult, SendTransactionParams, ReadContractParams, MulticallSuccessResult, MulticallResult, MulticallParams, MulticallFailureResult, MulticallCall, IndexTxSourceParams, GetTransactionParams, GetNonceParams, GetMapEntryParams, GetContractParams, GetContractAbiParams, GetBlockParams, GetBalanceParams, GetAccountInfoParams, FeeTier, FeeParam, FeeEstimation, EstimateFeeParams, DeployContractParams, ContractResponseError, ContractInstance, ContractCallOptions, ContractBuildCallOptions, CallContractParams, AccountInfo };
+export { watchTransaction, watchNftEvent, watchMempool, watchBlocks, watchAddressBalance, watchAddress, waitForTransactionReceipt, transferStx, sponsorTransaction, simulateTransaction, simulateCall, signTransactionAction, signMessage2 as signMessage, sendTransaction, resolveFee, readContract, multicall, minimumFee, isProviderAccount, isFeeTier, indexTxSource, getTransaction, getRawBlock, getNonce, getNftHoldings, getMempoolStats, getMapEntry, getContractSource, getContractAbi, getContract, getBlockHeight, getBlock, getBalance, getAccountInfo, getAccountHistory, extendedApiSource, estimateFee, deployContract, callContract, WatchTransactionParams, WatchNftEventParams, WatchMempoolParams, WatchBlocksParams, WatchAddressParams, WatchAddressBalanceParams, WaitForTransactionReceiptParams, TransferStxParams, TransactionStatusSource, TransactionStatus, TransactionSnapshot, TransactionReceipt, SponsorTransactionParams, SimulateTransferResult, SimulateTransactionResult, SimulateTransactionParams, SimulateDeployResult, SimulateContractCallResult, SimulateCallSuccess, SimulateCallResult, SimulateCallParams, SimulateCallFailure, SignTransactionParams, SignMessageParams, SendTransactionResult, SendTransactionParams, ReadContractParams, RawBlockResponse, NftHoldingsResponse, MulticallSuccessResult, MulticallResult, MulticallParams, MulticallFailureResult, MulticallCall, IndexTxSourceParams, GetTransactionParams, GetRawBlockParams, GetNonceParams, GetNftHoldingsParams, GetMapEntryParams, GetContractSourceParams, GetContractParams, GetContractAbiParams, GetBlockParams, GetBalanceParams, GetAccountInfoParams, GetAccountHistoryParams, FeeTier, FeeParam, FeeEstimation, EstimateFeeParams, DeployContractParams, ContractSourceResponse, ContractResponseError, ContractInstance, ContractCallOptions, ContractBuildCallOptions, CallContractParams, AccountInfo, AccountHistoryResponse };

package/dist/src/actions/index.js

@@ -1,13 +1,18 @@
 import {
   ContractResponseError,
   getContract
-} from "../../shared/stacks-6n2m9hyk.js";
+} from "../../shared/stacks-zzbkta7h.js";
 import {
   deployContract,
+  getAccountHistory,
   getAccountInfo,
   getBalance,
   getBlock,
   getContractAbi,
+  getContractSource,
+  getMempoolStats,
+  getNftHoldings,
+  getRawBlock,
   getTransaction,
   multicall,
   signMessage,
@@ -15,11 +20,11 @@ import {
   simulateCall,
   simulateTransaction,
   transferStx
-} from "../../shared/stacks-59xy6t1p.js";
+} from "../../shared/stacks-hjaqtgaq.js";
 import {
   callContract,
   getMapEntry
-} from "../../shared/stacks-01pbr7gf.js";
+} from "../../shared/stacks-cqp2dgmc.js";
 import {
   readContract
 } from "../../shared/stacks-msmgyerb.js";
@@ -33,7 +38,7 @@ import {
 } from "../../shared/stacks-tjjnkt3r.js";
 import {
   sponsorTransaction
-} from "../../shared/stacks-g67f4w1d.js";
+} from "../../shared/stacks-hpcbn81g.js";
 import {
   estimateFee,
   extendedApiSource,
@@ -46,7 +51,8 @@ import {
   resolveFee,
   sendTransaction,
   waitForTransactionReceipt
-} from "../../shared/stacks-kjg7fw4y.js";
+} from "../../shared/stacks-gh52j903.js";
+import"../../shared/stacks-fh48neva.js";
 import"../../shared/stacks-709tra19.js";
 import"../../shared/stacks-18jv9aen.js";
 import"../../shared/stacks-g11v9a35.js";
@@ -78,14 +84,19 @@ export {
   isFeeTier,
   indexTxSource,
   getTransaction,
+  getRawBlock,
   getNonce,
+  getNftHoldings,
+  getMempoolStats,
   getMapEntry,
+  getContractSource,
   getContractAbi,
   getContract,
   getBlockHeight,
   getBlock,
   getBalance,
   getAccountInfo,
+  getAccountHistory,
   extendedApiSource,
   estimateFee,
   deployContract,
@@ -93,5 +104,5 @@ export {
   ContractResponseError
 };
 
-//# debugId=853E584683991ADA64756E2164756E21
+//# debugId=B0E84684200EC53E64756E2164756E21
 //# sourceMappingURL=index.js.map

package/dist/src/actions/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "853E584683991ADA64756E2164756E21",
+  "debugId": "B0E84684200EC53E64756E2164756E21",
   "names": []
 }