🏆 Winner — æternity Hackathon

This project implements a barrier-options betting platform on the æternity blockchain. Participants wager on whether an asset price will touch an upper or lower barrier before expiry (one-touch / no-touch markets) or race between barriers. The stack includes:

• Sophia contracts (contracts/BarrierOptions.aes, contracts/ExchangeOracle.aes) running on æternity testnet.
• Node scripts for deployment, oracle configuration, and an off-chain oracle responder.
• Mocha/Chai tests via AEproject to validate settlement flows (manual price inputs and oracle responses).

• Architecture
• Local Setup
• Testing
• Deployment (Testnet)
• Oracle Responder
• Environment Variables
• Useful Addresses
• License

• BarrierOptions.aes: main contract storing markets, bets, and status. Supports owner-managed price checks and oracle-based settlements. Emits streamlined events for front-end consumption.
• ExchangeOracle.aes: minimal owner-only oracle registration contract. Returns oracle ID used by BarrierOptions.
• scripts/*.js: deployment, oracle configuration, and responder tooling using @aeternity/aepp-sdk.
• test/barrierOptionsTest.js: end-to-end tests simulating manual and oracle-based market resolution.

npm install
# optional: start a local æproject env if you want to test locally
aeproject env

npm test

Runs the Mocha suite (test/*.js) against the local AEproject environment (or whichever node/compiler you configure).

• æternity account with testnet funds (we used ak_mK1NyxjzK4GzZKXWxDfGbeqwEhQfZsNAx24J2NzJGQGUdu6sJ).
• Deployer private key (sk_…).
• Node URL & compiler URL (defaults to testnet / v7).
• Sophia compiler must stay on >=7.1.1 <8.0.0 for the current AEproject toolchain.

env \
  DEPLOYER_SECRET_KEY=sk_... \
  AE_NODE_URL=https://testnet.aeternity.io \
  AE_COMPILER_URL=https://v7.compiler.aepps.com \
  ORACLE_QUERY_FEE=1000000000000000 \
  ORACLE_REGISTER_TTL=500 \
  node scripts/deployOracle.js

Outputs:

• Oracle contract address (ct_...)
• Oracle ID (ok_...) (needed for BarrierOptions configuration)

env \
  DEPLOYER_SECRET_KEY=sk_... \
  AE_NODE_URL=https://testnet.aeternity.io \
  AE_COMPILER_URL=https://v7.compiler.aepps.com \
  node scripts/deployBarrierOptions.js

Outputs contract address (ct_...).

env \
  DEPLOYER_SECRET_KEY=sk_... \
  AE_NODE_URL=https://testnet.aeternity.io \
  AE_COMPILER_URL=https://v7.compiler.aepps.com \
  BARRIER_CONTRACT_ADDRESS=ct_... \
  PRICE_ORACLE_ID=ok_... \
  ORACLE_QUERY_FEE=1000000000000000 \
  ORACLE_QUERY_TTL=5 \
  ORACLE_RESPONSE_TTL=3 \
  node scripts/configureBarrierOracle.js

The dApp relies on an off-chain service to answer oracle price requests. A ready-to-run responder is provided:

env \
  DEPLOYER_SECRET_KEY=sk_... \
  AE_NODE_URL=https://testnet.aeternity.io \
  AE_COMPILER_URL=https://v7.compiler.aepps.com \
  ORACLE_CONTRACT_ADDRESS=ct_... \
  BARRIER_CONTRACT_ADDRESS=ct_... \
  ORACLE_EXTEND_TTL=50 \
  ORACLE_POLL_INTERVAL=15000 \
  node scripts/oracleResponder.js

This script:

1. Polls BarrierOptions for pending oracle queries.
2. Fetches AE/USD price from CoinGecko Demo API (fallback to a default).
3. Calls ExchangeOracle.respond, then triggers checkMarketFromOracle.
4. Extends the oracle TTL periodically.

Keep the responder running continuously while your front end is live.

• BarrierOptions (testnet): ct_7jTDxrEWXGBBSmhtQPP89aoNZ1qPXreGrszW8rJ86v9QYgu4a
• ExchangeOracle (testnet): ct_tmkuVj9TbRZiGwEJChGBCzFNBz44biwWeMAMKeqbTw54PMwvz
• Oracle ID: ok_tmkuVj9TbRZiGwEJChGBCzFNBz44biwWeMAMKeqbTw54PMwvz

• Located in frontend/ (bootstrapped from aepp-boilerplate-react).

• Install and run:

  cd frontend
  npm install
  npm start

• Configure via .env (prefix vars with REACT_APP_):

  • REACT_APP_BARRIER_CONTRACT_ADDRESS
  • REACT_APP_PRICE_ORACLE_ID
  • REACT_APP_OWNER_ADDRESS
  • REACT_APP_ORACLE_QUERY_FEE
  • REACT_APP_COINGECKO_API_KEY (or REACT_APP_COINGECKO_DEMO_API_KEY)

• Features: wallet connect, market list/detail, betting form, owner controls, oracle trigger, payout claim UI. Uses AeSdkAepp to compile the contract source at runtime.

MIT