Resolution period
The buyer raised a dispute. The buyer and seller can try to mutually resolve it. If they are unable to do so, the buyer can escalate the dispute and dispute resolve then decides the split.
REDEEMED
DISPUTED
RETRACTED RESOLVED ESCALATED
Period actions
Extend the dispute timeout
Retracts the dispute
/
Resolve the dispute
Resolve the dispute
Escalate the dispute
Post-period actions
Expire the dispute
Expire the dispute
Expire the dispute
TypeScript SDK
Extends the dispute timeout, allowing more time for mutual resolution.
const exchangeId = "1534";
const newTimeout = Date.now()/1000 + 5 * 24 * 60 * 60;
await sellerCoreSDK.extendDisputeTimeout(
exchangeId,
newTimeout
);The buyer and the seller mutually resolve the dispute and submit the decision on how the pot is split.
The buyer signs the proposal; the seller submits the transaction
const exchangeId = "1534";
const buyerPercentBasisPoints = 30_00;
const {
r: sigR,
s: sigS,
v: sigV
} = await buyerCoreSDK.signDisputeResolutionProposal({
exchangeId,
buyerPercentBasisPoints
});
await sellerCoreSDK.resolveDispute({
exchangeId: exchangeId,
buyerPercentBasisPoints,
sigR,
sigS,
sigV
});The seller signs the proposal; the buyer submits the transaction
const exchangeId = "1534";
const buyerPercentBasisPoints = 30_00;
const {
r: sigR,
s: sigS,
v: sigV
} = await sellerCoreSDK.signDisputeResolutionProposal({
exchangeId,
buyerPercentBasisPoints
});
await buyerCoreSDK.resolveDispute({
exchangeId: exchangeId,
buyerPercentBasisPoints,
sigR,
sigS,
sigV
});The buyer retracts the dispute. The outcome is equivalent to a normally completed exchange. The seller gets the price and the seller's deposit and the DR Fee is returned to the mutualizer.
const exchangeId = "1534";
await buyerCoreSDK.retractDispute(exchangeId);The dispute cannot be mutually resolved, and the Dispute Resolver is activated to decide on the split of the pot. The buyer must pay an escalation deposit to call this method. The escalation deposit is added to the pot that is then split between the seller and the buyer.
const exchangeId = "1534";
await buyerCoreSDK.escalateDispute(exchangeId);If the seller and buyer did not perform any protocol action, the dispute can be expired. The outcome is equivalent to a normally completed exchange. The seller gets the price and the seller's deposit and the DR Fee is returned to the mutualizer.
const exchangeId = "1534";
await coreSDK.expireDispute(exchangeId);Multiple exchanges can be expired in a single transaction.
const exchangeId1 = "1534";
const exchangeId2 = "2";
const exchangeId3 = "758";
await coreSDK.expireDisputeBatch([exchangeId1, exchangeId2, exchangeId3]);Solidity
Extends the dispute timeout, allowing more time for mutual resolution.
IBosonDisputeHandler bosonProtocol = IBosonDisputeHandler(_bosonProtocolAddress);
uint256 exchangeId = 1534;
uint256 newTimeout = block.timestamp + 1 days;
bosonProtocol.extendDisputeTimeout(exchangeId, newTimeout);The buyer and the seller mutually resolve the dispute and submit the decision on how the pot is split.
The other party signed the proposal, and this contract is submitting the transaction
IBosonDisputeHandler bosonProtocol = IBosonDisputeHandler(_bosonProtocolAddress);
uint256 exchangeId = 1534;
uint256 buyerPercent = 30_00;
bytes memory signature = 0x...; // must be provided by other signer
bosonProtocol.resolveDispute(exchangeId, buyerPercent, signature);The other party is submitting the transaction, and this contract uses EIP1271 verification
import { IERC1271 } from "@openzeppelin/contracts/interfaces/IERC1271.sol";
function isValidSignature(bytes32, bytes calldata) public view override returns (bytes4) {
// validate the signature, e.g. ECDSA verification
...
// If everything is ok, return the correct magic value
return IERC1271.isValidSignature.selector;
}The buyer retracts the dispute. The outcome is equivalent to a normally completed exchange. The seller gets the price and the seller's deposit and the DR Fee is returned to the mutualizer.
IBosonDisputeHandler bosonProtocol = IBosonDisputeHandler(_bosonProtocolAddress);
uint256 exchangeId = 1534;
bosonProtocol.retractDispute(exchangeId);The dispute cannot be mutually resolved, and the Dispute Resolver is activated to decide on the split of the pot. The buyer must pay an escalation deposit to call this method. The escalation deposit is added to the pot that is then split between the seller and the buyer.
IBosonDisputeHandler bosonProtocol = IBosonDisputeHandler(_bosonProtocolAddress);
uint256 exchangeId = 1534;
bosonProtocol.escalateDispute(exchangeId);If the seller and buyer did not perform any protocol action, the dispute can be expired. The outcome is equivalent to a normally completed exchange. The seller gets the price and the seller's deposit and the DR Fee is returned to the mutualizer.
IBosonDisputeHandler bosonProtocol = IBosonDisputeHandler(_bosonProtocolAddress);
uint256 exchangeId = 1534;
bosonProtocol.expireDispute(exchangeId);Multiple exchanges can be expired in a single transaction.
IBosonDisputeHandler bosonProtocol = IBosonDisputeHandler(_bosonProtocolAddress);
uint256[] memory exchangeIds = new uint256[](3);
exchangeIds[0] = 1534;
exchangeIds[1] = 2;
exchangeIds[2] = 758;
bosonProtocol.expireDispute(exchangeId);Last updated