dice-roll-sdk 1.0.2 → 1.0.4

package/dist/client.d.ts

@@ -0,0 +1,17 @@
+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

@@ -0,0 +1,136 @@
+"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

@@ -0,0 +1,4 @@
+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

@@ -0,0 +1,12 @@
+"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

@@ -0,0 +1,26 @@
+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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dice-roll-sdk",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "TypeScript SDK for interacting with the Dice Roll smart contract on Stacks blockchain",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",