Quickstart

LogiChain makes decentralized, verifiable CI/CD simple, secure, and powerful. Follow the steps below to get started:

---

🧱 Prerequisites

Before you begin, make sure you have:

• A Sui Wallet installed and funded with SUI.

• A GitHub account with access to the repository you'd like to build.

• Optional: Tokens on a supported source chain (for billing via Wormhole).

---

⚙️ Step-by-Step Instructions

1. Connect Your Sui Wallet

• Visit LogiChain App.

• Click "Connect Wallet".

• Authorize the connection in your Sui wallet extension.

• Your address will now appear in the top-right corner.

---

2. 🔗 Connect Your GitHub Account

• Click "Login with GitHub".

• Authorize LogiChain to read your repositories.

• Once connected, your accessible repositories will be listed.

---

3. 📁 Select Repository for CI/CD

• Browse the list of repositories.

• Click "Enable CI/CD" for the desired repository.

• Configure:

  • Branch to track (e.g., main)

  • Build configuration (e.g., Dockerfile, shell script)

  • Output artifacts (if applicable)

---

4. 💸 Make an Initial Deposit (Billing via Wormhole)

• Select your source chain (e.g., Ethereum, BSC, etc.)

• Enter the desired deposit amount.

• Confirm the cross-chain token transfer using Wormhole:

  • Tokens are locked/burned on the source chain.

  • A VAA is generated and submitted to Sui.

  • Sui receives and credits your payment balance.

✅ Note: This deposit serves as prepayment. Final billing is based on actual usage.

---

5. 🛠 Trigger Build & Verification

• After a new commit is pushed, or via manual trigger:

  • LogiChain selects an available Runner Operator.

  • The Runner stakes SUI and performs the build job.

  • Build artifacts are generated off-chain.

  • A verifiable attestation is created and stored on-chain.

---

6. 🔏 View Attestation & Build Artifacts

• Navigate to the "Attestations" tab.

• View:

  • Source commit ID

  • Runner node details

  • Build metadata (environment, OS, etc.)

  • Artifact hash

  • On-chain proof link

---

7. 🧾 Final Billing

• After build completion, usage metrics are calculated.

• The final amount is deducted from your prepaid balance.

• Optionally, request a refund or top-up additional funds.

---

8. 🔍 Verify Anywhere (Cross-Chain Attestation)

• Attestation is broadcast using Wormhole.

• Verification can be performed on target chains (e.g., Ethereum, Cosmos).

• Developers and users can cryptographically verify build legitimacy.

---

🧰 Optional Features

• Runner Dashboard: View active runners, SUI stake, and build history.

• Attestation Explorer: Public registry of all build attestations.

• GitHub Badge Integration: Display "Verified by LogiChain" badge on your repo.