Liquidity.io Docs

Sovereign EVM L1 chain — node, CLI, SDK, genesis, precompiles, Substrate migration

LQDTY is a sovereign EVM L1 with Quasar consensus and 1ms deterministic finality. It hosts the on-chain components of the exchange: token contracts, loan registries, DEX precompiles, custody wallets, and Substrate migration.

Chain Details

Parameter	Mainnet	Testnet
Chain name	LQDTY	LQDTY Testnet
Chain ID	`8675309`	`8675310`
Currency	LQDTY (18 decimals)	LQDTY
Block time	1ms (DEX VM)	1ms
Consensus	Quasar (DAG + FPC)	Quasar
Finality	1ms deterministic	1ms
Total supply	10,000,000,000 LQDTY	—
RPC	`https://rpc.liquidity.io`	`https://testnet-rpc.liquidity.io`
Explorer	`https://explorer.liquidity.io`	`https://testnet-explorer.liquidity.io`

Node

The LQDTY node (liquidityio/node) is a single embedded binary that runs as either a full node or an EVM plugin subprocess.

# Build
cd node && make build

# Run as full node
./liquidity-node --network-id=lqdty

# Auto-detected as plugin mode via env var
LIQUID_VM_TRANSPORT=grpc ./liquidity-node

EVM Precompiles

The LQDTY EVM includes 14 native precompile modules:

Category	Precompile	Purpose
Post-Quantum	ML-DSA	FIPS 204 digital signatures
	ML-KEM	FIPS 203 key encapsulation
	SLH-DSA	FIPS 205 hash-based signatures
	PQCrypto	Unified PQ interface
Threshold	CGGMP21	Threshold ECDSA (secp256k1)
	FROST	Threshold EdDSA (Ed25519)
	Ringtail	Hybrid BLS+lattice threshold
Curves	Ed25519	EdDSA verification
	secp256r1	NIST P-256 (WebAuthn)
	SR25519	Substrate Ristretto255 (migration)
Hashing	Blake3	3x faster than Keccak
DEX	LiquidPool	AMM concentrated liquidity
	LiquidBook	CLOB orderbook
	LiquidVault	Margin, clearinghouse, liquidation

CLI

The LQDTY CLI (liquidityio/cli) provides 30+ commands for chain management:

# Install
cd cli && make install

# Key commands
liquidity chain create       # Create new L1/subnet
liquidity chain deploy       # Deploy to testnet/mainnet
liquidity node create        # Spin up validator nodes (AWS EC2)
liquidity node validate      # Start validating
liquidity key create         # Generate keys (Ledger support)
liquidity mpc                # Threshold signing operations
liquidity dex                # DEX trading commands
liquidity contract           # Smart contract interaction
liquidity network            # Local network management

TypeScript SDK

The @liquidityio/sdk package provides client libraries for all LQDTY contracts and precompiles.

npm install @liquidityio/sdk

Contract Wrappers

Export	Purpose
`LiquidityClient`	Main client (connects to RPC, auto-detects chain)
`LoanRegistry`	Loan origination, lifecycle, servicing
`SecurityToken`	Whitelisted ERC20 with document management
`LQDTYToken`	Native LQDTY ERC20
`TokenSwap`	Atomic token-for-token exchange
`SubstrateMigration`	Substrate → EVM balance claims (SR25519 verification)

DEX Interfaces

Export	Purpose
`LiquidPool`	AMM concentrated liquidity (Uniswap V3 style)
`LiquidBook`	CLOB orderbook
`LiquidVault`	Margin trading, liquidations, ADL

Precompile Clients

Export	Purpose
`Blake3`	Fast hashing precompile
`SR25519`	Substrate signature verification
`FROST`	Threshold EdDSA verification
`CGGMP21`	Threshold ECDSA verification
`Ed25519`	EdDSA verification
`secp256r1`	WebAuthn / NIST P-256

Usage

import { LiquidityClient } from '@liquidityio/sdk'

const client = new LiquidityClient({
    chainId: 8675309,
    rpcUrl: 'https://rpc.liquidity.io',
    signer: wallet,
})

// DEX: Trade on AMM
const pool = client.liquidPool('0x...')
await pool.swap(tokenIn, tokenOut, amountIn)

// DEX: Place limit order on CLOB
const book = client.liquidBook()
await book.placeOrder({ marketId: 1, side: 'buy', price: 50000, size: 1 })

// Verify threshold signature on-chain
const frost = client.frost()
const valid = await frost.verify(publicKey, message, signature)

// Claim Substrate balance
const migration = client.substrateMigration('0x...')
await migration.claim(sr25519Signature, substrateAddress)

Genesis & Substrate Migration

The LQDTY chain migrated from a Substrate-based chain to an EVM L1:

Metric	Value
Accounts migrated	1,727
Loans migrated	8
Redenomination	12 decimals → 18 decimals (1:1,000,000)
Import batches	35 (via SubstrateImporter.sol)
Treasury	8,499,999,953 LQDTY (85%)
Distribution	999,992,794 LQDTY (10%)
Reserve	500,000,000 LQDTY (5%)

Migration flow: Export Substrate state → Redenominate → Deploy L1 → Deploy SubstrateImporter → importBalances (35 batches) → importLoans → finalizeMigration (permanent lock) → Users claim via SR25519 precompile.

Wallet Configuration

Add LQDTY to MetaMask or any EVM wallet:

Field	Mainnet	Testnet
Network Name	LQDTY Mainnet	LQDTY Testnet
RPC URL	`https://rpc.liquidity.io`	`https://testnet-rpc.liquidity.io`
Chain ID	8675309	8675310
Currency Symbol	LQDTY	LQDTY
Block Explorer	`https://explorer.liquidity.io`	`https://testnet-explorer.liquidity.io`

LQDTY Blockchain