Documentation
How XORY works
Everything you need to know — from opening a duel to the final court ruling.
How to create a duel
Any registered user can open a duel. You define the rules, pick a stake, set a deadline — and optionally choose your opponent directly.
Tap the "+" button from any screen to open the Create form.
Describe the terms clearly. XORY uses AI to structure the rules — review them before confirming.
Set a SOL stake amount. Both sides will lock the same amount.
Set a deadline. This is when the "claim window" opens after the duel ends.
Confirm the on-chain escrow transaction in your Solana wallet. Funds are locked until the duel resolves.
- —Your duel gets a unique 6-character invite code and a shareable link.
- —Wait for your friend to accept.
How to join a duel
To join, you either receive a direct duel or find an open duel via its invite link.
Accept from the link your friend sent, or check your notifications.
Read the rules carefully. You are agreeing to the exact terms the creator set.
Lock the same stake amount via the on-chain escrow transaction.
The duel is now ACTIVE. Both sides are locked in.
- —If the duel was created for a specific opponent and you are not that person, you cannot join.
- —If the deadline has already passed, the duel cannot be joined.
Claiming victory (after the deadline)
Once the duel deadline passes, the claim window opens. Either side can submit a claim to declare themselves the winner.
After the deadline, go to the duel and tap "Submit Claim".
Write your claim (minimum 10 characters). Upload evidence if available (image or file).
The other side is notified and has 48 hours to respond.
If the opponent accepts → duel resolves, funds transfer to you.
If the opponent disputes → the duel moves to Public Court.
If the opponent does not respond within 48 hours → the claim is auto-accepted.
Add clear, specific evidence. Judges vote based on what they see in court.
- —Only one active claim can exist at a time.
- —Claim response window: 48 hours (configurable by admin).
How a duel goes to Public Court
When a claim is disputed, the duel is escalated to Public Court — a community vote open to all verified users.
The opponent taps "Dispute" on the active claim and submits their counter-argument and evidence.
A court duel is created with both sides displayed: Side X (claimer) vs Side Y (disputer).
The duel enters VOTING status and is visible to all users on the Court page.
Verified users vote X or Y. Each user gets one vote per duel.
When the voting deadline expires, the result is determined by majority vote.
Winner gets paid. Instantly. On-chain.
Court results are final. There is no second appeal.
- —Duel participants cannot vote on their own duel.
- —Only verified users (Twitter/X connected) can vote.
- —A draw splits the pot between both sides.
- —The court votes for 48 hours, then the verdict is final. 48 hours (configurable by admin).
- —Court fee: 5% of the pot (deducted before payout).
- —Platform fee: 3% of the pot.
What if nobody claims?
If neither side submits a claim after the deadline, XORY does not leave the duel hanging forever.
The duel deadline passes with no claim submitted.
A 72-hour grace window begins (the "unclaimed resolution window").
If still no claim after 72 hours, the system automatically escalates the duel to Public Court.
The court duel is created with the message: "No claim submitted before the response window closed."
Community voting begins, with a 24-hour voting window.
Result is determined by majority vote, or split if no votes are cast.
Submit your claim as soon as the deadline passes to avoid auto-escalation.
- —Unclaimed resolution window: 72 hours after the duel deadline.
- —Auto-court voting period: 24 hours.
- —This process runs automatically — no action needed from either participant.
How voting works
Public Court relies on the community to decide disputes. Here is exactly how the voting system works.
Go to the Court page. Any duel with VOTING status is open.
Read both sides — Side X (claimer) and Side Y (disputer) — including their evidence.
Vote for the side you believe is correct. You get one vote per duel.
Votes are counted when the deadline expires.
Majority wins. If votes are tied, the pot is split equally.
Voting is how you earn Court Arbitrator reputation. Your judgment record is tracked on your profile.
- —You must have a verified account (X/Twitter connected) to vote.
- —You cannot vote on a duel you are a participant in.
- —Your vote cannot be changed after submission.
- —Votes are publicly visible after the duel is finalized.
Timings reference
All time windows are configured by the platform admin. The values below reflect the current settings.
Time for the opponent to accept or dispute a claim after the deadline.
Grace period after the deadline before auto-escalation to court.
Time the community has to vote on a disputed duel.
Voting window for auto-escalated unclaimed duels.
Fees
All fees are deducted from the pot (both stakes combined). The winner receives the remainder. Values reflect current platform settings.
Opponent accepts your claim — you win.
No response within the claim window — claimer wins automatically.
Opponent concedes the duel voluntarily.
Community votes — one side wins the majority.
Community votes — result is a tie, each side gets half.