@backchain/events 0.3.0

package/README.md

@@ -0,0 +1,81 @@
+# @backchain/events
+
+Type-safe event parsing and log filtering for all Backchain smart contracts.
+
+## Install
+
+```bash
+npm install @backchain/events
+```
+
+## Quick Start
+
+```ts
+import { EventParser, FilterBuilder, ALL_EVENT_ABIS } from '@backchain/events';
+
+const parser = new EventParser(ALL_EVENT_ABIS);
+const events = parser.parseReceipt(txReceipt);
+
+const filter = new FilterBuilder()
+  .contract(addresses.StakingPool)
+  .event('Staked')
+  .fromBlock(10_308_450n)
+  .build();
+const logs = await provider.getLogs(filter);
+```
+
+## API
+
+### Classes
+
+#### `EventParser`
+Parses raw transaction receipts or log arrays into typed event objects.
+
+- `new EventParser(abis: Abi[]): EventParser` — instantiate with one or more contract ABI arrays.
+- `parseReceipt(receipt: TransactionReceipt): ParsedEvent[]` — parse all logs in a receipt.
+- `parseLogs(logs: Log[]): ParsedEvent[]` — parse an arbitrary array of logs.
+- `parseLog(log: Log): ParsedEvent | null` — parse a single log; returns `null` if unrecognised.
+
+#### `FilterBuilder`
+Fluent builder for constructing `eth_getLogs` filter objects.
+
+- `contract(address: string): this` — filter by contract address.
+- `event(name: string): this` — filter by event name (resolved to topic0).
+- `fromBlock(block: bigint | 'latest'): this` — set the starting block.
+- `toBlock(block: bigint | 'latest'): this` — set the ending block.
+- `topic(index: 1 | 2 | 3, value: string): this` — add an indexed topic filter.
+- `build(): Filter` — return the final filter object.
+
+### Exports
+
+#### `ALL_EVENT_ABIS`
+Array of all event ABI fragments across all Backchain contracts (117 event signatures).
+
+#### `ALL_EVENTS_FLAT`
+Flat array of parsed `EventFragment` objects from every contract.
+
+### Per-Contract Event Sets
+
+Each export contains the event ABI fragments for a single contract:
+
+| Export | Contract |
+|---|---|
+| `BKC_TOKEN_EVENTS` | BKCToken |
+| `ECOSYSTEM_EVENTS` | BackchainEcosystem |
+| `STAKING_EVENTS` | StakingPool |
+| `LIQUIDITY_EVENTS` | LiquidityPool |
+| `BUYBACK_EVENTS` | BuybackMiner |
+| `BOOSTER_EVENTS` | RewardBooster |
+| `NFT_POOL_EVENTS` | NFTPool |
+| `NFT_FUSION_EVENTS` | NFTFusion |
+| `RENTAL_EVENTS` | RentalManager |
+| `FORTUNE_EVENTS` | FortunePool |
+| `AGORA_EVENTS` | Agora |
+| `NOTARY_EVENTS` | Notary |
+| `CHARITY_EVENTS` | CharityPool |
+| `GOVERNANCE_EVENTS` | BackchainGovernance |
+| `FAUCET_EVENTS` | SimpleBKCFaucet |
+
+## License
+
+MIT

package/dist/abis.d.ts

@@ -0,0 +1,40 @@
+export declare const BKC_TOKEN_EVENTS: readonly ["event Transfer(address indexed from, address indexed to, uint256 value)", "event Approval(address indexed owner, address indexed spender, uint256 value)", "event MinterAdded(address indexed minter)", "event MinterRemoved(address indexed minter)", "event MinterAdminRenounced(address indexed deployer)", "event TokensBurned(address indexed from, uint256 amount, uint256 newTotalSupply, uint256 totalBurnedAllTime)", "event TokensMinted(address indexed to, uint256 amount, uint256 newTotalSupply)"];
+export declare const ECOSYSTEM_EVENTS: readonly ["event FeeCollected(bytes32 indexed moduleId, address indexed user, address operator, address customRecipient, uint256 ethAmount, uint256 bkcFee)", "event EthDistributed(uint256 toReferrer, uint256 toCustom, uint256 toOperator, uint256 toTreasury, uint256 toBuyback)", "event BkcFeeDistributed(uint256 burned, uint256 toOperator, uint256 toStakers, uint256 toTreasury)", "event EthWithdrawn(address indexed recipient, uint256 amount)", "event BuybackETHWithdrawn(address indexed buyback, uint256 amount)", "event TutorSet(address indexed user, address indexed tutor)", "event TutorChanged(address indexed user, address indexed oldTutor, address indexed newTutor)", "event TutorRelayerUpdated(address indexed oldRelayer, address indexed newRelayer)", "event TutorBpsUpdated(uint16 newBps)", "event TutorBonusPaid(address indexed user, uint256 amount)", "event TutorBonusFunded(address indexed funder, uint256 amount, uint256 newPool)", "event TutorBonusAmountUpdated(uint256 oldAmount, uint256 newAmount)", "event TutorFeeUpdated(uint256 oldFee, uint256 newFee)", "event ChangeTutorFeeUpdated(uint256 oldFee, uint256 newFee)", "event ModuleRegistered(bytes32 indexed moduleId, address indexed contractAddr)", "event ContractDeauthorized(bytes32 indexed moduleId, address indexed contractAddr)", "event ModuleConfigUpdated(bytes32 indexed moduleId)", "event ModuleActivated(bytes32 indexed moduleId)", "event ModuleDeactivated(bytes32 indexed moduleId)", "event FeeConfigUpdated(bytes32 indexed actionId)", "event TreasuryUpdated(address indexed oldAddr, address indexed newAddr)", "event BuybackMinerUpdated(address indexed oldAddr, address indexed newAddr)", "event StakingPoolUpdated(address indexed oldAddr, address indexed newAddr)", "event BkcDistributionUpdated(uint16 burnBps, uint16 operatorBps, uint16 stakerBps, uint16 treasuryBps)", "event OwnershipTransferStarted(address indexed currentOwner, address indexed pendingOwner)", "event OwnershipTransferred(address indexed oldOwner, address indexed newOwner)", "event TokenRecovered(address indexed token, address indexed to, uint256 amount)"];
+export declare const STAKING_EVENTS: readonly ["event Delegated(address indexed user, uint256 indexed delegationIndex, uint256 amount, uint256 pStake, uint256 lockDays, address operator)", "event Unstaked(address indexed user, uint256 indexed delegationIndex, uint256 amountReturned)", "event ForceUnstaked(address indexed user, uint256 indexed delegationIndex, uint256 amountReturned, uint256 totalPenalty, uint256 recycledAmount, uint256 burnedAmount, uint256 tutorAmount, address tutor, address operator)", "event RewardsClaimed(address indexed user, uint256 totalRewards, uint256 recycledAmount, uint256 burnedAmount, uint256 tutorAmount, uint256 userReceived, uint256 nftBoostUsed, address tutor, address operator)", "event RewardNotified(uint256 amount, uint256 newAccRewardPerShare)", "event RewardNotifierSet(address indexed notifier, bool authorized)", "event RewardBoosterUpdated(address indexed oldBooster, address indexed newBooster)", "event ForceUnstakeEthFeeUpdated(uint256 oldFee, uint256 newFee)", "event DelegateForAuthorizationSet(address indexed contractAddr, bool authorized)"];
+export declare const LIQUIDITY_POOL_EVENTS: readonly ["event LiquidityAdded(address indexed provider, uint256 ethAmount, uint256 bkcAmount, uint256 shares)", "event LiquidityRemoved(address indexed provider, uint256 ethAmount, uint256 bkcAmount, uint256 shares)", "event SwapETHforBKC(address indexed buyer, uint256 ethIn, uint256 bkcOut)", "event SwapBKCforETH(address indexed seller, uint256 bkcIn, uint256 ethOut)"];
+export declare const BUYBACK_EVENTS: readonly ["event BuybackExecuted(address indexed caller, uint256 indexed buybackNumber, uint256 callerReward, uint256 ethSpent, uint256 bkcPurchased, uint256 bkcMined, uint256 bkcBurned, uint256 bkcToStakers, uint256 miningRateBps)", "event SwapTargetUpdated(address indexed oldPool, address indexed newPool)", "event ExecutionFeeUpdated(uint256 oldFee, uint256 newFee)", "event OwnershipTransferStarted(address indexed currentOwner, address indexed newOwner)", "event OwnershipTransferred(address indexed oldOwner, address indexed newOwner)"];
+export declare const REWARD_BOOSTER_EVENTS: readonly ["event Transfer(address indexed from, address indexed to, uint256 indexed tokenId)", "event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId)", "event ApprovalForAll(address indexed owner, address indexed operator, bool approved)", "event PoolsConfigured(address[4] pools)", "event FusionContractSet(address indexed fusionAddr)", "event FusionMinted(address indexed to, uint256 indexed tokenId, uint8 tier)", "event FusionBurned(address indexed from, uint256 indexed tokenId, uint8 tier)"];
+export declare const NFT_POOL_EVENTS: readonly ["event PoolInitialized(uint8 tier, uint256 nftCount, uint256 mintableReserves, uint256 bkcAmount, uint256 virtualReserves, uint256 initialK)", "event NFTPurchased(address indexed buyer, uint256 indexed tokenId, uint256 price, uint256 ethFee, uint256 newNftCount, address operator)", "event NFTSold(address indexed seller, uint256 indexed tokenId, uint256 payout, uint256 ethFee, uint256 newNftCount, address operator)"];
+export declare const NFT_FUSION_EVENTS: readonly ["event Fused(address indexed user, uint256 indexed tokenId1, uint256 indexed tokenId2, uint256 newTokenId, uint8 sourceTier, uint8 resultTier, address operator)", "event Split(address indexed user, uint256 indexed burnedTokenId, uint8 sourceTier, uint8 targetTier, uint256 mintCount, uint256[] newTokenIds, address operator)"];
+export declare const FORTUNE_EVENTS: readonly ["event GameCommitted(uint256 indexed gameId, address indexed player, uint256 wagerAmount, uint8 tierMask, address operator)", "event GameRevealed(uint256 indexed gameId, address indexed player, uint256 grossWager, uint256 prizeWon, uint8 tierMask, uint8 matchCount, address operator)", "event GameDetails(uint256 indexed gameId, uint8 tierMask, uint256[] guesses, uint256[] rolls, bool[] matches)", "event GameExpired(uint256 indexed gameId, address indexed player, uint256 forfeitedAmount)", "event PrizePoolFunded(address indexed funder, uint256 amount)", "event ExcessBurned(uint256 amount, uint256 totalBurned)"];
+export declare const NOTARY_EVENTS: readonly ["event Certified(uint256 indexed certId, address indexed owner, bytes32 indexed documentHash, uint8 docType, address operator)", "event BatchCertified(address indexed owner, uint256 startId, uint256 count, address operator)", "event CertificateTransferred(bytes32 indexed documentHash, address indexed from, address indexed to)", "event CertificateBoosted(bytes32 indexed documentHash, address indexed booster, uint32 boostExpiry, address operator)"];
+export declare const CHARITY_EVENTS: readonly ["event CampaignCreated(uint256 indexed campaignId, address indexed owner, uint96 goal, uint48 deadline, address operator)", "event DonationMade(uint256 indexed campaignId, address indexed donor, uint256 grossAmount, uint256 netAmount, address operator)", "event CampaignBoosted(uint256 indexed campaignId, address indexed booster, uint48 boostExpiry, address operator)", "event CampaignClosed(uint256 indexed campaignId, address indexed owner, uint96 raised)", "event FundsWithdrawn(uint256 indexed campaignId, address indexed owner, uint96 amount)"];
+export declare const AGORA_EVENTS: readonly ["event PostCreated(uint256 indexed postId, address indexed author, uint8 tag, uint8 contentType, string contentHash, address operator)", "event ReplyCreated(uint256 indexed postId, uint256 indexed parentId, address indexed author, uint8 tag, uint8 contentType, string contentHash, address operator)", "event RepostCreated(uint256 indexed postId, uint256 indexed originalId, address indexed author, uint8 tag, string contentHash, address operator)", "event PostEdited(uint256 indexed postId, address indexed author, string newContentHash)", "event PostDeleted(uint256 indexed postId, address indexed author)", "event TagChanged(uint256 indexed postId, uint8 oldTag, uint8 newTag)", "event Liked(uint256 indexed postId, address indexed liker, address indexed author, address operator)", "event SuperLiked(uint256 indexed postId, address indexed voter, address indexed author, uint256 amount, address operator)", "event Downvoted(uint256 indexed postId, address indexed voter, address indexed author, address operator)", "event Followed(address indexed follower, address indexed followed, address operator)", "event Unfollowed(address indexed follower, address indexed followed)", "event PostReported(uint256 indexed postId, address indexed reporter, address indexed author, uint8 category, uint256 totalReports)", "event PostBoosted(uint256 indexed postId, address indexed booster, uint8 tier, uint64 boostExpiry, address operator)", "event PostTipped(uint256 indexed postId, address indexed tipper, address indexed author, uint256 amount, address operator)", "event UserBlocked(address indexed blocker, address indexed blocked)", "event UserUnblocked(address indexed blocker, address indexed unblocked)", "event ProfileCreated(address indexed user, string metadataURI)", "event ProfileUpdated(address indexed user, string metadataURI)", "event PostPinned(address indexed user, uint256 indexed postId)", "event ProfileBoosted(address indexed user, uint64 boostExpiry, address operator)", "event BadgeObtained(address indexed user, uint8 tier, uint64 badgeExpiry, address operator)"];
+export declare const RENTAL_EVENTS: readonly ["event NFTListed(uint256 indexed tokenId, address indexed owner, uint96 pricePerDay)", "event ListingUpdated(uint256 indexed tokenId, uint96 pricePerDay)", "event NFTWithdrawn(uint256 indexed tokenId, address indexed owner)", "event NFTRented(uint256 indexed tokenId, address indexed tenant, address indexed owner, uint256 rentalCost, uint256 ethFee, uint48 endTime, address operator)", "event ListingBoosted(uint256 indexed tokenId, address indexed owner, uint256 days_, uint256 boostCost, uint32 newBoostExpiry)", "event EarningsWithdrawn(address indexed owner, uint256 amount)"];
+export declare const FAUCET_EVENTS: readonly ["event Claimed(address indexed recipient, uint256 tokens, uint256 eth, address indexed via)", "event ConfigUpdated(address relayer, uint256 tokensPerClaim, uint256 ethPerClaim, uint256 cooldown)", "event Paused(bool isPaused)", "event FundsDeposited(address indexed sender, uint256 eth, uint256 tokens)", "event FundsWithdrawn(address indexed to, uint256 eth, uint256 tokens)"];
+export declare const GOVERNANCE_EVENTS: readonly ["event AdminTransferred(address indexed previous, address indexed current)", "event PendingAdminSet(address indexed pending)", "event PhaseAdvanced(uint8 indexed previous, uint8 indexed current)", "event DAOSet(address indexed daoAddress)", "event TimelockDelayUpdated(uint256 previous, uint256 current)", "event ProposalCreated(uint256 indexed proposalId, address indexed target, uint256 value, bytes data, uint256 eta, string description)", "event ProposalExecuted(uint256 indexed proposalId)", "event ProposalCancelled(uint256 indexed proposalId)", "event DirectExecution(address indexed target, uint256 value, bytes data)"];
+export declare const AIRDROP_EVENTS: readonly ["event AllocationSet(address indexed beneficiary, uint256 amount)", "event AllocationFinalized(uint256 totalAllocated, uint256 beneficiaryCount)", "event ClaimedAndStaked(address indexed beneficiary, uint256 amount, uint256 lockDays)", "event ClaimedVested(address indexed beneficiary, uint256 totalAmount, uint256 firstRelease)", "event VestedWithdrawn(address indexed beneficiary, uint256 amount, uint256 totalWithdrawn, uint256 remaining)"];
+/** All event ABIs grouped by contract name */
+export declare const ALL_EVENT_ABIS: {
+    readonly BKCToken: readonly ["event Transfer(address indexed from, address indexed to, uint256 value)", "event Approval(address indexed owner, address indexed spender, uint256 value)", "event MinterAdded(address indexed minter)", "event MinterRemoved(address indexed minter)", "event MinterAdminRenounced(address indexed deployer)", "event TokensBurned(address indexed from, uint256 amount, uint256 newTotalSupply, uint256 totalBurnedAllTime)", "event TokensMinted(address indexed to, uint256 amount, uint256 newTotalSupply)"];
+    readonly BackchainEcosystem: readonly ["event FeeCollected(bytes32 indexed moduleId, address indexed user, address operator, address customRecipient, uint256 ethAmount, uint256 bkcFee)", "event EthDistributed(uint256 toReferrer, uint256 toCustom, uint256 toOperator, uint256 toTreasury, uint256 toBuyback)", "event BkcFeeDistributed(uint256 burned, uint256 toOperator, uint256 toStakers, uint256 toTreasury)", "event EthWithdrawn(address indexed recipient, uint256 amount)", "event BuybackETHWithdrawn(address indexed buyback, uint256 amount)", "event TutorSet(address indexed user, address indexed tutor)", "event TutorChanged(address indexed user, address indexed oldTutor, address indexed newTutor)", "event TutorRelayerUpdated(address indexed oldRelayer, address indexed newRelayer)", "event TutorBpsUpdated(uint16 newBps)", "event TutorBonusPaid(address indexed user, uint256 amount)", "event TutorBonusFunded(address indexed funder, uint256 amount, uint256 newPool)", "event TutorBonusAmountUpdated(uint256 oldAmount, uint256 newAmount)", "event TutorFeeUpdated(uint256 oldFee, uint256 newFee)", "event ChangeTutorFeeUpdated(uint256 oldFee, uint256 newFee)", "event ModuleRegistered(bytes32 indexed moduleId, address indexed contractAddr)", "event ContractDeauthorized(bytes32 indexed moduleId, address indexed contractAddr)", "event ModuleConfigUpdated(bytes32 indexed moduleId)", "event ModuleActivated(bytes32 indexed moduleId)", "event ModuleDeactivated(bytes32 indexed moduleId)", "event FeeConfigUpdated(bytes32 indexed actionId)", "event TreasuryUpdated(address indexed oldAddr, address indexed newAddr)", "event BuybackMinerUpdated(address indexed oldAddr, address indexed newAddr)", "event StakingPoolUpdated(address indexed oldAddr, address indexed newAddr)", "event BkcDistributionUpdated(uint16 burnBps, uint16 operatorBps, uint16 stakerBps, uint16 treasuryBps)", "event OwnershipTransferStarted(address indexed currentOwner, address indexed pendingOwner)", "event OwnershipTransferred(address indexed oldOwner, address indexed newOwner)", "event TokenRecovered(address indexed token, address indexed to, uint256 amount)"];
+    readonly StakingPool: readonly ["event Delegated(address indexed user, uint256 indexed delegationIndex, uint256 amount, uint256 pStake, uint256 lockDays, address operator)", "event Unstaked(address indexed user, uint256 indexed delegationIndex, uint256 amountReturned)", "event ForceUnstaked(address indexed user, uint256 indexed delegationIndex, uint256 amountReturned, uint256 totalPenalty, uint256 recycledAmount, uint256 burnedAmount, uint256 tutorAmount, address tutor, address operator)", "event RewardsClaimed(address indexed user, uint256 totalRewards, uint256 recycledAmount, uint256 burnedAmount, uint256 tutorAmount, uint256 userReceived, uint256 nftBoostUsed, address tutor, address operator)", "event RewardNotified(uint256 amount, uint256 newAccRewardPerShare)", "event RewardNotifierSet(address indexed notifier, bool authorized)", "event RewardBoosterUpdated(address indexed oldBooster, address indexed newBooster)", "event ForceUnstakeEthFeeUpdated(uint256 oldFee, uint256 newFee)", "event DelegateForAuthorizationSet(address indexed contractAddr, bool authorized)"];
+    readonly LiquidityPool: readonly ["event LiquidityAdded(address indexed provider, uint256 ethAmount, uint256 bkcAmount, uint256 shares)", "event LiquidityRemoved(address indexed provider, uint256 ethAmount, uint256 bkcAmount, uint256 shares)", "event SwapETHforBKC(address indexed buyer, uint256 ethIn, uint256 bkcOut)", "event SwapBKCforETH(address indexed seller, uint256 bkcIn, uint256 ethOut)"];
+    readonly BuybackMiner: readonly ["event BuybackExecuted(address indexed caller, uint256 indexed buybackNumber, uint256 callerReward, uint256 ethSpent, uint256 bkcPurchased, uint256 bkcMined, uint256 bkcBurned, uint256 bkcToStakers, uint256 miningRateBps)", "event SwapTargetUpdated(address indexed oldPool, address indexed newPool)", "event ExecutionFeeUpdated(uint256 oldFee, uint256 newFee)", "event OwnershipTransferStarted(address indexed currentOwner, address indexed newOwner)", "event OwnershipTransferred(address indexed oldOwner, address indexed newOwner)"];
+    readonly RewardBooster: readonly ["event Transfer(address indexed from, address indexed to, uint256 indexed tokenId)", "event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId)", "event ApprovalForAll(address indexed owner, address indexed operator, bool approved)", "event PoolsConfigured(address[4] pools)", "event FusionContractSet(address indexed fusionAddr)", "event FusionMinted(address indexed to, uint256 indexed tokenId, uint8 tier)", "event FusionBurned(address indexed from, uint256 indexed tokenId, uint8 tier)"];
+    readonly NFTPool: readonly ["event PoolInitialized(uint8 tier, uint256 nftCount, uint256 mintableReserves, uint256 bkcAmount, uint256 virtualReserves, uint256 initialK)", "event NFTPurchased(address indexed buyer, uint256 indexed tokenId, uint256 price, uint256 ethFee, uint256 newNftCount, address operator)", "event NFTSold(address indexed seller, uint256 indexed tokenId, uint256 payout, uint256 ethFee, uint256 newNftCount, address operator)"];
+    readonly NFTFusion: readonly ["event Fused(address indexed user, uint256 indexed tokenId1, uint256 indexed tokenId2, uint256 newTokenId, uint8 sourceTier, uint8 resultTier, address operator)", "event Split(address indexed user, uint256 indexed burnedTokenId, uint8 sourceTier, uint8 targetTier, uint256 mintCount, uint256[] newTokenIds, address operator)"];
+    readonly FortunePool: readonly ["event GameCommitted(uint256 indexed gameId, address indexed player, uint256 wagerAmount, uint8 tierMask, address operator)", "event GameRevealed(uint256 indexed gameId, address indexed player, uint256 grossWager, uint256 prizeWon, uint8 tierMask, uint8 matchCount, address operator)", "event GameDetails(uint256 indexed gameId, uint8 tierMask, uint256[] guesses, uint256[] rolls, bool[] matches)", "event GameExpired(uint256 indexed gameId, address indexed player, uint256 forfeitedAmount)", "event PrizePoolFunded(address indexed funder, uint256 amount)", "event ExcessBurned(uint256 amount, uint256 totalBurned)"];
+    readonly Notary: readonly ["event Certified(uint256 indexed certId, address indexed owner, bytes32 indexed documentHash, uint8 docType, address operator)", "event BatchCertified(address indexed owner, uint256 startId, uint256 count, address operator)", "event CertificateTransferred(bytes32 indexed documentHash, address indexed from, address indexed to)", "event CertificateBoosted(bytes32 indexed documentHash, address indexed booster, uint32 boostExpiry, address operator)"];
+    readonly CharityPool: readonly ["event CampaignCreated(uint256 indexed campaignId, address indexed owner, uint96 goal, uint48 deadline, address operator)", "event DonationMade(uint256 indexed campaignId, address indexed donor, uint256 grossAmount, uint256 netAmount, address operator)", "event CampaignBoosted(uint256 indexed campaignId, address indexed booster, uint48 boostExpiry, address operator)", "event CampaignClosed(uint256 indexed campaignId, address indexed owner, uint96 raised)", "event FundsWithdrawn(uint256 indexed campaignId, address indexed owner, uint96 amount)"];
+    readonly Agora: readonly ["event PostCreated(uint256 indexed postId, address indexed author, uint8 tag, uint8 contentType, string contentHash, address operator)", "event ReplyCreated(uint256 indexed postId, uint256 indexed parentId, address indexed author, uint8 tag, uint8 contentType, string contentHash, address operator)", "event RepostCreated(uint256 indexed postId, uint256 indexed originalId, address indexed author, uint8 tag, string contentHash, address operator)", "event PostEdited(uint256 indexed postId, address indexed author, string newContentHash)", "event PostDeleted(uint256 indexed postId, address indexed author)", "event TagChanged(uint256 indexed postId, uint8 oldTag, uint8 newTag)", "event Liked(uint256 indexed postId, address indexed liker, address indexed author, address operator)", "event SuperLiked(uint256 indexed postId, address indexed voter, address indexed author, uint256 amount, address operator)", "event Downvoted(uint256 indexed postId, address indexed voter, address indexed author, address operator)", "event Followed(address indexed follower, address indexed followed, address operator)", "event Unfollowed(address indexed follower, address indexed followed)", "event PostReported(uint256 indexed postId, address indexed reporter, address indexed author, uint8 category, uint256 totalReports)", "event PostBoosted(uint256 indexed postId, address indexed booster, uint8 tier, uint64 boostExpiry, address operator)", "event PostTipped(uint256 indexed postId, address indexed tipper, address indexed author, uint256 amount, address operator)", "event UserBlocked(address indexed blocker, address indexed blocked)", "event UserUnblocked(address indexed blocker, address indexed unblocked)", "event ProfileCreated(address indexed user, string metadataURI)", "event ProfileUpdated(address indexed user, string metadataURI)", "event PostPinned(address indexed user, uint256 indexed postId)", "event ProfileBoosted(address indexed user, uint64 boostExpiry, address operator)", "event BadgeObtained(address indexed user, uint8 tier, uint64 badgeExpiry, address operator)"];
+    readonly RentalManager: readonly ["event NFTListed(uint256 indexed tokenId, address indexed owner, uint96 pricePerDay)", "event ListingUpdated(uint256 indexed tokenId, uint96 pricePerDay)", "event NFTWithdrawn(uint256 indexed tokenId, address indexed owner)", "event NFTRented(uint256 indexed tokenId, address indexed tenant, address indexed owner, uint256 rentalCost, uint256 ethFee, uint48 endTime, address operator)", "event ListingBoosted(uint256 indexed tokenId, address indexed owner, uint256 days_, uint256 boostCost, uint32 newBoostExpiry)", "event EarningsWithdrawn(address indexed owner, uint256 amount)"];
+    readonly SimpleBKCFaucet: readonly ["event Claimed(address indexed recipient, uint256 tokens, uint256 eth, address indexed via)", "event ConfigUpdated(address relayer, uint256 tokensPerClaim, uint256 ethPerClaim, uint256 cooldown)", "event Paused(bool isPaused)", "event FundsDeposited(address indexed sender, uint256 eth, uint256 tokens)", "event FundsWithdrawn(address indexed to, uint256 eth, uint256 tokens)"];
+    readonly BackchainGovernance: readonly ["event AdminTransferred(address indexed previous, address indexed current)", "event PendingAdminSet(address indexed pending)", "event PhaseAdvanced(uint8 indexed previous, uint8 indexed current)", "event DAOSet(address indexed daoAddress)", "event TimelockDelayUpdated(uint256 previous, uint256 current)", "event ProposalCreated(uint256 indexed proposalId, address indexed target, uint256 value, bytes data, uint256 eta, string description)", "event ProposalExecuted(uint256 indexed proposalId)", "event ProposalCancelled(uint256 indexed proposalId)", "event DirectExecution(address indexed target, uint256 value, bytes data)"];
+    readonly AirdropVesting: readonly ["event AllocationSet(address indexed beneficiary, uint256 amount)", "event AllocationFinalized(uint256 totalAllocated, uint256 beneficiaryCount)", "event ClaimedAndStaked(address indexed beneficiary, uint256 amount, uint256 lockDays)", "event ClaimedVested(address indexed beneficiary, uint256 totalAmount, uint256 firstRelease)", "event VestedWithdrawn(address indexed beneficiary, uint256 amount, uint256 totalWithdrawn, uint256 remaining)"];
+};
+/** Contract names */
+export type ContractName = keyof typeof ALL_EVENT_ABIS;
+/** Flat array of all event ABIs */
+export declare const ALL_EVENTS_FLAT: readonly string[];
+//# sourceMappingURL=abis.d.ts.map

package/dist/abis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abis.d.ts","sourceRoot":"","sources":["../src/abis.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,gBAAgB,6fAQnB,CAAC;AAIX,eAAO,MAAM,gBAAgB,ikEA4BnB,CAAC;AAIX,eAAO,MAAM,cAAc,uiCAUjB,CAAC;AAIX,eAAO,MAAM,qBAAqB,wXAKxB,CAAC;AAIX,eAAO,MAAM,cAAc,iiBAMjB,CAAC;AAIX,eAAO,MAAM,qBAAqB,shBAQxB,CAAC;AAIX,eAAO,MAAM,eAAe,+aAIlB,CAAC;AAIX,eAAO,MAAM,iBAAiB,kVAGpB,CAAC;AAIX,eAAO,MAAM,cAAc,onBAOjB,CAAC;AAIX,eAAO,MAAM,aAAa,8cAKhB,CAAC;AAIX,eAAO,MAAM,cAAc,kjBAMjB,CAAC;AAIX,eAAO,MAAM,YAAY,4iEAsBf,CAAC;AAIX,eAAO,MAAM,aAAa,ilBAOhB,CAAC;AAIX,eAAO,MAAM,aAAa,qYAMhB,CAAC;AAIX,eAAO,MAAM,iBAAiB,+nBAUpB,CAAC;AAIX,eAAO,MAAM,cAAc,ucAMjB,CAAC;AAIX,8CAA8C;AAC9C,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;CAiBjB,CAAC;AAEX,qBAAqB;AACrB,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,cAAc,CAAC;AAEvD,mCAAmC;AACnC,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAAyC,CAAC"}

package/dist/abis.js

@@ -0,0 +1,198 @@
+// ── Complete event ABIs for all Backchain contracts ──────────────────────────
+// 117 events across 17 contracts — ethers.js v6 human-readable format
+// ── BKCToken (ERC-20) ───────────────────────────────────────────────────────
+export const BKC_TOKEN_EVENTS = [
+    'event Transfer(address indexed from, address indexed to, uint256 value)',
+    'event Approval(address indexed owner, address indexed spender, uint256 value)',
+    'event MinterAdded(address indexed minter)',
+    'event MinterRemoved(address indexed minter)',
+    'event MinterAdminRenounced(address indexed deployer)',
+    'event TokensBurned(address indexed from, uint256 amount, uint256 newTotalSupply, uint256 totalBurnedAllTime)',
+    'event TokensMinted(address indexed to, uint256 amount, uint256 newTotalSupply)',
+];
+// ── BackchainEcosystem ──────────────────────────────────────────────────────
+export const ECOSYSTEM_EVENTS = [
+    'event FeeCollected(bytes32 indexed moduleId, address indexed user, address operator, address customRecipient, uint256 ethAmount, uint256 bkcFee)',
+    'event EthDistributed(uint256 toReferrer, uint256 toCustom, uint256 toOperator, uint256 toTreasury, uint256 toBuyback)',
+    'event BkcFeeDistributed(uint256 burned, uint256 toOperator, uint256 toStakers, uint256 toTreasury)',
+    'event EthWithdrawn(address indexed recipient, uint256 amount)',
+    'event BuybackETHWithdrawn(address indexed buyback, uint256 amount)',
+    'event TutorSet(address indexed user, address indexed tutor)',
+    'event TutorChanged(address indexed user, address indexed oldTutor, address indexed newTutor)',
+    'event TutorRelayerUpdated(address indexed oldRelayer, address indexed newRelayer)',
+    'event TutorBpsUpdated(uint16 newBps)',
+    'event TutorBonusPaid(address indexed user, uint256 amount)',
+    'event TutorBonusFunded(address indexed funder, uint256 amount, uint256 newPool)',
+    'event TutorBonusAmountUpdated(uint256 oldAmount, uint256 newAmount)',
+    'event TutorFeeUpdated(uint256 oldFee, uint256 newFee)',
+    'event ChangeTutorFeeUpdated(uint256 oldFee, uint256 newFee)',
+    'event ModuleRegistered(bytes32 indexed moduleId, address indexed contractAddr)',
+    'event ContractDeauthorized(bytes32 indexed moduleId, address indexed contractAddr)',
+    'event ModuleConfigUpdated(bytes32 indexed moduleId)',
+    'event ModuleActivated(bytes32 indexed moduleId)',
+    'event ModuleDeactivated(bytes32 indexed moduleId)',
+    'event FeeConfigUpdated(bytes32 indexed actionId)',
+    'event TreasuryUpdated(address indexed oldAddr, address indexed newAddr)',
+    'event BuybackMinerUpdated(address indexed oldAddr, address indexed newAddr)',
+    'event StakingPoolUpdated(address indexed oldAddr, address indexed newAddr)',
+    'event BkcDistributionUpdated(uint16 burnBps, uint16 operatorBps, uint16 stakerBps, uint16 treasuryBps)',
+    'event OwnershipTransferStarted(address indexed currentOwner, address indexed pendingOwner)',
+    'event OwnershipTransferred(address indexed oldOwner, address indexed newOwner)',
+    'event TokenRecovered(address indexed token, address indexed to, uint256 amount)',
+];
+// ── StakingPool ─────────────────────────────────────────────────────────────
+export const STAKING_EVENTS = [
+    'event Delegated(address indexed user, uint256 indexed delegationIndex, uint256 amount, uint256 pStake, uint256 lockDays, address operator)',
+    'event Unstaked(address indexed user, uint256 indexed delegationIndex, uint256 amountReturned)',
+    'event ForceUnstaked(address indexed user, uint256 indexed delegationIndex, uint256 amountReturned, uint256 totalPenalty, uint256 recycledAmount, uint256 burnedAmount, uint256 tutorAmount, address tutor, address operator)',
+    'event RewardsClaimed(address indexed user, uint256 totalRewards, uint256 recycledAmount, uint256 burnedAmount, uint256 tutorAmount, uint256 userReceived, uint256 nftBoostUsed, address tutor, address operator)',
+    'event RewardNotified(uint256 amount, uint256 newAccRewardPerShare)',
+    'event RewardNotifierSet(address indexed notifier, bool authorized)',
+    'event RewardBoosterUpdated(address indexed oldBooster, address indexed newBooster)',
+    'event ForceUnstakeEthFeeUpdated(uint256 oldFee, uint256 newFee)',
+    'event DelegateForAuthorizationSet(address indexed contractAddr, bool authorized)',
+];
+// ── LiquidityPool ───────────────────────────────────────────────────────────
+export const LIQUIDITY_POOL_EVENTS = [
+    'event LiquidityAdded(address indexed provider, uint256 ethAmount, uint256 bkcAmount, uint256 shares)',
+    'event LiquidityRemoved(address indexed provider, uint256 ethAmount, uint256 bkcAmount, uint256 shares)',
+    'event SwapETHforBKC(address indexed buyer, uint256 ethIn, uint256 bkcOut)',
+    'event SwapBKCforETH(address indexed seller, uint256 bkcIn, uint256 ethOut)',
+];
+// ── BuybackMiner ────────────────────────────────────────────────────────────
+export const BUYBACK_EVENTS = [
+    'event BuybackExecuted(address indexed caller, uint256 indexed buybackNumber, uint256 callerReward, uint256 ethSpent, uint256 bkcPurchased, uint256 bkcMined, uint256 bkcBurned, uint256 bkcToStakers, uint256 miningRateBps)',
+    'event SwapTargetUpdated(address indexed oldPool, address indexed newPool)',
+    'event ExecutionFeeUpdated(uint256 oldFee, uint256 newFee)',
+    'event OwnershipTransferStarted(address indexed currentOwner, address indexed newOwner)',
+    'event OwnershipTransferred(address indexed oldOwner, address indexed newOwner)',
+];
+// ── RewardBooster (ERC-721) ─────────────────────────────────────────────────
+export const REWARD_BOOSTER_EVENTS = [
+    'event Transfer(address indexed from, address indexed to, uint256 indexed tokenId)',
+    'event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId)',
+    'event ApprovalForAll(address indexed owner, address indexed operator, bool approved)',
+    'event PoolsConfigured(address[4] pools)',
+    'event FusionContractSet(address indexed fusionAddr)',
+    'event FusionMinted(address indexed to, uint256 indexed tokenId, uint8 tier)',
+    'event FusionBurned(address indexed from, uint256 indexed tokenId, uint8 tier)',
+];
+// ── NFTPool ─────────────────────────────────────────────────────────────────
+export const NFT_POOL_EVENTS = [
+    'event PoolInitialized(uint8 tier, uint256 nftCount, uint256 mintableReserves, uint256 bkcAmount, uint256 virtualReserves, uint256 initialK)',
+    'event NFTPurchased(address indexed buyer, uint256 indexed tokenId, uint256 price, uint256 ethFee, uint256 newNftCount, address operator)',
+    'event NFTSold(address indexed seller, uint256 indexed tokenId, uint256 payout, uint256 ethFee, uint256 newNftCount, address operator)',
+];
+// ── NFTFusion ───────────────────────────────────────────────────────────────
+export const NFT_FUSION_EVENTS = [
+    'event Fused(address indexed user, uint256 indexed tokenId1, uint256 indexed tokenId2, uint256 newTokenId, uint8 sourceTier, uint8 resultTier, address operator)',
+    'event Split(address indexed user, uint256 indexed burnedTokenId, uint8 sourceTier, uint8 targetTier, uint256 mintCount, uint256[] newTokenIds, address operator)',
+];
+// ── FortunePool ─────────────────────────────────────────────────────────────
+export const FORTUNE_EVENTS = [
+    'event GameCommitted(uint256 indexed gameId, address indexed player, uint256 wagerAmount, uint8 tierMask, address operator)',
+    'event GameRevealed(uint256 indexed gameId, address indexed player, uint256 grossWager, uint256 prizeWon, uint8 tierMask, uint8 matchCount, address operator)',
+    'event GameDetails(uint256 indexed gameId, uint8 tierMask, uint256[] guesses, uint256[] rolls, bool[] matches)',
+    'event GameExpired(uint256 indexed gameId, address indexed player, uint256 forfeitedAmount)',
+    'event PrizePoolFunded(address indexed funder, uint256 amount)',
+    'event ExcessBurned(uint256 amount, uint256 totalBurned)',
+];
+// ── Notary ──────────────────────────────────────────────────────────────────
+export const NOTARY_EVENTS = [
+    'event Certified(uint256 indexed certId, address indexed owner, bytes32 indexed documentHash, uint8 docType, address operator)',
+    'event BatchCertified(address indexed owner, uint256 startId, uint256 count, address operator)',
+    'event CertificateTransferred(bytes32 indexed documentHash, address indexed from, address indexed to)',
+    'event CertificateBoosted(bytes32 indexed documentHash, address indexed booster, uint32 boostExpiry, address operator)',
+];
+// ── CharityPool ─────────────────────────────────────────────────────────────
+export const CHARITY_EVENTS = [
+    'event CampaignCreated(uint256 indexed campaignId, address indexed owner, uint96 goal, uint48 deadline, address operator)',
+    'event DonationMade(uint256 indexed campaignId, address indexed donor, uint256 grossAmount, uint256 netAmount, address operator)',
+    'event CampaignBoosted(uint256 indexed campaignId, address indexed booster, uint48 boostExpiry, address operator)',
+    'event CampaignClosed(uint256 indexed campaignId, address indexed owner, uint96 raised)',
+    'event FundsWithdrawn(uint256 indexed campaignId, address indexed owner, uint96 amount)',
+];
+// ── Agora ───────────────────────────────────────────────────────────────────
+export const AGORA_EVENTS = [
+    'event PostCreated(uint256 indexed postId, address indexed author, uint8 tag, uint8 contentType, string contentHash, address operator)',
+    'event ReplyCreated(uint256 indexed postId, uint256 indexed parentId, address indexed author, uint8 tag, uint8 contentType, string contentHash, address operator)',
+    'event RepostCreated(uint256 indexed postId, uint256 indexed originalId, address indexed author, uint8 tag, string contentHash, address operator)',
+    'event PostEdited(uint256 indexed postId, address indexed author, string newContentHash)',
+    'event PostDeleted(uint256 indexed postId, address indexed author)',
+    'event TagChanged(uint256 indexed postId, uint8 oldTag, uint8 newTag)',
+    'event Liked(uint256 indexed postId, address indexed liker, address indexed author, address operator)',
+    'event SuperLiked(uint256 indexed postId, address indexed voter, address indexed author, uint256 amount, address operator)',
+    'event Downvoted(uint256 indexed postId, address indexed voter, address indexed author, address operator)',
+    'event Followed(address indexed follower, address indexed followed, address operator)',
+    'event Unfollowed(address indexed follower, address indexed followed)',
+    'event PostReported(uint256 indexed postId, address indexed reporter, address indexed author, uint8 category, uint256 totalReports)',
+    'event PostBoosted(uint256 indexed postId, address indexed booster, uint8 tier, uint64 boostExpiry, address operator)',
+    'event PostTipped(uint256 indexed postId, address indexed tipper, address indexed author, uint256 amount, address operator)',
+    'event UserBlocked(address indexed blocker, address indexed blocked)',
+    'event UserUnblocked(address indexed blocker, address indexed unblocked)',
+    'event ProfileCreated(address indexed user, string metadataURI)',
+    'event ProfileUpdated(address indexed user, string metadataURI)',
+    'event PostPinned(address indexed user, uint256 indexed postId)',
+    'event ProfileBoosted(address indexed user, uint64 boostExpiry, address operator)',
+    'event BadgeObtained(address indexed user, uint8 tier, uint64 badgeExpiry, address operator)',
+];
+// ── RentalManager ───────────────────────────────────────────────────────────
+export const RENTAL_EVENTS = [
+    'event NFTListed(uint256 indexed tokenId, address indexed owner, uint96 pricePerDay)',
+    'event ListingUpdated(uint256 indexed tokenId, uint96 pricePerDay)',
+    'event NFTWithdrawn(uint256 indexed tokenId, address indexed owner)',
+    'event NFTRented(uint256 indexed tokenId, address indexed tenant, address indexed owner, uint256 rentalCost, uint256 ethFee, uint48 endTime, address operator)',
+    'event ListingBoosted(uint256 indexed tokenId, address indexed owner, uint256 days_, uint256 boostCost, uint32 newBoostExpiry)',
+    'event EarningsWithdrawn(address indexed owner, uint256 amount)',
+];
+// ── SimpleBKCFaucet ─────────────────────────────────────────────────────────
+export const FAUCET_EVENTS = [
+    'event Claimed(address indexed recipient, uint256 tokens, uint256 eth, address indexed via)',
+    'event ConfigUpdated(address relayer, uint256 tokensPerClaim, uint256 ethPerClaim, uint256 cooldown)',
+    'event Paused(bool isPaused)',
+    'event FundsDeposited(address indexed sender, uint256 eth, uint256 tokens)',
+    'event FundsWithdrawn(address indexed to, uint256 eth, uint256 tokens)',
+];
+// ── BackchainGovernance ─────────────────────────────────────────────────────
+export const GOVERNANCE_EVENTS = [
+    'event AdminTransferred(address indexed previous, address indexed current)',
+    'event PendingAdminSet(address indexed pending)',
+    'event PhaseAdvanced(uint8 indexed previous, uint8 indexed current)',
+    'event DAOSet(address indexed daoAddress)',
+    'event TimelockDelayUpdated(uint256 previous, uint256 current)',
+    'event ProposalCreated(uint256 indexed proposalId, address indexed target, uint256 value, bytes data, uint256 eta, string description)',
+    'event ProposalExecuted(uint256 indexed proposalId)',
+    'event ProposalCancelled(uint256 indexed proposalId)',
+    'event DirectExecution(address indexed target, uint256 value, bytes data)',
+];
+// ── AirdropVesting ──────────────────────────────────────────────────────────
+export const AIRDROP_EVENTS = [
+    'event AllocationSet(address indexed beneficiary, uint256 amount)',
+    'event AllocationFinalized(uint256 totalAllocated, uint256 beneficiaryCount)',
+    'event ClaimedAndStaked(address indexed beneficiary, uint256 amount, uint256 lockDays)',
+    'event ClaimedVested(address indexed beneficiary, uint256 totalAmount, uint256 firstRelease)',
+    'event VestedWithdrawn(address indexed beneficiary, uint256 amount, uint256 totalWithdrawn, uint256 remaining)',
+];
+// ── Aggregated ──────────────────────────────────────────────────────────────
+/** All event ABIs grouped by contract name */
+export const ALL_EVENT_ABIS = {
+    BKCToken: BKC_TOKEN_EVENTS,
+    BackchainEcosystem: ECOSYSTEM_EVENTS,
+    StakingPool: STAKING_EVENTS,
+    LiquidityPool: LIQUIDITY_POOL_EVENTS,
+    BuybackMiner: BUYBACK_EVENTS,
+    RewardBooster: REWARD_BOOSTER_EVENTS,
+    NFTPool: NFT_POOL_EVENTS,
+    NFTFusion: NFT_FUSION_EVENTS,
+    FortunePool: FORTUNE_EVENTS,
+    Notary: NOTARY_EVENTS,
+    CharityPool: CHARITY_EVENTS,
+    Agora: AGORA_EVENTS,
+    RentalManager: RENTAL_EVENTS,
+    SimpleBKCFaucet: FAUCET_EVENTS,
+    BackchainGovernance: GOVERNANCE_EVENTS,
+    AirdropVesting: AIRDROP_EVENTS,
+};
+/** Flat array of all event ABIs */
+export const ALL_EVENTS_FLAT = Object.values(ALL_EVENT_ABIS).flat();
+//# sourceMappingURL=abis.js.map

package/dist/abis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abis.js","sourceRoot":"","sources":["../src/abis.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,sEAAsE;AAEtE,+EAA+E;AAE/E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,yEAAyE;IACzE,+EAA+E;IAC/E,2CAA2C;IAC3C,6CAA6C;IAC7C,sDAAsD;IACtD,8GAA8G;IAC9G,gFAAgF;CAC1E,CAAC;AAEX,+EAA+E;AAE/E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,kJAAkJ;IAClJ,uHAAuH;IACvH,oGAAoG;IACpG,+DAA+D;IAC/D,oEAAoE;IACpE,6DAA6D;IAC7D,8FAA8F;IAC9F,mFAAmF;IACnF,sCAAsC;IACtC,4DAA4D;IAC5D,iFAAiF;IACjF,qEAAqE;IACrE,uDAAuD;IACvD,6DAA6D;IAC7D,gFAAgF;IAChF,oFAAoF;IACpF,qDAAqD;IACrD,iDAAiD;IACjD,mDAAmD;IACnD,kDAAkD;IAClD,yEAAyE;IACzE,6EAA6E;IAC7E,4EAA4E;IAC5E,wGAAwG;IACxG,4FAA4F;IAC5F,gFAAgF;IAChF,iFAAiF;CAC3E,CAAC;AAEX,+EAA+E;AAE/E,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,4IAA4I;IAC5I,+FAA+F;IAC/F,8NAA8N;IAC9N,kNAAkN;IAClN,oEAAoE;IACpE,oEAAoE;IACpE,oFAAoF;IACpF,iEAAiE;IACjE,kFAAkF;CAC5E,CAAC;AAEX,+EAA+E;AAE/E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACjC,sGAAsG;IACtG,wGAAwG;IACxG,2EAA2E;IAC3E,4EAA4E;CACtE,CAAC;AAEX,+EAA+E;AAE/E,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,8NAA8N;IAC9N,2EAA2E;IAC3E,2DAA2D;IAC3D,wFAAwF;IACxF,gFAAgF;CAC1E,CAAC;AAEX,+EAA+E;AAE/E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACjC,mFAAmF;IACnF,0FAA0F;IAC1F,sFAAsF;IACtF,yCAAyC;IACzC,qDAAqD;IACrD,6EAA6E;IAC7E,+EAA+E;CACzE,CAAC;AAEX,+EAA+E;AAE/E,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B,6IAA6I;IAC7I,0IAA0I;IAC1I,uIAAuI;CACjI,CAAC;AAEX,+EAA+E;AAE/E,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC7B,iKAAiK;IACjK,kKAAkK;CAC5J,CAAC;AAEX,+EAA+E;AAE/E,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,4HAA4H;IAC5H,8JAA8J;IAC9J,+GAA+G;IAC/G,4FAA4F;IAC5F,+DAA+D;IAC/D,yDAAyD;CACnD,CAAC;AAEX,+EAA+E;AAE/E,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,+HAA+H;IAC/H,+FAA+F;IAC/F,sGAAsG;IACtG,uHAAuH;CACjH,CAAC;AAEX,+EAA+E;AAE/E,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,0HAA0H;IAC1H,iIAAiI;IACjI,kHAAkH;IAClH,wFAAwF;IACxF,wFAAwF;CAClF,CAAC;AAEX,+EAA+E;AAE/E,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,uIAAuI;IACvI,kKAAkK;IAClK,kJAAkJ;IAClJ,yFAAyF;IACzF,mEAAmE;IACnE,sEAAsE;IACtE,sGAAsG;IACtG,2HAA2H;IAC3H,0GAA0G;IAC1G,sFAAsF;IACtF,sEAAsE;IACtE,oIAAoI;IACpI,sHAAsH;IACtH,4HAA4H;IAC5H,qEAAqE;IACrE,yEAAyE;IACzE,gEAAgE;IAChE,gEAAgE;IAChE,gEAAgE;IAChE,kFAAkF;IAClF,6FAA6F;CACvF,CAAC;AAEX,+EAA+E;AAE/E,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,qFAAqF;IACrF,mEAAmE;IACnE,oEAAoE;IACpE,+JAA+J;IAC/J,+HAA+H;IAC/H,gEAAgE;CAC1D,CAAC;AAEX,+EAA+E;AAE/E,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,4FAA4F;IAC5F,qGAAqG;IACrG,6BAA6B;IAC7B,2EAA2E;IAC3E,uEAAuE;CACjE,CAAC;AAEX,+EAA+E;AAE/E,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC7B,2EAA2E;IAC3E,gDAAgD;IAChD,oEAAoE;IACpE,0CAA0C;IAC1C,+DAA+D;IAC/D,uIAAuI;IACvI,oDAAoD;IACpD,qDAAqD;IACrD,0EAA0E;CACpE,CAAC;AAEX,+EAA+E;AAE/E,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,kEAAkE;IAClE,6EAA6E;IAC7E,uFAAuF;IACvF,6FAA6F;IAC7F,+GAA+G;CACzG,CAAC;AAEX,+EAA+E;AAE/E,8CAA8C;AAC9C,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,QAAQ,EAAE,gBAAgB;IAC1B,kBAAkB,EAAE,gBAAgB;IACpC,WAAW,EAAE,cAAc;IAC3B,aAAa,EAAE,qBAAqB;IACpC,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,qBAAqB;IACpC,OAAO,EAAE,eAAe;IACxB,SAAS,EAAE,iBAAiB;IAC5B,WAAW,EAAE,cAAc;IAC3B,MAAM,EAAE,aAAa;IACrB,WAAW,EAAE,cAAc;IAC3B,KAAK,EAAE,YAAY;IACnB,aAAa,EAAE,aAAa;IAC5B,eAAe,EAAE,aAAa;IAC9B,mBAAmB,EAAE,iBAAiB;IACtC,cAAc,EAAE,cAAc;CACxB,CAAC;AAKX,mCAAmC;AACnC,MAAM,CAAC,MAAM,eAAe,GAAsB,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC"}

package/dist/filters.d.ts

@@ -0,0 +1,44 @@
+/** Event filter for use with ethers.js provider.getLogs() */
+export interface EventFilter {
+    address?: string | string[];
+    topics?: Array<string | string[] | null>;
+    fromBlock?: number | 'latest';
+    toBlock?: number | 'latest';
+}
+/**
+ * Fluent builder for event filters.
+ *
+ * @example
+ * ```ts
+ * const filter = new FilterBuilder()
+ *   .address('0x...')
+ *   .event('Delegated(address,uint256,uint256,uint256,uint256,address)')
+ *   .indexed(1, userAddress)
+ *   .range(fromBlock, 'latest')
+ *   .build();
+ *
+ * const logs = await provider.getLogs(filter);
+ * ```
+ */
+export declare class FilterBuilder {
+    private _filter;
+    /** Filter by contract address(es). */
+    address(addr: string | string[]): this;
+    /** Set topic0 from a full event signature (auto-hashes). */
+    event(signature: string): this;
+    /** Set topic0 directly (pre-hashed). */
+    topic0(hash: string): this;
+    /** Set an indexed parameter topic (position 1-3). */
+    indexed(position: 1 | 2 | 3, value: string | string[] | null): this;
+    /** Set block range. */
+    range(from: number | 'latest', to: number | 'latest'): this;
+    /** Set starting block. */
+    fromBlock(block: number | 'latest'): this;
+    /** Set ending block. */
+    toBlock(block: number | 'latest'): this;
+    /** Build the filter object. */
+    build(): EventFilter;
+}
+/** Shorthand: create a filter for a specific event signature. */
+export declare function eventFilter(signature: string): FilterBuilder;
+//# sourceMappingURL=filters.d.ts.map

package/dist/filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../src/filters.ts"],"names":[],"mappings":"AAEA,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC/B;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,OAAO,CAAmB;IAElC,sCAAsC;IACtC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAKtC,4DAA4D;IAC5D,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAM9B,wCAAwC;IACxC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM1B,qDAAqD;IACrD,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,IAAI;IAWnE,uBAAuB;IACvB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAM3D,0BAA0B;IAC1B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAKzC,wBAAwB;IACxB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAKvC,+BAA+B;IAC/B,KAAK,IAAI,WAAW;CAGvB;AAED,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAE5D"}

package/dist/filters.js

@@ -0,0 +1,76 @@
+import { ethers } from 'ethers';
+/**
+ * Fluent builder for event filters.
+ *
+ * @example
+ * ```ts
+ * const filter = new FilterBuilder()
+ *   .address('0x...')
+ *   .event('Delegated(address,uint256,uint256,uint256,uint256,address)')
+ *   .indexed(1, userAddress)
+ *   .range(fromBlock, 'latest')
+ *   .build();
+ *
+ * const logs = await provider.getLogs(filter);
+ * ```
+ */
+export class FilterBuilder {
+    _filter = {};
+    /** Filter by contract address(es). */
+    address(addr) {
+        this._filter.address = addr;
+        return this;
+    }
+    /** Set topic0 from a full event signature (auto-hashes). */
+    event(signature) {
+        if (!this._filter.topics)
+            this._filter.topics = [];
+        this._filter.topics[0] = ethers.id(signature);
+        return this;
+    }
+    /** Set topic0 directly (pre-hashed). */
+    topic0(hash) {
+        if (!this._filter.topics)
+            this._filter.topics = [];
+        this._filter.topics[0] = hash;
+        return this;
+    }
+    /** Set an indexed parameter topic (position 1-3). */
+    indexed(position, value) {
+        if (!this._filter.topics)
+            this._filter.topics = [];
+        // Pad address values to 32 bytes
+        if (typeof value === 'string' && value.startsWith('0x') && value.length === 42) {
+            this._filter.topics[position] = ethers.zeroPadValue(value, 32);
+        }
+        else {
+            this._filter.topics[position] = value;
+        }
+        return this;
+    }
+    /** Set block range. */
+    range(from, to) {
+        this._filter.fromBlock = from;
+        this._filter.toBlock = to;
+        return this;
+    }
+    /** Set starting block. */
+    fromBlock(block) {
+        this._filter.fromBlock = block;
+        return this;
+    }
+    /** Set ending block. */
+    toBlock(block) {
+        this._filter.toBlock = block;
+        return this;
+    }
+    /** Build the filter object. */
+    build() {
+        return { ...this._filter };
+    }
+}
+/** Shorthand: create a filter for a specific event signature. */
+export function eventFilter(signature) {
+    return new FilterBuilder().event(signature);
+}
+//# sourceMappingURL=filters.js.map

package/dist/filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.js","sourceRoot":"","sources":["../src/filters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAUhC;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,aAAa;IACd,OAAO,GAAgB,EAAE,CAAC;IAElC,sCAAsC;IACtC,OAAO,CAAC,IAAuB;QAC3B,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;QAC5B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,SAAiB;QACnB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC;QACnD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,wCAAwC;IACxC,MAAM,CAAC,IAAY;QACf,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC;QACnD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QAC9B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,qDAAqD;IACrD,OAAO,CAAC,QAAmB,EAAE,KAA+B;QACxD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC;QACnD,iCAAiC;QACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YAC7E,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACnE,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,uBAAuB;IACvB,KAAK,CAAC,IAAuB,EAAE,EAAqB;QAChD,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,0BAA0B;IAC1B,SAAS,CAAC,KAAwB;QAC9B,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,KAAK,CAAC;QAC/B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,wBAAwB;IACxB,OAAO,CAAC,KAAwB;QAC5B,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC;QAC7B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,+BAA+B;IAC/B,KAAK;QACD,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC/B,CAAC;CACJ;AAED,iEAAiE;AACjE,MAAM,UAAU,WAAW,CAAC,SAAiB;IACzC,OAAO,IAAI,aAAa,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AAChD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { BKC_TOKEN_EVENTS, ECOSYSTEM_EVENTS, STAKING_EVENTS, LIQUIDITY_POOL_EVENTS, BUYBACK_EVENTS, REWARD_BOOSTER_EVENTS, NFT_POOL_EVENTS, NFT_FUSION_EVENTS, FORTUNE_EVENTS, NOTARY_EVENTS, CHARITY_EVENTS, AGORA_EVENTS, RENTAL_EVENTS, FAUCET_EVENTS, GOVERNANCE_EVENTS, AIRDROP_EVENTS, ALL_EVENT_ABIS, ALL_EVENTS_FLAT, } from './abis.js';
+export type { ContractName } from './abis.js';
+export { EventParser } from './parser.js';
+export { FilterBuilder, eventFilter } from './filters.js';
+export type { EventFilter } from './filters.js';
+export type { BaseEvent, ParsedEvent, TransferEvent, ApprovalEvent, TokensBurnedEvent, TokensMintedEvent, BkcTokenEvent, FeeCollectedEvent, EthDistributedEvent, TutorSetEvent, OwnershipTransferredEvent, EcosystemEvent, DelegatedEvent, UnstakedEvent, ForceUnstakedEvent, RewardsClaimedEvent, RewardNotifiedEvent, StakingEvent, LiquidityAddedEvent, SwapETHforBKCEvent, SwapBKCforETHEvent, LiquidityEvent, BuybackExecutedEvent, BuybackEvent, NFTPurchasedEvent, NFTSoldEvent, FusedEvent, SplitEvent, NftEvent, GameCommittedEvent, GameRevealedEvent, GameExpiredEvent, FortuneEvent, CertifiedEvent, CertificateTransferredEvent, NotaryEvent, CampaignCreatedEvent, DonationMadeEvent, CharityEvent, PostCreatedEvent, ReplyCreatedEvent, LikedEvent, FollowedEvent, PostTippedEvent, AgoraEvent, NFTListedEvent, NFTRentedEvent, RentalEvent, ClaimedEvent, FaucetEvent, ProposalCreatedEvent, PhaseAdvancedEvent, GovernanceEvent, BackchainEvent, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAEH,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,cAAc,EACd,YAAY,EACZ,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,cAAc,EAEd,cAAc,EACd,eAAe,GAClB,MAAM,WAAW,CAAC;AAEnB,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,YAAY,EAER,SAAS,EACT,WAAW,EAEX,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EAEb,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,yBAAyB,EACzB,cAAc,EAEd,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EAEZ,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EAEd,oBAAoB,EACpB,YAAY,EAEZ,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,UAAU,EACV,QAAQ,EAER,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EAEZ,cAAc,EACd,2BAA2B,EAC3B,WAAW,EAEX,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EAEZ,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,eAAe,EACf,UAAU,EAEV,cAAc,EACd,cAAc,EACd,WAAW,EAEX,YAAY,EACZ,WAAW,EAEX,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EAEf,cAAc,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// @backchain/events — Complete event ABIs, typed interfaces, and parsing utilities
+export { 
+// Per-contract event ABIs
+BKC_TOKEN_EVENTS, ECOSYSTEM_EVENTS, STAKING_EVENTS, LIQUIDITY_POOL_EVENTS, BUYBACK_EVENTS, REWARD_BOOSTER_EVENTS, NFT_POOL_EVENTS, NFT_FUSION_EVENTS, FORTUNE_EVENTS, NOTARY_EVENTS, CHARITY_EVENTS, AGORA_EVENTS, RENTAL_EVENTS, FAUCET_EVENTS, GOVERNANCE_EVENTS, AIRDROP_EVENTS, 
+// Aggregated
+ALL_EVENT_ABIS, ALL_EVENTS_FLAT, } from './abis.js';
+export { EventParser } from './parser.js';
+export { FilterBuilder, eventFilter } from './filters.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,OAAO;AACH,0BAA0B;AAC1B,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,cAAc,EACd,YAAY,EACZ,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,cAAc;AACd,aAAa;AACb,cAAc,EACd,eAAe,GAClB,MAAM,WAAW,CAAC;AAInB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,49 @@
+import { ethers } from 'ethers';
+import type { BaseEvent, ParsedEvent } from './types.js';
+/**
+ * Parses raw blockchain logs into typed Backchain events.
+ *
+ * @example
+ * ```ts
+ * import { EventParser, STAKING_EVENTS } from '@backchain/events';
+ *
+ * const parser = new EventParser();
+ * parser.register('StakingPool', STAKING_EVENTS);
+ *
+ * const events = parser.parseMany(logs, 'StakingPool');
+ * ```
+ */
+export declare class EventParser {
+    private interfaces;
+    private addressMap;
+    /**
+     * Register a contract ABI for event parsing.
+     * @param contractName Identifier (e.g. 'StakingPool')
+     * @param abi Human-readable ABI strings or ethers Interface
+     * @param address Optional contract address for auto-detection in parseReceipt()
+     */
+    register(contractName: string, abi: readonly string[] | string[] | ethers.Interface, address?: string): void;
+    /**
+     * Register all contracts at once with an address map.
+     * @param contracts Map of contractName → { abi, address }
+     */
+    registerAll(contracts: Record<string, {
+        abi: readonly string[];
+        address: string;
+    }>): void;
+    /**
+     * Parse a single log into a typed event.
+     * @returns ParsedEvent or null if the log doesn't match
+     */
+    parse<T extends BaseEvent = BaseEvent>(log: ethers.Log, contractName: string): ParsedEvent<T> | null;
+    /**
+     * Parse multiple logs (batch).
+     */
+    parseMany<T extends BaseEvent = BaseEvent>(logs: readonly ethers.Log[], contractName: string): ParsedEvent<T>[];
+    /**
+     * Parse all logs from a transaction receipt.
+     * Auto-detects contract from log.address if registered via address.
+     */
+    parseReceipt(receipt: ethers.TransactionReceipt): ParsedEvent[];
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,UAAU,CAAuC;IACzD,OAAO,CAAC,UAAU,CAA6B;IAE/C;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ5G;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAMzF;;;OAGG;IACH,KAAK,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EACjC,GAAG,EAAE,MAAM,CAAC,GAAG,EACf,YAAY,EAAE,MAAM,GACrB,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAgCxB;;OAEG;IACH,SAAS,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EACrC,IAAI,EAAE,SAAS,MAAM,CAAC,GAAG,EAAE,EAC3B,YAAY,EAAE,MAAM,GACrB,WAAW,CAAC,CAAC,CAAC,EAAE;IASnB;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,kBAAkB,GAAG,WAAW,EAAE;CAiBlE"}

package/dist/parser.js

@@ -0,0 +1,115 @@
+import { ethers } from 'ethers';
+/**
+ * Parses raw blockchain logs into typed Backchain events.
+ *
+ * @example
+ * ```ts
+ * import { EventParser, STAKING_EVENTS } from '@backchain/events';
+ *
+ * const parser = new EventParser();
+ * parser.register('StakingPool', STAKING_EVENTS);
+ *
+ * const events = parser.parseMany(logs, 'StakingPool');
+ * ```
+ */
+export class EventParser {
+    interfaces = new Map();
+    addressMap = new Map();
+    /**
+     * Register a contract ABI for event parsing.
+     * @param contractName Identifier (e.g. 'StakingPool')
+     * @param abi Human-readable ABI strings or ethers Interface
+     * @param address Optional contract address for auto-detection in parseReceipt()
+     */
+    register(contractName, abi, address) {
+        const iface = abi instanceof ethers.Interface ? abi : new ethers.Interface([...abi]);
+        this.interfaces.set(contractName, iface);
+        if (address) {
+            this.addressMap.set(address.toLowerCase(), contractName);
+        }
+    }
+    /**
+     * Register all contracts at once with an address map.
+     * @param contracts Map of contractName → { abi, address }
+     */
+    registerAll(contracts) {
+        for (const [name, { abi, address }] of Object.entries(contracts)) {
+            this.register(name, abi, address);
+        }
+    }
+    /**
+     * Parse a single log into a typed event.
+     * @returns ParsedEvent or null if the log doesn't match
+     */
+    parse(log, contractName) {
+        const iface = this.interfaces.get(contractName);
+        if (!iface)
+            return null;
+        try {
+            const desc = iface.parseLog({ topics: log.topics, data: log.data });
+            if (!desc)
+                return null;
+            const args = {};
+            for (const input of desc.fragment.inputs) {
+                args[input.name] = desc.args[input.name];
+            }
+            return {
+                raw: log,
+                parsed: {
+                    event: desc.name,
+                    args,
+                    blockNumber: log.blockNumber,
+                    blockHash: log.blockHash,
+                    transactionHash: log.transactionHash,
+                    transactionIndex: log.transactionIndex,
+                    logIndex: log.index,
+                    address: log.address,
+                    removed: log.removed,
+                },
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Parse multiple logs (batch).
+     */
+    parseMany(logs, contractName) {
+        const results = [];
+        for (const log of logs) {
+            const parsed = this.parse(log, contractName);
+            if (parsed)
+                results.push(parsed);
+        }
+        return results;
+    }
+    /**
+     * Parse all logs from a transaction receipt.
+     * Auto-detects contract from log.address if registered via address.
+     */
+    parseReceipt(receipt) {
+        const results = [];
+        for (const log of receipt.logs) {
+            // Try address-based lookup first
+            const contractName = this.addressMap.get(log.address.toLowerCase());
+            if (contractName) {
+                const parsed = this.parse(log, contractName);
+                if (parsed) {
+                    results.push(parsed);
+                    continue;
+                }
+            }
+            // Fallback: try all registered interfaces
+            for (const name of this.interfaces.keys()) {
+                const parsed = this.parse(log, name);
+                if (parsed) {
+                    results.push(parsed);
+                    break;
+                }
+            }
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,407 @@
+/** Base interface for all parsed events */
+export interface BaseEvent {
+    event: string;
+    args: Record<string, unknown>;
+    blockNumber: number;
+    blockHash: string;
+    transactionHash: string;
+    transactionIndex: number;
+    logIndex: number;
+    address: string;
+    removed: boolean;
+}
+/** Wrapper returned by EventParser */
+export interface ParsedEvent<T extends BaseEvent = BaseEvent> {
+    raw: {
+        topics: readonly string[];
+        data: string;
+    };
+    parsed: T;
+}
+export interface TransferEvent extends BaseEvent {
+    event: 'Transfer';
+    args: {
+        from: string;
+        to: string;
+        value: bigint;
+    };
+}
+export interface ApprovalEvent extends BaseEvent {
+    event: 'Approval';
+    args: {
+        owner: string;
+        spender: string;
+        value: bigint;
+    };
+}
+export interface TokensBurnedEvent extends BaseEvent {
+    event: 'TokensBurned';
+    args: {
+        from: string;
+        amount: bigint;
+        newTotalSupply: bigint;
+        totalBurnedAllTime: bigint;
+    };
+}
+export interface TokensMintedEvent extends BaseEvent {
+    event: 'TokensMinted';
+    args: {
+        to: string;
+        amount: bigint;
+        newTotalSupply: bigint;
+    };
+}
+export type BkcTokenEvent = TransferEvent | ApprovalEvent | TokensBurnedEvent | TokensMintedEvent | BaseEvent;
+export interface FeeCollectedEvent extends BaseEvent {
+    event: 'FeeCollected';
+    args: {
+        moduleId: string;
+        user: string;
+        operator: string;
+        customRecipient: string;
+        ethAmount: bigint;
+        bkcFee: bigint;
+    };
+}
+export interface EthDistributedEvent extends BaseEvent {
+    event: 'EthDistributed';
+    args: {
+        toReferrer: bigint;
+        toCustom: bigint;
+        toOperator: bigint;
+        toTreasury: bigint;
+        toBuyback: bigint;
+    };
+}
+export interface TutorSetEvent extends BaseEvent {
+    event: 'TutorSet';
+    args: {
+        user: string;
+        tutor: string;
+    };
+}
+export interface OwnershipTransferredEvent extends BaseEvent {
+    event: 'OwnershipTransferred';
+    args: {
+        oldOwner: string;
+        newOwner: string;
+    };
+}
+export type EcosystemEvent = FeeCollectedEvent | EthDistributedEvent | TutorSetEvent | OwnershipTransferredEvent | BaseEvent;
+export interface DelegatedEvent extends BaseEvent {
+    event: 'Delegated';
+    args: {
+        user: string;
+        delegationIndex: bigint;
+        amount: bigint;
+        pStake: bigint;
+        lockDays: bigint;
+        operator: string;
+    };
+}
+export interface UnstakedEvent extends BaseEvent {
+    event: 'Unstaked';
+    args: {
+        user: string;
+        delegationIndex: bigint;
+        amountReturned: bigint;
+    };
+}
+export interface ForceUnstakedEvent extends BaseEvent {
+    event: 'ForceUnstaked';
+    args: {
+        user: string;
+        delegationIndex: bigint;
+        amountReturned: bigint;
+        totalPenalty: bigint;
+        recycledAmount: bigint;
+        burnedAmount: bigint;
+        tutorAmount: bigint;
+        tutor: string;
+        operator: string;
+    };
+}
+export interface RewardsClaimedEvent extends BaseEvent {
+    event: 'RewardsClaimed';
+    args: {
+        user: string;
+        totalRewards: bigint;
+        recycledAmount: bigint;
+        burnedAmount: bigint;
+        tutorAmount: bigint;
+        userReceived: bigint;
+        nftBoostUsed: bigint;
+        tutor: string;
+        operator: string;
+    };
+}
+export interface RewardNotifiedEvent extends BaseEvent {
+    event: 'RewardNotified';
+    args: {
+        amount: bigint;
+        newAccRewardPerShare: bigint;
+    };
+}
+export type StakingEvent = DelegatedEvent | UnstakedEvent | ForceUnstakedEvent | RewardsClaimedEvent | RewardNotifiedEvent | BaseEvent;
+export interface LiquidityAddedEvent extends BaseEvent {
+    event: 'LiquidityAdded';
+    args: {
+        provider: string;
+        ethAmount: bigint;
+        bkcAmount: bigint;
+        shares: bigint;
+    };
+}
+export interface SwapETHforBKCEvent extends BaseEvent {
+    event: 'SwapETHforBKC';
+    args: {
+        buyer: string;
+        ethIn: bigint;
+        bkcOut: bigint;
+    };
+}
+export interface SwapBKCforETHEvent extends BaseEvent {
+    event: 'SwapBKCforETH';
+    args: {
+        seller: string;
+        bkcIn: bigint;
+        ethOut: bigint;
+    };
+}
+export type LiquidityEvent = LiquidityAddedEvent | SwapETHforBKCEvent | SwapBKCforETHEvent | BaseEvent;
+export interface BuybackExecutedEvent extends BaseEvent {
+    event: 'BuybackExecuted';
+    args: {
+        caller: string;
+        buybackNumber: bigint;
+        callerReward: bigint;
+        ethSpent: bigint;
+        bkcPurchased: bigint;
+        bkcMined: bigint;
+        bkcBurned: bigint;
+        bkcToStakers: bigint;
+        miningRateBps: bigint;
+    };
+}
+export type BuybackEvent = BuybackExecutedEvent | BaseEvent;
+export interface NFTPurchasedEvent extends BaseEvent {
+    event: 'NFTPurchased';
+    args: {
+        buyer: string;
+        tokenId: bigint;
+        price: bigint;
+        ethFee: bigint;
+        newNftCount: bigint;
+        operator: string;
+    };
+}
+export interface NFTSoldEvent extends BaseEvent {
+    event: 'NFTSold';
+    args: {
+        seller: string;
+        tokenId: bigint;
+        payout: bigint;
+        ethFee: bigint;
+        newNftCount: bigint;
+        operator: string;
+    };
+}
+export interface FusedEvent extends BaseEvent {
+    event: 'Fused';
+    args: {
+        user: string;
+        tokenId1: bigint;
+        tokenId2: bigint;
+        newTokenId: bigint;
+        sourceTier: number;
+        resultTier: number;
+        operator: string;
+    };
+}
+export interface SplitEvent extends BaseEvent {
+    event: 'Split';
+    args: {
+        user: string;
+        burnedTokenId: bigint;
+        sourceTier: number;
+        targetTier: number;
+        mintCount: bigint;
+        newTokenIds: bigint[];
+        operator: string;
+    };
+}
+export type NftEvent = NFTPurchasedEvent | NFTSoldEvent | FusedEvent | SplitEvent | BaseEvent;
+export interface GameCommittedEvent extends BaseEvent {
+    event: 'GameCommitted';
+    args: {
+        gameId: bigint;
+        player: string;
+        wagerAmount: bigint;
+        tierMask: number;
+        operator: string;
+    };
+}
+export interface GameRevealedEvent extends BaseEvent {
+    event: 'GameRevealed';
+    args: {
+        gameId: bigint;
+        player: string;
+        grossWager: bigint;
+        prizeWon: bigint;
+        tierMask: number;
+        matchCount: number;
+        operator: string;
+    };
+}
+export interface GameExpiredEvent extends BaseEvent {
+    event: 'GameExpired';
+    args: {
+        gameId: bigint;
+        player: string;
+        forfeitedAmount: bigint;
+    };
+}
+export type FortuneEvent = GameCommittedEvent | GameRevealedEvent | GameExpiredEvent | BaseEvent;
+export interface CertifiedEvent extends BaseEvent {
+    event: 'Certified';
+    args: {
+        certId: bigint;
+        owner: string;
+        documentHash: string;
+        docType: number;
+        operator: string;
+    };
+}
+export interface CertificateTransferredEvent extends BaseEvent {
+    event: 'CertificateTransferred';
+    args: {
+        documentHash: string;
+        from: string;
+        to: string;
+    };
+}
+export type NotaryEvent = CertifiedEvent | CertificateTransferredEvent | BaseEvent;
+export interface CampaignCreatedEvent extends BaseEvent {
+    event: 'CampaignCreated';
+    args: {
+        campaignId: bigint;
+        owner: string;
+        goal: bigint;
+        deadline: bigint;
+        operator: string;
+    };
+}
+export interface DonationMadeEvent extends BaseEvent {
+    event: 'DonationMade';
+    args: {
+        campaignId: bigint;
+        donor: string;
+        grossAmount: bigint;
+        netAmount: bigint;
+        operator: string;
+    };
+}
+export type CharityEvent = CampaignCreatedEvent | DonationMadeEvent | BaseEvent;
+export interface PostCreatedEvent extends BaseEvent {
+    event: 'PostCreated';
+    args: {
+        postId: bigint;
+        author: string;
+        tag: number;
+        contentType: number;
+        contentHash: string;
+        operator: string;
+    };
+}
+export interface ReplyCreatedEvent extends BaseEvent {
+    event: 'ReplyCreated';
+    args: {
+        postId: bigint;
+        parentId: bigint;
+        author: string;
+        tag: number;
+        contentType: number;
+        contentHash: string;
+        operator: string;
+    };
+}
+export interface LikedEvent extends BaseEvent {
+    event: 'Liked';
+    args: {
+        postId: bigint;
+        liker: string;
+        author: string;
+        operator: string;
+    };
+}
+export interface FollowedEvent extends BaseEvent {
+    event: 'Followed';
+    args: {
+        follower: string;
+        followed: string;
+        operator: string;
+    };
+}
+export interface PostTippedEvent extends BaseEvent {
+    event: 'PostTipped';
+    args: {
+        postId: bigint;
+        tipper: string;
+        author: string;
+        amount: bigint;
+        operator: string;
+    };
+}
+export type AgoraEvent = PostCreatedEvent | ReplyCreatedEvent | LikedEvent | FollowedEvent | PostTippedEvent | BaseEvent;
+export interface NFTListedEvent extends BaseEvent {
+    event: 'NFTListed';
+    args: {
+        tokenId: bigint;
+        owner: string;
+        pricePerDay: bigint;
+    };
+}
+export interface NFTRentedEvent extends BaseEvent {
+    event: 'NFTRented';
+    args: {
+        tokenId: bigint;
+        tenant: string;
+        owner: string;
+        rentalCost: bigint;
+        ethFee: bigint;
+        endTime: bigint;
+        operator: string;
+    };
+}
+export type RentalEvent = NFTListedEvent | NFTRentedEvent | BaseEvent;
+export interface ClaimedEvent extends BaseEvent {
+    event: 'Claimed';
+    args: {
+        recipient: string;
+        tokens: bigint;
+        eth: bigint;
+        via: string;
+    };
+}
+export type FaucetEvent = ClaimedEvent | BaseEvent;
+export interface ProposalCreatedEvent extends BaseEvent {
+    event: 'ProposalCreated';
+    args: {
+        proposalId: bigint;
+        target: string;
+        value: bigint;
+        data: string;
+        eta: bigint;
+        description: string;
+    };
+}
+export interface PhaseAdvancedEvent extends BaseEvent {
+    event: 'PhaseAdvanced';
+    args: {
+        previous: number;
+        current: number;
+    };
+}
+export type GovernanceEvent = ProposalCreatedEvent | PhaseAdvancedEvent | BaseEvent;
+export type BackchainEvent = BkcTokenEvent | EcosystemEvent | StakingEvent | LiquidityEvent | BuybackEvent | NftEvent | FortuneEvent | NotaryEvent | CharityEvent | AgoraEvent | RentalEvent | FaucetEvent | GovernanceEvent;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// ── Typed event interfaces for all Backchain contracts ──────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+EAA+E"}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@backchain/events",
+  "version": "0.3.0",
+  "description": "Backchain Events — Complete event ABIs, typed interfaces, and parsing utilities",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": { "import": "./dist/index.js", "types": "./dist/index.d.ts" }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
+  },
+  "peerDependencies": {
+    "ethers": "^6.0.0"
+  },
+  "devDependencies": {
+    "ethers": "^6.13.0",
+    "typescript": "^5.5.0"
+  },
+  "license": "MIT",
+  "repository": { "type": "git", "url": "https://github.com/backcoin-org/backchain-dapp.git", "directory": "sdk/packages/events" }
+}