@bananapus/suckers-v6 0.0.76 → 0.0.78

package/src/interfaces/IJBSucker.sol

@@ -5,6 +5,7 @@ import {IERC165} from "@openzeppelin/contracts/utils/introspection/IERC165.sol";
 import {IJBDirectory} from "@bananapus/core-v6/src/interfaces/IJBDirectory.sol";
 import {IJBProjects} from "@bananapus/core-v6/src/interfaces/IJBProjects.sol";
 import {IJBTokens} from "@bananapus/core-v6/src/interfaces/IJBTokens.sol";
+import {JBAccountingSnapshot} from "../structs/JBAccountingSnapshot.sol";
 import {JBClaim} from "../structs/JBClaim.sol";
 import {JBInboxTreeRoot} from "../structs/JBInboxTreeRoot.sol";
 import {JBOutboxTree} from "../structs/JBOutboxTree.sol";
@@ -18,6 +19,11 @@ import {JBTokenMapping} from "../structs/JBTokenMapping.sol";
 interface IJBSucker is IERC165 {
     // Events
 
+    /// @notice Emitted when peer-chain accounting data is sent without a merkle-root update.
+    /// @param sourceTimestamp The source freshness key assigned to the snapshot.
+    /// @param caller The address that initiated the send.
+    event AccountingDataSynced(uint256 sourceTimestamp, address caller);
+
     /// @notice Emitted when a beneficiary claims bridged tokens from the inbox tree.
     /// @param beneficiary The beneficiary receiving the tokens.
     /// @param token The terminal token address.
@@ -207,6 +213,10 @@ interface IJBSucker is IERC165 {
     /// @param claimData The claim data including token, leaf, and proof.
     function claim(JBClaim calldata claimData) external;
 
+    /// @notice Receive peer-chain accounting data from the remote sucker without a merkle-root update.
+    /// @param snapshot The accounting snapshot to store.
+    function fromRemoteAccounting(JBAccountingSnapshot calldata snapshot) external;
+
     /// @notice Map a local token to a remote token for bridging.
     /// @param map The token mapping to add.
     function mapToken(JBTokenMapping calldata map) external payable;
@@ -232,6 +242,10 @@ interface IJBSucker is IERC165 {
     )
         external;
 
+    /// @notice Send peer-chain accounting data without sending an outbox root or paying the registry `toRemoteFee`.
+    /// @dev The caller still provides bridge transport payment through `msg.value` when the bridge requires it.
+    function syncAccountingData() external payable;
+
     /// @notice Send the outbox tree root and bridged assets to the remote peer.
     /// @param token The terminal token to bridge.
     function toRemote(address token) external payable;

package/src/libraries/JBSuckerLib.sol

@@ -13,6 +13,7 @@ import {IERC165} from "@openzeppelin/contracts/utils/introspection/ERC165.sol";
 
 import {IJBPeerChainAdjustedAccounts} from "../interfaces/IJBPeerChainAdjustedAccounts.sol";
 import {JBPeerChainAdjustedAccountsLib} from "./JBPeerChainAdjustedAccountsLib.sol";
+import {JBAccountingSnapshot} from "../structs/JBAccountingSnapshot.sol";
 import {JBInboxTreeRoot} from "../structs/JBInboxTreeRoot.sol";
 import {JBMessageRoot} from "../structs/JBMessageRoot.sol";
 import {JBSourceContext} from "../structs/JBSourceContext.sol";
@@ -36,6 +37,37 @@ library JBSuckerLib {
     // ---------------------- external transactions ---------------------- //
     //*********************************************************************//
 
+    /// @notice Build the cross-chain accounting snapshot (total supply plus per-context surplus and balance).
+    /// @dev Extracted from `JBSucker.syncAccountingData` to reduce child contract bytecode. Called via DELEGATECALL.
+    /// The snapshot carries each context's surplus and balance in its own currency, without price-feed valuation.
+    /// @param directory The JB directory to look up controllers and terminals.
+    /// @param projectId The project ID.
+    /// @param messageVersion The message format version.
+    /// @param sourceTimestamp The monotonic source freshness key for this snapshot.
+    /// @return snapshot The constructed accounting snapshot.
+    function buildAccountingSnapshot(
+        IJBDirectory directory,
+        uint256 projectId,
+        uint8 messageVersion,
+        uint256 sourceTimestamp
+    )
+        external
+        view
+        returns (JBAccountingSnapshot memory snapshot)
+    {
+        // Snapshot the project's per-context surplus and balance, un-valued. No price oracle is consulted on send.
+        (uint256 localTotalSupply, JBSourceContext[] memory sourceContexts) =
+            _snapshotAccountsOf({directory: directory, projectId: projectId});
+
+        // Construct the accounting-only message without any token-local merkle root.
+        snapshot = JBAccountingSnapshot({
+            version: messageVersion,
+            sourceTotalSupply: localTotalSupply,
+            sourceContexts: sourceContexts,
+            sourceTimestamp: sourceTimestamp
+        });
+    }
+
     /// @notice Build the cross-chain snapshot message (total supply plus per-context surplus and balance).
     /// @dev Extracted from `JBSucker._buildSnapshotAndSend` to reduce child contract bytecode. Called via DELEGATECALL.
     /// The snapshot carries each context's surplus and balance in its own currency, without price-feed valuation.

package/src/structs/JBAccountingSnapshot.sol

@@ -0,0 +1,19 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.0;
+
+import {JBSourceContext} from "./JBSourceContext.sol";
+
+/// @notice A peer-chain accounting snapshot, without any token-local merkle root or transported value.
+/// @custom:member version The message format version. Used to reject incompatible messages.
+/// @custom:member sourceTotalSupply The total token supply (including reserved tokens) on the source chain at the
+/// time the message was sent. Used by the receiving chain to track cross-chain supply for cash out tax calculations.
+/// @custom:member sourceContexts The source chain's surplus and balance per accounting context, each in the context's
+/// own currency and decimals, un-valued.
+/// @custom:member sourceTimestamp A monotonic source-chain freshness key for the snapshot. Used by the receiving
+/// chain to reject stale surplus/balance/supply updates.
+struct JBAccountingSnapshot {
+    uint8 version;
+    uint256 sourceTotalSupply;
+    JBSourceContext[] sourceContexts;
+    uint256 sourceTimestamp;
+}