Create
Connect a wallet, write the thesis, choose a mode, define the deadline and select ETH or a supported ERC-20 stake.
Conviction,
made verifiable.
BLACKBOX turns a market thesis into a public, asset-backed onchain receipt. A creator defines the thesis, rules, deadline and stake. The protocol records those terms and escrows the stake until the contract's withdrawal conditions are satisfied.
BLACKBOX is not a betting market.A failed price target does not transfer the creator's stake to another party. The stake remains escrowed and can be withdrawn by its creator after the box is cleared or expires.
01
Protocol flow
From a wallet signature to a public receipt, the process is intentionally simple.
Seal
The transaction escrows the stake, pays the fixed creation fee and writes the box rules onchain.
Verify
Price Target uses the selected AggregatorV3-compatible oracle. Conviction Lock uses block time only.
Withdraw
Only the creator can withdraw the escrowed stake once the box has been cleared or has expired.
02
Two ways to prove conviction
BLACKBOX V1 supports two box modes with different verification logic.
Price Target
Attach a thesis to a specific price condition. Choose an ABOVE or BELOW direction, a target, a deadline and an AggregatorV3-compatible oracle.
- Target must be logically beyond the current oracle price at creation.
- Anyone can submit a check before the deadline.
- The contract independently reads the oracle and rejects an unmet target.
- A valid target check moves the box to CLEARED.
Conviction Lock
Lock ETH or an ERC-20 behind a thesis until a chosen deadline. No price oracle is used.
- No target price is required.
- No early creator withdrawal path exists.
- After the deadline, the box can expire and the creator can withdraw the stake.
- The receipt remains part of the public protocol history.
03
Oracle verification
BLACKBOX does not invent prices. Price Target boxes point to an exact external feed selected at creation.
Compatible interface
The selected feed must expose the AggregatorV3 methods used by the contract, including latestRoundData() and decimals().
Freshness rule
Every Price Target defines a maximum oracle age. The protocol rejects zero, future-dated, non-positive or stale price data.
Permissionless checks
Smart contracts do not wake themselves up. Any wallet may call the target-check function, but the caller cannot choose the outcome—the contract verifies it against the feed.
Important
Oracle quality matters. A compatible but unreliable or malicious feed can make the box unreliable. Users should verify the exact feed before sealing a Price Target box.
04
States & withdrawal
Every box moves through a small, explicit state machine.
OPEN
→Stake is escrowed and rules are active.
CLEARED
orPrice Target was proven before its deadline.
EXPIRED
→Deadline passed while the box was still open.
WITHDRAWN
Creator recovered the escrowed stake.
Who gets the stake?The creator. BLACKBOX V1 proves and time-locks conviction; it does not redistribute a failed thesis to counterparties.
05
Fees & supported assets
The protocol separates the creator's stake from the fixed creation fee.
Creation fee0.001 ETH per box
Native stakeETH
Token stakeERC-20
Fee-on-transfer tokensNot supported
Direct ETH transfersRejected
Maximum token decimals36
For ERC-20 boxes, BLACKBOX checks the amount actually received. Tokens that tax or reduce transfers will fail creation because the escrow must receive the exact requested stake.
06
Security model
BLACKBOX V1 minimizes protocol discretion by removing administrative settlement powers.
01
No owner
The deployed protocol has no owner role used to settle boxes or seize user stakes.
02
No upgrade key
V1 does not expose an administrative upgrade mechanism.
03
No protocol withdrawal
There is no operator function that can withdraw a user's escrowed stake.
04
Reentrancy protection
Creation and withdrawal flows use a contract-level reentrancy lock.
RISK DISCLOSURE
Onchain software, wallets, RPC infrastructure, ERC-20 tokens and external oracle feeds can all carry risk. BLACKBOX documentation describes protocol behavior; it is not a guarantee of asset value, oracle availability or investment performance.
07
Protocol limits
V1 intentionally constrains box parameters to keep behavior explicit.
Minimum deadline10 minutes from creation
Maximum deadline366 days from creation
Symbol length1–24 bytes
Thesis length1–180 bytes
Oracle max age60 seconds – 7 days
Price targetMust be positive
08
FAQ
The important edge cases, without marketing language.
Can I cancel a box early?+
No. There is no normal early-cancel withdrawal path. An open box must first be cleared by its target condition or pass its deadline.
Does BLACKBOX automatically check prices?+
No. A transaction must trigger the check. Anyone can submit it, and the contract independently decides whether the oracle condition is actually satisfied.
What happens if my target is never hit?+
Once the deadline passes, the box can become EXPIRED. The creator can then withdraw the original escrowed stake.
Can an admin decide that my call won or lost?+
No. V1 has no admin settlement path. Price Target uses the selected oracle; Conviction Lock uses time.
Is Reputation a separate token or scoring contract?+
No. The current website reputation view is derived from public BLACKBOX history and should not be interpreted as investment performance.
What is the official BLACKBOX token CA?+
0x87c1ef9902515723f4529e5454188cb1c472878d
0x87c1ef9902515723f4529e5454188cb1c472878dVerify on Blockscout ↗