Wallets¶

Table of Contents¶

Wallet Stack
Required Variable
Wallet Metadata URL
Contract Addresses
Authors and Contributors
Legal

Kevin K. Le (LinkedIn) — Founder, Founding Engineer, and Current Lead Engineer; Software Engineer at the Oregon Blockchain Group, University of Oregon.

Kellen Snider — Founding Engineer; Software Engineer at the Oregon Blockchain Group, University of Oregon. His vision, ideas, and dedication during TrustLedger's Ethereum development were invaluable to the codebase we build on today.

See CREDITS.md.

This document explains wallet configuration for the TrustLedger frontend. Read it when changing Reown AppKit, supported chains, or wallet metadata.

Wallet Stack¶

Home · Top · Table of Contents

The frontend uses Reown AppKit with wagmi and viem. Configuration lives in src/lib/wagmi.ts. The navigation wallet control is split into a lightweight disconnected shell and the connected menu. Keep the connected path loaded when a wallet is already connected so copy-address, analytics, dashboard, and disconnect actions are immediately available without opening the AppKit modal.

Supported frontend networks are:

Network	Chain ID
Sepolia	`11155111`
Arbitrum One	`42161`
Base	`8453`
Optimism	`10`

Required Variable¶

Home · Top · Table of Contents

Set this variable for WalletConnect relay wallets:

NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=

Without a real project ID, injected wallets and Coinbase can still work in some browsers, but QR, mobile, Tangem, Phantom, and other WalletConnect relay flows can fail.

Wallet Metadata URL¶

Home · Top · Table of Contents

AppKit advertises an origin to wallets. The frontend prefers the live browser origin and uses NEXT_PUBLIC_SITE_URL or NEXT_PUBLIC_APP_URL as a server-rendered fallback.

Set one of these for production:

NEXT_PUBLIC_SITE_URL=https://your-domain.example
NEXT_PUBLIC_APP_URL=https://your-domain.example

Contract Addresses¶

Home · Top · Table of Contents

Wallet connection does not configure contract addresses. Contract addresses are read from the frontend deployment variables documented in Environment.

Authors and Contributors¶

Home · Top · Table of Contents

Kevin K. Le — Founder, Founding Engineer, and Current Lead Engineer (LinkedIn)
Kellen Snider — Founding Engineer (LinkedIn)

See CREDITS.md for the complete acknowledgement list.

Legal¶

Home · Top · Table of Contents

This document is part of TrustLedger, an open-source decentralized escrow and arbitration protocol. Use of this software and documentation is subject to the Terms and Conditions, Privacy Policy, and Risk Disclosure. See LEGAL.md for the full compliance and licensing overview.