Merge pull request canopy-network#277 from canopy-network/feature/wallet

New Wallet Implementation

Author: rem1niscence

.docker/Dockerfile

@@ -2,9 +2,27 @@ FROM golang:1.24-alpine AS builder
 
 RUN apk update && apk add --no-cache make bash nodejs npm
 
+# Wallet-specific build configuration
+# Default: / (for simple-stack deployment with direct port access)
+ARG VITE_WALLET_BASE_PATH=/
+ARG VITE_EXPLORER_BASE_PATH=http://localhost:50001
+# RPC proxy targets for chain.json generation
+ARG VITE_WALLET_RPC_PROXY_TARGET=http://localhost:50002
+ARG VITE_WALLET_ADMIN_RPC_PROXY_TARGET=http://localhost:50003
+ARG VITE_ROOT_WALLET_RPC_PROXY_TARGET=http://localhost:50002
+
+
 WORKDIR /go/src/github.com/canopy-network/canopy
 COPY . /go/src/github.com/canopy-network/canopy
 
+# Export build configuration to environment
+ENV VITE_WALLET_BASE_PATH=${VITE_WALLET_BASE_PATH}
+ENV VITE_EXPLORER_BASE_PATH=${VITE_EXPLORER_BASE_PATH}
+ENV VITE_WALLET_RPC_PROXY_TARGET=${VITE_WALLET_RPC_PROXY_TARGET}
+ENV VITE_WALLET_ADMIN_RPC_PROXY_TARGET=${VITE_WALLET_ADMIN_RPC_PROXY_TARGET}
+ENV VITE_ROOT_WALLET_RPC_PROXY_TARGET=${VITE_ROOT_WALLET_RPC_PROXY_TARGET}
+
+
 RUN make build/wallet
 RUN make build/explorer
 RUN go build -a -o bin ./cmd/main/...

.docker/compose.yaml

@@ -4,38 +4,51 @@ services:
     build:
       context: ..
       dockerfile: .docker/Dockerfile
+      args:
+        VITE_WALLET_BASE_PATH: /
+        VITE_EXPLORER_BASE_PATH: http://localhost:50001
+        VITE_WALLET_RPC_PROXY_TARGET: http://localhost:50002
+        VITE_WALLET_ADMIN_RPC_PROXY_TARGET: http://localhost:50003
+        VITE_ROOT_WALLET_RPC_PROXY_TARGET: http://localhost:50002
     ports:
       - 50000:50000 # Wallet
       - 50001:50001 # Explorer
       - 50002:50002 # RPC
       - 50003:50003 # Admin RPC
-      - 9001:9001   # TCP P2P
-      - 6060:6060   # Debug
-      - 9090:9090   # Metrics
+      - 9001:9001 # TCP P2P
+      - 6060:6060 # Debug
+      - 9090:9090 # Metrics
     networks:
       - canopy
     command: ["start"]
     volumes:
       - ./volumes/node_1:/root/.canopy
-#    deploy:
-#      resources:
-#        limits:
-#          memory: 2G
-#          cpus: "1.0"
+  #    deploy:
+  #      resources:
+  #        limits:
+  #          memory: 2G
+  #          cpus: "1.0"
 
   node-2:
     container_name: node-2
     build:
       context: ..
       dockerfile: .docker/Dockerfile
+      args:
+        VITE_WALLET_BASE_PATH: /
+        VITE_EXPLORER_BASE_PATH: http://localhost:40001
+        VITE_WALLET_RPC_PROXY_TARGET: http://localhost:40002
+        VITE_WALLET_ADMIN_RPC_PROXY_TARGET: http://localhost:40003
+        VITE_ROOT_WALLET_RPC_PROXY_TARGET: http://localhost:50002
+
     ports:
       - 40000:40000 # Wallet
       - 40001:40001 # Explorer
       - 40002:40002 # RPC
       - 40003:40003 # Admin RPC
-      - 9002:9002   # TCP P2P
-      - 6061:6060   # Debug
-      - 9091:9091   # Metrics
+      - 9002:9002 # TCP P2P
+      - 6061:6060 # Debug
+      - 9091:9091 # Metrics
     networks:
       - canopy
     command: ["start"]
@@ -72,4 +85,4 @@ services:
 
 networks:
   canopy:
-    driver: bridge
+    driver: bridge

Dockerfile

@@ -0,0 +1,48 @@
+FROM golang:1.24-alpine AS builder
+
+RUN apk update && apk add --no-cache make bash nodejs npm
+
+ARG BIN_PATH
+# Wallet-specific build configuration
+# Default: /wallet/ (for monitoring-stack deployment with Traefik reverse proxy)
+# Override with: docker build --build-arg VITE_WALLET_BASE_PATH=/
+ARG VITE_WALLET_BASE_PATH=/wallet/
+# RPC proxy targets for chain.json generation
+# For monitoring-stack, these should be Traefik URLs
+ARG VITE_WALLET_RPC_PROXY_TARGET=/wallet/rpc
+ARG VITE_WALLET_ADMIN_RPC_PROXY_TARGET=/wallet/adminrpc
+ARG VITE_ROOT_WALLET_RPC_PROXY_TARGET=/wallet/rootrpc
+
+WORKDIR /go/src/github.com/canopy-network/canopy
+COPY . /go/src/github.com/canopy-network/canopy
+
+# Export build configuration to environment
+# These are available during npm build for wallet and explorer
+ENV VITE_WALLET_BASE_PATH=${VITE_WALLET_BASE_PATH}
+ENV VITE_WALLET_RPC_PROXY_TARGET=${VITE_WALLET_RPC_PROXY_TARGET}
+ENV VITE_WALLET_ADMIN_RPC_PROXY_TARGET=${VITE_WALLET_ADMIN_RPC_PROXY_TARGET}
+ENV VITE_ROOT_WALLET_RPC_PROXY_TARGET=${VITE_ROOT_WALLET_RPC_PROXY_TARGET}
+
+RUN make build/wallet
+RUN make build/explorer
+RUN CGO_ENABLED=0 GOOS=linux go build -a -o bin ./cmd/auto-update/.
+
+# Only build if the file at ${BIN_PATH} doesn't already exist
+RUN if [ ! -f "${BIN_PATH}" ]; then \
+  echo "File ${BIN_PATH} not found. Building it..."; \
+  CGO_ENABLED=0 GOOS=linux go build -a -o "${BIN_PATH}" ./cmd/main/...; \
+  else \
+  echo "File ${BIN_PATH} already exists. Skipping build."; \
+  fi
+
+FROM alpine:3.19
+
+RUN apk add --no-cache pigz ca-certificates
+
+ARG BIN_PATH
+
+WORKDIR /app
+COPY --from=builder /go/src/github.com/canopy-network/canopy/bin ./
+COPY --from=builder /go/src/github.com/canopy-network/canopy/${BIN_PATH} ${BIN_PATH}
+RUN chmod +x ${BIN_PATH}
+ENTRYPOINT ["/app/bin"]

cmd/rpc/server.go

@@ -341,7 +341,7 @@ var explorerFS embed.FS
 //go:embed all:web/wallet/out
 var walletFS embed.FS
 
-// runStaticFileServer creates a web server serving static files
+// runStaticFileServer creates a web server serving static files with SPA fallback
 func (s *Server) runStaticFileServer(fileSys fs.FS, dir, port string, conf lib.Config) {
 	// Attempt to get a sub-filesystem rooted at the specified directory
 	distFS, err := fs.Sub(fileSys, dir)
@@ -352,13 +352,16 @@ func (s *Server) runStaticFileServer(fileSys fs.FS, dir, port string, conf lib.C
 
 	// Create a new ServeMux to handle incoming HTTP requests
 	mux := http.NewServeMux()
-	fileServer := http.FileServer(http.FS(distFS))
 
 	// Define a handler function for the root path
 	mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
-		serveIndex := func() {
+		requestedPath := r.URL.Path
+
+		// Helper function to serve index.html with config injection
+		serveIndexHTML := func() {
 			// Construct the file path for `index.html`
 			filePath := path.Join(dir, "index.html")
+
 			// Read the content of `index.html` into a byte slice
 			htmlBytes, e := fs.ReadFile(fileSys, filePath)
 			if e != nil {
@@ -372,26 +375,40 @@ func (s *Server) runStaticFileServer(fileSys fs.FS, dir, port string, conf lib.C
 			// Set the response header as HTML and write the injected content to the response
 			w.Header().Set("Content-Type", "text/html")
 			w.WriteHeader(http.StatusOK)
-			_, _ = w.Write([]byte(injectedHTML))
+			w.Write([]byte(injectedHTML))
 		}
 
-		// Serve `index.html` with dynamic config injection
-		if r.URL.Path == "/" || r.URL.Path == "/index.html" {
-			serveIndex()
+		// Serve index.html for root path
+		if requestedPath == "/" || requestedPath == "/index.html" {
+			serveIndexHTML()
 			return
 		}
 
-		// Serve real static assets if they exist.
-		requestPath := strings.TrimPrefix(path.Clean(r.URL.Path), "/")
-		if requestPath != "" {
-			if _, e := fs.Stat(distFS, requestPath); e == nil {
-				fileServer.ServeHTTP(w, r)
+		// Check if the requested path has a file extension (indicates static asset)
+		// Common static asset extensions: .js, .css, .svg, .png, .jpg, .jpeg, .gif, .ico, .woff, .woff2, .ttf, .eot, .map
+		ext := path.Ext(requestedPath)
+		isStaticAsset := ext != ""
+
+		if isStaticAsset {
+			// Try to serve the static asset from the file system
+			// Remove leading slash for fs.Open
+			assetPath := strings.TrimPrefix(requestedPath, "/")
+
+			// Check if the file exists in the embedded filesystem
+			if _, err := distFS.Open(assetPath); err == nil {
+				// File exists, serve it
+				http.FileServer(http.FS(distFS)).ServeHTTP(w, r)
 				return
 			}
+
+			// Static asset not found, return 404
+			http.NotFound(w, r)
+			return
 		}
 
-		// SPA fallback: unknown client-side routes resolve to index.html.
-		serveIndex()
+		// For all other requests (no file extension = HTML navigation),
+		// serve index.html to enable SPA client-side routing
+		serveIndexHTML()
 	})
 
 	// Start the HTTP server in a new goroutine and listen on the specified port

cmd/rpc/web/wallet/.env.example

@@ -0,0 +1,22 @@
+# Wallet Base Path Configuration
+# This sets the base URL path for the wallet in production builds
+#
+# Examples:
+# - For deployment at https://example.com/wallet/ use: VITE_WALLET_BASE_PATH=/wallet/
+# - For deployment at https://wallet.example.com/ use: VITE_WALLET_BASE_PATH=/
+# - For deployment at root domain use: VITE_WALLET_BASE_PATH=/
+#
+# Default: /wallet/
+VITE_WALLET_BASE_PATH=/wallet/
+
+# RPC Proxy Targets (Development Server Only)
+# Used by Vite dev server proxy configuration
+VITE_WALLET_RPC_PROXY_TARGET=http://localhost:50002
+VITE_WALLET_ADMIN_RPC_PROXY_TARGET=http://localhost:50003
+# Root chain RPC target - used for cross-chain order queries (available orders, orders to fulfill)
+VITE_ROOT_WALLET_RPC_PROXY_TARGET=http://localhost:50002
+
+# Node Environment
+# Options: development | production
+# Default: development
+VITE_NODE_ENV=development

cmd/rpc/web/wallet/.gitignore

@@ -1,41 +1,12 @@
-# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
-
-# dependencies
-/node_modules
-/.pnp
-.pnp.js
-
-# testing
-/coverage
-
-# next.js
-/.next/
-/out/
-
-# production
-/build
-
-# misc
-.DS_Store
-*.pem
-
-# debug
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-
-# local env files
-.env*.local
-
-# Docker environment
-.docker/.env
-.docker/volumes
-
-# vercel
-.vercel
-
-# typescript
+.agents/*
+.claude/*
+node_modules
+out
+vite.config.ts.*
+.idea
+dist
 *.tsbuildinfo
-next-env.d.ts
 
-.idea
+# Compiled JS files (TypeScript generates these)
+src/**/*.js
+src/**/*.jsx

cmd/rpc/web/wallet/.prettierrc

@@ -0,0 +1,45 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+- `src/` contains application code.
+- `src/app/` holds routing, page shells, and providers.
+- `src/components/` contains feature UI and reusable primitives (`src/components/ui`).
+- `src/actions/` implements the dynamic action/form runtime.
+- `src/core/` and `src/hooks/` contain DS fetch logic, RPC helpers, and data hooks.
+- `src/manifest/` contains manifest loaders and types.
+- `public/plugin/canopy/` is the config surface (`chain.json`, `manifest.json`, `chain.json.template`).
+- `scripts/generate-chain-config.js` is executed before production builds.
+- `docs/declarative-actions-and-chain.md` documents the config-first architecture.
+- Build artifacts are emitted to `out/`.
+
+## Build, Test, and Development Commands
+- `npm install` installs dependencies (a `pnpm-lock.yaml` is also present if you use pnpm).
+- `npm run dev` starts the Vite dev server on `http://localhost:5173`.
+- `npm run build` runs prebuild config generation, TypeScript project checks, and Vite production build.
+- `npm run preview` serves the production bundle locally.
+- No `npm test` script exists in this package yet; use `npm run build` as the minimum validation step.
+
+## Coding Style & Naming Conventions
+- TypeScript is strict (`"strict": true`); keep all new code fully typed.
+- Prefer React function components and hooks.
+- Naming conventions:
+  - Components: `PascalCase.tsx` (example: `ValidatorList.tsx`)
+  - Hooks: `useX.ts`/`useX.tsx` (example: `useValidators.ts`)
+  - Utilities: `camelCase.ts`
+- Use the `@/` alias for imports rooted at `src`.
+- Preserve the config-first model: new chain actions/endpoints should be defined in `public/plugin/canopy/*.json`, not hardcoded in UI flows.
+- Follow local formatting in the file you touch (quote style is mixed across the repo).
+
+## Testing Guidelines
+- Automated tests are currently not configured in this workspace.
+- Before opening a PR, run `npm run build` and manually verify affected flows in `npm run dev`.
+- If you add tests, colocate them as `*.test.ts`/`*.test.tsx` near the implementation and prioritize action runtime, DS fetching, and critical page paths.
+
+## Commit & Pull Request Guidelines
+- Follow Conventional Commit style used in history: `feat:`, `fix:`, `chore:`.
+- Keep commits small and focused; avoid mixing unrelated refactors with feature work.
+- PRs should include:
+  - a concise summary and rationale,
+  - linked issue/task,
+  - screenshots or short recordings for UI changes,
+  - notes on `chain.json`/`manifest.json` compatibility impacts.