Luffa x Encode AI Hackathon Template

A ready-to-use Luffa SuperBox mini program template that demonstrates core blockchain capabilities on the Endless network. Built for developers participating in the Encode AI Hackathon.

Features

• Wallet Connect — Link a Luffa wallet and display address, avatar, nickname
• EDS Transfer — Send EDS tokens between wallets on the Endless network
• Sign & Verify — Sign messages client-side and verify signatures server-side
• Live Market Prices — Real-time crypto prices via CoinGecko API (BTC, ETH, SOL, DOGE)

---

Architecture

graph TD
    subgraph Pages["Mini Program Pages"]
        Home["Home Page"]
        Connect["Wallet Connect"]
        Transaction["Transaction"]
        Sign["Sign & Verify"]
        Market["Market Prices"]
    end

    subgraph SDK["SDK Layer"]
        Luffa["luffa.js — SDK Wrapper"]
        CoinGecko["CoinGecko REST API"]
    end

    subgraph Native["Luffa SuperBox Runtime"]
        Bridge["wx.invokeNativePlugin\n(Native Bridge)"]
    end

    Blockchain[("Endless Blockchain")]

    Home --> Connect
    Home --> Transaction
    Home --> Sign
    Home --> Market

    Connect --> Luffa
    Transaction --> Luffa
    Sign --> Luffa
    Market --> CoinGecko

    Luffa --> Bridge
    Bridge --> Blockchain

Loading

---

Project Structure

LuffaShowCase/
├── app.js                  # App entry — restores wallet from storage
├── app.json                # Page routes & navigation bar config
├── app.wxss                # Global styles
├── project.config.json     # Luffa DevTools config (v2.3.3)
├── luffalogo.svg           # Luffa brand logo
│
├── utils/
│   └── luffa.js            # SDK wrapper — all Luffa native API calls
│
└── pages/
    ├── home/               # Landing page with wallet status & quick actions
    │   ├── home.js
    │   ├── home.wxml
    │   ├── home.wxss
    │   └── home.json
    │
    ├── wallet/
    │   ├── connect.*       # Wallet connect/disconnect
    │   ├── transaction.*   # EDS token transfer
    │   └── sign.*          # Message signing & verification
    │
    └── market/
        ├── market.js       # CoinGecko API with caching
        ├── market.wxml
        ├── market.wxss
        └── market.json

---

Core Flows

Wallet Connect

sequenceDiagram
    participant User
    participant MiniApp as Mini Program
    participant SDK as luffa.js
    participant Wallet as Luffa Wallet

    User->>MiniApp: Tap "Connect Wallet"
    MiniApp->>SDK: luffa.connect(metadata)
    SDK->>Wallet: wx.invokeNativePlugin()
    Wallet-->>User: Show approval dialog
    User->>Wallet: Approve
    Wallet-->>SDK: address, avatar, cid, nickname, uid
    SDK-->>MiniApp: Resolve promise
    MiniApp->>MiniApp: Store in app.globalData.wallet
    MiniApp-->>User: Show wallet details

Loading

EDS Transfer (2-step)

sequenceDiagram
    participant User
    participant Page as transaction.js
    participant SDK as luffa.js
    participant Chain as Endless Network

    User->>Page: Enter recipient + amount
    User->>Page: Tap "Send"

    Note over Page,SDK: Step 1 — Package Transaction
    Page->>SDK: luffa.transfer(from, to, amount)
    Note right of SDK: module: "0x1"<br/>moduleName: "endless_account"<br/>functionName: "transfer"<br/>amount × 10^8
    SDK-->>Page: rawData

    Note over Page,Chain: Step 2 — Sign & Submit
    Page->>SDK: luffa.signAndSubmit(from, rawData)
    SDK->>Chain: Broadcast transaction
    Chain-->>SDK: Transaction hash
    SDK-->>Page: tx hash
    Page-->>User: Show success + hash

Loading

Sign & Verify (2-step)

sequenceDiagram
    participant User
    participant Page as sign.js
    participant SDK as luffa.js
    participant Wallet as Luffa Wallet
    participant Server as Verify Server

    User->>Page: Enter message + nonce
    User->>Page: Tap "Sign"

    Note over Page,Wallet: Step 1 — Client-side Signing
    Page->>SDK: luffa.signMessage(message, nonce)
    Note right of SDK: signMessageV2<br/>network: "eds"<br/>from: ""
    SDK->>Wallet: Native sign dialog
    Wallet-->>SDK: publicKey, signature, fullMessage
    SDK-->>Page: Signing result
    Page-->>User: Show signature data

    User->>Page: Tap "Verify"

    Note over Page,Server: Step 2 — Server-side Verification
    Page->>SDK: luffa.verifySignature(key, sign, msg)
    SDK->>Server: POST {key, sign, msg}
    Server-->>SDK: {code: 200, data: true}
    SDK-->>Page: Verification result
    Page-->>User: Signature valid!

Loading

Market Data Flow

flowchart LR
    A[User opens<br/>Market page] --> B{Cache fresh?<br/>< 60s old}
    B -- Yes --> C[Show cached data]
    B -- No --> D[Fetch from CoinGecko]
    D --> E{Response?}
    E -- 200 OK --> F[Update UI + cache]
    E -- 429 Rate Limited --> G[Show cached + warning]
    E -- Network Error --> H[Show cached + offline notice]

Loading

---

SDK Reference (utils/luffa.js)

All functions return Promises and use wx.invokeNativePlugin with api_name: "luffaWebRequest".

Function	Description	Key Params
connect(metadata)	Open wallet connect dialog	metadata.url, metadata.icon
signMessage(message, nonce)	Sign a message (signMessageV2)	message: string, nonce: number
verifySignature(key, sign, msg)	Verify signature on server	key: publicKey, sign: signature
packageTransaction(...)	Package tx V1 (typed params)	module, moduleName, functionName, data
packageTransactionV2(...)	Package tx V2 (function string)	func: "Addr::Module::Func"
signAndSubmit(from, rawData)	Sign and broadcast transaction	rawData from packageTransaction
transfer(from, to, amount)	EDS transfer helper (uses V1)	amount in EDS (auto-converts to chain units)
getLanguage()	Get Luffa app language	—
share(title, detail, imageUrl)	Share content	title, detail
openUrl(url)	Open Luffa URL	url: luffa:// link

V1 Typed Params Format

Transaction data uses positional typed parameters:

{
  "1_address_address": "0xRecipientAddress",  // position 1, type address
  "2_u128_amount": "150000000"                // position 2, type u128
}

Pattern: "position_type_paramName"

V2 Function String Format

{
  function: "0xContractAddress::ModuleName::FunctionName",
  functionArguments: ["arg1", "arg2"],
  typeArguments: []
}

---

Getting Started

Prerequisites

• Luffa SuperBox DevTools (v2.3.3+)
• A Luffa wallet for testing

Setup

1. Clone the template

   git clone <your-repo-url>

2. Open in Luffa DevTools

   • Launch Luffa SuperBox DevTools
   • Select "Import Project"
   • Point to the cloned directory

3. Configure your dApp metadata in pages/wallet/connect.js:

   luffa.connect({
     url: 'https://your-dapp-url.com',        // Your dApp URL
     icon: 'https://your-dapp-icon.com/icon.png' // Your dApp icon
   })

4. Preview — Click "Preview" in DevTools to test on your phone via the Luffa app

Testing on Device

Some native features (wallet connect, signing, transactions) require a real device — they may not work fully in the DevTools simulator.

---

API Notes

CoinGecko (Market Page)

• Free tier — no API key required
• Rate limit — the template uses 60s caching and 10s refresh cooldown to avoid 429 errors
• Falls back to cached data when offline or rate-limited

Luffa Verify Endpoint

The signature verification endpoint:

POST https://k8s-ingressn-ingressn-f1c0412ab0-63d9d6d0cb58a38c.elb.ap-southeast-1.amazonaws.com/lf16585928939296/verify/endless/verify

Request body:

{
  "key": "<publicKey>",
  "sign": "<signature>",
  "msg": "<fullMessage>"
}

Response: { "code": 200, "data": true } if valid.

---

Documentation

• Luffa SuperBox Quick Start
• Luffa Custom API Reference
• CoinGecko API Docs

---

License

MIT — free to use and modify for your hackathon project.