Skip to main content
Standard Gnosis / Polymarket conditional token framework. Unchanged from upstream — PredictStreet uses it as the settlement substrate.

​
Key concepts

  • Condition — an (oracle, questionId, outcomeSlotCount) tuple.
  • Position — an ERC-1155 balance of a specific outcome slot within a condition.
  • Redemption — once the oracle reports payouts, holders call redeemPositions to exchange winning tokens for USDC.

​
Prepare a condition

function prepareCondition(
    address oracle,
    bytes32 questionId,
    uint256 outcomeSlotCount
) external;
Called by oracle-service as part of market deployment.

​
Redeem winning positions

function redeemPositions(
    IERC20 collateralToken,
    bytes32 parentCollectionId,
    bytes32 conditionId,
    uint256[] calldata indexSets
) external;

​
Redeeming via the contract

Partners can either call ConditionalTokens.redeemPositions directly from their own client (this page describes that signature), or hand the job to the platform via POST /api/me/redemptions — the off-chain helper queues a submitter-executed redemption against your vault. Either path lands the same PayoutRedemption event on-chain. The off-chain ledger picks it up via chain-watcher and credits /api/me/balances.collateral accordingly; no extra API call is required to “claim” winnings beyond the initial redemption.

​
Events

event ConditionPreparation(bytes32 indexed conditionId, address indexed oracle, ...);
event ConditionResolution(bytes32 indexed conditionId, ...);
event PositionSplit(address indexed stakeholder, ...);
event PositionsMerge(address indexed stakeholder, ...);
event PayoutRedemption(address indexed redeemer, bytes32 indexed conditionId, ...);

​
Source

0x66Ed938E9Dec9A1df6033d66560d5fe6117EE744 on Blockscout (testnet). Tracks upstream Gnosis ConditionalTokens v1.0.1 with only build-system changes.