Skip to content

Commit e488be8

Browse files
authored
Update README.md
1 parent 09655d8 commit e488be8

1 file changed

Lines changed: 30 additions & 9 deletions

File tree

README.md

Lines changed: 30 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,25 +2,46 @@
22

33
## About
44

5-
This project is a proof of concept (POC) for a fully decentralized betting game on Ethereum that doesn't rely on external parties.
5+
Jodobix is an experiment of a fully decentralized betting game on Optimism that doesn't rely on external parts.
66

7-
## Requirements
7+
Betting games are becoming more and more popular. And where I live — in Brazil — they’re causing serious debt problems because of how addictive they are.
8+
9+
Of course, we need better laws and education to deal with this.
10+
But I also think most of these games are run by companies that don’t really offer anything in return. They’re just middlemen taking a huge cut.
11+
12+
Every year, billions of dollars go from players to game owners who do nothing but sit in the middle.
13+
14+
---
15+
16+
Jodobix is a betting game that runs on Optimism. It’s fully automatic, it can’t be stopped, and it doesn’t belong to anyone — not even me.
17+
18+
All the money from the bets goes straight to the winners. The house takes nothing. I don’t take anything either.
19+
20+
---
21+
22+
### ⚠️ IT'S AN EXPERIMENT
23+
Contrary to the recommended way of picking a random number in EVM smart contracts — which relies on an external source — Jodobix experiments with a different approach. It creates a temporary winner on each bet based on the combination of the blockhash of each bet and only confirms the winner when the game encounters a hash where the last two digits are repeated. I believe there's no way to predict or avoid this moment.
24+
I've tested this theory myself, extensively trying to manipulate or predict the result. There will be a second round of tests with family and friends, and I’d like to move the project forward by talking with node specialists to understand the practical risks.
25+
26+
## Contributing
27+
28+
### Requirements
829

930
Before you begin, install the following tools:
1031

1132
- [Node.js (>= v18.18)](https://nodejs.org/en/download/)
1233
- Yarn ([v1](https://classic.yarnpkg.com/en/docs/install/) or [v2+](https://yarnpkg.com/getting-started/install))
1334
- [Git](https://git-scm.com/downloads)
1435

15-
## Quickstart
36+
### Quickstart
1637

17-
### 1. Install dependencies
38+
#### 1. Install dependencies
1839

1940
```sh
2041
yarn install
2142
```
2243

23-
### 2. Run a local network
44+
#### 2. Run a local network
2445

2546
In the first terminal:
2647

@@ -30,7 +51,7 @@ yarn chain
3051

3152
This starts a local Ethereum network using Hardhat. The network runs on your machine and can be used for testing and development. You can customize the configuration in `packages/hardhat/hardhat.config.ts`.
3253

33-
### 3. Deploy the contract
54+
#### 3. Deploy the contract
3455

3556
In a second terminal:
3657

@@ -40,7 +61,7 @@ yarn deploy
4061

4162
This deploys the smart contract to the local network. Contracts are located in `packages/hardhat/contracts`, and the deployment script is in `packages/hardhat/deploy`.
4263

43-
### 4. Start the Next.js app
64+
#### 4. Start the Next.js app
4465

4566
In a third terminal:
4667

@@ -56,7 +77,7 @@ To run smart contract tests:
5677
yarn hardhat:test
5778
```
5879

59-
### 5. Mock other bettors
80+
#### 5. Mock other bettors
6081

6182
To simulate additional bettors, run:
6283

@@ -66,7 +87,7 @@ yarn fillgame --game-id 1
6687

6788
This script places a bet on each empty option.
6889

69-
### 6. End the betting period
90+
#### 6. End the betting period
7091

7192
Run the game recycler bot:
7293

0 commit comments

Comments
 (0)