Cardano

[Sixela33]

Pyth Examples Contribution

Type of Contribution

• New Example Project (Adding a new example to demonstrate Pyth integration)
• Bug Fix (Fixing an issue in existing examples)
• Documentation Update (Improving README, comments, or guides)
• Enhancement (Improving existing functionality or adding features)
• [ x] Hackathon Submission (Submitting a project from a hackathon)

Project Information

5minBets:

Pyth Product Used:

• [x ] Pyth Price Feeds
• Pyth Entropy
• Multiple Products
• Other: ___________

Blockchain/Platform:

• Ethereum/EVM
• Solana
• Aptos
• Sui
• Fuel
• Starknet
• TON
• [x ] Other: cardano

Description

What does this contribution do?

This contribution adds 5minBets, a Cardano-native price prediction market concept written in Aiken. The project models a simple 5-minute betting flow where users bet UP or DOWN on the XAU/USD price, with the current repository containing an initial validator prototype and a README that describes the intended protocol design and architecture.

How does it integrate with Pyth?

The project is designed to use Pyth price data as the oracle source for round creation and settlement. A relayer records the opening XAU/USD price from Pyth, users place bets during the round, and the closing Pyth price is later used to determine the winning side and calculate payouts.

What problem does it solve or demonstrate?

This example demonstrates how Pyth-powered market data can be used in a Cardano application to drive outcome-based logic for a prediction market. It also serves as a hackathon prototype and starting point for building a more complete oracle-driven betting protocol in Aiken.

Directory Structure (for new examples)

[product]/[example-name]/
├── contract/          # Smart contracts (if applicable)
├── app/              # Frontend application (if applicable)  
├── README.md         # Project documentation
└── ...

Testing & Verification

How to Test This Contribution

This example is currently an Aiken project prototype. Reviewers can validate formatting, buildability, and test execution using the standard Aiken workflow.

Prerequisites

• Node.js version: ___
• Other dependencies: ___

Setup & Run Instructions

cd pyth-examples/lazer/cardano/5minBets
aiken fmt --check
aiken check -D
aiken build

Deployment Information (if applicable)

Network: cardano

Contract Address(es): N/A

Demo URL: N/A

Checklist

Code Quality

• [ x] Code follows existing patterns in the repository
• Proper error handling implemented
• No hardcoded values (use environment variables where appropriate)

Testing

• Tested locally and works as expected
• All existing functionality still works (no breaking changes)

Additional Context

Related Issues

Fixes #

Screenshots/Demo (if applicable)

Notes for Reviewers

---

Thank you for contributing to Pyth Examples!