rune-stamp-sdk 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rune-Stamp
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,41 @@
+# rune-stamp-sdk
+
+TypeScript SDK for rune-style badge/stamp issuance on the Stacks blockchain — mint, verify, enumerate.
+
+## Install
+
+```bash
+npm install rune-stamp-sdk
+```
+
+## Usage
+
+```ts
+import { buildReadOnlyUrl, parseContractId } from 'rune-stamp-sdk';
+
+const contract = parseContractId('SP16F6839630K5XX06KE7KVNSNMYBK89912NH6N4C.rune-stamp-a1');
+if (contract) {
+  const url = buildReadOnlyUrl({ contract, functionName: 'get-stamp' });
+  console.log(url);
+}
+```
+
+## What's inside
+
+- `constants` — network endpoints, project-specific defaults
+- `utils` — address/contract-name validation, parsing, formatting, STX conversion
+- `contract` — read-only call URL helpers
+- `types` — `Stamp` and related shapes
+
+## Scripts
+
+```bash
+npm test           # vitest run
+npm run typecheck  # tsc --noEmit
+npm run lint       # eslint
+npm run build      # tsup → dist/
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,52 @@
+declare const STACKS_MAINNET = "https://api.mainnet.hiro.so";
+declare const STACKS_TESTNET = "https://api.testnet.hiro.so";
+declare const DEFAULT_FEE_USTX = 5000;
+declare const MICROSTX_PER_STX = 1000000;
+declare const CLARITY_VERSION = 4;
+declare const MAX_RUNE_NAME_LENGTH = 64;
+declare const MAX_STAMP_DESCRIPTION_LENGTH = 256;
+declare const STAMP_TIER: {
+    readonly common: 1;
+    readonly rare: 2;
+    readonly legendary: 3;
+};
+declare const NETWORKS: {
+    readonly mainnet: "https://api.mainnet.hiro.so";
+    readonly testnet: "https://api.testnet.hiro.so";
+};
+type NetworkName = keyof typeof NETWORKS;
+
+interface ContractIdentifier {
+    address: string;
+    name: string;
+}
+interface Stamp {
+    id: number;
+    runeName: string;
+    recipient: string;
+    mintedAt: number;
+}
+interface TxOptions {
+    fee?: number;
+    nonce?: number;
+    postConditions?: unknown[];
+}
+
+declare function microStxToStx(usx: number): number;
+declare function stxToMicroStx(stx: number): number;
+declare function isValidStacksAddress(addr: string): boolean;
+declare function isValidContractName(name: string): boolean;
+declare function parseContractId(id: string): ContractIdentifier | null;
+declare function formatContractId(address: string, name: string): string;
+declare function truncateAddress(addr: string, prefix?: number, suffix?: number): string;
+
+interface ReadOnlyCallArgs {
+    contract: ContractIdentifier;
+    functionName: string;
+    network?: NetworkName;
+    sender?: string;
+}
+declare function buildReadOnlyUrl(args: ReadOnlyCallArgs): string;
+declare function describeContract(c: ContractIdentifier): string;
+
+export { CLARITY_VERSION, type ContractIdentifier, DEFAULT_FEE_USTX, MAX_RUNE_NAME_LENGTH, MAX_STAMP_DESCRIPTION_LENGTH, MICROSTX_PER_STX, NETWORKS, type NetworkName, type ReadOnlyCallArgs, STACKS_MAINNET, STACKS_TESTNET, STAMP_TIER, type Stamp, type TxOptions, buildReadOnlyUrl, describeContract, formatContractId, isValidContractName, isValidStacksAddress, microStxToStx, parseContractId, stxToMicroStx, truncateAddress };

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+declare const STACKS_MAINNET = "https://api.mainnet.hiro.so";
+declare const STACKS_TESTNET = "https://api.testnet.hiro.so";
+declare const DEFAULT_FEE_USTX = 5000;
+declare const MICROSTX_PER_STX = 1000000;
+declare const CLARITY_VERSION = 4;
+declare const MAX_RUNE_NAME_LENGTH = 64;
+declare const MAX_STAMP_DESCRIPTION_LENGTH = 256;
+declare const STAMP_TIER: {
+    readonly common: 1;
+    readonly rare: 2;
+    readonly legendary: 3;
+};
+declare const NETWORKS: {
+    readonly mainnet: "https://api.mainnet.hiro.so";
+    readonly testnet: "https://api.testnet.hiro.so";
+};
+type NetworkName = keyof typeof NETWORKS;
+
+interface ContractIdentifier {
+    address: string;
+    name: string;
+}
+interface Stamp {
+    id: number;
+    runeName: string;
+    recipient: string;
+    mintedAt: number;
+}
+interface TxOptions {
+    fee?: number;
+    nonce?: number;
+    postConditions?: unknown[];
+}
+
+declare function microStxToStx(usx: number): number;
+declare function stxToMicroStx(stx: number): number;
+declare function isValidStacksAddress(addr: string): boolean;
+declare function isValidContractName(name: string): boolean;
+declare function parseContractId(id: string): ContractIdentifier | null;
+declare function formatContractId(address: string, name: string): string;
+declare function truncateAddress(addr: string, prefix?: number, suffix?: number): string;
+
+interface ReadOnlyCallArgs {
+    contract: ContractIdentifier;
+    functionName: string;
+    network?: NetworkName;
+    sender?: string;
+}
+declare function buildReadOnlyUrl(args: ReadOnlyCallArgs): string;
+declare function describeContract(c: ContractIdentifier): string;
+
+export { CLARITY_VERSION, type ContractIdentifier, DEFAULT_FEE_USTX, MAX_RUNE_NAME_LENGTH, MAX_STAMP_DESCRIPTION_LENGTH, MICROSTX_PER_STX, NETWORKS, type NetworkName, type ReadOnlyCallArgs, STACKS_MAINNET, STACKS_TESTNET, STAMP_TIER, type Stamp, type TxOptions, buildReadOnlyUrl, describeContract, formatContractId, isValidContractName, isValidStacksAddress, microStxToStx, parseContractId, stxToMicroStx, truncateAddress };

package/dist/index.js

@@ -0,0 +1,126 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  CLARITY_VERSION: () => CLARITY_VERSION,
+  DEFAULT_FEE_USTX: () => DEFAULT_FEE_USTX,
+  MAX_RUNE_NAME_LENGTH: () => MAX_RUNE_NAME_LENGTH,
+  MAX_STAMP_DESCRIPTION_LENGTH: () => MAX_STAMP_DESCRIPTION_LENGTH,
+  MICROSTX_PER_STX: () => MICROSTX_PER_STX,
+  NETWORKS: () => NETWORKS,
+  STACKS_MAINNET: () => STACKS_MAINNET,
+  STACKS_TESTNET: () => STACKS_TESTNET,
+  STAMP_TIER: () => STAMP_TIER,
+  buildReadOnlyUrl: () => buildReadOnlyUrl,
+  describeContract: () => describeContract,
+  formatContractId: () => formatContractId,
+  isValidContractName: () => isValidContractName,
+  isValidStacksAddress: () => isValidStacksAddress,
+  microStxToStx: () => microStxToStx,
+  parseContractId: () => parseContractId,
+  stxToMicroStx: () => stxToMicroStx,
+  truncateAddress: () => truncateAddress
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/constants.ts
+var STACKS_MAINNET = "https://api.mainnet.hiro.so";
+var STACKS_TESTNET = "https://api.testnet.hiro.so";
+var DEFAULT_FEE_USTX = 5e3;
+var MICROSTX_PER_STX = 1e6;
+var CLARITY_VERSION = 4;
+var MAX_RUNE_NAME_LENGTH = 64;
+var MAX_STAMP_DESCRIPTION_LENGTH = 256;
+var STAMP_TIER = { common: 1, rare: 2, legendary: 3 };
+var NETWORKS = {
+  mainnet: STACKS_MAINNET,
+  testnet: STACKS_TESTNET
+};
+
+// src/utils.ts
+var STACKS_ADDRESS_RE = /^S[PT][0-9A-HJKMNP-Z]{38,40}$/;
+var CONTRACT_NAME_RE = /^[a-zA-Z][a-zA-Z0-9\-]{0,127}$/;
+function microStxToStx(usx) {
+  return usx / MICROSTX_PER_STX;
+}
+function stxToMicroStx(stx) {
+  return Math.round(stx * MICROSTX_PER_STX);
+}
+function isValidStacksAddress(addr) {
+  if (typeof addr !== "string") return false;
+  return STACKS_ADDRESS_RE.test(addr);
+}
+function isValidContractName(name) {
+  if (typeof name !== "string") return false;
+  return CONTRACT_NAME_RE.test(name);
+}
+function parseContractId(id) {
+  const parts = id.split(".");
+  if (parts.length !== 2) return null;
+  const [address, name] = parts;
+  if (!isValidStacksAddress(address) || !isValidContractName(name)) return null;
+  return { address, name };
+}
+function formatContractId(address, name) {
+  return `${address}.${name}`;
+}
+function truncateAddress(addr, prefix = 4, suffix = 4) {
+  if (!addr || addr.length <= prefix + suffix + 3) return addr;
+  return `${addr.slice(0, prefix)}...${addr.slice(-suffix)}`;
+}
+
+// src/contract.ts
+function buildReadOnlyUrl(args) {
+  const { contract, functionName, network = "mainnet" } = args;
+  if (!isValidStacksAddress(contract.address)) {
+    throw new Error(`Invalid contract address: ${contract.address}`);
+  }
+  if (!isValidContractName(contract.name)) {
+    throw new Error(`Invalid contract name: ${contract.name}`);
+  }
+  const base = NETWORKS[network];
+  return `${base}/v2/contracts/call-read/${contract.address}/${contract.name}/${functionName}`;
+}
+function describeContract(c) {
+  return `Stacks contract ${formatContractId(c.address, c.name)}`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CLARITY_VERSION,
+  DEFAULT_FEE_USTX,
+  MAX_RUNE_NAME_LENGTH,
+  MAX_STAMP_DESCRIPTION_LENGTH,
+  MICROSTX_PER_STX,
+  NETWORKS,
+  STACKS_MAINNET,
+  STACKS_TESTNET,
+  STAMP_TIER,
+  buildReadOnlyUrl,
+  describeContract,
+  formatContractId,
+  isValidContractName,
+  isValidStacksAddress,
+  microStxToStx,
+  parseContractId,
+  stxToMicroStx,
+  truncateAddress
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/constants.ts","../src/utils.ts","../src/contract.ts"],"sourcesContent":["export * from './constants';\nexport * from './utils';\nexport * from './contract';\nexport * from './types';\n","export const STACKS_MAINNET = 'https://api.mainnet.hiro.so';\nexport const STACKS_TESTNET = 'https://api.testnet.hiro.so';\n\nexport const DEFAULT_FEE_USTX = 5_000;\nexport const MICROSTX_PER_STX = 1_000_000;\n\nexport const CLARITY_VERSION = 4;\n\nexport const MAX_RUNE_NAME_LENGTH = 64;\nexport const MAX_STAMP_DESCRIPTION_LENGTH = 256;\nexport const STAMP_TIER = { common: 1, rare: 2, legendary: 3 } as const;\n\nexport const NETWORKS = {\n  mainnet: STACKS_MAINNET,\n  testnet: STACKS_TESTNET,\n} as const;\n\nexport type NetworkName = keyof typeof NETWORKS;\n","import { MICROSTX_PER_STX } from './constants';\nimport type { ContractIdentifier } from './types';\n\nconst STACKS_ADDRESS_RE = /^S[PT][0-9A-HJKMNP-Z]{38,40}$/;\nconst CONTRACT_NAME_RE = /^[a-zA-Z][a-zA-Z0-9\\-]{0,127}$/;\n\nexport function microStxToStx(usx: number): number {\n  return usx / MICROSTX_PER_STX;\n}\n\nexport function stxToMicroStx(stx: number): number {\n  return Math.round(stx * MICROSTX_PER_STX);\n}\n\nexport function isValidStacksAddress(addr: string): boolean {\n  if (typeof addr !== 'string') return false;\n  return STACKS_ADDRESS_RE.test(addr);\n}\n\nexport function isValidContractName(name: string): boolean {\n  if (typeof name !== 'string') return false;\n  return CONTRACT_NAME_RE.test(name);\n}\n\nexport function parseContractId(id: string): ContractIdentifier | null {\n  const parts = id.split('.');\n  if (parts.length !== 2) return null;\n  const [address, name] = parts;\n  if (!isValidStacksAddress(address) || !isValidContractName(name)) return null;\n  return { address, name };\n}\n\nexport function formatContractId(address: string, name: string): string {\n  return `${address}.${name}`;\n}\n\nexport function truncateAddress(addr: string, prefix = 4, suffix = 4): string {\n  if (!addr || addr.length <= prefix + suffix + 3) return addr;\n  return `${addr.slice(0, prefix)}...${addr.slice(-suffix)}`;\n}\n","import { NETWORKS, type NetworkName } from './constants';\nimport { formatContractId, isValidContractName, isValidStacksAddress } from './utils';\nimport type { ContractIdentifier } from './types';\n\nexport interface ReadOnlyCallArgs {\n  contract: ContractIdentifier;\n  functionName: string;\n  network?: NetworkName;\n  sender?: string;\n}\n\nexport function buildReadOnlyUrl(args: ReadOnlyCallArgs): string {\n  const { contract, functionName, network = 'mainnet' } = args;\n  if (!isValidStacksAddress(contract.address)) {\n    throw new Error(`Invalid contract address: ${contract.address}`);\n  }\n  if (!isValidContractName(contract.name)) {\n    throw new Error(`Invalid contract name: ${contract.name}`);\n  }\n  const base = NETWORKS[network];\n  return `${base}/v2/contracts/call-read/${contract.address}/${contract.name}/${functionName}`;\n}\n\nexport function describeContract(c: ContractIdentifier): string {\n  return `Stacks contract ${formatContractId(c.address, c.name)}`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAM,iBAAiB;AACvB,IAAM,iBAAiB;AAEvB,IAAM,mBAAmB;AACzB,IAAM,mBAAmB;AAEzB,IAAM,kBAAkB;AAExB,IAAM,uBAAuB;AAC7B,IAAM,+BAA+B;AACrC,IAAM,aAAa,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,EAAE;AAEtD,IAAM,WAAW;AAAA,EACtB,SAAS;AAAA,EACT,SAAS;AACX;;;ACZA,IAAM,oBAAoB;AAC1B,IAAM,mBAAmB;AAElB,SAAS,cAAc,KAAqB;AACjD,SAAO,MAAM;AACf;AAEO,SAAS,cAAc,KAAqB;AACjD,SAAO,KAAK,MAAM,MAAM,gBAAgB;AAC1C;AAEO,SAAS,qBAAqB,MAAuB;AAC1D,MAAI,OAAO,SAAS,SAAU,QAAO;AACrC,SAAO,kBAAkB,KAAK,IAAI;AACpC;AAEO,SAAS,oBAAoB,MAAuB;AACzD,MAAI,OAAO,SAAS,SAAU,QAAO;AACrC,SAAO,iBAAiB,KAAK,IAAI;AACnC;AAEO,SAAS,gBAAgB,IAAuC;AACrE,QAAM,QAAQ,GAAG,MAAM,GAAG;AAC1B,MAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,QAAM,CAAC,SAAS,IAAI,IAAI;AACxB,MAAI,CAAC,qBAAqB,OAAO,KAAK,CAAC,oBAAoB,IAAI,EAAG,QAAO;AACzE,SAAO,EAAE,SAAS,KAAK;AACzB;AAEO,SAAS,iBAAiB,SAAiB,MAAsB;AACtE,SAAO,GAAG,OAAO,IAAI,IAAI;AAC3B;AAEO,SAAS,gBAAgB,MAAc,SAAS,GAAG,SAAS,GAAW;AAC5E,MAAI,CAAC,QAAQ,KAAK,UAAU,SAAS,SAAS,EAAG,QAAO;AACxD,SAAO,GAAG,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC;AAC1D;;;AC5BO,SAAS,iBAAiB,MAAgC;AAC/D,QAAM,EAAE,UAAU,cAAc,UAAU,UAAU,IAAI;AACxD,MAAI,CAAC,qBAAqB,SAAS,OAAO,GAAG;AAC3C,UAAM,IAAI,MAAM,6BAA6B,SAAS,OAAO,EAAE;AAAA,EACjE;AACA,MAAI,CAAC,oBAAoB,SAAS,IAAI,GAAG;AACvC,UAAM,IAAI,MAAM,0BAA0B,SAAS,IAAI,EAAE;AAAA,EAC3D;AACA,QAAM,OAAO,SAAS,OAAO;AAC7B,SAAO,GAAG,IAAI,2BAA2B,SAAS,OAAO,IAAI,SAAS,IAAI,IAAI,YAAY;AAC5F;AAEO,SAAS,iBAAiB,GAA+B;AAC9D,SAAO,mBAAmB,iBAAiB,EAAE,SAAS,EAAE,IAAI,CAAC;AAC/D;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,82 @@
+// src/constants.ts
+var STACKS_MAINNET = "https://api.mainnet.hiro.so";
+var STACKS_TESTNET = "https://api.testnet.hiro.so";
+var DEFAULT_FEE_USTX = 5e3;
+var MICROSTX_PER_STX = 1e6;
+var CLARITY_VERSION = 4;
+var MAX_RUNE_NAME_LENGTH = 64;
+var MAX_STAMP_DESCRIPTION_LENGTH = 256;
+var STAMP_TIER = { common: 1, rare: 2, legendary: 3 };
+var NETWORKS = {
+  mainnet: STACKS_MAINNET,
+  testnet: STACKS_TESTNET
+};
+
+// src/utils.ts
+var STACKS_ADDRESS_RE = /^S[PT][0-9A-HJKMNP-Z]{38,40}$/;
+var CONTRACT_NAME_RE = /^[a-zA-Z][a-zA-Z0-9\-]{0,127}$/;
+function microStxToStx(usx) {
+  return usx / MICROSTX_PER_STX;
+}
+function stxToMicroStx(stx) {
+  return Math.round(stx * MICROSTX_PER_STX);
+}
+function isValidStacksAddress(addr) {
+  if (typeof addr !== "string") return false;
+  return STACKS_ADDRESS_RE.test(addr);
+}
+function isValidContractName(name) {
+  if (typeof name !== "string") return false;
+  return CONTRACT_NAME_RE.test(name);
+}
+function parseContractId(id) {
+  const parts = id.split(".");
+  if (parts.length !== 2) return null;
+  const [address, name] = parts;
+  if (!isValidStacksAddress(address) || !isValidContractName(name)) return null;
+  return { address, name };
+}
+function formatContractId(address, name) {
+  return `${address}.${name}`;
+}
+function truncateAddress(addr, prefix = 4, suffix = 4) {
+  if (!addr || addr.length <= prefix + suffix + 3) return addr;
+  return `${addr.slice(0, prefix)}...${addr.slice(-suffix)}`;
+}
+
+// src/contract.ts
+function buildReadOnlyUrl(args) {
+  const { contract, functionName, network = "mainnet" } = args;
+  if (!isValidStacksAddress(contract.address)) {
+    throw new Error(`Invalid contract address: ${contract.address}`);
+  }
+  if (!isValidContractName(contract.name)) {
+    throw new Error(`Invalid contract name: ${contract.name}`);
+  }
+  const base = NETWORKS[network];
+  return `${base}/v2/contracts/call-read/${contract.address}/${contract.name}/${functionName}`;
+}
+function describeContract(c) {
+  return `Stacks contract ${formatContractId(c.address, c.name)}`;
+}
+export {
+  CLARITY_VERSION,
+  DEFAULT_FEE_USTX,
+  MAX_RUNE_NAME_LENGTH,
+  MAX_STAMP_DESCRIPTION_LENGTH,
+  MICROSTX_PER_STX,
+  NETWORKS,
+  STACKS_MAINNET,
+  STACKS_TESTNET,
+  STAMP_TIER,
+  buildReadOnlyUrl,
+  describeContract,
+  formatContractId,
+  isValidContractName,
+  isValidStacksAddress,
+  microStxToStx,
+  parseContractId,
+  stxToMicroStx,
+  truncateAddress
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts","../src/utils.ts","../src/contract.ts"],"sourcesContent":["export const STACKS_MAINNET = 'https://api.mainnet.hiro.so';\nexport const STACKS_TESTNET = 'https://api.testnet.hiro.so';\n\nexport const DEFAULT_FEE_USTX = 5_000;\nexport const MICROSTX_PER_STX = 1_000_000;\n\nexport const CLARITY_VERSION = 4;\n\nexport const MAX_RUNE_NAME_LENGTH = 64;\nexport const MAX_STAMP_DESCRIPTION_LENGTH = 256;\nexport const STAMP_TIER = { common: 1, rare: 2, legendary: 3 } as const;\n\nexport const NETWORKS = {\n  mainnet: STACKS_MAINNET,\n  testnet: STACKS_TESTNET,\n} as const;\n\nexport type NetworkName = keyof typeof NETWORKS;\n","import { MICROSTX_PER_STX } from './constants';\nimport type { ContractIdentifier } from './types';\n\nconst STACKS_ADDRESS_RE = /^S[PT][0-9A-HJKMNP-Z]{38,40}$/;\nconst CONTRACT_NAME_RE = /^[a-zA-Z][a-zA-Z0-9\\-]{0,127}$/;\n\nexport function microStxToStx(usx: number): number {\n  return usx / MICROSTX_PER_STX;\n}\n\nexport function stxToMicroStx(stx: number): number {\n  return Math.round(stx * MICROSTX_PER_STX);\n}\n\nexport function isValidStacksAddress(addr: string): boolean {\n  if (typeof addr !== 'string') return false;\n  return STACKS_ADDRESS_RE.test(addr);\n}\n\nexport function isValidContractName(name: string): boolean {\n  if (typeof name !== 'string') return false;\n  return CONTRACT_NAME_RE.test(name);\n}\n\nexport function parseContractId(id: string): ContractIdentifier | null {\n  const parts = id.split('.');\n  if (parts.length !== 2) return null;\n  const [address, name] = parts;\n  if (!isValidStacksAddress(address) || !isValidContractName(name)) return null;\n  return { address, name };\n}\n\nexport function formatContractId(address: string, name: string): string {\n  return `${address}.${name}`;\n}\n\nexport function truncateAddress(addr: string, prefix = 4, suffix = 4): string {\n  if (!addr || addr.length <= prefix + suffix + 3) return addr;\n  return `${addr.slice(0, prefix)}...${addr.slice(-suffix)}`;\n}\n","import { NETWORKS, type NetworkName } from './constants';\nimport { formatContractId, isValidContractName, isValidStacksAddress } from './utils';\nimport type { ContractIdentifier } from './types';\n\nexport interface ReadOnlyCallArgs {\n  contract: ContractIdentifier;\n  functionName: string;\n  network?: NetworkName;\n  sender?: string;\n}\n\nexport function buildReadOnlyUrl(args: ReadOnlyCallArgs): string {\n  const { contract, functionName, network = 'mainnet' } = args;\n  if (!isValidStacksAddress(contract.address)) {\n    throw new Error(`Invalid contract address: ${contract.address}`);\n  }\n  if (!isValidContractName(contract.name)) {\n    throw new Error(`Invalid contract name: ${contract.name}`);\n  }\n  const base = NETWORKS[network];\n  return `${base}/v2/contracts/call-read/${contract.address}/${contract.name}/${functionName}`;\n}\n\nexport function describeContract(c: ContractIdentifier): string {\n  return `Stacks contract ${formatContractId(c.address, c.name)}`;\n}\n"],"mappings":";AAAO,IAAM,iBAAiB;AACvB,IAAM,iBAAiB;AAEvB,IAAM,mBAAmB;AACzB,IAAM,mBAAmB;AAEzB,IAAM,kBAAkB;AAExB,IAAM,uBAAuB;AAC7B,IAAM,+BAA+B;AACrC,IAAM,aAAa,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,EAAE;AAEtD,IAAM,WAAW;AAAA,EACtB,SAAS;AAAA,EACT,SAAS;AACX;;;ACZA,IAAM,oBAAoB;AAC1B,IAAM,mBAAmB;AAElB,SAAS,cAAc,KAAqB;AACjD,SAAO,MAAM;AACf;AAEO,SAAS,cAAc,KAAqB;AACjD,SAAO,KAAK,MAAM,MAAM,gBAAgB;AAC1C;AAEO,SAAS,qBAAqB,MAAuB;AAC1D,MAAI,OAAO,SAAS,SAAU,QAAO;AACrC,SAAO,kBAAkB,KAAK,IAAI;AACpC;AAEO,SAAS,oBAAoB,MAAuB;AACzD,MAAI,OAAO,SAAS,SAAU,QAAO;AACrC,SAAO,iBAAiB,KAAK,IAAI;AACnC;AAEO,SAAS,gBAAgB,IAAuC;AACrE,QAAM,QAAQ,GAAG,MAAM,GAAG;AAC1B,MAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,QAAM,CAAC,SAAS,IAAI,IAAI;AACxB,MAAI,CAAC,qBAAqB,OAAO,KAAK,CAAC,oBAAoB,IAAI,EAAG,QAAO;AACzE,SAAO,EAAE,SAAS,KAAK;AACzB;AAEO,SAAS,iBAAiB,SAAiB,MAAsB;AACtE,SAAO,GAAG,OAAO,IAAI,IAAI;AAC3B;AAEO,SAAS,gBAAgB,MAAc,SAAS,GAAG,SAAS,GAAW;AAC5E,MAAI,CAAC,QAAQ,KAAK,UAAU,SAAS,SAAS,EAAG,QAAO;AACxD,SAAO,GAAG,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC;AAC1D;;;AC5BO,SAAS,iBAAiB,MAAgC;AAC/D,QAAM,EAAE,UAAU,cAAc,UAAU,UAAU,IAAI;AACxD,MAAI,CAAC,qBAAqB,SAAS,OAAO,GAAG;AAC3C,UAAM,IAAI,MAAM,6BAA6B,SAAS,OAAO,EAAE;AAAA,EACjE;AACA,MAAI,CAAC,oBAAoB,SAAS,IAAI,GAAG;AACvC,UAAM,IAAI,MAAM,0BAA0B,SAAS,IAAI,EAAE;AAAA,EAC3D;AACA,QAAM,OAAO,SAAS,OAAO;AAC7B,SAAO,GAAG,IAAI,2BAA2B,SAAS,OAAO,IAAI,SAAS,IAAI,IAAI,YAAY;AAC5F;AAEO,SAAS,iBAAiB,GAA+B;AAC9D,SAAO,mBAAmB,iBAAiB,EAAE,SAAS,EAAE,IAAI,CAAC;AAC/D;","names":[]}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "rune-stamp-sdk",
+  "version": "0.1.1",
+  "description": "TypeScript SDK for rune-style badge/stamp issuance on the Stacks blockchain — mint, verify, enumerate.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:utils": "vitest run tests/utils.test.ts",
+    "test:contract": "vitest run tests/contract.test.ts",
+    "test:constants": "vitest run tests/constants.test.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src tests --ext .ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "stacks",
+    "clarity",
+    "blockchain",
+    "sdk",
+    "badges",
+    "stamps",
+    "runes",
+    "reputation",
+    "soulbound",
+    "web3"
+  ],
+  "author": "Rune-Stamp",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wurlelham531-svg/rune-stamp-sdk"
+  },
+  "dependencies": {
+    "@stacks/transactions": "^6.12.0"
+  },
+  "devDependencies": {
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.57.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.5",
+    "vitest": "^1.6.0"
+  }
+}