settleWithAttestation()

Submit a signed resolution attestation to settle an expired option series. Anyone holding option tokens for the series (or the contract owner) can relay the attestation. The contract verifies the EIP-712 signature against the registered resolutionSigner. After settlement, holders can call claimHolderPayout() and writers can call claimWriterCollateral(). Contract: ConvallaxCore — 0x76c41a03e0993F0261bB3B1949320cA693f76faE

Function Signature

function settleWithAttestation(
    uint256 seriesId,
    uint16 resolutionBps,
    uint256 validUntil,
    bytes calldata signature
) external

Parameters

uint256

required

The expired option series to settle.

uint16

required

Resolution price in basis points (0–100). 0 = NO wins, 100 = YES wins, or any intermediate value for a continuous TWAP settlement.

uint256

required

Attestation expiry (Unix timestamp). Must be ≥ block.timestamp.

bytes

required

EIP-712 signature from the resolution signer over the SettlementAttestation struct.

EIP-712 Domain

Field	Value
`name`	`ConvallaxCore`
`version`	`1`
`chainId`	`80002`
`verifyingContract`	`0x76c41a03e0993F0261bB3B1949320cA693f76faE`

Attestation Struct

struct SettlementAttestation {
    uint256 seriesId;
    uint16  resolutionBps;
    uint256 validUntil;
}

Getting the Attestation

Use POST /settlement/prepare to compute the VWAP and receive the signed attestation. Pass the returned values directly to this function.

Prerequisites

block.timestamp ≥ expiry — the option must have expired
The series must not already be settled
The caller must hold option tokens for the series, or be the contract owner
block.timestamp ≤ validUntil — the attestation must not have expired
The signature must recover to the registered resolutionSigner

Example

const core = new ethers.Contract(
  '0x76c41a03e0993F0261bB3B1949320cA693f76faE',
  ['function settleWithAttestation(uint256 seriesId, uint16 resolutionBps, uint256 validUntil, bytes signature) external'],
  signer
);

// Values from POST /settlement/prepare
const tx = await core.settleWithAttestation(
  seriesId,
  59,        // resolutionBps
  validUntil,
  signature
);
await tx.wait();

Reverts

Condition	Reason
Not yet expired	`SeriesNotExpired(seriesId)`
Already settled	`AlreadySettled(seriesId)`
Attestation expired	`AttestationExpired`
Invalid signer	`InvalidSigner`
Caller has no tokens and is not owner	`NotHolderOrOwner`

Overview

Series

Trading

Market Maker

User

Settlement

On-Chain Contracts

Testnet

settleWithAttestation()

Function Signature

Parameters

EIP-712 Domain

Attestation Struct

Getting the Attestation

Prerequisites

Example

Reverts

​Function Signature

​Parameters

​EIP-712 Domain

​Attestation Struct

​Getting the Attestation

​Prerequisites

​Example

​Reverts

Function Signature

Parameters

EIP-712 Domain

Attestation Struct

Getting the Attestation

Prerequisites

Example

Reverts