Skip to content

Alice699/liquira

Repository files navigation

Liquira

Liquira is a stablecoin treasury operating layer for Arc Testnet. It gives finance teams one controlled workspace for wallet-aware balances, bridge flows, send flows, transaction follow-through, and treasury visibility.

Overview

Liquira is designed for operators, treasury managers, and crypto-native teams that need a calmer way to move stablecoin liquidity. The product focuses on operational clarity over trading noise: explicit transaction states, visible follow-through, and a treasury-first interface built around Arc Testnet.

Current release scope:

  • Live wallet connection and Arc environment awareness
  • Treasury overview with Arc wallet-linked balance visibility
  • Bridge into Arc Testnet
  • Send from Arc Testnet
  • Durable activity tracking with explorer-linked references
  • Swap surface visible in-product while live execution remains pending a verified integration path

Product Gallery

Landing

Liquira landing page

Overview

Liquira overview

Treasury

Liquira treasury

Bridge

Liquira bridge flow

Send

Liquira send flow

Why Liquira

  • Treasury-first product surface instead of a trading-first dashboard
  • Explicit workflow states for bridge and send operations
  • Durable activity visibility instead of relying on transient toasts
  • Arc Testnet-aware environment handling and wallet-linked reads
  • Submission-ready product presentation for Arc ecosystem review

Release Status

Surface Status
Wallet connection Live
Arc Testnet environment awareness Live
Treasury overview Live
Bridge into Arc Live
Send from Arc Live
Activity tracking Live
Swap on Arc In product, execution pending verified integration

Stack

  • Next.js App Router
  • TypeScript
  • Tailwind CSS
  • Viem
  • Arc-oriented workflow integration boundaries
  • Local wallet, activity, and toast providers

Project Structure

app/                 Next.js routes and layouts
components/          Product UI, landing surfaces, layout, workflows
lib/                 Arc config, transaction state model, utilities
public/              Static assets, icons, README screenshots
scripts/             Local developer utilities and reset scripts

Local Development

Requirements:

  • Node 22.x
  • npm

Install and run:

npm install
npm run dev

Open http://localhost:3000.

Useful scripts:

npm run dev:watch
npm run build
npm run start
npm run typecheck
npm run dev:reset:windows

Notes:

  • npm run dev uses a production-like build + start flow for local stability.
  • npm run dev:watch is available for hot reload.
  • Running the project from a Linux filesystem inside WSL is typically faster and more stable than running from /mnt/c/....

Environment

The current product is scoped to Arc Testnet.

Key environment details:

  • RPC: https://rpc.testnet.arc.network
  • WebSocket: wss://rpc.testnet.arc.network
  • Chain ID: 5042002
  • Explorer: https://testnet.arcscan.app
  • Native gas token: USDC

Environment variables:

NEXT_PUBLIC_CIRCLE_KIT_KEY=

.env.local is ignored by git and should not be committed.

Verification

Recommended checks before pushing or deploying:

npm run typecheck
npm run build

Recommended product checks:

  • Landing page loads correctly
  • Overview renders wallet-aware state
  • Bridge works on Arc Testnet
  • Send works on Arc Testnet
  • Activity reflects durable transaction states
  • Settings reflect the current release scope

Deployment

Recommended Vercel setup:

  • Use Node 22.x
  • Add required environment variables in the Vercel project
  • Verify the following routes after deploy:
    • /
    • /app/overview
    • /app/treasury
    • /app/move/bridge
    • /app/move/send
    • /app/activity
    • /app/settings

Notes on Swap

The swap surface remains in-product so the workflow shape and supported scope stay visible, but live execution is not presented as ready in this release. That boundary is intentional and kept explicit in the UI.

License

No license has been added yet.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors