# Voting Escrow Aggregator



## Overview [#overview]

`SpectraVotingEscrowAggregator` reads NFT voting power from the escrows registered in [GovernanceRegistry](/docs/technical-reference/contract-functions/governanceregistry). It applies each escrow's configured weight and can sum the voting power of all NFTs owned by a wallet.

Unlike [VotingEscrow](/docs/technical-reference/contract-functions/votingescrow), where `balanceOf(address)` counts NFTs, the aggregator's `balanceOf(address)` returns weighted voting power.

## NFT and escrow voting power [#nft-and-escrow-voting-power]

```solidity
function getVotingPowerOfNFT(address _ve, uint256 _tokenId) external view returns (uint256)
function getVotingPowerOfNFTAt(address _ve, uint256 _tokenId, uint256 _t) external view returns (uint256)
function getTotalVotingPowerOfVE(address _ve) external view returns (uint256)
function getTotalVotingPowerOfVEAt(address _ve, uint256 _t) external view returns (uint256)
```

`_ve` identifies a registered escrow and `_tokenId` identifies one of its NFTs. Timestamped reads use a Unix timestamp in seconds and the escrow weight recorded at that timestamp. Queries for an unregistered escrow revert.

For each escrow, weighted voting power is its NFT or total voting power multiplied by `getVeWeightAt(_ve, timestamp)` and divided by `1e18`.

## Wallet and aggregate voting power [#wallet-and-aggregate-voting-power]

```solidity
function getTotalVotingPowerOfUser(address _user) external view returns (uint256)
function balanceOf(address _user) external view returns (uint256)
function getTotalVotingPower() external view returns (uint256)
function getTotalVotingPowerAt(uint256 _t) external view returns (uint256)
function totalSupply() external view returns (uint256)
```

`balanceOf` is an alias for `getTotalVotingPowerOfUser`: both enumerate the wallet's currently owned NFTs across registered escrows. `totalSupply` is an alias for `getTotalVotingPower`. These views report voting power; they do not create locks, cast votes, or claim rewards.