lumos-luna-sdk 1.13.2 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +100 -19
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -5,8 +5,8 @@
5
5
  <h1 align="center">Lumos Luna SDK</h1>
6
6
 
7
7
  <p align="center">
8
- <strong>On-Chain Primitives for Terra Classic</strong><br/>
9
- <sub>Proof-of-Burn | Negative-Yield Staking | Invariant-Only Stable Vault</sub>
8
+ <strong>AI-Powered DeFi Ecosystem for Terra Classic</strong><br/>
9
+ <sub>6 Smart Contracts | AI Oracle | Luna Identity | Stable Vault V2 | Proof-of-Burn | Negative Staking</sub>
10
10
  </p>
11
11
 
12
12
  <p align="center">
@@ -15,11 +15,27 @@
15
15
  <a href="https://github.com/Schero94/lumos-luna-sdk/stargazers"><img src="https://img.shields.io/github/stars/Schero94/lumos-luna-sdk?style=flat-square" alt="GitHub Stars"/></a>
16
16
  </p>
17
17
 
18
+ <p align="center">
19
+ <a href="https://lunar.fitlex.me"><strong>Website</strong></a> &nbsp;·&nbsp;
20
+ <a href="https://luid.fitlex.me"><strong>Luna Identity App</strong></a> &nbsp;·&nbsp;
21
+ <a href="https://www.npmjs.com/package/lumos-luna-sdk"><strong>npm</strong></a> &nbsp;·&nbsp;
22
+ <a href="https://finder.terra.money/classic/address/terra1klz58628lk7pg3w6ah7erlpxaz4esxm8zsk02uunyy5gpdjrs5uq8p9rh0"><strong>Stable Vault V2 on Terra Finder</strong></a>
23
+ </p>
24
+
25
+ ---
26
+
27
+ ## Live Demo
28
+
29
+ | App | URL | What it does |
30
+ |-----|-----|-------------|
31
+ | **Marketing Site** | [lunar.fitlex.me](https://lunar.fitlex.me) | Ecosystem overview, live on-chain stats, AI burn rate, all 6 contracts |
32
+ | **Luna Identity App** | [luid.fitlex.me](https://luid.fitlex.me) | Create your on-chain identity, burn LUNC, level up, mint/burn lUSD in Stable Vault V2 |
33
+
18
34
  ---
19
35
 
20
36
  ## What is Lumos Luna?
21
37
 
22
- Lumos Luna is an SDK that exposes **three new on-chain primitives** for Terra Classic (LUNC). No new token, no governance overhead, no marketing - just code that works.
38
+ Lumos Luna is a complete DeFi ecosystem for Terra Classic (LUNC) with **6 smart contracts** deployed on mainnet, an **AI-powered burn oracle**, and a **1:1 USDC-backed stablecoin** with identity-based fee discounts.
23
39
 
24
40
  **Philosophy:**
25
41
  - Contracts are the truth, SDK is comfort
@@ -30,13 +46,70 @@ Lumos Luna is an SDK that exposes **three new on-chain primitives** for Terra Cl
30
46
 
31
47
  ## Deployed Contracts (Mainnet)
32
48
 
33
- All contracts are live on **Terra Classic Mainnet** (columbus-5):
49
+ All 6 contracts are live on **Terra Classic Mainnet** (columbus-5):
50
+
51
+ | Contract | Address | Admin | Status |
52
+ |----------|---------|-------|--------|
53
+ | **AI Burn Oracle** | [`terra19yr...633nf`](https://finder.terra.money/classic/address/terra19yr2f0akzjaerequfzm4aeecdplychkkq0pfwcetqqd8s5e6lk4qz633nf) | Oracle only | Active |
54
+ | **Luna Identity** | [`terra1xm4...fykwslsmjuj`](https://finder.terra.money/classic/address/terra1xm49ghe04tzd0qgt9uelv9gklfrj7yf6v0faxaw9lc3dsujfykwslsmjuj) | Config only | Active |
55
+ | **Proof-of-Burn** | [`terra188f...387uq0ch3d0`](https://finder.terra.money/classic/address/terra188fdkkvf54er3t6e9zgz6v24d7scykv3lqflpqr8xn063ff387uq0ch3d0) | Immutable | Active |
56
+ | **Negative-Staking** | [`terra13kz...qlscqnegaws`](https://finder.terra.money/classic/address/terra13kz7rzdpad9hxdkzn4dln2kfcxy8c7pe0lcwfu8ue9n2dlqqlscqnegaws) | Config only | Active |
57
+ | **Burn Calculator Pro** | [`terra19yr...633nf`](https://finder.terra.money/classic/address/terra19yr2f0akzjaerequfzm4aeecdplychkkq0pfwcetqqd8s5e6lk4qz633nf) | Immutable | Active |
58
+ | **Stable Vault V2** | [`terra1klz...jrs5uq8p9rh0`](https://finder.terra.money/classic/address/terra1klz58628lk7pg3w6ah7erlpxaz4esxm8zsk02uunyy5gpdjrs5uq8p9rh0) | Pause only | Active |
59
+
60
+ ---
61
+
62
+ ## Ecosystem Overview
63
+
64
+ ### Stable Vault V2 — 1:1 USDC-Backed Stablecoin (lUSD)
65
+
66
+ The flagship contract. Deposit USDC, receive lUSD at a 1:1 ratio. The vault enforces a strict invariant: **supply always equals reserves**.
67
+
68
+ What makes V2 special: it integrates with **Luna Identity** for fee discounts.
69
+
70
+ | Identity Level | Fee | Discount |
71
+ |---------------|-----|----------|
72
+ | No Identity | 0.30% | — |
73
+ | Level 1 | 0.20% | 10 bps |
74
+ | Level 2 | 0.15% | 15 bps |
75
+ | Level 3 | 0.10% | 20 bps |
76
+ | Level 4 | 0.05% | 25 bps |
77
+ | **Level 5+** | **FREE** | **30 bps** |
34
78
 
35
- | Primitive | Contract Address | Admin |
36
- |-----------|------------------|-------|
37
- | **Proof-of-Burn** | `terra188fdkkvf54er3t6e9zgz6v24d7scykv3lqflpqr8xn063ff387uq0ch3d0` | Immutable |
38
- | **Negative-Staking** | `terra13kz7rzdpad9hxdkzn4dln2kfcxy8c7pe0lcwfu8ue9n2dlqqlscqnegaws` | Config only |
39
- | **Stable-Vault** | `terra1g6pyt9gz3efumwpdvtspg9phge0kuqk4vhugdpv3906yvfkapv6q4s7rvj` | Pause only |
79
+ All collected fees are **permanently burned**.
80
+
81
+ ### Luna Identity — SoulBound Citizenship NFTs
82
+
83
+ Non-transferable on-chain identity. Burn LUNC to register, level up through contributions, unlock fee discounts in Stable Vault V2. Try it at [luid.fitlex.me](https://luid.fitlex.me).
84
+
85
+ ### Governance Voting — On-Chain Proposals
86
+
87
+ Identity holders can vote on ecosystem proposals. Voting power scales with your identity level — no token-weighted voting, purely reputation-based through proven LUNC burns.
88
+
89
+ | Level | Title | Voting Power |
90
+ |-------|-------|-------------|
91
+ | 1-2 | Citizen/Resident | No voting rights |
92
+ | 3 | Patriot | 1 vote |
93
+ | 4 | Guardian | 2 votes |
94
+ | 5+ | Senator+ | Votes = level |
95
+
96
+ Level 5+ (Senator) can also **create proposals**. Voting costs only gas (~0.5 LUNC), no additional burn required.
97
+
98
+ ### AI Burn Oracle — Market-Adaptive Burn Rate
99
+
100
+ Claude AI analyzes market data every 8 hours and adjusts the LUNC burn rate on-chain. Fully transparent, all recommendations stored on-chain with reasoning.
101
+
102
+ ### Proof-of-Burn — Verifiable Burn Receipts
103
+
104
+ Every LUNC burn gets an immutable on-chain receipt. Composable with other contracts for access control.
105
+
106
+ ### Negative Staking — Deflationary Staking
107
+
108
+ Stake LUNC, 10% gets burned. You receive governance weight proportional to `amount × lock_time`. The longer you lock, the more influence you earn.
109
+
110
+ ### Burn Calculator Pro — On-Chain Compute
111
+
112
+ Calculates optimal burn amounts based on current market conditions and AI Oracle data.
40
113
 
41
114
  ---
42
115
 
@@ -300,21 +373,29 @@ See `/examples` folder for complete usage examples.
300
373
  ## Project Structure
301
374
 
302
375
  ```
303
- /contracts
304
- /proof-of-burn # Rust CosmWasm contract
305
- /negative-staking # Rust CosmWasm contract
306
- /stable-vault # Rust CosmWasm contract
376
+ /apps
377
+ /luna-identity # Next.js PWA — luid.fitlex.me
378
+ /burnfeed # Burn feed viewer
379
+
380
+ /contracts # Rust CosmWasm smart contracts (Cargo workspace)
381
+ /proof-of-burn # Verifiable burn receipts
382
+ /negative-staking # Deflationary staking (10% burn)
383
+ /stable-vault # V1 — 1:1 USDC vault
384
+ /stable-vault-v2 # V2 — with Identity integration & fee burning
385
+ /luna-identity # SoulBound citizenship NFTs
386
+ /burn-calculator-pro # On-chain burn rate calculator
387
+ /burn-rate-calculator
388
+ /burn-calculator
389
+ /terra-recovery
390
+
391
+ /public-site # Marketing site — lunar.fitlex.me
307
392
 
308
393
  /src
309
394
  /primitives # SDK wrappers for contracts
310
- LumosPrimitives.ts # Main entry point
395
+ /identity # Identity client
311
396
 
312
397
  /services
313
- /ai-oracle # AI burn rate recommender
314
-
315
- /docs
316
- INVARIANTS.md # Mathematical specifications
317
- WHY_THIS_EXISTS.md # Philosophy
398
+ /ai-oracle # AI burn rate recommender (Claude AI, every 8h)
318
399
  ```
319
400
 
320
401
  ---
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lumos-luna-sdk",
3
- "version": "1.13.2",
3
+ "version": "2.2.0",
4
4
  "description": "Lumos Luna SDK - The first AI-native SDK for Terra Classic (LUNC) & Terra 2.0 (LUNA). Build revolutionary dApps with ease.",
5
5
  "author": "Schero94",
6
6
  "license": "MIT",