celo-dice-roll-sdk 1.0.0

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

@@ -0,0 +1,13 @@
+# celo-dice-roll-sdk
+
+TypeScript SDK for reading the Celo Dice Roll contract from Celo mainnet.
+
+```ts
+import { CeloDiceRollClient } from "celo-dice-roll-sdk";
+
+const client = new CeloDiceRollClient({
+  contractAddress: "0x943DfC4aFe76B2042031556516799ba03396B3F3",
+});
+
+const totalRolls = await client.getTotalRolls();
+```

package/dist/client.d.ts

@@ -0,0 +1,12 @@
+import { CeloDiceRollConfig, DiceRollStats, LeaderboardEntry } from "./types";
+declare const ABI: string[];
+export declare class CeloDiceRollClient {
+    private provider;
+    private contract;
+    contractAddress: string;
+    constructor(config: CeloDiceRollConfig);
+    getTotalRolls(): Promise<number>;
+    getUserStats(address: string): Promise<DiceRollStats>;
+    getLeaderboard(): Promise<LeaderboardEntry[]>;
+}
+export { ABI as CELO_DICE_ROLL_ABI };

package/dist/client.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CELO_DICE_ROLL_ABI = exports.CeloDiceRollClient = void 0;
+const ethers_1 = require("ethers");
+const ABI = [
+    "function roll(uint256 target) external",
+    "function totalRolls() external view returns (uint256)",
+    "function userRolls(address) external view returns (uint256)",
+    "function userWins(address) external view returns (uint256)",
+    "function getUserStats(address player) external view returns (uint256 rolls, uint256 wins, uint256 latestTarget, uint256 latestRoll)",
+    "function getLeaderboard() external view returns (address[10], uint256[10])",
+];
+exports.CELO_DICE_ROLL_ABI = ABI;
+class CeloDiceRollClient {
+    constructor(config) {
+        const rpcUrl = config.rpcUrl || "https://forno.celo.org";
+        this.provider = new ethers_1.ethers.JsonRpcProvider(rpcUrl);
+        this.contractAddress = config.contractAddress;
+        this.contract = new ethers_1.ethers.Contract(config.contractAddress, ABI, this.provider);
+    }
+    async getTotalRolls() {
+        const total = await this.contract.totalRolls();
+        return Number(total);
+    }
+    async getUserStats(address) {
+        const [rolls, wins, lastTarget, lastRoll] = await this.contract.getUserStats(address);
+        const rollCount = Number(rolls);
+        const winCount = Number(wins);
+        return {
+            rolls: rollCount,
+            wins: winCount,
+            lastTarget: Number(lastTarget),
+            lastRoll: Number(lastRoll),
+            winRate: rollCount === 0 ? 0 : Math.round((winCount / rollCount) * 100),
+        };
+    }
+    async getLeaderboard() {
+        const [addresses, scores] = await this.contract.getLeaderboard();
+        const entries = [];
+        for (let i = 0; i < 10; i++) {
+            const address = addresses[i];
+            const score = Number(scores[i]);
+            if (address !== ethers_1.ethers.ZeroAddress && score > 0) {
+                entries.push({ address, score, rank: i + 1 });
+            }
+        }
+        return entries;
+    }
+}
+exports.CeloDiceRollClient = CeloDiceRollClient;

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { CeloDiceRollClient, CELO_DICE_ROLL_ABI } from "./client";
+export type { CeloDiceRollConfig, DiceRollStats, LeaderboardEntry } from "./types";

package/dist/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CELO_DICE_ROLL_ABI = exports.CeloDiceRollClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "CeloDiceRollClient", { enumerable: true, get: function () { return client_1.CeloDiceRollClient; } });
+Object.defineProperty(exports, "CELO_DICE_ROLL_ABI", { enumerable: true, get: function () { return client_1.CELO_DICE_ROLL_ABI; } });

package/dist/types.d.ts

@@ -0,0 +1,16 @@
+export interface LeaderboardEntry {
+    address: string;
+    score: number;
+    rank: number;
+}
+export interface DiceRollStats {
+    rolls: number;
+    wins: number;
+    lastTarget: number;
+    lastRoll: number;
+    winRate: number;
+}
+export interface CeloDiceRollConfig {
+    contractAddress: string;
+    rpcUrl?: string;
+}

package/dist/types.js

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "celo-dice-roll-sdk",
+  "version": "1.0.0",
+  "description": "TypeScript SDK for the Celo Dice Roll MiniApp",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "keywords": [
+    "celo",
+    "blockchain",
+    "web3",
+    "sdk",
+    "smart-contract",
+    "solidity",
+    "evm",
+    "dapp",
+    "typescript",
+    "minipay",
+    "dice",
+    "game"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "ethers": "^6.9.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "author": "brventonbeshers-ship-it",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/brventonbeshers-ship-it/celo-dice-roll-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/brventonbeshers-ship-it/celo-dice-roll-sdk/issues"
+  },
+  "homepage": "https://github.com/brventonbeshers-ship-it/celo-dice-roll-sdk#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}