@slvr-labs/sdk 0.1.0

package/dist/events.d.ts

@@ -0,0 +1,418 @@
+import { Address, Log } from 'viem';
+/**
+ * Event ABIs for Slvr contracts
+ */
+export declare const SlvrGridLotteryEvents: readonly [{
+    readonly name: "BetPlaced";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "roundId";
+        readonly indexed: true;
+    }, {
+        readonly type: "address";
+        readonly name: "beneficiary";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint256";
+        readonly name: "total";
+    }, {
+        readonly type: "uint8[]";
+        readonly name: "squares";
+    }];
+}, {
+    readonly name: "Claimed";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "roundId";
+        readonly indexed: true;
+    }, {
+        readonly type: "address";
+        readonly name: "user";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint256";
+        readonly name: "nativeOut";
+    }, {
+        readonly type: "uint256";
+        readonly name: "slvrOut";
+    }, {
+        readonly type: "uint256";
+        readonly name: "refinedOut";
+    }, {
+        readonly type: "uint256";
+        readonly name: "refiningFee";
+    }];
+}, {
+    readonly name: "RoundResolved";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "roundId";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint8";
+        readonly name: "winningSquare";
+    }, {
+        readonly type: "bool";
+        readonly name: "jackpotHit";
+    }, {
+        readonly type: "bool";
+        readonly name: "singleMinerRound";
+    }, {
+        readonly type: "address";
+        readonly name: "singleMinerWinner";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint256";
+        readonly name: "winnerTotal";
+    }, {
+        readonly type: "uint256";
+        readonly name: "potForWinners";
+    }, {
+        readonly type: "uint256";
+        readonly name: "slvrForWinners";
+    }, {
+        readonly type: "uint256";
+        readonly name: "totalUnclaimedSlvr";
+    }];
+}, {
+    readonly name: "RandomnessRequested";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "roundId";
+        readonly indexed: true;
+    }, {
+        readonly type: "bytes32";
+        readonly name: "randomnessId";
+    }];
+}];
+/**
+ * Events for the veNFT staker (`SlvrVoteEscrowStaking`). All staking events are
+ * keyed by the veNFT `tokenId`; there are no raw-ERC20-amount stake events.
+ */
+export declare const SlvrStakingEvents: readonly [{
+    readonly name: "Staked";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "tokenId";
+        readonly indexed: true;
+    }, {
+        readonly type: "address";
+        readonly name: "user";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint256";
+        readonly name: "weight";
+    }];
+}, {
+    readonly name: "Unstaked";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "tokenId";
+        readonly indexed: true;
+    }, {
+        readonly type: "address";
+        readonly name: "user";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint256";
+        readonly name: "weight";
+    }];
+}, {
+    readonly name: "RewardClaimed";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "tokenId";
+        readonly indexed: true;
+    }, {
+        readonly type: "address";
+        readonly name: "user";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint256";
+        readonly name: "amount";
+    }];
+}, {
+    readonly name: "RewardDistributed";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "amount";
+    }];
+}, {
+    readonly name: "Checkpoint";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "tokenId";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint256";
+        readonly name: "oldWeight";
+    }, {
+        readonly type: "uint256";
+        readonly name: "newWeight";
+    }];
+}, {
+    readonly name: "RewardsSettledOnBurn";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "tokenId";
+        readonly indexed: true;
+    }, {
+        readonly type: "address";
+        readonly name: "owner";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint256";
+        readonly name: "amount";
+    }];
+}, {
+    readonly name: "PendingRewardsClaimed";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "user";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint256";
+        readonly name: "amount";
+    }];
+}];
+export declare const SlvrTokenEvents: readonly [{
+    readonly name: "Transfer";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "from";
+        readonly indexed: true;
+    }, {
+        readonly type: "address";
+        readonly name: "to";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint256";
+        readonly name: "value";
+    }];
+}, {
+    readonly name: "Approval";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "owner";
+        readonly indexed: true;
+    }, {
+        readonly type: "address";
+        readonly name: "spender";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint256";
+        readonly name: "value";
+    }];
+}];
+export declare const SlvrAutoCommitEvents: readonly [{
+    readonly name: "PlanConfigured";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "user";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint256";
+        readonly name: "nextRoundId";
+    }, {
+        readonly type: "uint32";
+        readonly name: "plays";
+    }, {
+        readonly type: "uint256";
+        readonly name: "amountPerPlay";
+    }, {
+        readonly type: "bool";
+        readonly name: "autoClaim";
+    }];
+}, {
+    readonly name: "PlanDisabled";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "user";
+        readonly indexed: true;
+    }];
+}, {
+    readonly name: "PlanCancelled";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "user";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint256";
+        readonly name: "refundAmount";
+    }];
+}, {
+    readonly name: "Deposited";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "user";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint256";
+        readonly name: "amount";
+    }];
+}, {
+    readonly name: "Withdrawn";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "user";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint256";
+        readonly name: "amount";
+    }, {
+        readonly type: "address";
+        readonly name: "to";
+    }];
+}, {
+    readonly name: "RoundExecuted";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "user";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint256";
+        readonly name: "roundId";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint32";
+        readonly name: "playsRemaining";
+    }];
+}, {
+    readonly name: "Claimed";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "user";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint256";
+        readonly name: "roundId";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint256";
+        readonly name: "nativeAmount";
+    }, {
+        readonly type: "uint256";
+        readonly name: "addedToBalance";
+    }];
+}, {
+    readonly name: "BalanceUpdated";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "user";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint256";
+        readonly name: "newBalance";
+    }, {
+        readonly type: "uint256";
+        readonly name: "amountAdded";
+    }];
+}, {
+    readonly name: "ExecutorFeePaid";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "user";
+        readonly indexed: true;
+    }, {
+        readonly type: "address";
+        readonly name: "executor";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint256";
+        readonly name: "fee";
+    }, {
+        readonly type: "uint256";
+        readonly name: "gasUsed";
+    }];
+}];
+/**
+ * Decode a log using the provided ABI
+ * @param abi Contract ABI
+ * @param log Log to decode
+ * @returns Decoded event or null if decoding fails
+ */
+export declare function decodeEvent<T = unknown>(abi: readonly unknown[], log: Log): T | null;
+/**
+ * Filter and decode events from logs
+ * @param abi Contract ABI
+ * @param logs Array of logs
+ * @param eventName Optional event name to filter by
+ * @returns Array of decoded events
+ */
+export declare function decodeEvents<T = unknown>(abi: readonly unknown[], logs: Log[], eventName?: string): T[];
+/**
+ * BetPlaced event data
+ */
+export interface BetPlacedEvent {
+    eventName: 'BetPlaced';
+    args: {
+        roundId: bigint;
+        beneficiary: Address;
+        total: bigint;
+        squares: readonly number[];
+    };
+}
+/**
+ * Claimed event data
+ */
+export interface ClaimedEvent {
+    eventName: 'Claimed';
+    args: {
+        roundId: bigint;
+        user: Address;
+        nativeOut: bigint;
+        slvrOut: bigint;
+        refinedOut: bigint;
+        refiningFee: bigint;
+    };
+}
+/**
+ * Round resolved event data
+ */
+export interface RoundResolvedEvent {
+    eventName: 'RoundResolved';
+    args: {
+        roundId: bigint;
+        winningSquare: number;
+        jackpotHit: boolean;
+        singleMinerRound: boolean;
+        singleMinerWinner: Address;
+        winnerTotal: bigint;
+        potForWinners: bigint;
+        slvrForWinners: bigint;
+        totalUnclaimedSlvr: bigint;
+    };
+}
+/**
+ * RandomnessRequested event data
+ */
+export interface RandomnessRequestedEvent {
+    eventName: 'RandomnessRequested';
+    args: {
+        roundId: bigint;
+        randomnessId: `0x${string}`;
+    };
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA4B,GAAG,EAAE,MAAM,MAAM,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKhC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ5B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG1B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU/B,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,SAAS,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,GAAG,IAAI,CAWpF;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EACtC,GAAG,EAAE,SAAS,OAAO,EAAE,EACvB,IAAI,EAAE,GAAG,EAAE,EACX,SAAS,CAAC,EAAE,MAAM,GACjB,CAAC,EAAE,CAiBL;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,WAAW,CAAC;IACvB,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,OAAO,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;KAC5B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,SAAS,CAAC;IACrB,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,OAAO,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,eAAe,CAAC;IAC3B,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,OAAO,CAAC;QACpB,gBAAgB,EAAE,OAAO,CAAC;QAC1B,iBAAiB,EAAE,OAAO,CAAC;QAC3B,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,qBAAqB,CAAC;IACjC,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,KAAK,MAAM,EAAE,CAAC;KAC7B,CAAC;CACH"}

package/dist/events.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SlvrAutoCommitEvents = exports.SlvrTokenEvents = exports.SlvrStakingEvents = exports.SlvrGridLotteryEvents = void 0;
+exports.decodeEvent = decodeEvent;
+exports.decodeEvents = decodeEvents;
+const viem_1 = require("viem");
+/**
+ * Event ABIs for Slvr contracts
+ */
+exports.SlvrGridLotteryEvents = (0, viem_1.parseAbi)([
+    'event BetPlaced(uint256 indexed roundId, address indexed beneficiary, uint256 total, uint8[] squares)',
+    'event Claimed(uint256 indexed roundId, address indexed user, uint256 nativeOut, uint256 slvrOut, uint256 refinedOut, uint256 refiningFee)',
+    'event RoundResolved(uint256 indexed roundId, uint8 winningSquare, bool jackpotHit, bool singleMinerRound, address indexed singleMinerWinner, uint256 winnerTotal, uint256 potForWinners, uint256 slvrForWinners, uint256 totalUnclaimedSlvr)',
+    'event RandomnessRequested(uint256 indexed roundId, bytes32 randomnessId)',
+]);
+/**
+ * Events for the veNFT staker (`SlvrVoteEscrowStaking`). All staking events are
+ * keyed by the veNFT `tokenId`; there are no raw-ERC20-amount stake events.
+ */
+exports.SlvrStakingEvents = (0, viem_1.parseAbi)([
+    'event Staked(uint256 indexed tokenId, address indexed user, uint256 weight)',
+    'event Unstaked(uint256 indexed tokenId, address indexed user, uint256 weight)',
+    'event RewardClaimed(uint256 indexed tokenId, address indexed user, uint256 amount)',
+    'event RewardDistributed(uint256 amount)',
+    'event Checkpoint(uint256 indexed tokenId, uint256 oldWeight, uint256 newWeight)',
+    'event RewardsSettledOnBurn(uint256 indexed tokenId, address indexed owner, uint256 amount)',
+    'event PendingRewardsClaimed(address indexed user, uint256 amount)',
+]);
+exports.SlvrTokenEvents = (0, viem_1.parseAbi)([
+    'event Transfer(address indexed from, address indexed to, uint256 value)',
+    'event Approval(address indexed owner, address indexed spender, uint256 value)',
+]);
+exports.SlvrAutoCommitEvents = (0, viem_1.parseAbi)([
+    'event PlanConfigured(address indexed user, uint256 nextRoundId, uint32 plays, uint256 amountPerPlay, bool autoClaim)',
+    'event PlanDisabled(address indexed user)',
+    'event PlanCancelled(address indexed user, uint256 refundAmount)',
+    'event Deposited(address indexed user, uint256 amount)',
+    'event Withdrawn(address indexed user, uint256 amount, address to)',
+    'event RoundExecuted(address indexed user, uint256 indexed roundId, uint32 playsRemaining)',
+    'event Claimed(address indexed user, uint256 indexed roundId, uint256 nativeAmount, uint256 addedToBalance)',
+    'event BalanceUpdated(address indexed user, uint256 newBalance, uint256 amountAdded)',
+    'event ExecutorFeePaid(address indexed user, address indexed executor, uint256 fee, uint256 gasUsed)',
+]);
+/**
+ * Decode a log using the provided ABI
+ * @param abi Contract ABI
+ * @param log Log to decode
+ * @returns Decoded event or null if decoding fails
+ */
+function decodeEvent(abi, log) {
+    try {
+        const decoded = (0, viem_1.decodeEventLog)({
+            abi,
+            data: log.data,
+            topics: log.topics,
+        });
+        return decoded;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Filter and decode events from logs
+ * @param abi Contract ABI
+ * @param logs Array of logs
+ * @param eventName Optional event name to filter by
+ * @returns Array of decoded events
+ */
+function decodeEvents(abi, logs, eventName) {
+    const decoded = [];
+    for (const log of logs) {
+        try {
+            const decodedEvent = decodeEvent(abi, log);
+            if (decodedEvent) {
+                if (!eventName || decodedEvent.eventName === eventName) {
+                    decoded.push(decodedEvent);
+                }
+            }
+        }
+        catch {
+            // Skip invalid logs
+        }
+    }
+    return decoded;
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":";;;AAiDA,kCAWC;AASD,oCAqBC;AA1FD,+BAA8D;AAE9D;;GAEG;AACU,QAAA,qBAAqB,GAAG,IAAA,eAAQ,EAAC;IAC5C,uGAAuG;IACvG,2IAA2I;IAC3I,8OAA8O;IAC9O,0EAA0E;CAC3E,CAAC,CAAC;AAEH;;;GAGG;AACU,QAAA,iBAAiB,GAAG,IAAA,eAAQ,EAAC;IACxC,6EAA6E;IAC7E,+EAA+E;IAC/E,oFAAoF;IACpF,yCAAyC;IACzC,iFAAiF;IACjF,4FAA4F;IAC5F,mEAAmE;CACpE,CAAC,CAAC;AAEU,QAAA,eAAe,GAAG,IAAA,eAAQ,EAAC;IACtC,yEAAyE;IACzE,+EAA+E;CAChF,CAAC,CAAC;AAEU,QAAA,oBAAoB,GAAG,IAAA,eAAQ,EAAC;IAC3C,sHAAsH;IACtH,0CAA0C;IAC1C,iEAAiE;IACjE,uDAAuD;IACvD,mEAAmE;IACnE,2FAA2F;IAC3F,4GAA4G;IAC5G,qFAAqF;IACrF,qGAAqG;CACtG,CAAC,CAAC;AAEH;;;;;GAKG;AACH,SAAgB,WAAW,CAAc,GAAuB,EAAE,GAAQ;IACxE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,qBAAc,EAAC;YAC7B,GAAG;YACH,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,MAAM,EAAE,GAAG,CAAC,MAAM;SACnB,CAAC,CAAC;QACH,OAAO,OAAY,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,YAAY,CAC1B,GAAuB,EACvB,IAAW,EACX,SAAkB;IAElB,MAAM,OAAO,GAAQ,EAAE,CAAC;IAExB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,WAAW,CAAI,GAAG,EAAE,GAAG,CAAC,CAAC;YAC9C,IAAI,YAAY,EAAE,CAAC;gBACjB,IAAI,CAAC,SAAS,IAAK,YAAuC,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;oBACnF,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oBAAoB;QACtB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}