Skip to main content

IFdcHub

Primary interface for interacting with the Flare Data Connector (FDC).

Sourced from IFdcHub.sol on GitHub.

Overview

The IFdcHub interface serves as the main entry point for applications requesting attestations from the Flare Data Connector. It provides functionality to request attestations, access configuration contracts, and handle related events.

Functions

fdcInflationConfigurations

Returns the FDC inflation configurations contract address.

function fdcInflationConfigurations(
) external view returns (
contract IFdcInflationConfigurations
);

Returns

  • IFdcInflationConfigurations: Contract interface for accessing inflation configurations

fdcRequestFeeConfigurations

Returns the FDC request fee configurations contract address.

function fdcRequestFeeConfigurations(
) external view returns (
contract IFdcRequestFeeConfigurations
);

Returns

  • IFdcRequestFeeConfigurations: Contract interface for accessing request fee configurations

requestAttestation

Requests an attestation from the Flare Data Connector.

function requestAttestation(
bytes _data
) external payable;

Parameters

  • _data: ABI encoded attestation request

Note: This function is payable and requires a fee based on the attestation type.

requestsOffsetSeconds

Returns the offset (in seconds) for the requests to be processed during the current voting round.

function requestsOffsetSeconds(
) external view returns (
uint8
);

Returns

  • uint8: Offset in seconds

Events

AttestationRequest

Emitted when an attestation request is submitted.

event AttestationRequest(
bytes data,
uint256 fee
)

Parameters

  • data: The encoded attestation request data
  • fee: The amount paid for the attestation request

InflationRewardsOffered

Emitted when inflation rewards are offered.

event InflationRewardsOffered(
uint24 rewardEpochId,
struct IFdcInflationConfigurations.FdcConfiguration[] fdcConfigurations,
uint256 amount
)

Parameters

  • rewardEpochId: The ID of the reward epoch
  • fdcConfigurations: Array of FDC configurations
  • amount: The total amount of rewards offered

RequestsOffsetSet

Emitted when the requests offset is updated.

event RequestsOffsetSet(
uint8 requestsOffsetSeconds
)

Parameters

  • requestsOffsetSeconds: The new offset value in seconds

Usage Example

AddressSolidity.sol
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.25;

import {ContractRegistry} from "@flarenetwork/flare-periphery-contracts/coston2/ContractRegistry.sol";
import {IFdcVerification} from "@flarenetwork/flare-periphery-contracts/coston2/IFdcVerification.sol";
import {IAddressValidity} from "@flarenetwork/flare-periphery-contracts/coston2/IAddressValidity.sol";

interface IAddressRegistry {
function registerAddress(
IAddressValidity.Proof memory _transaction
) external;
}

contract AddressRegistry is IAddressRegistry {
string[] public verifiedAddresses;

function registerAddress(
IAddressValidity.Proof memory _transaction
) public {
// 1. FDC Logic
// Check that this AddressValidity has indeed been confirmed by the FDC
require(
isAddressValidityProofValid(_transaction),
"Invalid transaction proof"
);

// 2. Business logic
string memory provedAddress = _transaction.data.requestBody.addressStr;

verifiedAddresses.push(provedAddress);
}

function isAddressValidityProofValid(
IAddressValidity.Proof memory transaction
) public view returns (bool) {
// Use the library to get the verifier contract and verify that this transaction was proved by state connector
IFdcVerification fdc = ContractRegistry.getFdcVerification();
return fdc.verifyAddressValidity(transaction);
}
}