@bananapus/nana-sdk-core 1.3.0 → 1.4.1

package/dist/cjs/v6/suckers.d.ts

@@ -1,10 +1,361 @@
 import { Address, Hex, PublicClient } from "viem";
 import { JBChainId } from "../types.js";
+/** Common v6 sucker view surface used to reconstruct and verify bridge state. */
+export declare const jbSuckerV6ViewAbi: readonly [{
+    readonly type: "function";
+    readonly name: "peer";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes32";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "peerChainId";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "projectId";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "outboxOf";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "outbox";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "nonce";
+            readonly type: "uint64";
+        }, {
+            readonly name: "numberOfClaimsSent";
+            readonly type: "uint192";
+        }, {
+            readonly name: "balance";
+            readonly type: "uint256";
+        }, {
+            readonly name: "tree";
+            readonly type: "tuple";
+            readonly components: readonly [{
+                readonly name: "branch";
+                readonly type: "bytes32[32]";
+            }, {
+                readonly name: "count";
+                readonly type: "uint256";
+            }];
+        }];
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "inboxOf";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "inbox";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "nonce";
+            readonly type: "uint64";
+        }, {
+            readonly name: "root";
+            readonly type: "bytes32";
+        }];
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "executedLeafHashOf";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "index";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "hash";
+        readonly type: "bytes32";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "remoteTokenFor";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "remoteToken";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "enabled";
+            readonly type: "bool";
+        }, {
+            readonly name: "emergencyHatch";
+            readonly type: "bool";
+        }, {
+            readonly name: "minGas";
+            readonly type: "uint32";
+        }, {
+            readonly name: "addr";
+            readonly type: "bytes32";
+        }];
+    }];
+}];
+/** Event carrying the complete v6 outbox leaf preimage and resulting root. */
+export declare const insertToSuckerOutboxEvent: {
+    readonly type: "event";
+    readonly name: "InsertToOutboxTree";
+    readonly inputs: readonly [{
+        readonly name: "beneficiary";
+        readonly type: "bytes32";
+        readonly indexed: true;
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "hashed";
+        readonly type: "bytes32";
+        readonly indexed: false;
+    }, {
+        readonly name: "index";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "root";
+        readonly type: "bytes32";
+        readonly indexed: false;
+    }, {
+        readonly name: "projectTokenCount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "terminalTokenAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "metadata";
+        readonly type: "bytes32";
+        readonly indexed: false;
+    }, {
+        readonly name: "caller";
+        readonly type: "address";
+        readonly indexed: false;
+    }];
+};
+/** CCIP-only probe used to distinguish fee-bearing sucker transports. */
+export declare const jbCcipSuckerV6Abi: readonly [{
+    readonly type: "function";
+    readonly name: "CCIP_ROUTER";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+}];
+/** Native-bridge-only probes used to positively identify sucker transports. */
+export declare const jbNativeSuckerV6ProbeAbi: readonly [{
+    readonly type: "function";
+    readonly name: "OPMESSENGER";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "ARBINBOX";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+}];
 /**
- * Minimal v6 JBSucker ABI. v6 identifies remote beneficiaries as bytes32 (for cross-VM
- * compatibility) and adds an opaque `metadata` attribution payload to prepared leaves.
+ * Reusable v6 JBSucker ABI: transaction builders, bridge-state views, the
+ * outbox event, and the permissionless accounting-sync entrypoint.
  */
 export declare const jbSuckerV6Abi: readonly [{
+    readonly type: "function";
+    readonly name: "peer";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes32";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "peerChainId";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "projectId";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "outboxOf";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "outbox";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "nonce";
+            readonly type: "uint64";
+        }, {
+            readonly name: "numberOfClaimsSent";
+            readonly type: "uint192";
+        }, {
+            readonly name: "balance";
+            readonly type: "uint256";
+        }, {
+            readonly name: "tree";
+            readonly type: "tuple";
+            readonly components: readonly [{
+                readonly name: "branch";
+                readonly type: "bytes32[32]";
+            }, {
+                readonly name: "count";
+                readonly type: "uint256";
+            }];
+        }];
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "inboxOf";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "inbox";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "nonce";
+            readonly type: "uint64";
+        }, {
+            readonly name: "root";
+            readonly type: "bytes32";
+        }];
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "executedLeafHashOf";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "index";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "hash";
+        readonly type: "bytes32";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "remoteTokenFor";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "remoteToken";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "enabled";
+            readonly type: "bool";
+        }, {
+            readonly name: "emergencyHatch";
+            readonly type: "bool";
+        }, {
+            readonly name: "minGas";
+            readonly type: "uint32";
+        }, {
+            readonly name: "addr";
+            readonly type: "bytes32";
+        }];
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "InsertToOutboxTree";
+    readonly inputs: readonly [{
+        readonly name: "beneficiary";
+        readonly type: "bytes32";
+        readonly indexed: true;
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "hashed";
+        readonly type: "bytes32";
+        readonly indexed: false;
+    }, {
+        readonly name: "index";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "root";
+        readonly type: "bytes32";
+        readonly indexed: false;
+    }, {
+        readonly name: "projectTokenCount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "terminalTokenAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "metadata";
+        readonly type: "bytes32";
+        readonly indexed: false;
+    }, {
+        readonly name: "caller";
+        readonly type: "address";
+        readonly indexed: false;
+    }];
+}, {
     readonly type: "function";
     readonly name: "prepare";
     readonly inputs: readonly [{
@@ -84,6 +435,12 @@ export declare const jbSuckerV6Abi: readonly [{
     }];
     readonly outputs: readonly [];
     readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "syncAccountingData";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
 }];
 /**
  * A leaf of a v6 sucker's merkle tree, representing tokens bridged for one beneficiary.
@@ -96,6 +453,10 @@ export type JBLeaf = {
     terminalTokenAmount: bigint;
     metadata: Hex;
 };
+/** Fields committed by `JBSucker._buildTreeHash` for one outbox leaf. */
+export type JBSuckerLeafData = Pick<JBLeaf, "beneficiary" | "projectTokenCount" | "terminalTokenAmount" | "metadata">;
+/** Reproduce the exact leaf hash committed by a v6 sucker. */
+export declare function suckerLeafHash({ projectTokenCount, terminalTokenAmount, beneficiary, metadata, }: JBSuckerLeafData): Hex;
 /**
  * A 32-entry bytes32 merkle inclusion proof, matching the fixed-size `bytes32[32]` the
  * sucker's `claim` function takes.
@@ -152,6 +513,375 @@ export type JBSuckerPairV6 = {
     remote: Address;
     remoteChainId: bigint;
 };
+/** Fixed depth used by the v6 suckers' incremental Merkle trees. */
+export declare const SUCKER_MERKLE_DEPTH = 32;
+/** MerkleLib's root for an empty depth-32 tree. */
+export declare const SUCKER_EMPTY_TREE_ROOT: Hex;
+/** Hash a MerkleLib node pair (`keccak256(abi.encode(bytes32, bytes32))`). */
+export declare function suckerHashPair(left: Hex, right: Hex): Hex;
+/** Empty-subtree hashes for depths 0 through 32, self-checked at depth 32. */
+export declare function suckerZeroHashes(): readonly Hex[];
+/**
+ * Build the fixed 32-sibling inclusion path for a dense outbox leaf array.
+ * Missing right-hand subtrees are filled with MerkleLib's canonical zero hash.
+ */
+export declare function suckerLeafProof(leafHashes: readonly Hex[], index: number): JBLeafProof;
+/** Recompute a sucker root from one leaf hash and its inclusion proof. */
+export declare function suckerBranchRoot(leafHash: Hex, proof: readonly Hex[], index: number): Hex;
+/** Complete preimage emitted for one v6 sucker outbox leaf. */
+export interface JBSuckerOutboxLeaf {
+    index: number;
+    hashed: Hex;
+    root: Hex;
+    beneficiary: Hex;
+    projectTokenCount: bigint;
+    terminalTokenAmount: bigint;
+    metadata: Hex;
+    blockNumber: bigint;
+}
+/** Log scanning controls for {@link getSuckerOutboxLeaves}. */
+export interface JBSuckerOutboxScanOptions {
+    fromBlock?: bigint;
+    toBlock?: bigint;
+    /** Fallback range size for RPCs which reject a genesis-to-latest query. */
+    blockRange?: bigint;
+    /** Backstop against an accidentally unbounded historical scan. */
+    maxBlockRanges?: number;
+}
+/** Convert a low-20-byte EVM address stored in bytes32 into a checksum address. */
+export declare function suckerBytes32ToAddress(value: Hex): Address;
+/**
+ * Read every dense outbox leaf for a sucker/token and verify the reconstructed
+ * latest root against the root emitted on-chain.
+ *
+ * A wide log request is attempted first. Providers that reject it fall back to
+ * bounded reverse scans, avoiding the subtly truncated histories which would
+ * otherwise produce invalid claim proofs.
+ */
+export declare function getSuckerOutboxLeaves(client: PublicClient, { sucker, token, count: requestedCount, fromBlock, toBlock, blockRange, maxBlockRanges, }: {
+    sucker: Address;
+    token: Address;
+    count?: number;
+} & JBSuckerOutboxScanOptions): Promise<JBSuckerOutboxLeaf[]>;
+/** Lifecycle state of one cross-chain sucker movement. */
+export type JBSuckerMovementStatus = "pending" | "claimable" | "claimed";
+/** Bridge family used by a sucker. Unknown values must fail closed for fees. */
+export type JBSuckerTransport = "ccip" | "native" | "unknown";
+/** Verified movement reconstructed from sucker logs and destination state. */
+export interface JBSuckerMovement {
+    sourceToken: Address;
+    remoteToken: Address;
+    leaf: JBLeaf;
+    leafHash: Hex;
+    outboxRoot: Hex;
+    blockNumber: bigint;
+    status: JBSuckerMovementStatus;
+    /** True when a pending leaf has not yet been included in a toRemote send. */
+    canExecute: boolean;
+    /** Present only when verified against the destination inbox root. */
+    proof: JBLeafProof | null;
+}
+/** Pure status classification shared by bridge movement lists. */
+export declare function classifySuckerMovement({ executed, index, deliveredCount, sentCount, }: {
+    executed: boolean;
+    index: number;
+    deliveredCount: number;
+    sentCount: number;
+}): {
+    status: JBSuckerMovementStatus;
+    canExecute: boolean;
+};
+/**
+ * Reconstruct all movements for one source sucker/token, verify the outbox and
+ * destination inbox roots, and attach a claim proof only to claimable leaves.
+ */
+export declare function getSuckerMovements(sourceClient: PublicClient, destinationClient: PublicClient, { sourceSucker, destinationSucker, sourceToken, remoteToken: requestedRemoteToken, ...scanOptions }: {
+    sourceSucker: Address;
+    destinationSucker: Address;
+    sourceToken: Address;
+    /**
+     * Verified historical mapping override. Required only if a disabled token
+     * mapping has been cleared to bytes32(0); a non-zero live mapping wins and
+     * must agree with this value.
+     */
+    remoteToken?: Address;
+} & JBSuckerOutboxScanOptions): Promise<JBSuckerMovement[]>;
+/** Build a claim object from a movement whose proof was verified by the SDK. */
+export declare function claimFromSuckerMovement(movement: JBSuckerMovement): JBClaim;
+/** Common escalating native-value candidates for CCIP sucker simulations. */
+export declare const CCIP_SUCKER_TRANSPORT_VALUES: readonly bigint[];
+/** Common escalating native-value candidates for native bridge simulations. */
+export declare const NATIVE_SUCKER_TRANSPORT_VALUES: readonly bigint[];
+/** Return the first value whose exact transaction simulation succeeds. */
+export declare function findSuckerTransportValue(values: readonly bigint[], simulate: (value: bigint) => Promise<unknown>): Promise<bigint | null>;
+/** Refuse the CCIP zero-transport path, which would switch fees to LINK. */
+export declare function assertSuckerTransportValue(transport: JBSuckerTransport, value: bigint, baseFee?: bigint): void;
+/**
+ * Positively identify a sucker's bridge family. RPC failures and unfamiliar
+ * implementations return `unknown`; callers must not assume they are native.
+ */
+export declare function classifySuckerTransport(client: PublicClient, sucker: Address): Promise<JBSuckerTransport>;
+/** Build a payable JBSucker.syncAccountingData transaction request. */
+export declare function buildSyncAccountingDataTx(args: {
+    chainId: JBChainId;
+    sucker: Address;
+    value?: bigint;
+}): {
+    chainId: 1 | 10 | 11155111 | 11155420 | 421614 | 84532 | 42161 | 8453;
+    address: `0x${string}`;
+    abi: readonly [{
+        readonly type: "function";
+        readonly name: "peer";
+        readonly stateMutability: "view";
+        readonly inputs: readonly [];
+        readonly outputs: readonly [{
+            readonly name: "";
+            readonly type: "bytes32";
+        }];
+    }, {
+        readonly type: "function";
+        readonly name: "peerChainId";
+        readonly stateMutability: "view";
+        readonly inputs: readonly [];
+        readonly outputs: readonly [{
+            readonly name: "";
+            readonly type: "uint256";
+        }];
+    }, {
+        readonly type: "function";
+        readonly name: "projectId";
+        readonly stateMutability: "view";
+        readonly inputs: readonly [];
+        readonly outputs: readonly [{
+            readonly name: "";
+            readonly type: "uint256";
+        }];
+    }, {
+        readonly type: "function";
+        readonly name: "outboxOf";
+        readonly stateMutability: "view";
+        readonly inputs: readonly [{
+            readonly name: "token";
+            readonly type: "address";
+        }];
+        readonly outputs: readonly [{
+            readonly name: "outbox";
+            readonly type: "tuple";
+            readonly components: readonly [{
+                readonly name: "nonce";
+                readonly type: "uint64";
+            }, {
+                readonly name: "numberOfClaimsSent";
+                readonly type: "uint192";
+            }, {
+                readonly name: "balance";
+                readonly type: "uint256";
+            }, {
+                readonly name: "tree";
+                readonly type: "tuple";
+                readonly components: readonly [{
+                    readonly name: "branch";
+                    readonly type: "bytes32[32]";
+                }, {
+                    readonly name: "count";
+                    readonly type: "uint256";
+                }];
+            }];
+        }];
+    }, {
+        readonly type: "function";
+        readonly name: "inboxOf";
+        readonly stateMutability: "view";
+        readonly inputs: readonly [{
+            readonly name: "token";
+            readonly type: "address";
+        }];
+        readonly outputs: readonly [{
+            readonly name: "inbox";
+            readonly type: "tuple";
+            readonly components: readonly [{
+                readonly name: "nonce";
+                readonly type: "uint64";
+            }, {
+                readonly name: "root";
+                readonly type: "bytes32";
+            }];
+        }];
+    }, {
+        readonly type: "function";
+        readonly name: "executedLeafHashOf";
+        readonly stateMutability: "view";
+        readonly inputs: readonly [{
+            readonly name: "token";
+            readonly type: "address";
+        }, {
+            readonly name: "index";
+            readonly type: "uint256";
+        }];
+        readonly outputs: readonly [{
+            readonly name: "hash";
+            readonly type: "bytes32";
+        }];
+    }, {
+        readonly type: "function";
+        readonly name: "remoteTokenFor";
+        readonly stateMutability: "view";
+        readonly inputs: readonly [{
+            readonly name: "token";
+            readonly type: "address";
+        }];
+        readonly outputs: readonly [{
+            readonly name: "remoteToken";
+            readonly type: "tuple";
+            readonly components: readonly [{
+                readonly name: "enabled";
+                readonly type: "bool";
+            }, {
+                readonly name: "emergencyHatch";
+                readonly type: "bool";
+            }, {
+                readonly name: "minGas";
+                readonly type: "uint32";
+            }, {
+                readonly name: "addr";
+                readonly type: "bytes32";
+            }];
+        }];
+    }, {
+        readonly type: "event";
+        readonly name: "InsertToOutboxTree";
+        readonly inputs: readonly [{
+            readonly name: "beneficiary";
+            readonly type: "bytes32";
+            readonly indexed: true;
+        }, {
+            readonly name: "token";
+            readonly type: "address";
+            readonly indexed: true;
+        }, {
+            readonly name: "hashed";
+            readonly type: "bytes32";
+            readonly indexed: false;
+        }, {
+            readonly name: "index";
+            readonly type: "uint256";
+            readonly indexed: false;
+        }, {
+            readonly name: "root";
+            readonly type: "bytes32";
+            readonly indexed: false;
+        }, {
+            readonly name: "projectTokenCount";
+            readonly type: "uint256";
+            readonly indexed: false;
+        }, {
+            readonly name: "terminalTokenAmount";
+            readonly type: "uint256";
+            readonly indexed: false;
+        }, {
+            readonly name: "metadata";
+            readonly type: "bytes32";
+            readonly indexed: false;
+        }, {
+            readonly name: "caller";
+            readonly type: "address";
+            readonly indexed: false;
+        }];
+    }, {
+        readonly type: "function";
+        readonly name: "prepare";
+        readonly inputs: readonly [{
+            readonly name: "projectTokenCount";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "beneficiary";
+            readonly type: "bytes32";
+            readonly internalType: "bytes32";
+        }, {
+            readonly name: "minTokensReclaimed";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "token";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "metadata";
+            readonly type: "bytes32";
+            readonly internalType: "bytes32";
+        }];
+        readonly outputs: readonly [];
+        readonly stateMutability: "nonpayable";
+    }, {
+        readonly type: "function";
+        readonly name: "toRemote";
+        readonly inputs: readonly [{
+            readonly name: "token";
+            readonly type: "address";
+            readonly internalType: "address";
+        }];
+        readonly outputs: readonly [];
+        readonly stateMutability: "payable";
+    }, {
+        readonly type: "function";
+        readonly name: "claim";
+        readonly inputs: readonly [{
+            readonly name: "claimData";
+            readonly type: "tuple";
+            readonly internalType: "struct JBClaim";
+            readonly components: readonly [{
+                readonly name: "token";
+                readonly type: "address";
+                readonly internalType: "address";
+            }, {
+                readonly name: "leaf";
+                readonly type: "tuple";
+                readonly internalType: "struct JBLeaf";
+                readonly components: readonly [{
+                    readonly name: "index";
+                    readonly type: "uint256";
+                    readonly internalType: "uint256";
+                }, {
+                    readonly name: "beneficiary";
+                    readonly type: "bytes32";
+                    readonly internalType: "bytes32";
+                }, {
+                    readonly name: "projectTokenCount";
+                    readonly type: "uint256";
+                    readonly internalType: "uint256";
+                }, {
+                    readonly name: "terminalTokenAmount";
+                    readonly type: "uint256";
+                    readonly internalType: "uint256";
+                }, {
+                    readonly name: "metadata";
+                    readonly type: "bytes32";
+                    readonly internalType: "bytes32";
+                }];
+            }, {
+                readonly name: "proof";
+                readonly type: "bytes32[32]";
+                readonly internalType: "bytes32[32]";
+            }];
+        }];
+        readonly outputs: readonly [];
+        readonly stateMutability: "nonpayable";
+    }, {
+        readonly type: "function";
+        readonly name: "syncAccountingData";
+        readonly stateMutability: "payable";
+        readonly inputs: readonly [];
+        readonly outputs: readonly [];
+    }];
+    functionName: "syncAccountingData";
+    args: readonly [];
+    value: bigint;
+};
+/** Relative absolute drift between two unsigned bigint values, from 0 to 1. */
+export declare function relativeSuckerDrift(left: bigint, right: bigint): number;
+/** Unpack a sucker freshness key (`timestamp << 128 | sequence`). */
+export declare function suckerTimestampSeconds(value: bigint): number;
 /**
  * Builds a `prepare` transaction on a v6 sucker, locking project tokens into an outbox
  * leaf destined for the remote chain.
@@ -244,4 +974,12 @@ export declare function getV6SuckerPairs(client: PublicClient, { chainId, projec
     chainId: JBChainId;
     projectId: bigint;
 }): Promise<JBSuckerPairV6[]>;
+/**
+ * Read active and deprecated suckers for a project. Historical suckers remain
+ * relevant because their already-delivered leaves can still be claimed.
+ */
+export declare function getAllV6SuckerPairs(client: PublicClient, { chainId, projectId }: {
+    chainId: JBChainId;
+    projectId: bigint;
+}): Promise<JBSuckerPairV6[]>;
 //# sourceMappingURL=suckers.d.ts.map