dice-roll-sdk 1.0.0 → 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 brventonbeshers-ship-it
+
+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

@@ -1,23 +1,25 @@
-# dice-roll-sdk
-
-TypeScript SDK for interacting with the Dice Roll contract on Stacks.
-
-## Installation
-
-```bash
-npm install dice-roll-sdk
-```
-
-## Usage
-
-```ts
-import { getLeaderboard, getTotalRolls, createRollCall } from "dice-roll-sdk";
-
-const total = await getTotalRolls();
-const leaderboard = await getLeaderboard();
-const tx = createRollCall();
-```
-
-## License
-
-MIT
+[![npm](https://img.shields.io/npm/v/dice-roll-sdk?color=blueviolet)](https://www.npmjs.com/package/dice-roll-sdk) ![Stacks Mainnet](https://img.shields.io/badge/Stacks-Mainnet-blueviolet) ![license](https://img.shields.io/badge/license-MIT-blue)
+
+# dice-roll-sdk
+
+TypeScript SDK for interacting with the Dice Roll contract on Stacks.
+
+## Installation
+
+```bash
+npm install dice-roll-sdk
+```
+
+## Usage
+
+```ts
+import { getLeaderboard, getTotalRolls, createRollCall } from "dice-roll-sdk";
+
+const total = await getTotalRolls();
+const leaderboard = await getLeaderboard();
+const tx = createRollCall();
+```
+
+## License
+
+MIT

package/package.json

@@ -1,50 +1,50 @@
-{
-  "name": "dice-roll-sdk",
-  "version": "1.0.0",
-  "description": "TypeScript SDK for interacting with the Dice Roll smart contract on Stacks blockchain",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "stacks",
-    "blockchain",
-    "dice-roll",
-    "sdk",
-    "smart-contract",
-    "web3",
-    "dapp",
-    "stacks-blockchain",
-    "typescript",
-    "on-chain",
-    "dice-game"
-  ],
-  "author": "brventonbeshers-ship-it",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/brventonbeshers-ship-it/dice-roll-sdk.git"
-  },
-  "bugs": {
-    "url": "https://github.com/brventonbeshers-ship-it/dice-roll-sdk/issues"
-  },
-  "homepage": "https://github.com/brventonbeshers-ship-it/dice-roll-sdk#readme",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "@stacks/network": "^7.3.1",
-    "@stacks/transactions": "^7.3.1"
-  },
-  "devDependencies": {
-    "typescript": "^5.0.0"
-  }
-}
+{
+  "name": "dice-roll-sdk",
+  "version": "1.0.2",
+  "description": "TypeScript SDK for interacting with the Dice Roll smart contract on Stacks blockchain",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "stacks",
+    "blockchain",
+    "dice-roll",
+    "sdk",
+    "smart-contract",
+    "web3",
+    "dapp",
+    "stacks-blockchain",
+    "typescript",
+    "on-chain",
+    "dice-game"
+  ],
+  "author": "brventonbeshers-ship-it",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/brventonbeshers-ship-it/dice-roll-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/brventonbeshers-ship-it/dice-roll-sdk/issues"
+  },
+  "homepage": "https://github.com/brventonbeshers-ship-it/dice-roll-sdk#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@stacks/network": "^7.3.1",
+    "@stacks/transactions": "^7.3.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}

package/dist/client.d.ts

@@ -1,17 +0,0 @@
-import type { DiceRollConfig, LeaderEntry, ReadOnlyResponse, RollCall } from "./types";
-export declare const DEFAULT_CONFIG: Required<DiceRollConfig>;
-export declare function callReadOnly(functionName: string, args?: string[], config?: DiceRollConfig): Promise<ReadOnlyResponse>;
-export declare function getTotalRolls(config?: DiceRollConfig): Promise<number>;
-export declare function getUserRolls(userAddress: string, config?: DiceRollConfig): Promise<number>;
-export declare function getUserLastResult(userAddress: string, config?: DiceRollConfig): Promise<number>;
-export declare function getLeaderboard(config?: DiceRollConfig): Promise<LeaderEntry[]>;
-export declare function createRollCall(config?: DiceRollConfig): RollCall;
-export declare class DiceRollClient {
-    private readonly config;
-    constructor(config?: DiceRollConfig);
-    getTotalRolls(): Promise<number>;
-    getUserRolls(userAddress: string): Promise<number>;
-    getUserLastResult(userAddress: string): Promise<number>;
-    getLeaderboard(): Promise<LeaderEntry[]>;
-    createRollCall(): RollCall;
-}

package/dist/client.js

@@ -1,136 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DiceRollClient = exports.DEFAULT_CONFIG = void 0;
-exports.callReadOnly = callReadOnly;
-exports.getTotalRolls = getTotalRolls;
-exports.getUserRolls = getUserRolls;
-exports.getUserLastResult = getUserLastResult;
-exports.getLeaderboard = getLeaderboard;
-exports.createRollCall = createRollCall;
-const network_1 = require("@stacks/network");
-const transactions_1 = require("@stacks/transactions");
-exports.DEFAULT_CONFIG = {
-    contractAddress: "SP1Q7YR67R6WGP28NXDJD1WZ11REPAAXRJJ3V6RKM",
-    contractName: "dice-roll",
-    apiBase: "https://api.mainnet.hiro.so",
-    network: network_1.STACKS_MAINNET,
-};
-function resolveConfig(overrides = {}) {
-    return { ...exports.DEFAULT_CONFIG, ...overrides };
-}
-function serializeCvToHex(cv) {
-    const serialized = (0, transactions_1.serializeCV)(cv);
-    if (typeof serialized === "string") {
-        return serialized.startsWith("0x") ? serialized : `0x${serialized}`;
-    }
-    return `0x${Buffer.from(serialized).toString("hex")}`;
-}
-async function callReadOnly(functionName, args = [], config = {}) {
-    const resolved = resolveConfig(config);
-    const response = await fetch(`${resolved.apiBase}/v2/contracts/call-read/${resolved.contractAddress}/${resolved.contractName}/${functionName}`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-            sender: resolved.contractAddress,
-            arguments: args,
-        }),
-    });
-    if (!response.ok) {
-        throw new Error(`Read-only call failed with status ${response.status}`);
-    }
-    return response.json();
-}
-function normalizeLeaderboardValue(raw) {
-    const entries = Array.isArray(raw) ? raw : [];
-    return entries
-        .map(item => {
-        const entry = item && typeof item === "object" && "value" in item
-            ? item.value
-            : item;
-        const record = entry;
-        return {
-            who: String(record?.who && typeof record.who === "object" ? record.who.value ?? "" : record?.who ?? ""),
-            rolls: Number(record?.rolls && typeof record.rolls === "object"
-                ? record.rolls.value ?? 0
-                : record?.rolls ?? 0),
-        };
-    })
-        .filter(entry => entry.who && entry.rolls > 0);
-}
-async function getTotalRolls(config = {}) {
-    const data = await callReadOnly("get-total-rolls", [], config);
-    if (!data.okay || !data.result) {
-        return 0;
-    }
-    const clarityValue = (0, transactions_1.hexToCV)(data.result);
-    const parsed = (0, transactions_1.cvToValue)(clarityValue, true);
-    return Number(parsed && typeof parsed === "object" && "value" in parsed
-        ? parsed.value ?? 0
-        : parsed ?? 0);
-}
-async function getUserRolls(userAddress, config = {}) {
-    const principalArg = serializeCvToHex((0, transactions_1.principalCV)(userAddress));
-    const data = await callReadOnly("get-user-rolls", [principalArg], config);
-    if (!data.okay || !data.result) {
-        return 0;
-    }
-    const clarityValue = (0, transactions_1.hexToCV)(data.result);
-    const parsed = (0, transactions_1.cvToValue)(clarityValue, true);
-    return Number(parsed && typeof parsed === "object" && "value" in parsed
-        ? parsed.value ?? 0
-        : parsed ?? 0);
-}
-async function getUserLastResult(userAddress, config = {}) {
-    const principalArg = serializeCvToHex((0, transactions_1.principalCV)(userAddress));
-    const data = await callReadOnly("get-user-last-result", [principalArg], config);
-    if (!data.okay || !data.result) {
-        return 0;
-    }
-    const clarityValue = (0, transactions_1.hexToCV)(data.result);
-    const parsed = (0, transactions_1.cvToValue)(clarityValue, true);
-    return Number(parsed && typeof parsed === "object" && "value" in parsed
-        ? parsed.value ?? 0
-        : parsed ?? 0);
-}
-async function getLeaderboard(config = {}) {
-    const data = await callReadOnly("get-leaderboard", [], config);
-    if (!data.okay || !data.result) {
-        return [];
-    }
-    const clarityValue = (0, transactions_1.hexToCV)(data.result);
-    const parsed = (0, transactions_1.cvToValue)(clarityValue, true);
-    return normalizeLeaderboardValue(parsed);
-}
-function createRollCall(config = {}) {
-    const resolved = resolveConfig(config);
-    return {
-        contractAddress: resolved.contractAddress,
-        contractName: resolved.contractName,
-        functionName: "roll",
-        functionArgs: [],
-        postConditionMode: transactions_1.PostConditionMode.Deny,
-        postConditions: [],
-        network: resolved.network,
-    };
-}
-class DiceRollClient {
-    constructor(config = {}) {
-        this.config = resolveConfig(config);
-    }
-    getTotalRolls() {
-        return getTotalRolls(this.config);
-    }
-    getUserRolls(userAddress) {
-        return getUserRolls(userAddress, this.config);
-    }
-    getUserLastResult(userAddress) {
-        return getUserLastResult(userAddress, this.config);
-    }
-    getLeaderboard() {
-        return getLeaderboard(this.config);
-    }
-    createRollCall() {
-        return createRollCall(this.config);
-    }
-}
-exports.DiceRollClient = DiceRollClient;

package/dist/index.d.ts

@@ -1,4 +0,0 @@
-import type { DiceRollClient } from "./client";
-export { DiceRollClient, DEFAULT_CONFIG, callReadOnly, createRollCall, getLeaderboard, getTotalRolls, getUserRolls, getUserLastResult, } from "./client";
-export type { DiceRollConfig, LeaderEntry, ReadOnlyResponse, RollCall, } from "./types";
-export type TotalRollsResult = Awaited<ReturnType<DiceRollClient["getTotalRolls"]>>;

package/dist/index.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getUserLastResult = exports.getUserRolls = exports.getTotalRolls = exports.getLeaderboard = exports.createRollCall = exports.callReadOnly = exports.DEFAULT_CONFIG = exports.DiceRollClient = void 0;
-var client_1 = require("./client");
-Object.defineProperty(exports, "DiceRollClient", { enumerable: true, get: function () { return client_1.DiceRollClient; } });
-Object.defineProperty(exports, "DEFAULT_CONFIG", { enumerable: true, get: function () { return client_1.DEFAULT_CONFIG; } });
-Object.defineProperty(exports, "callReadOnly", { enumerable: true, get: function () { return client_1.callReadOnly; } });
-Object.defineProperty(exports, "createRollCall", { enumerable: true, get: function () { return client_1.createRollCall; } });
-Object.defineProperty(exports, "getLeaderboard", { enumerable: true, get: function () { return client_1.getLeaderboard; } });
-Object.defineProperty(exports, "getTotalRolls", { enumerable: true, get: function () { return client_1.getTotalRolls; } });
-Object.defineProperty(exports, "getUserRolls", { enumerable: true, get: function () { return client_1.getUserRolls; } });
-Object.defineProperty(exports, "getUserLastResult", { enumerable: true, get: function () { return client_1.getUserLastResult; } });

package/dist/types.d.ts

@@ -1,26 +0,0 @@
-import type { StacksNetwork } from "@stacks/network";
-import type { PostConditionMode } from "@stacks/transactions";
-export interface DiceRollConfig {
-    contractAddress?: string;
-    contractName?: string;
-    apiBase?: string;
-    network?: StacksNetwork;
-}
-export interface LeaderEntry {
-    who: string;
-    rolls: number;
-}
-export interface ReadOnlyResponse {
-    okay?: boolean;
-    result?: string;
-    cause?: string;
-}
-export interface RollCall {
-    contractAddress: string;
-    contractName: string;
-    functionName: "roll";
-    functionArgs: [];
-    postConditionMode: PostConditionMode;
-    postConditions: [];
-    network: StacksNetwork;
-}

package/dist/types.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });