Alchemy Guild transforms liquidity provision into an immersive, gasless RPG economy while pioneering Confidential TEE Governance and MEV-Protected Liquidity Rebalancing using the iExec Nox Protocol on Arbitrum Sepolia (Chain ID: 421614).

Rather than navigating complex DeFi pool management, players Mint, Craft, and Stake elemental NFTs (Lead, Silver, Gold). Behind the scenes, the protocol manages underlying Uniswap V3 liquidity, automatically harvesting real USDC trading fees and distributing yield directly to NFT stakers. Every transaction is 100% gasless via ERC-4337 Smart Account Abstraction sponsored by our self-sustaining protocol tax paymaster.

Public blockchain governance (ERC-20 snapshot voting) suffers from two fundamental flaws: voter intimidation/bribery and governance front-running. Whales can see exact live vote tallies and swing outcomes at the last block, or copy trading strategies before proposals execute.

Alchemy Guild solves this with a 3-layer confidential TEE architecture:

graph TD
    User([User Smart Account]) -->|1. Shield GUILD| cGUILD[cGUILD Enclave Contract]
    cGUILD -->|Mint euint256 Handle| User
    User -->|2. Cast Vote: Burn 10 cGUILD| DAO[GuildDAO.sol]
    DAO -->|3. Push Encrypted Vote Handle| Enclave[Intel TDX Enclave / TEE Runner]
    
    subgraph "Active Voting Window (3 Days)"
        DAO -. Public Mempool View .- Secret[Encrypted Tally: N Handles Recorded\nPlaintext Split: HIDDEN 🔒]
    end
    
    subgraph "Proposal Resolution & Delegation"
        Enclave -->|4. Decrypt inside Hardware TEE| Result[Compute totalFor vs totalAgainst]
        Result -->|5. Verify & Execute| DAO
        User -. Grant O(1) Viewing Access .-> Leno[Leno AI Enclave v2 Agent]
    end

Users deposit standard GUILD governance tokens into the Shielding Lab inside the dashboard. The cGUILD contract (0xD32B...) calls Nox.toEuint256(...) to mint confidential handles (euint256), completely obfuscating token wealth from public blockchain explorers.

To submit a proposal (GuildDAO.createProposal), a user must hold at least 500 cGUILD. During submission, cGUILD.spendForGovernance(500e18, ...) verifies the encrypted balance within the Intel TDX enclave without revealing exact holdings, while granting the TEE Enclave Master Key (grantAccess) access to verify proposal authenticity.

When a user clicks Upvote (Support / FOR) or Downvote (Reject / AGAINST):

• GuildDAO.castVote(proposalId, support) is executed via a gasless ERC-4337 UserOp.
• Exactly 10 cGUILD (Nox.toEuint256(10e18)) is burned from the voter's confidential handle.
• A new encrypted vote handle (euint256) is generated and pushed to proposal.voteHandles.
• Sealed Tally: During the 3-day voting period (!proposal.executed), the public contract only reports {proposal.voteHandlesCount} Encrypted Vote Handles Sealed. Plaintext totalFor and totalAgainst percentages remain zero on-chain, eliminating bandwagon effects and frontrunning.

Once the voting period concludes (block.timestamp > proposal.endTime), the authorized Intel TDX Enclave Runner (0x1d...) calls executeProposalResult. The hardware enclave decrypts all collected vote handles inside isolated enclave memory, tallies exact FOR and AGAINST weights, and publishes the cryptographic teeProof along with the final resolved percentage split.

Members can delegate O(1) encrypted viewing rights (cGUILD.grantAccess(delegateAgentAddress)) directly to whitelisted autonomous agent enclaves (e.g., Leno AI Enclave v2: 0x5e4B... / 0x98bF...). The agent can securely analyze sentiment and cast programmatic votes inside the TEE without ever leaking voter balances or strategies to the mempool using the AI Agent Master Key delegation scheme.

• Players inject 0.002 ETH into the protocol to mint a Tier I (Lead) elemental NFT (Earth, Water, Wind, Fire, Ice, Lightning).
• DeFi Engine: The 0.002 ETH is immediately wrapped to WETH and deposited directly into the active Uniswap V3 WETH/USDC Liquidity Pool managed by YieldVault.

To increase yield share and rarity, players combine lower-tier NFTs into higher-tier elemental artifacts:

• Recipe: Burn 3x Tier N NFTs + pay 0.002 ETH crafting fee $\rightarrow$ Mint 1x Tier N+1 NFT.
• Deflationary Flywheel: Crafting permanently burns 3 NFTs from circulation, compressing supply while multiplying the owner's staking weight.

When players stake their elemental NFTs inside The Vault:

• YieldVault tracks the user's total active weight versus the globalTotalWeight.

• The user's pro-rata yield reward $R_{user}$ is calculated as a function of their total staked NFT weight $W_{user}$ against the global total weight of staked elements $W_{global}$ and the accumulated fee pool $F_{fees}$:

  $$R_{user} = \frac{W_{user}}{W_{global}} \times F_{fees}$$

• As traders swap on Uniswap V3, real USDC trading fees accrue to the vault.

• YieldVault.harvestAndDistribute() pushes 90% of all harvested USDC into GuildDistributor for stakers to claim instantly, and routes 10% to the Protocol Tax Paymaster to perpetually fund user gas.

To reward users for participating in the economy, paying protocol fees triggers an instant GUILD Subsidy distributed directly from the Treasury Distributor:

• Minting (Tier I): Claims a subsidy of +10 GUILD tokens.
• Crafting Tier II: Claims a subsidy of +50 GUILD tokens.
• Crafting Tier III: Claims a subsidy of +250 GUILD tokens.

Mathematically, the dynamic subsidy follows the function:

$$\text{Subsidy} = \begin{cases} 10 \text{ GUILD} & \text{for Minting (Tier I Element)} \ 50 \text{ GUILD} & \text{for Transmuting Tier II Element} \ 250 \text{ GUILD} & \text{for Transmuting Tier III Element} \end{cases}$$

Alchemy Guild operates as a fully autonomous, self-sustaining financial machine through three specialized background bots:

1. Confidential Rebalance Bot (iexec-nox-rebalancer)
   • Monitors YieldVault Uniswap V3 liquidity positions.
   • When out of range, target ticks (lowerTick, upperTick) are encrypted via iExec Nox inside a confidential payload before triggering YieldVault.rebalance(...). This ensures MEV searchers cannot sandwich the protocol's liquidity adjustments.
2. Tax Recycler (recycle-paymaster-tax.ts)
   • Continuously sweeps the 10% USDC protocol tax harvested from YieldVault.
   • Executes optimal Uniswap V3 swaps from USDC $\rightarrow$ ETH and deposits directly into the Alchemy / Pimlico Verifying Paymaster (0xa992...) on Arbitrum Sepolia (Chain ID: 421614).
3. Organic Volume Simulator (volume-bot.ts)
   • Simulates continuous, realistic retail trading volume across the WETH/USDC Uniswap V3 pool on Arbitrum Sepolia, guaranteeing steady, organic USDC fee accrual for NFT stakers.

All core contracts and TEE enclaves are deployed and verified on Arbitrum Sepolia (Chain ID: 421614):

• Node.js v18+ (npm or pnpm)
• Foundry (forge, cast, anvil)
• Arbitrum Sepolia ETH (only needed for deployer/treasury wallet operations; all user operations are sponsored via Paymaster).

git clone https://github.com/tmalone1250/alchemy-guild.git
cd alchemy-guild

# Install Frontend Dependencies
npm install

# Setup Environment Variables
cp .env.example .env

Ensure your .env contains:

VITE_PIMLICO_API_KEY=your_pimlico_api_key
VITE_RPC_URL=https://sepolia-rollup.arbitrum.io/rpc
PRIVATE_KEY=your_deployer_or_bot_private_key

npm run dev

Open http://localhost:5173 in your browser. Connect any Web3 wallet (MetaMask, Rabby, Reown AppKit); the application automatically provisions and connects your Gasless Smart Account (ERC-4337).

cd ../alchemy-vault
forge build
forge test -vvv

# Run Organic Volume Simulator (Swaps WETH <-> USDC on Uniswap V3)
npx tsx volume-bot.ts

# Run Tax Recycler (Converts harvested USDC tax to ETH -> deposits to Paymaster)
npx tsx recycle-paymaster-tax.ts

• Frontend Application: React 18, Vite, TypeScript, Tailwind CSS, Shadcn/UI, Lucide Icons.
• Web3 & Account Abstraction: Wagmi v2, Viem v2, TanStack Query, Permissionless.js v0.1.33 (smartAccountClient), Reown / WalletConnect AppKit.
• Confidentiality Engine: iExec Nox Protocol (euint256, euint32, Nox.allow, Nox.allowThis, confidential TEE runner executeProposalResult).
• Smart Contracts: Solidity 0.8.26, Foundry Forge, OpenZeppelin v5, Uniswap V3 Core & Periphery (NonfungiblePositionManager).

1. Connect & Provision: Connect wallet $\rightarrow$ Automatic Smart Account deployment on Arbitrum Sepolia (0.00 ETH gas).
2. The Laboratory: Click Mint Element (0.002 ETH) to inject liquidity and receive Tier I Lead NFTs. Select 3 matching elements and click Craft Tier II / III to transmute into high-weight artifacts.
3. The Vault: Deposit (Stake) your NFTs into the YieldVault to begin earning continuous pro-rata USDC real yield. Click Harvest & Claim anytime.
4. The Guild Hall (Confidential Governance):
   • Shielding Lab: Convert public GUILD tokens into confidential cGUILD (euint256).
   • Active Proposals (AIP-1): Click Upvote (Support) or Downvote (Reject). Exactly 10 cGUILD is burned from your secret handle while your vote weight is sealed inside the Intel TDX Enclave.
   • AI Delegation: Delegate O(1) encrypted viewing rights (grantAccess) to whitelisted AI Agent enclaves (Leno AI v2) for autonomous governance execution.