{"_id":"@bananapus/jbx-distributor-v6","_rev":"4-9f57a79fee917033d5570f6854d7d739","name":"@bananapus/jbx-distributor-v6","dist-tags":{"latest":"1.0.0"},"versions":{"0.0.4":{"name":"@bananapus/jbx-distributor-v6","version":"0.0.4","license":"MIT","_id":"@bananapus/jbx-distributor-v6@0.0.4","maintainers":[{"name":"simplemachine","email":"justinpulley92@gmail.com"},{"name":"me.jango","email":"me.jango@protonmail.com"},{"name":"filipviz","email":"f@filip.world"}],"homepage":"https://github.com/Bananapus/nana-jbx-distributor-v6#readme","bugs":{"url":"https://github.com/Bananapus/nana-jbx-distributor-v6/issues"},"dist":{"shasum":"993acf26e0dfd2802af5c3d43f52ea76340a890d","tarball":"https://registry.npmjs.org/@bananapus/jbx-distributor-v6/-/jbx-distributor-v6-0.0.4.tgz","fileCount":21,"integrity":"sha512-6j3OofPsS6rbweBjDnCiovaMjcuupv9aiQ29f5jl0CX5ZN2sX0w/2witZ1YXAbiOLzKPgoKM+/NQOllW1xxtdQ==","signatures":[{"sig":"MEQCIB72UC2hw6qxl4O9ijzr7lF9MqLGFiMJY7P87jrsblzqAiAiykUe0PqgyGW7qNE0UYPQmY2mVXqfggYNLNorNiSOmQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":180793},"engines":{"node":">=20.0.0"},"gitHead":"065ca15dd331eac658c84768f0d3abe038156b04","scripts":{"test":"forge test","coverage":"forge coverage --match-path \"./src/*.sol\" --report lcov --report summary","deploy:mainnets":"source ./.env && npx sphinx propose ./script/Deploy.s.sol --networks mainnets","deploy:testnets":"source ./.env && npx sphinx propose ./script/Deploy.s.sol --networks testnets"},"_npmUser":{"name":"me.jango","email":"me.jango@protonmail.com"},"repository":{"url":"git+https://github.com/Bananapus/nana-jbx-distributor-v6.git","type":"git"},"_npmVersion":"11.12.1","description":"`@bananapus/jbx-distributor-v6` distributes split-funded rewards to mainnet JBX stakers. Rewards are shared by JBX holders with nonzero delegated voting power at each reward round's snapshot block, then vest linearly before they are collected.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"@prb/math":"4.1.2","@bananapus/core-v6":"^0.0.86","@bananapus/suckers-v6":"^0.0.73","@openzeppelin/contracts":"5.6.1","@bananapus/permission-ids-v6":"^0.0.30"},"_hasShrinkwrap":false,"devDependencies":{"@sphinx-labs/plugins":"0.33.3"},"_npmOperationalInternal":{"tmp":"tmp/jbx-distributor-v6_0.0.4_1781112840935_0.7401094450511263","host":"s3://npm-registry-packages-npm-production"}},"0.0.5":{"name":"@bananapus/jbx-distributor-v6","version":"0.0.5","license":"MIT","_id":"@bananapus/jbx-distributor-v6@0.0.5","maintainers":[{"name":"simplemachine","email":"justinpulley92@gmail.com"},{"name":"me.jango","email":"me.jango@protonmail.com"},{"name":"filipviz","email":"f@filip.world"}],"homepage":"https://github.com/Bananapus/nana-jbx-distributor-v6#readme","bugs":{"url":"https://github.com/Bananapus/nana-jbx-distributor-v6/issues"},"dist":{"shasum":"c2b1be3c218af6824c5a12f8ba9cf3964faeaa60","tarball":"https://registry.npmjs.org/@bananapus/jbx-distributor-v6/-/jbx-distributor-v6-0.0.5.tgz","fileCount":21,"integrity":"sha512-6QRUk/sv7lELg0n1S78VBgiLgOAuOUQKm0sGkXeZz1VvIb31kfNje/xbU4OUARwUFH5yKW12r31riMivIK3xZA==","signatures":[{"sig":"MEYCIQDkYLAmOJpzle+7AoE0QRFexUaHyEo0ueurEXQ23pXUJgIhAJJPABYHNN0UlXv1k3/5Mq2J2+dMJK6hYAyyXUtpLoX5","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":180793},"engines":{"node":">=20.0.0"},"gitHead":"758c80e279e73604db6b8648bb0d5cf579cd9fff","scripts":{"test":"forge test","coverage":"forge coverage --match-path \"./src/*.sol\" --report lcov --report summary","deploy:mainnets":"source ./.env && npx sphinx propose ./script/Deploy.s.sol --networks mainnets","deploy:testnets":"source ./.env && npx sphinx propose ./script/Deploy.s.sol --networks testnets"},"_npmUser":{"name":"me.jango","email":"me.jango@protonmail.com"},"repository":{"url":"git+https://github.com/Bananapus/nana-jbx-distributor-v6.git","type":"git"},"_npmVersion":"11.12.1","description":"`@bananapus/jbx-distributor-v6` distributes split-funded rewards to mainnet JBX stakers. Rewards are shared by JBX holders with nonzero delegated voting power at each reward round's snapshot block, then vest linearly before they are collected.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"@prb/math":"4.1.2","@bananapus/core-v6":"^0.0.87","@bananapus/suckers-v6":"^0.0.76","@openzeppelin/contracts":"5.6.1","@bananapus/permission-ids-v6":"^0.0.32"},"_hasShrinkwrap":false,"devDependencies":{"@sphinx-labs/plugins":"0.33.3"},"_npmOperationalInternal":{"tmp":"tmp/jbx-distributor-v6_0.0.5_1781128349506_0.3247157972627055","host":"s3://npm-registry-packages-npm-production"}},"0.0.6":{"name":"@bananapus/jbx-distributor-v6","version":"0.0.6","license":"MIT","_id":"@bananapus/jbx-distributor-v6@0.0.6","maintainers":[{"name":"simplemachine","email":"justinpulley92@gmail.com"},{"name":"me.jango","email":"me.jango@protonmail.com"},{"name":"filipviz","email":"f@filip.world"}],"homepage":"https://github.com/Bananapus/nana-jbx-distributor-v6#readme","bugs":{"url":"https://github.com/Bananapus/nana-jbx-distributor-v6/issues"},"dist":{"shasum":"c8fe446d3b01895a21e72480e3cfc82e10e28352","tarball":"https://registry.npmjs.org/@bananapus/jbx-distributor-v6/-/jbx-distributor-v6-0.0.6.tgz","fileCount":21,"integrity":"sha512-55X/CZYfCdnWe24ZaRI2SKGrvBu1Q07Dp4wwozFaKxP9FpuJ3Jm52izD0/05jAuUPDarax4aigoZ0zvpgQorEg==","signatures":[{"sig":"MEUCIGEnP+k7lbO1nAsACgimgQe/eGMs/p7HeRtY9B2ii8PGAiEAppijhvG6oY9MbhqasOylpRpLwg9NW707qjQV4YcZhuc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":181177},"engines":{"node":">=20.0.0"},"gitHead":"43264f88b47ece71bdb2b3dbf8ca9787ea25a019","scripts":{"test":"forge test","coverage":"forge coverage --match-path \"./src/*.sol\" --report lcov --report summary","deploy:mainnets":"source ./.env && npx sphinx propose ./script/Deploy.s.sol --networks mainnets","deploy:testnets":"source ./.env && npx sphinx propose ./script/Deploy.s.sol --networks testnets"},"_npmUser":{"name":"me.jango","email":"me.jango@protonmail.com"},"repository":{"url":"git+https://github.com/Bananapus/nana-jbx-distributor-v6.git","type":"git"},"_npmVersion":"11.12.1","description":"`@bananapus/jbx-distributor-v6` distributes split-funded rewards to mainnet JBX stakers. Rewards are shared by JBX holders with nonzero delegated voting power at each reward round's snapshot block, then vest linearly before they are collected.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"@prb/math":"4.1.2","@bananapus/core-v6":"^0.0.87","@bananapus/suckers-v6":"^0.0.79","@openzeppelin/contracts":"5.6.1","@bananapus/permission-ids-v6":"^0.0.32"},"_hasShrinkwrap":false,"devDependencies":{"@sphinx-labs/plugins":"0.33.3"},"_npmOperationalInternal":{"tmp":"tmp/jbx-distributor-v6_0.0.6_1781472785848_0.6909811333903237","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"name":"@bananapus/jbx-distributor-v6","version":"1.0.0","license":"MIT","repository":{"type":"git","url":"git+https://github.com/Bananapus/nana-jbx-distributor-v6.git"},"engines":{"node":">=20.0.0"},"scripts":{"test":"forge test","coverage":"forge coverage --match-path \"./src/*.sol\" --report lcov --report summary","deploy:mainnets":"source ./.env && npx sphinx propose ./script/Deploy.s.sol --networks mainnets","deploy:testnets":"source ./.env && npx sphinx propose ./script/Deploy.s.sol --networks testnets"},"dependencies":{"@bananapus/core-v6":"^1.0.0","@bananapus/permission-ids-v6":"^1.0.0","@bananapus/suckers-v6":"^1.0.0","@openzeppelin/contracts":"5.6.1","@prb/math":"4.1.2"},"devDependencies":{"@sphinx-labs/plugins":"0.33.3"},"gitHead":"09dd1b564fd9ceb2cb6e25bc253c0fefd4f7ea19","_id":"@bananapus/jbx-distributor-v6@1.0.0","description":"`@bananapus/jbx-distributor-v6` distributes split-funded rewards to mainnet JBX stakers. Rewards are shared by JBX holders with nonzero delegated voting power at each reward round's snapshot block, then vest linearly before they are collected.","bugs":{"url":"https://github.com/Bananapus/nana-jbx-distributor-v6/issues"},"homepage":"https://github.com/Bananapus/nana-jbx-distributor-v6#readme","_nodeVersion":"25.9.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-h6teFUA/2qKQDFt+NHc7OI5CPKVbOP8PaoUdnoy4GmF1QmQ6sRl1JH2Y+OhynzKvc0WM8CogOQwawC5Qh8wyoQ==","shasum":"b506dee100c169f41d404e338064ddd146e1a8c5","tarball":"https://registry.npmjs.org/@bananapus/jbx-distributor-v6/-/jbx-distributor-v6-1.0.0.tgz","fileCount":21,"unpackedSize":181174,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICt16Ifry/IJofKYWOaTnW8rIpzrmhUPib3wryB+1+uBAiEA59b77OzwIpTEYBbzuvgAOcgawPtoG54DG53pVtRRHsU="}]},"_npmUser":{"name":"me.jango","email":"me.jango@protonmail.com"},"directories":{},"maintainers":[{"name":"simplemachine","email":"justinpulley92@gmail.com"},{"name":"me.jango","email":"me.jango@protonmail.com"},{"name":"filipviz","email":"f@filip.world"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/jbx-distributor-v6_1.0.0_1781484505666_0.48015191454493555"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-10T17:34:00.822Z","modified":"2026-06-15T00:48:27.827Z","0.0.4":"2026-06-10T17:34:01.065Z","0.0.5":"2026-06-10T21:52:29.668Z","0.0.6":"2026-06-14T21:33:05.997Z","1.0.0":"2026-06-15T00:48:25.822Z"},"bugs":{"url":"https://github.com/Bananapus/nana-jbx-distributor-v6/issues"},"license":"MIT","homepage":"https://github.com/Bananapus/nana-jbx-distributor-v6#readme","repository":{"type":"git","url":"git+https://github.com/Bananapus/nana-jbx-distributor-v6.git"},"description":"`@bananapus/jbx-distributor-v6` distributes split-funded rewards to mainnet JBX stakers. Rewards are shared by JBX holders with nonzero delegated voting power at each reward round's snapshot block, then vest linearly before they are collected.","maintainers":[{"name":"simplemachine","email":"justinpulley92@gmail.com"},{"name":"me.jango","email":"me.jango@protonmail.com"},{"name":"filipviz","email":"f@filip.world"}],"readme":"# Juicebox JBX Distributor\n\n`@bananapus/jbx-distributor-v6` distributes split-funded rewards to mainnet JBX stakers. Rewards are shared by JBX\nholders with nonzero delegated voting power at each reward round's snapshot block, then vest linearly before they are\ncollected.\n\nThe package is intentionally narrow:\n\n- projects submit rewards through Juicebox split hooks\n- same-chain mainnet splits fund JBX reward rounds directly\n- remote-chain project-token splits queue for a sucker bridge to mainnet\n- mainnet sucker claims settle bridged project tokens into the same JBX reward ledger\n- the admin sets the JBX staking token once, and cannot replace it\n\n## Documentation\n\n- [ARCHITECTURE.md](./ARCHITECTURE.md) - module overview, cross-chain flow, and trust boundaries.\n- [USER_JOURNEYS.md](./USER_JOURNEYS.md) - end-to-end flows for projects, keepers, and JBX stakers.\n- [INVARIANTS.md](./INVARIANTS.md) - properties the reward ledger, vesting math, and bridge settlement must preserve.\n- [RISKS.md](./RISKS.md) - operational and integration risks.\n- [ADMINISTRATION.md](./ADMINISTRATION.md) - deployment parameters and one-time admin action.\n- [SKILLS.md](./SKILLS.md) - quick index for routing tasks into the right sub-document.\n- [STYLE_GUIDE.md](./STYLE_GUIDE.md) - Solidity and repo conventions used across the Juicebox V6 ecosystem.\n- [AUDIT_INSTRUCTIONS.md](./AUDIT_INSTRUCTIONS.md) - audit framing, targets, and suggested hunting grounds.\n- [CHANGELOG.md](./CHANGELOG.md) - V5 to V6 migration changelog.\n- [references/operations.md](./references/operations.md) - operator checklist.\n- [references/runtime.md](./references/runtime.md) - runtime behavior notes.\n\n## Contracts\n\n| Contract | Role |\n| --- | --- |\n| `JBXDistributor` | Split hook, remote bridge queue, mainnet sucker settlement, and JBX reward specialization. |\n| `JBDistributor` | Shared round, vesting, collection, expiry, and optional Revnet vesting-loan accounting. |\n| `IJBXDistributor` | Integration interface for split-hook funding, bridge preparation, settlement, and JBX setup. |\n\n## Reward Model\n\nEach funded round records:\n\n- the accepted reward token and amount\n- a snapshot block fixed at first funding for that round\n- `IJBActiveVotes.getPastTotalActiveVotes(snapshotBlock)` as the denominator\n- the configured claim deadline, if `CLAIM_DURATION != 0`\n\nRecycling only moves inventory forward. If a keeper passes the current reward round to `recycleExpiredRewards`, the call\nis a no-op, including for zero-active rounds; those rounds can be recycled once a later round is current.\n\nClaim helpers should bound how much history they scan. Rewards can remain claimable across many rounds, but a wallet or\nkeeper should page through historical rounds instead of promising a single unbounded helper call.\n\nEach staker's numerator is `IVotes(JBX).getPastVotes(staker, snapshotBlock)`. The delegate address determines whether\nthe holder has active voting power, but rewards belong to the encoded holder address. Helpers can begin vesting or\ncollect to that canonical holder, so stakers do not need to submit every reward-cycle transaction themselves.\n\n## Cross-Chain Model\n\nRemote chains do not distribute directly. A remote project's split sends that project's token to `JBXDistributor` on\nthe remote chain. A keeper calls `bridgeToMainnet`, which prepares a sucker leaf with this distributor as the mainnet\nbeneficiary and metadata identifying the origin chain and project. On mainnet, `claimRemoteRewards` authenticates the\nleaf against the origin project ID, then records the mainnet project's destination tokens as JBX rewards.\n\nDirect ETH or token balances at the distributor are not rewards until an explicit same-chain funding, remote claim, or\nrecycle path assigns them to a reward round.\n\n## Install\n\n```bash\nnpm install @bananapus/jbx-distributor-v6\n```\n\n## Development\n\n```bash\nnpm install\nforge test --deny notes --fail-fast --summary --detailed --skip \"*/script/**\"\nforge fmt --check\n```\n","readmeFilename":"README.md"}