Detailed Instructions

The first step involves selecting a decentralized oracle network like Chainlink to source reliable, tamper-proof data. You must identify the specific Price Feed Aggregator smart contracts for each asset in the portfolio. For example, to get the price of Ethereum, you would use the ETH/USD feed.

• Sub-step 1: Identify Required Feeds: Determine the correct proxy address for each asset pair. For the mainnet ETH/USD feed, this is 0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419.
• Sub-step 2: Verify Data Freshness: Check the latestRoundData() function on the aggregator to confirm the answeredInRound and updatedAt timestamps are recent.
• Sub-step 3: Assess Aggregation: Understand that the reported price is an aggregate from multiple high-quality exchanges, weighted by liquidity, to prevent manipulation.

Tip: Always reference the official oracle network documentation for the most current and verified contract addresses.

Detailed Instructions

Your portfolio valuation smart contract must now call the oracle contract to retrieve the latest price data. This is a critical read operation that must handle potential oracle staleness or failure. The data is returned as a structured set of integers representing price, decimals, and timestamps.

• Sub-step 1: Execute the Call: Use the latestRoundData function on the identified aggregator address.
• Sub-step 2: Parse the Response: Decode the returned tuple (roundId, answer, startedAt, updatedAt, answeredInRound). The answer is the price, but you must account for decimals (often 8).
• Sub-step 3: Validate Timestamps: Implement a staleness check. Revert if block.timestamp - updatedAt exceeds a predefined threshold (e.g., 1 hour or 3600 seconds).

solidityCopy
// Example Solidity snippet for fetching and validating a price
(, int256 price, , uint256 updatedAt, ) = AggregatorV3Interface(priceFeed).latestRoundData();
require(block.timestamp - updatedAt < 3600, "Stale price data");
uint8 decimals = AggregatorV3Interface(priceFeed).decimals();
uint256 normalizedPrice = uint256(price) * (10 ** (18 - decimals)); // Normalize to 18 decimals

Tip: Always use the require statement to enforce data freshness and protect your contract from using outdated information.

Detailed Instructions

With validated price data for each asset, the system must now aggregate portfolio positions. This involves fetching the user's balance for each token, converting that quantity to a common base currency (like USD), and summing the results. This step is often performed off-chain for efficiency but can be done on-chain for decentralized applications.

• Sub-step 1: Fetch Token Balances: Query the balance of each ERC-20 token for the user's wallet address (e.g., 0x1234...) using the token contract's balanceOf function.
• Sub-step 2: Calculate Individual Asset Value: For each asset, multiply the normalized balance by the normalized oracle price. assetValue = (tokenBalance * price) / 10**decimalsCorrection.
• Sub-step 3: Sum Total Portfolio Value: Iterate through all assets in the portfolio, summing their USD-equivalent values to produce a total portfolio valuation.

javascriptCopy
// Example off-chain JavaScript aggregation logic
const totalValue = portfolioAssets.reduce((sum, asset) => {
  const balance = await tokenContract.balanceOf(userAddress);
  const price = await oracleContract.latestAnswer();
  const assetValue = (balance * price) / Math.pow(10, asset.decimals + priceDecimals);
  return sum + assetValue;
}, 0);
console.log(`Total Portfolio Value: $${totalValue.toFixed(2)}`);

Tip: Ensure consistent decimal handling across all assets to avoid catastrophic calculation errors. Using libraries like ethers.js or web3.js simplifies big number arithmetic.

Detailed Instructions

The final value must be presented reliably and mechanisms put in place for continuous monitoring. This involves updating the UI/UX for users and potentially triggering smart contract logic based on valuation thresholds, such as for liquidation events in lending protocols.

• Sub-step 1: Deliver to Frontend: Send the aggregated portfolio value to a dashboard. For a dApp, this might involve emitting an event from the smart contract or using a subgraph for indexed querying.
• Sub-step 2: Implement Update Triggers: Use oracle heartbeat or price deviation thresholds (e.g., a 1% change) to trigger recalculations, rather than polling constantly. Listen for the AnswerUpdated event from the oracle.
• Sub-step 3: Set Up Alerts: Configure off-chain keepers or on-chain automation (e.g., Gelato Network) to monitor the portfolio value against a user-defined health factor (e.g., 1.5). If it drops below 1.1, initiate a rebalancing or alert the user.

Tip: For production systems, implement a circuit breaker or a fallback oracle mechanism to maintain service if a primary oracle fails, ensuring resilient portfolio valuation.