🧠 GeniusSDK for Unity

GeniusSDK is a lightweight Unity plugin that integrates the GNUS decentralized compute network into your game or app. It allows players to earn Minions (GNUS tokens) by contributing compute power — which they can then spend on in-game rewards or purchases.

---

🚀 Features

• 🔌 One-line SDK initialization
• 🪙 Real-time Minion balance display
• 💸 Automatic GNUS-to-USD price conversion
• 🎯 Compatible with both TextMeshPro and UGUI
• 📱 Cross-platform native support: iOS, Android, macOS, Windows, Linux
• ⚡ Drag-and-drop purchase buttons with UnityEvent support

---

📦 Installation

✅ Option A: Import from GitHub Release

1. Download the latest .unitypackage from the Releases tab
2. In Unity:
   Assets → Import Package → Custom Package…
3. Select the downloaded file and click Import

🧑‍💻 Option B: Clone the Entire Project (for SDK Development or Contribution)

git clone https://github.com/GeniusVentures/UnityGeniusSDK.git

Then open the cloned folder directly in Unity Hub as its own project.

⚠️ This repo includes full Unity project files (ProjectSettings/).
Do not copy it into an existing Unity project. You can copy the Assets/GeniusSDK directory into your existing project.

Make sure to run:

git lfs install

---

🧩 Getting Started

1. Add the SDK to your scene

Attach GeniusSDKWrapper to any persistent GameObject (e.g. your game manager). It initializes automatically in Awake() and persists across scenes.

---

🔧 SDK Configuration

The GeniusSDKWrapper component exposes several important parameters in the Unity Inspector:

Field	Description
Address	The developer’s wallet address (where GNUS or child tokens will be sent).
Cut	A float from 0 to 1 representing the percentage of Minions earned that the developer keeps. For example, 0.7 means 70% goes to the dev, 30% to the user.
Token Value	The value of the child token relative to 1 GNUS. For example, 1.0 means 1 token = 1 GNUS, 0.1 means 10 tokens = 1 GNUS.
Token ID	The ID of the child token being used for payouts and pricing.

These values are written to dev_config.json at runtime and used to initialize the native GeniusSDK.

---

2. Display Minion Balance

Attach GeniusSDKBalanceDisplay to a Text or TextMeshProUGUI element.

• Automatically refreshes every X seconds (configurable)
• Or call manually:

  balanceDisplay.ForceUpdateBalance();

---

3. Show Dynamic Minion Pricing

Attach GeniusSDKPricer to a Text or TextMeshProUGUI.

• Set the USD base price in the Inspector (e.g., $1.00)

• It calculates how many Minions the player must pay based on live GNUS token price

• Auto-refreshes every X seconds (or manually):

  pricer.ForceUpdatePrice();

---

4. Add a Buy Button

Attach GeniusSDKPurchase to a Unity UI Button.

• Assign the GeniusSDKPricer reference
• Use the onPurchaseSuccess UnityEvent to trigger in-game rewards
• Purchase will use the latest Minion price calculated from the Pricer

---

🧪 Example Setup

[Canvas]
 ├── [Text]      MinionBalanceText + GeniusSDKBalanceDisplay
 ├── [Text]      ItemPriceText + GeniusSDKPricer
 ├── [Button]    PurchaseButton + GeniusSDKPurchase
 │      └── onPurchaseSuccess → your custom success handler (e.g. add gems)

---

🛠 Requirements

• Unity 2021.3 or newer (tested on 2022.3 LTS)
• Git LFS installed (for native plugin files >100MB)
• Platform-dependent libraries:
  • libGeniusSDK.so for Android/Linux
  • GeniusSDK.framework for iOS
  • GeniusSDK.bundle for macOS
  • GeniusSDK.dll for Windows

---

📱 Android Permissions

If you are targeting Android, the SDK uses low-level networking (e.g., libp2p and IPFS) which requires socket access. Make sure to add the following permissions to your AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

To add these in Unity:

1. Go to Edit → Project Settings → Player → Android tab
2. Under Publishing Settings, enable Custom Main Manifest
3. Unity will create Assets/Plugins/Android/AndroidManifest.xml
4. Add the permissions inside the <manifest> tag, before <application>

These are required for libp2p communication and IPFS peer discovery to function correctly on Android devices.

---

🧠 Notes

• You only need one instance of GeniusSDKWrapper per game
• All pricing and balance logic is async and runs on coroutines
• Purchase buttons automatically disable duplicate presses during execution

---

📣 Support

• Open an issue for bugs or feature requests
• PRs welcome!

---

🔗 About GNUS / Minions

The GeniusSDK connects your Unity app to the GNUS Network, where players earn Minions (GNUS tokens) by contributing device GPU cycles. Developers receive a portion of the tokens, allowing a monetization model without ads or upfront purchases.