Skip to content

Commit 37d9c3b

Browse files
authored
[release] Merge pull request #20 from N3koSempai/blockhainNew
[release] Blockhain donation
2 parents 53e5a72 + 519205b commit 37d9c3b

12 files changed

Lines changed: 1811 additions & 11 deletions

File tree

README.md

Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,82 @@ To create an automated release with both .deb and .flatpak packages:
8181
- Create a new release with tag `v{version}`
8282
- Upload both packages as `Klia-Store-beta{version}.deb` and `Klia-Store-beta{version}.flatpak`
8383

84+
## Crypto Donations Integration
85+
86+
Klia Store supports crypto donations (Bitcoin and Ethereum tokens) for app developers. Developers can add donation URLs to their Flathub apps to receive direct support from users.
87+
88+
### How to Add Crypto Donations to Your App
89+
90+
Follow these steps to enable crypto donations for your Flathub application:
91+
92+
#### 1. Prepare Your Wallet Addresses
93+
94+
You'll need one or both of the following:
95+
- **Bitcoin (BTC)** wallet address
96+
- **Ethereum (ETH)** wallet address (supports all ERC-20 tokens)
97+
98+
#### 2. Add Donation URLs to Your Flathub Manifest
99+
100+
Edit your app's `.metainfo.xml` file and add the donation URLs in the `<url>` section:
101+
102+
**For Bitcoin:**
103+
```xml
104+
<url type="donation">https://kliastore.gatorand.com/bitcoin/?wallet=YOUR_BTC_ADDRESS</url>
105+
```
106+
107+
**For Ethereum (any ERC-20 token):**
108+
```xml
109+
<url type="donation">https://kliastore.gatorand.com/ethereum/?wallet=YOUR_ETH_ADDRESS</url>
110+
```
111+
112+
**Example (Klia Store configuration):**
113+
```xml
114+
<component>
115+
<id>io.github.N3kosempai.klia-store</id>
116+
<name>Klia Store</name>
117+
<!-- ... other metadata ... -->
118+
<url type="homepage">https://github.com/N3koSempai/kliaStore</url>
119+
<url type="donation">https://kliastore.gatorand.com/bitcoin/?wallet=bc1q5y8are6m9r946h3ut7c3hxtuf6nm67rgz7ume7</url>
120+
<url type="donation">https://kliastore.gatorand.com/ethereum/?wallet=0x1234567890abcdef1234567890abcdef12345678</url>
121+
</component>
122+
```
123+
124+
#### 3. Supported Cryptocurrencies
125+
126+
Currently supported:
127+
-**Bitcoin (BTC)** - Native Bitcoin network
128+
-**USDT (Tether)** - Ethereum network (ERC-20)
129+
130+
Coming soon:
131+
- 🔜 USDC, DAI, and other ERC-20 tokens
132+
- 🔜 Other blockchains
133+
134+
#### 4. How It Works
135+
136+
1. Users browse your app in Klia Store
137+
2. They click the donation button (⚡ icon)
138+
3. Select cryptocurrency and enter amount
139+
4. Scan QR code or copy wallet address
140+
5. Send the exact amount from their wallet
141+
6. Click "Verify" to confirm the transaction on-chain
142+
7. Donation is recorded in local database
143+
144+
#### 5. Features
145+
146+
- **On-chain verification**: Transactions are verified using blockchain APIs (Blockstream/Mempool for BTC, Ethereum RPC nodes for USDT)
147+
- **QR code generation**: Automatic QR codes for easy mobile wallet scanning
148+
- **BIP-21 support**: Bitcoin URIs include amount for auto-fill in wallets
149+
- **Local tracking**: All donations are stored in SQLite database
150+
- **Privacy-focused**: No external tracking, only blockchain verification
151+
152+
#### 6. Important Notes
153+
154+
- Replace `YOUR_BTC_ADDRESS` and `YOUR_ETH_ADDRESS` with your actual wallet addresses
155+
- A single Ethereum address can receive all ERC-20 tokens (USDT, USDC, DAI, etc.)
156+
- Ensure your wallet addresses are correct before publishing
157+
- Users must send the **exact amount** specified for verification to work
158+
- Transactions typically take a few minutes to appear on-chain
159+
84160
## Documentation
85161

86162
- [Architecture Documentation](./architecture.md) - Detailed technical documentation

io.github.N3kosempai.klia-store.metainfo.xml

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,8 @@
1515
<url type="homepage">https://github.com/N3koSempai/klia-store</url>
1616
<url type="bugtracker">https://github.com/N3koSempai/klia-store/issues</url>
1717
<url type="vcs-browser">https://github.com/N3koSempai/klia-store</url>
18-
<url type="donation">https://n3kosempai.github.io/KliaStore/bitcoin/donate?wallet=bc1qaq220dfa4dwc2eg0s76t4uzmrf28med2nr3fz0</url>
18+
<url type="donation">https://kliastore.gatorand.com/bitcoin/?wallet=bc1q5y8are6m9r946h3ut7c3hxtuf6nm67rgz7ume7</url>
19+
<url type="donation">https://kliastore.gatorand.com/ethereum/?wallet=0xC849612e4f29b81e5e6A40C9c6D543e0C41C863C</url>
1920
<screenshots>
2021
<screenshot type="default">
2122
<caption>Main application window showing start page</caption>
@@ -38,15 +39,16 @@
3839
<binary>klia-store</binary>
3940
</provides>
4041
<releases>
41-
<release version="2.7.2" date="2026-02-23">
42+
<release version="2.8.0" date="2026-03-30">
4243
<description>
43-
<p> New Feature: Enhanced Source Security Verification (only available for app install for now)</p>
44+
<p>New Feature: Cryptocurrency Donations Support</p>
4445
<ul>
45-
<li>Now Klia Store verifies the integrity of your Flatpak sources using SHA-256 cryptographic checksums.</li>
46-
<li>Protects against tampering and ensures the authenticity of your application sources.</li>
47-
<li>Automatic validation when adding new repositories keeps your system safe from potential threats.</li>
48-
<li>Visual indicators show the verification status of each source at a glance.</li>
49-
46+
<li>Support developers directly with cryptocurrency donations (Bitcoin and Ethereum tokens like USDT).</li>
47+
<li>Scan QR codes with your mobile wallet or copy addresses for easy payments.</li>
48+
<li>Automatic on-chain verification ensures your donation reaches the developer.</li>
49+
<li>Klia Store is the first app to support this feature!</li>
50+
<li>More exciting features coming soon to the donation system!</li>
51+
<li>(Other developers can add crypto donation support to their apps - see instructions in the Klia Store README on GitHub)</li>
5052
</ul>
5153
</description>
5254
</release>

package-lock.json

Lines changed: 32 additions & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

package.json

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,9 +27,11 @@
2727
"@tauri-apps/plugin-shell": "^2.3.1",
2828
"@tauri-apps/plugin-sql": "~2.3.0",
2929
"i18next": "^25.6.0",
30+
"qrcode.react": "^4.2.0",
3031
"react": "^19.1.0",
3132
"react-dom": "^19.1.0",
3233
"react-i18next": "^16.2.0",
34+
"react-qr-code": "^2.0.18",
3335
"three": "^0.182.0",
3436
"use-debounce": "^10.0.6",
3537
"uuid": "^13.0.0",

screenshots/3dview.png

180 KB
Loading

0 commit comments

Comments
 (0)