IInfraMarket
Functions
ctor
function ctor(address operator, address emergencyCouncil, address lockup, address lockedArbToken, address factory)
external;
register
Register this campaign, taking a small stipend for management from the creator in the form of $3 fUSDC. Factory caller only.
function register(address trading, bytes32 desc, uint64 launchTs, uint64 callDeadlineTs) external returns (uint256);
Parameters
| Name | Type | Description |
|---|---|---|
trading | address | address to configure this |
desc | bytes32 | of the contract to commit as info for users. Should be info for a oracle. |
launchTs | uint64 | to use as the timestamp to begin this infra market. Could be the conclusion date. |
callDeadlineTs | uint64 |
call
Call the outcome, changing the state to allow a user to disagree with it with the whinge function. Takes a $2 fUSDC bond.
function call(address tradingAddr, bytes8 winner, address incentiveRecipient) external returns (uint256);
Parameters
| Name | Type | Description |
|---|---|---|
tradingAddr | address | to call for. |
winner | bytes8 | to indicate is the preferred outcome by this user. |
incentiveRecipient | address | to send future incentive amounts, and the refund for the bond to. |
whinge
Whinge the outcome, indicating that the sender disagrees with the call decision that was made. This is only possible during a two day window. A $7 fUSDC must be taken from the user.
function whinge(address tradingAddr, bytes8 preferredOutcome, address bondRecipient) external returns (uint256);
Parameters
| Name | Type | Description |
|---|---|---|
tradingAddr | address | to use for the disagreement that's taking place. |
preferredOutcome | bytes8 | to use as the outcome that the whinger disagrees is the best. |
bondRecipient | address | to send the bond that's refunded back to. |
predict
Make a commitment as to what the preferred outcome should be, now that there's been calling and whinging. The voting power comes from the lockup contract, which takes ARB and locks it up for an amount of time that this trading should close.
function predict(address tradingAddr, bytes32 commit) external;
Parameters
| Name | Type | Description |
|---|---|---|
tradingAddr | address | to use as the trading address to make commitments for. |
commit | bytes32 | to use as the commitment for what the outcome should be. |
curOutcomeVestedArb
Get the amount of vested ARB in a specific outcome produced by reveals up until now.
function curOutcomeVestedArb(address trading, bytes8 outcome) external view returns (uint256);
Parameters
| Name | Type | Description |
|---|---|---|
trading | address | contract this is for. |
outcome | bytes8 | that we want to know. |
epochNumber
Get the current epoch number for the trading contract given.
function epochNumber(address trading) external view returns (uint256 epochNo);
Parameters
| Name | Type | Description |
|---|---|---|
trading | address | to check. |
whingerPreferredWinner
Get the preferred whinger of the infra market given.
function whingerPreferredWinner(address trading) external view returns (bytes8);
Parameters
| Name | Type | Description |
|---|---|---|
trading | address | contract to get the amount for. |
callerPreferredOutcome
Get the caller preferred outcome of the infra market given.
function callerPreferredOutcome(address trading) external view returns (bytes8);
Parameters
| Name | Type | Description |
|---|---|---|
trading | address | contract to get the amount for. |
reveal
Reveal a previously made commitment. Should be done in the revealing period (two days after the first whinge, for two days).
function reveal(address tradingAddr, address committerAddr, bytes8 outcome, uint256 seed) external;
Parameters
| Name | Type | Description |
|---|---|---|
tradingAddr | address | to use as the place for the commitments to be tracked. |
committerAddr | address | to use as the address of the user making commitments. |
outcome | bytes8 | to state the previously made commitment was for. |
seed | uint256 | to use as the random nonce for the reveal. |
sweep
Sweep money from a bettor who bet incorrectly, or someone who neglected to reveal their commitment, who is assumed to be betting that the system is in an indeterminate state.
function sweep(address tradingAddr, uint256 epochNo, address victim, address feeRecipientAddr)
external
returns (uint256 yieldForFeeRecipient);
Parameters
| Name | Type | Description |
|---|---|---|
tradingAddr | address | to use as the trading address for the campaign. |
epochNo | uint256 | to use as the epoch number to take funds from. |
victim | address | to claim funds from. |
feeRecipientAddr | address | to send the small amount taken from the victim to (1%). |
capture
Capture amounts from the prize pool. Can only be done once, so be careful!
function capture(address tradingAddr, uint256 epochNo, address feeRecipient)
external
returns (uint256 yieldForFeeRecipient);
Parameters
| Name | Type | Description |
|---|---|---|
tradingAddr | address | to capture amounts from. |
epochNo | uint256 | to collect amounts from the pot from. |
feeRecipient | address | to send incentive amounts to. |
close
Close this campaign if it's been in a state where anyone can whinge for some time, two days since someone whinged and no-one had whinged.
function close(address tradingAddr, address feeRecipient) external;
Parameters
| Name | Type | Description |
|---|---|---|
tradingAddr | address | this market is for. |
feeRecipient | address | to send the incentive for closing to. |
escape
Escape a trading market that has gone over the limit. This calls the escape function in the trading contract to indicate something has gone wrong. This should only be callable if the contract is in the state for calling past the deadline.
function escape(address tradingAddr) external;
Parameters
| Name | Type | Description |
|---|---|---|
tradingAddr | address | to escape. |
winner
Winner that was declared for this infra market, if there is one.
function winner(address tradingAddr) external view returns (bytes8 winnerId);
status
Status of this trading contract's oracle.
function status(address tradingAddr) external view returns (InfraMarketState currentState, uint64 secsRemaining);
startTs
Starting timestamp of the campaign.
function startTs(address trading) external view returns (uint64);
endTs
Ending timestamp of the campaign.
function endTs(address trading) external view returns (uint64);
declare
Declare a winner, by providing the outcomes that were in use, along with a fee recipient to collect the fee for providing this correct calldata to.
function declare(address tradingAddr, bytes8[] calldata outcomes, address feeRecipient) external returns (uint256);
Parameters
| Name | Type | Description |
|---|---|---|
tradingAddr | address | to use as the trading address for the campaign. |
outcomes | bytes8[] | to use as the outcomes that were in use. |
feeRecipient | address | to send the incentive for declaring to. |
enableContract
Enable or disable the contract.
function enableContract(bool status) external returns (bool);
Parameters
| Name | Type | Description |
|---|---|---|
status | bool | to set the contract to. |