IIndex.sol

Concepto Central: Instrucciones de Swap e Intents#

Para ejecutar un rebalanceo, el llamante debe proporcionar un array de instrucciones SwapStep. El protocolo compara el resultado de estos pasos con el PendingIntent previamente bloqueado.

Tanto rebalanceIntent() como rebalance() son permissionless: cualquiera puede llamarlas una vez pasados los períodos de enfriamiento. Versiones anteriores de esta documentación describían esto como la tarea de un motor de retransmisión off-chain, y en la práctica suele ser un llamante automatizado el que lo activa, pero nada en la interfaz privilegia a ese llamante sobre cualquier otro.

Fragmento crucial para Builders: Los Tipos de Ejecución#

/// @notice A single swap step used to rebalance the garden.
struct SwapStep {
    bytes32 dexId; // Resolved to a selector on-chain (e.g., keccak256("UNISWAP_V3"))
    SwapInstruction instruction; // Contains tokens, pools, amounts and a deadline
}
 
/// @notice Pending rebalance intent data (slimmed for gas efficiency)
struct PendingIntent {
    bool active;
    uint256 totalValueUsd; // Portfolio value at intent creation
    bytes32[] symbols;
    uint256[] targetValues; // Desired USD value per token
}